ultra-builder-pro-cli 0.17.1 → 0.19.1

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 (42) hide show
  1. package/CHANGELOG.md +77 -6
  2. package/README.md +380 -261
  3. package/adapters/_shared/codex-assets.cjs +24 -16
  4. package/adapters/_shared/file-ops.cjs +40 -3
  5. package/adapters/_shared/provenance.cjs +90 -6
  6. package/adapters/_shared/runtime-assets.cjs +0 -11
  7. package/adapters/claude.js +3 -1
  8. package/adapters/kimi.js +4 -30
  9. package/adapters/opencode.js +50 -14
  10. package/docs/AGENT-CONTEXT.md +11 -14
  11. package/docs/ARCHITECTURE.md +23 -15
  12. package/docs/DECISIONS.md +75 -0
  13. package/docs/LEGACY-CLI-CROSSWALK.md +3 -3
  14. package/docs/PLUGIN-ISOLATION-CONTRACT.md +54 -0
  15. package/docs/ROADMAP.md +13 -13
  16. package/docs/RUNTIME-COMPAT-MATRIX.md +24 -21
  17. package/docs/STATE-DB-ACCESS-POLICY.md +2 -2
  18. package/docs/WORKFLOW-LIFECYCLE.md +12 -10
  19. package/hooks/active_task_context.py +1 -1
  20. package/hooks/context_spine.py +1 -1
  21. package/hooks/health_check.py +19 -0
  22. package/hooks/pre_stop_check.py +1 -1
  23. package/hooks/workflow_checkpoint.py +1 -1
  24. package/hooks/workflow_context.py +1 -1
  25. package/hooks/workflow_resume.py +1 -1
  26. package/mcp-server/lib/workflow-state.cjs +67 -54
  27. package/mcp-server/server.cjs +19 -7
  28. package/orchestrator/dispatch-rules.cjs +1 -1
  29. package/package.json +4 -5
  30. package/skills/ultra-change/SKILL.md +4 -3
  31. package/skills/ultra-init/SKILL.md +2 -1
  32. package/skills/ultra-research/SKILL.md +7 -4
  33. package/spec/cli-protocol.md +4 -4
  34. package/spec/mcp-tools.yaml +6 -6
  35. package/spec/schemas/context-file.v4.5.schema.json +1 -1
  36. package/spec/schemas/mcp-tools.schema.json +3 -3
  37. package/spec/schemas/state-db.sql +3 -3
  38. package/spec/schemas/tasks.v4.5.schema.json +1 -1
  39. package/adapters/_shared/handbook.cjs +0 -156
  40. package/bin/handbook.js +0 -54
  41. package/docs/PLAN.zh-CN.md +0 -1696
  42. package/docs/USER-HANDBOOK-CONTRACT.md +0 -81
package/CHANGELOG.md CHANGED
@@ -7,6 +7,71 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.19.1] — 2026-07-26
11
+
12
+ ### Fixed
13
+
14
+ - Made the four-host handbook-isolation release test hermetic so a clean CI
15
+ runner does not require the Codex CLI merely to prove that installation and
16
+ uninstallation preserve user-owned instruction files byte for byte.
17
+
18
+ ## [0.19.0] — 2026-07-26
19
+
20
+ ### Changed
21
+
22
+ - Made every public Ultra workflow explicitly activated. Claude Code and Kimi
23
+ Code disable model invocation, Codex keeps implicit invocation disabled, and
24
+ OpenCode commands load private plugin workflow assets instead of exposing
25
+ public workflows through its model skill catalog.
26
+ - Limited lifecycle context, health, checkpoint, stop, and subagent hooks to
27
+ DB-authoritative active workflows. Initialized idle projects retain only
28
+ generated-projection protection.
29
+ - Changed workflow handoff to return allowed transitions and a host-owned
30
+ recommendation without launching another public workflow.
31
+
32
+ ### Removed
33
+
34
+ - Removed `ubp-handbook`, the shared handbook renderer, Kimi session bootstrap,
35
+ and every package path capable of creating or rewriting user-level
36
+ `CLAUDE.md` or `AGENTS.md` files.
37
+
38
+ ## [0.18.0] — 2026-07-25
39
+
40
+ ### Added
41
+
42
+ - Added explicit `ubp-handbook --full` preview and apply modes that render one
43
+ complete engineering contract with native Claude Code, Codex, OpenCode, and
44
+ Kimi semantics, preserve supported provider-managed marker blocks, require a
45
+ content-bound preview confirmation, and back up every replaced user handbook.
46
+
47
+ ### Changed
48
+
49
+ - Replaced the duplicated legacy root prompts with concise host-native
50
+ repository guides. General engineering doctrine now has one renderer, while
51
+ workflow detail remains in portable Skills and host wiring remains in adapters.
52
+ - Changed research coverage from a catalog-wide checklist to a model-selected
53
+ evidence set. MCP persists only selected or explicitly recorded exclusions
54
+ while retaining synthesis and evidence invariants.
55
+ - Codex hook manifests now call the stable managed plugin adapter, so new tasks
56
+ do not retain an evictable cache-version path.
57
+ - Corrected Claude Code namespaced invocation, OpenCode Skill loading, and
58
+ installation-doctor syntax in every rendered handbook.
59
+ - Full handbook convergence now preserves repeated and nested external provider
60
+ regions, normalizes duplicate Ultra regions, follows dotfile symlinks, and
61
+ retains the target POSIX mode.
62
+ - Extended prompt conformance checks so external Skill declarations cannot enter
63
+ packaged Ultra Skills or worker prompts.
64
+ - Source installations now record dirty state and a deterministic worktree
65
+ digest without inheriting an enclosing consumer repository.
66
+ - The npm package now ships a current decision contract and excludes the
67
+ repository-only historical implementation plan.
68
+
69
+ ### Removed
70
+
71
+ - Removed stale external graph declarations, foreign interaction-tool, old context-budget,
72
+ outdated version, and invalid path instructions from the active repository
73
+ handbooks. External graph and memory capabilities remain separately owned.
74
+
10
75
  ## [0.17.1] — 2026-07-24
