opencodekit 0.18.2 → 0.18.3

package/dist/template/.opencode/package.json

@@ -11,7 +11,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.2.15"
+    "@opencode-ai/plugin": "1.2.19"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",

package/dist/template/.opencode/plugin/lib/memory-helpers.ts

@@ -48,6 +48,8 @@ export const MAX_PROJECT_FILE_CHARS = 900;
 export const MAX_HANDOFF_CHARS = 2500;
 export const MAX_BEADS = 8;
 export const MAX_COMBINED_CONTEXT_CHARS = 10000;
+const BEADS_DB_READ_ATTEMPTS = 3;
+const BEADS_DB_RETRY_DELAY_MS = 500;
 
 // ============================================================================
 // Compaction Helpers
@@ -122,24 +124,57 @@ export async function readLatestHandoff(handoffDir: string): Promise<string> {
 	return `Source: ${latest.name}\n${truncate(content, MAX_HANDOFF_CHARS)}`;
 }
 
-export function readInProgressBeads(directory: string): string {
+function delay(ms: number): Promise<void> {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export async function readInProgressBeads(directory: string): Promise<string> {
 	const dbPath = path.join(directory, ".beads", "beads.db");
-	let db: Database | undefined;
-	try {
-		db = new Database(dbPath, { readonly: true });
-		const rows = db
-			.query<{ id: string; title: string }, [number]>(
-				"SELECT id, title FROM issues WHERE status = 'in_progress' ORDER BY updated_at DESC LIMIT ?",
-			)
-			.all(MAX_BEADS);
-		return rows.length > 0
-			? rows.map((r) => `- ${r.id}: ${r.title}`).join("\n")
-			: "";
-	} catch {
-		return "";
-	} finally {
-		db?.close();
+
+	for (let attempt = 0; attempt < BEADS_DB_READ_ATTEMPTS; attempt++) {
+		let db: Database | undefined;
+		try {
+			db = new Database(dbPath, { readonly: true });
+			const rows = db
+				.query<{ id: string; title: string }, [number]>(
+					"SELECT id, title FROM issues WHERE status = 'in_progress' ORDER BY updated_at DESC LIMIT ?",
+				)
+				.all(MAX_BEADS);
+			return rows.length > 0
+				? rows.map((r) => `- ${r.id}: ${r.title}`).join("\n")
+				: "";
+		} catch (error) {
+			const code = String((error as { code?: string } | undefined)?.code ?? "");
+			const message = String(
+				(error as { message?: string } | undefined)?.message ?? error,
+			);
+			const isRetryable =
+				code.includes("SQLITE_BUSY") ||
+				code.includes("SQLITE_LOCKED") ||
+				message.includes("SQLITE_BUSY") ||
+				message.includes("SQLITE_LOCKED");
+
+			if (isRetryable && attempt < BEADS_DB_READ_ATTEMPTS - 1) {
+				await delay(BEADS_DB_RETRY_DELAY_MS);
+				continue;
+			}
+
+			if (isRetryable) {
+				console.warn(
+					`[memory] Failed to read beads.db after ${BEADS_DB_READ_ATTEMPTS} attempts: ${message}`,
+				);
+			} else {
+				console.warn(
+					`[memory] Failed to read beads.db, continuing without bead context: ${message}`,
+				);
+			}
+			return "";
+		} finally {
+			db?.close();
+		}
 	}
+
+	return "";
 }
 
 // ============================================================================

package/dist/template/.opencode/plugin/lib/memory-hooks.ts

@@ -180,7 +180,7 @@ export function createHooks(deps: HookDeps) {
 				readLatestHandoff(handoffDir),
 			]);
 
-			const beadsContext = readInProgressBeads(directory);
+			const beadsContext = await readInProgressBeads(directory);
 
 			// Add relevant observations for session
 			let knowledgeContext = "";

package/dist/template/.opencode/skill/beads/references/TROUBLESHOOTING.md

@@ -11,3 +11,28 @@
 
 - Run `br doctor` to repair database
 - Check git remote access
+
+## Database Lock / WAL Conflicts
+
+**Symptoms:**
+
+- `SQLITE_BUSY` or `SQLITE_LOCKED` errors when reading beads
+- Stale `.beads/beads.db-wal` or `.beads/beads.db-journal` files after agent crash
+
+**Cause:**
+Agent interruption during bead operations can leave WAL/journal files in an inconsistent state.
+
+**Fix:**
+
+1. Ensure no agents are actively writing to beads.db
+2. Remove stale lock files:
+   ```bash
+   rm -f .beads/beads.db-wal .beads/beads.db-journal
+   ```
+3. Run `br sync --flush-only` to rebuild from JSONL source of truth
+4. Verify: `br ready` should work without errors
+
+**Prevention:**
+
+- The memory plugin now retries bead.db reads automatically (3 attempts, 500ms delay)
+- If persistent, check for zombie agent processes: `ps aux | grep opencode`

package/dist/template/.opencode/skill/using-git-worktrees/SKILL.md

@@ -110,6 +110,32 @@ git worktree add "$path" -b "$BRANCH_NAME"
 cd "$path"
 ```
 
+## Worktree Tracking
+
+After creating a worktree, persist its absolute path for session resume:
+
+```bash
+# After creating worktree
+mkdir -p .beads/artifacts/$BEAD_ID
+echo "/absolute/path/to/worktree" > .beads/artifacts/$BEAD_ID/worktree.txt
+```
+
+On session resume, restore the active worktree if tracking exists:
+
+```bash
+# Check if worktree exists for active bead
+if [ -f .beads/artifacts/$BEAD_ID/worktree.txt ]; then
+  WORKTREE_PATH=$(cat .beads/artifacts/$BEAD_ID/worktree.txt)
+  cd "$WORKTREE_PATH"
+fi
+```
+
+On worktree cleanup (after merge), remove the tracking file:
+
+```bash
+rm -f .beads/artifacts/$BEAD_ID/worktree.txt
+```
+
 ### 3. Run Project Setup
 
 Auto-detect and run appropriate setup:

package/dist/template/.opencode/skill/verification-before-completion/references/VERIFICATION_PROTOCOL.md

@@ -0,0 +1,67 @@
+# Verification Protocol
+
+## Standard Gates
+
+Run these gates in parallel where possible:
+
+### Parallel Group (independent — run simultaneously)
+
+```bash
+# Gate 1: Typecheck
+npm run typecheck 2>&1 &
+PID_TC=$!
+
+# Gate 2: Lint (incremental when possible)
+# Full codebase:
+npm run lint 2>&1 &
+# Or incremental (changed files only):
+# npx oxlint $(git diff --name-only --diff-filter=d HEAD | grep -E '\.(ts|tsx|js|jsx)$')
+PID_LINT=$!
+
+wait $PID_TC $PID_LINT
+```
+
+### Sequential Group (depends on parallel group passing)
+
+```bash
+# Gate 3: Tests (incremental when possible)
+# Full: npm test
+# Incremental: npx vitest --changed
+npm test
+
+# Gate 4: Build (only if shipping)
+npm run build
+```
+
+## Incremental Mode
+
+Use incremental mode when:
+
+- Only a few files changed (< 20 files)
+- Not shipping/releasing (pre-commit, mid-development)
+
+| Gate      | Full Command        | Incremental Command                        |
+| --------- | ------------------- | ------------------------------------------ |
+| Typecheck | `npm run typecheck` | `npm run typecheck` (always full — needed) |
+| Lint      | `npm run lint`      | `npx oxlint $(git diff --name-only HEAD)`  |
+| Test      | `npm test`          | `npx vitest --changed`                     |
+| Build     | `npm run build`     | Skip (only needed for ship/release)        |
+
+## Gate Results Format
+
+Report results as:
+
+```text
+| Gate      | Status | Time   |
+|-----------|--------|--------|
+| Typecheck | PASS   | 2.1s   |
+| Lint      | PASS   | 0.8s   |
+| Test      | PASS   | 5.3s   |
+| Build     | SKIP   | —      |
+```
+
+## Failure Handling
+
+- If any gate fails, stop and fix before proceeding
+- Show the FULL error output for failed gates
+- After fixing, re-run ONLY the failed gate(s) + any downstream gates

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.18.2",
+	"version": "0.18.3",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": [
 		"agents",