forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/extract-adrs-from-spec.js

@@ -0,0 +1,410 @@
+/**
+ * extract_adrs_from_spec tool handler.
+ *
+ * Reads a project specification file and derives ADR stubs from technology
+ * decisions described within it. Unlike extract_adrs_from_history (which walks
+ * git log for brownfield projects), this tool is for greenfield projects where
+ * all architectural decisions are encoded in the spec before implementation begins.
+ *
+ * Each generated ADR includes the actual spec excerpt as context — making the
+ * artifact genuinely derived from the spec, not a generic placeholder.
+ */
+import { z } from "zod";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, } from "node:fs";
+import { join } from "node:path";
+// ── Schema ───────────────────────────────────────────────────────────
+export const extractAdrsFromSpecSchema = z.object({
+    project_dir: z
+        .string()
+        .describe("Absolute path to the project root directory."),
+    spec_path: z
+        .string()
+        .optional()
+        .describe("Path to the specification file. Auto-detected from docs/PRD.md, docs/TechSpec.md, " +
+        "docs/spec.md if omitted."),
+    max_adrs: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .optional()
+        .describe("Maximum number of ADR files to generate. Default: 10."),
+});
+// ── Spec discovery ───────────────────────────────────────────────────
+const SPEC_CANDIDATE_PATHS = [
+    "docs/PRD.md",
+    "docs/TechSpec.md",
+    "docs/tech-spec.md",
+    "docs/functional-spec.md",
+    "docs/spec.md",
+    "SPEC.md",
+];
+function resolveSpecPath(projectDir, specPath) {
+    if (specPath) {
+        const full = specPath.startsWith("/") || specPath.match(/^[A-Za-z]:/)
+            ? specPath
+            : join(projectDir, specPath);
+        return existsSync(full) ? full : null;
+    }
+    for (const p of SPEC_CANDIDATE_PATHS) {
+        const full = join(projectDir, p);
+        if (existsSync(full))
+            return full;
+    }
+    return null;
+}
+// ── ADR directory resolution ─────────────────────────────────────────
+function resolveAdrDir(projectDir) {
+    const active = join(projectDir, "docs", "adrs", "active");
+    if (existsSync(active))
+        return active;
+    const legacy = join(projectDir, "docs", "adrs");
+    if (existsSync(legacy))
+        return legacy;
+    const adr = join(projectDir, "docs", "adr");
+    if (existsSync(adr))
+        return adr;
+    return join(projectDir, "docs", "adrs", "active");
+}
+function nextAdrNumber(adrDir) {
+    if (!existsSync(adrDir))
+        return 1;
+    const files = readdirSync(adrDir).filter((f) => /^\d/.test(f) || /^adr/i.test(f));
+    if (files.length === 0)
+        return 1;
+    const nums = files
+        .map((f) => parseInt(f.replace(/\D.*/, ""), 10))
+        .filter((n) => !isNaN(n));
+    return nums.length > 0 ? Math.max(...nums) + 1 : 1;
+}
+function slugExists(adrDir, slug) {
+    if (!existsSync(adrDir))
+        return false;
+    return readdirSync(adrDir).some((f) => f.includes(slug));
+}
+// ── Spec parsing ─────────────────────────────────────────────────────
+/** Extract a section and its content up to the next same-or-higher-level header. */
+function extractSection(content, headerPattern) {
+    const match = content.match(headerPattern);
+    if (!match || match.index === undefined)
+        return null;
+    const start = match.index;
+    const level = (match[1] ?? "#").length; // heading level from the hash count
+    const afterStart = content.slice(start + match[0].length);
+    // Find next header of same or higher level
+    const nextHeader = new RegExp(`^#{1,${level}}\\s`, "m");
+    const end = afterStart.search(nextHeader);
+    return end >= 0
+        ? content.slice(start, start + match[0].length + end).trim()
+        : content.slice(start).trim();
+}
+function parseTechTable(sectionText) {
+    const rows = [];
+    const lines = sectionText.split("\n");
+    for (const line of lines) {
+        if (!line.startsWith("|"))
+            continue;
+        const cells = line
+            .split("|")
+            .map((c) => c.trim())
+            .filter(Boolean);
+        if (cells.length < 2)
+            continue;
+        if (cells[0]?.match(/^[-:]+$/))
+            continue; // separator row
+        if (cells[0]?.toLowerCase() === "layer" ||
+            cells[0]?.toLowerCase() === "component")
+            continue;
+        rows.push({
+            layer: cells[0] ?? "",
+            technology: cells[1] ?? "",
+            notes: cells[2] ?? "",
+        });
+    }
+    return rows;
+}
+const DECISION_PATTERNS = [
+    /(?:we\s+)?(?:chose|selected|adopted|use|using|decided\s+(?:on|to\s+use))\s+([\w/+.-]+(?:\s+[\w/+.-]+)?)\s+(?:because|for|over|instead|as)\s+(.{10,120})/gi,
+    /([\w/+.-]+)\s+(?:over|instead\s+of)\s+([\w/+.-]+)\s+because\s+(.{10,120})/gi,
+];
+function extractExplicitDecisions(content) {
+    const decisions = [];
+    for (const pattern of DECISION_PATTERNS) {
+        pattern.lastIndex = 0;
+        let m;
+        while ((m = pattern.exec(content)) !== null) {
+            decisions.push({
+                sentence: m[0].slice(0, 200).trim(),
+                technology: (m[1] ?? "").trim(),
+                rationale: (m[2] ?? m[3] ?? "").trim(),
+            });
+        }
+    }
+    return decisions.slice(0, 5);
+}
+// ── ADR candidate builder ─────────────────────────────────────────────
+/**
+ * Technology clusters: map technology keywords to ADR categories.
+ * First matching cluster wins.
+ */
+const TECH_CLUSTERS = [
+    {
+        slug: "ai-integration",
+        titleTemplate: (t) => `AI/LLM Integration — ${t.slice(0, 2).join(" + ")}`,
+        keywords: /\b(openai|anthropic|claude|gpt|llm|langchain|hugging\s?face|embedding|vector|pgvector|rag|ai\s*\/?\s*llm)\b/i,
+        category: "AI and LLM integration",
+    },
+    {
+        slug: "auth-strategy",
+        titleTemplate: (t) => `Authentication Strategy — ${t.slice(0, 2).join(" + ")}`,
+        keywords: /\b(jwt|auth|oauth|sso|identity|nextauth|clerk|supabase\s+auth|cognito|auth0|bcrypt|session)\b/i,
+        category: "authentication and authorization",
+    },
+    {
+        slug: "database",
+        titleTemplate: (t) => `Database Selection — ${t.slice(0, 2).join(" + ")}`,
+        keywords: /\b(postgresql|mysql|mongodb|redis|sqlite|supabase|prisma|drizzle|typeorm|sequelize|firebase|dynamo|neon|planetscale)\b/i,
+        category: "database and persistence",
+    },
+    {
+        slug: "deployment",
+        titleTemplate: (t) => `Deployment Strategy — ${t.slice(0, 2).join(" + ")}`,
+        keywords: /\b(railway|vercel|fly\.io|render|heroku|aws|gcp|azure|docker|kubernetes|k8s|cloudflare|lambda)\b/i,
+        category: "deployment and infrastructure",
+    },
+    {
+        slug: "testing-strategy",
+        titleTemplate: (t) => `Testing Strategy — ${t.slice(0, 2).join(" + ")}`,
+        keywords: /\b(vitest|jest|playwright|cypress|testing-library|storybook|mocha|supertest|hurl)\b/i,
+        category: "testing tools and approach",
+    },
+];
+const STACK_KEYWORDS = /\b(next\.?js|nestjs|express|fastify|react|vue|angular|svelte|nuxt|remix|django|flask|fastapi|rails|spring|laravel|node\.?js|typescript|python|go|rust|java|kotlin)\b/i;
+function buildAdrCandidates(tableRows, explicitDecisions, specExcerpt, specRelPath) {
+    const candidates = [];
+    // Group table rows by cluster
+    const clusterBuckets = new Map();
+    const stackRows = [];
+    for (const row of tableRows) {
+        const combined = `${row.layer} ${row.technology} ${row.notes}`;
+        let matched = false;
+        for (const cluster of TECH_CLUSTERS) {
+            if (cluster.keywords.test(combined)) {
+                if (!clusterBuckets.has(cluster.slug))
+                    clusterBuckets.set(cluster.slug, []);
+                clusterBuckets.get(cluster.slug).push(row);
+                matched = true;
+                break;
+            }
+        }
+        if (!matched && STACK_KEYWORDS.test(combined)) {
+            stackRows.push(row);
+        }
+    }
+    // Stack selection ADR (covers frontend + backend layers not captured by specific clusters)
+    const stackEntries = [...stackRows];
+    if (stackEntries.length > 0) {
+        const techs = stackEntries
+            .map((r) => r.technology.split(/[+,]/)[0].trim())
+            .slice(0, 4);
+        const tableMarkdown = stackEntries
+            .map((r) => `| ${r.layer} | ${r.technology} | ${r.notes} |`)
+            .join("\n");
+        candidates.push({
+            slug: "stack-selection",
+            title: `Stack Selection — ${techs.join(" + ")}`,
+            context: [
+                `This decision was identified from the project specification (${specRelPath}).`,
+                `The following technology layers were declared in the spec:`,
+                "",
+                "| Layer | Technology | Notes |",
+                "|-------|-----------|-------|",
+                tableMarkdown,
+            ].join("\n"),
+            decision: `The project uses ${techs.join(", ")} as stated in the specification.`,
+            consequences: [
+                "**Positive:** technology choices are explicit and captured before implementation begins.",
+                "**Risk:** any deviation from these choices requires a superseding ADR.",
+                "**Action:** verify these choices still hold before implementation — update this ADR if the spec was updated after scaffold.",
+            ].join("\n"),
+            specExcerpt,
+        });
+    }
+    // One ADR per detected cluster
+    for (const cluster of TECH_CLUSTERS) {
+        const rows = clusterBuckets.get(cluster.slug) ?? [];
+        if (rows.length === 0)
+            continue;
+        const techs = rows.map((r) => r.technology.split(/[+,]/)[0].trim());
+        const tableMarkdown = rows
+            .map((r) => `| ${r.layer} | ${r.technology} | ${r.notes} |`)
+            .join("\n");
+        candidates.push({
+            slug: cluster.slug,
+            title: cluster.titleTemplate(techs),
+            context: [
+                `This decision concerns ${cluster.category} in this project.`,
+                `Source: ${specRelPath}`,
+                "",
+                "| Layer | Technology | Notes |",
+                "|-------|-----------|-------|",
+                tableMarkdown,
+            ].join("\n"),
+            decision: rows
+                .map((r) => `- **${r.layer}:** ${r.technology}${r.notes ? ` (${r.notes})` : ""}`)
+                .join("\n"),
+            consequences: [
+                `**Positive:** ${cluster.category} is explicitly documented before implementation.`,
+                "**Risk:** changing these choices mid-project requires updating dependent ADRs and tests.",
+                "**Action:** verify these choices against current project state.",
+            ].join("\n"),
+            specExcerpt,
+        });
+    }
+    // One ADR per explicit decision sentence (if not already captured)
+    for (const d of explicitDecisions) {
+        if (candidates.some((c) => c.slug.includes(d.technology.toLowerCase().slice(0, 6))))
+            continue;
+        candidates.push({
+            slug: `decision-${d.technology
+                .toLowerCase()
+                .replace(/[^a-z0-9]/g, "-")
+                .slice(0, 30)}`,
+            title: `Decision — ${d.technology}`,
+            context: `Explicitly stated in the specification (${specRelPath}):\n\n> "${d.sentence}"`,
+            decision: `${d.technology}: ${d.rationale}`,
+            consequences: [
+                "**Positive:** explicit decision recorded before implementation.",
+                "**Action:** verify this decision is still current.",
+            ].join("\n"),
+            specExcerpt: d.sentence,
+        });
+    }
+    return candidates;
+}
+// ── ADR file writer ───────────────────────────────────────────────────
+function buildAdrContent(num, candidate, date) {
+    const numStr = String(num).padStart(4, "0");
+    return [
+        `# ADR-${numStr}: ${candidate.title}`,
+        "",
+        `**Status:** Retroactive`,
+        `**Date:** ${date}`,
+        `**Deciders:** Project team`,
+        `**Source:** Derived from specification`,
+        "",
+        "---",
+        "",
+        "## Context",
+        "",
+        candidate.context,
+        "",
+        "## Decision",
+        "",
+        candidate.decision,
+        "",
+        "## Consequences",
+        "",
+        candidate.consequences,
+        "",
+        "## Spec Excerpt",
+        "",
+        "```",
+        candidate.specExcerpt.slice(0, 400).trim(),
+        "```",
+        "",
+        "> This ADR was retroactively recorded from the project specification.",
+        "> Review and expand with team context before implementation begins.",
+        "",
+    ].join("\n");
+}
+// ── Handler ──────────────────────────────────────────────────────────
+export async function extractAdrsFromSpecHandler(args) {
+    const { project_dir, spec_path, max_adrs = 10 } = args;
+    const specFile = resolveSpecPath(project_dir, spec_path);
+    if (!specFile) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No specification file found. Pass `spec_path` or create one of: " +
+                        SPEC_CANDIDATE_PATHS.join(", "),
+                },
+            ],
+        };
+    }
+    const specContent = readFileSync(specFile, "utf-8");
+    const specRelPath = specFile
+        .replace(project_dir.replace(/\\/g, "/"), "")
+        .replace(/\\/g, "/")
+        .replace(/^\//, "");
+    // Find tech stack section
+    const techSectionPattern = /^(#{1,3})\s+(?:\d+\.\s+)?(?:tech(?:nology)?(?:\s+stack)?|stack|architecture|infrastructure|frameworks?)\s*$/im;
+    const techSection = extractSection(specContent, techSectionPattern) ?? "";
+    const tableRows = parseTechTable(techSection || specContent.slice(0, 3000));
+    const explicitDecisions = extractExplicitDecisions(specContent);
+    // Use first 1000 chars of tech section as the common spec excerpt
+    const specExcerpt = (techSection || specContent).slice(0, 1000).trim();
+    const candidates = buildAdrCandidates(tableRows, explicitDecisions, specExcerpt, specRelPath).slice(0, max_adrs);
+    if (candidates.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No technology decisions detected in ${specRelPath}.\n\n` +
+                        "ForgeCraft looks for: tech stack tables, bullet lists in architecture sections, " +
+                        "and explicit 'chose X because Y' language.\n\n" +
+                        "Consider using `generate_adr` to write ADRs manually from the spec.",
+                },
+            ],
+        };
+    }
+    const adrDir = resolveAdrDir(project_dir);
+    mkdirSync(adrDir, { recursive: true });
+    const date = new Date().toISOString().split("T")[0];
+    const written = [];
+    const skipped = [];
+    let nextNum = nextAdrNumber(adrDir);
+    for (const candidate of candidates) {
+        if (slugExists(adrDir, candidate.slug)) {
+            skipped.push(candidate.slug);
+            continue;
+        }
+        const numStr = String(nextNum).padStart(4, "0");
+        const filename = `${numStr}-${candidate.slug}.md`;
+        const filepath = join(adrDir, filename);
+        writeFileSync(filepath, buildAdrContent(nextNum, candidate, date), "utf-8");
+        written.push(filename);
+        nextNum++;
+    }
+    const adrRelDir = adrDir
+        .replace(project_dir.replace(/\\/g, "/"), "")
+        .replace(/\\/g, "/")
+        .replace(/^\//, "");
+    const lines = [
+        `## ADRs Extracted from Spec`,
+        "",
+        `**Source:** \`${specRelPath}\``,
+        `**Output:** \`${adrRelDir}/\``,
+        "",
+        written.length > 0
+            ? `**Created (${written.length}):**\n${written.map((f) => `- \`${f}\``).join("\n")}`
+            : "**Created:** none",
+        "",
+        skipped.length > 0
+            ? `**Skipped (${skipped.length}, already exist):**\n${skipped.map((s) => `- \`${s}\``).join("\n")}`
+            : "",
+        "",
+        "Each ADR contains the spec excerpt as context and is marked **Retroactive**.",
+        "Review and expand with team rationale before implementation begins.",
+        "",
+        "**Next steps:**",
+        "1. Open each ADR and confirm the decision is still current",
+        "2. Add alternatives considered and rejection rationale",
+        "3. Run `check_cascade` — ADRs now satisfy cascade step 4",
+    ].filter((l) => l !== undefined);
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+    };
+}
+//# sourceMappingURL=extract-adrs-from-spec.js.map

package/dist/tools/extract-adrs-from-spec.js.map

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

package/dist/tools/extract-adrs-history.d.ts

@@ -0,0 +1,47 @@
+/**
+ * extract_adrs_from_history tool handler.
+ *
+ * Scans git log for architectural decision candidates and emits
+ * retroactive ADR stubs into docs/adrs/active/.
+ *
+ * Uses heuristics:
+ *   - Commit message keywords: "switch to", "replace", "adopt", "migrate",
+ *     "chose", "use X instead", "move from", "change from", "refactor to"
+ *   - Large feat/refactor commits (≥ threshold files changed)
+ *   - Merge commit PR titles that describe architectural choices
+ *
+ * Each stub has Status: Retroactive and the commit date/message pre-filled.
+ * Practitioners resolve [NEEDS CLARIFICATION] sections after review.
+ *
+ * Idempotent: skips commits whose slug already exists in docs/adrs/active/.
+ */
+import type { ToolResult } from "../shared/types.js";
+export interface CommitCandidate {
+    readonly hash: string;
+    readonly date: string;
+    readonly subject: string;
+    readonly filesChanged: number;
+    readonly reason: string;
+}
+export interface ExtractAdrsHistoryInput {
+    readonly project_dir: string;
+    /** Max candidates to return (default 10, to avoid flooding). */
+    readonly max_candidates?: number;
+    /** Min files changed to flag a large commit (default 5). */
+    readonly large_commit_threshold?: number;
+    /** Branch or ref to walk (default: HEAD). */
+    readonly ref?: string;
+}
+/**
+ * Run git log and return candidates for architectural decisions.
+ * Non-throwing — returns empty array when not a git repo or git unavailable.
+ */
+export declare function findArchDecisionCandidates(projectDir: string, maxCandidates: number, largeCommitThreshold: number, ref: string): CommitCandidate[];
+/**
+ * Scan git history for architectural decisions and emit retroactive ADR stubs.
+ *
+ * @param args - Input with project_dir and optional config
+ * @returns MCP tool result with written/skipped counts and candidate list
+ */
+export declare function extractAdrsFromHistoryHandler(args: ExtractAdrsHistoryInput): Promise<ToolResult>;
+//# sourceMappingURL=extract-adrs-history.d.ts.map

package/dist/tools/extract-adrs-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-adrs-history.d.ts","sourceRoot":"","sources":["../../src/tools/extract-adrs-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAuCD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,oBAAoB,EAAE,MAAM,EAC5B,GAAG,EAAE,MAAM,GACV,eAAe,EAAE,CAsDnB;AAwFD;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAuHrB"}