@manishbht/helpcode 0.2.2

package/dist/src/commands/init.js

@@ -0,0 +1,91 @@
+/**
+ * `helpcode init` — detect the project, write .helpcode/project.json,
+ * make sure .helpcode/ is gitignored.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { buildDetectedConfig, projectExists, saveProjectConfig } from '../core/project.js';
+import { isOllamaReachable, listModels } from '../core/ollama.js';
+import { c, log } from '../lib/ui.js';
+/** Coder-tuned models preferred for file-selection reasoning, best first. */
+const PREFERRED_MODELS = [
+    'qwen2.5-coder', 'deepseek-coder-v2', 'codestral', 'llama3.1', 'mistral',
+];
+export async function handleInit(opts = {}) {
+    const cwd = process.cwd();
+    if (projectExists(cwd) && !opts.force) {
+        log.warn('.helpcode/project.json already exists.');
+        log.dim('Pass --force to regenerate.');
+        return 1;
+    }
+    const config = buildDetectedConfig(cwd);
+    // Detect Ollama. If reachable with a model, enable LLM selection and pick
+    // the best available coder model as the default.
+    let ollamaNote = '(not detected — LLM file selection off; install Ollama to enable)';
+    if (config.ollama && !opts.skipOllamaDetection) {
+        const host = config.ollama.host;
+        const reachable = await isOllamaReachable(host, { timeoutMs: 1000 });
+        if (reachable) {
+            try {
+                const models = await listModels(host, { timeoutMs: 2000 });
+                const chosen = pickModel(models);
+                if (chosen) {
+                    config.ollama.enabled = true;
+                    config.ollama.model = chosen;
+                    ollamaNote = `enabled, model: ${chosen}`;
+                }
+                else if (models.length > 0) {
+                    config.ollama.enabled = true;
+                    config.ollama.model = models[0];
+                    ollamaNote = `enabled, model: ${models[0]} (no coder model found — consider pulling qwen2.5-coder)`;
+                }
+                else {
+                    ollamaNote = 'reachable but no models pulled — run `ollama pull qwen2.5-coder`';
+                }
+            }
+            catch {
+                ollamaNote = 'reachable but model list failed — left disabled';
+            }
+        }
+    }
+    saveProjectConfig(config, cwd);
+    log.ok('Initialised .helpcode/project.json');
+    console.log();
+    console.log('Detected:');
+    console.log(`  ${c.dim('language:    ')}${config.language}`);
+    console.log(`  ${c.dim('framework:   ')}${config.framework ?? '(none)'}`);
+    console.log(`  ${c.dim('source dirs: ')}${config.sourceDirs.join(', ')}`);
+    console.log(`  ${c.dim('test cmd:    ')}${config.testCommand ?? '(none detected)'}`);
+    console.log(`  ${c.dim('ollama:      ')}${ollamaNote}`);
+    console.log();
+    ensureGitignore(cwd);
+    log.dim('Edit .helpcode/project.json to override any of the above.');
+    log.dim('Next: `helpcode ask "your task"`');
+    return 0;
+}
+/** Pick the best preferred model present, matching on prefix. */
+function pickModel(available) {
+    for (const pref of PREFERRED_MODELS) {
+        const match = available.find(m => m.startsWith(pref));
+        if (match)
+            return match;
+    }
+    return null;
+}
+function ensureGitignore(cwd) {
+    const gitignorePath = path.join(cwd, '.gitignore');
+    const line = '.helpcode/';
+    let existing = '';
+    if (fs.existsSync(gitignorePath)) {
+        existing = fs.readFileSync(gitignorePath, 'utf-8');
+        if (existing.split(/\r?\n/).some(l => l.trim() === line)) {
+            return; // already there
+        }
+    }
+    const updated = existing.endsWith('\n') || existing.length === 0
+        ? existing + line + '\n'
+        : existing + '\n' + line + '\n';
+    fs.writeFileSync(gitignorePath, updated, 'utf-8');
+    log.ok('Added .helpcode/ to .gitignore');
+}
+//# sourceMappingURL=init.js.map

