opencodekit 0.17.11 → 0.17.13

package/dist/template/.opencode/AGENTS.md

@@ -44,23 +44,44 @@ When instructions conflict:
 - Read files before editing
 - Delegate when work is large, uncertain, or cross-domain
 
+### Anti-Redundancy
+
+- **Search before creating** — always check if a utility, helper, or component already exists before creating a new one
+- **No wrapper files** — don't create files that only re-export from other files; import directly from the source
+- **One home per concept** — if a function/class already exists somewhere, use it; don't duplicate in a new location
+
 ### Verification Before Completion
 
 - No success claims without fresh evidence
+- **Verify external APIs before using** — check local type definitions, source code, or official docs; never guess library method signatures or options
 - Run relevant commands (typecheck/lint/test/build) after meaningful changes
 - If verification fails twice on the same approach, stop and escalate with blocker details
+- **Lint churn auto-resolution** — if staged diffs are formatting-only, auto-resolve without asking. If a commit was already requested, auto-stage formatting follow-ups.
+- **Auto-detect project toolchain** — look for `package.json`, `Cargo.toml`, `pyproject.toml`, `go.mod`, `Makefile`, etc. and run the appropriate verification commands
+- **Common verification patterns:**
+
+| Indicator        | Typecheck                               | Lint                    | Test            |
+| ---------------- | --------------------------------------- | ----------------------- | --------------- |
+| `package.json`   | `npm run typecheck`                     | `npm run lint`          | `npm test`      |
+| `Cargo.toml`     | `cargo check`                           | `cargo clippy`          | `cargo test`    |
+| `pyproject.toml` | `mypy .` or `pyright`                   | `ruff check .`          | `pytest`        |
+| `go.mod`         | `go vet ./...`                          | `golangci-lint run`     | `go test ./...` |
+| `pom.xml`        | `mvn compile`                           | `mvn checkstyle:check`  | `mvn test`      |
+| `build.gradle`   | `gradle compileJava`                    | `gradle checkstyleMain` | `gradle test`   |
+| `Makefile`       | Check for `check`/`lint`/`test` targets |                         |                 |
 
 ---
 
 ## Hard Constraints (Never Violate)
 
-| Constraint    | Rule                                              |
-| ------------- | ------------------------------------------------- |
-| Security      | Never expose/invent credentials                   |
-| Git Safety    | Never force push main/master; never bypass hooks  |
-| Honesty       | Never fabricate tool output; never guess URLs     |
-| Paths         | Use absolute paths for file operations            |
-| Reversibility | Ask first before destructive/irreversible actions |
+| Constraint    | Rule                                                                              |
+| ------------- | --------------------------------------------------------------------------------- |
+| Security      | Never expose/invent credentials                                                   |
+| Git Safety    | Never force push main/master; never bypass hooks                                  |
+| Git Restore   | Never run `reset --hard`, `checkout .`, `clean -fd` without explicit user request |
+| Honesty       | Never fabricate tool output; never guess URLs                                     |
+| Paths         | Use absolute paths for file operations                                            |
+| Reversibility | Ask first before destructive/irreversible actions                                 |
 
 ---
 
@@ -76,6 +97,18 @@ If blocked, report the blocker; do not bypass constraints.
 
 ---
 
+## Multi-Agent Safety
+
+When multiple agents or subagents work on the same codebase:
+
+- **Don't create git stash or worktree** unless the user explicitly requests it
+- **Scope commits to your changes only** — don't stage unrelated files
+- **Never use `git add .`** — stage specific files you modified
+- **Coordinate on shared files** — if another agent is editing the same file, wait or delegate
+- **No speculative cleanup** — don't reformat or refactor files you didn't need to change
+
+---
+
 ## Delegation Policy
 
 Use specialist agents by intent:
@@ -167,11 +200,14 @@ For major tracked work:
 
 ### File Size Guidance
 
+Files over ~500 lines become hard to maintain and review. Extract helpers, split modules, or refactor when approaching this threshold.
+
 | Size          | Strategy                          |
 | ------------- | --------------------------------- |
 | < 100 lines   | Full rewrite often easier         |
 | 100-400 lines | Structured edit with good context |
 | > 400 lines   | Strongly prefer structured edits  |
+| > 500 lines   | Consider splitting the file       |
 
 **Use the `structured-edit` skill for complex edits.**
 

package/dist/template/.opencode/agent/plan.md

@@ -36,7 +36,7 @@ You are opencode, an interactive CLI tool that helps users with software enginee
 - Prefer specialized tools over shell for file operations:
   - Use Read to view files, Edit to modify files, and Write only when needed.
   - Use Glob to find files by name and Grep to search file contents.
