@cortexkit/aft 0.57.1 → 0.58.0

package/dist/lib/binary-install.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The binary already sitting in the versioned cache for `version`, if any.
+ *
+ * A file here is not proof of a usable binary: the quick version probe can
+ * time out on the first run of a freshly copied binary (macOS assesses every
+ * new executable, which has taken seconds), and an entry written before
+ * identity sidecars existed is only trusted after it is asked its version.
+ * Callers use this to say "checking the cached binary" rather than "not
+ * found, downloading" when the downloader will in fact reuse the file.
+ */
+export declare function cachedBinaryFor(version: string): string | null;
+/**
+ * Obtain the native binary matching this CLI. Setup and `doctor --fix` both
+ * come through here, so a clean machine gets the same download (and the same
+ * failure explanation) from either command.
+ */
+/** Downloads the binary for a `v`-prefixed tag; resolves to its path or null. */
+export type BinaryDownloader = (tag: string) => Promise<string | null>;
+export type BinaryFailureCause = "permission" | "network" | "missing_asset" | "checksum" | "unsupported_platform" | "other";
+export type BinaryObtainResult = {
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    cause: BinaryFailureCause;
+    message: string;
+};
+/**
+ * Classify why a download failed from the error it threw or the lines it
+ * logged. The downloader reports its cause only through the log, so every
+ * line is considered; the first recognised cause wins, in order of how
+ * specific it is.
+ */
+export declare function classifyBinaryFailure(tag: string, evidence: string[]): {
+    cause: BinaryFailureCause;
+    message: string;
+};
+/** Download the binary for `version`, reporting the real cause on failure. */
+export declare function obtainAftBinary(version: string, download?: BinaryDownloader): Promise<BinaryObtainResult>;
+/** The command a user runs to retry the binary install from another command. */
+export declare const BINARY_RETRY_COMMAND = "npx @cortexkit/aft doctor --fix";
+//# sourceMappingURL=binary-install.d.ts.map

package/dist/lib/binary-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-install.d.ts","sourceRoot":"","sources":["../../src/lib/binary-install.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED;;;;GAIG;AAEH,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,SAAS,GACT,eAAe,GACf,UAAU,GACV,sBAAsB,GACtB,OAAO,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAa9D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAAE,GACjB;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqChD;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,gBAAoC,GAC7C,OAAO,CAAC,kBAAkB,CAAC,CAqB7B;AAED,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,oCAAwB,CAAC"}

package/dist/lib/binary-probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binary-probe.d.ts","sourceRoot":"","sources":["../../src/lib/binary-probe.ts"],"names":[],"mappings":"AA4CA,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAuBD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3E;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAkD3E;AAmBD,wBAAgB,WAAW,CACzB,QAAQ,GAAE,MAAyB,EACnC,IAAI,GAAE,MAAqB,GAC1B,MAAM,GAAG,IAAI,CAOf;AA6JD,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAW3E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1F;AAED,wBAAgB,aAAa,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtE"}
+{"version":3,"file":"binary-probe.d.ts","sourceRoot":"","sources":["../../src/lib/binary-probe.ts"],"names":[],"mappings":"AAiDA,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAuBD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3E;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAkD3E;AAmBD,wBAAgB,WAAW,CACzB,QAAQ,GAAE,MAAyB,EACnC,IAAI,GAAE,MAAqB,GAC1B,MAAM,GAAG,IAAI,CAOf;AAiJD,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAW3E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1F;AAED,wBAAgB,aAAa,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtE"}

package/dist/lib/bridge-tool-failures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-tool-failures.d.ts","sourceRoot":"","sources":["../../src/lib/bridge-tool-failures.ts"],"names":[],"mappings":"AAIA,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AAErD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAO3C,wBAAgB,0BAA0B,IAAI,MAAM,CAGnD;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBvE;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAmEpC;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAcxF;AAQD;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,EACnC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,GAAE,MAAqC,EAC9C,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,MAAM,CAKR"}
+{"version":3,"file":"bridge-tool-failures.d.ts","sourceRoot":"","sources":["../../src/lib/bridge-tool-failures.ts"],"names":[],"mappings":"AAIA,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AAErD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAO3C,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBvE;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAmEpC;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAcxF;AAQD;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,EACnC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,GAAE,MAAqC,EAC9C,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,MAAM,CAKR"}

