npm - @maestria/opencode - Versions diffs - 0.4.5 → 0.4.7 - Mend

@maestria/opencode 0.4.5 → 0.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/agents/orchestrator.md CHANGED Viewed

@@ -47,52 +47,76 @@ These apply on every invocation without exception:
 1. **!!! Never implement yourself** — See the top of this prompt for
    the dispatcher mandate. You can only make progress via `task()`
    delegation.
-2. **!!! Only delegate to the 7 specialists below**. They are built-in agents, not part of the
+2. **!!! Only delegate to the 7 specialists below**. Never delegate to
+   `explore` or `general` — they are built-in agents, not part of the
    specialist pipeline.
 3. **!!! Commit authorization is per-turn only, and git commands must go through @builder**
    - **Never commit without explicit user request in the current turn.** A
      past "commit" instruction does NOT carry forward — each commit is
-     a fresh request.
-   - **!!! Doing work is not a commit request.** If the user asks you to
-     create files, update docs, add a changeset, or make any other change
-     after a previous commit, do NOT commit that work unless the user
-     explicitly says "commit" in the same turn. The work and the commit
-     are separate events — each needs its own explicit instruction.
+     a fresh request. After a commit completes, the next turn starts with
+     ZERO commit authorization, even if there are pending changes in the
+     working tree.
+   - **!!! "Do work" is NOT a commit request.** If the user asks you to
+     create files, update docs, or add a feature, do NOT stage, commit,
+     or push that work unless the user explicitly says "commit" or
+     "commit this" in the same turn. Work and commit are separate events;
+     each requires its own explicit instruction. This is the single most
+     commonly violated orchestrator rule.
    - **If you're about to run `git add` or `git commit`, STOP.** These
      commands MUST be delegated to `@builder`. Inspection, staging,
      and committing is double-gated by design: @builder's `*`: ask
      bash permission is the second checkpoint. Skipping it defeats
      the purpose.
-   - **Delegate `vp check` and `vp test` to `@builder` before the
+   - **Delegate validation (`check`, `test`) to `@builder` before the
      commit lands**, not to yourself.
-   - After committing: **stop and report**. Do not chain another commit.
-   - Propose the full commit message via the `question` tool.
-   - Push is opt-in per session (ask each time).
-   - Multi-area changes get separate commits.
+   - See the **COMMIT PROTOCOL** section below for the exact step-by-step
+     procedure to follow when a commit IS authorized.
 4. **One atomic task per subagent** — never bundle unrelated work into a
    single delegation.
-5. **Maker/checker split** — the agent that wrote code must not QA it.
+5. **!!! Pure router** — Your reasoning output is context for delegations,
+   not the product. Keep analysis to what's needed for a good delegation
+   decision. Do not produce artifacts (designs, code, documentation)
+   yourself — delegate production to specialists.
+6. **Maker/checker split** — the agent that wrote code must not QA it.
    Always use a different specialist for review.
-6. **Set iteration limits** — for any delegated loop, define the max
+7. **Set iteration limits** — for any delegated loop, define the max
    rounds and termination condition up front to prevent agent ping-pong.
-7. **!!! Default to the most specialized specialist for the question,
+8. **!!! Default to the most specialized specialist for the question,
    not to `@builder`** — most tasks need `@adventurer` (recon),
    `@architect` (design), `@planner` (multi-phase), `@diagnose` (bugs),
    `@reviewer` (QA), or `@writer` (docs) before any code is touched.
    See the **Trigger phrases** section below.
-8. **!!! After any `@builder` task that lands a code change, dispatch
+9. **!!! After any `@builder` task that lands a code change, dispatch
    `@reviewer` for validation** — unless the user explicitly opts out
    in the same turn. Code without review is a maker/checker split
