ultra-builder-pro-cli 0.20.0 → 0.22.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 (109) hide show
  1. package/.ultra-template/docs/research/README.md +26 -5
  2. package/.ultra-template/specs/discovery.md +1 -1
  3. package/.ultra-template/tasks/tasks.json +10 -3
  4. package/.ultra-template/templates/task-context.md +19 -0
  5. package/CHANGELOG.md +106 -0
  6. package/README.md +215 -41
  7. package/adapters/_shared/codex-assets.cjs +69 -11
  8. package/adapters/_shared/interaction-contract.cjs +36 -3
  9. package/adapters/_shared/runtime-assets.cjs +41 -1
  10. package/adapters/claude.js +7 -5
  11. package/adapters/codex.js +1 -1
  12. package/adapters/kimi.js +2 -8
  13. package/adapters/opencode.js +43 -30
  14. package/bin/orchestrator.js +64 -24
  15. package/docs/AGENT-CONTEXT.md +89 -49
  16. package/docs/ARCHITECTURE.md +112 -45
  17. package/docs/ARTIFACT-AUTHORITY.md +274 -0
  18. package/docs/COMMIT-HASH-BACKFILL.md +33 -90
  19. package/docs/DECISIONS.md +14 -6
  20. package/docs/LEGACY-CLI-CROSSWALK.md +16 -6
  21. package/docs/PLUGIN-ISOLATION-CONTRACT.md +6 -4
  22. package/docs/ROADMAP.md +20 -6
  23. package/docs/RUNTIME-COMPAT-MATRIX.md +29 -16
  24. package/docs/STATE-DB-ACCESS-POLICY.md +43 -13
  25. package/docs/WORKFLOW-LIFECYCLE.md +105 -50
  26. package/hooks/README.md +10 -8
  27. package/hooks/active_task_context.py +105 -18
  28. package/hooks/context_spine.py +16 -4
  29. package/hooks/health_check.py +5 -4
  30. package/hooks/pre_stop_check.py +5 -2
  31. package/hooks/runtime_paths.py +396 -0
  32. package/hooks/subagent_tracker.py +5 -2
  33. package/hooks/workflow_checkpoint.py +16 -3
  34. package/hooks/workflow_context.py +11 -3
  35. package/hooks/workflow_resume.py +7 -4
  36. package/mcp-server/breadcrumb.cjs +20 -2
  37. package/mcp-server/lib/archive-journal.cjs +1026 -111
  38. package/mcp-server/lib/archive-mutation-worker.py +365 -0
  39. package/mcp-server/lib/artifact-registry.cjs +1127 -0
  40. package/mcp-server/lib/baseline-workflow.cjs +69 -28
  41. package/mcp-server/lib/change-packet.cjs +818 -0
  42. package/mcp-server/lib/change-workflow.cjs +932 -176
  43. package/mcp-server/lib/context-paths.cjs +142 -0
  44. package/mcp-server/lib/context-spine.cjs +511 -45
  45. package/mcp-server/lib/decision-dialogue.cjs +345 -3
  46. package/mcp-server/lib/delivery-transaction.cjs +471 -0
  47. package/mcp-server/lib/doctor-backup-worker.cjs +328 -0
  48. package/mcp-server/lib/doctor.cjs +401 -11
  49. package/mcp-server/lib/git-bootstrap.cjs +458 -47
  50. package/mcp-server/lib/init-project.cjs +240 -95
  51. package/mcp-server/lib/plan-publication-worker.cjs +830 -0
  52. package/mcp-server/lib/plan-store.cjs +700 -5
  53. package/mcp-server/lib/project-breadcrumb.cjs +23 -4
  54. package/mcp-server/lib/projector.cjs +211 -42
  55. package/mcp-server/lib/runtime-paths.cjs +1687 -0
  56. package/mcp-server/lib/safe-project-file.cjs +385 -0
  57. package/mcp-server/lib/spec-learning.cjs +28 -12
  58. package/mcp-server/lib/state-authority.cjs +19 -3
  59. package/mcp-server/lib/state-db.cjs +263 -9
  60. package/mcp-server/lib/state-ops.cjs +254 -50
  61. package/mcp-server/lib/task-ledger.cjs +1342 -0
  62. package/mcp-server/lib/telemetry.cjs +12 -3
  63. package/mcp-server/lib/workflow-state.cjs +610 -58
  64. package/mcp-server/server.cjs +423 -42
  65. package/orchestrator/daemon.cjs +2 -10
  66. package/orchestrator/parallel-orchestrator.cjs +314 -50
  67. package/orchestrator/planner/plan-builder.cjs +1 -1
  68. package/orchestrator/recovery.cjs +125 -7
  69. package/orchestrator/session-close-journal-worker.cjs +5 -0
  70. package/orchestrator/session-close-journal.cjs +1014 -0
  71. package/orchestrator/session-runner.cjs +679 -69
  72. package/orchestrator/worktree-manager.cjs +186 -35
  73. package/package.json +2 -3
  74. package/skills/cc-collab/SKILL.md +4 -1
  75. package/skills/codex-collab/SKILL.md +5 -2
  76. package/skills/ultra-change/SKILL.md +34 -8
  77. package/skills/ultra-deliver/SKILL.md +26 -11
  78. package/skills/ultra-dev/SKILL.md +52 -10
  79. package/skills/ultra-doctor/SKILL.md +16 -3
  80. package/skills/ultra-init/SKILL.md +22 -11
  81. package/skills/ultra-plan/SKILL.md +58 -18
  82. package/skills/ultra-research/SKILL.md +37 -35
  83. package/skills/ultra-review/SKILL.md +14 -8
  84. package/skills/ultra-status/SKILL.md +18 -9
  85. package/skills/ultra-test/SKILL.md +11 -5
  86. package/skills/ultra-think/SKILL.md +6 -2
  87. package/skills/ultra-think/references/decision-dialogue.md +17 -6
  88. package/skills/ultra-verify/SKILL.md +4 -1
  89. package/spec/cli-protocol.md +21 -7
  90. package/spec/mcp-tools.yaml +629 -44
  91. package/spec/schemas/change-delta.v1.schema.json +153 -0
  92. package/spec/schemas/context-file.v4.5.schema.json +1 -1
  93. package/spec/schemas/documentation-reconciliation.v1.schema.json +106 -0
  94. package/spec/schemas/mcp-tools.schema.json +1 -1
  95. package/spec/schemas/state-db.sql +51 -14
  96. package/spec/schemas/task-ledger.v1.schema.json +217 -0
  97. package/spec/schemas/tasks.v4.5.schema.json +1 -1
  98. package/ultra-tools/cli.cjs +3 -2
  99. package/ultra-tools/commands/db.cjs +76 -25
  100. package/ultra-tools/commands/migrate.cjs +1000 -82
  101. package/ultra-tools/commands/session.cjs +34 -8
  102. package/ultra-tools/commands/status.cjs +32 -6
  103. package/ultra-tools/commands/system.cjs +129 -22
  104. package/.ultra-template/tasks/contexts/TEMPLATE.md +0 -19
  105. package/commands/learn.md +0 -10
  106. package/orchestrator/skill-miner.cjs +0 -133
  107. package/output-styles/coding-vibes.md +0 -67
  108. package/output-styles/structural-thinking.md +0 -61
  109. package/skills/learn/SKILL.md +0 -58
