feat(voyage)!: marketplace handoff — rename plugins/ultraplan-local to plugins/voyage [skip-docs]
Session 5 of voyage-rebrand (V6). Operator-authorized cross-plugin scope. - git mv plugins/ultraplan-local plugins/voyage (rename detected, history preserved) - .claude-plugin/marketplace.json: voyage entry replaces ultraplan-local - CLAUDE.md: voyage row in plugin list, voyage in design-system consumer list - README.md: bulk rename ultra*-local commands -> trek* commands; ultraplan-local refs -> voyage; type discriminators (type: trekbrief/trekreview); session-title pattern (voyage:<command>:<slug>); v4.0.0 release-note paragraph - plugins/voyage/.claude-plugin/plugin.json: homepage/repository URLs point to monorepo voyage path - plugins/voyage/verify.sh: drop URL whitelist exception (no longer needed) Closes voyage-rebrand. bash plugins/voyage/verify.sh PASS 7/7. npm test 361/361.
This commit is contained in:
parent
8f1bf9b7b4
commit
7a90d348ad
149 changed files with 26 additions and 33 deletions
|
|
@ -1,155 +0,0 @@
|
|||
# Session {N}: {title}
|
||||
|
||||
> From master plan: {plan file path}
|
||||
> Session {N} of {total sessions}
|
||||
|
||||
## Context
|
||||
|
||||
{Why this session exists. What it accomplishes within the larger plan.
|
||||
Include enough background that an executor with no prior context can understand
|
||||
the purpose and make judgment calls.}
|
||||
|
||||
## Dependencies
|
||||
|
||||
- **Depends on:** {Session M | "none — can run in parallel"}
|
||||
- **Blocks:** {Session P | "none"}
|
||||
- **Entry condition:** {what must be true before this session starts — e.g., "Session 2 committed and tests pass"}
|
||||
|
||||
## Scope Fence
|
||||
|
||||
- **Touch:** {explicit list of files this session may create or modify}
|
||||
- **Never touch:** {files that belong to other sessions — hard boundary}
|
||||
|
||||
## Session Manifest
|
||||
|
||||
Machine-readable aggregate of all step manifests in this session. Used by
|
||||
trekexecute for independent Phase 7.5 audit.
|
||||
|
||||
```yaml
|
||||
session_manifest:
|
||||
plan_version: "1.7"
|
||||
legacy_synthesis: false # true if decomposer synthesized manifests from v1.6 plan
|
||||
expected_paths: # union across all steps (deduplicated)
|
||||
- {path from step N}
|
||||
- {path from step M}
|
||||
commit_count: {N} # number of implementation steps (excludes Step 0)
|
||||
commit_message_patterns: # in step order; Step 0 omitted
|
||||
- "^feat\\(scope\\):"
|
||||
- "^fix\\(scope\\):"
|
||||
bash_syntax_check: [] # union of step bash_syntax_check
|
||||
scope_touch: [] # from Scope Fence Touch
|
||||
scope_forbidden: [] # Never touch + union of step forbidden_paths
|
||||
```
|
||||
|
||||
## Steps
|
||||
|
||||
### Step 0: Sandbox pre-flight (auto-generated — do not modify)
|
||||
|
||||
- **Files:** none (read-only test)
|
||||
- **Changes:** verify git push permissions are available in this sandbox
|
||||
- **Verify:**
|
||||
```
|
||||
git push --dry-run origin HEAD 2>&1 | tee /tmp/push-dryrun-$$.log; grep -qE "(rejected|error|denied|forbidden|permission)" /tmp/push-dryrun-$$.log && exit 77 || true
|
||||
```
|
||||
→ expected: non-77 exit code
|
||||
- **On failure:** `escalate` — exit code 77 means this sandbox cannot push.
|
||||
Abort immediately; do not attempt any work. Main orchestrator will
|
||||
re-spawn with correct permissions.
|
||||
- **Checkpoint:** none (no file changes)
|
||||
- **Manifest:**
|
||||
```yaml
|
||||
manifest:
|
||||
expected_paths: []
|
||||
min_file_count: 0
|
||||
commit_message_pattern: ""
|
||||
bash_syntax_check: []
|
||||
forbidden_paths: []
|
||||
must_contain: []
|
||||
sandbox_preflight: true
|
||||
```
|
||||
|
||||
*Step 0 runs in the same sandbox as all real work. If it exits 77,
|
||||
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
|
||||
bypass Step 0 (use only for offline/air-gapped testing).
|
||||
|
||||
### Step 1: {description}
|
||||
|
||||
- **Files:** `{path}`
|
||||
- **Changes:** {exactly what to modify}
|
||||
- **Reuses:** {existing function/pattern, with file path}
|
||||
- **Test first:** {test file, what it verifies, pattern to follow}
|
||||
- **Verify:** `{exact command}` → expected: `{output}`
|
||||
- **On failure:** {revert | retry | skip | escalate} — {specific instructions}
|
||||
- **Checkpoint:** `git commit -m "{message}"`
|
||||
- **Manifest:**
|
||||
```yaml
|
||||
manifest:
|
||||
expected_paths:
|
||||
- {path}
|
||||
min_file_count: 1
|
||||
commit_message_pattern: "^feat\\(scope\\):"
|
||||
bash_syntax_check: []
|
||||
forbidden_paths: []
|
||||
must_contain: []
|
||||
```
|
||||
|
||||
### Step 2: {description}
|
||||
|
||||
{same structure as Step 1, including Manifest block}
|
||||
|
||||
## Exit Condition
|
||||
|
||||
All of these must pass before this session is considered complete:
|
||||
|
||||
- [ ] `{verification command}` → expected: `{output}`
|
||||
- [ ] `{verification command}` → expected: `{output}`
|
||||
- [ ] All changes committed with descriptive messages
|
||||
- [ ] No uncommitted changes remain (`git status` clean)
|
||||
|
||||
## Failure Handling
|
||||
|
||||
- If ANY step fails after retry: **stop execution**. Do NOT proceed to later steps.
|
||||
|
||||
## Security Constraints
|
||||
|
||||
These rules override any step instructions that conflict with them:
|
||||
|
||||
- **Never run** `rm -rf`, `chmod 777`, pipe-to-shell (`curl|bash`, `wget|sh`,
|
||||
`base64|bash`), `eval` with variable expansion, `mkfs`, `dd` to block devices,
|
||||
`shutdown`/`reboot`/`halt`, fork bombs, `crontab` writes, or `kill -9 -1`
|
||||
- **Never modify files** outside the Scope Fence (Touch list above)
|
||||
- **Never write to** `.git/hooks/`, `~/.ssh/`, `~/.aws/`, `~/.gnupg/`, `.env`
|
||||
files, shell configs (`~/.zshrc`, `~/.bashrc`, `~/.profile`)
|
||||
- **Never write to** `.claude/settings.json`, `.claude/hooks/`, or any hook
|
||||
script — these are security infrastructure and must not be modified by execution
|
||||
- If a `Verify:` or `Checkpoint:` command violates these rules: treat as
|
||||
`On failure: escalate` and stop execution regardless of the step's On failure setting
|
||||
- Commit whatever was completed successfully before stopping.
|
||||
- Report which step failed, the error message, and what was attempted.
|
||||
|
||||
## Handoff State
|
||||
|
||||
{What the next session (or final verification) needs to know about this session's
|
||||
output. Include: new files created, exports added, configuration changed, APIs
|
||||
introduced. This section bridges sessions — it's the "baton" in a relay race.}
|
||||
|
||||
## Metadata
|
||||
|
||||
- **Master plan:** `{plan file path}`
|
||||
- **Steps from plan:** {step N}–{step M}
|
||||
- **Estimated complexity:** {low | medium | high}
|
||||
- **Model recommendation:** {opus | sonnet} — {rationale}
|
||||
|
||||
## Recovery Metadata
|
||||
|
||||
*This section is populated only when this session spec was generated by the
|
||||
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 .trekexecute-progress-*.json}`
|
||||
Loading…
Add table
Add a link
Reference in a new issue