preflight-dev 3.1.0 → 3.2.0

package/README.md

@@ -4,7 +4,7 @@
 
 **Preflight checks for your AI coding prompts.**
 
-An 18-tool MCP server for Claude Code that catches ambiguous instructions before they cost you 2-3x in wrong→fix cycles — plus semantic search across your entire session history.
+A 24-tool MCP server for Claude Code that catches ambiguous instructions before they cost you 2-3x in wrong→fix cycles — plus semantic search across your entire session history.
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![MCP](https://img.shields.io/badge/MCP-Compatible-blueviolet)](https://modelcontextprotocol.io/)
@@ -29,13 +29,15 @@ The pattern is always the same: vague prompt → Claude guesses → wrong output
 
 ## The Solution
 
-18 tools in 3 categories that run as an MCP server inside Claude Code:
+24 tools in 4 categories that run as an MCP server inside Claude Code:
 
 | Category | What it does |
 |----------|-------------|
+| ✈️ **Preflight Core** (1 tool) | Unified entry point — triages every prompt, chains the right checks automatically |
 | 🎯 **Prompt Discipline** (12 tools) | Catches vague prompts, enforces structure, prevents waste |
 | 🔍 **Timeline Intelligence** (4 tools) | LanceDB vector search across months of session history |
-| ✅ **Verification & Hygiene** (2 tools) | Type-check, test, and audit before declaring done |
+| 📊 **Analysis & Reporting** (4 tools) | Scorecards, cost estimation, session stats, pattern detection |
+| ✅ **Verification & Hygiene** (3 tools) | Type-check, test, audit, and contract search |
 
 ## Before / After
 
@@ -56,20 +58,33 @@ The pattern is always the same: vague prompt → Claude guesses → wrong output
 
 ## Quick Start
 
+### Option A: Claude Code CLI (fastest)
+
+```bash
+claude mcp add preflight -- npx tsx /path/to/preflight/src/index.ts
+```
+
+Or with environment variables:
+
+```bash
+claude mcp add preflight -e CLAUDE_PROJECT_DIR=/path/to/your/project -- npx tsx /path/to/preflight/src/index.ts
+```
+
+### Option B: Clone & configure manually
+
 **1. Clone & install:**
 ```bash
 git clone https://github.com/TerminalGravity/preflight.git
 cd preflight && npm install
 ```
 
-**2. Add to your Claude Code config** (`.claude/settings.json` or project `.mcp.json`):
+**2. Add to your project's `.mcp.json`:**
 ```json
 {
   "mcpServers": {
     "preflight": {
       "command": "npx",
       "args": ["tsx", "/path/to/preflight/src/index.ts"],
-      "cwd": "/path/to/preflight",
       "env": {
         "CLAUDE_PROJECT_DIR": "/path/to/your/project"
       }
@@ -78,23 +93,30 @@ cd preflight && npm install
 }
 ```
 
-**3. Restart Claude Code.** That's it. The tools activate automatically.
+**3. Restart Claude Code.** The tools activate automatically.
 
 ## Tool Reference
 
+### ✈️ Preflight Core
+
+| Tool | What it does |
+|------|-------------|
+| `preflight_check` | **The main entry point.** Triages your prompt (trivial → multi-step), then chains the right checks automatically. One tool to rule them all. |
+
 ### 🎯 Prompt Discipline
 
 | Tool | What it does |
 |------|-------------|
 | `scope_work` | Creates structured execution plans before coding starts |
 | `clarify_intent` | Gathers project context to disambiguate vague prompts |
-| `enrich_agent_task` | Enriches sub-agent tasks with file paths and patterns |
+| `enrich_agent_task` | Enriches sub-agent tasks with file paths, patterns, and cross-service context |
 | `sharpen_followup` | Resolves "fix it" / "do the others" to actual file targets |
 | `token_audit` | Detects waste patterns, grades your session A–F |
 | `sequence_tasks` | Orders tasks by dependency, locality, and risk |
 | `checkpoint` | Save game before compaction — commits + resumption notes |
 | `check_session_health` | Monitors uncommitted files, time since commit, turn count |
 | `log_correction` | Tracks corrections and identifies recurring error patterns |
+| `check_patterns` | Checks prompts against learned correction patterns — warns about known pitfalls |
 | `session_handoff` | Generates handoff briefs for new sessions |
 | `what_changed` | Summarizes diffs since last checkpoint |
 
@@ -102,17 +124,27 @@ cd preflight && npm install
 
 | Tool | What it does |
 |------|-------------|
-| `onboard_project` | Indexes a project's session history into LanceDB vectors |
-| `search_history` | Semantic search across all indexed sessions |
+| `onboard_project` | Indexes a project's session history + contracts into per-project LanceDB |
+| `search_history` | Semantic search with scope: current project, related, or all |
 | `timeline` | Chronological view of events across sessions |
 | `scan_sessions` | Live scanning of active session data |
 
+### 📊 Analysis & Reporting
+
+| Tool | What it does |
+|------|-------------|
+| `generate_scorecard` | 12-category report card — session, trend (week/month), or cross-project comparative. PDF or markdown. |
+| `estimate_cost` | Token usage, dollar cost, waste from corrections, preflight savings |
+| `session_stats` | Lightweight session analysis — no embeddings needed |
+| `prompt_score` | Gamified A–F grading on specificity, scope, actionability, done-condition |
+
 ### ✅ Verification & Hygiene
 
 | Tool | What it does |
 |------|-------------|
 | `verify_completion` | Runs type check + tests + build before declaring done |
 | `audit_workspace` | Finds stale/missing workspace docs vs git activity |
+| `search_contracts` | Search API contracts, types, and schemas across current and related projects |
 
 ## Timeline Intelligence
 
@@ -133,13 +165,13 @@ No data leaves your machine. Embeddings run locally by default (Xenova/transform
 ```
 Claude Code ←→ MCP Protocol ←→ preflight server
                                       │
-                    ┌─────────────────┼─────────────────┐
-                    │                 │                  │
-              Discipline Tools   Timeline Tools    Verification
-              (12 tools)         (4 tools)         (2 tools)
-                                      │
-                                  LanceDB
-                                (local vectors)
+              ┌───────────┬───────────┼───────────┬──────────┐
+              │           │           │           │          │
+         Preflight    Discipline   Timeline   Analysis   Verify
+         Core (1)    Tools (12)   Tools (4)   Tools (4)  (3)
+              │           │           │
+         Smart Triage  Patterns    LanceDB        .preflight/
+         Classification Learning   (per-project)  (project config)
                                       │
                               ~/.claude/projects/
                             (session JSONL files)
@@ -147,6 +179,34 @@ Claude Code ←→ MCP Protocol ←→ preflight server
 
 ## Configuration
 
+### Project Config (`.preflight/`)
+
+Drop a `.preflight/` directory in your project root for team-shared config:
+
+```yaml
+# .preflight/config.yml
+profile: standard
+related_projects:
+  - path: /path/to/auth-service
+    alias: auth-service
+  - path: /path/to/notifications
+    alias: notifications
+thresholds:
+  session_stale_minutes: 30
+  max_tool_calls_before_checkpoint: 100
+```
+
+```yaml
+# .preflight/triage.yml
+rules:
+  always_check: [rewards, permissions, migration]
+  skip: [commit, format, lint]
+  cross_service_keywords: [auth, notification, event]
+strictness: standard
+```
+
+No config? No problem — everything works with zero configuration. Config just lets teams customize.
+
 ### Embedding Providers
 
 | Provider | Setup | Speed | Quality |
@@ -160,6 +220,7 @@ Claude Code ←→ MCP Protocol ←→ preflight server
 |----------|-------------|---------|
 | `CLAUDE_PROJECT_DIR` | Project root to monitor | Required |
 | `OPENAI_API_KEY` | OpenAI key for embeddings | (uses local Xenova) |
+| `PREFLIGHT_RELATED` | Comma-separated related project paths | (none) |
 
 ## Contributing
 

package/dist/cli/init.js

@@ -95,54 +95,6 @@ async function main() {
         env,
     };
     await writeFile(mcpPath, JSON.stringify(config, null, 2) + "\n");
-    // Offer to create .preflight/ config directory
-    const preflightDir = join(process.cwd(), ".preflight");
-    if (!existsSync(preflightDir)) {
-        const createConfig = await ask("\nCreate .preflight/ config directory with template files? [y/N]: ");
-        if (createConfig.trim().toLowerCase() === "y") {
-            await mkdir(preflightDir, { recursive: true });
-            const configYml = `# Preflight configuration
-profile: ${profile}
-
-related_projects: []
-# - path: /path/to/related/project
-#   alias: project-name
-
-thresholds:
-  session_stale_minutes: 30
-  max_tool_calls_before_checkpoint: 100
-  correction_pattern_threshold: 3
-
-embeddings:
-  provider: local
-`;
-            const triageYml = `# Triage rules for prompt classification
-rules:
-  always_check:
-    - rewards
-    - permissions
-    - migration
-    - schema
-  skip:
-    - commit
-    - format
-    - lint
-  cross_service_keywords:
-    - auth
-    - notification
-    - event
-    - webhook
-
-strictness: standard
-`;
-            await writeFile(join(preflightDir, "config.yml"), configYml);
-            await writeFile(join(preflightDir, "triage.yml"), triageYml);
-            console.log("✅ Created .preflight/config.yml and .preflight/triage.yml");
-        }
-    }
-    else {
-        console.log("\n.preflight/ directory already exists — skipping.");
-    }
     console.log(`\n✅ preflight added! (profile: ${profile})`);
     console.log("Restart Claude Code to connect.\n");
     rl.close();

package/dist/cli/init.js.map

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

package/dist/index.js

@@ -27,6 +27,8 @@ import { registerCheckpoint } from "./tools/checkpoint.js";
 import { registerSessionHealth } from "./tools/session-health.js";
 // Category 9: Error Recovery
 import { registerLogCorrection } from "./tools/log-correction.js";
+// Category 9b: Pattern Learning
+import { registerCheckPatterns } from "./tools/check-patterns.js";
 // Category 10: Workspace Hygiene
 import { registerAuditWorkspace } from "./tools/audit-workspace.js";
 // Category 11: Cross-Session Continuity
@@ -43,6 +45,8 @@ import { registerSearchHistory } from "./tools/search-history.js";
 import { registerTimeline } from "./tools/timeline-view.js";
 import { registerScanSessions } from "./tools/scan-sessions.js";
 import { registerGenerateScorecard } from "./tools/generate-scorecard.js";
+import { registerSearchContracts } from "./tools/search-contracts.js";
+import { registerEstimateCost } from "./tools/estimate-cost.js";
 // Validate related projects from config
 function validateRelatedProjects() {
     const config = getConfig();
@@ -81,6 +85,7 @@ const toolRegistry = [
     ["checkpoint", registerCheckpoint],
     ["check_session_health", registerSessionHealth],
     ["log_correction", registerLogCorrection],
+    ["check_patterns", registerCheckPatterns],
     ["audit_workspace", registerAuditWorkspace],
     ["session_handoff", registerSessionHandoff],
     ["what_changed", registerWhatChanged],
@@ -92,6 +97,8 @@ const toolRegistry = [
     ["timeline_view", registerTimeline],
     ["scan_sessions", registerScanSessions],
     ["generate_scorecard", registerGenerateScorecard],
+    ["estimate_cost", registerEstimateCost],
+    ["search_contracts", registerSearchContracts],
 ];
 let registered = 0;
 for (const [name, register] of toolRegistry) {

package/dist/index.js.map

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

package/dist/lib/contracts.d.ts

@@ -0,0 +1,27 @@
+export interface Contract {
+    name: string;
+    kind: "interface" | "type" | "enum" | "route" | "schema" | "event" | "model";
+    file: string;
+    definition: string;
+    project: string;
+    extractedAt: string;
+}
+/** Scan a project directory and extract all contracts */
+export declare function extractContracts(projectDir: string): Contract[];
+/** Load manual contract definitions from .preflight/contracts/ */
+export declare function loadManualContracts(projectDir: string): Contract[];
+/** Load stored contracts for a project */
+export declare function loadContracts(projectHash: string): Contract[];
+/** Save contracts to storage */
+export declare function saveContracts(projectHash: string, contracts: Contract[]): void;
+/** Search contracts by query string (simple relevance scoring) */
+export declare function searchContracts(query: string, contracts: Contract[]): Contract[];
+/** Extract and save contracts for a project, merging with manual definitions */
+export declare function extractAndSaveContracts(projectDir: string): {
+    count: number;
+    hash: string;
+};
+/** Load all contracts for a list of project directories */
+export declare function loadAllContracts(projectDirs: string[]): Contract[];
+/** Format contracts for display in tool output */
+export declare function formatContracts(contracts: Contract[], limit?: number): string;

package/dist/lib/contracts.js

@@ -0,0 +1,309 @@
+// =============================================================================
+// Cross-Service Contract Registry
+// =============================================================================
+// Extracts, stores, and searches API contracts, types, and schemas
+// across projects for fast cross-service context lookups.
+// =============================================================================
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSync } from "fs";
+import { join, resolve, relative, basename, extname } from "path";
+import { createHash } from "crypto";
+import { homedir } from "os";
+import { load as yamlLoad } from "js-yaml";
+// --- Helpers ---
+const PREFLIGHT_DIR = join(homedir(), ".preflight");
+const PROJECTS_DIR = join(PREFLIGHT_DIR, "projects");
+function hashProjectDir(projectDir) {
+    return createHash("sha256").update(resolve(projectDir)).digest("hex").slice(0, 12);
+}
+function contractsPath(projectHash) {
+    return join(PROJECTS_DIR, projectHash, "contracts.json");
+}
+// --- File Discovery ---
+/** Recursively find files matching patterns, skipping node_modules/.git/dist */
+function findFiles(dir, patterns, maxDepth = 8, depth = 0) {
+    if (depth > maxDepth)
+        return [];
+    const results = [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (entry === "node_modules" || entry === ".git" || entry === "dist" || entry === ".next" || entry === "build")
+            continue;
+        const full = join(dir, entry);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory()) {
+            results.push(...findFiles(full, patterns, maxDepth, depth + 1));
+        }
+        else if (patterns.some(p => p.test(full))) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+// --- Extraction ---
+const TS_CONTRACT_PATTERNS = [
+    // types.ts, types/*.ts, interfaces.ts, *.d.ts
+    /\/types\.ts$/, /\/types\/[^/]+\.ts$/, /\/interfaces\.ts$/, /\.d\.ts$/,
+    // API routes
+    /\/api\/.*\.ts$/, /\/routes\/.*\.ts$/,
+    // Event schemas
+    /\/events\/.*\.ts$/, /\/schemas\/.*\.ts$/,
+];
+const PRISMA_PATTERN = /prisma\/schema\.prisma$/;
+const OPENAPI_PATTERN = /\/(openapi\.ya?ml|swagger\.json)$/;
+/** Extract TypeScript interfaces, types, and enums from source */
+function extractTsContracts(content, filePath, projectDir) {
+    const contracts = [];
+    const relPath = relative(projectDir, filePath);
+    const now = new Date().toISOString();
+    // Match: export interface Foo { ... }
+    const interfaceRe = /export\s+interface\s+(\w+)(?:\s+extends\s+[^{]+)?\s*\{[^}]*(?:\{[^}]*\}[^}]*)*\}/g;
+    for (const m of content.matchAll(interfaceRe)) {
+        contracts.push({ name: m[1], kind: "interface", file: relPath, definition: m[0].slice(0, 500), project: projectDir, extractedAt: now });
+    }
+    // Match: export type Foo = ...
+    const typeRe = /export\s+type\s+(\w+)\s*(?:<[^>]*>)?\s*=[^;]+;/g;
+    for (const m of content.matchAll(typeRe)) {
+        contracts.push({ name: m[1], kind: "type", file: relPath, definition: m[0].slice(0, 500), project: projectDir, extractedAt: now });
+    }
+    // Match: export enum Foo { ... }
+    const enumRe = /export\s+enum\s+(\w+)\s*\{[^}]*\}/g;
+    for (const m of content.matchAll(enumRe)) {
+        contracts.push({ name: m[1], kind: "enum", file: relPath, definition: m[0].slice(0, 500), project: projectDir, extractedAt: now });
+    }
+    // Detect route definitions (Next.js/Express patterns)
+    const isRouteFile = /\/(api|routes)\//.test(filePath);
+    if (isRouteFile) {
+        // export async function GET/POST/PUT/DELETE/PATCH
+        const routeRe = /export\s+(?:async\s+)?function\s+(GET|POST|PUT|DELETE|PATCH|handler)\b[^{]*\{/g;
+        for (const m of content.matchAll(routeRe)) {
+            const routeName = `${m[1]} ${relPath.replace(/\.(ts|js)$/, "")}`;
+            const defStart = m.index;
+            contracts.push({ name: routeName, kind: "route", file: relPath, definition: content.slice(defStart, defStart + 500), project: projectDir, extractedAt: now });
+        }
+        // router.get/post/put/delete
+        const expressRe = /router\.(get|post|put|delete|patch)\s*\(\s*['"`]([^'"`]+)['"`]/g;
+        for (const m of content.matchAll(expressRe)) {
+            contracts.push({ name: `${m[1].toUpperCase()} ${m[2]}`, kind: "route", file: relPath, definition: m[0].slice(0, 500), project: projectDir, extractedAt: now });
+        }
+    }
+    return contracts;
+}
+/** Extract Prisma models */
+function extractPrismaContracts(content, filePath, projectDir) {
+    const contracts = [];
+    const relPath = relative(projectDir, filePath);
+    const now = new Date().toISOString();
+    const modelRe = /model\s+(\w+)\s*\{[^}]*\}/g;
+    for (const m of content.matchAll(modelRe)) {
+        contracts.push({ name: m[1], kind: "model", file: relPath, definition: m[0].slice(0, 500), project: projectDir, extractedAt: now });
+    }
+    const enumRe = /enum\s+(\w+)\s*\{[^}]*\}/g;
+    for (const m of content.matchAll(enumRe)) {
+        contracts.push({ name: m[1], kind: "enum", file: relPath, definition: m[0].slice(0, 500), project: projectDir, extractedAt: now });
+    }
+    return contracts;
+}
+/** Extract from OpenAPI/Swagger specs */
+function extractOpenApiContracts(content, filePath, projectDir) {
+    const contracts = [];
+    const relPath = relative(projectDir, filePath);
+    const now = new Date().toISOString();
+    try {
+        const spec = filePath.endsWith(".json") ? JSON.parse(content) : yamlLoad(content);
+        if (spec?.paths) {
+            for (const [path, methods] of Object.entries(spec.paths)) {
+                for (const method of Object.keys(methods)) {
+                    if (["get", "post", "put", "delete", "patch"].includes(method)) {
+                        const op = methods[method];
+                        const name = `${method.toUpperCase()} ${path}`;
+                        const def = JSON.stringify({ summary: op.summary, parameters: op.parameters, requestBody: op.requestBody }, null, 2);
+                        contracts.push({ name, kind: "route", file: relPath, definition: def.slice(0, 500), project: projectDir, extractedAt: now });
+                    }
+                }
+            }
+        }
+        if (spec?.components?.schemas) {
+            for (const [name, schema] of Object.entries(spec.components.schemas)) {
+                contracts.push({ name, kind: "schema", file: relPath, definition: JSON.stringify(schema, null, 2).slice(0, 500), project: projectDir, extractedAt: now });
+            }
+        }
+    }
+    catch {
+        // Invalid spec, skip
+    }
+    return contracts;
+}
+// --- Public API ---
+/** Scan a project directory and extract all contracts */
+export function extractContracts(projectDir) {
+    const absDir = resolve(projectDir);
+    const contracts = [];
+    // TypeScript files
+    const tsFiles = findFiles(absDir, TS_CONTRACT_PATTERNS);
+    for (const file of tsFiles) {
+        try {
+            const content = readFileSync(file, "utf-8");
+            contracts.push(...extractTsContracts(content, file, absDir));
+        }
+        catch { /* skip unreadable */ }
+    }
+    // Prisma
+    const prismaFiles = findFiles(absDir, [PRISMA_PATTERN], 3);
+    for (const file of prismaFiles) {
+        try {
+            const content = readFileSync(file, "utf-8");
+            contracts.push(...extractPrismaContracts(content, file, absDir));
+        }
+        catch { /* skip */ }
+    }
+    // OpenAPI
+    const openApiFiles = findFiles(absDir, [OPENAPI_PATTERN], 5);
+    for (const file of openApiFiles) {
+        try {
+            const content = readFileSync(file, "utf-8");
+            contracts.push(...extractOpenApiContracts(content, file, absDir));
+        }
+        catch { /* skip */ }
+    }
+    return contracts;
+}
+/** Load manual contract definitions from .preflight/contracts/ */
+export function loadManualContracts(projectDir) {
+    const contractsDir = join(projectDir, ".preflight", "contracts");
+    if (!existsSync(contractsDir))
+        return [];
+    const contracts = [];
+    const now = new Date().toISOString();
+    let entries;
+    try {
+        entries = readdirSync(contractsDir);
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (![".yml", ".yaml"].includes(extname(entry)))
+            continue;
+        const filePath = join(contractsDir, entry);
+        try {
+            const content = readFileSync(filePath, "utf-8");
+            const items = yamlLoad(content);
+            if (!Array.isArray(items))
+                continue;
+            for (const item of items) {
+                if (!item.name || !item.kind)
+                    continue;
+                const def = item.fields
+                    ? `${item.description || ""}\nFields: ${item.fields.map(f => `${f.name}: ${f.type}${f.required ? " (required)" : ""}`).join(", ")}`
+                    : item.description || "";
+                contracts.push({
+                    name: item.name,
+                    kind: item.kind,
+                    file: `.preflight/contracts/${entry}`,
+                    definition: def.trim().slice(0, 500),
+                    project: resolve(projectDir),
+                    extractedAt: now,
+                });
+            }
+        }
+        catch { /* skip invalid */ }
+    }
+    return contracts;
+}
+/** Load stored contracts for a project */
+export function loadContracts(projectHash) {
+    const p = contractsPath(projectHash);
+    if (!existsSync(p))
+        return [];
+    try {
+        return JSON.parse(readFileSync(p, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+/** Save contracts to storage */
+export function saveContracts(projectHash, contracts) {
+    const dir = join(PROJECTS_DIR, projectHash);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(contractsPath(projectHash), JSON.stringify(contracts, null, 2));
+}
+/** Search contracts by query string (simple relevance scoring) */
+export function searchContracts(query, contracts) {
+    const terms = query.toLowerCase().split(/\s+/).filter(t => t.length > 1);
+    if (terms.length === 0)
+        return contracts;
+    const scored = contracts.map(c => {
+        const nameL = c.name.toLowerCase();
+        const defL = c.definition.toLowerCase();
+        const fileL = c.file.toLowerCase();
+        let score = 0;
+        for (const term of terms) {
+            // Exact name match is highest
+            if (nameL === term)
+                score += 10;
+            // Name contains term
+            else if (nameL.includes(term))
+                score += 5;
+            // File contains term
+            if (fileL.includes(term))
+                score += 2;
+            // Definition contains term
+            if (defL.includes(term))
+                score += 1;
+        }
+        return { contract: c, score };
+    });
+    return scored
+        .filter(s => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .map(s => s.contract);
+}
+/** Extract and save contracts for a project, merging with manual definitions */
+export function extractAndSaveContracts(projectDir) {
+    const absDir = resolve(projectDir);
+    const hash = hashProjectDir(absDir);
+    const autoContracts = extractContracts(absDir);
+    const manualContracts = loadManualContracts(absDir);
+    // Manual contracts take precedence (same name = manual wins)
+    const manualNames = new Set(manualContracts.map(c => c.name));
+    const merged = [
+        ...manualContracts,
+        ...autoContracts.filter(c => !manualNames.has(c.name)),
+    ];
+    saveContracts(hash, merged);
+    return { count: merged.length, hash };
+}
+/** Load all contracts for a list of project directories */
+export function loadAllContracts(projectDirs) {
+    const all = [];
+    for (const dir of projectDirs) {
+        const hash = hashProjectDir(resolve(dir));
+        all.push(...loadContracts(hash));
+    }
+    return all;
+}
+/** Format contracts for display in tool output */
+export function formatContracts(contracts, limit = 10) {
+    if (contracts.length === 0)
+        return "";
+    const lines = contracts.slice(0, limit).map(c => {
+        const proj = basename(c.project);
+        const defPreview = c.definition.split("\n")[0].slice(0, 120);
+        return `From ${proj}: ${c.kind} ${c.name} — ${defPreview} (${c.file})`;
+    });
+    return lines.join("\n");
+}
+//# sourceMappingURL=contracts.js.map