v0.14.0

Zenzic Documentation v0.14.0

Aligned with Zenzic Core v0.14.0.

📖 New: Z506 MALFORMED_FRONTMATTER Gallery Page

Complete documentation for the new Z506 rule: live terminal output, examples of all
malformed delimiter variants, configuration guide, and suppression instructions.

📰 Blog UX Sprint v3

• Pagination: Blog index split to 10 posts per page with ← / → navigation links.
• Posts sidebar: Right panel on all blog post pages listing all 14 posts with
  active-post highlighting. Replaces the table of contents (TOC).
• Breadcrumbs: Manual Home › Blog › Title breadcrumb on every blog post with
  inline SVG home icon.
• Metadata bar: Date / authors / tags displayed after the H1 title, before the body.
  Pure Jinja2, zero JavaScript.
• Footer: Copyright notice now renders on all pages.
• Nav icons: Universal document icon added to all left-sidebar navigation links.

🗑️ I18N Eradication

Italian documentation fully removed. A Cloudflare Pages splat redirect /it/* → /:splat 301
preserves all legacy Italian URLs with zero 404s.

🐛 Fixed

• TOC right sidebar accent background on reference pages.
• Breadcrumb home icon selector (.md-path__item not .md-breadcrumb__item).

---

Full Changelog: CHANGELOG.md

Release v0.13.1: Zensical Architecture & Pipeline Hardening 📚

📝 Release Overview

This release finalizes the massive architectural shift for the Zenzic Documentation portal, completing the transition to our new Python-based static site generator (Zensical / MkDocs) and eradicating the final technical debt associated with the deprecated Node.js/Docusaurus stack.

In strict adherence to our Versioning Law, the documentation portal is now formally aligned and pinned to the v0.13.1 engine of Zenzic Core.

Architectural Changes & CI/CD

• Zensical Dual-Build Architecture: Consolidated the build pipeline to properly execute the ADR-020 Dual-Build strategy, generating output in the site/ and site/it/ directories using uv and zensical.
• Read The Docs Remediation: Exorcised the ghosts of npm and Node.js from the .readthedocs.yaml configuration. The RTD build environment is now strictly Python 3.12, utilizing uv for lightning-fast deterministic dependencies.
• Workflow Hardening: Fixed the release-docs.yml pipeline to correctly package and deploy the new site/ directory instead of the legacy build/ folder, unblocking Cloudflare Pages deployments.

Governance & Compliance

• Version Alignment: Bumped internal project references, pyproject.toml, and GitHub Actions to enforce the 0.13.1 Core standard and exact SHA pinning for Zenzic Actions (@37ffe97).
• DCO Enforcement: All commits retroactively signed and compliant with the Developer Certificate of Origin.

v0.11.0: Diátaxis Alignment for Monorepo & Routing Capabilities

Documentation Impact Analysis (D.I.A.)

This release synchronizes the documentation ecosystem with the v0.11.0 Core Engine updates, strictly adhering to the Diátaxis framework and the Bilingual Parity invariant (ADR-020).

Reference & Explanation Quadrants

• Configuration Reference: Updated excluded_dirs documentation to explicitly define the new .gitignore path-matching semantics (global basenames vs. repository-relative paths).
• Docusaurus Native Emulation: Documented Zenzic's new capability to statically resolve both URL-Based and File-Based Docusaurus links without Node.js execution.
• Known Limitations & Mitigations (Zero Hidden Debt): Added brutal transparency regarding Zenzic's physical boundaries. Documented the inability to dynamically evaluate Webpack @site aliases and sidebars.ts generated categories. Provided the official surgical .zenzic.toml mitigation strategy to silence Z101/Z104 on these specific paths without DQS penalties.

Ecosystem Governance

• The Golden Rule of Memory: The autonomous agent ledger (handoff_ledger.md) and .clinerules have been synchronized across the ecosystem, enforcing cross-repo memory consistency and the External Air-Gap Policy.

What's Changed

• chore(release): v0.11.0 by @PythonWoods-Dev in #90

Full Changelog: v0.10.4...v0.11.0

zenzic-doc 0.10.4 — Wordmark, blog post & security fixes

What's changed

Documentation

• New "Auditing the Auditors" case study blog post — covers the CI self-check incident and resolution
• New zenzic-doc SVG wordmark logo (light + dark) in official sky brand palette
• All badges centered with <p align="center"> in both README.md and README.it.md
• SSH commit signing setup instructions added to CONTRIBUTING.md

Security

• shell-quote CRITICAL (GHSA-w7jw-789q-3m8p) resolved via npm audit fix
• actions/checkout pinned to v6.0.3 SHA across all 9 workflows

CI

• Removed pull_request.paths filter from ci.yml — fail-closed: required checks now always created for every PR
• Added Z109 suppression for github.com/google/re2 transient connection errors in architecture.mdx (EN + IT)

Full changelog

https://github.com/PythonWoods/zenzic-doc/blob/main/CHANGELOG.md

v0.10.3: Z-Code Gallery Updates & Contributor Portal Hardening

This release updates the documentation portal to reflect the core linter enhancements of v0.10.3 and establishes new contributor guidelines aligned with enterprise standards.

📖 Documentation Impact Analysis (D.I.A.)

• Z-Code Gallery Routing: Updated the English and Italian reference documentation for Z102 (Anchor Missing), Z104 (File Not Found), and Z503 (Snippet Error) to document explicit anchors, footnote parsing, and custom YAML tag support.
• Diátaxis Compliance: Preserved the dry, lookup-only structure of finding-codes.mdx by routing detailed parser specs and examples exclusively to the tutorials gallery.

🛡️ Contribution Guidelines & Workflows

• Developer Portal Upgrade: Aligned the developer portal (pull-requests.mdx and index.mdx) and repository CONTRIBUTING.md / CONTRIBUTING.it.md guides to enforce the Issue-First Policy, mandatory GPG/SSH/S/MIME signatures, DCO sign-offs, and "No AI Slop" checks.
• Compliance Workflow: Integrated automated PR title linting and DCO validation into the repository's CI pipeline.

v0.10.1: Diátaxis Alignment & CI Naming Contract

What's New in v0.10.1

This release brings the official documentation perfectly in line with the Diátaxis framework boundaries and enforces the new organizational CI/CD naming standards.

Documentation & Diátaxis

• Reference Purity: Audited and purified the docs/reference/ quadrant. All philosophical explanations and step-by-step guides have been successfully migrated out of Reference files.
• Explanation Quadrant Alignment: Audited docs/explanation/ to ensure purely theoretical and architectural content without CLI execution steps.
• Tutorials & How-To: Audited the practical guides to remove deep theory and exhaustive tables, enforcing strict problem-oriented learning structures.

CI/CD & Governance

• Global CI Naming Contract: Aligned all GitHub Actions workflow files to the organizational naming standard (e.g., Zenzic Docs CI, Run Zenzic Quality Gate, Verify Badge Freshness).
• Gateway Contribution Policy: Removed duplicated workflow texts from CONTRIBUTING.md, transforming it into a strict pointer (Gateway) to the official developer documentation to prevent DRY violations.
• TOML Configuration Hardening: Restructured .zenzic.toml to enforce TOML parsing strictness, ensuring root keys (like strict and fail_under) are physically declared before any nested headers.

---

Full Changelog: v0.10.0...v0.10.1

v0.10.0 (Diamond)

Added

• Native CI Integration and Filtering Docs: Documented the new --ci shorthand and --format github-annotations in CLI Reference and CI/CD integration guides (EN + IT). Documented the --only flag for targeted rule filtering.
• Blog Post: Added new DevRel payload "Zenzic v0.10.0: Native GitHub Annotations and Progressive Adoption" demonstrating the killer features of v0.10.0.

Changed

• ADR-037 Install Guide Refinement: Removed the hardcoded version tag (@v0.10.0) from the Ephemeral GitHub execution instructions (uvx --from git+...) to decouple the command from temporal releases and point to the default branch.

v0.9.2 (Graphite)

v0.9.2 (Graphite)

This release delivers a complete structural overhaul of the documentation portal, strictly aligning it with the Diátaxis framework and standardizing the UI components.

Changed

• Architecture: Realigned all documentation into strict Diátaxis quadrants (Tutorials, How-To, Reference, Explanation).

v0.9.1 - Graphite

Zenzic Doc v0.9.1 "Graphite"

This release matches the Zenzic core release under the branch parity rule, completing the Z-Code Gallery documentation and stabilizing the CI audit pipeline.

What's Changed

Added

• Z-Code Gallery Completion: Full documentation and interactive examples (EN + IT locales) for Z107 CIRCULAR_ANCHOR and Z104 FILE_NOT_FOUND.

Changed

• Repository-Relative Suppression Config: Updated .zenzic.toml per_file_ignores and directory_policies to use strictly repository-relative keys (prefixed with docs/ or docs/it/).
• Strategic Navigation Exemption: Added directory_policies exemption for docs/tutorials/examples/** under Z401 to prevent scoring penalties on example directories that intentionally lack index files.
• Score Badge Telemetry: Stamped quality score badge inline in README.md and README.it.md to show a passing score of 96/100.
• Hostile Precision UI standardization applied across release-facing documentation surfaces.
• Normalized legacy snippets and inconsistent command narratives in terminal documentation.
• SVG asset governance aligned with ADR-037 compliance requirements.

Infrastructure & CI/CD

• Branch Parity CI Fix: Resolved the remote branch resolution bug in .github/workflows/ci.yml by using github.head_ref instead of github.base_ref. This ensures Pull Requests correctly checkout the corresponding development branch (release/v0.9.1-prep) of the zenzic core engine, guaranteeing that path matching alignments work seamlessly in CI checks.

---

For a complete migration history, see the Changelog.

v0.9.0 — Lab Gallery & Privacy Gate Documentation

What's new in v0.9.0

Lab gallery documentation

• tutorials/examples.mdx (EN + IT): full prose gallery for all 20 zenzic lab sandboxes with scenario matrix, exit-code column, and per-scenario descriptions.
• 15 new gallery sections covering z102, z103, z105, z108, z202, z204, z301, z302, z303, z402, z403, z501, z502, z503, z505.

CLI output alignment

• finding-codes.mdx (EN + IT): Z204 output updated to POLICY VIOLATION DETECTED banner (matches actual CLI).
• privacy-gate.mdx (EN + IT): new Exit Behavior section; [core] table-header corrected.

Developer docs

• Local gate sequence now mirrors the real just verify recipe (pre-commit hooks → pytest → strict audit → score stamp → freshness gate).
• Developer command matrix cleaned up; obsolete preflight terminology removed.

---

Full changelog: CHANGELOG.md