@kontextmind/kxm 0.7.39 → 0.7.43

package/plugins/kxm/src/tui.ts

@@ -19,6 +19,7 @@ import { mkdirSync } from "node:fs";
 import { join, resolve, dirname } from "node:path";
 import { spawnSync } from "node:child_process";
 import type { AgentRecord } from "./protocol.ts";
+import { createKxmTuiAnsiTheme, type KxmTuiTheme } from "@kontextmind/tui";
 import { slugifyBranchPart } from "./external-effects.ts";
 import {
   loadLocalMeshSnapshot,
@@ -295,33 +296,18 @@ function stageMark(status: string, theme: MeshTuiTheme): string {
   return theme.dim("[ ]");
 }
 
-type MeshTuiStyle = (text: string) => string;
-
-interface MeshTuiTheme {
-  accent: MeshTuiStyle;
-  dim: MeshTuiStyle;
-  error: MeshTuiStyle;
-  success: MeshTuiStyle;
-  warning: MeshTuiStyle;
-  headerBg: MeshTuiStyle;
-  panelBg: MeshTuiStyle;
-}
+/**
+ * The dashboard palette lives in `tui/theme.ts` so a config surface and the
+ * live screens cannot drift to different meanings for the same colour.
+ */
+type MeshTuiTheme = Pick<KxmTuiTheme, "accent" | "dim" | "error" | "success" | "warning" | "headerBg" | "panelBg">;
 
 function meshTuiTheme(color: boolean): MeshTuiTheme {
-  const ansi = (code: string): MeshTuiStyle => color ? (text) => `\u001b[${code}m${text}\u001b[0m` : (text) => text;
-  return {
-    accent: ansi("1;36"),
-    dim: ansi("2"),
-    error: ansi("1;31"),
-    success: ansi("1;32"),
-    warning: ansi("1;33"),
-    headerBg: ansi("1;97;44"),
-    panelBg: ansi("48;5;236"),
-  };
+  return createKxmTuiAnsiTheme(color);
 }
 
 function visibleAgents(snapshot: MeshTuiSnapshot): AgentRecord[] {
-  return snapshot.agents.filter((agent) => agent.model !== "kxm-tui");
+  return snapshot.agents.filter((agent) => agent.model !== "tui");
 }
 
 function panelMetric(snapshot: MeshTuiSnapshot, panel: MeshTuiPanel): string {
@@ -820,7 +806,7 @@ export async function runMeshTui(input: {
   let identity: { id: string; key: string } | undefined;
   let useOpsStream = true;
   let interactive: { tui: TUI; dashboard: KxmDashboard } | undefined;
-  const name = `kxm-tui-${process.pid}`;
+  const name = `tui-${process.pid}`;
   const view = defaultMeshTuiView(input.screen);
 
   const paint = (snapshot: MeshTuiSnapshot) => {
@@ -927,7 +913,7 @@ export async function runMeshTui(input: {
         name,
         purpose: "Read-only mesh observer TUI",
         project: input.project,
-        model: "kxm-tui",
+        model: "tui",
       }),
     });
     if (!registration.ok) throw new Error(`observer registration failed with HTTP ${registration.status}`);

package/schemas/{vnext/README.md → README.md}

@@ -1,7 +1,7 @@
-# KXM vNext schemas
+# KXM schemas
 
 These draft 2020-12 JSON Schemas validate parsed YAML configuration, bounded
-Runtime-local records, and JSON events/results for the planned vNext contract.
+Runtime-local records, and JSON events/results for the planned KXM contract.
 
 | Schema | Identity |
 |---|---|
@@ -29,7 +29,7 @@ Runtime-local records, and JSON events/results for the planned vNext contract.
 one validation layer; cross-file references, state-machine semantics,
 permission diffs, model diversity, path portability, and snapshot reproduction
 are deterministic semantic checks described in
-[`docs/vnext/validation.md`](../../docs/vnext/validation.md).
+[`docs/contracts/validation.md`](../../docs/contracts/validation.md).
 
 Unknown fields fail closed. A new field requires a reviewed schema revision;
 do not add generic metadata escape hatches to event or synchronization payloads.

package/schemas/{vnext/agent.schema.json → agent.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/agent.schema.json",
+  "$id": "https://schemas.kxm.dev/agent.schema.json",
   "title": "KXM agent definition",
   "description": "The filename determines the agent identity.",
   "type": "object",

package/schemas/{vnext/assignment-result.schema.json → assignment-result.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/assignment-result.schema.json",
+  "$id": "https://schemas.kxm.dev/assignment-result.schema.json",
   "title": "KXM structured assignment result",
   "type": "object",
   "required": [

package/schemas/{vnext/backup-manifest.schema.json → backup-manifest.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/backup-manifest.schema.json",
+  "$id": "https://schemas.kxm.dev/backup-manifest.schema.json",
   "title": "KXM SQLite stores backup manifest",
   "type": "object",
   "required": [

package/schemas/{vnext/candidate.schema.json → candidate.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/candidate.schema.json",
+  "$id": "https://schemas.kxm.dev/candidate.schema.json",
   "title": "KXM coded-repeat improvement candidate",
   "type": "object",
   "required": [

package/schemas/{vnext/common.schema.json → common.schema.json}

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/common.schema.json",
-  "title": "KXM vNext common definitions",
+  "$id": "https://schemas.kxm.dev/common.schema.json",
+  "title": "KXM common definitions",
   "$defs": {
     "identifier": {
       "type": "string",

package/schemas/{vnext/context-candidate.schema.json → context-candidate.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/context-candidate.schema.json",
+  "$id": "https://schemas.kxm.dev/context-candidate.schema.json",
   "title": "KXM evidence-linked improvement candidate",
   "type": "object",
   "required": [

package/schemas/{vnext/context-packet.schema.json → context-packet.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/context-packet.schema.json",
+  "$id": "https://schemas.kxm.dev/context-packet.schema.json",
   "title": "KXM formal context packet v2",
   "type": "object",
   "required": [

package/schemas/{vnext/delivery-manifest.schema.json → delivery-manifest.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/delivery-manifest.schema.json",
+  "$id": "https://schemas.kxm.dev/delivery-manifest.schema.json",
   "title": "KXM non-atomic multi-repository delivery manifest",
   "type": "object",
   "required": [

package/schemas/{vnext/drive-receipt.schema.json → drive-receipt.schema.json}

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/drive-receipt.schema.json",
-  "title": "KXM vNext drive session receipt",
+  "$id": "https://schemas.kxm.dev/drive-receipt.schema.json",
+  "title": "KXM drive session receipt",
   "type": "object",
   "required": [
     "schema",

package/schemas/{vnext/environment.schema.json → environment.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/environment.schema.json",
+  "$id": "https://schemas.kxm.dev/environment.schema.json",
   "title": "KXM portable environment overrides",
   "type": "object",
   "required": ["schema"],

package/schemas/{vnext/gate-registry.schema.json → gate-registry.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/gate-registry.schema.json",
+  "$id": "https://schemas.kxm.dev/gate-registry.schema.json",
   "title": "KXM gate registry",
   "type": "object",
   "required": [

package/schemas/{vnext/handoff-manifest.schema.json → handoff-manifest.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/handoff-manifest.schema.json",
+  "$id": "https://schemas.kxm.dev/handoff-manifest.schema.json",
   "title": "KXM structured handoff manifest v1",
   "type": "object",
   "required": [

package/schemas/{vnext/init-operation.schema.json → init-operation.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/init-operation.schema.json",
+  "$id": "https://schemas.kxm.dev/init-operation.schema.json",
   "title": "KXM Runtime-local initialization operation v1",
   "type": "object",
   "additionalProperties": false,

package/schemas/{vnext/local-repository-bindings.schema.json → local-repository-bindings.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/local-repository-bindings.schema.json",
+  "$id": "https://schemas.kxm.dev/local-repository-bindings.schema.json",
   "title": "KXM Runtime-local repository bindings",
   "type": "object",
   "required": ["schema", "projectId", "projectRoot", "repositories"],

package/schemas/{vnext/memory-record.schema.json → memory-record.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/memory-record.schema.json",
+  "$id": "https://schemas.kxm.dev/memory-record.schema.json",
   "title": "KXM harness-agnostic memory record",
   "type": "object",
   "required": [

package/schemas/{vnext/migration-decision.schema.json → migration-decision.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/migration-decision.schema.json",
+  "$id": "https://schemas.kxm.dev/migration-decision.schema.json",
   "title": "KXM reviewed legacy configuration migration decisions",
   "type": "object",
   "required": ["schema", "projectId", "projectName", "sourceDigest", "resolutions"],

package/schemas/{vnext/migration-plan.schema.json → migration-plan.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/migration-plan.schema.json",
+  "$id": "https://schemas.kxm.dev/migration-plan.schema.json",
   "title": "KXM legacy configuration migration plan",
   "type": "object",
   "required": [

package/schemas/{vnext/migration-receipt.schema.json → migration-receipt.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/migration-receipt.schema.json",
+  "$id": "https://schemas.kxm.dev/migration-receipt.schema.json",
   "title": "KXM verified legacy configuration migration receipt",
   "type": "object",
   "required": [

package/schemas/{vnext/model.schema.json → model.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/model.schema.json",
+  "$id": "https://schemas.kxm.dev/model.schema.json",
   "title": "KXM model profile",
   "description": "The filename determines the profile identity.",
   "type": "object",

package/schemas/{vnext/modes.schema.json → modes.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/modes.schema.json",
+  "$id": "https://schemas.kxm.dev/modes.schema.json",
   "title": "KXM Modes Configuration",
   "description": "Declarative major modes and domain modules for selective tool loading and context scoping",
   "type": "object",

package/schemas/{vnext/permission-diff.schema.json → permission-diff.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/permission-diff.schema.json",
+  "$id": "https://schemas.kxm.dev/permission-diff.schema.json",
   "title": "KXM permission-diff trust report",
   "description": "Structured, deterministic diff of authority-bearing fields between a trusted base bundle and a candidate bundle.",
   "type": "object",

package/schemas/policy-draft/README.md

@@ -3,10 +3,10 @@
 `kxm.model.v2` and `kxm.role.v2` here are **passive scaffolding**. They are not
 operator settings, live registry identities, or admission.
 
-- Live project models remain `kxm.model.v1` under `schemas/vnext/`.
+- Live project models remain `kxm.model.v1` under `schemas/`.
 - Live CLI roles remain `kxm.role.v1`.
 - Runner admission remains `.kxm/roster.yaml` via the trusted control Git loader.
-- This directory is not discovered as a vNext project resource.
+- This directory is not discovered as a KXM project resource.
 
 Pure validation lives in `plugins/kxm/src/policy-draft.mjs`
 (`validatePolicyDraft`). Callers must supply draft documents, evidence bytes,

package/schemas/{vnext/prices.schema.json → prices.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/prices.schema.json",
+  "$id": "https://schemas.kxm.dev/prices.schema.json",
   "title": "KXM price catalog",
   "type": "object",
   "required": [

package/schemas/{vnext/project.schema.json → project.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/project.schema.json",
+  "$id": "https://schemas.kxm.dev/project.schema.json",
   "title": "KXM project definition",
   "type": "object",
   "required": ["schema", "id", "name", "repositories"],

package/schemas/{vnext/repository.schema.json → repository.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/repository.schema.json",
+  "$id": "https://schemas.kxm.dev/repository.schema.json",
   "title": "KXM repository-scoped definition",
   "type": "object",
   "required": ["schema", "projectId", "repositoryId"],

package/schemas/{vnext/role.schema.json → role.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/role.schema.json",
+  "$id": "https://schemas.kxm.dev/role.schema.json",
   "title": "KXM role definition",
   "description": "The filename determines the role identity unless explicitly declared.",
   "type": "object",

package/schemas/{vnext/run-event.schema.json → run-event.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/run-event.schema.json",
+  "$id": "https://schemas.kxm.dev/run-event.schema.json",
   "title": "KXM local run event",
   "type": "object",
   "required": [

package/schemas/{vnext/session-brief.schema.json → session-brief.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/session-brief.schema.json",
+  "$id": "https://schemas.kxm.dev/session-brief.schema.json",
   "title": "KXM session brief",
   "type": "object",
   "required": [
@@ -28,7 +28,7 @@
     },
     "source": {
       "type": "string",
-      "enum": ["legacy", "vnext", "both"]
+      "enum": ["legacy", "runtime", "both"]
     },
     "hub": {
       "type": "object",

package/schemas/{vnext/sync-event.schema.json → sync-event.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/sync-event.schema.json",
+  "$id": "https://schemas.kxm.dev/sync-event.schema.json",
   "title": "KXM sync-safe run event",
   "type": "object",
   "required": [

package/schemas/{vnext/template-provenance.schema.json → template-provenance.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/template-provenance.schema.json",
+  "$id": "https://schemas.kxm.dev/template-provenance.schema.json",
   "title": "KXM managed-template provenance v1",
   "type": "object",
   "additionalProperties": false,

package/schemas/{vnext/workflow.schema.json → workflow.schema.json}

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/vnext/workflow.schema.json",
+  "$id": "https://schemas.kxm.dev/workflow.schema.json",
   "title": "KXM ordered workflow definition",
   "description": "The filename determines the workflow identity.",
   "type": "object",

package/scripts/build-package.mjs

@@ -0,0 +1,59 @@
+/**
+ * Build one workspace package to `dist/`.
+ *
+ * The repo bundles with esbuild everywhere — the CLI, the hub, the extension,
+ * and the MCP server — so a package builds with the same bundler and the same
+ * Node target. That keeps CI on one toolchain and makes a built package
+ * reproducible from the committed sources.
+ *
+ * Usage: node scripts/build-package.mjs packages/core/kxm-tui
+ */
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const REPOSITORY = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+import { build } from "esbuild";
+
+const EXTERNAL = Object.freeze([
+  "@earendil-works/pi-tui",
+  "@earendil-works/pi-coding-agent",
+  "@anthropic-ai/claude-agent-sdk",
+  "typebox",
+]);
+
+export async function buildPackage(projectDir, repository = REPOSITORY) {
+  const root = resolve(repository);
+  const project = resolve(root, projectDir);
+  await build({
+    absWorkingDir: root,
+    entryPoints: [resolve(project, "src/exports/index.ts")],
+    bundle: true,
+    platform: "node",
+    format: "esm",
+    target: "node22",
+    outfile: resolve(project, "dist/index.js"),
+    external: EXTERNAL,
+    sourcemap: false,
+  });
+  return resolve(project, "dist/index.js");
+}
+
+// A package script runs with its own directory as cwd, so accept a bare
+// "packages/..." path as well and resolve it against the repository.
+function normalizeProjectPath(value) {
+  return value.startsWith("packages/") || value.startsWith("plugins/")
+    ? resolve(REPOSITORY, value)
+    : resolve(value);
+}
+
+const invoked = process.argv[1] ? resolve(process.argv[1]) === fileURLToPath(import.meta.url) : false;
+if (invoked) {
+  const target = process.argv[2];
+  if (!target) {
+    process.stderr.write("usage: node scripts/build-package.mjs <project-dir>\n");
+    process.exitCode = 2;
+  } else {
+    const written = await buildPackage(normalizeProjectPath(target));
+    process.stdout.write(`built ${dirname(written).split("/").slice(-2).join("/")}/index.js\n`);
+  }
+}

package/scripts/build-runtime.mjs

@@ -1,8 +1,9 @@
 import { readFileSync, writeFileSync } from "node:fs";
 import { build } from "esbuild";
 
+
 await build({
-  entryPoints: ["plugins/kxm/src/cli.ts", "plugins/kxm/src/server.ts", "plugins/kxm/src/vnext-runtime-supervisor.ts"],
+  entryPoints: ["plugins/kxm/src/cli.ts", "plugins/kxm/src/server.ts", "plugins/kxm/src/runtime-supervisor.ts"],
   bundle: true,
   platform: "node",
   format: "esm",
@@ -39,7 +40,7 @@ const createRequire = "import { createRequire as __kxmCreateRequire } from 'node
 for (const bundlePath of [
   "plugins/kxm/dist/cli.js",
   "plugins/kxm/dist/server.js",
-  "plugins/kxm/dist/vnext-runtime-supervisor.js",
+  "plugins/kxm/dist/runtime-supervisor.js",
 ]) {
   const bundled = readFileSync(bundlePath, "utf8");
   if (!bundled.startsWith(shebang)) throw new Error(`runtime bundle is missing its executable shebang: ${bundlePath}`);

package/scripts/check-generated.mjs

@@ -10,11 +10,12 @@ export const STATIC_GENERATED_ARTIFACTS = Object.freeze([
   "plugins/kxm/dist/cli.js",
   "plugins/kxm/dist/server.js",
   "plugins/kxm/dist/mcp-server.js",
-  "plugins/kxm/dist/vnext-runtime-supervisor.js",
+  "plugins/kxm/dist/runtime-supervisor.js",
   "plugins/kxm/dist/core.js",
   "plugins/kxm/dist/runtime.js",
   "plugins/kxm/dist/client.js",
   "plugins/kxm/dist/extension.js",
+  "packages/core/tui/dist/index.js",
   "AGENTS.md",
   "CLAUDE.md",
   "GEMINI.md",

package/scripts/check-versions.mjs

@@ -1,4 +1,6 @@
 import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { workspaceManifestPaths } from "./package-surfaces.mjs";
 
 async function json(path) {
   return JSON.parse(await readFile(path, "utf8"));
@@ -23,6 +25,15 @@ const versions = new Map([
   ["MCP server", mcpVersion],
 ]);
 
+// Which directories count as packages is shared with scripts/kxm-bump-version.mjs
+// on purpose: the gate and the release writer must not disagree. Paths come
+// back POSIX-style, which is also how package-lock.json keys its `packages` map.
+for (const relativePath of workspaceManifestPaths(".")) {
+  const manifest = await json(join(relativePath, "package.json"));
+  versions.set(`${manifest.name} package`, manifest.version);
+  versions.set(`${manifest.name} lock entry`, lock.packages?.[relativePath]?.version);
+}
+
 const failures = [...versions].filter(([, version]) => version !== root.version);
 if (failures.length > 0) {
   for (const [name, version] of failures) {
@@ -30,5 +41,5 @@ if (failures.length > 0) {
   }
   process.exitCode = 1;
 } else {
-  process.stdout.write(`all package surfaces use version ${root.version}\n`);
+  process.stdout.write(`all package surfaces use version ${root.version} (${versions.size} checked)\n`);
 }