ultra-builder-pro-cli 0.5.3 → 0.7.0

package/bin/install.js

@@ -4,20 +4,19 @@
  * ultra-builder-pro-cli — multi-runtime installer.
  *
  * Distributes Ultra Builder Pro assets — commands, agents, skills, hooks,
- * MCP server — to Claude Code, OpenCode, Codex CLI, and Gemini CLI via
+ * MCP server — to Claude Code, OpenCode, and Codex CLI via
  * runtime-specific adapters under adapters/. Install is idempotent and
  * uses atomic writes; uninstall reverses via sentinel/manifest blocks.
  *
  * Usage:
  *   npx ultra-builder-pro-cli [options]
  *
- *   --claude / --opencode / --codex / --gemini   select runtime(s)
+ *   --claude / --opencode / --codex              select runtime(s)
  *   --all                                         install to all supported runtimes
  *   -g, --global                                  install to runtime's global config dir
  *   -l, --local                                   install into current working directory
  *   -u, --uninstall                               remove installed assets
  *   -c, --config-dir <path>                       override config directory
- *       --skip-rtk                                do not detect / install RTK hook
  *   -h, --help                                    show help
  */
 
@@ -29,8 +28,7 @@ const os = require('node:os');
 
 const pkg = require('../package.json');
 const { validateConfigDir } = require('../adapters/_shared/validate.cjs');
