opencodekit 0.12.2 → 0.12.4

package/dist/template/.opencode/command/resume.md

@@ -1,522 +1,154 @@
 ---
-description: Resume work on a bead from handoff with full context recovery
+description: Resume work on a bead from previous session
 argument-hint: "<bead-id>"
 agent: build
 ---
 
 # Resume: $ARGUMENTS
 
-Recover full context from a previous session and continue work on an in-progress task.
+You're picking up where a previous session left off. Recover context, verify state, continue work.
 
-## Load Beads Skill
+## Load Skills
 
 ```typescript
 skill({ name: "beads" });
 ```
 
-This skill provides the session protocol for proper context recovery.
-
-## Prerequisites
-
-- Bead ID must exist
-- Handoff file should be present (created by `/handoff`)
-- Previous session context should be accessible
-
-## Phase 1: Initialize Environment
-
-```typescript
-bd_init({ _: true, team: "project", role: "builder" });
-```
-
-## Phase 2: Validate Bead Exists
-
-```typescript
-bd_show({ id: "$ARGUMENTS" });
-```
-
-**If bead not found:**
+## Verify The Task Exists
 
+```bash
+bd show $ARGUMENTS
 ```
-ERROR: Bead '$ARGUMENTS' not found
 
-Available beads:
-[list from bd_ls]
+If not found, check `bd list --status=all`. Maybe it was closed, or you have the wrong ID.
 
-Did you mean:
-- bd-abc12 (similar prefix)
-- bd-xyz99 (in progress)
+## Check Git State
 
-Commands:
-- /status     # See all beads
-- /start <id> # Start a new bead
+```bash
+git branch --show-current
+git rev-parse --short HEAD
+git status --porcelain
 ```
 
-## Phase 3: Check Messages and Blockers
-
-Before diving in, check for coordination updates:
+If you're not on the right branch:
 
-```typescript
-bd_inbox({ n: 10, unread: true, global: true });
-bd_reservations({ reason: "Check for conflicting locks" });
+```bash
+git checkout $ARGUMENTS 2>/dev/null || git checkout feature/$ARGUMENTS
 ```
 
-**If blocking messages found:**
+If there are uncommitted changes, decide: stash, commit, or discard.
 
-```
-⚠️  ATTENTION REQUIRED
-━━━━━━━━━━━━━━━━━━━━━
-
-Message from qa-agent (2h ago):
-"Found regression in auth flow - hold on bd-abc12 until fixed"
+## Find The Handoff
 
-Options:
-1. Acknowledge and continue anyway
-2. Switch to different task (/triage)
-3. Reply for clarification
+```bash
+ls -t .beads/artifacts/$ARGUMENTS/handoffs/ 2>/dev/null | head -1
 ```
 
-**If conflicting file locks:**
+If a handoff exists, read it:
 
+```bash
+cat .beads/artifacts/$ARGUMENTS/handoffs/[latest].md
 ```
-⚠️  FILE CONFLICT
-━━━━━━━━━━━━━━━━
 
-Files you need are locked:
+The handoff tells you:
 
-src/auth/service.ts - locked by be-agent (expires 8m)
-src/auth/types.ts   - locked by be-agent (expires 8m)
-
-Options:
-1. Wait for lock to expire
-2. Message be-agent to coordinate
-3. Work on non-conflicting files first
-```
+- What was completed
+- Where work stopped
+- What to do next
+- Any blockers
 
-## Phase 4: Load Previous Session Context
+## Load Previous Session Context
 
-### Step 1: Search for Related Work
+Search for related work:
 
 ```typescript
-// Search past sessions for work on this bead
 search_session({ query: "$ARGUMENTS" });
+list_sessions({ project: "current", limit: 5 });
 ```
 
-This finds all sessions that discussed or worked on this bead.
-
-### Step 2: Find Related Sessions
-
-```typescript
-list_sessions({ project: "current", limit: 10, _: true });
-```
-
-### Step 3: Identify Relevant Session
-
-Look for sessions that:
-
-- Mention the bead ID
-- Modified files in the bead's scope
-- Have handoff mentions
+Load the most recent relevant session:
 
 ```typescript
