forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/scaffold-templates.js

@@ -1,76 +1,76 @@
 /**
  * scaffold-templates: Static template strings and render functions for scaffold_project.
  */
-export const PROJECT_SPECIFIC_TEMPLATE = `# Project-Specific Rules
-<!-- This file is owned by YOU. ForgeCraft will never overwrite it. -->
-<!-- Add project-specific rules, framework choices, conventions, and corrections here. -->
-<!-- The sentinel CLAUDE.md links here so any AI reading your project can find it. -->
-
-## Framework & Stack Choices
-<!-- e.g. We use Prisma for ORM. Deploy target is Railway. Python 3.11+. -->
-
-## Custom Corrections Log
-<!-- Log AI corrections so the pattern isn't repeated. -->
-<!-- Format: - YYYY-MM-DD: [description of correction] -->
-
-## Project-Specific Gates
-<!-- Add quality rules specific to this project that don't belong in universal standards. -->
+export const PROJECT_SPECIFIC_TEMPLATE = `# Project-Specific Rules
+<!-- This file is owned by YOU. ForgeCraft will never overwrite it. -->
+<!-- Add project-specific rules, framework choices, conventions, and corrections here. -->
+<!-- The sentinel CLAUDE.md links here so any AI reading your project can find it. -->
+
+## Framework & Stack Choices
+<!-- e.g. We use Prisma for ORM. Deploy target is Railway. Python 3.11+. -->
+
+## Custom Corrections Log
+<!-- Log AI corrections so the pattern isn't repeated. -->
+<!-- Format: - YYYY-MM-DD: [description of correction] -->
+
+## Project-Specific Gates
+<!-- Add quality rules specific to this project that don't belong in universal standards. -->
 `;
 export const EXCEPTIONS_TEMPLATE = JSON.stringify({
     version: "1",
     _comment: "Hook false-positive exceptions. Add entries here to prevent rediscovering the same false positive each session. Each entry: {id, hook, pattern, reason, addedAt, addedBy, adr?}",
     exceptions: [],
 }, null, 2) + "\n";
-export const PROJECT_GATES_TEMPLATE = `version: "1"
-# Project-specific quality gates.
-# Gates you discover while working that should be enforced for this project.
-# Set generalizable: true + fill in evidence to contribute to the community registry.
-# See: https://github.com/jghiringhelli/quality-gates/issues/new?template=quality-gate-proposal.md
-gates: []
+export const PROJECT_GATES_TEMPLATE = `version: "1"
+# Project-specific quality gates.
+# Gates you discover while working that should be enforced for this project.
+# Set generalizable: true + fill in evidence to contribute to the community registry.
+# See: https://github.com/jghiringhelli/quality-gates/issues/new?template=quality-gate-proposal.md
+gates: []
 `;
