@cortexkit/aft-opencode 0.2.0

package/dist/bridge.d.ts

@@ -0,0 +1,43 @@
+export interface BridgeOptions {
+    /** Request timeout in milliseconds. Default: 30000 */
+    timeoutMs?: number;
+    /** Maximum restart attempts before giving up. Default: 3 */
+    maxRestarts?: number;
+}
+/**
+ * Manages a persistent `aft` child process, communicating via NDJSON over
+ * stdin/stdout. Lazy-spawns on first `send()` call. Handles crash detection
+ * with exponential backoff auto-restart.
+ */
+export declare class BinaryBridge {
+    private binaryPath;
+    private cwd;
+    private process;
+    private pending;
+    private nextId;
+    private stdoutBuffer;
+    private _restartCount;
+    private _shuttingDown;
+    private timeoutMs;
+    private maxRestarts;
+    private configured;
+    private configOverrides;
+    constructor(binaryPath: string, cwd: string, options?: BridgeOptions, configOverrides?: Record<string, unknown>);
+    /** Number of times the binary has been restarted after a crash. */
+    get restartCount(): number;
+    /** Whether the child process is currently alive. */
+    isAlive(): boolean;
+    /**
+     * Send a command to the binary and return the parsed response.
+     * Lazy-spawns the binary on first call.
+     */
+    send(command: string, params?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Kill the child process and reject all pending requests. */
+    shutdown(): Promise<void>;
+    private ensureSpawned;
+    private spawnProcess;
+    private onStdoutData;
+    private handleCrash;
+    private rejectAllPending;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAA0B;gBAG/C,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,aAAa,EACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS3C,mEAAmE;IACnE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oDAAoD;IACpD,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoDnC,8DAA8D;IACxD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B/B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,YAAY;IAkCpB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/bridge.js

@@ -0,0 +1,194 @@
+import { spawn } from "node:child_process";
+/** Prefix for all bridge diagnostic messages on stderr. */
+const TAG = "[aft-plugin]";
+/**
+ * Manages a persistent `aft` child process, communicating via NDJSON over
+ * stdin/stdout. Lazy-spawns on first `send()` call. Handles crash detection
+ * with exponential backoff auto-restart.
+ */
+export class BinaryBridge {
+    binaryPath;
+    cwd;
+    process = null;
+    pending = new Map();
+    nextId = 1;
+    stdoutBuffer = "";
+    _restartCount = 0;
+    _shuttingDown = false;
+    timeoutMs;
+    maxRestarts;
+    configured = false;
+    configOverrides;
+    constructor(binaryPath, cwd, options, configOverrides) {
+        this.binaryPath = binaryPath;
+        this.cwd = cwd;
+        this.timeoutMs = options?.timeoutMs ?? 30_000;
+        this.maxRestarts = options?.maxRestarts ?? 3;
+        this.configOverrides = configOverrides ?? {};
+    }
+    /** Number of times the binary has been restarted after a crash. */
+    get restartCount() {
+        return this._restartCount;
+    }
+    /** Whether the child process is currently alive. */
+    isAlive() {
+        return this.process !== null && this.process.exitCode === null && !this.process.killed;
+    }
+    /**
+     * Send a command to the binary and return the parsed response.
+     * Lazy-spawns the binary on first call.
+     */
+    async send(command, params = {}) {
+        if (this._shuttingDown) {
+            throw new Error(`${TAG} Bridge is shutting down, cannot send "${command}"`);
+        }
+        this.ensureSpawned();
+        // Auto-configure project root + plugin config on first command
+        if (!this.configured) {
+            this.configured = true;
+            if (command !== "configure") {
+                await this.send("configure", {
+                    project_root: this.cwd,
+                    ...this.configOverrides,
+                });
+            }
+        }
+        const id = String(this.nextId++);
+        const request = { id, command, ...params };
+        const line = `${JSON.stringify(request)}\n`;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`${TAG} Request "${command}" (id=${id}) timed out after ${this.timeoutMs}ms`));
+            }, this.timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            if (!this.process?.stdin?.writable) {
+                this.pending.delete(id);
+                clearTimeout(timer);
+                reject(new Error(`${TAG} stdin not writable for command "${command}"`));
+                return;
+            }
+            this.process.stdin.write(line, (err) => {
+                if (err) {
+                    const entry = this.pending.get(id);
+                    if (entry) {
+                        this.pending.delete(id);
+                        clearTimeout(entry.timer);
+                        entry.reject(new Error(`${TAG} Failed to write to stdin: ${err.message}`));
+                    }
+                }
+            });
+        });
+    }
+    /** Kill the child process and reject all pending requests. */
+    async shutdown() {
+        this._shuttingDown = true;
+        this.rejectAllPending(new Error(`${TAG} Bridge shutting down`));
+        if (this.process) {
+            const proc = this.process;
+            this.process = null;
+            return new Promise((resolve) => {
+                const forceKillTimer = setTimeout(() => {
+                    proc.kill("SIGKILL");
+                    resolve();
+                }, 5_000);
+                proc.once("exit", () => {
+                    clearTimeout(forceKillTimer);
+                    console.error(`${TAG} Process exited during shutdown`);
+                    resolve();
+                });
+                proc.kill("SIGTERM");
+            });
+        }
+    }
+    // ---- Internal ----
+    ensureSpawned() {
+        if (this.isAlive())
+            return;
+        this.spawnProcess();
+    }
+    spawnProcess() {
+        console.error(`${TAG} Spawning binary: ${this.binaryPath} (cwd: ${this.cwd})`);
+        const child = spawn(this.binaryPath, [], {
+            cwd: this.cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        child.stdout?.on("data", (chunk) => {
+            this.onStdoutData(chunk.toString("utf-8"));
+        });
+        child.stderr?.on("data", (chunk) => {
+            const lines = chunk.toString("utf-8").trimEnd().split("\n");
+            for (const line of lines) {
+                console.error(`${TAG} stderr: ${line}`);
+            }
+        });
+        child.on("error", (err) => {
+            console.error(`${TAG} Process error: ${err.message}`);
+            this.handleCrash();
+        });
+        child.on("exit", (code, signal) => {
+            if (this._shuttingDown)
+                return;
+            console.error(`${TAG} Process exited: code=${code}, signal=${signal}`);
+            this.handleCrash();
+        });
+        this.process = child;
+        this.stdoutBuffer = "";
+    }
+    onStdoutData(data) {
+        this.stdoutBuffer += data;
+        // Process complete lines
+        let newlineIdx;
+        while ((newlineIdx = this.stdoutBuffer.indexOf("\n")) !== -1) {
+            const line = this.stdoutBuffer.slice(0, newlineIdx).trim();
+            this.stdoutBuffer = this.stdoutBuffer.slice(newlineIdx + 1);
+            if (!line)
+                continue;
+            try {
+                const response = JSON.parse(line);
+                const id = response.id;
+                if (id && this.pending.has(id)) {
+                    const entry = this.pending.get(id);
+                    this.pending.delete(id);
+                    clearTimeout(entry.timer);
+                    entry.resolve(response);
+                }
+            }
+            catch (_err) {
+                console.error(`${TAG} Failed to parse stdout line: ${line}`);
+            }
+        }
+    }
+    handleCrash() {
+        this.process = null;
+        // Reject all pending requests
+        this.rejectAllPending(new Error(`${TAG} Binary crashed (restarts: ${this._restartCount})`));
+        // Auto-restart with exponential backoff
+        if (this._restartCount < this.maxRestarts) {
+            const delay = 100 * 2 ** this._restartCount; // 100ms, 200ms, 400ms
+            this._restartCount++;
+            console.error(`${TAG} Auto-restart #${this._restartCount} in ${delay}ms`);
+            setTimeout(() => {
+                if (!this._shuttingDown) {
+                    try {
+                        this.spawnProcess();
+                    }
+                    catch (err) {
+                        console.error(`${TAG} Failed to restart: ${err.message}`);
+                    }
+                }
+            }, delay);
+        }
+        else {
+            console.error(`${TAG} Max restarts (${this.maxRestarts}) reached, giving up`);
+        }
+    }
+    rejectAllPending(error) {
+        for (const [_id, entry] of this.pending) {
+            clearTimeout(entry.timer);
+            entry.reject(error);
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export declare const AftConfigSchema: z.ZodObject<{
+    format_on_edit: z.ZodOptional<z.ZodBoolean>;
+    validate_on_edit: z.ZodOptional<z.ZodEnum<{
+        syntax: "syntax";
+        full: "full";
+    }>>;
+    formatter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        biome: "biome";
+        prettier: "prettier";
+        deno: "deno";
+        ruff: "ruff";
+        black: "black";
+        rustfmt: "rustfmt";
+        goimports: "goimports";
+        gofmt: "gofmt";
+        none: "none";
+    }>>>;
+    checker: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        biome: "biome";
+        ruff: "ruff";
+        none: "none";
+        tsc: "tsc";
+        pyright: "pyright";
+        cargo: "cargo";
+        go: "go";
+        staticcheck: "staticcheck";
+    }>>>;
+}, z.core.$strip>;
+export type AftConfig = z.infer<typeof AftConfigSchema>;
+/**
+ * Load AFT config using the same two-level pattern as oh-my-opencode:
+ *
+ * 1. User-level:    ~/.config/opencode/aft.jsonc (or .json)
+ * 2. Project-level: <project>/.opencode/aft.jsonc (or .json)
+ *
+ * Project config merges on top of user config.
+ * Both support JSONC (comments allowed).
+ * Invalid sections are skipped, valid sections still load.
+ */
+export declare function loadAftConfig(projectDirectory: string): AftConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AA6IxD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAwBjE"}

package/dist/config.js

@@ -0,0 +1,180 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse, printParseErrorCode } from "jsonc-parser";
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Zod schema
+// ---------------------------------------------------------------------------
+const FormatterEnum = z.enum([
+    "biome",
+    "prettier",
+    "deno",
+    "ruff",
+    "black",
+    "rustfmt",
+    "goimports",
+    "gofmt",
+    "none",
+]);
+const CheckerEnum = z.enum([
+    "tsc",
+    "biome",
+    "pyright",
+    "ruff",
+    "cargo",
+    "go",
+    "staticcheck",
+    "none",
+]);
+export const AftConfigSchema = z.object({
+    /** Whether to auto-format files after edits. Default: true. */
+    format_on_edit: z.boolean().optional(),
+    /** Auto-validate after edits: "syntax" (tree-sitter) or "full" (runs type checker). */
+    validate_on_edit: z.enum(["syntax", "full"]).optional(),
+    /** Per-language formatter overrides. Keys: "typescript", "python", "rust", "go". */
+    formatter: z.record(z.string(), FormatterEnum).optional(),
+    /** Per-language type checker overrides. Keys: "typescript", "python", "rust", "go". */
+    checker: z.record(z.string(), CheckerEnum).optional(),
+});
+// ---------------------------------------------------------------------------
+// JSONC parsing (same approach as oh-my-opencode)
+// ---------------------------------------------------------------------------
+function parseJsonc(content) {
+    const errors = [];
+    const result = parse(content, errors, {
+        allowTrailingComma: true,
+        disallowComments: false,
+    });
+    if (errors.length > 0) {
+        const errorMessages = errors
+            .map((e) => `${printParseErrorCode(e.error)} at offset ${e.offset}`)
+            .join(", ");
+        throw new SyntaxError(`JSONC parse error: ${errorMessages}`);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Config file detection (.jsonc preferred over .json)
+// ---------------------------------------------------------------------------
+function detectConfigFile(basePath) {
+    const jsoncPath = `${basePath}.jsonc`;
+    const jsonPath = `${basePath}.json`;
+    if (existsSync(jsoncPath)) {
+        return { format: "jsonc", path: jsoncPath };
+    }
+    if (existsSync(jsonPath)) {
+        return { format: "json", path: jsonPath };
+    }
+    return { format: "none", path: jsonPath };
+}
+// ---------------------------------------------------------------------------
+// Partial parse (valid sections survive, invalid sections are skipped)
+// ---------------------------------------------------------------------------
+function parseConfigPartially(rawConfig) {
+    const fullResult = AftConfigSchema.safeParse(rawConfig);
+    if (fullResult.success) {
+        return fullResult.data;
+    }
+    const partialConfig = {};
+    const invalidSections = [];
+    for (const key of Object.keys(rawConfig)) {
+        const sectionResult = AftConfigSchema.safeParse({ [key]: rawConfig[key] });
+        if (sectionResult.success) {
+            const parsed = sectionResult.data;
+            if (parsed[key] !== undefined) {
+                partialConfig[key] = parsed[key];
+            }
+        }
+        else {
+            const sectionErrors = sectionResult.error.issues
+                .filter((i) => i.path[0] === key)
+                .map((i) => `${i.path.join(".")}: ${i.message}`)
+                .join(", ");
+            if (sectionErrors) {
+                invalidSections.push(`${key}: ${sectionErrors}`);
+            }
+        }
+    }
+    if (invalidSections.length > 0) {
+        console.error(`[aft-plugin] Partial config loaded — invalid sections skipped: ${invalidSections.join("; ")}`);
+    }
+    return partialConfig;
+}
+// ---------------------------------------------------------------------------
+// Load config from a single file path
+// ---------------------------------------------------------------------------
+function loadConfigFromPath(configPath) {
+    try {
+        if (!existsSync(configPath)) {
+            return null;
+        }
+        const content = readFileSync(configPath, "utf-8");
+        const rawConfig = parseJsonc(content);
+        const result = AftConfigSchema.safeParse(rawConfig);
+        if (result.success) {
+            console.error(`[aft-plugin] Config loaded from ${configPath}`);
+            return result.data;
+        }
+        const errorMsg = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ");
+        console.error(`[aft-plugin] Config validation error in ${configPath}: ${errorMsg}`);
+        return parseConfigPartially(rawConfig);
+    }
+    catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        console.error(`[aft-plugin] Error loading config from ${configPath}: ${errorMsg}`);
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Merge configs (project overrides user, simple shallow merge for flat schema)
+// ---------------------------------------------------------------------------
+function mergeConfigs(base, override) {
+    return {
+        ...base,
+        ...override,
+        // Deep-merge language-scoped maps instead of replacing
+        formatter: { ...base.formatter, ...override.formatter },
+        checker: { ...base.checker, ...override.checker },
+    };
+}
+// ---------------------------------------------------------------------------
+// OpenCode config directory detection (same logic as oh-my-opencode)
+// ---------------------------------------------------------------------------
+function getOpenCodeConfigDir() {
+    // XDG_CONFIG_HOME or ~/.config, then /opencode
+    const xdgConfig = process.env.XDG_CONFIG_HOME || join(process.env.HOME || "~", ".config");
+    return join(xdgConfig, "opencode");
+}
+// ---------------------------------------------------------------------------
+// Public API: loadAftConfig
+// ---------------------------------------------------------------------------
+/**
+ * Load AFT config using the same two-level pattern as oh-my-opencode:
+ *
+ * 1. User-level:    ~/.config/opencode/aft.jsonc (or .json)
+ * 2. Project-level: <project>/.opencode/aft.jsonc (or .json)
+ *
+ * Project config merges on top of user config.
+ * Both support JSONC (comments allowed).
+ * Invalid sections are skipped, valid sections still load.
+ */
+export function loadAftConfig(projectDirectory) {
+    // User-level config
+    const configDir = getOpenCodeConfigDir();
+    const userBasePath = join(configDir, "aft");
+    const userDetected = detectConfigFile(userBasePath);
+    const userConfigPath = userDetected.format !== "none" ? userDetected.path : `${userBasePath}.json`;
+    // Project-level config
+    const projectBasePath = join(projectDirectory, ".opencode", "aft");
+    const projectDetected = detectConfigFile(projectBasePath);
+    const projectConfigPath = projectDetected.format !== "none" ? projectDetected.path : `${projectBasePath}.json`;
+    // Load user config first (base)
+    let config = loadConfigFromPath(userConfigPath) ?? {};
+    // Override with project config
+    const projectConfig = loadConfigFromPath(projectConfigPath);
+    if (projectConfig) {
+        config = mergeConfigs(config, projectConfig);
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAmB,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,OAAO;IACP,UAAU;IACV,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,WAAW;IACX,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC;IACzB,KAAK;IACL,OAAO;IACP,SAAS;IACT,MAAM;IACN,OAAO;IACP,IAAI;IACJ,aAAa;IACb,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,+DAA+D;IAC/D,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,uFAAuF;IACvF,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvD,oFAAoF;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,QAAQ,EAAE;IACzD,uFAAuF;IACvF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIH,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,SAAS,UAAU,CAAc,OAAe;IAC9C,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE;QACpC,kBAAkB,EAAE,IAAI;QACxB,gBAAgB,EAAE,KAAK;KACxB,CAAM,CAAC;IAER,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,aAAa,GAAG,MAAM;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,CAAC;aACnE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,WAAW,CAAC,sBAAsB,aAAa,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,QAAgB;IAIxC,MAAM,SAAS,GAAG,GAAG,QAAQ,QAAQ,CAAC;IACtC,MAAM,QAAQ,GAAG,GAAG,QAAQ,OAAO,CAAC;IAEpC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAE9E,SAAS,oBAAoB,CAAC,SAAkC;IAC9D,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,MAAM,aAAa,GAA4B,EAAE,CAAC;IAClD,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3E,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,IAA+B,CAAC;YAC7D,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9B,aAAa,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM;iBAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;iBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,IAAI,aAAa,EAAE,CAAC;gBAClB,eAAe,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,aAAa,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CACX,kEAAkE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO,aAA0B,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,SAAS,kBAAkB,CAAC,UAAkB;IAC5C,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,UAAU,CAA0B,OAAO,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAEpD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAC;YAC/D,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChG,OAAO,CAAC,KAAK,CAAC,2CAA2C,UAAU,KAAK,QAAQ,EAAE,CAAC,CAAC;QAEpF,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClE,OAAO,CAAC,KAAK,CAAC,0CAA0C,UAAU,KAAK,QAAQ,EAAE,CAAC,CAAC;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAE9E,SAAS,YAAY,CAAC,IAAe,EAAE,QAAmB;IACxD,OAAO;QACL,GAAG,IAAI;QACP,GAAG,QAAQ;QACX,uDAAuD;QACvD,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE;QACvD,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE;KAClD,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,qEAAqE;AACrE,8EAA8E;AAE9E,SAAS,oBAAoB;IAC3B,+CAA+C;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,gBAAwB;IACpD,oBAAoB;IACpB,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,cAAc,GAClB,YAAY,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,OAAO,CAAC;IAE9E,uBAAuB;IACvB,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAC1D,MAAM,iBAAiB,GACrB,eAAe,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,eAAe,OAAO,CAAC;IAEvF,gCAAgC;IAChC,IAAI,MAAM,GAAc,kBAAkB,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAEjE,+BAA+B;IAC/B,MAAM,aAAa,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IAC5D,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/downloader.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Auto-download the AFT binary from GitHub releases.
+ *
+ * Resolution order (in resolver.ts):
+ *   1. Cached binary in ~/.cache/aft/bin/
+ *   2. npm platform package (@cortexkit/aft-darwin-arm64, etc.)
+ *   3. PATH lookup (which aft)
+ *   4. ~/.cargo/bin/aft
+ *   5. Auto-download from GitHub releases (this module)
+ *
+ * Cache dir respects XDG_CACHE_HOME on Linux/macOS and LOCALAPPDATA on Windows.
+ */
+/** Get the cache directory, respecting XDG_CACHE_HOME / LOCALAPPDATA. */
+export declare function getCacheDir(): string;
+/** Binary name for the current platform. */
+export declare function getBinaryName(): string;
+/** Return the cached binary path if it exists, otherwise null. */
+export declare function getCachedBinaryPath(): string | null;
+/**
+ * Download the AFT binary for the current platform from GitHub releases.
+ *
+ * @param version - Git tag to download from (e.g. "v0.1.0"). If omitted,
+ *   fetches the latest release tag via the GitHub API.
+ * @returns Absolute path to the downloaded binary, or null on failure.
+ */
+export declare function downloadBinary(version?: string): Promise<string | null>;
+/**
+ * Ensure the AFT binary is available: check cache, then download if needed.
+ * This is the main entry point called by the resolver.
+ */
+export declare function ensureBinary(version?: string): Promise<string | null>;
+//# sourceMappingURL=downloader.d.ts.map

package/dist/downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../src/downloader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,yEAAyE;AACzE,wBAAgB,WAAW,IAAI,MAAM,CASpC;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAGnD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2E7E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAI3E"}

package/dist/downloader.js

@@ -0,0 +1,140 @@
+/**
+ * Auto-download the AFT binary from GitHub releases.
+ *
+ * Resolution order (in resolver.ts):
+ *   1. Cached binary in ~/.cache/aft/bin/
+ *   2. npm platform package (@cortexkit/aft-darwin-arm64, etc.)
+ *   3. PATH lookup (which aft)
+ *   4. ~/.cargo/bin/aft
+ *   5. Auto-download from GitHub releases (this module)
+ *
+ * Cache dir respects XDG_CACHE_HOME on Linux/macOS and LOCALAPPDATA on Windows.
+ */
+import { chmodSync, existsSync, mkdirSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const REPO = "nichochar/opencode-sfm";
+const TAG = "[aft-downloader]";
+/** Platform → GitHub release asset suffix */
+const PLATFORM_MAP = {
+    "darwin-arm64": "aft-darwin-arm64",
+    "darwin-x64": "aft-darwin-x64",
+    "linux-arm64": "aft-linux-arm64",
+    "linux-x64": "aft-linux-x64",
+    "win32-x64": "aft-win32-x64.exe",
+};
+/** Get the cache directory, respecting XDG_CACHE_HOME / LOCALAPPDATA. */
+export function getCacheDir() {
+    if (process.platform === "win32") {
+        const localAppData = process.env.LOCALAPPDATA || process.env.APPDATA;
+        const base = localAppData || join(homedir(), "AppData", "Local");
+        return join(base, "aft", "bin");
+    }
+    const base = process.env.XDG_CACHE_HOME || join(homedir(), ".cache");
+    return join(base, "aft", "bin");
+}
+/** Binary name for the current platform. */
+export function getBinaryName() {
+    return process.platform === "win32" ? "aft.exe" : "aft";
+}
+/** Return the cached binary path if it exists, otherwise null. */
+export function getCachedBinaryPath() {
+    const binaryPath = join(getCacheDir(), getBinaryName());
+    return existsSync(binaryPath) ? binaryPath : null;
+}
+/**
+ * Download the AFT binary for the current platform from GitHub releases.
+ *
+ * @param version - Git tag to download from (e.g. "v0.1.0"). If omitted,
+ *   fetches the latest release tag via the GitHub API.
+ * @returns Absolute path to the downloaded binary, or null on failure.
+ */
+export async function downloadBinary(version) {
+    const platformKey = `${process.platform}-${process.arch}`;
+    const assetName = PLATFORM_MAP[platformKey];
+    if (!assetName) {
+        console.error(`${TAG} Unsupported platform: ${platformKey}`);
+        return null;
+    }
+    const cacheDir = getCacheDir();
+    const binaryName = getBinaryName();
+    const binaryPath = join(cacheDir, binaryName);
+    // Already cached
+    if (existsSync(binaryPath)) {
+        return binaryPath;
+    }
+    // Resolve version if not provided
+    const tag = version ?? (await fetchLatestTag());
+    if (!tag) {
+        console.error(`${TAG} Could not determine latest release version.`);
+        return null;
+    }
+    const downloadUrl = `https://github.com/${REPO}/releases/download/${tag}/${assetName}`;
+    console.error(`${TAG} Downloading AFT binary (${tag}) for ${platformKey}...`);
+    try {
+        // Ensure cache directory exists
+        if (!existsSync(cacheDir)) {
+            mkdirSync(cacheDir, { recursive: true });
+        }
+        // Download
+        const response = await fetch(downloadUrl, { redirect: "follow" });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText} (${downloadUrl})`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        // Write to a temp file first, then rename (atomic-ish)
+        const tmpPath = `${binaryPath}.tmp`;
+        const { writeFileSync } = await import("node:fs");
+        writeFileSync(tmpPath, Buffer.from(arrayBuffer));
+        // Make executable
+        if (process.platform !== "win32") {
+            chmodSync(tmpPath, 0o755);
+        }
+        // Atomic rename
+        const { renameSync } = await import("node:fs");
+        renameSync(tmpPath, binaryPath);
+        console.error(`${TAG} AFT binary ready at ${binaryPath}`);
+        return binaryPath;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`${TAG} Failed to download AFT binary: ${msg}`);
+        // Clean up partial download
+        const tmpPath = `${binaryPath}.tmp`;
+        if (existsSync(tmpPath)) {
+            try {
+                unlinkSync(tmpPath);
+            }
+            catch {
+                // ignore cleanup failure
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Ensure the AFT binary is available: check cache, then download if needed.
+ * This is the main entry point called by the resolver.
+ */
+export async function ensureBinary(version) {
+    const cached = getCachedBinaryPath();
+    if (cached)
+        return cached;
+    return downloadBinary(version);
+}
+/** Fetch the latest release tag from GitHub API. */
+async function fetchLatestTag() {
+    try {
+        const response = await fetch(`https://api.github.com/repos/${REPO}/releases/latest`, {
+            headers: { Accept: "application/vnd.github.v3+json" },
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        return data.tag_name ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=downloader.js.map