@kontextmind/kxm 0.7.177 → 0.7.179

package/plugins/kxm/dist/cli.js

@@ -8880,7 +8880,7 @@ var require_public_api = __commonJS({
       }
       return doc;
     }
-    function parse12(src, reviver, options) {
+    function parse13(src, reviver, options) {
       let _reviver = void 0;
       if (typeof reviver === "function") {
         _reviver = reviver;
@@ -8921,7 +8921,7 @@ var require_public_api = __commonJS({
         return value.toString(options);
       return new Document.Document(value, _replacer, options).toString(options);
     }
-    exports.parse = parse12;
+    exports.parse = parse13;
     exports.parseAllDocuments = parseAllDocuments;
     exports.parseDocument = parseDocument3;
     exports.stringify = stringify12;
@@ -9184,6 +9184,7 @@ function loadKxmConfig(repoRoot = process.cwd(), options = {}) {
   const userConfigFile = join3(userDir, "config.yaml");
   const repoDir = repoConfigDirectory(repoRoot);
   const repoConfigFile = join3(repoDir, "config.yaml");
+  const includeProject = options.layers !== "user";
   let userRaw = {};
   let userLoadedPath;
   if (existsSync3(userConfigFile)) {
@@ -9197,7 +9198,7 @@ function loadKxmConfig(repoRoot = process.cwd(), options = {}) {
   }
   let repoRaw = {};
   let repoLoadedPath;
-  if (existsSync3(repoConfigFile)) {
+  if (includeProject && existsSync3(repoConfigFile)) {
     try {
       const text = readFileSync2(repoConfigFile, "utf8");
       repoRaw = (0, import_yaml.parse)(text) ?? {};
@@ -14043,7 +14044,7 @@ var require_fast_uri = __commonJS({
         normalizeString(uri, options);
       } else if (typeof uri === "object") {
         uri = /** @type {T} */
-        parse12(serialize(uri, options), options);
+        parse13(serialize(uri, options), options);
       }
       return uri;
     }
@@ -14083,8 +14084,8 @@ var require_fast_uri = __commonJS({
     function resolveComponent(base, relative8, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
-        base = parse12(serialize(base, options), options);
-        relative8 = parse12(serialize(relative8, options), options);
+        base = parse13(serialize(base, options), options);
+        relative8 = parse13(serialize(relative8, options), options);
       }
       options = options || {};
       if (!options.tolerant && relative8.scheme) {
@@ -14376,7 +14377,7 @@ var require_fast_uri = __commonJS({
       }
       return { parsed, malformedAuthorityOrPort, malformedPercentEncoding, malformedSchemeSpecific, malformedHost, malformedScheme };
     }
-    function parse12(uri, opts) {
+    function parse13(uri, opts) {
       return parseWithStatus(uri, opts).parsed;
     }
     function normalizeString(uri, opts) {
@@ -14413,7 +14414,7 @@ var require_fast_uri = __commonJS({
       resolveComponent,
       equal,
       serialize,
-      parse: parse12
+      parse: parse13
     };
     module.exports = fastUri;
     module.exports.default = fastUri;
@@ -19547,7 +19548,7 @@ function resolveDispatchStatus(entry, detected, authenticated, issues) {
     return { status: "no", supported: false, reason: "not_authenticated" };
   }
   if (authenticated === null) {
-    const authIssue = issues.find((issue4) => issue4 === "auth_context_required" || issue4 === "auth_unknown" || issue4 === "auth_unparsed" || issue4.startsWith("auth_"));
+    const authIssue = issues.find((issue5) => issue5 === "auth_context_required" || issue5 === "auth_unknown" || issue5 === "auth_unparsed" || issue5.startsWith("auth_"));
     return { status: "no", supported: false, reason: authIssue ?? issues[0] ?? "auth_unknown" };
   }
   return { status: "yes", supported: true };
@@ -20759,8 +20760,8 @@ function validateWorkflow(workflow, agents, models, repositories, gates, issues)
       const writable = Object.values(objectValue(step.repositories) ?? {}).filter((access) => access === "write").length;
       if (maxWriteRepositories > writable) issues.push(issue3("semantic", "write_repository_bound_invalid", file, `${stepId} maxWriteRepositories exceeds writable repository scope`));
     }
-    const join59 = objectValue(step.join);
-    const minimumPassed = join59 && typeof join59.minimumPassed === "number" ? join59.minimumPassed : void 0;
+    const join60 = objectValue(step.join);
+    const minimumPassed = join60 && typeof join60.minimumPassed === "number" ? join60.minimumPassed : void 0;
     if (minimumPassed !== void 0 && minimumPassed > maximum) issues.push(issue3("semantic", "join_impossible", file, `${stepId} minimumPassed exceeds assignment maximum`));
     const distinctBy = names(assignment?.distinctBy);
     if (distinctBy.length > 0) {
@@ -21473,7 +21474,7 @@ var init_project_config = __esm({
       issues;
       constructor(issues) {
         const sorted = sortIssues3(issues);
-        super(sorted.map((issue4) => `${issue4.file}: ${issue4.code}: ${issue4.message}`).join("\n"));
+        super(sorted.map((issue5) => `${issue5.file}: ${issue5.code}: ${issue5.message}`).join("\n"));
         this.name = "KxmConfigError";
         this.issues = sorted;
       }
@@ -22356,8 +22357,8 @@ import {
 } from "node:fs";
 import { basename as basename3, dirname as dirname9, isAbsolute as isAbsolute5, join as join12, relative as relative3, resolve as resolve10, sep as sep3 } from "node:path";
 function databaseError(code, file, message) {
-  const issue4 = { phase: "semantic", code, file, message };
-  return new KxmConfigError([issue4]);
+  const issue5 = { phase: "semantic", code, file, message };
+  return new KxmConfigError([issue5]);
 }
 function checkedParent(path4, description) {
   const parent = dirname9(path4);
@@ -25100,7 +25101,7 @@ function compileStep(step, index, stepIndex, requirePlanHash, sink) {
   const maxAttempts = compileCountField(step.maxAttempts, 1, `${id}.maxAttempts`, id, sink);
   const timeoutMs = compileOptionalDuration(step.timeoutMs, `${id}.timeoutMs`, id, sink);
   const assignments = compileAssignments(step, id, agent, sink);
-  const join59 = compileJoin(step, id, sink);
+  const join60 = compileJoin(step, id, sink);
   const requiredEvidence = compileEvidence(step, id, sink);
   const transitions = compileTransitions(step, id, index, stepIndex, sink);
   const outcomes = Object.keys(transitions).sort(compareCodeUnits5);
@@ -25128,7 +25129,7 @@ function compileStep(step, index, stepIndex, requirePlanHash, sink) {
     transitions: orderedTransitions,
     requiresPlanHash: requirePlanHash.includes(id),
     assignments,
-    join: join59
+    join: join60
   };
   if (kind === "agent" || kind === "moa") {
     if (!agent) return void 0;
@@ -25178,15 +25179,15 @@ function compileAssignments(step, stepId, primaryAgentId, sink) {
   };
 }
 function compileJoin(step, stepId, sink) {
-  const join59 = objectValue2(step.join);
-  if (!join59) return { strategy: "all" };
-  const declared = stringValue2(join59.strategy);
+  const join60 = objectValue2(step.join);
+  if (!join60) return { strategy: "all" };
+  const declared = stringValue2(join60.strategy);
   const strategy = declared && JOIN_STRATEGIES.has(declared) ? declared : "all";
-  const minimumPassed = compileOptionalCount(join59.minimumPassed, `${stepId}.join.minimumPassed`, stepId, sink);
+  const minimumPassed = compileOptionalCount(join60.minimumPassed, `${stepId}.join.minimumPassed`, stepId, sink);
   const compiled = {
     strategy,
     ...minimumPassed !== void 0 ? { minimumPassed } : {},
-    ...typeof join59.cancelRemaining === "boolean" ? { cancelRemaining: join59.cancelRemaining } : {}
+    ...typeof join60.cancelRemaining === "boolean" ? { cancelRemaining: join60.cancelRemaining } : {}
   };
   return compiled;
 }
@@ -25451,8 +25452,8 @@ function sortIssues4(issues) {
     return compareCodeUnits5(left.code, right.code);
   });
 }
-function pushIssue(sink, issue4) {
-  sink.issues.push({ workflowId: sink.workflowId, ...issue4 });
+function pushIssue(sink, issue5) {
+  sink.issues.push({ workflowId: sink.workflowId, ...issue5 });
 }
 var KXM_COMPILED_WORKFLOW_SCHEMA, WORKFLOW_SCHEMA, STEP_ID_PATTERN, SUPPORTED_STEP_KINDS, TERMINAL_STATUSES, JOIN_STRATEGIES, EVIDENCE_KINDS, REPOSITORY_ACCESS, DISTINCT_BY, BANNED_RUNTIME_HINT, KxmEngineCompileError;
 var init_engine_compile = __esm({
@@ -25472,7 +25473,7 @@ var init_engine_compile = __esm({
       issues;
       constructor(issues) {
         const sorted = sortIssues4(issues);
-        super(sorted.map((issue4) => `${issue4.workflowId}: ${issue4.code}: ${issue4.message}`).join("\n"));
+        super(sorted.map((issue5) => `${issue5.workflowId}: ${issue5.code}: ${issue5.message}`).join("\n"));
         this.name = "KxmEngineCompileError";
         this.issues = sorted;
       }
@@ -31226,7 +31227,7 @@ async function cmdKxmInit(runtime, options, postHooks) {
       return finishInit(0, `init plan: ${initialized.plan.mode}`);
     }
     const next = initialized.plan.mode === "legacy" ? "legacy state is not migrated by this build: initialise a fresh project directory and copy the YAML definitions you want to keep" : initialized.repairPlan?.issues.length ? "managed-template repair is blocked by conflicts or authority changes; local files were preserved" : "partial or provenance-free KXM state requires explicit repair; no files were overwritten";
-    return finishInit(1, [next, ...initialized.plan.issues.map((issue4) => `${issue4.file}: ${issue4.code}: ${issue4.message}`)].join("\n"));
+    return finishInit(1, [next, ...initialized.plan.issues.map((issue5) => `${issue5.file}: ${issue5.code}: ${issue5.message}`)].join("\n"));
   } catch (error) {
     if (error instanceof KxmConfigError) {
       print(runtime.io, runtime.json, {
@@ -40186,7 +40187,7 @@ async function cmdContextWikiLint(runtime, project) {
   const compiled = response.body;
   const issues = compiled.lint;
   print(runtime.io, runtime.json, { ok: issues.length === 0, command: "context wiki-lint", project, issues, audit: compiled.audit }, issues.length === 0 ? "wiki lint clean" : `wiki lint found ${issues.length} issue(s)`);
-  return issues.every((issue4) => issue4.severity !== "error") ? 0 : 1;
+  return issues.every((issue5) => issue5.severity !== "error") ? 0 : 1;
 }
 function skillStateFromFlag(value) {
   if (value === "candidate" || value === "promoted" || value === "quarantined" || value === "rejected") return value;
@@ -40402,11 +40403,114 @@ ${lines.join("\n")}`
 init_project();
 
 // plugins/kxm/src/cli/plugins.ts
+var import_yaml19 = __toESM(require_dist(), 1);
 init_repo_root();
 init_harness();
 init_types();
 import { spawnSync as spawnSync9 } from "node:child_process";
+import { existsSync as existsSync32, readFileSync as readFileSync30 } from "node:fs";
+import { isAbsolute as isAbsolute10, join as join36 } from "node:path";
 var PLUGIN_SUPPORTED_HARNESSES = Object.freeze(["pi", "omp", "claude"]);
+var OMP_STATUS_SETTINGS = [
+  { key: "statusLine.leftSegments", configKey: "leftSegments", value: ["model", "mode", "git", "pr", "subagents"] },
+  { key: "statusLine.rightSegments", configKey: "rightSegments", value: ["usage", "cost", "context_pct"] },
+  { key: "statusLine.preset", configKey: "preset", value: "custom" }
+];
+function spawnHarness(runtime, command, args) {
+  return runtime.io.spawnSync ? runtime.io.spawnSync(command, args) : spawnSync9(command, args, { encoding: "utf8", windowsHide: true, env: runtime.env });
+}
+function spawnFailed(run) {
+  return Boolean(run.error) || run.status !== 0;
+}
+function spawnFailureDetail(run, fallback) {
+  return (run.stderr || run.stdout || run.error?.message || fallback).trim();
+}
+function ompConfigValueArg(value) {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function readOmpGlobalStatusSettings(runtime, command) {
+  const args = ["config", "path"];
+  const run = spawnHarness(runtime, command, args);
+  if (spawnFailed(run)) return { args, run, rollbackAttempted: false, rollbackFailed: false };
+  const agentDir = run.stdout.trim();
+  if (!agentDir || !isAbsolute10(agentDir) || !existsSync32(agentDir)) {
+    return {
+      args,
+      run: { status: 1, stdout: run.stdout, stderr: "omp config path did not return an existing absolute directory" },
+      rollbackAttempted: false,
+      rollbackFailed: false
+    };
+  }
+  const configPath = ["config.yml", "config.yaml"].map((name) => join36(agentDir, name)).find(existsSync32);
+  let document = {};
+  try {
+    if (configPath) document = (0, import_yaml19.parse)(readFileSync30(configPath, "utf8"));
+  } catch {
+    return {
+      args,
+      run: { status: 1, stdout: run.stdout, stderr: `could not read OMP global config at ${configPath}` },
+      rollbackAttempted: false,
+      rollbackFailed: false
+    };
+  }
+  const root = document && typeof document === "object" && !Array.isArray(document) ? document : {};
+  const rawStatusLine = "statusLine" in root ? root.statusLine : void 0;
+  const statusLine = rawStatusLine && typeof rawStatusLine === "object" && !Array.isArray(rawStatusLine) ? rawStatusLine : {};
+  const previous = {};
+  for (const setting of OMP_STATUS_SETTINGS) {
+    const value = statusLine[setting.configKey];
+    previous[setting.key] = Object.hasOwn(statusLine, setting.configKey) && value !== null && value !== void 0 ? { present: true, value } : { present: false };
+  }
+  return { previous };
+}
+function rollbackOmpStatusBand(runtime, command, settings, previous) {
+  let failed2 = false;
+  for (const setting of [...settings].reverse()) {
+    const snapshot = previous[setting.key];
+    const args = snapshot?.present ? ["config", "set", setting.key, ompConfigValueArg(snapshot.value), "--json"] : ["config", "reset", setting.key, "--json"];
+    if (spawnFailed(spawnHarness(runtime, command, args))) failed2 = true;
+  }
+  return failed2;
+}
+function configureOmpStatusBand(runtime, command) {
+  const snapshot = readOmpGlobalStatusSettings(runtime, command);
+  if ("run" in snapshot) return snapshot;
+  const written = [];
+  for (const setting of OMP_STATUS_SETTINGS) {
+    const args = ["config", "set", setting.key, ompConfigValueArg(setting.value), "--json"];
+    written.push(setting);
+    const run = spawnHarness(runtime, command, args);
+    if (spawnFailed(run)) {
+      return {
+        args,
+        run,
+        rollbackAttempted: true,
+        rollbackFailed: rollbackOmpStatusBand(runtime, command, written, snapshot.previous)
+      };
+    }
+  }
+  for (const setting of OMP_STATUS_SETTINGS) {
+    const args = ["config", "get", setting.key, "--json"];
+    const run = spawnHarness(runtime, command, args);
+    let actual;
+    try {
+      const parsed = JSON.parse(run.stdout);
+      actual = parsed && typeof parsed === "object" && "value" in parsed ? parsed.value : void 0;
+    } catch {
+      actual = void 0;
+    }
+    if (spawnFailed(run) || JSON.stringify(actual) !== JSON.stringify(setting.value)) {
+      const mismatch = spawnFailed(run) ? run : { status: 1, stdout: run.stdout, stderr: `effective ${setting.key} is shadowed or did not persist` };
+      return {
+        args,
+        run: mismatch,
+        rollbackAttempted: true,
+        rollbackFailed: rollbackOmpStatusBand(runtime, command, written, snapshot.previous)
+      };
+    }
+  }
+  return void 0;
+}
 async function cmdPluginInstall(runtime, options) {
   const repoRoot = findKxmRepoRoot(import.meta.url);
   const env = runtime.env.PATH ? runtime.env : { ...process.env, ...runtime.env };
@@ -40417,12 +40521,22 @@ async function cmdPluginInstall(runtime, options) {
   if (options.omp) requestedHarnesses.push("omp");
   if (options.claude) requestedHarnesses.push("claude");
   const targetHarnesses = isExplicit ? requestedHarnesses : PLUGIN_SUPPORTED_HARNESSES;
+  if (options.statusBand && isExplicit && !options.omp) {
+    const detail = "--status-band requires OMP to be among the selected harnesses";
+    print(
+      runtime.io,
+      runtime.json,
+      { ok: false, command: "plugin install", error: "omp_status_band_requires_omp", results: [] },
+      detail
+    );
+    return 1;
+  }
   const results = [];
   for (const harnessId of targetHarnesses) {
     const status = inventory.harnesses.find((h) => h.id === harnessId);
     const detected = Boolean(status?.detected && status?.command);
     if (!detected) {
-      if (isExplicit) {
+      if (isExplicit || options.statusBand && harnessId === "omp") {
         results.push({
           harness: harnessId,
           status: "failed",
@@ -40444,15 +40558,15 @@ async function cmdPluginInstall(runtime, options) {
           detail: `would install kxm plugin into pi: ${command} ${args.join(" ")}`
         });
       } else {
-        const run = runtime.io.spawnSync ? runtime.io.spawnSync(command, args) : spawnSync9(command, args, { encoding: "utf8", windowsHide: true, env: runtime.env });
-        if (run.error || run.status !== 0 && run.status !== null) {
+        const run = spawnHarness(runtime, command, args);
+        if (spawnFailed(run)) {
           results.push({
             harness: "pi",
             status: "failed",
             command,
             args,
             error: run.error?.message || "install_failed",
-            detail: (run.stderr || run.stdout || "pi install exited with error").trim()
+            detail: spawnFailureDetail(run, "pi install exited with error")
           });
         } else {
           results.push({
@@ -40472,27 +40586,39 @@ async function cmdPluginInstall(runtime, options) {
           status: "would",
           command,
           args,
-          detail: `would install kxm plugin into omp: ${command} ${args.join(" ")}`
+          detail: options.statusBand ? `would install kxm plugin into omp and configure the focused subscription status band: ${command} ${args.join(" ")}` : `would install kxm plugin into omp: ${command} ${args.join(" ")}`
         });
       } else {
-        const run = runtime.io.spawnSync ? runtime.io.spawnSync(command, args) : spawnSync9(command, args, { encoding: "utf8", windowsHide: true, env: runtime.env });
-        if (run.error || run.status !== 0 && run.status !== null) {
+        const run = spawnHarness(runtime, command, args);
+        if (spawnFailed(run)) {
           results.push({
             harness: "omp",
             status: "failed",
             command,
             args,
             error: run.error?.message || "install_failed",
-            detail: (run.stderr || run.stdout || "omp plugin install exited with error").trim()
+            detail: spawnFailureDetail(run, "omp plugin install exited with error")
           });
         } else {
-          results.push({
-            harness: "omp",
-            status: "passed",
-            command,
-            args,
-            detail: "installed kxm plugin into omp"
-          });
+          const configFailure = options.statusBand ? configureOmpStatusBand(runtime, command) : void 0;
+          if (configFailure) {
+            results.push({
+              harness: "omp",
+              status: "failed",
+              command,
+              args: configFailure.args,
+              error: "status_band_config_failed",
+              detail: `installed kxm plugin into omp, but ${configFailure.args.slice(0, 3).join(" ")} failed: ${spawnFailureDetail(configFailure.run, "omp status band configuration exited with error")}${configFailure.rollbackAttempted ? configFailure.rollbackFailed ? "; previous settings could not be fully restored" : "; previous settings restored" : ""}`
+            });
+          } else {
+            results.push({
+              harness: "omp",
+              status: "passed",
+              command,
+              args,
+              detail: options.statusBand ? "installed kxm plugin into omp and configured the focused subscription status band; restart omp" : "installed kxm plugin into omp"
+            });
+          }
         }
       }
     } else if (harnessId === "claude") {
@@ -40512,15 +40638,15 @@ async function cmdPluginInstall(runtime, options) {
         } else {
           spawnSync9(command, marketplaceArgs, { encoding: "utf8", windowsHide: true, env: runtime.env });
         }
-        const run = runtime.io.spawnSync ? runtime.io.spawnSync(command, installArgs) : spawnSync9(command, installArgs, { encoding: "utf8", windowsHide: true, env: runtime.env });
-        if (run.error || run.status !== 0 && run.status !== null) {
+        const run = spawnHarness(runtime, command, installArgs);
+        if (spawnFailed(run)) {
           results.push({
             harness: "claude",
             status: "failed",
             command,
             args: installArgs,
             error: run.error?.message || "install_failed",
-            detail: (run.stderr || run.stdout || "claude plugin install exited with error").trim()
+            detail: spawnFailureDetail(run, "claude install exited with error")
           });
         } else {
           results.push({
@@ -40564,8 +40690,8 @@ async function cmdPluginInstall(runtime, options) {
 init_project_config();
 init_types();
 import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync32 } from "node:fs";
-import { join as join36 } from "node:path";
+import { existsSync as existsSync33 } from "node:fs";
+import { join as join37 } from "node:path";
 var GENERATOR = "plans/kxm-roadmap/update-dashboard.mjs";
 var SERVER = "ops/docs-site/serve.py";
 function requireProject(runtime, command) {
@@ -40582,8 +40708,8 @@ function requireProject(runtime, command) {
   return root;
 }
 function requireFile(runtime, command, root, relative8, error) {
-  const file = join36(root, relative8);
-  if (existsSync32(file)) return file;
+  const file = join37(root, relative8);
+  if (existsSync33(file)) return file;
   print(
     runtime.io,
     runtime.json,
@@ -40637,15 +40763,15 @@ init_runtime_store();
 init_runtime_supervisor();
 init_types();
 import { spawnSync as spawnSync10 } from "node:child_process";
-import { chmodSync as chmodSync6, existsSync as existsSync33, mkdirSync as mkdirSync24, readFileSync as readFileSync30, writeFileSync as writeFileSync22 } from "node:fs";
-import { basename as basename8, dirname as dirname18, join as join37, resolve as resolve25 } from "node:path";
+import { chmodSync as chmodSync6, existsSync as existsSync34, mkdirSync as mkdirSync24, readFileSync as readFileSync31, writeFileSync as writeFileSync22 } from "node:fs";
+import { basename as basename8, dirname as dirname18, join as join38, resolve as resolve25 } from "node:path";
 var LANE_SCHEMA = "kxm.lanes.v1";
 var SHA_RE = /^[a-f0-9]{40,64}$/;
 var TIMESTAMP_RE = /^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\.[0-9]{1,9})?Z$/;
 var SETTLED_RUN = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 var LANE_RUN_LIST_LIMIT = 1e4;
 function lanesFile(runtime) {
-  return join37(runtime.dirs.state, "lanes.json");
+  return join38(runtime.dirs.state, "lanes.json");
 }
 function gitEnv2() {
   return Object.fromEntries(Object.entries(process.env).filter(([name]) => !name.toUpperCase().startsWith("GIT_")));
@@ -40693,9 +40819,9 @@ function isLaneFile(value) {
 }
 function loadLanes(runtime, command) {
   const file = lanesFile(runtime);
-  if (!existsSync33(file)) return { schema: LANE_SCHEMA, lanes: {} };
+  if (!existsSync34(file)) return { schema: LANE_SCHEMA, lanes: {} };
   try {
-    const parsed = JSON.parse(readFileSync30(file, "utf8"));
+    const parsed = JSON.parse(readFileSync31(file, "utf8"));
     if (!isLaneFile(parsed)) return refuse(runtime, command, "lanes_unreadable", `lane record ${file} is malformed`);
     return parsed;
   } catch {
@@ -40752,7 +40878,7 @@ function withLaneCwd(runtime, unit, command = "lane") {
   const loaded2 = loadLanes(runtime, command);
   if (typeof loaded2 === "number") return loaded2;
   const lane = loaded2.lanes[unit];
-  if (!lane || !existsSync33(lane.path)) {
+  if (!lane || !existsSync34(lane.path)) {
     return refuse(runtime, command, "lane_missing", `lane ${unit} is not recorded or its worktree is absent`, { unit });
   }
   return {
@@ -40806,7 +40932,7 @@ async function cmdKxmRunCli(runtime, workflow, promptParts, options = {}) {
 }
 function readRunBrief(runtime, file, command) {
   try {
-    return { text: readFileSync30(resolve25(runtime.cwd, file), "utf8").trim() };
+    return { text: readFileSync31(resolve25(runtime.cwd, file), "utf8").trim() };
   } catch {
     return refuse(runtime, command, "brief_unreadable", `cannot read brief ${file}`, { brief: file });
   }
@@ -40823,7 +40949,7 @@ function aheadBehind(path4, baseSha) {
   return { behind: Number(match[1]), ahead: Number(match[2]) };
 }
 function laneView(unit, record) {
-  const exists = existsSync33(record.path);
+  const exists = existsSync34(record.path);
   const counts = exists ? aheadBehind(record.path, record.baseSha) : { ahead: null, behind: null };
   return {
     unit,
@@ -40900,7 +41026,7 @@ async function laneStoreRuns(runtime, lanePath) {
     }
   }
   const eventsPath = kxmProjectRunEventsPath(lanePath, runtime.env);
-  if (!existsSync33(eventsPath)) return void 0;
+  if (!existsSync34(eventsPath)) return void 0;
   const store = new KxmRunEventStore(eventsPath);
   try {
     return store.runsForProject(projectId(), LANE_RUN_LIST_LIMIT).map((run) => ({ runId: run.runId, status: run.status }));
@@ -40969,7 +41095,7 @@ async function cmdLaneCreate(runtime, unit, options = {}) {
   const loaded2 = loadLanes(runtime, command);
   if (typeof loaded2 === "number") return loaded2;
   const path4 = laneWorktreePath(root, unit);
-  if (loaded2.lanes[unit] || existsSync33(path4) || branchExists(root, unit)) {
+  if (loaded2.lanes[unit] || existsSync34(path4) || branchExists(root, unit)) {
     return refuse(runtime, command, "lane_exists", `lane ${unit} already exists`, { unit });
   }
   const baseSha = resolveBase(root, base);
@@ -40994,7 +41120,7 @@ async function cmdLaneCreate(runtime, unit, options = {}) {
     return refuse(runtime, command, "lane_git_failed", `git worktree add failed: ${added.stderr.trim().slice(0, 300)}`, { unit });
   }
   const recordedPath = discoverKxmProjectRoot(path4) ?? path4;
-  if (!existsSync33(join37(recordedPath, ".kxm", "project.yaml"))) {
+  if (!existsSync34(join38(recordedPath, ".kxm", "project.yaml"))) {
     git2(root, ["worktree", "remove", "--force", path4]);
     return refuse(runtime, command, "lane_not_project", `lane ${recordedPath} has no .kxm/project.yaml; the worktree was removed`, { unit, path: recordedPath });
   }
@@ -41060,7 +41186,7 @@ async function unregisterLaneRoot(runtime, projectRoot, force) {
       return void 0;
     }
     const paths = kxmRuntimePaths({ env: runtime.env });
-    if (!existsSync33(paths.registryDb)) return void 0;
+    if (!existsSync34(paths.registryDb)) return void 0;
     const registry = new KxmRuntimeRegistry(paths.registryDb);
     let outcome;
     try {
@@ -41090,7 +41216,7 @@ async function cmdLaneDrop(runtime, unit, options = {}) {
   if (!record) return refuse(runtime, command, "lane_missing", `lane ${unit} is not recorded`, { unit });
   const force = options.force === true;
   if (!force) {
-    if (existsSync33(record.path)) {
+    if (existsSync34(record.path)) {
       const dirty = porcelainCount(record.path);
       if (dirty === null) {
         return refuse(runtime, command, "lane_git_failed", `lane ${unit} worktree status could not be read`, { unit });
@@ -41116,7 +41242,7 @@ async function cmdLaneDrop(runtime, unit, options = {}) {
   if (unregistered !== void 0) {
     return refuse(runtime, command, "lane_unregister_failed", `lane ${unit} could not be unregistered: ${unregistered.slice(0, 300)}`, { unit });
   }
-  if (existsSync33(record.path)) {
+  if (existsSync34(record.path)) {
     const removed = git2(root, ["worktree", "remove", ...force ? ["--force"] : [], record.path]);
     if (removed.status !== 0) {
       return refuse(runtime, command, "lane_git_failed", `git worktree remove failed: ${removed.stderr.trim().slice(0, 300)}`, { unit });
@@ -41187,7 +41313,7 @@ init_project_config();
 init_repo_root();
 init_types();
 import { spawn as spawn5 } from "node:child_process";
-import { join as join38 } from "node:path";
+import { join as join39 } from "node:path";
 function childEnv() {
   const env = {};
   for (const [name, value] of Object.entries(process.env)) {
@@ -41206,7 +41332,7 @@ function cmdLand(runtime, options = {}) {
   if (!root) {
     return Promise.resolve(refuse2(runtime, "project_required", "land requires a KXM project (run kxm init first)"));
   }
-  const script = join38(findKxmRepoRoot(import.meta.url), "scripts", "pr-land.mjs");
+  const script = join39(findKxmRepoRoot(import.meta.url), "scripts", "pr-land.mjs");
   const args = [script];
   if (options.pr) args.push("--pr", options.pr);
   if (options.stage) args.push("--stage", options.stage);
@@ -41226,19 +41352,19 @@ function cmdLand(runtime, options = {}) {
 // plugins/kxm/src/cli/supervise.ts
 init_project_config();
 import { appendFileSync as appendFileSync2, chmodSync as chmodSync8, mkdirSync as mkdirSync26 } from "node:fs";
-import { join as join40 } from "node:path";
+import { join as join41 } from "node:path";
 
 // plugins/kxm/src/supervise-state.ts
 init_project_config();
-import { chmodSync as chmodSync7, existsSync as existsSync34, mkdirSync as mkdirSync25, readFileSync as readFileSync31, renameSync as renameSync8, writeFileSync as writeFileSync23 } from "node:fs";
-import { join as join39 } from "node:path";
+import { chmodSync as chmodSync7, existsSync as existsSync35, mkdirSync as mkdirSync25, readFileSync as readFileSync32, renameSync as renameSync8, writeFileSync as writeFileSync23 } from "node:fs";
+import { join as join40 } from "node:path";
 var SUPERVISOR_SCHEMA = "kxm.supervisor.v1";
 var TIMESTAMP_RE2 = /^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\.[0-9]{1,9})?Z$/;
 var MERGE_STATE_RE = /^[A-Z][A-Z0-9_]{0,31}$/;
 var CI_TOKEN_RE = /^[a-z][a-z0-9_-]{0,31}$/;
 var MAX_BACKOFF_MS = 24 * 60 * 60 * 1e3;
 function supervisorStatePath(stateDir) {
-  return join39(stateDir, "supervisor.json");
+  return join40(stateDir, "supervisor.json");
 }
 function emptySupervisorState(now) {
   return { schema: SUPERVISOR_SCHEMA, updatedAt: now, lanes: {} };
@@ -41287,10 +41413,10 @@ function isState(value) {
 }
 function loadSupervisorState(stateDir, now) {
   const path4 = supervisorStatePath(stateDir);
-  if (!existsSync34(path4)) return emptySupervisorState(now);
+  if (!existsSync35(path4)) return emptySupervisorState(now);
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync31(path4, "utf8"));
+    parsed = JSON.parse(readFileSync32(path4, "utf8"));
   } catch {
     return "supervisor_unreadable";
   }
@@ -41453,7 +41579,7 @@ function cmdSuperviseStatus(runtime) {
 }
 function appendTick(runtime, line) {
   mkdirSync26(runtime.dirs.logs, { recursive: true });
-  const path4 = join40(runtime.dirs.logs, "supervisor.log");
+  const path4 = join41(runtime.dirs.logs, "supervisor.log");
   appendFileSync2(path4, `${line}
 `, { encoding: "utf8", mode: 384 });
   try {
@@ -41472,8 +41598,8 @@ function cmdSuperviseTick(runtime) {
   const line = formatTickLine(now, tick.resumed, tick.waiting);
   if (runtime.dryRun) {
     printPlan(runtime, { command: "supervise", resumed: tick.resumed, waiting: tick.waiting, log: line, state: tick.state }, [
-      { action: "write", target: join40(runtime.dirs.state, "supervisor.json") },
-      { action: "write", target: join40(runtime.dirs.logs, "supervisor.log") }
+      { action: "write", target: join41(runtime.dirs.state, "supervisor.json") },
+      { action: "write", target: join41(runtime.dirs.logs, "supervisor.log") }
     ], "resume lanes whose backoff has elapsed");
     return 0;
   }
@@ -41520,7 +41646,7 @@ function cmdSuperviseRecord(runtime, options) {
   }
   if (runtime.dryRun) {
     printPlan(runtime, { command: "supervise", state: next }, [
-      { action: "write", target: join40(runtime.dirs.state, "supervisor.json") }
+      { action: "write", target: join41(runtime.dirs.state, "supervisor.json") }
     ], `record lane ${options.lane}`);
     return 0;
   }
@@ -41532,8 +41658,8 @@ function cmdSuperviseRecord(runtime, options) {
 init_project_config();
 init_types();
 import { spawnSync as spawnSync11 } from "node:child_process";
-import { existsSync as existsSync35 } from "node:fs";
-import { join as join41 } from "node:path";
+import { existsSync as existsSync36 } from "node:fs";
+import { join as join42 } from "node:path";
 var kxmAssignCliSeams = {};
 var RUNNER_REL = "scripts/assignment-run.mjs";
 function refuse4(runtime, command, error, text) {
@@ -41605,7 +41731,7 @@ async function cmdAssign(runtime, subcommand, args) {
   const command = `assign ${subcommand}`;
   const root = discoverKxmProjectRoot(runtime.cwd);
   if (!root) return refuse4(runtime, command, "project_required", `${command} requires a KXM project (run kxm init first)`);
-  if (!existsSync35(join41(root, "scripts", "assignment-run.mjs"))) {
+  if (!existsSync36(join42(root, "scripts", "assignment-run.mjs"))) {
     return refuse4(runtime, command, "assign_runner_missing", `${command} requires scripts/assignment-run.mjs in the project root`);
   }
   const argv = ["node", RUNNER_REL, ...runnerArgv(subcommand, args)];
@@ -41641,8 +41767,8 @@ init_config();
 init_hub_identity();
 init_envelope();
 import { randomUUID as randomUUID14 } from "node:crypto";
-import { existsSync as existsSync41, mkdirSync as mkdirSync30, readFileSync as readFileSync37, readdirSync as readdirSync13, rmSync as rmSync11, writeFileSync as writeFileSync26 } from "node:fs";
-import { join as join51, resolve as resolve28 } from "node:path";
+import { existsSync as existsSync42, mkdirSync as mkdirSync30, readFileSync as readFileSync38, readdirSync as readdirSync13, rmSync as rmSync11, writeFileSync as writeFileSync26 } from "node:fs";
+import { join as join52, resolve as resolve28 } from "node:path";
 
 // node_modules/marked/lib/marked.esm.js
 function A() {
@@ -44327,6 +44453,66 @@ var LEGACY_CTRL_SEQUENCES = {
   home: ["\x1B[7^"],
   end: ["\x1B[8^"]
 };
+var LEGACY_SEQUENCE_KEY_IDS = {
+  "\x1BOA": "up",
+  "\x1BOB": "down",
+  "\x1BOC": "right",
+  "\x1BOD": "left",
+  "\x1BOH": "home",
+  "\x1BOF": "end",
+  "\x1B[E": "clear",
+  "\x1BOE": "clear",
+  "\x1BOe": "ctrl+clear",
+  "\x1B[e": "shift+clear",
+  "\x1B[2~": "insert",
+  "\x1B[2$": "shift+insert",
+  "\x1B[2^": "ctrl+insert",
+  "\x1B[3$": "shift+delete",
+  "\x1B[3^": "ctrl+delete",
+  "\x1B[[5~": "pageUp",
+  "\x1B[[6~": "pageDown",
+  "\x1B[a": "shift+up",
+  "\x1B[b": "shift+down",
+  "\x1B[c": "shift+right",
+  "\x1B[d": "shift+left",
+  "\x1BOa": "ctrl+up",
+  "\x1BOb": "ctrl+down",
+  "\x1BOc": "ctrl+right",
+  "\x1BOd": "ctrl+left",
+  "\x1B[5$": "shift+pageUp",
+  "\x1B[6$": "shift+pageDown",
+  "\x1B[7$": "shift+home",
+  "\x1B[8$": "shift+end",
+  "\x1B[5^": "ctrl+pageUp",
+  "\x1B[6^": "ctrl+pageDown",
+  "\x1B[7^": "ctrl+home",
+  "\x1B[8^": "ctrl+end",
+  "\x1BOP": "f1",
+  "\x1BOQ": "f2",
+  "\x1BOR": "f3",
+  "\x1BOS": "f4",
+  "\x1B[11~": "f1",
+  "\x1B[12~": "f2",
+  "\x1B[13~": "f3",
+  "\x1B[14~": "f4",
+  "\x1B[[A": "f1",
+  "\x1B[[B": "f2",
+  "\x1B[[C": "f3",
+  "\x1B[[D": "f4",
+  "\x1B[[E": "f5",
+  "\x1B[15~": "f5",
+  "\x1B[17~": "f6",
+  "\x1B[18~": "f7",
+  "\x1B[19~": "f8",
+  "\x1B[20~": "f9",
+  "\x1B[21~": "f10",
+  "\x1B[23~": "f11",
+  "\x1B[24~": "f12",
+  "\x1Bb": "alt+left",
+  "\x1Bf": "alt+right",
+  "\x1Bp": "alt+up",
+  "\x1Bn": "alt+down"
+};
 var matchesLegacySequence = (data, sequences) => sequences.includes(data);
 var matchesLegacyModifierSequence = (data, key, modifier) => {
   if (modifier === MODIFIERS.shift) {
@@ -44472,6 +44658,22 @@ function matchesPrintableModifyOtherKeys(data, expectedKeycode, expectedModifier
     return false;
   return normalizeShiftedLetterIdentityCodepoint(parsed.codepoint, parsed.modifier) === normalizeShiftedLetterIdentityCodepoint(expectedKeycode, expectedModifier);
 }
+function formatKeyNameWithModifiers(keyName, modifier) {
+  const mods = [];
+  const effectiveMod = modifier & ~LOCK_MASK;
+  const supportedModifierMask = MODIFIERS.shift | MODIFIERS.ctrl | MODIFIERS.alt | MODIFIERS.super;
+  if ((effectiveMod & ~supportedModifierMask) !== 0)
+    return void 0;
+  if (effectiveMod & MODIFIERS.shift)
+    mods.push("shift");
+  if (effectiveMod & MODIFIERS.ctrl)
+    mods.push("ctrl");
+  if (effectiveMod & MODIFIERS.alt)
+    mods.push("alt");
+  if (effectiveMod & MODIFIERS.super)
+    mods.push("super");
+  return mods.length > 0 ? `${mods.join("+")}+${keyName}` : keyName;
+}
 function parseKeyId(keyId) {
   const parts = keyId.toLowerCase().split("+");
   const key = parts[parts.length - 1];
@@ -44728,6 +44930,149 @@ function matchesKey(data, keyId) {
   }
   return false;
 }
+function formatParsedKey(codepoint, modifier, baseLayoutKey) {
+  const normalizedCodepoint = normalizeKittyFunctionalCodepoint(codepoint);
+  const identityCodepoint = normalizeShiftedLetterIdentityCodepoint(normalizedCodepoint, modifier);
+  const isLatinLetter = identityCodepoint >= 97 && identityCodepoint <= 122;
+  const isDigit = identityCodepoint >= 48 && identityCodepoint <= 57;
+  const isKnownSymbol = SYMBOL_KEYS.has(String.fromCharCode(identityCodepoint));
+  const effectiveCodepoint = isLatinLetter || isDigit || isKnownSymbol ? identityCodepoint : baseLayoutKey ?? identityCodepoint;
+  let keyName;
+  if (effectiveCodepoint === CODEPOINTS.escape)
+    keyName = "escape";
+  else if (effectiveCodepoint === CODEPOINTS.tab)
+    keyName = "tab";
+  else if (effectiveCodepoint === CODEPOINTS.enter || effectiveCodepoint === CODEPOINTS.kpEnter)
+    keyName = "enter";
+  else if (effectiveCodepoint === CODEPOINTS.space)
+    keyName = "space";
+  else if (effectiveCodepoint === CODEPOINTS.backspace)
+    keyName = "backspace";
+  else if (effectiveCodepoint === FUNCTIONAL_CODEPOINTS.delete)
+    keyName = "delete";
+  else if (effectiveCodepoint === FUNCTIONAL_CODEPOINTS.insert)
+    keyName = "insert";
+  else if (effectiveCodepoint === FUNCTIONAL_CODEPOINTS.home)
+    keyName = "home";
+  else if (effectiveCodepoint === FUNCTIONAL_CODEPOINTS.end)
+    keyName = "end";
+  else if (effectiveCodepoint === FUNCTIONAL_CODEPOINTS.pageUp)
+    keyName = "pageUp";
+  else if (effectiveCodepoint === FUNCTIONAL_CODEPOINTS.pageDown)
+    keyName = "pageDown";
+  else if (effectiveCodepoint === ARROW_CODEPOINTS.up)
+    keyName = "up";
+  else if (effectiveCodepoint === ARROW_CODEPOINTS.down)
+    keyName = "down";
+  else if (effectiveCodepoint === ARROW_CODEPOINTS.left)
+    keyName = "left";
+  else if (effectiveCodepoint === ARROW_CODEPOINTS.right)
+    keyName = "right";
+  else if (effectiveCodepoint >= 48 && effectiveCodepoint <= 57)
+    keyName = String.fromCharCode(effectiveCodepoint);
+  else if (effectiveCodepoint >= 97 && effectiveCodepoint <= 122)
+    keyName = String.fromCharCode(effectiveCodepoint);
+  else if (SYMBOL_KEYS.has(String.fromCharCode(effectiveCodepoint)))
+    keyName = String.fromCharCode(effectiveCodepoint);
+  if (!keyName)
+    return void 0;
+  return formatKeyNameWithModifiers(keyName, modifier);
+}
+function parseKey(data) {
+  const kitty = parseKittySequence(data);
+  if (kitty) {
+    return formatParsedKey(kitty.codepoint, kitty.modifier, kitty.baseLayoutKey);
+  }
+  const modifyOtherKeys = parseModifyOtherKeysSequence(data);
+  if (modifyOtherKeys) {
+    return formatParsedKey(modifyOtherKeys.codepoint, modifyOtherKeys.modifier);
+  }
+  if (_kittyProtocolActive) {
+    if (data === "\x1B\r" || data === "\n")
+      return "shift+enter";
+  }
+  const legacySequenceKeyId = LEGACY_SEQUENCE_KEY_IDS[data];
+  if (legacySequenceKeyId)
+    return legacySequenceKeyId;
+  if (data === "\x1B")
+    return "escape";
+  if (data === "")
+    return "ctrl+\\";
+  if (data === "")
+    return "ctrl+]";
+  if (data === "")
+    return "ctrl+-";
+  if (data === "\x1B\x1B")
+    return "ctrl+alt+[";
+  if (data === "\x1B")
+    return "ctrl+alt+\\";
+  if (data === "\x1B")
+    return "ctrl+alt+]";
+  if (data === "\x1B")
+    return "ctrl+alt+-";
+  if (data === "	")
+    return "tab";
+  if (data === "\r" || !_kittyProtocolActive && data === "\n" || data === "\x1BOM")
+    return "enter";
+  if (data === "\0")
+    return "ctrl+space";
+  if (data === " ")
+    return "space";
+  if (data === "\x7F")
+    return "backspace";
+  if (data === "\b")
+    return isWindowsTerminalSession() ? "ctrl+backspace" : "backspace";
+  if (data === "\x1B[Z")
+    return "shift+tab";
+  if (!_kittyProtocolActive && data === "\x1B\r")
+    return "alt+enter";
+  if (!_kittyProtocolActive && data === "\x1B ")
+    return "alt+space";
+  if (data === "\x1B\x7F" || data === "\x1B\b")
+    return "alt+backspace";
+  if (!_kittyProtocolActive && data === "\x1BB")
+    return "alt+left";
+  if (!_kittyProtocolActive && data === "\x1BF")
+    return "alt+right";
+  if (!_kittyProtocolActive && data.length === 2 && data[0] === "\x1B") {
+    const code = data.charCodeAt(1);
+    if (code >= 1 && code <= 26) {
+      return `ctrl+alt+${String.fromCharCode(code + 96)}`;
+    }
+    const key = String.fromCharCode(code);
+    if (code >= 97 && code <= 122 || code >= 48 && code <= 57 || SYMBOL_KEYS.has(key)) {
+      return `alt+${key}`;
+    }
+  }
+  if (data === "\x1B[A")
+    return "up";
+  if (data === "\x1B[B")
+    return "down";
+  if (data === "\x1B[C")
+    return "right";
+  if (data === "\x1B[D")
+    return "left";
+  if (data === "\x1B[H" || data === "\x1BOH")
+    return "home";
+  if (data === "\x1B[F" || data === "\x1BOF")
+    return "end";
+  if (data === "\x1B[3~")
+    return "delete";
+  if (data === "\x1B[5~")
+    return "pageUp";
+  if (data === "\x1B[6~")
+    return "pageDown";
+  if (data.length === 1) {
+    const code = data.charCodeAt(0);
+    if (code >= 1 && code <= 26) {
+      return `ctrl+${String.fromCharCode(code + 96)}`;
+    }
+    if (code >= 32 && code <= 126) {
+      return data;
+    }
+  }
+  return void 0;
+}
 var KITTY_CSI_U_REGEX = /^\x1b\[(\d+)(?::(\d*))?(?::(\d+))?(?:;(\d+))?(?::(\d+))?u$/;
 var KITTY_PRINTABLE_ALLOWED_MODIFIERS = MODIFIERS.shift | LOCK_MASK;
 function decodeKittyPrintable(data) {
@@ -47415,7 +47760,7 @@ import * as path2 from "node:path";
 
 // node_modules/@earendil-works/pi-tui/dist/native-module-path.js
 import { createRequire as createRequire2 } from "node:module";
-import { dirname as dirname19, join as join42 } from "node:path";
+import { dirname as dirname19, join as join43 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var moduleRequire = createRequire2(import.meta.url);
 var TUI_PACKAGE_NAME = "@earendil-works/pi-tui";
@@ -47424,10 +47769,10 @@ function getNativeModuleCandidates(nativePath, options = {}) {
   const candidates = [];
   try {
     const packageEntry = (options.resolvePackage ?? moduleRequire.resolve)(TUI_PACKAGE_NAME);
-    candidates.push(join42(dirname19(packageEntry), "..", nativePath));
+    candidates.push(join43(dirname19(packageEntry), "..", nativePath));
   } catch {
   }
-  candidates.push(join42(moduleDir, "..", nativePath), join42(moduleDir, nativePath), join42(dirname19(options.execPath ?? process.execPath), nativePath));
+  candidates.push(join43(moduleDir, "..", nativePath), join43(moduleDir, nativePath), join43(dirname19(options.execPath ?? process.execPath), nativePath));
   return Array.from(new Set(candidates));
 }
 
@@ -50255,10 +50600,17 @@ var MAX_RENDER_WRITE_CHARS = 1024 * 1024;
 
 // plugins/kxm/src/tui.ts
 import { mkdirSync as mkdirSync27 } from "node:fs";
-import { join as join46, resolve as resolve27, dirname as dirname20 } from "node:path";
+import { join as join47, resolve as resolve27, dirname as dirname20 } from "node:path";
 import { spawnSync as spawnSync12 } from "node:child_process";
 
 // packages/core/tui/src/types/surface.ts
+var KXM_TUI_FIELD_KINDS = ["text", "enum", "choice", "info"];
+var KXM_TUI_STATUSES = ["ready", "available", "blocked"];
+var KXM_TUI_STEP_STATES = ["pending", "satisfied", "running", "done", "failed"];
+var KXM_TUI_NOTICE_LEVELS = ["info", "error"];
+var KXM_TUI_SET_ACTION = "set";
+var KXM_TUI_CLEAR_ACTION = "clear";
+var KXM_TUI_ABORT_ACTION = "abort";
 var KXM_TUI_LIMITS = Object.freeze({
   sourceMax: 128,
   idMax: 128,
@@ -50280,8 +50632,231 @@ var KXM_TUI_LIMITS = Object.freeze({
   sectionsMax: 32,
   orderMax: 1e3
 });
+var ID_PATTERN = /^[a-z0-9][a-z0-9._:-]*$/;
+var SOURCE_PATTERN = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/;
+var KEY_PATH_PATTERN = /^[A-Za-z0-9_][A-Za-z0-9_.[\]-]*$/;
+var ACTION_KEY_PATTERN = /^[A-Za-z0-9]$/;
+function issue4(path4, code, message) {
+  return { path: path4, code, message };
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function boundedText(issues, path4, value, max, required2) {
+  if (value === void 0) {
+    if (required2) issues.push(issue4(path4, "required", `${path4} is required`));
+    return;
+  }
+  if (typeof value !== "string" || value.length === 0) {
+    issues.push(issue4(path4, "invalid_string", `${path4} must be a non-empty string`));
+    return;
+  }
+  if (value.length > max) {
+    issues.push(issue4(path4, "too_long", `${path4} exceeds ${max} characters`));
+    return;
+  }
+  if (/[\u0000-\u0008\u000a-\u001f\u007f]/u.test(value)) {
+    issues.push(issue4(path4, "control_character", `${path4} must not contain control characters`));
+  }
+}
+function optionalEnum(issues, path4, value, allowed) {
+  if (value === void 0) return;
+  if (typeof value !== "string" || !allowed.includes(value)) {
+    issues.push(issue4(path4, "invalid_choice", `${path4} must be one of ${allowed.join(", ")}`));
+  }
+}
+function ratioField(issues, path4, value) {
+  if (value === void 0) return;
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0 || value > 1) {
+    issues.push(issue4(path4, "invalid_ratio", `${path4} must be a finite number between 0 and 1`));
+  }
+}
+function validateChoice(issues, path4, raw) {
+  if (!isPlainObject(raw)) {
+    issues.push(issue4(path4, "invalid_object", `${path4} must be an object`));
+    return;
+  }
+  boundedText(issues, `${path4}.id`, raw.id, KXM_TUI_LIMITS.choiceIdMax, true);
+  if (typeof raw.id === "string" && /[\s]/u.test(raw.id)) {
+    issues.push(issue4(`${path4}.id`, "invalid_choice_id", `${path4}.id must not contain whitespace`));
+  }
+  boundedText(issues, `${path4}.label`, raw.label, KXM_TUI_LIMITS.choiceLabelMax, true);
+  boundedText(issues, `${path4}.detail`, raw.detail, KXM_TUI_LIMITS.shortDetailMax, false);
+  boundedText(issues, `${path4}.group`, raw.group, KXM_TUI_LIMITS.shortDetailMax, false);
+  boundedText(issues, `${path4}.statusText`, raw.statusText, KXM_TUI_LIMITS.shortDetailMax, false);
+  boundedText(issues, `${path4}.action`, raw.action, KXM_TUI_LIMITS.idMax, false);
+  optionalEnum(issues, `${path4}.status`, raw.status, KXM_TUI_STATUSES);
+}
+function validateAction(issues, path4, raw) {
+  if (!isPlainObject(raw)) {
+    issues.push(issue4(path4, "invalid_object", `${path4} must be an object`));
+    return;
+  }
+  if (typeof raw.key !== "string" || !ACTION_KEY_PATTERN.test(raw.key)) {
+    issues.push(issue4(`${path4}.key`, "invalid_action_key", `${path4}.key must be a single alphanumeric key`));
+  }
+  boundedText(issues, `${path4}.label`, raw.label, KXM_TUI_LIMITS.shortDetailMax, true);
+  boundedText(issues, `${path4}.action`, raw.action, KXM_TUI_LIMITS.idMax, true);
+}
+function validateStep(issues, path4, raw) {
+  if (!isPlainObject(raw)) {
+    issues.push(issue4(path4, "invalid_object", `${path4} must be an object`));
+    return;
+  }
+  boundedText(issues, `${path4}.label`, raw.label, KXM_TUI_LIMITS.shortDetailMax, true);
+  boundedText(issues, `${path4}.detail`, raw.detail, KXM_TUI_LIMITS.stepDetailMax, false);
+  optionalEnum(issues, `${path4}.state`, raw.state, KXM_TUI_STEP_STATES);
+  if (raw.state === void 0) issues.push(issue4(`${path4}.state`, "required", `${path4}.state is required`));
+}
+function validateField(issues, path4, raw) {
+  if (!isPlainObject(raw)) {
+    issues.push(issue4(path4, "invalid_object", `${path4} must be an object`));
+    return;
+  }
+  boundedText(issues, `${path4}.id`, raw.id, KXM_TUI_LIMITS.idMax, true);
+  if (typeof raw.id === "string" && !ID_PATTERN.test(raw.id)) {
+    issues.push(issue4(`${path4}.id`, "invalid_id", `${path4}.id must match ${ID_PATTERN}`));
+  }
+  boundedText(issues, `${path4}.label`, raw.label, KXM_TUI_LIMITS.labelMax, true);
+  if (raw.kind === void 0) {
+    issues.push(issue4(`${path4}.kind`, "required", `${path4}.kind is required`));
+  } else {
+    optionalEnum(issues, `${path4}.kind`, raw.kind, KXM_TUI_FIELD_KINDS);
+  }
+  boundedText(issues, `${path4}.value`, raw.value, KXM_TUI_LIMITS.valueMax, false);
+  boundedText(issues, `${path4}.placeholder`, raw.placeholder, KXM_TUI_LIMITS.shortDetailMax, false);
+  boundedText(issues, `${path4}.detail`, raw.detail, KXM_TUI_LIMITS.detailMax, false);
+  boundedText(issues, `${path4}.statusText`, raw.statusText, KXM_TUI_LIMITS.statusTextMax, false);
+  if (raw.updatedAt !== void 0) {
+    boundedText(issues, `${path4}.updatedAt`, raw.updatedAt, 64, false);
+    if (typeof raw.updatedAt === "string" && !Number.isFinite(Date.parse(raw.updatedAt))) {
+      issues.push(issue4(`${path4}.updatedAt`, "invalid_timestamp", `${path4}.updatedAt must be an ISO timestamp`));
+    }
+  }
+  optionalEnum(issues, `${path4}.status`, raw.status, KXM_TUI_STATUSES);
+  if (raw.keyPath !== void 0) {
+    boundedText(issues, `${path4}.keyPath`, raw.keyPath, KXM_TUI_LIMITS.keyPathMax, false);
+    if (typeof raw.keyPath === "string" && !KEY_PATH_PATTERN.test(raw.keyPath)) {
+      issues.push(issue4(`${path4}.keyPath`, "invalid_key_path", `${path4}.keyPath must be a dotted config key`));
+    }
+  }
+  for (const listKey of ["busy", "awaitingInput"]) {
+    if (raw[listKey] !== void 0 && typeof raw[listKey] !== "boolean") {
+      issues.push(issue4(`${path4}.${listKey}`, "invalid_boolean", `${path4}.${listKey} must be a boolean`));
+    }
+  }
+  if (raw.progress !== void 0) {
+    if (!isPlainObject(raw.progress)) {
+      issues.push(issue4(`${path4}.progress`, "invalid_object", `${path4}.progress must be an object`));
+    } else {
+      boundedText(issues, `${path4}.progress.label`, raw.progress.label, KXM_TUI_LIMITS.shortDetailMax, true);
+      ratioField(issues, `${path4}.progress.ratio`, raw.progress.ratio);
+    }
+  }
+  for (const [listKey, max, check] of [
+    ["choices", KXM_TUI_LIMITS.choicesMax, validateChoice],
+    ["actions", KXM_TUI_LIMITS.actionsMax, validateAction],
+    ["steps", KXM_TUI_LIMITS.stepsMax, validateStep]
+  ]) {
+    const list = raw[listKey];
+    if (list === void 0) continue;
+    if (!Array.isArray(list) || list.length > max) {
+      issues.push(issue4(`${path4}.${listKey}`, "invalid_list", `${path4}.${listKey} must be an array of at most ${max}`));
+      continue;
+    }
+    list.forEach((entry, index) => check(issues, `${path4}.${listKey}[${index}]`, entry));
+  }
+  const output = raw.output;
+  if (output !== void 0) {
+    if (!Array.isArray(output) || output.length > KXM_TUI_LIMITS.outputMaxLines) {
+      issues.push(issue4(`${path4}.output`, "invalid_list", `${path4}.output must be an array of at most ${KXM_TUI_LIMITS.outputMaxLines} lines`));
+    } else {
+      output.forEach((line, index) => {
+        if (typeof line !== "string") issues.push(issue4(`${path4}.output[${index}]`, "invalid_string", "output lines must be strings"));
+        else if (line.length > KXM_TUI_LIMITS.outputLineMax) issues.push(issue4(`${path4}.output[${index}]`, "too_long", "output line is too long"));
+      });
+    }
+  }
+}
+function validateSection(issues, path4, raw) {
+  if (!isPlainObject(raw)) {
+    issues.push(issue4(path4, "invalid_object", `${path4} must be an object`));
+    return;
+  }
+  boundedText(issues, `${path4}.id`, raw.id, KXM_TUI_LIMITS.idMax, true);
+  if (typeof raw.id === "string" && !ID_PATTERN.test(raw.id)) {
+    issues.push(issue4(`${path4}.id`, "invalid_id", `${path4}.id must match ${ID_PATTERN}`));
+  }
+  boundedText(issues, `${path4}.title`, raw.title, KXM_TUI_LIMITS.labelMax, true);
+  boundedText(issues, `${path4}.detail`, raw.detail, KXM_TUI_LIMITS.shortDetailMax, false);
+  boundedText(issues, `${path4}.notice`, raw.notice, KXM_TUI_LIMITS.detailMax, false);
+  optionalEnum(issues, `${path4}.noticeLevel`, raw.noticeLevel, KXM_TUI_NOTICE_LEVELS);
+  if (typeof raw.order !== "number" || !Number.isInteger(raw.order) || raw.order < 0 || raw.order > KXM_TUI_LIMITS.orderMax) {
+    issues.push(issue4(`${path4}.order`, "invalid_order", `${path4}.order must be an integer between 0 and ${KXM_TUI_LIMITS.orderMax}`));
+  }
+  if (!Array.isArray(raw.fields) || raw.fields.length > KXM_TUI_LIMITS.fieldsMax) {
+    issues.push(issue4(`${path4}.fields`, "invalid_list", `${path4}.fields must be an array of at most ${KXM_TUI_LIMITS.fieldsMax}`));
+    return;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  raw.fields.forEach((field, index) => {
+    const fieldPath = `${path4}.fields[${index}]`;
+    validateField(issues, fieldPath, field);
+    if (isPlainObject(field) && typeof field.id === "string") {
+      if (seen.has(field.id)) issues.push(issue4(`${fieldPath}.id`, "duplicate_id", `${field.id} is published twice in ${path4}`));
+      seen.add(field.id);
+    }
+  });
+}
+function validateKxmTuiSurface(sections) {
+  if (!Array.isArray(sections)) return [issue4("sections", "invalid_list", "sections must be an array")];
+  if (sections.length > KXM_TUI_LIMITS.sectionsMax) {
+    return [issue4("sections", "too_many", `sections must number at most ${KXM_TUI_LIMITS.sectionsMax}`)];
+  }
+  const issues = [];
+  const seenSources = /* @__PURE__ */ new Map();
+  sections.forEach((section, index) => {
+    const path4 = `sections[${index}]`;
+    validateSection(issues, path4, section);
+    if (!isPlainObject(section)) return;
+    boundedText(issues, `${path4}.source`, section.source, KXM_TUI_LIMITS.sourceMax, true);
+    if (typeof section.source === "string" && !SOURCE_PATTERN.test(section.source)) {
+      issues.push(issue4(`${path4}.source`, "invalid_source", `${path4}.source must be an addressable owner id`));
+    }
+    if (typeof section.source === "string" && typeof section.id === "string") {
+      const ids = seenSources.get(section.source) ?? /* @__PURE__ */ new Set();
+      seenSources.set(section.source, ids);
+      if (ids.has(section.id)) issues.push(issue4(`${path4}.id`, "duplicate_section", `${section.source}/${section.id} is published twice`));
+      ids.add(section.id);
+    }
+  });
+  return issues;
+}
+function isSelectableField(field) {
+  return field !== void 0 && field.kind !== "info";
+}
+function groupedKxmTuiChoices(field) {
+  const choices = field.choices ?? [];
+  if (choices.length === 0) return [];
+  if (choices.every((choice) => choice.group === void 0)) return [{ group: "", choices }];
+  const groups = [];
+  const index = /* @__PURE__ */ new Map();
+  for (const choice of choices) {
+    const group = choice.group ?? "";
+    let bucket = index.get(group);
+    if (!bucket) {
+      bucket = [];
+      index.set(group, bucket);
+      groups.push({ group, choices: bucket });
+    }
+    bucket.push(choice);
+  }
+  return groups;
+}
 
 // packages/core/tui/src/tui/keys.ts
+var KXM_TUI_INPUT_MAX_LENGTH = 4096;
+var CONTROL_BYTES = /[\u0000-\u0008\u000a-\u001f\u007f\u0080-\u009f]/u;
 var NAMED_KEYS = Object.freeze({
   up: "up",
   down: "down",
@@ -50299,8 +50874,109 @@ var NAMED_KEYS = Object.freeze({
   backspace: "backspace",
   delete: "delete"
 });
+var CONTROL_BYTES_GLOBAL = /[\u0000-\u0008\u000a-\u001f\u007f\u0080-\u009f]/gu;
+function normalizeInputText(value) {
+  return value.replace(CONTROL_BYTES_GLOBAL, " ").replace(/ {2,}/gu, " ").trim().slice(0, KXM_TUI_INPUT_MAX_LENGTH);
+}
+function decodeKxmTuiInput(data) {
+  if (typeof data !== "string" || data.length === 0) return { kind: "ignored" };
+  const named = parseKey(data);
+  if (named === "ctrl+c") return { kind: "ctrlC" };
+  if (named) {
+    const kind = NAMED_KEYS[named.toLowerCase()];
+    if (kind) return { kind };
+    if (named === "space") return { kind: "text", text: " " };
+    if (Array.from(named).length === 1 && !CONTROL_BYTES.test(named)) {
+      return { kind: "text", text: named };
+    }
+    return { kind: "ignored" };
+  }
+  const kitty = decodeKittyPrintable(data);
+  if (kitty) {
+    const text = normalizeInputText(kitty);
+    return text ? { kind: "text", text } : { kind: "ignored" };
+  }
+  if (data.startsWith("\x1B")) return { kind: "ignored" };
+  const pasted = normalizeInputText(data);
+  return pasted ? { kind: "text", text: pasted } : { kind: "ignored" };
+}
+function deleteBackward(text) {
+  const units = Array.from(text);
+  units.pop();
+  return units.join("");
+}
+function insertAt(text, caret, insert, maxLength = KXM_TUI_INPUT_MAX_LENGTH) {
+  const units = Array.from(text);
+  const at2 = Math.max(0, Math.min(caret, units.length));
+  const added = Array.from(insert);
+  const merged = [...units.slice(0, at2), ...added, ...units.slice(at2)].join("");
+  const next = merged.length > maxLength ? merged.slice(0, maxLength) : merged;
+  return { text: next, caret: Math.min(next.length, at2 + added.length) };
+}
 
 // packages/core/tui/src/tui/layout.ts
+var KXM_TUI_ELLIPSIS = "\u2026";
+function fitText(text, width) {
+  if (width <= 0) return "";
+  if (visibleWidth(text) <= width) return text;
+  if (!text.includes("\x1B")) {
+    let out = "";
+    for (const unit of Array.from(text)) {
+      if (visibleWidth(out) + visibleWidth(unit) > width - KXM_TUI_ELLIPSIS.length) break;
+      out += unit;
+    }
+    return out + KXM_TUI_ELLIPSIS;
+  }
+  return truncateToWidth(text, width, KXM_TUI_ELLIPSIS);
+}
+function alignRight(left, right, width) {
+  if (width <= 0) return "";
+  const detail = fitText(right, Math.max(0, width - 2));
+  const detailWidth = visibleWidth(detail);
+  const leftWidth = Math.max(1, width - detailWidth - 1);
+  const fitted = fitText(left, leftWidth);
+  const filler = Math.max(1, width - visibleWidth(fitted) - detailWidth);
+  return `${fitted}${" ".repeat(filler)}${detail}`;
+}
+function padRight(text, width) {
+  const missing = width - visibleWidth(text);
+  return missing > 0 ? text + " ".repeat(missing) : text;
+}
+function wrapPlain(text, width) {
+  if (width <= 0) return [];
+  const lines = [];
+  let current = "";
+  for (const word of text.split(/\s+/u).filter(Boolean)) {
+    if (!current.length) current = word;
+    else if (visibleWidth(current) + 1 + visibleWidth(word) <= width) current = `${current} ${word}`;
+    else {
+      lines.push(current);
+      current = word;
+    }
+  }
+  if (current.length) lines.push(current);
+  return lines.length ? lines : [];
+}
+function formatAge(iso, nowMs) {
+  if (!iso) return "\u2014";
+  const at2 = Date.parse(iso);
+  if (!Number.isFinite(at2)) return "\u2014";
+  const seconds = Math.floor((nowMs - at2) / 1e3);
+  if (seconds < 0) return "\u2014";
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes}m${String(seconds % 60).padStart(2, "0")}s`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h${String(minutes % 60).padStart(2, "0")}m`;
+  const days = Math.floor(hours / 24);
+  return `${days}d${String(hours % 24).padStart(2, "0")}h`;
+}
+function progressBar(ratio, width = 10) {
+  const cells = Math.max(1, width);
+  if (ratio === void 0 || !Number.isFinite(ratio)) return "\u2591".repeat(cells);
+  const filled = Math.round(Math.max(0, Math.min(1, ratio)) * cells);
+  return "\u2588".repeat(filled) + "\u2591".repeat(Math.max(0, cells - filled));
+}
 var KXM_TUI_MARKS = Object.freeze({
   pending: "\u25CB",
   active: "\u25B6",
@@ -50365,9 +51041,368 @@ function createKxmTuiAnsiTheme(color) {
     panelBg: (text) => `\x1B[48;5;236m${text}\x1B[0m`
   };
 }
+function createDefaultKxmTuiTheme(env = process.env) {
+  return createKxmTuiAnsiTheme(!(env.NO_COLOR || env.KXM_TUI_NO_COLOR));
+}
+
+// packages/core/tui/src/tui/panel.ts
+var PANE_KEYS = /* @__PURE__ */ new Set(["j", "k", "h", "l"]);
+function initialKxmTuiPanelState(sections) {
+  return {
+    pane: "sections",
+    mode: "browse",
+    sectionIndex: 0,
+    fieldIndex: firstSelectableFieldIndex(sections[0]?.fields ?? []),
+    choiceIndex: 0,
+    draft: "",
+    caret: 0,
+    filter: "",
+    filtering: false,
+    help: false,
+    pending: []
+  };
+}
+function pendingKey(invocation) {
+  return `${invocation.source}\0${invocation.sectionId}\0${invocation.fieldId}`;
+}
+function firstSelectableFieldIndex(fields) {
+  const index = fields.findIndex(isSelectableField);
+  return index < 0 ? 0 : index;
+}
+function visibleChoices(field, filter) {
+  const choices = field?.choices ?? [];
+  const needle = filter.trim().toLowerCase();
+  if (!needle) return [...choices];
+  return choices.filter(
+    (choice) => `${choice.group ?? ""} ${choice.label} ${choice.id} ${choice.detail ?? ""}`.toLowerCase().includes(needle)
+  );
+}
+function currentSection(sections, state) {
+  return sections[state.sectionIndex];
+}
+function currentField(sections, state) {
+  return currentSection(sections, state)?.fields[state.fieldIndex];
+}
+function reconcileKxmTuiPanelState(state, sections) {
+  const sectionIndex = Math.min(state.sectionIndex, Math.max(0, sections.length - 1));
+  const fields = sections[sectionIndex]?.fields ?? [];
+  let fieldIndex = Math.min(state.fieldIndex, Math.max(0, fields.length - 1));
+  if (!isSelectableField(fields[fieldIndex])) fieldIndex = firstSelectableFieldIndex(fields);
+  const field = fields[fieldIndex];
+  const keepsEdit = state.mode === "edit" && (field?.statusText !== void 0 || field?.awaitingInput === true);
+  return {
+    ...state,
+    sectionIndex,
+    fieldIndex,
+    mode: keepsEdit ? "edit" : "browse",
+    choiceIndex: 0,
+    pending: []
+  };
+}
+function reduceKxmTuiInput(state, sections, input) {
+  return reduceDecoded(state, sections, decodeKxmTuiInput(input));
+}
+function invokeEffect(state, section, field, action, value) {
+  const invocation = {
+    source: section.source,
+    sectionId: section.id,
+    fieldId: field.id,
+    action,
+    ...value === void 0 ? {} : { value }
+  };
+  const key = pendingKey(invocation);
+  return {
+    state: { ...state, pending: state.pending.includes(key) ? state.pending : [...state.pending, key] },
+    effects: [{ type: "invoke", invocation }]
+  };
+}
+function moveSection(state, sections, delta) {
+  if (sections.length === 0) return state;
+  const next = Math.max(0, Math.min(state.sectionIndex + delta, sections.length - 1));
+  if (next === state.sectionIndex) return state;
+  return {
+    ...state,
+    sectionIndex: next,
+    fieldIndex: firstSelectableFieldIndex(sections[next]?.fields ?? []),
+    mode: "browse",
+    choiceIndex: 0,
+    draft: "",
+    caret: 0,
+    filter: "",
+    filtering: false
+  };
+}
+function moveField(state, fields, delta) {
+  const step = delta < 0 ? -1 : 1;
+  let next = state.fieldIndex + step;
+  while (next >= 0 && next < fields.length && !isSelectableField(fields[next])) next += step;
+  if (next < 0 || next >= fields.length) return state;
+  return {
+    ...state,
+    fieldIndex: next,
+    mode: "browse",
+    choiceIndex: 0,
+    draft: "",
+    caret: 0,
+    filter: "",
+    filtering: false
+  };
+}
+function moveChoice(state, count, delta) {
+  if (count === 0) return state;
+  return { ...state, choiceIndex: Math.max(0, Math.min(state.choiceIndex + delta, count - 1)) };
+}
+function choiceAt(field, state) {
+  const choices = visibleChoices(field, state.filter);
+  return choices[Math.max(0, Math.min(state.choiceIndex, choices.length - 1))];
+}
+function enterField(state, section, field) {
+  if (!field) return { state, effects: [] };
+  if (field.kind === "choice") {
+    if ((field.choices?.length ?? 0) === 0) {
+      return { state, effects: [{ type: "notice", message: `${field.label} has nothing to offer yet` }] };
+    }
+    return { state: { ...state, mode: "choices", choiceIndex: 0 }, effects: [] };
+  }
+  if (field.kind === "enum") {
+    const choices = field.choices ?? [];
+    if (choices.length === 0) {
+      return { state, effects: [{ type: "notice", message: `${field.label} has no values published` }] };
+    }
+    const current = choices.findIndex((choice) => choice.id === field.value);
+    const next = choices[(current + 1) % choices.length];
+    if (next.status === "blocked") {
+      return { state, effects: [{ type: "notice", message: next.statusText ?? `${next.label} is unavailable` }] };
+    }
+    return invokeEffect(state, section, field, next.action ?? KXM_TUI_SET_ACTION, next.id);
+  }
+  if (field.kind !== "text") return { state, effects: [] };
+  return { state: { ...state, mode: "edit", draft: field.value ?? "", caret: (field.value ?? "").length }, effects: [] };
+}
+function reduceDecoded(state, sections, decoded) {
+  const section = sections[state.sectionIndex];
+  const field = currentField(sections, state);
+  if (decoded.kind === "ctrlC") {
+    if (field?.busy && section) {
+      return invokeEffect(state, section, field, KXM_TUI_ABORT_ACTION);
+    }
+    return { state, effects: [{ type: "quit" }] };
+  }
+  if (!section) return { state, effects: [{ type: "quit" }] };
+  if (state.mode === "edit") return reduceEdit(state, section, field, decoded);
+  if (state.mode === "choices") return reduceChoices(state, section, field, decoded);
+  return reduceBrowse(state, sections, section, field, decoded);
+}
+function caretSource(text, caret) {
+  return Array.from(text).slice(0, caret).join("").length;
+}
+function reduceEdit(state, section, field, decoded) {
+  if (!field) return { state: { ...state, mode: "browse" }, effects: [] };
+  switch (decoded.kind) {
+    case "escape":
+      return { state: { ...state, mode: "browse", draft: "", caret: 0 }, effects: [] };
+    case "enter": {
+      const value = normalizeInputText(state.draft).trim();
+      if (!value) return { state: { ...state, mode: "browse", draft: "", caret: 0 }, effects: [] };
+      const step = invokeEffect(state, section, field, KXM_TUI_SET_ACTION, value);
+      return { state: { ...step.state, mode: "browse", draft: "", caret: 0 }, effects: step.effects };
+    }
+    case "backspace": {
+      if (state.caret === 0) return { state, effects: [] };
+      const cut = caretSource(state.draft, state.caret);
+      const before = deleteBackward(state.draft.slice(0, cut));
+      const draft = `${before}${state.draft.slice(cut)}`;
+      return { state: { ...state, draft, caret: Array.from(before).length }, effects: [] };
+    }
+    case "delete": {
+      const units = Array.from(state.draft);
+      const text = [...units.slice(0, state.caret), ...units.slice(state.caret + 1)].join("");
+      return { state: { ...state, draft: text }, effects: [] };
+    }
+    case "left":
+      return { state: { ...state, caret: Math.max(0, state.caret - 1) }, effects: [] };
+    case "right":
+      return { state: { ...state, caret: Math.min(Array.from(state.draft).length, state.caret + 1) }, effects: [] };
+    case "home":
+      return { state: { ...state, caret: 0 }, effects: [] };
+    case "end":
+      return { state: { ...state, caret: Array.from(state.draft).length }, effects: [] };
+    case "text": {
+      const text = decoded.text ?? "";
+      if (!text) return { state, effects: [] };
+      const inserted = insertAt(state.draft, state.caret, text);
+      return { state: { ...state, draft: inserted.text, caret: inserted.caret }, effects: [] };
+    }
+    default:
+      return { state, effects: [] };
+  }
+}
+function reduceChoices(state, section, field, decoded) {
+  if (!field) return { state: { ...state, mode: "browse" }, effects: [] };
+  const choices = visibleChoices(field, state.filter);
+  switch (decoded.kind) {
+    case "escape":
+      return { state: { ...state, mode: "browse", filter: "", filtering: false, choiceIndex: 0 }, effects: [] };
+    case "up":
+      return { state: moveChoice(state, choices.length, -1), effects: [] };
+    case "down":
+      return { state: moveChoice(state, choices.length, 1), effects: [] };
+    case "pageUp":
+      return { state: moveChoice(state, choices.length, -8), effects: [] };
+    case "pageDown":
+      return { state: moveChoice(state, choices.length, 8), effects: [] };
+    case "enter": {
+      const choice = choiceAt(field, state);
+      if (!choice) return { state, effects: [] };
+      if (choice.status === "blocked") {
+        return { state, effects: [{ type: "notice", message: choice.statusText ?? `${choice.label} is unavailable` }] };
+      }
+      const clearing = (choice.action ?? KXM_TUI_SET_ACTION) === KXM_TUI_CLEAR_ACTION;
+      const step = invokeEffect(
+        state,
+        section,
+        field,
+        choice.action ?? KXM_TUI_SET_ACTION,
+        clearing ? void 0 : choice.id
+      );
+      return { state: { ...step.state, mode: "browse", filter: "", filtering: false }, effects: step.effects };
+    }
+    case "backspace": {
+      if (state.filter.length === 0) return { state: { ...state, filtering: false }, effects: [] };
+      return { state: { ...state, filter: deleteBackward(state.filter), choiceIndex: 0 }, effects: [] };
+    }
+    case "text": {
+      const text = normalizeInputText(decoded.text ?? "");
+      if (!text) return { state, effects: [] };
+      return { state: { ...state, filtering: true, filter: `${state.filter}${text}`, choiceIndex: 0 }, effects: [] };
+    }
+    default:
+      return { state, effects: [] };
+  }
+}
+function reduceBrowse(state, sections, section, field, decoded) {
+  if (state.help && (decoded.kind === "escape" || decoded.kind === "enter")) {
+    return { state: { ...state, help: false }, effects: [] };
+  }
+  if (state.help) return { state, effects: [] };
+  if (decoded.kind === "text") {
+    const key = decoded.text ?? "";
+    if (key === "q") return { state, effects: [{ type: "quit" }] };
+    if (key === "h" || key === "?") return { state: { ...state, help: true }, effects: [] };
+    const action = field?.actions?.find((candidate) => candidate.key === key);
+    if (action && field) return invokeEffect(state, section, field, action.action);
+    if ((key === "x" || key === "d") && field && field.value !== void 0 && field.kind !== "info") {
+      return invokeEffect(state, section, field, KXM_TUI_CLEAR_ACTION);
+    }
+    if (PANE_KEYS.has(key)) {
+      if (key === "h") return { state: { ...state, pane: "sections" }, effects: [] };
+      if (key === "l") return { state: { ...state, pane: "fields" }, effects: [] };
+      const delta = key === "k" ? -1 : 1;
+      return {
+        state: state.pane === "fields" ? moveField(state, section.fields, delta) : moveSection(state, sections, delta),
+        effects: []
+      };
+    }
+    return { state, effects: [] };
+  }
+  switch (decoded.kind) {
+    case "escape":
+      return state.pane === "fields" ? { state: { ...state, pane: "sections", mode: "browse" }, effects: [] } : { state, effects: [{ type: "quit" }] };
+    case "tab":
+      return { state: { ...state, pane: state.pane === "fields" ? "sections" : "fields" }, effects: [] };
+    case "right":
+      return { state: { ...state, pane: "fields" }, effects: [] };
+    case "left":
+      return { state: { ...state, pane: "sections" }, effects: [] };
+    case "up":
+      return { state: state.pane === "fields" ? moveField(state, section.fields, -1) : moveSection(state, sections, -1), effects: [] };
+    case "down":
+      return { state: state.pane === "fields" ? moveField(state, section.fields, 1) : moveSection(state, sections, 1), effects: [] };
+    case "pageUp":
+      return { state: moveSection(state, sections, -1), effects: [] };
+    case "pageDown":
+      return { state: moveSection(state, sections, 1), effects: [] };
+    case "enter":
+      return state.pane === "fields" ? enterField(state, section, field) : { state: { ...state, pane: "fields" }, effects: [] };
+    default:
+      return { state, effects: [] };
+  }
+}
 
 // packages/core/tui/src/tui/render.ts
 var SECTION_PANE_RATIO = 1 / 3;
+var MIN_PANE_WIDTH = 16;
+var PROGRESS_WIDTH = 20;
+var OUTPUT_TAIL = 6;
+var SPLIT_MIN_WIDTH = 76;
+function statusMark(status, theme, fallback) {
+  switch (status) {
+    case "ready":
+      return theme.fg("success", KXM_TUI_MARKS.ready);
+    case "available":
+      return theme.fg("accent", KXM_TUI_MARKS.available);
+    case "blocked":
+      return theme.fg("error", KXM_TUI_MARKS.blocked);
+    default:
+      return theme.dim(fallback);
+  }
+}
+function cursorMark(active, theme) {
+  return active ? theme.cursor(KXM_TUI_MARKS.cursor) : KXM_TUI_MARKS.blankCursor;
+}
+function paneSplit(width) {
+  const third = Math.max(MIN_PANE_WIDTH, Math.floor(width * SECTION_PANE_RATIO));
+  const sections = Math.min(third, Math.max(MIN_PANE_WIDTH, Math.floor(width / 2)));
+  return { sections, fields: Math.max(MIN_PANE_WIDTH, width - sections - 1) };
+}
+function fieldIsPending(state, section, field) {
+  return state.pending.includes(pendingKey({ source: section.source, sectionId: section.id, fieldId: field.id }));
+}
+function sectionRow(section, focused, pane, theme, width) {
+  const cursor2 = cursorMark(focused && pane === "sections", theme);
+  const flag2 = section.notice ? theme.fg(section.noticeLevel === "error" ? "error" : "warning", "!") : " ";
+  const count = section.fields.length;
+  const unset = section.fields.filter((field) => field.kind !== "info" && field.value === void 0).length;
+  const right = unset > 0 ? `${unset} unset / ${count}` : `${count} field${count === 1 ? "" : "s"}`;
+  return fitText(alignRight(`${cursor2} ${flag2} ${section.title}`, right, width), width);
+}
+function choiceSuffix(choice) {
+  const parts = [];
+  if (choice.detail) parts.push(choice.detail);
+  if (choice.statusText) parts.push(choice.statusText);
+  return parts.join(" \xB7 ");
+}
+function choiceRows(field, state, theme, width) {
+  const shown = visibleChoices(field, state.filter);
+  const lines = [];
+  if (state.filtering) {
+    lines.push(fitText(`   ${theme.dim(`filter: ${state.filter || "(type to filter \xB7 esc clears)"}`)}`, width));
+  }
+  if (shown.length === 0) {
+    lines.push(fitText(`   ${theme.dim("no match")}`, width));
+    return lines;
+  }
+  let position = -1;
+  for (const group of groupedKxmTuiChoices(field)) {
+    const filtered = shown.filter((choice) => (choice.group ?? "") === group.group);
+    if (filtered.length === 0) continue;
+    if (group.group) lines.push(fitText(`   ${theme.key(group.group.toUpperCase())}`, width));
+    for (const choice of filtered) {
+      position += 1;
+      lines.push(
+        fitText(
+          alignRight(
+            `${cursorMark(position === state.choiceIndex, theme)} ${statusMark(choice.status, theme, KXM_TUI_MARKS.pending)} ${choice.label}`,
+            choiceSuffix(choice),
+            width
+          ),
+          width
+        )
+      );
+    }
+  }
+  return lines;
+}
 var STEP_MARKS = {
   pending: "\xB7",
   satisfied: KXM_TUI_MARKS.passed,
@@ -50375,12 +51410,494 @@ var STEP_MARKS = {
   done: KXM_TUI_MARKS.passed,
   failed: KXM_TUI_MARKS.failed
 };
+function stepColor(state, theme) {
+  switch (state) {
+    case "running":
+      return (text) => theme.fg("accent", text);
+    case "done":
+      return (text) => theme.fg("success", text);
+    case "failed":
+      return (text) => theme.fg("error", text);
+    default:
+      return theme.dim;
+  }
+}
+function stepRows(steps, theme, width) {
+  return steps.map((step) => {
+    const paint = stepColor(step.state, theme);
+    return fitText(alignRight(`   ${paint(STEP_MARKS[step.state])} ${step.label}`, step.detail ?? "", width), width);
+  });
+}
+function progressRow(field, theme, width) {
+  const progress = field.progress;
+  if (!progress) return "";
+  const ratio = progress.ratio;
+  const right = ratio === void 0 ? "working" : `${Math.round(ratio * 100)}%`;
+  return fitText(alignRight(`   ${progress.label}`, `${progressBar(ratio, PROGRESS_WIDTH)} ${right}`, width), width);
+}
+function focusedFieldDetail(field, state, theme, width) {
+  const lines = [];
+  if (field.keyPath) lines.push(fitText(`   ${theme.dim(`key: ${field.keyPath}`)}`, width));
+  for (const line of wrapPlain(field.detail ?? "", width - 3)) {
+    if (line) lines.push(fitText(`   ${theme.dim(line)}`, width));
+  }
+  for (const line of wrapPlain(field.statusText ?? "", width - 3)) {
+    if (line) lines.push(fitText(`   ${theme.fg("error", line)}`, width));
+  }
+  const progress = progressRow(field, theme, width);
+  if (progress) lines.push(progress);
+  if (field.steps?.length) lines.push(...stepRows(field.steps, theme, width));
+  if (field.output?.length) {
+    lines.push(...field.output.slice(-OUTPUT_TAIL).map((line) => fitText(`   ${theme.dim(line)}`, width)));
+  }
+  if (field.actions?.length) {
+    lines.push(fitText(`   ${theme.key(field.actions.map((action) => `${action.key} ${action.label}`).join(" \xB7 "))}`, width));
+  }
+  if (state.mode === "choices") lines.push(...choiceRows(field, state, theme, width));
+  if (state.mode === "edit" || field.awaitingInput) {
+    const draft = state.mode === "edit" ? `${state.draft.slice(0, state.caret)}|${state.draft.slice(state.caret)}` : "|";
+    lines.push(fitText(`   ${theme.dim("\u203A")} ${draft}`, width));
+  }
+  return lines;
+}
+function fieldRows(section, state, theme, width, nowMs) {
+  const lines = [];
+  section.fields.forEach((field, index) => {
+    const focused = state.pane === "fields" && state.fieldIndex === index;
+    if (field.kind === "info") {
+      lines.push(fitText(`   ${theme.dim(field.label)}  ${theme.dim(field.value ?? field.placeholder ?? "")}`, width));
+      return;
+    }
+    const pending = fieldIsPending(state, section, field);
+    const mark = statusMark(field.status, theme, pending ? "\u25CC" : KXM_TUI_MARKS.pending);
+    const value = pending && field.value === void 0 ? theme.dim("saving\u2026") : field.value;
+    const shown = value ?? theme.dim(field.placeholder ?? "not set");
+    const age2 = field.updatedAt ? theme.dim(` (${formatAge(field.updatedAt, nowMs)})`) : "";
+    lines.push(fitText(`${cursorMark(focused, theme)} ${mark} ${alignRight(field.label, `${shown}${age2}`, width - 4)}`, width));
+    if (focused) lines.push(...focusedFieldDetail(field, state, theme, width));
+  });
+  return lines;
+}
+function noticeRows(section, theme, width) {
+  if (!section?.notice) return [];
+  const token = section.noticeLevel === "error" ? "error" : "warning";
+  return wrapPlain(section.notice, width - 2).map((line) => fitText(theme.fg(token, line), width));
+}
+function singlePaneLines(sections, state, theme, width, nowMs) {
+  const section = sections[state.sectionIndex];
+  if (state.pane === "fields" && section) {
+    return [
+      fitText(theme.headerBg(alignRight(` ${section.title}`, section.source, width)), width),
+      ...noticeRows(section, theme, width),
+      ...fieldRows(section, state, theme, width, nowMs)
+    ];
+  }
+  return [
+    fitText(theme.headerBg(alignRight(" SECTIONS", `${sections.length}`, width)), width),
+    ...sections.map((candidate, index) => sectionRow(candidate, index === state.sectionIndex, state.pane, theme, width))
+  ];
+}
+function twoPaneLines(sections, state, theme, width, nowMs) {
+  const split = paneSplit(width);
+  const left = [fitText(theme.key(" SECTIONS"), split.sections)];
+  sections.forEach(
+    (candidate, index) => left.push(sectionRow(candidate, index === state.sectionIndex, state.pane, theme, split.sections))
+  );
+  const right = [];
+  const section = sections[state.sectionIndex];
+  if (section) {
+    right.push(fitText(alignRight(` ${section.title}`, section.source, split.fields), split.fields));
+    if (section.detail) right.push(fitText(` ${theme.dim(section.detail)}`, split.fields));
+    right.push(...noticeRows(section, theme, split.fields));
+    right.push(...fieldRows(section, state, theme, split.fields, nowMs));
+  } else {
+    right.push(fitText(theme.dim("no surface is published"), split.fields));
+  }
+  const rows = [];
+  for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+    rows.push(fitText(`${padRight(left[index] ?? "", split.sections)} ${right[index] ?? ""}`, width));
+  }
+  return rows;
+}
+function renderKxmTuiPanel(sections, state, theme, options, width = 120) {
+  const nowMs = options.nowMs ?? Date.now();
+  const title = `${theme.cursor(options.title)}${options.breadcrumb ? `  ${theme.dim(options.breadcrumb)}` : ""}`;
+  const header = [fitText(title, width)];
+  if (state.help) {
+    const help = (options.helpLines ?? ["no help published"]).flatMap((line) => wrapPlain(line, Math.max(1, width - 2)));
+    return [...header, ...help.map((line) => fitText(line, width)), fitText(theme.dim("esc close help"), width)];
+  }
+  const body = width < SPLIT_MIN_WIDTH ? singlePaneLines(sections, state, theme, width, nowMs) : twoPaneLines(sections, state, theme, width, nowMs);
+  const footer = options.footer ? [fitText(theme.dim(options.footer), width)] : [];
+  return [...header, ...body, ...footer];
+}
 
 // packages/core/tui/src/tui/panelComponent.ts
 var KXM_TUI_PANEL_HELP = Object.freeze([
   "\u2191\u2193 move \xB7 \u2190\u2192 or Tab panes \xB7 PgUp/PgDn section \xB7 enter edit or open list",
   "type to filter a list \xB7 x clears a value \xB7 esc backs out \xB7 q quit \xB7 h help"
 ]);
+function rowsComponent() {
+  const stack = new VStack([], { gap: 0 });
+  const scroll = new ScrollView(stack, { primary: true, overscroll: "contain", scrollbar: "auto" });
+  const fill = (rows) => {
+    stack.clear();
+    for (const row of rows) stack.addChild(new TruncatedText(row, 0, 0));
+  };
+  return { stack, scroll, fill };
+}
+var KxmTuiPanelComponent = class {
+  root = new VStack([], { gap: 0 });
+  options;
+  body = rowsComponent();
+  sections;
+  state;
+  notice;
+  unsubscribe;
+  constructor(options) {
+    this.options = options;
+    this.sections = options.registry.getSections();
+    this.state = initialKxmTuiPanelState(this.sections);
+    this.unsubscribe = options.registry.subscribe(() => this.refresh());
+    this.rebuild();
+  }
+  getState() {
+    return this.state;
+  }
+  getSections() {
+    return this.sections;
+  }
+  /** Point the cursor at a field, e.g. after opening a named section. */
+  focus(sectionId, fieldId) {
+    const sectionIndex = this.sections.findIndex((section) => section.id === sectionId);
+    if (sectionIndex < 0) return;
+    const fields = this.sections[sectionIndex]?.fields ?? [];
+    const fieldIndex = fieldId ? Math.max(0, fields.findIndex((field) => field.id === fieldId)) : this.state.fieldIndex;
+    this.state = { ...this.state, pane: "fields", sectionIndex, fieldIndex };
+    this.rebuild();
+    this.options.requestRender();
+  }
+  setStatus(message) {
+    this.notice = message;
+    this.rebuild();
+    this.options.requestRender();
+  }
+  refresh() {
+    const next = this.options.registry.getSections();
+    this.sections = next;
+    this.state = reconcileKxmTuiPanelState(this.state, next);
+    this.rebuild();
+    this.options.requestRender();
+  }
+  handleInput(data) {
+    if (matchesKey(data, Key.pageUp) || matchesKey(data, Key.ctrl("u"))) {
+      this.body.scroll.scrollBy(-(this.viewport() - 2));
+      this.options.requestRender();
+      return;
+    }
+    if (matchesKey(data, Key.pageDown) || matchesKey(data, Key.ctrl("d"))) {
+      this.body.scroll.scrollBy(this.viewport() - 2);
+      this.options.requestRender();
+      return;
+    }
+    const step = reduceKxmTuiInput(this.state, this.sections, data);
+    this.state = step.state;
+    for (const effect of step.effects) this.run(effect);
+    this.rebuild();
+    this.options.requestRender();
+  }
+  viewport() {
+    const height = this.body.scroll.viewportHeight;
+    return height > 3 ? height : 10;
+  }
+  run(effect) {
+    if (effect.type === "quit") {
+      this.options.onQuit();
+      return;
+    }
+    if (effect.type === "notice") {
+      this.notice = effect.message;
+      return;
+    }
+    this.notice = void 0;
+    void this.options.registry.invoke(effect.invocation).then((result) => {
+      if (!result.ok) this.setStatus(result.message ?? "the owner refused that change");
+      else if (this.notice === void 0) this.setStatus(void 0);
+    });
+  }
+  footer() {
+    const status = this.notice ?? this.options.statusText?.();
+    const base = "\u2191\u2193 \xB7 \u2190\u2192 panes \xB7 enter edit \xB7 x clear \xB7 esc back \xB7 h help \xB7 q quit";
+    return status ? `${base}  ${status}` : base;
+  }
+  rebuild() {
+    const theme = this.options.theme;
+    const width = this.options.getWidth?.() ?? 120;
+    const title = new Box(1, 0, theme.headerBg);
+    title.addChild(new HStack([
+      { component: new Text(theme.cursor(this.options.title), 0, 0), basis: 12, shrink: 1, minSize: 6 },
+      {
+        component: new Text(
+          this.options.breadcrumb ? theme.dim(fitText(this.options.breadcrumb, Math.max(4, width - 16))) : "",
+          0,
+          0
+        ),
+        grow: 1,
+        shrink: 1,
+        minSize: 8
+      }
+    ], { gap: 2 }));
+    this.body.fill(
+      renderKxmTuiPanel(this.sections, this.state, theme, {
+        title: this.options.title,
+        ...this.options.breadcrumb ? { breadcrumb: this.options.breadcrumb } : {},
+        helpLines: this.options.helpLines ?? KXM_TUI_PANEL_HELP,
+        footer: this.footer()
+      }, width)
+    );
+    const panel = new Box(0, 0, theme.panelBg);
+    panel.addChild(this.body.scroll);
+    this.root.clear();
+    this.root.addChild(title, { basis: "auto", shrink: 0 });
+    this.root.addChild(panel, { basis: "auto", grow: 1, shrink: 1, minSize: 1 });
+  }
+  handleMouse(event) {
+    return this.root.handleMouse?.(event);
+  }
+  invalidate() {
+    this.root.invalidate();
+  }
+  render(width) {
+    return this.root.render(width);
+  }
+  dispose() {
+    this.unsubscribe();
+    this.unsubscribe = () => void 0;
+  }
+};
+
+// packages/core/tui/src/services/registry.ts
+function describe(error) {
+  if (error instanceof Error && error.message) return error.message.split(/\r?\n/u)[0].slice(0, KXM_TUI_LIMITS.detailMax);
+  return String(error).split(/\r?\n/u)[0].slice(0, KXM_TUI_LIMITS.detailMax);
+}
+function normalizeSource(source) {
+  if (!/^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u.test(source) || source.length > KXM_TUI_LIMITS.sourceMax) {
+    throw new Error(`invalid kxm tui surface source: ${source.slice(0, 64)}`);
+  }
+  return source;
+}
+function createKxmTuiRegistry(options = {}) {
+  const contributions = /* @__PURE__ */ new Map();
+  const notices = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  const published = /* @__PURE__ */ new Map();
+  const issues = /* @__PURE__ */ new Map();
+  let generation = 0;
+  let disposed = false;
+  let epoch = 0;
+  const report2 = (error, context) => {
+    if (options.onInternalError) options.onInternalError(error, context);
+  };
+  const emit = (event) => {
+    for (const listener of Array.from(listeners)) {
+      try {
+        listener(event);
+      } catch (error) {
+        report2(error, "listener");
+      }
+    }
+  };
+  function readOwner(source, force) {
+    if (!force) {
+      const cached = published.get(source);
+      if (cached) return cached;
+    }
+    const contribution = contributions.get(source);
+    if (!contribution) {
+      published.set(source, []);
+      return [];
+    }
+    let sections;
+    try {
+      const raw = contribution.listSections();
+      const ownerIssues = validateKxmTuiSurface(raw);
+      if (ownerIssues.length > 0) {
+        issues.set(source, ownerIssues);
+        sections = raw.filter((section) => Boolean(section) && typeof section === "object").map((section) => ({
+          ...section,
+          notice: section.notice ?? `published surface was refused: ${ownerIssues[0].code} at ${ownerIssues[0].path}`,
+          noticeLevel: "error"
+        }));
+      } else {
+        issues.delete(source);
+        sections = raw;
+      }
+    } catch (error) {
+      issues.set(source, [{ path: source, code: "list_sections_failed", message: describe(error) }]);
+      report2(error, `listSections:${source}`);
+      sections = [{ source, id: "error", title: source, order: 900, notice: describe(error), noticeLevel: "error", fields: [] }];
+    }
+    const pending = notices.get(source);
+    const withNotice = pending !== void 0 && sections.length > 0 ? sections.map((section, index) => index === 0 ? { ...section, notice: pending, noticeLevel: "error" } : section) : sections;
+    published.set(source, withNotice);
+    return withNotice;
+  }
+  function merged() {
+    const all = [];
+    for (const source of contributions.keys()) all.push(...readOwner(source, false));
+    return all.slice().sort((a, b2) => a.order - b2.order || a.source.localeCompare(b2.source) || a.title.localeCompare(b2.title));
+  }
+  return {
+    register(contribution) {
+      if (disposed) throw new Error("kxm tui registry is disposed");
+      const source = normalizeSource(contribution.source);
+      notices.delete(source);
+      published.delete(source);
+      issues.delete(source);
+      contributions.set(source, { ...contribution, source });
+      emit({ reason: "publish", source });
+    },
+    unregister(source) {
+      contributions.delete(source);
+      published.delete(source);
+      issues.delete(source);
+      notices.delete(source);
+      emit({ reason: "publish", source });
+    },
+    getSections() {
+      return merged();
+    },
+    getIssues() {
+      return [...issues.values()].flat();
+    },
+    async invoke(invocation) {
+      if (disposed) return { ok: false, message: "kxm tui registry is disposed" };
+      const contribution = contributions.get(invocation.source);
+      if (!contribution) {
+        emit({ reason: "refused", source: invocation.source, message: "unknown owner" });
+        return { ok: false, message: `${invocation.source} does not own a surface here` };
+      }
+      const handler = contribution.handlers[invocation.action];
+      if (!handler) {
+        const message = `${invocation.source} does not accept "${invocation.action}"`;
+        emit({ reason: "refused", source: invocation.source, message });
+        return { ok: false, message };
+      }
+      const currentEpoch = epoch;
+      try {
+        await handler({
+          sectionId: invocation.sectionId,
+          fieldId: invocation.fieldId,
+          action: invocation.action,
+          ...invocation.value === void 0 ? {} : { value: invocation.value }
+        });
+      } catch (error) {
+        const failure = contribution.describeError?.(error, invocation.action) ?? describe(error);
+        notices.set(invocation.source, failure);
+        emit({ reason: "failed", source: invocation.source, message: failure });
+        readOwner(invocation.source, true);
+        generation += 1;
+        return { ok: false, message: failure };
+      }
+      if (currentEpoch !== epoch) {
+        readOwner(invocation.source, true);
+        return { ok: false, message: "stale write result was discarded" };
+      }
+      notices.delete(invocation.source);
+      readOwner(invocation.source, true);
+      generation += 1;
+      emit({ reason: "publish", source: invocation.source });
+      return { ok: true };
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    getGeneration() {
+      return generation;
+    },
+    hasSource(source) {
+      return contributions.has(source);
+    },
+    listSources() {
+      return [...contributions.keys()];
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      epoch += 1;
+      listeners.clear();
+      contributions.clear();
+      published.clear();
+      issues.clear();
+      notices.clear();
+    }
+  };
+}
+
+// packages/core/tui/src/adapters/terminal.ts
+function renderKxmTuiPanelFrame(input) {
+  const theme = input.theme ?? createPlainKxmTuiTheme();
+  const lines = renderKxmTuiPanel(
+    input.registry.getSections(),
+    initialKxmTuiPanelState(input.registry.getSections()),
+    theme,
+    { title: input.title, footer: input.footer ?? "non-interactive frame", nowMs: input.nowMs ?? Date.now() },
+    input.width ?? 100
+  );
+  return `${lines.map((line) => stripTerminalSequences(line)).join("\n")}
+`;
+}
+async function runKxmTuiPanel(input) {
+  const theme = input.theme ?? createDefaultKxmTuiTheme();
+  const tty = input.isTty ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  if (!tty) {
+    input.stdout(renderKxmTuiPanelFrame({
+      registry: input.registry,
+      title: input.title,
+      theme,
+      ...input.now === void 0 ? {} : { nowMs: input.now() },
+      ...input.breadcrumb ? { footer: input.breadcrumb } : {}
+    }));
+    return 0;
+  }
+  const terminal = input.terminal ?? new ProcessTerminal();
+  const tui = new TuiAltScreen(terminal, false, void 0, { mouse: true });
+  let timer;
+  let stopped = false;
+  let finished = () => void 0;
+  const done = new Promise((resolve35) => {
+    finished = resolve35;
+  });
+  const stop = () => {
+    if (stopped) return;
+    stopped = true;
+    if (timer) clearInterval(timer);
+    input.abort?.removeEventListener("abort", stop);
+    panel.dispose();
+    tui.stop();
+    finished();
+  };
+  const panel = new KxmTuiPanelComponent({
+    registry: input.registry,
+    theme,
+    title: input.title,
+    ...input.breadcrumb ? { breadcrumb: input.breadcrumb } : {},
+    ...input.helpLines ? { helpLines: input.helpLines } : {},
+    requestRender: () => tui.requestRender(),
+    onQuit: stop,
+    getWidth: () => terminal.columns
+  });
+  input.abort?.addEventListener("abort", stop, { once: true });
+  tui.setLayoutRoot(panel.root);
+  tui.setFocus(panel);
+  tui.start();
+  timer = setInterval(() => panel.refresh(), input.pollMs ?? 2e3);
+  timer.unref?.();
+  await done;
+  return stopped && input.abort?.aborted ? 130 : 0;
+}
 
 // plugins/kxm/src/external-effects.ts
 init_database();
@@ -50399,9 +51916,9 @@ var SHARED_EFFECT_KINDS = Object.freeze([
 // plugins/kxm/src/local-snapshot.ts
 init_sqlite();
 init_telemetry();
-import { existsSync as existsSync36, readdirSync as readdirSync12, readFileSync as readFileSync32 } from "node:fs";
+import { existsSync as existsSync37, readdirSync as readdirSync12, readFileSync as readFileSync33 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
-import { isAbsolute as isAbsolute10, join as join45, resolve as resolve26 } from "node:path";
+import { isAbsolute as isAbsolute11, join as join46, resolve as resolve26 } from "node:path";
 var DEFAULT_BUSY_TIMEOUT_MS = 5e3;
 var RUNTIME_PROJECT_KEY = /^[A-Za-z0-9_-][A-Za-z0-9._-]*$/;
 function processExists2(pid) {
@@ -50526,36 +52043,36 @@ function readOpenMessageMetadata(database, where = OPEN_MESSAGE_WHERE, params =
   return messages;
 }
 function resolveKxmSnapshotPaths(cwd, env = process.env) {
-  const stateDir = env.KXM_STATE_DIR?.trim() || join45(cwd, ".kxm", "state");
+  const stateDir = env.KXM_STATE_DIR?.trim() || join46(cwd, ".kxm", "state");
   const configured = env.KXM_DATA_PATH?.trim();
-  const dataPath = configured ? resolve26(cwd, configured) : join45(stateDir, "kxm.db");
+  const dataPath = configured ? resolve26(cwd, configured) : join46(stateDir, "kxm.db");
   return { dataPath, stateDir };
 }
 function resolveKxmStateRoot(stateDir, options) {
-  if (options?.kxmStateRoot && existsSync36(options.kxmStateRoot)) {
+  if (options?.kxmStateRoot && existsSync37(options.kxmStateRoot)) {
     return resolve26(options.kxmStateRoot);
   }
-  if (existsSync36(join45(stateDir, "runtime", "registry.db")) || existsSync36(join45(stateDir, "runtime", "projects"))) {
+  if (existsSync37(join46(stateDir, "runtime", "registry.db")) || existsSync37(join46(stateDir, "runtime", "projects"))) {
     return stateDir;
   }
   const env = options?.env ?? process.env;
   const explicit = env.KXM_STATE_HOME?.trim() || env.KXM_USER_STATE_DIR?.trim() || env.KXM_STATE_ROOT?.trim();
-  if (explicit && isAbsolute10(explicit) && existsSync36(resolve26(explicit))) {
+  if (explicit && isAbsolute11(explicit) && existsSync37(resolve26(explicit))) {
     return resolve26(explicit);
   }
   let base;
   if (process.platform === "win32") {
     const localAppData = env.LOCALAPPDATA?.trim();
-    base = localAppData && isAbsolute10(localAppData) ? localAppData : join45(homedir6(), "AppData", "Local");
+    base = localAppData && isAbsolute11(localAppData) ? localAppData : join46(homedir6(), "AppData", "Local");
     base = resolve26(base, "KXM");
   } else if (process.platform === "darwin") {
     base = resolve26(homedir6(), "Library", "Application Support", "KXM");
   } else {
     const xdgState = env.XDG_STATE_HOME?.trim();
-    base = xdgState && isAbsolute10(xdgState) ? xdgState : join45(homedir6(), ".local", "state");
+    base = xdgState && isAbsolute11(xdgState) ? xdgState : join46(homedir6(), ".local", "state");
     base = resolve26(base, "kxm");
   }
-  if (existsSync36(base)) return base;
+  if (existsSync37(base)) return base;
   return void 0;
 }
 function readRuntimeRuns(eventDb, projectId) {
@@ -50588,7 +52105,7 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
   let legacyRuns = [];
   let legacyRunTotal = 0;
   let plans = [];
-  if (existsSync36(dataPath)) {
+  if (existsSync37(dataPath)) {
     hasLegacy = true;
     const database = openReadOnlyDatabase(dataPath);
     try {
@@ -50619,11 +52136,11 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
   let kxmRunTotal = 0;
   const kxmStateRoot = scope && !scope.runtimeProjectId ? void 0 : resolveKxmStateRoot(stateDir, options);
   if (kxmStateRoot) {
-    const runtimeDir = join45(kxmStateRoot, "runtime");
-    const registryDbPath = join45(runtimeDir, "registry.db");
-    const projectsDir = join45(runtimeDir, "projects");
+    const runtimeDir = join46(kxmStateRoot, "runtime");
+    const registryDbPath = join46(runtimeDir, "registry.db");
+    const projectsDir = join46(runtimeDir, "projects");
     const projectKeys = /* @__PURE__ */ new Set();
-    if (existsSync36(registryDbPath)) {
+    if (existsSync37(registryDbPath)) {
       hasKxm = true;
       try {
         const regDb = openReadOnlyDatabase(registryDbPath);
@@ -50639,7 +52156,7 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
       } catch {
       }
     }
-    if (!scope && existsSync36(projectsDir)) {
+    if (!scope && existsSync37(projectsDir)) {
       try {
         for (const entry of readdirSync12(projectsDir, { withFileTypes: true })) {
           if (entry.isDirectory()) {
@@ -50651,8 +52168,8 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
     }
     for (const key of projectKeys) {
       if (scope && !RUNTIME_PROJECT_KEY.test(key)) continue;
-      const eventDbPath = join45(projectsDir, key, "run-events.db");
-      if (existsSync36(eventDbPath)) {
+      const eventDbPath = join46(projectsDir, key, "run-events.db");
+      if (existsSync37(eventDbPath)) {
         hasKxm = true;
         try {
           const eventDb = openReadOnlyDatabase(eventDbPath);
@@ -50670,10 +52187,10 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
     }
   }
   const pids = [];
-  if (existsSync36(stateDir)) {
+  if (existsSync37(stateDir)) {
     for (const file of readdirSync12(stateDir).filter((name) => name.endsWith(".pid"))) {
       try {
-        const record = JSON.parse(readFileSync32(join45(stateDir, file), "utf8"));
+        const record = JSON.parse(readFileSync33(join46(stateDir, file), "utf8"));
         pids.push({
           file,
           ...record.role ? { role: record.role } : {},
@@ -50712,8 +52229,8 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
   } else {
     source = "legacy";
   }
-  const telemetryFile = join45(stateDir, "telemetry.jsonl");
-  const spend = existsSync36(telemetryFile) ? readRoutingRecords(telemetryFile) : [];
+  const telemetryFile = join46(stateDir, "telemetry.jsonl");
+  const spend = existsSync37(telemetryFile) ? readRoutingRecords(telemetryFile) : [];
   return {
     source,
     agents: agents.sort((a, b2) => Number(b2.online) - Number(a.online) || a.name.localeCompare(b2.name)),
@@ -50847,7 +52364,7 @@ function spawnDegradeWorktree(repoRoot, runId, options) {
   const cleanRunId = runId.replace(/^run_/, "");
   const desc = options?.description ? slugifyBranchPart(options.description, 30) : "degrade";
   const branchName = `kxm/run-${cleanRunId}-${desc}`;
-  const relativeWtPath = join46(".kxm", "worktrees", `run-${cleanRunId}-${desc}`);
+  const relativeWtPath = join47(".kxm", "worktrees", `run-${cleanRunId}-${desc}`);
   const absoluteWtPath = resolve27(repoRoot, relativeWtPath);
   const jumpCommand = `cd "${absoluteWtPath}"`;
   try {
@@ -51616,20 +53133,20 @@ async function runMeshTui(input) {
 // plugins/kxm/src/session-work.ts
 import { spawnSync as spawnSync13 } from "node:child_process";
 import { randomUUID as randomUUID13 } from "node:crypto";
-import { existsSync as existsSync37, mkdirSync as mkdirSync28, readFileSync as readFileSync33, renameSync as renameSync9, writeFileSync as writeFileSync24 } from "node:fs";
-import { join as join47 } from "node:path";
+import { existsSync as existsSync38, mkdirSync as mkdirSync28, readFileSync as readFileSync34, renameSync as renameSync9, writeFileSync as writeFileSync24 } from "node:fs";
+import { join as join48 } from "node:path";
 init_hub_binding();
 init_telemetry();
 var MAX_SESSION_BRIEF_TASKS = 5;
 var MAX_SESSION_BRIEF_PLANS = 5;
 var SESSION_BRIEF_SCHEMA = "kxm.session-brief.v1";
 var DEFAULT_SESSION_BRIEF_STALE_SECONDS = 5;
-function hubPrefix(hub) {
+function hubStatusPart(hub) {
   const suffix = hub?.scope === "remote" ? "/remote" : "";
-  if (hub?.state === "on" || hub?.state === void 0 && hub?.online === true) return `kxm hub:on${suffix}`;
-  if (hub?.state === "off" || hub?.state === void 0 && hub?.online === false) return `kxm hub:off${suffix}`;
-  if (hub?.state === "unknown") return `kxm hub:unknown${suffix}`;
-  return "kxm";
+  if (hub?.state === "off" || hub?.state === void 0 && hub?.online === false) return `hub:off${suffix}`;
+  if (hub?.state === "unknown") return `hub:unknown${suffix}`;
+  if (hub?.scope === "remote") return "hub:remote";
+  return void 0;
 }
 function truncate(value, width) {
   const text = value.replace(/\s+/g, " ").trim();
@@ -51705,40 +53222,34 @@ function readGitShip(cwd) {
     return void 0;
   }
 }
-function formatSessionStatusLine(stats, current, hub, ship, updateLatest, cost) {
-  const head = hubPrefix(hub);
-  if (!current && stats.activeTasks === 0 && stats.planCount === 0 && stats.inbox === 0) {
-    const idle = hub?.online === void 0 && hub?.state === void 0 ? "kxm idle" : `${head} \xB7 idle`;
-    const withShip = ship?.dirty ? `${idle} \xB7 dirty` : ship && ship.ahead > 0 ? `${idle} \xB7 ${ship.ahead} local` : idle;
-    const withCost = cost ? `${withShip} \xB7 ${cost}` : withShip;
-    const finalLine = updateLatest ? `${withCost} \xB7 upd ${updateLatest}` : withCost;
-    return finalLine.length <= 80 ? finalLine : `${finalLine.slice(0, 79)}\u2026`;
-  }
-  const parts = [];
-  if (current?.kind === "task") parts.push(`${head} ${current.detail}`);
-  else if (current?.kind === "plan") parts.push(`${head} plan ${truncate(current.detail, 36)}`);
-  else parts.push(head);
-  parts.push(`${stats.activeTasks} task${stats.activeTasks === 1 ? "" : "s"}`);
+function formatSessionStatusLine(stats, current, hub, ship, updateLatest) {
+  const parts = ["kxm"];
+  const hubPart = hubStatusPart(hub);
+  if (hubPart) parts.push(hubPart);
+  if (current?.kind === "task") parts.push(current.detail);
+  else if (current?.kind === "plan") parts.push(`plan ${truncate(current.detail, 36)}`);
+  if (stats.activeTasks > 0) parts.push(`${stats.activeTasks} task${stats.activeTasks === 1 ? "" : "s"}`);
   if (stats.waitingTasks > 0) parts.push(`${stats.waitingTasks} waiting`);
-  parts.push(`${stats.planCount} plan${stats.planCount === 1 ? "" : "s"}`);
+  if (stats.planCount > 0) parts.push(`${stats.planCount} plan${stats.planCount === 1 ? "" : "s"}`);
   if (stats.inbox > 0) parts.push(`inbox ${stats.inbox}`);
   if (ship?.dirty) parts.push("dirty");
   else if (ship && ship.ahead > 0) parts.push(`${ship.ahead} local`);
-  if (cost) parts.push(cost);
   if (updateLatest) parts.push(`upd ${updateLatest}`);
-  const line = parts.join(" \xB7 ");
-  return line.length <= 80 ? line : `${line.slice(0, 79)}\u2026`;
+  return truncate(parts.join(" \xB7 "), 80);
 }
 function formatSessionWidget(stats, current, hub, ship, updateLatest, cost) {
-  const hubMark = hub?.state === "on" || hub?.online === true ? "hub:on  " : hub?.state === "off" || hub?.online === false ? "hub:off  " : hub?.state === "unknown" ? "hub:unknown  " : "";
-  const lines = [
-    `KXM  ${hubMark}${stats.activeTasks} tasks  ${stats.waitingTasks} waiting  ${stats.planCount} plans  inbox ${stats.inbox}`
-  ];
+  const suffix = hub?.scope === "remote" ? "/remote" : "";
+  const hubMark = hub?.state === "on" || hub?.state === void 0 && hub?.online === true ? `hub:on${suffix}` : hub?.state === "off" || hub?.state === void 0 && hub?.online === false ? `hub:off${suffix}` : hub?.state === "unknown" ? `hub:unknown${suffix}` : void 0;
+  const summary = ["KXM", hubMark];
+  if (stats.activeTasks > 0) summary.push(`${stats.activeTasks} task${stats.activeTasks === 1 ? "" : "s"}`);
+  if (stats.waitingTasks > 0) summary.push(`${stats.waitingTasks} waiting`);
+  if (stats.planCount > 0) summary.push(`${stats.planCount} plan${stats.planCount === 1 ? "" : "s"}`);
+  if (stats.inbox > 0) summary.push(`inbox ${stats.inbox}`);
+  const lines = [summary.filter(Boolean).join(" \xB7 ")];
   if (current) lines.push(`now  ${current.kind}  ${truncate(current.detail, 56)}`);
-  else if (stats.latestPlan) lines.push(`plan ${truncate(stats.latestPlan, 60)}`);
-  else lines.push("now  no selected work");
-  lines.push(formatShipLine(ship));
-  if (cost) lines.push(`cost  ${cost}`);
+  else if (stats.latestPlan) lines.push(`plan  ${truncate(stats.latestPlan, 60)}`);
+  if (ship?.dirty || ship && ship.ahead > 0) lines.push(formatShipLine(ship));
+  if (cost && cost !== "unknown") lines.push(`cost  ${cost}`);
   if (updateLatest) lines.push(`update  ${updateLatest} available \xB7 kxm update --kxm`);
   return lines;
 }
@@ -51758,7 +53269,7 @@ function buildSessionBrief(snapshot, current, hub, ship, updateLatest, cost, ses
   const tasks = uniqueLabels(recentTasks(snapshot.runs).map(taskItem));
   const plans = uniqueLabels(snapshot.plans.slice(0, MAX_SESSION_BRIEF_PLANS).map(planItem));
   const resolvedHub = hub ?? { state: "off", evidence: "unconfigured", online: false };
-  const statusLine = formatSessionStatusLine(stats, current, resolvedHub, ship, updateLatest, cost);
+  const statusLine = formatSessionStatusLine(stats, current, resolvedHub, ship, updateLatest);
   const widgetLines = formatSessionWidget(stats, current, resolvedHub, ship, updateLatest, cost);
   return {
     schema: SESSION_BRIEF_SCHEMA,
@@ -51776,10 +53287,10 @@ function buildSessionBrief(snapshot, current, hub, ship, updateLatest, cost, ses
   };
 }
 function readCachedSessionBrief(stateDir) {
-  const file = join47(stateDir, "session-brief.json");
+  const file = join48(stateDir, "session-brief.json");
   try {
-    if (!existsSync37(file)) return void 0;
-    const raw = readFileSync33(file, "utf8");
+    if (!existsSync38(file)) return void 0;
+    const raw = readFileSync34(file, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && parsed.schema === "kxm.session-brief.v1" && typeof parsed.generatedAt === "string") {
       const ageMs = Date.now() - Date.parse(parsed.generatedAt);
@@ -51795,7 +53306,7 @@ function readCachedSessionBrief(stateDir) {
 function writeCachedSessionBrief(stateDir, brief) {
   try {
     mkdirSync28(stateDir, { recursive: true, mode: 448 });
-    const file = join47(stateDir, "session-brief.json");
+    const file = join48(stateDir, "session-brief.json");
     const tmp = `${file}.tmp.${randomUUID13().slice(0, 8)}`;
     writeFileSync24(tmp, JSON.stringify(brief, null, 2), { encoding: "utf8", mode: 384 });
     renameSync9(tmp, file);
@@ -51804,8 +53315,8 @@ function writeCachedSessionBrief(stateDir, brief) {
 }
 function estimateSessionCost(stateDir) {
   try {
-    const telemetryFile = join47(stateDir, "telemetry.jsonl");
-    if (!existsSync37(telemetryFile)) return void 0;
+    const telemetryFile = join48(stateDir, "telemetry.jsonl");
+    if (!existsSync38(telemetryFile)) return void 0;
     const records = readRoutingRecords(telemetryFile);
     if (records.length === 0) return void 0;
     let totalCost = 0;
@@ -51822,7 +53333,7 @@ function estimateSessionCost(stateDir) {
       latestModel = r.effectiveModel ?? r.requestedModel ?? latestModel;
       latestHarness = r.harness ?? latestHarness;
     }
-    if (!hasMetered) return "unknown";
+    if (!hasMetered) return void 0;
     const route = latestHarness && latestModel ? `${latestHarness}/${latestModel}` : latestModel;
     return `$${totalCost.toFixed(2)} sess${route ? ` \xB7 ${route}` : ""}`;
   } catch {
@@ -51859,8 +53370,7 @@ function loadSessionBrief(cwd, env = process.env, current, hub, options = {}) {
           current,
           effectiveHub,
           options.ship,
-          options.updateLatest,
-          effectiveCost
+          options.updateLatest
         );
         const widgetLines = formatSessionWidget(
           cached.stats,
@@ -51925,8 +53435,7 @@ async function loadSessionBriefAsync(cwd, env = process.env, current, hub, optio
           current,
           effectiveHub,
           options.ship,
-          void 0,
-          effectiveCost
+          void 0
         );
         const widgetLines = formatSessionWidget(
           cached.stats,
@@ -51977,16 +53486,16 @@ init_hub_binding();
 
 // plugins/kxm/src/kxm-install-kind.ts
 init_bindings();
-import { existsSync as existsSync38, readFileSync as readFileSync34 } from "node:fs";
-import { dirname as dirname21, join as join48 } from "node:path";
+import { existsSync as existsSync39, readFileSync as readFileSync35 } from "node:fs";
+import { dirname as dirname21, join as join49 } from "node:path";
 function kxmSourceCheckoutRoot(dir) {
-  if (!existsSync38(join48(dir, ".git"))) return void 0;
+  if (!existsSync39(join49(dir, ".git"))) return void 0;
   if (!packageIsKxm(dir)) return void 0;
   return dir;
 }
 function packageIsKxm(root) {
   try {
-    const pkg = JSON.parse(readFileSync34(join48(root, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync35(join49(root, "package.json"), "utf8"));
     return pkg.name === "@kontextmind/kxm";
   } catch {
     return false;
@@ -52035,12 +53544,12 @@ function report(kind, root) {
   return { kind, root, instruction: installKindInstruction(kind, root) };
 }
 function classifyInstallRoot(probe) {
-  const piGitRoot = join48(probe.homeDir, ".pi", "agent", "git");
+  const piGitRoot = join49(probe.homeDir, ".pi", "agent", "git");
   if (isUnder(probe.repoRoot, piGitRoot, probe.platform)) return report("pi-git", probe.repoRoot);
-  const claudeHome = probe.env.CLAUDE_CONFIG_DIR?.trim() || join48(probe.homeDir, ".claude");
-  const pluginsRoot = join48(claudeHome, "plugins");
+  const claudeHome = probe.env.CLAUDE_CONFIG_DIR?.trim() || join49(probe.homeDir, ".claude");
+  const pluginsRoot = join49(claudeHome, "plugins");
   if (isUnder(probe.moduleDir, pluginsRoot, probe.platform)) return report("claude-marketplace", probe.moduleDir);
-  const hasGit = existsSync38(join48(probe.repoRoot, ".git"));
+  const hasGit = existsSync39(join49(probe.repoRoot, ".git"));
   if (hasGit && packageIsKxm(probe.repoRoot)) return report("source", probe.repoRoot);
   if (isNpmPackageLayout(probe.repoRoot, probe.platform) && packageIsKxm(probe.repoRoot) && !hasGit) {
     return report("npm-package", probe.repoRoot);
@@ -52063,16 +53572,16 @@ function resolveInstallKind(probe, npmGlobalRoot) {
 init_bindings();
 
 // plugins/kxm/src/kxm-update-config.ts
-var import_yaml19 = __toESM(require_dist(), 1);
-import { existsSync as existsSync39, readFileSync as readFileSync35 } from "node:fs";
-import { join as join49 } from "node:path";
+var import_yaml20 = __toESM(require_dist(), 1);
+import { existsSync as existsSync40, readFileSync as readFileSync36 } from "node:fs";
+import { join as join50 } from "node:path";
 init_bindings();
 function loadKxmUpdateConfig(env = process.env) {
-  const path4 = join49(kxmUserStateRoot({ env }), "update.yaml");
-  if (!existsSync39(path4)) return { schema: KXM_UPDATE_SCHEMA, auto: false, source: "npm" };
+  const path4 = join50(kxmUserStateRoot({ env }), "update.yaml");
+  if (!existsSync40(path4)) return { schema: KXM_UPDATE_SCHEMA, auto: false, source: "npm" };
   let parsed;
   try {
-    parsed = (0, import_yaml19.parse)(readFileSync35(path4, "utf8"));
+    parsed = (0, import_yaml20.parse)(readFileSync36(path4, "utf8"));
   } catch {
     throw new KxmUpdateConfigError("update.yaml is not valid YAML");
   }
@@ -52100,8 +53609,8 @@ function loadKxmUpdateConfig(env = process.env) {
 // plugins/kxm/src/session.ts
 init_protocol();
 init_envelope();
-import { existsSync as existsSync40, mkdirSync as mkdirSync29, readFileSync as readFileSync36, writeFileSync as writeFileSync25 } from "node:fs";
-import { join as join50 } from "node:path";
+import { existsSync as existsSync41, mkdirSync as mkdirSync29, readFileSync as readFileSync37, writeFileSync as writeFileSync25 } from "node:fs";
+import { join as join51 } from "node:path";
 var SESSION_SCHEMA = "kxm.session.v1";
 var SessionConfigError = class extends Error {
   code = "session_config_invalid";
@@ -52111,12 +53620,12 @@ var SessionConfigError = class extends Error {
   }
 };
 function workflowAssetDirs(assetsDir, workflowId) {
-  const root = join50(assetsDir, "workflows", workflowId);
-  return [root, join50(root, "inputs"), join50(root, "outputs"), join50(root, "generated")];
+  const root = join51(assetsDir, "workflows", workflowId);
+  return [root, join51(root, "inputs"), join51(root, "outputs"), join51(root, "generated")];
 }
 function sessionAssetDirs(assetsDir, sessionId) {
-  const root = join50(assetsDir, "sessions", sessionId);
-  return [root, join50(root, "inputs"), join50(root, "outputs")];
+  const root = join51(assetsDir, "sessions", sessionId);
+  return [root, join51(root, "inputs"), join51(root, "outputs")];
 }
 function rosterNames(configDir) {
   return [...loadRosterMap(configDir).values()].map((row) => String(row.name));
@@ -52166,7 +53675,7 @@ function workerFromRosterRow(name, row, project) {
 function loadRosterMap(configDir) {
   const byName = /* @__PURE__ */ new Map();
   for (const [file, key] of [["agents.json", "agents"], ["gates.json", "gates"]]) {
-    const path4 = join50(configDir, file);
+    const path4 = join51(configDir, file);
     for (const row of loadRoster(path4, key)) {
       const name = String(row.name).trim();
       const lowered = name.toLowerCase();
@@ -52180,10 +53689,10 @@ function loadRosterMap(configDir) {
   return byName;
 }
 function loadRoster(path4, key) {
-  if (!existsSync40(path4)) return [];
+  if (!existsSync41(path4)) return [];
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync36(path4, "utf8"));
+    parsed = JSON.parse(readFileSync37(path4, "utf8"));
   } catch (error) {
     throw new SessionConfigError(
       `${key} roster at ${path4} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
@@ -52208,7 +53717,7 @@ function loadRoster(path4, key) {
   });
 }
 function createSession(input) {
-  const assetDir = input.mode === "workflow" && input.workflowId ? join50("assets", "workflows", input.workflowId) : join50("assets", "sessions", input.id);
+  const assetDir = input.mode === "workflow" && input.workflowId ? join51("assets", "workflows", input.workflowId) : join51("assets", "sessions", input.id);
   return {
     schema: SESSION_SCHEMA,
     id: input.id,
@@ -52221,8 +53730,8 @@ function createSession(input) {
   };
 }
 function writeSession(assetsDir, session, dryRun = false) {
-  const dir = join50(assetsDir, "sessions", session.id);
-  const path4 = join50(dir, "session.json");
+  const dir = join51(assetsDir, "sessions", session.id);
+  const path4 = join51(dir, "session.json");
   if (!dryRun) {
     mkdirSync29(dir, { recursive: true });
     writeFileSync25(path4, `${JSON.stringify(session, null, 2)}
@@ -52264,9 +53773,9 @@ function moduleInstallRoot() {
   }
 }
 function warnIgnoredProjectUpdateYaml(runtime) {
-  const projectFile = join51(runtime.dirs.workspace, "update.yaml");
-  if (!existsSync41(projectFile)) return;
-  const userFile = join51(kxmUserStateRoot({ env: runtime.env }), "update.yaml");
+  const projectFile = join52(runtime.dirs.workspace, "update.yaml");
+  if (!existsSync42(projectFile)) return;
+  const userFile = join52(kxmUserStateRoot({ env: runtime.env }), "update.yaml");
   runtime.io.stderr(`kxm: ignoring .kxm/update.yaml in ${runtime.dirs.workdir}; update settings are read only from ${userFile}
 `);
 }
@@ -52350,7 +53859,7 @@ async function cmdDash(runtime, options = {}) {
     return 2;
   }
   const screen = requested;
-  const dataPath = resolve28(runtime.dirs.workdir, runtime.env.KXM_DATA_PATH?.trim() || join51(runtime.dirs.state, "kxm.db"));
+  const dataPath = resolve28(runtime.dirs.workdir, runtime.env.KXM_DATA_PATH?.trim() || join52(runtime.dirs.state, "kxm.db"));
   if (runtime.dryRun) {
     print(runtime.io, runtime.json, {
       ok: true,
@@ -52405,7 +53914,7 @@ async function cmdHub(runtime) {
         config = loadKxmUpdateConfig(runtime.env);
       } catch (error) {
         if (error instanceof KxmUpdateConfigError) {
-          const yamlPath = join51(kxmUserStateRoot({ env: runtime.env }), "update.yaml");
+          const yamlPath = join52(kxmUserStateRoot({ env: runtime.env }), "update.yaml");
           runtime.io.stderr(`kxm: ${error.message}; update check skipped; fix or remove ${yamlPath}
 `);
         } else {
@@ -52560,7 +54069,7 @@ async function cmdHubBind(runtime, rawUrl, options = {}) {
     ...cloudFields
   };
   const identity = resolveProjectIdentity(runtime.dirs.workdir, runtime.env);
-  const configFile = join51(findConfigRoot(runtime.dirs.workdir), ".kxm", "config.yaml");
+  const configFile = join52(findConfigRoot(runtime.dirs.workdir), ".kxm", "config.yaml");
   const key = {
     ...keyOp ? { op: keyOp } : {},
     ...tokenEnv ? { env: tokenEnv } : {}
@@ -52720,7 +54229,7 @@ async function cmdWorker(runtime, options) {
   return await (runtime.io.spawnWorker ?? ((launchEnv) => spawnScript("kxm-worker.mjs", launchEnv)))(extraEnv);
 }
 async function cmdStop(runtime, waitMsFlag) {
-  const pids = existsSync41(runtime.dirs.state) ? readdirSync13(runtime.dirs.state).filter((name) => name.endsWith(".pid")) : [];
+  const pids = existsSync42(runtime.dirs.state) ? readdirSync13(runtime.dirs.state).filter((name) => name.endsWith(".pid")) : [];
   if (runtime.dryRun) {
     print(runtime.io, runtime.json, { ok: true, command: "stop", dryRun: true, pidFiles: pids }, "would signal pid files");
     return 0;
@@ -52735,7 +54244,7 @@ async function cmdStop(runtime, waitMsFlag) {
   const orphans = [];
   for (const file of pids) {
     try {
-      const record = JSON.parse(readFileSync37(join51(runtime.dirs.state, file), "utf8"));
+      const record = JSON.parse(readFileSync38(join52(runtime.dirs.state, file), "utf8"));
       const expectedControl = file === "hub.pid" ? "hub.stop" : file.startsWith("worker-") ? `${file.slice(0, -4)}.stop` : void 0;
       const expectedRole = file === "hub.pid" ? "hub" : file.startsWith("worker-") ? "worker" : void 0;
       if (record.version !== 1 || !Number.isInteger(record.pid) || record.pid <= 0 || !record.startedAt || !expectedControl || record.controlFile !== expectedControl || record.role !== expectedRole) {
@@ -52755,7 +54264,7 @@ async function cmdStop(runtime, waitMsFlag) {
         ignored.push(file);
         continue;
       }
-      writeFileSync26(join51(runtime.dirs.state, record.controlFile), `${JSON.stringify({ startedAt: record.startedAt, ...record.generation ? { generation: record.generation } : {}, requestedAt: (/* @__PURE__ */ new Date()).toISOString() })}
+      writeFileSync26(join52(runtime.dirs.state, record.controlFile), `${JSON.stringify({ startedAt: record.startedAt, ...record.generation ? { generation: record.generation } : {}, requestedAt: (/* @__PURE__ */ new Date()).toISOString() })}
 `, { encoding: "utf8", mode: 384 });
       requested.push(file);
       records.set(file, { pid: record.pid, startedAt: record.startedAt, ...record.generation ? { generation: record.generation } : {} });
@@ -52773,7 +54282,7 @@ async function cmdStop(runtime, waitMsFlag) {
   while (Date.now() <= deadline && stopped.size < requested.length) {
     for (const [file, record] of records) {
       try {
-        const current = JSON.parse(readFileSync37(join51(runtime.dirs.state, file), "utf8"));
+        const current = JSON.parse(readFileSync38(join52(runtime.dirs.state, file), "utf8"));
         if (current.pid !== record.pid || current.startedAt !== record.startedAt || current.generation !== record.generation || !processExists(record.pid)) stopped.add(file);
       } catch {
         stopped.add(file);
@@ -52786,7 +54295,7 @@ async function cmdStop(runtime, waitMsFlag) {
   for (const file of orphans) {
     while (Date.now() <= deadlineOrphans) {
       try {
-        const current = JSON.parse(readFileSync37(join51(runtime.dirs.state, file), "utf8"));
+        const current = JSON.parse(readFileSync38(join52(runtime.dirs.state, file), "utf8"));
         if (!Number.isInteger(current.serverPid) || !processExists(current.serverPid)) break;
       } catch {
         break;
@@ -52794,14 +54303,14 @@ async function cmdStop(runtime, waitMsFlag) {
       await (runtime.io.sleep ?? ((ms) => new Promise((resolveSleep) => setTimeout(resolveSleep, ms))))(100);
     }
     try {
-      const current = JSON.parse(readFileSync37(join51(runtime.dirs.state, file), "utf8"));
+      const current = JSON.parse(readFileSync38(join52(runtime.dirs.state, file), "utf8"));
       if (Number.isInteger(current.serverPid) && processExists(current.serverPid)) {
         try {
           process.kill(current.serverPid, "SIGKILL");
         } catch {
         }
       }
-      rmSync11(join51(runtime.dirs.state, file), { force: true });
+      rmSync11(join52(runtime.dirs.state, file), { force: true });
     } catch {
     }
     stopped.add(file);
@@ -52812,11 +54321,11 @@ async function cmdStop(runtime, waitMsFlag) {
 }
 async function cmdSessionStatus(runtime) {
   const stateDir = runtime.dirs.state;
-  const names3 = existsSync41(stateDir) ? readdirSync13(stateDir) : [];
+  const names3 = existsSync42(stateDir) ? readdirSync13(stateDir) : [];
   const claims = [];
   for (const file of names3.filter((name) => name.endsWith(".pid"))) {
     try {
-      const record = JSON.parse(readFileSync37(join51(stateDir, file), "utf8"));
+      const record = JSON.parse(readFileSync38(join52(stateDir, file), "utf8"));
       claims.push({
         file,
         role: record.role,
@@ -52831,7 +54340,7 @@ async function cmdSessionStatus(runtime) {
   const recoveries = [];
   for (const file of names3.filter((name) => name.startsWith("worker-recovery-") && name.endsWith(".json"))) {
     try {
-      const envelope2 = JSON.parse(readFileSync37(join51(stateDir, file), "utf8"));
+      const envelope2 = JSON.parse(readFileSync38(join52(stateDir, file), "utf8"));
       recoveries.push({
         file,
         reason: envelope2.reason,
@@ -52857,7 +54366,7 @@ async function cmdSessionStatus(runtime) {
 async function cmdAuthToken(runtime, options = {}) {
   const tokenFile = sessionTokenPath(runtime.env.KXM_USER_CONFIG_DIR);
   if (options.clear && runtime.dryRun) {
-    const present = existsSync41(tokenFile);
+    const present = existsSync42(tokenFile);
     printPlan(runtime, { command: "auth token", cleared: present }, present ? [{ action: "delete", target: tokenFile }] : [], present ? "clear the session token from disk" : "no session token file to clear");
     return 0;
   }
@@ -52946,7 +54455,7 @@ async function cmdSessionBrief(runtime, options = {}) {
     print(runtime.io, runtime.json, { ok: true, command: "session brief", sessionToken }, sessionToken);
     return 0;
   }
-  const dataPath = resolve28(runtime.dirs.workdir, runtime.env.KXM_DATA_PATH?.trim() || join51(runtime.dirs.state, "kxm.db"));
+  const dataPath = resolve28(runtime.dirs.workdir, runtime.env.KXM_DATA_PATH?.trim() || join52(runtime.dirs.state, "kxm.db"));
   const env = {
     ...runtime.env,
     KXM_STATE_DIR: runtime.dirs.state,
@@ -52972,7 +54481,7 @@ async function cmdSessionBrief(runtime, options = {}) {
     writeCache: !runtime.dryRun
   });
   if (runtime.dryRun) {
-    if (!readCachedSessionBrief(runtime.dirs.state)) planned.push({ action: "write", target: join51(runtime.dirs.state, "session-brief.json") });
+    if (!readCachedSessionBrief(runtime.dirs.state)) planned.push({ action: "write", target: join52(runtime.dirs.state, "session-brief.json") });
     print(runtime.io, runtime.json, { ...brief, dryRun: true, planned }, [
       options.status ? brief.statusLine : formatSessionBriefText(brief),
       ...planned.map((change) => `dry run: would ${change.action} ${change.target}`)
@@ -53056,9 +54565,9 @@ init_routing();
 init_prices();
 import { spawnSync as spawnSync15 } from "node:child_process";
 import { createHash as createHash19 } from "node:crypto";
-import { existsSync as existsSync48, mkdtempSync as mkdtempSync3, readFileSync as readFileSync42, rmSync as rmSync13 } from "node:fs";
+import { existsSync as existsSync50, mkdtempSync as mkdtempSync3, readFileSync as readFileSync44, rmSync as rmSync13 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
-import { basename as basename11, extname as extname3, join as join57, resolve as resolve33 } from "node:path";
+import { basename as basename11, extname as extname3, join as join58, resolve as resolve33 } from "node:path";
 import { createInterface as createInterface3 } from "node:readline";
 
 // plugins/kxm/src/improve.ts
@@ -53066,8 +54575,8 @@ init_routing();
 init_protocol();
 init_relevance();
 import { createHash as createHash18 } from "node:crypto";
-import { existsSync as existsSync42, mkdirSync as mkdirSync31, writeFileSync as writeFileSync27 } from "node:fs";
-import { join as join52, relative as relative7, resolve as resolve29 } from "node:path";
+import { existsSync as existsSync43, mkdirSync as mkdirSync31, writeFileSync as writeFileSync27 } from "node:fs";
+import { join as join53, relative as relative7, resolve as resolve29 } from "node:path";
 var CANDIDATE_SCHEMA = "kxm.candidate.v1";
 var IMPROVEMENT_REPORT_SCHEMA = "kxm.improvement-report.v2";
 function classifyCandidateKind(stepId, agentRole) {
@@ -53323,7 +54832,7 @@ function groupRoutingRecords(records, options = {}) {
 }
 function buildImprovementReport(records, options = {}) {
   const projectRoot = options.projectRoot ? resolve29(options.projectRoot) : process.cwd();
-  const candidatesDir = options.candidatesDir ? resolve29(options.candidatesDir) : join52(projectRoot, ".kxm", "candidates");
+  const candidatesDir = options.candidatesDir ? resolve29(options.candidatesDir) : join53(projectRoot, ".kxm", "candidates");
   const promotionPolicy = options.promotionPolicy ?? "manual_pr";
   const groups = groupRoutingRecords(records, options);
   const candidates = [];
@@ -53337,7 +54846,7 @@ function buildImprovementReport(records, options = {}) {
       group.workflowId
     );
     const diffFileName = `${group.candidateId}.diff`;
-    const diffFilePath = join52(candidatesDir, diffFileName);
+    const diffFilePath = join53(candidatesDir, diffFileName);
     const relDiffPath = relative7(projectRoot, diffFilePath).replace(/\\/g, "/");
     const candidate = {
       schema: CANDIDATE_SCHEMA,
@@ -53359,11 +54868,11 @@ function buildImprovementReport(records, options = {}) {
       createdAt: nowIso()
     };
     if (!options.dryRun) {
-      if (!existsSync42(candidatesDir)) {
+      if (!existsSync43(candidatesDir)) {
         mkdirSync31(candidatesDir, { recursive: true });
       }
       writeFileSync27(diffFilePath, diff, "utf8");
-      const jsonFilePath = join52(candidatesDir, `${group.candidateId}.json`);
+      const jsonFilePath = join53(candidatesDir, `${group.candidateId}.json`);
       writeFileSync27(jsonFilePath, JSON.stringify(candidate, null, 2) + "\n", "utf8");
     }
     candidates.push(candidate);
@@ -53394,7 +54903,7 @@ function buildImprovementReport(records, options = {}) {
 }
 function writeImprovementReport(improvementsDir, report2, dryRun = false) {
   const stamp = report2.createdAt.replace(/[:.]/g, "-");
-  const path4 = join52(improvementsDir, `${stamp}.json`);
+  const path4 = join53(improvementsDir, `${stamp}.json`);
   if (!dryRun) {
     mkdirSync31(improvementsDir, { recursive: true });
     writeFileSync27(path4, `${JSON.stringify(report2, null, 2)}
@@ -53487,7 +54996,7 @@ init_runtime_store();
 init_route_switch();
 init_routing();
 init_telemetry();
-import { existsSync as existsSync43 } from "node:fs";
+import { existsSync as existsSync44 } from "node:fs";
 import { resolve as resolve30 } from "node:path";
 var ENGINE_EVENTS_SQL = "SELECT run_id, sequence, event_type, payload FROM events WHERE event_type IN ('routing.attempt.recorded','routing.route_switched','step.entered','run.status_changed') ORDER BY run_id, sequence";
 var SIMULATED_HARNESS = "driver-simulated";
@@ -53510,7 +55019,7 @@ function readEngineRoutingRecords(path4) {
     undecided: 0,
     duplicatesDropped: 0
   };
-  if (!existsSync43(path4)) return { records: [], source, routeSwitches: [] };
+  if (!existsSync44(path4)) return { records: [], source, routeSwitches: [] };
   source.exists = true;
   let rows;
   let database;
@@ -53596,7 +55105,7 @@ function readEngineRoutingRecords(path4) {
   };
 }
 function readJsonlSource(kind, path4) {
-  const exists = existsSync43(path4);
+  const exists = existsSync44(path4);
   const records = exists ? readRoutingRecords(path4).map((entry) => entry.routing) : [];
   return { records, source: { kind, path: path4, exists, records: records.length, duplicatesDropped: 0 } };
 }
@@ -53640,10 +55149,10 @@ function loadRoutingSources(options) {
 }
 
 // plugins/kxm/src/modes.ts
-var import_yaml20 = __toESM(require_dist(), 1);
+var import_yaml21 = __toESM(require_dist(), 1);
 init_prices();
-import { existsSync as existsSync44, readFileSync as readFileSync39 } from "node:fs";
-import { join as join53 } from "node:path";
+import { existsSync as existsSync45, readFileSync as readFileSync40 } from "node:fs";
+import { join as join54 } from "node:path";
 var DEFAULT_MODES_CONFIG = Object.freeze({
   schema: "kxm.modes.v1",
   majorModes: {
@@ -53706,13 +55215,13 @@ function loadModesConfig(projectRoot) {
   if (!projectRoot) {
     return DEFAULT_MODES_CONFIG;
   }
-  const modesPath = join53(projectRoot, ".kxm", "modes.yaml");
-  if (!existsSync44(modesPath)) {
+  const modesPath = join54(projectRoot, ".kxm", "modes.yaml");
+  if (!existsSync45(modesPath)) {
     return DEFAULT_MODES_CONFIG;
   }
   try {
-    const raw = readFileSync39(modesPath, "utf8");
-    const parsed = (0, import_yaml20.parse)(raw);
+    const raw = readFileSync40(modesPath, "utf8");
+    const parsed = (0, import_yaml21.parse)(raw);
     if (parsed && parsed.schema === "kxm.modes.v1" && parsed.majorModes) {
       return {
         schema: "kxm.modes.v1",
@@ -53797,11 +55306,11 @@ function calculatePromptFootprint(resolved, projectRoot = process.cwd(), catalog
     estimatedTokens: estimateTokens(baseSystemPromptChars)
   });
   for (const relPath of resolved.contextFiles) {
-    const fullPath = join53(projectRoot, relPath);
+    const fullPath = join54(projectRoot, relPath);
     let chars = 0;
-    if (existsSync44(fullPath)) {
+    if (existsSync45(fullPath)) {
       try {
-        chars = readFileSync39(fullPath, "utf8").length;
+        chars = readFileSync40(fullPath, "utf8").length;
       } catch {
         chars = 0;
       }
@@ -53934,9 +55443,9 @@ ${divider}
 // plugins/kxm/src/ssh-remote.ts
 init_safety_integrity();
 import { spawnSync as spawnSync14 } from "node:child_process";
-import { existsSync as existsSync45, mkdirSync as mkdirSync32, readFileSync as readFileSync40, readdirSync as readdirSync14, rmSync as rmSync12, statSync as statSync7 } from "node:fs";
+import { existsSync as existsSync46, mkdirSync as mkdirSync32, readFileSync as readFileSync41, readdirSync as readdirSync14, rmSync as rmSync12, statSync as statSync7 } from "node:fs";
 import { homedir as homedir8 } from "node:os";
-import { join as join54, resolve as resolve31 } from "node:path";
+import { join as join55, resolve as resolve31 } from "node:path";
 var MAX_SSH_OUTPUT_BYTES = 50 * 1024;
 var MAX_SSH_OUTPUT_LINES = 2e3;
 var DEFAULT_SOCKET_DIR = ".kxm/run/ssh-sockets";
@@ -53962,12 +55471,12 @@ function truncateSshOutput(raw) {
   return { text, truncated };
 }
 function parseSshConfig(configPath) {
-  const targetPath = configPath ?? join54(homedir8(), ".ssh", "config");
-  if (!existsSync45(targetPath)) {
+  const targetPath = configPath ?? join55(homedir8(), ".ssh", "config");
+  if (!existsSync46(targetPath)) {
     return [];
   }
   try {
-    const content = readFileSync40(targetPath, "utf-8");
+    const content = readFileSync41(targetPath, "utf-8");
     const lines = content.split("\n");
     const hosts = [];
     let currentHosts = [];
@@ -54045,14 +55554,14 @@ function resolveSshHostG(host, execFn = spawnSync14) {
 }
 function ensureSocketDir(socketDir = DEFAULT_SOCKET_DIR) {
   const resolved = resolve31(socketDir);
-  if (!existsSync45(resolved)) {
+  if (!existsSync46(resolved)) {
     mkdirSync32(resolved, { recursive: true, mode: 448 });
   }
   return resolved;
 }
 function buildSshArgs(options) {
   const socketDir = ensureSocketDir(options.socketDir ?? DEFAULT_SOCKET_DIR);
-  const controlPath = join54(socketDir, "%C");
+  const controlPath = join55(socketDir, "%C");
   const persist = options.controlPersist ?? DEFAULT_CONTROL_PERSIST;
   const args = [
     "-o",
@@ -54077,7 +55586,7 @@ function buildSshArgs(options) {
 }
 function checkControlSocket(host, socketDir = DEFAULT_SOCKET_DIR, execFn = spawnSync14) {
   const resolvedDir = ensureSocketDir(socketDir);
-  const controlPath = join54(resolvedDir, "%C");
+  const controlPath = join55(resolvedDir, "%C");
   try {
     const result = execFn("ssh", ["-O", "check", "-o", `ControlPath=${controlPath}`, host], {
       encoding: "utf-8"
@@ -54089,7 +55598,7 @@ function checkControlSocket(host, socketDir = DEFAULT_SOCKET_DIR, execFn = spawn
 }
 function closeControlSocket(host, socketDir = DEFAULT_SOCKET_DIR, execFn = spawnSync14) {
   const resolvedDir = ensureSocketDir(socketDir);
-  const controlPath = join54(resolvedDir, "%C");
+  const controlPath = join55(resolvedDir, "%C");
   try {
     const result = execFn("ssh", ["-O", "stop", "-o", `ControlPath=${controlPath}`, host], {
       encoding: "utf-8"
@@ -54301,6 +55810,304 @@ function executeSshRun(params) {
 // plugins/kxm/src/cli/system.ts
 init_config();
 
+// plugins/kxm/src/config-editor.ts
+var import_yaml22 = __toESM(require_dist(), 1);
+import { existsSync as existsSync47, readFileSync as readFileSync42 } from "node:fs";
+init_config();
+var KXM_CONFIG_EDITOR_SOURCE = "kxm/config";
+var INTEGER_TEXT = /^(0|[1-9][0-9]*)$/;
+var DECIMAL_TEXT = /^(0|[1-9][0-9]*)(\.[0-9]{1,6})?$/;
+var TEXT_VALUE = /^[A-Za-z0-9@][A-Za-z0-9@._:/-]{0,127}$/;
+var SCREEN_CHOICES = ["agents", "tasks", "workflows", "plans", "inbox", "procs", "spend"];
+var SECTIONS = [
+  {
+    id: "user",
+    title: "User",
+    order: 10,
+    fields: [
+      { id: "user-theme", label: "Theme", keyPath: "user.theme", spec: { kind: "enum", choices: ["dark", "light", "minimal"] } },
+      { id: "user-token-budget", label: "Token budget", keyPath: "user.tokenBudget", spec: { kind: "number", integer: true, min: 1, max: 2e6 } }
+    ]
+  },
+  {
+    id: "defaults",
+    title: "Defaults",
+    order: 20,
+    fields: [
+      { id: "defaults-workflow", label: "Workflow", keyPath: "defaults.workflow", spec: { kind: "text" } },
+      { id: "defaults-harness", label: "Harness", keyPath: "defaults.harness", spec: { kind: "text" } }
+    ]
+  },
+  {
+    id: "dash",
+    title: "Dashboard",
+    order: 30,
+    fields: [
+      { id: "dash-screen", label: "Default screen", keyPath: "dash.defaultScreen", spec: { kind: "enum", choices: SCREEN_CHOICES } },
+      { id: "dash-refresh", label: "Refresh interval", keyPath: "dash.refreshIntervalMs", spec: { kind: "number", integer: true, min: 250, max: 36e5 } },
+      { id: "dash-auto-open", label: "Auto-open", keyPath: "dash.autoOpen", spec: { kind: "enum", choices: ["true", "false"] } }
+    ]
+  },
+  {
+    id: "sync",
+    title: "Sync",
+    order: 40,
+    fields: [
+      { id: "sync-tracker", label: "Default tracker", keyPath: "sync.defaultTracker", spec: { kind: "enum", choices: ["github", "jira", "none"] } }
+    ]
+  },
+  {
+    id: "hub",
+    title: "Hub",
+    order: 50,
+    fields: [
+      {
+        id: "hub-auto-start",
+        label: "Auto-start",
+        keyPath: "hub.autoStart",
+        spec: { kind: "enum", choices: ["background", "off"] },
+        note: "Hub URLs and key references stay out of this panel."
+      }
+    ]
+  },
+  {
+    id: "improvement",
+    title: "Improvement",
+    order: 60,
+    fields: [
+      { id: "improvement-policy", label: "Promotion policy", keyPath: "improvement.promotionPolicy", spec: { kind: "enum", choices: ["manual_pr", "critic_quorum", "auto_threshold"] } },
+      { id: "improvement-half-life", label: "Telemetry half-life", keyPath: "improvement.telemetryHalfLifeDays", spec: { kind: "number", integer: false, min: 1e-6, max: 3650 } },
+      { id: "improvement-min-runs", label: "Minimum runs", keyPath: "improvement.autoThreshold.minRuns", spec: { kind: "number", integer: true, min: 1, max: 1e6 } },
+      { id: "improvement-min-pass-rate", label: "Minimum pass rate", keyPath: "improvement.autoThreshold.minPassRate", spec: { kind: "number", integer: false, min: 0, max: 1 } },
+      { id: "improvement-min-cost-savings", label: "Minimum cost savings", keyPath: "improvement.autoThreshold.minCostSavings", spec: { kind: "number", integer: false, min: 0, max: 1e6 } }
+    ]
+  },
+  {
+    id: "routing",
+    title: "Routing",
+    order: 70,
+    fields: [
+      {
+        id: "routing-shadow",
+        label: "Shadow execution",
+        keyPath: "routing.shadowExecution.enabled",
+        spec: { kind: "enum", choices: ["true", "false"] },
+        note: "Strategy, fallback, and context limits stay in role and route files."
+      },
+      { id: "routing-sample-rate", label: "Sample rate", keyPath: "routing.shadowExecution.sampleRate", spec: { kind: "number", integer: false, min: 0, max: 1 } },
+      { id: "routing-breaker-mode", label: "Breaker mode", keyPath: "routing.circuitBreaker.mode", spec: { kind: "enum", choices: ["soft_demotion", "quarantine"] } },
+      { id: "routing-failure-threshold", label: "Failure threshold", keyPath: "routing.circuitBreaker.failureThreshold", spec: { kind: "number", integer: true, min: 1, max: 1e4 } },
+      { id: "routing-window-seconds", label: "Window seconds", keyPath: "routing.circuitBreaker.windowSeconds", spec: { kind: "number", integer: true, min: 1, max: 31536e3 } },
+      { id: "routing-cooldown-seconds", label: "Cooldown seconds", keyPath: "routing.circuitBreaker.cooldownSeconds", spec: { kind: "number", integer: true, min: 0, max: 31536e3 } },
+      { id: "routing-penalty", label: "Penalty multiplier", keyPath: "routing.circuitBreaker.penaltyMultiplier", spec: { kind: "number", integer: false, min: 1e-6, max: 1e3 } }
+    ]
+  },
+  {
+    id: "telemetry",
+    title: "Telemetry",
+    order: 80,
+    fields: [
+      { id: "telemetry-federated", label: "Federated", keyPath: "telemetry.federated", spec: { kind: "enum", choices: ["true", "false"] } },
+      { id: "telemetry-anonymize", label: "Anonymize", keyPath: "telemetry.anonymize", spec: { kind: "enum", choices: ["true", "false"] } }
+    ]
+  }
+];
+var KxmConfigEditorError = class extends Error {
+  code = "config_edit_refused";
+  constructor(message) {
+    super(message);
+    this.name = "KxmConfigEditorError";
+  }
+};
+function createKxmConfigEditorContribution(target) {
+  return {
+    source: KXM_CONFIG_EDITOR_SOURCE,
+    republishAfterWrite: true,
+    listSections: () => listConfigEditorSections(target),
+    handlers: {
+      [KXM_TUI_SET_ACTION]: (input) => {
+        writeConfigEditorValue(target, input.sectionId, input.fieldId, input.value);
+      },
+      [KXM_TUI_CLEAR_ACTION]: (input) => {
+        clearConfigEditorValue(target, input.sectionId, input.fieldId);
+      }
+    },
+    describeError: (error) => error instanceof Error && error.message ? error.message : "config edit failed"
+  };
+}
+function scopeFile(target) {
+  return kxmConfigFileForScope(target.cwd, target.scope, target.userConfigDir);
+}
+function scopePhrase(scope) {
+  return scope === "project" ? "the project file .kxm/config.yaml" : "the user file config.yaml";
+}
+function listConfigEditorSections(target) {
+  const config = loadKxmConfig(target.cwd, {
+    ...target.userConfigDir === void 0 ? {} : { userConfigDir: target.userConfigDir },
+    layers: target.scope === "user" ? "user" : "all"
+  });
+  const owned = readScopeDocument(scopeFile(target));
+  const where = scopePhrase(target.scope);
+  return SECTIONS.map((section) => {
+    const fields = section.fields.map((field) => publishField(field, config, owned, where));
+    const diagnosis = fields.find((field) => field.statusText)?.statusText;
+    return {
+      source: KXM_CONFIG_EDITOR_SOURCE,
+      id: section.id,
+      title: section.title,
+      order: section.order,
+      detail: `kxm.config.v1 \xB7 ${target.scope} scope. Re-read from disk after each write.`,
+      ...diagnosis === void 0 ? {} : { notice: diagnosis, noticeLevel: "error" },
+      fields
+    };
+  });
+}
+function publishField(field, config, owned, where) {
+  const effective = getKxmConfigValue(config, field.keyPath);
+  const stored = ownValue(owned, field.keyPath);
+  const shown = displayScalar(effective);
+  const inherited = !stored.present;
+  const diagnosis = storedDiagnosis(field, stored, effective);
+  const detail = [
+    `Writes ${where}.`,
+    inherited ? "Inherited." : "Set in this scope.",
+    "Clear removes only this override.",
+    field.note ?? "",
+    diagnosis ?? ""
+  ].filter((part) => part.length > 0).join(" ");
+  const choices = field.spec.kind === "enum" ? field.spec.choices.map((choice) => ({ id: choice, label: choice })) : void 0;
+  return {
+    id: field.id,
+    label: field.label,
+    kind: field.spec.kind === "enum" ? "enum" : "text",
+    keyPath: field.keyPath,
+    detail,
+    status: "ready",
+    ...shown === void 0 ? {} : { value: shown },
+    ...choices === void 0 ? {} : { choices },
+    ...diagnosis === void 0 ? {} : { statusText: diagnosis }
+  };
+}
+function displayScalar(value) {
+  if (typeof value === "string" && value.length > 0) return value;
+  if (typeof value === "boolean") return value ? "true" : "false";
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return void 0;
+}
+function isBooleanEnum(spec) {
+  return spec.kind === "enum" && spec.choices.length === 2 && spec.choices.every((choice) => choice === "true" || choice === "false");
+}
+function storedTypeMatches(field, value) {
+  if (field.spec.kind === "number") {
+    return typeof value === "number" && Number.isFinite(value) && (!field.spec.integer || Number.isInteger(value));
+  }
+  if (isBooleanEnum(field.spec)) return typeof value === "boolean";
+  return typeof value === "string";
+}
+function storedDiagnosis(field, stored, effective) {
+  if (!stored.present) return void 0;
+  if (!storedTypeMatches(field, stored.value)) return "stored type does not match this field";
+  if (field.spec.kind === "enum" && !isBooleanEnum(field.spec) && !field.spec.choices.includes(stored.value)) {
+    return "stored value is not a supported scalar";
+  }
+  if (field.spec.kind === "number") {
+    const value = stored.value;
+    if (value < field.spec.min || value > field.spec.max) return "stored value is not a supported scalar";
+  }
+  if (stored.value !== effective) return "stored value is not a supported scalar";
+  return void 0;
+}
+function writeConfigEditorValue(target, sectionId, fieldId, raw) {
+  const field = requireField(sectionId, fieldId);
+  const value = parseEditorValue(field, raw);
+  setKxmConfigValue(target.cwd, field.keyPath, value, {
+    scope: target.scope,
+    ...target.userConfigDir === void 0 ? {} : { userConfigDir: target.userConfigDir }
+  });
+}
+function clearConfigEditorValue(target, sectionId, fieldId) {
+  const field = requireField(sectionId, fieldId);
+  deleteKxmConfigValue(target.cwd, field.keyPath, {
+    scope: target.scope,
+    ...target.userConfigDir === void 0 ? {} : { userConfigDir: target.userConfigDir }
+  });
+}
+function requireField(sectionId, fieldId) {
+  const section = SECTIONS.find((item) => item.id === sectionId);
+  const field = section?.fields.find((item) => item.id === fieldId);
+  if (!field) throw new KxmConfigEditorError("unknown configuration field");
+  return field;
+}
+function parseEditorValue(field, raw) {
+  if (raw === void 0) throw new KxmConfigEditorError("a value is required");
+  if (raw.length === 0 || raw.length > 128 || /[\u0000-\u001f\u007f]/u.test(raw)) {
+    throw new KxmConfigEditorError("value must be a single bounded line");
+  }
+  if (field.spec.kind === "enum") {
+    if (!field.spec.choices.includes(raw)) throw new KxmConfigEditorError("value is not a supported choice");
+    if (isBooleanEnum(field.spec)) return raw === "true";
+    return raw;
+  }
+  if (field.spec.kind === "text") {
+    if (!TEXT_VALUE.test(raw)) throw new KxmConfigEditorError("value must be a single bounded line");
+    return raw;
+  }
+  if (!(field.spec.integer ? INTEGER_TEXT : DECIMAL_TEXT).test(raw)) {
+    throw new KxmConfigEditorError("value must be a finite number in range");
+  }
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed) || field.spec.integer && !Number.isInteger(parsed) || parsed < field.spec.min || parsed > field.spec.max) {
+    throw new KxmConfigEditorError("value must be a finite number in range");
+  }
+  return parsed;
+}
+function readScopeDocument(file) {
+  if (!existsSync47(file)) return void 0;
+  const parsed = (0, import_yaml22.parse)(readFileSync42(file, "utf8"));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new KxmConfigEditorError(`config file ${file} must be a mapping`);
+  }
+  return parsed;
+}
+function ownValue(root, keyPath) {
+  if (!root) return { present: false, value: void 0 };
+  let cursor2 = root;
+  for (const part of keyPath.split(".")) {
+    if (!cursor2 || typeof cursor2 !== "object" || Array.isArray(cursor2)) return { present: false, value: void 0 };
+    const record = cursor2;
+    if (!Object.prototype.hasOwnProperty.call(record, part)) return { present: false, value: void 0 };
+    cursor2 = record[part];
+  }
+  return { present: true, value: cursor2 };
+}
+var EDITOR_HELP = [
+  "\u2191\u2193 move \xB7 enter edits \xB7 x clears this scope's override \xB7 q quits",
+  "Writes are checked, saved, then re-read. A refused edit leaves the file unchanged."
+];
+var FRAME_NOW_MS = Date.UTC(2026, 9, 11);
+async function runKxmConfigEditor(input) {
+  const registry = createKxmTuiRegistry();
+  try {
+    registry.register(createKxmConfigEditorContribution(input.target));
+    registry.getSections();
+    const failed2 = registry.getIssues()[0];
+    if (failed2) throw new KxmConfigEditorError(failed2.message);
+    const interactive = input.isTty && !input.dryRun;
+    return await runKxmTuiPanel({
+      registry,
+      title: "KXM configuration",
+      breadcrumb: `kxm.config.v1 \xB7 ${input.target.scope} scope`,
+      helpLines: EDITOR_HELP,
+      stdout: input.stdout,
+      isTty: interactive,
+      ...interactive ? {} : { theme: createPlainKxmTuiTheme() },
+      now: () => FRAME_NOW_MS
+    });
+  } finally {
+    registry.dispose();
+  }
+}
+
 // plugins/kxm/src/autocomplete.ts
 var TOP_LEVEL_COMMANDS = [
   "init",
@@ -54354,7 +56161,7 @@ var SUBCOMMANDS = {
   memory: ["brief", "note", "sync"],
   routing: ["report", "benchmark"],
   hub: ["view", "start", "stop", "bind", "unbind"],
-  config: ["get", "set", "list"],
+  config: ["get", "set", "edit", "list"],
   goal: ["create", "list", "get"],
   task: ["create", "list", "get", "run", "sync"],
   studio: ["layout", "serve"],
@@ -54476,7 +56283,7 @@ _kxm() {
           _arguments '1:shell:(bash zsh fish)'
           ;;
         config)
-          _arguments '1:action:(get set list)'
+          _arguments '1:action:(get set edit list)'
           ;;
         runs)
           _arguments '1:subcommand:(status cancel list)'
@@ -54520,7 +56327,7 @@ complete -c kxm -n "__fish_seen_subcommand_from completion" -a "bash zsh fish"
 complete -c kxm -n "__fish_seen_subcommand_from dash" -l screen -a "agents tasks workflows plans inbox procs spend"
 
 # Config subcommand
-complete -c kxm -n "__fish_seen_subcommand_from config" -a "get set list"
+complete -c kxm -n "__fish_seen_subcommand_from config" -a "get set edit list"
 
 # Runs subcommand
 complete -c kxm -n "__fish_seen_subcommand_from runs" -a "status cancel list"
@@ -54540,9 +56347,9 @@ complete -c kxm -n "__fish_seen_subcommand_from goal" -a "create list get"
 }
 
 // plugins/kxm/src/completion-install.ts
-import { existsSync as existsSync46, mkdirSync as mkdirSync33, readFileSync as readFileSync41, writeFileSync as writeFileSync28 } from "node:fs";
+import { existsSync as existsSync48, mkdirSync as mkdirSync33, readFileSync as readFileSync43, writeFileSync as writeFileSync28 } from "node:fs";
 import { homedir as homedir9 } from "node:os";
-import { basename as basename10, delimiter, dirname as dirname24, isAbsolute as isAbsolute11, join as join55, resolve as resolve32 } from "node:path";
+import { basename as basename10, delimiter, dirname as dirname24, isAbsolute as isAbsolute12, join as join56, resolve as resolve32 } from "node:path";
 var COMPLETION_MARKER = "# kxm completion";
 var PATH_MARKER = "# kxm path";
 function detectShell(env = process.env, platform = process.platform) {
@@ -54564,25 +56371,25 @@ function completionScriptPath(shell, options = {}) {
   const env = options.env ?? process.env;
   const explicit = options.configDir ?? env.KXM_USER_CONFIG_DIR?.trim();
   const base = explicit && explicit.length > 0 ? resolve32(explicit) : resolve32(effectiveHome(options), ".config", "kxm");
-  return join55(base, "completions", `kxm.${shell}`);
+  return join56(base, "completions", `kxm.${shell}`);
 }
 function bashRcCandidate(options) {
   const home = effectiveHome(options);
-  const candidates = [join55(home, ".bashrc"), join55(home, ".bash_profile")];
-  const existing = candidates.find((candidate) => existsSync46(candidate));
+  const candidates = [join56(home, ".bashrc"), join56(home, ".bash_profile")];
+  const existing = candidates.find((candidate) => existsSync48(candidate));
   return existing ?? candidates[0];
 }
 function zshRcCandidate(options) {
   const env = options.env ?? process.env;
   const home = effectiveHome(options);
-  if (env.ZDOTDIR?.trim()) return join55(resolve32(env.ZDOTDIR.trim()), ".zshrc");
-  return join55(home, ".zshrc");
+  if (env.ZDOTDIR?.trim()) return join56(resolve32(env.ZDOTDIR.trim()), ".zshrc");
+  return join56(home, ".zshrc");
 }
 function fishCompletionTarget(shell, options) {
   const env = options.env ?? process.env;
   const home = effectiveHome(options);
-  if (env.XDG_CONFIG_HOME?.trim()) return join55(resolve32(env.XDG_CONFIG_HOME.trim()), "fish", "completions", "kxm.fish");
-  return join55(home, ".config", "fish", "completions", "kxm.fish");
+  if (env.XDG_CONFIG_HOME?.trim()) return join56(resolve32(env.XDG_CONFIG_HOME.trim()), "fish", "completions", "kxm.fish");
+  return join56(home, ".config", "fish", "completions", "kxm.fish");
 }
 function completionRcTarget(shell, options = {}) {
   if (shell === "fish") {
@@ -54614,13 +56421,13 @@ function installShellCompletion(shellInput, options = {}) {
   const scriptPath = completionScriptPath(shell, options);
   const { rcFile } = completionRcTarget(shell, options);
   const script = generateShellCompletion(shell);
-  const existingScript = existsSync46(scriptPath);
-  const existingScriptMatches = existingScript && readFileSync41(scriptPath, "utf8") === script;
+  const existingScript = existsSync48(scriptPath);
+  const existingScriptMatches = existingScript && readFileSync43(scriptPath, "utf8") === script;
   let rcModified = false;
   let alreadyInstalled = false;
   if (shell === "fish") {
     const fishTarget = fishCompletionTarget(shell, options);
-    const fishInstalled = existsSync46(fishTarget) && readFileSync41(fishTarget, "utf8") === script;
+    const fishInstalled = existsSync48(fishTarget) && readFileSync43(fishTarget, "utf8") === script;
     alreadyInstalled = fishInstalled;
     if (!options.dryRun && (!fishInstalled || options.overwrite)) {
       mkdirSync33(resolve32(fishTarget, ".."), { recursive: true });
@@ -54637,7 +56444,7 @@ function installShellCompletion(shellInput, options = {}) {
   }
   if (rcFile) {
     const line = sourceLine(shell, scriptPath);
-    const rcContent = existsSync46(rcFile) ? readFileSync41(rcFile, "utf8") : "";
+    const rcContent = existsSync48(rcFile) ? readFileSync43(rcFile, "utf8") : "";
     alreadyInstalled = rcContent.includes(line) || rcContent.includes(`${COMPLETION_MARKER}`);
   }
   if (!options.dryRun) {
@@ -54653,7 +56460,7 @@ ${marker}
 ${line}
 `;
       mkdirSync33(resolve32(rcFile, ".."), { recursive: true });
-      writeFileSync28(rcFile, (existsSync46(rcFile) ? readFileSync41(rcFile, "utf8") : "") + stanza, { encoding: "utf8" });
+      writeFileSync28(rcFile, (existsSync48(rcFile) ? readFileSync43(rcFile, "utf8") : "") + stanza, { encoding: "utf8" });
       rcModified = true;
     }
   }
@@ -54668,15 +56475,15 @@ ${line}
 }
 function kxmBinDir(env = process.env) {
   const argv1 = env.KXM_ENTRY ?? process.argv[1];
-  if (argv1 && isAbsolute11(argv1)) {
+  if (argv1 && isAbsolute12(argv1)) {
     const dir = dirname24(argv1);
-    if (existsSync46(join55(dir, process.platform === "win32" ? "kxm.cmd" : "kxm"))) return dir;
+    if (existsSync48(join56(dir, process.platform === "win32" ? "kxm.cmd" : "kxm"))) return dir;
   }
   const pathEnv = env.PATH ?? "";
   for (const part of pathEnv.split(delimiter)) {
     if (!part) continue;
     const candidate = resolve32(part, process.platform === "win32" ? "kxm.cmd" : "kxm");
-    if (existsSync46(candidate)) return resolve32(part);
+    if (existsSync48(candidate)) return resolve32(part);
   }
   return void 0;
 }
@@ -54694,7 +56501,7 @@ function installPathEntry(shellInput, options = {}) {
   }
   const { rcFile } = completionRcTarget(shell, options);
   const line = pathLine(binDir);
-  const rcContent = existsSync46(rcFile ?? "") ? readFileSync41(rcFile, "utf8") : "";
+  const rcContent = existsSync48(rcFile ?? "") ? readFileSync43(rcFile, "utf8") : "";
   const alreadyInstalled = rcContent.includes(binDir) || (options.env?.PATH ?? process.env.PATH ?? "").split(delimiter).includes(binDir);
   if (!options.dryRun && rcFile && !alreadyInstalled) {
     mkdirSync33(dirname24(rcFile), { recursive: true });
@@ -54707,10 +56514,10 @@ ${line}
 }
 
 // plugins/kxm/src/init-guide-setup.ts
-var import_yaml21 = __toESM(require_dist(), 1);
+var import_yaml23 = __toESM(require_dist(), 1);
 init_routes();
-import { existsSync as existsSync47, mkdirSync as mkdirSync34, writeFileSync as writeFileSync29 } from "node:fs";
-import { dirname as dirname25, join as join56 } from "node:path";
+import { existsSync as existsSync49, mkdirSync as mkdirSync34, writeFileSync as writeFileSync29 } from "node:fs";
+import { dirname as dirname25, join as join57 } from "node:path";
 var ADMITTED_GUIDE_BINDINGS = Object.freeze({
   "anthropic/claude-fable-5.1": { harness: "claude", provider: "anthropic", model: "fable" },
   "anthropic/fable": { harness: "claude", provider: "anthropic", model: "fable" },
@@ -55141,8 +56948,8 @@ function renderGuideSetupFiles(projectRoot, plan) {
     const piMatch = binding.harness === "pi" && guidePiNoteMatches(binding);
     if (binding.harness === "pi" && !piMatch) {
       files.push({
-        path: join56(projectRoot, ".kxm", "agents", `${role}.yaml`),
-        content: (0, import_yaml21.stringify)(agentDocument(role, stage))
+        path: join57(projectRoot, ".kxm", "agents", `${role}.yaml`),
+        content: (0, import_yaml23.stringify)(agentDocument(role, stage))
       });
       continue;
     }
@@ -55159,23 +56966,23 @@ function renderGuideSetupFiles(projectRoot, plan) {
       modelDocument.origin = { source: GUIDE_PI_EVIDENCE_SOURCE, sha256: GUIDE_PI_EVIDENCE_SHA256 };
       if (!evidenceQueued) {
         files.push({
-          path: join56(projectRoot, GUIDE_PI_EVIDENCE_SOURCE),
+          path: join57(projectRoot, GUIDE_PI_EVIDENCE_SOURCE),
           content: GUIDE_PI_EVIDENCE_NOTE
         });
         evidenceQueued = true;
       }
     }
     files.push({
-      path: join56(projectRoot, ".kxm", "agents", `${role}.yaml`),
-      content: (0, import_yaml21.stringify)(agentDocument(role, stage))
+      path: join57(projectRoot, ".kxm", "agents", `${role}.yaml`),
+      content: (0, import_yaml23.stringify)(agentDocument(role, stage))
     });
     files.push({
-      path: join56(projectRoot, ".kxm", "models", `${routeId2}.yaml`),
-      content: (0, import_yaml21.stringify)(modelDocument)
+      path: join57(projectRoot, ".kxm", "models", `${routeId2}.yaml`),
+      content: (0, import_yaml23.stringify)(modelDocument)
     });
     files.push({
-      path: join56(projectRoot, ".kxm", "roles", `${role}.yaml`),
-      content: (0, import_yaml21.stringify)({
+      path: join57(projectRoot, ".kxm", "roles", `${role}.yaml`),
+      content: (0, import_yaml23.stringify)({
         schema: "kxm.role.v2",
         id: role,
         purpose: writer ? "writer" : "experiment",
@@ -55187,8 +56994,8 @@ function renderGuideSetupFiles(projectRoot, plan) {
   }
   for (const workflow of plan.workflows) {
     files.push({
-      path: join56(projectRoot, ".kxm", "workflows", `${workflow.slug}.yaml`),
-      content: (0, import_yaml21.stringify)(workflowDocument(workflow))
+      path: join57(projectRoot, ".kxm", "workflows", `${workflow.slug}.yaml`),
+      content: (0, import_yaml23.stringify)(workflowDocument(workflow))
     });
   }
   return files;
@@ -55204,16 +57011,16 @@ function mergeGuideRouteAdmission(projectRoot, plan) {
   }
   if (added.length === 0) return added;
   policy.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const path4 = join56(projectRoot, ".kxm", "routes.yaml");
+  const path4 = join57(projectRoot, ".kxm", "routes.yaml");
   mkdirSync34(dirname25(path4), { recursive: true });
-  writeFileSync29(path4, (0, import_yaml21.stringify)(policy), "utf8");
+  writeFileSync29(path4, (0, import_yaml23.stringify)(policy), "utf8");
   return added;
 }
 function writeGuideSetupFiles(files) {
   const written = [];
   const existed = [];
   for (const file of files) {
-    if (existsSync47(file.path)) {
+    if (existsSync49(file.path)) {
       existed.push(file.path);
       continue;
     }
@@ -55284,7 +57091,7 @@ function applyKxmPackageUpdate(runtime, notice) {
       detail: `release v${notice.latest} has no sha256 digest for ${name}; refusing to install`
     };
   }
-  const releaseDir = mkdtempSync3(join57(tmpdir3(), "kxm-pkg-update-"));
+  const releaseDir = mkdtempSync3(join58(tmpdir3(), "kxm-pkg-update-"));
   try {
     const downloader = notice.source === "github" && !ghReleaseDownloadAvailable(runtime.env) ? "curl" : "gh";
     const planned = planKxmPackageUpdate(notice.source, notice.latest, releaseDir, notice.asset, downloader, notice.localRoot);
@@ -55294,7 +57101,7 @@ function applyKxmPackageUpdate(runtime, notice) {
     for (const step of planned) {
       if (step.kind === "verify") {
         if (!verifyReleaseAssetDigest(step.path, step.sha256)) {
-          const actual = existsSync48(step.path) ? createHash19("sha256").update(readFileSync42(step.path)).digest("hex") : "missing";
+          const actual = existsSync50(step.path) ? createHash19("sha256").update(readFileSync44(step.path)).digest("hex") : "missing";
           return {
             ok: false,
             error: "release_digest_mismatch",
@@ -55622,12 +57429,12 @@ async function cmdValidate(runtime, fileFlag) {
   }
   const selectedFile = explicitFile || configuredFile;
   const file = selectedFile ? resolve33(runtime.cwd, selectedFile) : void 0;
-  if (file && !existsSync48(file)) {
+  if (file && !existsSync50(file)) {
     printWorker(runtime, worker, { ok: false, command: "validate", error: "file_not_found", file }, `workflow file not found: ${file}`);
     return 1;
   }
   try {
-    const raw = file ? readFileSync42(file, "utf8") : inline;
+    const raw = file ? readFileSync44(file, "utf8") : inline;
     if (explicitFile && file && !raw.trimStart().startsWith("[")) {
       const value = parseRestrictedYaml2(raw, file);
       const issues = new KxmSchemaRegistry().validate("workflow", value, file);
@@ -55722,7 +57529,7 @@ async function cmdImprove(runtime, options = {}) {
     print(runtime.io, runtime.json, { ok: false, command: "improve", error: "config_invalid", detail: message }, `config_invalid: ${message}`);
     return 1;
   }
-  const candidatesDir = options.outDir ? resolve33(runtime.cwd, options.outDir) : join57(root, ".kxm", "candidates");
+  const candidatesDir = options.outDir ? resolve33(runtime.cwd, options.outDir) : join58(root, ".kxm", "candidates");
   const report2 = buildImprovementReport(loaded2.records, {
     candidatesDir,
     projectRoot: root,
@@ -55732,7 +57539,7 @@ async function cmdImprove(runtime, options = {}) {
     halfLifeDays: config.improvement.telemetryHalfLifeDays,
     routeSwitches: loaded2.routeSwitches
   });
-  const reportDir = join57(runtime.dirs.assets, "improvements");
+  const reportDir = join58(runtime.dirs.assets, "improvements");
   const reportPath = writeImprovementReport(reportDir, report2, runtime.dryRun);
   const text = [
     "Sources:",
@@ -55802,6 +57609,37 @@ async function cmdConfigSet(runtime, key, value, options) {
     return 1;
   }
 }
+async function cmdConfigEdit(runtime, options, isTty = Boolean(process.stdin.isTTY && process.stdout.isTTY)) {
+  const scope = options.scope;
+  if (scope !== "project" && scope !== "user") {
+    const detail = "config edit requires --scope project or --scope user";
+    print(runtime.io, runtime.json, { ok: false, command: "config edit", error: "config_edit_unsupported", detail }, detail);
+    return 2;
+  }
+  if (runtime.json) {
+    const detail = "config edit does not print machine-readable output";
+    print(runtime.io, runtime.json, { ok: false, command: "config edit", error: "config_edit_unsupported", detail }, detail);
+    return 2;
+  }
+  try {
+    const userConfigDir = userConfigDirForEnv(runtime.env);
+    return await runKxmConfigEditor({
+      target: {
+        cwd: runtime.cwd,
+        scope,
+        ...userConfigDir === void 0 ? {} : { userConfigDir }
+      },
+      stdout: (text) => runtime.io.stdout(text),
+      isTty,
+      dryRun: runtime.dryRun
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    runtime.io.stderr(`config edit failed: ${message}
+`);
+    return 1;
+  }
+}
 async function cmdConfigList(runtime) {
   try {
     const config = loadKxmConfig(runtime.cwd);
@@ -55876,9 +57714,9 @@ async function maybeOfferCompletionInstall(runtime) {
   if (!pathNeeded) {
     const scriptPath = completionScriptPath(shell, { env: runtime.env, configDir: runtime.env.KXM_USER_CONFIG_DIR });
     const { rcFile } = completionRcTarget(shell, { env: runtime.env });
-    if (rcFile && existsSync48(rcFile)) {
+    if (rcFile && existsSync50(rcFile)) {
       try {
-        if (readFileSync42(rcFile, "utf8").includes(scriptPath)) return;
+        if (readFileSync44(rcFile, "utf8").includes(scriptPath)) return;
       } catch {
       }
     }
@@ -56043,7 +57881,7 @@ async function cmdRoutingReport(runtime, options) {
   let catalog;
   if (includeEquivalentListCost) {
     try {
-      const pricesPath = options.prices ? resolve33(runtime.cwd, options.prices) : join57(runtime.dirs.workspace, "prices.yaml");
+      const pricesPath = options.prices ? resolve33(runtime.cwd, options.prices) : join58(runtime.dirs.workspace, "prices.yaml");
       catalog = loadPriceCatalog(pricesPath);
     } catch {
     }
@@ -56253,6 +58091,7 @@ var DRY_RUN_COMMANDS = /* @__PURE__ */ new Set([
   "hub unbind",
   "config get",
   "config set",
+  "config edit",
   "config list",
   "goal create",
   "goal list",
@@ -56659,7 +58498,7 @@ function createProgram(ctx, result, argv) {
   addGlobalOptions(harnessCmd.command("list").description("Show installed harnesses, auth, and native updaters")).action(bind(cmdHarnessList));
   const pluginCmd = addGlobalOptions(program2.command("plugin").description("Install or manage KXM harness plugins"));
   pluginCmd.helpCommand("help", "Show plugin help");
-  addGlobalOptions(pluginCmd.command("install", { isDefault: true }).description("Install the KXM plugin into discovered or specified harnesses")).option("--all", "Install plugin for all discovered harnesses (default)").option("--claude", "Install plugin for Claude Code").option("--omp", "Install plugin for Oh My Pi (OMP)").option("--pi", "Install plugin for Pi").action(async function pluginInstallAction(options) {
+  addGlobalOptions(pluginCmd.command("install", { isDefault: true }).description("Install the KXM plugin into discovered or specified harnesses")).option("--all", "Install plugin for all discovered harnesses (default)").option("--claude", "Install plugin for Claude Code").option("--omp", "Install plugin for Oh My Pi (OMP)").option("--pi", "Install plugin for Pi").option("--status-band", "Configure OMP's focused status band with live subscription usage").action(async function pluginInstallAction(options) {
     result.code = await cmdPluginInstall(runtimeFrom(ctx, this), options);
   });
   const authCmd = addGlobalOptions(program2.command("auth").description("Manage credentials, tokens, and authorization"));
@@ -56825,7 +58664,7 @@ function createProgram(ctx, result, argv) {
   });
   const gate = addGlobalOptions(program2.command("gate").description("Validate definitions and operate evidence gates"));
   gate.helpCommand("help", "Show gate help");
-  addGlobalOptions(gate.command("validate").description("Parse workflow definitions without printing secrets")).option("--file <path>", "Workflow definition file").action(async function validateAction(options) {
+  addGlobalOptions(gate.command("validate").description("Parse workflow definitions without printing secrets")).option("--file <path>", "Workflow definition file").action(async function validateAction2(options) {
     result.code = await cmdValidate(runtimeFrom(ctx, this), options.file);
   });
   addGlobalOptions(gate.command("artifacts-exist").description("Verify a non-empty file under workspace assets")).requiredOption("--path <file>", "Artifact file under workspace assets").action(async function artifactsExistAction(options) {
@@ -56953,6 +58792,9 @@ function createProgram(ctx, result, argv) {
   addGlobalOptions(configCmd.command("set <key> <value>").description("Set a configuration value")).option("--scope <scope>", "Configuration scope: user or project (default: project)", "project").action(async function configSetAction(key, value, options) {
     result.code = await cmdConfigSet(runtimeFrom(ctx, this), key, value, options);
   });
+  addGlobalOptions(configCmd.command("edit").description("Edit supported non-secret settings in the terminal panel")).option("--scope <scope>", "Write scope: project or user").action(async function configEditAction(options) {
+    result.code = await cmdConfigEdit(runtimeFrom(ctx, this), options);
+  });
   addGlobalOptions(configCmd.command("list", { isDefault: true }).description("List resolved configuration values")).action(async function configListAction() {
     result.code = await cmdConfigList(runtimeFrom(ctx, this));
   });