opencodekit 0.16.0 → 0.16.1

package/dist/template/.opencode/memory/observations/2026-02-01-discovery-verify-command-already-implemented.md

@@ -1,28 +0,0 @@
----
-type: discovery
-created: 2026-02-01T15:16:50.162Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["verify", "command", "openspec", "completeness", "correctness", "coherence"]
-files: [".opencode/command/verify.md"]
----
-
-# 💡 Verify command already implemented
-
-🟢 **Confidence:** high
-
-The `/verify` command already exists at `.opencode/command/verify.md` with full implementation:
-
-**Three dimensions:**
-1. Completeness - Are all required artifacts present? All tasks addressed?
-2. Correctness - Do automated gates pass? (build, test, lint, typecheck)
-3. Coherence - Do artifacts agree with each other? No contradictions?
-
-**Features:**
-- `--quick` - Skip coherence check, gates only
-- `--fix` - Auto-fix issues where possible
-- Multi-language support (Node, Rust, Python, Go)
-- Updates bead notes with verification results
-
-This was identified as "short-term" in OpenSpec research but is already done!

package/dist/template/.opencode/memory/observations/2026-02-01-feature-openspec-phase-b-complete-template-upgra.md

@@ -1,43 +0,0 @@
----
-type: feature
-created: 2026-02-01T13:54:45.946Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["openspec", "templates", "context-injection", "workflow", "beads"]
-files: [".opencode/memory/_templates/proposal.md", ".opencode/memory/_templates/spec.md", ".opencode/memory/_templates/tasks.md", ".opencode/context/project.md", "opencode.json", ".opencode/opencode.json", ".opencode/memory/_templates/README.md", ".opencode/command/plan.md"]
----
-
-# ✨ OpenSpec Phase B Complete: Template Upgrade + Context Injection
-
-🟢 **Confidence:** high
-
-## Phase B Complete
-
-Adapted OpenSpec patterns into the kit + beads system:
-
-### New Templates Created
-- `.opencode/memory/_templates/proposal.md` - Captures WHY (motivation, impact)
-- `.opencode/memory/_templates/spec.md` - WHEN/THEN behavioral requirements
-- `.opencode/memory/_templates/tasks.md` - Numbered implementation checklists
-
-### Context Injection Added
-- `.opencode/context/project.md` - Tech stack, constraints, integrations
-- Added to `opencode.json` instructions[] for auto-injection into all prompts
-
-### Key Adaptation Decisions
-1. **Kept our comprehensive style** - OpenSpec templates are minimal scaffolds (~10 lines), ours provide more structure
-2. **Used instructions[] not config.yaml** - OpenCode's native mechanism vs OpenSpec's custom parser
-3. **No CLI tooling** - We're AI-native, commands ARE the interface
-4. **Flat template structure** - No per-schema subdirectories (simpler)
-
-### OpenSpec Patterns NOT Adopted
-- Canonical spec maintenance (our beads are ephemeral)
-- Delta spec merging (no long-running specs)
-- Multiple schema workflows (keeping single flow for now)
-- Shell completions (not relevant for AI workflow)
-
-### Files Modified
-- `.opencode/opencode.json` - Added context/project.md to instructions[]
-- `.opencode/memory/_templates/README.md` - Documented all templates
-- `.opencode/command/plan.md` - Added templates reference section

package/dist/template/.opencode/memory/observations/2026-02-01-learning-build-agent-should-use-dynamic-lsp-not-f.md

@@ -1,14 +0,0 @@
----
-type: learning
-created: 2026-02-01T10:01:36.015Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["build agent", "LSP", "dynamic tooling", "gpt-5.2-codex", "prompt update"]
----
-
-# 📚 Build agent should use dynamic LSP, not forced 9 calls
-
-🟢 **Confidence:** high
-
-User reports that with gpt-5.2-codex, build agent prompt forces 9 LSP tool calls. User wants build agent prompt updated to use dynamic, best-practice LSP usage (only the needed operations).