-read_session("last", { project: "current", focus: "$ARGUMENTS" });
+read_session({ session_reference: "last", project: "current" });
 ```
 
-### Step 3: Extract Key Context
-
-From session, note:
+Extract from session:
 
 - Files modified
 - Decisions made
 - Where work stopped
-- Blockers encountered
+- Problems encountered
 
-## Phase 5: Find and Load Handoff
+## Load Artifacts
 
-### Locate Handoff File
+Read all available context:
 
 ```bash
-ls -t .beads/artifacts/$ARGUMENTS/handoffs/ 2>/dev/null | head -1
-```
-
-**If no handoffs directory:**
-
-```
-No handoff found for $ARGUMENTS
-
-This bead may not have been started with /start, or
-no handoff was created before the previous session ended.
-
-Fallback: Loading from bead spec and plan...
-```
-
-### Load Handoff Content
-
-```typescript
-read({ filePath: ".beads/artifacts/$ARGUMENTS/handoffs/<latest>.md" });
-```
-
-### Parse Handoff Structure
-
-Expected format:
-
-```markdown
-# Handoff: $ARGUMENTS
-
-## Summary
-
-[What was accomplished]
-
-## Progress
-
-- [x] Step 1
-- [x] Step 2
-- [ ] Step 3 ← STOPPED HERE
-- [ ] Step 4
-
-## Current State
-
-- Branch: feature/auth
-- Commit: abc1234
-- Working: src/auth/service.ts
-
-## Resume Instructions
-
-[Specific next actions]
-
-## Blockers
-
-[Any known issues]
-
-## Files Modified
-
-- src/auth/service.ts (+45/-12)
-- src/auth/types.ts (+8/-0)
+cat .beads/artifacts/$ARGUMENTS/spec.md 2>/dev/null
+cat .beads/artifacts/$ARGUMENTS/plan.md 2>/dev/null
+cat .beads/artifacts/$ARGUMENTS/research.md 2>/dev/null
 ```
 
-## Phase 6: Verify Git State
+## Check For Stale Context
 
-### Check Current State
+If the handoff is more than 3 days old, things may have changed:
 
 ```bash
-git branch --show-current
-git rev-parse HEAD
-git status --porcelain
-```
-
-### Compare with Handoff
-
-```typescript
-const handoffCommit = parseHandoff().commit;
-const currentCommit = getCurrentCommit();
-
-if (handoffCommit !== currentCommit) {
-  // Check if we're ahead or behind
-  const isAhead = isAncestor(handoffCommit, currentCommit);
-  const isBehind = isAncestor(currentCommit, handoffCommit);
-
-  if (isAhead) {
-    console.log(
-      "Current branch is ahead of handoff - new commits since handoff",
-    );
-  } else if (isBehind) {
-    console.log(
-      "WARNING: Current branch is behind handoff - commits may be lost",
-    );
-  } else {
-    console.log("WARNING: Branches have diverged");
-  }
-}
-```
-
-**Mismatch Handling:**
-
-```
-⚠️  GIT STATE MISMATCH
-━━━━━━━━━━━━━━━━━━━━━
-
-Handoff Commit: abc1234 "feat: add auth middleware"
-Current Commit: def5678 "fix: typo in readme"
-Branch:         main (expected: feature/auth)
-
-Options:
-1. Switch to correct branch:
-   git checkout feature/auth
-
-2. Continue on current branch:
-   [Work may not align with handoff]
-
-3. View diff between commits:
-   git diff abc1234..def5678
+git log --oneline -10  # What happened since?
+git diff [handoff-commit]..HEAD --stat  # What files changed?
 ```
 
-### Branch Checkout (if needed)
+If significant changes occurred on main, consider rebasing:
 
 ```bash
