opencodekit 0.10.0 → 0.11.1

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

@@ -1,53 +1,259 @@
 ---
 description: Create and submit pull request with bead traceability
-argument-hint: "[bead-id]"
+argument-hint: "<bead-id> [--draft] [--wait]"
+agent: build
 ---
 
-**Load skill:** `skill({ name: "verification-before-completion" })`
+# Pull Request
 
-## Create Pull Request
+**Load skills:**
 
-**Current Branch:** `!git branch --show-current`
-**Changes Summary:** `!git diff main...HEAD --stat`
-**Commits:** `!git log main...HEAD --oneline`
+```typescript
+skill({ name: "beads" }); // Session protocol
+skill({ name: "verification-before-completion" });
+```
+
+## Options
+
+- `--draft`: Create as draft PR (for WIP or early feedback)
+- `--wait`: Wait for CI checks to pass after creation
+
+## Phase 1: Pre-PR Verification
+
+Before creating PR, run verification gates:
+
+```bash
+git status --porcelain  # Check for uncommitted changes
+```
+
+If uncommitted changes exist, ask: "Commit these changes first?"
+
+Run project gates:
+
+```bash
+npm run build 2>&1 | tail -5
+npm test 2>&1 | tail -10
+npm run lint 2>&1 | tail -5
+```
 
-Create a pull request following these steps:
+```
+Pre-PR Gates:
+━━━━━━━━━━━━━
+
+Build: [✓/✗]
+Tests: [✓/✗]
+Lint:  [✓/✗]
+```
 
-1. **Format code** (if formatters available): `!command -v prettier > /dev/null && npm run format || echo "No formatter configured"`
+**If any gate fails: STOP.**
 
-2. **Push branch**: `!git push -u origin $(git branch --show-current)`
+```
+Cannot create PR: [gate] failed.
 
-3. **Check for bead context:**
-   - If `$ARGUMENTS` contains a bead ID, fetch bead details: `bd_show({ id: "$ARGUMENTS" })`
-   - Use bead title and spec to inform PR content
-   - Reference the bead in the PR body for traceability
+Fix errors first, then run /pr again.
+```
 
-4. **Generate PR content:**
-   - Title: Clear, descriptive (under 60 chars)
-   - Summary: What and why this change matters
-   - Testing: How to verify the changes
-   - Breaking changes: Note any API/behavior changes
+## Phase 2: Check for Conflicts
 
-5. **Create PR**: `!gh pr create --title "Generated Title" --body "Generated Description"`
+```bash
+git fetch origin main
+git merge-base --is-ancestor origin/main HEAD || git diff origin/main...HEAD --name-only
+```
 
-**Template format:**
+Check for merge conflicts:
+
+```bash
+git merge --no-commit --no-ff origin/main 2>&1 || true
+git merge --abort 2>/dev/null || true
+```
+
+If conflicts detected:
+
+```
+⚠️  Merge conflicts detected with main:
+- [file1]
+- [file2]
 
+Resolve conflicts before creating PR:
+  git fetch origin main
+  git rebase origin/main
+  # Fix conflicts, then /pr again
 ```
+
+## Phase 3: Gather Context
+
+**Current state:**
+
+```bash
+git branch --show-current
+git diff main...HEAD --stat
+git log main...HEAD --oneline
+```
+
+**Load bead context (if provided):**
+
+```typescript
+bd_show({ id: "$ARGUMENTS" });
+```
+
+**Load artifacts:**
+
+```bash
+ls .beads/artifacts/<bead-id>/ 2>/dev/null
+cat .beads/artifacts/<bead-id>/spec.md 2>/dev/null | head -30
+cat .beads/artifacts/<bead-id>/review.md 2>/dev/null | head -30
+```
+
+Extract from artifacts:
+
+- **Goal** from spec.md
+- **Changes Made** from review.md
+- **Estimation Accuracy** from review.md
+- **Success Criteria** verification
+
+## Phase 4: Push Branch
+
+```bash
+git push -u origin $(git branch --show-current)
+```
+
+## Phase 5: Create PR
+
+Generate PR content from context:
+
+```bash
+gh pr create --title "<title>" --body "$(cat <<'EOF'
 ## Summary
-- Brief description of changes
 
-## Bead Reference
-Closes: bd-XXXXX (if applicable)
+[1-2 sentence description of what this PR does and why]
+
+## Changes
+
+| File | Change |
+| ---- | ------ |
+| `src/foo.ts` | [description] |
+| `src/bar.ts` | [description] |
 
 ## Testing
-- How to test these changes
 
-## Breaking Changes
-- None / List any breaking changes
+**Automated:**
+- All tests pass ✓
+- Lint passes ✓
+- Type check passes ✓
+
+**Manual verification:**
+- [ ] [How to test manually]
+
+## Screenshots
+
+[If UI changes, include before/after screenshots]
+
+## Estimation
+
+| Metric | Value |
+| ------ | ----- |
+| Estimated | [S/M/L] (~N calls) |
+| Actual | N calls |
+| Accuracy | [+/-N%] |
+
+## Checklist
+
+- [x] Tests added/updated
+- [x] All gates pass
+- [ ] Docs updated (if applicable)
+- [ ] Breaking changes documented (if any)
+
+## Artifacts
+
+- [spec.md](.beads/artifacts/<bead-id>/spec.md)
+- [review.md](.beads/artifacts/<bead-id>/review.md)
+[- research.md, plan.md, adr.md if they exist]
+
+## Bead Reference
+
+Closes: <bead-id>
+EOF
+)"
+```
+
+**For draft PRs (--draft):**
+
+```bash
+gh pr create --draft --title "<title>" --body "..."
 ```
 
