ultra-builder-pro-cli 0.9.0 → 0.11.0

package/adapters/_shared/tests/runtime-assets.test.cjs

@@ -11,8 +11,10 @@ const {
   INTERNAL_AGENT_SKILLS,
   SUPPORTED_RUNTIMES,
   COLLAB_SKILLS_BY_RUNTIME,
+  MCP_DEPENDENT_SKILLS,
   RETIRED_SKILLS,
   WORKFLOW_HOOK_FILES,
+  skillPolicy,
   skillsForRuntime,
 } = require('../runtime-assets.cjs');
 
@@ -74,15 +76,21 @@ test('runtime asset manifest exposes only Ultra-owned core and internal skills',
   }
 });
 
-test('code-review-expert and rule skills are internal, never implicitly exposed', () => {
-  const codexAssets = fs.readFileSync(path.join(REPO_ROOT, 'adapters', '_shared', 'codex-assets.cjs'), 'utf8');
-  assert.match(codexAssets, /const INTERNAL_SKILLS = new Set\(INTERNAL_AGENT_SKILLS\)/);
-  assert.match(codexAssets, /INTERNAL_SKILLS\.has\(name\)/);
+test('host invocation and MCP metadata live outside source SKILL frontmatter', () => {
+  const all = new Set(SUPPORTED_RUNTIMES.flatMap((runtime) => skillsForRuntime(runtime)));
+  for (const name of all) {
+    const policy = skillPolicy(name);
+    assert.equal(policy.allowImplicitInvocation, false, name);
+    assert.equal(policy.userInvocable, !INTERNAL_AGENT_SKILLS.includes(name), name);
+    assert.equal(policy.requiresUltraMcp, MCP_DEPENDENT_SKILLS.includes(name), name);
+  }
+  assert.throws(() => skillPolicy('not-packaged'), /unknown packaged Ultra skill/);
 });
 
 test('workflow hook allowlist contains no memory, prompt capture, or generic policy hook', () => {
   assert.deepEqual(WORKFLOW_HOOK_FILES, [
     'active_task_context.py',
+    'context_spine.py',
     'health_check.py',
     'pre_stop_check.py',
     'subagent_tracker.py',

package/adapters/claude.js

@@ -15,10 +15,12 @@ const {
   writeAtomic,
 } = require('./_shared/file-ops.cjs');
 const { buildMcpRuntime } = require('./_shared/codex-assets.cjs');
+const { parse: parseFrontmatter, serialize: serializeFrontmatter } = require('./_shared/frontmatter.cjs');
 const provenance = require('./_shared/provenance.cjs');
 const {
   CORE_PUBLIC_SKILLS,
   WORKFLOW_HOOK_FILES,
+  skillPolicy,
   skillsForRuntime,
 } = require('./_shared/runtime-assets.cjs');
 
@@ -46,12 +48,33 @@ function resolveRepoRoot(ctx = {}) {
   return ctx.repoRoot || path.resolve(__dirname, '..');
 }
 
-function copyNamedDirectories(repoRoot, target, parent, names) {
+function copySkills(repoRoot, target, names) {
   const copied = [];
   for (const name of names) {
-    const source = path.join(repoRoot, parent, name);
-    if (!fs.existsSync(source)) throw new Error(`missing allowlisted Claude asset: ${parent}/${name}`);
-    const files = copyTree(source, path.join(target, parent, name));
+    const source = path.join(repoRoot, 'skills', name);
+    if (!fs.existsSync(source)) throw new Error(`missing allowlisted Claude skill: ${name}`);
+    const files = copyTree(source, path.join(target, 'skills', name), {
+      transform(buf, rel) {
+        if (rel !== 'SKILL.md') return buf;
+        const { fm, body } = parseFrontmatter(buf.toString('utf8'));
+        if (!fm) throw new Error(`missing frontmatter in Claude skill: ${name}`);
+        let adaptedBody = body;
+        if (name === 'learn') {
+          adaptedBody = adaptedBody.replaceAll("current host's user skill directory", '`~/.claude/skills`');
+        }
+        if (name === 'ultra-review') {
+          adaptedBody = adaptedBody.replaceAll(
+            "the current host's native bounded-worker mechanism",
+            'Claude Code Task workers using the installed review agent definitions',
+          );
+        }
+        return Buffer.from(serializeFrontmatter({
+          name,
+          description: fm.description,
+          'user-invocable': skillPolicy(name).userInvocable,
+        }, adaptedBody));
+      },
+    });
     copied.push(...files.map((rel) => path.join(name, rel)));
   }
   return copied;
@@ -126,7 +149,7 @@ function install(ctx = {}) {
 
   const report = { target, copied: {}, config: { updated: false } };
   report.copied.commands = copyCommands(repoRoot, target);
-  report.copied.skills = copyNamedDirectories(repoRoot, target, 'skills', skillsForRuntime('claude'));
+  report.copied.skills = copySkills(repoRoot, target, skillsForRuntime('claude'));
   report.copied.agents = copyTree(path.join(repoRoot, 'agents'), path.join(target, 'agents'));
 
   ensureDir(path.join(target, 'hooks'));

package/adapters/kimi.js

@@ -76,154 +76,31 @@ function kimiTextTransform(input, assetName = '') {
   text = text.replaceAll('CLAUDE.md', 'AGENTS.md');
   text = text.replace(/@skills\/([a-z0-9-]+)\/SKILL\.md/g, '$KIMI_PLUGIN_ROOT/skills/$1/SKILL.md');
 
-  text = text.replaceAll('`TaskCreate/TaskUpdate (session-local)`', 'Kimi `TodoList` (session-local)');
-  text = text.replaceAll('TaskCreate/TaskUpdate (session-local)', 'Kimi `TodoList` (session-local)');
-  text = text.replaceAll('`TaskCreate/TaskUpdate`', 'Kimi `TodoList`');
-  text = text.replaceAll('TaskCreate/TaskUpdate', 'Kimi `TodoList`');
-  text = text.replaceAll('`TaskCreate`', 'Kimi `TodoList`');
-  text = text.replaceAll('`TaskUpdate`', 'Kimi `TodoList`');
-  text = text.replaceAll('`TaskList`', 'the current Kimi `TodoList`');
-  text = text.replaceAll('TaskCreate', 'Kimi TodoList item creation');
-  text = text.replaceAll('TaskUpdate', 'Kimi TodoList updates');
-  text = text.replaceAll('TaskList', 'the current Kimi TodoList');
-  text = text.replaceAll('TaskOutput', 'subagent transcript output');
-  text = text.replaceAll('Claude Task tool', 'Kimi `AgentSwarm`');
-  text = text.replaceAll('Task tool', 'Kimi `AgentSwarm`');
-  text = text.replaceAll('multiple Task calls', 'one Kimi `AgentSwarm` call with multiple independent tasks');
-  text = text.replaceAll('Task calls', 'Kimi `AgentSwarm` items');
-  text = text.replaceAll('Task call', 'Kimi `AgentSwarm` item');
-  text = text.replaceAll('`run_in_background: true`', 'Kimi `AgentSwarm` parallel execution');
-  text = text.replaceAll('run_in_background: true', 'Kimi `AgentSwarm` parallel execution');
-  text = text.replaceAll('AskUserQuestion', 'a direct question to the user');
-  text = text.replaceAll('Bash tool', 'Kimi `Bash` tool');
-  text = text.replaceAll('Use Bash', 'Use Kimi `Bash`');
-  text = text.replaceAll('Read tool', 'Kimi `Read` tool');
-  text = text.replaceAll('Write tool', 'Kimi `Write` tool');
-  text = text.replaceAll('MCP `review.run`', 'Kimi `AgentSwarm` review workers');
-  text = text.replaceAll('`review.run`', 'Kimi `AgentSwarm` review workers');
-  text = text.replaceAll('review.run', 'Kimi `AgentSwarm` review workers');
-  text = text.replaceAll('MCP `ask.question`', 'a direct question to the user');
-  text = text.replaceAll('`ask.question`', 'a direct question to the user');
-  text = text.replaceAll('ask.question', 'a direct question to the user');
-  text = text.replaceAll('Claude runtime', 'Kimi runtime');
-  text = text.replaceAll('Claude-only', 'Kimi-only');
-  text = text.replaceAll('Claude Code、OpenCode、Codex 三个 runtime', 'Claude Code、OpenCode、Codex、Kimi Code 四个 runtime');
-  text = text.replaceAll('Claude Code, OpenCode, and Codex', 'Claude Code, OpenCode, Codex, and Kimi Code');
-
   if (assetName === 'codex-collab') {
+    text = text.replaceAll('the current host', 'Kimi Code');
+    text = text.replaceAll('current host', 'Kimi Code');
     text = text.replaceAll('Claude Code remains primary', 'Kimi Code remains primary');
     text = text.replaceAll('one Claude Code-owned conclusion', 'one Kimi Code-owned conclusion');
   }
   if (assetName === 'ultra-verify') {
-    text = text.replaceAll('Claude Code remains primary', 'Kimi Code remains primary');
-    text = text.replaceAll("Claude Code's evidence-backed analysis", "Kimi Code's evidence-backed analysis");
-    text = text.replaceAll('Claude writes its analysis first', 'Kimi writes its analysis first');
-    text = text.replaceAll('Claude writes its own analysis', 'Kimi writes its own analysis');
+    text = text.replaceAll('the current host', 'Kimi Code');
+    text = text.replaceAll('current host', 'Kimi Code');
+    text = text.replaceAll('Claude Code', 'Kimi Code');
+    text = text.replaceAll('Claude', 'Kimi');
     text = text.replaceAll('claude-analysis.md', 'kimi-analysis.md');
-    text = text.replaceAll('one Claude Code-owned conclusion', 'one Kimi Code-owned conclusion');
   }
-  if (assetName === 'learn') {
-    text = text.replaceAll(
-      '~/.kimi-code/skills/learned/<name>_unverified.md',
-      '~/.kimi-code/skills/learned-<name>-unverified/SKILL.md',
-    );
-    text = text.replaceAll(
-      '~/.kimi-code/skills/learned/<pattern-slug>_unverified.md',
-      '~/.kimi-code/skills/learned-<pattern-slug>-unverified/SKILL.md',
-    );
-    text = text.replaceAll(
-      '~/.kimi-code/skills/learned/<slug>_unverified.md',
-      '~/.kimi-code/skills/learned-<slug>-unverified/SKILL.md',
-    );
-    text = text.replaceAll('append the `_unverified` suffix to the filename', 'append `-unverified` to the skill directory name');
-    text = text.replaceAll('Never overwrite an existing unverified file', 'Never overwrite an existing learned skill directory');
-    text = text.replaceAll('remove the `_unverified` suffix', 'rename the directory to remove `-unverified` and update its frontmatter name');
-    text = text.replaceAll('(`pattern-slug-2_unverified.md`)', '(`learned-pattern-slug-2-unverified/`)');
-  }
-  if (assetName === 'ultra-init') {
-    text = text.replaceAll('调用方（Claude / CLI / SDK）', '调用方（Kimi / CLI / SDK）');
-    text = text.replace(
-      /- 如果调用方是 Claude，可在此用 Kimi `TodoList` 跟踪 Step 0–4 的 session 内进度\n  （这是 runtime 的 session-local 跟踪，不走 MCP）/,
-      '- 在 Kimi 中，用原生 `TodoList` 跟踪 Step 0–4 的 session 内进度；这是 session-local 协调，不走 MCP',
-    );
-    text = text.replace(
-      /## 调用方式（按 runtime）[\s\S]*?## 输出锚点/,
-      [
-        '## Kimi 调用方式',
-        '',
-        '| Runtime | 调用形态 |',
-        '|---------|----------|',
-        '| Kimi | `/ultra-builder-pro:ultra-init [name] [type] [stack] [git]` — 原生命令拉起此 skill |',
-        '',
-        '## 输出锚点',
-      ].join('\n'),
-    );
+  if (assetName === 'cc-collab') {
+    text = text.replaceAll('the current host', 'Kimi Code');
+    text = text.replaceAll('current host', 'Kimi Code');
   }
   if (assetName === 'ultra-review') {
-    text = text.replace(
-      '# /ultra-review - Ultra Review System',
-      `# /ultra-review - Ultra Review System
-
-## Kimi native worker contract
-
-Use one Kimi \`AgentSwarm\` call when two or more independent reviewers are selected; use one
-foreground Kimi \`Agent\` call when only one reviewer is selected. Each reviewer first reads its
-matching prompt template (for example \`$KIMI_PLUGIN_ROOT/agents/review-code.md\`) and writes only
-its JSON artifact under \`SESSION_PATH\`. Run the coordinator as a final foreground Kimi \`Agent\`
-after the reviewer artifacts are complete. Kimi has no custom-agent plugin manifest field; these
-bundled files are bounded prompt templates, not separately registered host agents.`,
-    );
-    const executionContract = [
-      '### Phase 3: Kimi Reviewer Execution (File-Based)',
-      '',
-      'When two or more reviewers are selected, call Kimi `AgentSwarm` exactly once and make it the',
-      'only tool call in that response. Use `subagent_type: "coder"`, a `prompt_template` containing',
-      '`{{item}}`, and the selected reviewer names as the `items` array. The filled prompt must tell',
-      'each reviewer to:',
-      '',
-      '1. Read `$KIMI_PLUGIN_ROOT/agents/{{item}}.md` and follow that bounded worker contract.',
-      '2. Review only `DIFF_FILES` / `DIFF_RANGE` and write',
-      '   `{SESSION_PATH}/{{item}}.json` using the schema at',
-      '   `$KIMI_PLUGIN_ROOT/skills/ultra-review/references/unified-schema.md`.',
-      '3. Report at most 12 findings with confidence >= 75, ordered by severity then confidence.',
-      '4. Return only `Wrote N findings (P0:X P1:X P2:X P3:X) to <filepath>` after the file exists.',
-      '',
-      'Kimi `AgentSwarm` is foreground and accepts at least two items; it has no',
-      '`run_in_background` field. When exactly one reviewer is selected, launch one foreground Kimi',
-      '`Agent` with `subagent_type: "coder"`, `run_in_background: false`, and the same file contract.',
-      'The short final lines may appear in the parent context; the JSON files remain the only findings',
-      'input to the coordinator.',
-      '',
-      '### Phase 4: Validate & Coordinate',
-      '',
-      '**Step 4a: validate reviewer artifacts** — after the foreground call returns, run:',
-      '',
-      '```bash',
-      'python3 "$KIMI_PLUGIN_ROOT/skills/ultra-review/scripts/review_wait.py" {SESSION_PATH} agents {AGENT_COUNT}',
-      '```',
-      '',
-      'Use only the valid `review-*.json` files reported by the waiter. A partial result is explicit;',
-      'zero valid reviewer files skips coordination and reports the failure.',
-      '',
-      '**Step 4b: coordinate** — Launch the coordinator with one foreground Kimi `Agent` call using',
-      '`subagent_type: "coder"` and `run_in_background: false`. Its prompt must first read',
-      '`$KIMI_PLUGIN_ROOT/agents/review-coordinator.md`, then read the valid reviewer JSON files,',
-      'deduplicate findings, and write `SUMMARY.md` plus `SUMMARY.json` under `SESSION_PATH`.',
-      '',
-      '**Step 4c: validate the summary** — after the coordinator returns, run:',
-      '',
-      '```bash',
-      'python3 "$KIMI_PLUGIN_ROOT/skills/ultra-review/scripts/review_wait.py" {SESSION_PATH} summary',
-      '```',
-      '',
-      'Read `SUMMARY.json` only after this validation succeeds.',
-    ].join('\n');
-    text = text.replace(
-      /### Phase 3:[\s\S]*?### Phase 5: Report to User/,
-      `${executionContract}\n\n### Phase 5: Report to User`,
+    text = text.replaceAll(
+      "the current host's native bounded-worker mechanism",
+      'Kimi `AgentSwarm` for parallel reviewers or one foreground Kimi `Agent` for a single reviewer, using the worker prompt files under `$KIMI_PLUGIN_ROOT/agents/`',
     );
-    text = text.replaceAll('Background Execution', 'Reviewer Execution');
-    text = text.replaceAll('Wait & Coordinate', 'Validate & Coordinate');
+  }
+  if (assetName === 'learn') {
+    text = text.replaceAll("current host's user skill directory", '`~/.kimi-code/skills`');
   }
   text = text.replace(
     /(^|[\s`("'])\/ultra-(?!builder-pro:)([a-z][a-z0-9-]*)/gm,

package/adapters/opencode.js

@@ -70,62 +70,29 @@ function openCodeTextTransform(input, assetName = '') {
   text = text.replaceAll('CLAUDE.md', 'AGENTS.md');
   text = text.replace(/@skills\/([a-z0-9-]+)\/SKILL\.md/g, '~/.config/opencode/skills/$1/SKILL.md');
 
-  text = text.replaceAll('TaskCreate/TaskUpdate (session-local)', 'the OpenCode plan (session-local)');
-  text = text.replaceAll('TaskCreate', 'an OpenCode plan item');
-  text = text.replaceAll('TaskUpdate', 'an OpenCode plan update');
-  text = text.replaceAll('TaskList', 'the current OpenCode plan');
-  text = text.replaceAll('`run_in_background: true`', 'concurrent OpenCode task execution');
-  text = text.replaceAll('run_in_background: true', 'concurrent OpenCode task execution');
-  text = text.replaceAll('Claude Task tool', 'OpenCode `task` tool');
-  text = text.replaceAll('Task tool', 'OpenCode `task` tool');
-  text = text.replaceAll('multiple Task calls', 'multiple OpenCode `task` calls');
-  text = text.replaceAll('Bash tool', 'OpenCode `bash` tool');
-  text = text.replaceAll('Read tool', 'OpenCode `read` tool');
-  text = text.replaceAll('Write tool', 'OpenCode `edit` tool');
-
-  text = text.replaceAll('MCP `review.run`', 'OpenCode native review subagents');
-  text = text.replaceAll('`review.run`', 'OpenCode native review subagents');
-  text = text.replaceAll('review.run', 'OpenCode native review subagents');
-  text = text.replaceAll('MCP `ask.question`', 'OpenCode `question` tool');
-  text = text.replaceAll('`ask.question`', 'OpenCode `question` tool');
-  text = text.replaceAll('ask.question', 'OpenCode question tool');
-  text = text.replaceAll('AskUserQuestion', 'OpenCode `question` tool');
-  text = text.replaceAll('ultra-tools ask --question … --options …', 'OpenCode `question` tool');
-  text = text.replaceAll('ultra-tools ask --question …', 'OpenCode `question` tool');
-  text = text.replaceAll('ultra-tools ask …', 'OpenCode `question` tool');
-  text = text.replaceAll('Claude runtime', 'OpenCode runtime');
-  text = text.replaceAll('Claude-only', 'OpenCode-only');
-
   if (assetName === 'codex-collab') {
-    text = text.replaceAll('within Claude Code', 'from OpenCode');
-    text = text.replaceAll('Claude Code remains primary', 'OpenCode remains primary');
-    text = text.replaceAll('Claude orchestrates', 'OpenCode remains primary and orchestrates');
-    text = text.replaceAll('Claude synthesizes', 'OpenCode verifies and synthesizes');
-    text = text.replaceAll("Claude's", "OpenCode's");
-    text = text.replaceAll('proceed with Claude-only analysis', 'proceed with OpenCode-only analysis');
+    text = text.replaceAll('the current host', 'OpenCode');
+    text = text.replaceAll('current host', 'OpenCode');
   }
   if (assetName === 'ultra-verify') {
+    text = text.replaceAll('the current host', 'OpenCode');
+    text = text.replaceAll('current host', 'OpenCode');
     text = text.replaceAll('claude-analysis.md', 'opencode-analysis.md');
     text = text.replaceAll('Claude Code', 'OpenCode');
     text = text.replaceAll('Claude', 'OpenCode');
   }
-  if (assetName === 'learn') {
-    text = text.replaceAll(
-      '~/.config/opencode/skills/learned/<name>_unverified.md',
-      '~/.config/opencode/skills/learned-<name>-unverified/SKILL.md',
-    );
-    text = text.replaceAll(
-      '~/.config/opencode/skills/learned/<pattern-slug>_unverified.md',
-      '~/.config/opencode/skills/learned-<pattern-slug>-unverified/SKILL.md',
-    );
+  if (assetName === 'cc-collab') {
+    text = text.replaceAll('the current host', 'OpenCode');
+    text = text.replaceAll('current host', 'OpenCode');
+  }
+  if (assetName === 'ultra-review') {
     text = text.replaceAll(
-      '~/.config/opencode/skills/learned/<slug>_unverified.md',
-      '~/.config/opencode/skills/learned-<slug>-unverified/SKILL.md',
+      "the current host's native bounded-worker mechanism",
+      'the OpenCode `task` tool using the installed bounded review agents',
     );
-    text = text.replaceAll('append the `_unverified` suffix to the filename', 'append `-unverified` to the skill directory name');
-    text = text.replaceAll('Never overwrite an existing unverified file', 'Never overwrite an existing learned skill directory');
-    text = text.replaceAll('remove the `_unverified` suffix', 'rename the directory to remove `-unverified` and update the frontmatter name');
-    text = text.replaceAll('(`pattern-slug-2_unverified.md`)', '(`learned-pattern-slug-2-unverified/`)');
+  }
+  if (assetName === 'learn') {
+    text = text.replaceAll("current host's user skill directory", '`~/.config/opencode/skills`');
   }
   return text;
 }
@@ -336,25 +303,26 @@ function pluginSource() {
   return `// Managed by Ultra Builder Pro. Rebuild through the adapter; do not edit in place.
 import fs from "node:fs";
 import path from "node:path";
+import { execFileSync } from "node:child_process";
 
 const TERMINAL = new Set(["committed", "completed", "done", "cancelled"]);
 const TASKS_PROJECTION = ".ultra/tasks/tasks.json";
-const PROVIDER_FIELDS = new Set(["provider", "project", "reference", "revision", "indexed_head", "status"]);
 
-function providerMetadata(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
-  const clean = {};
-  for (const [kind, ref] of Object.entries(value)) {
-    if (!["memory", "code_graph"].includes(kind) || !ref || typeof ref !== "object" || Array.isArray(ref)) continue;
-    clean[kind] = Object.fromEntries(Object.entries(ref).filter(([key]) => PROVIDER_FIELDS.has(key)));
+function gitHead(root) {
+  try {
+    return execFileSync("git", ["rev-parse", "HEAD"], {
+      cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"],
+    }).trim();
+  } catch {
+    return null;
   }
-  return clean;
 }
 
 function findUltraContext(directory) {
   let current = path.resolve(directory);
   while (true) {
     const ultra = path.join(current, ".ultra");
+    const currentHead = gitHead(current);
     const workflowFile = path.join(ultra, "workflow-state.json");
     const statePresent = fs.existsSync(path.join(ultra, "state.db"));
     let workflow = null;
@@ -375,11 +343,36 @@ function findUltraContext(directory) {
         if (!fs.existsSync(manifestPath)) continue;
         try {
           const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
-          if (manifest?.change) changes.push({
-            ...manifest.change,
-            providers: providerMetadata(manifest.providers),
+          if (manifest?.change) {
+            const compiledHead = manifest.git?.head ?? null;
+            const legacyContext = manifest.schema_version !== "2.0";
+            const headStale = Boolean(compiledHead && currentHead && compiledHead !== currentHead);
+            const blockers = Array.isArray(manifest.readiness?.blockers)
+              ? [...manifest.readiness.blockers]
+              : [];
+            if (headStale && !blockers.includes("CONTEXT_HEAD_STALE")) blockers.push("CONTEXT_HEAD_STALE");
+            if (legacyContext && !blockers.includes("CONTEXT_SNAPSHOT_UPGRADE_REQUIRED")) {
+              blockers.unshift("CONTEXT_SNAPSHOT_UPGRADE_REQUIRED");
+            }
+            changes.push({
+            id: manifest.change.id,
+            kind: manifest.change.kind,
+            status: manifest.change.status,
+            role: manifest.role ?? "plan",
+            gate: manifest.gate ?? "alignment",
+            nextAction: legacyContext
+              ? "Recompile change.context to upgrade this legacy context snapshot."
+              : headStale
+              ? "Git HEAD changed after context compilation; recompile change.context."
+              : (manifest.next_action ?? "Inspect Ultra status."),
+            readiness: legacyContext || headStale ? "blocked" : (manifest.readiness?.status ?? "ready"),
+            blockers,
+            taskId: manifest.selected_task?.id ?? manifest.resume?.task_id ?? null,
+            taskStatus: manifest.selected_task?.status ?? manifest.resume?.task_status ?? null,
+            tokenEstimate: manifest.context?.token_estimate ?? 0,
             manifestPath: path.relative(current, manifestPath),
           });
+          }
         } catch (error) {
           process.stderr.write(\`[ultra-builder-pro] cannot read \${manifestPath}: \${error.message}\\n\`);
         }
@@ -410,13 +403,16 @@ function contextText(active) {
   if (active.changes.length > 0) {
     const change = active.changes[0];
     lines.push(
-      "[Ultra continuous change]",
+      "[Ultra context spine]",
       \`Project: \${active.root}\`,
       \`Change: \${change.id} (\${change.kind ?? "unknown"}, \${change.status ?? "active"})\`,
-      \`Title: \${change.title ?? "unknown"}\`,
-      \`Intent: \${change.intent ?? "unknown"}\`,
+      \`Task: \${change.taskId ?? "none"} (\${change.taskStatus ?? "none"})\`,
+      \`Role: \${change.role}\`,
+      \`Gate: \${change.gate}\`,
+      \`Readiness: \${change.readiness}\`,
+      ...(change.blockers.length > 0 ? [\`Blockers: \${change.blockers.join(", ")}\`] : []),
+      \`Next: \${change.nextAction}\`,
       \`Context manifest: \${change.manifestPath}\`,
-      \`External providers (metadata references only): \${JSON.stringify(change.providers)}\`,
     );
     if (active.changes.length > 1) lines.push(
       \`Active change count: \${active.changes.length}; resolve scope with change.list before mutation.\`,
@@ -429,7 +425,7 @@ function contextText(active) {
       "No active continuous change. Start daily work with the ultra-change workflow.",
     );
   }
-  lines.push("Authority: .ultra/state.db; generated JSON/Markdown are projections or artifacts.");
+  lines.push("Authority: .ultra/state.db; JSON/Markdown remain projections or evidence artifacts.");
   return lines.join("\\n");
 }
 

package/adapters/tests/claude.test.cjs

@@ -7,7 +7,12 @@ const os = require('node:os');
 const path = require('node:path');
 
 const claude = require('../claude.js');
-const { skillsForRuntime, WORKFLOW_HOOK_FILES } = require('../_shared/runtime-assets.cjs');
+const { parse: parseFrontmatter } = require('../_shared/frontmatter.cjs');
+const {
+  INTERNAL_AGENT_SKILLS,
+  skillsForRuntime,
+  WORKFLOW_HOOK_FILES,
+} = require('../_shared/runtime-assets.cjs');
 
 const REPO_ROOT = path.resolve(__dirname, '..', '..');
 
@@ -36,7 +41,10 @@ test('install builds the Claude-native plugin from the explicit Ultra allowlist'
 
     const hooks = JSON.parse(fs.readFileSync(path.join(target, 'hooks', 'hooks.json'), 'utf8'));
     const serialized = JSON.stringify(hooks);
-    for (const name of WORKFLOW_HOOK_FILES) assert.match(serialized, new RegExp(name.replace('.', '\\.')));
+    for (const name of WORKFLOW_HOOK_FILES.filter((value) => value !== 'context_spine.py')) {
+      assert.match(serialized, new RegExp(name.replace('.', '\\.')));
+    }
+    assert.ok(fs.existsSync(path.join(target, 'hooks', 'context_spine.py')));
     assert.doesNotMatch(serialized, /memory|recall|journal|observation_capture|user_prompt_capture|block_dangerous|post_edit_guard/);
     assert.match(serialized, /\$\{CLAUDE_PLUGIN_ROOT\}/);
   } finally {
@@ -57,17 +65,26 @@ test('Claude plugin collaboration and learn workflows are safe native plugin ass
     const plan = read('ultra-plan');
     const status = read('ultra-status');
 
-    assert.match(learn, /~\/.claude\/skills\/learned-<pattern-slug>-unverified\/SKILL\.md/);
-    assert.doesNotMatch(learn, /_unverified\.md/);
+    assert.match(learn, /`~\/.claude\/skills`/);
+    assert.doesNotMatch(learn, /_unverified|learned-[^\s/]*-unverified/i);
     assert.match(codexCollab, /-s read-only/);
+    assert.match(codexCollab, /--ephemeral/);
+    assert.match(codexCollab, /--ignore-user-config/);
     assert.match(verify, /-s read-only/);
-    assert.match(verify, /\$CLAUDE_PLUGIN_ROOT\/skills\/ultra-verify\/scripts\/verify_wait\.py/);
-    assert.match(review, /\$CLAUDE_PLUGIN_ROOT\/skills\/ultra-review\/scripts\/review_wait\.py/);
-    assert.match(plan, /LEGACY_STATE_MIGRATION_REQUIRED/);
-    assert.match(plan, /never read or write .*tasks\.json/i);
-    assert.match(status, /never fall back .*tasks\.json/i);
+    assert.match(verify, /--ephemeral/);
+    assert.match(verify, /scripts\/verify_wait\.py/);
+    assert.match(review, /Claude Code Task workers/);
+    assert.match(review, /scripts\/review_wait\.py/);
+    assert.doesNotMatch(plan, /LEGACY_STATE_MIGRATION_REQUIRED|v4\.4|v4\.5/);
+    assert.match(plan, /Never read or\s+write .*tasks\.json/i);
+    assert.match(status, /Never fall\s+back to generated task JSON/i);
     assert.doesNotMatch(plan, /ultra-tools task create/);
 
+    for (const name of skillsForRuntime('claude')) {
+      const { fm } = parseFrontmatter(read(name));
+      assert.equal(fm['user-invocable'], !INTERNAL_AGENT_SKILLS.includes(name), name);
+    }
+
     for (const [name, contents] of Object.entries({ codexCollab, verify })) {
       assert.doesNotMatch(contents, /--yolo|--full-auto|\/codex:/, name);
     }

package/adapters/tests/codex.test.cjs

@@ -14,6 +14,7 @@ const codex = require('../codex.js');
 const { parse: parseFrontmatter } = require('../_shared/frontmatter.cjs');
 const PACKAGE_VERSION = require('../../package.json').version;
 const {
+  MCP_DEPENDENT_SKILLS,
   skillsForRuntime,
   WORKFLOW_HOOK_FILES,
 } = require('../_shared/runtime-assets.cjs');
@@ -40,6 +41,7 @@ const AGENTS = [
   'review-coordinator',
   'review-design',
   'review-errors',
+  'review-spec',
   'review-tests',
   'tdd-runner',
 ];
@@ -122,12 +124,22 @@ test('every generated skill is Codex-valid, UI-visible, and free of Claude host
         /~\/\.claude|CLAUDE\.md|AskUserQuestion|(^|[\s`(>])\/(?:ultra-[a-z-]+|recall|learn|codex-collab)(?=$|[\s`,.;):])/m,
       );
       assert.doesNotMatch(text, /TaskCreate|TaskUpdate|TaskList|TaskOutput|run_in_background|~\/\.codex\/skills|mcp__claude/);
+      assert.doesNotMatch(text, /[\u3400-\u9fff]|ultra-review-findings-v1|Context7|Exa MCP|confidence\s*>=?\s*\d+/iu);
 
       const openai = yaml.load(fs.readFileSync(path.join(skillDir, 'agents', 'openai.yaml'), 'utf8'));
       assert.ok(openai.interface.display_name);
       assert.ok(openai.interface.short_description);
       assert.match(openai.interface.default_prompt, new RegExp(`\\$ultra-builder-pro:${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`));
-      assert.equal(typeof openai.policy.allow_implicit_invocation, 'boolean');
+      assert.equal(openai.policy.allow_implicit_invocation, false);
+      if (MCP_DEPENDENT_SKILLS.includes(name)) {
+        assert.deepEqual(openai.dependencies.tools, [{
+          type: 'mcp',
+          value: 'ultra-builder-pro',
+          description: 'Ultra Builder Pro authoritative task and change runtime',
+        }]);
+      } else {
+        assert.equal(openai.dependencies, undefined);
+      }
     }
 
     const cc = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'cc-collab', 'SKILL.md'), 'utf8');
@@ -146,13 +158,14 @@ test('every generated skill is Codex-valid, UI-visible, and free of Claude host
 
     const review = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-review', 'SKILL.md'), 'utf8');
     assert.match(review, /native Codex custom agents/);
-    assert.match(review, /~\/plugins\/ultra-builder-pro\/skills\/ultra-review/);
+    assert.match(review, /review-spec/);
+    assert.match(review, /scripts\/review_wait\.py/);
 
     const plan = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-plan', 'SKILL.md'), 'utf8');
     const status = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-status', 'SKILL.md'), 'utf8');
-    assert.match(plan, /LEGACY_STATE_MIGRATION_REQUIRED/);
-    assert.match(plan, /Never read or write .*tasks\.json/i);
-    assert.match(status, /Never fall back to .*tasks\.json/i);
+    assert.doesNotMatch(plan, /LEGACY_STATE_MIGRATION_REQUIRED|v4\.4|v4\.5/);
+    assert.match(plan, /Never read or\s+write .*tasks\.json/i);
+    assert.match(status, /Never fall\s+back to generated task JSON/i);
 
     const coreWorkflowText = [
       ...COMMANDS,
@@ -168,7 +181,7 @@ test('every generated skill is Codex-valid, UI-visible, and free of Claude host
   }
 });
 
-test('install converts all nine Claude agents into native Codex agent TOML', () => {
+test('install converts all bundled agent prompts into native Codex agent TOML', () => {
   const layout = mkLayout();
   try {
     const report = install(layout);
@@ -198,9 +211,10 @@ test('plugin declares current Codex hooks and a project-local Ultra MCP server',
       'SubagentStart', 'SubagentStop',
     ].sort());
     const serializedHooks = JSON.stringify(hooks);
-    for (const feature of WORKFLOW_HOOK_FILES) {
+    for (const feature of WORKFLOW_HOOK_FILES.filter((value) => value !== 'context_spine.py')) {
       assert.match(serializedHooks, new RegExp(feature.replace('.', '\\.')));
     }
+    assert.ok(fs.existsSync(path.join(layout.pluginRoot, 'hooks', 'context_spine.py')));
     assert.doesNotMatch(serializedHooks, /memory|recall|journal|observation_capture|user_prompt_capture|block_dangerous|post_edit_guard/);
     assert.match(serializedHooks, /\$PLUGIN_ROOT\/hooks\/adapters\/codex\.py/);
     assert.match(serializedHooks, /apply_patch/);
@@ -231,8 +245,8 @@ test('plugin declares current Codex hooks and a project-local Ultra MCP server',
     const liveSpec = yaml.load(fs.readFileSync(path.join(layout.pluginRoot, 'spec', 'mcp-tools.yaml'), 'utf8'));
     const upstreamSpec = yaml.load(fs.readFileSync(path.join(layout.pluginRoot, 'spec', 'upstream-mcp-tools.yaml'), 'utf8'));
     const capabilityMap = JSON.parse(fs.readFileSync(path.join(layout.pluginRoot, 'spec', 'codex-capability-map.json'), 'utf8'));
-    assert.equal(liveSpec.tools.length, 29);
-    assert.equal(upstreamSpec.tools.length, 29);
+    assert.equal(liveSpec.tools.length, 32);
+    assert.equal(upstreamSpec.tools.length, 32);
     assert.deepEqual(upstreamSpec.tools.map((tool) => tool.name).sort(), liveSpec.tools.map((tool) => tool.name).sort());
     assert.deepEqual(capabilityMap.live_mcp_tools.sort(), liveSpec.tools.map((tool) => tool.name).sort());
     assert.equal(Object.keys(capabilityMap.codex_native_replacements).length, 9);