Release v1.1.0

Author: snapsynapse

CHANGELOG.md

@@ -14,27 +14,32 @@ pattern.
 
 ## [Unreleased]
 
+## [1.1.0] - 2026-07-25
+
+### Added
+- Added deployment profiles, environment override guidance, and troubleshooting documentation to the canonical repository and newly initialized projects.
+- Added output-preservation, CNAME-transition, URL-edge, mapping-shape, MCP response-shape, generated-artifact cleanliness, public-surface, and CI workflow regression coverage.
+- Added a zero-dependency guided initializer that creates a clean project with the engine, worked example, MCP runtime, and deployment workflows.
+- Added a provider-independent external verifier contract using explicit executable and JSONL input/output boundaries.
+- Added an independent adoption pilot gate, bounded maintenance policy, security scope, and structured pilot-report issue form.
+
 ### Changed
-- Added deployment profiles and troubleshooting guidance, strict mapping-shape parsing, and regression coverage for output preservation, custom-domain transitions, URL edge cases, MCP response shape, generated-artifact cleanliness, and CI workflow contracts.
 - Made generated URL metadata and 404 navigation path-aware for subpath deployments.
 - Made internal-link checking deployment-base-aware for subpath output.
 - Made custom-domain CNAME generation explicit instead of deriving it from the published URL.
 - Unified entity and provision loading across build, validation, verification, and MCP surfaces.
 - Made filename-derived entity IDs canonical and expanded validation for required fields, duplicates, and generated-route collisions.
+- Made malformed mapping structure, unknown or duplicate keys, scalar obligation values, and duplicate obligation IDs fail loudly.
 - Clarified initializer scope, stable mapping wire keys, current project status, and canonical demo identity.
 - Expanded CI and eval coverage for the advertised Node.js minimum, URL validation, subpath deployment, identity mismatches, duplicate mappings, and the canonical public surface.
 - Repositioned the project as an internal-first open reference generator for evidence-backed structured sites.
 - Replaced unqualified self-healing claims with the deterministic drift checks the repository actually ships.
 - Distinguished maintainer-operated implementations from independent external adoption.
 - Standardized onboarding on the clean-project initializer and added a Pages deployment workflow for generated repositories.
 - Corrected the canonical Snap Synapse writeup path and acknowledged established prior art.
-- Added a zero-dependency guided initializer that creates a clean project with only the engine, worked example, MCP runtime, and deployment workflows.
 - Made `docs/` transient local output in the canonical repository; `demo/` is now the only tracked generated build.
 - Expanded deterministic verification to fail on missing reviews, invalid or future dates, mapping gaps, and required evidence metadata.
-- Added a provider-independent external verifier contract using an explicit executable and JSONL input/output, with no shell or source-file mutation.
 - Re-verified the worked example against current ISO and NIST primary sources, corrected unsupported claims, and replaced the ambiguous data-quality mapping with information integrity.
-- Documented the internal-first operating model, bounded maintenance policy, security scope, viable open-repository end state, and independent adoption pilot gate.
-- Added a structured GitHub issue form for independent pilot reports.
 
 ## [1.0.2] — 2026-06-12
 
@@ -175,7 +180,8 @@ canonical pattern definition at <https://knowledge-as-code.com/>.
   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.
 
-[Unreleased]: https://github.com/snapsynapse/knowledge-as-code-template/compare/v1.0.2...HEAD
+[Unreleased]: https://github.com/snapsynapse/knowledge-as-code-template/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/snapsynapse/knowledge-as-code-template/releases/tag/v1.1.0
 [1.0.2]: https://github.com/snapsynapse/knowledge-as-code-template/releases/tag/v1.0.2
 [1.0.1]: https://github.com/snapsynapse/knowledge-as-code-template/releases/tag/v1.0.1
 [1.0.0]: https://github.com/snapsynapse/knowledge-as-code-template/releases/tag/v1.0.0

MANIFEST.yaml

@@ -27,8 +27,8 @@
 #   - This file itself
 
 bundle: knowledge-as-code-template
