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
|
|
@ -7,7 +7,7 @@ for headless execution of decomposed sessions.
|
|||
|
||||
```bash
|
||||
#!/usr/bin/env bash
|
||||
# Headless launch script — generated by ultraplan-local
|
||||
# Headless launch script — generated by trekplan
|
||||
# Master plan: {plan_path}
|
||||
# Generated: {date}
|
||||
# Sessions: {total_sessions} ({parallel_count} parallel, {sequential_count} sequential)
|
||||
|
|
@ -24,7 +24,7 @@ WORKTREE_BASE="{session_dir}/worktrees"
|
|||
mkdir -p "$LOG_DIR" "$WORKTREE_BASE"
|
||||
|
||||
# Disable git's optional locks during parallel worktree ops (research/02 R2;
|
||||
# GH #47721). Mirror Phase 2.6 hardenings (commands/ultraexecute-local.md).
|
||||
# GH #47721). Mirror Phase 2.6 hardenings (commands/trekexecute.md).
|
||||
export GIT_OPTIONAL_LOCKS=0
|
||||
|
||||
# Per-child guardrails (operator may override via env). Match Phase 2.6
|
||||
|
|
@ -99,7 +99,7 @@ if [ "${TREKEXECUTE_SKIP_PREFLIGHT:-0}" != "1" ]; then
|
|||
fi
|
||||
fi
|
||||
|
||||
echo "=== Ultraplan Headless Execution (Worktree-Isolated) ==="
|
||||
echo "=== Voyage Headless Execution (Worktree-Isolated) ==="
|
||||
echo "Plan: {plan_path}"
|
||||
echo "Sessions: {total_sessions}"
|
||||
echo "Repo root: $REPO_ROOT"
|
||||
|
|
@ -138,7 +138,7 @@ cd "$REPO_ROOT"
|
|||
{# For each session in the wave: push BEFORE merge (Hard Rule 19 — push-before-cleanup). }
|
||||
git push origin "trek/{slug}/session-{n}" 2>/dev/null || true
|
||||
git merge --no-ff "trek/{slug}/session-{n}" \
|
||||
-m "merge: ultraplan session {n} — {title}"
|
||||
-m "merge: trekplan session {n} — {title}"
|
||||
if [ $? -ne 0 ]; then
|
||||
echo "MERGE CONFLICT: session {n}. Conflicting files:"
|
||||
git diff --name-only --diff-filter=U
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
<!--
|
||||
Optional YAML frontmatter — include ONLY when the plan was generated from a
|
||||
`type: ultrareview` input (Handover 6). Lists the 40-char hex IDs of the
|
||||
`type: trekreview` input (Handover 6). Lists the 40-char hex IDs of the
|
||||
BLOCKER + MAJOR findings consumed from `review.md`. Use block-style YAML;
|
||||
the frontmatter parser does not support flow-style arrays.
|
||||
|
||||
|
|
@ -18,7 +18,7 @@ source_findings:
|
|||
|
||||
> **Plan quality: {grade}** ({score}/100) — {APPROVE | APPROVE_WITH_NOTES | REVISE | REPLAN}
|
||||
>
|
||||
> Generated by ultraplan-local v{version} on {YYYY-MM-DD} — `plan_version: 1.7`
|
||||
> Generated by trekplan v{version} on {YYYY-MM-DD} — `plan_version: 1.7`
|
||||
|
||||
## Context
|
||||
|
||||
|
|
@ -116,7 +116,7 @@ concrete command (e.g., run the app, check output, curl an endpoint).*
|
|||
### Manifest — objective completion predicate
|
||||
|
||||
Every step MUST have a Manifest block. This is the machine-checkable contract
|
||||
that ultraexecute-local verifies after the Verify command passes. A step is
|
||||
that trekexecute verifies after the Verify command passes. A step is
|
||||
not considered complete until its manifest verifies — regardless of Verify
|
||||
command exit code.
|
||||
|
||||
|
|
@ -182,7 +182,7 @@ before execution.*
|
|||
## Verification
|
||||
|
||||
*Per-step manifest verification runs automatically during execution (every
|
||||
step's Manifest block is objectively checked by ultraexecute-local before the
|
||||
step's Manifest block is objectively checked by trekexecute before the
|
||||
step is marked passed). This section is for end-to-end integration checks
|
||||
that cross step boundaries — complete workflows, system-level behavior.*
|
||||
|
||||
|
|
@ -198,7 +198,7 @@ that cross step boundaries — complete workflows, system-level behavior.*
|
|||
## Execution Strategy
|
||||
|
||||
*Include this section when the plan has more than 5 implementation steps.
|
||||
Omit for small plans (≤ 5 steps) — ultraexecute will run them sequentially
|
||||
Omit for small plans (≤ 5 steps) — trekexecute will run them sequentially
|
||||
in a single session.*
|
||||
|
||||
*The execution strategy groups steps into sessions and organizes sessions
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ external_agents_used: [{list}]
|
|||
|
||||
# {Research Question Title}
|
||||
|
||||
> Generated by ultraresearch-local v{version} on {YYYY-MM-DD}
|
||||
> Generated by trekresearch v{version} on {YYYY-MM-DD}
|
||||
|
||||
## Research Question
|
||||
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@ the purpose and make judgment calls.}
|
|||
## Session Manifest
|
||||
|
||||
Machine-readable aggregate of all step manifests in this session. Used by
|
||||
ultraexecute-local for independent Phase 7.5 audit.
|
||||
trekexecute for independent Phase 7.5 audit.
|
||||
|
||||
```yaml
|
||||
session_manifest:
|
||||
|
|
@ -69,7 +69,7 @@ session_manifest:
|
|||
```
|
||||
|
||||
*Step 0 runs in the same sandbox as all real work. If it exits 77,
|
||||
ultraexecute-local marks the session `blocked` and does NOT proceed. This
|
||||
trekexecute marks the session `blocked` and does NOT proceed. This
|
||||
catches the fail-late push-denial mode observed in Wave 1.*
|
||||
|
||||
*Escape hatch:* set `TREKEXECUTE_SKIP_PREFLIGHT=1` in the environment to
|
||||
|
|
@ -146,10 +146,10 @@ introduced. This section bridges sessions — it's the "baton" in a relay race.}
|
|||
## Recovery Metadata
|
||||
|
||||
*This section is populated only when this session spec was generated by the
|
||||
ultraexecute-local Phase 7.6 recovery dispatcher. Omit for normal sessions.*
|
||||
trekexecute Phase 7.6 recovery dispatcher. Omit for normal sessions.*
|
||||
|
||||
- **Recovery of:** `{original session spec path}`
|
||||
- **Recovery depth:** {1 | 2}
|
||||
- **Missing steps (reason for recovery):** {step numbers + drift summary}
|
||||
- **Entry condition override:** {e.g., "previous partial session committed at {sha}"}
|
||||
- **Parent progress file:** `{path to .ultraexecute-progress-*.json}`
|
||||
- **Parent progress file:** `{path to .trekexecute-progress-*.json}`
|
||||
|
|
|
|||
|
|
@ -61,4 +61,4 @@ without answers.
|
|||
|
||||
- **Created:** {YYYY-MM-DD}
|
||||
- **Mode:** {interview | manual}
|
||||
- **Source:** {ultraplan interview | user-provided}
|
||||
- **Source:** {trekplan interview | user-provided}
|
||||
|
|
|
|||
|
|
@ -14,8 +14,8 @@ source: {interview | manual}
|
|||
|
||||
# Task: {title}
|
||||
|
||||
> Generated by `/ultrabrief-local` on {YYYY-MM-DD}.
|
||||
> This brief is the contract between requirements and planning. `/ultraplan-local`
|
||||
> Generated by `/trekbrief` on {YYYY-MM-DD}.
|
||||
> This brief is the contract between requirements and planning. `/trekplan`
|
||||
> reads it to produce the implementation plan. Every decision in the plan must
|
||||
> trace back to content in this brief.
|
||||
|
||||
|
|
@ -81,9 +81,9 @@ Do NOT write vague criteria:
|
|||
|
||||
## Research Plan
|
||||
|
||||
*Explicit research topics that must be answered before `/ultraplan-local` can
|
||||
*Explicit research topics that must be answered before `/trekplan` can
|
||||
produce a high-confidence plan. Each topic is phrased as a research question ready
|
||||
to feed into `/ultraresearch-local`. Topics may be empty (N=0) for trivial tasks
|
||||
to feed into `/trekresearch`. Topics may be empty (N=0) for trivial tasks
|
||||
where the codebase alone is sufficient context.*
|
||||
|
||||
{If research_topics = 0, write a single line: "No external research needed —
|
||||
|
|
@ -93,9 +93,9 @@ the codebase and this brief contain sufficient context for planning."}
|
|||
|
||||
- **Why this matters:** {How the plan depends on this answer. Which steps or
|
||||
decisions cannot be made confidently without it.}
|
||||
- **Research question:** "{Exact question to feed to /ultraresearch-local.
|
||||
- **Research question:** "{Exact question to feed to /trekresearch.
|
||||
One sentence, ends in `?`.}"
|
||||
- **Suggested invocation:** `/ultraresearch-local --project {project_dir} --external "{question}"`
|
||||
- **Suggested invocation:** `/trekresearch --project {project_dir} --external "{question}"`
|
||||
- **Required for plan steps:** {which kinds of steps will consume this — e.g.,
|
||||
"migration strategy", "library selection", "threat model"}
|
||||
- **Confidence needed:** {high | medium | low}
|
||||
|
|
@ -106,7 +106,7 @@ the codebase and this brief contain sufficient context for planning."}
|
|||
|
||||
- **Why this matters:** ...
|
||||
- **Research question:** "..."
|
||||
- **Suggested invocation:** `/ultraresearch-local --project {project_dir} ...`
|
||||
- **Suggested invocation:** `/trekresearch --project {project_dir} ...`
|
||||
- **Required for plan steps:** ...
|
||||
- **Confidence needed:** ...
|
||||
- **Estimated cost:** ...
|
||||
|
|
@ -133,7 +133,7 @@ failures.*
|
|||
- **Created:** {YYYY-MM-DD}
|
||||
- **Interview turns:** {N}
|
||||
- **Auto-research opted in:** {yes | no}
|
||||
- **Source:** {ultrabrief interview | manual}
|
||||
- **Source:** {trekbrief interview | manual}
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -143,15 +143,15 @@ Manual (default):
|
|||
|
||||
```bash
|
||||
# Run each research topic (order does not matter):
|
||||
/ultraresearch-local --project {project_dir} --external "{Topic 1 question}"
|
||||
/ultraresearch-local --project {project_dir} --external "{Topic 2 question}"
|
||||
/trekresearch --project {project_dir} --external "{Topic 1 question}"
|
||||
/trekresearch --project {project_dir} --external "{Topic 2 question}"
|
||||
|
||||
# Then plan:
|
||||
/ultraplan-local --project {project_dir}
|
||||
/trekplan --project {project_dir}
|
||||
|
||||
# Then execute:
|
||||
/ultraexecute-local --project {project_dir}
|
||||
/trekexecute --project {project_dir}
|
||||
```
|
||||
|
||||
Auto (opt-in during `/ultrabrief-local`): research and planning run
|
||||
Auto (opt-in during `/trekbrief`): research and planning run
|
||||
automatically; only execution is manual.
|
||||
|
|
|
|||
|
|
@ -42,7 +42,7 @@ should look at first.
|
|||
- file: lib/foo.mjs
|
||||
- line: 42
|
||||
- rule_key: BROKEN_SUCCESS_CRITERION
|
||||
- brief_ref: SC3 — "review.md is parseable as input to /ultraplan-local"
|
||||
- brief_ref: SC3 — "review.md is parseable as input to /trekplan"
|
||||
- title: Plan-validator rejects review.md when source_findings is flow-style
|
||||
- detail: The validator at lib/validators/plan-validator.mjs:N reads
|
||||
`source_findings` via parseDocument(), which does not support flow-style
|
||||
|
|
@ -101,7 +101,7 @@ should look at first.
|
|||
- 1 MINOR → nice-to-have for v1.1
|
||||
- 1 SUGGESTION → log and move on
|
||||
|
||||
If running `/ultraplan-local --brief review.md`, the planner will consume
|
||||
If running `/trekplan --brief review.md`, the planner will consume
|
||||
the BLOCKER + MAJOR findings as plan goals (their `recommended_action`
|
||||
becomes the step intent). MINOR + SUGGESTION are skipped for v1.0
|
||||
plan-input.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue