fixo-cli 1.0.0

package/dist/runtime/task-session.js

@@ -0,0 +1,263 @@
+import crypto from 'crypto';
+import fs from 'fs';
+import path from 'path';
+import { execFileSync } from 'child_process';
+import { WorkspaceGuard } from '../workspace-guard.js';
+import { redactSecrets } from './redaction.js';
+export class TaskSession {
+    id;
+    cwd;
+    guard;
+    policy;
+    runDir;
+    startedAt;
+    readFiles = new Map();
+    changedFiles = new Map();
+    /**
+     * 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.
+     */
+    structuralMaps = new Map();
+    summary;
+    constructor(opts) {
+        this.id = `${new Date().toISOString().replace(/[:.]/g, '-')}-${crypto.randomBytes(4).toString('hex')}`;
+        this.cwd = path.resolve(opts.cwd);
+        this.guard = new WorkspaceGuard(this.cwd);
+        this.policy = opts.policy ?? 'shell-confirm';
+        this.startedAt = new Date().toISOString();
+        this.runDir = path.join(this.cwd, '.fixo', 'runs', this.id);
+        fs.mkdirSync(this.runDir, { recursive: true });
+        fs.mkdirSync(path.join(this.runDir, 'snapshots'), { recursive: true });
+        this.summary = {
+            id: this.id,
+            task: opts.task,
+            model: opts.model,
+            cwd: this.cwd,
+            startedAt: this.startedAt,
+            status: 'running',
+            modifiedFiles: [],
+            verification: [],
+        };
+        this.writeSummary();
+        this.record('run_started', { task: opts.task, model: opts.model, policy: this.policy });
+        gcRuns(this.cwd, 50);
+    }
+    record(type, data = {}) {
+        const event = redactSecrets(JSON.stringify({ type, timestamp: new Date().toISOString(), ...data }));
+        fs.appendFileSync(path.join(this.runDir, 'events.jsonl'), `${event}\n`, 'utf-8');
+    }
+    noteRead(file) {
+        const resolved = this.guard.resolve(file, 'file');
+        this.readFiles.set(resolved, hashFile(resolved));
+        this.record('file_read', { file: this.guard.relative(resolved), hash: this.readFiles.get(resolved) });
+    }
+    /**
+     * 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, flags) {
+        const resolved = this.guard.resolve(file, 'file');
+        const existing = this.structuralMaps.get(resolved) ?? {
+            symbols: false,
+            imports: false,
+        };
+        this.structuralMaps.set(resolved, {
+            symbols: existing.symbols || flags.symbols,
+            imports: existing.imports || flags.imports,
+        });
+        this.record('structural_map', {
+            file: this.guard.relative(resolved),
+            ...flags,
+        });
+    }
+    /**
+     * 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) {
+        const resolved = this.guard.resolve(file, 'file');
+        return this.structuralMaps.get(resolved) ?? null;
+    }
+    captureBefore(file) {
+        const resolved = this.guard.resolve(file, 'file');
+        if (this.changedFiles.has(resolved))
+            return;
+        const beforeHash = hashFile(resolved);
+        const beforeExists = beforeHash !== null;
+        let beforeSnapshot;
+        if (beforeExists) {
+            beforeSnapshot = path.join('snapshots', `${crypto.randomBytes(6).toString('hex')}.before`);
+            fs.copyFileSync(resolved, path.join(this.runDir, beforeSnapshot));
+        }
+        const record = {
+            file: this.guard.relative(resolved),
+            beforeHash,
+            afterHash: beforeHash,
+            beforeExists,
+            afterExists: beforeExists,
+            beforeSnapshot,
+        };
+        this.changedFiles.set(resolved, record);
+        this.writeChanges();
+    }
+    noteChange(file) {
+        const resolved = this.guard.resolve(file, 'file');
+        if (!this.changedFiles.has(resolved))
+            this.captureBefore(resolved);
+        const existing = this.changedFiles.get(resolved);
+        const after = hashFile(resolved);
+        existing.afterHash = after;
+        existing.afterExists = after !== null;
+        this.changedFiles.set(resolved, existing);
+        this.summary.modifiedFiles = Array.from(this.changedFiles.keys()).map(f => this.guard.relative(f));
+        this.writeChanges();
+        this.writeSummary();
+        this.record('file_changed', { file: this.guard.relative(resolved), before: existing.beforeHash, after });
+    }
+    canMutate(file) {
+        const resolved = this.guard.resolve(file, 'file');
+        if (!fs.existsSync(resolved))
+            return { ok: true };
+        const readHash = this.readFiles.get(resolved);
+        if (readHash === undefined) {
+            return { ok: false, reason: `Refusing to modify unread file: ${this.guard.relative(resolved)}` };
+        }
+        const currentHash = hashFile(resolved);
+        if (readHash !== currentHash) {
+            return { ok: false, reason: `Refusing stale edit; file changed since read: ${this.guard.relative(resolved)}` };
+        }
+        return { ok: true };
+    }
+    addVerification(message) {
+        this.summary.verification.push(redactSecrets(message));
+        this.writeSummary();
+        this.record('verification', { message });
+    }
+    finish(status, response) {
+        this.summary.status = status;
+        this.summary.endedAt = new Date().toISOString();
+        this.summary.response = redactSecrets(response);
+        this.writeSummary();
+        this.record('run_finished', { status });
+    }
+    writeSummary() {
+        fs.writeFileSync(path.join(this.runDir, 'run.json'), JSON.stringify(this.summary, null, 2) + '\n', 'utf-8');
+    }
+    writeChanges() {
+        fs.writeFileSync(path.join(this.runDir, 'changes.json'), JSON.stringify(Array.from(this.changedFiles.values()), null, 2) + '\n', 'utf-8');
+    }
+}
+export function hashFile(file) {
+    if (!fs.existsSync(file))
+        return null;
+    const stat = fs.statSync(file);
+    if (!stat.isFile())
+        return null;
+    return crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');
+}
+export function gcRuns(cwd, keepLimit = 50) {
+    try {
+        const root = path.join(cwd, '.fixo', 'runs');
+        if (!fs.existsSync(root))
+            return;
+        const runs = fs.readdirSync(root).sort().reverse();
+        if (runs.length <= keepLimit)
+            return;
+        const toDelete = runs.slice(keepLimit);
+        for (const run of toDelete) {
+            fs.rmSync(path.join(root, run), { recursive: true, force: true });
+        }
+    }
+    catch (err) {
+        console.error('[TaskSession] Warning: failed to garbage collect old runs', err);
+    }
+}
+export function listRuns(cwd, limit = 10) {
+    const root = path.join(cwd, '.fixo', 'runs');
+    if (!fs.existsSync(root))
+        return [];
+    return fs.readdirSync(root)
+        .sort()
+        .reverse()
+        .slice(0, limit)
+        .map(id => {
+        const file = path.join(root, id, 'run.json');
+        if (!fs.existsSync(file))
+            return null;
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    })
+        .filter((run) => run !== null);
+}
+export function showRun(cwd, id) {
+    const file = path.join(cwd, '.fixo', 'runs', id, 'run.json');
+    if (!fs.existsSync(file))
+        return `Run not found: ${id}`;
+    const run = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    return [
+        `Run ${run.id}`,
+        `Status: ${run.status}`,
+        `Task: ${run.task}`,
+        `Model: ${run.model}`,
+        `Started: ${run.startedAt}`,
+        `Ended: ${run.endedAt ?? 'running'}`,
+        `Files: ${run.modifiedFiles.length ? run.modifiedFiles.join(', ') : '(none)'}`,
+        `Verification: ${run.verification.length ? run.verification.join(' | ') : '(none)'}`,
+    ].join('\n');
+}
+export function undoRun(cwd, id) {
+    const file = path.join(cwd, '.fixo', 'runs', id, 'run.json');
+    if (!fs.existsSync(file))
+        return `Run not found: ${id}`;
+    const runDir = path.dirname(file);
+    const changesFile = path.join(runDir, 'changes.json');
+    if (!fs.existsSync(changesFile))
+        return `Undo refused: run ${id} has no change ledger.`;
+    const guard = new WorkspaceGuard(cwd);
+    const changes = JSON.parse(fs.readFileSync(changesFile, 'utf-8'));
+    const conflicts = [];
+    for (const change of changes) {
+        const target = guard.resolve(change.file, 'rollback file');
+        const currentHash = hashFile(target);
+        if (currentHash !== change.afterHash) {
+            conflicts.push(`${change.file} changed after run (expected ${change.afterHash ?? 'missing'}, got ${currentHash ?? 'missing'})`);
+        }
+    }
+    if (conflicts.length > 0) {
+        return `Undo refused because files changed after the run:\n${conflicts.join('\n')}`;
+    }
+    for (const change of changes.slice().reverse()) {
+        const target = guard.resolve(change.file, 'rollback file');
+        if (change.beforeExists) {
+            if (!change.beforeSnapshot)
+                return `Undo failed: missing snapshot for ${change.file}`;
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.copyFileSync(path.join(runDir, change.beforeSnapshot), target);
+        }
+        else if (fs.existsSync(target)) {
+            fs.unlinkSync(target);
+        }
+    }
+    return `Undid ${changes.length} file change(s) from run ${id}.`;
+}
+export function revertAgentCommit(cwd) {
+    try {
+        const message = execFileSync('git', ['log', '-1', '--format=%s'], { cwd, encoding: 'utf-8' }).trim();
+        if (!message.includes('[fixo-run:')) {
+            return 'Undo refused: last commit is not marked as a FixO-owned commit.';
+        }
+        execFileSync('git', ['revert', '--no-edit', 'HEAD'], { cwd, encoding: 'utf-8' });
+        return 'Performed a safe git revert of the last FixO-owned commit.';
+    }
+    catch (error) {
+        return `Undo failed: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+//# sourceMappingURL=task-session.js.map

package/dist/runtime/task-session.js.map

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

package/dist/runtime/worktree.d.ts

@@ -0,0 +1,55 @@
+export interface CreateWorktreeInput {
+    /** Branch to create (and check out in the new worktree). */
+    branch: string;
+    /** Base branch / ref to fork from. Default: 'HEAD'. */
+    base?: string;
+    /** Where to put the worktree directory. Default: `<cwd>/.fixo/worktrees/<branch>`. */
+    path?: string;
+}
+export interface WorktreeResult {
+    ok: boolean;
+    /** Path to the new worktree (create) / merged branch name (merge) / removed path (remove). */
+    detail: string;
+    /** Captured git output. */
+    output: string;
+    /** Error message, if any. */
+    error?: string;
+}
+/** Create a new worktree at `path` on `branch` forked from `base`. */
+export declare function createWorktree(cwd: string, input: CreateWorktreeInput): WorktreeResult;
+/** Merge the worktree's branch back into the current branch of `cwd`. */
+export declare function mergeWorktree(cwd: string, branch: string, targetBranch?: string): WorktreeResult;
+/** Remove a worktree at `worktreePath` and (optionally) delete its branch. */
+export declare function removeWorktree(cwd: string, worktreePath: string, opts?: {
+    deleteBranch?: boolean;
+    branch?: string;
+}): WorktreeResult;
+export type WorktreeAnnotation = {
+    op: 'create';
+    branch: string;
+    base?: string;
+    path?: string;
+} | {
+    op: 'merge';
+    branch: string;
+} | {
+    op: 'remove';
+    path: string;
+    deleteBranch?: boolean;
+    branch?: string;
+};
+/**
+ * Extract all worktree annotations from `text`. Annotations
+ * are returned in the order they appear. The text is not
+ * mutated.
+ */
+export declare function parseWorktreeAnnotations(text: string): WorktreeAnnotation[];
+/**
+ * Apply a list of worktree annotations. Each annotation runs
+ * in order; failures are returned but do not stop the chain.
+ * Returns a list of results, one per annotation.
+ */
+export declare function applyWorktreeAnnotations(cwd: string, annotations: WorktreeAnnotation[]): WorktreeResult[];
+/** Strip worktree annotations from a string (used to clean the assistant output). */
+export declare function stripWorktreeAnnotations(text: string): string;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/runtime/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/runtime/worktree.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAYtF;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,CAUhG;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACrD,cAAc,CAkBhB;AAID,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA0C5E;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAY3E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,kBAAkB,EAAE,GAChC,cAAc,EAAE,CAclB;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/runtime/worktree.js

@@ -0,0 +1,175 @@
+/**
+ * worktree.ts — Git worktree management + annotation parser.
+ *
+ * Phase 3.6 spec:
+ *   - Three operations: create / merge / remove.
+ *   - NOT exposed as a tool. Instead, the SingleAgent scans
+ *     its final assistant message for inline annotations of
+ *     the form `[worktree:create branch=x]` / `[worktree:merge]`
+ *     / `[worktree:remove]` and dispatches the corresponding
+ *     worktree operation.
+ *   - All operations are guarded by `git isGitRepo(cwd)` and
+ *     use `execFileSync('git', ...)` so we never go through a
+ *     shell.
+ *
+ * Annotation format (single line, anywhere in assistant text):
+ *   [worktree:create branch=foo]
+ *   [worktree:create branch=foo base=main]
+ *   [worktree:merge]
+ *   [worktree:remove path=<absolute path to worktree>]
+ */
+import { execFileSync } from 'node:child_process';
+function runGit(cwd, args) {
+    try {
+        return execFileSync('git', args, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (error) {
+        const err = error;
+        const stderr = typeof err.stderr === 'string' ? err.stderr : (err.stderr ? err.stderr.toString() : err.message ?? '');
+        throw new Error(`Git error (git ${args.join(' ')}): ${stderr.trim()}`);
+    }
+}
+function defaultWorktreePath(cwd, branch) {
+    const safe = branch.replace(/[^A-Za-z0-9._/-]/g, '-');
+    return `${cwd}/.fixo/worktrees/${safe}`;
+}
+/** Create a new worktree at `path` on `branch` forked from `base`. */
+export function createWorktree(cwd, input) {
+    if (!input.branch || typeof input.branch !== 'string') {
+        return { ok: false, detail: '', output: '', error: 'createWorktree: branch is required' };
+    }
+    const worktreePath = input.path ?? defaultWorktreePath(cwd, input.branch);
+    const base = input.base ?? 'HEAD';
+    try {
+        const out = runGit(cwd, ['worktree', 'add', '-b', input.branch, worktreePath, base]);
+        return { ok: true, detail: worktreePath, output: out };
+    }
+    catch (err) {
+        return { ok: false, detail: worktreePath, output: '', error: err.message };
+    }
+}
+/** Merge the worktree's branch back into the current branch of `cwd`. */
+export function mergeWorktree(cwd, branch, targetBranch) {
+    if (!branch) {
+        return { ok: false, detail: '', output: '', error: 'mergeWorktree: branch is required' };
+    }
+    try {
+        const out = runGit(cwd, ['merge', '--no-ff', branch, '-m', `Merge worktree branch ${branch}`]);
+        return { ok: true, detail: targetBranch ?? branch, output: out };
+    }
+    catch (err) {
+        return { ok: false, detail: branch, output: '', error: err.message };
+    }
+}
+/** Remove a worktree at `worktreePath` and (optionally) delete its branch. */
+export function removeWorktree(cwd, worktreePath, opts = {}) {
+    if (!worktreePath) {
+        return { ok: false, detail: '', output: '', error: 'removeWorktree: worktreePath is required' };
+    }
+    try {
+        const out = runGit(cwd, ['worktree', 'remove', worktreePath, '--force']);
+        let extra = '';
+        if (opts.deleteBranch && opts.branch) {
+            try {
+                extra = '\n' + runGit(cwd, ['branch', '-D', opts.branch]);
+            }
+            catch {
+                // Branch may already be gone or merged — non-fatal.
+            }
+        }
+        return { ok: true, detail: worktreePath, output: out + extra };
+    }
+    catch (err) {
+        return { ok: false, detail: worktreePath, output: '', error: err.message };
+    }
+}
+const ANNOTATION_RE = /\[worktree:(\w+)([^\]]*)\]/g;
+/**
+ * Extract a single annotation from a `[worktree:op key=value ...]`
+ * token. Returns null if the token is malformed.
+ */
+function parseOneAnnotation(op, body) {
+    // Parse key=value pairs (values may be quoted; we accept
+    // any non-whitespace token).
+    const pairs = {};
+    const re = /(\w+)=(?:"([^"]*)"|(\S+))/g;
+    let m;
+    while ((m = re.exec(body)) !== null) {
+        pairs[m[1]] = m[2] ?? m[3] ?? '';
+    }
+    if (op === 'create') {
+        if (!pairs.branch)
+            return null;
+        return {
+            op: 'create',
+            branch: pairs.branch,
+            base: pairs.base,
+            path: pairs.path,
+        };
+    }
+    if (op === 'merge') {
+        if (!pairs.branch)
+            return null;
+        return { op: 'merge', branch: pairs.branch };
+    }
+    if (op === 'remove') {
+        if (!pairs.path)
+            return null;
+        return {
+            op: 'remove',
+            path: pairs.path,
+            deleteBranch: pairs.deleteBranch === 'true' || pairs.deleteBranch === '1',
+            branch: pairs.branch,
+        };
+    }
+    return null;
+}
+/**
+ * Extract all worktree annotations from `text`. Annotations
+ * are returned in the order they appear. The text is not
+ * mutated.
+ */
+export function parseWorktreeAnnotations(text) {
+    if (typeof text !== 'string' || text.length === 0)
+        return [];
+    const out = [];
+    ANNOTATION_RE.lastIndex = 0;
+    let m;
+    while ((m = ANNOTATION_RE.exec(text)) !== null) {
+        const op = m[1];
+        const body = m[2] ?? '';
+        const parsed = parseOneAnnotation(op, body);
+        if (parsed)
+            out.push(parsed);
+    }
+    return out;
+}
+/**
+ * Apply a list of worktree annotations. Each annotation runs
+ * in order; failures are returned but do not stop the chain.
+ * Returns a list of results, one per annotation.
+ */
+export function applyWorktreeAnnotations(cwd, annotations) {
+    return annotations.map(ann => {
+        if (ann.op === 'create') {
+            return createWorktree(cwd, { branch: ann.branch, base: ann.base, path: ann.path });
+        }
+        if (ann.op === 'merge') {
+            return mergeWorktree(cwd, ann.branch);
+        }
+        // remove
+        return removeWorktree(cwd, ann.path, {
+            deleteBranch: ann.deleteBranch,
+            branch: ann.branch,
+        });
+    });
+}
+/** Strip worktree annotations from a string (used to clean the assistant output). */
+export function stripWorktreeAnnotations(text) {
+    return text.replace(ANNOTATION_RE, '').replace(/[ \t]{2,}/g, ' ').trim();
+}
+//# sourceMappingURL=worktree.js.map

