v0.6.1 "Obsidian Glass" — [SUPERSEDED by v0.7.0]

Warning

[SUPERSEDED by v0.7.0] — Version 0.6.1 is deprecated. All users must upgrade to v0.7.0 "Obsidian Maturity". This release had alignment issues with Docusaurus specifications and legacy terminology ("Vanilla" mode).

---

🛡️ The Documentation has reached Stable Status.

This release marks the structural and visual inauguration of the Zenzic
Documentation Portal, synchronized with the v0.6.1 Obsidian Glass stable core.

Key Structural Innovations:

• Diátaxis Framework: Fully reorganized content into four functional
  quadrants: Tutorials, How-to Guides, Reference, and Explanation.
• Obsidian Engineering Ledger: A new visual standard for the Landing Page,
  showcasing our architectural invariants (Zero Assumptions, Subprocess-Free,
  Deterministic Compliance).
• Standalone Mode Rebranding: Complete transition from "Vanilla" to
  "Standalone Mode", reflecting technical honesty and structural transparency.
• Traceable Integrity: Authoritative index of Zxxx finding codes with
  deep-link support for instant resolution.

Technical Hardening:

• SEO & Search Console Fixes: Implemented root index and directory
  integrity checks to eliminate 404 errors.
• Social Presence: High-fidelity Open Graph assets for X and LinkedIn.
• Bilingual Excellence: 100% parity between English and Italian sources.

v0.6.1rc2 — Obsidian Bastion (Hardened)

v0.6.1rc2 — Obsidian Bastion (Hardened)

Zenzic v0.6.1rc2 is a major security milestone. After a rigorous stress test, we have fortified the Shield and synchronized the entire ecosystem.

🚄 Key Improvements

• Hardened Shield: Advanced detection of obfuscated secrets (Unicode, HTML entities, multi-line splits).
• Full-Spec Discovery: Mandatory ExclusionManager and 100% subprocess-free core logic.
• Metadata-Driven Routing: Stable support for Docusaurus v3 and MkDocs i18n.

🛡️ Security Audit

This release candidate successfully resisted 11 jailbreak vectors and 4 advanced credential obfuscation attempts during internal auditing.

📦 Installation

uvx --pre zenzic check all
# OR
pip install zenzic==0.6.1rc2

---

Proudly developed by PythonWoods. Your documentation's Safe Harbor.

v0.6.1rc1 — Obsidian Bastion: The Release Candidate

v0.6.1rc1 — Obsidian Bastion (Release Candidate)

Zenzic enters the final validation phase. v0.6.1rc1 is the most stable and feature-complete version of the Obsidian series.

🚀 Key Features

• Universal Discovery Engine: Centralized, high-performance file iteration.
• VCS-Awareness: Native support for .gitignore patterns.
• Metadata-Driven Routing: Full slug and i18n support for Docusaurus v3.
• Pure Python Core: 100% subprocess-free architecture.

🌐 Documentation & Brand

Visit the new home of documentation at zenzic.dev.

📦 Installation

uvx --pre zenzic check all
# OR
pip install zenzic==0.6.1rc1

v0.6.1a1 — Obsidian Bastion: Universal Discovery & VCS Awareness

🏰 Zenzic v0.6.1a1 — The Obsidian Bastion Release

Zenzic evolves into a VCS-aware Documentation Platform Analyser. This release marks the transition to a multi-source architecture, enabling deep integration with Docusaurus i18n and professional-grade exclusion management.

🚄 Universal Discovery Engine

The new discovery module centralizes file iteration across the entire framework. Zenzic now respects your workspace structure like never before, ensuring consistent results between the Scanner, Validator, and Shield.

🛡️ Layered Exclusion Management

Introducing a 4-level hierarchy for file and directory exclusions:

1. System Guardrails: Hardcoded protection for .git, .venv, node_modules, etc.
2. VCS Discovery: Optional support for .gitignore and .hgignore patterns.
3. Project Config: Granular control via zenzic.toml (now with forced inclusion support).
4. CLI Overrides: Dynamic control for specialized CI runs.

