opencodekit 0.12.2 → 0.12.3

package/dist/template/.opencode/command/fix-ci.md

@@ -1,325 +1,130 @@
 ---
-description: Analyze GitHub Actions logs and fix issues with bead tracking
-argument-hint: "<github-actions-url or run-id>"
+description: Fix CI failures
+argument-hint: "<run-id or url>"
 agent: build
 ---
 
 # Fix CI: $ARGUMENTS
 
-## Phase 1: Load Skills & Create Bead
+CI failures are P0 bugs. Fix fast.
 
-**Load skills:**
-
-```typescript
-skill({ name: "beads" }); // Session protocol
-skill({ name: "systematic-debugging" });
-skill({ name: "root-cause-tracing" });
-```
-
-**CI failures are P0 bugs.** Create bead immediately:
-
-```typescript
-bd_add({
-  title: "Fix CI: [failure summary]",
-  type: "bug",
-  pri: 0,
-  tags: ["ci", "bug"],
-});
-```
-
-**Reserve workflow files:**
-
-```typescript
-bd_reserve({
-  paths: [".github/workflows/**", "package.json", "tsconfig.json"],
-  reason: "Fixing CI: $ARGUMENTS",
-  ttl: 600,
-});
-```
-
-## Phase 2: Fetch CI Logs
-
-**From URL:**
-
-```bash
-# Extract run ID from URL
-# https://github.com/owner/repo/actions/runs/12345678
-gh run view 12345678 --log-failed
-```
-
-**From run ID:**
+## Get The Logs
 
 ```bash
+# From URL: extract run ID from https://github.com/owner/repo/actions/runs/12345
+# From run ID: use directly
 gh run view $ARGUMENTS --log-failed
 ```
 
-**List recent failed runs:**
+List recent failures:
 
 ```bash
 gh run list --status=failure --limit=5
 ```
 
-**Get full logs:**
+## Extract The Error
 
 ```bash
-gh run view $ARGUMENTS --log > /tmp/ci-log.txt
-```
-
-## Phase 3: Extract Errors
-
-Parse the CI log for errors:
-
-```bash
-# Find error lines
-grep -i "error\|failed\|exception" /tmp/ci-log.txt | head -30
-
 # Find the failing step
-gh run view $ARGUMENTS --json jobs --jq '.jobs[] | select(.conclusion=="failure") | {name, steps: [.steps[] | select(.conclusion=="failure")]}'
-```
-
-**Extract key information:**
+gh run view $ARGUMENTS --json jobs --jq '.jobs[] | select(.conclusion=="failure")'
 
-| Field             | Extract                        |
-| ----------------- | ------------------------------ |
-| **Failing job**   | Which job failed               |
-| **Failing step**  | Which step in the job          |
-| **Error message** | Exact error text               |
-| **Exit code**     | Process exit code if available |
-| **Context**       | Lines before/after error       |
-
-```
-CI Failure Analysis:
-━━━━━━━━━━━━━━━━━━━━
-
-Job: [job name]
-Step: [step name]
-Error: [error message]
-
-Context:
-[relevant log lines]
+# Get error context
+gh run view $ARGUMENTS --log > /tmp/ci-log.txt
+grep -i "error\|failed" /tmp/ci-log.txt | head -30
 ```
 
-## Phase 4: Identify Failure Pattern
+Identify:
 
-Common CI failure patterns:
+- **Job** that failed
+- **Step** in that job
+- **Error message** exact text
 
-| Pattern                  | Symptoms                           | Typical Fix                         |
-| ------------------------ | ---------------------------------- | ----------------------------------- |
-| **Dependency issue**     | "module not found", npm/yarn error | Update lockfile, check versions     |
-| **Environment mismatch** | Works locally, fails in CI         | Check Node/Python version, env vars |
-| **Test flakiness**       | Intermittent failures              | Add retries, fix race conditions    |
-| **Build timeout**        | Job cancelled after N minutes      | Optimize build, increase timeout    |
-| **Type error**           | TypeScript compilation failed      | Fix type errors locally first       |
-| **Lint error**           | ESLint/Prettier failures           | Run lint locally, fix issues        |
-| **Secret missing**       | "secret not found"                 | Check repository secrets config     |
-| **Permission denied**    | GITHUB_TOKEN issues                | Check workflow permissions          |
-| **Cache issue**          | Stale cache causing failures       | Clear cache, update cache key       |
-| **Docker issue**         | Image pull/build failures          | Check Dockerfile, registry auth     |
+## Common Patterns
 
-## Phase 5: Estimate Complexity
+| Pattern        | Symptoms                | Fix                                |
+| -------------- | ----------------------- | ---------------------------------- |
+| Dependency     | "module not found"      | `rm -rf node_modules && npm ci`    |
+| Environment    | Works locally, fails CI | Check Node version, env vars       |
+| Type error     | "tsc" failed            | `npm run type-check` locally first |
+| Lint error     | ESLint failed           | `npm run lint -- --fix`            |
+| Test flaky     | Intermittent            | Add retries, fix race condition    |
+| Secret missing | "secret not found"      | Check repo settings                |
 
