fixo-cli 1.0.0

package/dist/ui/session-header.js

@@ -0,0 +1,74 @@
+/**
+ * session-header.ts — The boxed session summary rendered once
+ * when a session starts or is resumed.
+ *
+ * The header uses the lava top/bottom border and a SNOW4 side
+ * border so it sits inside the same visual family as the AI
+ * response frame and the plan renderer.
+ */
+import { C, providerColor } from './colors.js';
+import { visLen } from './colors.js';
+function frameWidth() {
+    return Math.max(40, Math.min(100, (process.stdout.columns ?? 100) - 4));
+}
+function modeColor(mode) {
+    switch (mode) {
+        case 'BUILD': return C.LAVA;
+        case 'PLAN': return C.PURPLE;
+        case 'REVIEW': return C.YELLOW;
+    }
+}
+function padInside(s, width) {
+    const v = visLen(s);
+    if (v >= width)
+        return s;
+    return s + ' '.repeat(width - v);
+}
+function statusLabel(s) {
+    switch (s) {
+        case 'new': return 'New session';
+        case 'resumed': return 'Resumed session';
+        case 'imported': return 'Imported session';
+    }
+}
+/**
+ * Print the session header box. The box width is `columns - 4`,
+ * capped at 100. Safe to call on a non-TTY.
+ */
+export function renderSessionHeader(opts) {
+    const w = frameWidth();
+    const inner = w - 4; // account for the `│ ` and ` │` side padding
+    const top = `  ${C.LAVA}┌── SESSION ${'─'.repeat(Math.max(0, inner - 14))}┐${C.RESET}`;
+    const bottom = `  ${C.LAVA}└${'─'.repeat(w - 2)}┘${C.RESET}`;
+    const line1 = `${C.SNOW3}${statusLabel(opts.status)}${C.RESET}  ${C.SNOW4}·${C.RESET}  ${C.SNOW2}${formatDate(opts.startedAt)}${C.RESET}`;
+    const line2 = `${C.SNOW4}Provider:${C.RESET} ${C.SNOW}${providerColor(opts.provider)}${opts.provider}${C.RESET}  ${C.SNOW4}·${C.RESET}  ${C.SNOW4}Model:${C.RESET} ${C.BLUE}${opts.model}${C.RESET}`;
+    const line3 = `${C.SNOW4}Mode:${C.RESET} ${modeColor(opts.mode)}${opts.mode}${C.RESET}  ${C.SNOW4}·${C.RESET}  ${C.SNOW4}Routing:${C.RESET} ${C.SNOW2}${opts.routing}${C.RESET}  ${C.SNOW4}·${C.RESET}  ${C.SNOW4}Context:${C.RESET} ${C.SNOW2}${opts.contextWindow}${C.RESET}`;
+    try {
+        process.stdout.write(top + '\n');
+        process.stdout.write(`  ${C.SNOW4}│${C.RESET}  ${padInside(line1, inner)}${C.SNOW4}│${C.RESET}\n`);
+        process.stdout.write(`  ${C.SNOW4}│${C.RESET}  ${padInside(line2, inner)}${C.SNOW4}│${C.RESET}\n`);
+        process.stdout.write(`  ${C.SNOW4}│${C.RESET}  ${padInside(line3, inner)}${C.SNOW4}│${C.RESET}\n`);
+        process.stdout.write(bottom + '\n');
+    }
+    catch {
+        // stdout may be closed during teardown
+    }
+}
+function formatDate(iso) {
+    try {
+        const d = new Date(iso);
+        if (Number.isNaN(d.getTime()))
+            return iso;
+        return d.toLocaleString('en-US', {
+            month: 'short',
+            day: 'numeric',
+            year: 'numeric',
+            hour: 'numeric',
+            minute: '2-digit',
+        });
+    }
+    catch {
+        return iso;
+    }
+}
+//# sourceMappingURL=session-header.js.map

package/dist/ui/session-header.js.map

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

