opencodekit 0.13.2 → 0.14.1

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

@@ -115,23 +115,32 @@ git status
 git diff --cached --stat
 ```
 
-**Present to user:**
+**Use question tool to get commit decision:**
 
+```typescript
+question({
+  questions: [
+    {
+      header: "Commit",
+      question: "Fix Complete: $ARGUMENTS. What should I do next?",
+      options: [
+        {
+          label: "Commit changes (Recommended)",
+          description: "Git commit and bd sync",
+        },
+        {
+          label: "Show diff first",
+          description: "Review changes before committing",
+        },
+        {
+          label: "Skip commit",
+          description: "I'll review and commit manually",
+        },
+      ],
+    },
+  ],
+});
 ```
-Fix Complete: $ARGUMENTS
-━━━━━━━━━━━━━━━━━━━━━━━
-
-Root cause: [brief]
-Changes: [files]
-Tests: Pass ✓
-
-Would you like me to:
-1. Commit these changes
-2. Show full diff first
-3. Skip commit (I'll review manually)
-```
-
-**Wait for user confirmation before committing.**
 
 If user confirms:
 

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

@@ -46,6 +46,23 @@ git commit -m "WIP: $ARGUMENTS - [where you stopped]"
 
 Don't leave uncommitted work. The next session needs a clean starting point.
 
+## Record Key Learnings (Before Handoff)
+
+If you discovered important patterns or gotchas during this session:
+
+```typescript
+observation({
+  type: "learning", // or "pattern", "decision", "warning"
+  title: "[concise, searchable title]",
+  content: "[what you learned - specific and actionable]",
+  bead_id: "$ARGUMENTS",
+  files: "[affected files]",
+  concepts: "[keywords for semantic search]",
+});
+```
+
+**This auto-embeds** into the vector store. The next `/resume` will find it.
+
 ## Create The Handoff
 
 ```bash

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

@@ -67,7 +67,25 @@ If dirty, ask whether to stash, commit, or continue.
 Create a branch if not already on one for this task:
 
 ```bash
-git checkout -b $ARGUMENTS 2>/dev/null || echo "Already on branch"
+# Get current branch (parent branch)
+PARENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# Get task title for readable branch name
+BEAD_INFO=$(bd show $ARGUMENTS --json 2>/dev/null)
+BEAD_TITLE=$(echo "$BEAD_INFO" | jq -r '.title // ""' | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | cut -c1-40)
+BEAD_TYPE=$(echo "$BEAD_INFO" | jq -r '.type // "task"')
+
+# Map bead type to branch prefix
+case "$BEAD_TYPE" in
+  "bug") PREFIX="fix" ;;
+  "feature"|"epic") PREFIX="feat" ;;
+  "refactor") PREFIX="refactor" ;;
+  *) PREFIX="feat" ;;
+esac
+
+# Create branch: <parent>/<type>/<bead-id>-<description>
+BRANCH_NAME="${PARENT_BRANCH}/${PREFIX}/$ARGUMENTS-${BEAD_TITLE}"
+git checkout -b "$BRANCH_NAME" 2>/dev/null || echo "Already on branch"
 ```
 
 Mark the task in progress (if not already):
@@ -98,6 +116,44 @@ search_session({ query: "$ARGUMENTS" });
 read_session({ session_reference: "last" });
 ```
 
