ultra-builder-pro-cli 0.5.3 → 0.7.0

package/adapters/_shared/handbook.cjs

@@ -14,22 +14,22 @@ const HOSTS = Object.freeze({
   claude: Object.freeze({
     name: 'Claude Code',
     handbook: ['.claude', 'CLAUDE.md'],
-    invocation: '`/ultra-init`, `/ultra-research`, `/ultra-plan`, `/ultra-dev`, `/ultra-test`, `/ultra-review`, and `/ultra-deliver`; diagnostics use `/ultra-status` and `/ultra-think`',
-    collaboration: '`/codex-collab` and `/gemini-collab` are explicitly requested read-only advisors',
+    invocation: '`/ultra-init`, `/ultra-research`, `/ultra-plan`, `/ultra-change`, `/ultra-dev`, `/ultra-test`, `/ultra-review`, and `/ultra-deliver`; diagnostics use `/ultra-status`, `/ultra-think`, and `/ultra-doctor`',
+    collaboration: '`/codex-collab` is an explicitly requested read-only advisor',
     coordination: 'Claude Code task UI is host coordination; it does not replace Ultra task state',
   }),
   codex: Object.freeze({
     name: 'Codex',
     handbook: ['.codex', 'AGENTS.md'],
-    invocation: '`$ultra-builder-pro:ultra-init`, `$ultra-builder-pro:ultra-research`, `$ultra-builder-pro:ultra-plan`, `$ultra-builder-pro:ultra-dev`, `$ultra-builder-pro:ultra-test`, `$ultra-builder-pro:ultra-review`, and `$ultra-builder-pro:ultra-deliver`; diagnostics use `$ultra-builder-pro:ultra-status` and `$ultra-builder-pro:ultra-think`',
-    collaboration: '`$ultra-builder-pro:cc-collab` and `$ultra-builder-pro:gemini-collab` are explicitly requested read-only advisors',
+    invocation: '`$ultra-builder-pro:ultra-init`, `$ultra-builder-pro:ultra-research`, `$ultra-builder-pro:ultra-plan`, `$ultra-builder-pro:ultra-change`, `$ultra-builder-pro:ultra-dev`, `$ultra-builder-pro:ultra-test`, `$ultra-builder-pro:ultra-review`, and `$ultra-builder-pro:ultra-deliver`; diagnostics use `$ultra-builder-pro:ultra-status`, `$ultra-builder-pro:ultra-think`, and `$ultra-builder-pro:ultra-doctor`',
+    collaboration: '`$ultra-builder-pro:cc-collab` is an explicitly requested read-only advisor',
     coordination: 'The Codex plan is turn-facing coordination; it does not replace Ultra task state',
   }),
   opencode: Object.freeze({
     name: 'OpenCode',
     handbook: ['.config', 'opencode', 'AGENTS.md'],
-    invocation: '`/ultra-init`, `/ultra-research`, `/ultra-plan`, `/ultra-dev`, `/ultra-test`, `/ultra-review`, and `/ultra-deliver`; diagnostics use `/ultra-status` and `/ultra-think`',
-    collaboration: '`/cc-collab`, `/codex-collab`, and `/gemini-collab` are explicitly requested read-only advisors',
+    invocation: '`/ultra-init`, `/ultra-research`, `/ultra-plan`, `/ultra-change`, `/ultra-dev`, `/ultra-test`, `/ultra-review`, and `/ultra-deliver`; diagnostics use `/ultra-status`, `/ultra-think`, and `/ultra-doctor`',
+    collaboration: '`/cc-collab` and `/codex-collab` are explicitly requested read-only advisors',
     coordination: 'OpenCode session coordination does not replace Ultra task state',
   }),
 });
@@ -52,11 +52,11 @@ function renderHandbook(runtime) {
     `- Workflow entry points: ${value.invocation}.`,
     `- Collaboration boundary: ${value.collaboration}. The current host remains primary and owns final verification.`,
     `- Coordination boundary: ${value.coordination}.`,
-    '- Authority: `.ultra/state.db` is the only durable Ultra authority for tasks, sessions, events, telemetry, and review evidence. Generated JSON and Markdown are projections or workflow artifacts.',
-    '- Memory boundary: Ultra Builder Pro does not capture prompts, transcripts, observations, summaries, or cross-session memory. Persistent memory belongs to a separately installed provider such as cloud-mem or claude-mem.',
-    '- Hook boundary: Ultra hooks are workflow-only lifecycle adapters and are no-ops unless `.ultra/workflow-state.json` describes an active non-terminal workflow. Generic command blocking and post-edit policy stay in user or repository governance.',
+    '- Authority: `.ultra/state.db` is the only durable Ultra authority for changes, tasks, sessions, events, incidents, projection state, telemetry, and review evidence. Generated JSON and Markdown are projections or workflow artifacts.',
+    '- Memory and graph boundary: Ultra Builder Pro does not capture prompts, transcripts, observations, summaries, cross-session memory, or code-graph content. Separately installed providers own that data; Ultra may store only their metadata references in a change context manifest.',
+    '- Hook boundary: Ultra hooks observe workflow/change lifecycle only. Health/context may run when `.ultra/state.db` exists; projection protection is always authoritative, while edit/compact/stop/subagent enforcement remains active-workflow scoped. Generic command blocking and post-edit policy stay in user or repository governance.',
     '- Agent boundary: the bundled review and debugging agents are bounded workers. They use the current checkout and parent-supplied context, do not own private persistent state, and never replace the primary agent.',
-    '- Package boundary: only the ten Ultra workflows, four internal review-rule skills, and host-specific collaboration companions belong to this plugin. General browser, deployment, discovery, and framework skills must be installed from their owners.',
+    '- Package boundary: only the twelve Ultra workflows, four internal review-rule skills, and host-specific collaboration companions belong to this plugin. General browser, deployment, discovery, and framework skills must be installed from their owners.',
     END_MARKER,
   ].join('\n');
 }

package/adapters/_shared/path-rewrite.cjs

@@ -14,7 +14,6 @@ const RUNTIME_SKILL_ROOT = {
   claude: '.claude/skills',
   opencode: '.config/opencode/skills',
   codex: '.agents/skills',
-  gemini: '.gemini/extensions/ultra-builder-pro/skills',
 };
 
 function parseSkillRef(ref) {
@@ -52,7 +51,6 @@ function runtimeRoot(runtime) {
     case 'claude': return '.claude';
     case 'opencode': return '.config/opencode';
     case 'codex': return '.agents';
-    case 'gemini': return '.gemini/extensions/ultra-builder-pro';
     default: throw new Error(`unknown runtime: ${runtime}`);
   }
 }
@@ -62,7 +60,6 @@ function localRoot(runtime) {
     case 'claude': return '.claude';
     case 'opencode': return '.opencode';
     case 'codex': return '.agents';
-    case 'gemini': return '.gemini/extensions/ultra-builder-pro';
     default: throw new Error(`unknown runtime: ${runtime}`);
   }
 }

package/adapters/_shared/runtime-assets.cjs

