preflight-dev 3.1.0

package/dist/profiles.js

@@ -0,0 +1,65 @@
+// =============================================================================
+// Profile system — controls which tools are registered
+// =============================================================================
+// minimal:  No vectors. Pure JSONL parsing + git state. ~5MB install.
+// standard: Local embeddings (Xenova) + LanceDB. Auto-downloads model on
+//           first use. Zero config. ~200MB after model download. DEFAULT.
+// full:     Everything in standard + OpenAI option for higher quality embeddings.
+// =============================================================================
+import { getConfig } from "./lib/config.js";
+const MINIMAL_TOOLS = new Set([
+    "preflight_check",
+    "clarify_intent",
+    "check_session_health",
+    "session_stats",
+    "prompt_score",
+]);
+// Standard IS the default — includes embeddings + timeline.
+// LanceDB is embedded (no server), Xenova downloads model silently on first use.
+const STANDARD_TOOLS = new Set([
+    // Main entry point
+    "preflight_check",
+    // All 14 prompt discipline tools
+    "scope_work",
+    "clarify_intent",
+    "enrich_agent_task",
+    "sharpen_followup",
+    "token_audit",
+    "sequence_tasks",
+    "checkpoint",
+    "check_session_health",
+    "log_correction",
+    "audit_workspace",
+    "session_handoff",
+    "what_changed",
+    "verify_completion",
+    // Lightweight tools
+    "session_stats",
+    "prompt_score",
+    "generate_scorecard",
+    // Timeline tools — local embeddings, zero config
+    "onboard_project",
+    "search_history",
+    "timeline_view",
+    "scan_sessions",
+]);
+// Full = standard + OpenAI embedding option (needs API key)
+// Identical tool set — the difference is config, not features.
+const FULL_TOOLS = new Set([
+    ...STANDARD_TOOLS,
+]);
+export function getProfile() {
+    return getConfig().profile;
+}
+export function isToolEnabled(toolName) {
+    const profile = getProfile();
+    switch (profile) {
+        case "minimal":
+            return MINIMAL_TOOLS.has(toolName);
+        case "standard":
+            return STANDARD_TOOLS.has(toolName);
+        case "full":
+            return FULL_TOOLS.has(toolName);
+    }
+}
+//# sourceMappingURL=profiles.js.map

package/dist/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAChF,sEAAsE;AACtE,yEAAyE;AACzE,0EAA0E;AAC1E,kFAAkF;AAClF,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAgB,MAAM,iBAAiB,CAAC;AAE1D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,iBAAiB;IACjB,gBAAgB;IAChB,sBAAsB;IACtB,eAAe;IACf,cAAc;CACf,CAAC,CAAC;AAEH,4DAA4D;AAC5D,iFAAiF;AACjF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,mBAAmB;IACnB,iBAAiB;IACjB,iCAAiC;IACjC,YAAY;IACZ,gBAAgB;IAChB,mBAAmB;IACnB,kBAAkB;IAClB,aAAa;IACb,gBAAgB;IAChB,YAAY;IACZ,sBAAsB;IACtB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,oBAAoB;IACpB,iDAAiD;IACjD,iBAAiB;IACjB,gBAAgB;IAChB,eAAe;IACf,eAAe;CAChB,CAAC,CAAC;AAEH,4DAA4D;AAC5D,+DAA+D;AAC/D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,GAAG,cAAc;CAClB,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,EAAE,CAAC,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,KAAK,UAAU;YACb,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/tools/audit-workspace.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAuditWorkspace(server: McpServer): void;

package/dist/tools/audit-workspace.js

