opencodekit 0.12.6 → 0.13.0

package/dist/template/.opencode/memory/project/commands.md

@@ -1,6 +1,6 @@
 ---
 purpose: Build, test, lint, deploy commands discovered for this project
-updated: 2025-01-05
+updated: 2025-01-06
 ---
 
 # Project Commands
@@ -8,190 +8,46 @@ updated: 2025-01-05
 ## Build
 
 ```bash
-npm run type-check    # TypeScript type checking only (no emit)
+npm run build       # Bundles src/index.ts + copies .opencode/ to dist/template/
+npm run typecheck   # TypeScript type checking only (no emit)
 ```
 
 ## Test
 
 ```bash
-pytest tests/ -v                    # Run all Python tests
-pytest tests/test_specific.py -v    # Run single test file
-pytest tests/ --cov=. --cov-report=html  # Coverage report
+bun test                        # Run all tests
+bun test src/commands/init.ts   # Run single test file
+bun test --watch                # Watch mode
 ```
 
 ## Lint
 
-<!-- npm run lint, ruff check, etc. -->
-
-## Deploy
-
-<!-- Deployment commands if applicable -->
-
-## OpenCode Configuration
-
-### Environment Variables
-
 ```bash
-OPENCODE_EXPERIMENTAL=true              # Enable experimental features (LSP, batch)
-OPENCODE_EXPERIMENTAL_LSP_TOOL=true     # Enable built-in LSP navigation tool
-OPENCODE_DISABLE_LSP_DOWNLOAD=true      # Skip auto-downloading LSP servers
-OPENCODE_DISABLE_AUTOCOMPACT=true       # Disable automatic session compaction
-OPENCODE_DISABLE_PRUNE=true             # Disable DCP pruning
+npm run lint        # Check with Biome
+npm run lint:fix    # Auto-fix issues
 ```
 
-### Configuration File Priorities
-
-1. Global: `~/.config/opencode/opencode.json` or `dcp.jsonc`
-2. Config Dir: `$OPENCODE_CONFIG_DIR/opencode.json`
-3. Project: `.opencode/opencode.json` (highest priority)
+## Development
 
-### DCP Nudge Tuning
-
-```jsonc
-// Lower nudgeFrequency = more aggressive pruning suggestions
-"nudgeFrequency": 8    // LLM nudged every 8 tool calls (default: 10)
+```bash
+bun run src/index.ts            # Run CLI directly
+npm run dev                     # Same as above
+bun build src/index.ts --compile --outfile ock  # Compile to binary
 ```
 
-## Beads CLI (Core)
-
-The `bd` command is your issue tracker. JSONL is source of truth, SQLite is cache.
-
-### Essential Commands
+## Beads (Task Tracking)
 
 ```bash
-bd ready                              # Unblocked tasks (use this to find work)
+bd ready                              # Find unblocked tasks
 bd list --status=open                 # All open issues
 bd show <id>                          # Full details
-bd create "Title" -t task -p 2        # Create (type: task/bug/feature/epic, priority: 0-4)
+bd create "Title" -t task -p 2        # Create task
 bd update <id> --status in_progress   # Claim work
 bd close <id> --reason "Done"         # Complete