🌐 Docusaurus i18n & Metadata Routing

• Multi-source Discovery: Zenzic now automatically finds and lints translated docs in i18n/ locale trees.
• Slug Support: Frontmatter slug: overrides are now citizens of the Virtual Site Map (VSM).

🧩 Ecosystem Standardisation

• Integrations Namespace: MkDocs support has been moved to zenzic.integrations.mkdocs for a cleaner core.
• Pure Analysis: The serve command has been removed to preserve the Zero Subprocess Pillar.

🧪 Quality & Security

• Anti-ReDoS: Shield middleware now truncates pathologically long lines (>1MiB).
• Anti-Jailbreak: Hardened docs_root validation (Blood Sentinel Exit 3).
• Full Parity: 953 tests passed. Documentation synced at zenzic.dev.

v0.6.0a2 — Obsidian Glass

v0.6.0a2 — Obsidian Glass

Zenzic v0.6.0a2 is here, establishing a new standard for documentation integrity and security.

🚄 Universal Discovery & Metadata Routing

The new Discovery engine ensures that your exclusion rules are respected everywhere. Whether you use MkDocs, Docusaurus, or Zensical, Zenzic now maps your site topology using high-fidelity metadata.

🛡️ Hardened Security

The Zenzic Shield is now more vigilant than ever, operating as an IO middleware to catch secrets and path traversals before any parsing occurs.

🌐 New Home: zenzic.dev

Our documentation has moved! Visit zenzic.dev for the updated guides, the new Obsidian Style Guide, and deep dives into the Three Pillars of Zenzic.

📦 Installation (Pre-release)

Zenzic v0.6.0a2 is an Alpha release. To install it, you must specify the exact version or use the --pre flag.

Using uv (Recommended for speed)

# Run Zenzic instantly without installing
uvx --pre zenzic check all

# Or install it in your environment
uv pip install --pre zenzic

Using pip

# Install the specific alpha version
pip install zenzic==0.6.0a2

# Or always get the latest pre-release
pip install --pre zenzic

v0.6.0a1 — Obsidian Glass: The Headless Transition

🛡️ Zenzic v0.6.0a1 — "Obsidian Glass"

"The Sentinel no longer carries its own reflection; it watches the world through a prism of pure logic."

This release marks the most significant architectural evolution of Zenzic to date. We have officially transitioned to a Headless Architecture, decoupling the core analysis engine from the documentation site. Zenzic is now a pure, lightweight, and extremely fast security-first framework for any Markdown ecosystem.

---

⚠️ Alpha Release: The Headless Shift (Breaking Changes)

This is a pre-release. It introduces structural changes to the repository and the distribution model:

• Core Decoupling: The docs/ directory has been removed from the core repository. Documentation now lives in its own sovereign Bastion: zenzic-doc.
• Engine Agnosticism: All MkDocs-specific build dependencies and scripts have been purged. The core is now "clean" and focused 100% on static analysis.

---

⚓ What's New

💎 Docusaurus Native Support

Zenzic now speaks the language of the modern web. We’ve implemented a native DocusaurusAdapter (Pure Python) that enables:

• Full support for MDX files.
• i18n Ghost Routes: Automatic mapping of localized content in i18n/ to virtual site routes.
• Zero-Node.js Dependency: The adapter maps complex React-based documentation structures by analyzing the filesystem and static configurations, maintaining our "No Subprocesses" pillar.

🏗️ Core Hardening & Cleanup

• Fixed .mdx Classification: The engine now correctly identifies .mdx files as documents rather than assets.
• uvx / pipx Compatibility: Fixed the [project.scripts] entry point. You can now invoke the Sentinel directly via uvx --pre zenzic.
• Performance Optimization: By removing the documentation build overhead, the preflight check and general installation are now significantly faster.

---

🛠️ Technical Specs

