forgecraft-mcp 0.1.0

package/dist/tools/refresh-project.js

@@ -0,0 +1,257 @@
+/**
+ * refresh_project tool handler.
+ *
+ * Re-analyzes an existing project that has forgecraft.yaml,
+ * detects drift (new tags, changed scope), and proposes updates.
+ * Can optionally apply updates to config and CLAUDE.md.
+ */
+import { z } from "zod";
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import yaml from "js-yaml";
+import { ALL_TAGS, CONTENT_TIERS } from "../shared/types.js";
+import { analyzeProject } from "../analyzers/package-json.js";
+import { checkCompleteness } from "../analyzers/completeness.js";
+import { loadAllTemplatesWithExtras, loadUserOverrides } from "../registry/loader.js";
+import { composeTemplates } from "../registry/composer.js";
+import { renderClaudeMd } from "../registry/renderer.js";
+import { createLogger } from "../shared/logger/index.js";
+const logger = createLogger("tools/refresh-project");
+/** Minimum confidence to suggest a new tag. */
+const SUGGEST_THRESHOLD = 0.5;
+// ── Schema ───────────────────────────────────────────────────────────
+export const refreshProjectSchema = z.object({
+    project_dir: z
+        .string()
+        .describe("Absolute path to the project root directory."),
+    apply: z
+        .boolean()
+        .default(false)
+        .describe("If true, apply recommended changes to forgecraft.yaml and CLAUDE.md."),
+    tier: z
+        .enum(CONTENT_TIERS)
+        .optional()
+        .describe("Override tier level. If omitted, uses current config value."),
+    add_tags: z
+        .array(z.enum(ALL_TAGS))
+        .optional()
+        .describe("Explicitly add these tags during refresh."),
+    remove_tags: z
+        .array(z.enum(ALL_TAGS))
+        .optional()
+        .describe("Explicitly remove these tags during refresh."),
+});
+// ── Handler ──────────────────────────────────────────────────────────
+export async function refreshProjectHandler(args) {
+    const projectDir = args.project_dir;
+    logger.info("Refresh project starting", { projectDir, apply: args.apply });
+    // ── Step 1: Load current config ────────────────────────────────
+    const existingConfig = loadUserOverrides(projectDir);
+    if (!existingConfig) {
+        return {
+            content: [{
+                    type: "text",
+                    text: buildNoConfigOutput(projectDir),
+                }],
+        };
+    }
+    // ── Step 2: Re-analyze project ─────────────────────────────────
+    const drift = analyzeDrift(projectDir, existingConfig, args);
+    // ── Step 3: Build updated config ───────────────────────────────
+    const updatedTags = computeUpdatedTags(drift.currentTags, drift.newTagSuggestions, args.add_tags, args.remove_tags);
+    const updatedTier = args.tier ?? existingConfig.tier ?? "recommended";
+    const updatedConfig = {
+        ...existingConfig,
+        tags: updatedTags,
+        tier: updatedTier,
+    };
+    // ── Step 4: Compose with updated config ────────────────────────
+    const allTemplates = await loadAllTemplatesWithExtras(undefined, updatedConfig.templateDirs);
+    const composed = composeTemplates(updatedTags, allTemplates, { config: updatedConfig });
+    // ── Step 5: Apply or preview ───────────────────────────────────
+    if (!args.apply) {
+        return {
+            content: [{
+                    type: "text",
+                    text: buildPreviewOutput(drift, updatedTags, updatedConfig, composed, updatedTier),
+                }],
+        };
+    }
+    // Write updated config
+    const configYaml = yaml.dump(updatedConfig, { lineWidth: 100, noRefs: true });
+    writeFileSync(join(projectDir, "forgecraft.yaml"), configYaml, "utf-8");
+    // Regenerate CLAUDE.md
+    const context = {
+        projectName: updatedConfig.projectName ?? inferProjectName(projectDir),
+        language: "typescript",
+        tags: updatedTags,
+    };
+    const claudeContent = renderClaudeMd(composed.claudeMdBlocks, context);
+    writeFileSync(join(projectDir, "CLAUDE.md"), claudeContent, "utf-8");
+    return {
+        content: [{
+                type: "text",
+                text: buildAppliedOutput(drift, updatedTags, updatedConfig, composed, updatedTier),
+            }],
+    };
+}
+// ── Drift Analysis ───────────────────────────────────────────────────
+/**
+ * Analyze how the project has drifted from its current config.
+ */
+function analyzeDrift(projectDir, config, args) {
+    const currentTags = config.tags ?? ["UNIVERSAL"];
+    const currentTier = (config.tier ?? "recommended");
+    const requestedTier = (args.tier ?? currentTier);
+    // Re-detect tags from code
+    const detections = analyzeProject(projectDir);
+    const newTagSuggestions = [];
+    const detectedTagSet = new Set();
+    for (const d of detections) {
+        detectedTagSet.add(d.tag);
+        if (d.confidence >= SUGGEST_THRESHOLD && !currentTags.includes(d.tag)) {
+            newTagSuggestions.push({ tag: d.tag, confidence: d.confidence, evidence: d.evidence });
+        }
+    }
+    // Tags in config that code analysis no longer supports
+    const droppedTagCandidates = currentTags.filter((t) => t !== "UNIVERSAL" && !detectedTagSet.has(t));
+    // Completeness re-check
+    const completeness = checkCompleteness(projectDir, currentTags);
+    const completenessGaps = completeness.failing.map((f) => f.check);
+    const completenessFixed = completeness.passing.map((p) => p.check);
+    // Tier change
+    const tierChange = requestedTier !== currentTier
+        ? { from: currentTier, to: requestedTier }
+        : null;
+    // Block count comparison (before vs after)
+    const allTemplates = loadAllTemplatesWithExtras(undefined, config.templateDirs);
+    const beforeComposed = composeTemplates(currentTags, allTemplates, { config });
+    const proposedTags = computeUpdatedTags(currentTags, newTagSuggestions, args.add_tags, args.remove_tags);
+    const afterConfig = { ...config, tags: proposedTags, tier: requestedTier };
+    const afterComposed = composeTemplates(proposedTags, allTemplates, { config: afterConfig });
+    return {
+        currentTags,
+        newTagSuggestions,
+        droppedTagCandidates,
+        completenessGaps,
+        completenessFixed,
+        tierChange,
+        blockCountDelta: {
+            before: beforeComposed.claudeMdBlocks.length,
+            after: afterComposed.claudeMdBlocks.length,
+        },
+    };
+}
+// ── Tag Computation ──────────────────────────────────────────────────
+/**
+ * Compute the updated tag set from current tags, suggestions, and explicit adds/removes.
+ */
+function computeUpdatedTags(currentTags, suggestions, addTags, removeTags) {
+    const tagSet = new Set(currentTags);
+    // Add high-confidence suggestions
+    for (const s of suggestions) {
+        if (s.confidence >= 0.6) {
+            tagSet.add(s.tag);
+        }
+    }
+    // Explicit adds
+    if (addTags) {
+        for (const t of addTags) {
+            tagSet.add(t);
+        }
+    }
+    // Explicit removes (never remove UNIVERSAL)
+    if (removeTags) {
+        for (const t of removeTags) {
+            if (t !== "UNIVERSAL") {
+                tagSet.delete(t);
+            }
+        }
+    }
+    // Ensure UNIVERSAL
+    tagSet.add("UNIVERSAL");
+    return Array.from(tagSet);
+}
+// ── Output Formatting ────────────────────────────────────────────────
+/**
+ * Infer project name from directory path.
+ */
+function inferProjectName(projectDir) {
+    const parts = projectDir.replace(/\\/g, "/").split("/").filter(Boolean);
+    return parts[parts.length - 1] ?? "my-project";
+}
+/**
+ * Output when no forgecraft.yaml exists.
+ */
+function buildNoConfigOutput(projectDir) {
+    return (`# No Configuration Found\n\n` +
+        `No forgecraft.yaml or .forgecraft.json found in \`${projectDir}\`.\n\n` +
+        `Run \`setup_project\` first to initialize your project configuration.\n`);
+}
+/**
+ * Build the preview (dry-run) output for proposed changes.
+ */
+function buildPreviewOutput(drift, updatedTags, _config, composed, tier) {
+    let text = `# Refresh Preview\n\n`;
+    text += `**Current Tags:** ${drift.currentTags.map((t) => `[${t}]`).join(" ")}\n`;
+    text += `**Proposed Tags:** ${updatedTags.map((t) => `[${t}]`).join(" ")}\n`;
+    text += `**Tier:** ${tier}\n\n`;
+    // New tag suggestions
+    if (drift.newTagSuggestions.length > 0) {
+        text += `## New Tags Detected\n`;
+        for (const s of drift.newTagSuggestions) {
+            const marker = s.confidence >= 0.6 ? "✅ auto-add" : "💡 suggest";
+            text += `- **[${s.tag}]** (${Math.round(s.confidence * 100)}%) — ${marker}: ${s.evidence.join(", ")}\n`;
+        }
+        text += "\n";
+    }
+    // Dropped tag candidates
+    if (drift.droppedTagCandidates.length > 0) {
+        text += `## Tags No Longer Detected\n`;
+        text += `_These tags are in your config but not detected in code. Consider removing if no longer relevant._\n`;
+        text += drift.droppedTagCandidates.map((t) => `- [${t}]`).join("\n");
+        text += "\n\n";
+    }
+    // Tier change
+    if (drift.tierChange) {
+        text += `## Tier Change\n`;
+        text += `${drift.tierChange.from} → ${drift.tierChange.to}\n\n`;
+    }
+    // Block delta
+    text += `## Content Impact\n`;
+    text += `- CLAUDE.md blocks: ${drift.blockCountDelta.before} → ${drift.blockCountDelta.after}\n`;
+    text += `- Total available: ${composed.claudeMdBlocks.length} blocks, ${composed.nfrBlocks.length} NFRs, ${composed.hooks.length} hooks\n\n`;
+    // Gaps
+    if (drift.completenessGaps.length > 0) {
+        text += `## Remaining Gaps\n`;
+        text += drift.completenessGaps.map((g) => `- ${g}`).join("\n");
+        text += "\n\n";
+    }
+    text += `_Run again with apply=true to write changes._`;
+    return text;
+}
+/**
+ * Build the output after applying changes.
+ */
+function buildAppliedOutput(drift, updatedTags, config, composed, tier) {
+    const configYaml = yaml.dump(config, { lineWidth: 100, noRefs: true });
+    let text = `# Project Refreshed\n\n`;
+    text += `**Tags:** ${updatedTags.map((t) => `[${t}]`).join(" ")}\n`;
+    text += `**Tier:** ${tier}\n\n`;
+    text += `## Changes Applied\n`;
+    text += `- forgecraft.yaml — updated\n`;
+    text += `- CLAUDE.md — regenerated (${composed.claudeMdBlocks.length} blocks)\n\n`;
+    if (drift.newTagSuggestions.length > 0) {
+        const added = drift.newTagSuggestions.filter((s) => s.confidence >= 0.6);
+        if (added.length > 0) {
+            text += `## New Tags Added\n`;
+            text += added.map((s) => `- [${s.tag}] — ${s.evidence.join(", ")}`).join("\n");
+            text += "\n\n";
+        }
+    }
+    text += `## Updated Config\n`;
+    text += `\`\`\`yaml\n${configYaml}\`\`\`\n\n`;
+    text += `⚠️ **Restart required** to pick up CLAUDE.md changes.`;
+    return text;
+}
+//# sourceMappingURL=refresh-project.js.map

