opencodekit 0.19.5 → 0.19.6

package/dist/index.js

@@ -20,7 +20,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
 //#region package.json
-var version = "0.19.5";
+var version = "0.19.6";
 
 //#endregion
 //#region src/utils/license.ts

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

@@ -1,6 +1,7 @@
 ---
 description: Extract and persist learnings from completed work into institutional memory
 argument-hint: "[bead-id]"
+agent: build
 ---
 
 # Compound: $ARGUMENTS
@@ -19,9 +20,9 @@ so future Plan and Ship cycles start with institutional knowledge instead of bla
 ## Phase 1: Gather Evidence
 
 ```bash
-# Get what changed
-git diff origin/main..HEAD --stat
-git log origin/main..HEAD --oneline
+# Get what changed (falls back gracefully if no remote)
+git diff origin/main..HEAD --stat 2>/dev/null || git diff HEAD~5..HEAD --stat
+git log origin/main..HEAD --oneline 2>/dev/null || git log --oneline -10
 
 # Get review comments if any
 br comments list $ARGUMENTS 2>/dev/null || echo "No bead"

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

@@ -10,7 +10,7 @@ Create a bead and its specification (PRD) from a description.
 
 > **Workflow:** **`/create`** → `/start <id>` → `/ship <id>`
 >
-> ⛔ This command creates the specification ONLY. Do NOT write any implementation code.
+> This command creates the specification ONLY. Do NOT write any implementation code.
 
 ## Load Skills
 
@@ -133,24 +133,19 @@ Extract bead title and description from `$ARGUMENTS` before creating the bead.
 - If user provided multiple lines, use first line as title and full text as description.
 
 ```bash
-TITLE=$(echo "$ARGUMENTS" | head -n1)
-DESCRIPTION=$(echo "$ARGUMENTS")
-
-if [ "$TITLE" = "$DESCRIPTION" ]; then
-  DESCRIPTION="$TITLE"
-fi
-
 BEAD_ID=$(br create --title "$TITLE" --description "$DESCRIPTION" --type $BEAD_TYPE --json | jq -r '.id')
 mkdir -p ".beads/artifacts/$BEAD_ID"
 ```
 
+Extract title and description from `$ARGUMENTS`:
+- Single line input: use as both title and description
+- Multi-line input: first line as title, full text as description
+
 ## Phase 6: Write PRD
 
 Copy and fill the PRD template using context from Phase 3:
 
-```bash
-cp .opencode/memory/_templates/prd.md ".beads/artifacts/$BEAD_ID/prd.md"
-```
+Read the PRD template from `.opencode/memory/_templates/prd.md` and write it to `.beads/artifacts/$BEAD_ID/prd.md`.
 
 ### Required Sections
 

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

@@ -32,9 +32,9 @@ skill({ name: "frontend-design" }); // Design system guidance, anti-patterns, re
 ## Phase 1: Detect Existing Design System
 
 ```typescript
-glob({ pattern: "**/tailwind.config.{js,ts,mjs}" });
-glob({ pattern: "**/globals.css" });
-glob({ pattern: "**/components.json" }); // shadcn
+tilth_tilth_files({ pattern: "**/tailwind.config.{js,ts,mjs}" });
+tilth_tilth_files({ pattern: "**/globals.css" });
+tilth_tilth_files({ pattern: "**/components.json" }); // shadcn
 ```
 
 Read what exists. Don't design in a vacuum — build on the project's current system.

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

@@ -33,7 +33,7 @@ br show $ARGUMENTS
 git status --porcelain
 git branch --show-current
 git rev-parse --short HEAD
-ls .beads/artifacts/$ARGUMENTS/ 2>/dev/null
+Read `.beads/artifacts/$ARGUMENTS/` to check existing artifacts.
 ```
 
 ---