• Logic: 100% Pure Python 3.11+.
• Tests: 767 passed (100% regression coverage).
• Adapter Logic: Recursive Θ(V+E) graph mapping for Docusaurus v3.
• Governance: REUSE 3.3 compliant.

📖 Documentation & Contribution

For the latest guides, architecture deep-dives, and to contribute to the documentation, visit our portal:
👉 zenzic.pythonwoods.dev

v0.5.0a5 — The Sentinel Codex

🛡️ Zenzic v0.5.0a5 — "The Sentinel Codex"

"Rigour in code must extend to every single pixel the user sees."

This release marks the end of the "hand-crafted" era for Zenzic. With v0.5.0a5, the Safe Harbor receives its visual constitution (The Sentinel Style Guide) and full automation of its documentation assets. This version establishes the final structural baseline before the promotion to Release Candidate.

⚓ Release Highlights:

1. Sentinel Visual Language (ZRT-DOC-002):

   • Canonical Style Guide: Implemented a binding internal standard for UI/UX consistency.
   • Card Grid Refactoring: Transitioned from cluttered navigation to a high-density, single-action-link pattern.
   • Admonition Taxonomy: Enforced strict semantic roles for callouts (e.g., danger is now exclusively reserved for security incidents).

2. Graph Integrity & i18n Stability (ZRT-DOC-004):

   • 102 Strategic Anchor IDs: Injected explicit anchors across 70 files to ensure link stability between English and Italian translations.
   • Icon Normalization: Purged all Material Icons in favor of the clinical precision of Lucide and Octicons.

3. Visual Truth Automation:

   • Deterministic SVG Pipeline: All 5 documentation screenshots are now auto-generated from live sandbox fixtures. No more manual XML editing.
   • Metadata Alignment: Full synchronization of version strings across CITATION.cff, pyproject.toml, and __init__.py.

4. Hardened Security & CLI Validation:

   • E2E Test Suite: 8 new end-to-end tests validating the exit code contract (3 > 2 > 1 > 0) with zero mocks.
   • Critical Fix: Resolved a bug in the check all command where the --exit-zero flag could inadvertently silence security incidents. The Sentinel is now unconditionally vigilant.

🧪 Harbour Metrics:

• 767 regression tests passed successfully.
• 86.7% Mutation Score (testing effectiveness).
• i18n Parity: 100% coverage between EN and IT documentation.

v0.5.0a4

v0.5.0a4 — The Hardened Sentinel

Pre-release alpha. Not recommended for production use.

The Sentinel now detects system-path traversal attacks, link cycle violations,
and hex-encoded payloads — with surgical noise control for advisory findings.

---

🩸 Blood Sentinel — Exit Code 3

Links that escape docs/ and target OS system directories (/etc/, /root/,
/var/, /proc/, /sys/, /usr/) are classified as security_incident and
exit with code 3. Priority order: 3 > 2 (Shield) > 1 (errors). Never
suppressed by --exit-zero.

🔗 Graph Integrity — Θ(V+E)

Iterative DFS cycle detection runs once after the in-memory resolver is built
(Phase 1.5). Every Phase 2 per-link lookup is O(1). CIRCULAR_LINK is reported
at severity info — mutual navigation links are intentional in hypertext docs
and never block CI.

🛡 Hex Shield

New credential pattern: hex-encoded-payload — 3 or more consecutive \xNN
escape sequences. Catches obfuscated payloads embedded in documentation source,
including inside fenced code blocks.

💡 Signal-to-Noise Control

info findings are suppressed by default. A footer note counts them:
"N info findings suppressed — use --show-info for details."
Available on all 7 check commands.

🐛 ZRT-005 Bootstrap Paradox

zenzic init now works correctly in a completely empty directory. The generated
zenzic.toml includes a commented Shield block documenting all 8 credential
pattern families.

---

What's Changed

