@kontextmind/kxm 0.7.39 → 0.7.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontextmind/kxm",
-  "version": "0.7.39",
+  "version": "0.7.43",
   "description": "KXM local-first multi-agent orchestration and operator dashboard",
   "type": "module",
   "author": "KontextMind",
@@ -32,14 +32,14 @@
     "example": "node --disable-warning=ExperimentalWarning --experimental-strip-types examples/roundtrip.ts",
     "build:mcp": "esbuild plugins/kxm/src/mcp-server.ts --bundle --platform=node --format=esm --target=node22 --alias:@modelcontextprotocol/sdk/server/index.js=./node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js --alias:@modelcontextprotocol/sdk/server/stdio.js=./node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js --alias:@modelcontextprotocol/sdk/types.js=./node_modules/@modelcontextprotocol/sdk/dist/esm/types.js --outfile=plugins/kxm/dist/mcp-server.js --banner:js=\"#!/usr/bin/env node\"",
     "build:runtime": "node scripts/build-runtime.mjs",
-    "build": "npm run build:mcp && npm run build:runtime",
+    "build": "npm run build:mcp && npm run build:runtime && npm run build:packages",
     "check:generated": "npm run build && node scripts/check-generated.mjs",
     "test:core": "npm run build && node --disable-warning=ExperimentalWarning --experimental-strip-types --test --test-concurrency=4 test/core/*.test.ts",
     "test:simulations": "npm run build && node --disable-warning=ExperimentalWarning --experimental-strip-types --test --test-concurrency=4 test/simulations/*.test.ts",
     "test:complete": "npm run build && node --disable-warning=ExperimentalWarning --experimental-strip-types --test --test-concurrency=4 test/core/*.test.ts test/simulations/*.test.ts",
-    "test": "npm run test:core",
-    "test:coverage:core": "npm run build && node --disable-warning=ExperimentalWarning --experimental-strip-types --test --test-concurrency=4 --experimental-test-coverage --test-coverage-lines=91 --test-coverage-branches=80 --test-coverage-functions=92 --test-coverage-include=plugins/kxm/src/**/*.ts --test-coverage-exclude=plugins/kxm/src/server.ts --test-coverage-exclude=plugins/kxm/src/mcp-server.ts --test-coverage-exclude=plugins/kxm/src/vnext-runtime-supervisor.ts test/core/*.test.ts",
-    "test:coverage:complete": "npm run build && node --disable-warning=ExperimentalWarning --experimental-strip-types --test --test-concurrency=4 --experimental-test-coverage --test-coverage-lines=93 --test-coverage-branches=80 --test-coverage-functions=93 --test-coverage-include=plugins/kxm/src/**/*.ts --test-coverage-exclude=plugins/kxm/src/server.ts --test-coverage-exclude=plugins/kxm/src/mcp-server.ts --test-coverage-exclude=plugins/kxm/src/vnext-runtime-supervisor.ts test/core/*.test.ts test/simulations/*.test.ts",
+    "test": "npm run build && node --disable-warning=ExperimentalWarning --experimental-strip-types --test --test-concurrency=4 test/core/*.test.ts packages/core/*/tests/unit/*.test.ts",
+    "test:coverage:core": "npm run build && node --disable-warning=ExperimentalWarning --experimental-strip-types --test --test-concurrency=4 --experimental-test-coverage --test-coverage-lines=91 --test-coverage-branches=80 --test-coverage-functions=92 --test-coverage-include=plugins/kxm/src/**/*.ts --test-coverage-exclude=plugins/kxm/src/server.ts --test-coverage-exclude=plugins/kxm/src/mcp-server.ts --test-coverage-exclude=plugins/kxm/src/runtime-supervisor.ts --test-coverage-include=packages/core/*/src/**/*.ts test/core/*.test.ts packages/core/*/tests/unit/*.test.ts",
+    "test:coverage:complete": "npm run build && node --disable-warning=ExperimentalWarning --experimental-strip-types --test --test-concurrency=4 --experimental-test-coverage --test-coverage-lines=93 --test-coverage-branches=80 --test-coverage-functions=93 --test-coverage-include=plugins/kxm/src/**/*.ts --test-coverage-exclude=plugins/kxm/src/server.ts --test-coverage-exclude=plugins/kxm/src/mcp-server.ts --test-coverage-exclude=plugins/kxm/src/runtime-supervisor.ts --test-coverage-include=packages/core/*/src/**/*.ts test/core/*.test.ts test/simulations/*.test.ts packages/core/*/tests/unit/*.test.ts",
     "test:coverage": "npm run test:coverage:core",
     "typecheck": "tsc --noEmit",
     "lint:docs": "markdownlint-cli2",
