opencodekit 0.14.5 → 0.15.0

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

@@ -0,0 +1,72 @@
+---
+purpose: Build, test, lint, deploy commands discovered for this project
+updated: { { DATE } }
+---
+
+# Project Commands
+
+## Development
+
+```bash
+npm run dev        # Start development server
+bun run src/index.ts  # Run CLI directly
+```
+
+## Build
+
+```bash
+npm run build      # Build for production
+bun build ...      # Additional build options
+```
+
+## Test
+
+```bash
+bun test           # Run all tests
+bun test --watch   # Watch mode
+bun test file.ts   # Run single file
+```
+
+## Lint
+
+```bash
+npm run lint       # Check for issues
+npm run lint:fix   # Auto-fix issues
+```
+
+## Typecheck
+
+```bash
+npm run typecheck  # TypeScript checking only
+```
+
+## Database
+
+```bash
+npm run db:push    # Push schema changes
+npm run db:studio  # Open database UI
+```
+
+## Deployment
+
+```bash
+npm run deploy     # Deploy to production
+```
+
+## CI/CD
+
+- **Lint**: Runs on push
+- **Test**: Runs on push
+- **Deploy**: Triggers on main branch
+
+## Beads (Task Tracking)
+
+```bash
+bd ready              # Find unblocked tasks
+bd list --status=open # All open issues
+bd show <id>          # Full details
+bd create "Title" -p 2        # Create task
+bd update <id> --status in_progress  # Claim
+bd close <id> --reason "Done"        # Complete
+bd sync               # Push to git
+```

package/dist/template/.opencode/memory/_templates/project/conventions.md

@@ -0,0 +1,68 @@
+---
+purpose: Code patterns, commit style, team conventions
+updated: { { DATE } }
+---
+
+# Project Conventions
+
+## Code Style
+
+### TypeScript
+
+- **Module**: ESNext, bundler moduleResolution
+- **Strict**: Disabled
+- **Imports**: Group stdlib, third-party, local
+
+### Python
+
+- **Version**: 3.10+
+- **Style**: type hints required, dataclasses for config
+
+## Naming Conventions
+
+| Type      | Convention | Example           |
+| --------- | ---------- | ----------------- |
+| Classes   | PascalCase | `UserService`     |
+| Functions | snake_case | `get_user_data()` |
+| Variables | snake_case | `user_data`       |
+| Constants | UPPER_CASE | `MAX_RETRIES`     |
+| Files     | kebab-case | `user-service.ts` |
+
+## Import Order
+
+```typescript
+// 1. Node.js stdlib
+import fs from "node:fs/promises";
+import path from "node:path";
+
+// 2. Third-party
+import { cli } from "cac";
+import { log } from "@clack/prompts";
+
+// 3. Local
+import { initCommand } from "./commands/init.js";
+```
+
+## Commit Messages
+
+```
+type(scope): subject
+
+body (optional)
+
+footer (optional)
+```
+
+**Types**: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
+
+## Code Review
+
+- **Self-review**: Run lint/typecheck before PR
+- **Test coverage**: Add tests for new features
+- **Docs**: Update README for user-facing changes
+
+## Patterns to Avoid
+
+- Premature abstraction
+- Circular dependencies
+- Magic numbers/strings

package/dist/template/.opencode/memory/_templates/project/gotchas.md

@@ -0,0 +1,41 @@
+---
+purpose: Footguns, edge cases, and "don't forget this" warnings
+updated: { { DATE } }
+---
+
+# Project Gotchas
+
+## Configuration Quirks
+
+### Field Name
+
+**Issue**: What goes wrong
+**Fix**: How to handle it
+
+## Dependencies
+
+### Package Name
+
+**Version**: x.y.z
+**Why Required**: Purpose
+**Gotcha**: Edge case or limitation
+
+## Time Wasters
+
+### Issue Description
+
+**Symptoms**: What you'll see
+**Cause**: Root cause
+**Fix**: Solution
+
+## Common Errors
+
+| Error Message | Cause  | Fix       |
+| ------------- | ------ | --------- |
+| "Error: ..."  | Reason | Fix steps |
+
+## TODO
+
+- [ ] Document more edge cases
+- [ ] Add troubleshooting section
+- [ ] List known issues