@@ -18,6 +18,8 @@ const CORE_PUBLIC_SKILLS = Object.freeze([
   'ultra-deliver',
   'ultra-status',
   'ultra-think',
+  'ultra-change',
+  'ultra-doctor',
 ]);
 
 const INTERNAL_AGENT_SKILLS = Object.freeze([
@@ -27,11 +29,12 @@ const INTERNAL_AGENT_SKILLS = Object.freeze([
   'testing-rules',
 ]);
 
+const SUPPORTED_RUNTIMES = Object.freeze(['claude', 'opencode', 'codex']);
+
 const COLLAB_SKILLS_BY_RUNTIME = Object.freeze({
-  claude: Object.freeze(['codex-collab', 'gemini-collab', 'ultra-verify']),
-  codex: Object.freeze(['cc-collab', 'gemini-collab', 'ultra-verify']),
-  opencode: Object.freeze(['cc-collab', 'codex-collab', 'gemini-collab', 'ultra-verify']),
-  gemini: Object.freeze(['cc-collab', 'codex-collab', 'ultra-verify']),
+  claude: Object.freeze(['codex-collab', 'ultra-verify']),
+  codex: Object.freeze(['cc-collab', 'ultra-verify']),
+  opencode: Object.freeze(['cc-collab', 'codex-collab', 'ultra-verify']),
 });
 
 const RETIRED_SKILLS = Object.freeze([
@@ -60,11 +63,17 @@ function skillsForRuntime(runtime) {
   return [...CORE_PUBLIC_SKILLS, ...INTERNAL_AGENT_SKILLS, ...collab];
 }
 
+function isSupportedRuntime(runtime) {
+  return SUPPORTED_RUNTIMES.includes(runtime);
+}
+
 module.exports = {
   CORE_PUBLIC_SKILLS,
   INTERNAL_AGENT_SKILLS,
+  SUPPORTED_RUNTIMES,
   COLLAB_SKILLS_BY_RUNTIME,
   RETIRED_SKILLS,
   WORKFLOW_HOOK_FILES,
+  isSupportedRuntime,
   skillsForRuntime,
 };

package/adapters/_shared/tests/handbook.test.cjs

@@ -25,7 +25,10 @@ test('renders one common contract with host-native invocation syntax', () => {
   assert.match(opencode, /\/ultra-plan/);
   for (const rendered of [claude, codex, opencode]) {
     assert.match(rendered, /\.ultra\/state\.db/);
-    assert.match(rendered, /claude-mem|cloud-mem/);
+    assert.match(rendered, /Separately installed providers/);
+    assert.match(rendered, /ultra-change/);
+    assert.match(rendered, /ultra-doctor/);
+    assert.match(rendered, /metadata references/);
     assert.doesNotMatch(rendered, /\.ultra\/memory|memory\.retain|memory\.recall/);
     assert.match(rendered, new RegExp(BEGIN_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')));
     assert.match(rendered, new RegExp(END_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')));

package/adapters/_shared/tests/path-rewrite.test.cjs

@@ -26,12 +26,10 @@ test('resolveSkillRef routes to runtime-specific root under homeDir', () => {
   const claude = resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'claude', homeDir: home });
   const opencode = resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'opencode', homeDir: home });
   const codex = resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'codex', homeDir: home });
-  const gemini = resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'gemini', homeDir: home });
 
   assert.equal(claude, path.join(home, '.claude/skills/ultra-init/SKILL.md'));
   assert.equal(opencode, path.join(home, '.config/opencode/skills/ultra-init/SKILL.md'));
   assert.equal(codex, path.join(home, '.agents/skills/ultra-init/SKILL.md'));
-  assert.equal(gemini, path.join(home, '.gemini/extensions/ultra-builder-pro/skills/ultra-init/SKILL.md'));
 
   assert.throws(
     () => resolveSkillRef('@skills/ultra-init/SKILL.md', { runtime: 'unknown', homeDir: home }),
@@ -47,7 +45,7 @@ test('rewriteWorkflowRefInText + resolveAssetTarget give predictable paths', ()
   assert.equal(out, `see ${path.join(home, '.claude/skills/ultra-init/SKILL.md')} for details`);
 
   // Cover every runtime × every scope so runtimeRoot/localRoot branches hit
-  for (const rt of ['claude', 'opencode', 'codex', 'gemini']) {
+  for (const rt of ['claude', 'opencode', 'codex']) {
     const g = resolveAssetTarget('x', { runtime: rt, scope: 'global', homeDir: home, cwd });
     const l = resolveAssetTarget('x', { runtime: rt, scope: 'local', homeDir: home, cwd });
     assert.ok(g.startsWith(home));

package/adapters/_shared/tests/resolve-target.test.cjs

@@ -1,13 +1,10 @@
 'use strict';
 
-// Phase 4.6b reviewer suggestion — scope-precedence contract across all
-// four adapter.resolveTarget implementations.
+// Scope-precedence contract across every supported adapter.resolveTarget.
 //
 // Each adapter honors the same ordering:
 //   ctx.configDir  >  ctx.scope='global' → env var or homeDir/.<runtime>
 //                  >  ctx.scope='local'  → cwd/.<runtime>
-//
-// Gemini also exposes resolveExtensionRoot that appends extensions/<NAME>.
 
 const { test } = require('node:test');
 const assert = require('node:assert/strict');
@@ -16,7 +13,6 @@ const path = require('node:path');
 const claude = require('../../../adapters/claude.js');
 const opencode = require('../../../adapters/opencode.js');
 const codex = require('../../../adapters/codex.js');
-const gemini = require('../../../adapters/gemini.js');
 
 // Stable fake values so assertions don't depend on real $HOME / $CWD.
 const FAKE_HOME = '/fake-home';
@@ -43,7 +39,6 @@ const CASES = [
   { name: 'claude',   resolve: claude.resolveTarget,   localLeaf: '.claude',   globalHome: '.claude',   envKey: 'CLAUDE_CONFIG_DIR' },
   { name: 'opencode', resolve: opencode.resolveTarget, localLeaf: '.opencode', globalHome: path.join('.config', 'opencode'), envKey: 'OPENCODE_CONFIG_DIR' },
   { name: 'codex',    resolve: codex.resolveTarget,    localLeaf: '.codex',    globalHome: '.codex',    envKey: 'CODEX_HOME' },
-  { name: 'gemini',   resolve: gemini.resolveTarget,   localLeaf: '.gemini',   globalHome: '.gemini',   envKey: 'GEMINI_CONFIG_DIR' },
 ];
 
 for (const tc of CASES) {
@@ -78,8 +73,3 @@ for (const tc of CASES) {
     assert.equal(out, path.join(FAKE_CWD, tc.localLeaf));
   });
 }
-
-test('gemini.resolveExtensionRoot layers extensions/<NAME> on top of resolveTarget', () => {
-  const out = gemini.resolveExtensionRoot({ configDir: '/explicit' });
-  assert.equal(out, path.join('/explicit', 'extensions', 'ultra-builder-pro'));
-});

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

@@ -9,6 +9,7 @@ const REPO_ROOT = path.resolve(__dirname, '..', '..', '..');
 const {
   CORE_PUBLIC_SKILLS,
   INTERNAL_AGENT_SKILLS,
+  SUPPORTED_RUNTIMES,
   COLLAB_SKILLS_BY_RUNTIME,
   RETIRED_SKILLS,
   WORKFLOW_HOOK_FILES,
@@ -26,6 +27,8 @@ const CORE = [
   'ultra-deliver',
   'ultra-status',
   'ultra-think',
+  'ultra-change',
+  'ultra-doctor',
 ];
 
 const INTERNAL = [
@@ -51,19 +54,17 @@ test('runtime asset manifest exposes only Ultra-owned core and internal skills',
   assert.deepEqual(RETIRED_SKILLS, RETIRED);
 
   assert.deepEqual(COLLAB_SKILLS_BY_RUNTIME.claude, [
-    'codex-collab', 'gemini-collab', 'ultra-verify',
+    'codex-collab', 'ultra-verify',
   ]);
   assert.deepEqual(COLLAB_SKILLS_BY_RUNTIME.codex, [
-    'cc-collab', 'gemini-collab', 'ultra-verify',
+    'cc-collab', 'ultra-verify',
   ]);
   assert.deepEqual(COLLAB_SKILLS_BY_RUNTIME.opencode, [
-    'cc-collab', 'codex-collab', 'gemini-collab', 'ultra-verify',
-  ]);
-  assert.deepEqual(COLLAB_SKILLS_BY_RUNTIME.gemini, [
     'cc-collab', 'codex-collab', 'ultra-verify',
   ]);
+  assert.deepEqual(SUPPORTED_RUNTIMES, ['claude', 'opencode', 'codex']);
 
-  for (const runtime of ['claude', 'codex', 'opencode', 'gemini']) {
+  for (const runtime of SUPPORTED_RUNTIMES) {
     const names = skillsForRuntime(runtime);
     for (const retired of RETIRED) assert.ok(!names.includes(retired));
     assert.ok(!names.some((name) => /impeccable/i.test(name)));

package/adapters/opencode.js

@@ -94,7 +94,7 @@ function openCodeTextTransform(input, assetName = '') {
   text = text.replaceAll('Claude runtime', 'OpenCode runtime');
   text = text.replaceAll('Claude-only', 'OpenCode-only');
 
-  if (assetName === 'codex-collab' || assetName === 'gemini-collab') {
+  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');
@@ -104,13 +104,8 @@ function openCodeTextTransform(input, assetName = '') {
   }
   if (assetName === 'ultra-verify') {
     text = text.replaceAll('claude-analysis.md', 'opencode-analysis.md');
-    text = text.replaceAll('Claude + Gemini + Codex', 'OpenCode + Gemini + Codex');
     text = text.replaceAll('Claude Code', 'OpenCode');
     text = text.replaceAll('Claude', 'OpenCode');
-    text = text.replace(
-      /Orchestrate OpenCode \+ Gemini \+ Codex for independent three-way analysis\./,
-      'OpenCode remains primary while Gemini and Codex provide independent read-only analyses.',
-    );
   }
   if (assetName === 'learn') {
     text = text.replaceAll(
@@ -342,20 +337,55 @@ import path from "node:path";
 
 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)));
+  }
+  return clean;
+}
 
-function findActiveWorkflow(directory) {
+function findUltraContext(directory) {
   let current = path.resolve(directory);
   while (true) {
-    const file = path.join(current, ".ultra", "workflow-state.json");
-    if (fs.existsSync(file)) {
+    const ultra = path.join(current, ".ultra");
+    const workflowFile = path.join(ultra, "workflow-state.json");
+    const statePresent = fs.existsSync(path.join(ultra, "state.db"));
+    let workflow = null;
+    if (fs.existsSync(workflowFile)) {
       try {
-        const state = JSON.parse(fs.readFileSync(file, "utf8"));
-        return state && !TERMINAL.has(state.status) ? { root: current, state } : null;
+        const state = JSON.parse(fs.readFileSync(workflowFile, "utf8"));
+        workflow = state && !TERMINAL.has(state.status) ? state : null;
       } catch (error) {
-        process.stderr.write(\`[ultra-builder-pro] cannot read \${file}: \${error.message}\\n\`);
-        return null;
+        process.stderr.write(\`[ultra-builder-pro] cannot read \${workflowFile}: \${error.message}\\n\`);
       }
     }
+    const changes = [];
+    const changeRoot = path.join(ultra, "changes", "active");
+    if (fs.existsSync(changeRoot)) {
+      for (const entry of fs.readdirSync(changeRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue;
+        const manifestPath = path.join(changeRoot, entry.name, "context-manifest.json");
+        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),
+            manifestPath: path.relative(current, manifestPath),
+          });
+        } catch (error) {
+          process.stderr.write(\`[ultra-builder-pro] cannot read \${manifestPath}: \${error.message}\\n\`);
+        }
+      }
+    }
+    if (statePresent || workflow || changes.length > 0) {
+      return { root: current, workflow, changes, statePresent };
+    }
     const parent = path.dirname(current);
     if (parent === current) return null;
     current = parent;
@@ -363,16 +393,42 @@ function findActiveWorkflow(directory) {
 }
 
 function contextText(active) {
-  const state = active.state;
-  return [
-    "[Ultra active workflow]",
-    \`Project: \${active.root}\`,
-    \`Command: \${state.command ?? "unknown"}\`,
-    \`Task: \${state.task_id ?? state.task ?? "unknown"}\`,
-    \`Step: \${state.step ?? "unknown"}\`,
-    \`Status: \${state.status ?? "active"}\`,
-    "Authority: .ultra/state.db; recovery: .ultra/workflow-state.json.",
-  ].join("\\n");
+  const lines = [];
+  if (active.workflow) {
+    const state = active.workflow;
+    lines.push(
+      "[Ultra active workflow]",
+      \`Project: \${active.root}\`,
+      \`Command: \${state.command ?? "unknown"}\`,
+      \`Task: \${state.task_id ?? state.task ?? "unknown"}\`,
+      \`Step: \${state.step ?? "unknown"}\`,
+      \`Status: \${state.status ?? "active"}\`,
+    );
+  }
+  if (active.changes.length > 0) {
+    const change = active.changes[0];
+    lines.push(
+      "[Ultra continuous change]",
+      \`Project: \${active.root}\`,
+      \`Change: \${change.id} (\${change.kind ?? "unknown"}, \${change.status ?? "active"})\`,
+      \`Title: \${change.title ?? "unknown"}\`,
+      \`Intent: \${change.intent ?? "unknown"}\`,
+      \`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.\`,
+    );
+  }
+  if (!active.workflow && active.changes.length === 0) {
+    lines.push(
+      "[Ultra baseline]",
+      \`Project: \${active.root}\`,
+      "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.");
+  return lines.join("\\n");
 }
 
 function targetPaths(tool, args) {
@@ -396,8 +452,8 @@ function isTasksProjection(active, candidate) {
 
 export const UltraBuilderProPlugin = async ({ directory, worktree }) => {
   const root = worktree || directory;
-  let active = findActiveWorkflow(root);
-  const refresh = () => { active = findActiveWorkflow(root); };
+  let active = findUltraContext(root);
+  const refresh = () => { active = findUltraContext(root); };
   return {
     event: async ({ event }) => {
       if (["session.created", "session.compacted", "session.idle"].includes(event?.type)) refresh();
@@ -418,7 +474,7 @@ export const UltraBuilderProPlugin = async ({ directory, worktree }) => {
       if (targetPaths(tool, output?.args).some((candidate) => isTasksProjection(active, candidate))) {
         throw new Error(
           "Ultra Builder Pro refused a direct write to .ultra/tasks/tasks.json. " +
-          ".ultra/state.db is authoritative; use MCP task tools or run the required v4.4 to v4.5 migration."
+          ".ultra/state.db is authoritative; use MCP task tools and run ultra-doctor when state or projection health is degraded."
         );
       }
     },

package/adapters/tests/claude.test.cjs

@@ -52,7 +52,6 @@ test('Claude plugin collaboration and learn workflows are safe native plugin ass
     const read = (name) => fs.readFileSync(path.join(target, 'skills', name, 'SKILL.md'), 'utf8');
     const learn = read('learn');
     const codexCollab = read('codex-collab');
-    const geminiCollab = read('gemini-collab');
     const verify = read('ultra-verify');
     const review = read('ultra-review');
     const plan = read('ultra-plan');
@@ -61,8 +60,6 @@ test('Claude plugin collaboration and learn workflows are safe native plugin ass
     assert.match(learn, /~\/.claude\/skills\/learned-<pattern-slug>-unverified\/SKILL\.md/);
     assert.doesNotMatch(learn, /_unverified\.md/);
     assert.match(codexCollab, /-s read-only/);
-    assert.match(geminiCollab, /--approval-mode plan/);
-    assert.match(verify, /--approval-mode plan/);
     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/);
@@ -71,7 +68,7 @@ test('Claude plugin collaboration and learn workflows are safe native plugin ass
     assert.match(status, /never fall back .*tasks\.json/i);
     assert.doesNotMatch(plan, /ultra-tools task create/);
 
-    for (const [name, contents] of Object.entries({ codexCollab, geminiCollab, verify })) {
+    for (const [name, contents] of Object.entries({ codexCollab, verify })) {
       assert.doesNotMatch(contents, /--yolo|--full-auto|\/codex:/, name);
     }
   } finally {

package/adapters/tests/codex.test.cjs

@@ -21,8 +21,10 @@ const {
 const REPO_ROOT = path.resolve(__dirname, '..', '..');
 const COMMANDS = [
   'learn',
+  'ultra-change',
   'ultra-deliver',
   'ultra-dev',
+  'ultra-doctor',
   'ultra-init',
   'ultra-plan',
   'ultra-research',
@@ -89,7 +91,7 @@ test('install builds one Codex-native plugin with complete skill and command cov
 
     const expectedSkills = skillsForRuntime('codex').sort();
     assert.deepEqual(skillNames(layout.pluginRoot), expectedSkills);
-    assert.equal(expectedSkills.length, 17);
+    assert.equal(expectedSkills.length, 18);
     assert.ok(!fs.existsSync(path.join(layout.pluginRoot, 'skills', 'codex-collab')));
     assert.ok(!fs.existsSync(path.join(layout.pluginRoot, 'skills', 'learned')));
 
@@ -117,7 +119,7 @@ test('every generated skill is Codex-valid, UI-visible, and free of Claude host
       assert.equal(fm.name, name);
       assert.doesNotMatch(
         text,
-        /~\/\.claude|CLAUDE\.md|AskUserQuestion|(^|[\s`(>])\/(?:ultra-[a-z-]+|recall|learn|gemini-collab|codex-collab)(?=$|[\s`,.;):])/m,
+        /~\/\.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/);
 
@@ -135,13 +137,12 @@ test('every generated skill is Codex-valid, UI-visible, and free of Claude host
     const verify = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-verify', 'SKILL.md'), 'utf8');
     assert.match(verify, /Codex owns the task/);
     assert.match(verify, /claude --safe-mode/);
-    assert.match(verify, /gemini --approval-mode plan/);
     assert.match(verify, /codex-analysis\.md/);
     assert.doesNotMatch(verify, /codex-output\.md|Claude synthesizes|Claude-only/);
 
     const waiter = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-verify', 'scripts', 'verify_wait.py'), 'utf8');
-    assert.match(waiter, /"claude": "claude-output\.md"/);
-    assert.doesNotMatch(waiter, /"codex": "codex-output\.md"/);
+    assert.match(waiter, /ADVISOR = "claude"/);
+    assert.match(waiter, /OUTPUT_FILE = "claude-output\.md"/);
 
     const review = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-review', 'SKILL.md'), 'utf8');
     assert.match(review, /native Codex custom agents/);
@@ -179,7 +180,7 @@ test('install converts all nine Claude agents into native Codex agent TOML', ()
       assert.match(text, /^developer_instructions = """/m);
       assert.doesNotMatch(
         text,
-        /model = "opus"|^tools =|^memory =|maxTurns|CLAUDE\.md|AskUserQuestion|(^|[\s`(>])\/(?:ultra-[a-z-]+|recall|learn|gemini-collab|codex-collab)(?=$|[\s`,.;):])/m,
+        /model = "opus"|^tools =|^memory =|maxTurns|CLAUDE\.md|AskUserQuestion|(^|[\s`(>])\/(?:ultra-[a-z-]+|recall|learn|codex-collab)(?=$|[\s`,.;):])/m,
       );
     }
   } finally {
@@ -230,8 +231,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, 21);
-    assert.equal(upstreamSpec.tools.length, 21);
+    assert.equal(liveSpec.tools.length, 29);
+    assert.equal(upstreamSpec.tools.length, 29);
     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);

package/adapters/tests/opencode.test.cjs

@@ -60,7 +60,6 @@ test('install performs content-level OpenCode adaptation for commands, skills, r
     const learn = fs.readFileSync(path.join(target, 'skills', 'learn', 'SKILL.md'), 'utf8');
     const review = fs.readFileSync(path.join(target, 'skills', 'ultra-review', 'SKILL.md'), 'utf8');
     const codexCollab = fs.readFileSync(path.join(target, 'skills', 'codex-collab', 'SKILL.md'), 'utf8');
-    const geminiCollab = fs.readFileSync(path.join(target, 'skills', 'gemini-collab', 'SKILL.md'), 'utf8');
     const verify = fs.readFileSync(path.join(target, 'skills', 'ultra-verify', 'SKILL.md'), 'utf8');
 
     assert.deepEqual(Object.keys(parseFm(plan).fm), ['name', 'description']);
@@ -68,9 +67,9 @@ test('install performs content-level OpenCode adaptation for commands, skills, r
     assert.doesNotMatch(learn, /_unverified\.md/);
     assert.match(review, /~\/.config\/opencode\/skills\/ultra-review\/scripts\/review_wait\.py/);
     assert.match(codexCollab, /OpenCode remains primary/);
-    assert.match(geminiCollab, /OpenCode remains primary/);
     assert.match(verify, /OpenCode remains primary/);
     assert.match(verify, /opencode-analysis\.md/);
+    assert.match(verify, /codex exec -s read-only/);
     assert.match(plan, /LEGACY_STATE_MIGRATION_REQUIRED/);
     assert.match(plan, /never read or write .*tasks\.json/i);
     assert.doesNotMatch(plan, /ultra-tools task create/);
@@ -172,13 +171,14 @@ test('install writes a schema-safe opencode.json and keeps ownership outside hos
     assert.match(plugin, /\.ultra[\\/]tasks[\\/]tasks\.json/);
     assert.match(plugin, /throw new Error/);
     assert.match(plugin, /session\.compacted/);
-    assert.doesNotMatch(plugin, /memory|recall|journal|observation/);
+    assert.doesNotMatch(plugin, /memory\.(?:retain|recall|reflect)|journal|observation|prompt[_ -]?capture/);
+    assert.match(plugin, /metadata references only/);
   } finally {
     fs.rmSync(target, { recursive: true, force: true });
   }
 });
 
-test('OpenCode before-tool hook blocks tasks.json writes only during an active workflow', async () => {
+test('OpenCode context covers active changes and projection writes are blocked for Ultra projects', async () => {
   const target = mkTarget();
   const project = mkTarget();
   try {
@@ -187,15 +187,21 @@ test('OpenCode before-tool hook blocks tasks.json writes only during an active w
     const module = await import(pathToFileURL(pluginFile).href);
     const plugin = await module.UltraBuilderProPlugin({ directory: project });
 
-    await plugin['tool.execute.before'](
-      { tool: 'edit' },
-      { args: { filePath: '.ultra/tasks/tasks.json' } },
-    );
-
     fs.mkdirSync(path.join(project, '.ultra'), { recursive: true });
-    fs.writeFileSync(path.join(project, '.ultra', 'workflow-state.json'), JSON.stringify({
-      command: 'ultra-plan', task_id: 'plan', step: 'persist', status: 'active',
+    fs.writeFileSync(path.join(project, '.ultra', 'state.db'), 'owned-by-ultra');
+    const changeRoot = path.join(project, '.ultra', 'changes', 'active', 'daily-fix');
+    fs.mkdirSync(changeRoot, { recursive: true });
+    fs.writeFileSync(path.join(changeRoot, 'context-manifest.json'), JSON.stringify({
+      change: { id: 'daily-fix', title: 'Daily fix', kind: 'quick', status: 'active', intent: 'Fix drift' },
+      providers: { memory: { provider: 'cloud-mem', status: 'available' } },
     }));
+
+    const output = { system: [] };
+    await plugin['experimental.chat.system.transform']({}, output);
+    assert.match(output.system.join('\n'), /Ultra continuous change/);
+    assert.match(output.system.join('\n'), /daily-fix/);
+    assert.match(output.system.join('\n'), /metadata references only/);
+
     await assert.rejects(
       plugin['tool.execute.before'](
         { tool: 'apply_patch' },