opencodekit 0.21.8 → 0.21.10

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

@@ -6,16 +6,42 @@
  * - find_sessions: Multi-word AND search with relevance ranking
  * - read_session: Full transcript with keyword filtering
  *
- * Requires Bun runtime (uses bun:sqlite for zero-dep DB access).
+ * Uses Node's built-in node:sqlite module for zero-dep DB access.
  */
 
-import { Database } from "bun:sqlite";
 import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
 import { join } from "node:path";
 import type { Plugin } from "@opencode-ai/plugin";
 import { tool } from "@opencode-ai/plugin/tool";
 
-// --- Configuration ---
+type SqlParam = string | number | bigint | null | Uint8Array;
+type StatementSyncLike = {
+	get(...params: SqlParam[]): unknown;
+	all(...params: SqlParam[]): unknown[];
+};
+type DatabaseSyncLike = {
+	prepare(sql: string): StatementSyncLike;
+	close(): void;
+};
+type DatabaseSyncConstructor = new (
+	dbPath: string,
+	options?: { readOnly?: boolean; timeout?: number },
+) => DatabaseSyncLike;
+
+const require = createRequire(import.meta.url);
+let DatabaseSyncCtor: DatabaseSyncConstructor | null = null;
+
+function getDatabaseSyncConstructor(): DatabaseSyncConstructor {
+	if (!DatabaseSyncCtor) {
+		const sqlite = require("node:sqlite") as {
+			DatabaseSync: DatabaseSyncConstructor;
+		};
+		DatabaseSyncCtor = sqlite.DatabaseSync;
+	}
+	return DatabaseSyncCtor;
+}
+
 
 const SEARCH_CONFIG = {
 	roles: ["user", "assistant"],
@@ -66,13 +92,16 @@ const resolveDbPath = (): string => {
 /** Resolved once at module load — no per-request resolution cost. */
 const DEFAULT_DB_PATH = resolveDbPath();
 
-const openReadonlyDb = (): { db: Database | null; error: string | null } => {
+const openReadonlyDb = (): {
+	db: DatabaseSyncLike | null;
+	error: string | null;
+} => {
 	try {
+		const DatabaseSync = getDatabaseSyncConstructor();
 		return {
-			db: new Database(DEFAULT_DB_PATH, {
-				readonly: true,
-				create: false,
-				strict: true,
+			db: new DatabaseSync(DEFAULT_DB_PATH, {
+				readOnly: true,
+				timeout: 5000,
 			}),
 			error: null,
 		};

package/dist/template/.opencode/skill/agent-evals/SKILL.md

@@ -124,7 +124,7 @@ A single run can be lucky. For a skill you're seriously evaluating:
 | Anti-pattern avoidance | `grep` for the banned pattern → expect 0                          |
 | Required output shape  | JSON schema validation, presence of required sections             |
 | Code correctness       | run the code, run its tests, check exit code                      |
-| Behavior change        | call site count via `tilth_search`, file existence, line counts   |
+| Behavior change        | call site count via `srcwalk callers`, file existence, line counts |
 | UI / visual            | Playwright screenshot + pixel diff against expected, or DOM query |
 | Refusal / safety       | grep for forbidden phrases or correct refusal pattern             |
 

package/dist/template/.opencode/skill/code-search-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: code-search-patterns
-description: Use when navigating unfamiliar code with search-first patterns, combining built-in/LSP navigation with tilth MCP (main agent) and tilth CLI (subagents)
+description: Use when navigating unfamiliar code with search-first patterns, combining built-in/LSP navigation with srcwalk CLI
 version: 1.0.0
 tags: [workflow, code-quality, context, subagent]
 dependencies: []
@@ -8,10 +8,10 @@ dependencies: []
 
 # Code Search Patterns
 
-Unified navigation skill for fast, low-waste code understanding across both execution modes:
+Unified navigation skill for fast, low-waste code understanding:
 
-- **Main agent**: built-in tools + LSP + tilth MCP
-- **Subagents**: Bash + `npx -y tilth` CLI
+- **Main agent**: built-in tools + LSP + srcwalk CLI
+- **Subagents**: Bash + `srcwalk` CLI
 
 This skill merges practical navigation heuristics with concrete tool usage so you can locate behavior, trace impact, and edit safely with fewer calls.
 
@@ -42,7 +42,7 @@ Start with symbol/content search to find exact locations, then read only the nee
 - **Good**: `search -> targeted read`
 - **Avoid**: `read many files -> search later`
 
-Use LSP (`findReferences`, `outgoingCalls`) or tilth search first; read deep only after narrowing scope.
+Use LSP (`findReferences`, `outgoingCalls`) or srcwalk search first; read deep only after narrowing scope.
 
 ### 2) Multi-Symbol Search
 
@@ -65,7 +65,7 @@ Re-read only when you need:
 Before renaming/removing/changing signatures, inspect downstream impact first.
 
 - LSP: `findReferences`, `incomingCalls`
-- tilth: `tilth_tilth_deps` or `--deps`
+- srcwalk: `srcwalk impact <symbol>` or `srcwalk callers <symbol>`
 
 Then apply edits from dependents inward.
 
@@ -74,7 +74,7 @@ Then apply edits from dependents inward.
 Prefer nearby package/module scope first.
 
 - built-in search: constrain `path`
-- tilth: pass `scope` / `context`
+- srcwalk: pass `--scope <dir>` to restrict the scan area
 
 Locality reduces irrelevant matches and token churn.
 
@@ -83,7 +83,7 @@ Locality reduces irrelevant matches and token churn.
 For large files, inspect structure first (symbols/outline), then read only target sections.
 
 - LSP: `documentSymbol`
-- tilth read: smart outline by default, then section drill-in
+- srcwalk read: smart outline by default, then section drill-in
 
 ### 7) Follow Call Chain, Not File Tree
 
@@ -91,34 +91,18 @@ Start at entry behavior and walk calls (`definition -> outgoing -> next definiti
 
 This exposes real execution flow with fewer reads.
 
-## tilth MCP (Main Agent)
+## srcwalk CLI
 
-Use MCP variants when available in the main agent session:
-
-- `tilth_tilth_search`
-- `tilth_tilth_read`
-- `tilth_tilth_files`
-- `tilth_tilth_deps`
-
-### Built-in/LSP vs tilth MCP (when to choose which)
-
-| Need                    | Built-in / LSP                         | Prefer tilth MCP when                                       | Why tilth helps                     |
-| ----------------------- | -------------------------------------- | ----------------------------------------------------------- | ----------------------------------- |
-| Find symbols/usages     | `grep` / `lsp.findReferences`          | You want definitions + usages + expanded source in one call | Reduces search+read round trips     |
-| Read file content       | `read`                                 | File is large or you only need structure first              | Smart outline + section targeting   |
-| List candidate files    | `glob`                                 | You want quick glob results with token-aware relevance      | Faster triage for large directories |
-| Pre-change impact check | `lsp.incomingCalls` + manual follow-up | You need import + dependent view before breaking change     | Single blast-radius view via deps   |
-
-Guideline: if tilth MCP is active, use it as default for navigation; fall back to built-in/LSP when you need language-server-specific semantics or exact editor-position operations.
-
-## tilth CLI (Subagents)
-
-### Why this exists
-
-Subagents typically cannot call MCP tools directly. They can still use tilth through Bash:
+`srcwalk` is available to all agents (main agent and subagents) via Bash. It combines grep + tree-sitter AST into one CLI tool.
 
 ```bash
-npx -y tilth <query> [flags]
+srcwalk guide          # Print agent routing policy (run once per session)
+srcwalk find <symbol>  # Symbol search (definitions + usages)
+srcwalk <file>         # Smart file read (outline for large files)
+srcwalk map            # Codebase structural overview
+srcwalk files '<glob>' # Find files by pattern
+srcwalk callers <sym>  # Reverse call graph
+srcwalk impact <sym>   # Blast-radius heuristic
 ```
 
 ### Auto-detection
@@ -127,103 +111,90 @@ npx -y tilth <query> [flags]
 | --------------------------------- | ------------------------------------ |
 | Existing file path (`src/foo.ts`) | Read file (smart outline/full)       |
 | Identifier (`initCommand`)        | Symbol search (definitions + usages) |
-| Glob (`*.test.ts`)                | List files                           |
-| Plain text / phrase               | Content search                       |
-
-Use `--kind` to force a specific mode when needed.
+| `find <symbol>`                   | Explicit symbol search               |
+| `files <glob>`                    | File discovery                       |
 
 ### Core operations
 
 #### 1) Read file
 
 ```bash
-npx -y tilth src/index.ts
-npx -y tilth src/index.ts --full
-npx -y tilth src/index.ts --section 45-89
+srcwalk src/index.ts
+srcwalk src/index.ts --full
+srcwalk src/index.ts --section 45-89
 ```
 
 #### 2) Search symbols
 
 ```bash
-npx -y tilth initCommand --scope src/
-npx -y tilth "initCommand,detectMode" --scope src/
+srcwalk find initCommand --scope src/
+srcwalk find "initCommand,detectMode" --scope src/
 ```
 
 #### 3) Search text/regex
 
 ```bash
-npx -y tilth --kind content "TODO" --scope src/
-npx -y tilth --kind regex "/TODO.*fix/" --scope src/
+srcwalk find "TODO" --scope src/
+srcwalk find "/TODO.*fix/" --scope src/
 ```
 
 #### 4) Find callers
 
 ```bash
-npx -y tilth --kind callers initCommand --scope src/
+srcwalk callers initCommand --scope src/
 ```
 
 #### 5) List files
 
 ```bash
-npx -y tilth "*.test.ts" --scope src/
+srcwalk files "*.test.ts" --scope src/
 ```
 
-#### 6) Blast radius / deps
+#### 6) Blast radius
 
 ```bash
-npx -y tilth --deps src/commands/init.ts --scope src/
+srcwalk impact initCommand --scope src/
+srcwalk callers initCommand --scope src/
 ```
 
 #### 7) Codebase map
 
 ```bash
-npx -y tilth --map --scope src/
+srcwalk map --scope src/
 ```
 
 ### Useful flags
 
-| Flag              | Purpose                        | Example                      |
-| ----------------- | ------------------------------ | ---------------------------- | ------------------- | ----------------- | ---------------- |
-| `--scope <dir>`   | Restrict scan area             | `--scope src/commands/`      |
-| `--section <range | heading>`                      | Targeted file slice          | `--section 120-180` |
-| `--full`          | Force full file output         | `--full`                     |
-| `--budget <n>`    | Limit output size              | `--budget 2000`              |
-| `--json`          | Machine-readable output        | `--json`                     |
-| `--map`           | Structural project skeleton    | `--map --scope src/`         |
-| `--kind <symbol   | content                        | regex                        | callers>`           | Force search mode | `--kind callers` |
-| `--deps <file>`   | Import/dependent blast radius  | `--deps src/utils/errors.ts` |
-| `--expand <n>`    | Expand top matches with source | `--expand 3`                 |
-
-### MCP vs CLI
-
-| Capability                   | MCP (main agent)                                   | CLI (subagents)                            |
-| ---------------------------- | -------------------------------------------------- | ------------------------------------------ |
-| Access mode                  | Tool call                                          | Bash command                               |
-| Session dedup/context carry  | Yes                                                | No                                         |
-| Hash-anchored edit flow      | Yes (via MCP edit tools)                           | No                                         |
-| Symbol/content/regex/callers | Yes                                                | Yes                                        |
-| Deps/blast-radius            | Yes                                                | Yes                                        |
-| Codebase map                 | Limited by toolset                                 | Yes (`--map`)                              |
-| Best for                     | Interactive main-agent navigation + edit workflows | Subagent discovery/exploration without MCP |
+| Flag                    | Purpose                                       | Example                             |
+| ----------------------- | --------------------------------------------- | ----------------------------------- |
+| `--scope <dir>`         | Restrict scan area                            | `--scope src/commands/`             |
+| `--section <range\|sym>` | Targeted file slice (line range or symbol)   | `--section 120-180`, `--section fn` |
+| `--full`                | Force full file output (no outline)           | `--full`                            |
+| `--budget <n>`          | Limit output token size                       | `--budget 2000`                     |
+| `--json`                | Machine-readable output                       | `--json`                            |
+| `--filter <qualifiers>` | Filter find results by field:value            | `--filter kind:fn`                  |
+| `--glob <pattern>`      | File pattern filter within find               | `--glob "*.ts"`                     |
+| `--expand[=<n>]`        | Inline source for top N matches               | `--expand 3`                        |
+| `--depth <n>`           | Depth for callers/callees traversal           | `--depth 2`                         |
 
 ### Example subagent dispatch
 
 ```ts
 task({
   subagent_type: "general",
-  prompt: `Use tilth CLI via Bash for navigation.
+  prompt: `Use srcwalk via Bash for navigation.
 
 1) Locate symbol and usages:
-npx -y tilth initCommand --scope src/
+srcwalk find initCommand --scope src/
 
 2) Find callers:
-npx -y tilth --kind callers initCommand --scope src/
+srcwalk callers initCommand --scope src/
 
 3) Check blast radius before edits:
-npx -y tilth --deps src/commands/init.ts --scope src/
+srcwalk impact initCommand --scope src/
 
 4) Read only the relevant section:
-npx -y tilth src/commands/init.ts --section 500-620
+srcwalk src/commands/init.ts --section 500-620
 
 Then implement the requested change with minimal file edits.`,
 });
@@ -249,5 +220,5 @@ Target heuristic: understand a symbol and its direct impact in **≤3 calls** wh
 | Serially tracing one function at a time          | Multi-symbol search + callers/deps                                  |
 | Ignoring blast radius before API/signature edits | Run references/incoming/deps first                                  |
 | Unscoped repository-wide search                  | Use `path`/`--scope` to localize                                    |
-| Using CLI defaults when mode is ambiguous        | Force with `--kind`                                                 |
+| Using CLI defaults when mode is ambiguous        | Use explicit subcommand (`find`, `files`, `callers`) or `--filter kind:<label>` |
 | Overusing `--full` on large files                | Outline first, then `--section`                                     |

package/dist/template/.opencode/skill/context-initialization/SKILL.md

@@ -21,9 +21,9 @@ dependencies: []
 
 ### 1. Verify Templates
 
-```typescript
-tilth_tilth_files({ pattern: "*.md", scope: ".opencode/memory/_templates" });
-// Required templates: project.md, roadmap.md, state.md
+```bash
+srcwalk files "*.md" --scope .opencode/memory/_templates
+# Required templates: project.md, roadmap.md, state.md
 ```
 
 Stop if missing.
@@ -62,8 +62,8 @@ Skip if `--skip-questions` flag set.
 
 ### 4. Verify
 
-```typescript
-tilth_tilth_files({ pattern: "*.md", scope: ".opencode/memory/project" });
+```bash
+srcwalk files "*.md" --scope .opencode/memory/project
 ```
 
 Report created files with their injection status (auto-injected vs on-demand).

package/dist/template/.opencode/skill/rtk-command-compression/SKILL.md

@@ -22,7 +22,7 @@ Core rule: **opt in explicitly, verify rewrites, preserve raw evidence when corr
 
 ## When NOT to Use
 
-- Code inspection or editing: prefer `tilth_tilth_read`, `tilth_tilth_search`, LSP, Read, Grep, and Edit.
+- Code inspection or editing: prefer `srcwalk find`/`srcwalk <path>`, LSP, Read, Grep, and Edit.
 - Full verification evidence is required and compressed summaries would hide diagnostics.
 - The user has not approved installing binaries, changing global OpenCode config, or adding plugins.
 

package/dist/template/.opencode/tool/context7.ts

@@ -28,7 +28,7 @@ WHEN: Looking up library APIs, checking function signatures, finding usage examp
 SKIP: Searching your own codebase (use grep/LSP), general web research (use websearch).
 
 Common mistakes:
-- DON'T search for internal project code (use grep/tilth instead)
+- DON'T search for internal project code (use grep/srcwalk instead)
 - DON'T guess library versions — always resolve first, then query
 - DON'T use for general web research (use websearch instead)
 

package/dist/template/.opencode/tool/grepsearch.ts

@@ -18,7 +18,7 @@ export default tool({
 	description: `Search real-world code examples from GitHub repositories via grep.app. Replaces asking "how do others use X?" — use this for finding production patterns and real-world API usage.
 
 WHEN: Implementing unfamiliar APIs, looking for production patterns, understanding library integrations.
-SKIP: Searching your own codebase (use grep/tilth), looking up docs (use context7), general research (use websearch).
+SKIP: Searching your own codebase (use grep/srcwalk), looking up docs (use context7), general research (use websearch).
 
 Common mistakes:
 - DON'T search for keywords like "react tutorial" — search for literal code: "useState("

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.21.8",
+	"version": "0.21.10",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": [
 		"agents",
@@ -34,7 +34,7 @@
 	},
 	"scripts": {
 		"dev": "tsx src/index.ts",
-		"build": "tsdown && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json .opencode/ dist/template/.opencode/",
+		"build": "tsdown && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json --exclude='plugin/*.bak' --exclude=memory.db --exclude=memory.db-shm --exclude=memory.db-wal --exclude='memory.db.corrupt.*' --exclude=memory-recovery.log .opencode/ dist/template/.opencode/",
 		"typecheck": "tsgo --noEmit",
 		"test": "vitest run",
 		"test:watch": "vitest",