fixo-cli 1.0.0

package/dist/lsp/syntax-fallback.js

@@ -0,0 +1,275 @@
+/**
+ * syntax-fallback.ts — Pure-JS brace/paren/bracket balance check
+ * used as a fallback when no real language server is on the PATH.
+ *
+ * Why this exists
+ * ---------------
+ * The LspPreSaveGate calls into `LspManager` to ask the local
+ * language server for diagnostics. On a freshly-installed system
+ * there is no `tsserver` / `gopls` / `rust-analyzer` on the PATH —
+ * the user has a working FixO CLI but no editor infrastructure.
+ * In that case the pre-save gate would silently fall through and
+ * commit syntactically broken edits.
+ *
+ * This module provides a *very* cheap structural sanity check
+ * (brace/paren/bracket/quote balance) that runs in microseconds
+ * and catches the most common form of "LLM forgot a closing
+ * brace" corruption. It is intentionally not a real parser — it
+ * is a smoke detector, not a smoke alarm. If the syntax check
+ * reports `ok`, the real LSP may still surface semantic errors;
+ * if it reports `unbalanced`, the file is almost certainly
+ * broken and we should refuse the write.
+ *
+ * The check is env-gated behind `FIXO_LSP_FALLBACK=syntax-only`
+ * so a developer who *does* have a language server is never
+ * bothered by it.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Run the structural sanity check on a source string. Pure,
+ * sync, and allocation-light. The output is stable so tests can
+ * pin the verdict exactly.
+ */
+export function syntaxHealthCheck(source) {
+    const stack = [];
+    const lineStarts = [0];
+    for (let i = 0; i < source.length; i++) {
+        if (source.charCodeAt(i) === 10)
+            lineStarts.push(i + 1);
+    }
+    let inSingle = false;
+    let inDouble = false;
+    let inTemplate = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    let blockCommentStartLine = 1;
+    let singleStartLine = 0;
+    let doubleStartLine = 0;
+    let templateStartLine = 0;
+    let prevCh = '';
+    for (let i = 0; i < source.length; i++) {
+        const ch = source[i];
+        const code = source.charCodeAt(i);
+        const nextCh = i + 1 < source.length ? source[i + 1] : '';
+        const line = lineNumberAt(lineStarts, i);
+        if (inLineComment) {
+            if (code === 10)
+                inLineComment = false;
+            prevCh = ch;
+            continue;
+        }
+        if (inBlockComment) {
+            if (prevCh === '*' && ch === '/') {
+                inBlockComment = false;
+            }
+            prevCh = ch;
+            continue;
+        }
+        if (inSingle) {
+            if (ch === '\\') {
+                // Skip the next char. (No need to handle surrogate pairs
+                // separately — `\\u{1F600}` etc. still consume 2 source
+                // chars; the skip-i+1 below handles it.)
+                i++;
+                prevCh = '';
+                continue;
+            }
+            if (ch === "'" && prevCh !== '\\') {
+                inSingle = false;
+            }
+            else if (code === 10) {
+                return { state: 'unterminated-string', line: singleStartLine };
+            }
+            prevCh = ch;
+            continue;
+        }
+        if (inDouble) {
+            if (ch === '\\') {
+                i++;
+                prevCh = '';
+                continue;
+            }
+            if (ch === '"' && prevCh !== '\\') {
+                inDouble = false;
+            }
+            else if (code === 10) {
+                return { state: 'unterminated-string', line: doubleStartLine };
+            }
+            prevCh = ch;
+            continue;
+        }
+        if (inTemplate) {
+            if (ch === '\\') {
+                i++;
+                prevCh = '';
+                continue;
+            }
+            if (ch === '`') {
+                inTemplate = false;
+            }
+            else if (code === 10) {
+                return { state: 'unterminated-string', line: templateStartLine };
+            }
+            prevCh = ch;
+            continue;
+        }
+        // Not in any string/comment — check for new states.
+        if (ch === '/' && nextCh === '/') {
+            inLineComment = true;
+            prevCh = ch;
+            i++;
+            continue;
+        }
+        if (ch === '/' && nextCh === '*') {
+            inBlockComment = true;
+            blockCommentStartLine = line;
+            prevCh = ch;
+            i++;
+            continue;
+        }
+        if (ch === "'") {
+            inSingle = true;
+            singleStartLine = line;
+            prevCh = ch;
+            continue;
+        }
+        if (ch === '"') {
+            inDouble = true;
+            doubleStartLine = line;
+            prevCh = ch;
+            continue;
+        }
+        if (ch === '`') {
+            inTemplate = true;
+            templateStartLine = line;
+            prevCh = ch;
+            continue;
+        }
+        if (ch === '{' || ch === '(' || ch === '[') {
+            stack.push({ ch: ch, line });
+        }
+        else if (ch === '}' || ch === ')' || ch === ']') {
+            const expected = ch === '}' ? '{' : ch === ')' ? '(' : '[';
+            const top = stack.pop();
+            if (!top || top.ch !== expected) {
+                // The first missing closer tells us the first unclosed
+                // opener, which is what we report. If the stack is empty
+                // we still report a synthetic 'unbalanced' so the caller
+                // sees a verdict.
+                if (top) {
+                    return { state: 'unbalanced', opener: top.ch, line: top.line };
+                }
+                return { state: 'unbalanced', opener: expected, line };
+            }
+        }
+        prevCh = ch;
+    }
+    if (inBlockComment) {
+        return { state: 'unterminated-comment', line: blockCommentStartLine };
+    }
+    if (stack.length > 0) {
+        const top = stack[stack.length - 1];
+        return { state: 'unbalanced', opener: top.ch, line: top.line };
+    }
+    return { state: 'ok' };
+}
+function lineNumberAt(lineStarts, index) {
+    // Binary search would be O(log n) but a linear scan is fine for
+    // files up to ~10_000 lines, and the inlined version lets V8
+    // keep both arrays hot in the same cache line.
+    let line = 1;
+    for (let i = 0; i < lineStarts.length; i++) {
+        if (lineStarts[i] > index)
+            break;
+        line = i + 1;
+    }
+    return line;
+}
+/**
+ * Format a {@link SyntaxHealthVerdict} as a single-line summary
+ * suitable for the LLM's `tool_result`.
+ */
+export function formatSyntaxVerdict(verdict) {
+    switch (verdict.state) {
+        case 'ok':
+            return 'Syntax health check: OK (balanced).';
+        case 'unbalanced':
+            return `Syntax health check: unbalanced — '${verdict.opener}' opened on line ${verdict.line} has no matching closer.`;
+        case 'unterminated-string':
+            return `Syntax health check: unterminated string starting on line ${verdict.line}.`;
+        case 'unterminated-comment':
+            return `Syntax health check: unterminated block comment starting on line ${verdict.line}.`;
+    }
+}
+const COMMON_LANGUAGE_SERVERS = [
+    'typescript-language-server',
+    'tsserver',
+    'vscode-langservers-extracted',
+    'gopls',
+    'rust-analyzer',
+    'pyright',
+    'pylsp',
+    'clangd',
+    'jdtls',
+    'solargraph',
+];
+/**
+ * Synchronous PATH check for common language servers. Returns a
+ * {@link LspSanityResult} the boot code can use to decide whether
+ * to warn the user. Pure — no side effects, no I/O beyond
+ * `which`-style PATH scanning.
+ *
+ * The check is intentionally permissive: a missing language server
+ * is a `reason` to warn, not a hard failure. The user can always
+ * install one later. The hard fail mode is when neither a
+ * language server nor `FIXO_LSP_FALLBACK=syntax-only` is present
+ * AND the user has configured `lspPreSave: 'block'` — in that
+ * case the pre-save gate would block all writes, which is a much
+ * worse experience than a boot-time warning.
+ */
+export function checkLspSanity(env = process.env) {
+    const syntaxOnly = env.FIXO_LSP_FALLBACK === 'syntax-only';
+    const pathEntries = (env.PATH ?? '').split(path.delimiter).filter(Boolean);
+    // `execFileSync('which', ...)` would spawn a child process —
+    // expensive and unnecessary. PATH scan is enough: a binary on
+    // the PATH is in one of these directories.
+    const pathDirs = pathEntries;
+    const found = [];
+    for (const server of COMMON_LANGUAGE_SERVERS) {
+        for (const dir of pathDirs) {
+            if (!dir)
+                continue;
+            try {
+                if (fs.existsSync(path.join(dir, server))) {
+                    found.push(server);
+                    break;
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    if (found.length > 0) {
+        return { ok: true, reason: '', checked: [...COMMON_LANGUAGE_SERVERS], found, syntaxOnly };
+    }
+    if (syntaxOnly) {
+        return {
+            ok: true,
+            reason: 'FIXO_LSP_FALLBACK=syntax-only; brace-balance check will run instead of a real LSP.',
+            checked: [...COMMON_LANGUAGE_SERVERS],
+            found: [],
+            syntaxOnly: true,
+        };
+    }
+    return {
+        ok: false,
+        reason: 'No common language server found on PATH. Pre-save diagnostics will be skipped. ' +
+            'Install typescript-language-server / gopls / rust-analyzer or set FIXO_LSP_FALLBACK=syntax-only.',
+        checked: [...COMMON_LANGUAGE_SERVERS],
+        found: [],
+        syntaxOnly: false,
+    };
+}
+//# sourceMappingURL=syntax-fallback.js.map

package/dist/lsp/syntax-fallback.js.map

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

package/dist/model-outcomes.d.ts

@@ -0,0 +1,12 @@
+export interface ModelOutcome {
+    model: string;
+    taskType: string;
+    success: boolean;
+    latencyMs: number;
+    toolCalls: number;
+    verificationPassed: boolean | null;
+    timestamp: string;
+}
+export declare function recordModelOutcome(cwd: string, outcome: Omit<ModelOutcome, 'timestamp'>): void;
+export declare function summarizeModelOutcomes(cwd: string): string;
+//# sourceMappingURL=model-outcomes.d.ts.map

package/dist/model-outcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-outcomes.d.ts","sourceRoot":"","sources":["../src/model-outcomes.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,IAAI,CAM9F;AAeD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB1D"}

package/dist/model-outcomes.js

@@ -0,0 +1,46 @@
+import fs from 'fs';
+import path from 'path';
+const MAX_OUTCOMES = 100;
+export function recordModelOutcome(cwd, outcome) {
+    const dir = path.join(cwd, '.fixo');
+    fs.mkdirSync(dir, { recursive: true });
+    const file = path.join(dir, 'model-outcomes.jsonl');
+    fs.appendFileSync(file, JSON.stringify({ ...outcome, timestamp: new Date().toISOString() }) + '\n', 'utf-8');
+    pruneOutcomes(file);
+}
+function pruneOutcomes(file) {
+    try {
+        const content = fs.readFileSync(file, 'utf-8');
+        const lines = content.split('\n').filter(Boolean);
+        if (lines.length <= MAX_OUTCOMES)
+            return;
+        fs.writeFileSync(file, lines.slice(lines.length - MAX_OUTCOMES).join('\n') + '\n', 'utf-8');
+    }
+    catch (error) {
+        if (process.env.DEBUG || process.env.VERBOSE || process.argv.includes('--verbose')) {
+            console.warn(`[Debug Warning] Failed to prune model outcomes from ${file}: ${error.message || error}`);
+        }
+    }
+}
+export function summarizeModelOutcomes(cwd) {
+    const file = path.join(cwd, '.fixo', 'model-outcomes.jsonl');
+    if (!fs.existsSync(file))
+        return 'No model outcomes recorded.';
+    const rows = fs.readFileSync(file, 'utf-8')
+        .split('\n')
+        .filter(Boolean)
+        .map(line => JSON.parse(line));
+    const byModel = new Map();
+    for (const row of rows) {
+        const entry = byModel.get(row.model) ?? { total: 0, success: 0, latency: 0, verified: 0 };
+        entry.total++;
+        if (row.success)
+            entry.success++;
+        if (row.verificationPassed)
+            entry.verified++;
+        entry.latency += row.latencyMs;
+        byModel.set(row.model, entry);
+    }
+    return Array.from(byModel.entries()).map(([model, entry]) => `${model}: ${entry.success}/${entry.total} success, ${entry.verified}/${entry.total} verified, avg ${(entry.latency / entry.total / 1000).toFixed(1)}s`).join('\n');
+}
+//# sourceMappingURL=model-outcomes.js.map

package/dist/model-outcomes.js.map

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

package/dist/planner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Re-exported here so external callers (e.g. `SingleAgent`,
+ * telemetry sinks) can import the entire loop-trap surface from
+ * `src/planner.ts` without taking a hard dependency on the
+ * `src/runtime/` directory layout. The implementation lives in
+ * `src/runtime/loop-trap.ts`; this file is the public façade.
+ */
+export { LoopTrapDetector, LoopTrapAbortedError, DEFAULT_LOOP_TRAP_PREFS, canonicaliseArgs, } from './runtime/loop-trap.js';
+export type { LoopSnapshot, LoopTrapVerdict, LoopTrapLayer, LoopTrapPreferences, } from './runtime/loop-trap.js';
+export interface SavedPlan {
+    task: string;
+    createdAt: string;
+    taskType: 'chat' | 'review' | 'mutation' | 'test-fix' | 'refactor' | 'investigation';
+    expectedFiles: string[];
+    verificationCommand: string | null;
+    stages: string[];
+}
+export declare function createStructuredPlan(task: string): SavedPlan;
+export declare function validatePlan(plan: unknown): plan is SavedPlan;
+export declare function savePlan(cwd: string, task: string): SavedPlan;
+export declare function loadPlan(cwd: string): SavedPlan | null;
+export declare function renderPlan(plan: SavedPlan): string;
+export declare const TRIVIAL_PATTERNS: RegExp[];
+export declare function isTrivialQuery(input: string): boolean;
+export interface ComplexityClassification {
+    complexity: 'simple' | 'complex';
+    reason: string;
+}
+export declare function classifyComplexityHeuristic(task: string): ComplexityClassification;
+import type { AgentClient } from './agent/agent-client.js';
+export declare function classifyComplexityModel(task: string, model: string, client: AgentClient): Promise<ComplexityClassification>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,CAAC;IACrF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAUD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAsB5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,SAAS,CAS7D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAM7D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKtD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CASlD;AAID,eAAO,MAAM,gBAAgB,UAO5B,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUrD;AAID,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CA8BlF;AAED,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,wBAAwB,CAAC,CA4CnC"}

package/dist/planner.js

@@ -0,0 +1,163 @@
+import fs from 'fs';
+import path from 'path';
+/* ──────────────────────── Loop-Trap Detector Re-Exports ─────────────────── */
+/**
+ * Re-exported here so external callers (e.g. `SingleAgent`,
+ * telemetry sinks) can import the entire loop-trap surface from
+ * `src/planner.ts` without taking a hard dependency on the
+ * `src/runtime/` directory layout. The implementation lives in
+ * `src/runtime/loop-trap.ts`; this file is the public façade.
+ */
+export { LoopTrapDetector, LoopTrapAbortedError, DEFAULT_LOOP_TRAP_PREFS, canonicaliseArgs, } from './runtime/loop-trap.js';
+const DEFAULT_STAGES = [
+    'Understand: inspect indexed context and relevant files before editing.',
+    'Plan: choose patch-based edits and expected verification command.',
+    'Act: apply minimal workspace-scoped changes through guarded tools.',
+    'Verify: run detected checks or configured checkCommand.',
+    'Summarize: report changed files, checks, and residual risk.',
+];
+export function createStructuredPlan(task) {
+    const lower = task.toLowerCase();
+    const taskType = lower.includes('review') ? 'review'
+        : lower.includes('test') || lower.includes('failing') ? 'test-fix'
+            : lower.includes('refactor') ? 'refactor'
+                : /explain|what|why|how|list|show/.test(lower) ? 'investigation'
+                    : /^(hi|hello|hey|thanks|thank you|ok|bye)\b/.test(lower) ? 'chat'
+                        : 'mutation';
+    const extensions = '(ts|tsx|js|jsx|mjs|cjs|py|go|rs|java|rb|php|css|scss|json|md|yml|yaml|toml|sh|bash|txt|html|vue|svelte)';
+    const expectedFiles = Array.from(task.matchAll(new RegExp(`\\b([\\w./-]+\\.${extensions})\\b`, 'gi'))).map(match => match[1]);
+    const verificationCommand = taskType === 'chat' || taskType === 'investigation' || taskType === 'review'
+        ? null
+        : 'auto-detect';
+    return {
+        task,
+        taskType,
+        expectedFiles,
+        verificationCommand,
+        createdAt: new Date().toISOString(),
+        stages: DEFAULT_STAGES,
+    };
+}
+export function validatePlan(plan) {
+    if (!plan || typeof plan !== 'object')
+        return false;
+    const p = plan;
+    return typeof p.task === 'string'
+        && typeof p.createdAt === 'string'
+        && ['chat', 'review', 'mutation', 'test-fix', 'refactor', 'investigation'].includes(p.taskType)
+        && Array.isArray(p.expectedFiles)
+        && (typeof p.verificationCommand === 'string' || p.verificationCommand === null)
+        && Array.isArray(p.stages);
+}
+export function savePlan(cwd, task) {
+    const plan = createStructuredPlan(task);
+    const dir = path.join(cwd, '.fixo');
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, 'last-plan.json'), JSON.stringify(plan, null, 2) + '\n', 'utf-8');
+    return plan;
+}
+export function loadPlan(cwd) {
+    const file = path.join(cwd, '.fixo', 'last-plan.json');
+    if (!fs.existsSync(file))
+        return null;
+    const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    return validatePlan(parsed) ? parsed : null;
+}
+export function renderPlan(plan) {
+    return [
+        `Task: ${plan.task}`,
+        `Type: ${plan.taskType}`,
+        `Created: ${plan.createdAt}`,
+        `Expected files: ${plan.expectedFiles.join(', ') || '(none)'}`,
+        `Verification: ${plan.verificationCommand ?? '(none)'}`,
+        ...plan.stages.map((stage, index) => `${index + 1}. ${stage}`),
+    ].join('\n');
+}
+/* ──────────────────────── Trivial Query Detection ──────────────────────── */
+export const TRIVIAL_PATTERNS = [
+    /^(hi|hey|hello|howdy|yo|sup|greetings|hola|namaste)/i,
+    /^(thanks|thank you|thx|ty|cheers)/i,
+    /^(what can you do|who are you|help me|how does this work)/i,
+    /^(good morning|good evening|good night|gm|gn)/i,
+    /^(ok|okay|sure|great|nice|cool|awesome|perfect|got it)/i,
+    /^(bye|goodbye|see you|later|exit|quit)/i,
+];
+export function isTrivialQuery(input) {
+    const trimmed = input.trim();
+    if (trimmed.length < 3)
+        return true;
+    if (trimmed.length > 100)
+        return false; // Long inputs are usually tasks
+    for (const pattern of TRIVIAL_PATTERNS) {
+        if (pattern.test(trimmed))
+            return true;
+    }
+    return false;
+}
+export function classifyComplexityHeuristic(task) {
+    const trimmed = task.trim();
+    if (isTrivialQuery(trimmed)) {
+        return { complexity: 'simple', reason: 'Trivial chat query' };
+    }
+    const plan = createStructuredPlan(trimmed);
+    if (plan.taskType === 'chat' || plan.taskType === 'investigation' || plan.taskType === 'review') {
+        return { complexity: 'simple', reason: `Task type is ${plan.taskType}` };
+    }
+    // Check expected files.
+    if (plan.expectedFiles.length > 1) {
+        return { complexity: 'complex', reason: `Affects multiple files: ${plan.expectedFiles.join(', ')}` };
+    }
+    // Keywords that hint at complex operations
+    const complexKeywords = [
+        'system-wide', 'across the codebase', 'all files', 'every file', 'refactor the entire',
+        'multiple modules', 'architecture', 'orchestration', 'parallel', 'concurrent'
+    ];
+    const lower = trimmed.toLowerCase();
+    for (const kw of complexKeywords) {
+        if (lower.includes(kw)) {
+            return { complexity: 'complex', reason: `Contains complexity keyword: "${kw}"` };
+        }
+    }
+    // Simple edits / single file modifications are default simple
+    return { complexity: 'simple', reason: 'Single-file or narrow mutation scope' };
+}
+export async function classifyComplexityModel(task, model, client) {
+    const heuristic = classifyComplexityHeuristic(task);
+    // If heuristic is already complex, or if it is trivially simple, return it to save latency/tokens.
+    if (heuristic.complexity === 'complex' || heuristic.reason.startsWith('Trivial')) {
+        return heuristic;
+    }
+    const systemPrompt = `You are the FixO Complexity Classifier. Your job is to classify if a software engineering task is SIMPLE or COMPLEX.
+
+CRITERIA:
+- SIMPLE: Questions, explanations, conceptual reviews, single-file mutations (e.g. adding a field, fixing a minor bug, writing a test for a single file), or basic script creation.
+- COMPLEX: Multi-file changes, large refactoring, integration changes across layers (e.g. modifying both frontend and backend, changing API contracts between multiple files), or anything requiring parallel execution of subtasks.
+
+Output ONLY a JSON object:
+{
+  "complexity": "simple" | "complex",
+  "reason": "short explanation of the decision"
+}
+NO markdown formatting, NO backticks, and NO conversational text.`;
+    try {
+        const response = await client.chat([
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: task }
+        ], model, { agent_task_type: 'investigation', required_capabilities: ['fast'] });
+        const content = response.content?.trim() || '';
+        // Clean JSON from potential markdown blocks
+        const jsonMatch = content.match(/\{[\s\S]*\}/);
+        const parsed = JSON.parse(jsonMatch ? jsonMatch[0] : content);
+        if (parsed && (parsed.complexity === 'simple' || parsed.complexity === 'complex')) {
+            return {
+                complexity: parsed.complexity,
+                reason: parsed.reason || 'Model classification'
+            };
+        }
+    }
+    catch (err) {
+        // Fallback to heuristic
+    }
+    return heuristic;
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/project-memory.d.ts

@@ -0,0 +1,29 @@
+export interface ProjectFacts {
+    packageManager: 'npm' | 'pnpm' | 'yarn' | 'unknown';
+    scripts: Record<string, string>;
+    testCommands: string[];
+    buildCommands: string[];
+    tsconfigs: string[];
+    updatedAt: string;
+    allowRules: {
+        commands: string[];
+    };
+}
+export declare function detectProjectFacts(cwd: string): ProjectFacts;
+import { DatabaseSync } from 'node:sqlite';
+export declare function getDb(cwd: string): DatabaseSync;
+export declare function calculateTfidfSimilarity(query: string, documents: string[]): number[];
+export declare function retrieveRelevantFacts(cwd: string, query: string, client?: any, limit?: number): Promise<string[]>;
+export declare function appendSessionSummary(cwd: string, summary: string): void;
+export declare function readSessionHistory(cwd: string): string[];
+export declare function memoryDir(cwd: string): string;
+export declare function ensureProjectMemory(cwd: string): ProjectFacts;
+export declare function readMemory(cwd: string): string;
+export declare function appendMemory(cwd: string, text: string): void;
+export declare function readAllowRules(cwd: string): {
+    commands: string[];
+};
+export declare function allowCommand(cwd: string, command: string): void;
+export declare function forgetMemory(cwd: string): void;
+export declare function doctor(cwd: string): string;
+//# sourceMappingURL=project-memory.d.ts.map

package/dist/project-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory.d.ts","sourceRoot":"","sources":["../src/project-memory.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CA8B5D;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAiE/C;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA4ErF;AAgBD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,GAAG,EACZ,KAAK,SAAI,GACR,OAAO,CAAC,MAAM,EAAE,CAAC,CAmEnB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIvE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAQ7D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAK5D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAYlE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAM/D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG9C;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB1C"}