-export const SMOKE_TESTS_README = `# Smoke Tests
-
-Generated by ForgeCraft scaffold. Fill in the critical paths from your tech spec.
-
-## What smoke tests cover
-- Every API entry point that serves real users
-- Every critical user journey end-to-end
-- Every DB migration (verify schema applied correctly)
-- Every external integration handshake
-
-## Format
-Use the tool configured in forgecraft.yaml deployment.testing.smokeTool (or default to HTTP assertions).
-All smoke tests must complete in < 60 seconds total.
-
-## Running
-See forgecraft.yaml tools.test or your project's test runner.
-Results are written to .forgecraft/reports/smoke-latest.json.
-
-## Required before deployment
-All smoke tests must pass against staging before any production deploy.
-See verification.yaml deployment-gates phase.
+export const SMOKE_TESTS_README = `# Smoke Tests
+
+Generated by ForgeCraft scaffold. Fill in the critical paths from your tech spec.
+
+## What smoke tests cover
+- Every API entry point that serves real users
+- Every critical user journey end-to-end
+- Every DB migration (verify schema applied correctly)
+- Every external integration handshake
+
+## Format
+Use the tool configured in forgecraft.yaml deployment.testing.smokeTool (or default to HTTP assertions).
+All smoke tests must complete in < 60 seconds total.
+
+## Running
+See forgecraft.yaml tools.test or your project's test runner.
+Results are written to .forgecraft/reports/smoke-latest.json.
+
+## Required before deployment
+All smoke tests must pass against staging before any production deploy.
+See verification.yaml deployment-gates phase.
 `;
-export const LOAD_TESTS_README = `# Load Tests
-
-Generated by ForgeCraft scaffold. Fill in the parameters from your tech spec.
-
-## Parameters (fill in from forgecraft.yaml deployment.testing.load)
-- Concurrent users: [TODO: concurrentUsers from forgecraft.yaml]
-- Target RPS: [TODO: targetRps from forgecraft.yaml]
-- p99 ceiling: [TODO: p99CeilingMs ms]
-- Duration: [TODO: durationSeconds seconds minimum]
-
-## When these parameters are missing
-Deploying without stated load test parameters is full deployment with manual monitoring.
-The paper requires: parameters named in spec BEFORE the test runs, not after.
-Add them to forgecraft.yaml deployment.testing.load before running.
-
-## Tool
-Use the tool configured in forgecraft.yaml deployment.testing.load.tool (k6, Artillery, Locust, etc.)
-Results are written to .forgecraft/reports/load-latest.json.
-
-## Required before pre-release
-See verification.yaml pre-release-hardening phase, load-test step.
+export const LOAD_TESTS_README = `# Load Tests
+
+Generated by ForgeCraft scaffold. Fill in the parameters from your tech spec.
+
+## Parameters (fill in from forgecraft.yaml deployment.testing.load)
+- Concurrent users: [TODO: concurrentUsers from forgecraft.yaml]
+- Target RPS: [TODO: targetRps from forgecraft.yaml]
+- p99 ceiling: [TODO: p99CeilingMs ms]
+- Duration: [TODO: durationSeconds seconds minimum]
+
+## When these parameters are missing
+Deploying without stated load test parameters is full deployment with manual monitoring.
+The paper requires: parameters named in spec BEFORE the test runs, not after.
+Add them to forgecraft.yaml deployment.testing.load before running.
+
+## Tool
+Use the tool configured in forgecraft.yaml deployment.testing.load.tool (k6, Artillery, Locust, etc.)
+Results are written to .forgecraft/reports/load-latest.json.
+
+## Required before pre-release
+See verification.yaml pre-release-hardening phase, load-test step.
 `;
 /**
  * Render the bootstrap README for docs/adrs/.

package/dist/tools/scaffold-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold-writer.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold-writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,oBAAoB,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAoBzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAC7C,OAAO,EAAE,aAAa,EACtB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,gBAAgB,GAAG,IAAI,GAClC,mBAAmB,CAoOrB"}
+{"version":3,"file":"scaffold-writer.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold-writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,oBAAoB,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAoBzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAC7C,OAAO,EAAE,aAAa,EACtB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,gBAAgB,GAAG,IAAI,GAClC,mBAAmB,CAkPrB"}

package/dist/tools/scaffold-writer.js

@@ -10,6 +10,7 @@ import { renderInstructionFile, renderSkill } from "../registry/renderer.js";
 import { renderSentinelTree } from "../registry/sentinel-renderer.js";
 import { writeFileIfMissing } from "../shared/filesystem.js";
 import { ensureGateDirs } from "../shared/project-gates.js";
+import { installGitHooks } from "../shared/hook-installer.js";
 import { resolveTemplatePlaceholders } from "../shared/template-resolver.js";
 import { PROJECT_SPECIFIC_TEMPLATE, EXCEPTIONS_TEMPLATE, PROJECT_GATES_TEMPLATE, renderAdrsReadme, renderGitignore, renderSmokeTestsReadme, renderLoadTestsReadme, } from "./scaffold-templates.js";
 import { buildC4ContextStub, buildC4ContainerStub, buildSequenceDiagramStub, buildStateMachineDiagramStub, buildFlowDiagramStub, USE_CASES_STUB, writeSpecStub, } from "./scaffold-spec-stubs.js";
@@ -71,6 +72,10 @@ export function writeScaffoldFiles(input, composed, context, statusMdContent, pr
         }
     }
     trackWrite("Status.md", join(input.project_dir, "Status.md"), statusMdContent);
+    // Write .claude/state.md placeholder — index.md is written by writeCntFiles (setup-cnt.ts)
+    const claudeDir = join(input.project_dir, ".claude");
+    mkdirSync(claudeDir, { recursive: true });
+    trackWrite(".claude/state.md", join(claudeDir, "state.md"), "# Project State\n_Not yet run. Call close_cycle to generate._\n");
     mkdirSync(join(input.project_dir, "docs"), { recursive: true });
     trackWrite("docs/PRD.md", join(input.project_dir, "docs", "PRD.md"), prdContent);
     trackWrite("docs/TechSpec.md", join(input.project_dir, "docs", "TechSpec.md"), techSpecContent);
@@ -136,6 +141,10 @@ export function writeScaffoldFiles(input, composed, context, statusMdContent, pr
         trackWrite("tests/load/README.md", join(loadDir, "README.md"), renderLoadTestsReadme(userConfig.deployment));
         trackWrite(".forgecraft/reports/.gitkeep", join(reportsDir, ".gitkeep"), "");
     }
+    // Auto-install git hooks after all files are written. Skip silently when
+    // not a git repo (dry-run or detached worktrees). Existing hooks are
+    // preserved (force=false) so husky/lefthook configs are not stomped.
+    installGitHooks(input.project_dir, false);
     return { filesCreated, filesSkipped };
 }
 //# sourceMappingURL=scaffold-writer.js.map

package/dist/tools/scaffold-writer.js.map

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

package/dist/tools/score-rubric.d.ts

@@ -0,0 +1,19 @@
+/**
+ * score_rubric tool handler.
+ *
+ * Gathers evidence for all 7 GS properties and emits a structured evaluation
+ * prompt. The calling LLM scores 0/1/2 per property using the provided criteria
+ * as a starting framework — but is explicitly invited to override, add its own
+ * criteria, and flag anything it finds lacking regardless of what the heuristics say.
+ *
+ * The tool itself performs no scoring. It is a deterministic evidence collector.
+ * The intelligence lives in the LLM that reads its output.
+ *
+ * Read-only — no files written.
+ */
+import type { ToolResult } from "../shared/types.js";
+export interface ScoreRubricInput {
+    readonly project_dir: string;
+}
+export declare function scoreRubricHandler(args: ScoreRubricInput): Promise<ToolResult>;
+//# sourceMappingURL=score-rubric.d.ts.map

