briefed 0.1.0

package/dist/extract/staleness.js

@@ -0,0 +1,108 @@
+import { existsSync, readFileSync, statSync } from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+/**
+ * Check if the briefed context is stale (source files changed since last index).
+ */
+export function checkStaleness(root) {
+    const report = {
+        isStale: false,
+        lastIndexed: null,
+        changedFiles: 0,
+        totalFiles: 0,
+        stalePct: 0,
+        details: [],
+    };
+    const indexPath = join(root, ".briefed", "index.json");
+    if (!existsSync(indexPath)) {
+        report.isStale = true;
+        report.details.push("No index found — run briefed init");
+        return report;
+    }
+    // Get last indexed time
+    const indexStat = statSync(indexPath);
+    report.lastIndexed = indexStat.mtime;
+    // Use git to find files changed since last index
+    try {
+        const sinceDate = indexStat.mtime.toISOString();
+        const changedOutput = execSync(`git diff --name-only --diff-filter=ACMR HEAD -- "*.ts" "*.tsx" "*.js" "*.jsx" "*.py" "*.go" "*.rs" "*.java"`, { cwd: root, encoding: "utf-8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"] }).trim();
+        // Also check for uncommitted changes
+        const uncommitted = execSync(`git status --porcelain -- "*.ts" "*.tsx" "*.js" "*.jsx" "*.py" "*.go" "*.rs" "*.java"`, { cwd: root, encoding: "utf-8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"] }).trim();
+        const changed = new Set();
+        if (changedOutput) {
+            for (const f of changedOutput.split("\n"))
+                changed.add(f.trim());
+        }
+        if (uncommitted) {
+            for (const line of uncommitted.split("\n")) {
+                const file = line.trim().slice(3); // strip status chars
+                if (file)
+                    changed.add(file);
+            }
+        }
+        // Check which changed files are newer than the index
+        let staleCount = 0;
+        for (const file of changed) {
+            const fullPath = join(root, file);
+            if (existsSync(fullPath)) {
+                const fileStat = statSync(fullPath);
+                if (fileStat.mtime > indexStat.mtime) {
+                    staleCount++;
+                    if (staleCount <= 5) {
+                        report.details.push(`  changed: ${file}`);
+                    }
+                }
+            }
+        }
+        if (staleCount > 5) {
+            report.details.push(`  ... and ${staleCount - 5} more`);
+        }
+        report.changedFiles = staleCount;
+        // Load index to get total file count
+        try {
+            const index = JSON.parse(readFileSync(indexPath, "utf-8"));
+            report.totalFiles = index.modules?.reduce((sum, m) => sum + (m.files?.length || 0), 0) || 0;
+        }
+        catch { /* skip */ }
+        report.stalePct = report.totalFiles > 0
+            ? Math.round((staleCount / report.totalFiles) * 100)
+            : 0;
+        // Consider stale if >10% of files changed or >5 files changed
+        report.isStale = staleCount > 5 || report.stalePct > 10;
+    }
+    catch {
+        // Not a git repo or git not available — check file timestamps
+        report.details.push("No git available — using timestamp comparison");
+        report.isStale = true;
+    }
+    return report;
+}
+/**
+ * Format staleness report for display.
+ */
+export function formatStaleness(report) {
+    if (!report.isStale) {
+        const age = report.lastIndexed
+            ? timeSince(report.lastIndexed)
+            : "unknown";
+        return `  Context is fresh (indexed ${age} ago)`;
+    }
+    const lines = [];
+    lines.push(`  Context is STALE — ${report.changedFiles} files changed since last index`);
+    for (const d of report.details) {
+        lines.push(d);
+    }
+    lines.push(`  Run: npx briefed init`);
+    return lines.join("\n");
+}
+function timeSince(date) {
+    const secs = Math.floor((Date.now() - date.getTime()) / 1000);
+    if (secs < 60)
+        return `${secs}s`;
+    if (secs < 3600)
+        return `${Math.floor(secs / 60)}m`;
+    if (secs < 86400)
+        return `${Math.floor(secs / 3600)}h`;
+    return `${Math.floor(secs / 86400)}d`;
+}
+//# sourceMappingURL=staleness.js.map

