opencodekit 0.17.0 → 0.17.2

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

@@ -1,82 +1,82 @@
 {
-	"$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
-	"enabled": true,
-	"debug": false,
-	// "minimal" shows prune activity without noise; "detailed" shows token counts
-	"pruneNotification": "detailed",
-	// "chat" (in-conversation) or "toast" (system notification)
-	"pruneNotificationType": "toast",
-	// Commands: /dcp context, /dcp stats, /dcp sweep
-	"commands": {
-		"enabled": true,
-		// Protect these from /dcp sweep
-		"protectedTools": ["observation", "memory-update", "memory-search"]
-	},
-	"turnProtection": {
-		"enabled": true,
-		"turns": 4
-	},
-	// Protected file patterns - never auto-prune reads of these files
-	"protectedFilePatterns": [
-		"**/.env*",
-		"**/AGENTS.md",
-		"**/.opencode/**",
-		"**/.beads/**",
-		"**/package.json",
-		"**/tsconfig.json",
-		"**/biome.json"
-	],
-	"tools": {
-		"settings": {
-			"nudgeEnabled": true,
-			"nudgeFrequency": 10,
-			// v2.0.1: percentage support - 90% of model's 128k context
-			"contextLimit": "90%",
-			// Protect state-modifying and critical workflow tools
-			// LSP excluded: ephemeral exploration, prune after understanding
-			"protectedTools": [
-				"write",
-				"edit",
-				"memory-update",
-				"observation",
-				"skill",
-				"skill_mcp",
-				"task",
-				"batch",
-				"todowrite",
-				"todoread"
-			]
-		},
-		// v2.0.0: permission model - "allow", "ask", or "deny"
-		"prune": {
-			"permission": "allow"
-		},
-		"distill": {
-			"permission": "allow",
-			"showDistillation": false
-		},
-		"compress": {
-			// v2.0.1: compress is experimental, deny by default
-			"permission": "deny",
-			"showCompression": false
-		}
-	},
-	"strategies": {
-		// Dedup = zero LLM cost, high impact - always enable
-		"deduplication": {
-			"enabled": true,
-			"protectedTools": []
-		},
-		// Supersede writes = zero cost, removes redundant write inputs after read
-		// Note: default changed to false in beta, we explicitly enable
-		"supersedeWrites": {
-			"enabled": true
-		},
-		// Purge error inputs after N turns
-		"purgeErrors": {
-			"enabled": true,
-			"turns": 4,
-			"protectedTools": []
-		}
-	}
+  "$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
+  "enabled": true,
+  "debug": false,
+  // "minimal" shows prune activity without noise; "detailed" shows token counts
+  "pruneNotification": "detailed",
+  // "chat" (in-conversation) or "toast" (system notification)
+  "pruneNotificationType": "toast",
+  // Commands: /dcp context, /dcp stats, /dcp sweep
+  "commands": {
+    "enabled": true,
+    // Protect these from /dcp sweep
+    "protectedTools": ["observation", "memory-update", "memory-search"],
+  },
+  "turnProtection": {
+    "enabled": true,
+    "turns": 4,
+  },
+  // Protected file patterns - never auto-prune reads of these files
+  "protectedFilePatterns": [
+    "**/.env*",
+    "**/AGENTS.md",
+    "**/.opencode/**",
+    "**/.beads/**",
+    "**/package.json",
+    "**/tsconfig.json",
+    "**/biome.json",
+  ],
+  "tools": {
+    "settings": {
+      "nudgeEnabled": true,
+      "nudgeFrequency": 10,
+      // v2.0.1: percentage support - 90% of model's 128k context
+      "contextLimit": 200000,
+      // Protect state-modifying and critical workflow tools
+      // LSP excluded: ephemeral exploration, prune after understanding
+      "protectedTools": [
+        "write",
+        "edit",
+        "memory-update",
+        "observation",
+        "skill",
+        "skill_mcp",
+        "task",
+        "batch",
+        "todowrite",
+        "todoread",
+      ],
+    },
+    // v2.0.0: permission model - "allow", "ask", or "deny"
+    "prune": {
+      "permission": "allow",
+    },
+    "distill": {
+      "permission": "allow",
+      "showDistillation": false,
+    },
+    "compress": {
+      // v2.1.1: compress enabled with improved boundary matching
+      "permission": "allow",
+      "showCompression": true,
+    },
+  },
+  "strategies": {
+    // Dedup = zero LLM cost, high impact - always enable
+    "deduplication": {
+      "enabled": true,
+      "protectedTools": [],
+    },
+    // Supersede writes = zero cost, removes redundant write inputs after read
+    // Note: default changed to false in beta, we explicitly enable
+    "supersedeWrites": {
+      "enabled": true,
+    },
+    // Purge error inputs after N turns
+    "purgeErrors": {
+      "enabled": true,
+      "turns": 4,
+      "protectedTools": [],
+    },
+  },
 }

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

@@ -0,0 +1,58 @@
+---
+purpose: Project vision, goals, and success criteria (loaded into all AI contexts)
+updated: 2024-12-21
+---
+
+# Project Vision
+
+## The Goal
+
+<!-- One sentence: What does this project achieve? Outcome-shaped, not task-shaped. -->
+<!-- Good: "A real-time chat application with persistent message history" -->
+<!-- Bad: "Build chat components and API endpoints" -->
+
+## Success Criteria
+
+<!-- How do we know the project is successful? List 3-7 observable outcomes. -->
+<!-- Each should be verifiable by using the application, not by checking code. -->
+
+1. **[Criterion 1]** - [Specific, measurable outcome]
+2. **[Criterion 2]** - [Specific, measurable outcome]
+3. **[Criterion 3]** - [Specific, measurable outcome]
+
+## Target Users
+
+<!-- Who will use this? What do they need? -->
+
+- **Primary:** [User type and their core need]
+- **Secondary:** [User type and their core need]
+
+## Core Principles
+
+<!-- Non-negotiable principles that guide all decisions -->
+
+1. **[Principle 1]** - [Explanation]
+2. **[Principle 2]** - [Explanation]
+3. **[Principle 3]** - [Explanation]
+
+## Current Phase
+
+<!-- Where are we in the project lifecycle? -->
+
+- **Status:** [Discovery / Planning / Implementation / Polish / Maintenance]
+- **Milestone:** [Current milestone name]
+- **Next Milestone:** [Next milestone name]
+
+## Key Links
+
+<!-- Important references -->
+
+- **Repository:** [URL]
+- **Documentation:** [URL]
+- **Staging:** [URL]
+- **Production:** [URL]
+
+---
+
+_Update this file when project direction or phase changes._
+_AI uses this to maintain context across sessions and make decisions aligned with project goals._

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._