package/dist/workspace-guard.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Workspace boundary guard.
+ *
+ * Pillar 5 (Self-Protection) — the WorkspaceGuard also enforces
+ * a System Path Lock: paths that resolve inside the platform's
+ * own runtime (`src/**`, `package.json`, `tsconfig.json`, and
+ * the lockfile) are **immutable** from any active agent loop.
+ * This stops an autonomous agent from corrupting its own host
+ * (the failure mode that produced the
+ * `src/agent/tool-executor.ts:983: Unexpected "catch"` incident
+ * during the Phase 2 release).
+ */
+export declare class WorkspaceGuard {
+    readonly root: string;
+    private allowList;
+    constructor(root: string, allowList?: string[]);
+    private safeRealPath;
+    resolve(input: string | undefined, label?: string): string;
+    isInside(target: string): boolean;
+    relative(target: string): string;
+    ensureFile(target: string): string;
+    isBinaryFile(target: string, sampleBytes?: number): boolean;
+    /**
+     * File-system entries that make up the Fixo CLI platform
+     * itself. The agent runtime is **never** allowed to mutate
+     * these from an active task cycle, regardless of which
+     * workspace the user is operating in.
+     *
+     * The list is intentionally narrow (the platform's own
+     * source tree and root-level build manifests) so the lock
+     * does not interfere with the user's own code in
+     * sub-directories.
+     */
+    private static readonly PLATFORM_PATH_PATTERNS;
+    /**
+     * Return true if the relative path matches a platform-locked
+     * pattern. The check is case-insensitive on the extension
+     * because Windows and macOS Finder both silently rename
+     * `package.json` to `Package.json` if the user double-clicks.
+     */
+    isPlatformPath(relativePath: string): boolean;
+    /**
+     * Static form of {@link isPlatformPath}. Useful in tests and
+     * in places where a WorkspaceGuard instance is not yet
+     * available.
+     */
+    static isPlatformPath(relativePath: string): boolean;
+    private static isPlatformPathStatic;
+    /**
+     * Throws {@link PlatformPathLockedError} if `target` resolves
+     * to a path inside the platform's own runtime. This is the
+     * one method every mutation tool in the executor must call
+     * before staging a write.
+     */
+    assertNotPlatformPath(target: string): void;
+}
+/**
+ * Thrown when an agent loop attempts to mutate a path inside
+ * the platform's own runtime. Caught by the executor's switch
+ * statement and surfaced as a plain string error to the LLM,
+ * so the model sees the rejection in its next-turn tool result.
+ */
+export declare class PlatformPathLockedError extends Error {
+    readonly resolved: string;
+    readonly relative: string;
+    constructor(resolved: string, relative: string);
+}
+//# sourceMappingURL=workspace-guard.d.ts.map

package/dist/workspace-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-guard.d.ts","sourceRoot":"","sources":["../src/workspace-guard.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,SAAS,CAAW;gBAEhB,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO;IASlD,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,SAAS,GAAG,MAAM;IAS1D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAMjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIhC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAiBlC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,SAAO,GAAG,OAAO;IAgBzD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAO5C;IAEF;;;;;OAKG;IACI,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIpD;;;;OAIG;WACW,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI3D,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAQnC;;;;;OAKG;IACI,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CASnD;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBACrB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAS/C"}

package/dist/workspace-guard.js

