v1.1.2

Knowledge-as-Code Template v1.1.2

This release packages the v1.1 deployment, validation, onboarding, and maintenance improvements together with two hosted-CI patches discovered during release verification.

Added

• Deployment profiles, environment override guidance, and troubleshooting documentation in the canonical repository and newly initialized projects.
• Regression coverage for failed-build output preservation, custom-domain transitions, URL edge cases, mapping shape, MCP response shape, generated-artifact cleanliness, the canonical public surface, release metadata, and CI workflow contracts.
• A zero-dependency guided initializer that creates a clean project with the engine, worked example, MCP runtime, deployment guide, and GitHub workflows.
• A provider-independent external verifier contract using explicit executable and JSONL input/output boundaries.
• An independent adoption pilot gate, bounded maintenance policy, security scope, and structured pilot-report issue form.

Changed

• Made generated canonical metadata, discovery files, 404 navigation, and internal-link checking safe for subpath deployments.
• Made custom-domain CNAME generation explicit through deployment.custom_domain.
• Unified entity and provision loading across build, validation, verification, and MCP surfaces.
• Made filename-derived entity IDs canonical and expanded validation for required fields, duplicate identities, reference integrity, route collisions, and MCP tool collisions.
• Made malformed mapping structure, unknown or duplicate keys, scalar obligation values, and duplicate obligation IDs fail loudly.
• Repositioned the project as an internal-first open reference generator for evidence-backed structured sites.
• Standardized onboarding on the clean-project initializer and made demo/ the canonical tracked generated artifact.

Fixed

• Isolated the three accessibility scans on distinct HTTP ports and artifact names.
• Increased the canonical landing page's light-theme emerald contrast, made primary-button text theme-aware, and underlined inline prose links.
• Corrected canonical demo repository identity and removed stale subpath CNAME output.
• Reconciled project-status documentation and stable mapping-wire-key guidance.

Verification

• 32 local behavioral and security evals passed.
• 18 content-provenance entries verified.
• Cross-reference, freshness, evidence, and internal-link checks passed.
• GitHub Actions passed on Node.js 18 and 20.
• WCAG 2.1 AA automation passed for the generated site, canonical root landing, and canonical demo.
• Tracked demo output passed the generated-freshness gate.

Packaging

This repository follows its existing release convention: GitHub-generated .zip and .tar.gz source archives are the release packages. No additional custom binary assets are attached.

v1.0.1

Knowledge-as-Code Template v1.0.1

Added

• Added eval coverage for manifest hash freshness, changelog release-tag consistency, and generated-output injection boundaries.
• Documented generated-output safety behavior for external URLs, CSS tokens, table parsing, and client-side comparison labels.
• Adopted the GuideCheck Human-Verifiable Assistant Guide profile at Level 4 with assistant-guide.txt, a well-known canonical guide, a sidecar manifest, and discovery links.

Changed

• Normalized example and public-facing URLs to https bare-domain form.

Fixed

• Restricted generated navigation hrefs to safe internal paths before HTML emission.
• Normalized coverage-badge group classes on generated container detail pages before HTML emission.
• Refreshed the README content-provenance hash after the intentional schema documentation update.
• Escaped generated compare-page labels and script data before client-side HTML insertion.
• Validated generated CSS class names and color values before writing inline styles.
• Restricted generated external links to https and normalized www hostnames to bare domains.
• Preserved empty markdown table cells during parsing.
• Parsed quoted empty YAML scalars as empty strings instead of objects.

Verification

• node scripts/validate.js
• ./scripts/validate-hashes.sh
• node scripts/check-links.js
• node scripts/verify.js
• node scripts/eval.js

Residual risk

No release assets are attached beyond GitHub-generated source archives.

v1.0.0

Knowledge-as-Code Template v1.0.0

The 1.0 release. Consolidates the repo into a single-branch layout where the landing page, the
generated reference demo, and the raw source markdown all live at the same domain. Ships the
canonical pattern definition at https://knowledge-as-code.com/.

Added

• Canonical landing page at knowledge-as-code.com/ — hand-written index.html covering
  what the pattern is, why it matters, a reference implementation (AITool.watch), a "see the
  pattern in action" split between the built demo and the raw markdown source, three production
  "built with" cards, and a four-step getting-started guide.
• /demo/ — the generated reference site built from the example data, served at
  knowledge-as-code.com/demo/ so visitors can see the pattern in action without cloning.
