@manishbht/helpcode 0.2.2

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

@@ -0,0 +1,26 @@
+/**
+ * Project detection. Sniffs the working directory to make reasonable
+ * assumptions about language, framework, and test command.
+ *
+ * The detected config is written to .helpcode/project.json by `init`.
+ * The user can edit it; helpcode never re-detects after init unless asked.
+ */
+import { ProjectConfig } from '../types.js';
+export declare function detectLanguage(root: string): ProjectConfig['language'];
+export declare function detectFramework(root: string): string | null;
+export declare function detectTestCommand(root: string, language: ProjectConfig['language']): string | null;
+/**
+ * Detect source directories by finding top-level dirs that actually contain
+ * source files (directly or shallowly nested), rather than matching a fixed
+ * list of names. This means non-standard layouts — Django apps like `shop/`
+ * or `billing/`, a `core/` package, etc. — are picked up automatically.
+ *
+ * Strategy: scan immediate children of root. A child dir is a source dir if
+ * it (or its shallow descendants) contains at least one source file. Also
+ * include root itself if it has source files directly. Falls back to ['.'].
+ */
+export declare function detectSourceDirs(root: string): string[];
+export declare function buildDetectedConfig(root: string): ProjectConfig;
+export declare function loadProjectConfig(cwd?: string): ProjectConfig;
+export declare function saveProjectConfig(cfg: ProjectConfig, cwd?: string): void;
+export declare function projectExists(cwd?: string): boolean;

package/dist/src/core/project.js

