opencodekit 0.16.15 → 0.16.18

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

@@ -1,303 +1,133 @@
 ---
 description: Create and submit pull request with bead traceability
-argument-hint: "<bead-id> [--draft] [--wait]"
+argument-hint: "[bead-id] [--draft]"
 agent: build
 ---
 
 # Pull Request
 
-**Load skills:**
+## Load Skills
 
 ```typescript
-skill({ name: "beads" }); // Session protocol
+skill({ name: "beads" });
 skill({ name: "verification-before-completion" });
-skill({ name: "memory-system" });
 ```
 
-## Check Memory for Related Context
+## Parse Arguments
 
-Search for related decisions and patterns:
-
-```typescript
-// Find related decisions and patterns for this work
-memory_search({ query: "$ARGUMENTS [feature keywords]", limit: 3 });
-
-// Find any gotchas related to this area
-memory_search({ query: "[affected files/modules] gotchas", limit: 2 });
-```
-
-Include relevant context from memory in PR description.
-
-## Options
-
-- `--draft`: Create as draft PR (for WIP or early feedback)
-- `--wait`: Wait for CI checks to pass after creation
+| Argument    | Default  | Description        |
+| ----------- | -------- | ------------------ |
+| `<bead-id>` | optional | Link PR to bead    |
+| `--draft`   | false    | Create as draft PR |
 
 ## Phase 1: Pre-PR Verification
 
-Before creating PR, run verification gates:
-
-```
-!`git status --porcelain`  # Check for uncommitted changes
-```
-
-If uncommitted changes exist, ask: "Commit these changes first?"
-
-Run project gates:
-
-```
-!`npm run build 2>&1 | tail -5`
-!`npm test 2>&1 | tail -10`
-!`npm run lint 2>&1 | tail -5`
-```
-
-```
-Pre-PR Gates:
-━━━━━━━━━━━━━
-
-Build: [✓/✗]
-Tests: [✓/✗]
-Lint:  [✓/✗]
-```
-
-**If any gate fails: STOP.**
-
-```
-Cannot create PR: [gate] failed.
-
-Fix errors first, then run /pr again.
-```
-
-## Phase 2: Check for Conflicts
-
-```
-!`git fetch origin main`
-!`git merge-base --is-ancestor origin/main HEAD || git diff origin/main...HEAD --name-only`
+```bash
+git status --porcelain
 ```
 
-Check for merge conflicts:
+If uncommitted changes exist, ask whether to commit first.
 
-```
-!`git merge --no-commit --no-ff origin/main 2>&1 || true`
-!`git merge --abort 2>/dev/null || true`
-```
+Run verification gates. Detect project type and use the appropriate commands:
 
-If conflicts detected:
+| Project Type    | Detect Via                    | Build            | Test            | Lint                          | Typecheck                             |
+| --------------- | ----------------------------- | ---------------- | --------------- | ----------------------------- | ------------------------------------- |
+| Node/TypeScript | `package.json`                | `npm run build`  | `npm test`      | `npm run lint`                | `npm run typecheck` or `tsc --noEmit` |
+| Rust            | `Cargo.toml`                  | `cargo build`    | `cargo test`    | `cargo clippy -- -D warnings` | (included in build)                   |
+| Python          | `pyproject.toml` / `setup.py` | —                | `pytest`        | `ruff check .`                | `mypy .`                              |
+| Go              | `go.mod`                      | `go build ./...` | `go test ./...` | `golangci-lint run`           | (included in build)                   |
 
-```
-⚠️  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
-```
+Check `package.json` scripts, `Makefile`, or `justfile` for project-specific commands first — prefer those over generic defaults.
 
-## Phase 3: Gather Context
+If any gate fails, stop. Fix errors first, then run `/pr` again.
 
-**Current state:**
+## Phase 2: Gather Context
 
-```
-!`git branch --show-current`
-!`git diff main...HEAD --stat`
-!`git log main...HEAD --oneline`
-```
-
-**Load bead context (if provided):**
-
-```
-!`br show $ARGUMENTS`
+```bash
+git branch --show-current
+git log main...HEAD --oneline
+git diff main...HEAD --stat
 ```
 