@@ -60,10 +60,12 @@ question({
 If user chooses commit:
 
 ```bash
-git add -A
+git add <specific-files-you-modified>
 git commit -m "WIP: $ARGUMENTS - [brief description of where you stopped]"
 ```
 
+**Never use `git add -A` or `git add .`** — stage only the files you modified.
+
 ---
 
 ## Phase 3: Write Handoff

package/dist/template/.opencode/command/init-context.md

@@ -1,14 +1,26 @@
 ---
-description: Initialize GSD-style project planning context with integrated skill usage
+description: Initialize project planning context (roadmap, state) with optional brownfield analysis
 argument-hint: "[--skip-questions] [--brownfield]"
 agent: build
 ---
 
 # Init-Context: $ARGUMENTS
 
-Initialize GSD-style project planning with integrated skill usage.
+Initialize project planning context files from templates.
 
-`tech-stack.md` is the default baseline project memory file. This command adds the optional planning files (`project.md`, `roadmap.md`, `state.md`) used for richer multi-session project context.
+## Architecture
+
+**Auto-injected files** (always loaded into every prompt via `instructions[]`):
+- `user.md` — identity, preferences
+- `tech-stack.md` — framework, constraints
+- `project.md` — vision, success criteria, principles
+- `git-context.md` — spatial awareness
+
+**On-demand files** (created by this command, loaded via `memory-read` when needed):
+- `roadmap.md` — phases, milestones, bead planning
+- `state.md` — current position, blockers, next actions
+
+> **Warning:** Do NOT add roadmap.md or state.md to `instructions[]`. Per-prompt injection of too many files causes session OOM crashes. Use `memory-read({ file: "project/roadmap" })` or `memory-read({ file: "project/state" })` when needed.
 
 ## Load Skills
 
@@ -32,18 +44,20 @@ const args = {
 
 ### 1.1 Check Existing Context
 
-```bash
-ls .opencode/memory/project/ 2>/dev/null && HAS_CONTEXT=true || HAS_CONTEXT=false
-cat .opencode/memory/project/project.md 2>/dev/null | head -20
+Use tilth or Read to check for existing files:
+
+```typescript
+tilth_tilth_files({ pattern: "*.md", scope: ".opencode/memory/project" });
+// Or: Read({ filePath: ".opencode/memory/project/project.md", limit: 20 });
 ```
 
 **If planning context exists:**
 
 ```
-Existing optional planning context found:
-- project.md: [exists/size]
-- roadmap.md: [exists/size]
-- state.md: [exists/size]
+Existing planning context found:
+- project.md: [exists/size] (auto-injected)
+- roadmap.md: [exists/size] (on-demand)
+- state.md: [exists/size] (on-demand)
 
 Options:
 1. Refresh - Delete and recreate from templates
@@ -58,11 +72,10 @@ Wait for user selection.
 If `--brownfield` flag is set:
 
 ```typescript
-// Spawn parallel analysis agents (like GSD map-codebase)
 skill({ name: "swarm-coordination" });
 
 // Agent 1: Map tech stack
-Task({
+task({
   subagent_type: "explore",
   description: "Analyze tech stack",
   prompt:
@@ -70,7 +83,7 @@ Task({
 });
 
 // Agent 2: Map architecture
-Task({
+task({
   subagent_type: "explore",
   description: "Analyze architecture",
   prompt:
@@ -82,12 +95,11 @@ Task({
 
 ## Phase 2: Requirements Gathering
 
-### 2.1 Load Brainstorming Skill (if not --skip-questions)
+### 2.1 Brainstorming (if not --skip-questions)
 
 ```typescript
 if (!args.skipQuestions) {
-  skill({ name: "brainstorming" });
-
+  // brainstorming skill already loaded in Load Skills phase
   // Follow brainstorming process for project vision
   // Ask questions one at a time (as per brainstorming skill)
   // Output: Refined vision, success criteria, target users
@@ -106,12 +118,14 @@ Use template defaults with placeholders for:
 
 ## Phase 3: Document Creation
 
-### 3.1 Create project.md
+### 3.1 Update project.md (auto-injected)
+
+This file is auto-injected into every prompt. Keep it concise.
 
 **Load template:**
 
-```bash
-cat .opencode/memory/_templates/project.md
+```typescript
+Read({ filePath: ".opencode/memory/_templates/project.md" });
 ```
 
 **Fill with gathered data:**
@@ -122,9 +136,15 @@ cat .opencode/memory/_templates/project.md
 - Core principles (convention over config, minimal, extensible)
 - Current phase (from user input or template default)
 
-**Write to:** `.opencode/memory/project/project.md`
+**Write using memory tools:**
+
+```typescript
+memory-update({ file: "project/project", content: filledContent, mode: "replace" });
+```
+
+### 3.2 Create roadmap.md (on-demand)
 
-### 3.2 Create roadmap.md
+This file is NOT auto-injected. Access via `memory-read({ file: "project/roadmap" })`.
 
 **Parse phases from input:**
 
@@ -141,9 +161,15 @@ cat .opencode/memory/_templates/project.md
 | [Phase 1] | [Goal] | [Status] | [#]   |
 ```
 
-**Write to:** `.opencode/memory/project/roadmap.md`
+**Write using memory tools:**
 
-### 3.3 Create state.md
+```typescript
+memory-update({ file: "project/roadmap", content: roadmapContent, mode: "replace" });
+```
+
+### 3.3 Create state.md (on-demand)
+
+This file is NOT auto-injected. Access via `memory-read({ file: "project/state" })`.
 
 **Initialize with:**
 
@@ -157,7 +183,11 @@ cat .opencode/memory/_templates/project.md
 - Open Questions: (empty table)
 - Next Actions: (empty list)
 
-**Write to:** `.opencode/memory/project/state.md`
+**Write using memory tools:**
+
+```typescript
+memory-update({ file: "project/state", content: stateContent, mode: "replace" });
+```
 
 ### 3.4 Brownfield Analysis Integration (if applicable)
 
@@ -166,16 +196,18 @@ If `--brownfield` analysis was run:
 ```typescript
 // Append tech/arch findings to project.md Context Notes section
 // Or create separate .opencode/memory/project/codebase/ documents
-// (similar to GSD's .planning/codebase/ approach)
 ```
 
 ## Phase 4: Verification & Security
 
 ### 4.1 Verify Documents Created
 
-```bash
-ls -la .opencode/memory/project/
-wc -l .opencode/memory/project/*.md
+```typescript
+tilth_tilth_files({ pattern: "*.md", scope: ".opencode/memory/project" });
+// Verify each file exists and has content
+Read({ filePath: ".opencode/memory/project/project.md", limit: 5 });
+Read({ filePath: ".opencode/memory/project/roadmap.md", limit: 5 });
+Read({ filePath: ".opencode/memory/project/state.md", limit: 5 });
 ```
 
 **Check:**
@@ -185,20 +217,19 @@ wc -l .opencode/memory/project/*.md
 - [ ] state.md exists and >20 lines
 - [ ] All files are readable
 
-### 4.2 Secret Scan (Critical - from GSD pattern)
+### 4.2 Secret Scan
 
 ```bash
 # Scan for accidentally leaked secrets in generated docs
-grep -E '(sk-[a-zA-Z0-9]{20,}|sk_live_[a-zA-Z0-9]+|AKIA[A-Z0-9]{16}|ghp_[a-zA-Z0-9]{36}|-----BEGIN.*PRIVATE KEY)' .opencode/memory/project/*.md 2>/dev/null && SECRETS_FOUND=true || SECRETS_FOUND=false
+grep -rE '(sk-[a-zA-Z0-9]{20,}|sk_live_[a-zA-Z0-9]+|AKIA[A-Z0-9]{16}|ghp_[a-zA-Z0-9]{36}|xoxb-[a-zA-Z0-9-]+|-----BEGIN.*PRIVATE KEY)' .opencode/memory/project/*.md 2>/dev/null && SECRETS_FOUND=true || SECRETS_FOUND=false
 ```
 
 **If secrets found:** Alert user and pause before proceeding.
 
-### 4.3 Load Verification Skill
+### 4.3 Run Verification
 
 ```typescript
-skill({ name: "verification-before-completion" });
-
+// verification-before-completion skill already loaded
 // Run verification checklist:
 // 1. IDENTIFY: Files created, structure valid
 // 2. RUN: Validation commands
@@ -207,25 +238,15 @@ skill({ name: "verification-before-completion" });
 // 5. CLAIM: Context initialization complete
 ```
 
-## Phase 5: Beads Integration
-
-### 5.1 Create Initialization Bead (optional)
-
-```bash
-# If user wants to track context setup as a bead
-br create "Initialize project context" --type=task
-br update <bead-id> --status closed --reason="Context files created"
-```
-
 ## Output
 
-Creates optional planning context in `.opencode/memory/project/`:
+Creates planning context in `.opencode/memory/project/`:
 
-| File         | Purpose                                  | Lines (typical) |
-| ------------ | ---------------------------------------- | --------------- |
-| `project.md` | Vision, success criteria, principles     | 50-100          |
-| `roadmap.md` | Phases, milestones, bead planning        | 80-150          |
-| `state.md`   | Current position, blockers, next actions | 60-100          |
+| File         | Purpose                                  | Injection   | Access                                       |
+| ------------ | ---------------------------------------- | ----------- | -------------------------------------------- |
+| `project.md` | Vision, success criteria, principles     | Auto-injected | Updated in-place (already in `instructions[]`) |
+| `roadmap.md` | Phases, milestones, bead planning        | On-demand   | `memory-read({ file: "project/roadmap" })`   |
+| `state.md`   | Current position, blockers, next actions | On-demand   | `memory-read({ file: "project/state" })`     |
 
 **If `--brownfield`:**
 Additional files in `.opencode/memory/project/codebase/`:
@@ -235,21 +256,24 @@ Additional files in `.opencode/memory/project/codebase/`:
 
 ## Success Criteria
 
-- [ ] All `/init-context` planning documents created from templates
+- [ ] All planning documents created from templates
 - [ ] Documents follow template structure
 - [ ] No secrets leaked in generated files
 - [ ] Files pass basic validation (readable, non-empty)
-- [ ] User informed of next steps
+- [ ] User informed of next steps and access patterns
 
-## Phase 6: Custom Context (Optional)
+## Custom Context (Optional)
 
 Inform user about `.opencode/context/` for additional project-specific context:
 
 ```
 Custom context folder available at .opencode/context/
 - Add .md files with architecture decisions, domain knowledge, team agreements
-- Add file paths to opencode.json → instructions[] for AI prompt injection
 - This folder is preserved during init --force and upgrade
+
+⚠️  Only add files to instructions[] if they are essential for EVERY prompt.
+    Per-prompt injection adds ~2-4KB each. Too many files cause session OOM.
+    Prefer memory-read() for on-demand access instead.
 ```
 
 ## Next Steps
@@ -259,7 +283,7 @@ After init-context completes:
 1. **For new projects:** Use `/plan` to create first implementation plan
 2. **For brownfield:** Review codebase analysis, then `/plan`
 3. **For existing beads:** Use `/resume` to continue tracked work
-4. **For custom context:** Add `.md` files to `.opencode/context/` and reference in `opencode.json` instructions
+4. **For custom context:** Add `.md` files to `.opencode/context/` (on-demand via Read, not auto-injected)
 
 ---
 
@@ -267,7 +291,7 @@ After init-context completes:
 
 | Skill                            | When Used                         | Purpose                        |
 | -------------------------------- | --------------------------------- | ------------------------------ |
+| `context-initialization`         | Phase 1                           | Template verification          |
 | `brainstorming`                  | Phase 2 (if not --skip-questions) | Refine vision and requirements |
 | `swarm-coordination`             | Phase 1.2 (if --brownfield)       | Parallel codebase analysis     |
 | `verification-before-completion` | Phase 4                           | Validate created files         |
-| `beads`                          | Phase 5                           | Track as bead if desired       |

package/dist/template/.opencode/command/init-user.md

@@ -83,23 +83,28 @@ updated: [today]
 
 Ensure `user.md` is loaded in `instructions` (bare paths, no `file://` prefix).
 
-`tech-stack.md` is the core project memory file. Other files such as `project.md`, `roadmap.md`, `state.md`, and `gotchas.md` are optional/project-specific and should only be added if they actually exist and you want them injected.
-
-Example minimal setup:
+The default `instructions[]` includes 4 auto-injected files:
 
 ```json
 {
-  "instructions": [".opencode/memory/project/user.md", ".opencode/memory/project/tech-stack.md"]
+  "instructions": [
+    ".opencode/memory/project/user.md",
+    ".opencode/memory/project/tech-stack.md",
+    ".opencode/memory/project/project.md",
+    ".opencode/context/git-context.md"
+  ]
 }
 ```
 
+> **Warning:** Do not add more files to `instructions[]` unless they are essential for every prompt. Per-prompt injection of too many files causes session OOM crashes. Use `memory-read()` for on-demand access instead.
+
 ## Phase 4: Report
 
 Output:
 
 1. user.md created at `.opencode/memory/project/user.md`
 2. Preferences captured
-3. `tech-stack.md` is the only required project memory file by default
-4. Additional project memory files are optional and can be added later
+3. 4 files are auto-injected by default: user.md, tech-stack.md, project.md, git-context.md
+4. Additional planning files (roadmap.md, state.md) are on-demand via `/init-context`
 5. Custom context available at `.opencode/context/` (preserved during init --force and upgrade)
 6. Next step: `/init-context` if the user wants fuller project-planning memory files

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

@@ -74,9 +74,7 @@ Create `./AGENTS.md` — **target <60 lines** (max 150). Follow the `index-knowl
 
 From template `.opencode/memory/_templates/tech-stack.md`:
 
-```bash
-cp .opencode/memory/_templates/tech-stack.md .opencode/memory/project/tech-stack.md
-```
+Read the template from `.opencode/memory/_templates/tech-stack.md` and write it to `.opencode/memory/project/tech-stack.md`.
 
 Fill detected values:
 

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

@@ -1,6 +1,7 @@
 ---
 description: Full autonomous chain - Plan → Ship → Review → Compound in one command
 argument-hint: "<bead-id> [--skip-plan]"
+agent: build
 ---
 
 # LFG (Let's Fucking Go): $ARGUMENTS
@@ -22,9 +23,10 @@ Full compound engineering cycle. One command, all four steps.
 
 ```bash
 br show $BEAD_ID
-ls .beads/artifacts/$BEAD_ID/
 ```
 
+Read `.beads/artifacts/$BEAD_ID/` to check what artifacts exist.
+
 Verify:
 
 - Bead exists and is `in_progress`
@@ -73,7 +75,7 @@ Checkpoint only at `checkpoint:human-verify` or `checkpoint:decision` tasks.
 ## Step 3: REVIEW
 
 ```bash
-BASE_SHA=$(git rev-parse origin/main 2>/dev/null || git rev-parse HEAD~$(git log --oneline | wc -l | tr -d ' '))
+BASE_SHA=$(git rev-parse origin/main 2>/dev/null || git merge-base HEAD origin/main)
 HEAD_SHA=$(git rev-parse HEAD)
 ```
 

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

@@ -10,7 +10,7 @@ Create a detailed implementation plan with TDD steps. Optional deep-planning bet
 
 > **Workflow:** `/create` → `/start <id>` → **`/plan <id>`** (optional) → `/ship <id>`
 >
-> ⛔ Bead MUST be `in_progress` with `prd.md`. Use `/start` first.
+> Bead MUST be `in_progress` with `prd.md`. Use `/start` first.
 >
 > **When to use:** Complex tasks where PRD verification steps aren't enough guidance. Skip for simple tasks.
 
@@ -97,9 +97,10 @@ task({
 
 ```bash
 br show $ARGUMENTS
-ls .beads/artifacts/$ARGUMENTS/
 ```
 
+Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
+
 Verify:
 
 - Bead is `in_progress`
@@ -125,24 +126,23 @@ Before research, determine discovery level based on PRD:
 **Decision:** Ask user to confirm or adjust:
 
 ```typescript
-const suggestedLevel = assessDiscoveryLevel(prdContent);
-
 question({
   questions: [
     {
       header: "Discovery Level",
-      question: `Suggested: Level ${suggestedLevel} (${getLevelDescription(suggestedLevel)}). Proceed?`,
+      question: "Suggested discovery level based on PRD complexity. Proceed?",
       options: [
-        { label: `Yes, Level ${suggestedLevel} (Recommended)` },
-        { label: "Lower (less research)", description: "If you know the patterns" },
-        { label: "Higher (more research)", description: "If uncertain about approach" },
-        { label: "Skip research", description: "I know the codebase" },
+        { label: "Deep (Recommended for complex work)", description: "Level 2-3: spawn scout + explore agents" },
+        { label: "Standard", description: "Level 1: quick doc lookup" },
+        { label: "Skip research", description: "Level 0: I know the codebase" },
       ],
     },
   ],
 });
 ```
 
+Determine level from PRD content: Level 2+ if new library, external API, or "choose/evaluate" language. Level 3 if "architecture/design/system".
+
 ## Phase 3: Research (if Level 1-3)
 
 Read the PRD and extract tasks, success criteria, affected files, scope.

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

@@ -53,9 +53,10 @@ If bead ID provided:
 
 ```bash
 br show $ARGUMENTS
-ls .beads/artifacts/$ARGUMENTS/
 ```
 
+Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
+
 Read the PRD to extract goal and success criteria for the PR description.
 
 ## Phase 2B: Pre-PR Review
@@ -115,6 +116,9 @@ git push -u origin $(git branch --show-current)
 ## Phase 4: Create PR
 
 ```bash
+# Verify gh CLI is installed
+command -v gh >/dev/null 2>&1 || { echo "Error: gh CLI not found. Install: https://cli.github.com"; exit 1; }
+
 gh pr create --title "<title>" --body "$(cat <<'EOF'
 ## Summary
 

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

@@ -33,13 +33,13 @@ If not on the right branch, check out the feature branch. If uncommitted changes
 
 ## Phase 3: Find Handoff
 
-Check for handoff notes:
+Check for handoff notes in the memory system:
 
-```bash
-ls .beads/artifacts/$ARGUMENTS/handoffs/ 2>/dev/null
+```typescript
+memory_read({ file: "handoffs/$ARGUMENTS" });
 ```
 
-If a handoff exists, read the latest one. It tells you:
+If a handoff exists, it tells you:
 
 - What was completed
 - Where work stopped

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

@@ -37,7 +37,7 @@ skill({ name: "requesting-code-review" });
 | `explore`    | Finding patterns in codebase, prior art |
 | `scout`      | External research, best practices       |
 | `lsp`        | Finding symbol definitions, references  |
-| `grep`       | Finding code patterns                   |
+| `tilth_tilth_search` | Finding code patterns |
 | `codesearch` | Real-world usage examples               |
 
 ## Phase 1: Gather Context
@@ -66,7 +66,7 @@ If bead provided, read `.beads/artifacts/$ID/prd.md` to review against spec.
 
 If bead provided, read `.beads/artifacts/$ID/prd.md` to review against spec.
 
-## Phase 2: Automated Checks
+## Phase 3: Automated Checks
 
 Detect project type and run the appropriate checks in parallel:
 
@@ -86,7 +86,7 @@ Also scan for common issues appropriate to the detected language:
 - `TODO|FIXME|HACK` markers
 - Hardcoded secrets patterns
 
-## Phase 3: Manual Review
+## Phase 4: Manual Review
 
 Review each category:
 
@@ -105,7 +105,7 @@ Review each category:
 - Default: Full automated + manual review
 - `--thorough`: Deep analysis of all categories
 
-## Phase 4: Report
+## Phase 5: Report
 
 Group findings by severity:
 

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

@@ -10,7 +10,7 @@ Execute PRD tasks, verify each passes, run review, close the bead.
 
 > **Workflow:** `/create` → `/start <id>` → **`/ship <id>`**
 >
-> ⛔ Bead MUST be `in_progress` with `prd.md`. Run `/start` first if not.
+> Bead MUST be `in_progress` with `prd.md`. Run `/start` first if not.
 
 ## Load Skills
 
@@ -43,7 +43,7 @@ skill({ name: "verification-before-completion" });
 | `explore` | Finding patterns in codebase, prior art   |
 | `scout`   | External research, best practices         |
 | `lsp`     | Finding symbol definitions, references    |
-| `grep`    | Finding code patterns                     |
+| `tilth_tilth_search` | Finding code patterns |
 | `task`    | Spawning subagents for parallel execution |
 
 ## Phase 1: Guards
@@ -59,9 +59,7 @@ Verify:
 
 Check what artifacts exist:
 
-```bash
-ls .beads/artifacts/$ARGUMENTS/
-```
+Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
 
 ## Phase 2: Route to Execution
 
@@ -203,7 +201,7 @@ Follow the [Verification Protocol](../skill/verification-before-completion/refer
 - All 4 gates must pass before proceeding to commit/push
 - Also run PRD `Verify:` commands
 
-## Phase 6: Review
+## Phase 5: Review
 
 Load and run the review skill:
 
@@ -267,7 +265,7 @@ return Response.json({ok: true})  // Static, not query result
 
 If any artifact fails Level 2 or 3 → fix → re-verify.
 
-## Phase 7: Close
+## Phase 6: Close
 
 Ask user before closing:
 

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

@@ -56,9 +56,10 @@ br list --status=in_progress
 
 ```bash
 br show $ARGUMENTS
-ls .beads/artifacts/$ARGUMENTS/
 ```
 
+Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
+
 Verify `prd.md` exists and has real content (not just placeholders). If missing or incomplete, tell user to run `/create` first.
 
 ## Phase 3: Claim
@@ -107,18 +108,15 @@ Map bead type to branch prefix:
 | task      | task          |
 | epic      | epic          |
 
+Create the branch:
+
 ```bash
-PREFIX=$(case "$BEAD_TYPE" in
-  feature) echo "feat" ;;
-  bug) echo "fix" ;;
-  task) echo "task" ;;
-  epic) echo "epic" ;;
-  *) echo "task" ;;
-esac)
-TITLE_SLUG=$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')
-git checkout -b $PREFIX/$ARGUMENTS-$TITLE_SLUG
+# Example: feat/br-42-add-auth
+git checkout -b $PREFIX/$BEAD_ID-$TITLE_SLUG
 ```
 
+Slugify the title (lowercase, spaces to hyphens) and use the bead type to determine the prefix.
+
 **If worktree selected:**
 
 ```typescript

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

@@ -63,7 +63,7 @@ git log --oneline -5
 ```
 
 ```typescript
-find_sessions({ query: "today", limit: 5 });
+find_sessions({ query: "<project-name or recent-bead-keywords>", limit: 5 });
 ```
 
 ---

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

@@ -19,12 +19,12 @@ skill({ name: "accessibility-audit" }); // Keyboard/focus/contrast checks
 
 ## Parse Arguments
 
-| Argument        | Default | Description                                        |
-| --------------- | ------- | -------------------------------------------------- | ----------------------------------------------------------- |
-| `[path          | auto]`  | `auto`                                             | Specific file/dir to audit, or auto-detect changed UI files |
-| `--staged`      | false   | Audit staged changes only (`git diff --cached`)    |
-| `--since=<ref>` | `HEAD`  | Compare against ref (`main`, `HEAD~1`, commit SHA) |
-| `--full-report` | false   | Include all categories even when no issues found   |
+| Argument        | Default | Description                                                   |
+| --------------- | ------- | ------------------------------------------------------------- |
+| `[path\|auto]`  | `auto`  | Specific file/dir to audit, or auto-detect changed UI files   |
+| `--staged`      | false   | Audit staged changes only (`git diff --cached`)               |
+| `--since=<ref>` | `HEAD`  | Compare against ref (`main`, `HEAD~1`, commit SHA)            |
+| `--full-report` | false   | Include all categories even when no issues found              |
 
 ## Phase 1: Resolve Target Files
 

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

@@ -45,11 +45,10 @@ skill({ name: "verification-before-completion" });
 Before running any gates, check if a recent verification is still valid:
 
 ```bash
-# Compute current state fingerprint (commit hash + full diff + untracked files)
-CURRENT_STAMP=$(printf '%s\n%s\n%s' \
+# Compute current state fingerprint (commit hash + diff)
+CURRENT_STAMP=$(printf '%s\n%s' \
   "$(git rev-parse HEAD)" \
   "$(git diff HEAD -- '*.ts' '*.tsx' '*.js' '*.jsx')" \
-  "$(git ls-files --others --exclude-standard -- '*.ts' '*.tsx' '*.js' '*.jsx' | xargs cat 2>/dev/null)" \
   | shasum -a 256 | cut -d' ' -f1)
 LAST_STAMP=$(tail -1 .beads/verify.log 2>/dev/null | awk '{print $1}')
 ```
@@ -70,9 +69,10 @@ Verification: cached PASS (no changes since <timestamp from verify.log>)
 
 ```bash
 br show $ARGUMENTS
-ls .beads/artifacts/$ARGUMENTS/
 ```
 
+Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
+
 Read the PRD and any other artifacts (plan.md, research.md, design.md).
 
 **Verify guards:**

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

@@ -36,7 +36,7 @@
 	"compress": {
 		// "range" (stable) compresses spans into block summaries
 		// "message" (experimental) compresses individual raw messages
-		"mode": "message",
+		"mode": "range",
 		// "allow" (no prompt) | "ask" (prompt) | "deny" (tool not registered)
 		"permission": "allow",
 		"showCompression": false,

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

@@ -82,8 +82,6 @@
     ".opencode/memory/project/user.md",
     ".opencode/memory/project/tech-stack.md",
     ".opencode/memory/project/project.md",
-    ".opencode/memory/project/roadmap.md",
-    ".opencode/memory/project/state.md",
     ".opencode/context/git-context.md"
   ],
   "keybinds": {
@@ -92,7 +90,7 @@
   },
   "mcp": {
     "tilth": {
-      "command": ["tilth", "--mcp", "--edit"],
+      "command": ["npx", "-y", "tilth", "--mcp", "--edit"],
       "enabled": true,
       "environment": {
         "TILTH_THREADS": "8"

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

@@ -1,7 +1,7 @@
 ---
 name: context-initialization
-description: Initialize GSD-style project context files from templates
-version: 1.0.0
+description: Initialize project context files from templates. Creates on-demand planning files (roadmap.md, state.md) and updates auto-injected project.md.
+version: 2.0.0
 tags: [context, workflow]
 dependencies: []
 ---
@@ -11,20 +11,19 @@ dependencies: []
 ## When to Use
 
 - When initializing project context files (project.md, roadmap.md, state.md) from templates.
+- project.md is auto-injected into every prompt; roadmap.md and state.md are on-demand.
 
 ## When NOT to Use
 
 - When context files already exist and only need minor manual edits.
 
-
 ## Process
 
 ### 1. Verify Templates
 
-```bash
-test -f .opencode/memory/_templates/project.md
-test -f .opencode/memory/_templates/roadmap.md
-test -f .opencode/memory/_templates/state.md
+```typescript
+tilth_tilth_files({ pattern: "*.md", scope: ".opencode/memory/_templates" });
+// Required templates: project.md, roadmap.md, state.md
 ```
 
 Stop if missing.
@@ -43,28 +42,28 @@ Skip if `--skip-questions` flag set.
 
 ### 3. Create Files
 
-**project.md**
+**project.md** (auto-injected — keep concise)
 
-- Read template
+- Read template via `Read({ filePath: ".opencode/memory/_templates/project.md" })`
 - Fill with answers
-- Write to `.opencode/memory/project/`
+- Write via `memory-update({ file: "project/project", content: ..., mode: "replace" })`
 
-**roadmap.md**
+**roadmap.md** (on-demand — access via `memory-read({ file: "project/roadmap" })`)
 
 - Read template
 - Parse phases into table
-- Write to `.opencode/memory/project/`
+- Write via `memory-update({ file: "project/roadmap", content: ..., mode: "replace" })`
 
-**state.md**
+**state.md** (on-demand — access via `memory-read({ file: "project/state" })`)
 
 - Read template
 - Set initial state
-- Write to `.opencode/memory/project/`
+- Write via `memory-update({ file: "project/state", content: ..., mode: "replace" })`
 
 ### 4. Verify
 
-```bash
-ls .opencode/memory/project/
+```typescript
+tilth_tilth_files({ pattern: "*.md", scope: ".opencode/memory/project" });
 ```
 
-Report created files.
+Report created files with their injection status (auto-injected vs on-demand).

package/dist/template/.opencode/skill/tilth-cli/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: tilth-cli
 description: AST-aware code navigation via tilth CLI. Use when subagents need structural code search, smart file reading, or codebase mapping — complements MCP tilth (which only the main agent can access).
-version: 1.1.0
+version: 2.0.0
 tags: [code-navigation, search, subagent]
 dependencies: []
 ---
@@ -58,20 +58,31 @@ Output: numbered lines (`N  content`). Large files get a structural outline; use
 ```bash
 npx -y tilth initCommand --scope src/           # Find definition + all usages
 npx -y tilth handleAuth --scope src/auth/       # Scoped to subdirectory
+npx -y tilth "sym1,sym2" --scope src/            # Multi-symbol search (max 5)
 ```
 
 Returns: definitions first (with expanded source), then usages with context lines.
 
-### 3. Search for Text
+### 3. Search for Text / Regex
 
 ```bash
 npx -y tilth "TODO" --scope src/                # Literal text search
 npx -y tilth "version" --scope src/             # Finds all occurrences
+npx -y tilth --kind content "config" --scope src/  # Explicit content search
+npx -y tilth --kind regex "/TODO.*fix/" --scope src/  # Regex search
 ```
 
-tilth auto-detects text vs symbol. Identifiers (camelCase, snake_case) → symbol search. Multi-word or quoted strings → text search.
+tilth auto-detects text vs symbol. Identifiers (camelCase, snake_case) → symbol search. Multi-word or quoted strings → text search. Use `--kind` to force a specific search mode.
 
-### 4. List Files (Glob)
+### 4. Find Callers
+
+```bash
+npx -y tilth --kind callers initCommand --scope src/  # Find all call sites
+```
+
+Uses SIMD-accelerated pre-filtering + tree-sitter AST parsing. More accurate than text grep for finding actual function calls vs. comments/strings.
+
+### 5. List Files (Glob)
 
 ```bash
 npx -y tilth "*.test.ts" --scope src/           # List test files
@@ -80,27 +91,37 @@ npx -y tilth "*.ts" --scope src/commands/       # List TS files in subdir
 
 Returns: matched file paths with token size estimates.
 
-### 5. Codebase Map (CLI-Only)
+### 6. Blast-Radius Analysis (Deps)
+
+```bash
+npx -y tilth --deps src/utils/errors.ts         # What imports this file + what it imports
+npx -y tilth --deps src/commands/init.ts --scope src/  # Scoped dependency check
+```
+
+Shows imports (local + external) AND what other files call its exports, with symbol-level detail. Use before renaming/removing exports.
+
+### 7. Codebase Map (CLI-Only)
 
 ```bash
 npx -y tilth --map --scope src/                 # Structural skeleton
 npx -y tilth --map --scope .                    # Whole project
 ```
 
-Returns: directory tree with exported symbols per file. **CLI-only** — not available in MCP mode.
+Returns: directory tree with exported symbols per file. **CLI-only** — deliberately excluded from MCP (agents overuse it).
 
 ## Available Flags
 
-| Flag                | Purpose                                | Example              |
-| ------------------- | -------------------------------------- | -------------------- |
-| `--scope <DIR>`     | Restrict search to directory           | `--scope src/`       |
-| `--section <RANGE>` | Line range or heading for file reads   | `--section 45-89`    |
-| `--full`            | Force full file content (skip outline) | `--full`             |
-| `--budget <N>`      | Max tokens in response                 | `--budget 2000`      |
-| `--json`            | Machine-readable JSON output           | `--json`             |
-| `--map`             | Generate codebase structure map        | `--map --scope src/` |
-
-**Note:** `--kind`, `--deps`, `--expand`, and multi-symbol comma syntax are MCP-only features. The CLI does not support them.
+| Flag                | Purpose                                  | Example                     |
+| ------------------- | ---------------------------------------- | --------------------------- |
+| `--scope <DIR>`     | Restrict search to directory             | `--scope src/`              |
+| `--section <RANGE>` | Line range or heading for file reads     | `--section 45-89`           |
+| `--full`            | Force full file content (skip outline)   | `--full`                    |
+| `--budget <N>`      | Max tokens in response                   | `--budget 2000`             |
+| `--json`            | Machine-readable JSON output             | `--json`                    |
+| `--map`             | Generate codebase structure map          | `--map --scope src/`        |
+| `--kind <TYPE>`     | Force search type: symbol/content/regex/callers | `--kind callers`     |
+| `--deps`            | Show blast-radius (imports + dependents) | `--deps src/file.ts`        |
+| `--expand <N>`      | Top N matches to show full source        | `--expand 3`                |
 
 ## MCP vs CLI Comparison
 
@@ -108,10 +129,10 @@ Returns: directory tree with exported symbols per file. **CLI-only** — not ava
 | ------------------------------------- | ---------------- | ------------------- |
 | Session dedup (`[shown earlier]`)     | Yes              | No                  |
 | Hash-anchored editing (`tilth_edit`)  | Yes              | No                  |
-| Blast-radius analysis (`tilth_deps`)  | Yes              | No                  |
-| Multi-symbol search (`sym1,sym2`)     | Yes              | No                  |
-| `--kind` flag (content/regex/callers) | Yes              | No                  |
-| `--expand` control                    | Yes              | No                  |
+| Blast-radius analysis (`--deps`)      | Yes              | Yes (v0.5.7+)       |
+| Multi-symbol search (`sym1,sym2`)     | Yes              | Yes (v0.5.7+)       |
+| `--kind` flag (content/regex/callers) | Yes              | Yes (v0.5.7+)       |
+| `--expand` control                    | Yes              | Yes (v0.5.7+)       |
 | `--map` codebase skeleton             | No               | Yes                 |
 | Subagent access                       | No (main only)   | Yes (any with Bash) |
 | Process overhead                      | Once (~17ms)     | Per call (~17ms)    |
@@ -161,6 +182,8 @@ utils/
 - **Use `--scope`** to narrow searches — avoids scanning irrelevant directories
 - **Use `--budget`** when you need concise output (limits token count)
 - **~17ms per call** — fast enough for interactive use, but avoid unnecessary repeated calls
+- **Use `--kind callers`** for precise call-site analysis instead of text grep
+- **Use `--deps`** before renaming or removing exports to check blast radius
 
 ## Example Subagent Dispatch
 
@@ -171,6 +194,10 @@ task({
 
 Find the definition of \`initCommand\` and understand how it's called:
   npx -y tilth initCommand --scope src/
+  npx -y tilth --kind callers initCommand --scope src/
+
+Check blast radius before editing:
+  npx -y tilth --deps src/commands/init.ts
 
 Then read the relevant file section:
   npx -y tilth src/commands/init.ts --section 515-600

package/package.json

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