fixo-cli 1.0.0

package/dist/git/git-ops.js

@@ -0,0 +1,131 @@
+import { execFileSync } from 'child_process';
+function runGit(cwd, args) {
+    try {
+        return execFileSync('git', args, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (error) {
+        const stderr = error.stderr?.trim() || error.message;
+        throw new Error(`Git error (git ${args.join(' ')}): ${stderr}`);
+    }
+}
+export function createBranch(cwd, branchName) {
+    runGit(cwd, ['checkout', '-b', branchName]);
+    return `Successfully created and checked out branch: ${branchName}`;
+}
+export function commitChanges(cwd, message) {
+    runGit(cwd, ['add', '-A']);
+    runGit(cwd, ['commit', '-m', message]);
+    const hash = runGit(cwd, ['rev-parse', '--short', 'HEAD']);
+    return `Successfully committed changes as ${hash}`;
+}
+export function pushBranch(cwd, remote = 'origin') {
+    const currentBranch = runGit(cwd, ['branch', '--show-current']);
+    if (!currentBranch) {
+        throw new Error('Not currently on any branch (detached HEAD?)');
+    }
+    runGit(cwd, ['push', '-u', remote, currentBranch]);
+    return `Successfully pushed branch ${currentBranch} to ${remote}`;
+}
+export async function generatePrDescription(cwd, client, model, baseBranch = 'main') {
+    const currentBranch = runGit(cwd, ['branch', '--show-current']);
+    let diff = '';
+    try {
+        diff = runGit(cwd, ['diff', `${baseBranch}...${currentBranch}`]);
+    }
+    catch {
+        // Fallback to local diff against HEAD~1 if comparison fails
+        try {
+            diff = runGit(cwd, ['diff', 'HEAD~1']);
+        }
+        catch {
+            diff = runGit(cwd, ['diff']);
+        }
+    }
+    // Max diff size to send to model is 40k chars (~10k tokens)
+    if (diff.length > 40_000) {
+        diff = diff.slice(0, 40_000) + '\n\n... (diff truncated for length)';
+    }
+    if (!diff.trim()) {
+        return {
+            title: `work on ${currentBranch}`,
+            body: `Automated PR description for branch ${currentBranch}. No changes detected in comparison to ${baseBranch}.`
+        };
+    }
+    const systemPrompt = `You are a pull request description generator. Given the git diff of changes, write a clean, detailed semantic PR description.
+Your output must be a single valid JSON object matching this schema with NO markdown formatting, NO backticks, and NO conversational text:
+{
+  "title": "concise semantic PR title",
+  "body": "detailed markdown body containing: summary of changes, motivation, and tests completed."
+}`;
+    try {
+        const response = await client.chat([
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: `Here is the diff:\n\n${diff}` }
+        ], model, { agent_task_type: 'investigation', required_capabilities: ['fast'] });
+        const content = response.content?.trim() || '';
+        const jsonMatch = content.match(/\{[\s\S]*\}/);
+        const parsed = JSON.parse(jsonMatch ? jsonMatch[0] : content);
+        if (parsed && typeof parsed.title === 'string' && typeof parsed.body === 'string') {
+            return parsed;
+        }
+    }
+    catch (err) {
+        // Fallback on error
+    }
+    return {
+        title: `updates on branch ${currentBranch}`,
+        body: `## Summary\nAutomated updates on branch ${currentBranch}.\n\n## Changes\n- Code modifications applied by FixO.`
+    };
+}
+export async function createPullRequest(cwd, client, model, baseBranch = 'main') {
+    const currentBranch = runGit(cwd, ['branch', '--show-current']);
+    if (!currentBranch || currentBranch === 'main' || currentBranch === 'master') {
+        throw new Error(`Cannot create pull request from branch "${currentBranch}"`);
+    }
+    // 1. Generate title and body
+    const { title, body } = await generatePrDescription(cwd, client, model, baseBranch);
+    // 2. Check if GitHub CLI is installed and try to run it
+    try {
+        const ghCheck = execFileSync('which', ['gh'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (ghCheck) {
+            const prUrl = execFileSync('gh', ['pr', 'create', '--base', baseBranch, '--head', currentBranch, '--title', title, '--body', body], { cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+            return `Pull request created successfully via GitHub CLI:\n${prUrl}`;
+        }
+    }
+    catch {
+        // GitHub CLI not found or failed (not logged in, etc.)
+    }
+    // 3. Fallback: Generate comparison URL
+    let remoteUrl = '';
+    try {
+        remoteUrl = runGit(cwd, ['remote', 'get-url', 'origin']);
+    }
+    catch {
+        // No remote
+    }
+    let webUrl = '';
+    if (remoteUrl) {
+        // Parse git@github.com:owner/repo.git or https://github.com/owner/repo.git
+        let cleanUrl = remoteUrl;
+        if (cleanUrl.startsWith('git@')) {
+            cleanUrl = cleanUrl.replace(':', '/').replace('git@', 'https://');
+        }
+        if (cleanUrl.endsWith('.git')) {
+            cleanUrl = cleanUrl.slice(0, -4);
+        }
+        const titleEscaped = encodeURIComponent(title);
+        const bodyEscaped = encodeURIComponent(body);
+        webUrl = `${cleanUrl}/compare/${baseBranch}...${currentBranch}?expand=1&title=${titleEscaped}&body=${bodyEscaped}`;
+    }
+    return [
+        `GitHub CLI (gh) was not found or not authenticated. Here is the generated PR details:`,
+        `\nPR Title: ${title}`,
+        `\nPR Body:\n${body}`,
+        webUrl ? `\nYou can create the pull request manually by opening this URL in your browser:\n${webUrl}` : ''
+    ].filter(Boolean).join('\n');
+}
+//# sourceMappingURL=git-ops.js.map

package/dist/git/git-ops.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+/**
+ * FixO CLI — Entry Point
+ *
+ * Boot sequence:
+ * 1. Print the lava logo + command grid (new UI is the only UI).
+ * 2. Load global config (~/.fixocli/config.json)
+ * 3. If first run → run setup wizard
+ * 4. Load project config (.freellmapi.yml) if present
+ * 5. Ensure proxy server is running on the configured port
+ * 6. Print the session header
+ * 7. Launch interactive REPL
+ */
+import fs from 'fs';
+import path from 'path';
+import { loadConfig, saveConfig } from './config.js';
+import { runSetupWizard } from './setup-wizard.js';
+import { startREPL } from './ui/prompt.js';
+import yaml from 'js-yaml';
+import { C } from './ui/colors.js';
+import { renderLogo, renderCommandGrid, renderSessionHeader } from './ui/index.js';
+/* ──────────────────────── CLI Args ──────────────────────── */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {
+        help: false,
+        version: false,
+        verbose: false,
+        yes: false,
+        model: undefined,
+        port: undefined,
+        task: undefined,
+        resume: undefined,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                result.help = true;
+                break;
+            case '--version':
+            case '-V':
+                result.version = true;
+                break;
+            case '--verbose':
+            case '-v':
+                result.verbose = true;
+                break;
+            case '--yes':
+            case '-y':
+                result.yes = true;
+                break;
+            case '--model':
+            case '-m':
+                if (i + 1 < args.length)
+                    result.model = args[++i];
+                break;
+            case '--port':
+            case '-p':
+                if (i + 1 < args.length)
+                    result.port = parseInt(args[++i], 10);
+                break;
+            case '--resume':
+            case '-r':
+                if (i + 1 < args.length)
+                    result.resume = args[++i];
+                break;
+            case '--task':
+            case '-t':
+                if (i + 1 < args.length && !result.task) {
+                    result.task = args.slice(i + 1).join(' ');
+                    i = args.length; // consume rest
+                }
+                break;
+            default:
+                // If no flag, treat rest as task
+                if (!arg.startsWith('-') && !result.task) {
+                    result.task = args.slice(i).join(' ');
+                    i = args.length;
+                }
+                break;
+        }
+    }
+    return result;
+}
+function printHelpMessage() {
+    console.log(`
+${C.LAVA}${C.BOLD}FixO CLI${C.RESET} — Autonomous Free Multi-Provider LLM Coding Tool
+
+${C.BOLD}USAGE${C.RESET}
+  fixo                           Start interactive REPL
+  fixo "fix the bug"             Run a one-shot task
+  fixo --help                    Show this help
+
+${C.BOLD}OPTIONS${C.RESET}
+  -h, --help          Show help
+  -V, --version       Show version
+  -v, --verbose       Enable verbose/debug output
+  -y, --yes           Allow low-risk actions without repeated prompts
+  -m, --model <name>  Set the model (default: auto)
+  -p, --port <port>   Proxy server port (default: 3001)
+  -t, --task <text>   Run a one-shot task
+  -r, --resume <id>   Resume a previous session snapshot by id
+
+${C.BOLD}INTERACTIVE COMMANDS${C.RESET}
+  /help               Show all commands
+  /model [name|list]  Set model or list available models
+  /providers          Manage AI provider API keys
+  /mode [mode]        Set PLAN/BUILD/EXPLORE/SCOUT mode
+  /select [file]      Pin a file for agent context
+  /unselect           Clear all pinned files
+  /plan <task>        Generate a structured execution plan
+  /run-plan           Execute the last saved plan
+  /diff               Show git diff
+  /undo               Undo last AI change
+  /snapshot [label]   Create a named git snapshot
+  /log                Show recent git commits
+  /clear              Clear conversation
+  /compact            Summarise & compress conversation
+  /stats              Show usage statistics
+  /session            Manage sessions (list|load|new)
+  /runs               List recent FixO task ledgers
+  /show-run <id>      Show details of a specific run
+  /review             Review current git diff
+  /test               Run detected project checks
+  /fix-ci             Fix CI failures (paste logs)
+  /memory             Show project memory
+  /remember <fact>    Add a project fact to memory
+  /forget             Clear all project memory
+  /index              Build local repo index
+  /find <query>       Search the repo index
+  /explain <target>   Explain a file or symbol
+  /skills             List registered skill profiles
+  /doctor             Run FixO diagnostics
+  /theme              Toggle Dark Void / Inverted theme
+  /exit               Exit
+
+${C.BOLD}EXAMPLES${C.RESET}
+  ${C.SNOW4}# Start interactive mode${C.RESET}
+  fixo
+
+  ${C.SNOW4}# One-shot task${C.RESET}
+  fixo "add input validation to user.ts"
+
+  ${C.SNOW4}# Use a specific model${C.RESET}
+  fixo -m gemini-2.5-flash "explain this codebase"
+  `);
+}
+/* ──────────────────────── Project Config ──────────────────────── */
+const KNOWN_CONFIG_KEYS = new Set(['model', 'checkCommand', 'autoCommit', 'policy', 'executionMode', 'maxAttempts', 'systemPrompt', 'plugins', 'trustedPlugins']);
+function loadProjectConfig(cwd) {
+    const yamlPath = path.join(cwd, '.freellmapi.yml');
+    const yamlAltPath = path.join(cwd, '.freellmapi.yaml');
+    let configPath;
+    if (fs.existsSync(yamlPath))
+        configPath = yamlPath;
+    else if (fs.existsSync(yamlAltPath))
+        configPath = yamlAltPath;
+    if (!configPath)
+        return undefined;
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const doc = yaml.load(content);
+        if (!doc || typeof doc !== 'object')
+            return undefined;
+        for (const key of Object.keys(doc)) {
+            if (!KNOWN_CONFIG_KEYS.has(key)) {
+                console.warn(`${C.YELLOW}⚠ Unknown config key "${key}" in ${path.basename(configPath)}${C.RESET}`);
+            }
+        }
+        const config = {};
+        if (typeof doc.model === 'string')
+            config.model = doc.model;
+        if (typeof doc.checkCommand === 'string')
+            config.checkCommand = doc.checkCommand;
+        if (doc.autoCommit !== undefined)
+            config.autoCommit = Boolean(doc.autoCommit);
+        if (typeof doc.policy === 'string')
+            config.policy = doc.policy;
+        if (typeof doc.executionMode === 'string')
+            config.executionMode = doc.executionMode;
+        if (doc.maxAttempts !== undefined)
+            config.maxAttempts = parseInt(String(doc.maxAttempts), 10);
+        if (typeof doc.systemPrompt === 'string')
+            config.systemPrompt = doc.systemPrompt;
+        if (Array.isArray(doc.plugins))
+            config.plugins = doc.plugins.map(String);
+        if (Array.isArray(doc.trustedPlugins))
+            config.trustedPlugins = doc.trustedPlugins.map(String);
+        return config;
+    }
+    catch {
+        return undefined;
+    }
+}
+/* ──────────────────────── Main ──────────────────────── */
+async function main() {
+    // ──── Step 0: Print the lava logo (the new UI is the only UI) ────
+    renderLogo();
+    renderCommandGrid();
+    // Node version check (major >= 24)
+    const nodeMajor = parseInt(process.versions.node.split('.')[0], 10);
+    if (nodeMajor < 24) {
+        console.error(`${C.RED}Error: FixO CLI requires Node.js version 24.0.0 or higher (current version: ${process.version}).${C.RESET}`);
+        process.exit(1);
+    }
+    const args = parseArgs();
+    if (args.help) {
+        printHelpMessage();
+        process.exit(0);
+    }
+    if (args.version) {
+        try {
+            const pkgPath = new URL('../package.json', import.meta.url);
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            console.log(`fixo-cli v${pkg.version}`);
+        }
+        catch {
+            console.log('fixo-cli v1.0.0');
+        }
+        process.exit(0);
+    }
+    // ──── Step 1: Load config ────
+    let config = loadConfig();
+    // Pillar 3 — LSP pre-flight. Run a synchronous PATH check for
+    // common language servers and warn (not block) the user if
+    // none are present. The full pre-save gate is still wired in
+    // via the `LspPreSaveGate` and falls back to a brace-balance
+    // check when `FIXO_LSP_FALLBACK=syntax-only` is set.
+    try {
+        const { checkLspSanity } = await import('./lsp/syntax-fallback.js');
+        const sanity = checkLspSanity(process.env);
+        if (!sanity.ok) {
+            console.warn(`${C.YELLOW}⚠  ${sanity.reason}${C.RESET}\n` +
+                `${C.SNOW4}   Set FIXO_LSP_FALLBACK=syntax-only to enable brace-balance fallback.${C.RESET}`);
+        }
+    }
+    catch {
+        // best-effort — never block boot on this check
+    }
+    // ──── Step 2: First-run wizard & Validation ────
+    if (!config._firstRunComplete || !config.freellmapi_api_key || !config.apiUrl) {
+        config = await runSetupWizard();
+        saveConfig(config);
+    }
+    else {
+        // Validate API Key
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            const res = await fetch(`${config.apiUrl}/models`, {
+                headers: { Authorization: `Bearer ${config.freellmapi_api_key}` },
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (res.status === 401 || res.status === 403) {
+                console.warn(`${C.YELLOW}⚠ Warning: API Key appears invalid (HTTP ${res.status}). You may need to re-run setup.${C.RESET}`);
+            }
+        }
+        catch (err) {
+            console.warn(`${C.YELLOW}⚠ Warning: Could not validate API key (connection failed). Proceeding in offline mode or assuming temporary network issue.${C.RESET}`);
+        }
+    }
+    // ──── Apply CLI port override ────
+    if (args.port) {
+        if (config.apiUrl) {
+            try {
+                const url = new URL(config.apiUrl);
+                url.port = args.port.toString();
+                config.apiUrl = url.toString();
+            }
+            catch {
+                config.apiUrl = `http://localhost:${args.port}/v1`;
+            }
+        }
+        else {
+            config.apiUrl = `http://localhost:${args.port}/v1`;
+        }
+    }
+    // ──── Step 3: Load project config ────
+    const cwd = process.cwd();
+    const projectConfig = loadProjectConfig(cwd);
+    // ──── Step 3.5: Initialize MCP & Plugins ────
+    const { mcpManager, mcpBridgeManager, initializePlugins } = await import('./agent/tool-executor.js');
+    await mcpManager.initialize();
+    await mcpBridgeManager.initialize(cwd);
+    const { skillsManager } = await import('./agent/skills.js');
+    skillsManager.initialize(cwd);
+    await initializePlugins(cwd, projectConfig);
+    // Register shutdown hook
+    process.on('exit', () => {
+        mcpManager.shutdown();
+        mcpBridgeManager.shutdown();
+    });
+    // ──── Apply CLI overrides ────
+    const model = args.model ?? projectConfig?.model ?? config.defaultModel;
+    const verbose = args.verbose;
+    // ──── Step 4: Launch ────
+    if (args.task) {
+        // One-shot mode: run task and exit
+        const { SingleAgent } = await import('./agent/single-agent.js');
+        const { ConversationManager } = await import('./agent/conversation.js');
+        const agent = new SingleAgent(verbose);
+        const conversation = new ConversationManager();
+        const result = await agent.runStreaming({
+            task: args.task,
+            model: model ?? 'auto',
+            cwd,
+            verbose,
+            selectedFiles: [],
+            systemPromptOverride: projectConfig?.systemPrompt,
+            checkCommand: projectConfig?.checkCommand,
+            policy: projectConfig?.policy ?? config.preferences.policy,
+            yes: args.yes,
+        }, conversation);
+        // Print final stats
+        const modelPart = result.model ? `${result.model} · ` : '';
+        console.log(`\n${C.SNOW4}${modelPart}${result.tokensUsed.total_tokens} tokens · ${result.toolCallCount} tool calls · ${(result.durationMs / 1000).toFixed(1)}s${C.RESET}`);
+        const { stopLspManager } = await import('./agent/tool-executor.js');
+        await stopLspManager();
+        process.exit(result.success ? 0 : 1);
+    }
+    // Interactive REPL mode — print the session header before
+    // handing off to startREPL so the boot sequence is:
+    // logo → command grid → session header → › prompt.
+    const sessionModel = model ?? 'auto';
+    renderSessionHeader({
+        status: 'new',
+        startedAt: new Date().toISOString(),
+        provider: 'auto',
+        model: sessionModel,
+        mode: 'BUILD',
+        routing: 'auto',
+        contextWindow: '200k',
+    });
+    await startREPL({
+        config,
+        projectConfig,
+        cwd,
+        verbose,
+        resume: args.resume,
+    });
+    const { stopLspManager } = await import('./agent/tool-executor.js');
+    await stopLspManager();
+}
+// ──── Run ────
+main().catch((error) => {
+    console.error(`${C.RED}Fatal error: ${error.message ?? error}${C.RESET}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/indexer.d.ts

@@ -0,0 +1,30 @@
+export interface IndexedFile {
+    path: string;
+    hash: string;
+    symbols: string[];
+    imports: string[];
+    resolvedImports?: string[];
+    dependents?: string[];
+    importance?: number;
+}
+export interface RepoIndex {
+    updatedAt: string;
+    files: IndexedFile[];
+}
+/**
+ * Builds a fresh `RepoIndex` for the workspace at `cwd` and persists it
+ * to `.fixo/index/repo-index.json`. Routes symbol and import extraction
+ * through the `ParserFactory` so the same call site transparently uses
+ * tree-sitter when the WASM is available and the regex fallback when
+ * it is not.
+ */
+export declare function buildIndex(cwd: string): Promise<RepoIndex>;
+/**
+ * Loads the cached `RepoIndex` for `cwd`. If no cache exists, builds one
+ * first (sharing the in-flight promise with any concurrent caller).
+ */
+export declare function loadIndex(cwd: string): Promise<RepoIndex>;
+export declare function findInIndex(cwd: string, query: string): Promise<string>;
+export declare function explainIndexedTarget(cwd: string, query: string): Promise<string>;
+export declare function findCodebaseDependencies(cwd: string, targetPath: string): Promise<string>;
+//# sourceMappingURL=indexer.d.ts.map

package/dist/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AA6FD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAuF1D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmBzD;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB7E;AAED,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBtF;AAED,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B/F"}