package/dist/lib/cli-logger.d.ts

@@ -0,0 +1,34 @@
+import { type Logger } from "@cortexkit/aft-bridge";
+/**
+ * The CLI's own log for messages from the shared bridge package.
+ *
+ * The bridge logs through a host-provided logger and, when none is set, prints
+ * `[aft-bridge] …` lines straight to stderr. Inside the setup and doctor
+ * screens those raw lines break the prompt layout, so the CLI installs this
+ * logger: every bridge line goes to `aft-cli.log` under the AFT log directory,
+ * and is echoed to stderr only with `--verbose`.
+ *
+ * Code that needs to know WHY a bridge operation failed (the binary download
+ * reports its cause only through the log) can listen for lines while the
+ * operation runs with {@link captureBridgeLog}.
+ */
+export type BridgeLogLevel = "info" | "warn" | "error";
+/** Path of the CLI log. Tests write to the temp directory, never the live log directory. */
+export declare function cliLogPath(): string;
+export declare const cliLogger: Logger;
+/**
+ * Route bridge log lines to the CLI log. Idempotent; `verbose` only ever turns
+ * echoing on, so a later call without options keeps an earlier `--verbose`.
+ */
+export declare function installCliLogger(options?: {
+    verbose?: boolean;
+}): void;
+/** Run `fn` and return every bridge log line it produced alongside its result. */
+export declare function captureBridgeLog<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    lines: {
+        level: BridgeLogLevel;
+        message: string;
+    }[];
+}>;
+//# sourceMappingURL=cli-logger.d.ts.map

package/dist/lib/cli-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-logger.d.ts","sourceRoot":"","sources":["../../src/lib/cli-logger.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,MAAM,EAGZ,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAOvD,4FAA4F;AAC5F,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAyBD,eAAO,MAAM,SAAS,EAAE,MAKvB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CAK1E;AAED,kFAAkF;AAClF,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAU7E"}

package/dist/lib/config-migration.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Preview and report the retired-key config migration that `doctor --fix`
+ * runs through the native `aft fix-config`.
+ *
+ * The preview applies the shared TypeScript translation (kept equal to the
+ * native one by the config parity fixtures) to a copy of each file, so the
+ * plan can say what will change before anything is written. The report after
+ * the run diffs each file as it was before against what the binary wrote, so
+ * the user sees exactly what happened to their config, not a guess.
+ */
+export type ConfigTier = "user" | "project";
+export interface ConfigMigrationTarget {
+    path: string;
+    tier: ConfigTier;
+}
+export interface ConfigChange {
+    kind: "removed" | "added" | "changed";
+    key: string;
+    before?: unknown;
+    after?: unknown;
+}
+export interface ConfigMigrationPreview extends ConfigMigrationTarget {
+    changes: ConfigChange[];
+}
+type Json = Record<string, unknown>;
+/** Parse a config file into plain data, or null when it is missing or unreadable. */
+export declare function readPlainConfig(path: string): Json | null;
+/** The files the migration touches: the user file and the project file at `cwd`, when present. */
+export declare function configMigrationTargets(userConfigPath: string, cwd?: string): ConfigMigrationTarget[];
+/** Leaf-level differences between two config objects; arrays compare as whole values. */
+export declare function diffConfig(before: Json, after: Json, prefix?: string): ConfigChange[];
+/** Files that still use retired keys, with the changes the migration will make to each. */
+export declare function previewConfigMigration(targets: ConfigMigrationTarget[]): ConfigMigrationPreview[];
+/** One readable line per change, e.g. `removed tool_surface ("recommended")`. */
+export declare function describeConfigChange(change: ConfigChange): string;
+export {};
+//# sourceMappingURL=config-migration.d.ts.map

