opencodekit 0.15.20 → 0.16.0

package/dist/template/.opencode/memory/research/openspec-analysis.md

@@ -0,0 +1,226 @@
+# OpenSpec Research Analysis
+
+**Date:** 2026-02-01
+**Source:** https://github.com/Fission-AI/OpenSpec
+
+## What is OpenSpec?
+
+OpenSpec is a **spec-driven development framework** for AI coding assistants. It provides:
+- A structured workflow for planning → implementing → verifying changes
+- Schema-based artifact generation (proposal → specs → design → tasks)
+- Git-tracked change folders with delta specs
+- Archive system that merges changes into canonical specs
+
+## Core Philosophy
+
+| Principle | Description |
+|-----------|-------------|
+| **Fluid, not rigid** | Commands are actions, not phase gates |
+| **Iterative, not waterfall** | Edit artifacts during implementation |
+| **Easy, not complex** | Sensible defaults, minimal config |
+| **Brownfield-first** | Existing code > greenfield patterns |
+
+## Key Concepts
+
+### Directory Structure
+```
+openspec/
+├── config.yaml          # Project settings, context, rules
+├── specs/               # Source of truth for current behavior
+└── changes/
+    └── <change-name>/
+        ├── .openspec.yaml
+        ├── proposal.md
+        ├── specs/       # Delta specs (ADDED/MODIFIED/REMOVED)
+        ├── design.md
+        └── tasks.md
+```
+
+### Artifact Flow (DAG)
+```
+proposal → specs → design → tasks → apply
+```
+
+Dependencies are **enablers not gates** - can edit earlier artifacts later.
+
+### Commands (OPSX Syntax)
+| Command | Purpose |
+|---------|---------|
+| `/opsx:explore` | Think through ideas before committing |
+| `/opsx:new` | Create change folder |
+| `/opsx:continue` | Create next artifact |
+| `/opsx:ff` | Fast-forward (create all artifacts) |
+| `/opsx:apply` | Implement from tasks |
+| `/opsx:verify` | Validate completeness/correctness/coherence |
+| `/opsx:sync` | Merge delta specs to main specs |
+| `/opsx:archive` | Complete and archive change |
+
+---
+
+## Schema System
+
+### schema.yaml Format
+```yaml
+name: spec-driven
+version: 1
+description: The default workflow
+
+artifacts:
+  - id: proposal
+    generates: proposal.md
+    template: proposal.md
+    instruction: |
+      Create a proposal explaining WHY this change is needed.
+    requires: []
+
+  - id: specs
+    generates: specs/**/*.md
+    template: spec.md
+    instruction: |
+      Create spec files for each capability.
+    requires: [proposal]
+
+  - id: design
+    generates: design.md
+    template: design.md
+    requires: [specs]
+
+  - id: tasks
+    generates: tasks.md
+    template: tasks.md
+    requires: [design]
+
+apply:
+  requires: [tasks]
+  tracks: tasks.md
+```
+
+### config.yaml Format
+```yaml
+schema: spec-driven
+
+context: |
+  Tech stack: TypeScript, React, Node.js
+  API style: RESTful
+  Testing: Jest
+
+rules:
+  proposal:
+    - Include rollback plan
+  specs:
+    - Use Given/When/Then format
+```
+
+- **context**: Injected into ALL artifacts
+- **rules**: Injected only into MATCHING artifact
+
+---
+
+## What OpenCodeKit Can Learn
+
+### 1. **Artifact-Based Workflow** (HIGH VALUE)
+OpenSpec separates planning artifacts with explicit dependencies:
+- `proposal.md` → Why + scope
+- `specs/**/*.md` → Behavioral specs
+- `design.md` → How to implement
+- `tasks.md` → Checklist
+
+**Current gap:** Our `/plan` creates a single plan.md. Consider:
+- Explicit spec files per capability
+- Delta spec format for changes to existing behavior
+
+### 2. **Schema-Driven Configuration** (MEDIUM VALUE)
+OpenSpec uses YAML schemas that define:
+- Artifact types and their dependencies
+- Templates for each artifact
+- Instructions for AI
+
+**Current gap:** Our commands are hardcoded. Consider:
+- Making command workflows configurable via schema
+- Custom workflows per project (rapid, spec-driven, research-first)
+
+### 3. **Context + Rules Injection** (HIGH VALUE)
+OpenSpec injects project context and per-artifact rules into prompts.
+
+**Current gap:** Our AGENTS.md is global. Consider:
+- `config.yaml` with `context:` block for project-specific injection
+- Per-artifact rules in command definitions
+
+### 4. **Verify Command** (MEDIUM VALUE)
+OpenSpec has explicit `/opsx:verify` that checks:
+- Completeness: All artifacts exist, tasks itemized
+- Correctness: Implementation matches specs
+- Coherence: Artifacts don't contradict each other
+
+**Current gap:** Our `/ship` has verification gates but not coherence checking.
+
+### 5. **Archive/Sync Flow** (LOW VALUE for now)
+OpenSpec maintains canonical specs and merges deltas.
+
+**Current gap:** Not needed yet. We don't track specs long-term.
+
+### 6. **Fluid Actions vs Phase Gates** (HIGH VALUE)
+OpenSpec allows editing artifacts during implementation - no rigid phases.
+
+**Current status:** Our workflow is already fluid (Beads). No change needed.
+
+---
+
+## Recommended Adaptations
+
+### Phase 1: Config-Based Context Injection
+Add to `.opencode/opencode.json`:
+```json
+{
+  "context": "Tech stack: TypeScript, React...",
+  "rules": {
+    "plan": ["Include rollback plan"],
+    "ship": ["Run all verification gates"]
+  }
+}
+```
+
+### Phase 2: Schema-Configurable Workflows
+Create `.opencode/schema/` for custom command workflows:
+```yaml
+# .opencode/schema/rapid.yaml
+name: rapid
+artifacts:
+  - id: proposal
+    template: proposal.md
+  - id: tasks
+    template: tasks.md
+    requires: [proposal]
+```
+
+### Phase 3: Spec Files Per Bead
+Create spec structure:
+```
+.beads/artifacts/<bead-id>/
+├── spec.md           # Current (single file)
+├── specs/            # NEW: Per-capability specs
+│   └── <capability>.md
+└── plan.md
+```
+
+---
+
+## Key Differences
+
+| Aspect | OpenSpec | OpenCodeKit |
+|--------|----------|-------------|
+| Task tracking | Filesystem-based | Beads (git-backed) |
+| Workflow | Schema-defined | Command-defined |
+| Specs | Canonical + Delta | Per-bead only |
+| Config | YAML | JSON |
+| Context injection | Built-in | Manual (AGENTS.md) |
+| Verification | 3 dimensions | Test/lint gates |
+
+---
+
+## Next Steps
+
+1. **Immediate:** Add `context` block to opencode.json spec
+2. **Short-term:** Create `/verify` command with coherence checking
+3. **Medium-term:** Schema-configurable workflows
+4. **Long-term:** Canonical spec maintenance (if needed)

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

