opencodekit 0.20.1 → 0.20.3

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

@@ -8,9 +8,9 @@ agent: build
 
 Execute PRD tasks, verify each passes, run review, close the bead.
 
-> **Workflow:** `/create` → `/start <id>` → **`/ship <id>`**
+> **Workflow:** `/create` → **`/ship <id>`**
 >
-> Bead MUST be `in_progress` with `prd.md`. Run `/start` first if not.
+> Bead MUST have `prd.md`. If not yet claimed, `/ship` auto-claims it.
 
 ## Load Skills
 
@@ -48,19 +48,84 @@ skill({ name: "verification-before-completion" });
 
 ## Phase 1: Guards
 
+### Memory Grounding
+
+Search memory for context, prior decisions, and known issues before executing:
+
+```typescript
+memory-search({ query: "$ARGUMENTS" });
+memory-search({ query: "<bead title keywords>", limit: 5 });
+memory-read({ file: "handoffs/last" });
+```
+
+Use findings to avoid re-discovering known issues or repeating failed approaches.
+
+### Bead Validation
+
 ```bash
 br show $ARGUMENTS
 ```
 
 Verify:
 
-- Bead status is `in_progress` (if not, tell user to run `/start $ARGUMENTS`)
+- Bead is `in_progress` or unclaimed (auto-claim if needed)
 - `.beads/artifacts/$ARGUMENTS/prd.md` exists (if not, tell user to run `/create` first)
 
 Check what artifacts exist:
 
 Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
 
