Merge pull request #39 from PythonWoods/feat/docusaurus-adapter-v0.6.0a1

v0.6.0a1: Obsidian Glass — Headless Architecture & Docusaurus Support

Author: PythonWoods-Dev

.github/ISSUE_TEMPLATE/docs_issue.yml

@@ -11,7 +11,6 @@ on:
     paths:
       - 'src/**'
       - 'tests/**'
-      - 'docs/**'
       - 'pyproject.toml'
       - 'uv.lock'
       - 'noxfile.py'
@@ -23,7 +22,6 @@ on:
     paths:
       - 'src/**'
       - 'tests/**'
-      - 'docs/**'
       - 'pyproject.toml'
       - 'uv.lock'
       - 'noxfile.py'
@@ -83,23 +81,6 @@ jobs:
       - name: Run pip-audit
         run: uvx nox -s security
 
-  docs:
-    name: Documentation
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
-        with:
-          enable-cache: true
-
-      - name: Generate build artifacts
-        run: zip -qr docs/assets/brand-kit.zip docs/assets/brand/
-
-      - name: Build docs (strict) + Zenzic self-check
-        run: uvx nox -s docs preflight
-
   reuse:
     name: REUSE Compliance
     runs-on: ubuntu-latest

.github/workflows/ci.yml

@@ -102,15 +102,12 @@ zenzic_report/      # Optional HTML report exports from zenzic
 .zenzic-score.json
 
 # ────────────────────────────────────────────────────────────────────────────
-# MkDocs, Zensical & Documentation
+# Documentation build caches (user projects, not Zenzic's own docs)
 # ────────────────────────────────────────────────────────────────────────────
 site/
-pdf/                # with-pdf output directory
+pdf/
 .mkdocs_cache/
-.zensical_cache/    # Reserved for a future Zensical cache
-*.pdf               # Exclude locally generated PDF manuals from commits
-# Build artifact — generated by run_demo.sh and CI; never committed
-docs/assets/brand-kit.zip
+.zensical_cache/
 
 # ────────────────────────────────────────────────────────────────────────────
 # Web & JS (Optional but recommended)
@@ -175,14 +172,11 @@ Desktop.ini
 .gitlab-ci-local/
 .wrangler/              # Cloudflare Wrangler local cache
 
-# ============================================================================
-# Local scratch notes (never committed)
-# ============================================================================
+# ────────────────────────────────────────────────────────────────────────────
+# Migration staging area (v0.6.0a1 — Clean Harbor)
+# ────────────────────────────────────────────────────────────────────────────
 .temp/
 
-# Lucide icon set — downloaded at build time by nox/CI, not committed
-overrides/.icons/lucide/
-
 # ============================================================================
 # End of .gitignore
 # ============================================================================

.github/workflows/deploy-docs.yml

@@ -71,7 +71,7 @@ repos:
 
       - id: zenzic
         name: Zenzic self-check
-        entry: bash -c "mkdir -p docs/assets && zip -qr docs/assets/brand-kit.zip docs/assets/brand/ && uv run zenzic check all --strict"
+        entry: uv run zenzic check all --strict
         language: system
         types_or: [python, markdown, yaml]
         pass_filenames: false

.github/workflows/zenzic.yml

@@ -11,6 +11,29 @@ Le versioni seguono il [Semantic Versioning](https://semver.org/).
 
 ## [Non rilasciato]
 
+## [0.6.0a1] — 2026-04-12 — Obsidian Glass
+
+> **Alpha 1 della serie v0.6.** Zenzic evolve da un linter MkDocs-aware a un
+> **Analizzatore di Piattaforme Documentali**. Questo rilascio introduce
+> l'adapter per il motore Docusaurus v3 — il primo adapter non-MkDocs/Zensical —
+> e segna l'inizio della strategia di migrazione Obsidian Bridge.
+
+### Aggiunto
+
+- **Adapter Docusaurus v3** (`DocusaurusAdapter`): Supporto iniziale per il motore
+  Docusaurus v3 — adapter puro Python conforme al protocollo `BaseAdapter`. Gestisce
+  file sorgente `.md` e `.mdx`, modalità sidebar auto-generata (tutti i file
+  `REACHABLE`), geografia i18n Docusaurus
+  (`i18n/{locale}/docusaurus-plugin-content-docs/current/`), rilevamento Ghost Route
+  per le pagine indice delle locale, ed esclusione di file/directory con prefisso `_`
+  (`IGNORED`). Registrato come adapter built-in con entry-point
+  `docusaurus = "zenzic.core.adapters:DocusaurusAdapter"`.
+- **Estrazione `baseUrl`**: Estrazione chirurgica via regex di `baseUrl` da
+  `docusaurus.config.ts` / `.js` — nessun sottoprocesso Node.js (conformità
+  Pilastro 2).
+- **Hook factory `from_repo()`** per `DocusaurusAdapter`: Scopre automaticamente
+  `docusaurus.config.ts` o `.js` e costruisce l'adapter con il `baseUrl` corretto.
+
 ## [0.5.0a5] — 2026-04-09 — Il Codex Sentinel
 
 > **Rilascio Alpha 5.** Revisione del linguaggio visivo: Guida di Stile Sentinel,

.gitignore

@@ -11,6 +11,28 @@ Versions follow [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.6.0a1] — 2026-04-12 — Obsidian Glass
+
+> **Alpha 1 of the v0.6 series.** Zenzic evolves from a MkDocs-aware linter into
+> an **Analyser of Documentation Platforms**. This release introduces the
+> Docusaurus v3 engine adapter — the first non-MkDocs/Zensical adapter — and
+> marks the beginning of the Obsidian Bridge migration strategy.
+
+### Added
+
+- **Docusaurus v3 adapter** (`DocusaurusAdapter`): Initial support for Docusaurus v3
+  engine — pure Python adapter satisfying the `BaseAdapter` protocol. Handles `.md`
+  and `.mdx` source files, auto-generated sidebar mode (all files `REACHABLE`),
+  Docusaurus i18n geography (`i18n/{locale}/docusaurus-plugin-content-docs/current/`),
+  Ghost Route detection for locale index pages, and `_`-prefixed file/directory
+  exclusion (`IGNORED`). Registered as built-in adapter with entry-point
+  `docusaurus = "zenzic.core.adapters:DocusaurusAdapter"`.
+- **`baseUrl` extraction**: Surgical regex extraction of `baseUrl` from
+  `docusaurus.config.ts` / `.js` — no Node.js subprocess (Pillar 2 compliance).
+- **`from_repo()` factory hook** for `DocusaurusAdapter`: Auto-discovers
+  `docusaurus.config.ts` or `.js` and constructs the adapter with the correct
+  `baseUrl`.
+
 ## [0.5.0a5] — 2026-04-09 — The Sentinel Codex
 
 > **Alpha 5 Release.** Visual-language overhaul: Sentinel Style Guide,

.pre-commit-config.yaml

@@ -15,8 +15,8 @@ abstract: >
   scanner (the Shield). Built on pure functional principles in Python 3.11+, it operates
   source-first — no build framework required — and integrates with any Markdown-based
   documentation system via a plugin adapter protocol.
-version: 0.5.0a5
-date-released: 2026-04-09
+version: 0.6.0a1
+date-released: 2026-04-12
 url: "https://zenzic.pythonwoods.dev/"
 repository-code: "https://github.com/PythonWoods/zenzic"
 license: Apache-2.0