package/dist/lib/config-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-migration.d.ts","sourceRoot":"","sources":["../../src/lib/config-migration.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMpC,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQzD;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,GAAG,GAAE,MAAsB,GAC1B,qBAAqB,EAAE,CAQzB;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,SAAK,GAAG,YAAY,EAAE,CA0BjF;AAED,2FAA2F;AAC3F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,sBAAsB,EAAE,CA0BjG;AAMD,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAWjE"}

package/dist/lib/diagnostics.d.ts

@@ -3,6 +3,7 @@ import { type BinaryCacheInfo } from "./binary-cache.js";
 import { type BuildBreakerSuspension } from "./build-breaker.js";
 import type { LegacyPartitionDuplicationSummary } from "./legacy-storage.js";
 import { type LspCacheReport } from "./lsp-cache.js";
+import { type PluginLoadBlockerCode, type PluginLoadEvaluation } from "./plugin-load.js";
 export interface DiagnosticReport {
     timestamp: string;
     platform: string;
@@ -19,7 +20,7 @@ export interface DiagnosticReport {
 }
 export type DiagnosticIssueSeverity = "high" | "medium" | "low" | "info";
 export interface DiagnosticIssue {
-    code: "binary_missing" | "host_missing" | "plugin_missing" | "config_parse_error" | "plugin_cli_version_skew" | "onnx_missing" | "onnx_incompatible";
+    code: "binary_missing" | "host_missing" | "plugin_missing" | "config_parse_error" | "plugin_cli_version_skew" | "onnx_missing" | "onnx_incompatible" | PluginLoadBlockerCode;
     severity: DiagnosticIssueSeverity;
     scope: string;
     message: string;
@@ -74,9 +75,21 @@ export interface HarnessDiagnostic {
         exists: boolean;
         sizeKb: number;
     };
+    /**
+     * What the plugin will do with this config at startup: the conditions that
+     * stop it from loading at all, and the effective semantic backend. Optional
+     * so hand-built reports (tests, older callers) still type-check.
+     */
+    pluginLoad?: PluginLoadEvaluation;
 }
 export declare function collectDiagnostics(adapters: HarnessAdapter[]): Promise<DiagnosticReport>;
 export declare function renderDiagnosticsMarkdown(report: DiagnosticReport): string;
+/**
+ * The plugin/CLI version-skew issue for one harness, or null when there is
+ * none. Doctor prints it in the harness section as well as under "Issues
+ * found", so both places carry the same text.
+ */
+export declare function pluginVersionSkewFor(report: DiagnosticReport, harness: HarnessDiagnostic): DiagnosticIssue | null;
 export declare function collectDiagnosticIssues(report: DiagnosticReport): DiagnosticIssue[];
 export declare function findPluginCliVersionSkews(report: DiagnosticReport): DiagnosticIssue[];
 export declare function formatDiagnosticIssuesSection(report: DiagnosticReport): string[];

package/dist/lib/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/diagnostics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/diagnostics.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,KAAK,sBAAsB,EAA+B,MAAM,oBAAoB,CAAC;AAG9F,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAWxE,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,WAAW,EAAE,eAAe,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,EAAE,cAAc,CAAC;IACzB,sFAAsF;IACtF,uBAAuB,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACpD;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,IAAI,EACA,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,oBAAoB,GACpB,yBAAyB,GACzB,cAAc,GACd,mBAAmB,GACnB,qBAAqB,CAAC;IAC1B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,UAAU,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC7D,SAAS,EAAE;QACT,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;IACF,WAAW,EAAE,UAAU,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC9D,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,0DAA0D;QAC1D,MAAM,EAAE,OAAO,CAAC;QAChB,iEAAiE;QACjE,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,iBAAiB,CAAC,EAAE,iCAAiC,CAAC;KACvD,CAAC;IACF,WAAW,EAAE;QACX,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB;;;;WAIG;QACH,gBAAgB,EAAE,OAAO,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;;;OAIG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuB9F;AAyHD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAiF1E;AAuFD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB,GACzB,eAAe,GAAG,IAAI,CAGxB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,EAAE,CAmHnF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,EAAE,CAIrF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAUhF;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA0C/D"}

package/dist/lib/feature-plan.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Types and invocation helpers for the feature plan owned by the native
+ * binary (`aft setup --plan`). The CLI renders the plan and sends choices
+ * back; it never derives feature state itself.
+ */
+export declare const SETUP_PLAN_VERSION = 1;
+/**
+ * Row kinds. A `setting` is a boolean setting of a tool (the bash settings);
+ * its prerequisite is the tool it configures.
+ */
+export type FeatureKind = "tool" | "index" | "capability" | "setting";
+export type FeatureEffective = "off" | "building" | "ready" | "unavailable";
+export interface PlanFeature {
+    id: string;
+    kind: FeatureKind;
+    group: string;
+    order: number;
+    label: string;
+    description: string;
+    binding: {
+        path: string;
+        tool_name: string | null;
+    };
+    default: boolean;
+    configured: boolean;
+    source: "default" | "config";
+    proposed: boolean;
+    effective: FeatureEffective;
+    reason: string | null;
+    available: boolean;
+    unavailable_reason: string | null;
+    cost_note: string | null;
+    prerequisites: string[];
+}
+export interface SetupPlan {
+    plan_version: number;
+    features: PlanFeature[];
+}
+export interface SetupAnswers {
+    plan_version: number;
+    selections: Record<string, boolean>;
+}
+/** Result of one native setup invocation. */
+export interface NativeResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    status: number | null;
+    /** True when no native binary was found, so nothing ran at all. */
+    missingBinary?: boolean;
+}
+/** Why a native command could not run when no binary is installed. */
+export declare const MISSING_BINARY_MESSAGE = "the AFT binary is not installed";
+export type NativeRunner = (args: string[], input?: string) => NativeResult;
+/** Run the native binary with `args`, capturing output. */
+export declare function runNative(args: string[], input?: string): NativeResult;
+/** A runner pinned to one binary, for a caller that just installed it. */
+export declare function nativeRunnerFor(binary: string): NativeRunner;
+/** Native arguments carrying an explicit harness selector, when one was given. */
+export declare function harnessArgs(harness: string | null | undefined): string[];
+/** The `--harness` value the user passed, if any. Never inferred from installed hosts. */
+export declare function explicitHarness(argv: string[]): string | null;
+export type PlanLoad = {
+    ok: true;
+    plan: SetupPlan;
+    warnings: string;
+} | {
+    ok: false;
+    error: string;
+    /** The binary refused the configuration itself (it needs `aft doctor --fix`). */
+    configRejected: boolean;
+    /** No binary was installed, so no plan could be produced. */
+    missingBinary?: boolean;
+};
+/**
+ * The native binary names its own commands as `aft doctor --fix` / `aft setup`,
+ * but a user running this CLI through npx has no `aft` on PATH. Rewrite those
+ * suggestions to the command they can actually run.
+ */
+export declare function withCliCommands(text: string): string;
+/** Load and validate the plan. Unknown plan versions are refused. */
+export declare function loadFeaturePlan(harness: string | null, run?: NativeRunner): PlanLoad;
+/**
+ * Write answers through the binary. `alreadyWarned` tells the binary this
+ * setup operation already reported its load warnings (from the plan call), so
+ * the write does not repeat them.
+ */
+export declare function writeFeatureAnswers(answers: SetupAnswers, harness: string | null, alreadyWarned: boolean, run?: NativeRunner): NativeResult;
+/** One file's outcome from `aft fix-config`. */
+export interface ConfigFixFile {
+    path: string;
+    tier: "user" | "project";
+    status: "rewritten" | "unchanged" | "failed";
+    notes: string[];
+    error: string | null;
+}
+export type ConfigFixRun = {
+    ok: true;
+    files: ConfigFixFile[];
+} | {
+    ok: false;
+    error: string;
+    missingBinary: boolean;
+};
+/**
+ * Run the configuration migration (`aft fix-config`). Per-file outcomes are
+ * returned even when some files failed; `ok:false` means the run produced no
+ * usable report at all.
+ */
+export declare function runConfigFix(run?: NativeRunner): ConfigFixRun;
+//# sourceMappingURL=feature-plan.d.ts.map