package/dist/src/commands/init.js.map

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

package/dist/src/commands/reset.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `helpcode reset` — clear the current task and history.
+ * Does NOT touch project config or any source files.
+ */
+export interface ResetOptions {
+    yes?: boolean;
+}
+export declare function handleReset(opts?: ResetOptions): Promise<number>;

package/dist/src/commands/reset.js

@@ -0,0 +1,19 @@
+/**
+ * `helpcode reset` — clear the current task and history.
+ * Does NOT touch project config or any source files.
+ */
+import { resetState } from '../core/state.js';
+import { confirm, log } from '../lib/ui.js';
+export async function handleReset(opts = {}) {
+    if (!opts.yes) {
+        const ok = await confirm('Clear current task and history? (project config is untouched)');
+        if (!ok) {
+            log.dim('Cancelled.');
+            return 0;
+        }
+    }
+    resetState();
+    log.ok('State cleared. Project config and source files are untouched.');
+    return 0;
+}
+//# sourceMappingURL=reset.js.map

package/dist/src/commands/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../../src/commands/reset.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAqB,EAAE;IACvD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,+DAA+D,CAAC,CAAC;QAC1F,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,UAAU,EAAE,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,+DAA+D,CAAC,CAAC;IACxE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/src/commands/run.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `helpcode run <command>` — run a shell command and capture the output
+ * in compact form. The result is saved into state so the next `ask` can
+ * include it for Claude.
+ *
+ * Side effect (v0.1.3): if the command matches the project's configured
+ * test command AND it succeeds AND the current task is in a `failed` state,
+ * the task is auto-resolved. This fixes the state-drift problem where a
+ * task stays `failed` forever after the user fixes the issue outside
+ * helpcode and re-runs the tests manually.
+ */
+export interface RunOptions {
+    timeout?: number;
+}
+export declare function handleRun(command: string, opts?: RunOptions): Promise<number>;

package/dist/src/commands/run.js

