opencodekit 0.20.7 → 0.20.8

package/dist/index.js

@@ -20,7 +20,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
 //#region package.json
-var version = "0.20.7";
+var version = "0.20.8";
 
 //#endregion
 //#region src/utils/license.ts

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

@@ -22,6 +22,20 @@ When instructions conflict:
 
 1. **Security** — never expose or invent credentials
 2. **Anti-hallucination** — verify before asserting; if context is missing, prefer lookup over guessing; if you must proceed without full context, label assumptions explicitly and choose a reversible action
+
+### Source Hierarchy
+
+When verifying facts or API usage, rank sources by authority:
+
+| Tier                  | Source                                                       | Trust Level                           |
+| --------------------- | ------------------------------------------------------------ | ------------------------------------- |
+| **1 (Authoritative)** | Official documentation, type definitions, source code        | High — use directly                   |
+| **2 (Supportive)**    | Official blog posts, changelogs, web standards specs         | Medium — cross-reference              |
+| **3 (Contextual)**    | Browser compat tables, release notes, migration guides       | Medium — verify currency              |
+| **4 (Unreliable)**    | Stack Overflow, blog posts, AI-generated docs, training data | Low — never cite without verification |
+
+If a source from Tier 4 conflicts with Tier 1-2, the higher tier wins. If Tier 1-2 sources conflict with each other, state the conflict explicitly.
+
 3. **User intent** — do what was asked, simply and directly
 4. **Agency preservation** — "likely difficult" ≠ "impossible" ≠ "don't try"
 5. This `AGENTS.md`
@@ -45,6 +59,7 @@ If a newer user instruction conflicts with an earlier one, follow the newer inst
 - Stay in scope; no speculative refactors
 - Read files before editing
 - Delegate when work is large, uncertain, or cross-domain
+- When you notice something that should be improved but isn't part of the current task, log it as **"NOTICED BUT NOT TOUCHING: [description]"** and continue with the current task. This makes scope-creep visible and auditable without derailing the work.
 
 ### Simplicity First
 
@@ -318,6 +333,39 @@ For major tracked work:
 - **Agent prompts** stay role-focused; don't duplicate long checklists
 - **Load skills on demand**, not by default
 
+### Intent → Skill Mapping
+
+When user intent is clear, load the appropriate skills:
+
+| Intent                    | Phase          | Skills to Load                                                                     |
+| ------------------------- | -------------- | ---------------------------------------------------------------------------------- |
+| "Build a feature"         | Define → Build | `prd` → `writing-plans` → `incremental-implementation` + `test-driven-development` |
+| "Fix a bug"               | Verify         | `systematic-debugging` → `root-cause-tracing`                                      |
+| "Review code"             | Review         | `receiving-code-review` or `requesting-code-review`                                |
+| "Simplify / refactor"     | Review         | `code-simplification`                                                              |
+| "Ship it"                 | Ship           | `verification-before-completion` → `finishing-a-development-branch`                |
+| "Plan this"               | Plan           | `brainstorming` → `prd` → `writing-plans`                                          |
+| "Execute a plan"          | Build          | `executing-plans` + `subagent-driven-development`                                  |
+| "Debug flaky tests"       | Verify         | `condition-based-waiting` + `systematic-debugging`                                 |
+| "Debug in browser"        | Verify         | `chrome-devtools` or `playwright`                                                  |
+| "Write / fix tests"       | Verify         | `test-driven-development` + `testing-anti-patterns`                                |
+| "Build UI"                | Build          | `frontend-design` + `design-taste-frontend`                                        |
+| "Build UI from mockup"    | Build          | `mockup-to-code` + `frontend-design`                                               |
+| "Redesign existing UI"    | Build          | `redesign-existing-projects` + `design-taste-frontend`                             |
+| "Review UI / UX"          | Review         | `web-design-guidelines` + `visual-analysis` + `accessibility-audit`                |
+| "Audit accessibility"     | Verify         | `accessibility-audit`                                                              |
+| "Build React / Next.js"   | Build          | `react-best-practices` + `frontend-design`                                         |
+| "Research X"              | Define         | `deep-research` or `opensrc`                                                       |
+| "Design an API"           | Build          | `api-and-interface-design` + `documentation-and-adrs`                              |
+| "Set up CI/CD"            | Ship           | `ci-cd-and-automation` + `verification-gates`                                      |
+| "Deploy app"              | Ship           | `vercel-deploy-claimable`                                                          |
+| "Deprecate / migrate"     | Ship           | `deprecation-and-migration` + `incremental-implementation`                         |
+| "Write docs / record ADR" | Define         | `documentation-and-adrs`                                                           |
+| "Optimize performance"    | Verify         | `performance-optimization`                                                         |
+| "Harden security"         | Verify         | `security-and-hardening` + `defense-in-depth`                                      |
+| "Verify before merge"     | Ship           | `reconcile` + `verification-gates`                                                 |
+| "Create a skill"          | Build          | `skill-creator` + `writing-skills`                                                 |
+
 ---
 
 ## Context Management

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

