@maestria/opencode 0.4.2 → 0.4.5

package/agents/adventurer.md

@@ -18,11 +18,11 @@ permission:
   todowrite: allow
   edit: deny
   bash:
-    "*": ask
-    "git log*": allow
-    "git diff*": allow
-    "git status*": allow
-    "which *": allow
+    '*': ask
+    'git log*': allow
+    'git diff*': allow
+    'git status*': allow
+    'which *': allow
 ---
 
 You are a codebase reconnaissance agent.

package/agents/architect.md

@@ -14,12 +14,12 @@ permission:
   skill: allow
   edit: deny
   bash:
-    "*": ask
-    "git diff*": allow
-    "git log*": allow
-    "git status*": allow
-    "which *": allow
-    "npm view *": allow
+    '*': ask
+    'git diff*': allow
+    'git log*': allow
+    'git status*': allow
+    'which *': allow
+    'npm view *': allow
 ---
 
 You make architecture decisions systematically.

package/agents/builder.md

@@ -14,14 +14,14 @@ permission:
   todowrite: allow
   skill: allow
   bash:
-    "*": ask
-    "git status*": allow
-    "git diff*": allow
-    "git log*": allow
-    "npm test*": allow
-    "pnpm test*": allow
-    "npx tsc*": allow
-    "npm view *": allow
+    '*': ask
+    'git status*': allow
+    'git diff*': allow
+    'git log*': allow
+    'npm test*': allow
+    'pnpm test*': allow
+    'npx tsc*': allow
+    'npm view *': allow
 ---
 
 You are a focused implementation agent.

package/agents/diagnose.md

@@ -15,15 +15,15 @@ permission:
   todowrite: allow
   edit: ask
   bash:
-    "*": ask
-    "git status*": allow
-    "git diff*": allow
-    "git log*": allow
-    "git blame*": allow
-    "git show*": allow
-    "which *": allow
-    "env": allow
-    "pwd": allow
+    '*': ask
+    'git status*': allow
+    'git diff*': allow
+    'git log*': allow
+    'git blame*': allow
+    'git show*': allow
+    'which *': allow
+    'env': allow
+    'pwd': allow
 ---
 
 You trace bugs systematically.

package/agents/orchestrator.md

@@ -12,19 +12,19 @@ permission:
   webfetch: deny
   edit: deny
   bash:
-    "*": deny
-    "npx --yes skills@latest *": allow
+    '*': deny
+    'npx --yes skills@latest *': allow
   question: allow
   todowrite: allow
   task:
-    "*": deny
-    "adventurer": allow
-    "architect": allow
-    "builder": allow
-    "diagnose": allow
-    "planner": allow
-    "reviewer": allow
-    "writer": allow
+    '*': deny
+    'adventurer': allow
+    'architect': allow
+    'builder': allow
+    'diagnose': allow
+    'planner': allow
+    'reviewer': allow
+    'writer': allow
   skill: allow
 ---
 

package/agents/planner.md

@@ -11,11 +11,11 @@ permission:
   lsp: allow
   edit: ask
   bash:
-    "*": ask
-    "git status*": allow
-    "git diff*": allow
-    "git log*": allow
-    "which *": allow
+    '*': ask
+    'git status*': allow
+    'git diff*': allow
+    'git log*': allow
+    'which *': allow
   webfetch: allow
   todowrite: allow
   skill: allow

package/agents/reviewer.md

@@ -13,11 +13,11 @@ permission:
   skill: allow
   edit: deny
   bash:
-    "*": ask
-    "git status*": allow
-    "git diff*": allow
-    "git log*": allow
-    "git show*": allow
+    '*': ask
+    'git status*': allow
+    'git diff*': allow
+    'git log*': allow
+    'git show*': allow
   webfetch: allow
 ---
 

package/agents/writer.md

@@ -14,11 +14,11 @@ permission:
   skill: allow
   todowrite: allow
   bash:
-    "*": ask
-    "git status*": allow
-    "git diff*": allow
-    "git log*": allow
-    "npm view *": allow
+    '*': ask
+    'git status*': allow
+    'git diff*': allow
+    'git log*': allow
+    'npm view *': allow
 ---
 
 You write documentation.

package/dist/index.d.ts