@@ -0,0 +1,109 @@
+/**
+ * `helpcode run <command>` — run a shell command and capture the output
+ * in compact form. The result is saved into state so the next `ask` can
+ * include it for Claude.
+ *
+ * Side effect (v0.1.3): if the command matches the project's configured
+ * test command AND it succeeds AND the current task is in a `failed` state,
+ * the task is auto-resolved. This fixes the state-drift problem where a
+ * task stays `failed` forever after the user fixes the issue outside
+ * helpcode and re-runs the tests manually.
+ */
+import { runShellCommand } from '../core/tools.js';
+import { truncateLines, extractTraceback } from '../lib/compress.js';
+import { loadState, saveState } from '../core/state.js';
+import { projectExists, loadProjectConfig } from '../core/project.js';
+import { triageOutput, shouldTriage } from '../core/triage.js';
+import { c, log } from '../lib/ui.js';
+const MAX_OUTPUT_LINES = 40;
+export async function handleRun(command, opts = {}) {
+    if (!command || !command.trim()) {
+        log.err('Usage: helpcode run "<command>"');
+        return 1;
+    }
+    const result = await runShellCommand(command, { timeoutSecs: opts.timeout ?? 60 });
+    // Render compact report
+    const parts = [];
+    parts.push(`$ ${command}`);
+    parts.push(`Exit: ${result.exitCode}    Time: ${(result.durationMs / 1000).toFixed(2)}s` +
+        (result.timedOut ? c.yellow('    (TIMEOUT)') : ''));
+    if (result.stdout.trim()) {
+        parts.push('');
+        parts.push('--- stdout ---');
+        parts.push(truncateLines(result.stdout.trimEnd(), MAX_OUTPUT_LINES, 'stdout lines'));
+    }
+    if (result.stderr.trim()) {
+        parts.push('');
+        parts.push('--- stderr ---');
+        parts.push(extractTraceback(result.stderr));
+    }
+    if (!result.stdout.trim() && !result.stderr.trim()) {
+        parts.push('(no output)');
+    }
+    const report = parts.join('\n');
+    console.log(report);
+    // Save to state so `ask` can include it. When Ollama is enabled and the
+    // raw output is long, run it through local-LLM triage so the NEXT brief
+    // carries just the key failure rather than the whole wall of output. The
+    // console above still shows the full compact report to the user.
+    const state = loadState();
+    if (state.currentTask) {
+        let savedOutput = report;
+        const cfg = loadConfigSafe();
+        const rawForTriage = [result.stdout, result.stderr].filter(Boolean).join('\n').trim();
+        if (cfg?.ollama && shouldTriage(rawForTriage, cfg.ollama)) {
+            const triaged = await triageOutput(rawForTriage, cfg.ollama);
+            if (triaged.triaged) {
+                savedOutput = [
+                    `$ ${command}`,
+                    `Exit: ${result.exitCode}    Time: ${(result.durationMs / 1000).toFixed(2)}s`,
+                    '',
+                    '--- key failure (summarised by local model) ---',
+                    triaged.text,
+                ].join('\n');
+                log.dim('(summarised long output with local model for the next brief)');
+            }
+        }
+        state.currentTask.lastTestOutput = savedOutput;
+        // Auto-resolve: if this run matches the project's test command, it
+        // succeeded, and the task was failed, clear the failed state.
+        if (result.exitCode === 0 &&
+            state.currentTask.status === 'failed' &&
+            commandMatchesTestCommand(command)) {
+            state.currentTask.status = 'resolved';
+            console.log();
+            log.ok('Task marked resolved — the project test command now passes.');
+        }
+        saveState(state);
+    }
+    return result.exitCode;
+}
+/** Load project config without throwing if absent. */
+function loadConfigSafe() {
+    if (!projectExists())
+        return null;
+    try {
+        return loadProjectConfig();
+    }
+    catch {
+        return null;
+    }
+}
+/** Does the run command match the project's configured test command? */
+function commandMatchesTestCommand(command) {
+    if (!projectExists())
+        return false;
+    try {
+        const cfg = loadProjectConfig();
+        if (!cfg.testCommand)
+            return false;
+        return normalise(command) === normalise(cfg.testCommand);
+    }
+    catch {
+        return false;
+    }
+}
+function normalise(cmd) {
+    return cmd.trim().replace(/\s+/g, ' ');
+}
+//# sourceMappingURL=run.js.map

package/dist/src/commands/run.js.map

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

package/dist/src/commands/status.d.ts

@@ -0,0 +1,4 @@
+/**
+ * `helpcode status` — show what the agent thinks the current state is.
+ */
+export declare function handleStatus(): Promise<number>;

package/dist/src/commands/status.js