-- Use Bash for terminal operations (git, bun, builds, tests, running scripts).
+- Use Bash for terminal operations (git, npm/pnpm, builds, tests, running scripts).
 - Run tool calls in parallel when neither call needs the other's output; otherwise run sequentially.
 
 # Planning Guidelines

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

@@ -118,7 +118,7 @@ Report what was codified:
 | # | Type      | Title                        | Concepts               |
 |---|-----------|------------------------------|------------------------|
 | 1 | pattern   | ...                          | auth, jwt              |
-| 2 | gotcha    | ...                          | bun, build             |
+| 2 | gotcha    | ...                          | node, build            |
 | 3 | bugfix    | ...                          | typecheck, strict-mode |
 
 **AGENTS.md updates suggested:** [yes/no - describe if yes]

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

@@ -67,7 +67,7 @@ Run verification after each wave:
 
 - `npm run typecheck`
 - `npm run lint`
-- `bun test` (if tests exist for changed areas)
+- `vitest` (if tests exist for changed areas)
 
 Checkpoint only at `checkpoint:human-verify` or `checkpoint:decision` tasks.
 

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

@@ -43,9 +43,9 @@ OpenCodeKit (`ock`) enables developers to bootstrap AI-assisted development envi
 
 ## Tech Stack
 
-- **Runtime:** Bun >= 1.3.2
+- **Runtime:** Node.js >= 20.19.0
 - **Language:** TypeScript (ESNext, strict mode)
-- **Build:** `bun build` + rsync for template bundling
+- **Build:** tsdown + rsync for template bundling
 - **CLI Framework:** cac
 - **UI Prompts:** @clack/prompts
 - **Validation:** zod

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

@@ -43,9 +43,9 @@ updated: 2026-02-12
 
 ### Technical
 
-- Bun runtime required (>= 1.3.2)
+- Node.js runtime required (>= 20.19.0)
 - TypeScript strict mode enforced
-- Build uses rsync to bundle .opencode/ template
+- Build uses tsdown + rsync to bundle .opencode/ template
 - oxlint for linting (fast, modern)
 
 ### Product

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

@@ -1,6 +1,6 @@
 ---
 purpose: Tech stack, constraints, and integrations for AI context injection
-updated: 2026-02-02
+updated: 2026-02-24
 ---
 
 # Tech Stack
@@ -11,34 +11,34 @@ This file is automatically injected into ALL AI prompts via `opencode.json` inst
 
 - **Framework:** CLI tool (cac for argument parsing)
 - **Language:** TypeScript (ESNext, strict mode, bundler moduleResolution)
-- **Runtime:** Bun >= 1.3.2
+- **Runtime:** Node.js >= 20.19.0
 
 ## Key Dependencies
 
 - **CLI Framework:** cac (^6.7.14) - Command-line argument parsing
 - **UI Prompts:** @clack/prompts (^0.7.0) - Interactive CLI prompts
-- **TUI Framework:** @opentui/core (^0.1.72) + @opentui/solid (^0.1.72) - Terminal UI
 - **Validation:** zod (^3.25.76) - Schema validation
 - **Task Tracking:** beads-village (^1.3.3) - Git-backed task management
 - **AI SDK:** @ai-sdk/provider (^3.0.6) - AI provider integration
 
 ## Build & Tools
 
-- **Build:** `bun run build.ts` + rsync for template bundling
+- **Build:** tsdown + rsync for template bundling
 - **Lint:** oxlint (^1.38.0) - Fast JavaScript/TypeScript linter
 - **Format:** oxfmt (^0.23.0) - Code formatter
-- **TypeCheck:** TypeScript 5.9.3
+- **TypeCheck:** tsgo (@typescript/native-preview)
+- **Dev Runner:** tsx - TypeScript execution for development
 
 ## Testing
 
-- **Unit Tests:** bun test (native Bun test runner)
+- **Unit Tests:** vitest
 - **Test Location:** src/\*_/_.test.ts (colocated)
-- **Run Single:** bun test src/commands/init.test.ts
+- **Run Single:** vitest src/commands/init.test.ts
 
 ## Key Constraints
 
-- Must maintain Bun compatibility (engines.bun >= 1.3.2)
-- Node.js not officially supported
+- Node.js >= 20.19.0 required (engines.node in package.json)
+- pnpm for package management
 - Build copies .opencode/ to dist/template/ - don't edit dist/ directly
 - Keep .opencode/ structure minimal and focused
 

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

@@ -23,9 +23,9 @@ updated: 2025-01-06
 
 ## Technical Preferences
 
-- Runtime: Bun
+- Runtime: Node.js
 - Language: TypeScript
-- Linter: Biome
+- Linter: oxlint
 
 ## Rules to Always Follow