11
76
 
12
77
  ### Fixed
@@ -138,7 +203,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
138
203
 
139
204
  ### Added
140
205
 
141
- - Added schema 15 typed semantic records for all seventeen research steps, including
206
+ - Added schema 15 typed semantic records for selected research areas, including
142
207
  step-specific attributes, stable ids, evidence links, source anchors, stored source
143
208
  digests, synthesis trace validation, and current-source health checks.
144
209
  - Added complete Change Contracts with executable acceptance, non-goals, public seams,
@@ -538,7 +603,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
538
603
  parent agent, while persistent memory remains owned by a separately installed
539
604
  host provider.
540
605
  - Added a release regression guard that rejects private memory ownership,
541
- `.ultra/memory`, and retired `/recall` instructions from every bundled agent.
606
+ retired internal memory paths, and obsolete recall instructions from every
607
+ bundled agent.
542
608
 
543
609
  ## [0.5.2] — 2026-07-16
544
610
 
@@ -619,8 +685,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
619
685
  - Removed Ultra's memory MCP tools, store, wrapper, recall skill, memory-capture
620
686
  and summary hooks, and private agent-memory declarations. Persistent memory is
621
687
  now solely the responsibility of a separate cloud-mem/claude-mem plugin.
622
- - Removed bundled copies of `agent-browser`, `find-skills`, `use-railway`, the
623
- three Vercel skill packs, and all Impeccable-derived assets from Ultra output.
688
+ - Removed bundled external browser, discovery, deployment, framework, and
689
+ inherited design-skill assets from Ultra output.
624
690
  - Removed generic dangerous-command and post-edit governance hooks from the
625
691
  Ultra plugin; unrelated user/repository hooks remain outside this package.
626
692
 
@@ -655,7 +721,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
655
721
 
656
722
  - **Phase 8B — executor line** (D48, `8224159`): parallel session orchestrator
657
723
  that consumes `.ultra/execution-plan.json` waves, spawns sessions per
658
- `dispatch-rules.cjs` (declarative priority-sorted rule table, GSD-2 pattern),
724
+ `dispatch-rules.cjs` (declarative priority-sorted rule table),
659
725
  manages N concurrent git worktrees via `worktree-manager.cjs`, and auto-merges
660
726
  session branches back to `main` with conflict detection via `auto-merge.cjs`.
661
727
  Events: `wave_started` / `wave_completed` / `plan_completed` / `merged_back` /
@@ -751,7 +817,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
751
817
  skill manifest, CLI protocol + mapping table; 5 spec validators.
752
818
  - **Phase 0 — skeleton**: multi-runtime installer scaffolding.
753
819
 
754
- [Unreleased]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.16.0...HEAD
820
+ [Unreleased]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.19.1...HEAD
821
+ [0.19.1]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.19.0...v0.19.1
822
+ [0.19.0]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.18.0...v0.19.0
823
+ [0.18.0]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.17.1...v0.18.0
824
+ [0.17.1]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.17.0...v0.17.1
825
+ [0.17.0]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.16.0...v0.17.0
755
826
  [0.16.0]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.15.0...v0.16.0
756
827
  [0.15.0]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.14.0...v0.15.0
757
828
  [0.14.0]: https://github.com/rocky2431/ultra-builder-pro-cli/compare/v0.13.0...v0.14.0