package/dist/tools/refresh-project.js.map

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

package/dist/tools/review.d.ts

@@ -0,0 +1,31 @@
+/**
+ * review_project tool handler.
+ *
+ * Returns a structured code review checklist composed from review templates
+ * for the project's active tags. Supports comprehensive (all items) or
+ * focused (critical-only) scope.
+ */
+import { z } from "zod";
+export declare const reviewProjectSchema: z.ZodObject<{
+    tags: z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">;
+    scope: z.ZodDefault<z.ZodEnum<["comprehensive", "focused"]>>;
+}, "strip", z.ZodTypeAny, {
+    tags: string[];
+    scope: "comprehensive" | "focused";
+}, {
+    tags: string[];
+    scope?: "comprehensive" | "focused" | undefined;
+}>;
+/**
+ * Generate a structured code review checklist for the given tags and scope.
+ *
+ * @param args - Validated tool input with tags and scope.
+ * @returns MCP tool response with rendered review checklist.
+ */
+export declare function reviewProjectHandler(args: z.infer<typeof reviewProjectSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=review.d.ts.map

package/dist/tools/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,mBAAmB;;;;;;;;;EAY9B,CAAC;AAIH;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8C7D"}

package/dist/tools/review.js

@@ -0,0 +1,62 @@
+/**
+ * review_project tool handler.
+ *
+ * Returns a structured code review checklist composed from review templates
+ * for the project's active tags. Supports comprehensive (all items) or
+ * focused (critical-only) scope.
+ */
+import { z } from "zod";
+import { ALL_TAGS } from "../shared/types.js";
+import { loadAllTemplates } from "../registry/loader.js";
+import { composeTemplates } from "../registry/composer.js";
+import { renderReviewChecklist } from "../registry/renderer.js";
+// ── Schema ───────────────────────────────────────────────────────────
+export const reviewProjectSchema = z.object({
+    tags: z
+        .array(z.enum(ALL_TAGS))
+        .min(1)
+        .describe("Active project tags to generate review checklist for."),
+    scope: z
+        .enum(["comprehensive", "focused"])
+        .default("comprehensive")
+        .describe("Review scope: 'comprehensive' covers all severity levels across all 4 dimensions. " +
+        "'focused' limits to critical items only — ideal for quick pre-merge reviews."),
+});
+// ── Handler ──────────────────────────────────────────────────────────
+/**
+ * Generate a structured code review checklist for the given tags and scope.
+ *
+ * @param args - Validated tool input with tags and scope.
+ * @returns MCP tool response with rendered review checklist.
+ */
+export async function reviewProjectHandler(args) {
+    const tags = args.tags.includes("UNIVERSAL")
+        ? args.tags
+        : ["UNIVERSAL", ...args.tags];
+    const templateSets = loadAllTemplates();
+    const composed = composeTemplates(tags, templateSets);
+    if (composed.reviewBlocks.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No review templates found for the specified tags.",
+                },
+            ],
+        };
+    }
+    const reviewContent = renderReviewChecklist(composed.reviewBlocks, args.scope);
+    const scopeLabel = args.scope === "comprehensive"
+        ? "Comprehensive (all severity levels)"
+        : "Focused (critical items only)";
+    const dimensionCount = new Set(composed.reviewBlocks.map((block) => block.dimension)).size;
+    const totalChecks = composed.reviewBlocks.reduce((sum, block) => sum + block.checklist.length, 0);
+    let text = `# Code Review Checklist\n\n`;
+    text += `**Tags:** ${tags.map((t) => `[${t}]`).join(" ")}\n`;
+    text += `**Scope:** ${scopeLabel}\n`;
+    text += `**Dimensions:** ${dimensionCount}\n`;
+    text += `**Total checks:** ${totalChecks}\n\n`;
+    text += reviewContent;
+    return { content: [{ type: "text", text }] };
+}
+//# sourceMappingURL=review.js.map

