@kontextmind/kxm 0.7.120 → 0.7.121

package/plugins/kxm/dist/cli.js

@@ -18560,8 +18560,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(issue2("semantic", "write_repository_bound_invalid", file, `${stepId} maxWriteRepositories exceeds writable repository scope`));
     }
-    const join53 = objectValue(step.join);
-    const minimumPassed = join53 && typeof join53.minimumPassed === "number" ? join53.minimumPassed : void 0;
+    const join54 = objectValue(step.join);
+    const minimumPassed = join54 && typeof join54.minimumPassed === "number" ? join54.minimumPassed : void 0;
     if (minimumPassed !== void 0 && minimumPassed > maximum) issues.push(issue2("semantic", "join_impossible", file, `${stepId} minimumPassed exceeds assignment maximum`));
     const distinctBy = names(assignment?.distinctBy);
     if (distinctBy.length > 0) {
@@ -20863,7 +20863,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 join53 = compileJoin(step, id, sink);
+  const join54 = compileJoin(step, id, sink);
   const requiredEvidence = compileEvidence(step, id, sink);
   const transitions = compileTransitions(step, id, index, stepIndex, sink);
   const outcomes = Object.keys(transitions).sort(compareCodeUnits4);
@@ -20891,7 +20891,7 @@ function compileStep(step, index, stepIndex, requirePlanHash, sink) {
     transitions: orderedTransitions,
     requiresPlanHash: requirePlanHash.includes(id),
     assignments,
-    join: join53
+    join: join54
   };
   if (kind === "agent" || kind === "moa") {
     if (!agent) return void 0;
@@ -20941,15 +20941,15 @@ function compileAssignments(step, stepId, primaryAgentId, sink) {
   };
 }
 function compileJoin(step, stepId, sink) {
-  const join53 = objectValue2(step.join);
-  if (!join53) return { strategy: "all" };
-  const declared = stringValue2(join53.strategy);
+  const join54 = objectValue2(step.join);
+  if (!join54) return { strategy: "all" };
+  const declared = stringValue2(join54.strategy);
   const strategy = declared && JOIN_STRATEGIES.has(declared) ? declared : "all";
-  const minimumPassed = compileOptionalCount(join53.minimumPassed, `${stepId}.join.minimumPassed`, stepId, sink);
+  const minimumPassed = compileOptionalCount(join54.minimumPassed, `${stepId}.join.minimumPassed`, stepId, sink);
   const compiled = {
     strategy,
     ...minimumPassed !== void 0 ? { minimumPassed } : {},
-    ...typeof join53.cancelRemaining === "boolean" ? { cancelRemaining: join53.cancelRemaining } : {}
+    ...typeof join54.cancelRemaining === "boolean" ? { cancelRemaining: join54.cancelRemaining } : {}
   };
   return compiled;
 }
@@ -34136,7 +34136,7 @@ async function cmdWorkflowDefinitions(runtime, options) {
 }
 async function cmdWorkflowAdd(runtime, workflowId, options) {
   const scope = options.scope ?? "local";
-  const refuse2 = (error, message, code = 2) => {
+  const refuse3 = (error, message, code = 2) => {
     print(runtime.io, runtime.json, { ok: false, command: "workflow add", error, message }, `workflow add failed: ${message}`);
     return code;
   };
@@ -34144,12 +34144,12 @@ async function cmdWorkflowAdd(runtime, workflowId, options) {
     let content;
     if (options.template !== void 0) {
       if (options.file !== void 0 || options.pick !== void 0) {
-        return refuse2("workflow_add_conflict", "--template cannot be combined with --file or --pick");
+        return refuse3("workflow_add_conflict", "--template cannot be combined with --file or --pick");
       }
-      if (!workflowId) return refuse2("workflow_id_required", "usage: kxm workflow add <workflowId> --template <name>");
+      if (!workflowId) return refuse3("workflow_id_required", "usage: kxm workflow add <workflowId> --template <name>");
       const template = Object.hasOwn(WORKFLOW_TEMPLATES, options.template) ? WORKFLOW_TEMPLATES[options.template] : void 0;
       if (!template) {
-        return refuse2("workflow_template_unknown", `unknown template ${options.template}; choose ${Object.keys(WORKFLOW_TEMPLATES).join(", ")}`);
+        return refuse3("workflow_template_unknown", `unknown template ${options.template}; choose ${Object.keys(WORKFLOW_TEMPLATES).join(", ")}`);
       }
       content = { ...template, ...options.description !== void 0 ? { description: options.description } : {} };
     } else if (!workflowId || options.pick) {
@@ -34169,7 +34169,7 @@ async function cmdWorkflowAdd(runtime, workflowId, options) {
       }
       const picked = await resolvePickItem(runtime.io, `Select a workflow template to add (${scope})`, candidates, options.pick, runtime.env);
       if (!picked) {
-        return refuse2("workflow_id_required", "provide a workflowId or select an available workflow with --pick <id>", 1);
+        return refuse3("workflow_id_required", "provide a workflowId or select an available workflow with --pick <id>", 1);
       }
       workflowId ??= picked.id;
       if (options.file === void 0) {
@@ -34191,7 +34191,7 @@ async function cmdWorkflowAdd(runtime, workflowId, options) {
     if (scope === "local") {
       const projectRoot = discoverKxmProjectRoot(runtime.cwd);
       if (!projectRoot) {
-        return refuse2("project_not_found", "local workflows belong to a KXM project; run kxm init at the repository root, or pass --scope global");
+        return refuse3("project_not_found", "local workflows belong to a KXM project; run kxm init at the repository root, or pass --scope global");
       }
       const issues = kxmWorkflowWriteIssues(projectRoot, workflowId, document);
       if (issues.length > 0) {
@@ -34226,7 +34226,7 @@ ${issues.map((entry) => `  ${entry.file}: ${entry.code}: ${entry.message}`).join
     );
     return 0;
   } catch (err) {
-    return refuse2("workflow_add_failed", err instanceof Error ? err.message : String(err), 1);
+    return refuse3("workflow_add_failed", err instanceof Error ? err.message : String(err), 1);
   }
 }
 async function cmdWorkflowRemove(runtime, workflowId, options) {
@@ -37067,11 +37067,51 @@ async function cmdLaneRun(runtime, unit, options) {
   });
 }
 
+// plugins/kxm/src/cli/land.ts
+init_project_config();
+init_repo_root();
+init_types();
+import { spawn as spawn4 } from "node:child_process";
+import { join as join36 } from "node:path";
+function childEnv() {
+  const env = {};
+  for (const [name, value] of Object.entries(process.env)) {
+    if (value === void 0) continue;
+    if (name.toUpperCase().startsWith("GIT_")) continue;
+    env[name] = value;
+  }
+  return env;
+}
+function refuse2(runtime, error, text) {
+  print(runtime.io, runtime.json, { ok: false, command: "land", error }, text);
+  return 1;
+}
+function cmdLand(runtime, options = {}) {
+  const root = discoverKxmProjectRoot(runtime.cwd);
+  if (!root) {
+    return Promise.resolve(refuse2(runtime, "project_required", "land requires a KXM project (run kxm init first)"));
+  }
+  const script = join36(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);
+  if (options.bodyFile) args.push("--body-file", options.bodyFile);
+  if (runtime.json) args.push("--json");
+  if (runtime.dryRun) args.push("--dry-run");
+  return new Promise((resolveExit) => {
+    const child = spawn4(process.execPath, args, { cwd: root, env: childEnv(), windowsHide: true });
+    child.stdout.on("data", (chunk) => runtime.io.stdout(chunk.toString("utf8")));
+    child.stderr.on("data", (chunk) => runtime.io.stderr(chunk.toString("utf8")));
+    child.once("error", () => resolveExit(1));
+    child.once("close", (code) => resolveExit(code ?? 1));
+  });
+}
+
 // plugins/kxm/src/cli/hub.ts
 init_redact();
 import { randomUUID as randomUUID13 } from "node:crypto";
 import { existsSync as existsSync35, mkdirSync as mkdirSync28, readFileSync as readFileSync35, readdirSync as readdirSync12, rmSync as rmSync11, writeFileSync as writeFileSync25 } from "node:fs";
-import { join as join45, resolve as resolve28 } from "node:path";
+import { join as join46, resolve as resolve28 } from "node:path";
 init_hub_env();
 init_envelope();
 
@@ -42769,7 +42809,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 join36 } from "node:path";
+import { dirname as dirname19, join as join37 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var moduleRequire = createRequire2(import.meta.url);
 var TUI_PACKAGE_NAME = "@earendil-works/pi-tui";
@@ -42778,10 +42818,10 @@ function getNativeModuleCandidates(nativePath, options = {}) {
   const candidates = [];
   try {
     const packageEntry = (options.resolvePackage ?? moduleRequire.resolve)(TUI_PACKAGE_NAME);
-    candidates.push(join36(dirname19(packageEntry), "..", nativePath));
+    candidates.push(join37(dirname19(packageEntry), "..", nativePath));
   } catch {
   }
-  candidates.push(join36(moduleDir, "..", nativePath), join36(moduleDir, nativePath), join36(dirname19(options.execPath ?? process.execPath), nativePath));
+  candidates.push(join37(moduleDir, "..", nativePath), join37(moduleDir, nativePath), join37(dirname19(options.execPath ?? process.execPath), nativePath));
   return Array.from(new Set(candidates));
 }
 
@@ -45512,7 +45552,7 @@ var MAX_RENDER_WRITE_CHARS = 1024 * 1024;
 
 // plugins/kxm/src/tui.ts
 import { mkdirSync as mkdirSync25 } from "node:fs";
-import { join as join40, resolve as resolve27, dirname as dirname20 } from "node:path";
+import { join as join41, resolve as resolve27, dirname as dirname20 } from "node:path";
 import { spawnSync as spawnSync7 } from "node:child_process";
 
 // packages/core/tui/src/types/surface.ts
@@ -45658,7 +45698,7 @@ init_sqlite();
 init_telemetry();
 import { existsSync as existsSync30, readdirSync as readdirSync11, readFileSync as readFileSync30 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
-import { isAbsolute as isAbsolute9, join as join39, resolve as resolve26 } from "node:path";
+import { isAbsolute as isAbsolute9, join as join40, 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) {
@@ -45783,16 +45823,16 @@ function readOpenMessageMetadata(database, where = OPEN_MESSAGE_WHERE, params =
   return messages;
 }
 function resolveKxmSnapshotPaths(cwd, env = process.env) {
-  const stateDir = env.KXM_STATE_DIR?.trim() || join39(cwd, ".kxm", "state");
+  const stateDir = env.KXM_STATE_DIR?.trim() || join40(cwd, ".kxm", "state");
   const configured = env.KXM_DATA_PATH?.trim();
-  const dataPath = configured ? resolve26(cwd, configured) : join39(stateDir, "kxm.db");
+  const dataPath = configured ? resolve26(cwd, configured) : join40(stateDir, "kxm.db");
   return { dataPath, stateDir };
 }
 function resolveKxmStateRoot(stateDir, options) {
   if (options?.kxmStateRoot && existsSync30(options.kxmStateRoot)) {
     return resolve26(options.kxmStateRoot);
   }
-  if (existsSync30(join39(stateDir, "runtime", "registry.db")) || existsSync30(join39(stateDir, "runtime", "projects"))) {
+  if (existsSync30(join40(stateDir, "runtime", "registry.db")) || existsSync30(join40(stateDir, "runtime", "projects"))) {
     return stateDir;
   }
   const env = options?.env ?? process.env;
@@ -45803,13 +45843,13 @@ function resolveKxmStateRoot(stateDir, options) {
   let base;
   if (process.platform === "win32") {
     const localAppData = env.LOCALAPPDATA?.trim();
-    base = localAppData && isAbsolute9(localAppData) ? localAppData : join39(homedir6(), "AppData", "Local");
+    base = localAppData && isAbsolute9(localAppData) ? localAppData : join40(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 && isAbsolute9(xdgState) ? xdgState : join39(homedir6(), ".local", "state");
+    base = xdgState && isAbsolute9(xdgState) ? xdgState : join40(homedir6(), ".local", "state");
     base = resolve26(base, "kxm");
   }
   if (existsSync30(base)) return base;
@@ -45876,9 +45916,9 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
   let kxmRunTotal = 0;
   const kxmStateRoot = scope && !scope.runtimeProjectId ? void 0 : resolveKxmStateRoot(stateDir, options);
   if (kxmStateRoot) {
-    const runtimeDir = join39(kxmStateRoot, "runtime");
-    const registryDbPath = join39(runtimeDir, "registry.db");
-    const projectsDir = join39(runtimeDir, "projects");
+    const runtimeDir = join40(kxmStateRoot, "runtime");
+    const registryDbPath = join40(runtimeDir, "registry.db");
+    const projectsDir = join40(runtimeDir, "projects");
     const projectKeys = /* @__PURE__ */ new Set();
     if (existsSync30(registryDbPath)) {
       hasKxm = true;
@@ -45908,7 +45948,7 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
     }
     for (const key of projectKeys) {
       if (scope && !RUNTIME_PROJECT_KEY.test(key)) continue;
-      const eventDbPath = join39(projectsDir, key, "run-events.db");
+      const eventDbPath = join40(projectsDir, key, "run-events.db");
       if (existsSync30(eventDbPath)) {
         hasKxm = true;
         try {
@@ -45930,7 +45970,7 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
   if (existsSync30(stateDir)) {
     for (const file of readdirSync11(stateDir).filter((name) => name.endsWith(".pid"))) {
       try {
-        const record = JSON.parse(readFileSync30(join39(stateDir, file), "utf8"));
+        const record = JSON.parse(readFileSync30(join40(stateDir, file), "utf8"));
         pids.push({
           file,
           ...record.role ? { role: record.role } : {},
@@ -45969,7 +46009,7 @@ function loadLocalMeshSnapshot(dataPath, stateDir, options) {
   } else {
     source = "legacy";
   }
-  const telemetryFile = join39(stateDir, "telemetry.jsonl");
+  const telemetryFile = join40(stateDir, "telemetry.jsonl");
   const spend = existsSync30(telemetryFile) ? readRoutingRecords(telemetryFile) : [];
   return {
     source,
@@ -46104,7 +46144,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 = join40(".kxm", "worktrees", `run-${cleanRunId}-${desc}`);
+  const relativeWtPath = join41(".kxm", "worktrees", `run-${cleanRunId}-${desc}`);
   const absoluteWtPath = resolve27(repoRoot, relativeWtPath);
   const jumpCommand = `cd "${absoluteWtPath}"`;
   try {
@@ -46874,7 +46914,7 @@ async function runMeshTui(input) {
 import { spawnSync as spawnSync8 } from "node:child_process";
 import { randomUUID as randomUUID12 } from "node:crypto";
 import { existsSync as existsSync31, mkdirSync as mkdirSync26, readFileSync as readFileSync31, renameSync as renameSync8, writeFileSync as writeFileSync23 } from "node:fs";
-import { join as join41 } from "node:path";
+import { join as join42 } from "node:path";
 init_hub_binding();
 init_telemetry();
 var MAX_SESSION_BRIEF_TASKS = 5;
@@ -47033,7 +47073,7 @@ function buildSessionBrief(snapshot, current, hub, ship, updateLatest, cost, ses
   };
 }
 function readCachedSessionBrief(stateDir) {
-  const file = join41(stateDir, "session-brief.json");
+  const file = join42(stateDir, "session-brief.json");
   try {
     if (!existsSync31(file)) return void 0;
     const raw = readFileSync31(file, "utf8");
@@ -47052,7 +47092,7 @@ function readCachedSessionBrief(stateDir) {
 function writeCachedSessionBrief(stateDir, brief) {
   try {
     mkdirSync26(stateDir, { recursive: true, mode: 448 });
-    const file = join41(stateDir, "session-brief.json");
+    const file = join42(stateDir, "session-brief.json");
     const tmp = `${file}.tmp.${randomUUID12().slice(0, 8)}`;
     writeFileSync23(tmp, JSON.stringify(brief, null, 2), { encoding: "utf8", mode: 384 });
     renameSync8(tmp, file);
@@ -47061,7 +47101,7 @@ function writeCachedSessionBrief(stateDir, brief) {
 }
 function estimateSessionCost(stateDir) {
   try {
-    const telemetryFile = join41(stateDir, "telemetry.jsonl");
+    const telemetryFile = join42(stateDir, "telemetry.jsonl");
     if (!existsSync31(telemetryFile)) return void 0;
     const records = readRoutingRecords(telemetryFile);
     if (records.length === 0) return void 0;
@@ -47235,10 +47275,10 @@ init_hub_binding();
 // plugins/kxm/src/kxm-install-kind.ts
 init_bindings();
 import { existsSync as existsSync32, readFileSync as readFileSync32 } from "node:fs";
-import { dirname as dirname21, join as join42 } from "node:path";
+import { dirname as dirname21, join as join43 } from "node:path";
 function packageIsKxm(root) {
   try {
-    const pkg = JSON.parse(readFileSync32(join42(root, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync32(join43(root, "package.json"), "utf8"));
     return pkg.name === "@kontextmind/kxm";
   } catch {
     return false;
@@ -47287,12 +47327,12 @@ function report(kind, root) {
   return { kind, root, instruction: installKindInstruction(kind, root) };
 }
 function classifyInstallRoot(probe) {
-  const piGitRoot = join42(probe.homeDir, ".pi", "agent", "git");
+  const piGitRoot = join43(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() || join42(probe.homeDir, ".claude");
-  const pluginsRoot = join42(claudeHome, "plugins");
+  const claudeHome = probe.env.CLAUDE_CONFIG_DIR?.trim() || join43(probe.homeDir, ".claude");
+  const pluginsRoot = join43(claudeHome, "plugins");
   if (isUnder(probe.moduleDir, pluginsRoot, probe.platform)) return report("claude-marketplace", probe.moduleDir);
-  const hasGit = existsSync32(join42(probe.repoRoot, ".git"));
+  const hasGit = existsSync32(join43(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);
@@ -47317,10 +47357,10 @@ init_bindings();
 // plugins/kxm/src/kxm-update-config.ts
 var import_yaml16 = __toESM(require_dist(), 1);
 import { existsSync as existsSync33, readFileSync as readFileSync33 } from "node:fs";
-import { join as join43 } from "node:path";
+import { join as join44 } from "node:path";
 init_bindings();
 function loadKxmUpdateConfig(env = process.env) {
-  const path4 = join43(kxmUserStateRoot({ env }), "update.yaml");
+  const path4 = join44(kxmUserStateRoot({ env }), "update.yaml");
   if (!existsSync33(path4)) return { schema: KXM_UPDATE_SCHEMA, auto: false, source: "github" };
   let parsed;
   try {
@@ -47353,7 +47393,7 @@ function loadKxmUpdateConfig(env = process.env) {
 init_protocol();
 init_envelope();
 import { existsSync as existsSync34, mkdirSync as mkdirSync27, readFileSync as readFileSync34, writeFileSync as writeFileSync24 } from "node:fs";
-import { join as join44 } from "node:path";
+import { join as join45 } from "node:path";
 var SESSION_SCHEMA = "kxm.session.v1";
 var SessionConfigError = class extends Error {
   code = "session_config_invalid";
@@ -47363,12 +47403,12 @@ var SessionConfigError = class extends Error {
   }
 };
 function workflowAssetDirs(assetsDir, workflowId) {
-  const root = join44(assetsDir, "workflows", workflowId);
-  return [root, join44(root, "inputs"), join44(root, "outputs"), join44(root, "generated")];
+  const root = join45(assetsDir, "workflows", workflowId);
+  return [root, join45(root, "inputs"), join45(root, "outputs"), join45(root, "generated")];
 }
 function sessionAssetDirs(assetsDir, sessionId) {
-  const root = join44(assetsDir, "sessions", sessionId);
-  return [root, join44(root, "inputs"), join44(root, "outputs")];
+  const root = join45(assetsDir, "sessions", sessionId);
+  return [root, join45(root, "inputs"), join45(root, "outputs")];
 }
 function rosterNames(configDir) {
   return [...loadRosterMap(configDir).values()].map((row) => String(row.name));
@@ -47418,7 +47458,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 = join44(configDir, file);
+    const path4 = join45(configDir, file);
     for (const row of loadRoster(path4, key)) {
       const name = String(row.name).trim();
       const lowered = name.toLowerCase();
@@ -47460,7 +47500,7 @@ function loadRoster(path4, key) {
   });
 }
 function createSession(input) {
-  const assetDir = input.mode === "workflow" && input.workflowId ? join44("assets", "workflows", input.workflowId) : join44("assets", "sessions", input.id);
+  const assetDir = input.mode === "workflow" && input.workflowId ? join45("assets", "workflows", input.workflowId) : join45("assets", "sessions", input.id);
   return {
     schema: SESSION_SCHEMA,
     id: input.id,
@@ -47473,8 +47513,8 @@ function createSession(input) {
   };
 }
 function writeSession(assetsDir, session, dryRun = false) {
-  const dir = join44(assetsDir, "sessions", session.id);
-  const path4 = join44(dir, "session.json");
+  const dir = join45(assetsDir, "sessions", session.id);
+  const path4 = join45(dir, "session.json");
   if (!dryRun) {
     mkdirSync27(dir, { recursive: true });
     writeFileSync24(path4, `${JSON.stringify(session, null, 2)}
@@ -47530,9 +47570,9 @@ function moduleInstallRoot() {
   }
 }
 function warnIgnoredProjectUpdateYaml(runtime) {
-  const projectFile = join45(runtime.dirs.workspace, "update.yaml");
+  const projectFile = join46(runtime.dirs.workspace, "update.yaml");
   if (!existsSync35(projectFile)) return;
-  const userFile = join45(kxmUserStateRoot({ env: runtime.env }), "update.yaml");
+  const userFile = join46(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}
 `);
 }
@@ -47580,7 +47620,7 @@ async function cmdDash(runtime, options = {}) {
     return 2;
   }
   const screen = requested;
-  const dataPath = resolve28(runtime.dirs.workdir, runtime.env.KXM_DATA_PATH?.trim() || join45(runtime.dirs.state, "kxm.db"));
+  const dataPath = resolve28(runtime.dirs.workdir, runtime.env.KXM_DATA_PATH?.trim() || join46(runtime.dirs.state, "kxm.db"));
   if (runtime.dryRun) {
     print(runtime.io, runtime.json, {
       ok: true,
@@ -47626,7 +47666,7 @@ async function cmdHub(runtime) {
         config = loadKxmUpdateConfig(runtime.env);
       } catch (error) {
         if (error instanceof KxmUpdateConfigError) {
-          const yamlPath = join45(kxmUserStateRoot({ env: runtime.env }), "update.yaml");
+          const yamlPath = join46(kxmUserStateRoot({ env: runtime.env }), "update.yaml");
           runtime.io.stderr(`kxm: ${error.message}; update check skipped; fix or remove ${yamlPath}
 `);
         } else {
@@ -47828,7 +47868,7 @@ async function cmdStop(runtime, waitMsFlag) {
   const orphans = [];
   for (const file of pids) {
     try {
-      const record = JSON.parse(readFileSync35(join45(runtime.dirs.state, file), "utf8"));
+      const record = JSON.parse(readFileSync35(join46(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) {
@@ -47848,7 +47888,7 @@ async function cmdStop(runtime, waitMsFlag) {
         ignored.push(file);
         continue;
       }
-      writeFileSync25(join45(runtime.dirs.state, record.controlFile), `${JSON.stringify({ startedAt: record.startedAt, ...record.generation ? { generation: record.generation } : {}, requestedAt: (/* @__PURE__ */ new Date()).toISOString() })}
+      writeFileSync25(join46(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 } : {} });
@@ -47866,7 +47906,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(readFileSync35(join45(runtime.dirs.state, file), "utf8"));
+        const current = JSON.parse(readFileSync35(join46(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);
@@ -47879,7 +47919,7 @@ async function cmdStop(runtime, waitMsFlag) {
   for (const file of orphans) {
     while (Date.now() <= deadlineOrphans) {
       try {
-        const current = JSON.parse(readFileSync35(join45(runtime.dirs.state, file), "utf8"));
+        const current = JSON.parse(readFileSync35(join46(runtime.dirs.state, file), "utf8"));
         if (!Number.isInteger(current.serverPid) || !processExists(current.serverPid)) break;
       } catch {
         break;
@@ -47887,14 +47927,14 @@ async function cmdStop(runtime, waitMsFlag) {
       await (runtime.io.sleep ?? ((ms) => new Promise((resolveSleep) => setTimeout(resolveSleep, ms))))(100);
     }
     try {
-      const current = JSON.parse(readFileSync35(join45(runtime.dirs.state, file), "utf8"));
+      const current = JSON.parse(readFileSync35(join46(runtime.dirs.state, file), "utf8"));
       if (Number.isInteger(current.serverPid) && processExists(current.serverPid)) {
         try {
           process.kill(current.serverPid, "SIGKILL");
         } catch {
         }
       }
-      rmSync11(join45(runtime.dirs.state, file), { force: true });
+      rmSync11(join46(runtime.dirs.state, file), { force: true });
     } catch {
     }
     stopped.add(file);
@@ -47909,7 +47949,7 @@ async function cmdSessionStatus(runtime) {
   const claims = [];
   for (const file of names3.filter((name) => name.endsWith(".pid"))) {
     try {
-      const record = JSON.parse(readFileSync35(join45(stateDir, file), "utf8"));
+      const record = JSON.parse(readFileSync35(join46(stateDir, file), "utf8"));
       claims.push({
         file,
         role: record.role,
@@ -47924,7 +47964,7 @@ async function cmdSessionStatus(runtime) {
   const recoveries = [];
   for (const file of names3.filter((name) => name.startsWith("worker-recovery-") && name.endsWith(".json"))) {
     try {
-      const envelope = JSON.parse(readFileSync35(join45(stateDir, file), "utf8"));
+      const envelope = JSON.parse(readFileSync35(join46(stateDir, file), "utf8"));
       recoveries.push({
         file,
         reason: envelope.reason,
@@ -48039,7 +48079,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() || join45(runtime.dirs.state, "kxm.db"));
+  const dataPath = resolve28(runtime.dirs.workdir, runtime.env.KXM_DATA_PATH?.trim() || join46(runtime.dirs.state, "kxm.db"));
   const env = {
     ...runtime.env,
     KXM_STATE_DIR: runtime.dirs.state,
@@ -48065,7 +48105,7 @@ async function cmdSessionBrief(runtime, options = {}) {
     writeCache: !runtime.dryRun
   });
   if (runtime.dryRun) {
-    if (!readCachedSessionBrief(runtime.dirs.state)) planned.push({ action: "write", target: join45(runtime.dirs.state, "session-brief.json") });
+    if (!readCachedSessionBrief(runtime.dirs.state)) planned.push({ action: "write", target: join46(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}`)
@@ -48151,7 +48191,7 @@ import { spawnSync as spawnSync10 } from "node:child_process";
 import { createHash as createHash17 } from "node:crypto";
 import { existsSync as existsSync42, mkdtempSync as mkdtempSync3, readFileSync as readFileSync40, rmSync as rmSync13 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { basename as basename11, extname as extname3, join as join51, resolve as resolve33 } from "node:path";
+import { basename as basename11, extname as extname3, join as join52, resolve as resolve33 } from "node:path";
 import { createInterface as createInterface3 } from "node:readline";
 
 // plugins/kxm/src/improve.ts
@@ -48160,7 +48200,7 @@ init_protocol();
 init_relevance();
 import { createHash as createHash16 } from "node:crypto";
 import { existsSync as existsSync36, mkdirSync as mkdirSync29, writeFileSync as writeFileSync26 } from "node:fs";
-import { join as join46, relative as relative7, resolve as resolve29 } from "node:path";
+import { join as join47, 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) {
@@ -48416,7 +48456,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) : join46(projectRoot, ".kxm", "candidates");
+  const candidatesDir = options.candidatesDir ? resolve29(options.candidatesDir) : join47(projectRoot, ".kxm", "candidates");
   const promotionPolicy = options.promotionPolicy ?? "manual_pr";
   const groups = groupRoutingRecords(records, options);
   const candidates = [];
@@ -48430,7 +48470,7 @@ function buildImprovementReport(records, options = {}) {
       group.workflowId
     );
     const diffFileName = `${group.candidateId}.diff`;
-    const diffFilePath = join46(candidatesDir, diffFileName);
+    const diffFilePath = join47(candidatesDir, diffFileName);
     const relDiffPath = relative7(projectRoot, diffFilePath).replace(/\\/g, "/");
     const candidate = {
       schema: CANDIDATE_SCHEMA,
@@ -48456,7 +48496,7 @@ function buildImprovementReport(records, options = {}) {
         mkdirSync29(candidatesDir, { recursive: true });
       }
       writeFileSync26(diffFilePath, diff, "utf8");
-      const jsonFilePath = join46(candidatesDir, `${group.candidateId}.json`);
+      const jsonFilePath = join47(candidatesDir, `${group.candidateId}.json`);
       writeFileSync26(jsonFilePath, JSON.stringify(candidate, null, 2) + "\n", "utf8");
     }
     candidates.push(candidate);
@@ -48485,7 +48525,7 @@ function buildImprovementReport(records, options = {}) {
 }
 function writeImprovementReport(improvementsDir, report2, dryRun = false) {
   const stamp = report2.createdAt.replace(/[:.]/g, "-");
-  const path4 = join46(improvementsDir, `${stamp}.json`);
+  const path4 = join47(improvementsDir, `${stamp}.json`);
   if (!dryRun) {
     mkdirSync29(improvementsDir, { recursive: true });
     writeFileSync26(path4, `${JSON.stringify(report2, null, 2)}
@@ -48714,7 +48754,7 @@ function loadRoutingSources(options) {
 var import_yaml17 = __toESM(require_dist(), 1);
 init_prices();
 import { existsSync as existsSync38, readFileSync as readFileSync37 } from "node:fs";
-import { join as join47 } from "node:path";
+import { join as join48 } from "node:path";
 var DEFAULT_MODES_CONFIG = Object.freeze({
   schema: "kxm.modes.v1",
   majorModes: {
@@ -48777,7 +48817,7 @@ function loadModesConfig(projectRoot) {
   if (!projectRoot) {
     return DEFAULT_MODES_CONFIG;
   }
-  const modesPath = join47(projectRoot, ".kxm", "modes.yaml");
+  const modesPath = join48(projectRoot, ".kxm", "modes.yaml");
   if (!existsSync38(modesPath)) {
     return DEFAULT_MODES_CONFIG;
   }
@@ -48868,7 +48908,7 @@ function calculatePromptFootprint(resolved, projectRoot = process.cwd(), catalog
     estimatedTokens: estimateTokens(baseSystemPromptChars)
   });
   for (const relPath of resolved.contextFiles) {
-    const fullPath = join47(projectRoot, relPath);
+    const fullPath = join48(projectRoot, relPath);
     let chars = 0;
     if (existsSync38(fullPath)) {
       try {
@@ -49007,7 +49047,7 @@ init_safety_integrity();
 import { spawnSync as spawnSync9 } from "node:child_process";
 import { existsSync as existsSync39, mkdirSync as mkdirSync30, readFileSync as readFileSync38, readdirSync as readdirSync13, rmSync as rmSync12, statSync as statSync5 } from "node:fs";
 import { homedir as homedir8 } from "node:os";
-import { join as join48, resolve as resolve31 } from "node:path";
+import { join as join49, 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";
@@ -49033,7 +49073,7 @@ function truncateSshOutput(raw) {
   return { text, truncated };
 }
 function parseSshConfig(configPath) {
-  const targetPath = configPath ?? join48(homedir8(), ".ssh", "config");
+  const targetPath = configPath ?? join49(homedir8(), ".ssh", "config");
   if (!existsSync39(targetPath)) {
     return [];
   }
@@ -49123,7 +49163,7 @@ function ensureSocketDir(socketDir = DEFAULT_SOCKET_DIR) {
 }
 function buildSshArgs(options) {
   const socketDir = ensureSocketDir(options.socketDir ?? DEFAULT_SOCKET_DIR);
-  const controlPath = join48(socketDir, "%C");
+  const controlPath = join49(socketDir, "%C");
   const persist = options.controlPersist ?? DEFAULT_CONTROL_PERSIST;
   const args = [
     "-o",
@@ -49148,7 +49188,7 @@ function buildSshArgs(options) {
 }
 function checkControlSocket(host, socketDir = DEFAULT_SOCKET_DIR, execFn = spawnSync9) {
   const resolvedDir = ensureSocketDir(socketDir);
-  const controlPath = join48(resolvedDir, "%C");
+  const controlPath = join49(resolvedDir, "%C");
   try {
     const result = execFn("ssh", ["-O", "check", "-o", `ControlPath=${controlPath}`, host], {
       encoding: "utf-8"
@@ -49160,7 +49200,7 @@ function checkControlSocket(host, socketDir = DEFAULT_SOCKET_DIR, execFn = spawn
 }
 function closeControlSocket(host, socketDir = DEFAULT_SOCKET_DIR, execFn = spawnSync9) {
   const resolvedDir = ensureSocketDir(socketDir);
-  const controlPath = join48(resolvedDir, "%C");
+  const controlPath = join49(resolvedDir, "%C");
   try {
     const result = execFn("ssh", ["-O", "stop", "-o", `ControlPath=${controlPath}`, host], {
       encoding: "utf-8"
@@ -49610,7 +49650,7 @@ complete -c kxm -n "__fish_seen_subcommand_from goal" -a "create list get"
 // plugins/kxm/src/completion-install.ts
 import { existsSync as existsSync40, mkdirSync as mkdirSync31, readFileSync as readFileSync39, writeFileSync as writeFileSync27 } from "node:fs";
 import { homedir as homedir9 } from "node:os";
-import { basename as basename10, delimiter, dirname as dirname24, isAbsolute as isAbsolute10, join as join49, resolve as resolve32 } from "node:path";
+import { basename as basename10, delimiter, dirname as dirname24, isAbsolute as isAbsolute10, join as join50, resolve as resolve32 } from "node:path";
 var COMPLETION_MARKER = "# kxm completion";
 var PATH_MARKER = "# kxm path";
 function detectShell(env = process.env, platform = process.platform) {
@@ -49632,25 +49672,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 join49(base, "completions", `kxm.${shell}`);
+  return join50(base, "completions", `kxm.${shell}`);
 }
 function bashRcCandidate(options) {
   const home = effectiveHome(options);
-  const candidates = [join49(home, ".bashrc"), join49(home, ".bash_profile")];
+  const candidates = [join50(home, ".bashrc"), join50(home, ".bash_profile")];
   const existing = candidates.find((candidate) => existsSync40(candidate));
   return existing ?? candidates[0];
 }
 function zshRcCandidate(options) {
   const env = options.env ?? process.env;
   const home = effectiveHome(options);
-  if (env.ZDOTDIR?.trim()) return join49(resolve32(env.ZDOTDIR.trim()), ".zshrc");
-  return join49(home, ".zshrc");
+  if (env.ZDOTDIR?.trim()) return join50(resolve32(env.ZDOTDIR.trim()), ".zshrc");
+  return join50(home, ".zshrc");
 }
 function fishCompletionTarget(shell, options) {
   const env = options.env ?? process.env;
   const home = effectiveHome(options);
-  if (env.XDG_CONFIG_HOME?.trim()) return join49(resolve32(env.XDG_CONFIG_HOME.trim()), "fish", "completions", "kxm.fish");
-  return join49(home, ".config", "fish", "completions", "kxm.fish");
+  if (env.XDG_CONFIG_HOME?.trim()) return join50(resolve32(env.XDG_CONFIG_HOME.trim()), "fish", "completions", "kxm.fish");
+  return join50(home, ".config", "fish", "completions", "kxm.fish");
 }
 function completionRcTarget(shell, options = {}) {
   if (shell === "fish") {
@@ -49738,7 +49778,7 @@ function kxmBinDir(env = process.env) {
   const argv1 = env.KXM_ENTRY ?? process.argv[1];
   if (argv1 && isAbsolute10(argv1)) {
     const dir = dirname24(argv1);
-    if (existsSync40(join49(dir, process.platform === "win32" ? "kxm.cmd" : "kxm"))) return dir;
+    if (existsSync40(join50(dir, process.platform === "win32" ? "kxm.cmd" : "kxm"))) return dir;
   }
   const pathEnv = env.PATH ?? "";
   for (const part of pathEnv.split(delimiter)) {
@@ -49778,7 +49818,7 @@ ${line}
 var import_yaml18 = __toESM(require_dist(), 1);
 init_routes();
 import { existsSync as existsSync41, mkdirSync as mkdirSync32, writeFileSync as writeFileSync28 } from "node:fs";
-import { dirname as dirname25, join as join50 } from "node:path";
+import { dirname as dirname25, join as join51 } 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" },
@@ -50169,13 +50209,13 @@ function renderGuideSetupFiles(projectRoot, plan) {
     const stage = roleStages.get(role);
     if (!stage) continue;
     files.push({
-      path: join50(projectRoot, ".kxm", "agents", `${role}.yaml`),
+      path: join51(projectRoot, ".kxm", "agents", `${role}.yaml`),
       content: (0, import_yaml18.stringify)(agentDocument(role, stage, binding))
     });
   }
   for (const workflow of plan.workflows) {
     files.push({
-      path: join50(projectRoot, ".kxm", "workflows", `${workflow.slug}.yaml`),
+      path: join51(projectRoot, ".kxm", "workflows", `${workflow.slug}.yaml`),
       content: (0, import_yaml18.stringify)(workflowDocument(workflow))
     });
   }
@@ -50192,7 +50232,7 @@ function mergeGuideRouteAdmission(projectRoot, plan) {
   }
   if (added.length === 0) return added;
   policy.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const path4 = join50(projectRoot, ".kxm", "routes.yaml");
+  const path4 = join51(projectRoot, ".kxm", "routes.yaml");
   mkdirSync32(dirname25(path4), { recursive: true });
   writeFileSync28(path4, (0, import_yaml18.stringify)(policy), "utf8");
   return added;
@@ -50272,7 +50312,7 @@ function applyKxmPackageUpdate(runtime, notice) {
       detail: `release v${notice.latest} has no sha256 digest for ${name}; refusing to install`
     };
   }
-  const releaseDir = mkdtempSync3(join51(tmpdir2(), "kxm-pkg-update-"));
+  const releaseDir = mkdtempSync3(join52(tmpdir2(), "kxm-pkg-update-"));
   try {
     const planned = planKxmPackageUpdate(notice.source, notice.latest, releaseDir, notice.asset);
     if (runtime.dryRun) {
@@ -50659,7 +50699,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) : join51(root, ".kxm", "candidates");
+  const candidatesDir = options.outDir ? resolve33(runtime.cwd, options.outDir) : join52(root, ".kxm", "candidates");
   const report2 = buildImprovementReport(loaded.records, {
     candidatesDir,
     projectRoot: root,
@@ -50668,7 +50708,7 @@ async function cmdImprove(runtime, options = {}) {
     autoThreshold: config.improvement.autoThreshold,
     halfLifeDays: config.improvement.telemetryHalfLifeDays
   });
-  const reportDir = join51(runtime.dirs.assets, "improvements");
+  const reportDir = join52(runtime.dirs.assets, "improvements");
   const reportPath = writeImprovementReport(reportDir, report2, runtime.dryRun);
   const text = [
     "Sources:",
@@ -50977,7 +51017,7 @@ async function cmdRoutingReport(runtime, options) {
   let catalog;
   if (includeEquivalentListCost) {
     try {
-      const pricesPath = options.prices ? resolve33(runtime.cwd, options.prices) : join51(runtime.dirs.workspace, "prices.yaml");
+      const pricesPath = options.prices ? resolve33(runtime.cwd, options.prices) : join52(runtime.dirs.workspace, "prices.yaml");
       catalog = loadPriceCatalog(pricesPath);
     } catch {
     }
@@ -51090,6 +51130,7 @@ var DRY_RUN_COMMANDS = /* @__PURE__ */ new Set([
   "lane status",
   "lane drop",
   "lane run",
+  "land",
   "plugin install",
   "plugin",
   "runs status",
@@ -51391,6 +51432,13 @@ function createProgram(ctx, result) {
       ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {}
     });
   });
+  addGlobalOptions(program2.command("land").description("Land the current branch: verify, regenerate docs, push, pull request, rebase, unblock, squash-merge, release, and milestone")).option("--pr <n>", "Existing pull request number").option("--stage <name>", "Run one stage: verify, docs, push, pr, rebase, unblock, merge, release, or milestone").option("--body-file <path>", "Pull request body file used when creating a pull request").action(async function landAction(options) {
+    result.code = await cmdLand(runtimeFrom(ctx, this), {
+      ...options.pr !== void 0 ? { pr: options.pr } : {},
+      ...options.stage !== void 0 ? { stage: options.stage } : {},
+      ...options.bodyFile !== void 0 ? { bodyFile: options.bodyFile } : {}
+    });
+  });
   addGlobalOptions(program2.command("run").description("Create a KXM run without executing steps; follow its prerequisites, then kxm runs drive <runId> --wait").argument("[workflow]", "Workflow id to run").argument("[prompt...]", "Run prompt (events keep its hash; the full text is kept in a local 0600 sidecar file)").option("--brief <file>", "Read the run prompt from a file instead of the positional prompt").option("--lane <unit>", "Discover the project from this lane's worktree").action(async function runAction(workflow2, promptParts, options) {
     result.code = await cmdKxmRunCli(runtimeFrom(ctx, this), workflow2, promptParts, options);
   }));