@@ -6,7 +6,8 @@
       "model": "opencode/kimi-k2.5-free"
     },
     "compaction": {
-      "description": "Session summarizer for context continuity across compactions"
+      "description": "Session summarizer for context continuity across compactions",
+      "model": "opencode/minimax-m2.1-free"
     },
     "explore": {
       "description": "Fast codebase search specialist",
@@ -49,26 +50,65 @@
   "experimental": {},
   "formatter": {
     "biome": {
-      "command": ["npx", "@biomejs/biome", "check", "--write", "$FILE"],
-      "extensions": [".js", ".jsx", ".ts", ".tsx", ".json", ".jsonc"]
+      "command": [
+        "npx",
+        "@biomejs/biome",
+        "check",
+        "--write",
+        "$FILE"
+      ],
+      "extensions": [
+        ".js",
+        ".jsx",
+        ".ts",
+        ".tsx",
+        ".json",
+        ".jsonc"
+      ]
     },
     "cargo-fmt": {
-      "command": ["cargo", "fmt", "--", "$FILE"],
-      "extensions": [".rs"]
+      "command": [
+        "cargo",
+        "fmt",
+        "--",
+        "$FILE"
+      ],
+      "extensions": [
+        ".rs"
+      ]
     },
     "java-formatter": {
-      "command": ["google-java-format", "--replace", "$FILE"],
+      "command": [
+        "google-java-format",
+        "--replace",
+        "$FILE"
+      ],
       "environment": {
         "JAVA_HOME": "{env:JAVA_HOME}"
       },
-      "extensions": [".java"]
+      "extensions": [
+        ".java"
+      ]
     },
     "laravel-pint": {
-      "command": ["npx", "laravel-pint", "--preset", "psr12", "$FILE"],
-      "extensions": [".php"]
+      "command": [
+        "npx",
+        "laravel-pint",
+        "--preset",
+        "psr12",
+        "$FILE"
+      ],
+      "extensions": [
+        ".php"
+      ]
     },
     "oxfmt": {
-      "command": ["npx", "oxfmt", "--write", "$FILE"],
+      "command": [
+        "npx",
+        "oxfmt",
+        "--write",
+        "$FILE"
+      ],
       "extensions": [
         ".js",
         ".jsx",
@@ -87,7 +127,10 @@
       ]
     }
   },
-  "instructions": [".opencode/memory/user.md", ".opencode/memory/project/*.md"],
+  "instructions": [
+    ".opencode/memory/user.md",
+    ".opencode/memory/project/tech-stack.md"
+  ],
   "keybinds": {
     "command_list": ";",
     "leader": "`",
@@ -113,15 +156,21 @@
       "*": "allow",
       "cat *": "allow",
       "git branch *": "allow",
+      "git checkout *": "ask",
+      "git clean *": "ask",
       "git commit *": "ask",
       "git diff *": "allow",
       "git log *": "allow",
+      "git merge *": "ask",
       "git push *": "ask",
       "git rebase *": "ask",
       "git reset *": "ask",
       "git status *": "allow",
       "ls *": "allow",
       "npm *": "allow",
+      "npm publish *": "ask",
+      "npm run db:push*": "ask",
+      "npm run db:reset*": "deny",
       "npx *": "allow",
       "rm *": "deny",
       "rm -rf *": "deny",
@@ -133,9 +182,15 @@
     "question": "allow",
     "read": {
       "*": "allow",
+      "*credentials*": "deny",
       "*.env": "deny",
       "*.env.*": "deny",
-      "*.env.example": "allow"
+      "*.env.example": "allow",
+      "*.key": "deny",
+      "*.pem": "deny",
+      "*password*": "deny",
+      "*secret*": "deny",
+      "*token*": "deny"
     }
   },
   "plugin": [
@@ -239,32 +294,30 @@
             }
           }
         },