-| Signals                             | Estimate | Approach           |
-| ----------------------------------- | -------- | ------------------ |
-| Single config change, obvious fix   | S (~10)  | Quick fix          |
-| Dependency update, env var fix      | M (~30)  | Systematic         |
-| Flaky tests, race conditions        | L (~100) | Deep investigation |
-| Workflow restructure, cross-cutting | XL       | Plan first         |
-
-## Phase 6: Reproduce Locally (if possible)
-
-Try to reproduce the failure locally:
+## Reproduce Locally
 
 ```bash
-# Run the same commands as CI
 npm ci
 npm run build
 npm test
 npm run lint
 ```
 
-If it passes locally but fails in CI:
-
-```bash
-# Check for environment differences
-node --version    # Compare to CI
-npm --version     # Compare to CI
-cat .nvmrc        # If exists
-```
-
-## Phase 7: Fix
-
-**For complex fixes (≥3 phases):**
-
-```typescript
-task({
-  subagent_type: "planner",
-  description: "Plan CI fix",
-  prompt: "Create implementation plan for fixing CI: [failure description]",
-});
-```
-
-Save plan to `.beads/artifacts/<bead-id>/spec.md`
-
-**Common fixes:**
+If passes locally but fails in CI, check environment differences.
 
-```bash
-# Dependency issues
-rm -rf node_modules package-lock.json
-npm install
-
-# Type errors
-npm run type-check  # Fix locally first
+## Fix And Verify
 
-# Lint errors
-npm run lint -- --fix
-
-# Cache issues (add to workflow)
-# - uses: actions/cache@v3
-#   with:
-#     key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
-```
-
-## Phase 8: Verify Locally
-
-Before pushing:
+Make the fix. Verify locally:
 
 ```bash
-npm run build
-npm test
-npm run lint
-npm run type-check
+npm run build && npm test && npm run lint && npm run type-check
 ```
 
-All must pass locally.
-
-## Phase 9: Push & Re-trigger CI
+## Push And Watch
 
 ```bash
 git add <files>
-git commit -m "fix(ci): <description>
+git commit -m "fix(ci): [description]
 
-Root cause: [what was wrong]
-<bead-id>"
+Root cause: [brief]"
 
 git push
-```
 
-**Re-trigger CI:**
-
-```bash
-gh workflow run <workflow-name>
-# or
-gh run rerun $ARGUMENTS --failed
-```
-
-**Watch CI status:**
-
-```bash
+# Watch the new run
 gh run watch
 ```
 
-```
-CI Verification:
-━━━━━━━━━━━━━━━━
-
-Run ID: [new run id]
-Status: [pending/success/failure]
-URL: [run url]
-```
-
-## Phase 10: Handle Results
-
-**If CI passes:**
-
-```typescript
-observation({
-  type: "bugfix",
-  title: "CI fix: [summary]",
-  content: `
-## Root Cause
-[What was actually wrong]
-
-## Fix
-[What we changed]
-
-## Prevention
-[How to avoid in future]
-  `,
-  concepts: "ci, github-actions, [specific issue]",
-  bead_id: "<bead-id>",
-});
-
-bd_done({ id: "<bead-id>", msg: "CI fixed: [summary]" });
-```
-
-**If CI still fails:**
+## If Still Failing
 
 Iterate:
 
 1. Fetch new logs
-2. Identify new/remaining error
+2. Identify remaining error
 3. Fix and push again
-4. Maximum 3 iterations before escalating
+4. Max 3 iterations, then escalate
 
-**If fix makes things worse:**
+If fix makes things worse:
 
 ```bash
 git revert HEAD
 git push
 ```
 
-Then reassess approach.
+## Document
 
-## Phase 11: Update Memory
-
-If this was a recurring CI issue:
+If it's a recurring issue:
 
 ```typescript
-memory -
-  update({
-    file: "project/gotchas",
-    content: `
-## CI: [Issue Title]
-
-**Symptom:** [What you see in CI logs]
-**Cause:** [Root cause]
-**Fix:** [How to resolve]
-**Prevention:** [Config to prevent recurrence]
-  `,
-    mode: "append",
-  });
+observation({
+  type: "bugfix",
+  title: "CI: [issue]",
+  content: "Root cause: [what]\nFix: [how]\nPrevention: [future]",
+});
 ```
 
-## Phase 12: Sync & Report
+## Sync
 
 ```typescript
-bd_release({ _: true });
-bd_sync({ reason: "Fixed CI: $ARGUMENTS" });
+bd_sync({ reason: "Sync CI fix" });
 ```
 
+## Output
+
 ```
 CI Fixed: $ARGUMENTS
-━━━━━━━━━━━━━━━━━━━━
 
-Estimate: [S/M/L]
-Root cause: [brief description]
-Pattern: [which common pattern]
+Root cause: [brief]
+Changes: [files]
 
-Changes:
-- [file] - [change]
-
-CI Run: [new run URL]
+New run: [url]
 Status: Passed ✓
-
-Observation: Created ✓
-Gotcha: [Added/Not needed]
-
-Commit: [hash]
 ```
-
-## Notes
-
-- If `gh` CLI is not available: `brew install gh && gh auth login`
-- If fix reveals systemic issues, create follow-up beads
-- For flaky tests, consider adding retry logic or fixing race conditions
-- Check if same failure happened before: `gh run list --status=failure --limit=20`