fixo-cli 1.0.0

package/dist/agent/mcp-registry.d.ts

@@ -0,0 +1,45 @@
+/** Shape of a single MCP server config entry (matches MCP spec). */
+export interface McpServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    type?: 'stdio' | 'sse';
+    [key: string]: unknown;
+}
+/** A single source of MCP servers. */
+export interface McpSourceView {
+    name: 'global' | 'project' | 'local';
+    configPath: string | null;
+    servers: Record<string, McpServerConfig>;
+}
+export interface McpRegistryView {
+    global: McpSourceView;
+    project: McpSourceView;
+    local: McpSourceView;
+}
+/** Read the global MCP config from `~/.freellmapi/mcp.json`. */
+export declare function readGlobalMcpConfig(): {
+    configPath: string | null;
+    servers: Record<string, McpServerConfig>;
+};
+/** Read the project MCP config from `<cwd>/.fixo.yml` or `.fixo.yaml`. */
+export declare function readProjectMcpConfig(cwd: string): {
+    configPath: string | null;
+    servers: Record<string, McpServerConfig>;
+};
+/** Build a unified view of all MCP sources for `cwd`. */
+export declare function listAllMcpSources(cwd: string): McpRegistryView;
+/** Add a server to the in-memory local layer for `cwd`. */
+export declare function addLocalMcpServer(cwd: string, name: string, config: McpServerConfig): void;
+/** Remove a server from the in-memory local layer. */
+export declare function removeLocalMcpServer(cwd: string, name: string): boolean;
+/** Clear all local entries (test-only). */
+export declare function _resetLocalMcpServers(): void;
+/**
+ * Build a merged server map for runtime use. Precedence
+ * (highest → lowest): local > project > global. Project
+ * shadows global on name conflict; local shadows both.
+ */
+export declare function mergedMcpServers(cwd: string): Record<string, McpServerConfig>;
+//# sourceMappingURL=mcp-registry.d.ts.map

package/dist/agent/mcp-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.d.ts","sourceRoot":"","sources":["../../src/agent/mcp-registry.ts"],"names":[],"mappings":"AAmBA,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAcD,gEAAgE;AAChE,wBAAgB,mBAAmB,IAAI;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAAE,CAW7G;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAAE,CAazH;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAQ9D;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAE1F;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAO7E"}

package/dist/agent/mcp-registry.js