+## Load Related Memory (Semantic Search)
+
+First, get a quick codebase overview:
+
+```typescript
+// Quick overview of relevant directories
+repo - map({ path: "src", format: "compact", maxDepth: 3 });
+```
+
+Then search for relevant patterns and learnings:
+
+```typescript
+// Find similar past work
+memory -
+  search({
+    query: "[task description from bead]",
+    mode: "semantic",
+    limit: 3,
+  });
+
+// Find related gotchas and patterns
+memory -
+  search({
+    query: "[technology/domain keywords]",
+    mode: "semantic",
+    type: "observation",
+    limit: 3,
+  });
+```
+
+**Review findings before implementation.** Past observations may contain:
+
+- Gotchas to avoid (save debugging time)
+- Patterns that worked well (reuse them)
+- Decisions already made (don't re-decide)
+
+If memory search fails (Ollama not running), continue without it.
+
 ## Parallel Subagent Research (if --parallel or complex task)
 
 **Delegation Pattern: Fire and Continue**
@@ -258,26 +314,33 @@ git status
 git diff --cached --stat
 ```
 
-**Present to user:**
-
-```
-Implementation Complete: $ARGUMENTS
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Type: [epic/task/subtask]
-Tests: Pass ✓
-Changes: [files modified]
+**Use question tool to get commit decision:**
 
-Subtasks: [N completed / M total] (if applicable)
-
-Would you like me to:
-1. Commit these changes
-2. Show full diff first
-3. Skip commit (I'll review manually)
+```typescript
+question({
+  questions: [
+    {
+      header: "Commit",
+      question: "Implementation Complete: $ARGUMENTS. What should I do next?",
+      options: [
+        {
+          label: "Commit changes (Recommended)",
+          description: "Git commit and bd sync",
+        },
+        {
+          label: "Show diff first",
+          description: "Review changes before committing",
+        },
+        {
+          label: "Skip commit",
+          description: "I'll review and commit manually",
+        },
+      ],
+    },
+  ],
+});
 ```
 
-**Wait for user confirmation before committing.**
-
 If user confirms:
 
 ```bash

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

@@ -46,7 +46,7 @@ Before importing, check for existing beads with similar titles:
 
 Compare plan titles against existing beads:
 
-```
+````
 Duplicate Check:
 ━━━━━━━━━━━━━━━━
 
@@ -59,8 +59,19 @@ Options:
 2. Force import (create duplicates)
 3. Cancel import
 
-Select option (1/2/3):
-```
+```typescript
+question({
+  questions: [{
+    header: "Duplicates",
+    question: "Potential duplicates found. What should I do?",
+    options: [
+      { label: "Skip duplicates (Recommended)", description: "Import only new items" },
+      { label: "Force import", description: "Create duplicate beads anyway" },
+      { label: "Cancel import", description: "Stop and review plan" }
+    ]
+  }]
+});
+````
 
 If `--force` flag set, skip this check and import everything.
 
@@ -78,7 +89,7 @@ Parse the plan for:
 
 Report:
 
-```
+````
 Plan Analysis: [filename]
 ━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -95,10 +106,21 @@ Structure:
 │   └── [Issue 1] [L] → depends on [Epic 1/Issue 2]
 └── ...
 
-Proceed with import? (yes/modify/cancel)
-```
-
-**STOP and wait for approval** (unless `--dry-run`, then just show preview).
+```typescript
+question({
+  questions: [{
+    header: "Import",
+    question: "Plan analyzed. Should I proceed with import?",
+    options: [
+      { label: "Proceed with import (Recommended)", description: "Create epics and issues" },
+      { label: "Modify plan", description: "Need changes before importing" },
+      { label: "Cancel", description: "Stop and review plan" }
+    ]
+  }]
+});
+````
+
+**STOP and wait for user approval** (unless `--dry-run`, then just show preview).
 
 ---
 

package/dist/template/.opencode/command/new-feature.md

@@ -142,10 +142,34 @@ Key risks identified:
 - [Risk 1]: Mitigation: [...]
 - [Risk 2]: Mitigation: [...]
 
-Proceed with spec? (yes/modify/explore-more)
 ```
 
-**STOP and wait for approval** before proceeding.
+**STOP. Use question tool to get user approval:**
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Approve",
+      question:
+        "Should I proceed with creating the specification for $ARGUMENTS?",
+      options: [
+        {
+          label: "Yes, proceed",
+          description: "Approach looks good, create spec",
+        },
+        {
+          label: "Modify approach",
+          description: "Need changes to brainstorming",
+        },
+        { label: "Explore more", description: "Need more research first" },
+      ],
+    },
+  ],
+});
+```
+
+**Wait for user's answer before proceeding to spec creation.**
 
 ---
 
@@ -398,8 +422,17 @@ skill({ name: "using-git-worktrees" });
 # Ensure .gitignore has worktree directory
 grep -q "^\.worktrees/$" .gitignore || echo ".worktrees/" >> .gitignore
 
-# Create worktree for the epic
-git worktree add .worktrees/[epic-id] -b feature/[feature-name]
+# Get current branch (parent branch)
+PARENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# Create readable branch name from feature name
+FEATURE_SLUG=$(echo "[feature-name]" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | cut -c1-40)
+
+# Create branch: <parent>/feat/<epic-id>-<description>
+BRANCH_NAME="${PARENT_BRANCH}/feat/[epic-id]-${FEATURE_SLUG}"
+
+# Create worktree for the epic with readable branch
+git worktree add ".worktrees/[epic-id]" -b "$BRANCH_NAME"
 
 # Setup in worktree
 cd .worktrees/[epic-id]

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

@@ -37,6 +37,38 @@ cat .beads/artifacts/$ARGUMENTS/research.md 2>/dev/null || echo "No research fou
 
 **If complexity > M and no research:** "Consider `/research $ARGUMENTS` first for better planning."
 
+## Check Memory First (Semantic Search)
+
+Before subagent research, check what we already know:
+
+```typescript
+// Find similar past plans
+memory -
+  search({
+    query: "[bead title/description]",
+    mode: "semantic",
+    type: "bead",
+    limit: 3,
+  });
+
+// Find related patterns and decisions
+memory -
+  search({
+    query: "[domain keywords]",
+    mode: "semantic",
+    type: "observation",
+    limit: 3,
+  });
+```
+
+Review findings for:
+
+- Similar plans that worked well (reuse structure)
+- Patterns and decisions already made
+- Gotchas to avoid in planning
+
+If memory search fails (Ollama not running), continue to subagent research.
+
 ---
 
 ## Phase 1: Parallel Subagent Research
@@ -154,7 +186,25 @@ Decomposition: [Single bead | X tasks | X tasks with subtasks]
 
 Save to `.beads/artifacts/$ARGUMENTS/design.md`.
 
-**STOP. Wait for user to pick an option.**
+**STOP. Use question tool to ask user to pick an option:**
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Design",
+      question: "Which implementation approach should I use for $ARGUMENTS?",
+      options: [
+        { label: "Option A (Recommended)", description: "[Option A summary]" },
+        { label: "Option B", description: "[Option B summary]" },
+        { label: "Option C", description: "[Option C summary]" },
+      ],
+    },
+  ],
+});
+```
+
+Wait for user's answer before proceeding.
 
 ---
 

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

