forgecraft-mcp 0.3.0 → 0.5.0

package/README.md

@@ -17,14 +17,10 @@ AI coding assistants work better with clear engineering standards. Most start wi
 **Supports:** Claude (CLAUDE.md) · Cursor (.cursor/rules/) · GitHub Copilot (.github/copilot-instructions.md) · Windsurf (.windsurfrules) · Cline (.clinerules) · Aider (CONVENTIONS.md)
 
 ```bash
-claude mcp add forgecraft -- npx -y forgecraft-mcp
+npx forgecraft-mcp setup .
 ```
 
-Then tell Claude:
-
-> "Set up this project for production"
-
-Done. Your AI assistant now has tailored instruction files with SOLID principles, testing standards, architecture patterns, CI/CD guidance, and quality-gate hooks — all matched to your stack.
+That's it. ForgeCraft scans your project, auto-detects your stack, and generates tailored instruction files in seconds.
 
 ## `claude init` vs ForgeCraft
 
@@ -39,54 +35,35 @@ Done. Your AI assistant now has tailored instruction files with SOLID principles
 | **Quality gates** | None | Pre-commit hooks that enforce standards |
 | **CI/CD** | None | Pipeline stages, environments, deploy guidance |
 | **Session continuity** | None | `Status.md` + `forgecraft.yaml` persist context |
-| **Drift detection** | None | `refresh_project` detects scope changes |
-| **Compliance scoring** | None | `audit_project` scores 0-100 |
+| **Drift detection** | None | `refresh` detects scope changes |
+| **Compliance scoring** | None | `audit` scores 0-100 |
 
 ## How It Works
 
+```bash
+# First-time setup — auto-detects your stack
+npx forgecraft-mcp setup .
+
+# → scans your code → detects [API] + [WEB-REACT]
+# → creates forgecraft.yaml
+# → generates CLAUDE.md, .cursor/rules/, etc.
+# → adds quality-gate hooks
+# → done
 ```
-You: "Set up this project for production"
-
-Claude calls setup_project → scans your code → detects [API] + [WEB-REACT]
-                           → creates forgecraft.yaml
-                           → generates instruction files for your AI assistant(s)
-                           → adds quality-gate hooks
-                           → done
-```
-
-ForgeCraft is an [MCP server](https://modelcontextprotocol.io/) — it gives Claude 14 specialized tools. Claude picks the right ones automatically. You just describe what you want in plain English.
-
-> **Already ran `claude init`?** ForgeCraft's `generate_instructions` can merge with your existing CLAUDE.md (`merge_with_existing: true`), keeping your custom sections while adding production standards.
 
-## Install
+ForgeCraft is a **setup-time CLI tool**. Run it once to configure your project, then remove it — it has no runtime footprint.
 
-**One line. Takes 10 seconds.**
+optional: add the MCP sentinel to let your AI assistant diagnose and recommend commands:
 
 ```bash
 claude mcp add forgecraft -- npx -y forgecraft-mcp
 ```
 
-Restart Claude Code. That's it.
-
-<details>
-<summary>Alternative: manual config</summary>
-
-Add to `.claude/settings.json`:
-```json
-{
-  "mcpServers": {
-    "forgecraft": {
-      "command": "npx",
-      "args": ["-y", "forgecraft-mcp"]
-    }
-  }
-}
-```
-</details>
+The sentinel is a single lightweight tool (~200 tokens) that checks your project state and tells your AI what CLI command to run next. [Remove it](#mcp-sentinel) after initial setup to save tokens.
 
 ## What You Get
 
-After `setup_project`, your project has:
+After `npx forgecraft-mcp setup`, your project has:
 
 ```
 your-project/
