@cortexkit/aft 0.57.2 → 0.58.1

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":"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"}

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/issue-body.d.ts

@@ -6,7 +6,7 @@
  *
  *   1. Error-line extraction — pull the most-recent ERROR-shaped lines from
  *      a sanitized log so the issue body has a dedicated `## Recent errors`
- *      section that survives even when the main log tail needs aggressive
+ *      section that survives even when the main log section needs aggressive
  *      truncation.
  *
  *   2. GitHub byte-budget capping — when a rendered report exceeds the
@@ -28,6 +28,7 @@
  */
 export declare const MAX_GITHUB_BODY_BYTES = 60000;
 export declare function filterLogToSession(logText: string, sessionId: string): string;
+export declare function isErrorLogLine(line: string): boolean;
 /**
  * Extract the most-recent error-shaped log lines from a sanitized log.
  * Returns them in chronological order (oldest match first → newest match
@@ -43,7 +44,7 @@ export declare function extractRecentErrors(sanitized: string, limit?: number):
 /**
  * Apply a byte budget to a rendered issue body. If the body is already
  * within budget, returns it unchanged. Otherwise rewrites the main
- * fenced log block (whose heading must start with `## Logs (last`) to
+ * fenced log block (whose heading must start with `## Logs (`) to
  * drop oldest log lines until the body fits, leaving a clear
  * `[truncated for GitHub 64KB limit — older log lines dropped]` marker
  * at the top of the kept slice.
@@ -55,7 +56,7 @@ export declare function extractRecentErrors(sanitized: string, limit?: number):
  *
  * AFT's main log section contains per-harness sub-sections (`#### opencode
  * log (path)\n```...```\n#### pi log (path)\n```...```\n`). The cap walks
- * the entire `## Logs (last ...` block as a single shrinkable region
+ * the entire `## Logs (...)` block as a single shrinkable region
  * because precise per-harness allocation is fiddly and the alternative —
  * dropping the whole log block on overflow — is strictly worse for
  * debugging.

package/dist/lib/issue-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue-body.d.ts","sourceRoot":"","sources":["../../src/lib/issue-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAa5C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAW7E;AA2CD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE,CAU3E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA8B,GACvC,MAAM,CAqER"}
+{"version":3,"file":"issue-body.d.ts","sourceRoot":"","sources":["../../src/lib/issue-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAa5C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAW7E;AAuCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE,CAU3E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA8B,GACvC,MAAM,CAoER"}

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/lib/session-log.d.ts

@@ -0,0 +1,9 @@
+import type { RecentSession } from "./sessions.js";
+export interface SessionLogResult {
+    lines: string[];
+    errors: string[];
+    boundHit: boolean;
+}
+/** Read newest matching lines from the active log and its single rotated predecessor. */
+export declare function readSessionLog(path: string, session: RecentSession, maxBytes?: number): SessionLogResult;
+//# sourceMappingURL=session-log.d.ts.map

package/dist/lib/session-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log.d.ts","sourceRoot":"","sources":["../../src/lib/session-log.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQnD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,EACtB,QAAQ,SAAiB,GACxB,gBAAgB,CAsElB"}

package/dist/lib/sessions.d.ts

@@ -3,16 +3,20 @@ export interface RecentSession {
     id: string;
     title: string;
     lastActivity: number;
+    projectRoot?: string;
+    startedAt?: number;
 }
 interface OpenCodeSessionRow {
     id: unknown;
     title: unknown;
     time_updated: unknown;
+    time_created?: unknown;
+    directory?: unknown;
 }
 export declare function listRecentSessions(adapter: HarnessAdapter): RecentSession[];
 export declare function mapOpenCodeSessionRows(rows: OpenCodeSessionRow[]): RecentSession[];
 export declare function listPiSessionsFromDir(sessionsDir: string): RecentSession[];
-export declare function parsePiSessionJsonl(jsonl: string, fallbackFilename?: string): Pick<RecentSession, "id" | "title"> | null;
+export declare function parsePiSessionJsonl(jsonl: string, fallbackFilename?: string): Pick<RecentSession, "id" | "title" | "projectRoot" | "startedAt"> | null;
 export declare function truncateTitle(title: string, maxLength?: number): string;
 export {};
 //# sourceMappingURL=sessions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/lib/sessions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,kBAAkB;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;CACvB;AASD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,EAAE,CAS3E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,aAAa,EAAE,CAiBlF;AA0CD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CA8B1E;AA0BD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,gBAAgB,SAAK,GACpB,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,CA8B5C;AAqCD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAInE"}
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/lib/sessions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AASD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,EAAE,CAS3E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,aAAa,EAAE,CAsBlF;AA4CD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CA8B1E;AA0BD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,gBAAgB,SAAK,GACpB,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,CAAC,GAAG,IAAI,CA0C1E;AAqCD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAInE"}