-# Check if branch exists
-git branch --list "feature/$ARGUMENTS" "$ARGUMENTS"
-
-# Checkout if found
-git checkout "$ARGUMENTS" 2>/dev/null || git checkout "feature/$ARGUMENTS"
-```
-
-## Phase 7: Load All Artifacts
-
-Read all bead context in parallel:
-
-```typescript
-read({ filePath: ".beads/artifacts/$ARGUMENTS/spec.md" });
-read({ filePath: ".beads/artifacts/$ARGUMENTS/research.md" });
-read({ filePath: ".beads/artifacts/$ARGUMENTS/plan.md" });
-read({ filePath: ".beads/artifacts/$ARGUMENTS/review.md" });
-```
-
-**If files missing, note gaps:**
-
-```
-Artifact Status:
-✓ spec.md     - loaded
-✓ plan.md     - loaded
-✗ research.md - not found (may not be needed)
-✗ review.md   - not found (will create during work)
-```
-
-## Phase 8: Stale Handoff Detection
-
-Check if handoff is too old:
-
-```typescript
-const handoffAge = Date.now() - new Date(handoff.timestamp);
-const hoursOld = handoffAge / (1000 * 60 * 60);
-
-if (hoursOld > 72) {
-  // 3 days
-  console.warn(`⚠️ Handoff is ${Math.floor(hoursOld / 24)} days old`);
-  console.warn("Context may be outdated. Consider:");
-  console.warn("1. Re-reading current file state");
-  console.warn("2. Checking for changes by others");
-  console.warn("3. Re-running /research if needed");
-}
+git fetch origin
+git rebase origin/main
 ```
 
-**Stale Handoff Warning:**
+## Report Status
 
 ```
-⚠️  STALE HANDOFF DETECTED
-━━━━━━━━━━━━━━━━━━━━━━━━━
+Resuming: $ARGUMENTS
 
-Handoff created: 5 days ago
-Last commit on branch: 5 days ago
+Branch: [branch]
+Commit: [hash]
+Handoff: [date] ([age])
 
-Since then:
-- 12 commits on main
-- 3 files modified that you touched
+Progress:
+- [x] [completed]
+- [x] [completed]
+- [ ] [in progress] <- resume here
+- [ ] [remaining]
 
-Recommendation:
-1. Check for merge conflicts: git merge --no-commit main
-2. Re-read key files to refresh context
-3. Update plan if approach changed
+Next: [from handoff resume instructions]
 ```
 
-## Phase 9: Reserve Required Files
+## Continue Work
 
-Based on handoff and plan, reserve files for editing:
+Mark in progress if not already:
 
-```typescript
-const filesToEdit = extractFilesFromPlan(plan);
-bd_reserve({ paths: filesToEdit, ttl: 600, reason: "Resuming $ARGUMENTS" });
+```bash
+bd update $ARGUMENTS --status in_progress
 ```
 