@@ -0,0 +1,86 @@
+import { run } from "../lib/git.js";
+import { findWorkspaceDocs } from "../lib/files.js";
+/** Extract top-level work areas from file paths generically */
+function detectWorkAreas(files) {
+    const areas = new Set();
+    for (const f of files) {
+        if (!f || f.startsWith("."))
+            continue;
+        // Use first 1-2 path segments as the area
+        const parts = f.split("/");
+        if (parts.length >= 2) {
+            // For test-like directories, just use "tests"
+            if (/^(tests?|__tests__|spec)$/i.test(parts[0])) {
+                areas.add("tests");
+            }
+            else if (parts.length >= 3) {
+                // e.g. app/api/foo → "app/api", src/components/Bar → "src/components"
+                areas.add(`${parts[0]}/${parts[1]}`);
+            }
+            else {
+                areas.add(parts[0]);
+            }
+        }
+        else {
+            // Root-level files: group by extension category
+            if (/\.(json|ya?ml|toml|lock)$/.test(f))
+                areas.add("config");
+            else
+                areas.add("root");
+        }
+    }
+    return areas;
+}
+export function registerAuditWorkspace(server) {
+    server.tool("audit_workspace", `Audit workspace documentation freshness vs actual project state. Compares .claude/ workspace docs against recent git commits to find stale or missing documentation. Call after completing a batch of work or at session end.`, {}, async () => {
+        const docs = findWorkspaceDocs();
+        const recentFiles = run("git diff --name-only HEAD~10 2>/dev/null || echo ''").split("\n").filter(Boolean);
+        const sections = [];
+        // Doc freshness
+        const docStatus = [];
+        const currentTime = Date.now();
+        for (const [name, info] of Object.entries(docs)) {
+            const ageHours = Math.round((currentTime - info.mtime.getTime()) / 3600000);
+            const stale = ageHours > 4;
+            docStatus.push({ name, ageHours, stale, size: info.size });
+        }
+        // Use bullet list format (renders everywhere)
+        sections.push(`## Workspace Doc Freshness\n${docStatus.length > 0
+            ? docStatus.map(d => `- .claude/${d.name} — ${d.ageHours}h old ${d.stale ? "🔴 STALE" : "🟢 Fresh"}`).join("\n")
+            : "No workspace docs found."}`);
+        // Detect work areas generically from git diffs
+        const workAreas = detectWorkAreas(recentFiles);
+        // Check which areas lack docs
+        const docNames = Object.keys(docs).join(" ").toLowerCase();
+        const undocumented = [...workAreas].filter(area => {
+            const areaLower = area.toLowerCase();
+            // Check if any doc name contains the area name (or key parts)
+            const keywords = areaLower.split("/").filter(Boolean);
+            return !keywords.some(kw => docNames.includes(kw));
+        });
+        if (undocumented.length > 0) {
+            sections.push(`## Undocumented Work Areas\nRecent commits touched these areas but no workspace docs cover them:\n${undocumented.map(a => `- ❌ **${a}**`).join("\n")}`);
+        }
+        // Check for gap trackers or similar tracking docs
+        const trackingDocs = Object.entries(docs).filter(([n]) => /gap|track|progress/i.test(n));
+        if (trackingDocs.length > 0) {
+            const testFilesCount = parseInt(run("find tests -name '*.spec.ts' -o -name '*.test.ts' 2>/dev/null | wc -l").trim()) || 0;
+            sections.push(`## Tracking Docs\n${trackingDocs.map(([n]) => {
+                const age = docStatus.find(d => d.name === n)?.ageHours ?? "?";
+                return `- .claude/${n} — last updated ${age}h ago`;
+            }).join("\n")}\nTest files on disk: ${testFilesCount}`);
+        }
+        // Summary
+        const staleCount = docStatus.filter(d => d.stale).length;
+        const recs = [];
+        if (staleCount > 0)
+            recs.push(`⚠️ ${staleCount} docs are stale. Update them before ending this session.`);
+        else
+            recs.push("✅ Workspace docs are fresh.");
+        if (undocumented.length > 0)
+            recs.push(`⚠️ ${undocumented.length} work areas have no docs. Consider creating docs for: ${undocumented.join(", ")}`);
+        sections.push(`## Recommendation\n${recs.join("\n")}`);
+        return { content: [{ type: "text", text: sections.join("\n\n") }] };
+    });
+}
+//# sourceMappingURL=audit-workspace.js.map

package/dist/tools/audit-workspace.js.map

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

package/dist/tools/checkpoint.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCheckpoint(server: McpServer): void;