package/dist/extract/staleness.js.map

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

package/dist/extract/tests.d.ts

@@ -0,0 +1,16 @@
+export interface TestMapping {
+    sourceFile: string;
+    testFile: string;
+    testNames: string[];
+    testCount: number;
+}
+/**
+ * Find test files that correspond to source files.
+ * Uses naming conventions: foo.test.ts, foo.spec.ts, test_foo.py, etc.
+ * This is the #1 research-backed improvement: +45.97% pass@1 (TiCoder, IEEE TSE).
+ */
+export declare function findTestMappings(sourceFiles: string[], root: string): TestMapping[];
+/**
+ * Format test mappings for inclusion in the skeleton or contracts.
+ */
+export declare function formatTestContext(mapping: TestMapping): string;

package/dist/extract/tests.js

@@ -0,0 +1,175 @@
+import { readFileSync } from "fs";
+import { join, dirname, basename, extname } from "path";
+import { glob } from "glob";
+/**
+ * Find test files that correspond to source files.
+ * Uses naming conventions: foo.test.ts, foo.spec.ts, test_foo.py, etc.
+ * This is the #1 research-backed improvement: +45.97% pass@1 (TiCoder, IEEE TSE).
+ */
+export function findTestMappings(sourceFiles, root) {
+    const mappings = [];
+    // Build a map of all test files for fast lookup
+    const testFileSet = new Set();
+    const allFiles = sourceFiles;
+    for (const f of allFiles) {
+        if (isTestFile(f))
+            testFileSet.add(f);
+    }
+    // Also scan for test files not in the source list (test/ directories)
+    try {
+        const testGlobs = [
+            "test/**/*.{ts,tsx,js,jsx,py,go,rs}",
+            "tests/**/*.{ts,tsx,js,jsx,py,go,rs}",
+            "**/*.test.{ts,tsx,js,jsx}",
+            "**/*.spec.{ts,tsx,js,jsx}",
+            "**/test_*.py",
+            "**/*_test.go",
+            "**/*_test.rs",
+        ];
+        for (const pattern of testGlobs) {
+            const found = glob.sync(pattern, {
+                cwd: root,
+                ignore: ["node_modules/**", ".git/**", "dist/**", "build/**"],
+            });
+            for (const f of found)
+                testFileSet.add(f.replace(/\\/g, "/"));
+        }
+    }
+    catch {
+        // glob errors are non-fatal
+    }
+    // Match source files to test files
+    for (const sourceFile of sourceFiles) {
+        if (isTestFile(sourceFile))
+            continue;
+        const matched = findMatchingTest(sourceFile, testFileSet);
+        if (matched) {
+            const testPath = join(root, matched);
+            let testNames = [];
+            let testCount = 0;
+            try {
+                const content = readFileSync(testPath, "utf-8");
+                const extracted = extractTestNames(content, extname(matched));
+                testNames = extracted.names;
+                testCount = extracted.count;
+            }
+            catch {
+                // Can't read test file — still map it
+            }
+            mappings.push({
+                sourceFile,
+                testFile: matched,
+                testNames,
+                testCount,
+            });
+        }
+    }
+    return mappings;
+}
+/**
+ * Check if a file path looks like a test file.
+ */
+function isTestFile(filePath) {
+    const name = basename(filePath);
+    return (name.includes(".test.") ||
+        name.includes(".spec.") ||
+        name.includes("_test.") ||
+        name.startsWith("test_") ||
+        filePath.includes("/test/") ||
+        filePath.includes("/tests/") ||
+        filePath.includes("/__tests__/"));
+}
+/**
+ * Find the test file that matches a given source file.
+ */
+function findMatchingTest(sourceFile, testFiles) {
+    const dir = dirname(sourceFile);
+    const ext = extname(sourceFile);
+    const name = basename(sourceFile, ext);
+    // Try common test file naming patterns
+    const candidates = [
+        // Colocated: foo.test.ts next to foo.ts
+        `${dir}/${name}.test${ext}`,
+        `${dir}/${name}.spec${ext}`,
+        // __tests__ directory
+        `${dir}/__tests__/${name}.test${ext}`,
+        `${dir}/__tests__/${name}${ext}`,
+        // test/ directory at same level
+        `${dir.replace(/\/src\//, "/test/")}/${name}.test${ext}`,
+        `${dir.replace(/\/src\//, "/test/")}/${name}${ext}`,
+        `${dir.replace(/\/src\//, "/tests/")}/${name}.test${ext}`,
+        // test/ at root
+        `test/${name}.test${ext}`,
+        `test/${name}${ext}`,
+        `tests/${name}.test${ext}`,
+        // Python conventions
+        `${dir}/test_${name}${ext}`,
+        `test/test_${name}${ext}`,
+        `tests/test_${name}${ext}`,
+        // Go conventions
+        `${dir}/${name}_test${ext}`,
+        // Rust conventions
+        `tests/${name}${ext}`,
+    ];
+    for (const candidate of candidates) {
+        const normalized = candidate.replace(/\\/g, "/");
+        if (testFiles.has(normalized))
+            return normalized;
+    }
+    // Fuzzy match: look for any test file containing the source name
+    for (const testFile of testFiles) {
+        const testName = basename(testFile, extname(testFile))
+            .replace(/\.test$|\.spec$|^test_|_test$/, "");
+        if (testName === name)
+            return testFile;
+    }
+    return null;
+}
+/**
+ * Extract test names (describe/it/test blocks) from a test file.
+ */
+function extractTestNames(content, ext) {
+    const names = [];
+    if ([".ts", ".tsx", ".js", ".jsx", ".mjs"].includes(ext)) {
+        // JS/TS: describe("name"), it("name"), test("name")
+        const regex = /(?:describe|it|test)\s*\(\s*['"`]([^'"`]+)['"`]/g;
+        for (const match of content.matchAll(regex)) {
+            names.push(match[1]);
+        }
+    }
+    else if (ext === ".py") {
+        // Python: def test_name, class TestName
+        const fnRegex = /def\s+(test_\w+)/g;
+        const classRegex = /class\s+(Test\w+)/g;
+        for (const match of content.matchAll(fnRegex))
+            names.push(match[1]);
+        for (const match of content.matchAll(classRegex))
+            names.push(match[1]);
+    }
+    else if (ext === ".go") {
+        // Go: func TestName(t *testing.T)
+        const regex = /func\s+(Test\w+)\s*\(/g;
+        for (const match of content.matchAll(regex))
+            names.push(match[1]);
+    }
+    else if (ext === ".rs") {
+        // Rust: #[test] fn test_name()
+        const regex = /fn\s+(test_\w+)\s*\(/g;
+        for (const match of content.matchAll(regex))
+            names.push(match[1]);
+    }
+    return { names, count: names.length };
+}
+/**
+ * Format test mappings for inclusion in the skeleton or contracts.
+ */
+export function formatTestContext(mapping) {
+    const lines = [];
+    lines.push(`tests: ${mapping.testFile} (${mapping.testCount} tests)`);
+    if (mapping.testNames.length > 0) {
+        const preview = mapping.testNames.slice(0, 8);
+        lines.push(`  covers: ${preview.join(", ")}${mapping.testNames.length > 8 ? ` +${mapping.testNames.length - 8} more` : ""}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=tests.js.map

package/dist/extract/tests.js.map

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

package/dist/extract/usage-examples.d.ts

@@ -0,0 +1,17 @@
+import type { FileExtraction } from "./signatures.js";
+export interface UsageExample {
+    symbol: string;
+    file: string;
+    line: number;
+    snippet: string;
+}
+/**
+ * Find how functions/classes are actually USED in the codebase.
+ * Research shows API usage examples improve LLM output by 3x vs descriptions alone.
+ * Instead of telling Claude what a function does, show it how the project calls it.
+ */
+export declare function findUsageExamples(extractions: FileExtraction[], maxExamplesPerSymbol?: number): Map<string, UsageExample[]>;
+/**
+ * Format usage examples for context injection.
+ */
+export declare function formatUsageExamples(examples: Map<string, UsageExample[]>, maxTotal?: number): string;

package/dist/extract/usage-examples.js

@@ -0,0 +1,115 @@
+import { readFileSync } from "fs";
+import { basename } from "path";
+/**
+ * Find how functions/classes are actually USED in the codebase.
+ * Research shows API usage examples improve LLM output by 3x vs descriptions alone.
+ * Instead of telling Claude what a function does, show it how the project calls it.
+ */
+export function findUsageExamples(extractions, maxExamplesPerSymbol = 3) {
+    const examples = new Map();
+    // Build a set of all exported symbol names worth tracking
+    const exportedSymbols = new Map(); // name → defining file
+    for (const ext of extractions) {
+        for (const sym of ext.symbols) {
+            if (sym.exported && (sym.kind === "function" || sym.kind === "class" || sym.kind === "method")) {
+                const shortName = sym.name.split(".").pop();
+                if (shortName.length > 2 && !isCommonName(shortName)) {
+                    exportedSymbols.set(shortName, ext.path);
+                }
+            }
+        }
+    }
+    if (exportedSymbols.size === 0)
+        return examples;
+    // Scan files for usages of these symbols
+    for (const ext of extractions) {
+        // Only look in files that import something
+        if (ext.imports.length === 0)
+            continue;
+        let content;
+        try {
+            content = readFileSync(ext.path, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split("\n");
+        // What does this file import?
+        const importedNames = new Set();
+        for (const imp of ext.imports) {
+            for (const name of imp.names) {
+                importedNames.add(name);
+            }
+        }
+        // Find lines where imported symbols are called/used
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // Skip imports, comments, empty lines
+            if (!line || line.startsWith("import ") || line.startsWith("//") ||
+                line.startsWith("/*") || line.startsWith("*") || line.startsWith("from ") ||
+                line.startsWith("require("))
+                continue;
+            for (const symName of importedNames) {
+                if (!exportedSymbols.has(symName))
+                    continue;
+                // Check if this line calls/uses the symbol
+                // Match: symName( or new SymName( or symName. or await symName(
+                const callPattern = new RegExp(`\\b${escapeRegex(symName)}\\s*[.(]`);
+                if (callPattern.test(line)) {
+                    if (!examples.has(symName))
+                        examples.set(symName, []);
+                    const existing = examples.get(symName);
+                    if (existing.length < maxExamplesPerSymbol) {
+                        // Don't duplicate from same file
+                        if (!existing.some((e) => e.file === ext.path)) {
+                            existing.push({
+                                symbol: symName,
+                                file: ext.path,
+                                line: i + 1,
+                                snippet: line.slice(0, 120), // truncate long lines
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return examples;
+}
+/**
+ * Format usage examples for context injection.
+ */
+export function formatUsageExamples(examples, maxTotal = 20) {
+    if (examples.size === 0)
+        return "";
+    const lines = [];
+    let count = 0;
+    // Sort by number of usages (most-used first)
+    const sorted = [...examples.entries()]
+        .sort((a, b) => b[1].length - a[1].length);
+    for (const [symbol, usages] of sorted) {
+        if (count >= maxTotal)
+            break;
+        for (const usage of usages) {
+            if (count >= maxTotal)
+                break;
+            lines.push(`  ${symbol}: ${usage.snippet} (${basename(usage.file)}:${usage.line})`);
+            count++;
+        }
+    }
+    if (lines.length === 0)
+        return "";
+    return "Usage examples:\n" + lines.join("\n");
+}
+function isCommonName(name) {
+    const common = new Set([
+        "get", "set", "map", "filter", "reduce", "find", "push", "pop",
+        "log", "error", "warn", "info", "debug", "toString", "valueOf",
+        "then", "catch", "finally", "resolve", "reject", "use", "run",
+    ]);
+    return common.has(name);
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=usage-examples.js.map

package/dist/extract/usage-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-examples.js","sourceRoot":"","sources":["../../src/extract/usage-examples.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAW,MAAM,MAAM,CAAC;AAUzC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAA6B,EAC7B,uBAA+B,CAAC;IAEhC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEnD,0DAA0D;IAC1D,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,uBAAuB;IAC1E,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC/F,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;gBAC7C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;oBACrD,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,eAAe,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEhD,yCAAyC;IACzC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,2CAA2C;QAC3C,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEvC,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,8BAA8B;QAC9B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC7B,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE7B,sCAAsC;YACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC5D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBACzE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,SAAS;YAE1C,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;gBACpC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,SAAS;gBAE5C,2CAA2C;gBAC3C,gEAAgE;gBAChE,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACrE,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;wBAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBACtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;oBAExC,IAAI,QAAQ,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;wBAC3C,iCAAiC;wBACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;4BAC/C,QAAQ,CAAC,IAAI,CAAC;gCACZ,MAAM,EAAE,OAAO;gCACf,IAAI,EAAE,GAAG,CAAC,IAAI;gCACd,IAAI,EAAE,CAAC,GAAG,CAAC;gCACX,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,sBAAsB;6BACpD,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAqC,EACrC,WAAmB,EAAE;IAErB,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,6CAA6C;IAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;SACnC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAE7C,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACtC,IAAI,KAAK,IAAI,QAAQ;YAAE,MAAM;QAE7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,IAAI,QAAQ;gBAAE,MAAM;YAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,KAAK,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YACpF,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,mBAAmB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC;QACrB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK;QAC9D,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS;QAC9D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK;KAC9D,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/generate/index-file.d.ts

@@ -0,0 +1,29 @@
+import type { FileExtraction } from "../extract/signatures.js";
+import type { DepGraph } from "../extract/depgraph.js";
+import type { ComplexityScore } from "../extract/complexity.js";
+export interface ModuleEntry {
+    name: string;
+    dir: string;
+    files: string[];
+    keywords: string[];
+    complexity: number;
+    file: string;
+}
+export interface ModuleIndex {
+    modules: ModuleEntry[];
+    generated: string;
+}
+/**
+ * Group files into logical modules and generate an index for prompt matching.
+ * Modules are primarily directory-based with keyword extraction.
+ */
+export declare function generateModuleIndex(extractions: FileExtraction[], depGraph: DepGraph, complexity: ComplexityScore[], root: string): ModuleIndex;
+/**
+ * Write the module index to .briefed/index.json
+ */
+export declare function writeModuleIndex(root: string, index: ModuleIndex): void;
+/**
+ * Generate simple contract files for each module (non-LLM version).
+ * Extracts structural info: purpose, exports, deps, complexity.
+ */
+export declare function generateSimpleContracts(index: ModuleIndex, extractions: FileExtraction[], depGraph: DepGraph, root: string): void;

package/dist/generate/index-file.js

@@ -0,0 +1,168 @@
+import { dirname, basename } from "path";
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import yaml from "js-yaml";
+/**
+ * Group files into logical modules and generate an index for prompt matching.
+ * Modules are primarily directory-based with keyword extraction.
+ */
+export function generateModuleIndex(extractions, depGraph, complexity, root) {
+    // Group files by directory
+    const dirGroups = new Map();
+    for (const ext of extractions) {
+        const dir = dirname(ext.path);
+        if (!dirGroups.has(dir))
+            dirGroups.set(dir, []);
+        dirGroups.get(dir).push(ext);
+    }
+    const modules = [];
+    for (const [dir, files] of dirGroups) {
+        if (files.length === 0)
+            continue;
+        // Extract keywords from:
+        // 1. Directory name parts
+        // 2. File names
+        // 3. Exported symbol names
+        const keywords = new Set();
+        // Directory parts
+        for (const part of dir.split("/")) {
+            if (part && part.length > 2) {
+                keywords.add(part.toLowerCase());
+                // Split camelCase/PascalCase
+                for (const word of splitIdentifier(part)) {
+                    if (word.length > 2)
+                        keywords.add(word.toLowerCase());
+                }
+            }
+        }
+        // File names (without extension)
+        for (const f of files) {
+            const name = basename(f.path).replace(/\.[^.]+$/, "");
+            keywords.add(name.toLowerCase());
+            for (const word of splitIdentifier(name)) {
+                if (word.length > 2)
+                    keywords.add(word.toLowerCase());
+            }
+        }
+        // Exported symbol names
+        for (const f of files) {
+            for (const sym of f.symbols.filter((s) => s.exported)) {
+                const name = sym.name.split(".").pop();
+                keywords.add(name.toLowerCase());
+                for (const word of splitIdentifier(name)) {
+                    if (word.length > 2)
+                        keywords.add(word.toLowerCase());
+                }
+            }
+        }
+        // Remove very common/generic keywords
+        const genericWords = new Set([
+            "src", "lib", "app", "index", "utils", "helpers", "types",
+            "const", "config", "common", "shared", "core", "main",
+        ]);
+        for (const gw of genericWords)
+            keywords.delete(gw);
+        // Compute average complexity
+        const fileComplexities = files
+            .map((f) => complexity.find((c) => c.file === f.path)?.score || 0);
+        const avgComplexity = fileComplexities.length > 0
+            ? fileComplexities.reduce((s, v) => s + v, 0) / fileComplexities.length
+            : 0;
+        const safeName = dir.replace(/[\/\\]/g, "-").replace(/^-/, "") || "root";
+        modules.push({
+            name: safeName,
+            dir,
+            files: files.map((f) => f.path),
+            keywords: [...keywords],
+            complexity: Math.round(avgComplexity * 10) / 10,
+            file: `${safeName}.yaml`,
+        });
+    }
+    // Sort by complexity (most complex first — they need context most)
+    modules.sort((a, b) => b.complexity - a.complexity);
+    return {
+        modules,
+        generated: new Date().toISOString(),
+    };
+}
+/**
+ * Write the module index to .briefed/index.json
+ */
+export function writeModuleIndex(root, index) {
+    const briefedDir = join(root, ".briefed");
+    if (!existsSync(briefedDir))
+        mkdirSync(briefedDir, { recursive: true });
+    writeFileSync(join(briefedDir, "index.json"), JSON.stringify(index, null, 2));
+}
+/**
+ * Generate simple contract files for each module (non-LLM version).
+ * Extracts structural info: purpose, exports, deps, complexity.
+ */
+export function generateSimpleContracts(index, extractions, depGraph, root) {
+    const contractsDir = join(root, ".briefed", "contracts");
+    if (!existsSync(contractsDir))
+        mkdirSync(contractsDir, { recursive: true });
+    for (const mod of index.modules) {
+        const modExtractions = extractions.filter((e) => mod.files.includes(e.path));
+        const exports = modExtractions.flatMap((e) => e.symbols.filter((s) => s.exported));
+        // Get dependencies (other modules this one imports from)
+        const deps = new Set();
+        for (const ext of modExtractions) {
+            for (const imp of ext.imports) {
+                if (imp.isRelative) {
+                    // Find which module this import belongs to
+                    for (const otherMod of index.modules) {
+                        if (otherMod.name === mod.name)
+                            continue;
+                        if (otherMod.files.some((f) => imp.source.includes(basename(f).replace(/\.[^.]+$/, "")))) {
+                            deps.add(otherMod.name);
+                        }
+                    }
+                }
+            }
+        }
+        // Get dependents (other modules that import from this one)
+        const dependents = new Set();
+        for (const otherMod of index.modules) {
+            if (otherMod.name === mod.name)
+                continue;
+            const otherExtractions = extractions.filter((e) => otherMod.files.includes(e.path));
+            for (const ext of otherExtractions) {
+                for (const imp of ext.imports) {
+                    if (imp.isRelative && mod.files.some((f) => imp.source.includes(basename(f).replace(/\.[^.]+$/, "")))) {
+                        dependents.add(otherMod.name);
+                    }
+                }
+            }
+        }
+        const contract = {
+            module: mod.dir,
+            files: mod.files.length,
+            complexity: mod.complexity,
+        };
+        if (exports.length > 0) {
+            contract.exports = exports.slice(0, 15).map((s) => s.signature);
+        }
+        if (deps.size > 0) {
+            contract.dependencies = [...deps];
+        }
+        if (dependents.size > 0) {
+            contract.dependents = [...dependents];
+        }
+        const yamlContent = yaml.dump(contract, {
+            indent: 2,
+            lineWidth: 120,
+            noRefs: true,
+        });
+        writeFileSync(join(contractsDir, mod.file), yamlContent);
+    }
+}
+/** Split camelCase/PascalCase/snake_case identifiers into words */
+function splitIdentifier(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/[_-]/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length > 0);
+}
+//# sourceMappingURL=index-file.js.map