@henols/vice-mcp 0.2.1 → 0.2.3

package/resources/vice-launcher.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# .claude/mcp/vice/resources/vice-launcher.sh
+# src/mcp/vice/resources/vice-launcher.sh
 #
 # HAND-AUTHORED -- not generated. It lives beside the generated vice-broker.mjs
 # purely because install-resources.mjs deploys the whole resources/ directory
@@ -15,7 +15,10 @@
 # --check-container is now forwarded through to the Node entry point, which
 # answers it, preserving the exact same exit-code contract this launcher
 # always had: 2 when the guard refuses, 3 for the report path, 0 for
-# --print-paths.
+# --print-paths, and (new below) 4 when no interpreter this launcher is
+# willing to exec into could be resolved -- distinct from 2/3 so a triage
+# reader can tell "no usable interpreter" from "container guard refused"
+# at a glance.
 #
 # Copies vice-broker.sh's own opening shape: SELF_PATH/SELF_DIR resolution,
 # resolve_repo_root(). Plan 11 INLINES resolve_repo_root() here (it used to
@@ -38,7 +41,7 @@ SELF_DIR="$(cd "$(dirname "$SELF_PATH")" && pwd)"
 #
 # WHY THIS FUNCTION EXISTS AT ALL: a fixed `".."` hop (`REPO_ROOT="$(cd
 # "$(dirname "$SELF_PATH")/.." && pwd)"`) is wrong from this launcher's own
-# location, `.claude/mcp/vice/resources/` -- four levels below the repo root,
+# location, `src/mcp/vice/resources/` -- four levels below the repo root,
 # not one. NOTHING would error on a wrong fixed hop count: the script would
 # just read a permanently-empty `.vice-supervisor` state directory forever,
 # and restart detection would quietly stop working while every command kept
@@ -73,7 +76,7 @@ _REPO_ROOT_WARNED_NO_MARKER=0
 #      paths.
 #   4. Otherwise, a location-shaped last resort, also with a one-time stderr
 #      note: FOUR levels up when <absolute-dir>'s own directory is named