-
-const SUPPORTED_RUNTIMES = ['claude', 'opencode', 'codex', 'gemini'];
+const { SUPPORTED_RUNTIMES } = require('../adapters/_shared/runtime-assets.cjs');
 
 const COLORS = {
   reset: '\x1b[0m',
@@ -58,7 +56,7 @@ function printBanner() {
     paint('cyan', '   ╚═════╝ ╚═════╝ ╚═╝         ╚═════╝╚══════╝╚═╝'),
     '',
     `  ${paint('bold', 'Ultra Builder Pro CLI')} ${paint('dim', 'v' + pkg.version)}`,
-    `  ${paint('dim', 'Multi-runtime installer for Claude Code, OpenCode, Codex, Gemini')}`,
+    `  ${paint('dim', 'Multi-runtime installer for Claude Code, OpenCode, and Codex')}`,
     '',
   ];
   console.log(banner.join('\n'));
@@ -71,7 +69,6 @@ function printHelp() {
     ${paint('cyan', '--claude')}           Claude Code
     ${paint('cyan', '--opencode')}         OpenCode
     ${paint('cyan', '--codex')}            Codex CLI (OpenAI)
-    ${paint('cyan', '--gemini')}           Gemini CLI (Google)
     ${paint('cyan', '--all')}              all supported runtimes
 
   ${paint('yellow', 'Scope:')}
@@ -81,7 +78,6 @@ function printHelp() {
   ${paint('yellow', 'Other:')}
     ${paint('cyan', '-u, --uninstall')}    remove installed assets
     ${paint('cyan', '-c, --config-dir')}   override runtime's config directory (string path)
-    ${paint('cyan', '--skip-rtk')}        skip RTK hook registration (RTK is a soft dependency)
     ${paint('cyan', '-h, --help')}         show this help
     ${paint('cyan', '-v, --version')}      show CLI version
 
@@ -89,7 +85,7 @@ function printHelp() {
     ${paint('dim', '# Install to Claude Code globally')}
     npx ultra-builder-pro-cli --claude --global
 
-    ${paint('dim', '# Install to all 4 runtimes locally in this repo')}
+    ${paint('dim', '# Install to all supported runtimes locally in this repo')}
     npx ultra-builder-pro-cli --all --local
 
     ${paint('dim', '# Uninstall from OpenCode')}
@@ -107,7 +103,6 @@ function parseArgs(argv) {
     help: false,
     version: false,
     configDir: null,
-    skipRtk: false,
   };
 
   for (let i = 0; i < args.length; i++) {
@@ -116,7 +111,6 @@ function parseArgs(argv) {
       case '--claude': runtimes.add('claude'); break;
       case '--opencode': runtimes.add('opencode'); break;
       case '--codex': runtimes.add('codex'); break;
-      case '--gemini': runtimes.add('gemini'); break;
       case '--all':
         SUPPORTED_RUNTIMES.forEach(r => runtimes.add(r));
         break;
@@ -125,7 +119,6 @@ function parseArgs(argv) {
       case '-u': case '--uninstall': flags.uninstall = true; break;
       case '-h': case '--help': flags.help = true; break;
       case '-v': case '--version': flags.version = true; break;
-      case '--skip-rtk': flags.skipRtk = true; break;
       case '-c': case '--config-dir':
         flags.configDir = args[++i];
         if (!flags.configDir || flags.configDir.startsWith('-')) {
@@ -193,7 +186,7 @@ async function main() {
   }
 
   if (runtimes.length === 0) {
-    bail('no runtime selected; use --claude / --opencode / --codex / --gemini / --all');
+    bail('no runtime selected; use --claude / --opencode / --codex / --all');
   }
 
   const scope = resolveScope(flags);
@@ -229,21 +222,6 @@ async function main() {
     process.exit(1);
   }
 
-  // Phase 6.1 — RTK hook (soft dependency; install continues on absence).
-  if (mode === 'install') {
-    const rtk = require('../adapters/_shared/rtk-detect.cjs');
-    const result = rtk.installHook({ skip: flags.skipRtk, scope });
-    if (result.skipped) {
-      console.log(`  ${paint('dim', '⤼ rtk skipped (--skip-rtk)')}`);
-    } else if (result.available && result.initialized) {
-      console.log(`  ${paint('green', '✓')} rtk hook registered (${result.version})`);
-    } else if (result.available && !result.initialized) {
-      console.log(`  ${paint('yellow', '!')} rtk present but init failed: ${result.init_error}`);
-    } else {
-      console.log(`  ${paint('dim', '⤼ ' + result.hint.replace(/\n/g, '\n    '))}`);
-    }
-  }
-
   console.log(`  ${paint('green', 'Done.')}`);
 }
 

package/bin/orchestrator.js

@@ -22,6 +22,7 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { spawn } = require('node:child_process');
+const { isSupportedRuntime } = require('../adapters/_shared/runtime-assets.cjs');
 
 const REPO_ROOT = process.env.UBP_REPO_ROOT || process.cwd();
 const PIDFILE = path.join(REPO_ROOT, '.ultra', 'orchestrator.pid');
@@ -46,8 +47,13 @@ function optInAllowed(settings) {
 }
 
 function parseRuntimes() {
-  const raw = process.env.UBP_ORCH_RUNTIMES || 'claude,opencode,codex,gemini';
-  return raw.split(',').map((s) => s.trim()).filter(Boolean);
+  const raw = process.env.UBP_ORCH_RUNTIMES || 'claude,opencode,codex';
+  const runtimes = [...new Set(raw.split(',').map((s) => s.trim()).filter(Boolean))];
+  const invalid = runtimes.filter((runtime) => !isSupportedRuntime(runtime));
+  if (invalid.length > 0) {
+    throw new Error(`unsupported orchestrator runtime(s): ${invalid.join(', ')}`);
+  }
+  return runtimes;
 }
 
 function cmdRun(opts = {}) {
@@ -61,48 +67,25 @@ function cmdRun(opts = {}) {
   }
   const { initStateDb } = require('../mcp-server/lib/state-db.cjs');
   const { runDaemon } = require('../orchestrator/daemon.cjs');
+  const runtimes = parseRuntimes();
   const { db } = initStateDb(path.join(REPO_ROOT, '.ultra', 'state.db'));
   const handle = runDaemon({
     db,
     repoRoot: REPO_ROOT,
-    runtimes: parseRuntimes(),
+    runtimes,
     pollMs: Number(process.env.UBP_ORCH_POLL_MS || 1000),
     onError: (err) => process.stderr.write(`orchestrator error: ${err.message}\n`),
   });
 
-  // Phase 6.4 — optional code-graph watcher (opt-in via settings or CLI).
-  const watcherEnabled =
-    opts.withGraphWatcher === true ||
-    !!(settings && settings.orchestrator && settings.orchestrator.graph_watcher === true);
-  let watcherHandle = null;
-  if (watcherEnabled) {
-    try {
-      const { startWatcher } = require('../orchestrator/code-graph-watcher.cjs');
-      const jsonlPath = path.join(REPO_ROOT, '.ultra', 'code-graph-events.jsonl');
-      fs.mkdirSync(path.dirname(jsonlPath), { recursive: true });
-      watcherHandle = startWatcher({
-        repoRoot: REPO_ROOT,
-        onBatch: (batch) => {
-          try { fs.appendFileSync(jsonlPath, JSON.stringify(batch) + '\n'); }
-          catch (err) { process.stderr.write(`graph-watcher write error: ${err.message}\n`); }
-        },
-      });
-      process.stderr.write(`orchestrator: graph-watcher enabled → ${jsonlPath}\n`);
-    } catch (err) {
-      process.stderr.write(`orchestrator: graph-watcher disabled (${err.message})\n`);
-    }
-  }
-
   const shutdown = (signal) => {
     process.stderr.write(`orchestrator received ${signal}, stopping\n`);
     handle.stop();
-    if (watcherHandle) watcherHandle.stop();
     try { db.close(); } catch (_) { /* ignore */ }
     process.exit(0);
   };
   process.on('SIGTERM', () => shutdown('SIGTERM'));
   process.on('SIGINT', () => shutdown('SIGINT'));
-  process.stderr.write(`orchestrator running (pollMs=${Number(process.env.UBP_ORCH_POLL_MS || 1000)}, runtimes=${parseRuntimes().join(',')})\n`);
+  process.stderr.write(`orchestrator running (pollMs=${Number(process.env.UBP_ORCH_POLL_MS || 1000)}, runtimes=${runtimes.join(',')})\n`);
   // Keep process alive while the setInterval is unref'd.
   setInterval(() => {}, 60000);
 }
@@ -198,9 +181,8 @@ function usage() {
 
 const argv = process.argv.slice(2);
 const subcommand = argv[0];
-const runOpts = { withGraphWatcher: argv.includes('--with-graph-watcher') };
 switch (subcommand) {
-  case 'run':    cmdRun(runOpts); break;
+  case 'run':    cmdRun();        break;
   case 'start':  cmdStart();      break;
   case 'stop':   cmdStop();       break;
   case 'status': cmdStatus();     break;

package/commands/ultra-change.md

@@ -0,0 +1,47 @@
+---
+description: Start or resume a continuous post-delivery change with bounded context, documentation impact, and linked authoritative tasks
+argument-hint: "[change-id or title] [quick|standard|major|incident]"
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion
+model: opus
+workflow-ref: "@skills/ultra-change/SKILL.md"
+mcp_tools_required:
+  - change.create
+  - change.update
+  - change.get
+  - change.list
+  - change.context
+  - task.create
+  - task.list
+---
+
+# /ultra-change
+
+## 目标
+
+把初始交付后的日常修复、功能、重构或事故变成一个持续可追踪的 change，避免
+代码、spec、测试证据和项目上下文逐步漂移。
+
+## Workflow
+
+完整流程见 `@skills/ultra-change/SKILL.md`：
+
+1. 先查 active/blocked change，匹配则恢复，避免重复创建。
+2. 按 `quick / standard / major / incident` 分类并声明 docs impact。
+3. 调 `change.create`，为 change 创建至少一个带 `change_id` 的 task。
+4. standard/major 写 delta + plan；调 `change.context` 编译最小上下文。
+5. 路由到 `/ultra-dev`、`/ultra-test`、`/ultra-review`、`/ultra-deliver`。
+
+Memory 与代码图谱只允许以外部 provider 元数据引用出现；本命令不保存 provider
+正文，也不自动刷新外部 provider。
+
+## 用法
+
+```bash
+/ultra-change auth-timeout quick
+/ultra-change billing-redesign major
+/ultra-change incident-2026-07-17 incident
+```
+
+## 下一步
+
+输出会给出 change id、artifact root、linked task 与准确的下一个 Ultra workflow。

package/commands/ultra-deliver.md

@@ -1,18 +1,24 @@
 ---
-description: Release preparation — docs + build + version bump + tag + push, gated by /ultra-test pass
+description: Converge and deliver a verified baseline or continuous change — reconcile specs, archive evidence, version, tag, and push
 argument-hint: "[version-type]"
 allowed-tools: Task, Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion
 model: opus
 workflow-ref: "@skills/ultra-deliver/SKILL.md"
 cli_fallback: "direct user interaction"
+mcp_tools_required:
+  - change.list
+  - change.get
+  - change.context
+  - change.converge
+  - change.archive
 ---
 
 # /ultra-deliver
 
 ## 目标
 
-`/ultra-test` 绿灯后做发布准备：更新 CHANGELOG + technical-debt + README →
-production build → 版本号 + git tag + push。写 `.ultra/delivery-report.json`。
+`/ultra-test` 绿灯后，把 active delta 合并回 baseline，重跑发布证据，调用
+`change.converge` 与 `change.archive`，再完成版本号、tag、push 和 delivery report。
 
 ## 参数
 
@@ -22,14 +28,15 @@ production build → 版本号 + git tag + push。写 `.ultra/delivery-report.js
 
 ## Workflow
 
-完整 5 步见 `@skills/ultra-deliver/SKILL.md`（validations → 文档 → build → 版本发布 → 产物报告）。
+完整流程见 `@skills/ultra-deliver/SKILL.md`（绑定 change → baseline reconciliation →
+build/test → release commit → context/convergence/archive → tag/push → report）。
 
 **命令入口做的事**：
 1. 读 `.ultra/test-report.json` 验 `passed=true` + `git_commit === HEAD`
 2. `git status` 清洁检查；不干净 → 通过 Host 原生提问界面选处理方式
-3. 驱动 skill 跑文档 + build + 版本 + tag + push
-4. 写 `.ultra/delivery-report.json`
-5. 输出 release summary
+3. 有 active change 时合并 delta、刷新 context，并通过确定性 convergence gate
+4. archive 完成后才允许 tag/push
+5. 写带 change id、archive path、baseline updates 的 delivery report
 
 ## 用法
 

package/commands/ultra-dev.md

@@ -8,6 +8,8 @@ mcp_tools_required:
   - task.update
   - task.get
   - task.list
+  - change.get
+  - change.context
 ---
 
 # /ultra-dev
@@ -34,9 +36,10 @@ v4.4→v4.5 迁移，绝不从 `tasks.json` 回退或直接改投影。
 **命令入口做的事**：
 1. 读 `.ultra/workflow-state.json` 决定新跑 vs resume
 2. 首跑通过 Host 原生提问触发 Design Approval Gate
-3. 驱动 skill 走 TDD + review 循环；状态仅通过 MCP `task.update`（双写消除）
-4. Step 4.5 review 通过 `/ultra-review` 和 Host 原生 subagent 执行
-5. Step 4.4 pre-review checkpoint 写入 workflow-state.json，不依赖 `/compact`
+3. 驱动 skill 走 TDD + review 循环；状态仅通过 MCP `task.update`
+4. task 有 `change_id` 时把需求变化写进 active delta，并用 `change.context` 刷新上下文
+5. Step 4.5 review 通过 `/ultra-review` 和 Host 原生 subagent 执行
+6. Step 4.4 pre-review checkpoint 写入 workflow-state.json，不依赖 `/compact`
 
 ## 用法
 

package/commands/ultra-doctor.md

@@ -0,0 +1,36 @@
+---
+description: Inspect Ultra runtime health and optionally run explicit backup-first mechanical recovery
+argument-hint: "[--repair]"
+allowed-tools: Read, Bash
+model: opus
+workflow-ref: "@skills/ultra-doctor/SKILL.md"
+mcp_tools_required:
+  - system.doctor
+cli_fallback: "system doctor"
+---
+
+# /ultra-doctor
+
+## 目标
+
+诊断 state.db、projection、incident、session 和 active change artifact 的健康状态。
+默认只读；只有显式传入 `--repair` 才允许备份后执行机械恢复。
+
+## Workflow
+
+完整契约见 `@skills/ultra-doctor/SKILL.md`。
+
+1. 默认调用 `system.doctor {"repair": false}`。
+2. 只报告失败检查、incident、游标落后和归属边界。
+3. `--repair` 时必须先生成 state.db 备份，再恢复 orphan、消费 staleness event、
+   重排超时中断或失败的 projection 并重新投影。
+4. 修复后重新读取报告；仍 degraded 就明确剩余阻塞，不宣称完成。
+
+## 用法
+
+```bash
+/ultra-doctor
+/ultra-doctor --repair
+```
+
+Memory 和代码图谱属于外部 provider，本命令既不收集也不修复它们。

package/commands/ultra-init.md

@@ -1,5 +1,5 @@
 ---
-description: Initialize Ultra Builder Pro project — scaffold .ultra/, seed tasks.json, optional git
+description: Initialize Ultra Builder Pro project — scaffold .ultra/, initialize state.db and continuous-change directories, optional git
 argument-hint: <name> <type> <stack> [git]
 allowed-tools: Read, Write, Bash, Grep, Glob, AskUserQuestion
 model: opus
@@ -13,8 +13,9 @@ cli_fallback: "task init-project"
 
 ## 目标
 
-搭 `.ultra/` 骨架（specs + tasks + docs + reports）；写入带元数据的 `tasks.json`；
-按需初始化 git。4 个 runtime 行为一致，不依赖 Claude 独占工具。
+搭 `.ultra/` 骨架（specs + tasks + changes + docs + reports），初始化权威
+`state.db`，写入带元数据的初始 `tasks.json`，并按需初始化 git。Claude Code、
+OpenCode、Codex 三个 runtime 行为一致。
 
 ## 参数
 

package/commands/ultra-status.md

@@ -7,6 +7,8 @@ workflow-ref: "@skills/ultra-status/SKILL.md"
 mcp_tools_required:
   - task.list
   - task.get
+  - change.list
+  - system.doctor
 ---
 
 # /ultra-status
@@ -14,7 +16,7 @@ mcp_tools_required:
 ## 目标
 
 一次调用拿整个项目近况：任务进度（来自 state.db `task.list`）+ 测试状态（`test-report.json`）+
-发布状态（`delivery-report.json`）+ 风险检测 + 下一步命令路由。只读。
+发布状态（`delivery-report.json`）+ active change + runtime health + 下一步命令路由。只读。
 任务状态只接受 MCP `task.list`/`task.get`；失败时原样报告并停止，绝不读取
 `tasks.json` 冒充权威数据。旧 v4.4 数据必须先执行正式迁移。
 
@@ -30,9 +32,9 @@ mcp_tools_required:
 
 **命令入口做的事**：
 1. 环境检查（state.db 可达 + 有 task）
-2. `task.list` 拿全量；读 test-report / delivery-report
-3. 算进度 + 风险（blocked / stalled / overdue / complexity spike / test stale）
-4. 按当前 artifact 组合路由到下一个命令（/ultra-init → /ultra-research → /ultra-plan → /ultra-dev → /ultra-test → /ultra-deliver）
+2. `task.list` + `change.list` + read-only `system.doctor`；读 test/delivery report
+3. 算进度 + 风险（含 projection、incident、context/docs drift）
+4. 初始交付后不再显示终局 Done；健康 baseline 的下一项日常工作路由到 `/ultra-change`
 
 ## 用法
 
@@ -44,4 +46,4 @@ mcp_tools_required:
 ## 下一步
 
 看输出的 `▶ Next Up` 块。常见场景：有 pending → `/ultra-dev`；全绿 → `/ultra-test`；
-test passed → `/ultra-deliver`。
+test passed → `/ultra-deliver`；已归档且 baseline 健康 → `/ultra-change`。

package/commands/ultra-test.md

@@ -6,6 +6,7 @@ model: opus
 workflow-ref: "@skills/ultra-test/SKILL.md"
 mcp_tools_required:
   - task.list
+  - change.list
 ---
 
 # /ultra-test
@@ -33,7 +34,7 @@ completed-task 前置检查必须来自 MCP `task.list`；失败时停止，绝
 **命令入口做的事**：
 1. 探测项目类型 + `task.list` 确认 ≥1 completed
 2. 按 scope 跑 gates；失败进 auto-fix（最多 5 轮）
-3. 写 `.ultra/test-report.json`（`passed` + gate-level 明细 + blocking_issues）
+3. 写 `.ultra/test-report.json`（change_id + exact commands + gate 明细 + blocking_issues）
 4. 通过 → 提示 `/ultra-deliver`
 
 ## 用法

package/docs/AGENT-CONTEXT.md

@@ -1,16 +1,15 @@
 # Ultra Builder Pro — Agent Context
 
 Current shared runtime contract for the native Claude Code, OpenCode, and Codex
-plugins. Gemini CLI remains a compatibility adapter and is not the reference
-shape for the three first-class plugins.
+plugins.
 
 ## 1. Ownership boundary
 
 Ultra Builder Pro owns only:
 
-- ten public workflows: `learn`, `ultra-init`, `ultra-research`, `ultra-plan`,
+- twelve public workflows: `learn`, `ultra-init`, `ultra-research`, `ultra-plan`,
   `ultra-dev`, `ultra-test`, `ultra-review`, `ultra-deliver`, `ultra-status`, and
-  `ultra-think`;
+  `ultra-think`, plus the daily `ultra-change` and diagnostic `ultra-doctor`;
 - four internal agent-only rule skills: `code-review-expert`, `security-rules`,
   `integration-rules`, and `testing-rules`;
 - the host-specific collaboration companions and `ultra-verify`;
@@ -25,39 +24,39 @@ not put it in a plugin until that allowlist classifies it.
 ## 2. Three-layer architecture
 
 ```text
-native command or skill -> MCP workflow-state operation -> CLI fallback
-                                  |
-                                  v
-                         .ultra/state.db
+native command or skill -> MCP workflow-state operation -> .ultra/state.db
+                                      ^
+                                      |
+              selected CLI init / doctor / diagnostics / orchestration
 ```
 
 | Layer | Artifact | Contract |
 |---|---|---|
 | Skill/command | `skills/*/SKILL.md`, `commands/*.md` | Model-facing workflow and host-native entry point |
 | MCP | `mcp-server/server.cjs` | Authoritative typed operations over `.ultra/state.db` |
-| CLI | `ultra-tools`, `ubp-orchestrator` | Portable fallback, automation, and diagnostics |
+| CLI | `ultra-tools`, `ubp-orchestrator` | Selected initialization, backup-first recovery, automation, and diagnostics; not a change-state mirror |
 
-`.ultra/state.db` is the only durable Ultra authority for tasks, sessions,
-events, telemetry, review evidence, and circuit-breaker state. `tasks.json`,
-context Markdown, execution plans, and reports are projections or workflow
-artifacts; never treat them as a second writable authority.
+`.ultra/state.db` is the only durable Ultra authority for changes, tasks,
+sessions, events, incidents, projection jobs/cursors, telemetry, review evidence,
+and circuit-breaker state. `tasks.json`, context Markdown, execution plans, and
+reports are projections or workflow artifacts.
 
 ## 3. Live MCP and declared contracts
 
-`spec/mcp-tools.yaml` declares 30 contracts across seven families. The bundled
-server registers 21 tools:
+`spec/mcp-tools.yaml` declares and the bundled server registers 29 tools across
+five families:
 
 | Family | Live tools |
 |---|---|
 | `task.*` | create, update, list, get, switch_tag, delete, init_project, expand, parse_prd, dependency_topo, append_event, subscribe_events |
 | `session.*` | spawn, close, get, list, admission_check, heartbeat, subscribe_events |
+| `change.*` | create, update, get, list, context, converge, archive |
+| `system.*` | doctor |
 | `plan.*` | export, get |
 
-The nine declared `review.*`, `impact.*`, `skill.*`, and `ask.*` contracts are
-not advertised by the live server. A generated Codex plugin records their
-native replacements in `spec/codex-capability-map.json`; other hosts use their
-own native review agents, repository discovery, skill loader, and user
-interaction surfaces.
+Review, repository impact discovery, skill loading, and user interaction remain
+host-native capabilities rather than fake MCP contracts. The generated Codex
+capability map documents those replacements.
 
 Any new MCP contract starts in `spec/mcp-tools.yaml` with valid and invalid
 fixtures. Do not add an ad-hoc server handler first.
@@ -66,9 +65,9 @@ fixtures. Do not add an ad-hoc server handler first.
 
 | Host | Plugin form | Workflow entry | Hook form | Collaboration companions |
 |---|---|---|---|---|
-| Claude Code | `.claude-plugin/plugin.json`, native commands/skills/agents, `.mcp.json` | `/ultra-*`, `/learn` | native `hooks/hooks.json` | `codex-collab`, `gemini-collab` |
-| Codex | personal plugin with `.codex-plugin/plugin.json`, namespaced skills, TOML agents, `.mcp.json` | `$ultra-builder-pro:ultra-*`, `$ultra-builder-pro:learn` | native `hooks/hooks.json` through the Codex wire adapter | `cc-collab`, `gemini-collab` |
-| OpenCode | config bundle plus native JavaScript plugin | `/ultra-*`, `/learn` | `event`, system transform, compaction, and tool lifecycle handlers | `cc-collab`, `codex-collab`, `gemini-collab` |
+| Claude Code | `.claude-plugin/plugin.json`, native commands/skills/agents, `.mcp.json` | `/ultra-*`, `/learn` | native `hooks/hooks.json` | `codex-collab`, `ultra-verify` |
+| Codex | personal plugin with `.codex-plugin/plugin.json`, namespaced skills, TOML agents, `.mcp.json` | `$ultra-builder-pro:ultra-*`, `$ultra-builder-pro:learn` | native `hooks/hooks.json` through the Codex wire adapter | `cc-collab`, `ultra-verify` |
+| OpenCode | config bundle plus native JavaScript plugin | `/ultra-*`, `/learn` | `event`, system transform, compaction, and tool lifecycle handlers | `cc-collab`, `codex-collab`, `ultra-verify` |
 
 The current host remains primary. Collaboration skills call another runtime
 only when explicitly requested, use it as a read-only advisor, and return the
@@ -85,17 +84,22 @@ The canonical Python hook allowlist contains seven workflow-only adapters:
 - `pre_stop_check.py` at stop;
 - `subagent_tracker.py` for bounded worker lifecycle evidence.
 
-Every hook is a no-op unless `.ultra/workflow-state.json` describes an active,
-non-terminal workflow. OpenCode expresses the same boundary in its native
-JavaScript plugin. Generic command blocking, post-edit governance, and unrelated
-user hooks are not copied into Ultra Builder Pro.
+`health_check.py` and `workflow_context.py` may inspect any initialized project;
+`active_task_context.py` always protects the task projection but limits ordinary
+edit guidance to an active workflow. Compact/stop/subagent hooks remain
+active-workflow scoped. OpenCode natively injects baseline/change context and
+protects the projection; full health inspection is available through
+`system.doctor` rather than a session-start health hook.
+Generic command blocking, post-edit governance, and unrelated user hooks are not
+copied into Ultra Builder Pro.
 
 ## 6. Memory boundary
 
 Ultra Builder Pro has no memory MCP family, recall skill, prompt capture,
 transcript capture, observation journal, or session-summary hook. Persistent
 cross-session memory belongs to a separately installed provider such as
-cloud-mem/claude-mem.
+cloud-mem/claude-mem. Code graph content is equally external. A change context
+may contain only provider metadata references, never provider payload content.
 
 Old Ultra data is never deleted during install. The explicit migration path is:
 
@@ -113,6 +117,9 @@ Archive before prune; the confirmation token is intentionally required.
 .ultra/
 ├── state.db                 # authoritative SQLite store
 ├── workflow-state.json      # active workflow/recovery checkpoint
+├── changes/
+│   ├── active/<id>/         # intent, delta, plan, compiled context, verification
+│   └── archive/             # converged packets after baseline reconciliation
 ├── tasks/                   # projections and task contexts
 ├── specs/                   # research/product/architecture artifacts
 ├── sessions/                # bounded runtime artifacts