forgecraft-mcp 1.3.2 → 1.6.1

package/dist/analyzers/scorers/composable-scorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"composable-scorer.js","sourceRoot":"","sources":["../../../src/analyzers/scorers/composable-scorer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,QAAkB;IACpE,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QAC7C,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAC/C,UAAU,EAAE,SAAS;KACtB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/C,MAAM,aAAa,GAAG;QACpB,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;QACpD,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAC9C,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QAC9C,cAAc,EAAE,YAAY;KAC7B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/C,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,kDAAkD,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9E,gBAAgB,CAAC,CAAC,CAAC,CACtB,CAAC;IAEF,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE;YACzB,wBAAwB,UAAU,GAAG;YACrC,2BAA2B,aAAa,GAAG;YAC3C,aAAa;gBACX,CAAC,CAAC,mCAAmC;gBACrC,CAAC,CAAC,+CAA+C;SACpD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE;YACzB,wBAAwB,UAAU,GAAG;YACrC,4EAA4E;SAC7E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE;QACzB,wEAAwE;QACxE,2BAA2B;KAC5B,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"composable-scorer.js","sourceRoot":"","sources":["../../../src/analyzers/scorers/composable-scorer.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/scorers/executable-scorer.d.ts

@@ -4,8 +4,9 @@
 import type { GsPropertyScore } from "../../shared/types.js";
 /**
  * Score the Executable GS property.
- * 2 = tests passed + CI configured OR verification-state.json with passed steps.
- * 1 = tests passed locally but no CI or verification state.
+ * 2 = tests passed + CI configured OR verification-state.json with passed steps
+ *   OR tests passed + harness-run.json with ≥1 PASS result AND L2 coverage ≥ 50%.
+ * 1 = tests passed locally but no CI, no verification state, or harness exists but 0% passing.
  * 0 = tests failed OR no test infrastructure.
  */
 export declare function scoreExecutable(projectDir: string, testsPassed: boolean): GsPropertyScore;

package/dist/analyzers/scorers/executable-scorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executable-scorer.d.ts","sourceRoot":"","sources":["../../../src/analyzers/scorers/executable-scorer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,eAAe,CA2CzF"}
+{"version":3,"file":"executable-scorer.d.ts","sourceRoot":"","sources":["../../../src/analyzers/scorers/executable-scorer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA8C7D;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,GACnB,eAAe,CA8EjB"}

package/dist/analyzers/scorers/executable-scorer.js

@@ -4,10 +4,44 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { gs } from "./scorer-utils.js";
+/**
+ * Read harness-run.json from .forgecraft/harness-run.json.
+ * Returns null when file is missing or unparseable.
+ */
+function readHarnessRun(projectDir) {
+    const runJsonPath = join(projectDir, ".forgecraft", "harness-run.json");
+    if (!existsSync(runJsonPath))
+        return null;
+    try {
+        const raw = readFileSync(runJsonPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Count total use cases in docs/use-cases.md.
+ * Returns 0 when file is missing or unparseable.
+ */
+function countUseCases(projectDir) {
+    const useCasesPath = join(projectDir, "docs", "use-cases.md");
+    if (!existsSync(useCasesPath))
+        return 0;
+    try {
+        const content = readFileSync(useCasesPath, "utf-8");
+        const matches = content.match(/^##\s+UC-\d{3}:/gm);
+        return matches?.length ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
 /**
  * Score the Executable GS property.
- * 2 = tests passed + CI configured OR verification-state.json with passed steps.
- * 1 = tests passed locally but no CI or verification state.
+ * 2 = tests passed + CI configured OR verification-state.json with passed steps
+ *   OR tests passed + harness-run.json with ≥1 PASS result AND L2 coverage ≥ 50%.
+ * 1 = tests passed locally but no CI, no verification state, or harness exists but 0% passing.
  * 0 = tests failed OR no test infrastructure.
  */
 export function scoreExecutable(projectDir, testsPassed) {
@@ -34,8 +68,12 @@ export function scoreExecutable(projectDir, testsPassed) {
         }
     }
     const ciPaths = [
-        ".github/workflows", ".gitlab-ci.yml", ".circleci/config.yml",
-        "Jenkinsfile", ".travis.yml", "azure-pipelines.yml",
+        ".github/workflows",
+        ".gitlab-ci.yml",
+        ".circleci/config.yml",
+        "Jenkinsfile",
+        ".travis.yml",
+        "azure-pipelines.yml",
     ];
     const hasCi = ciPaths.some((p) => existsSync(join(projectDir, p)));
     if (hasCi) {
@@ -43,9 +81,31 @@ export function scoreExecutable(projectDir, testsPassed) {
             "Tests passed + CI pipeline configured (automated runtime execution evidence)",
         ]);
     }
+    // Harness evidence path
+    const harnessRun = readHarnessRun(projectDir);
+    if (harnessRun) {
+        const totalUcs = countUseCases(projectDir);
+        const l2Coverage = totalUcs > 0 ? harnessRun.passed / totalUcs : 0;
+        const pct = Math.round(l2Coverage * 100);
+        const evidenceLine = pct >= 100
+            ? `Harness run: ${harnessRun.passed}/${totalUcs} UCs passing (100% L2 coverage) — behavioral contracts verified`
+            : `Harness run: ${harnessRun.passed}/${totalUcs} UCs passing (${pct}% L2 coverage) — run more probes for full coverage`;
+        if (harnessRun.passed >= 1 && l2Coverage >= 0.5) {
+            return gs("executable", 2, [
+                "Tests passed + harness execution evidence recorded",
+                evidenceLine,
+            ]);
+        }
+        // Harness exists but insufficient coverage
+        return gs("executable", 1, [
+            "Tests passed locally but harness coverage below 50% or 0 probes passing",
+            evidenceLine,
+        ]);
+    }
     return gs("executable", 1, [
         "Tests passed locally but no CI configured and no verification-state.json",
         "Local pass is necessary but not sufficient for pre-release — add CI or record_verification steps",
+        "No harness-run.json found — run run_harness to generate behavioral execution evidence",
     ]);
 }
 //# sourceMappingURL=executable-scorer.js.map

package/dist/analyzers/scorers/executable-scorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"executable-scorer.js","sourceRoot":"","sources":["../../../src/analyzers/scorers/executable-scorer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,WAAoB;IACtE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE;YACzB,0FAA0F;SAC3F,CAAC,CAAC;IACL,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,yBAAyB,CAAC,CAAC;IACrF,IAAI,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAG3B,CAAC;YACF,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC;YAC9E,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE;oBACzB,uEAAuE;oBACvE,gBAAgB,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE;iBAC7D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG;QACd,mBAAmB,EAAE,gBAAgB,EAAE,sBAAsB;QAC7D,aAAa,EAAE,aAAa,EAAE,qBAAqB;KACpD,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE;YACzB,8EAA8E;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE;QACzB,0EAA0E;QAC1E,kGAAkG;KACnG,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"executable-scorer.js","sourceRoot":"","sources":["../../../src/analyzers/scorers/executable-scorer.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/scorers/scorer-utils.d.ts

@@ -8,9 +8,11 @@ export declare const ROUTE_DIRS: string[];
 export declare const DB_CALL_PATTERNS: RegExp[];
 /** Lines that are comments or imports — excluded from DB call detection. */
 export declare const COMMENT_OR_IMPORT: RegExp;
-/** Minimum instruction-file length to be considered substantive. */
-export declare const MIN_INSTRUCTION_FILE_LINES = 40;
-/** Keywords that indicate an instruction file covers architecture/conventions/decisions. */
+/**
+ * Keywords that indicate an instruction file covers architecture/conventions/decisions.
+ * Intentionally broad to be tech-agnostic: web services, libraries, CLIs,
+ * GitHub Actions, and ML projects each use different vocabulary.
+ */
 export declare const INSTRUCTION_COVERAGE_KEYWORDS: string[];
 /** Minimum distinct keyword hits to award score 2 for Self-describing. */
 export declare const MIN_KEYWORD_HITS = 3;

package/dist/analyzers/scorers/scorer-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scorer-utils.d.ts","sourceRoot":"","sources":["../../../src/analyzers/scorers/scorer-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIzF,iEAAiE;AACjE,eAAO,MAAM,UAAU,UAA4D,CAAC;AAEpF,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,EAAE,MAAM,EASpC,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,QAA+C,CAAC;AAE9E,oEAAoE;AACpE,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,UAUzC,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAIlC,sCAAsC;AACtC,wBAAgB,EAAE,CAChB,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,eAAe,CAEjB;AAID,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD;AAID,6DAA6D;AAC7D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,cAAc,EAAE,GAC3B,IAAI,CASN;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAMxE"}
+{"version":3,"file":"scorer-utils.d.ts","sourceRoot":"","sources":["../../../src/analyzers/scorers/scorer-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACf,MAAM,uBAAuB,CAAC;AAI/B,iEAAiE;AACjE,eAAO,MAAM,UAAU,UAMtB,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,EAAE,MAAM,EASpC,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,QAA+C,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,UAuBzC,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAIlC,sCAAsC;AACtC,wBAAgB,EAAE,CAChB,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,eAAe,CAEjB;AAID,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKrD;AAID,6DAA6D;AAC7D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,cAAc,EAAE,GAC3B,IAAI,CAaN;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAMxE"}

package/dist/analyzers/scorers/scorer-utils.js

@@ -4,7 +4,13 @@
 import { extname, basename, dirname } from "node:path";
 // ── Constants ─────────────────────────────────────────────────────────
 /** Directories that are considered "route/controller" layers. */
-export const ROUTE_DIRS = ["routes", "controllers", "handlers", "api", "endpoints"];
+export const ROUTE_DIRS = [
+    "routes",
+    "controllers",
+    "handlers",
+    "api",
+    "endpoints",
+];
 /** ORM/DB client call patterns to flag in route files. */
 export const DB_CALL_PATTERNS = [
     /\bprisma\.\w+\.\w+\s*\(/, // prisma.user.findMany(
@@ -18,19 +24,34 @@ export const DB_CALL_PATTERNS = [
 ];
 /** Lines that are comments or imports — excluded from DB call detection. */
 export const COMMENT_OR_IMPORT = /^\s*(\/\/|\/\*|\*|#|import\s|require\s*\()/;
-/** Minimum instruction-file length to be considered substantive. */
-export const MIN_INSTRUCTION_FILE_LINES = 40;
-/** Keywords that indicate an instruction file covers architecture/conventions/decisions. */
+/**
+ * Keywords that indicate an instruction file covers architecture/conventions/decisions.
+ * Intentionally broad to be tech-agnostic: web services, libraries, CLIs,
+ * GitHub Actions, and ML projects each use different vocabulary.
+ */
 export const INSTRUCTION_COVERAGE_KEYWORDS = [
+    // Web service / layered architecture terms
     "architecture",
+    "layer",
+    "repository",
+    "service",
+    // Universal design terms
     "convention",
     "decision",
+    "pattern",
+    "module",
+    "interface",
+    "constraint",
+    "behavior",
+    // Documentation/traceability
     "adr",
     "domain",
-    "pattern",
-    "layer",
-    "repository",
-    "service",
+    // Action/CLI/tool-specific
+    "workflow",
+    "input",
+    "output",
+    "command",
+    "tool",
 ];
 /** Minimum distinct keyword hits to award score 2 for Self-describing. */
 export const MIN_KEYWORD_HITS = 3;
@@ -67,7 +88,11 @@ export function collectDbViolations(lines, relPath, violations) {
             continue;
         const matchedPattern = DB_CALL_PATTERNS.find((p) => p.test(line));
         if (matchedPattern) {
-            violations.push({ file: relPath, line: i + 1, snippet: line.slice(0, 120) });
+            violations.push({
+                file: relPath,
+                line: i + 1,
+                snippet: line.slice(0, 120),
+            });
         }
     }
 }

package/dist/analyzers/scorers/scorer-utils.js.map

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

package/dist/analyzers/scorers/self-describing-scorer.d.ts

@@ -1,12 +1,15 @@
 /**
- * Self-describing scorer: instruction file exists, is substantive, and covers
- * architecture / conventions / decisions.
+ * Self-describing scorer: instruction file exists and covers architecture/convention keywords.
+ *
+ * Sentinel-aware: a compact CLAUDE.md that navigates to the right docs is better
+ * than a verbose file that repeats them. Line count is irrelevant — keyword coverage
+ * is the signal.
  */
 import type { GsPropertyScore } from "../../shared/types.js";
 /**
  * Score the Self-describing GS property.
- * 2 = instruction file found, substantive, covers architecture/convention keywords.
- * 1 = file found but short or missing keywords.
+ * 2 = instruction file exists and covers ≥ MIN_KEYWORD_HITS architecture/convention keywords.
+ * 1 = file exists but covers fewer keywords (present but not describing the architecture).
  * 0 = no instruction file found.
  */
 export declare function scoreSelfDescribing(projectDir: string): GsPropertyScore;

package/dist/analyzers/scorers/self-describing-scorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-describing-scorer.d.ts","sourceRoot":"","sources":["../../../src/analyzers/scorers/self-describing-scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAwCvE"}
+{"version":3,"file":"self-describing-scorer.d.ts","sourceRoot":"","sources":["../../../src/analyzers/scorers/self-describing-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAuCvE"}

package/dist/analyzers/scorers/self-describing-scorer.js

@@ -1,14 +1,17 @@
 /**
- * Self-describing scorer: instruction file exists, is substantive, and covers
- * architecture / conventions / decisions.
+ * Self-describing scorer: instruction file exists and covers architecture/convention keywords.
+ *
+ * Sentinel-aware: a compact CLAUDE.md that navigates to the right docs is better
+ * than a verbose file that repeats them. Line count is irrelevant — keyword coverage
+ * is the signal.
  */
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import { gs, MIN_INSTRUCTION_FILE_LINES, INSTRUCTION_COVERAGE_KEYWORDS, MIN_KEYWORD_HITS } from "./scorer-utils.js";
+import { gs, INSTRUCTION_COVERAGE_KEYWORDS, MIN_KEYWORD_HITS, } from "./scorer-utils.js";
 /**
  * Score the Self-describing GS property.
- * 2 = instruction file found, substantive, covers architecture/convention keywords.
- * 1 = file found but short or missing keywords.
+ * 2 = instruction file exists and covers ≥ MIN_KEYWORD_HITS architecture/convention keywords.
+ * 1 = file exists but covers fewer keywords (present but not describing the architecture).
  * 0 = no instruction file found.
  */
 export function scoreSelfDescribing(projectDir) {
@@ -28,24 +31,20 @@ export function scoreSelfDescribing(projectDir) {
     try {
         content = readFileSync(join(projectDir, found), "utf-8");
     }
-    catch { /* empty */ }
-    const lines = content.split("\n").filter((l) => l.trim().length > 0);
-    if (lines.length < MIN_INSTRUCTION_FILE_LINES) {
-        return gs("self-describing", 1, [
-            `${found} found but only ${lines.length} non-empty lines (< ${MIN_INSTRUCTION_FILE_LINES} — treat as stub)`,
-        ]);
+    catch {
+        /* empty */
     }
     const lower = content.toLowerCase();
     const hits = INSTRUCTION_COVERAGE_KEYWORDS.filter((kw) => lower.includes(kw));
-    if (hits.length < MIN_KEYWORD_HITS) {
-        return gs("self-describing", 1, [
-            `${found} found (${lines.length} lines) but covers fewer than ${MIN_KEYWORD_HITS} architecture/convention keywords`,
-            `Missing keywords: ${INSTRUCTION_COVERAGE_KEYWORDS.filter((kw) => !lower.includes(kw)).slice(0, 5).join(", ")}`,
+    if (hits.length >= MIN_KEYWORD_HITS) {
+        return gs("self-describing", 2, [
+            `${found} found — covers: ${hits.join(", ")}`,
         ]);
     }
-    return gs("self-describing", 2, [
-        `${found} found — ${lines.length} non-empty lines`,
-        `Covers: ${hits.join(", ")}`,
+    const missing = INSTRUCTION_COVERAGE_KEYWORDS.filter((kw) => !lower.includes(kw));
+    return gs("self-describing", 1, [
+        `${found} found but covers fewer than ${MIN_KEYWORD_HITS} architecture/convention keywords`,
+        `Add navigation or constraints referencing: ${missing.slice(0, 5).join(", ")}`,
     ]);
 }
 //# sourceMappingURL=self-describing-scorer.js.map

package/dist/analyzers/scorers/self-describing-scorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"self-describing-scorer.js","sourceRoot":"","sources":["../../../src/analyzers/scorers/self-describing-scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,EAAE,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEpH;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,gBAAgB,GAAG;QACvB,WAAW;QACX,eAAe;QACf,iCAAiC;QACjC,gBAAgB;QAChB,aAAa;QACb,gBAAgB;KACjB,CAAC;IAEF,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC,wCAAwC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC;QAAC,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErE,IAAI,KAAK,CAAC,MAAM,GAAG,0BAA0B,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE;YAC9B,GAAG,KAAK,mBAAmB,KAAK,CAAC,MAAM,uBAAuB,0BAA0B,mBAAmB;SAC5G,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9E,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE;YAC9B,GAAG,KAAK,WAAW,KAAK,CAAC,MAAM,iCAAiC,gBAAgB,mCAAmC;YACnH,qBAAqB,6BAA6B,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAChH,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE;QAC9B,GAAG,KAAK,YAAY,KAAK,CAAC,MAAM,kBAAkB;QAClD,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC7B,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"self-describing-scorer.js","sourceRoot":"","sources":["../../../src/analyzers/scorers/self-describing-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,EAAE,EACF,6BAA6B,EAC7B,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,gBAAgB,GAAG;QACvB,WAAW;QACX,eAAe;QACf,iCAAiC;QACjC,gBAAgB;QAChB,aAAa;QACb,gBAAgB;KACjB,CAAC;IAEF,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC,wCAAwC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9E,IAAI,IAAI,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE;YAC9B,GAAG,KAAK,oBAAoB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,6BAA6B,CAAC,MAAM,CAClD,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAC5B,CAAC;IACF,OAAO,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE;QAC9B,GAAG,KAAK,gCAAgC,gBAAgB,mCAAmC;QAC3F,8CAA8C,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC/E,CAAC,CAAC;AACL,CAAC"}

package/dist/artifacts/commit-hooks.d.ts

@@ -25,7 +25,7 @@ export declare class CommitHooksArtifact implements GenerativeSpec {
     readonly projectDir: string;
     readonly name = "Pre-commit Hooks (Automated Enforcement)";
     readonly purpose = "Rejects non-conforming commits before they enter the repository, making all other spec properties self-defending.";
-    readonly covers: readonly ["Temporary/draft file prevention", "Secret scanning", "Production anti-pattern detection", "TypeScript compilation gate", "Test + coverage gate", "Dangerous command prevention", "Conventional commit message format enforcement"];
+    readonly covers: readonly ["Temporary/draft file prevention", "Secret scanning", "Production anti-pattern detection", "TypeScript compilation gate", "Rust cargo check + cargo clippy gate", "Test + coverage gate", "Dangerous command prevention", "Conventional commit message format enforcement"];
     readonly excludes: readonly ["Hook implementation details (those live in .claude/hooks/)", "CI/CD pipeline steps (those are post-commit enforcement)"];
     readonly version: string;
     readonly specId = "artifact:commit-hooks";

package/dist/artifacts/commit-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit-hooks.d.ts","sourceRoot":"","sources":["../../src/artifacts/commit-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAI1B,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAWhE;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IA2BtD,QAAQ,CAAC,UAAU,EAAE,MAAM;IA1B7B,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,OAAO,uHACsG;IACtH,QAAQ,CAAC,MAAM,gPAQJ;IACX,QAAQ,CAAC,QAAQ,sIAGN;IAEX,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,2BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,CAAM;IACrD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,UAAU,CAAC,CAAM;IACvD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAM;IAE/C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;gBAGhC,UAAU,EAAE,MAAM,EAC3B,OAAO,SAAU;IAsEnB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAQlC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAUtE,MAAM;;;;;;;;IAOZ,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAMrD,WAAW,CACT,MAAM,EAAE,cAAc,GAAG,WAAW,GACnC,aAAa,CAAC,mBAAmB,CAAC;IAI/B,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC;CAU7B"}
+{"version":3,"file":"commit-hooks.d.ts","sourceRoot":"","sources":["../../src/artifacts/commit-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAI1B,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAYhE;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IA4BtD,QAAQ,CAAC,UAAU,EAAE,MAAM;IA3B7B,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,OAAO,uHACsG;IACtH,QAAQ,CAAC,MAAM,wRASJ;IACX,QAAQ,CAAC,QAAQ,sIAGN;IAEX,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,2BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,CAAM;IACrD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,UAAU,CAAC,CAAM;IACvD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAM;IAE/C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;gBAGhC,UAAU,EAAE,MAAM,EAC3B,OAAO,SAAU;IAsEnB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAQlC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAUtE,MAAM;;;;;;;;IAOZ,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAMrD,WAAW,CACT,MAAM,EAAE,cAAc,GAAG,WAAW,GACnC,aAAa,CAAC,mBAAmB,CAAC;IAI/B,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC;CAU7B"}

package/dist/artifacts/commit-hooks.js

@@ -19,6 +19,7 @@ const REQUIRED_HOOKS = [
     "pre-commit-secrets.sh",
     "pre-commit-prod-quality.sh",
     "pre-commit-compile.sh",
+    "pre-commit-clippy.sh",
     "pre-commit-test.sh",
     "commit-msg.sh",
 ];
@@ -39,6 +40,7 @@ export class CommitHooksArtifact {
         "Secret scanning",
         "Production anti-pattern detection",
         "TypeScript compilation gate",
+        "Rust cargo check + cargo clippy gate",
         "Test + coverage gate",
         "Dangerous command prevention",
         "Conventional commit message format enforcement",

package/dist/artifacts/commit-hooks.js.map

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

package/dist/cli/commands.d.ts

@@ -14,15 +14,17 @@ import type { Flags } from "./args.js";
 export declare function resolveTagsFromConfig(dir: string, flagTags: string[] | undefined): Tag[] | undefined;
 /**
  * Extract text from MCP-style handler result and print to stdout.
+ * With `json: true`, wraps output in `{ "ok": true, "output": "..." }`.
  *
  * @param result - MCP content result with text blocks
+ * @param json - When true, output as JSON (for CI/scripting)
  */
 export declare function printResult(result: {
     content: Array<{
         type: string;
         text: string;
     }>;
-}): void;
+}, json?: boolean): void;
 /** @param pos - Positional args @param flags - Parsed flags */
 export declare function cmdSetup(pos: string[], flags: Flags): Promise<void>;
 /** @param pos - Positional args @param flags - Parsed flags */
@@ -51,4 +53,36 @@ export declare function cmdAddHook(pos: string[], flags: Flags): Promise<void>;
 export declare function cmdVerify(pos: string[], flags: Flags): Promise<void>;
 /** @param pos - Positional args @param flags - Parsed flags */
 export declare function cmdAddModule(pos: string[], flags: Flags): Promise<void>;
+/**
+ * `check-cascade [dir]` — run cascade checks and exit 1 on required failures.
+ *
+ * With `--json`: outputs structured JSON suitable for CI parsing.
+ * Exit codes: 0 = all required steps pass, 1 = one or more required steps fail.
+ *
+ * @param pos - Positional args (pos[0] = project dir)
+ * @param flags - Parsed flags
+ */
+export declare function cmdCheckCascade(pos: string[], flags: Flags): Promise<void>;
+/**
+ * `violations [dir]` — report active gate violations, exit 1 if any present.
+ *
+ * Active violations are those recorded after the last git commit. Stale
+ * violations (cleared by a commit) are shown but don't trigger exit 1.
+ *
+ * With `--json`: outputs structured JSON suitable for CI parsing.
+ * Exit codes: 0 = no active violations, 1 = active violations present.
+ *
+ * @param pos - Positional args (pos[0] = project dir)
+ * @param flags - Parsed flags
+ */
+export declare function cmdViolations(pos: string[], flags: Flags): Promise<void>;
+/**
+ * `status [dir]` — print a live project state snapshot (always exits 0).
+ *
+ * With `--json`: wraps the snapshot text in `{ "ok": true, "output": "..." }`.
+ *
+ * @param pos - Positional args (pos[0] = project dir)
+ * @param flags - Parsed flags
+ */
+export declare function cmdStatus(pos: string[], flags: Flags): Promise<void>;
 //# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,GAAG,EAA6B,MAAM,oBAAoB,CAAC;AAmBzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AASvC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAC7B,GAAG,EAAE,GAAG,SAAS,CAInB;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,GAAG,IAAI,CAEP;AAID,+DAA+D;AAC/D,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BzE;AAED,+DAA+D;AAC/D,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3E;AAED,+DAA+D;AAC/D,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1E;AAED,+DAA+D;AAC/D,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ3E;AAED,+DAA+D;AAC/D,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAazE;AAED,+DAA+D;AAC/D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5E;AAED,+DAA+D;AAC/D,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1E;AAED,+DAA+D;AAC/D,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxE;AAED,+DAA+D;AAC/D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5E;AAED,+DAA+D;AAC/D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB5E;AAED,+DAA+D;AAC/D,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3E;AAED,+DAA+D;AAC/D,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3E;AAED,+DAA+D;AAC/D,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1E;AAED,+DAA+D;AAC/D,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB7E"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.js

@@ -18,6 +18,9 @@ import { addModuleHandler } from "../tools/add-module.js";
 import { verifyHandler } from "../tools/verify.js";
 import { adviceHandler } from "../tools/advice.js";
 import { metricsHandler } from "../tools/metrics.js";
+import { runCascadeChecks, loadCascadeDecisions, isCascadeComplete, } from "../tools/check-cascade.js";
+import { buildGateViolationReport, formatGateViolationReport, } from "../tools/gate-violations.js";
+import { consolidateStatusHandler } from "../tools/consolidate-status.js";
 import { str, arr, bool } from "./args.js";
 import { detectAiAssistant, buildNoAssistantWarning, } from "./assistant-detector.js";
 // ── Config Resolution ────────────────────────────────────────────────
@@ -37,11 +40,19 @@ export function resolveTagsFromConfig(dir, flagTags) {
 // ── Output ───────────────────────────────────────────────────────────
 /**
  * Extract text from MCP-style handler result and print to stdout.
+ * With `json: true`, wraps output in `{ "ok": true, "output": "..." }`.
  *
  * @param result - MCP content result with text blocks
+ * @param json - When true, output as JSON (for CI/scripting)
  */
-export function printResult(result) {
-    console.log(result.content[0]?.text ?? "");
+export function printResult(result, json = false) {
+    const text = result.content[0]?.text ?? "";
+    if (json) {
+        console.log(JSON.stringify({ ok: true, output: text }));
+    }
+    else {
+        console.log(text);
+    }
 }
 // ── Commands ─────────────────────────────────────────────────────────
 /** @param pos - Positional args @param flags - Parsed flags */
@@ -270,4 +281,100 @@ export async function cmdAddModule(pos, flags) {
     });
     printResult(result);
 }
+// ── CI / Bare Gate Commands ──────────────────────────────────────────
+/**
+ * `check-cascade [dir]` — run cascade checks and exit 1 on required failures.
+ *
+ * With `--json`: outputs structured JSON suitable for CI parsing.
+ * Exit codes: 0 = all required steps pass, 1 = one or more required steps fail.
+ *
+ * @param pos - Positional args (pos[0] = project dir)
+ * @param flags - Parsed flags
+ */
+export async function cmdCheckCascade(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const json = bool(flags, "json", false);
+    const decisions = loadCascadeDecisions(projectDir);
+    const steps = runCascadeChecks(projectDir, decisions);
+    const passed = isCascadeComplete(steps);
+    if (json) {
+        const failedSteps = steps
+            .filter((s) => s.status === "FAIL" || s.status === "STUB")
+            .map((s) => ({ name: s.name, status: s.status, detail: s.detail }));
+        const passingCount = steps.filter((s) => s.status === "PASS" || s.status === "WARN").length;
+        console.log(JSON.stringify({
+            ok: passed,
+            passing: passingCount,
+            total: steps.length,
+            failedSteps,
+        }));
+    }
+    else {
+        for (const s of steps) {
+            const icon = s.status === "PASS"
+                ? "✅"
+                : s.status === "SKIP"
+                    ? "⏭ "
+                    : s.status === "WARN"
+                        ? "⚠️ "
+                        : "❌";
+            console.log(`${icon} ${s.name}: ${s.status}`);
+            if (s.status === "FAIL" || s.status === "STUB") {
+                console.log(`   ${s.detail}`);
+            }
+        }
+        if (!passed) {
+            console.error("\n❌ Cascade gate failed — required steps are incomplete.");
+        }
+    }
+    if (!passed)
+        process.exit(1);
+}
+/**
+ * `violations [dir]` — report active gate violations, exit 1 if any present.
+ *
+ * Active violations are those recorded after the last git commit. Stale
+ * violations (cleared by a commit) are shown but don't trigger exit 1.
+ *
+ * With `--json`: outputs structured JSON suitable for CI parsing.
+ * Exit codes: 0 = no active violations, 1 = active violations present.
+ *
+ * @param pos - Positional args (pos[0] = project dir)
+ * @param flags - Parsed flags
+ */
+export async function cmdViolations(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const json = bool(flags, "json", false);
+    const report = buildGateViolationReport(projectDir);
+    if (json) {
+        console.log(JSON.stringify({
+            ok: report.active.length === 0,
+            active: report.active,
+            stale: report.stale,
+            lastCommitAt: report.lastCommitAt,
+        }));
+    }
+    else {
+        console.log(formatGateViolationReport(report));
+        if (report.active.length > 0) {
+            console.error(`\n❌ ${report.active.length} active gate violation(s) — fix before committing.`);
+        }
+    }
+    if (report.active.length > 0)
+        process.exit(1);
+}
+/**
+ * `status [dir]` — print a live project state snapshot (always exits 0).
+ *
+ * With `--json`: wraps the snapshot text in `{ "ok": true, "output": "..." }`.
+ *
+ * @param pos - Positional args (pos[0] = project dir)
+ * @param flags - Parsed flags
+ */
+export async function cmdStatus(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const json = bool(flags, "json", false);
+    const result = await consolidateStatusHandler({ project_dir: projectDir });
+    printResult(result, json);
+}
 //# sourceMappingURL=commands.js.map