package/dist/template/.opencode/memory/observations/2026-02-01-learning-kimi-k2-5-model-requires-temperature-1-0.md

@@ -1,22 +0,0 @@
----
-type: learning
-created: 2026-02-01T04:58:58.391Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["kimi_k25", "temperature", "thinking mode", "opencode zen", "model configuration", "scout agent"]
----
-
-# 📚 Kimi K2.5 model requires temperature 1.0
-
-🟢 **Confidence:** high
-
-The kimi_k25 (Kimi K2.5) model is a thinking mode model that requires temperature to be exactly 1.0. The parameter is immutable - you cannot set custom temperatures.
-
-Error message: "Parameter 'temperature' is immutable for kimi_k25 and must be 1.0 (thinking mode). Got 0.3."
-
-Solution options:
-1. Change scout.md temperature from 0.3 to 1.0 to use kimi-k2.5-free
-2. Use a different model like minimax-m2.1-free that supports custom temperatures
-
-Other thinking models in opencode.json also have "temperature": 1 in their configuration (e.g., big-pickle, glm-4.6, glm-4.7 with reasoning enabled).

package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-already-imple.md

@@ -1,27 +0,0 @@
----
-type: learning
-created: 2026-02-01T15:16:13.160Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["opencode", "context-injection", "instructions", "agents-md", "config"]
-files: ["AGENTS.md", ".opencode/memory/user.md", "project/tech-stack.md", ".opencode/AGENTS.md"]
----
-
-# 📚 OpenCode context injection already implemented
-
-🟢 **Confidence:** high
-
-OpenCode doesn't support `context` or `rules` fields from OpenSpec research.
-
-Instead, OpenCode uses:
-1. `instructions` array in opencode.json → files injected into prompts (we have: user.md, tech-stack.md)
-2. `AGENTS.md` files → rules and guidelines (project-level + global)
-3. `command` field in opencode.json → per-command customization
-
-Our current setup already follows best practices:
-- `.opencode/memory/user.md` + `project/tech-stack.md` via instructions[]
-- `.opencode/AGENTS.md` for global rules
-- `.opencode/command/*.md` for commands
-
-No additional context injection needed - we're already doing it right!

package/dist/template/.opencode/memory/observations/2026-02-01-learning-opencode-context-injection-uses-instruct.md

@@ -1,35 +0,0 @@
----
-type: learning
-created: 2026-02-01T13:39:55.750Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["opencode", "openspec", "context injection", "instructions", "config", "prompt", "agent configuration"]
-files: [".opencode/memory/project/context.md"]
----
-
-# 📚 OpenCode context injection uses 'instructions' not 'context'
-
-🟢 **Confidence:** high
-
-OpenCode config (opencode.json) doesn't have a `context` field like OpenSpec's config.yaml. Instead, it uses:
-
-1. **`instructions`** - Array of file paths that get injected into prompts
-   - Current: `[".opencode/memory/user.md", ".opencode/memory/project/*.md"]`
-   - These files are loaded and included in the system prompt
-
-2. **Per-agent `prompt`** - Custom prompt string per agent via `agent.<name>.prompt`
-
-3. **Per-command `template`** - Via `command.<name>.template`
-
-OpenSpec's approach:
-- `context:` - Global context injected into ALL artifacts
-- `rules:` - Per-artifact rules (e.g., `rules.proposal: ["Include rollback plan"]`)
-
-To adapt OpenSpec's context injection pattern to OpenCode:
-- Use `instructions` with well-structured markdown files
-- Create `.opencode/memory/project/context.md` for global project context
-- Use agent-specific `prompt` fields for per-agent rules
-- Or create command-specific files that commands load via skill pattern
-
-Key difference: OpenCode's approach is file-based, OpenSpec's is config-based inline text.

package/dist/template/.opencode/memory/observations/2026-02-01-learning-update-build-agent-prompt-to-use-context.md