@@ -1,3 +1,7 @@
-import type { Plugin } from "@opencode-ai/plugin";
-export declare const MaestriaPlugin: Plugin;
-export default MaestriaPlugin;
+import { Plugin } from "@opencode-ai/plugin";
+
+//#region src/index.d.ts
+declare const MaestriaPlugin: Plugin;
+//#endregion
+export { MaestriaPlugin, MaestriaPlugin as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,101 +1,6 @@
-import { readFileSync, readdirSync } from "fs";
-import { join, dirname, basename } from "path";
-import { parse as parseYaml } from "yaml";
-import { fileURLToPath } from "url";
-import { maestriaOptionsSchema } from "@/modes/types.js";
-import { detectMode, stripKeyword, getModeMarker, getModePrompt } from "@/modes/index.js";
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const agentsDir = join(__dirname, "..", "agents");
-const rulesPath = join(__dirname, "..", "rules", "AGENTS.md");
-function parseFrontmatter(yamlStr) {
-    const result = parseYaml(yamlStr);
-    return {
-        description: result.description || "",
-        mode: result.mode || "subagent",
-        permission: result.permission || {},
-        color: result.color,
-        maxSteps: result.maxSteps ? Number(result.maxSteps) : undefined,
-    };
-}
-/**
- * Read an agent markdown file and split into frontmatter + prompt.
- */
-function parseAgentFile(filePath) {
-    const content = readFileSync(filePath, "utf-8");
-    const name = basename(filePath, ".md");
-    // Split on ---
-    const parts = content.split("---");
-    if (parts.length < 3) {
-        throw new Error(`Invalid agent file: ${filePath} — missing frontmatter`);
-    }
-    const frontmatter = parseFrontmatter(parts[1].trim());
-    const prompt = parts.slice(2).join("---").trim();
-    const config = {
-        description: frontmatter.description,
-        mode: frontmatter.mode,
-        prompt,
-        permission: frontmatter.permission,
-    };
-    if (frontmatter.color)
-        config.color = frontmatter.color;
-    if (frontmatter.maxSteps)
-        config.maxSteps = frontmatter.maxSteps;
-    return { name, config };
-}
-/**
- * Load all agent configs from the bundled agents/ directory.
- */
-function loadAgents() {
-    const files = readdirSync(agentsDir).filter((f) => f.endsWith(".md"));
-    const agents = {};
-    for (const file of files) {
-        const { name, config } = parseAgentFile(join(agentsDir, file));
-        agents[name] = config;
-    }
-    return agents;
-}
-export const MaestriaPlugin = async (_input, options) => {
-    // Validate and parse options with zod
-    const parsed = maestriaOptionsSchema.parse(options ?? {});
-    const disabledKeywords = new Set((parsed.modes?.disabledKeywords ?? []).map((k) => k.toLowerCase()));
-    const agents = loadAgents();
-    return {
-        config: async (input) => {
-            input.agent = {
-                ...input.agent,
-                ...agents,
-            };
-            input.instructions = [...(input.instructions ?? []), rulesPath];
-        },
-        "experimental.session.compacting": async (_input, output) => {
-            output.context.push("Session was compacted. Task tracking is maintained via todowrite. " +
-                "Active context (files, decisions, blockers) was captured before compaction. " +
-                "Continue where you left off.");
-        },
-        "chat.message": async (hookInput, hookOutput) => {
-            // Only fire for the orchestrator agent
-            if (hookInput.agent !== "orchestrator")
-                return;
-            // Find the first text part with user content
-            const textPart = hookOutput.parts.find((p) => p.type === "text");
-            if (!textPart)
-                return;
-            // Detect keyword in the text
-            const result = detectMode(textPart.text, disabledKeywords);
-            if (!result)
-                return;
-            // Strip keyword from text and prepend mode marker + prompt inline.
-            // We embed everything in the existing text part rather than injecting
-            // a second text part into `parts`, because the OpenCode runtime does
-            // not handle multiple text parts per message (causes a hang).
-            textPart.text = [
-                getModeMarker(result.mode),
-                "",
-                getModePrompt(result.mode),
-                "",
-                stripKeyword(textPart.text, result),
-            ].join("\n");
-        },
-    };
-};
-export default MaestriaPlugin;
+import{readFileSync as e,readdirSync as t}from"fs";import{basename as n,dirname as r,join as i}from"path";import{parse as a}from"yaml";import{fileURLToPath as o}from"url";import{z as s}from"zod";import{escapeRegExp as c}from"es-toolkit";const l=s.enum([`fein`,`sonar`,`blitz`]),u=s.object({modes:s.object({disabledKeywords:s.array(l).optional()}).optional()}),d={fein:[`## MODE: fein (Full Pipeline)`,``,`Execute the complete fein pipeline: mandatory reconnaissance`,`(@adventurer) → design/plan (@architect or @planner) →`,`implementation (@builder) → review (@reviewer).`,`Do NOT skip any phase unless the user explicitly overrides`,`in the same turn.`].join(`
+`),sonar:[`## MODE: sonar (Research Only)`,``,`Research mode: reconnaissance and design only. Delegate to`,`@adventurer (recon) followed by @architect or @planner`,`(analysis/design). STOP after delivering findings and design.`,`Do NOT implement, write code, or create any production files.`].join(`
+`),blitz:[`## MODE: blitz (Fast Implementation)`,``,`Speed mode: skip reconnaissance and design gates. Go directly`,`to @builder for implementation. Only use @adventurer if the`,`codebase context is genuinely unknown (not as a default step).`,`Skip @reviewer unless the user explicitly requests review.`].join(`
+`)},f={fein:`[MODE: fein]`,sonar:`[MODE: sonar]`,blitz:`[MODE: blitz]`},p=[`fein`,`sonar`,`blitz`],m={fein:3,sonar:2,blitz:1},h=/```[\s\S]*?```|`[^`]*`/g;function g(e){let t=[],n;for(;(n=h.exec(e))!==null;)t.push([n.index,n.index+n[0].length]);return t}function _(e,t){return t.some(([t,n])=>e>=t&&e<n)}function v(e){return RegExp(`\\b${c(e)}\\b`,`gi`)}function y(e,t){let n=g(e),r=t?new Set(Array.from(t).map(e=>e.toLowerCase())):void 0,i=null;for(let t of p){if(r?.has(t))continue;let a=v(t),o;for(;(o=a.exec(e))!==null;)_(o.index,n)||(i===null||m[t]>m[i.mode])&&(i={keyword:o[0],index:o.index,mode:t})}return i===null?null:{mode:i.mode,keyword:i.keyword,index:i.index,prompt:d[i.mode],marker:f[i.mode]}}function b(e,t){return(e.slice(0,t.index)+e.slice(t.index+t.keyword.length).replace(/^:\s*/,``)).replace(/\s{2,}/g,` `).trim()}function x(e){return C(e)?d[e]:``}function S(e){return C(e)?f[e]:``}function C(e){return p.includes(e)}const w=r(o(import.meta.url)),T=i(w,`..`,`agents`),E=i(w,`..`,`rules`,`AGENTS.md`);function D(e){let t=a(e);return{description:t.description||``,mode:t.mode||`subagent`,permission:t.permission||{},color:t.color,maxSteps:t.maxSteps?Number(t.maxSteps):void 0}}function O(t){let r=e(t,`utf-8`),i=n(t,`.md`),a=r.split(`---`);if(a.length<3)throw Error(`Invalid agent file: ${t} — missing frontmatter`);let o=D(a[1].trim()),s=a.slice(2).join(`---`).trim(),c={description:o.description,mode:o.mode,prompt:s,permission:o.permission};return o.color&&(c.color=o.color),o.maxSteps&&(c.maxSteps=o.maxSteps),{name:i,config:c}}function k(){let e=t(T).filter(e=>e.endsWith(`.md`)),n={};for(let t of e){let{name:e,config:r}=O(i(T,t));n[e]=r}return n}const A=async(e,t)=>{let n=u.parse(t??{}),r=new Set((n.modes?.disabledKeywords??[]).map(e=>e.toLowerCase())),i=k();return{config:async e=>{e.agent={...e.agent,...i},e.instructions=[...e.instructions??[],E]},"experimental.session.compacting":async(e,t)=>{t.context.push(`Session was compacted. Task tracking is maintained via todowrite. Active context (files, decisions, blockers) was captured before compaction. Continue where you left off.`)},"chat.message":async(e,t)=>{if(e.agent!==`orchestrator`)return;let n=t.parts.find(e=>e.type===`text`);if(!n)return;let i=y(n.text,r);i&&(n.text=[S(i.mode),``,x(i.mode),``,b(n.text,i)].join(`
+`))}}};export{A as MaestriaPlugin,A as default};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["parseYaml"],"sources":["../src/modes/types.ts","../src/modes/prompts.ts","../src/modes/index.ts","../src/index.ts"],"sourcesContent":["/**\n * Types for keyword-triggered workflow modes.\n *\n * @see ADR-008 for full design context.\n */\n\nimport { z } from 'zod';\n\n/**\n * Valid mode keywords.\n *\n * - `\"fein\"` -- Full pipeline (recon -> design -> build -> review)\n * - `\"sonar\"` -- Research only (recon + design, stop before build)\n * - `\"blitz\"` -- Fast implementation (builder direct, skip recon/design/review)\n */\nexport const modeKeywordSchema = z.enum(['fein', 'sonar', 'blitz']);\nexport type ModeKeyword = z.infer<typeof modeKeywordSchema>;\n\n/**\n * Plugin-level options for @maestria/opencode.\n */\nexport const maestriaOptionsSchema = z.object({\n  modes: z\n    .object({\n      disabledKeywords: z.array(modeKeywordSchema).optional(),\n    })\n    .optional(),\n});\nexport type MaestriaPluginOptions = z.infer<typeof maestriaOptionsSchema>;\n\n/**\n * Result returned when a mode keyword is detected in a message.\n */\nexport interface ModeResult {\n  /** The resolved mode keyword (lowercase). */\n  mode: ModeKeyword;\n  /** The keyword string as matched in the original text. */\n  keyword: string;\n  /** The character index where the keyword starts in the original text. */\n  index: number;\n  /** The mode prompt text to inject. */\n  prompt: string;\n  /** The mode marker string like `[MODE: fein]`. */\n  marker: string;\n}\n","import type { ModeKeyword } from '@/modes/types.js';\n\n/**\n * Mode prompt text for each keyword.\n * These are injected into the turn when a mode is detected.\n *\n * @see ADR-008 (section \"Mode Prompts\")\n */\nexport const MODE_PROMPTS: Record<ModeKeyword, string> = {\n  fein: [\n    '## MODE: fein (Full Pipeline)',\n    '',\n    'Execute the complete fein pipeline: mandatory reconnaissance',\n    '(@adventurer) → design/plan (@architect or @planner) →',\n    'implementation (@builder) → review (@reviewer).',\n    'Do NOT skip any phase unless the user explicitly overrides',\n    'in the same turn.',\n  ].join('\\n'),\n\n  sonar: [\n    '## MODE: sonar (Research Only)',\n    '',\n    'Research mode: reconnaissance and design only. Delegate to',\n    '@adventurer (recon) followed by @architect or @planner',\n    '(analysis/design). STOP after delivering findings and design.',\n    'Do NOT implement, write code, or create any production files.',\n  ].join('\\n'),\n\n  blitz: [\n    '## MODE: blitz (Fast Implementation)',\n    '',\n    'Speed mode: skip reconnaissance and design gates. Go directly',\n    'to @builder for implementation. Only use @adventurer if the',\n    'codebase context is genuinely unknown (not as a default step).',\n    'Skip @reviewer unless the user explicitly requests review.',\n  ].join('\\n'),\n};\n\n/**\n * Marker strings for each mode keyword, used to signal the active mode.\n * Format: `[MODE: <keyword>]`\n */\nexport const MODE_MARKERS: Record<ModeKeyword, string> = {\n  fein: '[MODE: fein]',\n  sonar: '[MODE: sonar]',\n  blitz: '[MODE: blitz]',\n};\n\n/**\n * Array of all valid mode keywords for runtime iteration.\n */\nexport const VALID_KEYWORDS: readonly ModeKeyword[] = ['fein', 'sonar', 'blitz'];\n","import { escapeRegExp } from 'es-toolkit';\nimport { MODE_PROMPTS, MODE_MARKERS, VALID_KEYWORDS } from '@/modes/prompts.js';\nimport type { ModeKeyword, ModeResult } from '@/modes/types.js';\n\n/**\n * Priority mapping for mode keyword restrictiveness.\n * Higher number = more restrictive = wins when multiple keywords are present.\n * fein (3): full pipeline with mandatory gates\n * sonar (2): research only, no code\n * blitz (1): fast implementation, skip all gates\n */\nconst MODE_PRIORITY: Record<ModeKeyword, number> = {\n  fein: 3,\n  sonar: 2,\n  blitz: 1,\n};\n\n/**\n * Regex matching fenced code blocks (```) and inline backtick spans (`).\n * Used to exclude keyword matches inside code spans.\n */\n// Note: Unclosed fenced code blocks (``` without closing ```) are not\n// excluded — the regex requires matching fences. This is an accepted\n// false-positive risk (see ADR-008 consequences).\nconst CODE_BLOCK_RE = /```[\\s\\S]*?```|`[^`]*`/g;\n\n/**\n * Find ranges of code blocks and inline code spans in text.\n * Returns [start, end) positions. Keywords inside these ranges\n * are ignored during detection.\n */\nfunction findAllCodeBlockRanges(text: string): Array<[number, number]> {\n  const ranges: Array<[number, number]> = [];\n  let match: RegExpExecArray | null;\n  while ((match = CODE_BLOCK_RE.exec(text)) !== null) {\n    ranges.push([match.index, match.index + match[0].length]);\n  }\n  return ranges;\n}\n\nfunction isInRanges(index: number, ranges: Array<[number, number]>): boolean {\n  return ranges.some(([start, end]) => index >= start && index < end);\n}\n\n/**\n * Build a regex pattern for word-boundary matching of the given keyword.\n *\n * The pattern uses `\\b` word boundaries to ensure we match whole words only,\n * and is case-insensitive so `Fein`, `FEIN`, `fein` all match.\n */\nfunction buildKeywordRegex(keyword: string): RegExp {\n  return new RegExp(`\\\\b${escapeRegExp(keyword)}\\\\b`, 'gi');\n}\n\n/**\n * Detect a workflow mode keyword in the given text.\n *\n * Detection rules (per ADR-008):\n * - Word-boundary regex matching (`\\bfein\\b`, `\\bsonar\\b`, `\\bblitz\\b`)\n * - Most restrictive match wins (fein > sonar > blitz)\n * - Case-insensitive\n * - Disabled keywords are ignored\n * - Matches inside fenced code blocks (```) and inline backticks (`) are ignored\n *\n * @param text The user message to scan.\n * @param disabled Optional set of disabled mode keywords (lowercase).\n * @returns A `ModeResult` if a keyword was detected, or `null`.\n */\nexport function detectMode(text: string, disabled?: Set<string>): ModeResult | null {\n  const codeRanges = findAllCodeBlockRanges(text);\n  // Normalize disabled keywords to lowercase for case-insensitive comparison\n  const normalizedDisabled = disabled\n    ? new Set(Array.from(disabled).map((k) => k.toLowerCase()))\n    : undefined;\n  let bestMatch: { keyword: string; index: number; mode: ModeKeyword } | null = null;\n\n  for (const keyword of VALID_KEYWORDS) {\n    if (normalizedDisabled?.has(keyword)) continue;\n\n    const regex = buildKeywordRegex(keyword);\n    let match: RegExpExecArray | null;\n\n    while ((match = regex.exec(text)) !== null) {\n      if (isInRanges(match.index, codeRanges)) continue;\n      // Most-restrictive wins: prefer higher-priority mode over position\n      if (bestMatch === null || MODE_PRIORITY[keyword] > MODE_PRIORITY[bestMatch.mode]) {\n        bestMatch = {\n          keyword: match[0],\n          index: match.index,\n          mode: keyword,\n        };\n      }\n    }\n  }\n\n  if (bestMatch === null) return null;\n\n  return {\n    mode: bestMatch.mode,\n    keyword: bestMatch.keyword,\n    index: bestMatch.index,\n    prompt: MODE_PROMPTS[bestMatch.mode],\n    marker: MODE_MARKERS[bestMatch.mode],\n  };\n}\n\n/**\n * Remove the matched keyword from the text, cleaning up any trailing colon\n * or whitespace that may follow it.\n *\n * @param text The original message text.\n * @param result The `ModeResult` from `detectMode()`.\n * @returns The text with the keyword stripped.\n */\nexport function stripKeyword(text: string, result: ModeResult): string {\n  const before = text.slice(0, result.index);\n  const after = text.slice(result.index + result.keyword.length);\n\n  // Remove any colon + optional whitespace after the keyword\n  // (e.g. \"fein: do this\" -> \"do this\")\n  const cleaned = after.replace(/^:\\s*/, '');\n\n  // Collapse double spaces and trim both ends (handles keyword at start,\n  // end, or middle of text, plus extra whitespace around colon)\n  return (before + cleaned).replace(/\\s{2,}/g, ' ').trim();\n}\n\n/**\n * Get the mode prompt text for a given mode name.\n *\n * @param mode The mode keyword (e.g. \"fein\", \"sonar\", \"blitz\").\n * @returns The prompt string, or empty string if mode is unknown.\n */\nexport function getModePrompt(mode: string): string {\n  if (isModeKeyword(mode)) {\n    return MODE_PROMPTS[mode];\n  }\n  return '';\n}\n\n/**\n * Get the mode marker string for a given mode name.\n *\n * @param mode The mode keyword (e.g. \"fein\", \"sonar\", \"blitz\").\n * @returns The marker string (e.g. `[MODE: fein]`), or empty string if unknown.\n */\nexport function getModeMarker(mode: string): string {\n  if (isModeKeyword(mode)) {\n    return MODE_MARKERS[mode];\n  }\n  return '';\n}\n\n/**\n * Type guard to check if a string is a valid ModeKeyword.\n */\nfunction isModeKeyword(value: string): value is ModeKeyword {\n  return (VALID_KEYWORDS as readonly string[]).includes(value);\n}\n","import type { Plugin } from '@opencode-ai/plugin';\nimport { readFileSync, readdirSync } from 'fs';\nimport { join, dirname, basename } from 'path';\nimport { parse as parseYaml } from 'yaml';\nimport { fileURLToPath } from 'url';\nimport { type MaestriaPluginOptions, maestriaOptionsSchema } from '@/modes/types.js';\nimport { detectMode, stripKeyword, getModeMarker, getModePrompt } from '@/modes/index.js';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst agentsDir = join(__dirname, '..', 'agents');\nconst rulesPath = join(__dirname, '..', 'rules', 'AGENTS.md');\n\ninterface AgentFrontmatter {\n  description: string;\n  mode: string;\n  permission: Record<string, unknown>;\n  color?: string;\n  maxSteps?: number;\n}\n\nfunction parseFrontmatter(yamlStr: string): AgentFrontmatter {\n  const result = parseYaml(yamlStr) as Record<string, unknown>;\n  return {\n    description: (result.description as string) || '',\n    mode: (result.mode as string) || 'subagent',\n    permission: (result.permission as Record<string, unknown>) || {},\n    color: result.color as string | undefined,\n    maxSteps: result.maxSteps ? Number(result.maxSteps) : undefined,\n  };\n}\n\n/**\n * Read an agent markdown file and split into frontmatter + prompt.\n */\nfunction parseAgentFile(filePath: string): { name: string; config: Record<string, unknown> } {\n  const content = readFileSync(filePath, 'utf-8');\n  const name = basename(filePath, '.md');\n\n  // Split on ---\n  const parts = content.split('---');\n  if (parts.length < 3) {\n    throw new Error(`Invalid agent file: ${filePath} — missing frontmatter`);\n  }\n\n  const frontmatter = parseFrontmatter(parts[1].trim());\n  const prompt = parts.slice(2).join('---').trim();\n\n  const config: Record<string, unknown> = {\n    description: frontmatter.description,\n    mode: frontmatter.mode,\n    prompt,\n    permission: frontmatter.permission,\n  };\n\n  if (frontmatter.color) config.color = frontmatter.color;\n  if (frontmatter.maxSteps) config.maxSteps = frontmatter.maxSteps;\n\n  return { name, config };\n}\n\n/**\n * Load all agent configs from the bundled agents/ directory.\n */\nfunction loadAgents(): Record<string, Record<string, unknown>> {\n  const files = readdirSync(agentsDir).filter((f) => f.endsWith('.md'));\n  const agents: Record<string, Record<string, unknown>> = {};\n\n  for (const file of files) {\n    const { name, config } = parseAgentFile(join(agentsDir, file));\n    agents[name] = config;\n  }\n\n  return agents;\n}\n\nexport const MaestriaPlugin: Plugin = async (_input, options?: MaestriaPluginOptions) => {\n  // Validate and parse options with zod\n  const parsed = maestriaOptionsSchema.parse(options ?? {});\n  const disabledKeywords = new Set<string>(\n    (parsed.modes?.disabledKeywords ?? []).map((k) => k.toLowerCase()),\n  );\n  const agents = loadAgents();\n\n  return {\n    config: async (input) => {\n      input.agent = {\n        ...input.agent,\n        ...agents,\n      };\n      input.instructions = [...(input.instructions ?? []), rulesPath];\n    },\n    'experimental.session.compacting': async (_input, output) => {\n      output.context.push(\n        'Session was compacted. Task tracking is maintained via todowrite. ' +\n          'Active context (files, decisions, blockers) was captured before compaction. ' +\n          'Continue where you left off.',\n      );\n    },\n    'chat.message': async (hookInput, hookOutput) => {\n      // Only fire for the orchestrator agent\n      if (hookInput.agent !== 'orchestrator') return;\n\n      // Find the first text part with user content\n      const textPart = hookOutput.parts.find((p) => p.type === 'text') as\n        | { text: string; type: 'text' }\n        | undefined;\n      if (!textPart) return;\n\n      // Detect keyword in the text\n      const result = detectMode(textPart.text, disabledKeywords);\n      if (!result) return;\n\n      // Strip keyword from text and prepend mode marker + prompt inline.\n      // We embed everything in the existing text part rather than injecting\n      // a second text part into `parts`, because the OpenCode runtime does\n      // not handle multiple text parts per message (causes a hang).\n      textPart.text = [\n        getModeMarker(result.mode),\n        '',\n        getModePrompt(result.mode),\n        '',\n        stripKeyword(textPart.text, result),\n      ].join('\\n');\n    },\n  };\n};\n\nexport default MaestriaPlugin;\n"],"mappings":"6OAeA,MAAa,EAAoB,EAAE,KAAK,CAAC,OAAQ,QAAS,OAAO,CAAC,EAMrD,EAAwB,EAAE,OAAO,CAC5C,MAAO,EACJ,OAAO,CACN,iBAAkB,EAAE,MAAM,CAAiB,CAAC,CAAC,SAAS,CACxD,CAAC,CAAC,CACD,SAAS,CACd,CAAC,ECnBY,EAA4C,CACvD,KAAM,CACJ,gCACA,GACA,+DACA,yDACA,kDACA,6DACA,mBACF,CAAC,CAAC,KAAK;CAAI,EAEX,MAAO,CACL,iCACA,GACA,6DACA,yDACA,gEACA,+DACF,CAAC,CAAC,KAAK;CAAI,EAEX,MAAO,CACL,uCACA,GACA,gEACA,8DACA,iEACA,4DACF,CAAC,CAAC,KAAK;CAAI,CACb,EAMa,EAA4C,CACvD,KAAM,eACN,MAAO,gBACP,MAAO,eACT,EAKa,EAAyC,CAAC,OAAQ,QAAS,OAAO,ECxCzE,EAA6C,CACjD,KAAM,EACN,MAAO,EACP,MAAO,CACT,EASM,EAAgB,0BAOtB,SAAS,EAAuB,EAAuC,CACrE,IAAM,EAAkC,CAAC,EACrC,EACJ,MAAQ,EAAQ,EAAc,KAAK,CAAI,KAAO,MAC5C,EAAO,KAAK,CAAC,EAAM,MAAO,EAAM,MAAQ,EAAM,EAAE,CAAC,MAAM,CAAC,EAE1D,OAAO,CACT,CAEA,SAAS,EAAW,EAAe,EAA0C,CAC3E,OAAO,EAAO,MAAM,CAAC,EAAO,KAAS,GAAS,GAAS,EAAQ,CAAG,CACpE,CAQA,SAAS,EAAkB,EAAyB,CAClD,OAAW,OAAO,MAAM,EAAa,CAAO,EAAE,KAAM,IAAI,CAC1D,CAgBA,SAAgB,EAAW,EAAc,EAA2C,CAClF,IAAM,EAAa,EAAuB,CAAI,EAExC,EAAqB,EACvB,IAAI,IAAI,MAAM,KAAK,CAAQ,CAAC,CAAC,IAAK,GAAM,EAAE,YAAY,CAAC,CAAC,EACxD,IAAA,GACA,EAA0E,KAE9E,IAAK,IAAM,KAAW,EAAgB,CACpC,GAAI,GAAoB,IAAI,CAAO,EAAG,SAEtC,IAAM,EAAQ,EAAkB,CAAO,EACnC,EAEJ,MAAQ,EAAQ,EAAM,KAAK,CAAI,KAAO,MAChC,EAAW,EAAM,MAAO,CAAU,IAElC,IAAc,MAAQ,EAAc,GAAW,EAAc,EAAU,SACzE,EAAY,CACV,QAAS,EAAM,GACf,MAAO,EAAM,MACb,KAAM,CACR,EAGN,CAIA,OAFI,IAAc,KAAa,KAExB,CACL,KAAM,EAAU,KAChB,QAAS,EAAU,QACnB,MAAO,EAAU,MACjB,OAAQ,EAAa,EAAU,MAC/B,OAAQ,EAAa,EAAU,KACjC,CACF,CAUA,SAAgB,EAAa,EAAc,EAA4B,CAUrE,OATe,EAAK,MAAM,EAAG,EAAO,KASvB,EARC,EAAK,MAAM,EAAO,MAAQ,EAAO,QAAQ,MAInC,CAAC,CAAC,QAAQ,QAAS,EAIhB,EAAA,CAAG,QAAQ,UAAW,GAAG,CAAC,CAAC,KAAK,CACzD,CAQA,SAAgB,EAAc,EAAsB,CAIlD,OAHI,EAAc,CAAI,EACb,EAAa,GAEf,EACT,CAQA,SAAgB,EAAc,EAAsB,CAIlD,OAHI,EAAc,CAAI,EACb,EAAa,GAEf,EACT,CAKA,SAAS,EAAc,EAAqC,CAC1D,OAAQ,EAAqC,SAAS,CAAK,CAC7D,CCtJA,MAAM,EAAY,EAAQ,EAAc,OAAO,KAAK,GAAG,CAAC,EAClD,EAAY,EAAK,EAAW,KAAM,QAAQ,EAC1C,EAAY,EAAK,EAAW,KAAM,QAAS,WAAW,EAU5D,SAAS,EAAiB,EAAmC,CAC3D,IAAM,EAASA,EAAU,CAAO,EAChC,MAAO,CACL,YAAc,EAAO,aAA0B,GAC/C,KAAO,EAAO,MAAmB,WACjC,WAAa,EAAO,YAA0C,CAAC,EAC/D,MAAO,EAAO,MACd,SAAU,EAAO,SAAW,OAAO,EAAO,QAAQ,EAAI,IAAA,EACxD,CACF,CAKA,SAAS,EAAe,EAAqE,CAC3F,IAAM,EAAU,EAAa,EAAU,OAAO,EACxC,EAAO,EAAS,EAAU,KAAK,EAG/B,EAAQ,EAAQ,MAAM,KAAK,EACjC,GAAI,EAAM,OAAS,EACjB,MAAU,MAAM,uBAAuB,EAAS,uBAAuB,EAGzE,IAAM,EAAc,EAAiB,EAAM,EAAE,CAAC,KAAK,CAAC,EAC9C,EAAS,EAAM,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAEzC,EAAkC,CACtC,YAAa,EAAY,YACzB,KAAM,EAAY,KAClB,SACA,WAAY,EAAY,UAC1B,EAKA,OAHI,EAAY,QAAO,EAAO,MAAQ,EAAY,OAC9C,EAAY,WAAU,EAAO,SAAW,EAAY,UAEjD,CAAE,OAAM,QAAO,CACxB,CAKA,SAAS,GAAsD,CAC7D,IAAM,EAAQ,EAAY,CAAS,CAAC,CAAC,OAAQ,GAAM,EAAE,SAAS,KAAK,CAAC,EAC9D,EAAkD,CAAC,EAEzD,IAAK,IAAM,KAAQ,EAAO,CACxB,GAAM,CAAE,OAAM,UAAW,EAAe,EAAK,EAAW,CAAI,CAAC,EAC7D,EAAO,GAAQ,CACjB,CAEA,OAAO,CACT,CAEA,MAAa,EAAyB,MAAO,EAAQ,IAAoC,CAEvF,IAAM,EAAS,EAAsB,MAAM,GAAW,CAAC,CAAC,EAClD,EAAmB,IAAI,KAC1B,EAAO,OAAO,kBAAoB,CAAC,EAAA,CAAG,IAAK,GAAM,EAAE,YAAY,CAAC,CACnE,EACM,EAAS,EAAW,EAE1B,MAAO,CACL,OAAQ,KAAO,IAAU,CACvB,EAAM,MAAQ,CACZ,GAAG,EAAM,MACT,GAAG,CACL,EACA,EAAM,aAAe,CAAC,GAAI,EAAM,cAAgB,CAAC,EAAI,CAAS,CAChE,EACA,kCAAmC,MAAO,EAAQ,IAAW,CAC3D,EAAO,QAAQ,KACb,4KAGF,CACF,EACA,eAAgB,MAAO,EAAW,IAAe,CAE/C,GAAI,EAAU,QAAU,eAAgB,OAGxC,IAAM,EAAW,EAAW,MAAM,KAAM,GAAM,EAAE,OAAS,MAAM,EAG/D,GAAI,CAAC,EAAU,OAGf,IAAM,EAAS,EAAW,EAAS,KAAM,CAAgB,EACpD,IAML,EAAS,KAAO,CACd,EAAc,EAAO,IAAI,EACzB,GACA,EAAc,EAAO,IAAI,EACzB,GACA,EAAa,EAAS,KAAM,CAAM,CACpC,CAAC,CAAC,KAAK;CAAI,EACb,CACF,CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maestria/opencode",
-  "version": "0.4.2",
+  "version": "0.4.5",
   "description": "OpenCode plugin encoding AI engineering praxis: rules, agents, and workflow discipline.",
   "keywords": [
     "agents",
@@ -46,15 +46,15 @@
   },
   "devDependencies": {
     "@types/node": "^24",
-    "commit-and-tag-version": "^12.7.3",
-    "typescript": "^5",
-    "vitest": "npm:@voidzero-dev/vite-plus-test@^0.1.24"
+    "typescript": "^6.0.3",
+    "vitest": "4.1.9"
   },
   "engines": {
     "node": ">=22.12.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && bash scripts/verify-imports.sh",
-    "test": "node ./node_modules/vitest/vitest.mjs run"
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test"
   }
 }

