@maestria/opencode 0.3.6 → 0.3.8

package/agents/adventurer.md

@@ -1,5 +1,6 @@
 ---
-description: Codebase reconnaissance agent for deep code understanding.
+description: >
+  Codebase reconnaissance agent for deep code understanding.
   Maps unknown territory — traces call chains, maps module relationships,
   generates structured reports for downstream specialists.
   Use for: understanding unfamiliar code, tracing dependencies, gathering
@@ -13,11 +14,13 @@ permission:
   lsp: allow
   webfetch: allow
   skill: allow
+  todowrite: allow
   edit: deny
   bash:
     "*": ask
     "git log*": allow
     "git diff*": allow
+    "git status*": allow
     "which *": allow
 ---
 

package/agents/architect.md

@@ -1,5 +1,6 @@
 ---
-description: Architecture decisions using decision matrices and ADRs.
+description: >
+  Architecture decisions using decision matrices and ADRs.
   Evaluates options with weighted criteria, clarifies business context first.
   Use for: technology choices, implementation approaches, trade-off analysis.
 mode: subagent
@@ -13,6 +14,9 @@ permission:
   edit: deny
   bash:
     "*": ask
+    "git diff*": allow
+    "git log*": allow
+    "git status*": allow
     "which *": allow
     "npm view *": allow
 ---

package/agents/builder.md

@@ -1,5 +1,6 @@
 ---
-description: Focused implementation agent for atomic tasks.
+description: >
+  Focused implementation agent for atomic tasks.
   Executes one verifiable unit of work with minimal context.
   Use for: targeted fixes, feature implementation, refactors, adding tests.
 mode: subagent
@@ -20,6 +21,7 @@ permission:
     "npm test*": allow
     "pnpm test*": allow
     "npx tsc*": allow
+    "npm view *": allow
 ---
 
 You are a focused implementation agent.

package/agents/diagnose.md

@@ -1,5 +1,6 @@
 ---
-description: Systematic 6-step regression tracing.
+description: >
+  Systematic 6-step regression tracing.
   From error message to root cause to prevention.
   Use for: cryptic errors, regressions, production bugs.
 mode: subagent
@@ -10,6 +11,7 @@ permission:
   lsp: allow
   webfetch: allow
   skill: allow
+  todowrite: allow
   edit: ask
   bash:
     "*": ask

package/agents/orchestrator.md

@@ -1,5 +1,6 @@
 ---
-description: Manager agent for complex multi-step tasks.
+description: >
+  Manager agent for complex multi-step tasks.
   Breaks down work, delegates to specialists, integrates results.
   Use for: multi-file features, cross-domain tasks, 3+ step workflows.
 mode: all
@@ -15,6 +16,9 @@ permission:
     "git status*": allow
     "git diff*": allow
     "git log*": allow
+    "git show*": allow
+    "git branch*": allow
+    "ls *": allow
     "which *": allow
     "pwd": allow
     "npx --yes skills@latest *": allow

package/agents/planner.md

@@ -1,5 +1,6 @@
 ---
-description: Create detailed implementation plans with phased dependencies, timelines, and success criteria.
+description: >
+  Create detailed implementation plans with phased dependencies, timelines, and success criteria.
   Breaks down complex features into verifiable milestones.
   Use for: complex features requiring multi-phase execution, when the plan needs review before building.
 mode: subagent
@@ -14,6 +15,7 @@ permission:
     "git status*": allow
     "git diff*": allow
     "git log*": allow
+    "which *": allow
   webfetch: allow
   todowrite: allow
   skill: allow

package/agents/reviewer.md

@@ -1,5 +1,6 @@
 ---
-description: Code review with quality gates.
+description: >
+  Code review with quality gates.
   Reviews code for correctness, edge cases, security, performance, maintainability,
   and adherence to conventions. Provides specific, actionable feedback.
   Use for: PR review, pre-commit review, architecture document review.
@@ -16,6 +17,7 @@ permission:
     "git status*": allow
     "git diff*": allow
     "git log*": allow
+    "git show*": allow
   webfetch: allow
 ---
 

package/agents/writer.md

@@ -1,5 +1,6 @@
 ---