@@ -1,14 +0,0 @@
----
-type: learning
-created: 2026-02-01T10:05:57.086Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["build agent", "prompt", "LSP", "contextual usage", "best practice"]
----
-
-# 📚 Update build agent prompt to use contextual LSP
-
-🟢 **Confidence:** high
-
-User wants the build agent prompt updated to avoid forcing all 9 LSP calls. They want a brutal, best-practice policy: use LSP contextually (documentSymbol/hover first, add other ops only when needed).

package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-using-opencode-expert-.md

@@ -1,14 +0,0 @@
----
-type: learning
-created: 2026-02-01T10:26:42.193Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["AGENTS.md", "opencode-expert", "project rules", "opencode kit"]
----
-
-# 📚 Upgrade AGENTS.md using opencode-expert reference
-
-🟢 **Confidence:** high
-
-User requested upgrading project rules in AGENTS.md for an OpenCode kit, referencing dmmulroy/.dotfiles opencode-expert.md.

package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-g.md

@@ -1,14 +0,0 @@
----
-type: learning
-created: 2026-02-01T10:27:47.569Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["AGENTS.md", "opencode-expert", "configuration", "best practices"]
----
-
-# 📚 Upgrade AGENTS.md with OpenCode expert guidance
-
-🟢 **Confidence:** high
-
-User requested a focused upgrade to AGENTS.md using dmmulroy/.dotfiles opencode-expert.md as reference for OpenCode configuration best practices and links.

package/dist/template/.opencode/memory/observations/2026-02-01-learning-upgrade-agents-md-with-opencode-expert-r.md

@@ -1,14 +0,0 @@
----
-type: learning
-created: 2026-02-01T10:27:01.422Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["AGENTS.md", "opencode-expert", "project rules", "opencode kit"]
----
-
-# 📚 Upgrade AGENTS.md with OpenCode expert rules
-
-🟢 **Confidence:** high
-
-User requested upgrading project AGENTS.md using dmmulroy/.dotfiles opencode-expert.md as reference to make the kit better for OpenCode users.

package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-prefers-copilot-gpt-5-2-codex-mediu.md

@@ -1,14 +0,0 @@
----
-type: learning
-created: 2026-02-01T09:56:48.021Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["copilot", "gpt-5.2-codex", "medium", "speed", "model preference"]
----
-
-# 📚 User prefers Copilot GPT-5.2-Codex medium for speed
-
-🟢 **Confidence:** high
-
-User reports that GitHub Copilot gpt-5.2-codex medium variant provides good speed and is preferred for their OpenCode setup.

package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-contextu.md

@@ -1,15 +0,0 @@
----
-type: learning
-created: 2026-02-01T10:19:23.691Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["general agent", "LSP", "contextual usage", "prompt update"]
-files: [".opencode/agent/general.md"]
----
-
-# 📚 User wants general agent prompt contextual LSP
-
-🟢 **Confidence:** high
-
-User asked to update .opencode/agent/general.md to use contextual LSP usage (avoid forced LSP calls), similar to build agent prompt.

package/dist/template/.opencode/memory/observations/2026-02-01-learning-user-wants-general-agent-prompt-reviewed.md

@@ -1,15 +0,0 @@
----
-type: learning
-created: 2026-02-01T10:18:29.926Z
-confidence: high
-valid_until: null
-superseded_by: null
-concepts: ["general agent", "prompt review", "LSP policy", "best practice", "opencode"]
-files: [".opencode/agent/general.md"]
----
-
-# 📚 User wants general agent prompt reviewed and tightened
-
-🟢 **Confidence:** high
-
-User requested a review of .opencode/agent/general.md and wants a more brutal/best-practice upgrade similar to build agent prompt changes (e.g., LSP usage policy).

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