@@ -120,23 +120,33 @@ git log origin/$(git branch --show-current)..HEAD --oneline 2>/dev/null || git l
 git diff --stat origin/$(git branch --show-current)..HEAD 2>/dev/null || git diff --stat HEAD~3..HEAD
 ```
 
-**Present to user:**
+**Use question tool to get push/PR decision:**
 
+```typescript
+question({
+  questions: [
+    {
+      header: "Push",
+      question: "Ready to push and create PR for $ARGUMENTS. What should I do?",
+      options: [
+        {
+          label: "Push & create PR (Recommended)",
+          description: "Push branch and create PR",
+        },
+        { label: "Push & draft PR", description: "Create as draft for review" },
+        {
+          label: "Show diff first",
+          description: "Review changes before pushing",
+        },
+        {
+          label: "Skip (I'll push manually)",
+          description: "Handle PR creation manually",
+        },
+      ],
+    },
+  ],
+});
 ```
-Ready to Push & Create PR
-━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Branch: [current branch]
-Commits: [N commits ahead of origin]
-
-Would you like me to:
-1. Push and create PR
-2. Push and create draft PR
-3. Show full diff first
-4. Skip (I'll push manually)
-```
-
-**Wait for user confirmation before proceeding.**
 
 If user confirms, push:
 

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