@@ -0,0 +1,199 @@
+/**
+ * Project detection. Sniffs the working directory to make reasonable
+ * assumptions about language, framework, and test command.
+ *
+ * The detected config is written to .helpcode/project.json by `init`.
+ * The user can edit it; helpcode never re-detects after init unless asked.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { HelpcodeError, ErrorCode } from '../lib/errors.js';
+const STATE_DIR = '.helpcode';
+const PROJECT_FILE = path.join(STATE_DIR, 'project.json');
+function readBlob(root, files) {
+    let blob = '';
+    for (const f of files) {
+        const p = path.join(root, f);
+        if (fs.existsSync(p)) {
+            try {
+                blob += fs.readFileSync(p, 'utf-8').toLowerCase() + '\n';
+            }
+            catch {
+                // ignore unreadable files
+            }
+        }
+    }
+    return blob;
+}
+export function detectLanguage(root) {
+    if (fs.existsSync(path.join(root, 'pyproject.toml')) ||
+        fs.existsSync(path.join(root, 'requirements.txt')) ||
+        fs.existsSync(path.join(root, 'setup.py')) ||
+        fs.existsSync(path.join(root, 'Pipfile'))) {
+        return 'python';
+    }
+    if (fs.existsSync(path.join(root, 'tsconfig.json'))) {
+        return 'typescript';
+    }
+    if (fs.existsSync(path.join(root, 'package.json'))) {
+        return 'javascript';
+    }
+    return 'unknown';
+}
+export function detectFramework(root) {
+    const blob = readBlob(root, ['requirements.txt', 'pyproject.toml', 'package.json', 'Pipfile']);
+    if (fs.existsSync(path.join(root, 'manage.py')) || blob.includes('django')) {
+        return 'Django';
+    }
+    if (blob.includes('"fastapi"') || blob.includes('fastapi==') || blob.includes('fastapi>=')) {
+        return 'FastAPI';
+    }
+    if (blob.includes('"flask"') || blob.includes('flask==') || blob.includes('flask>=')) {
+        return 'Flask';
+    }
+    if (blob.includes('"next"'))
+        return 'Next.js';
+    if (blob.includes('"express"'))
+        return 'Express';
+    if (blob.includes('"react"'))
+        return 'React';
+    if (blob.includes('"vue"'))
+        return 'Vue';
+    return null;
+}
+export function detectTestCommand(root, language) {
+    if (language === 'python') {
+        if (fs.existsSync(path.join(root, 'manage.py'))) {
+            return 'python manage.py test --verbosity=1';
+        }
+        // pytest is the default for everything else Python
+        return 'pytest -q --tb=short';
+    }
+    if (language === 'javascript' || language === 'typescript') {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8'));
+            if (pkg.scripts && typeof pkg.scripts.test === 'string') {
+                return 'npm test';
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    return null;
+}
+/** Directory names we never treat as source dirs. */
+const NON_SOURCE_DIRS = new Set([
+    '.git', '.venv', 'venv', 'env', 'node_modules', '__pycache__',
+    '.pytest_cache', '.mypy_cache', 'dist', 'build', '.next', '.idea',
+    '.vscode', '.helpcode', 'coverage', '.cache', 'site-packages',
+    'migrations', '.tox', 'htmlcov', '__snapshots__',
+]);
+const SOURCE_FILE_EXTS = new Set([
+    '.py', '.js', '.ts', '.jsx', '.tsx', '.go', '.rs', '.rb', '.java',
+]);
+/**
+ * Detect source directories by finding top-level dirs that actually contain
+ * source files (directly or shallowly nested), rather than matching a fixed
+ * list of names. This means non-standard layouts — Django apps like `shop/`
+ * or `billing/`, a `core/` package, etc. — are picked up automatically.
+ *
+ * Strategy: scan immediate children of root. A child dir is a source dir if
+ * it (or its shallow descendants) contains at least one source file. Also
+ * include root itself if it has source files directly. Falls back to ['.'].
+ */
+export function detectSourceDirs(root) {
+    const found = [];
+    let entries;
+    try {
+        entries = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return ['.'];
+    }
+    let rootHasSource = false;
+    for (const entry of entries) {
+        if (entry.isFile() && SOURCE_FILE_EXTS.has(path.extname(entry.name))) {
+            rootHasSource = true;
+        }
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (NON_SOURCE_DIRS.has(entry.name) || entry.name.startsWith('.'))
+            continue;
+        if (dirContainsSource(path.join(root, entry.name), 2)) {
+            found.push(entry.name);
+        }
+    }
+    if (rootHasSource)
+        found.unshift('.');
+    return found.length > 0 ? found : ['.'];
+}
+/** Does this dir contain a source file within `maxDepth` levels? */
+function dirContainsSource(dir, maxDepth) {
+    if (maxDepth < 0)
+        return false;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        if (entry.isFile() && SOURCE_FILE_EXTS.has(path.extname(entry.name))) {
+            return true;
+        }
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory()
+            && !NON_SOURCE_DIRS.has(entry.name)
+            && !entry.name.startsWith('.')) {
+            if (dirContainsSource(path.join(dir, entry.name), maxDepth - 1))
+                return true;
+        }
+    }
+    return false;
+}
+export function buildDetectedConfig(root) {
+    const language = detectLanguage(root);
+    return {
+        root,
+        language,
+        framework: detectFramework(root),
+        testCommand: detectTestCommand(root, language),
+        sourceDirs: detectSourceDirs(root),
+        createdAt: new Date().toISOString(),
+        // Default: disabled. `init` upgrades this to enabled with a detected
+        // model if Ollama is reachable. Users can flip `enabled` any time.
+        ollama: {
+            enabled: false,
+            model: 'qwen2.5-coder:7b',
+            host: 'http://localhost:11434',
+            timeoutMs: 20000,
+        },
+    };
+}
+export function loadProjectConfig(cwd = process.cwd()) {
+    const file = path.join(cwd, PROJECT_FILE);
+    if (!fs.existsSync(file)) {
+        throw new HelpcodeError(ErrorCode.STATE_ERROR, `No ${PROJECT_FILE} found in ${cwd}.`, 'Run `helpcode init` first to set up the project.');
+    }
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch (e) {
+        throw new HelpcodeError(ErrorCode.STATE_ERROR, `Could not parse ${PROJECT_FILE}: ${e.message}`, 'The file may be corrupt. Run `helpcode init --force` to regenerate.');
+    }
+}
+export function saveProjectConfig(cfg, cwd = process.cwd()) {
+    const dir = path.join(cwd, STATE_DIR);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(cwd, PROJECT_FILE), JSON.stringify(cfg, null, 2), 'utf-8');
+}
+export function projectExists(cwd = process.cwd()) {
+    return fs.existsSync(path.join(cwd, PROJECT_FILE));
+}
+//# sourceMappingURL=project.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Build a structured prompt for Claude.ai.
+ *
+ * The prompt always includes the response protocol at the bottom, so Claude
+ * sees how to format its reply on every turn (pattern training by repetition).
+ */
+import { ProjectConfig } from '../types.js';
+export interface PromptInput {
+    taskDescription: string;
+    selectedFiles: string[];
+    lastTestOutput: string | null;
+    config: ProjectConfig;
+}
+export declare function buildPrompt(input: PromptInput): string;
+/**
+ * Instructions appended to every prompt. This is the load-bearing protocol
+ * that makes parsing Claude's reply reliable.
+ */
+export declare const RESPONSE_PROTOCOL = "## Please respond in this format\n\n```\n## PLAN\nOne to three sentences describing what you'll change and why.\n\n## DIFF: path/to/file.py\n```diff\n--- a/path/to/file.py\n+++ b/path/to/file.py\n@@ -10,3 +10,3 @@\n- old line\n+ new line\n```\n\n(repeat ## DIFF: blocks as needed, one per file)\n\n## TEST\n```bash\nthe single command I should run to verify this works\n```\n\n## NOTES\n(optional) anything else worth noting \u2014 caveats, alternatives, questions.\n```\n\nRules:\n- Use unified diff format inside each `## DIFF:` block.\n- Use real context lines (with a leading space) so the diff anchors correctly.\n- Keep each diff scoped to the file named in its header.\n- Don't include explanations between sections \u2014 put commentary in `## NOTES`.";