package/dist/modes/index.d.ts

@@ -1,39 +0,0 @@
-import type { ModeResult } from "./types.js";
-/**
- * Detect a workflow mode keyword in the given text.
- *
- * Detection rules (per ADR-008):
- * - Word-boundary regex matching (`\bfein\b`, `\bsonar\b`, `\bblitz\b`)
- * - Most restrictive match wins (fein > sonar > blitz)
- * - Case-insensitive
- * - Disabled keywords are ignored
- * - Matches inside fenced code blocks (```) and inline backticks (`) are ignored
- *
- * @param text The user message to scan.
- * @param disabled Optional set of disabled mode keywords (lowercase).
- * @returns A `ModeResult` if a keyword was detected, or `null`.
- */
-export declare function detectMode(text: string, disabled?: Set<string>): ModeResult | null;
-/**
- * Remove the matched keyword from the text, cleaning up any trailing colon
- * or whitespace that may follow it.
- *
- * @param text The original message text.
- * @param result The `ModeResult` from `detectMode()`.
- * @returns The text with the keyword stripped.
- */
-export declare function stripKeyword(text: string, result: ModeResult): string;
-/**
- * Get the mode prompt text for a given mode name.
- *
- * @param mode The mode keyword (e.g. "fein", "sonar", "blitz").
- * @returns The prompt string, or empty string if mode is unknown.
- */
-export declare function getModePrompt(mode: string): string;
-/**
- * Get the mode marker string for a given mode name.
- *
- * @param mode The mode keyword (e.g. "fein", "sonar", "blitz").
- * @returns The marker string (e.g. `[MODE: fein]`), or empty string if unknown.
- */
-export declare function getModeMarker(mode: string): string;