@@ -1,60 +0,0 @@
----
-purpose: Key modules, directory structure, architectural decisions
-updated: { { DATE } }
----
-
-# Project Architecture
-
-## Directory Structure
-
-```
-src/              # Source code
-  index.ts        # Entry point
-  commands/       # CLI commands
-  utils/          # Utilities
-
-dist/             # Built output
-.opencode/        # OpenCode configuration
-.beads/           # Task tracking
-```
-
-## Key Modules
-
-### Module Name
-
-**Purpose**: Brief description
-
-**Files**:
-
-- `src/module/file.ts`
-
-**Dependencies**:
-
-- External libs
-- Internal modules
-
-## Data Flow
-
-```
-User Action
-  → Module A
-    → Module B
-      → External Service
-```
-
-## External Dependencies
-
-- **Library**: Version, purpose
-- **Service**: API endpoint, auth method
-
-## Architectural Decisions
-
-| 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/command-rules.md

@@ -1,122 +0,0 @@
----
-purpose: Per-command context and rules injected during command execution
-updated: 2026-02-01
-pattern: OpenSpec context/rules injection adapted for OpenCodeKit
----
-
-# Command-Specific Rules
-
-Rules automatically injected based on active command context.
-
-## Planning Commands
-
-### /plan
-
-- Include rollback plan for risky changes
-- Break tasks into independently-testable units
-- Estimate complexity per task (S/M/L)
-- Identify dependencies between tasks explicitly
-
-### /design
-
-- Research existing patterns before proposing new ones
-- Include concrete file paths in all designs
-- Show interface contracts for public APIs
-- Specify error handling strategy
-
-### /research
-
-- Cite sources with URLs
-- Distinguish facts from inferences
-- Note confidence level (high/medium/low)
-- Identify gaps in available information
-
-## Implementation Commands
-
-### /start
-
-- Check for existing bead before creating new
-- Load relevant memory files first
-- Verify task context with `bd show <id>`
-
-### /resume
-
-- Re-read spec before continuing
-- Check what's already completed
-- Don't re-implement existing work
-
-### /ship
-
-- Run all verification gates before claiming done
-- Include test evidence in close reason
-- Never skip lint/typecheck even for "small" changes
-
-## Review Commands
-
-### /review
-
-- Focus on correctness over style
-- Identify security implications
-- Check for unhandled edge cases
-- Suggest simplifications where possible
-
-### /verify
-
-- Check completeness: all artifacts exist
-- Check correctness: implementation matches spec
-- Check coherence: no contradictions between artifacts
-
-### /ui-review
-
-- Check accessibility (WCAG compliance)
-- Verify responsive behavior
-- Identify inconsistent patterns
-
-## Handoff Commands
-
-### /handoff
-
-- Include current bead state
-- List completed vs remaining tasks
-- Note any blockers or decisions needed
-- Provide session context for continuity
-
-### /init
-
-- Don't overwrite existing memory files
-- Detect project type from existing files
-- Set up minimal viable structure first
-
-## Context Injection
-
-These rules are automatically considered when:
-
-1. User invokes a command explicitly (e.g., `/plan`)
-2. Agent recognizes a command-like workflow
-3. Subagent receives delegated work matching a command pattern
-
----
-
-## Tech Stack Rules (Project-Specific)
-
-When working in this project, always:
-
-- **Runtime**: Use Bun (not Node.js)
-- **Language**: TypeScript with ESM imports
-- **Linting**: Run `npm run lint:fix` before commits
-- **Types**: Run `npm run typecheck` to validate
-- **Formatting**: Use Biome (configured in biome.json)
-
-## Git Rules
-
-- Never commit to main directly
-- Always ask before `git push`
-- Use conventional commit format: `type(scope): message`
-- Never force push unless explicitly requested
-
-## File Structure Rules
-
-- Commands go in `.opencode/command/`
-- Skills go in `.opencode/skill/`
-- Memory files go in `.opencode/memory/`
-- Plugin code goes in `.opencode/plugin/`

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

@@ -1,72 +0,0 @@
----
-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/project/conventions.md

@@ -1,68 +0,0 @@
----
-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/project/gotchas.md

@@ -1,41 +0,0 @@
----
-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