-#      `resources` (matching `<root>/.claude/mcp/vice/resources`),
+#      `resources` (matching `<root>/src/mcp/vice/resources`),
 #      ONE level up otherwise.
 resolve_repo_root() {
   local from="$1" dir parent base
@@ -131,12 +134,105 @@ REPO_ROOT="$(resolve_repo_root "$SELF_DIR")"
 # deployed tools/ copy that may be stale or hand-edited.
 BROKER_ARTIFACT="$SELF_DIR/vice-broker.mjs"
 
+# ---------------------------------------------------------------- interpreter resolution
+#
+# WHY THIS EXISTS: this launcher used to `exec node ...`, trusting whatever
+# `node` a shell's PATH resolved first. On a development host with several
+# Node majors installed side by side that is an accident waiting to happen,
+# and a service environment (a systemd unit's own PATH, carrying no
+# interactive-shell version-manager entry) resolves a DIFFERENT one than an
+# interactive shell -- the same script started two different ways running
+# two different interpreters, with no record of which. Nothing spawns this
+# script (the broker never spawns itself; the only thing that ever prints
+# this path is a message telling a HUMAN to run it), so there is no parent
+# process whose own interpreter this launcher could inherit or receive as an
+# argument -- the ladder below, plus a refusal, is the whole of it.
+#
+# NODE_FLOOR_MAJOR mirrors src/mcp/vice/package.json's `engines.node` --
+# pinned to that single number by a test (host-scripts.test.ts) precisely so
+# this floor cannot silently drift into a second, disagreeing number, which
+# is the same failure class as the bare-interpreter exec this section
+# replaces.
+NODE_FLOOR_MAJOR=24
+
+# probe_node_version <candidate-path>
+#
+# On success, sets NODE_RESOLVED_VERSION (the raw "vX.Y.Z" string) and
+# NODE_RESOLVED_MAJOR (just the leading number) and returns 0. On any
+# failure -- not executable, crashes, or prints something this launcher
+# cannot parse as a version -- returns 1 and sets neither. Called only from
+# inside an `if`, so a failure here becomes a named refusal downstream
+# rather than aborting the whole script under `set -e`.
+probe_node_version() {
+  local candidate="$1" raw major
+  if ! raw="$("$candidate" --version 2>/dev/null)"; then
+    return 1
+  fi
+  case "$raw" in
+    v[0-9]*) : ;;
+    *) return 1 ;;
+  esac
+  major="${raw#v}"
+  major="${major%%.*}"
+  case "$major" in
+    ''|*[!0-9]*) return 1 ;;
+  esac
+  NODE_RESOLVED_VERSION="$raw"
+  NODE_RESOLVED_MAJOR="$major"
+  return 0
+}
+
+# Resolution ladder -- exactly two rungs, then a refusal. There is no third
+# rung to invent: see the WHY note above for why the broker's own
+# interpreter can never be threaded in as a candidate.
+#
+#   1. VICE_BROKER_NODE, an absolute-path override, accepted only when it
+#      names an executable file -- this is the rung that fixes a service
+#      unit whose PATH carries no usable node at all: point it at one
+#      directly instead of depending on PATH.
+#   2. `node` as found on PATH.
+NODE_BIN=""
+NODE_VERSION=""
+NODE_MAJOR=""
+NODE_RESOLUTION_ERROR=""
+
+if [ -n "${VICE_BROKER_NODE:-}" ]; then
+  if [ -f "${VICE_BROKER_NODE}" ] && [ -x "${VICE_BROKER_NODE}" ]; then
+    if probe_node_version "$VICE_BROKER_NODE"; then
+      NODE_BIN="$VICE_BROKER_NODE"
+      NODE_VERSION="$NODE_RESOLVED_VERSION"
+      NODE_MAJOR="$NODE_RESOLVED_MAJOR"
+    else
+      NODE_RESOLUTION_ERROR="VICE_BROKER_NODE is set to '$VICE_BROKER_NODE', but running it with --version failed or produced output this launcher could not parse. Set VICE_BROKER_NODE to an absolute path to a working node executable, or unset it to fall back to node on PATH."
+    fi
+  else
+    NODE_RESOLUTION_ERROR="VICE_BROKER_NODE is set to '$VICE_BROKER_NODE', which does not resolve to an executable file. Set VICE_BROKER_NODE to an absolute path to an executable node interpreter, or unset it to fall back to node on PATH."
+  fi
+else
+  NODE_CANDIDATE="$(command -v node 2>/dev/null || true)"
+  if [ -n "$NODE_CANDIDATE" ]; then
+    if probe_node_version "$NODE_CANDIDATE"; then
+      NODE_BIN="$NODE_CANDIDATE"
+      NODE_VERSION="$NODE_RESOLVED_VERSION"
+      NODE_MAJOR="$NODE_RESOLVED_MAJOR"
+    else
+      NODE_RESOLUTION_ERROR="Resolved 'node' on PATH at '$NODE_CANDIDATE', but running it with --version failed or produced output this launcher could not parse. Install a working Node >= v${NODE_FLOOR_MAJOR} and put it on PATH, or set VICE_BROKER_NODE to an absolute path to one."
+    fi
+  else
+    NODE_RESOLUTION_ERROR="No 'node' executable was found on PATH and VICE_BROKER_NODE is not set. Install Node >= v${NODE_FLOOR_MAJOR} and put it on PATH, or set VICE_BROKER_NODE to an absolute path to one."
+  fi
+fi
+
 # ---------------------------------------------------------------- --print-paths
 #
-# Prints already-resolved variables only -- writes no state, spawns nothing,
-# so (like vice-broker.sh's own --print-paths) it needs no guard enforcement
-# to report what this launcher would use. Checked BEFORE --check-container is
-# forwarded, since --print-paths needs no guard verdict at all.
+# Prints already-resolved variables only -- writes no state and spawns
+# nothing beyond the version probe above, so (like vice-broker.sh's own
+# --print-paths) it needs no guard enforcement to report what this launcher
+# would use. Checked BEFORE --check-container is forwarded, since
+# --print-paths needs no guard verdict at all, and BEFORE the floor is
+# enforced below: this diagnostic reports what it found, or reports it
+# found nothing, but never refuses -- a diagnostic that dies exactly when
+# the thing it diagnoses is broken is worthless.
 PRINT_PATHS=0
 for arg in "$@"; do
   case "$arg" in
@@ -150,9 +246,29 @@ if [ "$PRINT_PATHS" -eq 1 ]; then
   echo "repo_root=$REPO_ROOT"
   echo "self_dir=$SELF_DIR"
   echo "broker_artifact=$BROKER_ARTIFACT"
+  echo "node_bin=$NODE_BIN"
+  echo "node_version=$NODE_VERSION"
   exit 0
 fi
 
