@cortexkit/aft 0.15.0

package/README.md

@@ -0,0 +1,24 @@
+# @cortexkit/aft
+
+Unified CLI for [Agent File Tools (AFT)](https://github.com/cortexkit/aft) — setup, doctor, and diagnostics across supported agent harnesses.
+
+## Usage
+
+```bash
+bunx --bun @cortexkit/aft setup            # interactive setup for one or more harnesses
+bunx --bun @cortexkit/aft doctor           # check and fix configuration issues
+bunx --bun @cortexkit/aft doctor --force   # force clear plugin cache
+bunx --bun @cortexkit/aft doctor --issue   # collect diagnostics and open a GitHub issue
+```
+
+By default the CLI auto-detects which harnesses are installed on your system (OpenCode, Pi). When multiple are detected, it prompts you to choose. Use `--harness opencode` or `--harness pi` to target one explicitly.
+
+## Supported harnesses
+
+- **OpenCode** — `@cortexkit/aft-opencode` plugin
+- **Pi** — `@cortexkit/aft-pi` extension
+
+## Learn more
+
+- Main repository: <https://github.com/cortexkit/aft>
+- Issues: <https://github.com/cortexkit/aft/issues>

package/dist/__tests__/adapters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapters.test.d.ts.map

package/dist/__tests__/adapters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/adapters.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/jsonc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jsonc.test.d.ts.map

package/dist/__tests__/jsonc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/jsonc.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sanitize.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sanitize.test.d.ts.map

package/dist/__tests__/sanitize.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sanitize.test.ts"],"names":[],"mappings":""}

package/dist/adapters/index.d.ts

@@ -0,0 +1,14 @@
+import { OpenCodeAdapter } from "./opencode.js";
+import { PiAdapter } from "./pi.js";
+import type { HarnessAdapter, HarnessKind } from "./types.js";
+export type { HarnessAdapter, HarnessKind } from "./types.js";
+export { OpenCodeAdapter, PiAdapter };
+export declare function getAllAdapters(): HarnessAdapter[];
+export declare function getAdapter(kind: HarnessKind): HarnessAdapter;
+/** Adapters whose host binary is on PATH. Order: installed first, then rest. */
+export declare function getAdaptersPreferInstalled(): HarnessAdapter[];
+/** Adapters that have AFT registered (either via plugin entry or `pi install`). */
+export declare function getAdaptersWithPluginRegistered(): HarnessAdapter[];
+/** Adapters whose host is installed, regardless of whether AFT is registered. */
+export declare function getInstalledAdapters(): HarnessAdapter[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;AAItC,wBAAgB,cAAc,IAAI,cAAc,EAAE,CAEjD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAI5D;AAED,gFAAgF;AAChF,wBAAgB,0BAA0B,IAAI,cAAc,EAAE,CAM7D;AAED,mFAAmF;AACnF,wBAAgB,+BAA+B,IAAI,cAAc,EAAE,CAElE;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,cAAc,EAAE,CAEvD"}

package/dist/adapters/opencode.d.ts

@@ -0,0 +1,28 @@
+import type { HarnessAdapter, HarnessConfigPaths, PluginCacheInfo, PluginEntryResult } from "./types.js";
+export declare class OpenCodeAdapter implements HarnessAdapter {
+    readonly kind: "opencode";
+    readonly displayName = "OpenCode";
+    readonly pluginPackageName = "@cortexkit/aft-opencode";
+    readonly pluginEntryWithVersion = "@cortexkit/aft-opencode@latest";
+    isInstalled(): boolean;
+    getHostVersion(): string | null;
+    detectConfigPaths(): HarnessConfigPaths;
+    hasPluginEntry(): boolean;
+    ensurePluginEntry(): Promise<PluginEntryResult>;
+    getPluginCacheInfo(): PluginCacheInfo;
+    getStorageDir(): string;
+    getLogFile(): string;
+    getInstallHint(): string;
+    clearPluginCache(force: boolean): Promise<{
+        action: "cleared" | "up_to_date" | "not_found" | "not_applicable" | "error";
+        path: string;
+        cached?: string;
+        latest?: string;
+        error?: string;
+    }>;
+    /** Exposed for diagnostic reporting — harness-specific side data. */
+    getOpenCodeCacheDir(): string;
+    /** For doctor: directory size helpers for each storage subtree. */
+    describeStorageSubtrees(): Record<string, number>;
+}
+//# sourceMappingURL=opencode.d.ts.map

package/dist/adapters/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/adapters/opencode.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA8BpB,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,QAAQ,CAAC,WAAW,cAAc;IAClC,QAAQ,CAAC,iBAAiB,6BAAe;IACzC,QAAQ,CAAC,sBAAsB,oCAAgB;IAE/C,WAAW,IAAI,OAAO;IAStB,cAAc,IAAI,MAAM,GAAG,IAAI;IAQ/B,iBAAiB,IAAI,kBAAkB;IAgBvC,cAAc,IAAI,OAAO;IAOnB,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAgDrD,kBAAkB,IAAI,eAAe;IA0BrC,aAAa,IAAI,MAAM;IAKvB,UAAU,IAAI,MAAM;IAIpB,cAAc,IAAI,MAAM;IAIlB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;QAC9C,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC;QAC5E,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAgCF,qEAAqE;IACrE,mBAAmB,IAAI,MAAM;IAI7B,mEAAmE;IACnE,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAUlD"}

package/dist/adapters/pi.d.ts

@@ -0,0 +1,25 @@
+import type { HarnessAdapter, HarnessConfigPaths, PluginCacheInfo, PluginEntryResult } from "./types.js";
+export declare class PiAdapter implements HarnessAdapter {
+    readonly kind: "pi";
+    readonly displayName = "Pi";
+    readonly pluginPackageName = "@cortexkit/aft-pi";
+    readonly pluginEntryWithVersion = "npm:@cortexkit/aft-pi";
+    isInstalled(): boolean;
+    getHostVersion(): string | null;
+    detectConfigPaths(): HarnessConfigPaths;
+    hasPluginEntry(): boolean;
+    ensurePluginEntry(): Promise<PluginEntryResult>;
+    getPluginCacheInfo(): PluginCacheInfo;
+    getStorageDir(): string;
+    getLogFile(): string;
+    getInstallHint(): string;
+    clearPluginCache(_force: boolean): Promise<{
+        action: "cleared" | "up_to_date" | "not_found" | "not_applicable" | "error";
+        path: string;
+        cached?: string;
+        latest?: string;
+        error?: string;
+    }>;
+    describeStorageSubtrees(): Record<string, number>;
+}
+//# sourceMappingURL=pi.d.ts.map

package/dist/adapters/pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../../src/adapters/pi.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAuDpB,qBAAa,SAAU,YAAW,cAAc;IAC9C,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAU;IAC9B,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,iBAAiB,uBAAe;IACzC,QAAQ,CAAC,sBAAsB,2BAAgB;IAE/C,WAAW,IAAI,OAAO;IAStB,cAAc,IAAI,MAAM,GAAG,IAAI;IAQ/B,iBAAiB,IAAI,kBAAkB;IAevC,cAAc,IAAI,OAAO;IAInB,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmCrD,kBAAkB,IAAI,eAAe;IA6BrC,aAAa,IAAI,MAAM;IAKvB,UAAU,IAAI,MAAM;IAIpB,cAAc,IAAI,MAAM;IAIlB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QAC/C,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC;QAC5E,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IASF,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAUlD"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * HarnessAdapter — abstracts what the unified AFT CLI needs to know about a
+ * specific agent harness (OpenCode, Pi, and future entries).
+ *
+ * Each adapter covers:
+ *   1. *Detection* — is the harness installed? is AFT registered with it?
+ *   2. *Configuration* — where do its config files live, how are they read/written?
+ *   3. *Runtime state* — log file, storage dir, plugin cache dir
+ *   4. *Setup* — how a user installs/registers our plugin with it
+ *
+ * Everything here is synchronous or returns synchronously-resolvable
+ * structures; async work lives in the command layer.
+ */
+export type HarnessKind = "opencode" | "pi";
+export interface HarnessConfigPaths {
+    /** Primary config dir (e.g. `~/.config/opencode`, `~/.pi/agent`). */
+    configDir: string;
+    /** Harness's main config file (opencode.jsonc, pi's internal config if any). */
+    harnessConfig: string;
+    harnessConfigFormat: "json" | "jsonc" | "none";
+    /** AFT user-level config (`<configDir>/aft.jsonc` or equivalent). */
+    aftConfig: string;
+    aftConfigFormat: "json" | "jsonc" | "none";
+    /** Optional harness-specific UI/TUI config (OpenCode's `tui.jsonc`; undefined for Pi). */
+    tuiConfig?: string;
+    tuiConfigFormat?: "json" | "jsonc" | "none";
+}
+export interface PluginCacheInfo {
+    path: string;
+    cached?: string;
+    latest?: string;
+    exists: boolean;
+}
+export interface PluginEntryResult {
+    /** True if the plugin was added or was already present. */
+    ok: boolean;
+    /** Human-readable action description for the doctor/setup output. */
+    action: "already_present" | "added" | "updated" | "config_missing" | "error";
+    message: string;
+    configPath: string;
+}
+export interface HarnessAdapter {
+    readonly kind: HarnessKind;
+    readonly displayName: string;
+    readonly pluginPackageName: string;
+    readonly pluginEntryWithVersion: string;
+    /** Is the harness's host CLI (`opencode`, `pi`) on PATH? */
+    isInstalled(): boolean;
+    getHostVersion(): string | null;
+    detectConfigPaths(): HarnessConfigPaths;
+    /**
+     * Check whether our plugin is registered with the harness. For OpenCode this
+     * reads the `plugin` array in opencode.jsonc. For Pi it checks the extension
+     * index because Pi manages its own registration.
+     */
+    hasPluginEntry(): boolean;
+    /**
+     * Ensure the plugin is registered. May prompt, may run shell commands (Pi),
+     * may edit config files (OpenCode). Idempotent.
+     */
+    ensurePluginEntry(): Promise<PluginEntryResult>;
+    getPluginCacheInfo(): PluginCacheInfo;
+    getStorageDir(): string;
+    getLogFile(): string;
+    /** User-facing hint when the harness isn't installed. */
+    getInstallHint(): string;
+    /**
+     * Harness-aware version of `doctor --force` cache clearing. OpenCode nukes
+     * its bunx package cache; Pi may be a no-op because Pi caches are managed by
+     * `pi install` itself.
+     */
+    clearPluginCache(force: boolean): Promise<{
+        action: "cleared" | "up_to_date" | "not_found" | "not_applicable" | "error";
+        path: string;
+        cached?: string;
+        latest?: string;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/C,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC3C,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,EAAE,EAAE,OAAO,CAAC;IACZ,qEAAqE;IACrE,MAAM,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,gBAAgB,GAAG,OAAO,CAAC;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAExC,4DAA4D;IAC5D,WAAW,IAAI,OAAO,CAAC;IACvB,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAEhC,iBAAiB,IAAI,kBAAkB,CAAC;IAExC;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC;IAE1B;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEhD,kBAAkB,IAAI,eAAe,CAAC;IACtC,aAAa,IAAI,MAAM,CAAC;IACxB,UAAU,IAAI,MAAM,CAAC;IAErB,yDAAyD;IACzD,cAAc,IAAI,MAAM,CAAC;IAEzB;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;QACxC,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC;QAC5E,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,7 @@
+export interface DoctorOptions {
+    force: boolean;
+    issue: boolean;
+    argv: string[];
+}
+export declare function runDoctor(options: DoctorOptions): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFvE"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function runSetup(argv: string[]): Promise<number>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAIA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+C9D"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * @cortexkit/aft — unified CLI for Agent File Tools.
+ *
+ * Entry point parses argv and dispatches to commands. Harness selection
+ * (OpenCode, Pi) is auto-detected from installed config paths; explicit
+ * `--harness <name>` overrides detection.
+ */
+declare const command: string;
+declare const args: string[];
+declare function printHelp(): void;
+declare function main(): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,QAAA,MAAM,OAAO,QAAkB,CAAC;AAChC,QAAA,MAAM,IAAI,UAAwB,CAAC;AAEnC,iBAAS,SAAS,IAAI,IAAI,CAqBzB;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAarC"}