@@ -1,61 +0,0 @@
1
- ---
2
- name: Structural Thinking
3
- description: Structural thinking with architectural clarity - naturally considers foundations, layers, and clean interfaces
4
- ---
5
-
6
- # Structural Thinking Style 🏗️
7
-
8
- Your communication naturally follows structured, layered thinking patterns. You instinctively break problems into foundational components, interfaces, and hierarchical organization.
9
-
10
- ## Core Rule: Language Adaptation
11
- **CRITICAL: Always match the user's language and cultural context while maintaining the structured thinking style.**
12
-
13
- ## Communication Style
14
-
15
- **Natural Thinking Pattern:**
16
- - Break problems into foundational layers and dependencies
17
- - Instinctively consider modularity and composition
18
- - Think in hierarchies, interfaces, and clean boundaries
19
- - Build solutions that can be extended and composed
20
-
21
- **Speaking Style:**
22
- - Structured and methodical in expression
23
- - Use architectural metaphors naturally
24
- - Speak with quiet confidence and clarity
25
- - Emphasize principles and reasoning behind ideas
26
-
27
- **Tone Characteristics:**
28
- - Thoughtful and deliberate, never rushed
29
- - Educational but not condescending
30
- - Always explain the "why" behind thoughts
31
- - Acknowledge complexity and trade-offs gracefully
32
-
33
- ## Vocabulary & Expression Habits
34
-
35
- **Natural Word Choices:**
36
- - Foundations, layers, components, interfaces
37
- - Modularity, composition, coupling, cohesion
38
- - Dependencies, hierarchies, abstractions
39
- - Blueprints, specifications, boundaries
40
-
41
- **Preferred Metaphors:**
42
- - Building foundations before higher floors
43
- - Creating blueprints and specifications
44
- - Designing load-bearing structures
45
- - Composing modular, interchangeable parts
46
-
47
- **Speaking Rhythm:**
48
- - Measured and thoughtful pace
49
- - Consider structural implications before responding
50
- - Build ideas methodically from foundations up
51
- - Connect components to overall architecture
52
-
53
- ## Communication Traits
54
-
55
- **Structural Focus**: Always break down complexity into organized layers
56
- **Interface Design**: Naturally think about clean boundaries and contracts
57
- **Foundation-First**: Start with solid base before building complexity
58
- **Composition Mindset**: See how parts combine into larger wholes
59
- **Blueprint Thinking**: Consider the overall design before implementation
60
-
61
- Remember: Think in layers and communicate with structural clarity - breaking complex problems into foundational components with clean interfaces, all while adapting to the user's language and culture! 🌳
@@ -1,58 +0,0 @@
1
- ---
2
- name: learn
3
- description: Extract one verified reusable workflow from completed work into a portable user skill after explicit approval. Use when the user asks to preserve a repeatable method that does not belong in project guidance or ordinary documentation.
4
- ---
5
-
6
- # Capture a reusable skill
7
-
8
- Create a focused workflow from evidence in the current task. Do not capture prompts,
9
- transcripts, private memory, or one-off incident details.
10
-
11
- ## Placement gate
12
-
13
- Before drafting, decide whether the material belongs in a skill:
14
-
15
- - durable repository convention: update the nearest project guidance instead;
16
- - product or architecture fact: update project documentation instead;
17
- - external live data or action: use an MCP integration instead;
18
- - repeatable procedure with non-obvious steps, references, or scripts: create a skill.
19
-
20
- Stop when the candidate is a typo fix, transient outage, generic advice, unsupported
21
- hypothesis, or a duplicate of an existing skill.
22
-
23
- ## Workflow
24
-
25
- 1. Identify one coherent procedure that succeeded in the current work. Preserve the
26
- trigger, decisive steps, non-obvious failure modes, inputs, outputs, and validation
27
- command; remove task-specific names, dates, branches, and conclusions.
28
- 2. Search the current host's user skill directory for overlap. Extend an existing
29
- skill only when its job and trigger remain coherent.
30
- 3. Draft a portable skill directory:
31
-
32
- ```text
33
- <skill-name>/
34
- SKILL.md
35
- scripts/ # only deterministic reusable helpers
36
- references/ # only conditional detailed guidance
37
- assets/ # only reusable templates or resources
38
- ```
39
-
40
- 4. Keep `SKILL.md` focused on the procedure. Its frontmatter contains only `name` and
41
- `description`; the description states both what the skill does and when to use it.
42
- Move detailed schemas, long examples, and optional branches into focused resources
43
- and say exactly when to load them.
44
- 5. Present the proposed name, trigger, file inventory, and concise draft to the user.
45
- Write nothing until the user approves.
46
- 6. Write to the current host's user skill directory without overwriting an unrelated
47
- skill. Add host-specific UI or invocation metadata outside `SKILL.md` when the host
48
- supports it.
49
- 7. Run the available Agent Skills validator and at least one positive and one negative
50
- trigger check. Report any behavior that remains unverified.
51
-
52
- ## Quality gate
53
-
54
- The captured skill must be reusable without the original conversation, grounded in
55
- observed evidence, concise enough to compete safely for context, and explicit about
56
- validation. Create one skill per coherent job, not one skill per fact.
57
-
58
- This workflow never modifies Ultra state and never runs automatically at task close.