+# ---------------------------------------------------------------- interpreter gate
+#
+# Refuses BEFORE exec, by name, with a remedy -- a below-floor or
+# unresolvable interpreter must never reach the broker artifact, because
+# once it does, whatever fails next presents as a wedge with no obvious
+# cause. This project detects and refuses by name; it never installs
+# anything and never shells out to a package manager.
+if [ -z "$NODE_BIN" ]; then
+  printf 'vice-launcher: refusing to start -- %s\n' "$NODE_RESOLUTION_ERROR" >&2
+  exit 4
+fi
+
+if [ "$NODE_MAJOR" -lt "$NODE_FLOOR_MAJOR" ]; then
+  printf 'vice-launcher: refusing to start -- resolved node interpreter %s reports %s, which is below the required floor v%s.x. Install a Node >= v%s and put it on PATH, or set VICE_BROKER_NODE to an absolute path to one that satisfies the floor.\n' \
+    "$NODE_BIN" "$NODE_VERSION" "$NODE_FLOOR_MAJOR" "$NODE_FLOOR_MAJOR" >&2
+  exit 4
+fi
+
 # ---------------------------------------------------------------- exec
 #
 # The guard now runs INSIDE the Node entry point, at its own process
@@ -161,9 +277,11 @@ fi
 # enforcement path (exit 2, refusal) are the broker's own job now. This
 # launcher forwards every argument, including --repo-root, unchanged, and
 # no longer inspects --check-container itself; the exit-code contract this
-# launcher always exposed (2/3/0) is preserved because the guard functions
-# ported into container-guard.mts return the SAME codes
+# launcher always exposed (2/3/0, now also 4) is preserved because the guard
+# functions ported into container-guard.mts return the SAME codes
 # container_guard_enforce()/container_guard_report() always did. Signal
 # delivery still passes straight through to the broker process with no bash
-# trap in between.
-exec node "$BROKER_ARTIFACT" --repo-root "$REPO_ROOT" "$@"
+# trap in between -- exec replaces the process image with the RESOLVED
+# interpreter, never a bare command name, so the interpreter this launcher
+# actually gated is the one that actually runs.
+exec "$NODE_BIN" "$BROKER_ARTIFACT" --repo-root "$REPO_ROOT" "$@"

package/stock-address.ts

@@ -23,8 +23,8 @@
 //     hex by default" rule belongs to the checkpoint-condition emitter, not
 //     this parser. Do not conflate the two.
 //   - Never implement symbol resolution in Phase 3. setSymbolResolver() is
-//     a deliberately empty extension point until Phase 5's DERIV-04 symbol
-//     store installs a real one; the default here stays `null`.
+//     the one extension point for it: it starts `null` and stays that way
+//     until stock-symbols.ts's `vice_symbols_load` installs a real resolver.
 //   - Never add a second resolver holder. `nameFor` (address -> name,
 //     DISASM-06's first consumer, Phase 4) and `resolve` (name -> address,
 //     Phase 3) live on the SAME `SymbolResolver` object, read from the SAME
@@ -32,7 +32,7 @@
 //     installs one object implementing both; a second holder or a
 //     re-derived address->name map in a family module would force it to
 //     install itself twice.