package/dist/modes/index.js

@@ -1,144 +0,0 @@
-import { escapeRegExp } from "es-toolkit";
-import { MODE_PROMPTS, MODE_MARKERS, VALID_KEYWORDS } from "./prompts.js";
-/**
- * Priority mapping for mode keyword restrictiveness.
- * Higher number = more restrictive = wins when multiple keywords are present.
- * fein (3): full pipeline with mandatory gates
- * sonar (2): research only, no code
- * blitz (1): fast implementation, skip all gates
- */
-const MODE_PRIORITY = {
-    fein: 3,
-    sonar: 2,
-    blitz: 1,
-};
-/**
- * Regex matching fenced code blocks (```) and inline backtick spans (`).
- * Used to exclude keyword matches inside code spans.
- */
-// Note: Unclosed fenced code blocks (``` without closing ```) are not
-// excluded — the regex requires matching fences. This is an accepted
-// false-positive risk (see ADR-008 consequences).
-const CODE_BLOCK_RE = /```[\s\S]*?```|`[^`]*`/g;
-/**
- * Find ranges of code blocks and inline code spans in text.
- * Returns [start, end) positions. Keywords inside these ranges
- * are ignored during detection.
- */
-function findAllCodeBlockRanges(text) {
-    const ranges = [];
-    let match;
-    while ((match = CODE_BLOCK_RE.exec(text)) !== null) {
-        ranges.push([match.index, match.index + match[0].length]);
-    }
-    return ranges;
-}
-function isInRanges(index, ranges) {
-    return ranges.some(([start, end]) => index >= start && index < end);
-}
-/**
- * Build a regex pattern for word-boundary matching of the given keyword.
- *
- * The pattern uses `\b` word boundaries to ensure we match whole words only,
- * and is case-insensitive so `Fein`, `FEIN`, `fein` all match.
- */
-function buildKeywordRegex(keyword) {
-    return new RegExp(`\\b${escapeRegExp(keyword)}\\b`, "gi");
-}
-/**
- * Detect a workflow mode keyword in the given text.
- *
- * Detection rules (per ADR-008):
- * - Word-boundary regex matching (`\bfein\b`, `\bsonar\b`, `\bblitz\b`)
- * - Most restrictive match wins (fein > sonar > blitz)
- * - Case-insensitive
- * - Disabled keywords are ignored
- * - Matches inside fenced code blocks (```) and inline backticks (`) are ignored
- *
- * @param text The user message to scan.
- * @param disabled Optional set of disabled mode keywords (lowercase).
- * @returns A `ModeResult` if a keyword was detected, or `null`.
- */
-export function detectMode(text, disabled) {
-    const codeRanges = findAllCodeBlockRanges(text);
-    // Normalize disabled keywords to lowercase for case-insensitive comparison
-    const normalizedDisabled = disabled
-        ? new Set(Array.from(disabled).map((k) => k.toLowerCase()))
-        : undefined;
-    let bestMatch = null;
-    for (const keyword of VALID_KEYWORDS) {
-        if (normalizedDisabled?.has(keyword))
-            continue;
-        const regex = buildKeywordRegex(keyword);
-        let match;
-        while ((match = regex.exec(text)) !== null) {
-            if (isInRanges(match.index, codeRanges))
-                continue;
-            // Most-restrictive wins: prefer higher-priority mode over position
-            if (bestMatch === null || MODE_PRIORITY[keyword] > MODE_PRIORITY[bestMatch.mode]) {
-                bestMatch = {
-                    keyword: match[0],
-                    index: match.index,
-                    mode: keyword,
-                };
-            }
-        }
-    }
-    if (bestMatch === null)
-        return null;
-    return {
-        mode: bestMatch.mode,
-        keyword: bestMatch.keyword,
-        index: bestMatch.index,
-        prompt: MODE_PROMPTS[bestMatch.mode],
-        marker: MODE_MARKERS[bestMatch.mode],
-    };
-}
-/**
- * Remove the matched keyword from the text, cleaning up any trailing colon
- * or whitespace that may follow it.
- *
- * @param text The original message text.
- * @param result The `ModeResult` from `detectMode()`.
- * @returns The text with the keyword stripped.
- */
-export function stripKeyword(text, result) {
-    const before = text.slice(0, result.index);
-    const after = text.slice(result.index + result.keyword.length);
-    // Remove any colon + optional whitespace after the keyword
-    // (e.g. "fein: do this" -> "do this")
-    const cleaned = after.replace(/^:\s*/, "");
-    // Collapse double spaces and trim both ends (handles keyword at start,
-    // end, or middle of text, plus extra whitespace around colon)
-    return (before + cleaned).replace(/\s{2,}/g, " ").trim();
-}
-/**
- * Get the mode prompt text for a given mode name.
- *
- * @param mode The mode keyword (e.g. "fein", "sonar", "blitz").
- * @returns The prompt string, or empty string if mode is unknown.
- */
-export function getModePrompt(mode) {
-    if (isModeKeyword(mode)) {
-        return MODE_PROMPTS[mode];
-    }
-    return "";
-}
-/**
- * Get the mode marker string for a given mode name.
- *
- * @param mode The mode keyword (e.g. "fein", "sonar", "blitz").
- * @returns The marker string (e.g. `[MODE: fein]`), or empty string if unknown.
- */
-export function getModeMarker(mode) {
-    if (isModeKeyword(mode)) {
-        return MODE_MARKERS[mode];
-    }
-    return "";
-}
-/**
- * Type guard to check if a string is a valid ModeKeyword.
- */
-function isModeKeyword(value) {
-    return VALID_KEYWORDS.includes(value);
-}

package/dist/modes/prompts.d.ts

@@ -1,17 +0,0 @@
-import type { ModeKeyword } from "./types.js";
-/**
- * Mode prompt text for each keyword.
- * These are injected into the turn when a mode is detected.
- *
- * @see ADR-008 (section "Mode Prompts")
- */
-export declare const MODE_PROMPTS: Record<ModeKeyword, string>;
-/**
- * Marker strings for each mode keyword, used to signal the active mode.
- * Format: `[MODE: <keyword>]`
- */
-export declare const MODE_MARKERS: Record<ModeKeyword, string>;
-/**
- * Array of all valid mode keywords for runtime iteration.
- */
-export declare const VALID_KEYWORDS: readonly ModeKeyword[];

package/dist/modes/prompts.js

@@ -1,46 +0,0 @@
-/**
- * Mode prompt text for each keyword.
- * These are injected into the turn when a mode is detected.
- *
- * @see ADR-008 (section "Mode Prompts")
- */
-export const MODE_PROMPTS = {
-    fein: [
-        "## MODE: fein (Full Pipeline)",
-        "",
-        "Execute the complete fein pipeline: mandatory reconnaissance",
-        "(@adventurer) → design/plan (@architect or @planner) →",
-        "implementation (@builder) → review (@reviewer).",
-        "Do NOT skip any phase unless the user explicitly overrides",
-        "in the same turn.",
-    ].join("\n"),
-    sonar: [
-        "## MODE: sonar (Research Only)",
-        "",
-        "Research mode: reconnaissance and design only. Delegate to",
-        "@adventurer (recon) followed by @architect or @planner",
-        "(analysis/design). STOP after delivering findings and design.",
-        "Do NOT implement, write code, or create any production files.",
-    ].join("\n"),
-    blitz: [
-        "## MODE: blitz (Fast Implementation)",
-        "",
-        "Speed mode: skip reconnaissance and design gates. Go directly",
-        "to @builder for implementation. Only use @adventurer if the",
-        "codebase context is genuinely unknown (not as a default step).",
-        "Skip @reviewer unless the user explicitly requests review.",
-    ].join("\n"),
-};
-/**
- * Marker strings for each mode keyword, used to signal the active mode.
- * Format: `[MODE: <keyword>]`
- */
-export const MODE_MARKERS = {
-    fein: "[MODE: fein]",
-    sonar: "[MODE: sonar]",
-    blitz: "[MODE: blitz]",
-};
-/**
- * Array of all valid mode keywords for runtime iteration.
- */
-export const VALID_KEYWORDS = ["fein", "sonar", "blitz"];

package/dist/modes/types.d.ts

@@ -1,51 +0,0 @@
-/**
- * Types for keyword-triggered workflow modes.
- *
- * @see ADR-008 for full design context.
- */
-import { z } from "zod";
-/**
- * Valid mode keywords.
- *
- * - `"fein"` -- Full pipeline (recon -> design -> build -> review)
- * - `"sonar"` -- Research only (recon + design, stop before build)
- * - `"blitz"` -- Fast implementation (builder direct, skip recon/design/review)
- */
-export declare const modeKeywordSchema: z.ZodEnum<["fein", "sonar", "blitz"]>;
-export type ModeKeyword = z.infer<typeof modeKeywordSchema>;
-/**
- * Plugin-level options for @maestria/opencode.
- */
-export declare const maestriaOptionsSchema: z.ZodObject<{
-    modes: z.ZodOptional<z.ZodObject<{
-        disabledKeywords: z.ZodOptional<z.ZodArray<z.ZodEnum<["fein", "sonar", "blitz"]>, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        disabledKeywords?: ("fein" | "sonar" | "blitz")[] | undefined;
-    }, {
-        disabledKeywords?: ("fein" | "sonar" | "blitz")[] | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    modes?: {
-        disabledKeywords?: ("fein" | "sonar" | "blitz")[] | undefined;
-    } | undefined;
-}, {
-    modes?: {
-        disabledKeywords?: ("fein" | "sonar" | "blitz")[] | undefined;
-    } | undefined;
-}>;
-export type MaestriaPluginOptions = z.infer<typeof maestriaOptionsSchema>;
-/**
- * Result returned when a mode keyword is detected in a message.
- */
-export interface ModeResult {
-    /** The resolved mode keyword (lowercase). */
-    mode: ModeKeyword;
-    /** The keyword string as matched in the original text. */
-    keyword: string;
-    /** The character index where the keyword starts in the original text. */
-    index: number;
-    /** The mode prompt text to inject. */
-    prompt: string;
-    /** The mode marker string like `[MODE: fein]`. */
-    marker: string;
-}

package/dist/modes/types.js

@@ -1,24 +0,0 @@
-/**
- * Types for keyword-triggered workflow modes.
- *
- * @see ADR-008 for full design context.
- */
-import { z } from "zod";
-/**
- * Valid mode keywords.
- *
- * - `"fein"` -- Full pipeline (recon -> design -> build -> review)
- * - `"sonar"` -- Research only (recon + design, stop before build)
- * - `"blitz"` -- Fast implementation (builder direct, skip recon/design/review)
- */
-export const modeKeywordSchema = z.enum(["fein", "sonar", "blitz"]);
-/**
- * Plugin-level options for @maestria/opencode.
- */
-export const maestriaOptionsSchema = z.object({
-    modes: z
-        .object({
-        disabledKeywords: z.array(modeKeywordSchema).optional(),
-    })
-        .optional(),
-});