@@ -0,0 +1,168 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Workspace boundary guard.
+ *
+ * Pillar 5 (Self-Protection) — the WorkspaceGuard also enforces
+ * a System Path Lock: paths that resolve inside the platform's
+ * own runtime (`src/**`, `package.json`, `tsconfig.json`, and
+ * the lockfile) are **immutable** from any active agent loop.
+ * This stops an autonomous agent from corrupting its own host
+ * (the failure mode that produced the
+ * `src/agent/tool-executor.ts:983: Unexpected "catch"` incident
+ * during the Phase 2 release).
+ */
+export class WorkspaceGuard {
+    root;
+    allowList;
+    constructor(root, allowList = []) {
+        try {
+            this.root = fs.realpathSync(path.resolve(root));
+        }
+        catch {
+            this.root = path.resolve(root);
+        }
+        this.allowList = allowList;
+    }
+    safeRealPath(p) {
+        try {
+            return fs.realpathSync(p);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'ENOENT') {
+                const parent = path.dirname(p);
+                if (parent === p)
+                    return p;
+                return path.join(this.safeRealPath(parent), path.basename(p));
+            }
+            throw err;
+        }
+    }
+    resolve(input, label = 'path') {
+        const raw = input?.trim() || '.';
+        const resolved = path.resolve(this.root, raw);
+        if (!this.isInside(resolved)) {
+            throw new Error(`${label} escapes workspace: ${input ?? '.'}`);
+        }
+        return resolved;
+    }
+    isInside(target) {
+        const resolvedTarget = this.safeRealPath(path.resolve(target));
+        const relative = path.relative(this.root, resolvedTarget);
+        return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
+    }
+    relative(target) {
+        return path.relative(this.root, path.resolve(target)) || '.';
+    }
+    ensureFile(target) {
+        const resolved = this.resolve(target, 'file');
+        try {
+            const stat = fs.statSync(resolved);
+            if (!stat.isFile()) {
+                throw new Error(`Not a file: ${target}`);
+            }
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'ENOENT') {
+                throw new Error(`File does not exist: ${target}`);
+            }
+            throw err;
+        }
+        return resolved;
+    }
+    isBinaryFile(target, sampleBytes = 4096) {
+        const fd = fs.openSync(target, 'r');
+        try {
+            const buffer = Buffer.alloc(sampleBytes);
+            const bytesRead = fs.readSync(fd, buffer, 0, sampleBytes, 0);
+            for (let i = 0; i < bytesRead; i++) {
+                if (buffer[i] === 0)
+                    return true;
+            }
+            return false;
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    /* ──────────────────── System Path Lock (Pillar 5) ──────────────────── */
+    /**
+     * File-system entries that make up the Fixo CLI platform
+     * itself. The agent runtime is **never** allowed to mutate
+     * these from an active task cycle, regardless of which
+     * workspace the user is operating in.
+     *
+     * The list is intentionally narrow (the platform's own
+     * source tree and root-level build manifests) so the lock
+     * does not interfere with the user's own code in
+     * sub-directories.
+     */
+    static PLATFORM_PATH_PATTERNS = [
+        /(^|\/)src\/.+/,
+        /(^|\/)package\.json$/,
+        /(^|\/)package-lock\.json$/,
+        /(^|\/)tsconfig(\..+)?\.json$/,
+        /(^|\/)dist\/.+/,
+        /(^|\/)node_modules\/.+/,
+    ];
+    /**
+     * Return true if the relative path matches a platform-locked
+     * pattern. The check is case-insensitive on the extension
+     * because Windows and macOS Finder both silently rename
+     * `package.json` to `Package.json` if the user double-clicks.
+     */
+    isPlatformPath(relativePath) {
+        return WorkspaceGuard.isPlatformPathStatic(relativePath);
+    }
+    /**
+     * Static form of {@link isPlatformPath}. Useful in tests and
+     * in places where a WorkspaceGuard instance is not yet
+     * available.
+     */
+    static isPlatformPath(relativePath) {
+        return WorkspaceGuard.isPlatformPathStatic(relativePath);
+    }
+    static isPlatformPathStatic(relativePath) {
+        const normalised = relativePath.replace(/\\/g, '/').toLowerCase();
+        for (const pattern of WorkspaceGuard.PLATFORM_PATH_PATTERNS) {
+            if (pattern.test(normalised))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Throws {@link PlatformPathLockedError} if `target` resolves
+     * to a path inside the platform's own runtime. This is the
+     * one method every mutation tool in the executor must call
+     * before staging a write.
+     */
+    assertNotPlatformPath(target) {
+        // Resolve to an absolute path so symlinks and `..` tricks
+        // cannot escape the check.
+        const resolved = this.resolve(target, 'platform path');
+        const relative = this.relative(resolved);
+        if (this.isPlatformPath(relative)) {
+            throw new PlatformPathLockedError(resolved, relative);
+        }
+    }
+}
+/**
+ * Thrown when an agent loop attempts to mutate a path inside
+ * the platform's own runtime. Caught by the executor's switch
+ * statement and surfaced as a plain string error to the LLM,
+ * so the model sees the rejection in its next-turn tool result.
+ */
+export class PlatformPathLockedError extends Error {
+    resolved;
+    relative;
+    constructor(resolved, relative) {
+        super(`Error: Modification of Fixo CLI core architecture files is strictly ` +
+            `prohibited during workspace task cycles (target: ${relative}).`);
+        this.name = 'PlatformPathLockedError';
+        this.resolved = resolved;
+        this.relative = relative;
+    }
+}
+//# sourceMappingURL=workspace-guard.js.map

package/dist/workspace-guard.js.map

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

package/dist/workspace-lock.d.ts

@@ -0,0 +1,27 @@
+export interface LockState {
+    agentId: string;
+    type: 'read' | 'write';
+}
+export declare class WorkspaceLockManager {
+    private locks;
+    /**
+     * Tries to acquire a lock on a file.
+     * Returns true if successful, false if the lock is held by another agent.
+     */
+    acquireLock(filePath: string, agentId: string, lockType: 'read' | 'write'): boolean;
+    /**
+     * Releases a lock held by an agent on a file.
+     * Returns true if a lock was released, false if no lock existed for this agent.
+     */
+    releaseLock(filePath: string, agentId: string): boolean;
+    /**
+     * Releases all locks held by a specific agent.
+     */
+    releaseAllLocks(agentId: string): void;
+    /**
+     * Checks if a file is currently locked in a way that conflicts with the requested lockType.
+     */
+    isLocked(filePath: string, lockType: 'read' | 'write'): boolean;
+}
+export declare const workspaceLockManager: WorkspaceLockManager;
+//# sourceMappingURL=workspace-lock.d.ts.map

package/dist/workspace-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-lock.d.ts","sourceRoot":"","sources":["../src/workspace-lock.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAkC;IAE/C;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;IA0CnF;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAkBvD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAWtC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;CAehE;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/dist/workspace-lock.js

@@ -0,0 +1,95 @@
+import path from 'path';
+export class WorkspaceLockManager {
+    locks = new Map();
+    /**
+     * Tries to acquire a lock on a file.
+     * Returns true if successful, false if the lock is held by another agent.
+     */
+    acquireLock(filePath, agentId, lockType) {
+        const normalizedPath = path.resolve(filePath);
+        const activeLocks = this.locks.get(normalizedPath) || [];
+        if (activeLocks.length === 0) {
+            this.locks.set(normalizedPath, [{ agentId, type: lockType }]);
+            return true;
+        }
+        // Check if the current agent already holds a lock of the same or higher type
+        const agentLock = activeLocks.find(l => l.agentId === agentId);
+        if (agentLock) {
+            if (agentLock.type === lockType || agentLock.type === 'write') {
+                return true;
+            }
+            // Upgrade from read to write
+            if (lockType === 'write') {
+                // Can only upgrade if this agent is the ONLY reader
+                if (activeLocks.length === 1) {
+                    agentLock.type = 'write';
+                    return true;
+                }
+                return false; // Other agents hold read locks, cannot upgrade
+            }
+        }
+        // If any write lock is active, block all new locks
+        if (activeLocks.some(l => l.type === 'write')) {
+            return false;
+        }
+        // If new lock is write and there are existing read locks, block it
+        if (lockType === 'write') {
+            return false;
+        }
+        // Otherwise, add a shared read lock
+        activeLocks.push({ agentId, type: lockType });
+        this.locks.set(normalizedPath, activeLocks);
+        return true;
+    }
+    /**
+     * Releases a lock held by an agent on a file.
+     * Returns true if a lock was released, false if no lock existed for this agent.
+     */
+    releaseLock(filePath, agentId) {
+        const normalizedPath = path.resolve(filePath);
+        const activeLocks = this.locks.get(normalizedPath) || [];
+        const index = activeLocks.findIndex(l => l.agentId === agentId);
+        if (index === -1) {
+            return false;
+        }
+        activeLocks.splice(index, 1);
+        if (activeLocks.length === 0) {
+            this.locks.delete(normalizedPath);
+        }
+        else {
+            this.locks.set(normalizedPath, activeLocks);
+        }
+        return true;
+    }
+    /**
+     * Releases all locks held by a specific agent.
+     */
+    releaseAllLocks(agentId) {
+        for (const [filePath, activeLocks] of this.locks.entries()) {
+            const filtered = activeLocks.filter(l => l.agentId !== agentId);
+            if (filtered.length === 0) {
+                this.locks.delete(filePath);
+            }
+            else {
+                this.locks.set(filePath, filtered);
+            }
+        }
+    }
+    /**
+     * Checks if a file is currently locked in a way that conflicts with the requested lockType.
+     */
+    isLocked(filePath, lockType) {
+        const normalizedPath = path.resolve(filePath);
+        const activeLocks = this.locks.get(normalizedPath) || [];
+        if (activeLocks.length === 0) {
+            return false;
+        }
+        if (lockType === 'write') {
+            return true; // Any lock (read or write) blocks a new write lock
+        }
+        // For read locks, only an active write lock blocks it
+        return activeLocks.some(l => l.type === 'write');
+    }
+}
+export const workspaceLockManager = new WorkspaceLockManager();
+//# sourceMappingURL=workspace-lock.js.map

package/dist/workspace-lock.js.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "fixo-cli",
+  "version": "1.0.0",
+  "description": "FixO CLI — Autonomous Free Multi-Provider LLM Coding Tool",
+  "type": "module",
+  "bin": {
+    "fixo": "./dist/index.js",
+    "fixo-cli": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "node --import tsx --test src/__tests__/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "coding",
+    "agent",
+    "cli",
+    "llm",
+    "free",
+    "openai",
+    "groq",
+    "gemini",
+    "claude-code-alternative"
+  ],
+  "license": "Apache-2.0",
+  "author": "Abrar Akhunji",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Abrar-Akhunji/FIXO_CLI.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Abrar-Akhunji/FIXO_CLI/issues"
+  },
+  "homepage": "https://github.com/Abrar-Akhunji/FIXO_CLI#readme",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.0",
+    "cheerio": "^1.2.0",
+    "gpt-tokenizer": "^3.4.0",
+    "js-yaml": "^4.1.0",
+    "tree-sitter-bash": "^0.25.0",
+    "turndown": "^7.2.4",
+    "vscode-jsonrpc": "^8.2.1",
+    "web-tree-sitter": "^0.25.10"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.15.3",
+    "@types/turndown": "^5.0.6",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  }
+}