fixo-cli 1.0.0

package/dist/runtime/staging.js

@@ -0,0 +1,526 @@
+/**
+ * Atomic Workspace Shadow Staging — Pillar 2 of the Phase 2 safety
+ * refactor. The problem: a direct `fs.writeFileSync` to a user's
+ * source file is a non-atomic, non-rollbackable operation. If the
+ * process is killed mid-write, the user is left with a partially
+ * truncated file. If a downstream validation step fails, the
+ * user is left with a corrupted file. Both outcomes are
+ * unacceptable for a tool that markets itself as "enterprise
+ * safe".
+ *
+ * The fix: route every file write through a `.fixo/staging/`
+ * shadow directory, validate it (Pillar 3 LSP gate will plug in
+ * here), and only then perform an atomic `fs.renameSync` swap.
+ * If anything goes wrong, restore the original from a sibling
+ * `.pending.bak` file and the user is none the wiser.
+ *
+ * Layout under `cwd`:
+ *
+ *   .fixo/staging/<run-id>/
+ *     <sha256(targetPath)>.pending       # staged content
+ *     <sha256(targetPath)>.meta.json     # { targetPath, mode, createdAt }
+ *
+ *   <targetPath>.pending.bak             # temporary backup, only
+ *                                        # present during commit()
+ *
+ * The staging directory is created with mode `0o700`. Pending
+ * files and their metadata are written with mode `0o600`.
+ *
+ * The manager is synchronous (writes are small, no streaming),
+ * safe to construct at the start of a run, and thread-agnostic —
+ * the run-id is the only thing that disambiguates concurrent
+ * runs against the same workspace.
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { WorkspaceGuard } from '../workspace-guard.js';
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+/** Thrown when a requested staged write does not exist. */
+export class StagedWriteNotFoundError extends Error {
+    id;
+    constructor(id) {
+        super(`No staged write with id ${id}`);
+        this.name = 'StagedWriteNotFoundError';
+        this.id = id;
+    }
+}
+/** Thrown when commit() rolls back due to a pre-commit hook failure. */
+export class PreCommitHookRejectedError extends Error {
+    id;
+    cause;
+    constructor(id, cause) {
+        super(`Pre-commit hook rejected staged write ${id}: ${String(cause)}`);
+        this.name = 'PreCommitHookRejectedError';
+        this.id = id;
+        this.cause = cause;
+    }
+}
+/** Thrown when a target path escapes the workspace root. */
+export class StagingPathEscapeError extends Error {
+    attempted;
+    constructor(attempted) {
+        super(`Staging refused: path escapes workspace root: ${attempted}`);
+        this.name = 'StagingPathEscapeError';
+        this.attempted = attempted;
+    }
+}
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000; // 24h
+const STAGING_DIR_NAME = 'staging';
+const META_SUFFIX = '.meta.json';
+const PENDING_SUFFIX = '.pending';
+const BACKUP_SUFFIX = '.pending.bak';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const sha256 = (input) => crypto.createHash('sha256').update(input, 'utf-8').digest('hex');
+/** Try to chmod; ignore on platforms that don't support it. */
+const chmodSafe = (filePath, mode) => {
+    try {
+        fs.chmodSync(filePath, mode);
+    }
+    catch {
+        // ignore
+    }
+};
+/** Best-effort deletion that does not throw. */
+const rmSafe = (target) => {
+    try {
+        fs.unlinkSync(target);
+    }
+    catch {
+        // ignore
+    }
+};
+// ---------------------------------------------------------------------------
+// AtomicStagingManager
+// ---------------------------------------------------------------------------
+export class AtomicStagingManager {
+    cwd;
+    runId;
+    options;
+    /** Absolute path of the staging directory for this run. */
+    stagingDir;
+    constructor(cwd, runId, options = {}) {
+        if (!runId || !/^[A-Za-z0-9._-]+$/.test(runId)) {
+            throw new Error(`runId must match [A-Za-z0-9._-]+ (got: ${JSON.stringify(runId)})`);
+        }
+        this.cwd = path.resolve(cwd);
+        this.runId = runId;
+        this.options = {
+            ttlMs: options.ttlMs ?? DEFAULT_TTL_MS,
+            enabled: options.enabled ?? true,
+            preCommitHook: options.preCommitHook,
+            syntaxHealthCheck: options.syntaxHealthCheck,
+        };
+        this.stagingDir = path.join(this.cwd, '.fixo', STAGING_DIR_NAME, this.runId);
+    }
+    /** Ensure the staging directory exists with mode 0o700. */
+    ensureStagingDir() {
+        fs.mkdirSync(this.stagingDir, { recursive: true, mode: 0o700 });
+        chmodSafe(this.stagingDir, 0o700);
+    }
+    /** Reject paths that escape the workspace root. */
+    resolveTarget(relativeOrAbsolute) {
+        const guard = new WorkspaceGuard(this.cwd);
+        try {
+            return guard.resolve(relativeOrAbsolute, 'file');
+        }
+        catch {
+            throw new StagingPathEscapeError(relativeOrAbsolute);
+        }
+    }
+    /**
+     * Stage a file for atomic write. Writes the content to
+     * `<staging>/<sha256(target)>.pending` and a sidecar
+     * `<staging>/<sha256(target)>.meta.json` containing the target
+     * path, mode, and timestamp. Returns the staged write metadata.
+     */
+    stage(target, content, mode = 0o644) {
+        const resolved = this.resolveTarget(target);
+        const id = sha256(resolved);
+        this.ensureStagingDir();
+        const pendingPath = path.join(this.stagingDir, `${id}${PENDING_SUFFIX}`);
+        const metaPath = path.join(this.stagingDir, `${id}${META_SUFFIX}`);
+        // Write pending content (atomic: write to temp + rename).
+        const tmpPath = `${pendingPath}.tmp`;
+        fs.writeFileSync(tmpPath, content, { encoding: 'utf-8', mode: 0o600 });
+        chmodSafe(tmpPath, 0o600);
+        fs.renameSync(tmpPath, pendingPath);
+        // Write meta sidecar.
+        const meta = {
+            targetPath: resolved,
+            mode,
+            createdAt: Date.now(),
+        };
+        fs.writeFileSync(metaPath, JSON.stringify(meta), {
+            encoding: 'utf-8',
+            mode: 0o600,
+        });
+        chmodSafe(metaPath, 0o600);
+        return {
+            id,
+            targetPath: resolved,
+            pendingPath,
+            metaPath,
+            createdAt: meta.createdAt,
+            mode,
+        };
+    }
+    /** Read a staged write's content (lazy — only read on demand). */
+    read(id) {
+        const entry = this.readEntry(id);
+        return fs.readFileSync(entry.pendingPath, 'utf-8');
+    }
+    /** Look up a staged write by id without touching the file system further. */
+    readEntry(id) {
+        const pendingPath = path.join(this.stagingDir, `${id}${PENDING_SUFFIX}`);
+        const metaPath = path.join(this.stagingDir, `${id}${META_SUFFIX}`);
+        if (!fs.existsSync(pendingPath) || !fs.existsSync(metaPath)) {
+            throw new StagedWriteNotFoundError(id);
+        }
+        const raw = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+        return {
+            id,
+            targetPath: raw.targetPath,
+            pendingPath,
+            metaPath,
+            createdAt: raw.createdAt,
+            mode: raw.mode,
+        };
+    }
+    /** List all staged writes for this run. */
+    list() {
+        if (!fs.existsSync(this.stagingDir))
+            return [];
+        const names = fs.readdirSync(this.stagingDir);
+        const entries = [];
+        for (const name of names) {
+            if (!name.endsWith(META_SUFFIX))
+                continue;
+            const id = name.slice(0, -META_SUFFIX.length);
+            try {
+                entries.push(this.readEntry(id));
+            }
+            catch {
+                // Stale meta without a pending counterpart — skip.
+            }
+        }
+        return entries;
+    }
+    /**
+     * Remove a staged write without touching the target. Used by the
+     * LSP pre-save gate when it rejects a write.
+     */
+    discard(id) {
+        const entry = this.readEntry(id);
+        rmSafe(entry.pendingPath);
+        rmSafe(entry.metaPath);
+    }
+    /**
+     * Commit a staged write to its target path. The flow is:
+     *
+     *   1. Run the optional pre-commit hook (Pillar 3 plugs in here).
+     *   2. Ensure the parent directory of the target exists.
+     *   3. If the target exists, rename it to `<target>.pending.bak`.
+     *   4. Rename the pending file to the target.
+     *   5. Delete the backup.
+     *
+     * If any step fails, the backup (if any) is restored to the
+     * target and the backup itself is removed. The pending and
+     * metadata files are always cleaned up on success.
+     */
+    async commit(id) {
+        const entry = this.readEntry(id);
+        const target = entry.targetPath;
+        const backup = `${target}${BACKUP_SUFFIX}`;
+        const existed = fs.existsSync(target);
+        // 1. Pre-commit hook (Pillar 3 plugs in here).
+        if (this.options.preCommitHook) {
+            try {
+                await this.options.preCommitHook(entry);
+            }
+            catch (cause) {
+                // Hook rejected — discard the staged write but do NOT
+                // touch the target.
+                this.discard(id);
+                throw new PreCommitHookRejectedError(id, cause);
+            }
+        }
+        // 1.5 Pillar 5 / Protection 3 — structural syntax health
+        // check. Runs *after* the LSP gate and *before* the rename
+        // swap. If the staged content is syntactically broken the
+        // write is rejected and discarded; the target is preserved.
+        if (this.options.syntaxHealthCheck) {
+            const content = fs.readFileSync(entry.pendingPath, 'utf-8');
+            try {
+                await this.options.syntaxHealthCheck(entry, content);
+            }
+            catch (cause) {
+                this.discard(id);
+                throw new PreCommitHookRejectedError(id, cause);
+            }
+        }
+        if (!this.options.enabled) {
+            // Dry-run mode: leave the staged write in place.
+            const bytes = Buffer.byteLength(fs.readFileSync(entry.pendingPath), 'utf-8');
+            return {
+                committed: false,
+                targetPath: target,
+                backupCreated: false,
+                bytesWritten: bytes,
+                committedAt: new Date().toISOString(),
+            };
+        }
+        // 2. Ensure parent directory exists.
+        const parent = path.dirname(target);
+        fs.mkdirSync(parent, { recursive: true });
+        try {
+            // 3. Back up the existing file (if any).
+            if (existed) {
+                // If a stale backup is present from a previous failed
+                // commit, clear it first.
+                rmSafe(backup);
+                fs.renameSync(target, backup);
+            }
+            // 4. Swap pending into place.
+            fs.renameSync(entry.pendingPath, target);
+            // Apply mode.
+            try {
+                fs.chmodSync(target, entry.mode);
+            }
+            catch {
+                // ignore
+            }
+            // 5. Clear the backup.
+            if (existed)
+                rmSafe(backup);
+            const bytes = Buffer.byteLength(fs.readFileSync(target, 'utf-8'), 'utf-8');
+            // Tidy up the meta sidecar.
+            rmSafe(entry.metaPath);
+            return {
+                committed: true,
+                targetPath: target,
+                backupCreated: existed,
+                bytesWritten: bytes,
+                committedAt: new Date().toISOString(),
+            };
+        }
+        catch (err) {
+            // Rollback: restore the backup, remove the .pending if any.
+            try {
+                if (existed && fs.existsSync(backup)) {
+                    if (fs.existsSync(target))
+                        fs.unlinkSync(target);
+                    fs.renameSync(backup, target);
+                }
+                else if (!existed && fs.existsSync(target)) {
+                    // We created the file but the rename to target itself
+                    // succeeded — only reached if chmod fails. Target is
+                    // already correct; nothing to undo.
+                }
+            }
+            catch {
+                // Last-ditch: leave the backup in place so a human can
+                // recover. The next GC pass will clean it up.
+            }
+            // Pending may have been consumed; if not, leave it.
+            throw err;
+        }
+    }
+    /**
+     * Apply a surgical in-place edit to an existing file. The new
+     * content is staged under the same `.fixo/staging/<runId>/<id>.pending`
+     * layout and the commit step mirrors `commit()`: backup the
+     * target, atomic rename, clear the backup, clear the meta.
+     *
+     * This is functionally `stage() + commit()` collapsed into a
+     * single call, but the on-disk layout, backup semantics, and
+     * rollback path are identical. Provided so `str_replace` (and
+     * future surgical-edit tools) can route their edits through the
+     * same atomic staging pipeline as `write_file` without touching
+     * the existing `stage()` / `commit()` flow.
+     *
+     * The optional `meta` argument is recorded into `.meta.json` so
+     * the audit trail records the originator of the edit (e.g. a
+     * `str_replace` tool call vs. a `subagent`). The method never
+     * weakens the Pillar 2 atomicity guarantee: if the rename
+     * swap fails, the backup is restored and the original file is
+     * preserved byte-for-byte.
+     */
+    async applySurgicalReplace(target, newContent, meta) {
+        const resolved = this.resolveTarget(target);
+        const id = sha256(resolved);
+        this.ensureStagingDir();
+        const pendingPath = path.join(this.stagingDir, `${id}${PENDING_SUFFIX}`);
+        const metaPath = path.join(this.stagingDir, `${id}${META_SUFFIX}`);
+        const backup = `${resolved}${BACKUP_SUFFIX}`;
+        const existed = fs.existsSync(resolved);
+        // 1. Write the new content to the .pending file (atomic via temp+rename).
+        const tmpPath = `${pendingPath}.tmp`;
+        fs.writeFileSync(tmpPath, newContent, { encoding: 'utf-8', mode: 0o600 });
+        chmodSafe(tmpPath, 0o600);
+        fs.renameSync(tmpPath, pendingPath);
+        // 2. Write the sidecar meta with audit trail.
+        const metaPayload = {
+            targetPath: resolved,
+            mode: 0o644,
+            createdAt: Date.now(),
+            reason: meta.reason,
+            actorId: meta.actorId,
+            runId: meta.runId,
+        };
+        fs.writeFileSync(metaPath, JSON.stringify(metaPayload), {
+            encoding: 'utf-8',
+            mode: 0o600,
+        });
+        chmodSafe(metaPath, 0o600);
+        // 3. Ensure parent dir exists.
+        const parent = path.dirname(resolved);
+        fs.mkdirSync(parent, { recursive: true });
+        try {
+            // 4. Back up the existing file (if any).
+            if (existed) {
+                // Clear any stale backup from a previous failed commit.
+                rmSafe(backup);
+                fs.renameSync(resolved, backup);
+            }
+            // 5. Atomic swap of the pending file into the target.
+            fs.renameSync(pendingPath, resolved);
+            // 6. Apply file mode (best-effort across platforms).
+            try {
+                fs.chmodSync(resolved, 0o644);
+            }
+            catch {
+                // ignore
+            }
+            // 7. Clear backup and meta sidecar.
+            if (existed)
+                rmSafe(backup);
+            rmSafe(metaPath);
+            const bytes = Buffer.byteLength(fs.readFileSync(resolved, 'utf-8'), 'utf-8');
+            return { ok: true, path: resolved, bytes };
+        }
+        catch (err) {
+            // Rollback: restore the backup, clean up the .pending if any.
+            try {
+                if (existed && fs.existsSync(backup)) {
+                    if (fs.existsSync(resolved))
+                        fs.unlinkSync(resolved);
+                    fs.renameSync(backup, resolved);
+                }
+                else if (!existed && fs.existsSync(resolved)) {
+                    // We created the file but the rename to target itself
+                    // succeeded — only reached if chmod fails. Target is
+                    // already correct; nothing to undo.
+                }
+            }
+            catch {
+                // Last-ditch: leave the backup in place so a human can
+                // recover. The next GC pass will clean it up.
+            }
+            // Pending may have been consumed; if not, leave it.
+            throw err;
+        }
+    }
+    /**
+     * Remove any staged write older than `ttlMs`. Returns the number
+     * of entries removed. Designed to be cheap at run start
+     * (typically <2ms for a few hundred entries).
+     */
+    gc(now = Date.now()) {
+        if (!fs.existsSync(this.stagingDir))
+            return 0;
+        const cutoff = now - this.options.ttlMs;
+        let removed = 0;
+        for (const entry of this.list()) {
+            if (entry.createdAt < cutoff) {
+                this.discard(entry.id);
+                removed += 1;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Sweep every run-id directory under `<cwd>/.fixo/staging/`.
+     * Returns the total number of expired entries removed. Called
+     * automatically at the start of every streaming run and is also
+     * exposed via the `/fixo gc` slash command.
+     */
+    static garbageCollectAll(cwd, ttlMs) {
+        const root = path.resolve(cwd);
+        const stagingRoot = path.join(root, '.fixo', STAGING_DIR_NAME);
+        if (!fs.existsSync(stagingRoot))
+            return 0;
+        let removed = 0;
+        let runDirs;
+        try {
+            runDirs = fs.readdirSync(stagingRoot);
+        }
+        catch {
+            return 0;
+        }
+        for (const runDir of runDirs) {
+            const runPath = path.join(stagingRoot, runDir);
+            let stat;
+            try {
+                stat = fs.lstatSync(runPath);
+            }
+            catch {
+                continue;
+            }
+            if (!stat.isDirectory())
+                continue;
+            // Safe: runDir names are sanitised in the constructor.
+            const mgr = new AtomicStagingManager(root, runDir, { ttlMs });
+            removed += mgr.gc();
+        }
+        return removed;
+    }
+    /**
+     * Discard every staged write for the given (cwd, runId) pair. Used
+     * when an agent is force-killed (e.g. loop-trap hard-abort) so the
+     * workspace is left in its pre-run state. Returns the number of
+     * entries removed.
+     *
+     * Best-effort: a failure to remove a single entry is logged and
+     * swallowed so the caller never sees an exception from cleanup.
+     */
+    static rollbackAll(cwd, runId) {
+        const root = path.resolve(cwd);
+        let removed = 0;
+        let mgr;
+        try {
+            mgr = new AtomicStagingManager(root, runId);
+        }
+        catch {
+            return 0;
+        }
+        if (!fs.existsSync(mgr.stagingDir))
+            return 0;
+        const entries = mgr.list();
+        for (const entry of entries) {
+            try {
+                mgr.discard(entry.id);
+                removed += 1;
+            }
+            catch (err) {
+                console.error(`[AtomicStagingManager.rollbackAll] failed to discard ${entry.id}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Best-effort: remove the now-empty run directory.
+        try {
+            fs.rmSync(mgr.stagingDir, { recursive: true, force: true });
+        }
+        catch {
+            // ignore
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=staging.js.map

package/dist/runtime/staging.js.map

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

package/dist/runtime/task-session.d.ts

@@ -0,0 +1,95 @@
+import { WorkspaceGuard } from '../workspace-guard.js';
+import type { PolicyProfile } from './policy.js';
+export interface TaskEvent {
+    type: string;
+    timestamp: string;
+    [key: string]: unknown;
+}
+export interface TaskSessionSummary {
+    id: string;
+    task: string;
+    model: string;
+    cwd: string;
+    startedAt: string;
+    endedAt?: string;
+    status: 'running' | 'success' | 'error';
+    modifiedFiles: string[];
+    verification: string[];
+    response?: string;
+}
+export interface ChangeRecord {
+    file: string;
+    beforeHash: string | null;
+    afterHash: string | null;
+    beforeExists: boolean;
+    afterExists: boolean;
+    beforeSnapshot?: string;
+}
+export declare class TaskSession {
+    readonly id: string;
+    readonly cwd: string;
+    readonly guard: WorkspaceGuard;
+    readonly policy: PolicyProfile;
+    readonly runDir: string;
+    readonly startedAt: string;
+    readonly readFiles: Map<string, string | null>;
+    readonly changedFiles: Map<string, ChangeRecord>;
+    /**
+     * Tracks which files the agent has done a *structural* pre-scan on
+     * (via `extract_symbols` / `extract_imports`). The map is read by
+     * Pillar 3 (Context-Budget Guard) to verify that a large file the
+     * LLM wants to read was first reduced to its declarations. The
+     * `noteStructuralMap` and `hasStructuralMap` helpers below are
+     * intentionally side-effect-free for tests.
+     */
+    readonly structuralMaps: Map<string, {
+        symbols: boolean;
+        imports: boolean;
+    }>;
+    private summary;
+    constructor(opts: {
+        cwd: string;
+        task: string;
+        model: string;
+        policy?: PolicyProfile;
+    });
+    record(type: string, data?: Record<string, unknown>): void;
+    noteRead(file: string): void;
+    /**
+     * Mark a file as having been pre-scanned structurally. The
+     * `flags` object records which dimensions were extracted so
+     * Pillar 3 can decide whether the LLM is still missing
+     * information when it later calls `read_file` on the same path.
+     */
+    noteStructuralMap(file: string, flags: {
+        symbols: boolean;
+        imports: boolean;
+    }): void;
+    /**
+     * Returns the structural pre-scan flags recorded for a file.
+     * Returns `null` if the file has never been pre-scanned — the
+     * caller should treat this as a hard-fail for the
+     * Context-Budget Guard rule.
+     */
+    hasStructuralMap(file: string): {
+        symbols: boolean;
+        imports: boolean;
+    } | null;
+    captureBefore(file: string): void;
+    noteChange(file: string): void;
+    canMutate(file: string): {
+        ok: boolean;
+        reason?: string;
+    };
+    addVerification(message: string): void;
+    finish(status: 'success' | 'error', response: string): void;
+    private writeSummary;
+    private writeChanges;
+}
+export declare function hashFile(file: string): string | null;
+export declare function gcRuns(cwd: string, keepLimit?: number): void;
+export declare function listRuns(cwd: string, limit?: number): TaskSessionSummary[];
+export declare function showRun(cwd: string, id: string): string;
+export declare function undoRun(cwd: string, id: string): string;
+export declare function revertAgentCommit(cwd: string): string;
+//# sourceMappingURL=task-session.d.ts.map

package/dist/runtime/task-session.d.ts.map

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