@@ -49,7 +49,10 @@
     "validate:claude": "claude plugin validate . --strict && claude plugin validate plugins/kxm --strict",
     "validate:ci": "npm run test:coverage && npm run check && npm pack --dry-run",
     "validate:pr": "npm run test:core && npm run check && npm run check:generated",
-    "validate": "npm run validate:ci && npm run validate:claude"
+    "validate": "npm run validate:ci && npm run validate:claude",
+    "test:packages": "npx nx run-many -t test --output-style=static",
+    "check:packages": "npx nx run-many -t build,test:coverage,typecheck --output-style=static",
+    "build:packages": "npx nx run-many -t build --output-style=stream"
   },
   "bin": {
     "kxm": "./scripts/kxm.mjs"
@@ -60,7 +63,8 @@
     "./client": "./plugins/kxm/dist/client.js",
     "./extension": "./plugins/kxm/dist/extension.js",
     "./mcp": "./plugins/kxm/dist/mcp-server.js",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./tui": "./packages/core/tui/dist/index.js"
   },
   "pi": {
     "extensions": [
@@ -96,6 +100,7 @@
     "commander": "15.0.0",
     "esbuild": "0.28.2",
     "markdownlint-cli2": "0.23.2",
+    "nx": "23.2.1",
     "tsx": "^4.23.13",
     "typebox": "1.3.30",
     "typescript": "7.0.2"
@@ -116,6 +121,8 @@
     "plugins/kxm/package.json",
     "plugins/kxm/README.md",
     "plugins/kxm/dist",
+    "packages/core/tui/dist",
+    "packages/core/tui/src",
     "plugins/kxm/skills",
     "plugins/kxm/src",
     "scripts",
@@ -127,5 +134,8 @@
     "LICENSE",
     "SECURITY.md"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "workspaces": [
+    "packages/core/*"
+  ]
 }

package/packages/core/tui/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to `@kontextmind/tui` are documented here. The repository
+keeps one version across every package, checked by `npm run check:versions`.
+
+## 0.7.1
+
+### Added
+
+- Surface contract `kxm.tui-contract.v1`: sections, fields, selectable choices
+  with `ready|available|blocked` status, owner actions, steps, progress, an
+  output tail, and bounded validation that refuses an oversized or malformed
+  published surface.
+- Pure panel reducer that emits effects without writing, plus a plain-text
+  renderer, a Pi `Component` adapter, a standalone terminal adapter, and a
+  `ctx.ui.custom` adapter.
+- Contribution registry: owners publish sections and handle their own writes; a
+  failed write returns as the old value plus the owner's reason.
+- CLI palette shared with `kxm dash`, so one colour cannot mean two things.

package/packages/core/tui/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KontextMind
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/packages/core/tui/README.md

@@ -0,0 +1,45 @@
+# @kontextmind/tui
+
+Reusable KXM terminal components: one declarative surface model, one renderer,
+one input decoder, one contribution registry, and thin host adapters.
+
+`kxm dash` and every configuration surface draw from here so a field looks,
+keys, and fails the same way across the product. Guide:
+[`docs/tui-components.md`](../../../docs/tui-components.md).
+
+## Layout
+
+```text
+src/
+  types/      surface contract and its validation; imports nothing outside itself
+  tui/        pure controls: keys, layout, theme, panel reducer, renderer, component
+  services/   the contribution registry that routes every write to its owner
+  adapters/   host bindings: a standalone terminal session and the Pi TUI
+  exports/    the public surface; anything unexported may be reshaped
+tests/
+  unit/       one file per layer
+  helpers/    the reference surface fixture
+```
+
+`src/` may import `@earendil-works/pi-tui` and nothing else external. No
+`node:fs`, no hub, no SQLite: a control that reads disk cannot be rendered in a
+test, and every control here is. The layer rules are enforced by
+`test/core/package-layers.test.ts`, not by memory.
+
+## Tasks
+
+| Command | What it does |
+|---|---|
+| `bun run build` | Bundle `src/exports/index.ts` to `dist/index.js` |
+| `bun run test` | Run the unit tests under Node |
+| `bun run test:coverage` | Same, with the coverage floor |
+| `bun run typecheck` | `tsc --noEmit` for this package |
+
+From the repository root: `npx nx run tui:<target>` or
+`npx nx run-many -t build,test`.
+
+## Boundary
+
+This package renders and routes. It does not own configuration, admit a writer,
+or decide that work is green. Owners publish sections and perform their own
+writes, so the panel can never become a second source of truth.