@sunilp-org/jam-cli 0.1.0 → 0.1.2

package/dist/utils/cache.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tool result cache — avoids redundant file reads and searches within a session.
+ *
+ * Keyed by (toolName, JSON.stringify(args)).  File reads are invalidated
+ * if a write_file or apply_patch call modifies the same path.
+ */
+export declare class ToolResultCache {
+    private cache;
+    /** TTL in ms — stale results are evicted (default: 5 minutes). */
+    private ttl;
+    constructor(ttlMs?: number);
+    private key;
+    /**
+     * Get a cached result.  Returns `null` if not found or expired.
+     */
+    get(name: string, args: Record<string, unknown>): string | null;
+    /**
+     * Store a tool result.
+     */
+    set(name: string, args: Record<string, unknown>, output: string): void;
+    /**
+     * Invalidate cached reads for a file path (called after write/patch operations).
+     */
+    invalidatePath(filePath: string): void;
+    /** Number of cached entries. */
+    get size(): number;
+    /** Clear all cached results. */
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA4D;IAEzE,kEAAkE;IAClE,OAAO,CAAC,GAAG,CAAS;gBAER,KAAK,GAAE,MAAsB;IAIzC,OAAO,CAAC,GAAG;IAIX;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAW/D;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKtE;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAatC,gCAAgC;IAChC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,gCAAgC;IAChC,KAAK,IAAI,IAAI;CAGd"}

package/dist/utils/cache.js

@@ -0,0 +1,62 @@
+/**
+ * Tool result cache — avoids redundant file reads and searches within a session.
+ *
+ * Keyed by (toolName, JSON.stringify(args)).  File reads are invalidated
+ * if a write_file or apply_patch call modifies the same path.
+ */
+export class ToolResultCache {
+    cache = new Map();
+    /** TTL in ms — stale results are evicted (default: 5 minutes). */
+    ttl;
+    constructor(ttlMs = 5 * 60 * 1000) {
+        this.ttl = ttlMs;
+    }
+    key(name, args) {
+        return `${name}:${JSON.stringify(args, Object.keys(args).sort())}`;
+    }
+    /**
+     * Get a cached result.  Returns `null` if not found or expired.
+     */
+    get(name, args) {
+        const k = this.key(name, args);
+        const entry = this.cache.get(k);
+        if (!entry)
+            return null;
+        if (Date.now() - entry.timestamp > this.ttl) {
+            this.cache.delete(k);
+            return null;
+        }
+        return entry.output;
+    }
+    /**
+     * Store a tool result.
+     */
+    set(name, args, output) {
+        const k = this.key(name, args);
+        this.cache.set(k, { output, timestamp: Date.now() });
+    }
+    /**
+     * Invalidate cached reads for a file path (called after write/patch operations).
+     */
+    invalidatePath(filePath) {
+        for (const [k] of this.cache) {
+            // Invalidate any read_file cache entries that match this path
+            if (k.startsWith('read_file:') && k.includes(filePath)) {
+                this.cache.delete(k);
+            }
+            // Also invalidate search_text since file contents changed
+            if (k.startsWith('search_text:')) {
+                this.cache.delete(k);
+            }
+        }
+    }
+    /** Number of cached entries. */
+    get size() {
+        return this.cache.size;
+    }
+    /** Clear all cached results. */
+    clear() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,eAAe;IAClB,KAAK,GAAG,IAAI,GAAG,EAAiD,CAAC;IAEzE,kEAAkE;IAC1D,GAAG,CAAS;IAEpB,YAAY,QAAgB,CAAC,GAAG,EAAE,GAAG,IAAI;QACvC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC;IACnB,CAAC;IAEO,GAAG,CAAC,IAAY,EAAE,IAA6B;QACrD,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,IAA6B;QAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,IAA6B,EAAE,MAAc;QAC7D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB;QAC7B,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,8DAA8D;YAC9D,IAAI,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;YACD,0DAA0D;YAC1D,IAAI,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,gCAAgC;IAChC,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/utils/context.d.ts

@@ -0,0 +1,38 @@
+/**
+ * JAM.md — persistent project context file.
+ *
+ * Automatically discovers project details (language, structure, dependencies,
+ * patterns) and writes a `JAM.md` at the workspace root.  This file is read
+ * by `jam ask` / `jam chat` and injected into the system prompt so the model
+ * starts every conversation with a deep understanding of the project.
+ *
+ * Users can (and should) edit JAM.md to add domain-specific notes, coding
+ * conventions, architectural decisions, etc.
+ */
+export declare const CONTEXT_FILENAME = "JAM.md";
+/**
+ * Load `JAM.md` from the workspace root.  Returns `null` if not found.
+ */
+export declare function loadContextFile(workspaceRoot: string): Promise<string | null>;
+/**
+ * Generate JAM.md content by auto-discovering the project.
+ */
+export declare function generateContextContent(workspaceRoot: string): Promise<string>;
+/**
+ * Write JAM.md to the workspace root. Returns the path written.
+ */
+export declare function writeContextFile(workspaceRoot: string, content: string): Promise<string>;
+/**
+ * Check if JAM.md already exists.
+ */
+export declare function contextFileExists(workspaceRoot: string): Promise<boolean>;
+/**
+ * Update JAM.md with frequently accessed file patterns from the session.
+ * Appends or replaces a "Frequently Accessed Files" section.
+ *
+ * @param workspaceRoot  Workspace root path
+ * @param readFiles      Array of file paths accessed during sessions
+ * @param searchQueries  Array of search queries used during sessions
+ */
+export declare function updateContextWithUsage(workspaceRoot: string, readFiles: string[], searchQueries: string[]): Promise<void>;
+//# sourceMappingURL=context.d.ts.map

package/dist/utils/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAIzC;;GAEG;AACH,wBAAsB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOnF;AAgMD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgGnF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/E;AAOD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Df"}

package/dist/utils/context.js

@@ -0,0 +1,383 @@
+/**
+ * JAM.md — persistent project context file.
+ *
+ * Automatically discovers project details (language, structure, dependencies,
+ * patterns) and writes a `JAM.md` at the workspace root.  This file is read
+ * by `jam ask` / `jam chat` and injected into the system prompt so the model
+ * starts every conversation with a deep understanding of the project.
+ *
+ * Users can (and should) edit JAM.md to add domain-specific notes, coding
+ * conventions, architectural decisions, etc.
+ */
+import { readFile, writeFile, readdir, access, constants } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+export const CONTEXT_FILENAME = 'JAM.md';
+// ── Read existing JAM.md ──────────────────────────────────────────────────────
+/**
+ * Load `JAM.md` from the workspace root.  Returns `null` if not found.
+ */
+export async function loadContextFile(workspaceRoot) {
+    const contextPath = join(workspaceRoot, CONTEXT_FILENAME);
+    try {
+        return await readFile(contextPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Recursively build a directory tree string (max depth). */
+async function buildTree(dir, prefix, depth, maxDepth) {
+    if (depth > maxDepth)
+        return '';
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return '';
+    }
+    // Filter out noise
+    const filtered = entries
+        .filter((e) => {
+        const name = String(e.name);
+        if (name.startsWith('.'))
+            return false;
+        if (['node_modules', 'dist', 'build', 'coverage', '__pycache__', '.next', '.nuxt', 'target', 'out'].includes(name))
+            return false;
+        return true;
+    })
+        .sort((a, b) => {
+        // Dirs first, then files
+        if (a.isDirectory() && !b.isDirectory())
+            return -1;
+        if (!a.isDirectory() && b.isDirectory())
+            return 1;
+        return String(a.name).localeCompare(String(b.name));
+    });
+    const lines = [];
+    for (let i = 0; i < filtered.length; i++) {
+        const entry = filtered[i];
+        const name = String(entry.name);
+        const isLast = i === filtered.length - 1;
+        const connector = isLast ? '└── ' : '├── ';
+        const childPrefix = isLast ? '    ' : '│   ';
+        if (entry.isDirectory()) {
+            lines.push(`${prefix}${connector}${name}/`);
+            const subtree = await buildTree(join(dir, name), prefix + childPrefix, depth + 1, maxDepth);
+            if (subtree)
+                lines.push(subtree);
+        }
+        else {
+            lines.push(`${prefix}${connector}${name}`);
+        }
+    }
+    return lines.join('\n');
+}
+/** Detect language, framework, and other details from filesystem. */
+async function discoverProject(workspaceRoot) {
+    const info = {
+        name: basename(workspaceRoot),
+        language: 'unknown',
+        framework: 'none detected',
+        packageManager: 'unknown',
+        description: '',
+        entryPoint: '',
+        testFramework: '',
+        scripts: {},
+        dependencies: [],
+        devDependencies: [],
+        structure: '',
+    };
+    // ── package.json (Node / TS / JS) ──────────────────────────────────────────
+    try {
+        const pkgRaw = await readFile(join(workspaceRoot, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(pkgRaw);
+        info.name = pkg['name'] ?? info.name;
+        info.description = pkg['description'] ?? '';
+        info.entryPoint = pkg['main'] ?? (pkg['bin'] ? JSON.stringify(pkg['bin']) : '');
+        const scripts = pkg['scripts'];
+        if (scripts)
+            info.scripts = scripts;
+        const deps = pkg['dependencies'];
+        if (deps)
+            info.dependencies = Object.keys(deps);
+        const devDeps = pkg['devDependencies'];
+        if (devDeps)
+            info.devDependencies = Object.keys(devDeps);
+        // Detect package manager
+        const lockFiles = [
+            ['bun.lockb', 'bun'],
+            ['pnpm-lock.yaml', 'pnpm'],
+            ['yarn.lock', 'yarn'],
+            ['package-lock.json', 'npm'],
+        ];
+        for (const [file, mgr] of lockFiles) {
+            try {
+                await access(join(workspaceRoot, file), constants.F_OK);
+                info.packageManager = mgr;
+                break;
+            }
+            catch { /* skip */ }
+        }
+        // Detect frameworks from deps
+        const allDeps = [...info.dependencies, ...info.devDependencies];
+        if (allDeps.includes('commander') || allDeps.includes('yargs') || allDeps.includes('oclif'))
+            info.framework = 'CLI application';
+        else if (allDeps.includes('next'))
+            info.framework = 'Next.js';
+        else if (allDeps.includes('nuxt'))
+            info.framework = 'Nuxt';
+        else if (allDeps.includes('svelte'))
+            info.framework = 'Svelte';
+        else if (allDeps.includes('vue'))
+            info.framework = 'Vue';
+        else if (allDeps.includes('react'))
+            info.framework = 'React';
+        else if (allDeps.includes('express'))
+            info.framework = 'Express';
+        else if (allDeps.includes('fastify'))
+            info.framework = 'Fastify';
+        // Detect test framework
+        if (allDeps.includes('vitest'))
+            info.testFramework = 'Vitest';
+        else if (allDeps.includes('jest'))
+            info.testFramework = 'Jest';
+        else if (allDeps.includes('mocha'))
+            info.testFramework = 'Mocha';
+    }
+    catch { /* not a node project */ }
+    // ── Language detection ──────────────────────────────────────────────────────
+    try {
+        await access(join(workspaceRoot, 'tsconfig.json'), constants.F_OK);
+        info.language = 'TypeScript';
+    }
+    catch {
+        try {
+            await access(join(workspaceRoot, 'package.json'), constants.F_OK);
+            info.language = 'JavaScript';
+        }
+        catch { /* fallthrough */ }
+    }
+    // Python detection
+    if (info.language === 'unknown') {
+        for (const marker of ['pyproject.toml', 'setup.py', 'requirements.txt', 'Pipfile']) {
+            try {
+                await access(join(workspaceRoot, marker), constants.F_OK);
+                info.language = 'Python';
+                break;
+            }
+            catch { /* skip */ }
+        }
+    }
+    // Go
+    if (info.language === 'unknown') {
+        try {
+            await access(join(workspaceRoot, 'go.mod'), constants.F_OK);
+            info.language = 'Go';
+        }
+        catch { /* skip */ }
+    }
+    // Rust
+    if (info.language === 'unknown') {
+        try {
+            await access(join(workspaceRoot, 'Cargo.toml'), constants.F_OK);
+            info.language = 'Rust';
+        }
+        catch { /* skip */ }
+    }
+    // ── Build directory tree ───────────────────────────────────────────────────
+    info.structure = await buildTree(workspaceRoot, '', 0, 3);
+    return info;
+}
+/** File extension hint for the language. */
+function langFileHint(lang) {
+    switch (lang) {
+        case 'TypeScript': return '`.ts` / `.tsx`';
+        case 'JavaScript': return '`.js` / `.jsx`';
+        case 'Python': return '`.py`';
+        case 'Go': return '`.go`';
+        case 'Rust': return '`.rs`';
+        default: return '';
+    }
+}
+/**
+ * Generate JAM.md content by auto-discovering the project.
+ */
+export async function generateContextContent(workspaceRoot) {
+    const info = await discoverProject(workspaceRoot);
+    const sections = [];
+    // Header
+    sections.push(`# ${info.name}`);
+    sections.push('');
+    sections.push('> This file was auto-generated by `jam context init`.');
+    sections.push('> Edit it freely — Jam reads it on every `ask` / `chat` invocation.');
+    sections.push('');
+    // Overview
+    sections.push('## Overview');
+    sections.push('');
+    if (info.description)
+        sections.push(info.description);
+    sections.push('');
+    sections.push(`| Property | Value |`);
+    sections.push(`|----------|-------|`);
+    sections.push(`| Language | ${info.language} |`);
+    if (langFileHint(info.language)) {
+        sections.push(`| File extensions | ${langFileHint(info.language)} |`);
+    }
+    if (info.framework !== 'none detected') {
+        sections.push(`| Framework | ${info.framework} |`);
+    }
+    if (info.packageManager !== 'unknown') {
+        sections.push(`| Package manager | ${info.packageManager} |`);
+    }
+    if (info.entryPoint) {
+        sections.push(`| Entry point | \`${info.entryPoint}\` |`);
+    }
+    if (info.testFramework) {
+        sections.push(`| Test framework | ${info.testFramework} |`);
+    }
+    sections.push('');
+    // Scripts
+    if (Object.keys(info.scripts).length > 0) {
+        sections.push('## Scripts');
+        sections.push('');
+        sections.push('```bash');
+        for (const [name, cmd] of Object.entries(info.scripts)) {
+            sections.push(`${info.packageManager !== 'unknown' ? info.packageManager : 'npm'} run ${name}  # ${cmd}`);
+        }
+        sections.push('```');
+        sections.push('');
+    }
+    // Directory structure
+    if (info.structure) {
+        sections.push('## Directory Structure');
+        sections.push('');
+        sections.push('```');
+        sections.push(info.structure);
+        sections.push('```');
+        sections.push('');
+    }
+    // Key dependencies
+    if (info.dependencies.length > 0) {
+        sections.push('## Key Dependencies');
+        sections.push('');
+        for (const dep of info.dependencies) {
+            sections.push(`- \`${dep}\``);
+        }
+        sections.push('');
+    }
+    // Dev dependencies (abbreviated)
+    if (info.devDependencies.length > 0) {
+        sections.push('## Dev Dependencies');
+        sections.push('');
+        for (const dep of info.devDependencies) {
+            sections.push(`- \`${dep}\``);
+        }
+        sections.push('');
+    }
+    // User editable sections
+    sections.push('## Architecture Notes');
+    sections.push('');
+    sections.push('<!-- Add notes about the project architecture, key patterns, design decisions, etc. -->');
+    sections.push('');
+    sections.push('## Coding Conventions');
+    sections.push('');
+    sections.push('<!-- Add notes about coding style, naming conventions, import patterns, etc. -->');
+    sections.push('');
+    sections.push('## Important Context');
+    sections.push('');
+    sections.push('<!-- Add anything else Jam should know when answering questions about this project. -->');
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * Write JAM.md to the workspace root. Returns the path written.
+ */
+export async function writeContextFile(workspaceRoot, content) {
+    const contextPath = join(workspaceRoot, CONTEXT_FILENAME);
+    await writeFile(contextPath, content, 'utf-8');
+    return contextPath;
+}
+/**
+ * Check if JAM.md already exists.
+ */
+export async function contextFileExists(workspaceRoot) {
+    try {
+        await access(join(workspaceRoot, CONTEXT_FILENAME), constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Auto-update JAM.md with usage patterns (P2-7) ────────────────────────────
+const USAGE_SECTION_HEADER = '## Frequently Accessed Files';
+const USAGE_SECTION_MARKER = '<!-- jam-auto-usage -->';
+/**
+ * Update JAM.md with frequently accessed file patterns from the session.
+ * Appends or replaces a "Frequently Accessed Files" section.
+ *
+ * @param workspaceRoot  Workspace root path
+ * @param readFiles      Array of file paths accessed during sessions
+ * @param searchQueries  Array of search queries used during sessions
+ */
+export async function updateContextWithUsage(workspaceRoot, readFiles, searchQueries) {
+    const contextPath = join(workspaceRoot, CONTEXT_FILENAME);
+    let existing;
+    try {
+        existing = await readFile(contextPath, 'utf-8');
+    }
+    catch {
+        return; // No JAM.md — nothing to update
+    }
+    // Count file access frequency
+    const fileCounts = new Map();
+    for (const f of readFiles) {
+        fileCounts.set(f, (fileCounts.get(f) ?? 0) + 1);
+    }
+    // Sort by frequency
+    const topFiles = [...fileCounts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 15)
+        .map(([path, count]) => `- \`${path}\` (${count}x)`);
+    if (topFiles.length === 0)
+        return;
+    const usageSection = [
+        '',
+        USAGE_SECTION_HEADER,
+        '',
+        USAGE_SECTION_MARKER,
+        '',
+        '> Auto-updated by Jam based on your usage patterns. These are the files most frequently',
+        '> examined when answering questions. Jam will prioritize searching these locations.',
+        '',
+        ...topFiles,
+        '',
+        ...(searchQueries.length > 0 ? [
+            '### Common Search Patterns',
+            '',
+            ...searchQueries.slice(0, 10).map(q => `- \`${q}\``),
+            '',
+        ] : []),
+        USAGE_SECTION_MARKER,
+        '',
+    ].join('\n');
+    // Replace existing usage section or append
+    const markerStart = existing.indexOf(USAGE_SECTION_MARKER);
+    if (markerStart !== -1) {
+        const markerEnd = existing.indexOf(USAGE_SECTION_MARKER, markerStart + USAGE_SECTION_MARKER.length);
+        if (markerEnd !== -1) {
+            // Find the section header before first marker
+            const headerPos = existing.lastIndexOf(USAGE_SECTION_HEADER, markerStart);
+            const sectionStart = headerPos !== -1 ? headerPos : markerStart;
+            const sectionEnd = markerEnd + USAGE_SECTION_MARKER.length;
+            const updated = existing.slice(0, sectionStart) + usageSection + existing.slice(sectionEnd);
+            await writeFile(contextPath, updated, 'utf-8');
+            return;
+        }
+    }
+    // Append to end
+    const updated = existing.trimEnd() + '\n' + usageSection;
+    await writeFile(contextPath, updated, 'utf-8');
+}
+//# sourceMappingURL=context.js.map

package/dist/utils/context.js.map

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

package/dist/utils/critic.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Critic agent — evaluates the main agent's answer for quality and relevance.
+ *
+ * Replaces the naive keyword-matching `checkAnswerRelevance` with a real
+ * LLM-based evaluation.  The critic runs as a separate, cheap LLM call
+ * with a focused system prompt.
+ */
+import type { ProviderAdapter } from '../providers/base.js';
+export interface CriticVerdict {
+    /** Whether the answer passes quality checks. */
+    pass: boolean;
+    /** Brief reason if it fails. */
+    reason: string;
+    /** Confidence 0-1 (from the critic's self-assessment). */
+    confidence: number;
+}
+/**
+ * Run the critic agent to evaluate an answer.
+ *
+ * Uses a low temperature and short max tokens for fast, focused evaluation.
+ * Falls back to PASS if the critic call fails (non-blocking).
+ */
+export declare function criticEvaluate(provider: ProviderAdapter, question: string, answer: string, options?: {
+    model?: string;
+}): Promise<CriticVerdict>;
+/**
+ * Build a correction message from the critic's feedback.
+ * More specific than the generic buildCorrectionMessage.
+ */
+export declare function buildCriticCorrection(verdict: CriticVerdict, originalQuestion: string): string;
+//# sourceMappingURL=critic.d.ts.map

package/dist/utils/critic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critic.d.ts","sourceRoot":"","sources":["../../src/utils/critic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAiCD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAiCD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAgB9F"}