opencodekit 0.12.6 → 0.12.7

package/dist/template/.opencode/command/analyze-mockup.md

@@ -3,6 +3,7 @@ description: Analyze UI mockup or screenshot with structured output
 argument-hint: "<image-path> [focus: layout|colors|components|typography|a11y|all] [--quick|--deep] [--compare <file>]"
 agent: vision
 model: proxypal/gemini-3-flash-preview
+subtask: true
 ---
 
 # Analyze Mockup: $ARGUMENTS

package/dist/template/.opencode/command/analyze-project.md

@@ -1,7 +1,8 @@
 ---
 description: Analyze project health, status, and ready work with metrics
 argument-hint: "[--quick|--deep|--health|--security]"
-agent: planner
+agent: explore
+subtask: true
 ---
 
 # Analyze Project

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

@@ -1,7 +1,8 @@
 ---
 description: Brainstorm and explore ideas with structured ideation
 argument-hint: "<topic or bead-id> [--quick]"
-agent: build
+agent: planner
+subtask: true
 ---
 
 # Brainstorm: $ARGUMENTS

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

@@ -3,6 +3,7 @@ description: Audit design system from screenshots or codebase
 argument-hint: "<screenshots-path|codebase|both> [output: tokens|report|both] [--quick|--deep]"
 agent: vision
 model: proxypal/gemini-3-pro-preview
+subtask: true
 ---
 
 # Design Audit: $ARGUMENTS

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

@@ -76,11 +76,38 @@ Read the spec and check each criterion:
 
 For each success criterion listed, run its verification. All must pass. If something's missing, go back and implement it.
 
-## Commit Everything
+## Review Changes (Ask Before Commit)
+
+Show what would be committed:
 
 ```bash
 git add -A
 git status
+git diff --cached --stat
+```
+
+**Present the changes to the user:**
+
+```
+Ready to Commit
+━━━━━━━━━━━━━━
+
+Files changed:
+[list from git status]
+
+Summary: $ARGUMENTS - [what was done]
+
+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 proceeding.**
+
+If user confirms commit:
+
+```bash
 git commit -m "$ARGUMENTS: [what was done]
 
 - [change 1]
@@ -89,14 +116,22 @@ git commit -m "$ARGUMENTS: [what was done]
 Closes: $ARGUMENTS"
 ```
 
-## Close The Task
+## Close The Task (Ask First)
+
+**Ask the user:**
+
+```
+Close bead $ARGUMENTS?
+- Yes, close it
+- No, keep it open for now
+```
+
+If user confirms:
 
 ```bash
 bd close $ARGUMENTS --reason "Completed: [1-line summary]"
 ```
 
-This closes the task. Sync separately if needed.
-
 ## Create Review (Optional But Recommended)
 
 If this was non-trivial work, document what happened:

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

@@ -112,21 +112,41 @@ npm test && npm run type-check
 
 ## Complete
 
-If all gates pass:
+If all gates pass, show what was done:
 
 ```bash
 git add -A
-git commit -m "$ARGUMENTS: [summary]"
-bd sync
+git status
+git diff --cached --stat
 ```
 
-Report what was done and suggest next step:
+**Present to user:**
 
 ```
-Done: $ARGUMENTS
+Implementation Complete: $ARGUMENTS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
+Tests: Pass ✓
 Changes: [files modified]
-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:
+
+```bash
+git commit -m "$ARGUMENTS: [summary]"
+bd sync
+```
+
+Suggest next step:
+
+```
 Next: /finish $ARGUMENTS
 ```
 

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

@@ -2,6 +2,7 @@
 description: Initialize project for AI-assisted development (creates AGENTS.md + memory files)
 argument-hint: "[--deep] [--skip-questions]"
 agent: planner
+subtask: true
 ---
 
 # Init: $ARGUMENTS

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

@@ -111,7 +111,34 @@ Extract from artifacts:
 - **Estimation Accuracy** from review.md
 - **Success Criteria** verification
 
-## Phase 4: Push Branch
+## Phase 4: Review Before Push
+
+Show what will be pushed:
+
+```bash
+git log origin/$(git branch --show-current)..HEAD --oneline 2>/dev/null || git log --oneline -5
+git diff --stat origin/$(git branch --show-current)..HEAD 2>/dev/null || git diff --stat HEAD~3..HEAD
+```
+
+**Present to user:**
+
+```
+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:
 
 ```bash
 git push -u origin $(git branch --show-current)

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

@@ -3,6 +3,7 @@ description: Research UI/UX patterns, design systems, and component implementati
 argument-hint: "<topic-or-path> [bead-id] [--audit] [--compare]"
 agent: vision
 model: proxypal/gemini-3-flash-preview
