flowseeker 0.1.7

package/dist/commands/copyContext.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyContext = copyContext;
+const vscode = __importStar(require("vscode"));
+const loadConfig_1 = require("../config/loadConfig");
+const contextPack_1 = require("../pipeline/contextPack");
+const logger_1 = require("../utils/logger");
+async function copyContext(provider) {
+    const result = provider.getResult();
+    if (!result) {
+        vscode.window.showWarningMessage("Run FlowSeeker: Find Relevant Context first.");
+        return;
+    }
+    const config = await (0, loadConfig_1.loadConfig)();
+    const selectedUnits = provider.getSelectedUnits();
+    const contextPack = (0, contextPack_1.createContextPack)(result.task, selectedUnits, config);
+    await vscode.env.clipboard.writeText(contextPack);
+    (0, logger_1.logInfo)(`Copied context pack with ${selectedUnits.length} selected evidence units.`);
+    vscode.window.showInformationMessage(`Copied FlowSeeker context with ${selectedUnits.length} selected evidence units.`);
+}
+//# sourceMappingURL=copyContext.js.map

package/dist/commands/explainSelectionRelevance.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainSelectionRelevance = explainSelectionRelevance;
+const vscode = __importStar(require("vscode"));
+async function explainSelectionRelevance(provider) {
+    const editor = vscode.window.activeTextEditor;
+    if (!editor) {
+        vscode.window.showWarningMessage("Open a file that appears in FlowSeeker results first.");
+        return;
+    }
+    const units = provider.findUnitsForFile(editor.document.uri.fsPath);
+    if (units.length === 0) {
+        vscode.window.showInformationMessage("The active file is not in the current FlowSeeker result set.");
+        return;
+    }
+    const detail = units
+        .map((unit) => {
+        const range = unit.range ? `:${unit.range.startLine}-${unit.range.endLine}` : "";
+        return `${unit.relativePath}${range}\nRole: ${unit.role}\nConfidence: ${unit.confidence.toFixed(2)}\nReasons:\n${unit.reasons.map((reason) => `- ${reason}`).join("\n")}`;
+    })
+        .join("\n\n---\n\n");
+    vscode.window.showInformationMessage(detail, { modal: true });
+}
+//# sourceMappingURL=explainSelectionRelevance.js.map

package/dist/commands/findRelevantContext.js