-## After PR Created
+## Phase 6: Wait for CI (if --wait)
+
+```bash
+gh pr checks --watch
+```
 
-If a bead ID was provided, update the bead with PR link:
+Report CI status:
+
+```
+CI Status:
+━━━━━━━━━━
+
+- build: [✓/✗/pending]
+- test: [✓/✗/pending]
+- lint: [✓/✗/pending]
+
+[If all pass] CI passed ✓
+[If any fail] CI failed: [which check]
+```
 
-Update the bead with a note about the PR using the beads messaging or note system.
+## Phase 7: Update Bead & Sync
+
+```typescript
+bd_msg({
+  subj: "PR created",
+  body: "PR: <pr-url>\nStatus: [ready/draft]\nCI: [passing/pending]",
+  to: "all",
+  importance: "normal",
+  global: true,
+});
+
+bd_sync({ reason: "PR created for $ARGUMENTS" });
+```
+
+## Output
+
+```
+PR Created: <bead-id>
+━━━━━━━━━━━━━━━━━━━━
+
+URL: <pr-url>
+Status: [Ready for Review / Draft]
+Branch: <branch> → main
+
+Pre-PR Gates: All passed ✓
+Conflicts: None ✓
+[CI: Passed ✓ (if --wait)]
+
+Artifacts linked:
+- spec.md ✓
+- review.md ✓
+[- research.md, plan.md, adr.md]
+```
+
+**Next steps:**
+
+```
+━━━━━━━━━━━━━━━━━━━━
+
+Request review:
+  gh pr edit <pr-number> --add-reviewer <username>
+
+Check CI:
+  gh pr checks
+
+Merge when approved:
+  gh pr merge --squash
+```
+
+**If draft PR:**
+
+```
+Draft PR created. When ready:
+  gh pr ready
+```

package/dist/template/.opencode/command/quick-build.md

@@ -1,13 +1,242 @@
 ---
-description: Quick build for trivial tasks
-argument-hint: "[task]"
+description: Quick build for trivial tasks with fast verification
+argument-hint: "<task-description> [--no-test] [--no-commit]"
 agent: build
 ---
 
 # Quick Build: $ARGUMENTS
 
-**Reject if:** ≥2 files, new deps, security risk, DB changes. Use `/create` instead.
+Fast path for trivial tasks. Skip ceremony, keep safety.
 
-**Simple edit:** Fix directly with clear comments, commit.
+## Parse Arguments
 