-## Phase 10: Generate Resume Report
+Then continue with implementation:
 
 ```
-╔══════════════════════════════════════════════════════════════════════════╗
-║                         RESUMING: $ARGUMENTS                             ║
-╠══════════════════════════════════════════════════════════════════════════╣
-
-TASK INFO
-━━━━━━━━━
-Title:    [from bead]
-Priority: [P0-P4]
-Status:   In Progress
-Created:  [date]
-
-
-CONTEXT SOURCES
-━━━━━━━━━━━━━━━
-Source              │ Status │ Age
-────────────────────┼────────┼────────
-Handoff             │ ✓      │ 2 days
-Previous Session    │ ✓      │ 2 days
-Spec                │ ✓      │ -
-Plan                │ ✓      │ -
-
-
-PREVIOUS SESSION SUMMARY
-━━━━━━━━━━━━━━━━━━━━━━━━
-Session: ses_abc123 (2 days ago)
-Duration: 45 min
-Messages: 34
-Focus: Implementing auth middleware
-
-Key Actions:
-- Created AuthMiddleware class
-- Added token validation
-- Stopped at: refresh token logic
-
-
-PROGRESS
-━━━━━━━━
-[x] Set up project structure
-[x] Create base service class
-[x] Add authentication logic
-[ ] Implement refresh tokens     ← RESUME HERE
-[ ] Add rate limiting
-[ ] Write tests
-[ ] Update documentation
-
-Completed: 3/7 (43%)
-
-
-GIT STATE
-━━━━━━━━━
-Branch: feature/auth
-Commit: abc1234 "feat: add auth middleware"
-Status: Clean ✓
-
-
-RESUME INSTRUCTIONS
-━━━━━━━━━━━━━━━━━━━
-From handoff:
-
-"Left off implementing refresh token rotation. The TokenService
-is ready but needs the rotateToken() method. See TODO in
-src/auth/token-service.ts:45. Tests are set up but empty."
-
-
-FILES TO MODIFY
-━━━━━━━━━━━━━━━
-src/auth/token-service.ts (add rotateToken method)
-src/auth/token-service.test.ts (add tests)
-
-
-FILE LOCKS ACQUIRED
-━━━━━━━━━━━━━━━━━━━
-✓ src/auth/token-service.ts (10 min)
-✓ src/auth/token-service.test.ts (10 min)
-
-
-BLOCKERS
-━━━━━━━━
-[If any blockers from handoff:]
-- Waiting on API spec for refresh endpoint (ask be-agent)
-
-[If no blockers:]
-No known blockers
-
-
-READY TO CONTINUE
-━━━━━━━━━━━━━━━━━
-
-Load skill: skill({ name: "executing-plans" })
-
-Then continue with:
 /implement $ARGUMENTS
-
-Or if you need to re-orient:
-- Read src/auth/token-service.ts to see current state
-- Check plan.md for detailed steps
-
-╚══════════════════════════════════════════════════════════════════════════╝
-```
-
-## Phase 11: Determine Next Action
-
-Based on state, recommend action:
-
-```typescript
-const nextAction = determineNextAction({
-  hasSpec: !!spec,
-  hasResearch: !!research,
-  hasPlan: !!plan,
-  planProgress: calculateProgress(plan),
-  hasBlockers: blockers.length > 0,
-});
-
-switch (nextAction) {
-  case "NEEDS_SPEC":
-    return "/create $ARGUMENTS - Add specification";
-  case "NEEDS_RESEARCH":
-    return "/research $ARGUMENTS - Research required";
-  case "NEEDS_PLAN":
-    return "/plan $ARGUMENTS - Create implementation plan";
-  case "CONTINUE_IMPLEMENTATION":
-    return "/implement $ARGUMENTS - Continue building";
-  case "BLOCKED":
-    return "Address blockers first, then /implement";
-  case "READY_TO_FINISH":
-    return "/finish $ARGUMENTS - Complete and close";
-}
-```
-
-**Decision Table:**
-
-| State                         | Action                  |
-| ----------------------------- | ----------------------- |
-| No spec.md                    | `/create $ARGUMENTS`    |
-| No research.md (complex task) | `/research $ARGUMENTS`  |
-| No plan.md                    | `/plan $ARGUMENTS`      |
-| Plan < 100% complete          | `/implement $ARGUMENTS` |
-| Plan 100% + tests pass        | `/finish $ARGUMENTS`    |
-| Has blockers                  | Address blockers first  |
-
-## Error Recovery
-
-### No Bead Found
-
-```
-ERROR: Bead not found
-
-Possible causes:
-1. Typo in bead ID
-2. Bead was closed/deleted
-3. Using wrong project
-
-Check: bd_ls({ status: "all", limit: 20, offset: 0 })
-```
-
-### No Session Context
-
 ```
-WARNING: No previous session found for this bead
 
-Proceeding with spec and plan only.
-Context may be limited.
+Or if you need to re-plan:
 
-Recommendation: Read key files manually before continuing.
 ```
-
-### Corrupted Handoff
-
+/plan $ARGUMENTS
 ```
-ERROR: Handoff file is corrupted or incomplete
 
-Missing required sections:
-- Progress checklist
-- Resume instructions
-
-Fallback: Using plan.md for progress tracking
-```
+## If Context Is Too Stale
 