@@ -0,0 +1,98 @@
+/**
+ * mcp-registry.ts — Unified view of MCP server config across
+ * 3 sources: global (~/.freellmapi/mcp.json), project
+ * (.fixo.yml / .fixo.yaml), and local (in-memory runtime
+ * additions made via /mcp add).
+ *
+ * Phase 3.3 invariant: when the same server name appears in
+ * both global and project, the project definition wins.
+ * Local entries shadow both.
+ *
+ * The registry is read-only on disk; mutating actions
+ * (add/remove) are kept in an in-memory layer that is
+ * consumed by /mcp add and /mcp remove.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import yaml from 'js-yaml';
+/** In-memory local additions, keyed by cwd. */
+const localByCwd = new Map();
+function getLocal(cwd) {
+    let m = localByCwd.get(cwd);
+    if (!m) {
+        m = {};
+        localByCwd.set(cwd, m);
+    }
+    return m;
+}
+/** Read the global MCP config from `~/.freellmapi/mcp.json`. */
+export function readGlobalMcpConfig() {
+    const configPath = path.join(os.homedir(), '.freellmapi', 'mcp.json');
+    if (!fs.existsSync(configPath)) {
+        return { configPath: null, servers: {} };
+    }
+    try {
+        const raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        return { configPath, servers: raw.mcpServers ?? {} };
+    }
+    catch {
+        return { configPath, servers: {} };
+    }
+}
+/** Read the project MCP config from `<cwd>/.fixo.yml` or `.fixo.yaml`. */
+export function readProjectMcpConfig(cwd) {
+    const yml = path.join(cwd, '.fixo.yml');
+    const yamlAlt = path.join(cwd, '.fixo.yaml');
+    const configPath = fs.existsSync(yml) ? yml : fs.existsSync(yamlAlt) ? yamlAlt : null;
+    if (!configPath) {
+        return { configPath: null, servers: {} };
+    }
+    try {
+        const raw = yaml.load(fs.readFileSync(configPath, 'utf-8'));
+        return { configPath, servers: raw?.mcpServers ?? {} };
+    }
+    catch {
+        return { configPath, servers: {} };
+    }
+}
+/** Build a unified view of all MCP sources for `cwd`. */
+export function listAllMcpSources(cwd) {
+    const g = readGlobalMcpConfig();
+    const p = readProjectMcpConfig(cwd);
+    return {
+        global: { name: 'global', configPath: g.configPath, servers: g.servers },
+        project: { name: 'project', configPath: p.configPath, servers: p.servers },
+        local: { name: 'local', configPath: null, servers: { ...getLocal(cwd) } },
+    };
+}
+/** Add a server to the in-memory local layer for `cwd`. */
+export function addLocalMcpServer(cwd, name, config) {
+    getLocal(cwd)[name] = config;
+}
+/** Remove a server from the in-memory local layer. */
+export function removeLocalMcpServer(cwd, name) {
+    const local = getLocal(cwd);
+    if (!(name in local))
+        return false;
+    delete local[name];
+    return true;
+}
+/** Clear all local entries (test-only). */
+export function _resetLocalMcpServers() {
+    localByCwd.clear();
+}
+/**
+ * Build a merged server map for runtime use. Precedence
+ * (highest → lowest): local > project > global. Project
+ * shadows global on name conflict; local shadows both.
+ */
+export function mergedMcpServers(cwd) {
+    const view = listAllMcpSources(cwd);
+    return {
+        ...view.global.servers,
+        ...view.project.servers,
+        ...view.local.servers,
+    };
+}
+//# sourceMappingURL=mcp-registry.js.map

package/dist/agent/mcp-registry.js.map

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

package/dist/agent/orchestrator.d.ts