-description: Documentation writing following structured patterns.
+description: >
+  Documentation writing following structured patterns.
   Creates clear, comprehensive docs for code, APIs, systems.
   Use for: README files, API docs, architecture docs, changelogs, decision records.
 mode: subagent
@@ -7,12 +8,16 @@ permission:
   read: allow
   glob: allow
   grep: allow
+  lsp: allow
   edit: allow
   webfetch: allow
   skill: allow
+  todowrite: allow
   bash:
     "*": ask
     "git status*": allow
+    "git diff*": allow
+    "git log*": allow
     "npm view *": allow
 ---
 

package/dist/index.js

@@ -1,105 +1,12 @@
 import { readFileSync, readdirSync } from "fs";
 import { join, dirname, basename } from "path";
+import { parse as parseYaml } from "yaml";
 import { fileURLToPath } from "url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const agentsDir = join(__dirname, "..", "agents");
 const rulesPath = join(__dirname, "..", "rules", "AGENTS.md");
-/**
- * Parse a simple YAML frontmatter block. Handles:
- * - string values ("allow", "ask", "deny")
- * - nested objects (bash: { "*": "ask" })
- * - multiline strings (description)
- */
-function parseFrontmatter(yaml) {
-    const lines = yaml.split("\n");
-    const result = {};
-    let currentKey = null;
-    let currentValue = [];
-    let nestedStack = [];
-    function flushValue() {
-        if (currentKey === null)
-            return;
-        const value = currentValue.join(" ").trim();
-        if (value) {
-            if (nestedStack.length > 0) {
-                nestedStack[nestedStack.length - 1].obj[currentKey] = value;
-            }
-            else {
-                result[currentKey] = value;
-            }
-        }
-        currentKey = null;
-        currentValue = [];
-    }
-    function getIndent(line) {
-        let count = 0;
-        for (const ch of line) {
-            if (ch === " " || ch === "\t")
-                count++;
-            else
-                break;
-        }
-        return count;
-    }
-    function parseKeyValue(line) {
-        const colonIdx = line.indexOf(":");
-        if (colonIdx === -1)
-            return null;
-        const key = line.slice(0, colonIdx).trim();
-        const value = line.slice(colonIdx + 1).trim();
-        return { key, value };
-    }
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const indent = getIndent(line);
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith("#"))
-            continue;
-        const kv = parseKeyValue(line);
-        // Pop nested stacks that have ended
-        while (nestedStack.length > 0 && indent <= nestedStack[nestedStack.length - 1].indent) {
-            flushValue();
-            nestedStack.pop();
-        }
-        if (kv) {
-            flushValue();
-            currentKey = kv.key;
-            if (kv.value) {
-                // Inline value: key: value
-                if (nestedStack.length > 0) {
-                    nestedStack[nestedStack.length - 1].obj[currentKey] = kv.value;
-                }
-                else {
-                    result[currentKey] = kv.value;
-                }
-                currentKey = null;
-            }
-            else {
-                // Potential nested object: key:
-                // Check next line for indentation
-                const nextLine = lines[i + 1];
-                if (nextLine && getIndent(nextLine) > indent) {
-                    const nestedObj = {};
-                    if (nestedStack.length > 0) {
-                        nestedStack[nestedStack.length - 1].obj[currentKey] = nestedObj;
-                    }
-                    else {
-                        result[currentKey] = nestedObj;
-                    }
-                    nestedStack.push({ key: currentKey, obj: nestedObj, indent });
-                    currentKey = null;
-                }
-                // Otherwise it's an empty value, ignore
-            }
-        }
-        else {
-            // Continuation line (for multiline strings like description)
-            if (currentKey && indent > 0) {
-                currentValue.push(trimmed);
-            }
-        }
-    }
-    flushValue();
+function parseFrontmatter(yamlStr) {
+    const result = parseYaml(yamlStr);
     return {
         description: result.description || "",
         mode: result.mode || "subagent",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maestria/opencode",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "OpenCode plugin encoding AI engineering praxis: rules, agents, and workflow discipline.",
   "keywords": [
     "agents",
@@ -39,7 +39,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@opencode-ai/plugin": "^1.17.0"
+    "@opencode-ai/plugin": "^1.17.0",
+    "yaml": "^2.7.0"
   },
   "devDependencies": {
     "@types/node": "^24",