-bundle_version: 1.0.2
-bundle_date: 2026-06-12
+bundle_version: 1.1.0
+bundle_date: 2026-07-25
 description: >
   Knowledge as Code starter template — scaffolds a KaC site with
   Primary/Container/Authority/Secondary entities, gist ontology binding,
@@ -112,12 +112,12 @@ files:
 
   - path: scripts/eval.js
     role: tooling
-    hash: sha256:6b9bcb6254884340cb0186c6cac73c34fdae57b07f44aea5a696cf44220e672e
+    hash: sha256:7e54c1463d232c5bd547efcd9176705e4e988439dd9536c07f308a43cb9ea8ff
     note: Behavioral and security regression suite
 
   - path: mcp-server.js
     role: tooling
-    hash: sha256:4d0581cda1be5b0e7aea639e3db8fc15a2a2607a85ac447d5c25a40d0458372b
+    hash: sha256:7a6e590449baa4eaff376e8a23d5bedbcf8a546d1a75d149287bc0c13517840f
     note: Read-only MCP interface over canonical project data
 
   - path: scripts/check-links.js

index.html

@@ -569,7 +569,7 @@ <h1><span class="mark">Knowledge as Code</span></h1>
     <span class="sep">·</span>
     Updated <time datetime="2026-07-25">July 25, 2026</time>
     <span class="sep">·</span>
-    <span class="version">v1.0</span>
+    <span class="version">v1.1</span>
     <span class="sep">·</span>
     <a href="https://creativecommons.org/licenses/by/4.0/" rel="license">CC&nbsp;BY&nbsp;4.0</a>
   </p>

mcp-server.js

@@ -13,6 +13,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const packageMetadata = require('./package.json');
 const { loadProjectData } = require('./scripts/lib/data-loaders');
 const { parseYaml } = require('./scripts/lib/parsers');
 
@@ -325,7 +326,7 @@ function handleMessage(msg) {
             capabilities: { tools: {} },
             serverInfo: {
                 name: config.name || 'Knowledge Base MCP',
-                version: '1.0.0'
+                version: packageMetadata.version
             }
         });
     }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "knowledge-as-code-template",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Zero-dependency generator for evidence-backed reference sites from Git-tracked Markdown and YAML.",
   "license": "MIT",
   "scripts": {

scripts/eval.js

@@ -891,6 +891,25 @@ function evalWorkflowContract() {
     ]) assertIncludes(workflow, required);
 }
 
+function evalReleaseMetadata() {
+    const packageMetadata = readJson(path.join(ROOT, 'package.json'));
+    const version = packageMetadata.version;
+    assert.match(version, /^\d+\.\d+\.\d+$/, 'package.json must contain a stable semantic version.');
+
+    const changelog = fs.readFileSync(path.join(ROOT, 'CHANGELOG.md'), 'utf8');
+    const manifest = fs.readFileSync(path.join(ROOT, 'MANIFEST.yaml'), 'utf8');
+    const landing = fs.readFileSync(path.join(ROOT, 'index.html'), 'utf8');
+    assertIncludes(changelog, `## [${version}]`);
+    assertIncludes(manifest, `bundle_version: ${version}`);
+    assertIncludes(landing, `<span class="version">v${version.split('.').slice(0, 2).join('.')}</span>`);
+
+    const request = JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params: {} }) + '\n';
+    const mcp = spawnSync(process.execPath, ['mcp-server.js'], { cwd: ROOT, encoding: 'utf8', input: request });
+    assert.strictEqual(mcp.status, 0, `MCP release metadata check failed:\n${mcp.stdout}\n${mcp.stderr}`);
+    const response = JSON.parse(mcp.stdout.trim());
+    assert.strictEqual(response.result.serverInfo.version, version);
+}
+
 function evalMcpNotificationSilence() {
     const notification = '{"jsonrpc":"2.0","method":"unknown","params":{}}\n';
     const result = spawnSync(process.execPath, ['mcp-server.js'], {
@@ -966,6 +985,7 @@ const evals = [
     ['MCP notification silence', evalMcpNotificationSilence],
     ['generated artifact cleanliness', evalGeneratedArtifactCleanliness],
     ['workflow contract', evalWorkflowContract],
+    ['release metadata', evalReleaseMetadata],
     ['docs consistency', evalDocsConsistency]
 ];