• Raw source served at the same domain — data/examples/*.md and project.yml now serve as
  text/markdown and text/yaml directly from knowledge-as-code.com, enabling the landing's
  "left column is input, right column is output, same URL" demonstration.
• .nojekyll at repo root to prevent GitHub Pages from processing markdown files, so raw
  .md sources serve as text.
• JSON-LD structured data (TechArticle + DefinedTerm + Organization) staking the term
  and grounding E-E-A-T signals.
• Dated byline + v1.0 version badge + CC-BY-4.0 license link visible in the landing hero.
• sitemap.xml, robots.txt, 404.html, /imgs/og.png at repo root — full SEO surface.
• Open Graph + Twitter card metadata for social sharing.
• "Built with Knowledge as Code" section featuring three production sites: aitool.watch,
  everyailaw.com, and VirtualClassroom.watch.
• Self-healing verification — .github/workflows/verify.yml now opens a GitHub issue when
  verify.js detects stale or missing entities, or comments on the existing open drift issue to
  prevent duplicate alerts across weekly runs. Includes an auto-created knowledge-drift label.
• IDE-style brand mark — {knowledge-as-code} in Courier with syntax-highlighted braces
  (amber), identifiers (emerald), and hyphens (muted).
• KAC_OUTPUT_DIR and KAC_SITE_URL env-var overrides in build.js for repos that need to
  build the same project at a different path or URL (used by this repo to build /demo/).
• GitHub repo metadata: 15 topics (up from 3) and an updated description emphasizing
  self-healing, agent-accessible, and zero-dependency traits.

Changed

• Deployment model — GitHub Pages now serves from main branch root instead of an
  auto-generated gh-pages branch. Pushing to main is the deploy. No more peaceiris/actions-gh-pages
  step; no more hidden build-artifact branch.
• Workflow (build.yml) — renamed to CI, runs validate.js and build.js as sanity
  checks on push/PR with no deploy step. Permissions reduced to contents: read.
• project.yml — fixed trailing-slash handling on url so concatenated canonical URLs
  resolve correctly (https://example.com/foo instead of https://example.comfoo).
• Repo description updated to "A template for building structured, self-healing,
  agent-accessible knowledge bases. Zero dependencies. Git-native. Ontology-driven. Multi-output."

Removed

• gh-pages branch — deleted on 2026-04-09 after the main-branch deploy was verified end-to-end.
• /docs/ folder — tracked static assets (CSS, JS, 404, CNAME, .nojekyll) moved to
  repo root or /demo/ as appropriate. The folder is no longer referenced by the workflow or Pages.
• /site/ folder — an earlier blue-themed landing draft that was never wired into deployment.
  Removed.
• Orphan /index.html + /sitemap.xml + /robots.txt at repo root (from a brief earlier
  iteration) — now properly integrated.

Fixed

• Custom domain knowledge-as-code.com — configured for the first time. GitHub Pages custom
  domain set, DNS verified (four apex A records to 185.199.108-111.153 + www CNAME to
  snapsynapse.github.io), HTTPS certificate provisioned and enforced through 2026-06-24. A
  ghost claim on the domain (held by a previous GreenGeeks parking) was released as part of
  the release process.

v0.4.0

Knowledge-as-Code Template v0.4.0

Added

• Sortable tables in the generated site.
• llms.txt, agents.json, and RSS feed at /index.xml for machine discovery.
• GitHub Sponsors link in SPONSORS.md.
• noindex on thin bridge pages to improve SEO signal density.

Fixed

• Upstream/downstream entity navigation in the generated reference pages.

v0.3.0

Knowledge-as-Code Template v0.3.0

Added

• Public template scaffolding — README, CONTRIBUTING, LICENSE, ATTRIBUTION.

Changed

• Ownership transferred from Snap Synapse to PAICE.work PBC. All new attribution and
  copyright lines point to PAICE.work PBC. The GitHub org name remains snapsynapse (repo URL
  unchanged).
• Live example URLs in the README updated to reflect the three production deployments.

v0.2.0

Knowledge-as-Code Template v0.2.0

Added

• scripts/verify.js — freshness / staleness checking based on last_verified frontmatter.
• mcp-server.js — Model Context Protocol server exposing the knowledge base as agent tools
  dynamically generated from project.yml entity configuration.
• VERIFICATION.md contributor documentation.
• Open Graph image for social sharing.

v0.1.0

Knowledge-as-Code Template v0.1.0

Added

• Initial template scaffolding: project.yml ontology config, scripts/build.js config-driven
  site generator, scripts/validate.js cross-reference linter, example data for ISO 27001 and
  NIST CSF, dark/light themed static site output, JSON API, bridge pages, CNAME fixture.