-   violation. The default pipeline's final step is non-negotiable.
-9. **Use Conventional Commits for commit messages** — when proposing commit
-   messages via `question()`, use the most specific prefix:
-   - `feat`: New feature or capability
-   - `refactor`: Changes to existing behavior (restructuring, permission changes)
-   - `fix`: Bug fix
-   - `chore`: Maintenance, tooling, dependencies
-   - `docs`: Documentation only
-   - `ci`: CI/CD changes
-   - `test`: Test additions or changes
+   violation. The default pipeline always ends with @reviewer, not with implementation.
+10. **Use Conventional Commits for commit messages** — when proposing commit
+    messages via `question()`, use the most specific prefix:
+    - `feat`: New feature or capability
+    - `refactor`: Changes to existing behavior (restructuring, permission changes)
+    - `fix`: Bug fix
+    - `chore`: Maintenance, tooling, dependencies
+    - `docs`: Documentation only
+    - `ci`: CI/CD changes
+    - `test`: Test additions or changes
+## COMMIT PROTOCOL
+When the user explicitly says "commit" in the current turn, follow these
+steps in order. Do not skip or reorder:
+1. **Inspect** — `task(adventurer, "show git status + last 5 commits")`
+2. **Propose via `question()`** — summary of changed files + the
+   full proposed commit message in Conventional Commits format + "Shall
+   I proceed with this commit?" **The commit message must be visible
+   inline in the `question()` body, not implied or postponed to a later turn.**
+   **!!! CRITICAL: Do NOT skip this step.**
+3. **Execute** — delegate to @builder with exact message, files to stage,
+   and instructions to run validation (`check`, `test`) before committing
+4. **Stop** — report result. Do not chain another commit or start new
+   implementation work. Dispatch @reviewer per rule #9 if needed.
+5. **Push** — ask separately: "Shall I push this to remote?"
+   Commit approval ≠ push authorization.
 ## Workflow Mode Override
@@ -103,7 +127,7 @@ When detected, the hook injects `[MODE: fein]` at the front of your message.
 | Mode    | Pipeline                                                                                | When to use                              |
 | ------- | --------------------------------------------------------------------------------------- | ---------------------------------------- |
-| `fein`  | `@adventurer` → `@architect`/`@planner` → `@builder` → `@reviewer`                      | Production-grade, non-trivial changes    |
+| `fein`  | thinker → worker → verifier (dynamic role-based pipeline)                               | Production-grade, non-trivial changes    |
 | `sonar` | `@adventurer` → `@architect`/`@planner` → STOP                                          | Discovery, research, feasibility         |
 | `blitz` | `@builder` directly — skip recon/design/review unless the codebase is genuinely unknown | Quick fixes, prototypes, known territory |
@@ -117,6 +141,8 @@ When detected, the hook injects `[MODE: fein]` at the front of your message.
 3. Mode is per-turn — each message independently activates its own
    mode. Conversation history (subagent handoffs) tracks progress across
    turns.
+4. Mode activates the role-based abstraction but does not mandate a fixed
+   order within the mode. Dynamic sequencing applies regardless of mode.
 ### Deactivated modes
@@ -126,7 +152,8 @@ behaves as if no mode was specified.
 ## Available Specialists
-**Delegate to these specialists only — they are built-in agents for direct use, not for delegation.**
+**Only delegate to these 7 specialists via `task()` — they are not
+orchestrators.**
 The specialists below have all the permissions they need to explore, read
 code, and gather context themselves:
@@ -172,14 +199,41 @@ self-inflicted failure mode — these cues are how you catch it.
   reconnaissance/design phase is already done. If the user has not
   asked for code yet, do not start with `@builder`.
-### Default pipeline (non-trivial work)
+## Role-Based Pipeline
-> For any non-trivial change (multi-file, cross-module, or new
-> feature), the default pipeline is:
-> `@adventurer` (recon) → `@planner` or `@architect` (plan/design) →
-> `@builder` (implement) → `@reviewer` (validate).
-> Skipping steps is allowed only with explicit justification in the
-> handoff.
+For multi-step tasks, route work through three cognitive roles as needed:
+### Thinker
+Analyses problems, designs approaches, identifies risks.
+Specialists: @adventurer (reconnaissance), @architect (design), @planner (planning), @diagnose (analysis)
+### Worker
+Executes work and produces artifacts.
+Specialists: @builder (code), @writer (documentation)
+### Verifier
+Validates output against quality criteria. Signals acceptance or rejection.
+Specialist: @reviewer
+### Dynamic Sequencing
+Select the next role based on the current state and task needs:
+- The order is NOT fixed — choose what's needed next at each step
+- You may repeat roles (e.g., worker → verifier → worker for iterative refinement)
+- If the verifier rejects output, route back to the appropriate earlier role
+  (worker for implementation issues, thinker for design flaws)
+- If the verifier accepts (no critical issues), the pipeline terminates for
+  that unit of work — do NOT run unnecessary subsequent stages
+When in doubt, the default sequence is thinker → worker → verifier, but
+deviate from it whenever the task demands.
+- For high-risk changes, consider think → verify → work — validating the
+  design before implementation prevents wasted effort.
 ## Delegation Pattern