+## Phase 1B: Auto-Claim (if not yet in_progress)
+
+If bead status is NOT `in_progress`, auto-claim it:
+
+```bash
+br update $ARGUMENTS --status in_progress
+```
+
+Then ask about workspace:
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Workspace",
+      question: "How do you want to set up the workspace?",
+      options: [
+        {
+          label: "Create feature branch (Recommended)",
+          description: "git checkout -b feat/<bead-id>-<title>",
+        },
+        {
+          label: "Use current branch",
+          description: "Work on current branch",
+        },
+      ],
+    },
+  ],
+});
+```
+
+**If feature branch selected:**
+
+Map bead type to branch prefix:
+
+| Bead Type | Branch Prefix |
+| --------- | ------------- |
+| feature   | feat          |
+| bug       | fix           |
+| task      | task          |
+| epic      | epic          |
+
+```bash
+# Example: feat/br-42-add-auth
+git checkout -b $PREFIX/$BEAD_ID-$TITLE_SLUG
+```
+
+**If current branch:** Continue without branch creation.
+
+**If bead is already `in_progress`:** Skip this phase entirely.
+
 ## Phase 2: Route to Execution
 
 | Artifact exists | Action                                                   |
@@ -333,8 +398,7 @@ Report:
 
 ## Related Commands
 
-| Need        | Command       |
-| ----------- | ------------- |
-| Create spec | `/create`     |
-| Claim task  | `/start <id>` |
-| Create PR   | `/pr`         |
+| Need        | Command   |
+| ----------- | --------- |
+| Create spec | `/create` |
+| Create PR   | `/pr`     |

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

@@ -99,7 +99,7 @@ Based on gathered state, recommend ONE next step:
 | State                        | Suggestion                    |
 | ---------------------------- | ----------------------------- |
 | Has in_progress tasks        | `/ship <id>` (continue work)  |
-| Has ready tasks, none active | `/start <id>` (pick up work)  |
+| Has ready tasks, none active | `/ship <id>` (pick up work)   |
 | Uncommitted changes          | Review and commit             |
 | Nothing active or ready      | `/create "<desc>"` (new work) |
 

package/dist/template/.opencode/command/ui-review.md

@@ -88,5 +88,4 @@ observation({
 | Need                 | Command   |
 | -------------------- | --------- |
 | Design from scratch  | `/design` |
-| Start implementation | `/start`  |
 | Ship implementation  | `/ship`   |

package/dist/template/.opencode/command/ui-slop-check.md

@@ -143,4 +143,4 @@ observation({
 | ---------------------------------------- | ------------ |
 | Design from scratch                      | `/design`    |
 | Full UI review (single screen/component) | `/ui-review` |
-| Implementation work                      | `/start`     |
+| Implementation work                      | `/ship`      |

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

@@ -149,7 +149,17 @@ Output:
 5. **Blocking issues** to fix before shipping
 6. **Next step**: `/ship $ARGUMENTS` if ready, or list fixes needed
 
-Record significant findings with `observation()`.
+Record significant findings with `observation()`:
+
+```typescript
+observation({
+  type: "discovery", // or "warning", "bugfix"
+  title: "Verify: [bead-id] [key finding]",
+  narrative: "[What was found, impact, resolution]",
+  concepts: "verification, [component]",
+  confidence: "high",
+});
+```
 
 ## Related Commands
 

package/dist/template/.opencode/dcp.jsonc

@@ -24,11 +24,11 @@
 	},
 	// Glob patterns for files that should never be auto-pruned
 	// Keep tight: broad patterns reduce DCP effectiveness
+	// .opencode/** and .beads/** removed — memory-* and tilth_* outputs
+	// already survive compression via compress.protectedTools
 	"protectedFilePatterns": [
 		"**/.env*",
 		"**/AGENTS.md",
-		"**/.opencode/**",
-		"**/.beads/**",
 		"**/package.json",
 		"**/tsconfig.json"
 	],
@@ -43,34 +43,41 @@
 		// v3.1.0: active summary tokens extend effective maxContextLimit
 		"summaryBuffer": true,
 		// Soft upper threshold: above this, strong compression nudges fire
-		// Accepts number or "X%" of model context window
-		"maxContextLimit": "80%",
+		// Use numeric values — percentage requires modelContextLimit from runtime
+		// which may be unavailable for some provider/model combos (e.g. GitHub Copilot)
+		// Rule: must be BELOW OpenCode emergency threshold (model_max - reserved - max_output)
+		// For Copilot Claude (216k ctx, 64k out, 16k reserved): emergency = 136k
+		// So DCP must start compressing well before 136k
+		"maxContextLimit": 100000,
 		// Per-model override for maxContextLimit (takes priority over global)
-		// Aligned to claude-opus-4.6 (216k context, 64k output) as primary build agent
 		"modelMaxLimits": {
-			"github-copilot/claude-opus-4.6": 192000,
-			"github-copilot/claude-opus-4.5": 192000,
-			"github-copilot/claude-sonnet-4.6": 192000,
-			"github-copilot/claude-sonnet-4.5": 192000,
-			"github-copilot/claude-sonnet-4": 192000,
-			"github-copilot/claude-haiku-4.5": 172000,
-			"github-copilot/gpt-5.4": 192000,
-			"github-copilot/gpt-5.3-codex": 192000,
-			"github-copilot/gemini-3.1-pro-preview": 192000
+			// Claude: 216k ctx, 64k out → emergency at 136k → DCP starts at 110k
+			"github-copilot/claude-opus-4.6": 110000,
+			"github-copilot/claude-opus-4.5": 110000,
+			"github-copilot/claude-sonnet-4.6": 110000,
+			"github-copilot/claude-sonnet-4.5": 110000,
+			"github-copilot/claude-sonnet-4": 110000,
+			// Haiku: smaller model, be more conservative
+			"github-copilot/claude-haiku-4.5": 90000,
+			// GPT/Gemini: assume similar 200k+ windows
+			"github-copilot/gpt-5.4": 110000,
+			"github-copilot/gpt-5.3-codex": 110000,
+			"github-copilot/gemini-3.1-pro-preview": 110000
 		},
 		// Soft lower threshold: below this, turn/iteration reminders are off
-		"minContextLimit": "35%",
+		// Use numeric values — same reason as maxContextLimit above
+		"minContextLimit": 50000,
 		// Per-model override for minContextLimit (takes priority over global)
 		"modelMinLimits": {
-			"github-copilot/claude-opus-4.6": "30%",
-			"github-copilot/claude-opus-4.5": "35%",
-			"github-copilot/claude-sonnet-4.6": "35%",
-			"github-copilot/claude-sonnet-4.5": "35%",
-			"github-copilot/claude-sonnet-4": "35%",
-			"github-copilot/claude-haiku-4.5": "25%",
-			"github-copilot/gpt-5.4": "30%",
-			"github-copilot/gpt-5.3-codex": "30%",
-			"github-copilot/gemini-3.1-pro-preview": "30%"
+			"github-copilot/claude-opus-4.6": 65000,
+			"github-copilot/claude-opus-4.5": 65000,
+			"github-copilot/claude-sonnet-4.6": 65000,
+			"github-copilot/claude-sonnet-4.5": 65000,
+			"github-copilot/claude-sonnet-4": 65000,
+			"github-copilot/claude-haiku-4.5": 50000,
+			"github-copilot/gpt-5.4": 65000,
+			"github-copilot/gpt-5.3-codex": 65000,
+			"github-copilot/gemini-3.1-pro-preview": 65000
 		},
 		// How often context-limit nudge fires above maxContextLimit (1 = every fetch)
 		"nudgeFrequency": 5,