ultra-builder-pro-cli 0.25.0 → 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.
- package/.ultra-template/contexts/TEMPLATE.md +87 -0
- package/.ultra-template/decisions/.gitkeep +1 -0
- package/.ultra-template/evidence/.gitkeep +1 -0
- package/.ultra-template/north-star.md +46 -0
- package/.ultra-template/research/.gitkeep +1 -0
- package/.ultra-template/specs/discovery.md +2 -2
- package/.ultra-template/tasks.json +3 -0
- package/.ultra-template/test-report.json +27 -0
- package/CHANGELOG.md +49 -0
- package/README.md +217 -579
- package/adapters/_shared/delegate-profiles/kimi-read-only.md +15 -0
- package/adapters/_shared/delegate-profiles/kimi-write.md +17 -0
- package/adapters/_shared/file-ops.cjs +76 -2
- package/adapters/_shared/host-profile.cjs +97 -0
- package/adapters/_shared/plugin-core.cjs +204 -0
- package/adapters/_shared/runtime-assets.cjs +31 -96
- package/adapters/claude.js +92 -291
- package/adapters/codex.js +309 -842
- package/adapters/grok.js +143 -1469
- package/adapters/kimi.js +124 -1053
- package/adapters/opencode.js +230 -742
- package/bin/delegate-worker.cjs +323 -0
- package/bin/delegate.cjs +456 -0
- package/bin/install.js +38 -11
- package/docs/ARCHITECTURE.md +122 -216
- package/docs/ARTIFACT-AUTHORITY.md +90 -268
- package/docs/DECISIONS.md +75 -87
- package/docs/PHILOSOPHY.md +177 -0
- package/docs/PLUGIN-ISOLATION-CONTRACT.md +62 -39
- package/docs/RUNTIME-COMPAT-MATRIX.md +99 -156
- package/docs/SKILL-AUTHORING.md +94 -73
- package/docs/WORKFLOW-LIFECYCLE.md +93 -189
- package/hooks/README.md +17 -37
- package/hooks/_common.py +113 -0
- package/hooks/adapters/codex.py +9 -16
- package/hooks/adapters/grok.py +5 -5
- package/hooks/adapters/kimi.py +8 -14
- package/hooks/block_dangerous_commands.py +95 -0
- package/hooks/compact_context.py +65 -0
- package/hooks/mid_workflow_recall.py +25 -0
- package/hooks/post_edit_guard.py +105 -0
- package/hooks/session_context.py +30 -0
- package/package.json +17 -52
- package/skills/ultra-change/SKILL.md +97 -50
- package/skills/ultra-change/references/change-contract.md +40 -1
- package/skills/ultra-delegate/SKILL.md +82 -0
- package/skills/ultra-delegate/references/delegation-contract.md +51 -0
- package/skills/ultra-delegate/scripts/delegate_wait.py +86 -0
- package/skills/ultra-deliver/SKILL.md +61 -42
- package/skills/ultra-deliver/references/baseline-reconciliation.md +39 -20
- package/skills/ultra-dev/SKILL.md +96 -62
- package/skills/ultra-dev/references/debugging.md +22 -0
- package/skills/ultra-domain-modeling/SKILL.md +79 -0
- package/skills/ultra-grilling/SKILL.md +79 -0
- package/skills/ultra-init/SKILL.md +94 -37
- package/skills/ultra-init/references/brownfield-adoption.md +33 -83
- package/skills/ultra-init/scripts/init_project.cjs +84 -0
- package/skills/ultra-plan/SKILL.md +88 -68
- package/skills/ultra-research/SKILL.md +62 -48
- package/skills/ultra-research/references/00-problem-validation.md +5 -5
- package/skills/ultra-research/references/01-opportunity-discovery.md +3 -3
- package/skills/ultra-research/references/02-market-assessment.md +5 -4
- package/skills/ultra-research/references/03-competitive-landscape.md +3 -3
- package/skills/ultra-research/references/04-product-strategy.md +3 -3
- package/skills/ultra-research/references/05-assumptions-validation.md +5 -5
- package/skills/ultra-research/references/10-user-personas.md +3 -2
- package/skills/ultra-research/references/11-user-scenarios.md +3 -3
- package/skills/ultra-research/references/20-user-stories.md +4 -3
- package/skills/ultra-research/references/21-features-scope.md +3 -2
- package/skills/ultra-research/references/22-success-metrics.md +3 -3
- package/skills/ultra-research/references/30-architecture-context.md +3 -3
- package/skills/ultra-research/references/31-solution-strategy.md +3 -3
- package/skills/ultra-research/references/32-building-blocks.md +3 -3
- package/skills/ultra-research/references/40-deployment.md +3 -3
- package/skills/ultra-research/references/41-quality-risks.md +3 -3
- package/skills/ultra-research/references/99-synthesis.md +7 -7
- package/skills/ultra-review/SKILL.md +59 -32
- package/skills/ultra-review/references/code.md +17 -0
- package/skills/ultra-review/references/comments.md +12 -0
- package/skills/ultra-review/references/design.md +12 -0
- package/skills/ultra-review/references/errors.md +13 -0
- package/skills/ultra-review/references/spec.md +13 -0
- package/skills/ultra-review/references/tests.md +12 -0
- package/skills/ultra-review/references/worker-packet.md +40 -0
- package/skills/ultra-review/scripts/review_wait.py +26 -15
- package/skills/ultra-status/SKILL.md +61 -36
- package/skills/ultra-tdd/SKILL.md +81 -0
- package/skills/ultra-tdd/references/templates/README.md +20 -0
- package/skills/ultra-tdd/references/templates/feature-flag-default-audit.sh +79 -0
- package/skills/ultra-tdd/references/templates/persistence-real.ts +78 -0
- package/skills/ultra-tdd/references/templates/testcontainer-postgres.py +78 -0
- package/skills/ultra-tdd/references/templates/testcontainer-postgres.ts +73 -0
- package/skills/ultra-tdd/references/templates/vertical-slice.ts +66 -0
- package/skills/ultra-tdd/references/test-execution.md +18 -0
- package/skills/ultra-test/SKILL.md +70 -30
- package/skills/ultra-test/references/export-syntax.md +18 -0
- package/skills/ultra-test/scripts/worktree_digest.cjs +54 -0
- package/skills/ultra-think/SKILL.md +49 -27
- package/skills/ultra-think/references/autonomy-boundary.md +48 -0
- package/skills/ultra-think/references/interaction-boundary.md +18 -33
- package/.ultra-template/docs/research/README.md +0 -55
- package/.ultra-template/reports/templates/delivery-report.json +0 -17
- package/.ultra-template/reports/templates/test-report.json +0 -18
- package/.ultra-template/tasks/tasks.json +0 -15
- package/.ultra-template/templates/task-context.md +0 -19
- package/adapters/_shared/codex-assets.cjs +0 -725
- package/adapters/_shared/codex-ultra-tools-entry.cjs +0 -11
- package/adapters/_shared/interaction-contract.cjs +0 -129
- package/adapters/_shared/path-rewrite.cjs +0 -79
- package/adapters/_shared/runtime-native.cjs +0 -132
- package/adapters/_shared/settings-merge.cjs +0 -76
- package/agents/code-reviewer.md +0 -42
- package/agents/debugger.md +0 -40
- package/agents/review-code.md +0 -49
- package/agents/review-comments.md +0 -38
- package/agents/review-coordinator.md +0 -56
- package/agents/review-design.md +0 -40
- package/agents/review-errors.md +0 -43
- package/agents/review-spec.md +0 -39
- package/agents/review-tests.md +0 -40
- package/agents/tdd-runner.md +0 -38
- package/bin/orchestrator.js +0 -383
- package/commands/ultra-change.md +0 -10
- package/commands/ultra-deliver.md +0 -10
- package/commands/ultra-dev.md +0 -10
- package/commands/ultra-doctor.md +0 -10
- package/commands/ultra-init.md +0 -10
- package/commands/ultra-plan.md +0 -10
- package/commands/ultra-research.md +0 -10
- package/commands/ultra-review.md +0 -10
- package/commands/ultra-status.md +0 -10
- package/commands/ultra-test.md +0 -10
- package/commands/ultra-think.md +0 -10
- package/docs/AGENT-CONTEXT.md +0 -191
- package/docs/COMMIT-HASH-BACKFILL.md +0 -51
- package/docs/LEGACY-CLI-CROSSWALK.md +0 -175
- package/docs/ROADMAP.md +0 -101
- package/docs/STATE-DB-ACCESS-POLICY.md +0 -161
- package/hooks/active_task_context.py +0 -152
- package/hooks/context_envelope.py +0 -100
- package/hooks/health_check.py +0 -196
- package/hooks/pre_stop_check.py +0 -66
- package/hooks/runtime_paths.py +0 -396
- package/hooks/subagent_tracker.py +0 -88
- package/hooks/workflow_checkpoint.py +0 -76
- package/hooks/workflow_context.py +0 -48
- package/hooks/workflow_resume.py +0 -84
- package/mcp-server/hook-context.cjs +0 -38
- package/mcp-server/hook-event.cjs +0 -34
- package/mcp-server/lib/archive-journal.cjs +0 -1119
- package/mcp-server/lib/archive-mutation-worker.py +0 -365
- package/mcp-server/lib/artifact-registry.cjs +0 -1232
- package/mcp-server/lib/baseline-workflow.cjs +0 -1193
- package/mcp-server/lib/canonical-json.cjs +0 -19
- package/mcp-server/lib/change-authority.cjs +0 -26
- package/mcp-server/lib/change-packet.cjs +0 -790
- package/mcp-server/lib/change-workflow.cjs +0 -65
- package/mcp-server/lib/context-envelope.cjs +0 -581
- package/mcp-server/lib/context-paths.cjs +0 -142
- package/mcp-server/lib/decision-records.cjs +0 -423
- package/mcp-server/lib/delivery-transaction.cjs +0 -471
- package/mcp-server/lib/doctor-backup-worker.cjs +0 -328
- package/mcp-server/lib/doctor.cjs +0 -627
- package/mcp-server/lib/git-bootstrap.cjs +0 -651
- package/mcp-server/lib/init-project.cjs +0 -1021
- package/mcp-server/lib/kernel-change-workflow.cjs +0 -2029
- package/mcp-server/lib/legacy-change-workflow.cjs +0 -3032
- package/mcp-server/lib/managed-file-write.cjs +0 -172
- package/mcp-server/lib/plan-checkpoint.cjs +0 -177
- package/mcp-server/lib/plan-publication-worker.cjs +0 -830
- package/mcp-server/lib/plan-store.cjs +0 -794
- package/mcp-server/lib/prd-parser.cjs +0 -83
- package/mcp-server/lib/pricing.cjs +0 -44
- package/mcp-server/lib/project-context.cjs +0 -178
- package/mcp-server/lib/projector.cjs +0 -386
- package/mcp-server/lib/provider-refs.cjs +0 -42
- package/mcp-server/lib/runtime-paths.cjs +0 -1687
- package/mcp-server/lib/runtime-state.cjs +0 -222
- package/mcp-server/lib/safe-project-file.cjs +0 -385
- package/mcp-server/lib/stage-checkpoints.cjs +0 -463
- package/mcp-server/lib/state-authority.cjs +0 -95
- package/mcp-server/lib/state-db.cjs +0 -1580
- package/mcp-server/lib/state-ops.cjs +0 -1428
- package/mcp-server/lib/task-contract.cjs +0 -404
- package/mcp-server/lib/task-expander.cjs +0 -105
- package/mcp-server/lib/task-ledger.cjs +0 -1964
- package/mcp-server/lib/telemetry.cjs +0 -85
- package/mcp-server/lib/topo.cjs +0 -131
- package/mcp-server/lib/ultra-facade.cjs +0 -2684
- package/mcp-server/lib/worker-packet.cjs +0 -358
- package/mcp-server/server.cjs +0 -437
- package/orchestrator/auto-merge.cjs +0 -128
- package/orchestrator/daemon.cjs +0 -264
- package/orchestrator/dispatch-rules.cjs +0 -78
- package/orchestrator/parallel-orchestrator.cjs +0 -903
- package/orchestrator/planner/plan-builder.cjs +0 -125
- package/orchestrator/recovery.cjs +0 -188
- package/orchestrator/session-close-journal-worker.cjs +0 -5
- package/orchestrator/session-close-journal.cjs +0 -1014
- package/orchestrator/session-runner.cjs +0 -1153
- package/orchestrator/worktree-manager.cjs +0 -282
- package/settings.json +0 -7
- package/skills/cc-collab/SKILL.md +0 -42
- package/skills/code-review-expert/SKILL.md +0 -43
- package/skills/code-review-expert/references/correctness-reliability.md +0 -30
- package/skills/code-review-expert/references/design-boundaries.md +0 -26
- package/skills/code-review-expert/references/removal-plan.md +0 -24
- package/skills/codex-collab/SKILL.md +0 -49
- package/skills/codex-collab/evals/evals.json +0 -35
- package/skills/integration-rules/SKILL.md +0 -32
- package/skills/security-rules/SKILL.md +0 -38
- package/skills/testing-rules/SKILL.md +0 -32
- package/skills/ultra-doctor/SKILL.md +0 -41
- package/skills/ultra-plan/references/semantic-preflight.md +0 -20
- package/skills/ultra-verify/SKILL.md +0 -46
- package/skills/ultra-verify/evals/evals.json +0 -46
- package/skills/ultra-verify/references/cross-verify-modes.md +0 -28
- package/skills/ultra-verify/references/evidence-status.md +0 -21
- package/skills/ultra-verify/scripts/verify_wait.py +0 -94
- package/spec/cli-protocol.md +0 -102
- package/spec/mcp-tools.yaml +0 -312
- package/spec/schemas/baseline-reconciliation.v1.schema.json +0 -73
- package/spec/schemas/change-delta.v1.schema.json +0 -153
- package/spec/schemas/command-manifest.schema.json +0 -29
- package/spec/schemas/context-file.v4.5.schema.json +0 -54
- package/spec/schemas/delivery-report.v1.schema.json +0 -66
- package/spec/schemas/documentation-reconciliation.v1.schema.json +0 -106
- package/spec/schemas/mcp-tools.schema.json +0 -136
- package/spec/schemas/skill-manifest.schema.json +0 -24
- package/spec/schemas/state-db.sql +0 -641
- package/spec/schemas/task-ledger.v2.schema.json +0 -296
- package/spec/schemas/tasks.v4.5.schema.json +0 -96
- package/spec/schemas/test-report.v1.schema.json +0 -225
- package/ultra-tools/cli.cjs +0 -129
- package/ultra-tools/commands/db.cjs +0 -226
- package/ultra-tools/commands/legacy-memory.cjs +0 -159
- package/ultra-tools/commands/migrate.cjs +0 -1386
- package/ultra-tools/commands/session.cjs +0 -213
- package/ultra-tools/commands/status.cjs +0 -559
- package/ultra-tools/commands/system.cjs +0 -498
- 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
|
-
}
|