@@ -0,0 +1,127 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findRelevantContext = findRelevantContext;
+const vscode = __importStar(require("vscode"));
+const runPipeline_1 = require("../pipeline/runPipeline");
+const logger_1 = require("../utils/logger");
+async function findRelevantContext(provider) {
+    const folders = vscode.workspace.workspaceFolders;
+    if (!folders || folders.length === 0) {
+        (0, logger_1.logInfo)("Find Relevant Context stopped because no workspace folder is open.");
+        vscode.window.showWarningMessage("Open a workspace folder before running FlowSeeker.");
+        return;
+    }
+    const task = await vscode.window.showInputBox({
+        title: "FlowSeeker: Find Relevant Context",
+        prompt: "Describe the bug, feature, refactor, or investigation you need to solve.",
+        placeHolder: "Example: fix students being approved by name instead of ID",
+        ignoreFocusOut: true
+    });
+    if (!task?.trim()) {
+        (0, logger_1.logInfo)("Find Relevant Context cancelled before scan.");
+        return;
+    }
+    try {
+        (0, logger_1.logInfo)(`Starting scan for task: ${task.trim()}`);
+        (0, logger_1.logInfo)(`Workspace folders: ${folders.map((folder) => folder.uri.fsPath).join("; ")}`);
+        const result = await vscode.window.withProgress({
+            location: vscode.ProgressLocation.Notification,
+            title: "FlowSeeker is scanning the workspace",
+            cancellable: true
+        }, async (progress, token) => {
+            progress.report({ message: "Understanding task and scanning files..." });
+            return (0, runPipeline_1.runFlowSeeker)(task.trim(), { progress, token });
+        });
+        provider.setResult(result);
+        (0, logger_1.logInfo)(`Task intent: ${result.profile.intent}; keywords: ${result.profile.keywords.join(", ")}`);
+        (0, logger_1.logInfo)(`Retrieval strategies: ${result.profile.strategies.join(", ")}`);
+        (0, logger_1.logInfo)(`Retrieval passes: ${result.profile.passes.map((pass) => `${pass.label}[${pass.purpose}]=${pass.terms.map((term) => `${term.term}:${term.weight}`).join("|")}`).join("; ")}`);
+        (0, logger_1.logInfo)(`Role counts: ${formatCounts(countBy(result.units.map((unit) => unit.role)))}`);
+        (0, logger_1.logInfo)(`Kind counts: ${formatCounts(countBy(result.units.map((unit) => unit.kind)))}`);
+        (0, logger_1.logInfo)(`Top evidence:\n${formatTopEvidence(result.units)}`);
+        (0, logger_1.logInfo)(`Scan complete. Discovered files: ${result.stats.discoveredFiles}; scanned files: ${result.stats.scannedFiles}; skipped files: ${result.stats.skippedFiles}; scanned bytes: ${formatBytes(result.stats.scannedBytes)}; raw evidence: ${result.stats.rawEvidenceCount}; ranked evidence: ${result.stats.rankedEvidenceCount}; max candidates: ${result.stats.maxCandidates}; capped: ${result.stats.capped}; stopped early: ${result.stats.stoppedEarly}${result.stats.stopReason ? ` (${result.stats.stopReason})` : ""}${formatIndexStats(result.stats)}.`);
+        if (result.stats.scannedFiles > 0 && result.units.length === 0) {
+            vscode.window.showWarningMessage(`FlowSeeker scanned ${result.stats.scannedFiles} files but found no evidence for this task. Try adding domain terms to .flowseeker/config.json synonyms or run it in the target project workspace.`);
+            return;
+        }
+        vscode.window.showInformationMessage(result.stats.stoppedEarly
+            ? `FlowSeeker returned partial results: ${result.stats.stopReason}. Showing ${result.units.length} evidence units.`
+            : result.stats.capped
+                ? `FlowSeeker found ${result.stats.rawEvidenceCount} raw evidence units and showed the top ${result.units.length}.`
+                : `FlowSeeker found ${result.units.length} evidence units from ${result.stats.scannedFiles} scanned files.`);
+    }
+    catch (error) {
+        (0, logger_1.logError)("Find Relevant Context failed.", error);
+        const message = error instanceof Error ? error.message : String(error);
+        vscode.window.showErrorMessage(`FlowSeeker failed: ${message}`);
+    }
+}
+function formatBytes(bytes) {
+    if (bytes < 1024 * 1024) {
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    }
+    return `${(bytes / 1024 / 1024).toFixed(1)}MB`;
+}
+function formatIndexStats(stats) {
+    if (stats.indexedFiles === undefined) {
+        return "";
+    }
+    return `; indexed files: ${stats.indexedFiles}; candidate files: ${stats.candidateFiles ?? "unknown"}; index reused: ${stats.indexReusedFiles ?? 0}; index updated: ${stats.indexUpdatedFiles ?? 0}`;
+}
+function countBy(values) {
+    return values.reduce((counts, value) => {
+        counts[value] = (counts[value] ?? 0) + 1;
+        return counts;
+    }, {});
+}
+function formatCounts(counts) {
+    const entries = Object.entries(counts).sort((left, right) => right[1] - left[1]);
+    return entries.length > 0 ? entries.map(([key, value]) => `${key}=${value}`).join(", ") : "none";
+}
+function formatTopEvidence(units) {
+    if (units.length === 0) {
+        return "  none";
+    }
+    return units
+        .slice(0, 10)
+        .map((unit, index) => {
+        const reasons = unit.reasons.slice(0, 2).join("; ") || "ranked evidence";
+        const passes = unit.retrievalPasses.length > 0 ? unit.retrievalPasses.join("+") : "seed";
+        return `  ${index + 1}. ${unit.relativePath} [${unit.role}/${unit.kind}] passes=${passes} score=${unit.score.toFixed(1)} confidence=${unit.confidence.toFixed(2)} - ${reasons}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=findRelevantContext.js.map

package/dist/commands/openEvidence.js

@@ -0,0 +1,49 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openEvidence = openEvidence;
+const vscode = __importStar(require("vscode"));
+async function openEvidence(unit) {
+    const document = await vscode.workspace.openTextDocument(vscode.Uri.file(unit.file));
+    const editor = await vscode.window.showTextDocument(document, { preview: false });
+    if (!unit.range) {
+        return;
+    }
+    const start = new vscode.Position(Math.max(0, unit.range.startLine - 1), 0);
+    const end = new vscode.Position(Math.max(0, unit.range.endLine - 1), 0);
+    editor.selection = new vscode.Selection(start, start);
+    editor.revealRange(new vscode.Range(start, end), vscode.TextEditorRevealType.InCenter);
+}
+//# sourceMappingURL=openEvidence.js.map

package/dist/commands/openMcpConfig.js

@@ -0,0 +1,81 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openMcpConfig = openMcpConfig;
+const vscode = __importStar(require("vscode"));
+async function openMcpConfig() {
+    const folders = vscode.workspace.workspaceFolders;
+    if (!folders?.[0]) {
+        await vscode.window.showWarningMessage("Open a workspace folder before configuring MCP servers.");
+        return;
+    }
+    const vscodeDir = vscode.Uri.joinPath(folders[0].uri, ".vscode");
+    const configUri = vscode.Uri.joinPath(vscodeDir, "mcp.json");
+    await ensureWorkspaceMcpConfig(vscodeDir, configUri);
+    const document = await vscode.workspace.openTextDocument(configUri);
+    await vscode.window.showTextDocument(document, { preview: false });
+}
+async function ensureWorkspaceMcpConfig(vscodeDir, configUri) {
+    try {
+        await vscode.workspace.fs.stat(configUri);
+        return;
+    }
+    catch {
+        // Create a workspace MCP config template when one does not exist.
+    }
+    try {
+        await vscode.workspace.fs.createDirectory(vscodeDir);
+    }
+    catch {
+        // Directory may have been created by another process.
+    }
+    const template = {
+        servers: {
+            "example-stdio": {
+                enabled: false,
+                type: "stdio",
+                command: "npx",
+                args: ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
+            },
+            "example-http": {
+                enabled: false,
+                type: "http",
+                url: "http://localhost:3000/mcp"
+            }
+        }
+    };
+    await vscode.workspace.fs.writeFile(configUri, new TextEncoder().encode(`${JSON.stringify(template, null, 2)}\n`));
+}
+//# sourceMappingURL=openMcpConfig.js.map

package/dist/commands/openRelatedTests.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openRelatedTests = openRelatedTests;
+const vscode = __importStar(require("vscode"));
+async function openRelatedTests(provider) {
+    const tests = provider.getUnitsByRole("test");
+    if (tests.length === 0) {
+        vscode.window.showInformationMessage("No related tests were found in the current FlowSeeker results.");
+        return;
+    }
+    for (const test of tests.slice(0, 5)) {
+        const document = await vscode.workspace.openTextDocument(vscode.Uri.file(test.file));
+        const editor = await vscode.window.showTextDocument(document, { preview: false });
+        if (test.range) {
+            const position = new vscode.Position(Math.max(0, test.range.startLine - 1), 0);
+            editor.selection = new vscode.Selection(position, position);
+            editor.revealRange(new vscode.Range(position, position), vscode.TextEditorRevealType.InCenter);
+        }
+    }
+}
+//# sourceMappingURL=openRelatedTests.js.map

package/dist/commands/rebuildIndex.js

@@ -0,0 +1,45 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rebuildIndex = rebuildIndex;
+const vscode = __importStar(require("vscode"));
+const cacheStore_1 = require("../index/cacheStore");
+const logger_1 = require("../utils/logger");
+async function rebuildIndex() {
+    await (0, cacheStore_1.clearFlowSeekerCache)();
+    (0, logger_1.logInfo)("FlowSeeker cache cleared.");
+    vscode.window.showInformationMessage("FlowSeeker cache cleared. The workspace index will be rebuilt on the next search.");
+}
+//# sourceMappingURL=rebuildIndex.js.map