@@ -0,0 +1,53 @@
+/**
+ * `helpcode status` — show what the agent thinks the current state is.
+ */
+import { loadState } from '../core/state.js';
+import { loadProjectConfig } from '../core/project.js';
+import { c, log } from '../lib/ui.js';
+export async function handleStatus() {
+    let projectLine = '(not initialised — run `helpcode init`)';
+    try {
+        const cfg = loadProjectConfig();
+        projectLine = `${cfg.language}${cfg.framework ? ' / ' + cfg.framework : ''}`;
+    }
+    catch {
+        // not initialised
+    }
+    const state = loadState();
+    console.log(`${c.bold('project:')} ${projectLine}`);
+    if (!state.currentTask) {
+        console.log(`${c.bold('task:')}    ${c.dim('(none)')}`);
+        console.log();
+        log.dim('Run `helpcode ask "your task"` to start.');
+        return 0;
+    }
+    const t = state.currentTask;
+    console.log(`${c.bold('task:')}    ${t.description}`);
+    console.log(`${c.dim('  id:')}       ${t.id}`);
+    console.log(`${c.dim('  status:')}   ${formatStatus(t.status)}`);
+    console.log(`${c.dim('  iters:')}    ${t.iterations}`);
+    console.log(`${c.dim('  created:')}  ${t.createdAt}`);
+    if (t.lastDiffsApplied.length > 0) {
+        console.log();
+        console.log(c.bold('last applied:'));
+        for (const d of t.lastDiffsApplied) {
+            const mark = d.ok ? c.green('✓') : c.red('✗');
+            const tag = d.created ? c.dim(' (new)') : '';
+            console.log(`  ${mark} ${d.filepath}${tag}`);
+        }
+    }
+    if (state.history.length > 0) {
+        console.log();
+        console.log(c.dim(`history: ${state.history.length} resolved task(s)`));
+    }
+    return 0;
+}
+function formatStatus(s) {
+    switch (s) {
+        case 'awaiting_paste': return c.yellow(s);
+        case 'resolved': return c.green(s);
+        case 'failed': return c.red(s);
+        default: return s;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/src/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,WAAW,GAAG,yCAAyC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAChC,WAAW,GAAG,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;IAEpD,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,GAAG,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAEtD,IAAI,CAAC,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,KAAK,UAAU,CAAC,CAAO,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzC,KAAK,QAAQ,CAAC,CAAS,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,CAAe,OAAO,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/src/core/llmSelector.d.ts

@@ -0,0 +1,65 @@
+/**
+ * LLM-based file selection (v0.2).
+ *
+ * Given a task description and a set of candidate files, ask a local model
+ * (via Ollama) which files are most relevant and why. Unlike the keyword
+ * heuristic in selector.ts, the model can reason about indirection: a "login
+ * bug" task can surface session.py and the user model, not just files that
+ * literally contain the word "login".
+ *
+ * The CRITICAL guard is hallucination rejection: the model sometimes invents
+ * filenames. Every returned path is validated against the real candidate set;
+ * invented paths are dropped. If nothing valid survives, the caller falls
+ * back to the heuristic selector.
+ *
+ * This module is pure logic over its inputs (prompt building + parsing). The
+ * actual model call and the strategy/fallback wiring live in selector.ts so
+ * this stays easily unit-testable without a live Ollama.
+ */
+import { OllamaError } from './ollama.js';
+export interface Candidate {
+    /** Path relative to the project root, as shown to the model. */
+    path: string;
+    /** A compact signature: declarations or first lines, to give the model context. */
+    signature: string;
+}
+export interface Selection {
+    path: string;
+    reason: string;
+}
+/**
+ * Build a compact signature for a file: lines that look like declarations
+ * (def/class/function/export/const/interface/type/struct/fn/func), capped.
+ * Falls back to the first few non-blank lines if no declarations are found.
+ * Language-agnostic by design — works reasonably for Python, JS/TS, Go, Rust.
+ */
+export declare function buildSignature(filepath: string): string;
+/**
+ * Build the selection prompt. Strict, parseable format — same philosophy as
+ * the Claude response protocol: lean on the model's format-following.
+ */
+export declare function buildSelectionPrompt(task: string, candidates: Candidate[], count: number): string;
+/**
+ * Parse the model's response into validated selections.
+ *
+ * Tolerant of real-world model messiness: prose preambles, list markers
+ * (`- `, `1. `), backtick-wrapped paths, and missing reasons. Strict on the
+ * one thing that matters: the path must exist in the candidate set.
+ */
+export declare function parseSelectionResponse(response: string, candidates: Candidate[]): Selection[];
+/**
+ * Full LLM selection: build candidates' signatures, prompt the model, parse
+ * and validate. Returns validated selections, or an empty array if the model
+ * produced nothing usable (caller falls back to heuristic).
+ *
+ * Throws OllamaError on transport failures so the caller can distinguish
+ * "model ran but found nothing" (empty array) from "couldn't reach model"
+ * (throw) — both lead to fallback, but the caller may log them differently.
+ */
+export declare function llmSelectFiles(task: string, candidatePaths: string[], projectRoot: string, opts: {
+    host: string;
+    model: string;
+    count: number;
+    timeoutMs?: number;
+}): Promise<Selection[]>;
+export { OllamaError };

package/dist/src/core/llmSelector.js

@@ -0,0 +1,134 @@
+/**
+ * LLM-based file selection (v0.2).
+ *
+ * Given a task description and a set of candidate files, ask a local model
+ * (via Ollama) which files are most relevant and why. Unlike the keyword
+ * heuristic in selector.ts, the model can reason about indirection: a "login
+ * bug" task can surface session.py and the user model, not just files that
+ * literally contain the word "login".
+ *
+ * The CRITICAL guard is hallucination rejection: the model sometimes invents
+ * filenames. Every returned path is validated against the real candidate set;
+ * invented paths are dropped. If nothing valid survives, the caller falls
+ * back to the heuristic selector.
+ *
+ * This module is pure logic over its inputs (prompt building + parsing). The
+ * actual model call and the strategy/fallback wiring live in selector.ts so
+ * this stays easily unit-testable without a live Ollama.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { generate, OllamaError } from './ollama.js';
+const MAX_SIGNATURE_DECLS = 8; // declarations to include per file
+const MAX_SIGNATURE_FALLBACK_LINES = 6; // if no declarations found
+/**
+ * Build a compact signature for a file: lines that look like declarations
+ * (def/class/function/export/const/interface/type/struct/fn/func), capped.
+ * Falls back to the first few non-blank lines if no declarations are found.
+ * Language-agnostic by design — works reasonably for Python, JS/TS, Go, Rust.
+ */
+export function buildSignature(filepath) {
+    let text;
+    try {
+        text = fs.readFileSync(filepath, 'utf-8');
+    }
+    catch {
+        return '(unreadable)';
+    }
+    const lines = text.split(/\r?\n/);
+    const declRe = /^\s*(?:export\s+)?(?:async\s+)?(?:def|class|function|const|let|interface|type|struct|fn|func|public|private|protected)\b/;
+    const decls = [];
+    for (const line of lines) {
+        if (declRe.test(line)) {
+            // Trim to the signature part — drop bodies/braces for compactness
+            const trimmed = line.trim().replace(/\s*[{:].*$/, '').slice(0, 80);
+            if (trimmed)
+                decls.push(trimmed);
+            if (decls.length >= MAX_SIGNATURE_DECLS)
+                break;
+        }
+    }
+    if (decls.length > 0) {
+        return decls.join('; ');
+    }
+    // Fallback: first few non-blank, non-comment lines
+    const firstLines = lines
+        .map(l => l.trim())
+        .filter(l => l.length > 0 && !l.startsWith('#') && !l.startsWith('//'))
+        .slice(0, MAX_SIGNATURE_FALLBACK_LINES);
+    return firstLines.join(' / ').slice(0, 200) || '(empty)';
+}
+/**
+ * Build the selection prompt. Strict, parseable format — same philosophy as
+ * the Claude response protocol: lean on the model's format-following.
+ */
+export function buildSelectionPrompt(task, candidates, count) {
+    const lines = [];
+    lines.push(`TASK: ${task}`);
+    lines.push('');
+    lines.push('CANDIDATE FILES:');
+    for (const c of candidates) {
+        lines.push(`- ${c.path}: ${c.signature}`);
+    }
+    lines.push('');
+    lines.push(`Return the ${count} files most relevant to the task, most relevant first.`);
+    lines.push('Format each line exactly as:');
+    lines.push('  PATH | one-line reason');
+    lines.push('Only use paths from the candidate list above. No prose, no other text.');
+    return lines.join('\n');
+}
+/**
+ * Parse the model's response into validated selections.
+ *
+ * Tolerant of real-world model messiness: prose preambles, list markers
+ * (`- `, `1. `), backtick-wrapped paths, and missing reasons. Strict on the
+ * one thing that matters: the path must exist in the candidate set.
+ */
+export function parseSelectionResponse(response, candidates) {
+    const validPaths = new Set(candidates.map(c => c.path));
+    const seen = new Set();
+    const out = [];
+    for (const rawLine of response.split(/\r?\n/)) {
+        let line = rawLine.trim();
+        if (!line)
+            continue;
+        // Strip leading list markers: "- ", "* ", "1. ", "2) "
+        line = line.replace(/^(?:[-*]\s+|\d+[.)]\s+)/, '');
+        // Split on the first pipe into path-part and reason-part
+        const pipeIdx = line.indexOf('|');
+        let pathPart = pipeIdx >= 0 ? line.slice(0, pipeIdx) : line;
+        const reason = pipeIdx >= 0 ? line.slice(pipeIdx + 1).trim() : '';
+        // Clean the path: strip backticks, surrounding quotes, whitespace
+        pathPart = pathPart.trim().replace(/^[`'"]+|[`'"]+$/g, '').trim();
+        if (!validPaths.has(pathPart))
+            continue; // hallucination guard
+        if (seen.has(pathPart))
+            continue; // dedupe
+        seen.add(pathPart);
+        out.push({ path: pathPart, reason });
+    }
+    return out;
+}
+/**
+ * Full LLM selection: build candidates' signatures, prompt the model, parse
+ * and validate. Returns validated selections, or an empty array if the model
+ * produced nothing usable (caller falls back to heuristic).
+ *
+ * Throws OllamaError on transport failures so the caller can distinguish
+ * "model ran but found nothing" (empty array) from "couldn't reach model"
+ * (throw) — both lead to fallback, but the caller may log them differently.
+ */
+export async function llmSelectFiles(task, candidatePaths, projectRoot, opts) {
+    const candidates = candidatePaths.map(p => ({
+        path: path.relative(projectRoot, p),
+        signature: buildSignature(p),
+    }));
+    const prompt = buildSelectionPrompt(task, candidates, opts.count);
+    const response = await generate(opts.host, opts.model, prompt, {
+        timeoutMs: opts.timeoutMs,
+    });
+    return parseSelectionResponse(response, candidates);
+}
+// Re-export for callers that want to detect transport errors specifically.
+export { OllamaError };
+//# sourceMappingURL=llmSelector.js.map

package/dist/src/core/llmSelector.js.map

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

package/dist/src/core/ollama.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Minimal client for a local Ollama server (default http://localhost:11434).
+ *
+ * Design:
+ *   - Zero runtime dependencies: plain fetch, no SDK.
+ *   - fetch is injectable so tests never touch a live Ollama and CI passes
+ *     with no Ollama installed.
+ *   - Every failure becomes an OllamaError; callers (the selector) catch it
+ *     and fall back to the heuristic. The LLM path can NEVER break `ask`.
+ *
+ * This is the v0.2 foundation. It does file-selection reasoning today; the
+ * same client will serve later local-LLM tasks (response rescue, triage).
+ */
+export declare class OllamaError extends Error {
+    constructor(message: string);
+}
+/** Injectable fetch type — matches the global fetch signature we use. */
+type FetchImpl = (url: string, init?: RequestInit) => Promise<Response>;
+export interface OllamaCallOptions {
+    /** Injectable fetch for testing. Defaults to global fetch. */
+    fetchImpl?: FetchImpl;
+    /** Timeout in milliseconds. */
+    timeoutMs?: number;
+}
+/**
+ * Quick liveness probe. Returns true if Ollama answers /api/tags with 200.
+ * Never throws — a down server simply returns false.
+ */
+export declare function isOllamaReachable(host: string, opts?: OllamaCallOptions): Promise<boolean>;
+/**
+ * List the models pulled into Ollama (via GET /api/tags).
+ * Throws OllamaError if the server is unreachable or the response is bad.
+ */
+export declare function listModels(host: string, opts?: OllamaCallOptions): Promise<string[]>;
+/**
+ * Generate a completion via POST /api/chat (non-streaming).
+ * Returns the assistant message content.
+ *
+ * Throws OllamaError on timeout, connection failure, non-2xx status,
+ * or unparseable response.
+ */
+export declare function generate(host: string, model: string, prompt: string, opts?: OllamaCallOptions): Promise<string>;
+export {};