forgecraft-mcp 1.4.0 → 1.7.0

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":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGvD,yEAAyE;AAEzE,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;AAEpF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,yBAAyB,EAAE,wBAAwB;IACnD,2BAA2B,EAAE,oBAAoB;IACjD,cAAc,EAAE,oBAAoB;IACpC,gBAAgB,EAAE,cAAc;IAChC,wBAAwB,EAAE,qBAAqB;IAC/C,qBAAqB,EAAE,kBAAkB;IACzC,wBAAwB,EAAE,qBAAqB;IAC/C,2BAA2B,EAAE,mCAAmC;CACjE,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,4CAA4C,CAAC;AAE9E,oEAAoE;AACpE,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,cAAc;IACd,YAAY;IACZ,UAAU;IACV,KAAK;IACL,QAAQ;IACR,SAAS;IACT,OAAO;IACP,YAAY;IACZ,SAAS;CACV,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,0EAA0E;AAE1E,sCAAsC;AACtC,MAAM,UAAU,EAAE,CAChB,QAAoB,EACpB,KAAgB,EAChB,QAAkB;IAElB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC;AAED,0EAA0E;AAE1E,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,sGAAsG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACjI,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO,uEAAuE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChG,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,0EAA0E;AAE1E,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CACjC,KAAe,EACf,OAAe,EACf,UAA4B;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;QAChC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAC3C,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,IAAI,cAAc,EAAE,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,IAAY;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,OAAO,GAAG,GAAG,IAAI,IAAI,UAAU,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAkB;IAC7D,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,CAAC,EAAE,EAAE,CACJ,mBAAmB,CAAC,CAAC,CAAC;QACtB,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,KAAK,IAAI,CACrE,CAAC;AACJ,CAAC"}
+{"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/cli/help.js

@@ -5,57 +5,57 @@
  * Print usage help to stdout.
  */
 export function showHelp() {
-    console.log(`
-ForgeCraft MCP — engineering standards for AI coding assistants
-
-USAGE
-  npx forgecraft-mcp <command> [arguments] [flags]
-  npx forgecraft-mcp serve                         (default — starts MCP server)
-
-COMMANDS
-  setup   <dir>          First-time project setup (auto-detects stack)
-  refresh <dir>          Re-sync instruction files after project changes
-  audit   <dir>          Check project against configured standards
-  scaffold <dir>         Generate project structure and instruction files
-  review  [dir]          Generate code review checklist
-  list    [tags|hooks|skills]   Discover available resources
-  classify [dir]         Suggest tags for a project
-  generate <dir>         Generate instruction files only
-  convert <dir>          Generate migration plan
-  add-hook <name> <dir>  Install a quality-gate hook
-  add-module <name> <dir> Scaffold a feature module
-  verify  [dir]          Run tests + score §4.3 GS properties + report layer violations
-  advice  [dir]          Quality cycle checklist + tool stack + example configs for your tags
-  metrics [dir]          External quality report: LOC, coverage, layer violations, dead code, complexity
-
-CI / BARE GATE COMMANDS (exit codes: 0 = pass, 1 = fail)
-  check-cascade [dir]    Run cascade gate checks — exit 1 if required steps are incomplete
-  violations    [dir]    Report active gate violations — exit 1 if any violations present
-  status        [dir]    Print live project state snapshot (cascade + roadmap + git + Status.md)
-
-FLAGS (vary by command)
-  --json                 Machine-readable JSON output (for CI/scripting)
-  --tags <tags...>       Project classification tags (or read from forgecraft.yaml)
-  --tier <tier>          Content depth: core | recommended | optional
-  --targets <targets...> AI assistant targets: claude cursor copilot windsurf cline aider
-  --name <name>          Project name
-  --description <text>   Project description for tag detection
-  --dry-run              Preview without writing files
-  --apply                Apply changes (for refresh, default is preview)
-  --add-tags <tags...>   Add tags during refresh
-  --remove-tags <tags...> Remove tags during refresh
-  --no-anti-patterns     Skip anti-pattern scanning (for audit)
-  --language <lang>      typescript | python (default: typescript)
-  --scope <scope>        comprehensive | focused (for review)
-  --test-cmd <cmd>       Test command override for verify (default: npm test)
-  --timeout <ms>         Test suite timeout in milliseconds (default: 120000)
-  --threshold <n>        Minimum GS score out of 12 for pass (default: 10)
-  --mutation             Run Stryker mutation testing (slow, opt-in; used by metrics)
-  --coverage-dir <path>  Path to existing coverage report directory (used by metrics)
-  --force                Overwrite existing files
-  --compact              Strip explanatory bullet tails and deduplicate lines (~20-40% smaller output)
-  --tag <tag>            Single tag filter (for add-hook)
-  --check                Drift-check mode for refresh: exit 1 if tag/tier drift detected (CI gate)
+    console.log(`
+ForgeCraft MCP — engineering standards for AI coding assistants
+
+USAGE
+  npx forgecraft-mcp <command> [arguments] [flags]
+  npx forgecraft-mcp serve                         (default — starts MCP server)
+
+COMMANDS
+  setup   <dir>          First-time project setup (auto-detects stack)
+  refresh <dir>          Re-sync instruction files after project changes
+  audit   <dir>          Check project against configured standards
+  scaffold <dir>         Generate project structure and instruction files
+  review  [dir]          Generate code review checklist
+  list    [tags|hooks|skills]   Discover available resources
+  classify [dir]         Suggest tags for a project
+  generate <dir>         Generate instruction files only
+  convert <dir>          Generate migration plan
+  add-hook <name> <dir>  Install a quality-gate hook
+  add-module <name> <dir> Scaffold a feature module
+  verify  [dir]          Run tests + score §4.3 GS properties + report layer violations
+  advice  [dir]          Quality cycle checklist + tool stack + example configs for your tags
+  metrics [dir]          External quality report: LOC, coverage, layer violations, dead code, complexity
+
+CI / BARE GATE COMMANDS (exit codes: 0 = pass, 1 = fail)
+  check-cascade [dir]    Run cascade gate checks — exit 1 if required steps are incomplete
+  violations    [dir]    Report active gate violations — exit 1 if any violations present
+  status        [dir]    Print live project state snapshot (cascade + roadmap + git + Status.md)
+
+FLAGS (vary by command)
+  --json                 Machine-readable JSON output (for CI/scripting)
+  --tags <tags...>       Project classification tags (or read from forgecraft.yaml)
+  --tier <tier>          Content depth: core | recommended | optional
+  --targets <targets...> AI assistant targets: claude cursor copilot windsurf cline aider
+  --name <name>          Project name
+  --description <text>   Project description for tag detection
+  --dry-run              Preview without writing files
+  --apply                Apply changes (for refresh, default is preview)
+  --add-tags <tags...>   Add tags during refresh
+  --remove-tags <tags...> Remove tags during refresh
+  --no-anti-patterns     Skip anti-pattern scanning (for audit)
+  --language <lang>      typescript | python (default: typescript)
+  --scope <scope>        comprehensive | focused (for review)
+  --test-cmd <cmd>       Test command override for verify (default: npm test)
+  --timeout <ms>         Test suite timeout in milliseconds (default: 120000)
+  --threshold <n>        Minimum GS score out of 12 for pass (default: 10)
+  --mutation             Run Stryker mutation testing (slow, opt-in; used by metrics)
+  --coverage-dir <path>  Path to existing coverage report directory (used by metrics)
+  --force                Overwrite existing files
+  --compact              Strip explanatory bullet tails and deduplicate lines (~20-40% smaller output)
+  --tag <tag>            Single tag filter (for add-hook)
+  --check                Drift-check mode for refresh: exit 1 if tag/tier drift detected (CI gate)
 `);
 }
 //# sourceMappingURL=help.js.map

package/dist/disciplines/catalog.d.ts

@@ -0,0 +1,16 @@
+export interface DetectResult {
+    applies: boolean;
+    evidence: string[];
+}
+export interface ScoreResult {
+    score: 0 | 1 | 2;
+    evidence: string[];
+}
+export interface Discipline {
+    name: string;
+    description: string;
+    detect(repoPath: string): DetectResult;
+    score(repoPath: string): ScoreResult;
+}
+export declare const DISCIPLINES: readonly Discipline[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/disciplines/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/disciplines/catalog.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IACvC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;CACtC;AA+KD,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EAO5C,CAAC"}

package/dist/disciplines/catalog.js

@@ -0,0 +1,196 @@
+/**
+ * Structural disciplines catalog.
+ *
+ * A "discipline" is a recognised way to organise a codebase — SOLID,
+ * hexagonal, layered, clean architecture, DDD, and TDD-as-a-practice.
+ * Each entry knows two things:
+ *
+ *   1. `detect(repoPath)` — does this discipline appear to apply at all?
+ *      A heuristic scan of file names, directory structure, and well-known
+ *      vocabulary. Cheap, read-only, no parsing.
+ *   2. `score(repoPath)` — given that it applies, how well is it followed?
+ *      0/1/2 scale, mirroring the existing GS scorer convention. Bodies
+ *      are placeholders for now; calibration anchors come later.
+ *
+ * The catalog is intentionally additive: a repo can match many disciplines
+ * at once (e.g. a hexagonal codebase that also speaks DDD), and a repo
+ * with nothing recognisable matches none.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+const TODO_PLACEHOLDER = {
+    score: 0,
+    evidence: ["TODO: scoring heuristic not yet implemented (skeleton)"],
+};
+function listDirsRecursive(repoPath, maxDepth = 3) {
+    const out = [];
+    function walk(dir, depth) {
+        if (depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true, encoding: "utf8" });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (!e.isDirectory())
+                continue;
+            const name = e.name;
+            if (name === "node_modules" || name.startsWith("."))
+                continue;
+            const full = join(dir, name);
+            out.push(full);
+            walk(full, depth + 1);
+        }
+    }
+    walk(repoPath, 0);
+    return out;
+}
+function hasDirNamed(repoPath, names) {
+    const dirs = listDirsRecursive(repoPath);
+    const lower = new Set(names.map((n) => n.toLowerCase()));
+    const hits = [];
+    for (const d of dirs) {
+        const base = d.split(/[\\/]/).pop().toLowerCase();
+        if (lower.has(base))
+            hits.push(d);
+    }
+    return hits;
+}
+function hasAnyFile(repoPath, files) {
+    const hits = [];
+    for (const f of files) {
+        const full = join(repoPath, f);
+        if (existsSync(full) && safeIsFile(full))
+            hits.push(f);
+    }
+    return hits;
+}
+function safeIsFile(p) {
+    try {
+        return statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+const SOLID = {
+    name: "SOLID",
+    description: "Class-oriented design principles (SRP, OCP, LSP, ISP, DIP).",
+    detect(repoPath) {
+        const interfaceDirs = hasDirNamed(repoPath, ["interfaces", "abstractions"]);
+        const classy = hasAnyFile(repoPath, [
+            "tsconfig.json",
+            "pom.xml",
+            "build.gradle",
+            "*.csproj",
+        ]);
+        const evidence = [];
+        if (interfaceDirs.length > 0)
+            evidence.push(`interface dirs: ${interfaceDirs.length}`);
+        if (classy.length > 0)
+            evidence.push(`class-oriented project: ${classy.join(", ")}`);
+        return { applies: evidence.length > 0, evidence };
+    },
+    score: () => TODO_PLACEHOLDER,
+};
+const TDD = {
+    name: "TDD",
+    description: "Test-driven development practice (tests present and central).",
+    detect(repoPath) {
+        const testDirs = hasDirNamed(repoPath, [
+            "tests",
+            "test",
+            "__tests__",
+            "spec",
+        ]);
+        const configs = hasAnyFile(repoPath, [
+            "vitest.config.ts",
+            "vitest.config.js",
+            "jest.config.js",
+            "jest.config.ts",
+            "karma.conf.js",
+            "phpunit.xml",
+        ]);
+        const evidence = [];
+        if (testDirs.length > 0)
+            evidence.push(`test dirs: ${testDirs.length}`);
+        if (configs.length > 0)
+            evidence.push(`test configs: ${configs.join(", ")}`);
+        return { applies: testDirs.length > 0 || configs.length > 0, evidence };
+    },
+    score: () => TODO_PLACEHOLDER,
+};
+const HEXAGONAL = {
+    name: "Hexagonal",
+    description: "Ports & adapters — domain isolated behind explicit ports.",
+    detect(repoPath) {
+        const dirs = hasDirNamed(repoPath, ["ports", "adapters", "hexagon"]);
+        const evidence = dirs.length > 0 ? [`hexagonal dirs: ${dirs.length}`] : [];
+        return { applies: dirs.length >= 2, evidence };
+    },
+    score: () => TODO_PLACEHOLDER,
+};
+const LAYERED = {
+    name: "Layered",
+    description: "Classic n-tier separation (controllers / services / repositories).",
+    detect(repoPath) {
+        const dirs = hasDirNamed(repoPath, [
+            "controllers",
+            "services",
+            "repositories",
+            "dao",
+            "presentation",
+            "business",
+            "persistence",
+        ]);
+        const evidence = dirs.length > 0 ? [`layered dirs: ${dirs.length}`] : [];
+        return { applies: dirs.length >= 2, evidence };
+    },
+    score: () => TODO_PLACEHOLDER,
+};
+const CLEAN_ARCHITECTURE = {
+    name: "CleanArchitecture",
+    description: "Concentric rings — entities, use cases, interface adapters, frameworks.",
+    detect(repoPath) {
+        const dirs = hasDirNamed(repoPath, [
+            "entities",
+            "usecases",
+            "use-cases",
+            "interface-adapters",
+            "frameworks",
+        ]);
+        const evidence = dirs.length > 0 ? [`clean-arch dirs: ${dirs.length}`] : [];
+        return { applies: dirs.length >= 2, evidence };
+    },
+    score: () => TODO_PLACEHOLDER,
+};
+const DDD = {
+    name: "DDD",
+    description: "Domain-driven design vocabulary (aggregate, value object, repository).",
+    detect(repoPath) {
+        const dirs = hasDirNamed(repoPath, [
+            "aggregates",
+            "valueobjects",
+            "value-objects",
+            "domain",
+            "domainevents",
+            "domain-events",
+            "boundedcontexts",
+        ]);
+        const evidence = dirs.length > 0 ? [`ddd dirs: ${dirs.length}`] : [];
+        return { applies: dirs.length >= 1, evidence };
+    },
+    score: () => TODO_PLACEHOLDER,
+};
+export const DISCIPLINES = [
+    SOLID,
+    TDD,
+    HEXAGONAL,
+    LAYERED,
+    CLEAN_ARCHITECTURE,
+    DDD,
+];
+//# sourceMappingURL=catalog.js.map

package/dist/disciplines/catalog.js.map

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

package/dist/disciplines/runner.d.ts

@@ -0,0 +1,13 @@
+export interface DetectedDiscipline {
+    name: string;
+    applies: boolean;
+    evidence: string[];
+}
+export interface ScoredDiscipline {
+    name: string;
+    score: 0 | 1 | 2;
+    evidence: string[];
+}
+export declare function detectApplicableDisciplines(repoPath: string): DetectedDiscipline[];
+export declare function scoreApplicableDisciplines(repoPath: string): ScoredDiscipline[];
+//# sourceMappingURL=runner.d.ts.map

package/dist/disciplines/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/disciplines/runner.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,GACf,kBAAkB,EAAE,CAKtB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GACf,gBAAgB,EAAE,CAapB"}

package/dist/disciplines/runner.js

@@ -0,0 +1,35 @@
+/**
+ * Disciplines runner — apply the catalog to a concrete repo path.
+ *
+ * Two entry points:
+ *   - detectApplicableDisciplines: which disciplines match this codebase?
+ *   - scoreApplicableDisciplines: of those that match, how well are they
+ *     followed? Score bodies are skeletons today (see `catalog.ts`); the
+ *     runner shape is the contract callers can rely on.
+ *
+ * Detection and scoring are deliberately split so callers can render a
+ * "this repo speaks N disciplines" summary without paying for scoring.
+ */
+import { DISCIPLINES } from "./catalog.js";
+export function detectApplicableDisciplines(repoPath) {
+    return DISCIPLINES.map((d) => {
+        const r = d.detect(repoPath);
+        return { name: d.name, applies: r.applies, evidence: r.evidence };
+    });
+}
+export function scoreApplicableDisciplines(repoPath) {
+    const out = [];
+    for (const d of DISCIPLINES) {
+        const det = d.detect(repoPath);
+        if (!det.applies)
+            continue;
+        const sc = d.score(repoPath);
+        out.push({
+            name: d.name,
+            score: sc.score,
+            evidence: [...det.evidence, ...sc.evidence],
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=runner.js.map

package/dist/disciplines/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/disciplines/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAc3C,MAAM,UAAU,2BAA2B,CACzC,QAAgB;IAEhB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAgB;IAEhB,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,SAAS;QAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/registry/composer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../src/registry/composer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,GAAG,EACH,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAW5B,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC;IAC3C,uFAAuF;IACvF,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IACvC,gHAAgH;IAChH,QAAQ,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,CAAC;IACxD;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,gBAAgB,EAAE,CAAC;CAC7C;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,GAAG,EAAE,EACjB,YAAY,EAAE,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,iBAAiB,CAgKnB"}
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../src/registry/composer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,GAAG,EACH,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAW5B,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC;IAC3C,uFAAuF;IACvF,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IACvC,gHAAgH;IAChH,QAAQ,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,CAAC;IACxD;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,gBAAgB,EAAE,CAAC;CAC7C;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,GAAG,EAAE,EACjB,YAAY,EAAE,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,iBAAiB,CAsKnB"}

package/dist/registry/composer.js

@@ -79,13 +79,18 @@ export function composeTemplates(activeTags, allTemplates, options) {
                 }
             }
         }
-        // Compose hooks (deduplicate by name — not tier-filtered)
+        // Compose hooks (deduplicate by name — stack-filtered, not tier-filtered)
         if (templateSet.hooks) {
             for (const hook of templateSet.hooks) {
-                if (!seenHookNames.has(hook.name)) {
-                    seenHookNames.add(hook.name);
-                    hooks.push(hook);
+                if (seenHookNames.has(hook.name))
+                    continue;
+                // Skip hooks that declare a stack restriction when no active tag matches
+                if (hook.stack?.length &&
+                    !hook.stack.some((s) => orderedTags.includes(s))) {
+                    continue;
                 }
+                seenHookNames.add(hook.name);
+                hooks.push(hook);
             }
         }
         // Compose skills (deduplicate by id, filter by tier)