@@ -17,6 +17,19 @@ You're gathering information before implementation. Find answers, document findi
 
 ## Load Context
 
+### Get Quick Codebase Overview
+
+First, understand the codebase structure:
+
+```typescript
+// Quick overview of relevant directories
+repo-map({ path: "src", format: "compact", maxDepth: 3 });
+```
+
+This helps identify relevant directories and files before diving deeper.
+
+### Load Bead Details
+
 !`bd show $ARGUMENTS`
 !`cat .beads/artifacts/$ARGUMENTS/spec.md`
 
@@ -29,14 +42,38 @@ Extract questions that need answering from spec.
 
 Extract the questions that need answering from the spec.
 
-## Check For Previous Research
+## Check Memory First (Semantic Search)
+
+Before hitting external sources, search what we already know:
 
 ```typescript
-search_session({ query: "[topic keywords]" });
-list_sessions({ project: "current", since: "this week", limit: 5 });
+// Search past research and observations on similar topics
+memory -
+  search({
+    query: "[research question/topic]",
+    mode: "semantic",
+    limit: 5,
+  });
+
+// Search for related gotchas and learnings
+memory -
+  search({
+    query: "[topic keywords]",
+    mode: "semantic",
+    type: "observation",
+    limit: 3,
+  });
 ```
 
-Don't duplicate work that's already been done.
+**If memory has high-confidence answers, you may skip external research.**
+
+Review findings for:
+
+- Previous research on this exact topic
+- Related patterns and decisions
+- Known gotchas to avoid
+
+If memory search fails (Ollama not running), continue to external sources.
 
 ## Source Priority
 
@@ -49,7 +86,26 @@ Don't duplicate work that's already been done.
 
 ## Research
 
-### Internal Codebase
+### Internal Codebase - Get Quick Overview
+
+First, generate a compact repository map to understand the codebase structure:
+
+```typescript
+// Quick overview of relevant directories
+repo-map({ path: "src", format: "compact", maxDepth: 3 });
+
+// For specific feature area
+repo-map({ path: "src/commands", format: "tree", maxDepth: 2 });
+```
+
+**Use repo-map when:**
+
+- Starting research on a new area of the codebase
+- Need to understand file organization before diving deep
+- Looking for relevant files to investigate
+- Want quick symbol overview for a directory
+
+### Deep Dive
 
 ```typescript
 // Find similar patterns

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

@@ -71,6 +71,37 @@ Extract from session:
 - Where work stopped
 - Problems encountered
 
+## Load Related Memory (Semantic Search)
+
+Search for relevant observations and past work:
+
+```typescript
+// Find observations related to this bead
+memory -
+  search({
+    query: "$ARGUMENTS [bead title/description]",
+    mode: "semantic",
+    type: "observation",
+    limit: 5,
+  });
+
+// Find similar past work
+memory -
+  search({
+    query: "[bead description keywords]",
+    mode: "semantic",
+    limit: 3,
+  });
+```
+
+**Review findings** - past observations may contain:
+
+- Gotchas discovered during previous sessions
+- Decisions already made
+- Patterns that worked
+
+If memory search fails (Ollama not running), continue without it.
+
 ## Load Artifacts
 
 Read all available context:

package/dist/template/.opencode/command/revert-feature.md

@@ -99,7 +99,7 @@ Before reverting, check what depends on this:
 
 ### Downstream Report
 
-```
+````
 Downstream Impact Analysis
 ━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -119,8 +119,20 @@ Feature flags:
 - AUTH_ENABLED flag in production
 
 CAUTION: Reverting may break dependent features.
-Proceed? (yes/abort/revert-cascade)
-```
+
+```typescript
+question({
+  questions: [{
+    header: "Confirm",
+    question: "Ready to revert $ARGUMENTS? Breaking changes detected.",
+    options: [
+      { label: "Proceed with revert", description: "Execute revert with backups" },
+      { label: "Abort", description: "Cancel this operation" },
+      { label: "Revert cascade", description: "Revert dependent features too" }
+    ]
+  }]
+});
+````
 
 ---