package/dist/template/.opencode/memory/beads-workflow.md

@@ -147,27 +147,28 @@ git worktree prune
 ```
 Leader Agents (touch beads, sync, coordinate)
 ├── build   - Primary implementation agent
-└── rush    - Fast-track implementation agent
+└── plan    - Architecture and planning agent
 
 Subagents (read-only, stateless workers)
+├── general - Fast, well-defined tasks
 ├── explore - Codebase search, patterns
 ├── scout   - External docs, best practices
-├── planner - Architecture, decomposition
 ├── review  - Code review, debugging
 └── vision  - UI/UX, visual analysis
 ```
 
 ### Delegation Rules
 
-| Agent     | Can Do                     | Cannot Do              |
-| --------- | -------------------------- | ---------------------- |
-| `build`   | All beads ops, `bd sync`   | -                      |
-| `rush`    | All beads ops, `bd sync`   | -                      |
-| `explore` | Read, grep, glob, ast-grep | Edit, write, `bd sync` |
-| `scout`   | Fetch, search, Context7    | Edit, write, `bd sync` |
-| `planner` | Read, create artifacts     | Edit files, `bd sync`  |
-| `review`  | Read, analyze, suggest     | Edit files, `bd sync`  |
-| `vision`  | Analyze images, mockups    | All beads operations   |
+| Agent     | Can Do                   | Cannot Do              |
+| --------- | ------------------------ | ---------------------- |
+| `build`   | All beads ops, `bd sync` | -                      |
+| `plan`    | All beads ops, `bd sync` | -                      |
+| `general` | Read, small edits        | `bd sync`, beads write |
+| `explore` | Read, grep, glob         | Edit, write, `bd sync` |
+| `scout`   | Fetch, search, Context7  | Edit, write, `bd sync` |
+| `plan`    | Read, create artifacts   | Edit files, `bd sync`  |
+| `review`  | Read, analyze, suggest   | Edit files, `bd sync`  |
+| `vision`  | Analyze images, mockups  | All beads operations   |
 
 ### Parallel Research Pattern
 