package/dist/runtime/worktree.js.map

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

package/dist/setup-wizard.d.ts

@@ -0,0 +1,8 @@
+import type { FreeLLMConfig } from './config.js';
+/**
+ * Runs the interactive first-run setup wizard for FixO CLI.
+ * Links the CLI terminal to the FreeLLMAPI SaaS cloud by prompting
+ * for the master API key, destination URL, and saving it to the configuration.
+ */
+export declare function runSetupWizard(): Promise<FreeLLMConfig>;
+//# sourceMappingURL=setup-wizard.d.ts.map

package/dist/setup-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.d.ts","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CA0E7D"}

package/dist/setup-wizard.js

@@ -0,0 +1,73 @@
+import * as p from '@clack/prompts';
+import { getDefaultConfig, saveConfig, DEFAULT_API_URL } from './config.js';
+/**
+ * Runs the interactive first-run setup wizard for FixO CLI.
+ * Links the CLI terminal to the FreeLLMAPI SaaS cloud by prompting
+ * for the master API key, destination URL, and saving it to the configuration.
+ */
+export async function runSetupWizard() {
+    p.intro('🚀 Welcome to FixO CLI Setup');
+    console.log(`┌────────────────────────────────────────────────────────────────┐
+│  🚀 Welcome to FixO CLI!                                       │
+│  Let's link your CLI terminal to your FreeLLMAPI SaaS cloud.   │
+│                                                                │
+│  1. Open your web browser and navigate to your dashboard.       │
+│  2. Sign in to your account.                                   │
+│  3. Navigate to the Profile / API Keys section.                │
+│  4. Copy your master 'FreeLLMAPI' API key.                     │
+└────────────────────────────────────────────────────────────────┘\n`);
+    const serverChoice = await p.select({
+        message: 'Select your FreeLLMAPI server endpoint:',
+        options: [
+            { value: DEFAULT_API_URL, label: 'Cloud Hosted SaaS (Default)' },
+            { value: 'http://localhost:3001/v1', label: 'Local Development Server (http://localhost:3001/v1)' },
+            { value: 'custom', label: 'Custom Endpoint URL' },
+        ],
+    });
+    if (p.isCancel(serverChoice)) {
+        p.outro('Setup cancelled.');
+        process.exit(1);
+    }
+    let apiUrl = serverChoice;
+    if (serverChoice === 'custom') {
+        const customUrl = await p.text({
+            message: 'Enter your custom FreeLLMAPI Endpoint URL:',
+            placeholder: 'https://api.custom-domain.com/v1',
+            validate: (val) => {
+                if (!val.trim())
+                    return 'URL is required';
+                return;
+            },
+        });
+        if (p.isCancel(customUrl)) {
+            p.outro('Setup cancelled.');
+            process.exit(1);
+        }
+        apiUrl = customUrl.trim();
+    }
+    const apiKeyInput = await p.text({
+        message: 'Enter your FreeLLMAPI API key:',
+        placeholder: 'freellmapi-user-sk-...',
+        validate: (val) => {
+            if (!val.trim()) {
+                return 'API key is required';
+            }
+            if (!val.trim().startsWith('freellmapi-')) {
+                return 'API key must start with "freellmapi-"';
+            }
+            return;
+        },
+    });
+    if (p.isCancel(apiKeyInput)) {
+        p.outro('Setup cancelled. FixO CLI requires an API key to function.');
+        process.exit(1);
+    }
+    const config = getDefaultConfig();
+    config.freellmapi_api_key = apiKeyInput.trim();
+    config.apiUrl = apiUrl;
+    config._firstRunComplete = true;
+    saveConfig(config);
+    p.outro('✓ Configuration saved to ~/.fixocli/config.json');
+    return config;
+}
+//# sourceMappingURL=setup-wizard.js.map

package/dist/setup-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.js","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC;;;;;;;;qEAQuD,CAAC,CAAC;IAErE,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QAClC,OAAO,EAAE,yCAAyC;QAClD,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,6BAA6B,EAAE;YAChE,EAAE,KAAK,EAAE,0BAA0B,EAAE,KAAK,EAAE,qDAAqD,EAAE;YACnG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,EAAE;SAClD;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,GAAG,YAAsB,CAAC;IACpC,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;YAC7B,OAAO,EAAE,4CAA4C;YACrD,WAAW,EAAE,kCAAkC;YAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;gBAChB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;oBAAE,OAAO,iBAAiB,CAAC;gBAC1C,OAAO;YACT,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;QAC/B,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,wBAAwB;QACrC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChB,OAAO,qBAAqB,CAAC;YAC/B,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC1C,OAAO,uCAAuC,CAAC;YACjD,CAAC;YACD,OAAO;QACT,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,CAAC,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,CAAC,kBAAkB,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEhC,UAAU,CAAC,MAAM,CAAC,CAAC;IAEnB,CAAC,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAE3D,OAAO,MAAM,CAAC;AAChB,CAAC"}