@@ -164,24 +141,74 @@ tags: [UNIVERSAL, API]
 tier: recommended
 ```
 
-## All 14 Tools
-
-| Tool | Purpose |
-|------|---------|
-| `setup_project` | **Start here.** Analyze → classify → configure → generate. |
-| `refresh_project` | Re-scan after changes. Detects new tags, updates config. |
-| `classify_project` | Analyze code to suggest tags |
-| `scaffold_project` | Generate full project structure |
-| `generate_instructions` | Create instruction files for any AI assistant |
-| `audit_project` | Score compliance (0-100). Run in CI. |
-| `review_project` | Structured review checklist |
-| `convert_existing` | Phased migration plan for legacy code |
-| `add_hook` | Add quality-gate hooks |
-| `add_module` | Scaffold a feature module |
-| `configure_mcp` | Discover & configure recommended MCP servers |
-| `get_nfr_template` | NFR sections for tech specs |
-| `list_tags` | Show all available tags |
-| `list_hooks` | Show hooks, filterable by tag |
+## CLI Commands
+
+```bash
+npx forgecraft-mcp <command> [dir] [flags]
+```
+
+| Command | Purpose |
+|---------|--------|
+| `setup <dir>` | **Start here.** Analyze → auto-detect stack → generate instruction files + hooks |
+| `refresh <dir>` | Re-scan after project changes. Detects new tags, shows before/after diff. |
+| `refresh <dir> --apply` | Apply the refresh (default is preview-only) |
+| `audit <dir>` | Score compliance (0-100). Reads tags from `forgecraft.yaml`. |
+| `scaffold <dir> --tags ...` | Generate full folder structure + instruction files |
+| `review [dir] --tags ...` | Structured code review checklist (4 dimensions) |
+| `list tags` | Show all 24 available tags |
+| `list hooks --tags ...` | Show quality-gate hooks for given tags |
+| `list skills --tags ...` | Show skill files for given tags |
+| `classify [dir]` | Analyze code to suggest tags |
+| `generate <dir>` | Regenerate instruction files only |
+| `convert <dir>` | Phased migration plan for legacy code |
+| `add-hook <name> <dir>` | Add a quality-gate hook |
+| `add-module <name> <dir>` | Scaffold a feature module |
+
+### Common flags
+
+```
+--tags UNIVERSAL API     Project classification tags (or read from forgecraft.yaml)
+--tier core|recommended  Content depth (default: recommended)
+--targets claude cursor  AI assistant targets (default: claude)
+--dry-run                Preview without writing files
+--apply                  Apply changes (for refresh)
+--language typescript    typescript | python (default: typescript)
+--scope focused          comprehensive | focused (for review)
+```
+
+## MCP Sentinel
+
+Optionally add the ForgeCraft MCP sentinel to let your AI assistant diagnose your project and suggest the right CLI command:
+
+```bash
+claude mcp add forgecraft -- npx -y forgecraft-mcp
+```
+
+The sentinel is a **single minimal tool** (~200 tokens per request, vs ~1,500 for a full MCP tool suite). It checks whether `forgecraft.yaml`, `CLAUDE.md`, and `.claude/hooks` exist, then returns targeted CLI commands to run.
+
+**Recommended workflow:**
+1. Add the sentinel temporarily
+2. Let Claude run `npx forgecraft-mcp setup .`
+3. Remove the sentinel: `claude mcp remove forgecraft`
+4. Re-add it when you need to refresh or audit
+
+<details>
+<summary>Manual MCP config</summary>
+
+Add to `.claude/settings.json`:
+```json
+{
+  "mcpServers": {
+    "forgecraft": {
+      "command": "npx",
+      "args": ["-y", "forgecraft-mcp"]
+    }
+  }
+}
+```
+</details>
+
+> **Already ran `claude init`?** Use `npx forgecraft-mcp generate . --merge` to merge with your existing CLAUDE.md, keeping your custom sections while adding production standards.
 
 ## Configuration
 
@@ -227,7 +254,14 @@ Score: 72/100  Grade: C
 
 ### Refresh (project scope changed?)
 
-Tell Claude *"refresh this project"* — it re-scans, suggests new tags, shows before/after impact, and updates everything on approval.
+```bash
+npx forgecraft-mcp refresh . --apply
+```
+
+Or in preview mode first (default):
+```bash
+npx forgecraft-mcp refresh .   # shows before/after diff without writing
+```
 
 ## Contributing
 
@@ -247,7 +281,7 @@ PRs welcome. See [`templates/universal/`](templates/universal/) for the format.
 
 ### MCP Server Discovery
 
-`configure_mcp` dynamically discovers recommended MCP servers matching your project tags. Servers are curated in `mcp-servers.yaml` per tag — community-contributable via PRs.
+`npx forgecraft-mcp configure-mcp` dynamically discovers recommended MCP servers matching your project tags. Servers are curated in `mcp-servers.yaml` per tag — community-contributable via PRs.
 
 Built-in recommendations include Context7 (docs), Playwright (testing), Chrome DevTools (debugging), Stripe (fintech), Docker/K8s (infra), and more across all 24 tags.
 
@@ -265,7 +299,7 @@ git clone https://github.com/jghiringhelli/forgecraft-mcp.git
 cd forgecraft-mcp
 npm install
 npm run build
-npm test   # 128 tests, 10 suites
+npm test   # 229 tests, 16 suites
 ```
 
 ## License