package/dist/src/core/prompt.js

@@ -0,0 +1,121 @@
+/**
+ * Build a structured prompt for Claude.ai.
+ *
+ * The prompt always includes the response protocol at the bottom, so Claude
+ * sees how to format its reply on every turn (pattern training by repetition).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { getLastCommitSummary, getUncommittedFileCount } from '../lib/git.js';
+import { truncateLines } from '../lib/compress.js';
+const MAX_FILE_LINES = 150;
+export function buildPrompt(input) {
+    const parts = [];
+    parts.push('## Project context');
+    parts.push(`- Language: ${input.config.language}`);
+    if (input.config.framework) {
+        parts.push(`- Framework: ${input.config.framework}`);
+    }
+    if (input.config.testCommand) {
+        parts.push(`- Test command: \`${input.config.testCommand}\``);
+    }
+    const commit = getLastCommitSummary(input.config.root);
+    if (commit)
+        parts.push(`- Last commit: ${commit}`);
+    const uncommitted = getUncommittedFileCount(input.config.root);
+    if (uncommitted > 0)
+        parts.push(`- Uncommitted changes: ${uncommitted} file(s)`);
+    if (input.lastTestOutput && input.lastTestOutput.trim()) {
+        parts.push('');
+        parts.push('## Last test output');
+        parts.push('```');
+        parts.push(truncateLines(input.lastTestOutput, 30, 'lines'));
+        parts.push('```');
+    }
+    if (input.selectedFiles.length > 0) {
+        parts.push('');
+        parts.push(`## Files (${input.selectedFiles.length})`);
+        for (const f of input.selectedFiles) {
+            const rel = path.relative(input.config.root, f);
+            let body;
+            try {
+                const text = fs.readFileSync(f, 'utf-8');
+                const lines = text.split(/\r?\n/);
+                body = lines.length > MAX_FILE_LINES
+                    ? lines.slice(0, MAX_FILE_LINES).join('\n') +
+                        `\n# ... [${lines.length - MAX_FILE_LINES} more lines truncated] ...`
+                    : text;
+            }
+            catch {
+                body = '(could not read file)';
+            }
+            const fence = fenceForFile(f);
+            parts.push('');
+            parts.push(`### \`${rel}\``);
+            parts.push('```' + fence);
+            parts.push(body);
+            parts.push('```');
+        }
+    }
+    parts.push('');
+    parts.push('## My task');
+    parts.push(input.taskDescription);
+    parts.push('');
+    parts.push(RESPONSE_PROTOCOL);
+    return parts.join('\n');
+}
+function fenceForFile(filepath) {
+    const ext = path.extname(filepath);
+    const map = {
+        '.py': 'python',
+        '.js': 'javascript',
+        '.ts': 'typescript',
+        '.jsx': 'jsx',
+        '.tsx': 'tsx',
+        '.sh': 'bash',
+        '.rb': 'ruby',
+        '.go': 'go',
+        '.java': 'java',
+        '.rs': 'rust',
+        '.json': 'json',
+        '.yml': 'yaml',
+        '.yaml': 'yaml',
+    };
+    return map[ext] ?? '';
+}
+/**
+ * Instructions appended to every prompt. This is the load-bearing protocol
+ * that makes parsing Claude's reply reliable.
+ */
+export const RESPONSE_PROTOCOL = `## Please respond in this format
+
+\`\`\`
+## PLAN
+One to three sentences describing what you'll change and why.
+
+## DIFF: path/to/file.py
+\`\`\`diff
+--- a/path/to/file.py
++++ b/path/to/file.py
+@@ -10,3 +10,3 @@
+- old line
++ new line
+\`\`\`
+
+(repeat ## DIFF: blocks as needed, one per file)
+
+## TEST
+\`\`\`bash
+the single command I should run to verify this works
+\`\`\`
+
+## NOTES
+(optional) anything else worth noting — caveats, alternatives, questions.
+\`\`\`
+
+Rules:
+- Use unified diff format inside each \`## DIFF:\` block.
+- Use real context lines (with a leading space) so the diff anchors correctly.
+- Keep each diff scoped to the file named in its header.
+- Don't include explanations between sections — put commentary in \`## NOTES\`.`;
+//# sourceMappingURL=prompt.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * File selection — pick the files most likely relevant to a task.
+ *
+ * Two strategies:
+ *   - heuristic (v0.1): filename match + content keyword + recency. Always
+ *     available, synchronous, no dependencies.
+ *   - llm (v0.2): a local model reasons about which files matter. Used only
+ *     when Ollama is enabled in project.json AND reachable. Falls back to
+ *     the heuristic on ANY failure.
+ *
+ * `selectFilesWithStrategy` is the entry point the `ask` command uses. The
+ * old synchronous `selectFiles` (heuristic) is preserved as the fallback and
+ * for callers that want the heuristic explicitly.
+ */
+import { ProjectConfig } from '../types.js';
+/** How a file was chosen. `reason` is populated for the LLM strategy. */
+export interface SelectedFile {
+    /** Absolute path. */
+    filepath: string;
+    /** Why it was chosen (LLM reasoning, or a short heuristic note). */
+    reason: string;
+}
+export interface SelectionResult {
+    files: SelectedFile[];
+    /** Which strategy actually produced the result. */
+    strategy: 'llm' | 'heuristic';
+    /** If the LLM was attempted but fell back, why. Empty otherwise. */
+    fallbackReason: string;
+}
+/**
+ * The entry point used by `ask`. Chooses the LLM strategy when configured and
+ * reachable, otherwise the heuristic. Never throws — any LLM failure degrades
+ * to the heuristic with a recorded reason.
+ */
+export declare function selectFilesWithStrategy(taskDescription: string, config: ProjectConfig, opts?: {
+    forceHeuristic?: boolean;
+}): Promise<SelectionResult>;
+/** Walk every source file under the configured source dirs (uncapped). */
+export declare function walkAllSourceFiles(config: ProjectConfig): string[];
+/**
+ * Walk source dirs, scoring each candidate file against the task description.
+ * Returns up to MAX_RESULTS files sorted by descending score. (Heuristic.)
+ */
+export declare function selectFiles(taskDescription: string, config: ProjectConfig): string[];
+/** Score a single file against task keywords. Higher is better. */
+export declare function scoreFile(filepath: string, keywords: string[]): number;

