feat(voyage)!: bulk content rewrite ultra -> voyage/trek prose [skip-docs]
Sed-pipeline (16 patterns, longest-match-first) sweeper residuelle ultra*-treff i prose, command-narrativ, agent-prompts, hook-kommentarer, doc-prosa. Pipeline-utvidelser fra V4-prompten: - BSD-syntax [[:<:]]ultra[[:>:]] istedenfor \bultra\b (BSD sed mangler \b) - 6 compound-patterns for ultraplan/ultraexecute/ultraresearch/ultrabrief/ ultrareview/ultracontinue uten -local-suffiks - ultra*-stats glob -> trek*-stats glob - Linje-eksklusjon redusert til ultra-cc-architect (Q8); session-state- eksklusjonen var over-protektiv - File-eksklusjon utvidet til settings.json, package.json, plugin.json, hele .claude/-treet (gitignored + V5-territorium) Q8-undantak holdt: architecture-discovery.mjs + project-discovery.mjs urort. Filnavn-konvensjon holdt: .session-state.local.json + *.local.* preservert. Manuell narrative-fix: tests/lib/agent-frontmatter.test.mjs linje 10 mangled "/ultra*-local" til "/voyage*-local" (ingen slik kommando finnes); korrigert til "/trek*". Residualer utenfor scope (V5 handterer): package.json + .claude-plugin/ plugin.json (Step 12-14 versjons-bump). .claude/* er gitignored spec-historikk med tilsiktet BEFORE/AFTER-narrativ. Part of voyage-rebrand session 3 (Wave 4 / Step 10). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
parent
ca5a8cec67
commit
14ecda886c
81 changed files with 672 additions and 672 deletions
|
|
@ -8,7 +8,7 @@ allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
|
|||
|
||||
# Ultraexecute Local
|
||||
|
||||
Disciplined executor for ultraplan plans. Reads a plan file, detects if it has
|
||||
Disciplined executor for trekplan plans. Reads a plan file, detects if it has
|
||||
an Execution Strategy (multi-session), and either executes directly or
|
||||
orchestrates parallel headless sessions — all to realize one plan.
|
||||
|
||||
|
|
@ -25,7 +25,7 @@ Parse `$ARGUMENTS` for mode flags:
|
|||
- If `{dir}` does not exist or `{dir}/plan.md` is missing:
|
||||
```
|
||||
Error: project directory missing plan.md: {dir}
|
||||
Run /ultraplan-local --project {dir} to produce it.
|
||||
Run /trekplan --project {dir} to produce it.
|
||||
```
|
||||
- If no explicit `<plan.md>` argument is provided after flag parsing,
|
||||
use the derived `{dir}/plan.md`. If a `<plan.md>` argument IS provided,
|
||||
|
|
@ -54,20 +54,20 @@ If no path is provided (and `--project` was not used to derive one), output
|
|||
usage and stop:
|
||||
|
||||
```
|
||||
Usage: /ultraexecute-local <plan.md>
|
||||
/ultraexecute-local --project <dir>
|
||||
/ultraexecute-local --fg <plan.md>
|
||||
/ultraexecute-local --resume <plan.md>
|
||||
/ultraexecute-local --dry-run <plan.md>
|
||||
/ultraexecute-local --validate <plan.md>
|
||||
/ultraexecute-local --step N <plan.md>
|
||||
/ultraexecute-local --session N <plan.md>
|
||||
/ultraexecute-local --project <dir> --resume
|
||||
/ultraexecute-local --project <dir> --session N
|
||||
Usage: /trekexecute <plan.md>
|
||||
/trekexecute --project <dir>
|
||||
/trekexecute --fg <plan.md>
|
||||
/trekexecute --resume <plan.md>
|
||||
/trekexecute --dry-run <plan.md>
|
||||
/trekexecute --validate <plan.md>
|
||||
/trekexecute --step N <plan.md>
|
||||
/trekexecute --session N <plan.md>
|
||||
/trekexecute --project <dir> --resume
|
||||
/trekexecute --project <dir> --session N
|
||||
|
||||
Modes:
|
||||
(default) Auto — multi-session if plan has Execution Strategy, else foreground
|
||||
--project Resolve plan.md inside an ultrabrief project folder; progress.json
|
||||
--project Resolve plan.md inside an trekbrief project folder; progress.json
|
||||
is written there too
|
||||
--fg Force foreground — all steps sequentially, ignore Execution Strategy
|
||||
--resume Resume from last progress checkpoint
|
||||
|
|
@ -77,13 +77,13 @@ Modes:
|
|||
--session N Execute only session N from the plan's Execution Strategy
|
||||
|
||||
Examples:
|
||||
/ultraexecute-local .claude/plans/ultraplan-2026-04-06-auth-refactor.md
|
||||
/ultraexecute-local --project .claude/projects/2026-04-18-jwt-auth
|
||||
/ultraexecute-local --project .claude/projects/2026-04-18-jwt-auth --resume
|
||||
/ultraexecute-local --fg .claude/plans/ultraplan-2026-04-06-auth-refactor.md
|
||||
/ultraexecute-local --session 2 .claude/plans/ultraplan-2026-04-06-auth-refactor.md
|
||||
/ultraexecute-local --dry-run .claude/plans/ultraplan-2026-04-06-auth-refactor.md
|
||||
/ultraexecute-local --validate .claude/plans/ultraplan-2026-04-06-auth-refactor.md
|
||||
/trekexecute .claude/plans/trekplan-2026-04-06-auth-refactor.md
|
||||
/trekexecute --project .claude/projects/2026-04-18-jwt-auth
|
||||
/trekexecute --project .claude/projects/2026-04-18-jwt-auth --resume
|
||||
/trekexecute --fg .claude/plans/trekplan-2026-04-06-auth-refactor.md
|
||||
/trekexecute --session 2 .claude/plans/trekplan-2026-04-06-auth-refactor.md
|
||||
/trekexecute --dry-run .claude/plans/trekplan-2026-04-06-auth-refactor.md
|
||||
/trekexecute --validate .claude/plans/trekplan-2026-04-06-auth-refactor.md
|
||||
```
|
||||
|
||||
If the file does not exist, report and stop:
|
||||
|
|
@ -100,16 +100,16 @@ File: {path}
|
|||
|
||||
## Phase 2 — Detect file type and parse structure
|
||||
|
||||
Read the file. Determine whether it is an **ultraplan** or a **session spec**:
|
||||
Read the file. Determine whether it is an **trekplan** or a **session spec**:
|
||||
|
||||
- **Session spec**: contains `## Dependencies` with `Entry condition:` AND `## Scope Fence`
|
||||
AND `## Exit Condition` sections.
|
||||
- **Ultraplan**: contains `## Implementation Plan` with numbered `### Step N:` headings
|
||||
- **Voyage**: contains `## Implementation Plan` with numbered `### Step N:` headings
|
||||
but no `## Scope Fence`.
|
||||
|
||||
If neither structure is detected, report and stop:
|
||||
```
|
||||
Error: unrecognized file format. Expected an ultraplan or session spec.
|
||||
Error: unrecognized file format. Expected an trekplan or session spec.
|
||||
```
|
||||
|
||||
### Parse steps
|
||||
|
|
@ -226,7 +226,7 @@ Warnings: {count}
|
|||
{if warnings}: - {each warning on own line}
|
||||
|
||||
Plan is schema-compliant. Safe to run:
|
||||
/ultraexecute-local {path}
|
||||
/trekexecute {path}
|
||||
```
|
||||
|
||||
If Phase 2 parsing failed (unrecognized format, missing Manifest in strict
|
||||
|
|
@ -240,15 +240,15 @@ Reason: {specific error from Phase 2}
|
|||
{if format not recognized}:
|
||||
Detected heading format: {e.g. "### Fase 1:", "## Phase 1"}
|
||||
Expected: "### Step N: <description>"
|
||||
Fix: re-run /ultraplan-local — planning-orchestrator must emit v1.7 format
|
||||
Fix: re-run /trekplan — planning-orchestrator must emit v1.7 format
|
||||
|
||||
{if missing manifest}:
|
||||
Step {N} has no Manifest block (plan_version=1.7 requires one per step)
|
||||
Fix: re-run /ultraplan-local — planning-orchestrator must include manifest YAML
|
||||
Fix: re-run /trekplan — planning-orchestrator must include manifest YAML
|
||||
|
||||
{if malformed YAML or invalid regex}:
|
||||
Step {N}: {specific YAML/regex error}
|
||||
Fix: edit the plan manually or re-run /ultraplan-local
|
||||
Fix: edit the plan manually or re-run /trekplan
|
||||
```
|
||||
|
||||
Exit after emitting the report. Do not continue to Phase 2.4 or later.
|
||||
|
|
@ -390,13 +390,13 @@ Untracked/modified files:
|
|||
{output of git status --porcelain}
|
||||
|
||||
Commit or stash your changes, then re-run.
|
||||
To run sequentially instead: /ultraexecute-local --fg {plan-path}
|
||||
To run sequentially instead: /trekexecute --fg {plan-path}
|
||||
```
|
||||
|
||||
Stop execution. Update progress with `status: "stopped"`.
|
||||
|
||||
**Also write `.session-state.local.json`** (Handover 7) — this surfaces the
|
||||
stopped state to `/ultracontinue` so the next session can prompt the user to
|
||||
stopped state to `/trekcontinue` so the next session can prompt the user to
|
||||
clean the working tree before resuming. Write atomically alongside `progress.json`:
|
||||
|
||||
```json
|
||||
|
|
@ -458,7 +458,7 @@ that were manually edited or have bugs.
|
|||
### Check 4 — Stale worktree cleanup
|
||||
|
||||
Run `git worktree list`. If any worktrees with paths containing
|
||||
`ultraplan-sessions/{slug}/worktrees/` exist from a previous failed run:
|
||||
`trekplan-sessions/{slug}/worktrees/` exist from a previous failed run:
|
||||
|
||||
```bash
|
||||
git worktree remove --force {stale-path} 2>/dev/null
|
||||
|
|
@ -532,7 +532,7 @@ If `ANTHROPIC_API_KEY` is NOT set: proceed silently to Step 1.
|
|||
|
||||
```bash
|
||||
REPO_ROOT="$(git rev-parse --show-toplevel)"
|
||||
SESSION_DIR="$REPO_ROOT/.claude/ultraplan-sessions/{slug}"
|
||||
SESSION_DIR="$REPO_ROOT/.claude/trekplan-sessions/{slug}"
|
||||
WORKTREE_DIR="$SESSION_DIR/worktrees"
|
||||
LOG_DIR="$SESSION_DIR/logs"
|
||||
mkdir -p "$WORKTREE_DIR" "$LOG_DIR"
|
||||
|
|
@ -564,7 +564,7 @@ MAX_BUDGET_USD="${TREKEXECUTE_MAX_BUDGET_USD:-5}"
|
|||
|
||||
The budget caps default to safe values for normal-length steps. Operators may
|
||||
override for long runs:
|
||||
`TREKEXECUTE_MAX_TURNS=120 TREKEXECUTE_MAX_BUDGET_USD=20 /ultraexecute-local --project ...`
|
||||
`TREKEXECUTE_MAX_TURNS=120 TREKEXECUTE_MAX_BUDGET_USD=20 /trekexecute --project ...`
|
||||
|
||||
**2a. Create worktrees for this wave's sessions:**
|
||||
|
||||
|
|
@ -651,7 +651,7 @@ For each session N in the wave:
|
|||
```bash
|
||||
SESSION_CWD="${session_cwd:-.}" # default: worktree root; overridable per-session via Execution Strategy `cwd:` field
|
||||
cd "$WORKTREE_PATH/$SESSION_CWD" && \
|
||||
GIT_OPTIONAL_LOCKS=0 claude -p "${SAFETY_PREAMBLE}\n\n/ultraexecute-local --session {N} {plan-path}" \
|
||||
GIT_OPTIONAL_LOCKS=0 claude -p "${SAFETY_PREAMBLE}\n\n/trekexecute --session {N} {plan-path}" \
|
||||
--allowedTools "Read,Write,Edit,Bash,Glob,Grep" \
|
||||
--permission-mode bypassPermissions \
|
||||
--max-turns "$MAX_TURNS" \
|
||||
|
|
@ -690,7 +690,7 @@ wait {PID1} {PID2} ...
|
|||
**2d. Check results after each wave:**
|
||||
|
||||
For each session in the wave, read its log file (in `$LOG_DIR`, always accessible
|
||||
from the main worktree) and grep for `"ultraexecute_summary"`. Parse the JSON to
|
||||
from the main worktree) and grep for `"trekexecute_summary"`. Parse the JSON to
|
||||
determine:
|
||||
- Did the session complete? (`result: "completed"`)
|
||||
- Did it fail? (`result: "failed"` or `"stopped"`)
|
||||
|
|
@ -719,7 +719,7 @@ unrecoverable failure to a recoverable one). Push failure is non-fatal
|
|||
```bash
|
||||
GIT_OPTIONAL_LOCKS=0 git push origin "trek/{slug}/session-{N}" 2>/dev/null || true
|
||||
GIT_OPTIONAL_LOCKS=0 git merge --no-ff "trek/{slug}/session-{N}" \
|
||||
-m "merge: ultraplan session {N} — {session-title}"
|
||||
-m "merge: trekplan session {N} — {session-title}"
|
||||
```
|
||||
|
||||
If the merge succeeds (exit code 0): continue to next session.
|
||||
|
|
@ -823,12 +823,12 @@ The progress file location depends on whether `--project` is in use:
|
|||
|
||||
- **With `--project <dir>`:** progress lives at `{project_dir}/progress.json`.
|
||||
- **Without `--project`:** progress lives at
|
||||
`{plan-dir}/.ultraexecute-progress-{slug}.json`, where `{slug}` is the plan
|
||||
`{plan-dir}/.trekexecute-progress-{slug}.json`, where `{slug}` is the plan
|
||||
filename without extension.
|
||||
|
||||
**Session-scoped naming:** When `mode = session N`:
|
||||
- With `--project`: `{project_dir}/progress-session-{N}.json`.
|
||||
- Without `--project`: `{plan-dir}/.ultraexecute-progress-{slug}-session-{N}.json`.
|
||||
- Without `--project`: `{plan-dir}/.trekexecute-progress-{slug}-session-{N}.json`.
|
||||
|
||||
This prevents merge conflicts when parallel sessions each write their own
|
||||
progress file.
|
||||
|
|
@ -879,7 +879,7 @@ progress file.
|
|||
|
||||
## Phase 4 — Entry condition check (session specs only)
|
||||
|
||||
**Skip for ultraplans.** Skip in dry-run mode (report what would be checked instead).
|
||||
**Skip for trekplans.** Skip in dry-run mode (report what would be checked instead).
|
||||
|
||||
Read the entry condition. Evaluate it:
|
||||
|
||||
|
|
@ -899,14 +899,14 @@ Update progress file with `status: "stopped"`. Stop execution.
|
|||
**Also write `.session-state.local.json`** (Handover 7) with the same
|
||||
`status: "stopped"` and `next_session_brief_path` pointing at the brief that
|
||||
the failed entry-condition session was supposed to consume. This lets
|
||||
`/ultracontinue` surface the stop in the next session. Use the same atomic
|
||||
`/trekcontinue` surface the stop in the next session. Use the same atomic
|
||||
write pattern + validator check as Phase 2.55. On validator failure, warn
|
||||
but do not block.
|
||||
|
||||
**Also write sibling `NEXT-SESSION-PROMPT.local.md`** with frontmatter
|
||||
(`produced_by: trekexecute`, `produced_at: <ISO-8601>`,
|
||||
`status: stopped`) — same combined ESM pattern as Phase 8 — so Phase 1.5
|
||||
of `/ultracontinue` can compare project-dir and plugin-root candidates.
|
||||
of `/trekcontinue` can compare project-dir and plugin-root candidates.
|
||||
|
||||
If the entry condition **passes**:
|
||||
```
|
||||
|
|
@ -948,9 +948,9 @@ If `has_execution_strategy = true`, show a preview of multi-session orchestratio
|
|||
|
||||
| Wave | Session | Steps | Depends on | Command |
|
||||
|------|---------|-------|------------|---------|
|
||||
| 1 | Session 1: {title} | {nums} | none | `claude -p "/ultraexecute-local --session 1 {path}"` |
|
||||
| 1 | Session 2: {title} | {nums} | none | `claude -p "/ultraexecute-local --session 2 {path}"` |
|
||||
| 2 | Session 3: {title} | {nums} | S1, S2 | `claude -p "/ultraexecute-local --session 3 {path}"` |
|
||||
| 1 | Session 1: {title} | {nums} | none | `claude -p "/trekexecute --session 1 {path}"` |
|
||||
| 1 | Session 2: {title} | {nums} | none | `claude -p "/trekexecute --session 2 {path}"` |
|
||||
| 2 | Session 3: {title} | {nums} | S1, S2 | `claude -p "/trekexecute --session 3 {path}"` |
|
||||
```
|
||||
|
||||
Check billing status via `echo "${ANTHROPIC_API_KEY:+SET}"` and report:
|
||||
|
|
@ -1138,7 +1138,7 @@ If **FAIL**, read the `On failure:` clause. Apply the retry cap: **maximum 2 ret
|
|||
`status: "passed"` in the progress file — collect their `Files:` fields. Never
|
||||
use `git add -A` (risks staging secrets, binaries, or unrelated work).
|
||||
```bash
|
||||
git add {files from passed steps' Files: fields} && git commit -m "wip: ultraexecute-local stopped at step {N} — escalation needed"
|
||||
git add {files from passed steps' Files: fields} && git commit -m "wip: trekexecute stopped at step {N} — escalation needed"
|
||||
```
|
||||
Jump to Phase 7.
|
||||
|
||||
|
|
@ -1170,7 +1170,7 @@ and jump to Phase 8 (final report).
|
|||
|
||||
## Phase 7 — Exit condition check (session specs only)
|
||||
|
||||
**Skip for ultraplans.** Run only when all steps passed (not on early stop).
|
||||
**Skip for trekplans.** Run only when all steps passed (not on early stop).
|
||||
|
||||
Run each exit condition command from the `## Exit Condition` checklist:
|
||||
|
||||
|
|
@ -1230,7 +1230,7 @@ Record in progress file:
|
|||
## Phase 7.6 — Recovery dispatch (multi-session parent context only)
|
||||
|
||||
**Preconditions:**
|
||||
- This is the parent ultraexecute invocation (not a child `--session N`)
|
||||
- This is the parent trekexecute invocation (not a child `--session N`)
|
||||
- Phase 7.5 reported `drift`
|
||||
- `recovery_depth < 2` (hard cap to prevent infinite loops)
|
||||
|
||||
|
|
@ -1256,7 +1256,7 @@ the user for manual resolution.
|
|||
**Invoke the recovery session:**
|
||||
|
||||
```bash
|
||||
cd "$WORKTREE_PATH" && claude -p "/ultraexecute-local --session {N} {recovery spec path}" \
|
||||
cd "$WORKTREE_PATH" && claude -p "/trekexecute --session {N} {recovery spec path}" \
|
||||
--allowedTools "Read,Write,Edit,Bash,Glob,Grep" \
|
||||
--permission-mode bypassPermissions \
|
||||
> "$LOG_DIR/session-{N}-recovery-{depth}.log" 2>&1
|
||||
|
|
@ -1320,11 +1320,11 @@ node ${CLAUDE_PLUGIN_ROOT}/lib/stats/event-emit.mjs \
|
|||
```
|
||||
|
||||
**Recovery surface:** if declined, `--resume re-enters at the gate` —
|
||||
re-running `/ultraexecute-local --resume --project <dir>` jumps directly
|
||||
re-running `/trekexecute --resume --project <dir>` jumps directly
|
||||
back to the main-merge gate AskUserQuestion (skipping completed waves).
|
||||
The wave session branches are preserved for inspection (Hard Rule 19's
|
||||
push-before-cleanup ensures they survive on the remote even if local
|
||||
cleanup ran). To inspect: `git log ultraplan/<slug>/session-N` per wave.
|
||||
cleanup ran). To inspect: `git log trekplan/<slug>/session-N` per wave.
|
||||
|
||||
### Progress + state-file writes
|
||||
|
||||
|
|
@ -1353,7 +1353,7 @@ to stderr but do NOT block — Phase 8 must always reach the final report.
|
|||
**Also write sibling `NEXT-SESSION-PROMPT.local.md`** (Bug 3 frontmatter
|
||||
contract — see `docs/HANDOVER-CONTRACTS.md` § Handover 7 Lifecycle) in the
|
||||
project directory. The frontmatter MUST contain `produced_by: trekexecute`
|
||||
and `produced_at: <ISO-8601>` so `/ultracontinue` Phase 1.5 can detect
|
||||
and `produced_at: <ISO-8601>` so `/trekcontinue` Phase 1.5 can detect
|
||||
producer drift between project-dir and plugin-root candidates. Use a single
|
||||
ESM inline block so state-file + prompt-file writes succeed or fail together:
|
||||
|
||||
|
|
@ -1366,7 +1366,7 @@ const [, dir, briefPath, label, status] = process.argv;
|
|||
const now = new Date().toISOString();
|
||||
const stateObj = { schema_version: 1, project: dir, next_session_brief_path: briefPath, next_session_label: label, status, updated_at: now };
|
||||
atomicWriteJson(path.join(dir, '.session-state.local.json'), stateObj);
|
||||
const promptBody = '---\\nproduced_by: trekexecute\\nproduced_at: ' + now + '\\nproject: ' + dir + '\\nstatus: ' + status + '\\n---\\n\\n# ' + label + '\\n\\nResume via /ultracontinue.\\n';
|
||||
const promptBody = '---\\nproduced_by: trekexecute\\nproduced_at: ' + now + '\\nproject: ' + dir + '\\nstatus: ' + status + '\\n---\\n\\n# ' + label + '\\n\\nResume via /trekcontinue.\\n';
|
||||
writeFileSync(path.join(dir, 'NEXT-SESSION-PROMPT.local.md'), promptBody);
|
||||
" '{project_dir}' '{next_session_brief_path}' '{next_session_label}' '{status}'`
|
||||
```
|
||||
|
|
@ -1426,7 +1426,7 @@ Attempts: {N}
|
|||
|
||||
{Numbered list of unexecuted steps}
|
||||
|
||||
To resume: /ultraexecute-local --resume {path}
|
||||
To resume: /trekexecute --resume {path}
|
||||
```
|
||||
|
||||
**Result vocabulary (v1.7, strict):**
|
||||
|
|
@ -1441,7 +1441,7 @@ To resume: /ultraexecute-local --resume {path}
|
|||
|
||||
```json
|
||||
{
|
||||
"ultraexecute_summary": {
|
||||
"trekexecute_summary": {
|
||||
"plan": "{path}",
|
||||
"plan_type": "{plan | session-spec}",
|
||||
"plan_version": "{1.7 | 1.6 | legacy}",
|
||||
|
|
@ -1464,7 +1464,7 @@ To resume: /ultraexecute-local --resume {path}
|
|||
}
|
||||
```
|
||||
|
||||
The `ultraexecute_summary` key makes it grep-able in log files from headless runs.
|
||||
The `trekexecute_summary` key makes it grep-able in log files from headless runs.
|
||||
|
||||
## Phase 9 — Stats tracking
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue