ultra-builder-pro-cli 0.19.1 → 0.21.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.
- package/.ultra-template/docs/research/README.md +26 -5
- package/.ultra-template/specs/discovery.md +1 -1
- package/.ultra-template/tasks/tasks.json +1 -1
- package/CHANGELOG.md +90 -1
- package/README.md +62 -29
- package/adapters/_shared/codex-assets.cjs +69 -11
- package/adapters/_shared/interaction-contract.cjs +60 -5
- package/adapters/_shared/runtime-assets.cjs +41 -1
- package/adapters/claude.js +7 -5
- package/adapters/codex.js +1 -1
- package/adapters/kimi.js +2 -8
- package/adapters/opencode.js +30 -28
- package/bin/orchestrator.js +64 -24
- package/commands/ultra-research.md +1 -1
- package/docs/AGENT-CONTEXT.md +79 -45
- package/docs/ARCHITECTURE.md +75 -38
- package/docs/ARTIFACT-AUTHORITY.md +234 -0
- package/docs/DECISIONS.md +20 -10
- package/docs/LEGACY-CLI-CROSSWALK.md +15 -11
- package/docs/PLUGIN-ISOLATION-CONTRACT.md +4 -3
- package/docs/ROADMAP.md +21 -6
- package/docs/RUNTIME-COMPAT-MATRIX.md +30 -13
- package/docs/STATE-DB-ACCESS-POLICY.md +11 -9
- package/docs/WORKFLOW-LIFECYCLE.md +105 -54
- package/hooks/README.md +6 -5
- package/hooks/active_task_context.py +97 -12
- package/hooks/context_spine.py +16 -4
- package/hooks/health_check.py +5 -4
- package/hooks/pre_stop_check.py +5 -2
- package/hooks/runtime_paths.py +396 -0
- package/hooks/subagent_tracker.py +5 -2
- package/hooks/workflow_checkpoint.py +16 -3
- package/hooks/workflow_context.py +11 -3
- package/hooks/workflow_resume.py +7 -4
- package/mcp-server/breadcrumb.cjs +20 -2
- package/mcp-server/lib/archive-journal.cjs +1026 -111
- package/mcp-server/lib/archive-mutation-worker.py +365 -0
- package/mcp-server/lib/artifact-registry.cjs +1126 -0
- package/mcp-server/lib/baseline-workflow.cjs +9 -4
- package/mcp-server/lib/change-packet.cjs +818 -0
- package/mcp-server/lib/change-workflow.cjs +932 -176
- package/mcp-server/lib/context-paths.cjs +111 -0
- package/mcp-server/lib/context-spine.cjs +511 -45
- package/mcp-server/lib/decision-dialogue.cjs +427 -12
- package/mcp-server/lib/delivery-transaction.cjs +471 -0
- package/mcp-server/lib/doctor-backup-worker.cjs +328 -0
- package/mcp-server/lib/doctor.cjs +375 -12
- package/mcp-server/lib/git-bootstrap.cjs +459 -47
- package/mcp-server/lib/init-project.cjs +190 -95
- package/mcp-server/lib/plan-publication-worker.cjs +830 -0
- package/mcp-server/lib/plan-store.cjs +700 -5
- package/mcp-server/lib/project-breadcrumb.cjs +23 -4
- package/mcp-server/lib/projector.cjs +174 -40
- package/mcp-server/lib/runtime-paths.cjs +1687 -0
- package/mcp-server/lib/safe-project-file.cjs +385 -0
- package/mcp-server/lib/spec-learning.cjs +28 -12
- package/mcp-server/lib/state-db.cjs +397 -13
- package/mcp-server/lib/state-ops.cjs +248 -49
- package/mcp-server/lib/telemetry.cjs +12 -3
- package/mcp-server/lib/workflow-state.cjs +614 -62
- package/mcp-server/server.cjs +282 -33
- package/orchestrator/daemon.cjs +2 -10
- package/orchestrator/parallel-orchestrator.cjs +314 -50
- package/orchestrator/planner/plan-builder.cjs +1 -1
- package/orchestrator/recovery.cjs +125 -7
- package/orchestrator/session-close-journal-worker.cjs +5 -0
- package/orchestrator/session-close-journal.cjs +1014 -0
- package/orchestrator/session-runner.cjs +679 -69
- package/orchestrator/worktree-manager.cjs +186 -35
- package/package.json +2 -3
- package/skills/cc-collab/SKILL.md +4 -1
- package/skills/codex-collab/SKILL.md +5 -2
- package/skills/ultra-change/SKILL.md +38 -13
- package/skills/ultra-deliver/SKILL.md +23 -11
- package/skills/ultra-dev/SKILL.md +33 -6
- package/skills/ultra-doctor/SKILL.md +6 -2
- package/skills/ultra-init/SKILL.md +4 -2
- package/skills/ultra-plan/SKILL.md +68 -18
- package/skills/ultra-research/SKILL.md +45 -32
- package/skills/ultra-review/SKILL.md +9 -5
- package/skills/ultra-status/SKILL.md +9 -4
- package/skills/ultra-test/SKILL.md +15 -7
- package/skills/ultra-think/SKILL.md +6 -0
- package/skills/ultra-think/references/decision-dialogue.md +61 -14
- package/skills/ultra-verify/SKILL.md +4 -1
- package/spec/cli-protocol.md +19 -7
- package/spec/mcp-tools.yaml +531 -46
- package/spec/schemas/change-delta.v1.schema.json +153 -0
- package/spec/schemas/documentation-reconciliation.v1.schema.json +106 -0
- package/spec/schemas/mcp-tools.schema.json +1 -1
- package/spec/schemas/state-db.sql +57 -17
- package/spec/schemas/tasks.v4.5.schema.json +1 -1
- package/ultra-tools/cli.cjs +3 -2
- package/ultra-tools/commands/db.cjs +76 -25
- package/ultra-tools/commands/migrate.cjs +995 -80
- package/ultra-tools/commands/session.cjs +34 -8
- package/ultra-tools/commands/status.cjs +34 -7
- package/ultra-tools/commands/system.cjs +129 -22
- package/commands/learn.md +0 -10
- package/orchestrator/skill-miner.cjs +0 -133
- package/output-styles/coding-vibes.md +0 -67
- package/output-styles/structural-thinking.md +0 -61
- 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! 🌳
|
package/skills/learn/SKILL.md
DELETED
|
@@ -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.
|