@@ -92,6 +92,7 @@ Every diff you produce must meet these standards:
 - **Strong typing** — no `as any`, no `@ts-ignore` unless documented with a reason
 - **Reuse existing interfaces** — extend or compose existing types before creating new ones
 - **Minimal tests** — if the file you're editing has adjacent tests, add coverage for your change
+
 ## Ritual Structure
 
 Each task follows a five-phase ritual. Constraints create the container; the ritual transforms intent into output.
@@ -181,9 +182,9 @@ Load contextually when needed:
 | Debug/bug work         | `systematic-debugging`, `root-cause-tracing`               |
 | Test-heavy work        | `test-driven-development`, `testing-anti-patterns`         |
 | UI work                | `frontend-design`, `react-best-practices`                  |
-| Parallel orchestration | `swarm-coordination`, `beads-bridge`                       |
+| Parallel orchestration | `swarm-coordination`                                       |
 | Before completion      | `requesting-code-review`, `finishing-a-development-branch` |
-| Codebase exploration   | `code-navigation`                                          |
+| Codebase exploration   | `code-search-patterns`                                     |
 
 ## Execution Mode
 

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

@@ -43,20 +43,20 @@ Find relevant files, symbols, and usage paths quickly for the caller.
 
 ## Tools — Use These for Local Code Search
 
-**Prefer tilth CLI** (`npx -y tilth`) for symbol search and file reading — it combines grep + tree-sitter + cat into one call. See `tilth-cli` skill for full syntax.
-
-| Tool | Use For | Example |
-|------|---------|--------|
-| `tilth` (symbol) | AST-aware symbol search (definitions + usages) | `npx -y tilth handleAuth --scope src/` |
-| `tilth` (read) | Smart file reading with outline for large files | `npx -y tilth src/auth.ts --section 44-89` |
-| `tilth` (glob) | Find files by pattern with token estimates | `npx -y tilth "*.test.ts" --scope src/` |
-| `tilth` (map) | Codebase structural overview | `npx -y tilth --map --scope src/` |
-| `grep` | Find text/regex patterns in files | `grep(pattern: "PatchEntry", include: "*.ts")` |
-| `glob` | Find files by name/pattern | `glob(pattern: "src/**/*.ts")` |
-| `lsp` (goToDefinition) | Jump to symbol definition | `lsp(operation: "goToDefinition", filePath: "...", line: N, character: N)` |
-| `lsp` (findReferences) | Find all usages of a symbol | `lsp(operation: "findReferences", ...)` |
-| `lsp` (hover) | Get type info and docs | `lsp(operation: "hover", ...)` |
-| `read` | Read file content | `read(filePath: "src/utils/patch.ts")` |
+**Prefer tilth CLI** (`npx -y tilth`) for symbol search and file reading — it combines grep + tree-sitter + cat into one call. See `code-search-patterns` skill for full syntax.
+
+| Tool                   | Use For                                         | Example                                                                    |
+| ---------------------- | ----------------------------------------------- | -------------------------------------------------------------------------- |
+| `tilth` (symbol)       | AST-aware symbol search (definitions + usages)  | `npx -y tilth handleAuth --scope src/`                                     |
+| `tilth` (read)         | Smart file reading with outline for large files | `npx -y tilth src/auth.ts --section 44-89`                                 |
+| `tilth` (glob)         | Find files by pattern with token estimates      | `npx -y tilth "*.test.ts" --scope src/`                                    |
+| `tilth` (map)          | Codebase structural overview                    | `npx -y tilth --map --scope src/`                                          |
+| `grep`                 | Find text/regex patterns in files               | `grep(pattern: "PatchEntry", include: "*.ts")`                             |
+| `glob`                 | Find files by name/pattern                      | `glob(pattern: "src/**/*.ts")`                                             |
+| `lsp` (goToDefinition) | Jump to symbol definition                       | `lsp(operation: "goToDefinition", filePath: "...", line: N, character: N)` |
+| `lsp` (findReferences) | Find all usages of a symbol                     | `lsp(operation: "findReferences", ...)`                                    |
+| `lsp` (hover)          | Get type info and docs                          | `lsp(operation: "hover", ...)`                                             |
+| `read`                 | Read file content                               | `read(filePath: "src/utils/patch.ts")`                                     |
 
 **NEVER** use `websearch`, `webfetch`, or `codesearch` — those search the internet, not your project.
 **NEVER** modify files or run destructive commands — bash is for tilth CLI and read-only operations only.

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