package/dist/tools/checkpoint.js

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { run, getBranch, getStatus, getLastCommit, getStagedFiles } from "../lib/git.js";
+import { PROJECT_DIR } from "../lib/files.js";
+import { appendLog, now } from "../lib/state.js";
+export function registerCheckpoint(server) {
+    server.tool("checkpoint", `Save a session checkpoint before context compaction hits. Commits current work, writes session state to workspace docs, and creates a resumption note. Call this proactively when session is getting long, or when the session-health hook warns about turn count. This is your "save game" before compaction wipes context.`, {
+        summary: z.string().describe("What was accomplished so far in this session"),
+        next_steps: z.string().describe("What still needs to be done"),
+        current_blockers: z.string().optional().describe("Any issues or blockers encountered"),
+        commit_mode: z.enum(["staged", "tracked", "all"]).optional().describe("What to commit: 'staged' (only staged files), 'tracked' (modified tracked files), 'all' (git add -A). Default: 'tracked'"),
+    }, async ({ summary, next_steps, current_blockers, commit_mode }) => {
+        const mode = commit_mode || "tracked";
+        const branch = getBranch();
+        const dirty = getStatus();
+        const lastCommit = getLastCommit();
+        const timestamp = now();
+        // Write checkpoint file
+        const checkpointDir = join(PROJECT_DIR, ".claude");
+        if (!existsSync(checkpointDir))
+            mkdirSync(checkpointDir, { recursive: true });
+        const checkpointFile = join(checkpointDir, "last-checkpoint.md");
+        const checkpointContent = `# Session Checkpoint
+**Time**: ${timestamp}
+**Branch**: ${branch}
+**Last Commit**: ${lastCommit}
+
+## Accomplished
+${summary}
+
+## Next Steps
+${next_steps}
+
+${current_blockers ? `## Blockers\n${current_blockers}\n` : ""}
+## Uncommitted Work (at checkpoint time)
+\`\`\`
+${dirty || "clean"}
+\`\`\`
+`;
+        writeFileSync(checkpointFile, checkpointContent);
+        appendLog("checkpoint-log.jsonl", {
+            timestamp,
+            branch,
+            summary,
+            next_steps,
+            blockers: current_blockers || null,
+            dirty_files: dirty ? dirty.split("\n").filter(Boolean).length : 0,
+            commit_mode: mode,
+        });
+        // Commit based on mode
+        let commitResult = "no uncommitted changes";
+        if (dirty) {
+            const shortSummary = summary.split("\n")[0].slice(0, 72);
+            const commitMsg = `checkpoint: ${shortSummary}`;
+            let addCmd = "git add -u";
+            switch (mode) {
+                case "staged": {
+                    const staged = getStagedFiles();
+                    if (!staged) {
+                        commitResult = "nothing staged — skipped commit (use 'tracked' or 'all' mode, or stage files first)";
+                    }
+                    addCmd = "true"; // noop, already staged
+                    break;
+                }
+                case "all":
+                    addCmd = "git add -A";
+                    break;
+                case "tracked":
+                default:
+                    addCmd = "git add -u";
+                    break;
+            }
+            if (commitResult === "no uncommitted changes") {
+                // Stage the checkpoint file too
+                run(`git add "${checkpointFile}"`);
+                const result = run(`${addCmd} && git commit -m "${commitMsg.replace(/"/g, '\\"')}" 2>&1`);
+                if (result.includes("commit failed") || result.includes("nothing to commit")) {
+                    // Rollback: unstage if commit failed
+                    run("git reset HEAD 2>/dev/null");
+                    commitResult = `commit failed: ${result}`;
+                }
+                else {
+                    commitResult = result;
+                }
+            }
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: `## Checkpoint Saved ✅
+**File**: .claude/last-checkpoint.md
+**Branch**: ${branch}
+**Commit mode**: ${mode}
+**Commit**: ${commitResult}
+
+### What's saved:
+- Summary of work done
+- Next steps for continuation
+${current_blockers ? "- Current blockers\n" : ""}- Working tree state at checkpoint time
+
+### To resume after compaction:
+Tell the next session/continuation: "Read .claude/last-checkpoint.md for where I left off"`,
+                }],
+        };
+    });
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/tools/checkpoint.js.map

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

package/dist/tools/clarify-intent.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerClarifyIntent(server: McpServer): void;

package/dist/tools/clarify-intent.js