-        "gpt-5-mini": {
+        "gpt-5.2": {
           "attachment": true,
           "reasoning": true,
           "temperature": true,
           "tool_call": true,
+          "options": {
+            "reasoningEffort": "medium",
+            "reasoningSummary": "auto"
+          },
           "variants": {
             "high": {
-              "options": {
-                "reasoning": {
-                  "effort": "high"
-                }
-              }
+              "reasoningEffort": "high",
+              "reasoningSummary": "auto",
+              "include": [
+                "reasoning.encrypted_content"
+              ]
             },
             "low": {
-              "options": {
-                "reasoning": {
-                  "effort": "low"
-                }
-              }
+              "reasoningEffort": "low",
+              "reasoningSummary": "auto"
             },
             "medium": {
-              "options": {
-                "reasoning": {
-                  "effort": "medium"
-                }
-              }
+              "reasoningEffort": "medium",
+              "reasoningSummary": "auto"
             }
           }
         },
@@ -273,27 +326,30 @@
           "reasoning": true,
           "temperature": true,
           "tool_call": true,
+          "options": {
+            "reasoningEffort": "medium",
+            "reasoningSummary": "auto"
+          },
           "variants": {
+            "fast": {
+              "disabled": true
+            },
             "high": {
-              "options": {
-                "reasoning": {
-                  "effort": "high"
-                }
-              }
+              "reasoningEffort": "high",
+              "reasoningSummary": "auto",
+              "textVerbosity": "medium",
+              "include": [
+                "reasoning.encrypted_content"
+              ]
             },
             "low": {
-              "options": {
-                "reasoning": {
-                  "effort": "low"
-                }
-              }
+              "reasoningEffort": "low",
+              "reasoningSummary": "auto"
             },
             "medium": {
-              "options": {
-                "reasoning": {
-                  "effort": "medium"
-                }
-              }
+              "reasoningEffort": "medium",
+              "reasoningSummary": "auto",
+              "textVerbosity": "medium"
             }
           }
         }
@@ -307,13 +363,17 @@
               "disabled": true
             },
             "high": {
-              "include": ["reasoning.encrypted_content"],
+              "include": [
+                "reasoning.encrypted_content"
+              ],
               "reasoningEffort": "high",
               "reasoningSummary": "auto",
               "textVerbosity": "low"
             },
             "medium": {
-              "include": ["reasoning.encrypted_content"],
+              "include": [
+                "reasoning.encrypted_content"
+              ],
               "reasoningEffort": "medium",
               "reasoningSummary": "auto",
               "textVerbosity": "low"
@@ -326,13 +386,17 @@
               "disabled": true
             },
             "high": {
-              "include": ["reasoning.encrypted_content"],
+              "include": [
+                "reasoning.encrypted_content"
+              ],
               "reasoningEffort": "high",
               "reasoningSummary": "auto",
               "textVerbosity": "low"
             },
             "medium": {
-              "include": ["reasoning.encrypted_content"],
+              "include": [
+                "reasoning.encrypted_content"
+              ],
               "reasoningEffort": "medium",
               "reasoningSummary": "auto",
               "textVerbosity": "low"
@@ -362,8 +426,14 @@
             "output": 65536
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini 2 5 Flash"
         },
@@ -373,8 +443,14 @@
             "output": 65536
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini 2 5 Flash Lite"
         },
@@ -384,8 +460,14 @@
             "output": 65536
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini 2 5 Pro"
         },
@@ -395,8 +477,14 @@
             "output": 65536
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini 3 Flash Preview",
           "options": {
@@ -433,8 +521,14 @@
             "output": 65536
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini 3 Pro Preview",
           "options": {
@@ -464,8 +558,14 @@
             "output": 64000
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini Claude Opus 4 5 Thinking",
           "options": {
@@ -494,8 +594,14 @@
             "output": 64000
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini Claude Sonnet 4 5"
         },
@@ -505,8 +611,14 @@
             "output": 64000
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini Claude Sonnet 4 5 Thinking",
           "options": {
@@ -784,8 +896,7 @@
   "tools": {
     "context7-query-docs": true,
     "context7-resolve-library-id": true,
-    "grepsearch": true,
-    "oracle": true
+    "grepsearch": true
   },
   "tui": {
     "diff_style": "auto",

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

@@ -11,10 +11,10 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.1.47"
+    "@opencode-ai/plugin": "1.1.48"
   },
   "devDependencies": {
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.1.0",
     "typescript": "^5.9.3"
   }
 }