-**Load artifacts:**
+If bead ID provided:
 
+```bash
+br show $ARGUMENTS
+ls .beads/artifacts/$ARGUMENTS/
 ```
-!`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: Review Before Push
+Read the PRD to extract goal and success criteria for the PR description.
 
-Show what will be pushed:
+## Phase 3: Push and Confirm
 
-```bash
-git log origin/$(git branch --show-current)..HEAD --oneline 2>/dev/null || git log --oneline -5
-git diff --stat origin/$(git branch --show-current)..HEAD 2>/dev/null || git diff --stat HEAD~3..HEAD
-```
-
-**Use question tool to get push/PR decision:**
+Show what will be pushed and ask the user:
 
 ```typescript
 question({
   questions: [
     {
       header: "Push",
-      question: "Ready to push and create PR for $ARGUMENTS. What should I do?",
+      question: "Ready to push and create PR. Proceed?",
       options: [
-        {
-          label: "Push & create PR (Recommended)",
-          description: "Push branch and create PR",
-        },
+        { label: "Push & create PR (Recommended)", description: "Push branch and create PR" },
         { label: "Push & draft PR", description: "Create as draft for review" },
-        {
-          label: "Show diff first",
-          description: "Review changes before pushing",
-        },
-        {
-          label: "Skip (I'll push manually)",
-          description: "Handle PR creation manually",
-        },
+        { label: "Show diff first", description: "Review changes before pushing" },
       ],
     },
   ],
 });
 ```
 
-If user confirms, push:
+If confirmed:
 
 ```bash
 git push -u origin $(git branch --show-current)
 ```
 
-## Phase 5: Create PR
-
-Generate PR content from context:
+## Phase 4: Create PR
 
 ```bash
-gh pr create --title "<title>" --body "$(cat <<'EOF'  # Keep as instructional (multi-line)
+gh pr create --title "<title>" --body "$(cat <<'EOF'
 ## Summary
 
-[1-2 sentence description of what this PR does and why]
+[1-2 sentences: what this PR does and why]
 
 ## Changes
 
-| File | Change |
-| ---- | ------ |
-| `src/foo.ts` | [description] |
-| `src/bar.ts` | [description] |
+- `file.ts`: [what changed]
+- `other.ts`: [what changed]
 
 ## Testing
 
-**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%] |
+- All tests pass
+- Lint and typecheck pass
+- Manual verification: [how to test]
 
 ## 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 "..."  # Keep as-is (instructional)
-```
-
-## Phase 6: Wait for CI (if --wait)
-
-```
-!`gh pr checks --watch`
-```
-
-Report CI status:
+If `--draft`, add `--draft` flag.
 
-```
-CI Status:
-━━━━━━━━━━
-
-- build: [✓/✗/pending]
-- test: [✓/✗/pending]
-- lint: [✓/✗/pending]
-
-[If all pass] CI passed ✓
-[If any fail] CI failed: [which check]
-```
-
-## Phase 7: Update Bead & Sync
-
-```bash
-br sync --flush-only
-```
+If bead ID provided, add artifacts section linking to `.beads/artifacts/$ARGUMENTS/prd.md`.
 
 ## Output
 
-```
-PR Created: <bead-id>
-━━━━━━━━━━━━━━━━━━━━
+Report:
 
-URL: <pr-url>
-Status: [Ready for Review / Draft]
-Branch: <branch> → main
+1. PR URL
+2. Status (Ready for Review / Draft)
+3. Branch → main
+4. Gate results
 
-Pre-PR Gates: All passed ✓
-Conflicts: None ✓
-[CI: Passed ✓ (if --wait)]
-
-Artifacts linked:
-- spec.md ✓
-- review.md ✓
-[- research.md, plan.md, adr.md]
-```
+## Related Commands
 
-**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
-```
+| Need         | Command        |
+| ------------ | -------------- |
+| Ship first   | `/ship <id>`   |
+| Verify first | `/verify <id>` |