-bd sync                               # Export/commit/push (always run at session end)
-```
-
-### Dependencies
-
-```bash
-bd dep add <child> <parent> --type blocks   # Child blocked until parent closes
-bd dep tree <id>                            # Visualize dependency chain
-bd blocked                                  # Show all blocked issues
+bd sync                               # Sync with git (always run at session end)
 ```
 
-### Coordination
-
-```bash
-bd list --status in_progress          # See what's claimed by others
-git pull && bd import                 # Get latest from team
-bd sync                               # Push your changes
-```
-
-### Priority Levels
-
-- **P0** - Critical (security, data loss)
-- **P1** - High (major features, important bugs)
-- **P2** - Medium (default)
-- **P3** - Low
-- **P4** - Backlog
-
-### Sandbox Mode
-
-If running in restricted environment (Claude Code, etc.):
-
-```bash
-bd --sandbox ready
-# Or: bd --no-daemon --no-auto-flush --no-auto-import list
-```
-
-## Beads Plugin Tools (For OpenCode Agents)
-
-This project's plugin (`.opencode/plugin/beads.ts`) provides typed tools that wrap the CLI.
-
-### Session Lifecycle
-
-```typescript
-bd_init({ role: "build" }); // Join workspace - MUST call first
-bd_claim(); // Get next ready task, mark in_progress
-bd_reserve({ paths: ["src/foo.ts"] }); // Lock files before editing
-// ... do work ...
-bd_done({ id: "bd-xxx", msg: "Done" }); // Close + release locks + sync
-```
-
-### Task Management
-
-```typescript
-bd_add({ title: "Task", pri: 2, type: "task" }); // Create issue
-bd_show({ id: "bd-xxx" }); // Get full details
-bd_ls({ status: "open", limit: 10 }); // List issues
-bd_ready(); // Ready-to-work tasks
-bd_update({ id: "bd-xxx", status: "in_progress" }); // Update issue
-bd_search({ query: "auth" }); // Search issues
-```
-
-### File Locking (Plugin-Only)
-
-```typescript
-bd_reserve({ paths: ["src/a.ts", "src/b.ts"], ttl: 600 }); // Lock files
-bd_reservations(); // List active locks
-bd_release({ paths: ["src/a.ts"] }); // Release specific
-bd_release(); // Release all
-```
-
-### Messaging (Plugin-Only)
-
-```typescript
-bd_msg({ subj: "Done", to: "all", global: true }); // Broadcast
-bd_inbox({ n: 5, unread: true }); // Check messages
-bd_ack({ ids: ["msg-abc", "msg-def"] }); // Mark messages as read
-```
-
-### Agent Coordination (Plugin-Only)
-
-```typescript
-bd_whois(); // See all agents and their current work
-bd_whois({ agent: "build-abc" }); // Lookup specific agent
-```
-
-### Maintenance
-
-```typescript
-bd_sync(); // Sync with git
-bd_status({ include_agents: true }); // Workspace overview
-bd_doctor(); // Check database health
-bd_cleanup({ days: 7 }); // Remove old closed issues
-```
-
-## Beads Workflow
-
-### Start Work
-
-```bash
-bd ready                              # Find unblocked task
-bd update bd-xxx --status in_progress # Claim it
-git checkout -b bd-xxx                # Create branch
-```
-
-### During Work
-
-```bash
-git commit -m "WIP: bd-xxx - [progress]"  # Checkpoint commits
-bd sync                                    # Sync beads state
-```
-
-### End Session
-
-```bash
-git add -A && git commit -m "bd-xxx: [summary]"
-bd close bd-xxx --reason "Completed: [what]"
-bd sync
-git push
-```
-
-### Handoff (If Not Finishing)
-
-```bash
-git commit -m "WIP: bd-xxx - [where stopped]"
-# Create handoff in .beads/artifacts/bd-xxx/handoffs/
-bd sync
-git push
-```
+## CI/CD
 
-Resume later with: `/resume bd-xxx`
+- GitHub Actions workflow at `.github/workflows/opencode.yml`
+- Triggered by `/oc` or `/opencode` comments on issues/PRs

package/dist/template/.opencode/memory/session-context.md

@@ -0,0 +1,40 @@
+---
+purpose: Session continuity state that survives compaction
+updated: 2025-01-08
+---
+
+# Session Context
+
+<!--
+Agent-maintained via memory-update tool.
+Update when: goal changes, key decision made, state shifts, uncertainty discovered.
+After compaction: read this file, ask 1-3 targeted questions if gaps exist.
+-->
+
+## Goal
+
+<!-- What we're trying to achieve + success criteria -->
+
+## Constraints
+
+<!-- User-specified limits, discovered guardrails. Mark UNCONFIRMED if inferred -->
+
+## Decisions
+
+<!-- Key choices made this session with brief rationale -->
+
+## State
+
+- **Done**:
+- **Now**:
+- **Next**:
+
+## Open Questions
+
+<!-- Uncertainties - mark UNCONFIRMED if not verified -->
+
+## Working Set
+
+- **Files**:
+- **Bead**:
+- **Branch**:

package/dist/template/.opencode/memory/user.md

@@ -1,21 +1,38 @@
 ---
 purpose: User identity, preferences, communication style
-updated: 2024-12-21
+updated: 2025-01-06
 ---
 
 # User Profile
 
 ## Identity
-<!-- Name, role, git contributor identity -->
+
+- Name: huynhgiabuu
+- Git email: buub1309120@gmail.com
 
 ## Communication Preferences
-<!-- Concise vs detailed, tone preferences -->
+
+- Style: Detailed responses preferred
+- Explanations welcome when helpful
 
 ## Workflow Preferences
-<!-- Preferred tools, testing habits, review style -->
+
+- Git commits: Ask first before committing
+- Beads updates: Ask first before modifying task state
+- Auto-actions: Disabled - always confirm before state changes
 
 ## Technical Preferences
-<!-- Languages, frameworks, patterns they favor -->
 
-## Things to Remember
-<!-- Personal quirks, pet peeves, preferences learned -->
+- Runtime: Bun
+- Language: TypeScript
+- Linter: Biome
+
+## Rules to Always Follow
+
+- Run `npm run lint:fix` before any commit
+- Validate changes with `npm run typecheck`
+- Don't modify dist/ directly (it's built output)
+- Ask before adding new dependencies
+- Ask before changing .opencode/ structure
+- Never commit secrets or .env files
+- Never force push to main

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

@@ -3,11 +3,10 @@
   "agent": {
     "build": {
       "description": "Primary development agent with full codebase access",
-      "model": "github-copilot/claude-opus-4.5"
+      "model": "proxypal/gemini-claude-opus-4-5-thinking"
     },
     "compaction": {
-      "description": "Session summarizer for context continuity across compactions",
-      "model": "opencode/minimax-m2.1-free"
+      "description": "Session summarizer for context continuity across compactions"
     },
     "explore": {
       "description": "Fast codebase search specialist",
@@ -29,7 +28,7 @@
     },
     "rush": {
       "description": "Fast primary agent for small, well-defined tasks",
-      "model": "proxypal/gemini-3-flash-preview"
+      "model": "zai-coding-plan/glm-4.7"
     },
     "scout": {
       "description": "External research specialist for library docs and patterns",
@@ -50,30 +49,76 @@
     "chatMaxRetries": 2,
     "continue_loop_on_deny": false,
     "lsp": true,
-    "primary_tools": ["edit", "write", "bash"]
+    "primary_tools": [
+      "edit",
+      "write",
+      "bash"
+    ]
   },
   "formatter": {
     "biome": {
-      "command": ["npx", "@biomejs/biome", "check", "--write", "$FILE"],
-      "extensions": [".js", ".jsx", ".ts", ".tsx", ".json", ".jsonc"]
+      "command": [
+        "npx",
+        "@biomejs/biome",
+        "check",
+        "--write",
+        "$FILE"
+      ],
+      "extensions": [
+        ".js",
+        ".jsx",
+        ".ts",
+        ".tsx",
+        ".json",
+        ".jsonc"
+      ]
     },
     "cargo-fmt": {
-      "command": ["cargo", "fmt", "--", "$FILE"],
-      "extensions": [".rs"]
+      "command": [
+        "cargo",
+        "fmt",
+        "--",
+        "$FILE"
+      ],
+      "extensions": [
+        ".rs"
+      ]
     },
     "java-formatter": {
-      "command": ["google-java-format", "--replace", "$FILE"],
+      "command": [
+        "google-java-format",
+        "--replace",
+        "$FILE"
+      ],
       "environment": {
         "JAVA_HOME": "{env:JAVA_HOME}"
       },
-      "extensions": [".java"]
+      "extensions": [
+        ".java"
+      ]
     },
     "prettier": {
-      "command": ["npx", "prettier", "--write", "$FILE"],
-      "extensions": [".html", ".css", ".scss", ".sass", ".md", ".yaml", ".yml"]
+      "command": [
+        "npx",
+        "prettier",
+        "--write",
+        "$FILE"
+      ],
+      "extensions": [
+        ".html",
+        ".css",
+        ".scss",
+        ".sass",
+        ".md",
+        ".yaml",
+        ".yml"
+      ]
     }
   },
-  "instructions": [".opencode/memory/user.md", ".opencode/memory/project/*.md"],
+  "instructions": [
+    ".opencode/memory/user.md",
+    ".opencode/memory/project/*.md"
+  ],
   "keybinds": {
     "command_list": ";",
     "leader": "`",