package/dist/lib/feature-plan.d.ts.map

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

package/dist/lib/fs-errors.d.ts

@@ -0,0 +1,34 @@
+/** Injectable filesystem facts, so the message can be tested for any owner. */
+export interface PermissionFacts {
+    /** Owner uid of an existing path, or null when it cannot be read. */
+    ownerUid(path: string): number | null;
+    /** The uid this process runs as, or null where uids do not exist (Windows). */
+    currentUid(): number | null;
+    /** A user name for a uid, or null when it cannot be resolved. */
+    userName(uid: number): string | null;
+    exists(path: string): boolean;
+    home(): string;
+}
+/** True for EACCES/EPERM/EROFS errors, or text carrying one of those codes. */
+export declare function isPermissionError(error: unknown): boolean;
+/** The path a Node fs error names, from `error.path` or the quoted path in its message. */
+export declare function errorPath(error: unknown): string | null;
+/** Show paths under the home directory as `~/…`, which is how users type them. */
+export declare function tildePath(path: string, home?: string): string;
+/**
+ * Describe a failed write to `target`.
+ *
+ * The owner shown is the nearest existing path (the file itself, or the first
+ * directory above a file that does not exist yet). When another user owns it,
+ * the fix widens to the highest directory below home that the same foreign
+ * owner holds, because `sudo npm i -g` usually takes the whole tree
+ * (`~/.config/opencode`, not just one file inside it).
+ */
+export declare function describePermissionProblem(target: string, facts?: PermissionFacts): string;
+/**
+ * One line for any filesystem error. Permission errors get the owner and fix
+ * command; everything else keeps its own message. `fallbackPath` is used when
+ * the error does not name a path itself.
+ */
+export declare function formatFsError(error: unknown, fallbackPath?: string, facts?: PermissionFacts): string;
+//# sourceMappingURL=fs-errors.d.ts.map