@@ -0,0 +1,180 @@
+import { z } from "zod";
+import { run, getBranch, getStatus, getRecentCommits, getDiffFiles, getStagedFiles } from "../lib/git.js";
+import { findWorkspaceDocs, PROJECT_DIR } from "../lib/files.js";
+import { searchSemantic } from "../lib/timeline-db.js";
+import { getRelatedProjects } from "../lib/config.js";
+import { existsSync, readFileSync } from "fs";
+import { join, basename } from "path";
+/** Parse test failures from common report formats without fragile shell pipelines */
+function getTestFailures() {
+    // Try playwright JSON report
+    const reportPath = join(PROJECT_DIR, "playwright-report", "results.json");
+    if (existsSync(reportPath)) {
+        try {
+            const data = JSON.parse(readFileSync(reportPath, "utf-8"));
+            const failures = [];
+            const walk = (suites) => {
+                for (const suite of suites || []) {
+                    for (const spec of suite.specs || []) {
+                        if (spec.ok === false)
+                            failures.push(spec.title);
+                    }
+                    walk(suite.suites);
+                }
+            };
+            walk(data.suites);
+            return failures.length ? failures.join("\n") : "all passing";
+        }
+        catch {
+            return "report exists but could not parse";
+        }
+    }
+    // Try jest/vitest JSON output
+    for (const p of ["test-results.json", "jest-results.json"]) {
+        const fp = join(PROJECT_DIR, p);
+        if (existsSync(fp)) {
+            try {
+                const data = JSON.parse(readFileSync(fp, "utf-8"));
+                const failed = data.testResults
+                    ?.filter((t) => t.status === "failed")
+                    ?.map((t) => t.name) || [];
+                return failed.length ? failed.join("\n") : "all passing";
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return "no test report found";
+}
+/** Extract intent signals using weighted pattern matching */
+function extractSignals(msg, context) {
+    const signals = [];
+    const lower = msg.toLowerCase();
+    const patterns = [
+        [/\b(fix|repair|broken|failing|error|bug|crash|issue)\b/, "FIX", 2],
+        [/\b(test|spec|suite|playwright|jest|vitest|e2e)\b/, "TESTS", 2],
+        [/\b(commit|push|pr|merge|rebase|cherry.?pick)\b/, "GIT", 2],
+        [/\b(add|create|new|build|implement|feature)\b/, "CREATE", 1],
+        [/\b(remove|delete|clean|strip|drop|deprecate)\b/, "REMOVE", 1],
+        [/\b(check|verify|confirm|status|review|audit)\b/, "VERIFY", 1],
+        [/\b(refactor|rename|move|reorganize|extract)\b/, "REFACTOR", 1],
+        [/\b(deploy|release|ship|publish)\b/, "DEPLOY", 1],
+        [/\b(everything|all|entire|whole)\b/, "⚠️ UNBOUNDED", 3],
+    ];
+    const matched = [];
+    for (const [re, label, weight] of patterns) {
+        if (re.test(lower))
+            matched.push({ label, weight, hint: "" });
+    }
+    // Add contextual hints
+    if (matched.some(m => m.label === "FIX")) {
+        if (context.hasTypeErrors)
+            signals.push("FIX: Type errors detected — likely the target.");
+        if (context.hasTestFailures)
+            signals.push("FIX: Test failures detected — check test output.");
+        if (!context.hasTypeErrors && !context.hasTestFailures)
+            signals.push("FIX: No obvious errors — ask what's broken.");
+    }
+    if (matched.some(m => m.label === "TESTS"))
+        signals.push("TESTS: Check failing tests and test files below.");
+    if (matched.some(m => m.label === "GIT"))
+        signals.push("GIT: Check dirty files and branch state.");
+    if (matched.some(m => m.label === "CREATE"))
+        signals.push("CREATE: Check workspace priorities for planned work.");
+    if (matched.some(m => m.label === "REMOVE"))
+        signals.push("REMOVE: Clarify what 'them/it' refers to before deleting.");
+    if (matched.some(m => m.label === "VERIFY"))
+        signals.push("VERIFY: Use git/test state to answer.");
+    if (matched.some(m => m.label === "REFACTOR"))
+        signals.push("REFACTOR: Identify scope boundaries before starting.");
+    if (matched.some(m => m.label === "DEPLOY"))
+        signals.push("DEPLOY: Verify all checks pass first.");
+    if (matched.some(m => m.label === "⚠️ UNBOUNDED"))
+        signals.push("⚠️ UNBOUNDED: Narrow down using workspace priorities.");
+    if (!signals.length)
+        signals.push("UNCLEAR: Ask ONE clarifying question before proceeding.");
+    return signals;
+}
+/** Search for relevant cross-project context */
+async function searchCrossProjectContext(userMessage) {
+    const relatedProjects = getRelatedProjects();
+    if (relatedProjects.length === 0)
+        return [];
+    // Generate search queries for schemas, types, contracts, APIs
+    const queries = [
+        `${userMessage} type interface schema`,
+        `${userMessage} API endpoint contract`,
+        `${userMessage} enum constant definition`,
+        `${userMessage} class function method`,
+    ];
+    const contextItems = [];
+    for (const query of queries) {
+        try {
+            const results = await searchSemantic(query, {
+                project_dirs: relatedProjects,
+                type: "commit", // Focus on code changes
+                limit: 3,
+            });
+            for (const result of results) {
+                const projectName = basename(result.project);
+                const content = result.content.slice(0, 200);
+                const sourceInfo = result.source_file ? ` at ${result.source_file}` : "";
+                contextItems.push(`**From ${projectName}:** ${content}${sourceInfo}`);
+            }
+        }
+        catch {
+            // Skip if search fails
+        }
+    }
+    return contextItems.slice(0, 5); // Limit to top 5 context items
+}
+export function registerClarifyIntent(server) {
+    server.tool("clarify_intent", `Clarify a vague user instruction by gathering project context. Call BEFORE executing when the user's prompt is missing specific files, actions, scope, or done conditions. Returns git state, test failures, recent changes, and workspace priorities.`, {
+        user_message: z.string().describe("The user's raw message/instruction to clarify"),
+        suspected_area: z.string().optional().describe("Best guess area: 'tests', 'git', 'ui', 'api', 'schema'"),
+    }, async ({ user_message, suspected_area }) => {
+        const sections = [];
+        const branch = getBranch();
+        const status = getStatus();
+        const recentCommits = getRecentCommits(5);
+        const recentFiles = getDiffFiles("HEAD~3");
+        const staged = getStagedFiles();
+        const dirtyCount = status ? status.split("\n").filter(Boolean).length : 0;
+        sections.push(`## Git State\nBranch: ${branch}\nDirty files: ${dirtyCount}\n${status ? `\`\`\`\n${status}\n\`\`\`` : "Working tree clean"}\nStaged: ${staged || "nothing"}\n\nRecent commits:\n\`\`\`\n${recentCommits}\n\`\`\`\n\nRecently changed files:\n\`\`\`\n${recentFiles}\n\`\`\``);
+        // Gather test/type state when relevant
+        const area = (suspected_area || "").toLowerCase();
+        let hasTypeErrors = false;
+        let hasTestFailures = false;
+        if (!area || area.includes("test") || area.includes("fix") || area.includes("ui") || area.includes("api")) {
+            const typeErrors = run("pnpm tsc --noEmit 2>&1 | grep -c 'error TS' || echo '0'");
+            hasTypeErrors = parseInt(typeErrors, 10) > 0;
+            const testFiles = run("find tests -name '*.spec.ts' -maxdepth 4 2>/dev/null | head -20");
+            const failingTests = getTestFailures();
+            hasTestFailures = failingTests !== "all passing" && failingTests !== "no test report found";
+            sections.push(`## Test State\nType errors: ${typeErrors}\nFailing tests: ${failingTests}\nTest files:\n\`\`\`\n${testFiles || "none found"}\n\`\`\``);
+        }
+        // Workspace priorities
+        const workspaceDocs = findWorkspaceDocs();
+        const priorityDocs = Object.entries(workspaceDocs)
+            .filter(([n]) => /gap|roadmap|current|todo|changelog/i.test(n))
+            .slice(0, 3);
+        if (priorityDocs.length > 0) {
+            sections.push(`## Workspace Priorities\n${priorityDocs.map(([n, d]) => `### .claude/${n}\n\`\`\`\n${d.content}\n\`\`\``).join("\n\n")}`);
+        }
+        const signals = extractSignals(user_message, {
+            hasTypeErrors,
+            hasTestFailures,
+            hasDirtyFiles: dirtyCount > 0,
+        });
+        // Search for cross-project context
+        const crossProjectContext = await searchCrossProjectContext(user_message);
+        if (crossProjectContext.length > 0) {
+            sections.push(`## Related Project Context\n${crossProjectContext.map(c => `- ${c}`).join("\n")}`);
+        }
+        sections.push(`## Intent Signals\n${signals.map(s => `- ${s}`).join("\n")}`);
+        sections.push(`## Recommendation\n1. **Proceed with specifics** — state what you'll do and why\n2. **Ask ONE question** — if context doesn't disambiguate`);
+        return { content: [{ type: "text", text: sections.join("\n\n") }] };
+    });
+}
+//# sourceMappingURL=clarify-intent.js.map

package/dist/tools/clarify-intent.js.map

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

package/dist/tools/enrich-agent-task.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerEnrichAgentTask(server: McpServer): void;

package/dist/tools/enrich-agent-task.js

@@ -0,0 +1,97 @@
+import { z } from "zod";
+import { run, getDiffFiles } from "../lib/git.js";
+import { PROJECT_DIR } from "../lib/files.js";
+import { existsSync } from "fs";
+import { join } from "path";
+/** Sanitize user input for safe use in shell commands */
+function shellEscape(s) {
+    return s.replace(/[^a-zA-Z0-9_\-./]/g, "");
+}
+/** Detect package manager from lockfiles */
+function detectPackageManager() {
+    if (existsSync(join(PROJECT_DIR, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(PROJECT_DIR, "yarn.lock")))
+        return "yarn";
+    if (existsSync(join(PROJECT_DIR, "bun.lockb")))
+        return "bun";
+    return "npm";
+}
+/** Find files in a target area using git-tracked files (project-agnostic) */
+function findAreaFiles(area) {
+    if (!area)
+        return getDiffFiles("HEAD~3");
+    const safeArea = shellEscape(area);
+    // If area looks like a path, search directly
+    if (area.includes("/")) {
+        return run(`git ls-files -- '${safeArea}*' 2>/dev/null | head -20`);
+    }
+    // Search for area keyword in git-tracked file paths
+    const files = run(`git ls-files 2>/dev/null | grep -i '${safeArea}' | head -20`);
+    if (files && !files.startsWith("[command failed"))
+        return files;
+    // Fallback to recently changed files
+    return getDiffFiles("HEAD~3");
+}
+/** Find related test files for an area */
+function findRelatedTests(area) {
+    if (!area)
+        return run("git ls-files 2>/dev/null | grep -E '\\.(spec|test)\\.(ts|tsx|js|jsx)$' | head -10");
+    const safeArea = shellEscape(area.split(/\s+/)[0]);
+    const tests = run(`git ls-files 2>/dev/null | grep -E '\\.(spec|test)\\.(ts|tsx|js|jsx)$' | grep -i '${safeArea}' | head -10`);
+    return tests || run("git ls-files 2>/dev/null | grep -E '\\.(spec|test)\\.(ts|tsx|js|jsx)$' | head -10");
+}
+/** Get an example pattern from the first matching file */
+function getExamplePattern(files) {
+    const firstFile = files.split("\n").filter(Boolean)[0];
+    if (!firstFile)
+        return "no pattern available";
+    return run(`head -30 '${shellEscape(firstFile)}' 2>/dev/null || echo 'could not read file'`);
+}
+export function registerEnrichAgentTask(server) {
+    server.tool("enrich_agent_task", `Enrich a vague sub-agent task with project context. Call before spawning a Task/sub-agent to add file paths, patterns, scope boundaries, and done conditions.`, {
+        task_description: z.string().describe("The raw task for the sub-agent"),
+        target_area: z.string().optional().describe("Codebase area: directory path, keyword, or description like 'auth tests', 'api routes'"),
+    }, async ({ task_description, target_area }) => {
+        const area = target_area || "";
+        const pm = detectPackageManager();
+        const fileList = findAreaFiles(area);
+        const testFiles = findRelatedTests(area);
+        const pattern = getExamplePattern(area.includes("test") ? testFiles : fileList);
+        const fileSummary = fileList
+            ? fileList.split("\n").filter(Boolean).slice(0, 5).join(", ")
+            : "Specify exact files";
+        const testSummary = testFiles
+            ? testFiles.split("\n").filter(Boolean).slice(0, 3).join(", ")
+            : "Run relevant tests";
+        return {
+            content: [{
+                    type: "text",
+                    text: `## Files in Target Area
+\`\`\`
+${fileList || "none found — specify a more precise area"}
+\`\`\`
+
+## Related Tests
+\`\`\`
+${testFiles || "none"}
+\`\`\`
+
+## Existing Pattern
+\`\`\`typescript
+${pattern}
+\`\`\`
+
+## Enriched Task
+Original: "${task_description}"
+
+- **Files**: ${fileSummary}
+- **Pattern**: Follow existing pattern above
+- **Tests**: ${testSummary}
+- **Scope**: Do NOT modify files outside target area
+- **Done when**: All relevant tests pass + \`${pm} tsc --noEmit\` clean`,
+                }],
+        };
+    });
+}
+//# sourceMappingURL=enrich-agent-task.js.map

package/dist/tools/enrich-agent-task.js.map

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

package/dist/tools/generate-scorecard.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGenerateScorecard(server: McpServer): void;