-## Integration
-
-After resume, the loaded skill will guide execution:
-
-```typescript
-skill({ name: "executing-plans" });
-```
+If more than a week old or significant changes happened:
 
-This ensures:
+1. Re-read key files to refresh understanding
+2. Check if the approach in plan.md is still valid
+3. Consider running `/research $ARGUMENTS` again if external factors changed
 
-- Plan is followed step-by-step
-- Progress is tracked in plan.md
-- Handoff is created before context limit
+Don't blindly follow an outdated plan. Verify it still makes sense.

package/dist/template/.opencode/command/status.md

@@ -25,7 +25,7 @@ bd_ls({ status: "in_progress", limit: 10, offset: 0 });
 bd_ls({ status: "ready", limit: 10, offset: 0 });
 bd_inbox({ n: 5, unread: true, global: true });
 bd_doctor({ reason: "Health check" });
-bd_reservations({ reason: "Check file locks" });
+bd_reservations();
 
 // Sessions
 list_sessions({ project: "current", since: "today", limit: 5, _: true });
@@ -112,9 +112,9 @@ IN PROGRESS
 ━━━━━━━━━━━
 ID       │ Priority │ Title                    │ Agent    │ Age
 ─────────┼──────────┼──────────────────────────┼──────────┼────────
-bd-abc12 │ P0       │ Fix auth regression      │ be-agent │ 2h
-bd-def34 │ P1       │ Add user dashboard       │ fe-agent │ 1d
-bd-ghi56 │ P2       │ Refactor logging         │ be-agent │ 3h
+bd-abc12 │ P0       │ Fix auth regression      │ build    │ 2h
+bd-def34 │ P1       │ Add user dashboard       │ build    │ 1d
+bd-ghi56 │ P2       │ Refactor logging         │ build    │ 3h
 
 
 READY TO START
@@ -133,9 +133,9 @@ MESSAGES
 
 From        │ Subject                          │ Time
 ────────────┼──────────────────────────────────┼────────
-fe-agent    │ Need API spec for dashboard      │ 2h ago
-qa-agent    │ Tests failing on staging         │ 4h ago
-be-agent    │ Migration complete               │ 1d ago
+build-1     │ Need API spec for dashboard      │ 2h ago
+review      │ Tests failing on staging         │ 4h ago
+build-2     │ Migration complete               │ 1d ago
 
 [If no messages:]
 📭 No unread messages
@@ -148,8 +148,8 @@ FILE LOCKS
 
 Path                           │ Owner     │ Expires
 ───────────────────────────────┼───────────┼─────────
-src/auth/service.ts            │ be-agent  │ 8m
-src/components/Dashboard.tsx   │ fe-agent  │ 15m
+src/auth/service.ts            │ build     │ 8m
+src/components/Dashboard.tsx   │ build     │ 15m
 
 [If no locks:]
 🔓 No active file locks
@@ -215,7 +215,7 @@ REQUIRED ACTIONS
 ━━━━━━━━━━━━━━━━
 Priority │ Action                              │ Command
 ─────────┼─────────────────────────────────────┼────────────────────
-HIGH     │ Reply to fe-agent question          │ bd_msg(...)
+HIGH     │ Reply to build-1 question          │ bd_msg(...)
 HIGH     │ Add plan for bd-ghi56               │ /plan bd-ghi56
 MEDIUM   │ Review 2 stale tasks                │ /triage --stale
 LOW      │ Push 2 local commits                │ git push
@@ -332,7 +332,7 @@ RECOMMENDED NEXT STEPS
 Based on current status:
 
 1. High Priority Messages:
-   → Reply to fe-agent: bd_msg({ to: "fe-agent", subj: "Re: API spec", body: "..." })
+   → Reply to build-1: bd_msg({ to: "build-1", subj: "Re: API spec", body: "..." })
 
 2. Continue In-Progress Work:
    → /implement bd-abc12  (P0, 2h old)