Skip to content

chore(release): v0.7.1 Documentation Alignment & CI/CD Unification#49

Merged
PythonWoods-Dev merged 18 commits into
mainfrom
release/v0.7.1
May 9, 2026
Merged

chore(release): v0.7.1 Documentation Alignment & CI/CD Unification#49
PythonWoods-Dev merged 18 commits into
mainfrom
release/v0.7.1

Conversation

@PythonWoods-Dev
Copy link
Copy Markdown
Contributor

Overview

This PR aligns the zenzic-doc repository with the Zenzic v0.7.1 release. It focuses on eradicating legacy AI-related content, unifying the CI/CD pipeline under the 4-Gates Standard, and introducing a strict documentation-to-code parity check.

Changes

  • Pipeline Unification: Eliminated double execution of linters. just verify is now the single source of truth for both local and CI validation.
  • Doc-Code Parity Gate: Re-engineered the verify_codes_parity Nox session. It now robustly checks if all Zxxx codes in the codebase are documented in finding-codes.mdx (EN/IT), falling back to PyPI via uv if the local core is unavailable.
  • Ghost Purge: Removed legacy and phantom error codes (Z001, Z002) from the documentation, modernizing them to their current equivalents.
  • I18N Documentation: Added the missing Z907 (I18N Parity) documentation to both English and Italian finding-codes references.
  • Release Bridge: Updated zenzic.toml to temporarily exclude zenzic.dev URLs that point to unreleased v0.7.0 posts, unblocking the CI.

PythonWoods-Dev and others added 18 commits May 8, 2026 09:06
…7.1)

No code changes (Node/Docusaurus ecosystem). Tracks alignment with
Zenzic Core release/v0.7.1 infrastructure patch (Boundary Testing
matrix fix, Mypy floor lowered to 3.10).
…des-parity, add Graceful Degradation

- Remove nox preflight session (duplicated just verify; bare uvx zenzic without version pin)
- Rename verify-docs → verify-codes-parity (nox session + function)
- Step 1 rewritten: ZENZIC_PROJECT_PATH-aware Graceful Degradation
  - Core Maintainer: uv run --project <path> (local source)
  - External Contributor: uv run --with zenzic (published PyPI fallback)
- justfile: add verify-codes recipe; update verify target to 4-Gates (lint-all + typecheck + build + verify-codes)
- docs sweep (EN + IT): all stale preflight/verify-docs references updated
  - README.md/README.it.md: command table + code block
  - CONTRIBUTING.md: pre-push gate section
  - docs/how-to/add-badges.mdx: nox -s preflight → nox -s build
  - developers/explanation/adr-bilingual-structural.mdx: just preflight → just lint-all
  - developers/how-to/sovereign-override-404-shield.mdx: checklist item
  - docs/how-to/configure-ci-cd.mdx: new Doc-Code Parity section (verify-codes-parity + Graceful Degradation table)
- CHANGELOG.md + CHANGELOG.it.md: [Unreleased] ### Changed entry added
Silent syntax error in the 'check' recipe: bash treats 'if[' as a command
name rather than the 'if' keyword followed by '['. The command would fail
with 'command not found: if[-d' on first execution.
…cy (EN+IT)

- _check-hooks: warn if pre-push hook not installed (warn-only, never blocks)
- ecosystem.mdx: retitled 'The Zenzic Ecosystem'; added:
  - Ecosystem at a Glance table (Core / Structum / Zenzic-Doc)
  - zenzic-doc Living Test Bench section (self-dogfooding, Graceful Degradation)
  - The 4-Gates Standard section (IDE / Pre-commit / Pre-push / Remote CI)
- IT mirror updated atomically
…+IT)

- _check-hooks: empathetic DX Polish (ANSI yellow, uvx fix command)
- justfile: remove double execution (typecheck + check removed from verify chain)
- codes.py: Z000 now canonical (34 codes total)
- finding-codes.mdx: add Z907 I18N_PARITY section (EN+IT)
- finding-codes.mdx: purge Legacy Codes section; promote CI/CD to H2
- checks.mdx: Z001→Z101, Z002→Z103, Z009→Z902
verify-codes-parity: 0 MISSING, 0 phantom codes
…pdate release-dry command in justfile

Co-authored-by: Copilot <copilot@github.com>
@PythonWoods-Dev PythonWoods-Dev merged commit 1fc5ffe into main May 9, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant