ultra-builder-pro-cli 0.25.1 → 0.26.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 (241) hide show
  1. package/.ultra-template/contexts/TEMPLATE.md +87 -0
  2. package/.ultra-template/decisions/.gitkeep +1 -0
  3. package/.ultra-template/evidence/.gitkeep +1 -0
  4. package/.ultra-template/north-star.md +46 -0
  5. package/.ultra-template/research/.gitkeep +1 -0
  6. package/.ultra-template/specs/discovery.md +2 -2
  7. package/.ultra-template/tasks.json +3 -0
  8. package/.ultra-template/test-report.json +27 -0
  9. package/CHANGELOG.md +40 -0
  10. package/README.md +217 -579
  11. package/adapters/_shared/delegate-profiles/kimi-read-only.md +15 -0
  12. package/adapters/_shared/delegate-profiles/kimi-write.md +17 -0
  13. package/adapters/_shared/file-ops.cjs +76 -2
  14. package/adapters/_shared/host-profile.cjs +97 -0
  15. package/adapters/_shared/plugin-core.cjs +204 -0
  16. package/adapters/_shared/runtime-assets.cjs +31 -96
  17. package/adapters/claude.js +92 -291
  18. package/adapters/codex.js +309 -842
  19. package/adapters/grok.js +143 -1469
  20. package/adapters/kimi.js +124 -1053
  21. package/adapters/opencode.js +230 -742
  22. package/bin/delegate-worker.cjs +323 -0
  23. package/bin/delegate.cjs +456 -0
  24. package/bin/install.js +38 -11
  25. package/docs/ARCHITECTURE.md +122 -216
  26. package/docs/ARTIFACT-AUTHORITY.md +90 -268
  27. package/docs/DECISIONS.md +75 -87
  28. package/docs/PHILOSOPHY.md +177 -0
  29. package/docs/PLUGIN-ISOLATION-CONTRACT.md +62 -39
  30. package/docs/RUNTIME-COMPAT-MATRIX.md +99 -156
  31. package/docs/SKILL-AUTHORING.md +94 -73
  32. package/docs/WORKFLOW-LIFECYCLE.md +93 -189
  33. package/hooks/README.md +17 -37
  34. package/hooks/_common.py +113 -0
  35. package/hooks/adapters/codex.py +9 -16
  36. package/hooks/adapters/grok.py +5 -5
  37. package/hooks/adapters/kimi.py +8 -14
  38. package/hooks/block_dangerous_commands.py +95 -0
  39. package/hooks/compact_context.py +65 -0
  40. package/hooks/mid_workflow_recall.py +25 -0
  41. package/hooks/post_edit_guard.py +105 -0
  42. package/hooks/session_context.py +30 -0
  43. package/package.json +17 -52
  44. package/skills/ultra-change/SKILL.md +97 -50
  45. package/skills/ultra-change/references/change-contract.md +40 -1
  46. package/skills/ultra-delegate/SKILL.md +82 -0
  47. package/skills/ultra-delegate/references/delegation-contract.md +51 -0
  48. package/skills/ultra-delegate/scripts/delegate_wait.py +86 -0
  49. package/skills/ultra-deliver/SKILL.md +61 -42
  50. package/skills/ultra-deliver/references/baseline-reconciliation.md +39 -20
  51. package/skills/ultra-dev/SKILL.md +96 -62
  52. package/skills/ultra-dev/references/debugging.md +22 -0
  53. package/skills/ultra-domain-modeling/SKILL.md +79 -0
  54. package/skills/ultra-grilling/SKILL.md +79 -0
  55. package/skills/ultra-init/SKILL.md +94 -37
  56. package/skills/ultra-init/references/brownfield-adoption.md +33 -83
  57. package/skills/ultra-init/scripts/init_project.cjs +84 -0
  58. package/skills/ultra-plan/SKILL.md +88 -68
  59. package/skills/ultra-research/SKILL.md +62 -48
  60. package/skills/ultra-research/references/00-problem-validation.md +5 -5
  61. package/skills/ultra-research/references/01-opportunity-discovery.md +3 -3
  62. package/skills/ultra-research/references/02-market-assessment.md +5 -4
  63. package/skills/ultra-research/references/03-competitive-landscape.md +3 -3
  64. package/skills/ultra-research/references/04-product-strategy.md +3 -3
  65. package/skills/ultra-research/references/05-assumptions-validation.md +5 -5
  66. package/skills/ultra-research/references/10-user-personas.md +3 -2
  67. package/skills/ultra-research/references/11-user-scenarios.md +3 -3
  68. package/skills/ultra-research/references/20-user-stories.md +4 -3
  69. package/skills/ultra-research/references/21-features-scope.md +3 -2
  70. package/skills/ultra-research/references/22-success-metrics.md +3 -3
  71. package/skills/ultra-research/references/30-architecture-context.md +3 -3
  72. package/skills/ultra-research/references/31-solution-strategy.md +3 -3
  73. package/skills/ultra-research/references/32-building-blocks.md +3 -3
  74. package/skills/ultra-research/references/40-deployment.md +3 -3
  75. package/skills/ultra-research/references/41-quality-risks.md +3 -3
  76. package/skills/ultra-research/references/99-synthesis.md +7 -7
  77. package/skills/ultra-review/SKILL.md +59 -32
  78. package/skills/ultra-review/references/code.md +17 -0
  79. package/skills/ultra-review/references/comments.md +12 -0
  80. package/skills/ultra-review/references/design.md +12 -0
  81. package/skills/ultra-review/references/errors.md +13 -0
  82. package/skills/ultra-review/references/spec.md +13 -0
  83. package/skills/ultra-review/references/tests.md +12 -0
  84. package/skills/ultra-review/references/worker-packet.md +40 -0
  85. package/skills/ultra-review/scripts/review_wait.py +26 -15
  86. package/skills/ultra-status/SKILL.md +61 -36
  87. package/skills/ultra-tdd/SKILL.md +81 -0
  88. package/skills/ultra-tdd/references/templates/README.md +20 -0
  89. package/skills/ultra-tdd/references/templates/feature-flag-default-audit.sh +79 -0
  90. package/skills/ultra-tdd/references/templates/persistence-real.ts +78 -0
  91. package/skills/ultra-tdd/references/templates/testcontainer-postgres.py +78 -0
  92. package/skills/ultra-tdd/references/templates/testcontainer-postgres.ts +73 -0
  93. package/skills/ultra-tdd/references/templates/vertical-slice.ts +66 -0
  94. package/skills/ultra-tdd/references/test-execution.md +18 -0
  95. package/skills/ultra-test/SKILL.md +70 -30
  96. package/skills/ultra-test/references/export-syntax.md +18 -0
  97. package/skills/ultra-test/scripts/worktree_digest.cjs +54 -0
  98. package/skills/ultra-think/SKILL.md +49 -27
  99. package/skills/ultra-think/references/autonomy-boundary.md +48 -0
  100. package/skills/ultra-think/references/interaction-boundary.md +18 -33
  101. package/.ultra-template/docs/research/README.md +0 -55
  102. package/.ultra-template/reports/templates/delivery-report.json +0 -17
  103. package/.ultra-template/reports/templates/test-report.json +0 -18
  104. package/.ultra-template/tasks/tasks.json +0 -15
  105. package/.ultra-template/templates/task-context.md +0 -19
  106. package/adapters/_shared/codex-assets.cjs +0 -725
  107. package/adapters/_shared/codex-ultra-tools-entry.cjs +0 -11
  108. package/adapters/_shared/interaction-contract.cjs +0 -129
  109. package/adapters/_shared/path-rewrite.cjs +0 -79
  110. package/adapters/_shared/runtime-native.cjs +0 -132
  111. package/adapters/_shared/settings-merge.cjs +0 -76
  112. package/agents/code-reviewer.md +0 -42
  113. package/agents/debugger.md +0 -40
  114. package/agents/review-code.md +0 -49
  115. package/agents/review-comments.md +0 -38
  116. package/agents/review-coordinator.md +0 -56
  117. package/agents/review-design.md +0 -40
  118. package/agents/review-errors.md +0 -43
  119. package/agents/review-spec.md +0 -39
  120. package/agents/review-tests.md +0 -40
  121. package/agents/tdd-runner.md +0 -38
  122. package/bin/orchestrator.js +0 -383
  123. package/commands/ultra-change.md +0 -10
  124. package/commands/ultra-deliver.md +0 -10
  125. package/commands/ultra-dev.md +0 -10
  126. package/commands/ultra-doctor.md +0 -10
  127. package/commands/ultra-init.md +0 -10
  128. package/commands/ultra-plan.md +0 -10
  129. package/commands/ultra-research.md +0 -10
  130. package/commands/ultra-review.md +0 -10
  131. package/commands/ultra-status.md +0 -10
  132. package/commands/ultra-test.md +0 -10
  133. package/commands/ultra-think.md +0 -10
  134. package/docs/AGENT-CONTEXT.md +0 -191
  135. package/docs/COMMIT-HASH-BACKFILL.md +0 -51
  136. package/docs/LEGACY-CLI-CROSSWALK.md +0 -175
  137. package/docs/ROADMAP.md +0 -101
  138. package/docs/STATE-DB-ACCESS-POLICY.md +0 -161
  139. package/hooks/active_task_context.py +0 -152
  140. package/hooks/context_envelope.py +0 -100
  141. package/hooks/health_check.py +0 -196
  142. package/hooks/pre_stop_check.py +0 -66
  143. package/hooks/runtime_paths.py +0 -396
  144. package/hooks/subagent_tracker.py +0 -88
  145. package/hooks/workflow_checkpoint.py +0 -76
  146. package/hooks/workflow_context.py +0 -48
  147. package/hooks/workflow_resume.py +0 -84
  148. package/mcp-server/hook-context.cjs +0 -38
  149. package/mcp-server/hook-event.cjs +0 -34
  150. package/mcp-server/lib/archive-journal.cjs +0 -1119
  151. package/mcp-server/lib/archive-mutation-worker.py +0 -365
  152. package/mcp-server/lib/artifact-registry.cjs +0 -1232
  153. package/mcp-server/lib/baseline-workflow.cjs +0 -1193
  154. package/mcp-server/lib/canonical-json.cjs +0 -19
  155. package/mcp-server/lib/change-authority.cjs +0 -26
  156. package/mcp-server/lib/change-packet.cjs +0 -790
  157. package/mcp-server/lib/change-workflow.cjs +0 -65
  158. package/mcp-server/lib/context-envelope.cjs +0 -581
  159. package/mcp-server/lib/context-paths.cjs +0 -142
  160. package/mcp-server/lib/decision-records.cjs +0 -423
  161. package/mcp-server/lib/delivery-transaction.cjs +0 -471
  162. package/mcp-server/lib/doctor-backup-worker.cjs +0 -328
  163. package/mcp-server/lib/doctor.cjs +0 -627
  164. package/mcp-server/lib/git-bootstrap.cjs +0 -651
  165. package/mcp-server/lib/init-project.cjs +0 -1021
  166. package/mcp-server/lib/kernel-change-workflow.cjs +0 -2029
  167. package/mcp-server/lib/legacy-change-workflow.cjs +0 -3032
  168. package/mcp-server/lib/managed-file-write.cjs +0 -172
  169. package/mcp-server/lib/plan-checkpoint.cjs +0 -177
  170. package/mcp-server/lib/plan-publication-worker.cjs +0 -830
  171. package/mcp-server/lib/plan-store.cjs +0 -794
  172. package/mcp-server/lib/prd-parser.cjs +0 -83
  173. package/mcp-server/lib/pricing.cjs +0 -44
  174. package/mcp-server/lib/project-context.cjs +0 -178
  175. package/mcp-server/lib/projector.cjs +0 -386
  176. package/mcp-server/lib/provider-refs.cjs +0 -42
  177. package/mcp-server/lib/runtime-paths.cjs +0 -1714
  178. package/mcp-server/lib/runtime-state.cjs +0 -222
  179. package/mcp-server/lib/safe-project-file.cjs +0 -385
  180. package/mcp-server/lib/stage-checkpoints.cjs +0 -463
  181. package/mcp-server/lib/state-authority.cjs +0 -95
  182. package/mcp-server/lib/state-db.cjs +0 -1580
  183. package/mcp-server/lib/state-ops.cjs +0 -1428
  184. package/mcp-server/lib/task-contract.cjs +0 -404
  185. package/mcp-server/lib/task-expander.cjs +0 -105
  186. package/mcp-server/lib/task-ledger.cjs +0 -1964
  187. package/mcp-server/lib/telemetry.cjs +0 -85
  188. package/mcp-server/lib/topo.cjs +0 -131
  189. package/mcp-server/lib/ultra-facade.cjs +0 -2684
  190. package/mcp-server/lib/worker-packet.cjs +0 -358
  191. package/mcp-server/server.cjs +0 -437
  192. package/orchestrator/auto-merge.cjs +0 -128
  193. package/orchestrator/daemon.cjs +0 -264
  194. package/orchestrator/dispatch-rules.cjs +0 -78
  195. package/orchestrator/parallel-orchestrator.cjs +0 -903
  196. package/orchestrator/planner/plan-builder.cjs +0 -125
  197. package/orchestrator/recovery.cjs +0 -188
  198. package/orchestrator/session-close-journal-worker.cjs +0 -5
  199. package/orchestrator/session-close-journal.cjs +0 -1014
  200. package/orchestrator/session-runner.cjs +0 -1153
  201. package/orchestrator/worktree-manager.cjs +0 -282
  202. package/settings.json +0 -7
  203. package/skills/cc-collab/SKILL.md +0 -42
  204. package/skills/code-review-expert/SKILL.md +0 -43
  205. package/skills/code-review-expert/references/correctness-reliability.md +0 -30
  206. package/skills/code-review-expert/references/design-boundaries.md +0 -26
  207. package/skills/code-review-expert/references/removal-plan.md +0 -24
  208. package/skills/codex-collab/SKILL.md +0 -49
  209. package/skills/codex-collab/evals/evals.json +0 -35
  210. package/skills/integration-rules/SKILL.md +0 -32
  211. package/skills/security-rules/SKILL.md +0 -38
  212. package/skills/testing-rules/SKILL.md +0 -32
  213. package/skills/ultra-doctor/SKILL.md +0 -41
  214. package/skills/ultra-plan/references/semantic-preflight.md +0 -20
  215. package/skills/ultra-verify/SKILL.md +0 -46
  216. package/skills/ultra-verify/evals/evals.json +0 -46
  217. package/skills/ultra-verify/references/cross-verify-modes.md +0 -28
  218. package/skills/ultra-verify/references/evidence-status.md +0 -21
  219. package/skills/ultra-verify/scripts/verify_wait.py +0 -94
  220. package/spec/cli-protocol.md +0 -102
  221. package/spec/mcp-tools.yaml +0 -312
  222. package/spec/schemas/baseline-reconciliation.v1.schema.json +0 -73
  223. package/spec/schemas/change-delta.v1.schema.json +0 -153
  224. package/spec/schemas/command-manifest.schema.json +0 -29
  225. package/spec/schemas/context-file.v4.5.schema.json +0 -54
  226. package/spec/schemas/delivery-report.v1.schema.json +0 -66
  227. package/spec/schemas/documentation-reconciliation.v1.schema.json +0 -106
  228. package/spec/schemas/mcp-tools.schema.json +0 -136
  229. package/spec/schemas/skill-manifest.schema.json +0 -24
  230. package/spec/schemas/state-db.sql +0 -641
  231. package/spec/schemas/task-ledger.v2.schema.json +0 -296
  232. package/spec/schemas/tasks.v4.5.schema.json +0 -96
  233. package/spec/schemas/test-report.v1.schema.json +0 -225
  234. package/ultra-tools/cli.cjs +0 -129
  235. package/ultra-tools/commands/db.cjs +0 -226
  236. package/ultra-tools/commands/legacy-memory.cjs +0 -159
  237. package/ultra-tools/commands/migrate.cjs +0 -1386
  238. package/ultra-tools/commands/session.cjs +0 -213
  239. package/ultra-tools/commands/status.cjs +0 -559
  240. package/ultra-tools/commands/system.cjs +0 -498
  241. package/ultra-tools/commands/task.cjs +0 -105
@@ -1,66 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://ultra-builder-pro.dev/schemas/delivery-report.v1.schema.json",
4
- "title": "Ultra delivery report v1",
5
- "type": "object",
6
- "required": [
7
- "$schema", "change_id", "archive_status", "baseline_id", "baseline_status",
8
- "git_commit", "worktree_digest", "context_digest", "checks", "rollback", "timestamp"
9
- ],
10
- "additionalProperties": false,
11
- "properties": {
12
- "$schema": { "const": "ultra-delivery-report-v1" },
13
- "change_id": { "type": ["string", "null"] },
14
- "archive_status": { "type": ["string", "null"], "enum": ["archived", null] },
15
- "baseline_id": { "type": ["string", "null"] },
16
- "baseline_status": { "type": ["string", "null"] },
17
- "git_commit": { "type": ["string", "null"] },
18
- "worktree_digest": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
19
- "context_digest": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
20
- "checks": {
21
- "type": "array",
22
- "items": {
23
- "type": "object",
24
- "required": ["command", "status", "exit_code", "evidence"],
25
- "additionalProperties": false,
26
- "properties": {
27
- "command": { "type": "string", "minLength": 1 },
28
- "status": { "enum": ["pass", "fail"] },
29
- "exit_code": { "type": "integer" },
30
- "evidence": { "type": "string", "minLength": 1 }
31
- },
32
- "allOf": [
33
- {
34
- "if": { "properties": { "status": { "const": "pass" } } },
35
- "then": { "properties": { "exit_code": { "const": 0 } } }
36
- },
37
- {
38
- "if": { "properties": { "status": { "const": "fail" } } },
39
- "then": { "properties": { "exit_code": { "not": { "const": 0 } } } }
40
- }
41
- ]
42
- }
43
- },
44
- "rollback": { "type": ["string", "null"] },
45
- "timestamp": { "type": ["string", "null"], "format": "date-time" }
46
- },
47
- "allOf": [
48
- {
49
- "if": { "properties": { "archive_status": { "const": "archived" } } },
50
- "then": {
51
- "properties": {
52
- "change_id": { "type": "string", "minLength": 1 },
53
- "baseline_id": { "type": "string", "minLength": 1 },
54
- "baseline_status": { "type": "string", "minLength": 1 },
55
- "context_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
56
- "checks": {
57
- "minItems": 1,
58
- "items": { "properties": { "status": { "const": "pass" }, "exit_code": { "const": 0 } } }
59
- },
60
- "rollback": { "type": "string", "minLength": 1 },
61
- "timestamp": { "type": "string", "format": "date-time" }
62
- }
63
- }
64
- }
65
- ]
66
- }
@@ -1,106 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://ultra-builder-pro.dev/schemas/documentation-reconciliation.v1.schema.json",
4
- "title": "Ultra documentation reconciliation v1",
5
- "type": "object",
6
- "required": [
7
- "$schema",
8
- "change_id",
9
- "delta_artifact_id",
10
- "delta_digest",
11
- "documents"
12
- ],
13
- "additionalProperties": false,
14
- "properties": {
15
- "$schema": { "const": "ultra-documentation-reconciliation-v1" },
16
- "change_id": { "type": "string", "minLength": 1 },
17
- "delta_artifact_id": { "type": "string", "minLength": 1 },
18
- "delta_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
19
- "no_change_reason": { "type": "string", "minLength": 3 },
20
- "documents": {
21
- "type": "array",
22
- "items": {
23
- "type": "object",
24
- "required": [
25
- "path",
26
- "action",
27
- "overlay_path",
28
- "before_digest",
29
- "after_digest",
30
- "delta_refs",
31
- "acceptance_refs",
32
- "verification",
33
- "consumers"
34
- ],
35
- "additionalProperties": false,
36
- "properties": {
37
- "path": { "type": "string", "minLength": 1 },
38
- "action": { "enum": ["add", "update"] },
39
- "overlay_path": { "type": "string", "minLength": 1 },
40
- "before_digest": {
41
- "type": ["string", "null"],
42
- "pattern": "^[0-9a-f]{64}$"
43
- },
44
- "after_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
45
- "delta_refs": {
46
- "type": "array",
47
- "minItems": 1,
48
- "uniqueItems": true,
49
- "items": { "type": "string", "minLength": 1 }
50
- },
51
- "acceptance_refs": {
52
- "type": "array",
53
- "minItems": 1,
54
- "uniqueItems": true,
55
- "items": { "type": "string", "minLength": 1 }
56
- },
57
- "verification": {
58
- "type": "array",
59
- "minItems": 1,
60
- "items": {
61
- "type": "object",
62
- "required": ["command", "status", "evidence_refs"],
63
- "additionalProperties": false,
64
- "properties": {
65
- "command": { "type": "string", "minLength": 1 },
66
- "status": { "const": "pass" },
67
- "evidence_refs": {
68
- "type": "array",
69
- "minItems": 1,
70
- "uniqueItems": true,
71
- "items": { "type": "string", "minLength": 1 }
72
- }
73
- }
74
- }
75
- },
76
- "consumers": {
77
- "type": "array",
78
- "items": {
79
- "type": "object",
80
- "required": ["type", "id", "relation"],
81
- "additionalProperties": false,
82
- "properties": {
83
- "type": {
84
- "enum": ["artifact", "project", "baseline", "change", "task", "workflow", "external"]
85
- },
86
- "id": { "type": "string", "minLength": 1 },
87
- "relation": { "type": "string", "minLength": 1 }
88
- }
89
- }
90
- },
91
- "no_consumer_reason": { "type": "string", "minLength": 3 }
92
- }
93
- }
94
- }
95
- },
96
- "allOf": [
97
- {
98
- "if": {
99
- "properties": {
100
- "documents": { "maxItems": 0 }
101
- }
102
- },
103
- "then": { "required": ["no_change_reason"] }
104
- }
105
- ]
106
- }
@@ -1,136 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://ultra-builder-pro.dev/spec/mcp-tools.schema.json",
4
- "title": "MCP tools manifest",
5
- "description": "Meta-schema describing the shape of spec/mcp-tools.yaml. The manifest is the single source for published MCP tool contracts.",
6
- "type": "object",
7
- "required": ["version", "info", "tools"],
8
- "additionalProperties": false,
9
- "properties": {
10
- "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+(\\.[0-9]+)?$" },
11
- "info": {
12
- "type": "object",
13
- "required": ["title", "phase", "trace_to"],
14
- "additionalProperties": false,
15
- "properties": {
16
- "title": { "type": "string" },
17
- "phase": { "type": "string" },
18
- "trace_to": { "type": "string" },
19
- "notes": { "type": "string" }
20
- }
21
- },
22
- "families": {
23
- "type": "array",
24
- "items": {
25
- "type": "object",
26
- "required": ["name", "description"],
27
- "additionalProperties": false,
28
- "properties": {
29
- "name": { "type": "string", "pattern": "^[a-z]+$" },
30
- "description": { "type": "string", "minLength": 10 },
31
- "phase": { "type": "string" }
32
- }
33
- }
34
- },
35
- "tools": {
36
- "type": "array",
37
- "minItems": 1,
38
- "items": { "$ref": "#/$defs/tool" }
39
- }
40
- },
41
- "$defs": {
42
- "tool": {
43
- "type": "object",
44
- "required": [
45
- "name",
46
- "family",
47
- "description",
48
- "phase",
49
- "input_schema",
50
- "output_schema",
51
- "errors",
52
- "cli_subcommand"
53
- ],
54
- "additionalProperties": false,
55
- "properties": {
56
- "name": {
57
- "type": "string",
58
- "pattern": "^[a-z][a-z_]*\\.[a-z][a-z_]*$",
59
- "description": "family.verb naming convention"
60
- },
61
- "family": {
62
- "type": "string",
63
- "enum": ["ultra", "task", "memory", "review", "impact", "skill", "session", "ask", "plan", "baseline", "change", "decision", "workflow", "artifact", "system"]
64
- },
65
- "description": { "type": "string", "minLength": 10 },
66
- "phase": {
67
- "type": "string",
68
- "pattern": "^[0-9]+(\\.[0-9]+)?[ab]?$",
69
- "description": "earliest phase that implements this tool (e.g. 2, 4.5, 4.6a, 8a)"
70
- },
71
- "readonly": { "type": "boolean", "default": false },
72
- "writer_role": {
73
- "type": "string",
74
- "enum": ["mcp", "cli", "orchestrator", "any"],
75
- "default": "mcp",
76
- "description": "which process is allowed to invoke (R25 access policy)"
77
- },
78
- "input_schema": { "$ref": "#/$defs/jsonSchemaFragment" },
79
- "output_schema": { "$ref": "#/$defs/jsonSchemaFragment" },
80
- "errors": {
81
- "type": "array",
82
- "minItems": 1,
83
- "items": {
84
- "type": "object",
85
- "required": ["code", "description"],
86
- "additionalProperties": false,
87
- "properties": {
88
- "code": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" },
89
- "description": { "type": "string", "minLength": 5 },
90
- "retriable": { "type": "boolean", "default": false }
91
- }
92
- }
93
- },
94
- "cli_subcommand": {
95
- "type": "string",
96
- "pattern": "^[a-z][a-z\\- ]*$",
97
- "description": "ultra-tools subcommand path (e.g. 'task create', 'session spawn')"
98
- },
99
- "emits_events": {
100
- "type": "array",
101
- "items": { "type": "string" },
102
- "description": "events.type values appended to state.db on success"
103
- },
104
- "trace_to": {
105
- "type": "string",
106
- "description": "current source or decision reference"
107
- }
108
- }
109
- },
110
- "jsonSchemaFragment": {
111
- "type": "object",
112
- "description": "embedded JSON Schema (Draft 2020-12 subset). validate-mcp-tools.cjs compiles each fragment to ensure it is a usable schema.",
113
- "required": ["type"],
114
- "properties": {
115
- "type": {},
116
- "properties": {},
117
- "required": {},
118
- "additionalProperties": {},
119
- "items": {},
120
- "enum": {},
121
- "oneOf": {},
122
- "anyOf": {},
123
- "allOf": {},
124
- "$ref": {},
125
- "format": {},
126
- "pattern": {},
127
- "minimum": {},
128
- "maximum": {},
129
- "minLength": {},
130
- "maxLength": {},
131
- "minItems": {},
132
- "description": {}
133
- }
134
- }
135
- }
136
- }
@@ -1,24 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://ultra-builder-pro.dev/spec/skill-manifest.schema.json",
4
- "title": "Portable Agent Skill frontmatter",
5
- "description": "Canonical source contract for skills/*/SKILL.md. Host invocation policy, UI metadata, runtime dependencies, and command hints belong in adapters or host-native metadata, not model instructions.",
6
- "type": "object",
7
- "required": ["name", "description"],
8
- "additionalProperties": false,
9
- "properties": {
10
- "name": {
11
- "type": "string",
12
- "minLength": 1,
13
- "maxLength": 64,
14
- "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
15
- "description": "Portable Agent Skills name; must match the parent directory."
16
- },
17
- "description": {
18
- "type": "string",
19
- "minLength": 10,
20
- "maxLength": 1024,
21
- "description": "Concise discovery metadata that states both what the skill does and when to use it."
22
- }
23
- }
24
- }