@@ -0,0 +1,14 @@
+import type { AgentContext, Subtask, TaskDAG } from '../types.js';
+export declare class Orchestrator {
+    private client;
+    private verbose;
+    tokensUsed: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    constructor(verbose?: boolean);
+    plan(context: AgentContext): Promise<TaskDAG>;
+    validateAndSortDAG(subtasks: Subtask[]): Subtask[];
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/agent/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agent/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKlE,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAU;IAClB,UAAU;;;;MAA+D;gBAEpE,OAAO,UAAQ;IAMrB,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAmFnD,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;CAmCnD"}

package/dist/agent/orchestrator.js

@@ -0,0 +1,118 @@
+import { AgentClient } from './agent-client.js';
+import { loadConfig } from '../config.js';
+import { C } from '../ui/colors.js';
+export class Orchestrator {
+    client;
+    verbose;
+    tokensUsed = { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
+    constructor(verbose = false) {
+        const config = loadConfig();
+        this.client = new AgentClient(config.freellmapi_api_key || '', config.apiUrl, verbose);
+        this.verbose = verbose;
+    }
+    async plan(context) {
+        const systemPrompt = `You are the FixO Orchestrator. Your job is to analyze a complex software engineering task and decompose it into a Directed Acyclic Graph (DAG) of subtasks.
+Each subtask will be assigned to a specialist worker agent:
+- 'code': Writes or modifies code files.
+- 'test': Creates, updates, or executes test suites.
+- 'doc': Updates documentation, READMEs, JSDocs, etc.
+- 'reviewer': Reviews changes, audits code modifications.
+
+You must output a single valid JSON object containing a "subtasks" array. NO markdown formatting, NO backticks, and NO conversational text.
+
+JSON Schema:
+{
+  "subtasks": [
+    {
+      "id": "string",
+      "title": "string",
+      "description": "string",
+      "persona": "code" | "test" | "doc" | "reviewer",
+      "dependencies": ["string"],
+      "files": ["string"]
+    }
+  ]
+}`;
+        const maxRetries = 3;
+        let attempt = 0;
+        let feedback = '';
+        while (attempt < maxRetries) {
+            if (attempt > 0) {
+                const delayMs = Math.pow(2, attempt) * 1000;
+                if (this.verbose) {
+                    console.log(`[Orchestrator] Retrying plan generation in ${(delayMs / 1000).toFixed(1)}s...`);
+                }
+                await new Promise(resolve => setTimeout(resolve, delayMs));
+            }
+            try {
+                const response = await this.client.chat([
+                    { role: 'system', content: systemPrompt },
+                    { role: 'user', content: context.task + (feedback ? `\n\nPrevious attempt failed validation: ${feedback}. Please output only valid JSON matching the schema.` : '') }
+                ], context.model, { agent_task_type: 'investigation', required_capabilities: ['fast'] });
+                if (response.usage) {
+                    this.tokensUsed.prompt_tokens += response.usage.prompt_tokens;
+                    this.tokensUsed.completion_tokens += response.usage.completion_tokens;
+                    this.tokensUsed.total_tokens += response.usage.total_tokens;
+                }
+                const content = response.content?.trim() || '';
+                const jsonMatch = content.match(/\{[\s\S]*\}/);
+                const parsed = JSON.parse(jsonMatch ? jsonMatch[0] : content);
+                if (parsed && Array.isArray(parsed.subtasks)) {
+                    this.validateAndSortDAG(parsed.subtasks);
+                    return parsed;
+                }
+                feedback = 'Missing subtasks array';
+            }
+            catch (err) {
+                feedback = err.message || String(err);
+            }
+            attempt++;
+        }
+        console.warn(`${C.YELLOW}[Orchestrator] Warning: Failed to generate plan. Falling back to SingleAgent execution...${C.RESET}`);
+        return {
+            subtasks: [
+                {
+                    id: 'fallback-task',
+                    title: 'Execute coding task',
+                    description: context.task,
+                    persona: 'code',
+                    dependencies: [],
+                    files: [],
+                    status: 'pending'
+                }
+            ]
+        };
+    }
+    validateAndSortDAG(subtasks) {
+        const sorted = [];
+        const visited = new Set();
+        const temp = new Set();
+        const subtaskMap = new Map();
+        for (const s of subtasks) {
+            subtaskMap.set(s.id, s);
+        }
+        function visit(id) {
+            if (temp.has(id)) {
+                throw new Error(`Circular dependency detected at subtask: ${id}`);
+            }
+            if (!visited.has(id)) {
+                temp.add(id);
+                const subtask = subtaskMap.get(id);
+                if (!subtask) {
+                    throw new Error(`Dependency subtask not found: ${id}`);
+                }
+                for (const depId of subtask.dependencies) {
+                    visit(depId);
+                }
+                temp.delete(id);
+                visited.add(id);
+                sorted.push(subtask);
+            }
+        }
+        for (const s of subtasks) {
+            visit(s.id);
+        }
+        return sorted;
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/agent/orchestrator.js.map

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

package/dist/agent/parser-adapter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * parser-adapter.ts — Unified code-parsing interface for the FixO CLI.
+ *
+ * Decouples every consumer (indexer, command-parser, repo-map, future
+ * callers) from a single concrete parser. Two implementations exist:
+ *
+ *   - `TreeSitterAdapter` — uses the vendored WebAssembly tree-sitter
+ *     engine. Supports shell command parsing via the bundled bash
+ *     grammar, and a generic regex fallback for any other language.
+ *     If `Parser.init()` throws (WASM architecture mismatch, missing
+ *     file, etc.) the adapter catches the error, logs a console
+ *     warning, and reports `supported = false`.
+ *
+ *   - `RegexParserAdapter` — a pure-JS, zero-dependency fallback that
+ *     works on every platform. It uses curated per-language regexes
+ *     for symbol and import extraction, and a tokeniser-style splitter
+ *     for shell commands. Slightly less accurate than tree-sitter but
+ *     always available.
+ *
+ * A double-checked async singleton (`ParserFactory`) ensures only one
+ * adapter is ever instantiated per process and that concurrent callers
+ * share the same in-flight `init()` promise.
+ */
+export type LanguageId = 'typescript' | 'javascript' | 'python' | 'go' | 'rust' | 'bash' | 'json' | 'markdown' | 'generic';
+export interface SymbolInfo {
+    name: string;
+    kind: 'class' | 'function' | 'interface' | 'type' | 'const' | 'let' | 'var' | 'enum' | 'method' | 'variable' | 'field' | 'module' | 'unknown';
+    line: number;
+    endLine: number;
+    exported: boolean;
+}
+export interface ImportInfo {
+    source: string;
+    symbols: string[];
+    line: number;
+    isTypeOnly: boolean;
+}
+export interface ParsedCommand {
+    binary: string;
+    arguments: string[];
+    raw: string;
+}
+export interface ParserInitResult {
+    ok: boolean;
+    reason?: string;
+}
+export interface ParserAdapter {
+    readonly name: 'tree-sitter' | 'regex';
+    readonly supported: boolean;
+    /** Performs any one-time async work (e.g. loading WASM grammars). */
+    init(): Promise<ParserInitResult>;
+    /**
+     * Extracts symbol declarations from `source` for the given language.
+     * Synchronous: callers may invoke this from inside a tight loop.
+     */
+    extractSymbols(source: string, language: LanguageId): SymbolInfo[];
+    /**
+     * Extracts import statements from `source` for the given language.
+     * Synchronous: callers may invoke this from inside a tight loop.
+     */
+    extractImports(source: string, language: LanguageId): ImportInfo[];
+    /**
+     * Parses a shell command string into individual `binary`/`arguments`
+     * tuples. Optional — adapters that do not understand shell may omit it.
+     */
+    parseShellCommand?(command: string): ParsedCommand[];
+    /** Frees any held resources. */
+    dispose(): void;
+}
+/** Maps a file extension (including the leading dot) to a `LanguageId`. */
+export declare function languageIdFromExtension(ext: string): LanguageId;
+export declare class TreeSitterAdapter implements ParserAdapter {
+    readonly name: "tree-sitter";
+    supported: boolean;
+    private parser;
+    private initialised;
+    init(): Promise<ParserInitResult>;
+    extractSymbols(source: string, language: LanguageId): SymbolInfo[];
+    extractImports(source: string, language: LanguageId): ImportInfo[];
+    parseShellCommand(command: string): ParsedCommand[];
+    private parseShellWithTreeSitter;
+    dispose(): void;
+}
+export declare class RegexParserAdapter implements ParserAdapter {
+    readonly name: "regex";
+    supported: boolean;
+    init(): Promise<ParserInitResult>;
+    extractSymbols(source: string, language: LanguageId): SymbolInfo[];
+    extractImports(source: string, language: LanguageId): ImportInfo[];
+    parseShellCommand(command: string): ParsedCommand[];
+    /** Convenience: re-uses the safety heuristic so callers can stay pure. */
+    isCommandSafeShell(command: string, workspaceRoot: string): boolean;
+    dispose(): void;
+}
+export declare class ParserFactory {
+    /**
+     * Returns a fully-initialised parser adapter. The first caller pays
+     * the (potential) WASM-init cost; subsequent callers share the same
+     * adapter instance.
+     *
+     * `force = 'tree-sitter'` rejects the call with the underlying
+     * error if WASM init fails (use this when WASM is required by the
+     * caller). `force = 'regex'` skips tree-sitter entirely.
+     */
+    static getParser(force?: 'tree-sitter' | 'regex' | 'auto'): Promise<ParserAdapter>;
+    /**
+     * Returns the currently cached parser synchronously, or `null` if
+     * the factory has not been initialised yet. Use this only when you
+     * cannot await — e.g. inside a sync extraction loop on a hot path.
+     */
+    static getCachedParser(): ParserAdapter | null;
+    /** Resets the factory. Intended for tests only. */
+    static reset(): void;
+    /**
+     * Configures the factory's force policy. The next `getParser()` call
+     * after this method will re-initialise with the new policy.
+     */
+    static setForce(force: 'tree-sitter' | 'regex' | 'auto'): void;
+}
+//# sourceMappingURL=parser-adapter.d.ts.map

package/dist/agent/parser-adapter.d.ts.map

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