@kontextmind/kxm 0.7.120 → 0.7.121

package/plugins/kxm/dist/mcp-server.js

@@ -17313,7 +17313,7 @@ function sessionTokenFixHint(policy) {
 }
 
 // plugins/kxm/src/mcp-server.ts
-var VERSION = "0.7.120";
+var VERSION = "0.7.121";
 var CONFIGURE_PLUGIN = "/plugin configure kxm@kxm";
 var inbox = /* @__PURE__ */ new Map();
 var notifiedInbox = /* @__PURE__ */ new Set();

package/plugins/kxm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-plugin",
-  "version": "0.7.120",
+  "version": "0.7.121",
   "private": true,
   "type": "module",
   "engines": {

package/plugins/kxm/skills/kxm/SKILL.md

@@ -20,7 +20,7 @@ writers, or replace `.kxm/roster.yaml` trusted policy.
 | Delegate to or answer another agent | `kxm-peer` | `peer` (`peer await` is capped at 60 seconds) |
 | Work inside a durable workflow run, gates, signed callbacks | `kxm-workflow` | `workflow`, `gate` |
 | Role definitions, role hosts, model rosters | `kxm-definitions` | `role` |
-| Create, drive, inspect, or cancel a run, or use a worktree lane | `kxm-runs` | `run`, `runs`, `lane` |
+| Create, drive, inspect, or cancel a run, use a worktree lane, or land a branch | `kxm-runs` | `run`, `runs`, `lane`, `land` |
 | What we know or decided, recall, context footprint, Git memory | `kxm-context-memory` | `context`, `memory`, `explain` |
 | Turn a repeated practice into a governed skill | `kxm-skill-lifecycle` | `skills` |
 | What KXM learned, repeated asks, recorded route spend | `kxm-routing-improve` | `routing`, `improve` |

package/plugins/kxm/skills/kxm-runs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: kxm-runs
-description: Create, drive, and inspect local KXM runs, and manage worktree lanes. kxm runs drive with --simulated executes a run model-free and settles it with a verified receipt. Use when asked to start a workflow run, check its status, read its receipt, cancel it, smoke-test a workflow, or create a lane.
+description: Create, drive, and inspect local KXM runs, manage worktree lanes, and land a branch. kxm runs drive with --simulated executes a run model-free and settles it with a verified receipt. Use when asked to start a workflow run, check its status, read its receipt, cancel it, smoke-test a workflow, create a lane, or land the current branch.
 ---
 
 # KXM runs
@@ -26,6 +26,7 @@ create, or logs verbs under `runs`.
 | `kxm lane status <unit>` | One lane plus its last run status, or unknown when the supervisor is not answering | `--json` |
 | `kxm lane drop <unit>` | Remove the worktree and the record. The branch is not deleted | `--force`, `--json` |
 | `kxm lane run <unit>` | Create the lane if needed, start a run from a brief, and drive it | `--brief <file>` (required), `--workflow <id>`, `--base <ref>`, `--wait`, `--timeout-ms <n>`, `--json` |
+| `kxm land` | Verify, regenerate docs, push, open or reuse a pull request, rebase, unblock, squash-merge, watch the release, and note a milestone | `--pr <n>`, `--stage <name>`, `--body-file <path>`, `--json`, `--dry-run` |
 
 The run record and its events keep only the prompt's hash, but the full
 prompt text is kept in a local `run-events.db.run-prompts.json` file (mode
@@ -65,6 +66,21 @@ file. `kxm run --lane <unit>` and `kxm runs status|drive|receipt|cancel --lane`
 discover the project from the lane worktree. `kxm lane run <unit> --brief <file>`
 creates the lane when it is missing, starts the run, and drives it.
 
+`kxm land` lands the current branch. With no `--stage` it runs these stages in
+order: `verify`, `docs`, `push`, `pr`, `rebase`, `unblock`, `merge`,
+`release`, `milestone`. `verify` runs `npm run verify` on a clean tree and is
+not replaced by the later stages. `docs` regenerates the roadmap when
+`plans/kxm-roadmap/update-dashboard.mjs` is present and commits only those
+generated pages. `push` publishes the branch. `pr` reuses the open pull
+request or creates one from `--body-file`. `rebase` rebases onto
+`origin/main` for at most five rounds, resolving only the dist rebuild, the
+CHANGELOG Unreleased union, and the tracker "Landed in this tree" union.
+`unblock` reruns one failed check and reports a required review. `merge`
+squash-merges. `release` waits for the tag and the npm publish. `milestone`
+reports `deep_review_required` when a phase flips to done or the body contains
+a `Milestone:` line, and does not run the review. `--dry-run` prints each
+stage's plan and does not mutate.
+
 ## Refusals
 
 - `run_workflow_unknown`: the workflow ID is not a project workflow. Run only

package/plugins/kxm/src/cli/land.ts

@@ -0,0 +1,48 @@
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { discoverKxmProjectRoot } from "../project-config.ts";
+import { findKxmRepoRoot } from "../repo-root.ts";
+import { print, type Runtime } from "./types.ts";
+
+export interface LandOptions {
+  pr?: string;
+  stage?: string;
+  bodyFile?: string;
+}
+
+function childEnv(): NodeJS.ProcessEnv {
+  const env: NodeJS.ProcessEnv = {};
+  for (const [name, value] of Object.entries(process.env)) {
+    if (value === undefined) continue;
+    if (name.toUpperCase().startsWith("GIT_")) continue;
+    env[name] = value;
+  }
+  return env;
+}
+
+function refuse(runtime: Runtime, error: string, text: string): number {
+  print(runtime.io, runtime.json, { ok: false, command: "land", error }, text);
+  return 1;
+}
+
+/** Spawn scripts/pr-land.mjs and stream its JSON lines. The exit code is the script's. */
+export function cmdLand(runtime: Runtime, options: LandOptions = {}): Promise<number> {
+  const root = discoverKxmProjectRoot(runtime.cwd);
+  if (!root) {
+    return Promise.resolve(refuse(runtime, "project_required", "land requires a KXM project (run kxm init first)"));
+  }
+  const script = join(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 = spawn(process.execPath, args, { cwd: root, env: childEnv(), windowsHide: true });
+    child.stdout.on("data", (chunk: Buffer) => runtime.io.stdout(chunk.toString("utf8")));
+    child.stderr.on("data", (chunk: Buffer) => runtime.io.stderr(chunk.toString("utf8")));
+    child.once("error", () => resolveExit(1));
+    child.once("close", (code) => resolveExit(code ?? 1));
+  });
+}

package/plugins/kxm/src/cli.ts

@@ -131,6 +131,8 @@ import {
   cmdLaneStatus,
 } from "./cli/lanes.ts";
 
+import { cmdLand } from "./cli/land.ts";
+
 import {
   cmdStatus,
   cmdDash,
@@ -197,6 +199,7 @@ const USAGE_ERROR_CODES = new Set([
 const DRY_RUN_COMMANDS: ReadonlySet<string> = new Set([
   "init", "backup", "restore", "run", "explain", "suggest", "update", "dash", "completion", "completion install",
   "lane create", "lane list", "lane status", "lane drop", "lane run",
+  "land",
   "plugin install", "plugin",
   "runs status", "runs drive", "runs receipt", "runs cancel", "runs list",
   "tenant status", "models inventory-refresh", "harness list", "auth token",
@@ -485,6 +488,18 @@ function createProgram(ctx: CliContext, result: { code: number }): Command {
       });
     });
 
+  addGlobalOptions(program.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(this: Command, options: { pr?: string; stage?: string; bodyFile?: string }) {
+      result.code = await cmdLand(runtimeFrom(ctx, this), {
+        ...(options.pr !== undefined ? { pr: options.pr } : {}),
+        ...(options.stage !== undefined ? { stage: options.stage } : {}),
+        ...(options.bodyFile !== undefined ? { bodyFile: options.bodyFile } : {}),
+      });
+    });
+
   addGlobalOptions(program.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)")

package/plugins/kxm/src/mcp-server.ts

@@ -11,7 +11,7 @@ import { deliverInboxNotification } from "./inbox.ts";
 import type { HubEvent, MessageRecord } from "./protocol.ts";
 import { sessionTokenFixHint } from "./session-token-hint.ts";
 
-const VERSION = "0.7.120";
+const VERSION = "0.7.121";
 const CONFIGURE_PLUGIN = "/plugin configure kxm@kxm";
 const inbox = new Map<string, MessageRecord>();
 const notifiedInbox = new Set<string>();

package/scripts/pr-land.d.mts

@@ -0,0 +1,2 @@
+export function unionChangelogUnreleased(ours: string, theirs: string): string;
+export function unionLandedTracker(ours: string, theirs: string): string;