package/dist/tools/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,wEAAwE;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAA4C,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,uDAAuD,CAAC;IACpE,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;SAClC,OAAO,CAAC,eAAe,CAAC;SACxB,QAAQ,CACP,oFAAoF;QACpF,8EAA8E,CAC/E;CACJ,CAAC,CAAC;AAEH,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAyC;IAEzC,MAAM,IAAI,GAAU,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QACjD,CAAC,CAAE,IAAI,CAAC,IAAc;QACtB,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAW,CAAC;IAE3C,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAEtD,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,mDAAmD;iBAC1D;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CACzC,QAAQ,CAAC,YAAY,EACrB,IAAI,CAAC,KAAK,CACX,CAAC;IAEF,MAAM,UAAU,GACd,IAAI,CAAC,KAAK,KAAK,eAAe;QAC5B,CAAC,CAAC,qCAAqC;QACvC,CAAC,CAAC,+BAA+B,CAAC;IAEtC,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CACtD,CAAC,IAAI,CAAC;IAEP,MAAM,WAAW,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,CAC9C,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAC5C,CAAC,CACF,CAAC;IAEF,IAAI,IAAI,GAAG,6BAA6B,CAAC;IACzC,IAAI,IAAI,aAAa,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAC7D,IAAI,IAAI,cAAc,UAAU,IAAI,CAAC;IACrC,IAAI,IAAI,mBAAmB,cAAc,IAAI,CAAC;IAC9C,IAAI,IAAI,qBAAqB,WAAW,MAAM,CAAC;IAC/C,IAAI,IAAI,aAAa,CAAC;IAEtB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/tools/scaffold.d.ts