package/dist/src/core/selector.js

@@ -0,0 +1,193 @@
+/**
+ * File selection — pick the files most likely relevant to a task.
+ *
+ * Two strategies:
+ *   - heuristic (v0.1): filename match + content keyword + recency. Always
+ *     available, synchronous, no dependencies.
+ *   - llm (v0.2): a local model reasons about which files matter. Used only
+ *     when Ollama is enabled in project.json AND reachable. Falls back to
+ *     the heuristic on ANY failure.
+ *
+ * `selectFilesWithStrategy` is the entry point the `ask` command uses. The
+ * old synchronous `selectFiles` (heuristic) is preserved as the fallback and
+ * for callers that want the heuristic explicitly.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { isOllamaReachable, OllamaError } from './ollama.js';
+import { llmSelectFiles } from './llmSelector.js';
+const IGNORE_DIRS = new Set([
+    '.git', '.venv', 'venv', 'env', 'node_modules', '__pycache__',
+    '.pytest_cache', '.mypy_cache', 'dist', 'build', '.next',
+    '.idea', '.vscode', '.helpcode', 'coverage', '.cache',
+]);
+const SOURCE_EXTS = new Set([
+    '.py', '.js', '.ts', '.jsx', '.tsx', '.sh', '.rb', '.go',
+    '.java', '.rs', '.c', '.cpp', '.h', '.hpp',
+]);
+const MAX_RESULTS = 6;
+const RECENCY_WINDOW_DAYS = 14;
+const LLM_CANDIDATE_CAP = 60; // cap files sent to the model (design §3.1)
+/**
+ * The entry point used by `ask`. Chooses the LLM strategy when configured and
+ * reachable, otherwise the heuristic. Never throws — any LLM failure degrades
+ * to the heuristic with a recorded reason.
+ */
+export async function selectFilesWithStrategy(taskDescription, config, opts = {}) {
+    const ollama = config.ollama;
+    const wantLlm = !opts.forceHeuristic && ollama?.enabled === true;
+    if (wantLlm && ollama) {
+        const reachable = await isOllamaReachable(ollama.host, { timeoutMs: 1000 });
+        if (!reachable) {
+            return heuristicResult(taskDescription, config, 'Ollama not reachable');
+        }
+        try {
+            const allFiles = walkAllSourceFiles(config).slice(0, LLM_CANDIDATE_CAP);
+            const selections = await llmSelectFiles(taskDescription, allFiles, config.root, {
+                host: ollama.host,
+                model: ollama.model,
+                count: MAX_RESULTS,
+                timeoutMs: ollama.timeoutMs,
+            });
+            if (selections.length === 0) {
+                return heuristicResult(taskDescription, config, 'model returned no usable files');
+            }
+            // Map relative paths back to absolute for the caller
+            const files = selections.map(s => ({
+                filepath: path.join(config.root, s.path),
+                reason: s.reason,
+            }));
+            return { files, strategy: 'llm', fallbackReason: '' };
+        }
+        catch (e) {
+            const why = e instanceof OllamaError ? e.message : e.message;
+            return heuristicResult(taskDescription, config, why);
+        }
+    }
+    return heuristicResult(taskDescription, config, '');
+}
+function heuristicResult(taskDescription, config, fallbackReason) {
+    const files = selectFiles(taskDescription, config).map(filepath => ({
+        filepath,
+        reason: 'matched keywords / recently modified',
+    }));
+    return { files, strategy: 'heuristic', fallbackReason };
+}
+/** Walk every source file under the configured source dirs (uncapped). */
+export function walkAllSourceFiles(config) {
+    const out = [];
+    for (const dir of config.sourceDirs) {
+        const start = dir === '.' ? config.root : path.join(config.root, dir);
+        if (!fs.existsSync(start))
+            continue;
+        walk(start, f => out.push(f));
+    }
+    return out;
+}
+/**
+ * Walk source dirs, scoring each candidate file against the task description.
+ * Returns up to MAX_RESULTS files sorted by descending score. (Heuristic.)
+ */
+export function selectFiles(taskDescription, config) {
+    const keywords = extractKeywords(taskDescription);
+    const candidates = [];
+    for (const dir of config.sourceDirs) {
+        const start = path.join(config.root, dir);
+        if (!fs.existsSync(start))
+            continue;
+        walk(start, file => {
+            const score = scoreFile(file, keywords);
+            if (score > 0)
+                candidates.push({ filepath: file, score });
+        });
+    }
+    candidates.sort((a, b) => b.score - a.score);
+    return candidates.slice(0, MAX_RESULTS).map(c => c.filepath);
+}
+/** Score a single file against task keywords. Higher is better. */
+export function scoreFile(filepath, keywords) {
+    let score = 0;
+    let content = '';
+    try {
+        content = fs.readFileSync(filepath, 'utf-8');
+    }
+    catch {
+        // unreadable; rely on filename match only below
+    }
+    // Skip empty or near-empty files entirely. They add noise to briefs
+    // without contributing useful context (think: empty __init__.py).
+    if (content.trim().length < 10) {
+        return 0;
+    }
+    const base = path.basename(filepath).toLowerCase();
+    for (const kw of keywords) {
+        if (base.includes(kw))
+            score += 10;
+    }
+    const lowerContent = content.toLowerCase();
+    for (const kw of keywords) {
+        const matches = countOccurrences(lowerContent, kw);
+        if (matches > 0)
+            score += Math.min(matches, 5); // diminishing returns
+    }
+    // Recency bonus
+    try {
+        const ageDays = (Date.now() - fs.statSync(filepath).mtimeMs) / (1000 * 60 * 60 * 24);
+        if (ageDays <= RECENCY_WINDOW_DAYS)
+            score += 3;
+    }
+    catch {
+        // ignore
+    }
+    return score;
+}
+function extractKeywords(text) {
+    // Lowercase, strip punctuation, drop stopwords and very short words
+    const stopwords = new Set([
+        'the', 'a', 'an', 'and', 'or', 'but', 'is', 'are', 'was', 'were',
+        'to', 'of', 'in', 'on', 'at', 'for', 'with', 'by', 'from', 'as',
+        'how', 'why', 'what', 'when', 'where', 'do', 'does', 'did', 'i',
+        'my', 'me', 'we', 'our', 'this', 'that', 'these', 'those', 'it',
+        'be', 'been', 'have', 'has', 'had', 'can', 'should', 'would',
+        'fix', 'add', 'make', 'change',
+    ]);
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter(w => w.length > 2 && !stopwords.has(w));
+}
+function countOccurrences(haystack, needle) {
+    if (!needle)
+        return 0;
+    let count = 0;
+    let idx = 0;
+    while ((idx = haystack.indexOf(needle, idx)) !== -1) {
+        count++;
+        idx += needle.length;
+    }
+    return count;
+}
+function walk(dir, callback) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (IGNORE_DIRS.has(entry.name) || entry.name.startsWith('.'))
+                continue;
+            walk(full, callback);
+        }
+        else if (entry.isFile()) {
+            if (SOURCE_EXTS.has(path.extname(entry.name))) {
+                callback(full);
+            }
+        }
+    }
+}
+//# sourceMappingURL=selector.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Persistent agent state. Stored at .helpcode/state.json.
+ *
+ * State is intentionally readable JSON. Users can `cat` it to see exactly
+ * what helpcode is thinking. No black-box memory.
+ */
+import { AgentState, CurrentTask } from '../types.js';
+export declare function loadState(cwd?: string): AgentState;
+export declare function saveState(state: AgentState, cwd?: string): void;
+export declare function createTask(description: string): CurrentTask;
+export declare function resetState(cwd?: string): void;