vemora 0.1.0-alpha.15

package/dist/commands/status.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStatus = runStatus;
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
+const deps_1 = require("../indexer/deps");
+const cache_1 = require("../storage/cache");
+const knowledge_1 = require("../storage/knowledge");
+const repository_1 = require("../storage/repository");
+const summaries_1 = require("../storage/summaries");
+async function runStatus(rootDir) {
+    const config = (0, config_1.loadConfig)(rootDir);
+    const repo = new repository_1.RepositoryStorage(rootDir);
+    const meta = repo.loadMetadata();
+    const cacheStorage = new cache_1.EmbeddingCacheStorage(config.projectId);
+    const cache = cacheStorage.load();
+    const row = (label, value) => console.log(`  ${chalk_1.default.gray(label.padEnd(16))} ${value}`);
+    console.log(chalk_1.default.bold("vemora status"));
+    console.log();
+    row("Project:", config.projectName);
+    row("Project ID:", config.projectId);
+    row("Provider:", `${config.embedding.provider} / ${config.embedding.model}`);
+    if (meta) {
+        console.log();
+        console.log(chalk_1.default.bold("Index (versioned in git):"));
+        row("Last indexed:", meta.lastIndexed ?? chalk_1.default.gray("never"));
+        row("Files:", String(meta.indexedFiles));
+        row("Chunks:", String(meta.totalChunks));
+        row("Symbols:", String(meta.totalSymbols));
+        row("Dep edges:", String(meta.totalDepEdges ?? 0));
+        row("Call edges:", String(meta.totalCallEdges ?? 0));
+    }
+    // Summaries
+    const summaryStorage = new summaries_1.SummaryStorage(rootDir);
+    if (summaryStorage.hasFileSummaries()) {
+        const fileSummaries = summaryStorage.loadFileSummaries();
+        const summaryCount = Object.keys(fileSummaries).length;
+        const hasOverview = summaryStorage.hasProjectSummary();
+        console.log();
+        console.log(chalk_1.default.bold("Summaries (versioned in git):"));
+        row("File summaries:", String(summaryCount));
+        row("Project overview:", hasOverview
+            ? chalk_1.default.green("yes")
+            : chalk_1.default.gray("no  (run vemora summarize)"));
+    }
+    // Knowledge store
+    const knowledgeStorage = new knowledge_1.KnowledgeStorage(rootDir);
+    if (knowledgeStorage.hasKnowledge()) {
+        const entries = knowledgeStorage.load();
+        console.log();
+        console.log(chalk_1.default.bold("Knowledge store (versioned in git):"));
+        row("Entries:", String(entries.length));
+        // Staleness detection: warn if relatedFiles were modified after entry was created
+        const fileIndex = repo.loadFiles();
+        const stale = entries.filter((e) => {
+            if (!e.relatedFiles?.length)
+                return false;
+            return e.relatedFiles.some((f) => {
+                const fileEntry = fileIndex[f];
+                if (!fileEntry)
+                    return false;
+                // If we have a hash snapshot, use it — immune to touch/timestamp skew
+                if (e.relatedFileHashes?.[f]) {
+                    return fileEntry.hash !== e.relatedFileHashes[f];
+                }
+                // Fallback for older entries without hash snapshots
+                if (fileEntry.hash && e.createdAt) {
+                    return new Date(fileEntry.lastModified) > new Date(e.createdAt);
+                }
+                return false;
+            });
+        });
+        if (stale.length > 0) {
+            console.log();
+            for (const e of stale) {
+                console.log(`  ${chalk_1.default.yellow("⚠")}  Knowledge entry ${chalk_1.default.gray(`[${e.id.slice(0, 8)}]`)} ${chalk_1.default.bold(`"${e.title}"`)} — related files changed after entry was created`);
+                console.log(chalk_1.default.gray(`     Created: ${e.createdAt.slice(0, 10)} · Run \`vemora knowledge list\` to review`));
+            }
+        }
+    }
+    // TODO / FIXME annotations
+    const todos = repo.loadTodos();
+    if (todos.length > 0) {
+        const byType = todos.reduce((acc, t) => {
+            acc[t.type] = (acc[t.type] ?? 0) + 1;
+            return acc;
+        }, {});
+        console.log();
+        console.log(chalk_1.default.bold("Code annotations (versioned in git):"));
+        row("Total:", String(todos.length));
+        for (const [type, count] of Object.entries(byType).sort()) {
+            row(`  ${type}:`, String(count));
+        }
+    }
+    // Circular dependency detection
+    const deps = repo.loadDeps();
+    const cycles = (0, deps_1.detectCycles)(deps);
+    if (cycles.length > 0) {
+        console.log();
+        console.log(chalk_1.default.bold("Circular dependencies:"));
+        for (const cycle of cycles) {
+            const display = cycle
+                .map((f) => chalk_1.default.cyan(path_1.default.basename(f)))
+                .join(chalk_1.default.gray(" → "));
+            console.log(`  ${chalk_1.default.yellow("⚠")}  ${display}`);
+        }
+    }
+    console.log();
+    console.log(chalk_1.default.bold("Embedding cache (local only):"));
+    const cachedCount = cache?.chunkIds
+        ? cache.chunkIds.length
+        : Object.keys(cache?.embeddings ?? {}).length;
+    if (!cache || cachedCount === 0) {
+        console.log(`  ${chalk_1.default.gray("No cache found.")} Run ${chalk_1.default.cyan("vemora index")} to generate embeddings.`);
+    }
+    else {
+        row("Cached vectors:", String(cachedCount));
+        row("Model:", cache.embeddingModel);
+        row("Updated:", cache.lastUpdated);
+        row("Location:", cacheStorage.getCacheDir());
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/summarize.d.ts

@@ -0,0 +1,14 @@
+export interface SummarizeOptions {
+    /** Re-generate all summaries, ignoring content hashes */
+    force?: boolean;
+    /** Override the model from config (e.g. gpt-4o, gpt-4o-mini) */
+    model?: string;
+    /** Only generate file-level summaries, skip project overview */
+    filesOnly?: boolean;
+    /** Only (re)generate the project overview from existing file summaries */
+    projectOnly?: boolean;
+    /** Print the existing project overview without regenerating anything */
+    show?: boolean;
+}
+export declare function runSummarize(rootDir: string, options?: SummarizeOptions): Promise<void>;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/commands/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../src/commands/summarize.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA6BD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAyLf"}

package/dist/commands/summarize.js

@@ -0,0 +1,170 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSummarize = runSummarize;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const ora_1 = __importDefault(require("ora"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
+const factory_1 = require("../llm/factory");
+const repository_1 = require("../storage/repository");
+const summaries_1 = require("../storage/summaries");
+// ─── Prompts ──────────────────────────────────────────────────────────────────
+function fileSummaryPrompt(file, symbols, content) {
+    const symbolList = symbols.length > 0 ? symbols.join(", ") : "none";
+    return (`Summarize this source file in 1-2 sentences for a code memory index.\n` +
+        `Cover: what it does, key exports (${symbolList}), its role in the codebase.\n` +
+        `Output only the summary sentence(s). No headers, no lists, no preamble.\n\n` +
+        `File: ${file}\n\`\`\`\n${content}\n\`\`\``);
+}
+function projectOverviewPrompt(projectName, summaries) {
+    return (`Write a technical overview of the "${projectName}" codebase for an AI assistant's memory index.\n` +
+        `Cover: purpose, main architectural layers, key data flows, entry points for development tasks.\n` +
+        `Be dense and precise. 200-300 words. No preamble, no headers, plain prose only.\n\n` +
+        `File summaries:\n${summaries}`);
+}
+// ─── Main command ─────────────────────────────────────────────────────────────
+async function runSummarize(rootDir, options = {}) {
+    if (options.show) {
+        const summaryStorage = new summaries_1.SummaryStorage(rootDir);
+        const projectSummary = summaryStorage.loadProjectSummary();
+        if (!projectSummary) {
+            console.log(chalk_1.default.yellow("No project overview found. Run `vemora summarize` first."));
+            process.exit(1);
+        }
+        console.log(projectSummary.overview);
+        console.log();
+        console.log(chalk_1.default.gray(`Generated: ${projectSummary.generatedAt}`));
+        return;
+    }
+    const config = (0, config_1.loadConfig)(rootDir);
+    const repo = new repository_1.RepositoryStorage(rootDir);
+    const summaryStorage = new summaries_1.SummaryStorage(rootDir);
+    // ── Resolve LLM provider ────────────────────────────────────────────────────
+    const summarizationConfig = {
+        ...(config.summarization ?? { provider: "ollama", model: "gemma4:e2b", baseUrl: "http://localhost:11434" }),
+        ...(options.model ? { model: options.model } : {}),
+    };
+    const model = summarizationConfig.model;
+    const llm = (0, factory_1.createLLMProvider)(summarizationConfig);
+    // ── File summaries ──────────────────────────────────────────────────────────
+    let anyFileSummaryChanged = false;
+    if (!options.projectOnly) {
+        const files = repo.loadFiles();
+        const prevSummaries = summaryStorage.loadFileSummaries();
+        const allEntries = Object.entries(files);
+        const toSummarize = options.force
+            ? allEntries
+            : allEntries.filter(([relPath, entry]) => {
+                const prev = prevSummaries[relPath];
+                return !prev || prev.contentHash !== entry.hash;
+            });
+        const skipped = allEntries.length - toSummarize.length;
+        console.log(chalk_1.default.bold(`Summarizing ${chalk_1.default.cyan(config.projectName)}`));
+        console.log(chalk_1.default.gray(`  model: ${model}`));
+        console.log();
+        console.log(chalk_1.default.bold("File summaries") +
+            chalk_1.default.gray(`  ${toSummarize.length} to generate` +
+                (skipped > 0 ? `, ${skipped} unchanged (skipped)` : "")));
+        console.log();
+        if (toSummarize.length === 0) {
+            console.log(chalk_1.default.green("✓ All file summaries are up to date."));
+        }
+        else {
+            const updated = { ...prevSummaries };
+            let failed = 0;
+            for (let i = 0; i < toSummarize.length; i++) {
+                const [relPath, entry] = toSummarize[i];
+                const label = `[${i + 1}/${toSummarize.length}] ${relPath}`;
+                const spinner = (0, ora_1.default)(chalk_1.default.gray(label)).start();
+                try {
+                    // Read file content, truncate to ~4000 chars to stay within prompt limits
+                    const absolutePath = path_1.default.join(rootDir, relPath);
+                    let content = "";
+                    if (fs_1.default.existsSync(absolutePath)) {
+                        const raw = fs_1.default.readFileSync(absolutePath, "utf-8");
+                        content =
+                            raw.length > 4000
+                                ? raw.slice(0, 4000) + "\n... (truncated)"
+                                : raw;
+                    }
+                    const fileSymbols = entry.symbols ?? [];
+                    const response = await llm.chat([{ role: "user", content: fileSummaryPrompt(relPath, fileSymbols, content) }], { model, maxTokens: 1024, temperature: 0 });
+                    const summary = response.content.trim();
+                    updated[relPath] = {
+                        summary,
+                        contentHash: entry.hash,
+                        generatedAt: new Date().toISOString(),
+                    };
+                    // Save after every file so progress is never lost on interruption
+                    summaryStorage.saveFileSummaries(updated);
+                    spinner.succeed(chalk_1.default.gray(relPath));
+                    anyFileSummaryChanged = true;
+                }
+                catch (err) {
+                    spinner.fail(chalk_1.default.red(`${relPath}: ${err.message}`));
+                    failed++;
+                }
+            }
+            console.log();
+            console.log(chalk_1.default.green(`✓ ${toSummarize.length - failed} file summaries saved`) +
+                (failed > 0 ? chalk_1.default.red(` (${failed} failed)`) : "") +
+                chalk_1.default.gray("  →  .vemora/summaries/file-summaries.json"));
+        }
+        if (options.filesOnly)
+            return;
+        console.log();
+    }
+    // ── Project overview ────────────────────────────────────────────────────────
+    if (!anyFileSummaryChanged &&
+        !options.force &&
+        !options.projectOnly &&
+        summaryStorage.hasProjectSummary()) {
+        console.log(chalk_1.default.green("✓ Project overview is up to date."));
+        return;
+    }
+    const currentSummaries = summaryStorage.loadFileSummaries();
+    const summaryEntries = Object.entries(currentSummaries);
+    if (summaryEntries.length === 0) {
+        console.log(chalk_1.default.yellow("No file summaries found. Run `vemora summarize` (without --project-only) first."));
+        return;
+    }
+    const overviewSpinner = (0, ora_1.default)("Generating project overview...").start();
+    // Build the file summaries block, sorted and truncated to fit context
+    const MAX_SUMMARY_CHARS = 12000;
+    let summaryBlock = summaryEntries
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([file, { summary }]) => `${file}:\n  ${summary}`)
+        .join("\n\n");
+    if (summaryBlock.length > MAX_SUMMARY_CHARS) {
+        summaryBlock =
+            summaryBlock.slice(0, MAX_SUMMARY_CHARS) + "\n... (truncated)";
+    }
+    try {
+        const response = await llm.chat([{ role: "user", content: projectOverviewPrompt(config.projectName, summaryBlock) }], { model, maxTokens: 2048, temperature: 0.1 });
+        const overview = response.content.trim();
+        const projectSummary = {
+            overview,
+            generatedAt: new Date().toISOString(),
+        };
+        summaryStorage.saveProjectSummary(projectSummary);
+        overviewSpinner.succeed("Project overview saved" +
+            chalk_1.default.gray("  →  .vemora/summaries/project-summary.json"));
+        // Print a short preview
+        console.log();
+        const previewLines = overview.split("\n").slice(0, 5);
+        for (const line of previewLines) {
+            console.log("  " + chalk_1.default.gray(line));
+        }
+        if (overview.split("\n").length > 5) {
+            console.log(chalk_1.default.gray("  … (use `vemora summarize --show` to read in full)"));
+        }
+    }
+    catch (err) {
+        overviewSpinner.fail(`Project overview failed: ${err.message}`);
+    }
+}
+//# sourceMappingURL=summarize.js.map

package/dist/commands/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../src/commands/summarize.ts"],"names":[],"mappings":";;;;;AAkDA,oCA4LC;AA9OD,kDAA0B;AAC1B,4CAAoB;AACpB,8CAAsB;AACtB,gDAAwB;AACxB,2CAA4C;AAE5C,4CAAmD;AACnD,sDAA0D;AAC1D,oDAAsD;AAetD,iFAAiF;AAEjF,SAAS,iBAAiB,CACxB,IAAY,EACZ,OAAiB,EACjB,OAAe;IAEf,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACpE,OAAO,CACL,wEAAwE;QACxE,qCAAqC,UAAU,gCAAgC;QAC/E,6EAA6E;QAC7E,SAAS,IAAI,aAAa,OAAO,UAAU,CAC5C,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB,EAAE,SAAiB;IACnE,OAAO,CACL,sCAAsC,WAAW,kDAAkD;QACnG,kGAAkG;QAClG,qFAAqF;QACrF,oBAAoB,SAAS,EAAE,CAChC,CAAC;AACJ,CAAC;AAED,iFAAiF;AAE1E,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,UAA4B,EAAE;IAE9B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,cAAc,GAAG,IAAI,0BAAc,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,cAAc,GAAG,cAAc,CAAC,kBAAkB,EAAE,CAAC;QAC3D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,0DAA0D,CAAC,CAAC,CAAC;YACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,cAAc,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,OAAO,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,8BAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAI,0BAAc,CAAC,OAAO,CAAC,CAAC;IAEnD,+EAA+E;IAC/E,MAAM,mBAAmB,GAAG;QAC1B,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,QAAQ,EAAE,QAAiB,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;QACpH,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CAAC;IACF,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC;IACxC,MAAM,GAAG,GAAG,IAAA,2BAAiB,EAAC,mBAAmB,CAAC,CAAC;IAEnD,+EAA+E;IAE/E,IAAI,qBAAqB,GAAG,KAAK,CAAC;IAElC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,cAAc,CAAC,iBAAiB,EAAE,CAAC;QAEzD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK;YAC/B,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE;gBACrC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;gBACpC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,IAAI,CAAC;YAClD,CAAC,CAAC,CAAC;QAEP,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;QAEvD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,eAAe,eAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC1B,eAAK,CAAC,IAAI,CACR,KAAK,WAAW,CAAC,MAAM,cAAc;gBACnC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1D,CACJ,CAAC;QACF,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAqB,EAAE,GAAG,aAAa,EAAE,CAAC;YACvD,IAAI,MAAM,GAAG,CAAC,CAAC;YAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC5D,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;gBAE/C,IAAI,CAAC;oBACH,0EAA0E;oBAC1E,MAAM,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBACjD,IAAI,OAAO,GAAG,EAAE,CAAC;oBACjB,IAAI,YAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;wBAChC,MAAM,GAAG,GAAG,YAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;wBACnD,OAAO;4BACL,GAAG,CAAC,MAAM,GAAG,IAAI;gCACf,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,mBAAmB;gCAC1C,CAAC,CAAC,GAAG,CAAC;oBACZ,CAAC;oBAED,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;oBAExC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,EAC7E,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAC3C,CAAC;oBAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;oBAExC,OAAO,CAAC,OAAO,CAAC,GAAG;wBACjB,OAAO;wBACP,WAAW,EAAE,KAAK,CAAC,IAAI;wBACvB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACtC,CAAC;oBAEF,kEAAkE;oBAClE,cAAc,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;oBAC1C,OAAO,CAAC,OAAO,CAAC,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;oBACrC,qBAAqB,GAAG,IAAI,CAAC;gBAC/B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,eAAK,CAAC,GAAG,CAAC,GAAG,OAAO,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBACjE,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,MAAM,GAAG,MAAM,uBAAuB,CAAC;gBAClE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,KAAK,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,eAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAC3D,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,SAAS;YAAE,OAAO;QAC9B,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,+EAA+E;IAE/E,IACE,CAAC,qBAAqB;QACtB,CAAC,OAAO,CAAC,KAAK;QACd,CAAC,OAAO,CAAC,WAAW;QACpB,cAAc,CAAC,iBAAiB,EAAE,EAClC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,gBAAgB,GAAG,cAAc,CAAC,iBAAiB,EAAE,CAAC;IAC5D,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAExD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,MAAM,CACV,iFAAiF,CAClF,CACF,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,eAAe,GAAG,IAAA,aAAG,EAAC,gCAAgC,CAAC,CAAC,KAAK,EAAE,CAAC;IAEtE,sEAAsE;IACtE,MAAM,iBAAiB,GAAG,KAAK,CAAC;IAChC,IAAI,YAAY,GAAG,cAAc;SAC9B,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,QAAQ,OAAO,EAAE,CAAC;SACtD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,IAAI,YAAY,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAC5C,YAAY;YACV,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,mBAAmB,CAAC;IACnE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC,EACpF,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAC7C,CAAC;QAEF,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEzC,MAAM,cAAc,GAAmB;YACrC,QAAQ;YACR,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,cAAc,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAClD,eAAe,CAAC,OAAO,CACrB,wBAAwB;YACtB,eAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAC5D,CAAC;QAEF,wBAAwB;QACxB,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAe,CAAC,IAAI,CAAC,4BAA6B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/commands/triage.d.ts

@@ -0,0 +1,33 @@
+export type TriageType = "bugs" | "security" | "performance";
+export interface TriageOptions {
+    /** Audit types to run (default: all three) */
+    types?: TriageType[];
+    /** Max findings to return, sorted by score (default: 30) */
+    topK?: number;
+    /** Skip findings with score below this threshold (default: 1) */
+    minScore?: number;
+    /** Output format */
+    output?: "terminal" | "json" | "markdown";
+    /** Restrict analysis to files matching this substring */
+    file?: string;
+}
+export interface TriageMatch {
+    heuristic: string;
+    category: string;
+    severity: "high" | "medium" | "low";
+    reason: string;
+    /** Absolute 1-based line number within the file */
+    line: number;
+    /** Trimmed line content (up to 120 chars) */
+    snippet: string;
+}
+export interface TriageFinding {
+    file: string;
+    startLine: number;
+    endLine: number;
+    symbol?: string;
+    score: number;
+    matches: TriageMatch[];
+}
+export declare function runTriage(rootDir: string, options?: TriageOptions): Promise<void>;
+//# sourceMappingURL=triage.d.ts.map

package/dist/commands/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/commands/triage.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAmaD,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmDf"}