+subtask: true
 ---
 
 # Research UI: $ARGUMENTS

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

@@ -2,6 +2,7 @@
 description: Research a topic or bead before implementation
 argument-hint: "<bead-id> [--quick|--thorough]"
 agent: scout
+subtask: true
 ---
 
 # Research: $ARGUMENTS

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

@@ -2,6 +2,7 @@
 description: Review code for quality, security, and compliance
 argument-hint: "[path|bead-id|pr-number|'all'] [--quick|--thorough]"
 agent: review
+subtask: true
 ---
 
 # Review: $ARGUMENTS

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

@@ -2,6 +2,7 @@
 description: Comprehensive project and session status dashboard
 argument-hint: "[--full] [--health] [--sessions] [--git]"
 agent: explore
+subtask: true
 ---
 
 # Status Dashboard
@@ -32,8 +33,8 @@ Run all status checks simultaneously:
 
 ```typescript
 // Custom tools (message inbox, locks)
-bd-inbox({ n: 5, unread: true, to: "all" });
-bd-release(); // Lists active locks when called with no args
+bd - inbox({ n: 5, unread: true, to: "all" });
+bd - release(); // Lists active locks when called with no args
 
 // Built-in tools
 list_sessions({ project: "current", since: "today", limit: 5 });

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

@@ -1,7 +1,8 @@
 ---
 description: Generate AI summary of sessions for quick context recovery
 argument-hint: "[session_reference] [--compare] [--focus=<topic>]"
-agent: build
+agent: explore
+subtask: true
 ---
 
 # Summarize

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

@@ -3,6 +3,7 @@ description: Review UI/UX design for quality, aesthetics, and best practices
 argument-hint: "<image-or-component-path> [--bead=<id>] [--responsive] [--dark-mode]"
 agent: vision
 model: proxypal/gemini-3-pro-preview
+subtask: true
 ---
 
 # UI Review: $ARGUMENTS

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

@@ -1,26 +1,79 @@
 ---
 purpose: Key modules, directory structure, architectural decisions
-updated: 2024-12-21
+updated: 2025-01-06
 ---
 
 # Project Architecture
 
 ## Directory Structure
 
-<!-- Key directories and their purpose -->
+```
+src/
+  index.ts              # CLI entry point (cac-based)
+  commands/
+    init.ts             # ock init - scaffolds .opencode/
+    agent.ts            # ock agent - manage agents
+    skill.ts            # ock skill - manage skills
+    config.ts           # ock config - edit opencode.json
+    upgrade.ts          # ock upgrade - update templates
+    menu.ts             # Interactive menu, doctor, status
+    completion.ts       # Shell completions
+  utils/
+    logger.ts           # Logging utilities
+    errors.ts           # Error handling
+    safe-prompts.ts     # @clack/prompts wrappers
+
+dist/
+  index.js              # Built CLI bundle
+  template/.opencode/   # Template files copied during init
+
+.opencode/              # OpenCode configuration (source of truth)
+  agent/                # Agent definitions
+  command/              # Workflow commands
+  skills/               # Skills library
+  tool/                 # Custom tools (memory-*, bd-*)
+  plugin/               # OpenCode plugins
+  memory/               # Persistent knowledge
+
+.beads/                 # Task tracking database
+```
 
 ## Key Modules
 
-<!-- Core files/modules and what they do -->
+### CLI (src/index.ts)
+
+Entry point using `cac` library. Registers commands, parses args, handles errors.
+
+### Init Command (src/commands/init.ts)
+
+Core command - copies `.opencode/` template from dist to target project.
+
+### Build Process
+
+1. `bun build` bundles src/index.ts → dist/index.js
+2. rsync copies .opencode/ → dist/template/.opencode/
+3. Published package includes dist/ only
 
 ## Data Flow
 
-<!-- How data moves through the system -->
+```
+User runs: npx opencodekit init
+  → dist/index.js executes
+  → init command copies dist/template/.opencode/ to ./.opencode/
+  → User has full OpenCode setup
+```
 
 ## External Dependencies
 
-<!-- Critical third-party services, APIs -->
+- **cac**: CLI framework
+- **@clack/prompts**: Interactive prompts
+- **zod**: Schema validation
+- **beads-village**: Task tracking integration
+- **@opencode-ai/plugin**: Plugin SDK
 
 ## Architectural Decisions
 
-<!-- Why things are structured this way -->
+1. **Bun-first**: Uses Bun for speed, but builds to Node-compatible output
+2. **Template bundling**: .opencode/ copied at build time, not runtime
+3. **No transpilation**: TypeScript bundled directly by Bun
+4. **Colocated tests**: Tests live next to source files (*.test.ts)

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/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