• validator.py — iterative DFS graph integrity, Blood Sentinel classification
• reporter.py — security_incident badge, show_info filter, suppression note
• cli.py — --show-info on all 7 commands, Shield block in init template
• shield.py — hex-encoded-payload pattern family
• checks.md (EN+IT) — Blood Sentinel, Circular Links, References/Shield section
• architecture.md (EN+IT) — new, documents O(V+E) graph integrity design
• INTERNAL_GLOSSARY.toml — canonical EN/IT term registry
• 3 terminal SVG screenshots integrated into the manual
• Shield comment block in all 9 example zenzic.toml files
• safety_demonstration.md — live Sentinel demo for first-time users

759 tests · preflight green · bilingual docs (EN + IT)

---

Full Changelog: v0.5.0a3...v0.5.0a4

v0.5.0a3 — The Sentinel: Smart Init, Mutation War & Aesthetic Sprint

GitHub Release

Tag: v0.5.0a3

Release title:
v0.5.0a3 — The Sentinel: Smart Init, Mutation War & Aesthetic Sprint

Release description:

Highlights

Smart Initialization — zenzic init now detects pyproject.toml and offers to
embed configuration as [tool.zenzic] instead of creating a standalone zenzic.toml.
Use --pyproject to skip the prompt. Engine auto-detection works in both modes.

Mutation Testing Campaign — 80 new targeted tests raise mutation score from 58%
to 86.7% on rules.py (target was 75%). Hypothesis property-based testing integrated
with tiered profiles (dev/ci/purity).

The Breathing Sentinel — native col_start/match_text propagation replacing
fragile regex workarounds. Surgical caret rendering, traceback gutter with 2-space
padding, and vertical breathing between findings.

Agnostic Target — zenzic check all README.md or zenzic check all content/
scopes audits to a single file or directory. VanillaAdapter auto-selected for
out-of-docs targets.

Plugin SDK — zenzic init --plugin <name> scaffolds a ready-to-edit rule package.
zenzic.rules public namespace is now stable.

Z001/Z002 Split — broken links (error) vs orphan-page links (warning).

Quality Gates

pytest             706 passed, 0 failed
coverage           ≥ 80% branch (hard gate)
mutation score     86.7% (242/279 killed on rules.py)
ruff check src/    0 violations
mypy src/          0 errors
reuse lint         compliant
zenzic check all   7/7 OK (self-dogfood)

Install / Upgrade

uvx --pre zenzic check all           # zero-install one-shot (requires --pre for alpha)
uv tool install zenzic==0.5.0a3      # pin this exact pre-release
pip install zenzic==0.5.0a3          # pin this exact pre-release

Full changelog: CHANGELOG.md · Release notes: RELEASE.md

---

v0.5.0a2: The Refined Sentinel (Native UI & Unified Workflow)"

🛡️ Zenzic v0.5.0a2 — The Refined Sentinel

Second alpha of the v0.5 "Sentinel" cycle. This release is a consolidation sprint focused on developer experience, package honesty, UI professionalization, and toolchain hardening.

🌀 What's new

Lean & Agnostic by Design
The zenzic[docs] public extra has been removed. Zenzic performs static analysis of your configuration files — it does not execute the build engine or its plugins. Install MkDocs independently; Zenzic stays lightweight and dependency-free.

Unified Developer Workflow via just
Contributors now have a single, coherent command surface.

• just check: The Sentinel's self-linting duty (Zenzic vs Zenzic).
• just verify: The pre-push quality gate (Preflight + Production build).
• just sync, just build, just serve: Standardized environment and doc management.

Native Material UI Restoration
Removed custom header overrides in favor of native MkDocs-Material Tabs. The repository widget now displays stars, forks, and versioning on a single horizontal line, following industry best practices for a clean, professional look.

Toolchain & Security Hardening

• PEP 440 Compliance: bump-my-version is now hardened to handle alpha sequences (a2 → a3) automatically.
• Dependency Refresh: Updated 115 packages, resolving potential security vulnerabilities and upgrading to mkdocs-material v9.7.6.

📋 Full changelog

See CHANGELOG.md — ## [0.5.0a2] section.