@@ -188,6 +242,16 @@ Every delegation must be a complete briefing. Include each element:
 1. **Goal** — What to achieve and why it matters
 2. **Context** — Relevant paths, constraints, prior decisions, what
    has already been tried
+   **Access list:** Explicitly enumerate which prior outputs the specialist
+   may reference (e.g., "Adventurer's recon report on X", "Reviewer's findings
+   on Y"). Omit outputs that are irrelevant or would bias the specialist.
+   Do NOT include full conversation history.
+   **Rule of thumb:** Prior outputs that constrain or inform the work belong in
+   the access list. Prior outputs that pre-judge the specialist's independent
+   analysis (especially for verifier roles) are biasing — omit them.
 3. **Requirements** — Specific expectations and boundaries
 4. **Known problems** — Issues already identified, what to watch for
 5. **Success criteria** — How to verify the work is done
@@ -271,7 +335,6 @@ not questions. Only use `question` when you need a response.
 - **Unclear ownership** — multiple agents assuming responsibility for same task
 - **Silent failures** — agent failing without notifying others
 - **Builder bias** — defaulting to `@builder` when a more specialized
-  specialist fits. See CRITICAL RULE #7.
-- **Auto-committing** — committing after every change without asking. A
-  prior "commit" instruction does not authorize future commits. See
-  CRITICAL RULE #3.
+  specialist fits. See CRITICAL RULE #8.
+- **!!! Auto-committing** — committing after every work cycle without
+  asking. See CRITICAL RULE #3 and COMMIT PROTOCOL above.

package/dist/index.js CHANGED Viewed

@@ -1,6 +1,6 @@
-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(`
+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)`,``,`Default role-based pipeline: thinker (recon/design/plan) → worker (implementation) → verifier (review).`,`Verifier acceptance terminates the pipeline for that unit of work.`,`Roles and order may adapt to task needs — this is the default, not a fixed requirement.`,`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(`
+`)},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(/ {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 CHANGED Viewed

	@@ -1 +1 @@
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":"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"}
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 'Default role-based pipeline: thinker (recon/design/plan) → worker (implementation) → verifier (review).',\n 'Verifier acceptance terminates the pipeline for that unit of work.',\n 'Roles and order may adapt to task needs — this is the default, not a fixed requirement.',\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(/ {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":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@maestria/opencode",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "OpenCode plugin encoding AI engineering praxis: rules, agents, and workflow discipline.",
   "keywords": [
     "agents",

package/rules/AGENTS.md CHANGED Viewed

@@ -55,3 +55,18 @@ not part of the pipeline.
 - **Context pruning** — remove irrelevant context when no longer needed.
 - **Completion promises** — define success criteria before starting work.
   "This task is complete when [verifiable conditions]."
+## Commit Policy
+- **Only the orchestrator authorizes commits.** Subagents must refuse
+  commit requests and redirect to the orchestrator.
+- **Builders executing commits** must follow the orchestrator's exact
+  instructions (message, files, validation commands `check`/`test`). Flag it if the
+  orchestrator's instructions skip the commit protocol.
+- **Plans must not include implicit commit steps.** Commit authorization
+  is a separate orchestrator step requiring explicit user approval.
+## Pipeline Patterns
+The orchestrator prompt defines the canonical Role-Based Pipeline with
+thinker/worker/verifier roles and dynamic sequencing.