preflight-dev 3.1.0 → 3.2.0

package/src/tools/preflight-check.ts

@@ -11,6 +11,7 @@ import { findWorkspaceDocs } from "../lib/files.js";
 import { getConfig } from "../lib/config.js";
 import { searchSemantic } from "../lib/timeline-db.js";
 import { basename, join } from "path";
+import { loadPatterns, matchPatterns, formatPatternMatches } from "../lib/patterns.js";
 
 // ---------------------------------------------------------------------------
 // Helpers
@@ -201,6 +202,16 @@ export function registerPreflightCheck(server: McpServer): void {
       if (force_level === "light") effectiveLevel = "ambiguous";
       if (force_level === "full") effectiveLevel = "multi-step";
 
+      // --- Pattern matching ---
+      const patterns = loadPatterns();
+      const patternMatches = matchPatterns(prompt, patterns);
+
+      // Boost triage level if patterns match
+      if (patternMatches.length > 0 && effectiveLevel === "trivial") {
+        effectiveLevel = "ambiguous";
+        triage.reasons.push(`matches ${patternMatches.length} known correction pattern(s)`);
+      }
+
       // --- Trivial ---
       if (effectiveLevel === "trivial") {
         return { content: [{ type: "text" as const, text: "✅ Preflight: clear to proceed." }] };
@@ -212,6 +223,14 @@ export function registerPreflightCheck(server: McpServer): void {
         `_Reasons: ${triage.reasons.join("; ")}_`,
       ];
 
+      // --- Pattern warnings ---
+      if (patternMatches.length > 0) {
+        sections.push("");
+        for (const p of patternMatches) {
+          sections.push(`⚡ Known pitfall: "${p.pattern}" (you've corrected this ${p.frequency}x before)`);
+        }
+      }
+
       // --- Clear: verify files ---
       if (effectiveLevel === "clear") {
         const filePaths = extractFilePaths(prompt);

package/src/tools/scope-work.ts

@@ -8,6 +8,7 @@ import { getRelatedProjects } from "../lib/config.js";
 import { now } from "../lib/state.js";
 import { existsSync } from "fs";
 import { join, normalize, resolve, basename } from "path";
+import { loadAllContracts, searchContracts, formatContracts } from "../lib/contracts.js";
 
 const STOP_WORDS = new Set([
   "the", "and", "for", "with", "from", "that", "this", "should", "would", "could",
@@ -163,6 +164,11 @@ export function registerScopeWork(server: McpServer): void {
         ? docEntries.map(([name]) => `- \`${name}\``).join("\n")
         : "- (none found)";
 
+      // Check contracts FIRST (fast, no vector search)
+      const contractDirs = [resolve(PROJECT_DIR), ...getRelatedProjects()];
+      const allContracts = loadAllContracts(contractDirs);
+      const matchedContracts = searchContracts(task, allContracts);
+
       // Get cross-project context
       const relatedContext = await searchRelatedProjectContext(task);
 
@@ -197,6 +203,7 @@ ${docLines}
 ${claudeMd ? "- `CLAUDE.md` exists (project instructions)" : ""}
 ${agentsMd ? "- `.claude/AGENTS.md` exists" : ""}
 
+${matchedContracts.length > 0 ? `## 📑 Matching Contracts\n${formatContracts(matchedContracts, 8)}\n` : ""}
 ${relatedContext.length > 0 ? `## 🔗 Related Project Context\n${relatedContext.join("\n")}\n` : ""}
 ---
 

package/src/tools/search-contracts.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { resolve, basename } from "path";
+import { PROJECT_DIR } from "../lib/files.js";
+import { getRelatedProjects } from "../lib/config.js";
+import { loadAllContracts, searchContracts } from "../lib/contracts.js";
+
+export function registerSearchContracts(server: McpServer): void {
+  server.tool(
+    "search_contracts",
+    "Search API contracts, types, and schemas across current and related projects. Fast lookup without vector search.",
+    {
+      query: z.string().describe("What to search for"),
+      scope: z.enum(["current", "related", "all"]).default("all").describe("Which projects to search"),
+      kind: z.enum(["interface", "type", "enum", "route", "schema", "event", "model", "all"]).default("all").describe("Filter by contract kind"),
+    },
+    async ({ query, scope, kind }) => {
+      const projectDirs: string[] = [];
+
+      if (scope === "current" || scope === "all") {
+        projectDirs.push(resolve(PROJECT_DIR));
+      }
+      if (scope === "related" || scope === "all") {
+        projectDirs.push(...getRelatedProjects());
+      }
+
+      if (projectDirs.length === 0) {
+        return { content: [{ type: "text" as const, text: "No projects configured. Run onboard_project first." }] };
+      }
+
+      let contracts = loadAllContracts(projectDirs);
+
+      // Filter by kind
+      if (kind !== "all") {
+        contracts = contracts.filter(c => c.kind === kind);
+      }
+
+      // Search
+      const results = searchContracts(query, contracts);
+
+      if (results.length === 0) {
+        return { content: [{ type: "text" as const, text: `No contracts matching "${query}" found across ${projectDirs.length} project(s).` }] };
+      }
+
+      const output = [
+        `## Contract Search: "${query}"`,
+        `Found ${results.length} matching contract(s):\n`,
+        ...results.slice(0, 20).map(c => {
+          const proj = basename(c.project);
+          return `### ${c.kind} \`${c.name}\` (${proj})\nFile: \`${c.file}\`\n\`\`\`\n${c.definition}\n\`\`\``;
+        }),
+      ];
+
+      if (results.length > 20) {
+        output.push(`\n...and ${results.length - 20} more. Narrow your query or filter by kind.`);
+      }
+
+      return { content: [{ type: "text" as const, text: output.join("\n") }] };
+    }
+  );
+}

package/src/tools/session-stats.ts

@@ -124,6 +124,8 @@ export function registerSessionStats(server: McpServer): void {
         ``,
         `Most active branches:`,
         topBranches || "  (none)",
+        ``,
+        `💰 Run estimate_cost for detailed cost analysis.`,
       ].join("\n");
 
       return {