package/dist/lib/fs-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-errors.d.ts","sourceRoot":"","sources":["../../src/lib/fs-errors.ts"],"names":[],"mappings":"AAiBA,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,+EAA+E;IAC/E,UAAU,IAAI,MAAM,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,IAAI,IAAI,MAAM,CAAC;CAChB;AA6CD,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAcvD;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,CAGxE;AASD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,eAA8B,GACpC,MAAM,CA4BR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,GAAE,eAA8B,GACpC,MAAM,CAMR"}

package/dist/lib/jsonc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonc.d.ts","sourceRoot":"","sources":["../../src/lib/jsonc.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAW9E;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAcA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,GAAE,WAAoB,GAC3B,IAAI,CAKN;AAED,wDAAwD;AACxD,eAAO,MAAM,cAAc,gFACoD,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAClB;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAoC9C"}
+{"version":3,"file":"jsonc.d.ts","sourceRoot":"","sources":["../../src/lib/jsonc.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAW9E;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAcA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,GAAE,WAAoB,GAC3B,IAAI,CAKN;AAED,wDAAwD;AACxD,eAAO,MAAM,cAAc,gFACoD,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAClB;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA4C9C"}

package/dist/lib/omp-helpers.d.ts

@@ -1,4 +1,4 @@
-import { spawnSync } from "node:child_process";
+import { spawnSync } from "@cortexkit/aft-bridge";
 export interface OmpBinaryInfo {
     path: string;
     source: "path" | "home" | "package";

package/dist/lib/omp-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"omp-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/omp-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AAiDtD,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAY7F;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,EAAE,CAUV;AAED,wBAAgB,eAAe,IAAI,aAAa,GAAG,IAAI,CAYtD;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,OAAO,uBAAuB,CAAC;IAC9C,SAAS,EAAE,OAAO,SAAS,CAAC;CAC7B;AAOD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,SAAS,EAChB,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,gBAAgB,CAsBlB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,IAAI,CAsBtE"}
+{"version":3,"file":"omp-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/omp-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIlD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AAiDtD,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAY7F;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,EAAE,CAUV;AAED,wBAAgB,eAAe,IAAI,aAAa,GAAG,IAAI,CAYtD;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,OAAO,uBAAuB,CAAC;IAC9C,SAAS,EAAE,OAAO,SAAS,CAAC;CAC7B;AAOD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,SAAS,EAChB,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,gBAAgB,CAsBlB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,IAAI,CAsBtE"}

package/dist/lib/onnx-fix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onnx-fix.d.ts","sourceRoot":"","sources":["../../src/lib/onnx-fix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI5E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAmDlF;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,+CAA+C;IAC/C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/E,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3D;AA6ED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EAAE,EAC1B,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgF/B"}
+{"version":3,"file":"onnx-fix.d.ts","sourceRoot":"","sources":["../../src/lib/onnx-fix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK5E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAuDlF;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,+CAA+C;IAC/C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/E,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3D;AA6ED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EAAE,EAC1B,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgF/B"}

package/dist/lib/onnx.d.ts

@@ -12,7 +12,25 @@ export declare function getOnnxLibraryName(): string;
  */
 export declare function getManualInstallHint(): string;
 export declare function findIgnoredWindowsSystemOnnxRuntime(): string | null;
+/** A system runtime the bridge resolver will skip, and why. */
+export interface IgnoredSystemOnnxRuntime {
+    path: string;
+    reason: string;
+}
+export interface SystemOnnxRuntimeInspection {
+    /** The system runtime the bridge resolver would use, if any. */
+    path: string | null;
+    /** The first candidate skipped because it cannot be loaded. */
+    ignored: IgnoredSystemOnnxRuntime | null;
+}
 export declare function findSystemOnnxRuntime(): string | null;
+/**
+ * Mirror of the bridge resolver's system search, including its loadability
+ * probe, so doctor reports the runtime AFT will really use. A library whose
+ * required dependencies are missing is reported as ignored with the reason
+ * instead of as a compatible system runtime.
+ */
+export declare function inspectSystemOnnxRuntime(searchPathsOverride?: string[]): SystemOnnxRuntimeInspection;
 export declare function findCachedOnnxRuntime(storageDir: string): string | null;
 /**
  * Detect an installed ONNX Runtime's advertised version by walking the

package/dist/lib/onnx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onnx.d.ts","sourceRoot":"","sources":["../../src/lib/onnx.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAa7C;AAkDD,wBAAgB,mCAAmC,IAAI,MAAM,GAAG,IAAI,CAcnE;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAwErD;AACD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUvE;AAyBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwC9D;AAED,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM/D"}
+{"version":3,"file":"onnx.d.ts","sourceRoot":"","sources":["../../src/lib/onnx.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAa7C;AAkDD,wBAAgB,mCAAmC,IAAI,MAAM,GAAG,IAAI,CAcnE;AAED,+DAA+D;AAC/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,+DAA+D;IAC/D,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC1C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAC7B,2BAA2B,CAqF7B;AACD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUvE;AAyBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgD9D;AAED,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM/D"}

package/dist/lib/plugin-load.d.ts

@@ -0,0 +1,51 @@
+import { type ConfigErrorCode } from "@cortexkit/aft-bridge";
+/**
+ * What the plugin will do with the AFT config it loads at startup.
+ *
+ * `doctor` used to read the config only for display, so a config the plugin
+ * cannot use still reported "registered, healthy". This mirrors the plugin's
+ * startup config checks: retired keys the policy rejects, a file that does not
+ * parse, and a `subc.connection_file` that points at no file. On any of them
+ * the plugin still loads and registers its tools, but in its config error
+ * state: every AFT tool call fails with the error. The text of that error
+ * comes from the same `@cortexkit/aft-bridge` helpers the plugins use, so
+ * doctor quotes exactly what the model sees. It also derives the effective
+ * semantic backend, which decides whether ONNX Runtime is needed at all.
+ */
+export type PluginLoadBlockerCode = ConfigErrorCode;
+export interface PluginLoadBlocker {
+    code: PluginLoadBlockerCode;
+    /** The config file responsible. */
+    path: string;
+    /** Doctor's description, quoting the error every AFT tool call returns. */
+    message: string;
+    /** The exact text every AFT tool call fails with while this condition holds. */
+    toolCallError: string;
+    /** Exactly what the user (or `doctor --fix`) does about it. */
+    remediation: string;
+    /** True when `doctor --fix` repairs it (the retired-key migration). */
+    fixable: boolean;
+}
+export interface PluginLoadEvaluation {
+    blockers: PluginLoadBlocker[];
+    /** Whether the semantic index resolves on. */
+    semanticIndex: boolean;
+    /** The effective `semantic.backend` (`fastembed` when unset). */
+    semanticBackend: string;
+    /** True only for the local backend with the semantic index on. */
+    onnxRequired: boolean;
+}
+/** Same resolution as the plugin's transport factory: `~` and relative paths are under home. */
+export declare function resolveSubcConnectionPath(raw: string, home?: string): string;
+export interface PluginLoadInput {
+    userConfigPath: string;
+    /** Project directory whose `.cortexkit/aft.jsonc` the plugin also loads. */
+    projectDirectory?: string;
+    /** Harness id for `harnesses.<id>` overrides ("opencode" | "pi" | "omp"). */
+    harness: string;
+    /** Plugin version whose retired-key policy applies. */
+    pluginVersion: string;
+    home?: string;
+}
+export declare function evaluatePluginLoad(input: PluginLoadInput): PluginLoadEvaluation;
+//# sourceMappingURL=plugin-load.d.ts.map

package/dist/lib/plugin-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-load.d.ts","sourceRoot":"","sources":["../../src/lib/plugin-load.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAWrB,MAAM,uBAAuB,CAAC;AAK/B;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,YAAY,EAAE,OAAO,CAAC;CACvB;AAsBD,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5E;AAiBD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,oBAAoB,CAsF/E"}

package/dist/lib/sanitize.d.ts

@@ -1,4 +1,10 @@
 export declare function escapeRegex(value: string): string;
+/**
+ * Mask credentials only (tokens, URL userinfo, credential key/values, email
+ * addresses), leaving paths alone. `sanitizeContent` adds the path and
+ * username passes on top.
+ */
+export declare function redactSecrets(content: string): string;
 /**
  * Strip personally identifiable path segments and usernames from arbitrary
  * text. Used on log contents, diagnostic JSON blocks, and the final issue body

package/dist/lib/sanitize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/lib/sanitize.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAmFD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkCvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAarD"}
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/lib/sanitize.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAiED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA+CrD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkCvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAarD"}

package/dist/setup/feature-list.d.ts

@@ -0,0 +1,89 @@
+import type { Readable, Writable } from "node:stream";
+/**
+ * The grouped feature checklist for setup.
+ *
+ * Clack's own group multiselect prints a row's description as a hint in
+ * parentheses after the label, only for checked or focused rows, and wraps a
+ * long hint with the wrong tree prefix (the continuation line loses the `│`
+ * that joins the group). This renderer puts each description on its own
+ * indented line under the label, word-wrapped to the terminal width with the
+ * same tree prefix on every line, so a row renders the same whatever its state
+ * and the tree never breaks. Rows show only the label and description.
+ */
+export interface FeatureRow {
+    value: string;
+    label: string;
+    description: string;
+}
+/**
+ * How rows depend on each other. `requires` maps a setting row to the tool row
+ * it configures: while that tool is unchecked the setting does not apply, is
+ * drawn as not applicable and cannot be toggled, and keeps its value so
+ * checking the tool again restores it. `implies` maps a row to a row it needs:
+ * checking the row checks its prerequisite, and unchecking the prerequisite
+ * unchecks the row.
+ */
+export interface SelectionRules {
+    requires: ReadonlyMap<string, string>;
+    implies: ReadonlyMap<string, string>;
+    /** Display name of a required row, for the not-applicable note. */
+    labels?: ReadonlyMap<string, string>;
+}
+export declare const NO_RULES: SelectionRules;
+/**
+ * The selection after one toggle, with the rules applied: a row that does not
+ * apply keeps its previous value, a newly checked row checks its prerequisite,
+ * and a newly unchecked prerequisite unchecks the rows that need it.
+ */
+export declare function applySelectionRules(previous: readonly string[], next: readonly string[], rules: SelectionRules): string[];
+/**
+ * A finished selection made consistent: every checked row's prerequisite is
+ * checked. Used on whatever the prompt returns, so answers never ask for a
+ * row without the row it needs.
+ */
+export declare function normalizeSelection(picked: readonly string[], rules: SelectionRules): string[];
+/** Rows that do not apply under `selected`, each mapped to the unchecked row it requires. */
+export declare function inapplicableRows(selected: ReadonlySet<string>, rules: SelectionRules): Map<string, string>;
+/** Word-wrap plain text to `width` columns; a word longer than a line is split. */
+export declare function wrapWords(text: string, width: number): string[];
+export type RowState = "active" | "selected" | "active-selected" | "inactive";
+/**
+ * A group checkbox's state. `partial` is a group with some rows checked and
+ * some not: clack draws it the same as an empty group, which made a mostly-on
+ * group (say Editing with only aft_move and aft_delete off) look switched off.
+ */
+export type GroupState = RowState | "partial" | "active-partial";
+/**
+ * One feature row as terminal lines, without the guide bar. `last` marks the
+ * final row of its group, which closes the tree branch. `requires` names the
+ * unchecked row this one depends on: the row is then drawn as not applicable,
+ * with an empty dim checkbox whatever its remembered value.
+ */
+export declare function renderRowLines(row: FeatureRow, state: RowState, last: boolean, columns: number, requires?: string): string[];
+/**
+ * A group header: the group name with a checkbox that reflects its rows (all,
+ * some or none checked). Pressing space on a partial group checks every row,
+ * which is clack's toggle for any group that is not fully checked.
+ */
+export declare function renderGroupLine(name: string, state: GroupState): string;
+/** The header state for a group given how many of its rows are checked. */
+export declare function groupState(active: boolean, checked: number, total: number): GroupState;
+/**
+ * A complete static frame of the checklist: message, every group and row, and
+ * the key help. Used for the prompt's first paint and by tests; the live
+ * prompt scrolls the same lines when they do not fit the terminal.
+ */
+export declare function renderFeatureList(message: string, groups: Record<string, FeatureRow[]>, selected: ReadonlySet<string>, columns: number, cursor?: string | null, rules?: SelectionRules): string;
+/** Terminal streams for the prompt; tests pass their own to render at a fixed width. */
+export interface PromptStreams {
+    input?: Readable;
+    output?: Writable & {
+        columns?: number;
+    };
+}
+/**
+ * Show the checklist and return the checked row values; calls `onCancel` on
+ * cancel. `rules` keeps dependent rows consistent as the user toggles.
+ */
+export declare function promptFeatureList(message: string, groups: Record<string, FeatureRow[]>, initial: string[], onCancel: () => never, streams?: PromptStreams, rules?: SelectionRules): Promise<string[]>;
+//# sourceMappingURL=feature-list.d.ts.map

package/dist/setup/feature-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-list.d.ts","sourceRoot":"","sources":["../../src/setup/feature-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgBtD;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,eAAO,MAAM,QAAQ,EAAE,cAA4D,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,KAAK,EAAE,cAAc,GACpB,MAAM,EAAE,CAcV;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAM7F;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,KAAK,EAAE,cAAc,GACpB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrB;AAUD,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB/D;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,iBAAiB,GAAG,UAAU,CAAC;AAE9E;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAkBjE;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,EAAE,CAgBV;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAEvE;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAItF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EACpC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,KAAK,GAAE,cAAyB,GAC/B,MAAM,CAuBR;AAaD,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EACpC,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,MAAM,KAAK,EACrB,OAAO,GAAE,aAAkB,EAC3B,KAAK,GAAE,cAAyB,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAgFnB"}