-import { ViceError, type ViceErrorOptions } from "./vice.ts";
+import { ViceError, type ViceErrorOptions } from "./vice-errors.ts";
 
 export interface SymbolResolver {
   resolve(name: string): number | undefined;
@@ -46,9 +46,9 @@ export interface SymbolResolver {
 // -- no symbol resolution happens until a later phase installs one.
 let symbolResolver: SymbolResolver | null = null;
 
-/** The deliberately-empty extension point Phase 5's DERIV-04 symbol store
- * fills. Passing `null` (the Phase 3 default) restores the "no symbol table
- * loaded" refusal. */
+/** The extension point stock-symbols.ts's `vice_symbols_load` fills at
+ * runtime. Passing `null` (the default before any load) restores the "no
+ * symbol table loaded" refusal. */
 export function setSymbolResolver(resolver: SymbolResolver | null): void {
   symbolResolver = resolver;
 }

package/stock-cia.ts

@@ -23,7 +23,7 @@
 // field naming the sharing address.
 //
 // Bit-field names below were transcribed ONCE from
-// `.claude/skills/c64-memory-mapping/memmap.json`'s entries for $DC00,
+// `src/skills/c64-memory-mapping/memmap.json`'s entries for $DC00,
 // $DC01, $DC02, $DC03, $DC08-$DC0F, $DD00, $DD01 and $DD0D, and
 // cross-checked at write time -- the same "committed literal, cross-checked
 // once, no automated drift check" posture Phase 4's D-06 already accepted
@@ -36,7 +36,7 @@
 //   - This is NOT a keyboard-matrix read. $DC00/$DC01 expose only the
 //     current column selection and row result; the full matrix is
 //     `vice_keyboard_matrix`, which is provably unrecoverable on stock
-//     (`docs/stock-vice-parity.md` SS A item 2) and is Phase 8's business.
+//     (`docs/stock-vice-parity.md` SS A item 2) -- the wire protocol has no matrix command, and `KEYBOARD_FEED` (0x72) injects buffer text only.
 //   - WR-02 (2026-08-17): the port A/B joystick bits share their PINS with
 //     the keyboard matrix's column-select ($DC00) and row-read ($DC01), and
 //     a stock read halts the machine at an arbitrary PC -- often inside the

package/stock-condition.ts

@@ -35,10 +35,10 @@
 //     last gate before the wire and re-validates every literal and every
 //     kind itself, even though parseConditionString() and conditionFromJson()
 //     also validate on the way in.
-//   - Phase 6's GAIN-06 extends this AST with raster semantics (finer-grained
-//     raster/cycle conditions) rather than replacing it or adding a second,
-//     parallel condition-building path. Any future raster work grows this
-//     module's types, it does not fork them.
+//   - GAIN-06's raster-semantics extension (finer-grained raster/cycle
+//     conditions) was cut with the whole of Stock-Only Gains, 2026-08-17
+//     (see docs/stock-vice-parity.md's dated cut record). Widening this AST
+//     is unclaimed scope with no owner -- grow these types, never fork them.
 //
 // This module has no handlers and no dispatch entries -- a later plan
 // consumes emitCondition()'s output as the only thing a condition-set
@@ -46,7 +46,7 @@
 // session, never touches a socket, never imports anything from the
 // session/session-handler layer.
 
-import { ViceError } from "./vice.ts";
+import { ViceError } from "./vice-errors.ts";
 
 // ---------------------------------------------------------------------------
 // Errors
@@ -545,9 +545,9 @@ function parseSingleComparison(text: string, originalExpr: string): ConditionNod
  * conditionFromJson() produces and returns it; it never emits text itself,
  * so emitCondition() remains the only producer of wire text.
  *
- * Accepted input, deliberately narrow (widening this grammar is Phase 6's
- * GAIN-06 decision, not a maintenance liberty -- do not implement a general
- * expression parser):
+ * Accepted input, deliberately narrow (GAIN-06's plan to widen this grammar
+ * was cut along with Stock-Only Gains, 2026-08-17; widening it is unclaimed
+ * scope with no owner -- do not implement a general expression parser):
  *   - a single comparison, with or without surrounding parentheses:
  *     "A == $42", "(PC == $c000)", "SP <= $ff", "RL == $64"
  *   - a conjunction/disjunction where EVERY comparison is individually

package/stock-connect.ts

@@ -42,7 +42,7 @@ import {
   StockRequestTimeoutError,
 } from "./stock-protocol.ts";
 import { readCapabilityRecord, writeCapabilityRecord, type CapabilityDeps } from "./backend-detect.mts";
-import { MachineRestartedError, ViceError, readEpoch, type EpochResult } from "./vice.ts";
+import { MachineRestartedError, ViceError, readEpoch, type EpochResult } from "./vice-errors.ts";
 import {
   MonitorOwnershipError,
   type ClaimMonitorOptions,
@@ -402,12 +402,14 @@ async function safeResume(client: ViceMonitorClient): Promise<void> {
  * leave a frozen C64 behind either.
  */
 export async function stockConnect({ host, port, targetId, brokerControl, deps = {} }: StockConnectOptions): Promise<StockConnectSession> {
-  const claimOutcome = await brokerControl.claimMonitor({ targetId });
+  // Plan 41-03 (D-14): explicit, not relying on claimMonitor()'s own default
+  // -- the binary path names its own channel at the call site.
+  const claimOutcome = await brokerControl.claimMonitor({ targetId, channel: "binary" });
   if (!claimOutcome.ok) {
     if (claimOutcome.reason === "monitor_owned") {
       throw new MonitorOwnershipError(
         `stockConnect: monitor for target ${targetId} on port ${port} is already claimed by grant ${claimOutcome.holder.grantId}`,
-        { holderGrantId: claimOutcome.holder.grantId, holderClaimedAt: claimOutcome.holder.claimedAt, port },
+        { holderGrantId: claimOutcome.holder.grantId, holderClaimedAt: claimOutcome.holder.claimedAt, port, channel: claimOutcome.holder.channel },
       );
     }
     // "timeout" (the broker did not answer) is kept strictly distinct from
@@ -474,7 +476,9 @@ export async function stockConnect({ host, port, targetId, brokerControl, deps =
     // reason. Both outcomes are now reported on stderr and neither can
     // displace `err`.
     try {
-      const released = await brokerControl.releaseMonitor({ targetId });
+      // Plan 41-03 (D-14): explicit "binary" -- never releases the "text"
+      // claim as a side effect of a failed binary handshake.
+      const released = await brokerControl.releaseMonitor({ targetId, channel: "binary" });
       if (!released.ok) {
         console.error(
           `stockConnect: monitor release for target ${targetId} after a failed handshake was refused (${released.reason}) -- the instance may still be claimed`,
@@ -493,7 +497,7 @@ export async function stockConnect({ host, port, targetId, brokerControl, deps =
  * stockConnect()'s own failure-path release above. */
 export async function stockDisconnect(session: StockConnectSession): Promise<void> {
   await safeDisconnect(session.client);
-  await session.brokerControl.releaseMonitor({ targetId: session.targetId });
+  await session.brokerControl.releaseMonitor({ targetId: session.targetId, channel: "binary" });
 }
 
 // ---------------------------------------------------------------------------
@@ -534,7 +538,7 @@ export async function stockReconnect(session: StockConnectSession, { lastToolCal
 
   if (baselineEpoch === null || currentEpoch === null || currentEpoch !== baselineEpoch) {
     throw new MachineRestartedError(
-      `stockConnect: reconnect to target ${session.targetId} could not prove machine identity across the reconnect ` +
+      `stockReconnect: reconnect to target ${session.targetId} could not prove machine identity across the reconnect ` +
         `(baseline epoch ${String(baselineEpoch)}, current epoch ${String(currentEpoch)})`,
       { baselineEpoch, currentEpoch, where: "stock-connect.ts:stockReconnect", lastToolCall },
     );

package/stock-derived.ts

@@ -18,48 +18,32 @@
 // hazard. There, NOT translating an emulator-side path is the bug -- four
 // tools carry a filename stock VICE opens on the HOST, and stock-paths.ts's
 // whole job is making sure that translation happens. HERE, translating a
-// CLIENT-SIDE-DERIVED path is the bug: `forwardToVice()` calls
-// `rewriteArguments(args, name)` itself, before it ever delegates to
-// `call()` -- so a derived tool sitting behind `call()` would receive
-// HOST-translated paths and act on them INSIDE THE CONTAINER (ROADMAP Phase 4
-// Notes, CLAUDE.md). The derived-tool seam this file anchors exists so a
-// derived tool's handler is reached BEFORE `forwardToVice()` runs
-// `rewriteArguments()` at all.
+// CLIENT-SIDE-DERIVED path is the bug: a derived tool answers from data this
+// proxy already holds, so handing its arguments through a HOST path
+// translator meant for a forwarded call would act on a translated path
+// INSIDE THE CONTAINER instead of the untranslated one the derived handler
+// actually needs.
 //
-// SECOND CONSUMER: `gatherWedgeEvidence()` in vice-proxy.ts calls
-// `rewriteArguments()` itself, for `vice_display_screenshot`. On the stock
-// backend, PERFORMING that translation becomes the bug -- its own comment
-// inverts. Phase 5 criterion 5 owns that fix; it is deliberately NOT
-// repointed here.
-//
-// CITATION STYLE, deliberate (07-REVIEW.md WR-12): the two call sites above
-// are named by SYMBOL (`forwardToVice()`'s own `rewriteArguments(args, name)`
-// call; `gatherWedgeEvidence()`'s own call), never by line number. This header
-// used to cite `vice-proxy.ts:2773`, `:1343` and `:1367`; by the time WR-12 was
-// filed the real lines were 2889, 1344 and 1368 -- 07-16 edited vice-proxy.ts
-// without re-verifying them, and this header is the in-tree statement of
-// CLAUDE.md's derived-tool constraint, so its citations are load-bearing. Line
-// numbers in this file drift every phase; grep for the symbol instead.
-//
-// WHY THE HAZARD IS UNREACHABLE ON STOCK TODAY -- restated in terms of what
-// actually enforces it (WR-12 again; the previous reason had gone stale):
-// `buildBackendAwareTool()` routes EVERY stock tool call to
-// `dispatchStock()`, so `forwardToVice()`, `handleRecycle()` and
-// `gatherWedgeEvidence()` are reachable only on the fork arm. That is a
-// structural property of the registration, not of any tool's name. The reason
-// this header used to give -- "handleRecycle() is backend-aware and refused by
-// name after CR-07, and vice_display_screenshot does not exist on stock until
-// Phase 5" -- is now WRONG on its first clause: Phase 7 implemented
-// `vice_recycle` on stock (`handleRecycleStock`) and registered it in
-// STOCK_DERIVED_TOOLS below. The conclusion held; the stated reason did not,
-// which is worse than no reason for a constraint a future reader will
-// re-derive.
+// WHY THE HAZARD IS UNREACHABLE ON STOCK TODAY: it no longer has anywhere to
+// come FROM. The fork-only generic forwarding function and its own
+// per-call argument path-rewriter, and the fork-only wedge-evidence
+// gatherer that also ran that rewriter for `vice_display_screenshot`, are
+// both deleted outright -- there is no remaining call site anywhere in this
+// package that translates a host path before dispatch. Every stock tool
+// call, derived or direct, reaches `dispatchStock()` in stock-dispatch.ts
+// through exactly one registration seam in vice-proxy.ts, with no
+// per-backend branch left to route around it. The hazard this file was
+// built to close is now closed by construction, not merely by a runtime
+// backend check: there is no path-translating function left for a derived
+// tool's runner to be reached behind.
 //
 // WHAT NOT TO DO:
 //   - Never `import` hostpath.ts from this file, or from any module listed
 //     in STOCK_DERIVED_TOOLS' implementations -- hostpath-consumers.test.ts
 //     fails the build if you do.
-//   - Never `import` vice-proxy.ts, and never call rewriteArguments().
+//   - Never `import` vice-proxy.ts, and never re-introduce a per-call
+//     argument path-translator that a derived tool's runner could be
+//     reached behind.
 //   - Never add a client-side-derived tool to stock-paths.ts's
 //     STOCK_EMULATOR_SIDE_PATH_TOOLS -- that file's own header already warns
 //     against exactly this.
@@ -76,7 +60,7 @@
 //     withDerivedTool() refuses on this set, and a declared-but-unshipped
 //     module fails at module load in the published tarball rather than at
 //     dispatch.
-import { ViceError, type ViceErrorOptions } from "./vice.ts";
+import { ViceError, type ViceErrorOptions } from "./vice-errors.ts";
 import type { StockToolResult } from "./stock-handler.ts";
 import type { StockDispatchDeps } from "./stock-dispatch.ts";
 
@@ -114,6 +98,14 @@ export const STOCK_DERIVED_TOOLS: ReadonlySet<string> = new Set([
   "vice_run_until", // Phase 7, TIME-02
   "vice_diagnose", // Phase 7, TIME-04
   "vice_recycle", // Phase 7, TIME-04
+  "vice_device_console", // Plan 41-06, CHAN-03 -- text-channel remedy tool, needsSession:false (text-tools.ts)
+  "vice_warp_set", // Plan 41-06, CHAN-03 -- text-channel remedy tool, needsSession:false (text-tools.ts)
+  "vice_memmap_show", // Plan 42-01, PARSE-01 -- text-channel access-map tool, needsSession:false (text-tools.ts)
+  "vice_memmap_zap", // Plan 43-03, EVID-05 -- text-channel access-map bracket-reset tool, needsSession:false (text-tools.ts)
+  "vice_cpu_history", // Plan 42-07, PARSE-02 -- text-channel CPU-history tool, needsSession:false (text-tools.ts)
+  "vice_profile_flat", // Plan 42-07, PARSE-02 -- text-channel flat-profile tool, needsSession:false (text-tools.ts)
+  "vice_backtrace", // Plan 42-07, PARSE-02/D-42-4 -- text-channel backtrace tool, shares the fork's own name, needsSession:false (text-tools.ts)
+  "vice_io_registers", // Plan 42-07, PARSE-02 -- text-channel register-decode tool, needsSession:false (text-tools.ts)
 ]);
 
 /**