opencodekit 0.17.1 → 0.17.2

package/dist/template/.opencode/memory/_templates/ROADMAP.md

@@ -0,0 +1,93 @@
+---
+purpose: Project roadmap with phases, milestones, and bead organization
+updated: 2024-12-21
+---
+
+# Roadmap
+
+## Overview
+
+<!-- High-level project breakdown -->
+
+| Phase     | Goal                | Status        | Beads |
+| --------- | ------------------- | ------------- | ----- |
+| [Phase 1] | [One-sentence goal] | [Not Started] | [#]   |
+| [Phase 2] | [One-sentence goal] | [Not Started] | [#]   |
+| [Phase 3] | [One-sentence goal] | [Not Started] | [#]   |
+
+## Phase 1: [Name]
+
+**Goal:** [Outcome-shaped description]
+
+**Success Criteria:**
+
+- [ ] [Criterion 1]
+- [ ] [Criterion 2]
+- [ ] [Criterion 3]
+
+**Beads:**
+| ID | Title | Type | Status | Depends On |
+|----|-------|------|--------|------------|
+| br-xxx | [Title] | task | open | - |
+| br-xxx | [Title] | task | open | br-xxx |
+
+**Out of Scope:**
+
+- [What's explicitly deferred to later phases]
+
+---
+
+## Phase 2: [Name]
+
+**Goal:** [Outcome-shaped description]
+
+**Success Criteria:**
+
+- [ ] [Criterion 1]
+- [ ] [Criterion 2]
+
+**Beads:**
+| ID | Title | Type | Status | Depends On |
+|----|-------|------|--------|------------|
+| br-xxx | [Title] | feature | open | Phase 1 |
+
+**Dependencies:**
+
+- Requires Phase 1 completion
+
+---
+
+## Phase 3: [Name]
+
+**Goal:** [Outcome-shaped description]
+
+**Success Criteria:**
+
+- [ ] [Criterion 1]
+
+**Beads:**
+| ID | Title | Type | Status | Depends On |
+|----|-------|------|--------|------------|
+| br-xxx | [Title] | epic | open | Phase 2 |
+
+---
+
+## Legend
+
+**Status:**
+
+- `Not Started` - No work begun
+- `In Progress` - Active development
+- `Complete` - All beads closed
+
+**Type:**
+
+- `task` - Tactical, single-session work
+- `feature` - New capability, multi-session
+- `epic` - Cross-domain, significant scope
+- `bug` - Fix for broken behavior
+
+---
+
+_Update this file when phases complete or roadmap changes._
+_Use `/plan` command to create detailed plans for active phases._

package/dist/template/.opencode/memory/_templates/STATE.md

@@ -0,0 +1,89 @@
+---
+purpose: Current project state, active decisions, blockers, and position tracking
+updated: 2024-12-21
+---
+
+# State
+
+## Current Position
+
+<!-- Where are we right now? What just happened? -->
+
+**Active Bead:** br-xxx - [Title]
+**Status:** [In Progress / Blocked / Review]
+**Started:** [Date]
+**Phase:** [Phase name from ROADMAP.md]
+
+## Recent Completed Work
+
+<!-- Last 3-5 completed beads -->
+
+| Bead   | Title   | Completed | Summary            |
+| ------ | ------- | --------- | ------------------ |
+| br-xxx | [Title] | [Date]    | [One-line summary] |
+| br-xxx | [Title] | [Date]    | [One-line summary] |
+
+## Active Decisions
+
+<!-- Decisions made that affect current and future work -->
+
+| Date   | Decision           | Rationale | Impact            |
+| ------ | ------------------ | --------- | ----------------- |
+| [Date] | [What was decided] | [Why]     | [What it affects] |
+
+## Blockers
+
+<!-- What's preventing progress? -->
+
+| Bead   | Blocker                  | Since  | Owner               |
+| ------ | ------------------------ | ------ | ------------------- |
+| br-xxx | [Description of blocker] | [Date] | [Who's responsible] |
+
+## Open Questions
+
+<!-- Questions that need answers before proceeding -->
+
+| Question   | Context            | Blocking | Priority       |
+| ---------- | ------------------ | -------- | -------------- |
+| [Question] | [Where it came up] | [Yes/No] | [High/Med/Low] |
+
+## Context Notes
+
+<!-- Important context that doesn't fit elsewhere -->
+
+### Technical
+
+- [Technical decision or constraint]
+- [Pattern or convention established]
+
+### Product
+
+- [Product decision or direction]
+- [User feedback or requirement]
+
+### Process
+
+- [Workflow change or improvement]
+- [Team agreement or process]
+
+## Next Actions
+
+<!-- Immediate next steps -->
+
+1. [ ] [Action item with owner if applicable]
+2. [ ] [Action item]
+3. [ ] [Action item]
+
+## Session Handoff
+
+<!-- For multi-session work, what's the state for the next session? -->
+
+**Last Session:** [Date]
+**Next Session Priority:** [What's most important to do next]
+**Known Issues:** [Any issues to be aware of]
+**Context Links:** [Relevant files, PRs, docs]
+
+---
+
+_Update this file at the end of each significant session or when state changes._
+_This file is the "you are here" marker for the project._

package/dist/template/.opencode/memory/_templates/tech-stack.md

@@ -44,6 +44,41 @@ This file is automatically injected into ALL AI prompts via `opencode.json` inst
 - [Service 2: e.g., Resend for email]
 - [Service 3: e.g., Sentry for error tracking]
 
+## Context Budget Guidelines
+
+**Quality Degradation Rule:** Target ~50% context per plan execution for consistent quality.
+
+| Task Complexity | Max Tasks/Plan | Typical Context Usage |
+| --------------- | -------------- | --------------------- |
+| Simple (CRUD)   | 3              | ~30-45%               |
+| Complex (auth)  | 2              | ~40-50%               |
+| Very complex    | 1-2            | ~30-50%               |
+
+**Split Signals:**
+
+- More than 3 tasks → Create child plans
+- Multiple subsystems → Separate plans
+- > 5 file modifications per task → Split
+- Discovery + implementation → Split
+
+## Verification Commands
+
+**Always run before claiming complete:**
+
+```bash
+# Type checking
+[typecheck command, e.g., npm run typecheck]
+
+# Linting
+[lint command, e.g., npm run lint]
+
+# Testing
+[test command, e.g., npm test]
+
+# Building
+[build command, e.g., npm run build]
+```
+
 ---
 
 _Update this file when tech stack or constraints change._

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

@@ -0,0 +1,92 @@
+---
+purpose: Project vision, success criteria, and core principles
+updated: 2026-02-12
+---
+
+# OpenCodeKit
+
+## Vision
+
+A project scaffolding tool that generates OpenCode-ready project templates.
+
+OpenCodeKit (`ock`) enables developers to bootstrap AI-assisted development environments with all essential configurations, skills, commands, and integrations pre-configured and validated.
+
+## Success Criteria
+
+- [ ] Users can `ock init` and get a working OpenCode project in under 60 seconds
+- [ ] Generated projects include all essential files (AGENTS.md, skills, commands, memory)
+- [ ] 100% of generated templates pass validation (typecheck, lint)
+- [ ] Templates are customizable through CLI prompts or config
+- [ ] Integration with beads for task tracking works out-of-the-box
+
+## Target Users
+
+### Primary
+
+- **Solo developers** setting up AI-assisted workflows for personal projects
+- **Teams** standardizing their OpenCode configuration across multiple projects
+
+### User Needs
+
+- Quick setup without manual configuration
+- Consistent, validated project structures
+- Customizable templates for different use cases
+- Integrated task tracking from day one
+
+## Core Principles
+
+1. **Convention over configuration** - Sensible defaults, minimal setup required
+2. **Minimal but complete** - Include only essential files, no bloat
+3. **Extensible** - Easy to add custom skills, commands, and templates
+4. **Validated by default** - All generated projects pass typecheck and lint
+5. **Git-backed** - All state and tracking integrated with git workflow
+
+## Tech Stack
+
+- **Runtime:** Bun >= 1.3.2
+- **Language:** TypeScript (ESNext, strict mode)
+- **Build:** `bun build` + rsync for template bundling
+- **CLI Framework:** cac
+- **UI Prompts:** @clack/prompts
+- **Validation:** zod
+- **Task Tracking:** beads_rust (br)
+
+## Current Phase
+
+**Scale** - Core complete, adding advanced features.
+
+See [roadmap.md](./roadmap.md) for phase details and [state.md](./state.md) for current position.
+
+## Architecture
+
+```
+src/
+├── index.ts          # CLI entry point
+├── commands/         # CLI commands (init, etc.)
+├── utils/            # Shared utilities
+└── validation/       # Validation scripts
+
+dist/
+├── index.js          # Built CLI
+└── template/         # Bundled .opencode/ template
+
+.opencode/
+├── agent/            # Agent definitions
+├── command/          # OpenCode commands
+├── skill/            # Reusable skills
+├── tool/             # Custom tools
+└── memory/           # Project memory
+```
+
+## Key Files
+
+| File          | Purpose                     |
+| ------------- | --------------------------- |
+| AGENTS.md     | Project rules for AI agents |
+| package.json  | Dependencies and scripts    |
+| build.ts      | Build configuration         |
+| tsconfig.json | TypeScript configuration    |
+
+---
+
+_Update this file when vision, success criteria, or principles change._

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

@@ -0,0 +1,142 @@
+---
+purpose: Project roadmap with phases, milestones, and bead organization
+updated: 2026-02-12
+---
+
+# Roadmap
+
+## Overview
+
+| Phase  | Goal                                              | Status      | Beads |
+| ------ | ------------------------------------------------- | ----------- | ----- |
+| MVP    | Core `ock init` command with basic template       | Complete    | [#]   |
+| Extend | Additional commands (`/ship`, `/plan`, `/resume`) | Complete    | [#]   |
+| Polish | Error handling, docs, validation improvements     | Complete    | [#]   |
+| Scale  | Plugin system, custom templates, advanced config  | In Progress | [#]   |
+
+## Phase 1: MVP
+
+**Goal:** Users can run `ock init` to generate a working OpenCode project template.
+
+**Success Criteria:**
+
+- [x] `ock init` command creates project structure
+- [x] Generated files include AGENTS.md, skills, commands, memory
+- [x] Templates pass typecheck and lint
+- [x] Basic CLI prompts for project configuration
+
+**Beads:**
+
+| ID  | Title             | Type    | Status | Depends On |
+| --- | ----------------- | ------- | ------ | ---------- |
+| -   | Core init command | feature | closed | -          |
+| -   | Template bundling | task    | closed | -          |
+| -   | CLI prompts       | task    | closed | -          |
+
+**Out of Scope:**
+
+- Advanced customization
+- Plugin system
+- Multiple template options
+
+---
+
+## Phase 2: Extend
+
+**Goal:** Add essential OpenCode commands for common workflows.
+
+**Success Criteria:**
+
+- [x] `/ship` command for deployment workflows
+- [x] `/plan` command for implementation planning
+- [x] `/resume` command for continuing work
+- [x] `/handoff` command for session handoffs
+- [x] `/status` command for project state
+
+**Beads:**
+
+| ID  | Title           | Type    | Status | Depends On |
+| --- | --------------- | ------- | ------ | ---------- |
+| -   | Ship command    | feature | closed | MVP        |
+| -   | Plan command    | feature | closed | MVP        |
+| -   | Resume command  | feature | closed | MVP        |
+| -   | Handoff command | feature | closed | MVP        |
+| -   | Status command  | feature | closed | MVP        |
+
+**Dependencies:**
+
+- Requires MVP completion
+
+---
+
+## Phase 3: Polish
+
+**Goal:** Improve quality, documentation, and error handling.
+
+**Success Criteria:**
+
+- [x] Comprehensive error messages with actionable guidance
+- [x] Documentation for all commands
+- [x] Validation scripts for template integrity
+- [x] Improved CLI UX with progress indicators
+
+**Beads:**
+
+| ID  | Title               | Type | Status | Depends On |
+| --- | ------------------- | ---- | ------ | ---------- |
+| -   | Error handling      | task | closed | Extend     |
+| -   | Documentation       | task | closed | Extend     |
+| -   | Validation scripts  | task | closed | Extend     |
+| -   | CLI UX improvements | task | closed | Extend     |
+
+**Dependencies:**
+
+- Requires Extend completion
+
+---
+
+## Phase 4: Scale
+
+**Goal:** Add advanced features for power users and customization.
+
+**Success Criteria:**
+
+- [ ] Plugin system for extending CLI functionality
+- [ ] Custom template support (user-defined templates)
+- [ ] Advanced configuration options
+- [ ] Template marketplace or sharing mechanism
+
+**Beads:**
+
+| ID  | Title            | Type    | Status | Depends On    |
+| --- | ---------------- | ------- | ------ | ------------- |
+| -   | Plugin system    | epic    | open   | Polish        |
+| -   | Custom templates | feature | open   | Polish        |
+| -   | Advanced config  | task    | open   | Polish        |
+| -   | Template sharing | epic    | open   | Plugin system |
+
+**Dependencies:**
+
+- Requires Polish completion
+
+---
+
+## Legend
+
+**Status:**
+
+- `Not Started` - No work begun
+- `In Progress` - Active development
+- `Complete` - All beads closed
+
+**Type:**
+
+- `task` - Tactical, single-session work
+- `feature` - New capability, multi-session
+- `epic` - Cross-domain, significant scope
+- `bug` - Fix for broken behavior
+
+---
+
+_Update this file when phases complete or roadmap changes._
+_Use `/plan` command to create detailed plans for active phases._

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

@@ -0,0 +1,84 @@
+---
+purpose: Current project state, active decisions, blockers, and position tracking
+updated: 2026-02-12
+---
+
+# State
+
+## Current Position
+
+**Active Bead:** (none active)
+**Status:** Ready for new work
+**Started:** 2026-02-12
+**Phase:** Scale
+
+## Recent Completed Work
+
+| Bead | Title                 | Completed | Summary                                           |
+| ---- | --------------------- | --------- | ------------------------------------------------- |
+| -    | Polish phase tasks    | 2026-02   | Error handling, docs, validation, UX improvements |
+| -    | Extend phase commands | 2026-02   | Ship, plan, resume, handoff, status commands      |
+| -    | MVP core features     | 2026-02   | Init command, template bundling, CLI prompts      |
+
+## Active Decisions
+
+| Date       | Decision          | Rationale                                  | Impact                          |
+| ---------- | ----------------- | ------------------------------------------ | ------------------------------- |
+| 2026-02-12 | Scale phase focus | Core complete, ready for advanced features | Plugin system, custom templates |
+
+## Blockers
+
+| Bead | Blocker | Since | Owner |
+| ---- | ------- | ----- | ----- |
+| -    | (none)  | -     | -     |
+
+## Open Questions
+
+| Question                         | Context                        | Blocking | Priority |
+| -------------------------------- | ------------------------------ | -------- | -------- |
+| What plugin system architecture? | Scale phase planning           | Yes      | High     |
+| How to handle custom templates?  | User-defined templates feature | Yes      | High     |
+
+## Context Notes
+
+### Technical
+
+- Bun runtime required (>= 1.3.2)
+- TypeScript strict mode enforced
+- Build uses rsync to bundle .opencode/ template
+- oxlint for linting (fast, modern)
+
+### Product
+
+- Target: solo developers and teams
+- Key differentiator: validated, ready-to-use templates
+- Integration with beads_rust for task tracking
+
+### Process
+
+- Run `npm run lint:fix` before commits
+- Validate with `npm run typecheck`
+- Never modify dist/ directly
+
+## Next Actions
+
+1. [ ] Define plugin system architecture
+2. [ ] Design custom template API
+3. [ ] Create Scale phase implementation plan
+4. [ ] Identify Scale phase beads
+
+## Session Handoff
+
+**Last Session:** 2026-02-12
+**Next Session Priority:** Define plugin system architecture
+**Known Issues:** None currently blocking
+**Context Links:**
+
+- AGENTS.md - Project rules
+- .opencode/skill/ - Available skills
+- .opencode/command/ - Available commands
+
+---
+
+_Update this file at the end of each significant session or when state changes._
+_This file is the "you are here" marker for the project._