package/dist/tools/score-rubric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-rubric.d.ts","sourceRoot":"","sources":["../../src/tools/score-rubric.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOrD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AA0bD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAKrB"}

package/dist/tools/score-rubric.js

@@ -0,0 +1,411 @@
+/**
+ * score_rubric tool handler.
+ *
+ * Gathers evidence for all 7 GS properties and emits a structured evaluation
+ * prompt. The calling LLM scores 0/1/2 per property using the provided criteria
+ * as a starting framework — but is explicitly invited to override, add its own
+ * criteria, and flag anything it finds lacking regardless of what the heuristics say.
+ *
+ * The tool itself performs no scoring. It is a deterministic evidence collector.
+ * The intelligence lives in the LLM that reads its output.
+ *
+ * Read-only — no files written.
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { auditCntHealth } from "../shared/cnt-health.js";
+import { getActiveProjectGates } from "../shared/project-gates.js";
+import { readBrownfieldFlag } from "../shared/config.js";
+// ── Evidence collectors ───────────────────────────────────────────────
+function safeRead(path, maxLines = 20) {
+    try {
+        const lines = readFileSync(path, "utf-8").split("\n");
+        return lines.slice(0, maxLines).join("\n");
+    }
+    catch {
+        return "(not found)";
+    }
+}
+function safeCount(dir, ext) {
+    if (!existsSync(dir))
+        return 0;
+    try {
+        const files = readdirSync(dir);
+        return ext ? files.filter((f) => f.endsWith(ext)).length : files.length;
+    }
+    catch {
+        return 0;
+    }
+}
+function safeCountPattern(dir, pattern) {
+    if (!existsSync(dir))
+        return 0;
+    try {
+        return readdirSync(dir).filter((f) => pattern.test(f)).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function fileWords(path) {
+    try {
+        return readFileSync(path, "utf-8").split(/\s+/).filter(Boolean).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function countMarkers(dir) {
+    if (!existsSync(dir))
+        return 0;
+    const MARKER = "[NEEDS CLARIFICATION]";
+    let count = 0;
+    try {
+        for (const f of readdirSync(dir)) {
+            if (!f.endsWith(".md"))
+                continue;
+            try {
+                const content = readFileSync(join(dir, f), "utf-8");
+                let pos = 0;
+                while ((pos = content.indexOf(MARKER, pos)) !== -1) {
+                    count++;
+                    pos += MARKER.length;
+                }
+            }
+            catch {
+                // skip
+            }
+        }
+    }
+    catch {
+        // skip
+    }
+    return count;
+}
+function readHarnessEvidence(projectDir) {
+    const path = join(projectDir, ".forgecraft", "harness-run.json");
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf-8"));
+        const notImplemented = (raw.results ?? []).filter((r) => r.status === "not_implemented").length;
+        return {
+            passed: raw.passed ?? 0,
+            failed: raw.failed ?? 0,
+            notImplemented,
+            timestamp: raw.timestamp ?? null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function readProbeEvidence(projectDir, filename) {
+    const path = join(projectDir, ".forgecraft", filename);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf-8"));
+        return {
+            passed: raw.passed ?? 0,
+            failed: raw.failed ?? 0,
+            timestamp: raw.timestamp ?? null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function adrStatuses(projectDir) {
+    const canonical = join(projectDir, "docs", "adrs", "active");
+    const legacy = join(projectDir, "docs", "adrs");
+    const dir = existsSync(canonical) ? canonical : legacy;
+    if (!existsSync(dir))
+        return { total: 0, accepted: 0, retroactive: 0, markers: 0 };
+    let accepted = 0;
+    let retroactive = 0;
+    let total = 0;
+    const MARKER = "[NEEDS CLARIFICATION]";
+    let markers = 0;
+    try {
+        for (const f of readdirSync(dir)) {
+            if (!f.endsWith(".md"))
+                continue;
+            total++;
+            const content = readFileSync(join(dir, f), "utf-8");
+            if (/\*\*Status:\*\*\s*Accepted/i.test(content))
+                accepted++;
+            if (/\*\*Status:\*\*\s*Retroactive/i.test(content))
+                retroactive++;
+            let pos = 0;
+            while ((pos = content.indexOf(MARKER, pos)) !== -1) {
+                markers++;
+                pos += MARKER.length;
+            }
+        }
+    }
+    catch {
+        // skip
+    }
+    return { total, accepted, retroactive, markers };
+}
+function hookInstallationStatus(projectDir) {
+    const gitHooksDir = join(projectDir, ".git", "hooks");
+    const sourceHooksDir = join(projectDir, ".forgecraft", "hooks");
+    if (!existsSync(sourceHooksDir))
+        return { installed: 0, missing: 0 };
+    if (!existsSync(gitHooksDir))
+        return { installed: 0, missing: 5 };
+    const EXPECTED = [
+        "pre-commit",
+        "commit-msg",
+        "post-commit",
+        "prepare-commit-msg",
+        "pre-push",
+    ];
+    let installed = 0;
+    let missing = 0;
+    for (const hook of EXPECTED) {
+        if (existsSync(join(gitHooksDir, hook)))
+            installed++;
+        else
+            missing++;
+    }
+    return { installed, missing };
+}
+// ── Evidence assembler ────────────────────────────────────────────────
+function gatherEvidence(projectDir) {
+    const claudeMdPath = join(projectDir, "CLAUDE.md");
+    const indexMdPath = join(projectDir, ".claude", "index.md");
+    const coreMdPath = join(projectDir, ".claude", "core.md");
+    const prdPath = [
+        join(projectDir, "docs", "PRD.md"),
+        join(projectDir, "docs", "prd.md"),
+    ].find(existsSync);
+    const claudeMdLines = existsSync(claudeMdPath)
+        ? readFileSync(claudeMdPath, "utf-8").split("\n").length
+        : 0;
+    const claudeMdHead = safeRead(claudeMdPath, 5);
+    const isSentinel = existsSync(claudeMdPath) &&
+        readFileSync(claudeMdPath, "utf-8").includes("<!-- ForgeCraft sentinel:");
+    const cntHealth = (() => {
+        try {
+            return auditCntHealth(projectDir);
+        }
+        catch {
+            return null;
+        }
+    })();
+    const cntLeafCount = safeCount(join(projectDir, ".claude", "standards"), ".md");
+    const cntRoutingPass = cntHealth?.routingPass ?? null;
+    const unroutedLeaves = cntHealth?.unroutedLeaves ?? [];
+    const ucDir = join(projectDir, "docs", "use-cases");
+    const ucCount = safeCountPattern(ucDir, /^UC-\d{3}/);
+    const monolithUcPath = join(projectDir, "docs", "use-cases.md");
+    const ucMonolithWords = fileWords(monolithUcPath);
+    const harnessDir = [
+        join(projectDir, "tests", "harness"),
+        join(projectDir, "test", "harness"),
+    ].find(existsSync);
+    const probeCount = harnessDir ? safeCount(harnessDir) : 0;
+    const harnessEvidence = readHarnessEvidence(projectDir);
+    const envEvidence = readProbeEvidence(projectDir, "env-probe-run.json");
+    const sloEvidence = readProbeEvidence(projectDir, "slo-probe-run.json");
+    const adrs = adrStatuses(projectDir);
+    const decisionCount = safeCount(join(projectDir, "docs", "decisions"), ".md");
+    const decisionMarkers = countMarkers(join(projectDir, "docs", "decisions"));
+    let gateCount = 0;
+    let warningGates = 0;
+    let errorGates = 0;
+    try {
+        const gates = getActiveProjectGates(projectDir);
+        gateCount = gates.length;
+        warningGates = gates.filter((g) => g.severity === "warning").length;
+        errorGates = gates.filter((g) => g.severity === "error").length;
+    }
+    catch {
+        // skip
+    }
+    const hooks = hookInstallationStatus(projectDir);
+    const brownfield = readBrownfieldFlag(projectDir);
+    const sessionPromptsExist = existsSync(join(projectDir, "docs", "session-prompts"));
+    const prdWords = prdPath ? fileWords(prdPath) : 0;
+    const prdRelPath = prdPath
+        ? prdPath.replace(projectDir, "").replace(/^[\\/]/, "")
+        : null;
+    const indexMdHead = safeRead(indexMdPath, 10);
+    const coreMdLines = existsSync(coreMdPath)
+        ? readFileSync(coreMdPath, "utf-8").split("\n").length
+        : 0;
+    return {
+        // Self-describing
+        claudeMd: `${claudeMdLines} lines | sentinel: ${isSentinel} | head:\n${claudeMdHead}`,
+        cntLeaves: `${cntLeafCount} leaf nodes`,
+        indexMd: existsSync(indexMdPath)
+            ? `present | head:\n${indexMdHead}`
+            : "absent",
+        coreMd: `${coreMdLines} lines`,
+        cntRoutingPass: cntRoutingPass === null ? "unknown" : String(cntRoutingPass),
+        unroutedLeaves: unroutedLeaves.length > 0 ? unroutedLeaves.join(", ") : "none",
+        // Bounded
+        sessionPrompts: sessionPromptsExist
+            ? "docs/session-prompts/ exists"
+            : "absent",
+        cntBounded: cntRoutingPass
+            ? "routing directives present"
+            : "routing directives missing",
+        // Verifiable
+        ucCount: String(ucCount),
+        ucMonolith: ucMonolithWords > 0 ? `use-cases.md: ${ucMonolithWords} words` : "absent",
+        probeCount: String(probeCount),
+        harnessEvidence: harnessEvidence
+            ? `${harnessEvidence.passed} passed / ${harnessEvidence.failed} failed / ${harnessEvidence.notImplemented} not_implemented @ ${harnessEvidence.timestamp}`
+            : "not run",
+        // Defended
+        gateCount: String(gateCount),
+        gateSeverities: `${errorGates} error-severity / ${warningGates} warning-severity`,
+        hooksInstalled: `${hooks.installed}/5 installed | ${hooks.missing} missing`,
+        brownfield: String(brownfield),
+        // Auditable
+        adrs: `${adrs.total} total | ${adrs.accepted} Accepted | ${adrs.retroactive} Retroactive | ${adrs.markers} unresolved markers`,
+        decisions: `${decisionCount} files | ${decisionMarkers} unresolved markers`,
+        // Composable
+        prd: prdRelPath ? `${prdRelPath}: ${prdWords} words` : "absent",
+        chainLinks: `PRD:${prdRelPath ? "✓" : "✗"} UCs:${ucCount > 0 ? "✓" : "✗"} Probes:${probeCount > 0 ? "✓" : "✗"} ADRs:${adrs.total > 0 ? "✓" : "✗"} Gates:${gateCount > 0 ? "✓" : "✗"}`,
+        // Executable
+        envEvidence: envEvidence
+            ? `${envEvidence.passed} passed / ${envEvidence.failed} failed @ ${envEvidence.timestamp}`
+            : "not run",
+        sloEvidence: sloEvidence
+            ? `${sloEvidence.passed} passed / ${sloEvidence.failed} failed @ ${sloEvidence.timestamp}`
+            : "not run",
+    };
+}
+// ── Scoring prompt builder ─────────────────────────────────────────────
+function buildScoringPrompt(projectDir, evidence) {
+    const relDir = projectDir.split(/[\\/]/).pop() ?? projectDir;
+    return [
+        `# GS Rubric Evaluation — ${relDir}`,
+        "",
+        "You are evaluating this project against the 7 Generative Specification properties.",
+        "Score each property 0 / 1 / 2 using the criteria below as a **starting framework**.",
+        "",
+        "**Important:** The criteria below describe what the tooling can detect. You are not limited to them.",
+        "If you see something the heuristics miss — a property that is technically present but",
+        "hollow, spec artifacts that exist but are incoherent, tests that pass trivially — flag it.",
+        "Reduce the score. Add a note. The goal is an honest assessment, not a passing grade.",
+        "",
+        "---",
+        "",
+        "## Evidence",
+        "",
+        "### Self-describing",
+        `- CLAUDE.md: ${evidence["claudeMd"]}`,
+        `- CNT: ${evidence["cntLeaves"]} | routing: ${evidence["cntRoutingPass"]} | unrouted: ${evidence["unroutedLeaves"]}`,
+        `- .claude/index.md: ${evidence["indexMd"]}`,
+        `- .claude/core.md: ${evidence["coreMd"]}`,
+        "",
+        "### Bounded",
+        `- Session prompts: ${evidence["sessionPrompts"]}`,
+        `- CNT context loading: ${evidence["cntBounded"]}`,
+        "",
+        "### Verifiable",
+        `- Use cases (canonical): ${evidence["ucCount"]} UC files`,
+        `- Use cases (monolith): ${evidence["ucMonolith"]}`,
+        `- L2 probes: ${evidence["probeCount"]} files`,
+        `- Harness run: ${evidence["harnessEvidence"]}`,
+        "",
+        "### Defended",
+        `- Active gates: ${evidence["gateCount"]} (${evidence["gateSeverities"]})`,
+        `- Git hooks: ${evidence["hooksInstalled"]}`,
+        `- Brownfield project: ${evidence["brownfield"]}`,
+        "",
+        "### Auditable",
+        `- ADRs: ${evidence["adrs"]}`,
+        `- Decision records: ${evidence["decisions"]}`,
+        "",
+        "### Composable",
+        `- PRD: ${evidence["prd"]}`,
+        `- Chain presence: ${evidence["chainLinks"]}`,
+        "",
+        "### Executable",
+        `- L2 Harness: ${evidence["harnessEvidence"]}`,
+        `- L3 Env probes: ${evidence["envEvidence"]}`,
+        `- L4 SLO probes: ${evidence["sloEvidence"]}`,
+        "",
+        "---",
+        "",
+        "## Scoring Criteria (starting framework — override freely)",
+        "",
+        "### 1. Self-describing (0–2)",
+        "- **0**: No CLAUDE.md, or a monolithic blob with no CNT navigation",
+        "- **1**: CLAUDE.md present; some CNT nodes exist but routing is incomplete or absent",
+        "- **2**: Sentinel CLAUDE.md + CNT with routing directives for all domains; index.md clearly describes when to load each node",
+        "",
+        "### 2. Bounded (0–2)",
+        "- **0**: No session prompts; Claude loads all context on every call",
+        "- **1**: Session prompts or CNT routing exist but scope boundaries are vague or unrouted leaves remain",
+        "- **2**: Every generated session has explicit scope; CNT routing loads only relevant context; no context bloat",
+        "",
+        "### 3. Verifiable (0–2)",
+        "- **0**: No use cases, or use cases exist but no tests are bound to them",
+        "- **1**: Use cases exist; some probes exist; harness has not been run or has not_implemented probes",
+        "- **2**: All UCs have probes; harness ran with 0 failures and 0 not_implemented; L2 coverage ≥ 80%",
+        "",
+        "### 4. Defended (0–2)",
+        "- **0**: No gates, or gates are defined but hooks are not installed so they never fire",
+        "- **1**: Gates defined; hooks installed; but gates are all warning-severity or coverage is low",
+        "- **2**: Error-severity gates in force; hooks installed and firing; gates cover the main failure modes",
+        "",
+        "### 5. Auditable (0–2)",
+        "- **0**: No ADRs or decisions; no record of why choices were made",
+        "- **1**: ADRs exist but majority are Retroactive stubs with unresolved markers; decision trail is incomplete",
+        "- **2**: All significant decisions have Accepted ADRs with full Context/Decision/Alternatives; decision records link to chronicle sessions where relevant",
+        "",
+        "### 6. Composable (0–2)",
+        "- **0**: No visible derivation chain; spec is a monolith or absent",
+        "- **1**: Some chain links present (e.g. PRD → UCs, or UCs → probes) but not end-to-end; cross-references between layers are missing",
+        "- **2**: Full chain intact: PRD → UCs → ADRs → probes → gates; each layer is derivable from the prior; cross-references present",
+        "",
+        "### 7. Executable (0–2)",
+        "- **0**: No executable spec artifacts; everything is documentation only",
+        "- **1**: Probes exist but have not been run, are stubs (not_implemented), or have failures",
+        "- **2**: L2 probes all passing; L3 env probes run and passing; L4 SLO probes run and passing; monitoring contracts verified",
+        "",
+        "---",
+        "",
+        "## Your Task",
+        "",
+        "Fill in the scorecard below. For each property:",
+        "1. State the score (0, 1, or 2)",
+        "2. Give a one-line rationale",
+        "3. If you disagree with or want to add to the criteria above, say so explicitly",
+        "4. Flag anything that looks hollow, superficial, or missing regardless of the heuristics",
+        "",
+        "```",
+        "| Property        | Score | Rationale |",
+        "|---|---|---|",
+        "| Self-describing | /2    |           |",
+        "| Bounded         | /2    |           |",
+        "| Verifiable      | /2    |           |",
+        "| Defended        | /2    |           |",
+        "| Auditable       | /2    |           |",
+        "| Composable      | /2    |           |",
+        "| Executable      | /2    |           |",
+        "| **Total**       | /14   |           |",
+        "```",
+        "",
+        "After the scorecard, add a **Flags** section for anything the evidence doesn't capture but you",
+        "noticed — incoherent spec language, contradictory requirements, test scaffolding that trivially",
+        "passes, CNT nodes that exist but are empty, ADRs that are technically Accepted but clearly",
+        "placeholder content, etc. These flags don't change the score but tell the practitioner what",
+        "to work on that the tooling cannot detect.",
+    ].join("\n");
+}
+// ── Handler ───────────────────────────────────────────────────────────
+export async function scoreRubricHandler(args) {
+    const evidence = gatherEvidence(args.project_dir);
+    const prompt = buildScoringPrompt(args.project_dir, evidence);
+    return { content: [{ type: "text", text: prompt }] };
+}
+//# sourceMappingURL=score-rubric.js.map