ultra-builder-pro-cli 0.13.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (172) hide show
  1. package/.ultra-template/docs/research/README.md +11 -7
  2. package/.ultra-template/specs/architecture.md +36 -36
  3. package/.ultra-template/specs/discovery.md +46 -33
  4. package/.ultra-template/specs/product.md +38 -29
  5. package/.ultra-template/specs/research-distillate.md +48 -0
  6. package/.ultra-template/tasks/contexts/TEMPLATE.md +11 -28
  7. package/CHANGELOG.md +86 -1
  8. package/README.md +40 -26
  9. package/adapters/_shared/codex-assets.cjs +29 -165
  10. package/adapters/_shared/file-ops.cjs +6 -2
  11. package/adapters/_shared/runtime-assets.cjs +1 -0
  12. package/adapters/claude.js +3 -2
  13. package/adapters/codex.js +1 -0
  14. package/adapters/kimi.js +3 -2
  15. package/adapters/opencode.js +33 -122
  16. package/agents/review-coordinator.md +9 -6
  17. package/docs/AGENT-CONTEXT.md +21 -11
  18. package/docs/ARCHITECTURE.md +41 -13
  19. package/docs/PLAN.zh-CN.md +3 -2
  20. package/docs/ROADMAP.md +9 -5
  21. package/docs/RUNTIME-COMPAT-MATRIX.md +6 -6
  22. package/docs/STATE-DB-ACCESS-POLICY.md +27 -25
  23. package/docs/WORKFLOW-LIFECYCLE.md +266 -0
  24. package/hooks/README.md +6 -1
  25. package/hooks/active_task_context.py +22 -50
  26. package/hooks/context_spine.py +61 -332
  27. package/hooks/health_check.py +29 -18
  28. package/hooks/pre_stop_check.py +28 -33
  29. package/hooks/subagent_tracker.py +54 -85
  30. package/hooks/workflow_checkpoint.py +39 -47
  31. package/hooks/workflow_context.py +4 -9
  32. package/hooks/workflow_resume.py +48 -128
  33. package/mcp-server/breadcrumb.cjs +22 -0
  34. package/mcp-server/hook-event.cjs +34 -0
  35. package/mcp-server/lib/archive-journal.cjs +17 -5
  36. package/mcp-server/lib/baseline-workflow.cjs +158 -18
  37. package/mcp-server/lib/change-workflow.cjs +550 -85
  38. package/mcp-server/lib/context-spine.cjs +242 -24
  39. package/mcp-server/lib/doctor.cjs +33 -3
  40. package/mcp-server/lib/init-project.cjs +210 -16
  41. package/mcp-server/lib/plan-store.cjs +4 -1
  42. package/mcp-server/lib/prd-parser.cjs +14 -41
  43. package/mcp-server/lib/pricing.cjs +7 -10
  44. package/mcp-server/lib/project-breadcrumb.cjs +145 -0
  45. package/mcp-server/lib/projector.cjs +57 -3
  46. package/mcp-server/lib/spec-learning.cjs +79 -2
  47. package/mcp-server/lib/state-db.cjs +145 -8
  48. package/mcp-server/lib/state-ops.cjs +160 -9
  49. package/mcp-server/lib/task-expander.cjs +9 -38
  50. package/mcp-server/lib/workflow-state.cjs +2292 -0
  51. package/mcp-server/server.cjs +182 -50
  52. package/orchestrator/daemon.cjs +1 -2
  53. package/orchestrator/dispatch-rules.cjs +5 -31
  54. package/orchestrator/planner/plan-builder.cjs +21 -12
  55. package/package.json +14 -6
  56. package/skills/cc-collab/SKILL.md +2 -2
  57. package/skills/codex-collab/SKILL.md +2 -3
  58. package/skills/ultra-change/SKILL.md +53 -68
  59. package/skills/ultra-change/references/change-contract.md +36 -0
  60. package/skills/ultra-deliver/SKILL.md +69 -79
  61. package/skills/ultra-deliver/references/baseline-reconciliation.md +20 -0
  62. package/skills/ultra-dev/SKILL.md +54 -59
  63. package/skills/ultra-doctor/SKILL.md +40 -71
  64. package/skills/ultra-init/SKILL.md +96 -103
  65. package/skills/ultra-init/references/brownfield-adoption.md +2 -2
  66. package/skills/ultra-plan/SKILL.md +79 -75
  67. package/skills/ultra-plan/references/semantic-preflight.md +18 -0
  68. package/skills/ultra-research/SKILL.md +87 -60
  69. package/skills/ultra-research/references/00-problem-validation.md +36 -0
  70. package/skills/ultra-research/references/01-opportunity-discovery.md +33 -0
  71. package/skills/ultra-research/references/02-market-assessment.md +30 -0
  72. package/skills/ultra-research/references/03-competitive-landscape.md +31 -0
  73. package/skills/ultra-research/references/04-product-strategy.md +32 -0
  74. package/skills/ultra-research/references/05-assumptions-validation.md +31 -0
  75. package/skills/ultra-research/references/10-user-personas.md +29 -0
  76. package/skills/ultra-research/references/11-user-scenarios.md +28 -0
  77. package/skills/ultra-research/references/20-user-stories.md +30 -0
  78. package/skills/ultra-research/references/21-features-scope.md +29 -0
  79. package/skills/ultra-research/references/22-success-metrics.md +28 -0
  80. package/skills/ultra-research/references/30-architecture-context.md +30 -0
  81. package/skills/ultra-research/references/31-solution-strategy.md +28 -0
  82. package/skills/ultra-research/references/32-building-blocks.md +28 -0
  83. package/skills/ultra-research/references/40-deployment.md +29 -0
  84. package/skills/ultra-research/references/41-quality-risks.md +28 -0
  85. package/skills/ultra-research/references/99-synthesis.md +35 -0
  86. package/skills/ultra-review/SKILL.md +57 -73
  87. package/skills/ultra-review/references/review-modes.md +27 -0
  88. package/skills/ultra-review/references/unified-schema.md +25 -0
  89. package/skills/ultra-review/scripts/review_wait.py +40 -3
  90. package/skills/ultra-status/SKILL.md +41 -45
  91. package/skills/ultra-test/SKILL.md +48 -55
  92. package/skills/ultra-verify/SKILL.md +22 -31
  93. package/skills/ultra-verify/references/{confidence-system.md → evidence-status.md} +3 -3
  94. package/skills/ultra-verify/scripts/verify_wait.py +54 -54
  95. package/spec/cli-protocol.md +7 -2
  96. package/spec/mcp-tools.yaml +422 -73
  97. package/spec/schemas/baseline-reconciliation.v1.schema.json +73 -0
  98. package/spec/schemas/delivery-report.v1.schema.json +111 -0
  99. package/spec/schemas/mcp-tools.schema.json +1 -1
  100. package/spec/schemas/state-db.sql +82 -1
  101. package/spec/schemas/tasks.v4.5.schema.json +8 -1
  102. package/spec/schemas/test-report.v1.schema.json +194 -0
  103. package/ultra-tools/cli.cjs +1 -1
  104. package/ultra-tools/commands/migrate.cjs +3 -3
  105. package/ultra-tools/commands/status.cjs +213 -12
  106. package/.ultra-template/delivery-report.json +0 -9
  107. package/.ultra-template/test-report.json +0 -8
  108. package/adapters/_shared/tests/file-ops.test.cjs +0 -54
  109. package/adapters/_shared/tests/frontmatter.test.cjs +0 -47
  110. package/adapters/_shared/tests/handbook.test.cjs +0 -101
  111. package/adapters/_shared/tests/path-rewrite.test.cjs +0 -60
  112. package/adapters/_shared/tests/provenance.test.cjs +0 -133
  113. package/adapters/_shared/tests/resolve-target.test.cjs +0 -75
  114. package/adapters/_shared/tests/runtime-assets.test.cjs +0 -131
  115. package/adapters/_shared/tests/settings-merge.test.cjs +0 -85
  116. package/adapters/_shared/tests/validate.test.cjs +0 -30
  117. package/adapters/tests/claude.test.cjs +0 -137
  118. package/adapters/tests/codex-hook.test.cjs +0 -115
  119. package/adapters/tests/codex.test.cjs +0 -423
  120. package/adapters/tests/kimi-hook.test.cjs +0 -122
  121. package/adapters/tests/kimi.test.cjs +0 -259
  122. package/adapters/tests/opencode.test.cjs +0 -371
  123. package/mcp-server/lib/archive-journal.test.cjs +0 -35
  124. package/mcp-server/lib/baseline-workflow.test.cjs +0 -477
  125. package/mcp-server/lib/change-workflow.test.cjs +0 -971
  126. package/mcp-server/lib/context-spine.test.cjs +0 -93
  127. package/mcp-server/lib/doctor.test.cjs +0 -148
  128. package/mcp-server/lib/llm-client.cjs +0 -157
  129. package/mcp-server/lib/llm-client.test.cjs +0 -156
  130. package/mcp-server/lib/plan-store.test.cjs +0 -132
  131. package/mcp-server/lib/prd-parser.test.cjs +0 -171
  132. package/mcp-server/lib/runtime-state.test.cjs +0 -92
  133. package/mcp-server/lib/spec-learning.test.cjs +0 -67
  134. package/mcp-server/lib/state-db.test.cjs +0 -314
  135. package/mcp-server/lib/task-expander.test.cjs +0 -324
  136. package/mcp-server/lib/topo.test.cjs +0 -158
  137. package/mcp-server/tests/circuit-breaker.test.cjs +0 -125
  138. package/mcp-server/tests/commit-hash-flow.test.cjs +0 -117
  139. package/mcp-server/tests/concurrency-update.test.cjs +0 -96
  140. package/mcp-server/tests/concurrency.test.cjs +0 -112
  141. package/mcp-server/tests/db-ops.test.cjs +0 -121
  142. package/mcp-server/tests/init-project.test.cjs +0 -393
  143. package/mcp-server/tests/migrate.test.cjs +0 -232
  144. package/mcp-server/tests/projector.test.cjs +0 -162
  145. package/mcp-server/tests/server-contract.test.cjs +0 -1471
  146. package/mcp-server/tests/staleness.test.cjs +0 -190
  147. package/mcp-server/tests/state-db.test.cjs +0 -106
  148. package/mcp-server/tests/state-ops.test.cjs +0 -449
  149. package/mcp-server/tests/tagged-tasks.test.cjs +0 -163
  150. package/mcp-server/tests/telemetry.test.cjs +0 -219
  151. package/orchestrator/planner/expand-prompt.cjs +0 -62
  152. package/orchestrator/planner/expand-prompt.test.cjs +0 -52
  153. package/orchestrator/planner/plan-builder.test.cjs +0 -165
  154. package/orchestrator/planner/prd-prompt.cjs +0 -44
  155. package/orchestrator/planner/prd-prompt.test.cjs +0 -30
  156. package/orchestrator/tests/auto-merge.test.cjs +0 -216
  157. package/orchestrator/tests/daemon.test.cjs +0 -311
  158. package/orchestrator/tests/dispatch-rules.test.cjs +0 -124
  159. package/orchestrator/tests/parallel-orchestrator.test.cjs +0 -233
  160. package/orchestrator/tests/phase-8b-gate.test.cjs +0 -183
  161. package/orchestrator/tests/recovery.test.cjs +0 -190
  162. package/orchestrator/tests/session-runner.test.cjs +0 -314
  163. package/orchestrator/tests/skill-miner.test.cjs +0 -147
  164. package/orchestrator/tests/worktree-manager.test.cjs +0 -148
  165. package/skills/ultra-research/references/architecture.md +0 -38
  166. package/skills/ultra-research/references/problem-product.md +0 -39
  167. package/skills/ultra-research/references/quality-delivery.md +0 -34
  168. package/skills/ultra-research/references/synthesis.md +0 -38
  169. package/skills/ultra-research/references/users-scope.md +0 -40
  170. package/ultra-tools/legacy-memory.test.cjs +0 -80
  171. package/ultra-tools/status-command.test.cjs +0 -181
  172. package/ultra-tools/system-command.test.cjs +0 -309
@@ -1,115 +0,0 @@
1
- 'use strict';
2
-
3
- const { test } = require('node:test');
4
- const assert = require('node:assert/strict');
5
- const fs = require('node:fs');
6
- const os = require('node:os');
7
- const path = require('node:path');
8
- const { spawnSync } = require('node:child_process');
9
-
10
- const REPO_ROOT = path.resolve(__dirname, '..', '..');
11
- const ADAPTER = path.join(REPO_ROOT, 'hooks', 'adapters', 'codex.py');
12
-
13
- function run(feature, payload) {
14
- return spawnSync('python3', [ADAPTER, feature], {
15
- cwd: REPO_ROOT,
16
- input: JSON.stringify(payload),
17
- encoding: 'utf8',
18
- env: { ...process.env, PLUGIN_DATA: path.join(REPO_ROOT, '.tmp-codex-hook-test') },
19
- });
20
- }
21
-
22
- test('Codex hook adapter rejects retired generic policy hooks', () => {
23
- const result = run('block_dangerous_commands.py', {
24
- session_id: 'session-1',
25
- turn_id: 'turn-1',
26
- cwd: REPO_ROOT,
27
- hook_event_name: 'PreToolUse',
28
- tool_name: 'Bash',
29
- tool_input: { command: 'git reset --hard' },
30
- });
31
- assert.equal(result.status, 0, result.stderr);
32
- const output = JSON.parse(result.stdout);
33
- assert.match(output.systemMessage, /refused unknown feature/);
34
- });
35
-
36
- test('Codex hook adapter injects only an active Ultra task boundary before edits', () => {
37
- const project = fs.mkdtempSync(path.join(os.tmpdir(), 'ubp-codex-hook-'));
38
- try {
39
- fs.mkdirSync(path.join(project, '.ultra'));
40
- fs.writeFileSync(path.join(project, '.ultra', 'workflow-state.json'), JSON.stringify({
41
- command: 'ultra-dev', task_id: 'task-7', step: '4.5', status: 'review_pending',
42
- }));
43
- const result = run('active_task_context.py', {
44
- session_id: 'session-2',
45
- cwd: project,
46
- hook_event_name: 'PreToolUse',
47
- tool_name: 'apply_patch',
48
- tool_input: { command: '*** Begin Patch\n*** Update File: src/a.py\n*** End Patch' },
49
- });
50
- assert.equal(result.status, 0, result.stderr);
51
- const output = JSON.parse(result.stdout);
52
- assert.equal(output.hookSpecificOutput.hookEventName, 'PreToolUse');
53
- assert.match(output.hookSpecificOutput.additionalContext, /task-7/);
54
- assert.doesNotMatch(JSON.stringify(output), /memory|recall|journal/);
55
- } finally {
56
- fs.rmSync(project, { recursive: true, force: true });
57
- }
58
- });
59
-
60
- test('Codex hook adapter maps apply_patch payloads to Edit-compatible file inputs', () => {
61
- const script = [
62
- 'import importlib.util, json, pathlib',
63
- `p = pathlib.Path(${JSON.stringify(ADAPTER)})`,
64
- 's = importlib.util.spec_from_file_location("codex_hook_adapter", p)',
65
- 'm = importlib.util.module_from_spec(s)',
66
- 's.loader.exec_module(m)',
67
- 'payload = {"hook_event_name":"PostToolUse","tool_name":"apply_patch","tool_input":{"patch":"*** Begin Patch\\n*** Update File: src/a.py\\n*** Add File: src/b.py\\n*** End Patch"}}',
68
- 'print(json.dumps(m.normalize_inputs(payload)))',
69
- ].join('; ');
70
- const result = spawnSync('python3', ['-c', script], { cwd: REPO_ROOT, encoding: 'utf8' });
71
- assert.equal(result.status, 0, result.stderr);
72
- const outputs = JSON.parse(result.stdout);
73
- assert.deepEqual(outputs.map((entry) => entry.tool_input.file_path), ['src/a.py', 'src/b.py']);
74
- assert.ok(outputs.every((entry) => entry.tool_name === 'Edit'));
75
- });
76
-
77
- test('Codex hook adapter denies apply_patch writes to tasks.json during an active Ultra workflow', () => {
78
- const project = fs.mkdtempSync(path.join(os.tmpdir(), 'ubp-codex-hook-deny-'));
79
- try {
80
- fs.mkdirSync(path.join(project, '.ultra'));
81
- fs.writeFileSync(path.join(project, '.ultra', 'workflow-state.json'), JSON.stringify({
82
- command: 'ultra-plan', task_id: 'plan', step: 'persist', status: 'active',
83
- }));
84
- const result = run('active_task_context.py', {
85
- session_id: 'session-deny',
86
- cwd: project,
87
- hook_event_name: 'PreToolUse',
88
- tool_name: 'apply_patch',
89
- tool_input: {
90
- patch: '*** Begin Patch\n*** Update File: .ultra/tasks/tasks.json\n*** End Patch',
91
- },
92
- });
93
- assert.equal(result.status, 0, result.stderr);
94
- const output = JSON.parse(result.stdout);
95
- assert.equal(output.hookSpecificOutput.permissionDecision, 'deny');
96
- assert.match(output.hookSpecificOutput.permissionDecisionReason, /\.ultra\/state\.db/);
97
- } finally {
98
- fs.rmSync(project, { recursive: true, force: true });
99
- }
100
- });
101
-
102
- test('Codex hook adapter converts compact recovery context to PostCompact schema', () => {
103
- const script = [
104
- 'import importlib.util, json, pathlib',
105
- `p = pathlib.Path(${JSON.stringify(ADAPTER)})`,
106
- 's = importlib.util.spec_from_file_location("codex_hook_adapter", p)',
107
- 'm = importlib.util.module_from_spec(s)',
108
- 's.loader.exec_module(m)',
109
- 'legacy = {"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"restored"}}',
110
- 'print(json.dumps(m.adapt_output(legacy, "PostCompact")))',
111
- ].join('; ');
112
- const result = spawnSync('python3', ['-c', script], { cwd: REPO_ROOT, encoding: 'utf8' });
113
- assert.equal(result.status, 0, result.stderr);
114
- assert.deepEqual(JSON.parse(result.stdout), { systemMessage: 'restored' });
115
- });
@@ -1,423 +0,0 @@
1
- 'use strict';
2
-
3
- const { test } = require('node:test');
4
- const assert = require('node:assert/strict');
5
- const fs = require('node:fs');
6
- const os = require('node:os');
7
- const path = require('node:path');
8
- const { spawnSync } = require('node:child_process');
9
- const yaml = require('js-yaml');
10
- const { Client } = require('@modelcontextprotocol/sdk/client/index.js');
11
- const { StdioClientTransport } = require('@modelcontextprotocol/sdk/client/stdio.js');
12
- const { initStateDb, closeStateDb } = require('../../mcp-server/lib/state-db.cjs');
13
-
14
- const codex = require('../codex.js');
15
- const { parse: parseFrontmatter } = require('../_shared/frontmatter.cjs');
16
- const PACKAGE_VERSION = require('../../package.json').version;
17
- const {
18
- MCP_DEPENDENT_SKILLS,
19
- skillsForRuntime,
20
- WORKFLOW_HOOK_FILES,
21
- } = require('../_shared/runtime-assets.cjs');
22
-
23
- const REPO_ROOT = path.resolve(__dirname, '..', '..');
24
- const COMMANDS = [
25
- 'learn',
26
- 'ultra-change',
27
- 'ultra-deliver',
28
- 'ultra-dev',
29
- 'ultra-doctor',
30
- 'ultra-init',
31
- 'ultra-plan',
32
- 'ultra-research',
33
- 'ultra-status',
34
- 'ultra-test',
35
- 'ultra-think',
36
- ];
37
- const AGENTS = [
38
- 'code-reviewer',
39
- 'debugger',
40
- 'review-code',
41
- 'review-comments',
42
- 'review-coordinator',
43
- 'review-design',
44
- 'review-errors',
45
- 'review-spec',
46
- 'review-tests',
47
- 'tdd-runner',
48
- ];
49
-
50
- function mkLayout() {
51
- const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ubp-codex-home-'));
52
- return {
53
- homeDir,
54
- configDir: path.join(homeDir, '.codex'),
55
- pluginRoot: path.join(homeDir, 'plugins', 'ultra-builder-pro'),
56
- marketplaceFile: path.join(homeDir, '.agents', 'plugins', 'marketplace.json'),
57
- };
58
- }
59
-
60
- function cleanup(layout) {
61
- fs.rmSync(layout.homeDir, { recursive: true, force: true });
62
- }
63
-
64
- function install(layout) {
65
- return codex.install({
66
- configDir: layout.configDir,
67
- homeDir: layout.homeDir,
68
- scope: 'global',
69
- repoRoot: REPO_ROOT,
70
- runPluginCli: false,
71
- });
72
- }
73
-
74
- function skillNames(pluginRoot) {
75
- return fs.readdirSync(path.join(pluginRoot, 'skills'), { withFileTypes: true })
76
- .filter((entry) => entry.isDirectory() && fs.existsSync(path.join(pluginRoot, 'skills', entry.name, 'SKILL.md')))
77
- .map((entry) => entry.name)
78
- .sort();
79
- }
80
-
81
- test('install builds one Codex-native plugin with complete skill and command coverage', () => {
82
- const layout = mkLayout();
83
- try {
84
- const report = install(layout);
85
- assert.equal(report.plugin.root, layout.pluginRoot);
86
-
87
- const manifest = JSON.parse(fs.readFileSync(path.join(layout.pluginRoot, '.codex-plugin', 'plugin.json'), 'utf8'));
88
- assert.equal(manifest.name, 'ultra-builder-pro');
89
- const escapedVersion = PACKAGE_VERSION.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
90
- assert.match(manifest.version, new RegExp(`^${escapedVersion}\\+codex\\.[0-9a-f]{12}$`));
91
- assert.equal(manifest.skills, './skills/');
92
- assert.equal(manifest.mcpServers, './.mcp.json');
93
- assert.ok(!Object.hasOwn(manifest, 'hooks'), 'default hooks/hooks.json discovery avoids unsupported manifest field');
94
-
95
- const expectedSkills = skillsForRuntime('codex').sort();
96
- assert.deepEqual(skillNames(layout.pluginRoot), expectedSkills);
97
- assert.equal(expectedSkills.length, 18);
98
- assert.ok(!fs.existsSync(path.join(layout.pluginRoot, 'skills', 'codex-collab')));
99
- assert.ok(!fs.existsSync(path.join(layout.pluginRoot, 'skills', 'learned')));
100
-
101
- const commandMap = JSON.parse(fs.readFileSync(path.join(layout.pluginRoot, 'command-map.json'), 'utf8'));
102
- assert.deepEqual(Object.keys(commandMap).sort(), COMMANDS.map((name) => `/${name}`).sort());
103
- for (const command of COMMANDS) {
104
- assert.equal(commandMap[`/${command}`], `$ultra-builder-pro:${command}`);
105
- assert.ok(fs.existsSync(path.join(layout.pluginRoot, 'skills', command, 'SKILL.md')));
106
- }
107
- assert.ok(!fs.existsSync(path.join(layout.configDir, 'prompts')), 'deprecated Codex prompts must not be installed');
108
- } finally {
109
- cleanup(layout);
110
- }
111
- });
112
-
113
- test('every generated skill is Codex-valid, UI-visible, and free of Claude host bindings', () => {
114
- const layout = mkLayout();
115
- try {
116
- install(layout);
117
- for (const name of skillNames(layout.pluginRoot)) {
118
- const skillDir = path.join(layout.pluginRoot, 'skills', name);
119
- const text = fs.readFileSync(path.join(skillDir, 'SKILL.md'), 'utf8');
120
- const { fm } = parseFrontmatter(text);
121
- assert.deepEqual(Object.keys(fm).sort(), ['description', 'name'], `${name} should use Codex skill frontmatter only`);
122
- assert.equal(fm.name, name);
123
- assert.doesNotMatch(
124
- text,
125
- /~\/\.claude|CLAUDE\.md|AskUserQuestion|(^|[\s`(>])\/(?:ultra-[a-z-]+|recall|learn|codex-collab)(?=$|[\s`,.;):])/m,
126
- );
127
- assert.doesNotMatch(text, /TaskCreate|TaskUpdate|TaskList|TaskOutput|run_in_background|~\/\.codex\/skills|mcp__claude/);
128
- assert.doesNotMatch(text, /[\u3400-\u9fff]|ultra-review-findings-v1|Context7|Exa MCP|confidence\s*>=?\s*\d+/iu);
129
-
130
- const openai = yaml.load(fs.readFileSync(path.join(skillDir, 'agents', 'openai.yaml'), 'utf8'));
131
- assert.ok(openai.interface.display_name);
132
- assert.ok(openai.interface.short_description);
133
- assert.match(openai.interface.default_prompt, new RegExp(`\\$ultra-builder-pro:${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`));
134
- assert.equal(openai.policy.allow_implicit_invocation, false);
135
- if (MCP_DEPENDENT_SKILLS.includes(name)) {
136
- assert.deepEqual(openai.dependencies.tools, [{
137
- type: 'mcp',
138
- value: 'ultra-builder-pro',
139
- description: 'Ultra Builder Pro authoritative task and change runtime',
140
- }]);
141
- } else {
142
- assert.equal(openai.dependencies, undefined);
143
- }
144
- }
145
-
146
- const cc = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'cc-collab', 'SKILL.md'), 'utf8');
147
- assert.match(cc, /Claude Code/);
148
- assert.match(cc, /claude --safe-mode/);
149
-
150
- const verify = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-verify', 'SKILL.md'), 'utf8');
151
- assert.match(verify, /Codex owns the task/);
152
- assert.match(verify, /claude --safe-mode/);
153
- assert.match(verify, /codex-analysis\.md/);
154
- assert.doesNotMatch(verify, /codex-output\.md|Claude synthesizes|Claude-only/);
155
-
156
- const waiter = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-verify', 'scripts', 'verify_wait.py'), 'utf8');
157
- assert.match(waiter, /ADVISOR = "claude"/);
158
- assert.match(waiter, /OUTPUT_FILE = "claude-output\.md"/);
159
-
160
- const review = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-review', 'SKILL.md'), 'utf8');
161
- assert.match(review, /native Codex custom agents/);
162
- assert.match(review, /review-spec/);
163
- assert.match(review, /scripts\/review_wait\.py/);
164
-
165
- const plan = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-plan', 'SKILL.md'), 'utf8');
166
- const status = fs.readFileSync(path.join(layout.pluginRoot, 'skills', 'ultra-status', 'SKILL.md'), 'utf8');
167
- assert.doesNotMatch(plan, /LEGACY_STATE_MIGRATION_REQUIRED|v4\.4|v4\.5/);
168
- assert.match(plan, /Never read or\s+write .*tasks\.json/i);
169
- assert.match(status, /Never fall\s+back to generated task JSON/i);
170
-
171
- const coreWorkflowText = [
172
- ...COMMANDS,
173
- 'ultra-review',
174
- ].map((name) => fs.readFileSync(path.join(layout.pluginRoot, 'skills', name, 'SKILL.md'), 'utf8')).join('\n');
175
- assert.doesNotMatch(coreWorkflowText, /Phase (?:3\.7|5|7) placeholder|not yet implemented|UNKNOWN_TOOL/);
176
- assert.doesNotMatch(coreWorkflowText, /session\.checkpoint|review\.run|ultra-tools subagent/);
177
- assert.doesNotMatch(coreWorkflowText, /ask\.question|ultra-tools task (?:create|update|list|get)/);
178
- assert.doesNotMatch(coreWorkflowText, /Context7 MCP|mcp__context7|Exa MCP|mcp__exa|Playwright via Bash/);
179
- assert.doesNotMatch(coreWorkflowText, /`\/{command}`/);
180
- } finally {
181
- cleanup(layout);
182
- }
183
- });
184
-
185
- test('install converts all bundled agent prompts into native Codex agent TOML', () => {
186
- const layout = mkLayout();
187
- try {
188
- const report = install(layout);
189
- assert.deepEqual(report.agents.installed.sort(), AGENTS.map((name) => `${name}.toml`).sort());
190
- for (const name of AGENTS) {
191
- const text = fs.readFileSync(path.join(layout.configDir, 'agents', `${name}.toml`), 'utf8');
192
- assert.match(text, new RegExp(`^name = "${name}"`, 'm'));
193
- assert.match(text, /^description = /m);
194
- assert.match(text, /^developer_instructions = """/m);
195
- assert.doesNotMatch(
196
- text,
197
- /model = "opus"|^tools =|^memory =|maxTurns|CLAUDE\.md|AskUserQuestion|(^|[\s`(>])\/(?:ultra-[a-z-]+|recall|learn|codex-collab)(?=$|[\s`,.;):])/m,
198
- );
199
- }
200
- } finally {
201
- cleanup(layout);
202
- }
203
- });
204
-
205
- test('plugin declares current Codex hooks and a project-local Ultra MCP server', () => {
206
- const layout = mkLayout();
207
- try {
208
- install(layout);
209
- const hooks = JSON.parse(fs.readFileSync(path.join(layout.pluginRoot, 'hooks', 'hooks.json'), 'utf8')).hooks;
210
- assert.deepEqual(Object.keys(hooks).sort(), [
211
- 'PostCompact', 'PreCompact', 'PreToolUse', 'SessionStart', 'Stop',
212
- 'SubagentStart', 'SubagentStop',
213
- ].sort());
214
- const serializedHooks = JSON.stringify(hooks);
215
- for (const feature of WORKFLOW_HOOK_FILES.filter((value) => value !== 'context_spine.py')) {
216
- assert.match(serializedHooks, new RegExp(feature.replace('.', '\\.')));
217
- }
218
- assert.ok(fs.existsSync(path.join(layout.pluginRoot, 'hooks', 'context_spine.py')));
219
- assert.doesNotMatch(serializedHooks, /memory|recall|journal|observation_capture|user_prompt_capture|block_dangerous|post_edit_guard/);
220
- assert.match(serializedHooks, /\$PLUGIN_ROOT\/hooks\/adapters\/codex\.py/);
221
- assert.match(serializedHooks, /apply_patch/);
222
-
223
- const mcp = JSON.parse(fs.readFileSync(path.join(layout.pluginRoot, '.mcp.json'), 'utf8'));
224
- const server = mcp.mcpServers['ultra-builder-pro'];
225
- assert.equal(server.type, 'stdio');
226
- assert.ok(path.isAbsolute(server.command));
227
- assert.ok(path.isAbsolute(server.args[0]));
228
- assert.equal(server.args[0], path.join(layout.pluginRoot, 'runtime', 'launch.cjs'));
229
- assert.doesNotMatch(server.args[0], new RegExp(REPO_ROOT.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')));
230
- assert.ok(!server.env, 'MCP must use each Codex task cwd so .ultra/state.db stays project-local');
231
-
232
- for (const rel of [
233
- 'runtime/index.cjs',
234
- 'runtime/launch.cjs',
235
- 'runtime/ultra-tools.cjs',
236
- 'runtime/build/Release/better_sqlite3.node',
237
- 'spec/mcp-tools.yaml',
238
- 'spec/upstream-mcp-tools.yaml',
239
- 'spec/codex-capability-map.json',
240
- 'spec/schemas/state-db.sql',
241
- 'templates/.ultra/tasks/tasks.json',
242
- ]) {
243
- assert.ok(fs.existsSync(path.join(layout.pluginRoot, rel)), `missing bundled MCP asset ${rel}`);
244
- }
245
-
246
- const liveSpec = yaml.load(fs.readFileSync(path.join(layout.pluginRoot, 'spec', 'mcp-tools.yaml'), 'utf8'));
247
- const upstreamSpec = yaml.load(fs.readFileSync(path.join(layout.pluginRoot, 'spec', 'upstream-mcp-tools.yaml'), 'utf8'));
248
- const capabilityMap = JSON.parse(fs.readFileSync(path.join(layout.pluginRoot, 'spec', 'codex-capability-map.json'), 'utf8'));
249
- assert.equal(liveSpec.tools.length, 36);
250
- assert.equal(upstreamSpec.tools.length, 36);
251
- assert.deepEqual(upstreamSpec.tools.map((tool) => tool.name).sort(), liveSpec.tools.map((tool) => tool.name).sort());
252
- assert.deepEqual(capabilityMap.live_mcp_tools.sort(), liveSpec.tools.map((tool) => tool.name).sort());
253
- assert.equal(Object.keys(capabilityMap.codex_native_replacements).length, 9);
254
- assert.equal(capabilityMap.codex_native_replacements['review.run'].surface, 'native_custom_agents');
255
- assert.equal(capabilityMap.codex_native_replacements['ask.question'].surface, 'direct_user_interaction');
256
- } finally {
257
- cleanup(layout);
258
- }
259
- });
260
-
261
- test('bundled plugin MCP runs outside the source checkout and keeps state in the Codex task cwd', async () => {
262
- const layout = mkLayout();
263
- const projectDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ubp-codex-mcp-project-'));
264
- let client;
265
- try {
266
- install(layout);
267
- const seededState = initStateDb(path.join(projectDir, '.ultra', 'state.db'));
268
- seededState.db.prepare(
269
- `INSERT INTO baselines
270
- (id, project_name, mode, status, approved_by, approval_note, converged_at)
271
- VALUES ('test-baseline', 'codex-bundle', 'greenfield', 'ready', 'test', 'smoke fixture', ?)`,
272
- ).run(new Date().toISOString());
273
- closeStateDb(seededState.db);
274
- const mcp = JSON.parse(fs.readFileSync(path.join(layout.pluginRoot, '.mcp.json'), 'utf8'));
275
- const server = mcp.mcpServers['ultra-builder-pro'];
276
- const env = { ...process.env };
277
- delete env.UBP_DB_PATH;
278
- delete env.UBP_ROOT_DIR;
279
- delete env.UBP_RUNTIME_ROOT;
280
- const transport = new StdioClientTransport({
281
- command: server.command,
282
- args: server.args,
283
- cwd: projectDir,
284
- env,
285
- stderr: 'pipe',
286
- });
287
- client = new Client({ name: 'ubp-codex-adapter-test', version: '0.0.0' }, { capabilities: {} });
288
- await client.connect(transport);
289
-
290
- const tools = await client.listTools();
291
- assert.ok(tools.tools.some((tool) => tool.name === 'task.create'));
292
- const created = await client.callTool({
293
- name: 'task.create',
294
- arguments: { id: 'codex-bundle-1', title: 'bundled runtime', type: 'feature', priority: 'P1' },
295
- });
296
- assert.equal(created.isError, undefined);
297
- assert.ok(fs.existsSync(path.join(projectDir, '.ultra', 'state.db')));
298
- assert.ok(!fs.existsSync(path.join(layout.pluginRoot, '.ultra', 'state.db')));
299
-
300
- const status = spawnSync(process.execPath, [
301
- path.join(layout.pluginRoot, 'runtime', 'ultra-tools.cjs'),
302
- 'status', '--cost', '--json',
303
- ], { cwd: projectDir, encoding: 'utf8' });
304
- assert.equal(status.status, 0, status.stderr);
305
- assert.equal(JSON.parse(status.stdout).ok, true);
306
-
307
- const freshTarget = path.join(projectDir, 'fresh-project');
308
- const initialized = await client.callTool({
309
- name: 'task.init_project',
310
- arguments: { target_dir: freshTarget, project_name: 'Codex bundle', project_type: 'cli' },
311
- });
312
- assert.equal(initialized.isError, undefined);
313
- assert.ok(fs.existsSync(path.join(freshTarget, '.ultra', 'tasks', 'tasks.json')));
314
- } finally {
315
- if (client) await client.close();
316
- fs.rmSync(projectDir, { recursive: true, force: true });
317
- cleanup(layout);
318
- }
319
- });
320
-
321
- test('install preserves user config and marketplace entries and is byte-idempotent', () => {
322
- const layout = mkLayout();
323
- try {
324
- fs.mkdirSync(layout.configDir, { recursive: true });
325
- const configFile = path.join(layout.configDir, 'config.toml');
326
- fs.writeFileSync(configFile, '[profile]\nname = "dev"\n');
327
- fs.mkdirSync(path.dirname(layout.marketplaceFile), { recursive: true });
328
- fs.writeFileSync(layout.marketplaceFile, JSON.stringify({
329
- name: 'personal',
330
- interface: { displayName: 'Personal' },
331
- plugins: [{
332
- name: 'mine',
333
- source: { source: 'local', path: './plugins/mine' },
334
- policy: { installation: 'AVAILABLE', authentication: 'ON_INSTALL' },
335
- category: 'Developer Tools',
336
- }],
337
- }, null, 2) + '\n');
338
-
339
- install(layout);
340
- const firstConfig = fs.readFileSync(configFile, 'utf8');
341
- const firstMarketplace = fs.readFileSync(layout.marketplaceFile, 'utf8');
342
- const firstManifest = fs.readFileSync(path.join(layout.pluginRoot, '.codex-plugin', 'plugin.json'), 'utf8');
343
- const firstAgent = fs.readFileSync(path.join(layout.configDir, 'agents', 'review-code.toml'), 'utf8');
344
- install(layout);
345
-
346
- assert.equal(fs.readFileSync(configFile, 'utf8'), firstConfig);
347
- assert.equal(fs.readFileSync(layout.marketplaceFile, 'utf8'), firstMarketplace);
348
- assert.equal(fs.readFileSync(path.join(layout.pluginRoot, '.codex-plugin', 'plugin.json'), 'utf8'), firstManifest);
349
- assert.equal(fs.readFileSync(path.join(layout.configDir, 'agents', 'review-code.toml'), 'utf8'), firstAgent);
350
-
351
- const marketplace = JSON.parse(firstMarketplace);
352
- assert.deepEqual(marketplace.plugins.map((entry) => entry.name), ['mine', 'ultra-builder-pro']);
353
- assert.equal(marketplace.plugins[1].source.path, './plugins/ultra-builder-pro');
354
- } finally {
355
- cleanup(layout);
356
- }
357
- });
358
-
359
- test('uninstall removes only UBP-managed plugin and agents', () => {
360
- const layout = mkLayout();
361
- try {
362
- fs.mkdirSync(layout.configDir, { recursive: true });
363
- const configFile = path.join(layout.configDir, 'config.toml');
364
- fs.writeFileSync(configFile, '[profile]\nname = "dev"\n');
365
- install(layout);
366
- fs.writeFileSync(path.join(layout.configDir, 'agents', 'mine.toml'), 'name = "mine"\n');
367
-
368
- codex.uninstall({
369
- configDir: layout.configDir,
370
- homeDir: layout.homeDir,
371
- scope: 'global',
372
- runPluginCli: false,
373
- });
374
-
375
- assert.ok(!fs.existsSync(layout.pluginRoot));
376
- for (const name of AGENTS) {
377
- assert.ok(!fs.existsSync(path.join(layout.configDir, 'agents', `${name}.toml`)));
378
- }
379
- assert.ok(fs.existsSync(path.join(layout.configDir, 'agents', 'mine.toml')));
380
- assert.equal(fs.readFileSync(configFile, 'utf8'), '[profile]\nname = "dev"\n');
381
- const marketplace = JSON.parse(fs.readFileSync(layout.marketplaceFile, 'utf8'));
382
- assert.ok(!marketplace.plugins.some((entry) => entry.name === 'ultra-builder-pro'));
383
- } finally {
384
- cleanup(layout);
385
- }
386
- });
387
-
388
- test('doctor checks the current Codex cache hook target for a CLI-managed global install', () => {
389
- const layout = mkLayout();
390
- try {
391
- install(layout);
392
- const runtimeManifest = JSON.parse(fs.readFileSync(
393
- path.join(layout.configDir, 'ultra-builder-pro', 'install-manifest.json'),
394
- 'utf8',
395
- ));
396
- const version = runtimeManifest.plugin.version;
397
- const cacheAdapter = path.join(
398
- codex._internal.pluginCacheRoot(layout.configDir, 'personal'),
399
- version,
400
- 'hooks',
401
- 'adapters',
402
- 'codex.py',
403
- );
404
- const doctorCtx = {
405
- homeDir: layout.homeDir,
406
- scope: 'global',
407
- repoRoot: REPO_ROOT,
408
- runPluginCli: true,
409
- };
410
-
411
- const degraded = codex.doctor(doctorCtx);
412
- assert.equal(degraded.status, 'degraded');
413
- assert.ok(degraded.issues.some((entry) => (
414
- entry.code === 'HOOK_TARGET_MISSING' && entry.version === version
415
- )));
416
-
417
- fs.mkdirSync(path.dirname(cacheAdapter), { recursive: true });
418
- fs.copyFileSync(path.join(layout.pluginRoot, 'hooks', 'adapters', 'codex.py'), cacheAdapter);
419
- assert.equal(codex.doctor(doctorCtx).status, 'healthy');
420
- } finally {
421
- cleanup(layout);
422
- }
423
- });
@@ -1,122 +0,0 @@
1
- 'use strict';
2
-
3
- const { test } = require('node:test');
4
- const assert = require('node:assert/strict');
5
- const fs = require('node:fs');
6
- const os = require('node:os');
7
- const path = require('node:path');
8
- const { spawnSync } = require('node:child_process');
9
-
10
- const REPO_ROOT = path.resolve(__dirname, '..', '..');
11
- const ADAPTER = path.join(REPO_ROOT, 'hooks', 'adapters', 'kimi.py');
12
-
13
- function run(feature, payload, args = []) {
14
- return spawnSync('python3', [ADAPTER, feature, ...args], {
15
- cwd: REPO_ROOT,
16
- input: JSON.stringify(payload),
17
- encoding: 'utf8',
18
- });
19
- }
20
-
21
- test('Kimi hook adapter rejects non-workflow policy hooks without blocking the host', () => {
22
- const result = run('block_dangerous_commands.py', {
23
- session_id: 'session-1',
24
- cwd: REPO_ROOT,
25
- hook_event_name: 'PreToolUse',
26
- tool_name: 'Shell',
27
- tool_input: { command: 'git reset --hard' },
28
- });
29
- assert.equal(result.status, 0, result.stderr);
30
- assert.match(JSON.parse(result.stdout).message, /refused unknown feature/);
31
- });
32
-
33
- test('Kimi hook adapter translates active edit context to the native message field', () => {
34
- const project = fs.mkdtempSync(path.join(os.tmpdir(), 'ubp-kimi-hook-'));
35
- try {
36
- fs.mkdirSync(path.join(project, '.ultra'));
37
- fs.writeFileSync(path.join(project, '.ultra', 'workflow-state.json'), JSON.stringify({
38
- command: 'ultra-dev', task_id: 'task-7', step: '4.5', status: 'review_pending',
39
- }));
40
- const result = run('active_task_context.py', {
41
- session_id: 'session-2',
42
- cwd: project,
43
- hook_event_name: 'PreToolUse',
44
- tool_name: 'Edit',
45
- tool_input: { file_path: 'src/a.py' },
46
- });
47
- assert.equal(result.status, 0, result.stderr);
48
- const output = JSON.parse(result.stdout);
49
- assert.match(output.message, /task-7/);
50
- assert.equal(output.hookSpecificOutput, undefined);
51
- } finally {
52
- fs.rmSync(project, { recursive: true, force: true });
53
- }
54
- });
55
-
56
- test('Kimi hook adapter emits the native deny contract for projection writes', () => {
57
- const project = fs.mkdtempSync(path.join(os.tmpdir(), 'ubp-kimi-hook-deny-'));
58
- try {
59
- fs.mkdirSync(path.join(project, '.ultra'));
60
- fs.writeFileSync(path.join(project, '.ultra', 'workflow-state.json'), JSON.stringify({
61
- command: 'ultra-plan', task_id: 'plan', step: 'persist', status: 'active',
62
- }));
63
- const result = run('active_task_context.py', {
64
- session_id: 'session-deny',
65
- cwd: project,
66
- hook_event_name: 'PreToolUse',
67
- tool_name: 'Write',
68
- tool_input: { file_path: '.ultra/tasks/tasks.json' },
69
- });
70
- assert.equal(result.status, 0, result.stderr);
71
- const output = JSON.parse(result.stdout);
72
- assert.equal(output.hookSpecificOutput.permissionDecision, 'deny');
73
- assert.match(output.hookSpecificOutput.permissionDecisionReason, /\.ultra\/state\.db/);
74
- } finally {
75
- fs.rmSync(project, { recursive: true, force: true });
76
- }
77
- });
78
-
79
- test('Kimi subagent fields are normalized for the existing lifecycle tracker', () => {
80
- const script = [
81
- 'import importlib.util, json, pathlib',
82
- `p = pathlib.Path(${JSON.stringify(ADAPTER)})`,
83
- 's = importlib.util.spec_from_file_location("kimi_hook_adapter", p)',
84
- 'm = importlib.util.module_from_spec(s)',
85
- 's.loader.exec_module(m)',
86
- 'payload = {"hook_event_name":"SubagentStart","agent_name":"review-code","session_id":"s"}',
87
- 'print(json.dumps(m.normalize_input(payload)))',
88
- ].join('; ');
89
- const result = spawnSync('python3', ['-c', script], { cwd: REPO_ROOT, encoding: 'utf8' });
90
- assert.equal(result.status, 0, result.stderr);
91
- assert.deepEqual(JSON.parse(result.stdout), {
92
- hook_event_name: 'SubagentStart',
93
- agent_name: 'review-code',
94
- session_id: 's',
95
- agent_id: 'review-code',
96
- agent_type: 'review-code',
97
- });
98
- });
99
-
100
- test('Kimi adapter preserves an explicit Stop deny and recovery context schema', () => {
101
- const script = [
102
- 'import importlib.util, json, pathlib',
103
- `p = pathlib.Path(${JSON.stringify(ADAPTER)})`,
104
- 's = importlib.util.spec_from_file_location("kimi_hook_adapter", p)',
105
- 'm = importlib.util.module_from_spec(s)',
106
- 's.loader.exec_module(m)',
107
- 'values = [m.adapt_output({"decision":"block","reason":"finish gates"}, "Stop"), m.adapt_output({"additionalContext":"restored"}, "PostCompact")]',
108
- 'print(json.dumps(values))',
109
- ].join('; ');
110
- const result = spawnSync('python3', ['-c', script], { cwd: REPO_ROOT, encoding: 'utf8' });
111
- assert.equal(result.status, 0, result.stderr);
112
- assert.deepEqual(JSON.parse(result.stdout), [
113
- {
114
- hookSpecificOutput: {
115
- message: 'finish gates',
116
- permissionDecision: 'deny',
117
- permissionDecisionReason: 'finish gates',
118
- },
119
- },
120
- { message: 'restored' },
121
- ]);
122
- });