@@ -203,9 +204,9 @@ Task({
 
 | Situation                | Delegate To | Why                        |
 | ------------------------ | ----------- | -------------------------- |
-| Need codebase patterns   | `@explore`  | Fast grep/glob/ast-grep    |
+| Need codebase patterns   | `@explore`  | Fast grep/glob             |
 | Need library docs        | `@scout`    | Context7, GitHub patterns  |
-| Complex planning         | `@planner`  | Structured decomposition   |
+| Complex planning         | `@plan`     | Structured decomposition   |
 | Code review before merge | `@review`   | Fresh eyes, evidence-based |
 | UI/mockup analysis       | `@vision`   | Visual expertise           |
 | Stuck on implementation  | `@explore`  | Fresh search perspective   |
@@ -229,7 +230,7 @@ Based on [OpenCode Command Docs](https://opencode.ai/docs/commands/).
 ---
 description: Short description shown in TUI command list
 argument-hint: "<required> [optional] [--flag]"
-agent: build | planner | scout | explore | review | vision
+agent: build | plan | scout | explore | review | vision
 subtask: true # Run as subagent (doesn't pollute primary context)
 model: gemini-2.5-pro # Override default model
 ---
@@ -302,11 +303,11 @@ model: gemini-2.5-pro # Override default model
 | `/start <id> --worktree`     | build   | + Create git worktree                                  | Isolated feature work       |
 | `/start <id> --research`     | build   | + Parallel subagent research                           | Complex task preparation    |
 | `/create`                    | build   | `bd create`, `bd sync`                                 | Create new tracked task     |
-| `/new-feature`               | planner | `bd create` (epic + subtasks), `bd dep add`, `bd sync` | Complex feature with phases |
-| `/new-feature --worktree`    | planner | + Create git worktree for epic                         | Isolated feature branch     |
+| `/new-feature`               | plan    | `bd create` (epic + subtasks), `bd dep add`, `bd sync` | Complex feature with phases |
+| `/new-feature --worktree`    | plan    | + Create git worktree for epic                         | Isolated feature branch     |
 | `/issue <num>`               | build   | `bd create`, `bd sync`, `gh issue comment`             | Import GitHub issue         |
-| `/plan <id>`                 | planner | `bd create` (subtasks), `bd dep add`, `bd sync`        | Break down task             |
-| `/plan <id> --create-beads`  | planner | Create child beads after planning                      | Auto-hierarchy creation     |
+| `/plan <id>`                 | plan    | `bd create` (subtasks), `bd dep add`, `bd sync`        | Break down task             |
+| `/plan <id> --create-beads`  | plan    | Create child beads after planning                      | Auto-hierarchy creation     |
 | `/implement <id>`            | build   | `bd update --status in_progress`, `bd sync`            | Do the work                 |
 | `/implement <id> --parallel` | build   | + Aggressive subagent research                         | Complex implementation      |
 | `/commit [id]`               | build   | `bd sync` (if bead-id provided)                        | Commit with traceability    |
@@ -322,21 +323,21 @@ model: gemini-2.5-pro # Override default model
 | Command            | Agent   | Beads Operations      | Notes                      |
 | ------------------ | ------- | --------------------- | -------------------------- |
 | `/research <id>`   | scout   | `bd show` (read-only) | NO `bd sync` - subagent    |
-| `/brainstorm`      | planner | None                  | Pure planning, no tracking |
+| `/brainstorm`      | plan    | None                  | Pure planning, no tracking |
 | `/analyze-project` | explore | None                  | Codebase exploration       |
 | `/summarize`       | explore | None                  | Session/code summary       |
 | `/review-codebase` | review  | None                  | Code review                |
 
 ### Non-Beads Commands
 
-| Command                | Agent   | Purpose                        |
-| ---------------------- | ------- | ------------------------------ |
-| `/quick-build`         | build   | Trivial fixes, no bead created |
-| `/design`              | planner | Architecture design            |
-| `/ui-review`           | vision  | UI/UX analysis                 |
-| `/accessibility-check` | vision  | A11y audit                     |
-| `/fix-ci`              | build   | CI pipeline fixes              |
-| `/fix-types`           | build   | TypeScript errors              |
+| Command                | Agent  | Purpose                        |
+| ---------------------- | ------ | ------------------------------ |
+| `/quick-build`         | build  | Trivial fixes, no bead created |
+| `/design`              | plan   | Architecture design            |
+| `/ui-review`           | vision | UI/UX analysis                 |
+| `/accessibility-check` | vision | A11y audit                     |
+| `/fix-ci`              | build  | CI pipeline fixes              |
+| `/fix-types`           | build  | TypeScript errors              |
 
 ## Workflow Patterns
 
@@ -486,13 +487,13 @@ bd sync
 | Agent   | Can Do                          | Cannot Do |
 | ------- | ------------------------------- | --------- |
 | `build` | All beads operations, `bd sync` | -         |
-| `rush`  | All beads operations, `bd sync` | -         |
+| `plan`  | All beads operations, `bd sync` | -         |
 
 ### Subagents (Read-Only Beads)
 
 | Agent     | Can Do                                 | Cannot Do             |
 | --------- | -------------------------------------- | --------------------- |
-| `planner` | `bd show`, `bd list`, create artifacts | `bd sync`, `bd close` |
+| `plan`    | `bd show`, `bd list`, create artifacts | `bd sync`, `bd close` |
 | `scout`   | `bd show` (read context)               | Any writes            |
 | `explore` | `bd show`, `bd list`                   | Any writes            |
 | `review`  | `bd show`                              | Any writes            |

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

@@ -1,6 +1,6 @@
 ---
 purpose: Key modules, directory structure, architectural decisions
-updated: 2025-01-06
+updated: { { DATE } }
 ---
 
 # Project Architecture
@@ -8,72 +8,53 @@ updated: 2025-01-06
 ## Directory Structure
 
 ```
-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
+src/              # Source code
+  index.ts        # Entry point
+  commands/       # CLI commands
+  utils/          # Utilities
+
+dist/             # Built output
+.opencode/        # OpenCode configuration
+.beads/           # Task tracking
 ```
 
 ## Key Modules
 
-### CLI (src/index.ts)
+### Module Name
 
-Entry point using `cac` library. Registers commands, parses args, handles errors.
+**Purpose**: Brief description
 
-### Init Command (src/commands/init.ts)
+**Files**:
 
-Core command - copies `.opencode/` template from dist to target project.
+- `src/module/file.ts`
 
-### Build Process
+**Dependencies**:
 
-1. `bun build` bundles src/index.ts → dist/index.js
-2. rsync copies .opencode/ → dist/template/.opencode/
-3. Published package includes dist/ only
+- External libs
+- Internal modules
 
 ## Data Flow
 
 ```
-User runs: npx opencodekit init
-  → dist/index.js executes
-  → init command copies dist/template/.opencode/ to ./.opencode/
-  → User has full OpenCode setup
+User Action
+  → Module A
+    → Module B
+      → External Service
 ```
 
 ## External Dependencies
 
-- **cac**: CLI framework
-- **@clack/prompts**: Interactive prompts
-- **zod**: Schema validation
-- **beads-village**: Task tracking integration
-- **@opencode-ai/plugin**: Plugin SDK
+- **Library**: Version, purpose
+- **Service**: API endpoint, auth method
 
 ## Architectural Decisions
 
-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)
+| Decision | Rationale    | Trade-offs   |
+| -------- | ------------ | ------------ |
+| Choice 1 | Why this way | Limitation 1 |
+
+## TODO
+
+- [ ] Document missing modules
+- [ ] Add dependency diagram
+- [ ] Map data flow diagrams

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

@@ -1,53 +1,72 @@
 ---
 purpose: Build, test, lint, deploy commands discovered for this project
-updated: 2025-01-06
+updated: { { DATE } }
 ---
 
 # Project Commands
 
+## Development
+
+```bash
+npm run dev        # Start development server
+bun run src/index.ts  # Run CLI directly
+```
+
 ## Build
 
 ```bash
-npm run build       # Bundles src/index.ts + copies .opencode/ to dist/template/
-npm run typecheck   # TypeScript type checking only (no emit)
+npm run build      # Build for production
+bun build ...      # Additional build options
 ```
 
 ## Test
 
 ```bash
-bun test                        # Run all tests
-bun test src/commands/init.ts   # Run single test file
-bun test --watch                # Watch mode
+bun test           # Run all tests
+bun test --watch   # Watch mode
+bun test file.ts   # Run single file
 ```
 
 ## Lint
 
 ```bash
-npm run lint        # Check with Biome
-npm run lint:fix    # Auto-fix issues
+npm run lint       # Check for issues
+npm run lint:fix   # Auto-fix issues
 ```
 
-## Development
+## Typecheck
 
 ```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
+npm run typecheck  # TypeScript checking only
 ```
 
-## Beads (Task Tracking)
+## Database
+
+```bash
+npm run db:push    # Push schema changes
+npm run db:studio  # Open database UI
+```
+
+## Deployment
 
 ```bash
-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 task
-bd update <id> --status in_progress   # Claim work
-bd close <id> --reason "Done"         # Complete
-bd sync                               # Sync with git (always run at session end)
+npm run deploy     # Deploy to production
 ```
 
 ## CI/CD
 
-- GitHub Actions workflow at `.github/workflows/opencode.yml`
-- Triggered by `/oc` or `/opencode` comments on issues/PRs
+- **Lint**: Runs on push
+- **Test**: Runs on push
+- **Deploy**: Triggers on main branch
+
+## Beads (Task Tracking)
+
+```bash
+bd ready              # Find unblocked tasks
+bd list --status=open # All open issues
+bd show <id>          # Full details
+bd create "Title" -p 2        # Create task
+bd update <id> --status in_progress  # Claim
+bd close <id> --reason "Done"        # Complete
+bd sync               # Push to git
+```