Release v0.9.0: Hostile Precision & Lab Gallery (#66)

Author: PythonWoods-Dev

.bumpversion.toml

@@ -2,7 +2,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 [tool.bumpversion]
-current_version = "0.7.1"
+current_version = "0.9.0"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 
@@ -14,8 +14,8 @@ regex = true
 
 [[tool.bumpversion.files]]
 filename = "package-lock.json"
-search = '"name":\s*"zenzic-docs",\s*"version":\s*"\d+\.\d+\.\d+"'
-replace = '"name": "zenzic-docs",\n  "version": "{new_version}"'
+search = '"name":\s*"zenzic-doc",\s*"version":\s*"\d+\.\d+\.\d+"'
+replace = '"name": "zenzic-doc",\n  "version": "{new_version}"'
 regex = true
 
 [[tool.bumpversion.files]]
@@ -28,57 +28,76 @@ filename = "docusaurus.config.ts"
 search = "v{current_version}"
 replace = "v{new_version}"
 
-[[tool.bumpversion.files]]
-filename = "README.md"
-search = "v{current_version}"
-replace = "v{new_version}"
 
 [[tool.bumpversion.files]]
-filename = "README.it.md"
+filename = "RELEASE.md"
 search = "v{current_version}"
 replace = "v{new_version}"
 
 [[tool.bumpversion.files]]
 filename = "RELEASE.md"
-search = "v{current_version}"
-replace = "v{new_version}"
+search = '(?m)^(\| Date\s+\|\s+)\d{{4}}-\d{{2}}-\d{{2}}(\s*\|)$'
+replace = '| Date     | {now:%Y-%m-%d} |'
+regex = true
 
 [[tool.bumpversion.files]]
-filename = "RELEASE.it.md"
-search = "v{current_version}"
-replace = "v{new_version}"
+filename = "docs/how-to/configure-ci-cd.mdx"
+search = 'version:\s*"?v?{current_version}"?'
+replace = 'version: "{new_version}"'
+regex = true
 
 [[tool.bumpversion.files]]
-filename = "i18n/en/code.json"
+filename = "i18n/it/docusaurus-plugin-content-docs/current/how-to/configure-ci-cd.mdx"
+search = 'version:\s*"?v?{current_version}"?'
+replace = 'version: "{new_version}"'
+regex = true
+
+[[tool.bumpversion.files]]
+filename = "i18n/it/docusaurus-plugin-content-docs/current.json"
+search = '"message": "{current_version}"'
+replace = '"message": "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "README.md"
+search = "badge/Zenzic-v{current_version}-blue"
+replace = "badge/Zenzic-v{new_version}-blue"
+
+[[tool.bumpversion.files]]
+filename = "README.it.md"
+search = "badge/Zenzic-v{current_version}-blue"
+replace = "badge/Zenzic-v{new_version}-blue"
+
+[[tool.bumpversion.files]]
+filename = "static/assets/brand/zenzic-brand-system.html"
 search = "v{current_version}"
 replace = "v{new_version}"
 
 [[tool.bumpversion.files]]
-filename = "i18n/it/code.json"
+filename = "static/assets/social/social-card.svg"
 search = "v{current_version}"
 replace = "v{new_version}"
 
 [[tool.bumpversion.files]]
-filename = "src/components/Homepage/Hero.tsx"
+filename = "static/assets/social/social-card-light.svg"
 search = "v{current_version}"
 replace = "v{new_version}"
 
 [[tool.bumpversion.files]]
-filename = "src/components/Homepage/Quickstart.tsx"
-search = "zenzic {current_version}"
-replace = "zenzic {new_version}"
+filename = "i18n/en/code.json"
+search = '"message": "v{current_version}"'
+replace = '"message": "v{new_version}"'
 
 [[tool.bumpversion.files]]
-filename = "src/pages/index.tsx"
-search = '"softwareVersion": "{current_version}"'
-replace = '"softwareVersion": "{new_version}"'
+filename = "i18n/it/code.json"
+search = '"message": "v{current_version}"'
+replace = '"message": "v{new_version}"'
 
 [[tool.bumpversion.files]]
-filename = "docs/how-to/configure-ci-cd.mdx"
-search = 'version: "{current_version}"'
-replace = 'version: "{new_version}"'
+filename = "src/components/Homepage/Hero.tsx"
+search = "v{current_version}"
+replace = "v{new_version}"
 
 [[tool.bumpversion.files]]
-filename = "i18n/it/docusaurus-plugin-content-docs/current/how-to/configure-ci-cd.mdx"
-search = 'version: "{current_version}"'
-replace = 'version: "{new_version}"'
+filename = "src/components/Homepage/Features.tsx"
+search = "v{current_version}"
+replace = "v{new_version}"

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,73 @@
+# SPDX-FileCopyrightText: 2026 PythonWoods <dev@pythonwoods.dev>
+# SPDX-License-Identifier: Apache-2.0
+
+name: Bug Report
+description: Report a broken link, rendering error, translation issue, or build failure in the documentation portal.
+title: "fix(docs): <short description>"
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to report a bug. Please fill in all required fields.
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Bug category
+      options:
+        - Broken internal link
+        - Broken external link
+        - Translation error (EN / IT mismatch)
+        - Missing translation (page not localised)
+        - Rendering error (code block, admonition, diagram)
+        - Build failure (yarn build / Docusaurus error)
+        - Navigation / sidebar issue
+        - Other
+      multiple: false
+    validations:
+      required: true
+
+  - type: input
+    id: page_url
+    attributes:
+      label: Affected page URL
+      description: The URL of the page where the bug occurs (use the production URL or the local dev URL).
+      placeholder: "https://zenzic.dev/docs/getting-started or http://localhost:3000/..."
+    validations:
+      required: true
+
+  - type: dropdown
+    id: language
+    attributes:
+      label: Language
+      options:
+        - English (default)
+        - Italian (it)
+        - Both
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behaviour
+      description: What should the page show or do?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behaviour
+      description: What does it actually show or do? Include screenshots if relevant.
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission checklist
+      options:
+        - label: I have searched existing issues and this is not a duplicate.
+          required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,71 @@
+# SPDX-FileCopyrightText: 2026 PythonWoods <dev@pythonwoods.dev>
+# SPDX-License-Identifier: Apache-2.0
+
+name: Feature Request
+description: Propose new documentation content, a translation, a tutorial, or a structural improvement.
+title: "feat(docs): <short description>"
+labels: ["enhancement", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Before opening a feature request, please check the
+        [open issues](https://github.com/PythonWoods/zenzic-doc/issues) to avoid duplicates.
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Feature category
+      options:
+        - New tutorial
+        - New how-to guide
+        - New reference page
+        - New blog post / release log
+        - New ADR (Architecture Decision Record)
+        - Italian translation of existing page
+        - Navigation / sidebar restructure
+        - Search improvement
+        - Other
+      multiple: false
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem to solve
+      description: What documentation gap does this fill? What question does it answer?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed content / change
+      description: Describe the new page, section, or structural change in concrete terms.
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: pillars
+    attributes:
+      label: Documentation quality pillars
+      description: Please confirm your proposal respects all that apply.
+      options:
+        - label: >
+            **Accuracy** — all code samples and commands have been tested against the
+            current stable Zenzic release.
+        - label: >
+            **EN / IT parity** — I will provide both English and Italian versions, or I have
+            noted in the description that a Core Maintainer should handle the translation.
+        - label: >
+            **Zenzic-validated** — the page will pass `just check` (no broken links,
+            no orphaned assets).
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission checklist
+      options:
+        - label: I have searched existing issues and this is not a duplicate.
+          required: true

.github/ISSUE_TEMPLATE/gate-bypass-postmortem.md

@@ -0,0 +1,52 @@
+---
+name: "🛡️ Gate Bypass Post-Mortem"
+about: "Break-Glass protocol — documented bypass of the `just verify` Final Guard."
+title: "[BYPASS] <short-emergency-description>"
+labels: ["gate-bypass", "priority:critical"]
+assignees: ""
+---
+<!-- SPDX-FileCopyrightText: 2026 PythonWoods <dev@pythonwoods.dev> -->
+<!-- SPDX-License-Identifier: Apache-2.0 -->
+<!-- markdownlint-disable MD003 MD041 -->
+
+> **Blameless principles**
+>
+> 1. **Data, not blame.** The failure log is objective evidence; narrative is secondary.
+> 2. **System focus.** Root cause identifies *why the pipeline* (Zenzic / yarn build / GHA) failed, never who pushed.
+> 3. **Always-on remediation.** Every bypass produces a task that hardens the gate so it is no longer needed next time.
+
+## 🚨 1. Trigger
+
+> What made the immediate bypass necessary? (production hotfix, total CI infra outage, broken upstream Node dependency, ...)
+
+## 📊 2. Gate Failure Log (Evidence)
+
+> Paste the full output of `just verify` (or the failing step) that blocked the push.
+
+```bash
+# paste log here
+```
+
+## 🔍 3. Root Cause Analysis
+
+- [ ] **False positive** (Zenzic flagged a legitimate documentation link)
+- [ ] **Build failure** (yarn build / Docusaurus rendering error)
+- [ ] **Flakiness** (network fetch during build, `yarn install` failure)
+- [ ] **Infrastructure** (GitHub Actions / local runner offline)
+- [ ] **Technical debt** (broken link introduced by upstream content change)
+- [ ] **Other** — describe:
+
+## 🛠️ 4. Remediation
+
+> Concrete change to the gate so this bypass becomes unnecessary in the future. Link the follow-up PR/issue here.
+
+## ⏳ 5. Timeline & Scope
+
+- **Bypass commit SHA / branch / PR:**
+- **Bypass author:** (informational only — blameless)
+- **Bypass time → post-mortem time** (max 24h):
+- **Permanent fix merged at:**
+
+---
+
+*Bypass closed only when the permanent fix lands. Until then this issue stays open and is reviewed at every sprint retrospective.*

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,56 @@
+<!-- SPDX-FileCopyrightText: 2026 PythonWoods <dev@pythonwoods.dev> -->
+<!-- SPDX-License-Identifier: Apache-2.0 -->
+<!-- markdownlint-disable MD041 -->
+
+## Description
+
+<!-- Describe your changes in detail. Link the issue this PR resolves. -->
+
+Closes #
+
+## Type of change
+
+- [ ] Bug fix (broken link, rendering error, build failure)
+- [ ] New content (tutorial, how-to, blog post, ADR)
+- [ ] Translation (EN ↔ IT)
+- [ ] Structural / navigation change
+- [ ] Dependency update (npm, Docusaurus version)
+
+---
+
+## Documentation Quality — mandatory checklist
+
+Every PR touching `docs/`, `blog/`, `src/`, or `i18n/` must satisfy all that apply.
+
+### 1. Accuracy & Link Validity
+
+- [ ] All new internal links use relative paths and have been verified locally
+  (`just check` or `yarn build` must pass without broken-link errors).
+- [ ] External links point to canonical, stable URLs — not redirects or preview deployments.
+- [ ] Code samples have been tested against the referenced Zenzic version.
+
+### 2. EN / IT Parity
+
+- [ ] The English source file(s) in `docs/`, `blog/`, or `src/` have been updated (or are unchanged).
+- [ ] The corresponding Italian file(s) in `i18n/it/` have been updated — **or** I have left a
+  comment below explaining why parity is deferred and which Core Maintainer will handle the translation.
+
+> **Graceful Degradation clause** — If you don't speak Italian, update the English files and
+> leave a comment here. A Core Maintainer will handle the Italian translation.
+
+### 3. Build & Zenzic Self-Check
+
+- [ ] `yarn build` completes without errors locally.
+- [ ] `just check` (Zenzic self-audit of this documentation portal) passes without new findings.
+- [ ] REUSE/SPDX headers are present on every new file.
+
+### 4. D.I.A. (Documentation Impact Analysis)
+
+- [ ] **D.I.A. (Documentation Impact Analysis):** I have evaluated the impact of this code change on the public documentation.
+  - *If impacted:* [ ] I have opened a PR on `zenzic-doc` OR [ ] I request maintainer assistance to update the docs.
+
+---
+
+## Notes for reviewers
+
+<!-- Anything unusual about this PR that reviewers should know? -->