@@ -245,7 +290,15 @@
             "context": 880964,
             "output": 65536
           },
-          "name": "Gemini 3 Flash Preview"
+          "name": "Gemini 3 Flash Preview",
+          "options": {
+            "generationConfig": {
+              "thinkingConfig": {
+                "thinkingLevel": "HIGH",
+                "includeThoughts": true
+              }
+            }
+          }
         },
         "gemini-3-pro-image-preview": {
           "limit": {
@@ -259,7 +312,15 @@
             "context": 880964,
             "output": 65536
           },
-          "name": "Gemini 3 Pro Preview"
+          "name": "Gemini 3 Pro Preview",
+          "options": {
+            "generationConfig": {
+              "thinkingConfig": {
+                "thinkingLevel": "HIGH",
+                "includeThoughts": true
+              }
+            }
+          }
         },
         "gemini-claude-opus-4-5-thinking": {
           "limit": {

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

@@ -11,7 +11,7 @@
 	"author": "",
 	"license": "ISC",
 	"dependencies": {
-		"@opencode-ai/plugin": "1.1.3"
+		"@opencode-ai/plugin": "1.1.6"
 	},
 	"devDependencies": {
 		"@types/node": "^25.0.3",

package/dist/template/.opencode/plugin/compaction.ts

@@ -1,10 +1,19 @@
 /**
- * Memory & Compaction Plugin
+ * Memory & Compaction Plugin (Codex-Inspired Continuity)
  *
- * Injects memory context and beads state into session compaction:
- * 1. Load memory files for context
- * 2. Inject beads in-progress state
- * 3. Append workflow-specific compaction rules
+ * Injects continuity context into session compaction:
+ * 1. Load session-context.md (CONTINUITY.md pattern)
+ * 2. Load project memory files
+ * 3. Inject beads in-progress state
+ * 4. Append workflow-specific compaction rules
+ *
+ * Session context format (agent-maintained via memory-update):
+ * - Goal: What we're trying to achieve + success criteria
+ * - Constraints: User-specified limits, discovered guardrails
+ * - Decisions: Key choices made this session
+ * - State: Done/Now/Next
+ * - Open Questions: Uncertainties marked UNCONFIRMED
+ * - Working Set: Files, bead IDs, branch
  */
 
 import type { Plugin } from "@opencode-ai/plugin";
@@ -14,7 +23,19 @@ export const CompactionPlugin: Plugin = async ({ $, directory }) => {
 
 	return {
 		"experimental.session.compacting": async (input, output) => {
-			// Load memory context
+			// 1. Load session context (CONTINUITY.md pattern) - HIGHEST PRIORITY
+			let sessionContext = "";
+			try {
+				const sessionFile = `${MEMORY_DIR}/session-context.md`;
+				const content = await $`cat ${sessionFile} 2>/dev/null`.text();
+				if (content.trim()) {
+					sessionContext = `\n## Session Continuity (Compaction-Safe)\n${content}`;
+				}
+			} catch {
+				// No session context yet
+			}
+
+			// 2. Load project memory files
 			let memoryContext = "";
 			try {
 				const memoryFiles =
@@ -33,7 +54,7 @@ export const CompactionPlugin: Plugin = async ({ $, directory }) => {
 				// Memory dir doesn't exist or other error
 			}
 
-			// Inject beads in-progress state
+			// 3. Inject beads in-progress state
 			let beadsContext = "";
 			try {
 				const result =
@@ -48,12 +69,13 @@ export const CompactionPlugin: Plugin = async ({ $, directory }) => {
 				// Beads not available, skip
 			}
 
-			// Inject memory and beads context into compaction context
-			if (memoryContext || beadsContext) {
-				output.context.push(`## Session Context
-${beadsContext}
-${memoryContext}
-`);
+			// Inject all context - session context FIRST (most important)
+			const allContext = [sessionContext, beadsContext, memoryContext]
+				.filter(Boolean)
+				.join("\n");
+
+			if (allContext) {
+				output.context.push(`## Session Context\n${allContext}\n`);
 			}
 
 			// Append workflow-specific rules to OpenCode's default prompt
@@ -61,6 +83,28 @@ ${memoryContext}
 
 ## Additional Rules for This Workflow
 
+### Session Continuity
+Maintain session-context.md via memory-update tool. Format:
+\`\`\`
+Goal: [What + success criteria]
+Constraints: [Limits, mark UNCONFIRMED if inferred]
+Decisions: [Key choices this session]
+State:
+  Done: [Completed]
+  Now: [Current focus - ONE thing]
+  Next: [Queued]
+Open Questions: [Uncertainties - mark UNCONFIRMED]
+Working Set: [Files, bead ID, branch]
+\`\`\`
+
+Update session-context.md when:
+- Goal changes or clarifies
+- Key decision made
+- State shifts (Done/Now/Next)
+- Uncertainty discovered
+
+After compaction: Check session-context.md, ask 1-3 targeted questions if gaps exist.
+
 ### Beads Workflow
 - PRESERVE: Bead IDs (bd-xxx format), bead states, in-progress task IDs
 - DROP: Closed/completed beads (already tracked in git)
@@ -71,13 +115,13 @@ ${memoryContext}
 
 ### Memory System
 If you discover:
-- Gotchas/edge cases → Mention they should be saved to .opencode/memory/project/gotchas.md
-- Build/test commands → Mention they should be saved to .opencode/memory/project/commands.md
-- Code patterns/conventions → Mention they should be saved to .opencode/memory/project/conventions.md
-- Architecture insights → Mention they should be saved to .opencode/memory/project/architecture.md
+- Gotchas/edge cases → Save to .opencode/memory/project/gotchas.md
+- Build/test commands → Save to .opencode/memory/project/commands.md
+- Code patterns/conventions → Save to .opencode/memory/project/conventions.md
+- Architecture insights → Save to .opencode/memory/project/architecture.md
 
 ### Preservation Priorities
-- PRESERVE: File paths with exact locations (file:line_number), user constraints, technical decisions
+- PRESERVE: File paths (file:line_number), user constraints, decisions, UNCONFIRMED items
 - DROP: Failed attempts, superseded info, verbose tool outputs, exploration dead-ends
 `;
 		},

package/dist/template/.opencode/plugin/lib/notify.ts

@@ -12,7 +12,7 @@ let _isWSL: boolean | null = null;
 export function isWSL(): boolean {
 	if (_isWSL !== null) return _isWSL;
 	try {
-		const fs = require("fs");
+		const fs = require("node:fs");
 		const release = fs.readFileSync("/proc/version", "utf8").toLowerCase();
 		_isWSL = release.includes("microsoft") || release.includes("wsl");
 	} catch {
@@ -28,7 +28,6 @@ export function isWSL(): boolean {
  * @param message - Notification body
  */
 export async function notify(
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	$: any,
 	title: string,
 	message: string,
@@ -39,7 +38,7 @@ export async function notify(
 
 	try {
 		if (platform === "darwin") {
-			await $`osascript -e ${'display notification "' + safeMessage + '" with title "' + safeTitle + '"'}`;
+			await $`osascript -e ${`display notification "${safeMessage}" with title "${safeTitle}"`}`;
 		} else if (platform === "linux") {
 			if (isWSL()) {
 				// WSL: try notify-send, fail silently

package/dist/template/.opencode/plugin/sessions.ts

@@ -116,7 +116,7 @@ export const SessionsPlugin: Plugin = async ({ client }) => {
 						const userMessages = messageData.filter(
 							(m) => m.info?.role === "user",
 						);
-						summary += `## Recent User Messages\n\n`;
+						summary += "## Recent User Messages\n\n";
 						for (let i = 0; i < Math.min(userMessages.length, 5); i++) {
 							const m = userMessages[i];
 							const content = extractContent(m.info);

package/dist/template/.opencode/plugin/skill-mcp.ts

@@ -1,7 +1,7 @@
-import { type ChildProcess, spawn } from "child_process";
-import { existsSync, readFileSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
+import { type ChildProcess, spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
 import type { Plugin } from "@opencode-ai/plugin";
 import { tool } from "@opencode-ai/plugin/tool";
 
@@ -155,7 +155,7 @@ export const SkillMcpPlugin: Plugin = async ({ directory }) => {
 				},
 			});
 
-			client.process.stdin?.write(JSON.stringify(request) + "\n");
+			client.process.stdin?.write(`${JSON.stringify(request)}\n`);
 		});
 	}
 
@@ -232,10 +232,10 @@ export const SkillMcpPlugin: Plugin = async ({ directory }) => {
 
 			// Send initialized notification
 			proc.stdin?.write(
-				JSON.stringify({
+				`${JSON.stringify({
 					jsonrpc: "2.0",
 					method: "notifications/initialized",
-				}) + "\n",
+				})}\n`,
 			);
 
 			// Discover capabilities
@@ -430,7 +430,7 @@ The skill must be loaded first via the skill() tool to register its MCP config.`
 					if (args.skill_name) {
 						const toDisconnect: string[] = [];
 						for (const key of state.clients.keys()) {
-							if (key.startsWith(args.skill_name + ":")) {
+							if (key.startsWith(`${args.skill_name}:`)) {
 								toDisconnect.push(key);
 							}
 						}
@@ -440,11 +440,10 @@ The skill must be loaded first via the skill() tool to register its MCP config.`
 							state.clients.delete(key);
 						}
 						return JSON.stringify({ disconnected: toDisconnect });
-					} else {
-						const count = state.clients.size;
-						disconnectAll();
-						return JSON.stringify({ disconnected: "all", count });
 					}
+					const count = state.clients.size;
+					disconnectAll();
+					return JSON.stringify({ disconnected: "all", count });
 				},
 			}),
 		},