substrate-ai 0.20.78 → 0.20.80
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/README.md +7 -0
- package/dist/adapter-registry-BgfwxcSY.js +4 -0
- package/dist/cli/index.js +40 -641
- package/dist/cli/templates/agents-md-substrate-section.md +5 -0
- package/dist/cli/templates/claude-md-substrate-section.md +5 -0
- package/dist/cli/templates/gemini-md-substrate-section.md +5 -0
- package/dist/{health-EyALt_76.js → health-CuKzY0Fn.js} +2 -2
- package/dist/{health-CUPkzJ8b.js → health-D_2Tesme.js} +2 -2
- package/dist/index.d.ts +34 -1
- package/dist/index.js +1 -1
- package/dist/{interactive-prompt-DqvUvzPv.js → interactive-prompt-CsvMelhG.js} +2 -2
- package/dist/{manifest-read-DP4lBymM.js → manifest-read-Boipz5aP.js} +7 -3
- package/dist/modules/interactive-prompt/index.js +2 -2
- package/dist/{run-5R5ZPgSw.js → run-Bhe2gX2V.js} +1413 -435
- package/dist/{run-E6tr8jf3.js → run-L26TdXRR.js} +4 -4
- package/dist/src/modules/recovery-engine/index.d.ts +12 -1
- package/package.json +1 -1
- package/dist/adapter-registry-B42bBpfj.js +0 -4
- /package/dist/{adapter-registry-DXLMTmfD.js → adapter-registry-DIcrxjH8.js} +0 -0
package/README.md
CHANGED
|
@@ -155,6 +155,10 @@ create-story → test-plan → dev-story → build-fix → code-review
|
|
|
155
155
|
|
|
156
156
|
Stories run in parallel across your available agents, each in its own git worktree. After dev-story completes, an optional `probe-author` phase dispatches for event-driven and state-integrating ACs (see [Verification Pipeline](#verification-pipeline)) to derive runtime probes from AC text. Build-fix runs the project's build to catch compilation errors before code review.
|
|
157
157
|
|
|
158
|
+
#### Per-Story Worktree Lifecycle
|
|
159
|
+
|
|
160
|
+
Each dispatched story runs in a dedicated git worktree at `.substrate-worktrees/story-<key>` on branch `substrate/story-<key>`. The dev agent's auto-commit (e.g., `feat(story-N-M): ...`) lands on the branch, not main. After verification produces a SHIP_IT verdict, the branch is merged back to the base branch (typically main) and the worktree is removed automatically. After a verification failure, the worktree and branch are preserved so you can inspect the partial implementation via `substrate reconcile-from-disk`. Use `--no-worktree` if your project does not support worktrees (e.g., submodules, bare repos).
|
|
161
|
+
|
|
158
162
|
### Verification Pipeline
|
|
159
163
|
|
|
160
164
|
Six gates run after code review. Each can pass, warn, or fail; failures block SHIP_IT.
|
|
@@ -523,6 +527,8 @@ substrate init
|
|
|
523
527
|
|
|
524
528
|
Without Dolt, all functionality works except for: `substrate diff`, `substrate history`, persistent OTEL observability tables, and context engineering repo-map storage.
|
|
525
529
|
|
|
530
|
+
**On-disk operator surface:** Each pipeline run creates per-story worktrees under `.substrate-worktrees/story-<key>/`. Successful stories are merged to main and their worktrees removed. Failed or escalated stories preserve their worktrees for operator inspection via `substrate reconcile-from-disk`.
|
|
531
|
+
|
|
526
532
|
## CLI Command Reference
|
|
527
533
|
|
|
528
534
|
These commands are typically invoked by your AI assistant during pipeline operation. You usually don't run them directly.
|
|
@@ -544,6 +550,7 @@ These commands are typically invoked by your AI assistant during pipeline operat
|
|
|
544
550
|
| `substrate run --cost-ceiling <usd>` | Halt run when cumulative cost crosses this threshold |
|
|
545
551
|
| `substrate run --max-review-cycles <n>` | Cycles per story (default 2; use 3 for migrations / interface extraction) |
|
|
546
552
|
| `substrate run --skip-verification` | Skip post-dispatch verification (use sparingly) |
|
|
553
|
+
| `substrate run --no-worktree` | Disable per-story git worktrees (use for submodule repos or bare repos that don't support worktrees) |
|
|
547
554
|
| `substrate run --help-agent` | Print agent instruction prompt fragment |
|
|
548
555
|
| `substrate resume` | Resume an interrupted run |
|
|
549
556
|
| `substrate cancel` | Cancel a running pipeline |
|