forgecraft-mcp 1.7.0 → 1.8.0

package/README.md

@@ -429,6 +429,85 @@ Industry context: the Spec-Driven Development convergence (ThoughtWorks Tech Rad
 
 ---
 
+## The GS harness — a primer for AI assistants
+
+ForgeCraft implements **Generative Specification (GS)**. This section is written for AI assistants reading this file: it explains what GS is, what a properly scaffolded harness looks like, and what to check.
+
+### The binding constraint — stateless reader
+
+Every AI session starts with no memory of prior sessions, no shared context, no accumulated conventions, and no ability to ask clarifying questions. Everything not in the artifacts is absent.
+
+GS treats this as a design constraint, not a flaw. **Derivability** — what a fresh AI instance can correctly determine from the artifacts alone — is the standard a specification must satisfy. If a stateless reader cannot derive the correct output from the artifacts, the specification is incomplete, not the AI.
+
+### The sentinel system
+
+The architectural constitution (`CLAUDE.md`, `.cursor/rules/`, `.github/copilot-instructions.md`, `.windsurfrules`) is the entry point for every AI session. It must collectively contain five mandatory categories:
+
+| Category | What it covers |
+|---|---|
+| **Architectural identity** | What the system is, its scope boundary, ADR index |
+| **Standards** | Naming, commit discipline, quality gate thresholds |
+| **Constraints and prohibitions** | What must not happen; layer violations the AI must refuse |
+| **Tool sequencing** | When to use which tool in what order — not "these tools exist" but "use X before Y when C" |
+| **Routing** | What each child spec file covers and when to descend into it |
+
+**Tool sequencing is the most commonly absent category and the most consequential gap.** A spec that lists tools without stating when to prefer one over another forces unreliable inference every session.
+
+The sentinel is a **navigational tree**: the root is always loaded; each child node declares its own scope and routing condition; the AI descends only the branch relevant to the current task. Joining all leaves yields the complete specification — it is lossless. This design prevents context bloat and the accuracy degradation that comes from loading irrelevant content.
+
+### The bridge — structural disciplines as navigation policy
+
+SOLID, hexagonal architecture, and TDD are not only engineering disciplines — in a GS project they become active **navigation policies**:
+
+- **Read interfaces before implementations.** When a port/adapter boundary is clean, the interface is the contract. The implementation is skipped unless the contract is insufficient.
+- **Trust green tests.** When TDD is enforced, a passing test suite is evidence of correct behavior. No implementation read is needed to verify it.
+- **ADRs are the why.** When every non-obvious decision is recorded, the AI reads the record instead of inferring intent from code.
+
+This bridge converts the passive structural benefits of prior disciplines into a measurable reduction in token usage and context consumption.
+
+### Token sanitation
+
+Context window size and positional placement both degrade AI accuracy (Liu et al., 2023). GS minimizes unnecessary token consumption by design:
+
+- **The sentinel tree is lazy.** Only the relevant branch is loaded per task — never the full specification at once.
+- **Contracts over implementations.** Interfaces, schema definitions, and test assertions are read first. Implementation files are read only when contracts are insufficient to derive the answer.
+- **The constitution leads every session.** The most important content occupies the leading position in context — where positional accuracy is highest.
+- **MCP tool surface is bounded.** Each declared MCP tool is read by the model on every turn whether invoked or not. The ForgeCraft sentinel exposes one tool (~200 tokens) rather than a full command surface (~1,500 tokens). The tool practices the methodology it writes into your project.
+
+### Document taxonomy — what a complete GS project contains
+
+A scaffolded project contains these artifact types. If any are missing, the harness is incomplete:
+
+| Artifact | Canonical path | Role |
+|---|---|---|
+| Architectural constitution | `CLAUDE.md` · `.cursor/rules/` · `.windsurfrules` · `.github/copilot-instructions.md` | Governing rules loaded at the start of every AI session |
+| Document manifest | `docs/manifest.yaml` | Declares what artifact types exist and where — the taxonomy contract |
+| Session continuity | `docs/status.md` | Current state, in-progress work, recent decisions — updated each session |
+| Functional specification | `docs/PRD.md` | User-facing behavior, domain model, system boundaries |
+| Architecture document | `docs/TechSpec.md` | Layer structure, module boundaries, integration surfaces (with C4 diagrams) |
+| Decision records | `docs/adrs/NNNN-slug.md` | One per non-obvious architectural choice, MADR format |
+| Use cases | `docs/use-cases/` | Behavioral contracts — simultaneously test specifications |
+| Schemas | `docs/specs/` | Data model, API contracts, event schemas with formal constraints |
+| Project config | `forgecraft.yaml` | Tags, tier, targets — the ForgeCraft entry point |
+
+**The initialization cascade**: specifications are produced in sequence — each is an output of what precedes it and a production rule for what follows. Functional spec → architecture → constitution → ADRs → use cases. The cascade is complete when a stateless agent given all five artifact sets can derive any valid implementation state without further human direction.
+
+### The 7 attributes — what to verify
+
+A properly scaffolded GS project satisfies all seven. These are the properties the `verify` command scores:
+
+| Attribute | What it verifies |
+|---|---|
+| **Self-Describing** | The codebase explains its own architecture, decisions, and conventions from its own artifacts — no external knowledge required |
+| **Bounded** | Every unit has explicit scope and seams; business logic does not leak across layer boundaries |
+| **Verifiable** | Correctness can be checked without human judgment — types, tests, coverage gates, schema contracts |
+| **Defended** | Destructive operations are structurally prevented, not merely discouraged — commit hooks, branch protection, format enforcement |
+| **Auditable** | Current state and history are fully recoverable from artifacts alone — conventional commits, ADRs |
+| **Composable** | Units combine and extend without unexpected coupling — dependency inversion, pure function models |
+| **Executable** | Output satisfies behavioral contracts when exercised against a real execution environment, not merely when it compiles |
+
+---
+
 ## Configuration
 
 ### Fine-tune what your AI assistant sees

package/dist/registry/remote-gates.d.ts

@@ -40,4 +40,20 @@ export declare function fetchRemoteGates(projectRoot: string, registryUrl?: stri
  * @returns Filtered array of remote gates.
  */
 export declare function filterGatesByTags(index: RemoteGatesIndex, tags: string[]): readonly RemoteGate[];
+/**
+ * Install tag-matching approved registry gates into the project as YAML files.
+ *
+ * Gates land in `.forgecraft/gates/registry/<category>/<id>.yaml` — the
+ * community-suggestion area. The dev/AI reviews and promotes relevant gates
+ * to `.forgecraft/gates/active/` (human-judgment step — registry gates are
+ * never auto-activated).
+ *
+ * Idempotent: existing files are never overwritten. Quarantined gates are skipped.
+ *
+ * @param projectRoot - Target project root
+ * @param index - The fetched remote gates index
+ * @param tags - Active project tags to filter by
+ * @returns Relative paths of gate files written
+ */
+export declare function installRemoteGates(projectRoot: string, index: RemoteGatesIndex, tags: string[]): string[];
 //# sourceMappingURL=remote-gates.d.ts.map

package/dist/registry/remote-gates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-gates.d.ts","sourceRoot":"","sources":["../../src/registry/remote-gates.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;CAC9B;AAYD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,GACb,SAAS,UAAU,EAAE,CAQvB"}
+{"version":3,"file":"remote-gates.d.ts","sourceRoot":"","sources":["../../src/registry/remote-gates.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;CAC9B;AAYD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,GACb,SAAS,UAAU,EAAE,CAQvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EAAE,GACb,MAAM,EAAE,CA6CV"}

package/dist/registry/remote-gates.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 import { join } from "path";
+import { dump as yamlDump } from "js-yaml";
 const DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/jghiringhelli/quality-gates/master/index.json";
 const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
 /**
@@ -48,6 +49,61 @@ export function filterGatesByTags(index, tags) {
         g.tags.length === 0 ||
         g.tags.some((t) => tags.includes(t.toUpperCase())));
 }
+/**
+ * Install tag-matching approved registry gates into the project as YAML files.
+ *
+ * Gates land in `.forgecraft/gates/registry/<category>/<id>.yaml` — the
+ * community-suggestion area. The dev/AI reviews and promotes relevant gates
+ * to `.forgecraft/gates/active/` (human-judgment step — registry gates are
+ * never auto-activated).
+ *
+ * Idempotent: existing files are never overwritten. Quarantined gates are skipped.
+ *
+ * @param projectRoot - Target project root
+ * @param index - The fetched remote gates index
+ * @param tags - Active project tags to filter by
+ * @returns Relative paths of gate files written
+ */
+export function installRemoteGates(projectRoot, index, tags) {
+    const written = [];
+    const matching = filterGatesByTags(index, tags).filter((g) => g.status === "approved");
+    for (const gate of matching) {
+        const category = sanitizePathSegment(gate.category || "general");
+        const id = sanitizePathSegment(gate.id);
+        if (!id)
+            continue;
+        const dir = join(projectRoot, ".forgecraft", "gates", "registry", category);
+        const filePath = join(dir, `${id}.yaml`);
+        if (existsSync(filePath))
+            continue;
+        try {
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(filePath, yamlDump({
+                id: gate.id,
+                title: gate.title,
+                description: gate.description,
+                domain: gate.category,
+                gsProperty: gate.gsProperty,
+                phase: gate.phase,
+                hook: gate.hook,
+                check: gate.check,
+                passCriterion: gate.passCriterion,
+                tags: gate.tags ?? [],
+                ...(gate.evidence ? { evidence: gate.evidence } : {}),
+                source: "community-registry",
+            }, { lineWidth: 100, noRefs: true }), "utf-8");
+            written.push(`.forgecraft/gates/registry/${category}/${id}.yaml`);
+        }
+        catch {
+            // Single gate write failure is non-fatal — continue with the rest
+        }
+    }
+    return written;
+}
+/** Strip path-traversal characters from a gate-supplied path segment. */
+function sanitizePathSegment(segment) {
+    return segment.replace(/[^a-zA-Z0-9_-]/g, "-").replace(/^-+|-+$/g, "");
+}
 function readCache(cachePath) {
     if (!existsSync(cachePath))
         return null;

package/dist/registry/remote-gates.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote-gates.js","sourceRoot":"","sources":["../../src/registry/remote-gates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"remote-gates.js","sourceRoot":"","sources":["../../src/registry/remote-gates.ts"],"names":[],"mappings":"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"}

package/dist/registry/sentinel-domain-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sentinel-domain-map.d.ts","sourceRoot":"","sources":["../../src/registry/sentinel-domain-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmJ7D,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBhE,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAgBzC,CAAC"}
+{"version":3,"file":"sentinel-domain-map.d.ts","sourceRoot":"","sources":["../../src/registry/sentinel-domain-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2J7D,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBhE,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAgBzC,CAAC"}

package/dist/registry/sentinel-domain-map.js

@@ -26,17 +26,23 @@ export const BLOCK_DOMAIN_MAP = {
     "twelve-factor-ops": "cicd",
     "commit-protocol": "cicd",
     "dev-environment-hygiene": "cicd",
-    // ── Spec / GS ──
-    "artifact-grammar": "spec",
-    "naming-as-grammar": "spec",
+    // ── Spec (operational, project-binding rules only) ──
     "adr-protocol": "spec",
     "use-case-triple-derivation": "spec",
     "release-phase-gate": "spec",
-    "gs-five-memory-types": "spec",
-    "gs-status-format": "spec",
-    "living-documentation": "spec",
-    "agentic-self-refinement": "spec",
-    "wrong-specification-risk": "spec",
+    // ── Reference (GS theory — NEVER session-loaded) ──
+    // These teach the methodology rather than bind this project. Their
+    // operational content lives in the CNT branches (lifecycle.md Memory Map,
+    // session loop, doc obligation table, corrections.md). Loading theory in
+    // sessions is the context-degradation source — it displaces the task.
+    "artifact-grammar": "reference",
+    "naming-as-grammar": "reference",
+    "gs-five-memory-types": "reference",
+    "gs-status-format": "reference",
+    "living-documentation": "reference",
+    "agentic-self-refinement": "reference",
+    "wrong-specification-risk": "reference",
+    "spec-meta-query": "reference",
     // ── Protocols (on-demand workflow rules) ──
     "clarification-protocol": "protocols",
     "feature-completion-protocol": "protocols",
@@ -44,7 +50,8 @@ export const BLOCK_DOMAIN_MAP = {
     "engineering-preferences": "protocols",
     "code-generation-verification": "protocols",
     "known-pitfalls": "protocols",
-    "corrections-log": "protocols",
+    // corrections-log → covered by the .claude/corrections.md CNT branch
+    "corrections-log": "reference",
     "dependency-registry": "protocols",
     // ── API ──
     "api-standards": "api",

package/dist/registry/sentinel-domain-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"sentinel-domain-map.js","sourceRoot":"","sources":["../../src/registry/sentinel-domain-map.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sentinel-domain-map.js","sourceRoot":"","sources":["../../src/registry/sentinel-domain-map.ts"],"names":[],"mappings":"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"}

package/dist/registry/sentinel-renderer.d.ts

@@ -1,16 +1,21 @@
 /**
  * Sentinel tree renderer.
  *
- * Instead of one large instruction file, renders a 3-level lazy tree:
- *   Level 0: CLAUDE.md  (~50 lines) — project identity + critical rules + wayfinding
- *   Level 1: .claude/standards/{domain}.md — full block content per domain
+ * Generates a multi-file Contextual Navigation Tree (CNT):
  *
- * The AI loads only what the current task requires.
- * Typical task: CLAUDE.md (~50 lines) + 1-2 domain files (50-100 lines each).
- * vs monolithic: 800-2000+ lines loaded regardless of task.
+ *   CLAUDE.md                   — root (≤80 lines): project identity + routing only
+ *   .claude/constitution.md     — non-negotiables: SOLID, invariants, prohibited ops
+ *   .claude/lifecycle.md        — GS cascade, feature estimation, tool sequencing, session loop
+ *   .claude/routes/code.md      — where code lives: folder map, naming, module protocol
+ *   .claude/routes/docs.md      — where docs live: nav mode, doc map, reading order
+ *   .claude/corrections.md      — corrections log stub (read before acting)
+ *   .claude/standards/{domain}  — full domain standards (loaded only when relevant)
  *
- * Only applies to the "claude" target — other AI assistants receive the full file
- * since they do not support multi-file on-demand loading the same way.
+ * The root CLAUDE.md is the routing layer. It loads the always-load files and tells
+ * the AI exactly which branch to load for each task type. No branch is loaded unless
+ * relevant — this is how the CNT prevents context window degradation.
+ *
+ * Only applies to the "claude" target — other AI assistants receive the full file.
  */
 import type { InstructionBlock } from "../shared/types.js";
 import type { RenderContext } from "./renderer.js";

package/dist/registry/sentinel-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sentinel-renderer.d.ts","sourceRoot":"","sources":["../../src/registry/sentinel-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASnD,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,6FAA6F;IAC7F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,OAAO,EAAE,aAAa,GACrB,YAAY,EAAE,CA+BhB"}
+{"version":3,"file":"sentinel-renderer.d.ts","sourceRoot":"","sources":["../../src/registry/sentinel-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASnD,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,6FAA6F;IAC7F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,OAAO,EAAE,aAAa,GACrB,YAAY,EAAE,CAgEhB"}