package/dist/cli.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI mode for ForgeCraft.
+ *
+ * Handles `npx forgecraft-mcp <command> [args]` invocations.
+ * Each subcommand maps directly to an existing handler function.
+ * Returns `true` when a command is handled so the caller skips MCP server startup.
+ */
+/**
+ * Run CLI mode. Returns `true` when a command was handled, `false` to fall
+ * through to MCP server startup.
+ *
+ * @param argv - Raw process.argv (will be sliced from index 2)
+ */
+export declare function runCli(argv: string[]): Promise<boolean>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkTH;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAuC7D"}

package/dist/cli.js

@@ -0,0 +1,345 @@
+/**
+ * CLI mode for ForgeCraft.
+ *
+ * Handles `npx forgecraft-mcp <command> [args]` invocations.
+ * Each subcommand maps directly to an existing handler function.
+ * Returns `true` when a command is handled so the caller skips MCP server startup.
+ */
+import { resolve } from "node:path";
+import { loadUserOverrides } from "./registry/loader.js";
+import { setupProjectHandler } from "./tools/setup-project.js";
+import { refreshProjectHandler } from "./tools/refresh-project.js";
+import { auditProjectHandler } from "./tools/audit.js";
+import { scaffoldProjectHandler } from "./tools/scaffold.js";
+import { reviewProjectHandler } from "./tools/review.js";
+import { listTagsHandler, listHooksHandler, listSkillsHandler } from "./tools/list.js";
+import { classifyProjectHandler } from "./tools/classify.js";
+import { generateInstructionsHandler } from "./tools/generate-claude-md.js";
+import { convertExistingHandler } from "./tools/convert.js";
+import { addHookHandler } from "./tools/add-hook.js";
+import { addModuleHandler } from "./tools/add-module.js";
+/**
+ * Minimal argv parser — no external dependencies.
+ * `--flag val1 val2` → `flags["flag"] = ["val1", "val2"]`
+ * `--flag` alone → `flags["flag"] = true`
+ * `--no-flag` → `flags["flag"] = false`
+ */
+function parseCliArgs(argv) {
+    const [command = "serve", ...rest] = argv;
+    const positional = [];
+    const flags = {};
+    let i = 0;
+    while (i < rest.length) {
+        const arg = rest[i];
+        if (arg.startsWith("--no-")) {
+            flags[arg.slice(5)] = false;
+            i++;
+        }
+        else if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const values = [];
+            i++;
+            while (i < rest.length && !rest[i].startsWith("--")) {
+                values.push(rest[i]);
+                i++;
+            }
+            flags[key] = values.length === 0 ? true : values;
+        }
+        else {
+            positional.push(arg);
+            i++;
+        }
+    }
+    return { command, positional, flags };
+}
+/** Extract first value of an array flag, or undefined. */
+function str(flags, key) {
+    const v = flags[key];
+    return Array.isArray(v) ? v[0] : undefined;
+}
+/** Extract array flag values, or undefined if absent/empty. */
+function arr(flags, key) {
+    const v = flags[key];
+    return Array.isArray(v) && v.length > 0 ? v : undefined;
+}
+/** Extract boolean flag, falling back to a default. */
+function bool(flags, key, defaultVal) {
+    const v = flags[key];
+    return typeof v === "boolean" ? v : defaultVal;
+}
+// ── Config Resolution ────────────────────────────────────────────────
+/**
+ * Resolve tags from explicit flags or fall back to forgecraft.yaml.
+ *
+ * @param dir - Project directory to read config from
+ * @param flagTags - Explicitly provided tags from --tags flag
+ * @returns Resolved tags, or undefined if none found
+ */
+function resolveTagsFromConfig(dir, flagTags) {
+    if (flagTags && flagTags.length > 0)
+        return flagTags;
+    const config = loadUserOverrides(resolve(dir));
+    return config?.tags ?? undefined;
+}
+// ── Output ───────────────────────────────────────────────────────────
+/** Extract text from MCP-style handler result and print to stdout. */
+function printResult(result) {
+    console.log(result.content[0]?.text ?? "");
+}
+// ── Commands ─────────────────────────────────────────────────────────
+async function cmdSetup(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const result = await setupProjectHandler({
+        project_dir: projectDir,
+        project_name: str(flags, "name"),
+        description: str(flags, "description"),
+        tier: str(flags, "tier") ?? "recommended",
+        tags: arr(flags, "tags"),
+        dry_run: bool(flags, "dry-run", false),
+        output_targets: arr(flags, "targets") ?? ["claude"],
+    });
+    printResult(result);
+}
+async function cmdRefresh(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const result = await refreshProjectHandler({
+        project_dir: projectDir,
+        apply: bool(flags, "apply", false),
+        tier: str(flags, "tier"),
+        add_tags: arr(flags, "add-tags"),
+        remove_tags: arr(flags, "remove-tags"),
+        output_targets: arr(flags, "targets"),
+    });
+    printResult(result);
+}
+async function cmdAudit(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const tags = resolveTagsFromConfig(projectDir, arr(flags, "tags"));
+    if (!tags || tags.length === 0) {
+        console.error("Error: --tags required (or add forgecraft.yaml with tags)");
+        process.exit(1);
+    }
+    const result = await auditProjectHandler({
+        tags,
+        project_dir: projectDir,
+        include_anti_patterns: bool(flags, "anti-patterns", true),
+    });
+    printResult(result);
+}
+async function cmdScaffold(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const tags = resolveTagsFromConfig(projectDir, arr(flags, "tags"));
+    if (!tags || tags.length === 0) {
+        console.error("Error: --tags required (or add forgecraft.yaml with tags)");
+        process.exit(1);
+    }
+    const result = await scaffoldProjectHandler({
+        tags,
+        project_dir: projectDir,
+        project_name: str(flags, "name") ?? "My Project",
+        language: str(flags, "language") ?? "typescript",
+        dry_run: bool(flags, "dry-run", false),
+        force: bool(flags, "force", false),
+        output_targets: arr(flags, "targets") ?? ["claude"],
+    });
+    printResult(result);
+}
+async function cmdReview(pos, flags) {
+    const projectDir = pos[0] ? resolve(pos[0]) : process.cwd();
+    const tags = resolveTagsFromConfig(projectDir, arr(flags, "tags"));
+    if (!tags || tags.length === 0) {
+        console.error("Error: --tags required (or add forgecraft.yaml with tags)");
+        process.exit(1);
+    }
+    const result = await reviewProjectHandler({
+        tags,
+        scope: str(flags, "scope") ?? "comprehensive",
+    });
+    printResult(result);
+}
+async function cmdList(pos, flags) {
+    const resource = pos[0] ?? "tags";
+    const filterTags = arr(flags, "tags");
+    if (resource === "hooks") {
+        printResult(await listHooksHandler({ tags: filterTags }));
+    }
+    else if (resource === "skills") {
+        printResult(await listSkillsHandler({ tags: filterTags }));
+    }
+    else {
+        printResult(await listTagsHandler());
+    }
+}
+async function cmdClassify(pos, flags) {
+    const result = await classifyProjectHandler({
+        project_dir: pos[0] ? resolve(pos[0]) : undefined,
+        description: str(flags, "description"),
+    });
+    printResult(result);
+}
+async function cmdGenerate(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const tags = resolveTagsFromConfig(projectDir, arr(flags, "tags"));
+    if (!tags || tags.length === 0) {
+        console.error("Error: --tags required (or add forgecraft.yaml with tags)");
+        process.exit(1);
+    }
+    const result = await generateInstructionsHandler({
+        tags,
+        project_dir: projectDir,
+        project_name: str(flags, "name") ?? "My Project",
+        output_targets: arr(flags, "targets") ?? ["claude"],
+        merge_with_existing: bool(flags, "merge", true),
+    });
+    printResult(result);
+}
+async function cmdConvert(pos, flags) {
+    const projectDir = resolve(pos[0] ?? ".");
+    const tags = resolveTagsFromConfig(projectDir, arr(flags, "tags"));
+    if (!tags || tags.length === 0) {
+        console.error("Error: --tags required (or add forgecraft.yaml with tags)");
+        process.exit(1);
+    }
+    const result = await convertExistingHandler({
+        tags,
+        project_dir: projectDir,
+        scan_depth: str(flags, "scan-depth") ?? "quick",
+    });
+    printResult(result);
+}
+async function cmdAddHook(pos, flags) {
+    const hookName = pos[0];
+    const projectDir = resolve(pos[1] ?? ".");
+    if (!hookName) {
+        console.error("Error: hook name required — npx forgecraft-mcp add-hook <name> <dir>");
+        process.exit(1);
+    }
+    const result = await addHookHandler({
+        hook: hookName,
+        project_dir: projectDir,
+        tag: str(flags, "tag"),
+    });
+    printResult(result);
+}
+async function cmdAddModule(pos, flags) {
+    const moduleName = pos[0];
+    const projectDir = resolve(pos[1] ?? ".");
+    if (!moduleName) {
+        console.error("Error: module name required — npx forgecraft-mcp add-module <name> <dir>");
+        process.exit(1);
+    }
+    const result = await addModuleHandler({
+        module_name: moduleName,
+        project_dir: projectDir,
+        tags: arr(flags, "tags") ?? ["UNIVERSAL"],
+        language: str(flags, "language") ?? "typescript",
+    });
+    printResult(result);
+}
+// ── Help ─────────────────────────────────────────────────────────────
+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
+
+FLAGS (vary by command)
+  --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)
+  --force                Overwrite existing files
+  --tag <tag>            Single tag filter (for add-hook)
+`);
+}
+// ── Entry Point ──────────────────────────────────────────────────────
+/**
+ * Run CLI mode. Returns `true` when a command was handled, `false` to fall
+ * through to MCP server startup.
+ *
+ * @param argv - Raw process.argv (will be sliced from index 2)
+ */
+export async function runCli(argv) {
+    const args = argv.slice(2);
+    if (args.length === 0)
+        return false; // no args → start MCP server
+    // Help flag at any position
+    if (args.includes("--help") || args.includes("-h")) {
+        showHelp();
+        return true;
+    }
+    const { command, positional, flags } = parseCliArgs(args);
+    if (command === "serve")
+        return false; // explicit serve → MCP server
+    try {
+        switch (command) {
+            case "setup":
+                await cmdSetup(positional, flags);
+                break;
+            case "refresh":
+                await cmdRefresh(positional, flags);
+                break;
+            case "audit":
+                await cmdAudit(positional, flags);
+                break;
+            case "scaffold":
+                await cmdScaffold(positional, flags);
+                break;
+            case "review":
+                await cmdReview(positional, flags);
+                break;
+            case "list":
+                await cmdList(positional, flags);
+                break;
+            case "classify":
+                await cmdClassify(positional, flags);
+                break;
+            case "generate":
+                await cmdGenerate(positional, flags);
+                break;
+            case "convert":
+                await cmdConvert(positional, flags);
+                break;
+            case "add-hook":
+                await cmdAddHook(positional, flags);
+                break;
+            case "add-module":
+                await cmdAddModule(positional, flags);
+                break;
+            default:
+                console.error(`Unknown command: ${command}`);
+                showHelp();
+                process.exit(1);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: ${message}`);
+        process.exit(1);
+    }
+    return true;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -1,9 +1,12 @@
 #!/usr/bin/env node
 /**
- * ForgeCraft MCP Server — Entry Point.
+ * ForgeCraft — Entry Point.
  *
- * Registers all tools and starts the MCP server over stdio transport.
- * This is the binary entry point run via `npx forgecraft-mcp`.
+ * Dual-mode binary: runs as a CLI tool when subcommands are provided,
+ * or starts the MCP server in stdio mode when invoked without subcommands.
+ *
+ * CLI usage:   npx forgecraft-mcp setup .
+ * MCP usage:   npx forgecraft-mcp          (or: npx forgecraft-mcp serve)
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}