@@ -157,7 +157,7 @@ Before claiming task done:
 4. Run validation (lint/typecheck/tests as applicable)
 5. Report changed files with `file:line` references
 
-**Code navigation:** Use tilth CLI for AST-aware search when available — see `tilth-cli` skill for syntax. Prefer `npx -y tilth <symbol> --scope <dir>` over grep for symbol definitions.
+**Code navigation:** Use tilth CLI for AST-aware search when available — see `code-search-patterns` skill for syntax. Prefer `npx -y tilth <symbol> --scope <dir>` over grep for symbol definitions.
 
 ## Progress Updates
 

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

@@ -386,7 +386,7 @@ When planning under constraint:
 4. **Release**: Write actionable plan with exact file paths, commands, and verification
 5. **Reset**: End with a concrete next command (`/ship <id>`, `/start <child-id>`, etc.)
 
-**Code navigation:** Use tilth CLI for AST-aware search and `--map` for structural overview — see `tilth-cli` skill.
+**Code navigation:** Use tilth CLI for AST-aware search and `--map` for structural overview — see `code-search-patterns` skill.
 
 ## Output
 

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

@@ -178,7 +178,7 @@ return <div>No messages</div>  // State exists but not used
 3. For each finding: explain why, when it happens, and impact
 4. If no qualifying findings exist, say so explicitly
 
-**Code navigation:** Use tilth CLI for AST-aware symbol search when tracing cross-file dependencies — see `tilth-cli` skill. Prefer `npx -y tilth <symbol> --scope <dir>` over grep for understanding call chains.
+**Code navigation:** Use tilth CLI for AST-aware symbol search when tracing cross-file dependencies — see `code-search-patterns` skill. Prefer `npx -y tilth <symbol> --scope <dir>` over grep for understanding call chains.
 
 ## Output
 

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

@@ -71,7 +71,6 @@ Route by need:
 | Mockup-to-implementation mapping              | `mockup-to-code`      |
 | Distinctive UI direction / anti-slop guidance | `frontend-design`     |
 | Figma design data (read/write via MCP)        | `figma-go`            |
-| OpenPencil design-as-code workflow            | `pencil`              |
 | Brand identity extraction from URLs           | `webclaw`             |
 
 ### Taste-Skill Variants (installed)
@@ -108,14 +107,6 @@ If Figma is available, request MCP access via `figma-go` and ground feedback in
 2. Use `figma-go` to pull `get_design_context` or `get_node`
 3. Reference node IDs in findings for traceability
 
-## OpenPencil Workflow (when no Figma)
-
-If design must be created or iterated quickly, use OpenPencil via the legacy `pencil` skill:
-
-1. Create/modify `.op` via `op` CLI
-2. Export PNGs or code for review
-3. Provide audit with node-level critique where possible
-
 ## Brand Extraction Workflow (when auditing existing sites)
 
 Use `webclaw` MCP to extract brand identity from live sites:

package/dist/template/.opencode/opencode.json

@@ -109,11 +109,6 @@
 			"enabled": true,
 			"timeout": 120000,
 			"type": "local"
-		},
-		"pencil": {
-			"command": ["openpencil-mcp"],
-			"enabled": false,
-			"type": "local"
 		}
 	},
 	"model": "opencode/minimax-m2.5-free",

package/dist/template/.opencode/package.json

@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "@google/stitch-sdk": "^0.0.3",
-    "@opencode-ai/plugin": "1.4.0"
+    "@opencode-ai/plugin": "1.4.3"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",