-**Needs structure:** Create bead with `/create`, implement, run `/finish`.
+| Argument         | Default  | Description                   |
+| ---------------- | -------- | ----------------------------- |
+| Task description | required | What to fix/change            |
+| `--no-test`      | false    | Skip test run (use sparingly) |
+| `--no-commit`    | false    | Make changes but don't commit |
+
+---
+
+## Qualification Check
+
+**This task qualifies for quick-build if ALL are true:**
+
+| Criterion                | Check                                | If False          |
+| ------------------------ | ------------------------------------ | ----------------- |
+| Single file change       | 1 file modified                      | Use `/create`     |
+| No new dependencies      | No package.json/requirements changes | Use `/create`     |
+| No database changes      | No migrations, schema changes        | Use `/create`     |
+| No security implications | No auth, secrets, permissions        | Use `/create`     |
+| Under 30 minutes         | Estimate < 30 min                    | Use `/create`     |
+| Clear scope              | Know exactly what to change          | Use `/brainstorm` |
+| Low risk                 | Won't break critical paths           | Use `/create`     |
+
+**Examples that qualify:**
+
+- Fix typo in UI text
+- Update a constant value
+- Fix off-by-one error
+- Add missing null check
+- Update documentation
+- Rename a variable
+- Fix CSS styling issue
+
+**Examples that DON'T qualify:**
+
+- Add new API endpoint (multiple files)
+- Change authentication logic (security)
+- Update database schema (DB changes)
+- Add new npm package (dependencies)
+- Refactor a module (scope unclear)
+
+---
+
+## Workflow
+
+### Step 1: Verify Scope (30 seconds)
+
+```bash
+# Check what files might be involved
+grep -r "[search-term]" src/ --include="*.{ts,tsx}" -l | head -5
+```
+
+If more than 1 file: **STOP** → Use `/create $ARGUMENTS` instead.
+
+### Step 2: Backup Current State
+
+```bash
+# Stash any existing changes
+git stash push -m "pre-quickbuild-$(date +%s)" 2>/dev/null || true
+
+# Note current commit
+git rev-parse HEAD
+```
+
+### Step 3: Make the Change
+
+```bash
+# Read the file
+read [file-path]
+
+# Make minimal, focused edit
+edit [file-path] [oldString] [newString]
+```
+
+**Edit guidelines:**
+
+- Change only what's necessary
+- Add comment if non-obvious
+- Don't refactor adjacent code
+- Don't fix unrelated issues
+
+### Step 4: Verify (unless --no-test)
+
+```bash
+# Type check
+npm run type-check || tsc --noEmit
+
+# Run relevant tests
+npm test -- --testPathPattern="[related-test]" --passWithNoTests
+
+# Lint check
+npm run lint -- [file-path]
+```
+
+**All checks must pass before committing.**
+
+### Step 5: Commit (unless --no-commit)
+
+```bash
+git add [file-path]
+git commit -m "fix: [concise description]
+
+Quick-build: [task description]"
+```
+
+**Commit message format:**
+
+- `fix:` for bug fixes
+- `chore:` for maintenance
+- `docs:` for documentation
+- `style:` for formatting
+
+---
+
+## Escape Hatch
+
+If during work you realize it's more complex:
+
+```
+⚠ Complexity detected:
+- Multiple files need changes
+- Found related issues that need fixing
+- Discovered missing test coverage
+
+Escaping to structured workflow...
+```
+
+**Action:**
+
+1. Revert uncommitted changes: `git checkout -- .`
+2. Create proper bead: `/create $ARGUMENTS`
+3. Continue with full workflow
+
+**Don't force a complex change through quick-build.**
+
+---
+
+## Time Budget
+
+| Task Type      | Max Time | Example                      |
+| -------------- | -------- | ---------------------------- |
+| Typo/text fix  | 5 min    | Fix spelling in button label |
+| Config change  | 10 min   | Update timeout value         |
+| Simple bug fix | 15 min   | Fix null check               |
+| Style fix      | 10 min   | Fix CSS alignment            |
+| Doc update     | 15 min   | Update README section        |
+
+**If approaching 30 minutes: STOP and escalate to /create.**
+
+---
+
+## Output
+
+```
+Quick Build Complete
+━━━━━━━━━━━━━━━━━━━━
+
+Task: [description]
+File: [path]
+Time: [X minutes]
+
+Changes:
+- [summary of change]
+
+Verification:
+✓ Type check passed
+✓ Tests passed (3 specs)
+✓ Lint passed
+
+Commit: [sha] "fix: [message]"
+
+Done. No bead created (trivial task).
+```
+
+---
+
+## Rollback
+
+If the quick fix causes issues:
+
+```bash
+# Revert the commit
+git revert HEAD --no-edit
+
+# Or reset to before
+git reset --hard HEAD~1
+```
+
+---
+
+## Examples
+
+```bash
+# Fix a typo
+/quick-build fix typo in login button text
+
+# Update a constant
+/quick-build change MAX_RETRIES from 3 to 5
+
+# Fix null check
+/quick-build add null check in getUserName function
+
+# CSS fix
+/quick-build fix button alignment in header
+
+# Skip tests for doc-only change
+/quick-build update README installation instructions --no-test
+```
+
+---
+
+## Anti-Patterns
+
+| Don't                       | Why                | Do Instead            |
+| --------------------------- | ------------------ | --------------------- |
+| Quick-build multiple files  | Scope creep        | Use `/create`         |
+| Skip tests for code changes | Risk of regression | Always verify         |
+| Fix "one more thing"        | Scope creep        | Separate quick-build  |
+| Force complex through       | Technical debt     | Escalate to `/create` |
+| Quick-build without reading | May miss context   | Read file first       |
+
+---
+
+## Related Commands
+
+| Need            | Command                     |
+| --------------- | --------------------------- |
+| Structured task | `/create` then `/implement` |
+| Just exploring  | Read files directly         |
+| Multiple fixes  | `/create` with sub-tasks    |
+| Need planning   | `/new-feature`              |