@@ -0,0 +1,32 @@
+/**
+ * scaffold_project tool handler.
+ *
+ * Generates full project structure from classified tags.
+ */
+import { z } from "zod";
+export declare const scaffoldProjectSchema: z.ZodObject<{
+    tags: z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">;
+    project_dir: z.ZodString;
+    project_name: z.ZodString;
+    language: z.ZodDefault<z.ZodEnum<["typescript", "python"]>>;
+    dry_run: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    tags: string[];
+    project_dir: string;
+    language: "typescript" | "python";
+    project_name: string;
+    dry_run: boolean;
+}, {
+    tags: string[];
+    project_dir: string;
+    project_name: string;
+    language?: "typescript" | "python" | undefined;
+    dry_run?: boolean | undefined;
+}>;
+export declare function scaffoldProjectHandler(args: z.infer<typeof scaffoldProjectSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAmBhC,CAAC;AAIH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC1C,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqH7D"}

package/dist/tools/scaffold.js

@@ -0,0 +1,160 @@
+/**
+ * scaffold_project tool handler.
+ *
+ * Generates full project structure from classified tags.
+ */
+import { z } from "zod";
+import { mkdirSync, writeFileSync, chmodSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { ALL_TAGS } from "../shared/types.js";
+import { loadAllTemplatesWithExtras, loadUserOverrides } from "../registry/loader.js";
+import { composeTemplates } from "../registry/composer.js";
+import { renderClaudeMd, renderStatusMd, renderPrdSkeleton, renderTechSpecSkeleton, } from "../registry/renderer.js";
+import { createLogger } from "../shared/logger/index.js";
+const logger = createLogger("tools/scaffold");
+// ── Schema ───────────────────────────────────────────────────────────
+export const scaffoldProjectSchema = z.object({
+    tags: z
+        .array(z.enum(ALL_TAGS))
+        .min(1)
+        .describe("Project classification tags. UNIVERSAL is always included."),
+    project_dir: z
+        .string()
+        .describe("Absolute path to the project root directory."),
+    project_name: z
+        .string()
+        .describe("Human-readable project name."),
+    language: z
+        .enum(["typescript", "python"])
+        .default("typescript")
+        .describe("Primary programming language."),
+    dry_run: z
+        .boolean()
+        .default(false)
+        .describe("If true, return the plan without writing files."),
+});
+// ── Handler ──────────────────────────────────────────────────────────
+export async function scaffoldProjectHandler(args) {
+    const tags = args.tags.includes("UNIVERSAL")
+        ? args.tags
+        : ["UNIVERSAL", ...args.tags];
+    logger.info("Scaffolding project", {
+        tags,
+        projectDir: args.project_dir,
+        dryRun: args.dry_run,
+    });
+    // Load and compose templates (respects forgecraft.yaml config if present)
+    const userConfig = loadUserOverrides(args.project_dir);
+    const templateSets = await loadAllTemplatesWithExtras(undefined, userConfig?.templateDirs);
+    const composed = composeTemplates(tags, templateSets, {
+        config: userConfig ?? undefined,
+    });
+    const context = {
+        projectName: args.project_name,
+        language: args.language,
+        tags,
+    };
+    const filesCreated = [];
+    // Render content
+    const claudeMdContent = renderClaudeMd(composed.claudeMdBlocks, context);
+    const statusMdContent = renderStatusMd(context);
+    const prdContent = renderPrdSkeleton(context);
+    const techSpecContent = renderTechSpecSkeleton(context);
+    if (args.dry_run) {
+        const plan = buildDryRunPlan(composed, tags);
+        return { content: [{ type: "text", text: plan }] };
+    }
+    // Create directories from structure entries
+    for (const entry of composed.structureEntries) {
+        const fullPath = join(args.project_dir, entry.path);
+        if (entry.type === "directory") {
+            mkdirSync(fullPath, { recursive: true });
+            filesCreated.push(`${entry.path}/`);
+        }
+    }
+    // Write CLAUDE.md
+    writeFileSafe(join(args.project_dir, "CLAUDE.md"), claudeMdContent);
+    filesCreated.push("CLAUDE.md");
+    // Write Status.md
+    writeFileSafe(join(args.project_dir, "Status.md"), statusMdContent);
+    filesCreated.push("Status.md");
+    // Write docs
+    mkdirSync(join(args.project_dir, "docs"), { recursive: true });
+    writeFileSafe(join(args.project_dir, "docs", "PRD.md"), prdContent);
+    filesCreated.push("docs/PRD.md");
+    writeFileSafe(join(args.project_dir, "docs", "TechSpec.md"), techSpecContent);
+    filesCreated.push("docs/TechSpec.md");
+    // Write .env.example
+    writeFileSafe(join(args.project_dir, ".env.example"), "NODE_ENV=development\nLOG_LEVEL=info\n");
+    filesCreated.push(".env.example");
+    // Write hooks
+    const hooksDir = join(args.project_dir, ".claude", "hooks");
+    mkdirSync(hooksDir, { recursive: true });
+    for (const hook of composed.hooks) {
+        const hookPath = join(hooksDir, hook.filename);
+        writeFileSafe(hookPath, hook.script);
+        try {
+            chmodSync(hookPath, 0o755);
+        }
+        catch {
+            // chmod may fail on Windows, that's OK
+        }
+        filesCreated.push(`.claude/hooks/${hook.filename}`);
+    }
+    // Write .gitignore if not present
+    const gitignorePath = join(args.project_dir, ".gitignore");
+    writeFileSafe(gitignorePath, "node_modules/\ndist/\n.env\ncoverage/\n*.log\n");
+    filesCreated.push(".gitignore");
+    const result = {
+        filesCreated,
+        mcpServersConfigured: [],
+        nextSteps: [
+            "Review and adjust CLAUDE.md for your project specifics",
+            "Fill in docs/PRD.md with your actual requirements",
+            "Fill in docs/TechSpec.md with your architecture decisions",
+            "Run `npm install` or equivalent to install dependencies",
+            "Start implementing your first feature module",
+        ],
+        restartRequired: true,
+    };
+    let text = `# Project Scaffolded Successfully\n\n`;
+    text += `**Tags:** ${tags.map((t) => `[${t}]`).join(" ")}\n`;
+    text += `**Files Created:** ${filesCreated.length}\n\n`;
+    text += `## Created Files\n`;
+    text += filesCreated.map((f) => `- \`${f}\``).join("\n");
+    text += `\n\n## Next Steps\n`;
+    text += result.nextSteps.map((s, i) => `${i + 1}. ${s}`).join("\n");
+    text += `\n\n⚠️ **Restart required** to pick up CLAUDE.md and hooks.`;
+    return { content: [{ type: "text", text }] };
+}
+/**
+ * Write a file, creating parent directories as needed.
+ */
+function writeFileSafe(filePath, content) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, content, "utf-8");
+}
+/**
+ * Build a dry-run plan without writing files.
+ */
+function buildDryRunPlan(composed, tags) {
+    let text = `# Scaffold Plan (Dry Run)\n\n`;
+    text += `**Tags:** ${tags.map((t) => `[${t}]`).join(" ")}\n\n`;
+    text += `## Directories to Create\n`;
+    const dirs = composed.structureEntries.filter((e) => e.type === "directory");
+    text += dirs.map((d) => `- \`${d.path}/\`${d.description ? ` — ${d.description}` : ""}`).join("\n");
+    text += `\n\n## Files to Generate\n`;
+    text += `- CLAUDE.md (${composed.claudeMdBlocks.length} blocks)\n`;
+    text += `- Status.md\n`;
+    text += `- docs/PRD.md (skeleton)\n`;
+    text += `- docs/TechSpec.md (skeleton with ${composed.nfrBlocks.length} NFR sections)\n`;
+    text += `- .env.example\n`;
+    text += `- .gitignore\n`;
+    text += `\n## Hooks to Install (${composed.hooks.length})\n`;
+    text += composed.hooks
+        .map((h) => `- \`${h.filename}\` (${h.trigger}) — ${h.description}`)
+        .join("\n");
+    text += `\n\n_Run again with dry_run=false to write files._`;
+    return text;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/tools/scaffold.js.map

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

package/dist/tools/setup-project.d.ts

@@ -0,0 +1,37 @@
+/**
+ * setup_project tool handler.
+ *
+ * Unified entry point that analyzes a project, detects tags,
+ * loads/creates a forgecraft.yaml config, and orchestrates scaffolding.
+ * Works for both new and existing projects.
+ */
+import { z } from "zod";
+export declare const setupProjectSchema: z.ZodObject<{
+    project_dir: z.ZodString;
+    project_name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tier: z.ZodDefault<z.ZodEnum<[string, ...string[]]>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodEnum<[string, ...string[]]>, "many">>;
+    dry_run: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    project_dir: string;
+    tier: string;
+    dry_run: boolean;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    project_name?: string | undefined;
+}, {
+    project_dir: string;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    tier?: string | undefined;
+    project_name?: string | undefined;
+    dry_run?: boolean | undefined;
+}>;
+export declare function setupProjectHandler(args: z.infer<typeof setupProjectSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=setup-project.d.ts.map

package/dist/tools/setup-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-project.d.ts","sourceRoot":"","sources":["../../src/tools/setup-project.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EA0B7B,CAAC;AAiBH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACvC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAmD7D"}