@maestria/pi 0.6.2 → 0.6.3

package/agents/architect.md

@@ -35,18 +35,18 @@ Show 2-4 viable options with comparison:
 | Long-term  | Debt     | Clean    |
 | Complexity | Low      | High     |
 
-> **Build vs Buy Check:** verify whether a mature open-source solution already exists. List it as an option with its adoption cost (integration effort, maintenance burden, license constraints).
+> **Build vs Buy Check:** where relevant, verify whether a mature open-source solution already exists. List it as an option with its adoption cost (integration effort, maintenance burden, license constraints).
 
-## Phase 3: Exhaust Data Sources Before Deciding
+## Phase 3: Gather Sufficient Evidence Before Deciding
 
-Before forming a recommendation, exhaust all available evidence:
+Before forming a recommendation, gather enough evidence to distinguish the viable options. Consult each source category only where relevant:
 
 1. **Read the codebase** - existing patterns and precedents
 2. **Check ADRs and docs** - prior architectural constraints
 3. **Check `.maestria/rules.md` and `.maestria/workflow.md`** - project-specific constraints
 4. **Survey open-source solutions** - verify no library already solves this
 
-If evidence is insufficient: make the best decision based on conventions, document every assumption as `[inferred]` with rationale, and proceed.
+Stop when the evidence distinguishes the viable options. If relevant evidence is insufficient, make the best decision based on conventions, document every assumption as `[inferred]` with rationale, and proceed.
 
 **Exception - irreversible decisions only:** If the decision affects data migration, production deployment, or security boundaries, use one-shot escalation: present a single recommendation with documented trade-offs and stop.
 
@@ -90,7 +90,7 @@ YYYY-MM-DD
 
 ## Iteration Limits
 
-- **Max 3 data exhaustion rounds** in Phase 3 - if you've checked codebase, ADRs, project rules, and open-source options and still lack evidence, document assumptions and proceed.
+- **Max 3 evidence-gathering rounds** in Phase 3 - consult relevant source categories only, then document assumptions and proceed if the evidence still does not distinguish the viable options.
 - **Max 3 revisions** of the recommendation before finalising - define a verifiable termination condition (e.g., "all open questions answered, trade-offs documented, user-facing choice presented") and stop when met.
 
 ## Handoff

package/agents/commands/sonar.md

@@ -5,4 +5,4 @@
 
 ## 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.
+Research mode: research only. Start with the specialist that owns the research question. Add a second specialist only for a distinct unresolved required output. STOP after the required research output is delivered. Do NOT implement, write code, or create any production files.

package/agents/planner.md

@@ -40,7 +40,6 @@ Global Handoff Contract and Parallelization rules apply.
 - Follow existing code conventions
 - Write tests for new functionality
 - Run type checking after changes
-- Commit with conventional commits
 
 ### What NOT to Do
 

package/agents/reviewer.md

@@ -1,8 +1,9 @@
 ---
 description: >-
   Code review specialist. Reviews for correctness, edge cases, security,
-  performance, and maintainability. Supports multi-lens review swarms
-  with fix/dismiss/escalate triage.
+  performance, and maintainability in one general review. Adds specialist
+  lenses only for matching security, performance, architecture, or UX risk;
+  preserves blind review, lens exclusivity, and fix/dismiss/escalate triage.
 tools: read, bash, grep, find, ls, glob
 prompt_mode: append
 inherit_context: true
@@ -23,7 +24,7 @@ You review code for quality. You do not edit files (read-only checker only).
 
 ## Review Checklist
 
-Each category must have a verdict. Items are interrogative to engage critical thinking.
+The general reviewer must give a verdict for every category. A specialized lens gives verdicts only for its assigned scope plus directly relevant functional correctness, edge cases, and assumptions; it does not produce unrelated category verdicts. Items are interrogative to engage critical thinking.
 
 ### 1. Functional Correctness
 
@@ -90,12 +91,12 @@ Each category must have a verdict. Items are interrogative to engage critical th
 
 ## Iteration Limits
 
-- **Termination condition:** All checklist items have a verdict, critical issues have concrete fixes.
+- **Termination condition:** A general review gives every checklist item a verdict; a specialized lens gives verdicts for its assigned scope and directly relevant checks. Critical issues have concrete fixes.
 - **Max 3 re-reviews** before escalating persistent issues with issue history.
 
-## Multi-Lens Review Swarm
+## Risk-Matched Review Lenses
 
-When the orchestrator dispatches multiple review passes in parallel, narrow to your assigned lens:
+When the orchestrator dispatches a general review plus risk-matched specialist lenses, narrow to your assigned scope:
 
 ### Available lenses
 
@@ -103,13 +104,13 @@ When the orchestrator dispatches multiple review passes in parallel, narrow to y
 - **Performance lens** - Identify bottlenecks, excessive allocations, cache misses, bundle size, memory leaks
 - **Architecture lens** - Evaluate module boundaries, seam placement, dependency direction, interface quality
 - **UX lens** - Review visual fidelity, accessibility (WCAG), interaction patterns, empty/loading/error/populated states, responsive behavior, motion
-- **General lens** - Full review checklist: functional correctness, code quality, edge cases, style, test coverage
+- **General lens** - Full review checklist, including functional correctness, code quality, edge cases, style, performance, security, test coverage, assumptions, and writing style
 
-### Swarm etiquette
+### Lens etiquette
 
-1. **Stay in your lane** - Focus on your assigned lens. Trust other reviewers for their domains. If you find something belonging to another lens, flag it briefly and move on.
+1. **Stay in your lane** - General reviewers complete the whole checklist. Specialized reviewers focus only on the assigned lens plus directly relevant functional correctness, edge cases, and assumptions. Trust other reviewers for unrelated domains.
 2. **Lens exclusivity** - No two reviewers share the same lens. Trust the dispatch boundaries.
-3. **Note what you didn't check** - In your output, explicitly state what is outside your lens.
+3. **Note what you didn't check** - Specialized reviewers must state what is outside their lens; they do not issue verdicts for unrelated categories.
 4. **Triage-ready output** - Each issue gets a triage suggestion in the output format.
 
 ## Rules

package/dist/extension.mjs

@@ -1,4 +1,4 @@
-import{homedir as e}from"node:os";import{dirname as t,join as n,resolve as r}from"node:path";import{fileURLToPath as i}from"node:url";import{existsSync as a,mkdirSync as o,readFileSync as s,writeFileSync as c}from"node:fs";import{Type as l}from"typebox";import{SUBAGENT_EVENTS as u}from"@gotgenes/pi-subagents";import{isToolCallEventType as d}from"@earendil-works/pi-coding-agent";function f(){return{mode:null,activeTask:``,completionPromise:``,specialistsDelegated:[],blockers:[],filesModified:[],filesRead:[],handoffHistory:[],reviewMode:!1,originalModel:null,originalTools:null,subagentStatus:{},reviewModel:null}}function p(e,t,n,r){let i=[{from:t,to:n,task:r,timestamp:Date.now()},...e.handoffHistory].slice(0,5);return{...e,handoffHistory:i}}function m(e){return{state:{...e,reviewMode:!1,originalModel:null,originalTools:null},originalModel:e.originalModel,originalTools:e.originalTools}}function h(e,t){e.appendEntry(`maestria_state`,{...t})}function g(e){let t=[];if(e.mode&&t.push(`**Mode:** ${e.mode.toUpperCase()}`),e.reviewModel&&t.push(`**Review Model:** ${e.reviewModel}`),e.activeTask&&t.push(`**Goal:** ${e.activeTask}`),e.completionPromise&&t.push(`**Completion Promise:** ${e.completionPromise}`),e.specialistsDelegated.length>0&&t.push(`**Specialists Delegated:** ${e.specialistsDelegated.join(`, `)}`),e.blockers.length>0){t.push(`**Blockers:**`);for(let n of e.blockers)t.push(`- ${n}`)}let n=[];if(e.filesModified.length>0&&n.push(`**Modified:** ${e.filesModified.join(`, `)}`),e.filesRead.length>0&&n.push(`**Read:** ${e.filesRead.join(`, `)}`),n.length>0&&t.push(`**Files:** ${n.join(`; `)}`),e.handoffHistory.length>0){t.push(`**Recent Handoffs:**`);for(let n of e.handoffHistory)t.push(`- ${n.from} → ${n.to}: ${n.task}`)}return t.join(`
+import{homedir as e}from"node:os";import{dirname as t,join as n,resolve as r}from"node:path";import{fileURLToPath as i}from"node:url";import{existsSync as a,mkdirSync as o,readFileSync as s,writeFileSync as c}from"node:fs";import{Type as l}from"typebox";import{SUBAGENT_EVENTS as u}from"@gotgenes/pi-subagents";import{isToolCallEventType as d}from"@earendil-works/pi-coding-agent";function f(){return{mode:null,activeTask:``,completionPromise:``,specialistsDelegated:[],blockers:[],filesModified:[],filesRead:[],handoffHistory:[],reviewMode:!1,originalModel:null,originalTools:null,subagentStatus:{},reviewModel:null,nativeGoal:null}}function p(e,t,n,r){let i=[{from:t,to:n,task:r,timestamp:Date.now()},...e.handoffHistory].slice(0,5);return{...e,handoffHistory:i}}function m(e){return{state:{...e,reviewMode:!1,originalModel:null,originalTools:null},originalModel:e.originalModel,originalTools:e.originalTools}}function h(e,t){e.appendEntry(`maestria_state`,{...t})}function g(e){let t=[];if(e.mode&&t.push(`**Mode:** ${e.mode.toUpperCase()}`),e.reviewModel&&t.push(`**Review Model:** ${e.reviewModel}`),e.activeTask&&t.push(`**Goal:** ${e.activeTask}`),e.nativeGoal&&t.push(`**Native Goal:** ${e.nativeGoal.objective} (${e.nativeGoal.status})`),e.completionPromise&&t.push(`**Completion Promise:** ${e.completionPromise}`),e.specialistsDelegated.length>0&&t.push(`**Specialists Delegated:** ${e.specialistsDelegated.join(`, `)}`),e.blockers.length>0){t.push(`**Blockers:**`);for(let n of e.blockers)t.push(`- ${n}`)}let n=[];if(e.filesModified.length>0&&n.push(`**Modified:** ${e.filesModified.join(`, `)}`),e.filesRead.length>0&&n.push(`**Read:** ${e.filesRead.join(`, `)}`),n.length>0&&t.push(`**Files:** ${n.join(`; `)}`),e.handoffHistory.length>0){t.push(`**Recent Handoffs:**`);for(let n of e.handoffHistory)t.push(`- ${n.from} → ${n.to}: ${n.task}`)}return t.join(`
 
 `)}async function _(e,t,n){let{state:r,originalModel:i,originalTools:a}=m(n);if(a&&a.length>0&&e.setActiveTools(a),i)try{let n=t.modelRegistry.getAll().find(e=>e.id===i);n&&await e.setModel(n)}catch{}Object.assign(n,r)}async function v(e,t,n){let r=n.reviewModel;if(!r)return null;try{let n=t.modelRegistry.getAll().find(e=>e.id===r);return n?(await e.setModel(n),r):(t.ui.notify(`Review model "${r}" not found in registry, staying on current.`),null)}catch{return t.ui.notify(`Could not switch to review model "${r}", staying on current.`),null}}const y={REVIEW_ACTIVATED:`maestria:review:activated`,REVIEW_DEACTIVATED:`maestria:review:deactivated`,SUBAGENT_STARTED:`maestria:subagent:started`,SUBAGENT_COMPLETED:`maestria:subagent:completed`,SUBAGENT_FAILED:`maestria:subagent:failed`},b=[`adventurer`,`architect`,`builder`,`diagnose`,`planner`,`reviewer`,`writer`];function x(e){if(!b.includes(e))throw Error(`Unknown agent: "${e}". Allowed: ${b.join(`, `)}`)}function S(e,t){if(!e||!e.trim())throw Error(t)}function C(e,t){if(!a(e))return console.warn(`[maestria] Agents source directory not found:`,e),0;try{o(t,{recursive:!0})}catch{return console.warn(`[maestria] Could not create agents directory:`,t),0}let r=0;for(let i of b){let o=n(e,`${i}.md`),l=n(t,`${i}.md`);if(!a(o)){console.warn(`[maestria] Agent source not found: ${i}.md`);continue}if(!a(l))try{c(l,s(o,`utf-8`),`utf-8`),r++}catch(e){console.warn(`[maestria] Failed to deploy agent ${i}:`,e)}}return r>0&&console.log(`[maestria] Deployed ${r} specialist agents to ${t}`),r}const w=n(t(i(import.meta.url)),`..`,`agents`);function T(t){C(w,n(e(),`.pi`,`agent`,`agents`))}const E=[`fein`,`sonar`,`blitz`],D={fein:`[MODE: fein]`,sonar:`[MODE: sonar]`,blitz:`[MODE: blitz]`},O={};function k(e,t){let n=s(r(t,`${e}.md`),`utf-8`),i=n.indexOf(`## MODE:`);return i===-1?n.replace(/\s+$/,``)+`
 `:n.slice(i).replace(/\s+$/,``)+`

package/dist/extension.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extension.mjs","names":["deploySpecialistAgents","installModeAutoDetect","installModeCommands","COMMANDS_DIR","installCompactionHandlers"],"sources":["../../shared/pi/src/state-core.ts","../src/state/review.ts","../../shared/pi/src/subagent-utils.ts","../../shared/pi/src/agent-deployment.ts","../src/agents.ts","../../shared/pi/src/modes-core.ts","../src/modes.ts","../src/rules.ts","../../shared/pi/src/compaction-core.ts","../src/compaction.ts","../src/subagent.ts","../src/commands.ts","../../shared/pi/src/tools-core.ts","../src/tools.ts","../src/extension.ts"],"sourcesContent":["/**\n * Shared state management for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Provides shared state-management types, transforms, persistence, and rendering\n * consumed directly by @maestria/omp and @maestria/pi.\n *\n * @module\n */\n\n// ── Types ──\n\nexport type ModeKeyword = 'fein' | 'sonar' | 'blitz';\n\nexport const HANDOFF_HISTORY_CAP = 5;\nexport const FILE_HISTORY_CAP = 10;\n\nexport interface HandoffEntry {\n  from: string;\n  to: string;\n  task: string;\n  timestamp: number;\n}\n\nexport interface SubagentStatusInfo {\n  type: string;\n  status: string;\n  startedAt: number;\n  completedAt?: number;\n}\n\nexport interface MaestriaState {\n  mode: ModeKeyword | null;\n  activeTask: string;\n  completionPromise: string;\n  specialistsDelegated: string[];\n  blockers: string[];\n  filesModified: string[];\n  filesRead: string[];\n  handoffHistory: HandoffEntry[];\n  reviewMode: boolean;\n  originalModel: string | null;\n  originalTools: string[] | null;\n  subagentStatus: Record<string, SubagentStatusInfo>;\n  reviewModel: string | null;\n}\n\n// ── Transforms ──\n\nexport function createInitialState(): MaestriaState {\n  return {\n    mode: null,\n    activeTask: '',\n    completionPromise: '',\n    specialistsDelegated: [],\n    blockers: [],\n    filesModified: [],\n    filesRead: [],\n    handoffHistory: [],\n    reviewMode: false,\n    originalModel: null,\n    originalTools: null,\n    subagentStatus: {},\n    reviewModel: null,\n  };\n}\n\nfunction prependDeduped(files: string[], path: string, cap: number): string[] {\n  const filtered = files.filter((f) => f !== path);\n  return [path, ...filtered].slice(0, cap);\n}\n\nexport function recordHandoff(\n  state: MaestriaState,\n  from: string,\n  to: string,\n  task: string,\n): MaestriaState {\n  const entry: HandoffEntry = { from, to, task, timestamp: Date.now() };\n  const history = [entry, ...state.handoffHistory].slice(0, HANDOFF_HISTORY_CAP);\n  return { ...state, handoffHistory: history };\n}\n\nexport function recordFileModified(state: MaestriaState, path: string): MaestriaState {\n  return { ...state, filesModified: prependDeduped(state.filesModified, path, FILE_HISTORY_CAP) };\n}\n\nexport function recordFileRead(state: MaestriaState, path: string): MaestriaState {\n  return { ...state, filesRead: prependDeduped(state.filesRead, path, FILE_HISTORY_CAP) };\n}\n\nexport function recordSubagentStatus(\n  state: MaestriaState,\n  id: string,\n  info: SubagentStatusInfo,\n): MaestriaState {\n  return { ...state, subagentStatus: { ...state.subagentStatus, [id]: info } };\n}\n\nexport function setReviewMode(state: MaestriaState, active: boolean): MaestriaState {\n  return { ...state, reviewMode: active };\n}\n\nexport function exitReviewMode(state: MaestriaState): {\n  state: MaestriaState;\n  originalModel: string | null;\n  originalTools: string[] | null;\n} {\n  return {\n    state: {\n      ...state,\n      reviewMode: false,\n      originalModel: null,\n      originalTools: null,\n    },\n    originalModel: state.originalModel,\n    originalTools: state.originalTools,\n  };\n}\n\n// ── Persistence ──\n\nexport function persistState(\n  pi: { appendEntry: (type: string, data: unknown) => void },\n  state: MaestriaState,\n): void {\n  pi.appendEntry('maestria_state', { ...state });\n}\n\n// ── Render ──\n\nexport function renderMaestriaSummary(state: MaestriaState): string {\n  const parts: string[] = [];\n\n  if (state.mode) {\n    parts.push(`**Mode:** ${state.mode.toUpperCase()}`);\n  }\n\n  if (state.reviewModel) {\n    parts.push(`**Review Model:** ${state.reviewModel}`);\n  }\n\n  if (state.activeTask) {\n    parts.push(`**Goal:** ${state.activeTask}`);\n  }\n\n  if (state.completionPromise) {\n    parts.push(`**Completion Promise:** ${state.completionPromise}`);\n  }\n\n  if (state.specialistsDelegated.length > 0) {\n    parts.push(`**Specialists Delegated:** ${state.specialistsDelegated.join(', ')}`);\n  }\n\n  if (state.blockers.length > 0) {\n    parts.push('**Blockers:**');\n    for (const blocker of state.blockers) {\n      parts.push(`- ${blocker}`);\n    }\n  }\n\n  const fileSubs: string[] = [];\n  if (state.filesModified.length > 0) {\n    fileSubs.push(`**Modified:** ${state.filesModified.join(', ')}`);\n  }\n  if (state.filesRead.length > 0) {\n    fileSubs.push(`**Read:** ${state.filesRead.join(', ')}`);\n  }\n  if (fileSubs.length > 0) {\n    parts.push(`**Files:** ${fileSubs.join('; ')}`);\n  }\n\n  if (state.handoffHistory.length > 0) {\n    parts.push('**Recent Handoffs:**');\n    for (const entry of state.handoffHistory) {\n      parts.push(`- ${entry.from} → ${entry.to}: ${entry.task}`);\n    }\n  }\n\n  return parts.join('\\n\\n');\n}\n","import type {\n  ExtensionAPI,\n  ExtensionCommandContext,\n  ExtensionContext,\n} from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@maestria/shared-pi/state-core';\nimport { exitReviewMode } from '@maestria/shared-pi/state-core';\n\nexport async function restoreOriginalState(\n  pi: ExtensionAPI,\n  ctx: ExtensionContext,\n  state: MaestriaState,\n): Promise<void> {\n  const { state: clearedState, originalModel, originalTools } = exitReviewMode(state);\n\n  if (originalTools && originalTools.length > 0) {\n    pi.setActiveTools(originalTools);\n  }\n\n  if (originalModel) {\n    try {\n      const models = ctx.modelRegistry.getAll();\n      const model = models.find((m: { id: string }) => m.id === originalModel);\n      if (model) {\n        await pi.setModel(model);\n      }\n    } catch {\n      // Best-effort: model restoration is non-critical\n    }\n  }\n\n  Object.assign(state, clearedState);\n}\n\nexport async function cycleToReviewModel(\n  pi: ExtensionAPI,\n  ctx: ExtensionCommandContext,\n  state: MaestriaState,\n): Promise<string | null> {\n  const reviewModel = state.reviewModel;\n  if (!reviewModel) {\n    return null;\n  }\n  try {\n    const models = ctx.modelRegistry.getAll();\n    const model = models.find((m) => m.id === reviewModel);\n    if (model) {\n      await pi.setModel(model);\n      return reviewModel;\n    } else {\n      ctx.ui.notify(`Review model \"${reviewModel}\" not found in registry, staying on current.`);\n      return null;\n    }\n  } catch {\n    ctx.ui.notify(`Could not switch to review model \"${reviewModel}\", staying on current.`);\n    return null;\n  }\n}\n","/**\n * Shared subagent validation utilities for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Imported by both @maestria/omp and @maestria/pi to eliminate duplication.\n *\n * @module\n */\n\n/** Maestria cross-extension event names. */\nexport const MAESTRIA_EVENTS = {\n  REVIEW_ACTIVATED: 'maestria:review:activated',\n  REVIEW_DEACTIVATED: 'maestria:review:deactivated',\n  SUBAGENT_STARTED: 'maestria:subagent:started',\n  SUBAGENT_COMPLETED: 'maestria:subagent:completed',\n  SUBAGENT_FAILED: 'maestria:subagent:failed',\n} as const;\n\n/** The set of specialist agent types maestria supports. */\nexport const ALLOWED_AGENTS = [\n  'adventurer',\n  'architect',\n  'builder',\n  'diagnose',\n  'planner',\n  'reviewer',\n  'writer',\n] as const;\n\n/** A valid specialist agent name. */\nexport type AllowedAgent = (typeof ALLOWED_AGENTS)[number];\n\n/** The 7-field handoff contract used in delegation. */\nexport const HANDOFF_FIELDS = [\n  'Goal',\n  'Context',\n  'Requirements',\n  'Known problems',\n  'Assumptions documented',\n  'Success criteria',\n  'Next step',\n] as const;\n\n/** Result of validating a handoff document against the contract fields. */\nexport interface HandoffValidation {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Asserts that `agent` is a known maestria specialist.\n * @throws {Error} if the agent name is not in ALLOWED_AGENTS.\n */\nexport function assertValidAgent(agent: string): asserts agent is AllowedAgent {\n  if (!ALLOWED_AGENTS.includes(agent as AllowedAgent)) {\n    throw new Error(`Unknown agent: \"${agent}\". Allowed: ${ALLOWED_AGENTS.join(', ')}`);\n  }\n}\n\n/**\n * Asserts that `task` is a non-empty, non-whitespace string.\n * @throws {Error} with the given label if task is falsy or all-whitespace.\n */\nexport function assertNonEmptyTask(\n  task: string | undefined,\n  label: string,\n): asserts task is string {\n  if (!task || !task.trim()) {\n    throw new Error(label);\n  }\n}\n\n/**\n * Validates that a handoff document contains all required fields\n * with non-empty content. Each field is expected in markdown bold format:\n * `**Field:** content`.\n */\nexport function validateHandoff(handoff: string): HandoffValidation {\n  const errors: string[] = [];\n  for (const field of HANDOFF_FIELDS) {\n    // Match field header and capture content up to the next field or end of string.\n    // This avoids false positives when an empty field is followed by another field's `**` header.\n    const pattern = `\\\\*\\\\*${field}:\\\\*\\\\*([\\\\s\\\\S]*?)(?=\\\n\\\\*\\\\*|$)`;\n    const match = handoff.match(new RegExp(pattern, 'i'));\n    if (!match || !match[1] || !match[1].trim()) {\n      errors.push(`Missing or empty field: \"${field}\"`);\n    }\n  }\n  return { valid: errors.length === 0, errors };\n}\n","/**\n * Shared agent deployment logic for Maestria platform packages.\n *\n * Both @maestria/omp and @maestria/pi deploy specialist agent .md files\n * to their respective platform agent directories. This module eliminates\n * the duplication between the two packages.\n *\n * @module\n */\n\nimport { readFileSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { ALLOWED_AGENTS } from './subagent-utils.js';\n\n/**\n * Deploy bundled specialist agent .md files to the given destination directory.\n *\n * Only creates files that don't already exist — never overwrites user-customized agents.\n *\n * @param agentsSrc  - Path to the source directory containing specialist .md files\n * @param agentsDest - Absolute path to the platform's agents destination directory\n *                     (e.g. `join(homedir(), '.omp', 'agent', 'agents')`)\n * @returns The number of agents newly deployed\n */\nexport function deploySpecialistAgents(agentsSrc: string, agentsDest: string): number {\n  if (!existsSync(agentsSrc)) {\n    console.warn('[maestria] Agents source directory not found:', agentsSrc);\n    return 0;\n  }\n\n  try {\n    mkdirSync(agentsDest, { recursive: true });\n  } catch {\n    console.warn('[maestria] Could not create agents directory:', agentsDest);\n    return 0;\n  }\n\n  let deployed = 0;\n  for (const name of ALLOWED_AGENTS) {\n    const srcFile = join(agentsSrc, `${name}.md`);\n    const destFile = join(agentsDest, `${name}.md`);\n\n    if (!existsSync(srcFile)) {\n      console.warn(`[maestria] Agent source not found: ${name}.md`);\n      continue;\n    }\n\n    if (existsSync(destFile)) continue;\n\n    try {\n      const content = readFileSync(srcFile, 'utf-8');\n      writeFileSync(destFile, content, 'utf-8');\n      deployed++;\n    } catch (err) {\n      console.warn(`[maestria] Failed to deploy agent ${name}:`, err);\n    }\n  }\n\n  if (deployed > 0) {\n    console.log(`[maestria] Deployed ${deployed} specialist agents to ${agentsDest}`);\n  }\n\n  return deployed;\n}\n","import { homedir } from 'node:os';\nimport { join, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { deploySpecialistAgents as deployAgents } from '@maestria/shared-pi/agent-deployment';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst AGENTS_SRC = join(__dirname, '..', 'agents');\n\n/**\n * Deploy bundled specialist agent .md files to the pi-subagents agents directory.\n *\n * pi-subagents discovers agent types from ~/.pi/agent/agents/*.md on every\n * registry.reload() call (which fires automatically on each tool invocation).\n * This function ensures the files are in place before the first subagent dispatch.\n *\n * Only creates files that don't already exist — never overwrites user-customized agents.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function deploySpecialistAgents(_ctx?: unknown): void {\n  deployAgents(AGENTS_SRC, join(homedir(), '.pi', 'agent', 'agents'));\n}\n","/**\n * Shared mode constants and utilities for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Imported by both @maestria/omp and @maestria/pi to eliminate duplication\n * in mode prompt loading, keyword detection, and text transformation.\n *\n * @module\n */\n\nimport { readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { MaestriaState } from './state-core.js';\n\n// ── Constants ──\n\nexport const MODE_KEYWORDS = ['fein', 'sonar', 'blitz'] as const;\nexport type ModeKeyword = (typeof MODE_KEYWORDS)[number];\n\nexport const MODE_MARKERS: Record<ModeKeyword, string> = {\n  fein: '[MODE: fein]',\n  sonar: '[MODE: sonar]',\n  blitz: '[MODE: blitz]',\n};\n\n// ── Prompt loading ──\n\n/** Lazily cached mode prompts — shared across platforms. */\nconst _promptCache: Partial<Record<ModeKeyword, string>> = {};\n\n/**\n * Load and cache a mode prompt from a commands directory.\n * The commandsDir should point to a directory containing `fein.md`,\n * `sonar.md`, and `blitz.md` files.\n */\nexport function loadModePrompt(name: string, commandsDir: string): string {\n  const content = readFileSync(resolve(commandsDir, `${name}.md`), 'utf-8');\n  const modeIdx = content.indexOf('## MODE:');\n  if (modeIdx !== -1) {\n    return content.slice(modeIdx).replace(/\\s+$/, '') + '\\n';\n  }\n  return content.replace(/\\s+$/, '') + '\\n';\n}\n\n/**\n * Get the full mode prompt (marker + body) for a keyword, loading from\n * the given commands directory on first access.\n */\nexport function getModePrompt(keyword: ModeKeyword, commandsDir: string): string {\n  if (!(keyword in _promptCache)) {\n    try {\n      _promptCache[keyword] = loadModePrompt(keyword, commandsDir);\n    } catch (e) {\n      console.warn(`[maestria] Failed to load mode prompt \"${keyword}\":`, e);\n      _promptCache[keyword] = '';\n    }\n  }\n  return `${MODE_MARKERS[keyword]}\\n\\n${_promptCache[keyword]}`;\n}\n\n// ── Keyword detection ──\n\n/** Result of detecting a mode keyword in text. */\nexport interface ModeDetectResult {\n  /** The detected keyword. */\n  keyword: ModeKeyword;\n  /** The text with the keyword stripped and trimmed. */\n  strippedText: string;\n  /** The full mode prompt (marker + body). */\n  prompt: string;\n}\n\n/** Regex matching fenced code blocks (```) and inline backtick spans (`). */\nconst CODE_BLOCK_RE = /```[\\s\\S]*?```|`[^`]*`/g;\n\n/**\n * Find ranges of fenced code blocks and inline code spans in text.\n * Returns [start, end) positions. Keywords inside these ranges are\n * ignored during detection (per ADR-OC-003).\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 * 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 * Detect a mode keyword (fein/sonar/blitz) in text as a whole word,\n * case-insensitive. Detection rules (per ADR-OC-003):\n * - Word-boundary regex matching (\\bfein\\b, \\bsonar\\b, \\bblitz\\b)\n * - Most restrictive match wins (fein > sonar > blitz)\n * - Case-insensitive\n * - Matches inside fenced code blocks (```) and inline backticks (`) are ignored\n */\nexport function detectModeInText(text: string, commandsDir: string): ModeDetectResult | null {\n  if (!text) return null;\n\n  const codeRanges = findAllCodeBlockRanges(text);\n  let best: { keyword: ModeKeyword; index: number } | null = null;\n\n  for (const keyword of MODE_KEYWORDS) {\n    const regex = new RegExp(`\\\\b${keyword}\\\\b`, 'gi');\n    let match: RegExpExecArray | null;\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 (best === null || MODE_PRIORITY[keyword] > MODE_PRIORITY[best.keyword]) {\n        best = { keyword, index: match.index };\n      }\n    }\n  }\n\n  if (best === null) return null;\n\n  // Strip the matched keyword, cleaning up a trailing colon and collapsing\n  // double spaces (mirrors opencode's stripKeyword behavior).\n  const before = text.slice(0, best.index);\n  const after = text.slice(best.index + best.keyword.length).replace(/^:\\s*/, '');\n  const strippedText = (before + after).replace(/ {2,}/g, ' ').trim();\n\n  return {\n    keyword: best.keyword,\n    strippedText,\n    prompt: getModePrompt(best.keyword, commandsDir),\n  };\n}\n\n/**\n * Build the final text to send to the LLM: prompt + stripped text.\n * If strippedText is empty, returns just the prompt.\n */\nexport function buildModeText(prompt: string, strippedText: string): string {\n  return strippedText ? `${prompt}\\n\\n${strippedText}` : prompt;\n}\n\n// ── Platform handler factories ──\n\n/**\n * Install an input event handler that detects mode keywords (fein/sonar/blitz)\n * in user input, strips them, and injects the mode prompt.\n *\n * @param onInput - Platform's `pi.on('input', handler)` method\n * @param state - Shared maestria state\n * @param commandsDir - Path to directory containing fein.md/sonar.md/blitz.md\n * @param opts - Platform-specific callbacks and result builders\n */\nexport function installModeAutoDetect(\n  onInput: (handler: (event: unknown, ctx: unknown) => unknown) => void,\n  state: MaestriaState,\n  commandsDir: string,\n  opts: {\n    /** Exit review mode — calls platform's restoreOriginalState */\n    restoreOriginalState: (ctx: unknown) => Promise<void>;\n    /** Persist state after mode change */\n    persistState: () => void;\n    /** Return value when no keyword is detected (e.g. Pi: { action: 'continue' }) */\n    noMatch: unknown;\n    /** Build return value from transformed text (e.g. Pi: { action: 'transform', text }) */\n    transform: (text: string) => unknown;\n  },\n): void {\n  onInput(async (event: unknown, ctx: unknown) => {\n    const text = ((event as Record<string, unknown>).text as string) ?? '';\n    const result = detectModeInText(text, commandsDir);\n    if (!result) return opts.noMatch;\n\n    if (state.reviewMode) {\n      await opts.restoreOriginalState(ctx);\n    }\n\n    state.mode = result.keyword;\n    opts.persistState();\n\n    return opts.transform(buildModeText(result.prompt, result.strippedText));\n  });\n}\n\n/**\n * Install slash commands for fein/sonar/blitz that set the workflow mode\n * and show a notification. Task description injection is handled by the\n * auto-detect handler instead.\n *\n * @param registerCommand - Platform's `pi.registerCommand(name, opts)` method\n * @param state - Shared maestria state\n * @param opts - Platform-specific callbacks\n */\nexport function installModeCommands(\n  registerCommand: (\n    name: string,\n    options: { description: string; handler: (...args: unknown[]) => unknown },\n  ) => void,\n  state: MaestriaState,\n  opts: {\n    /** Exit review mode before switching modes */\n    restoreOriginalState: (ctx: unknown) => Promise<void>;\n    /** Persist state after mode change */\n    persistState: () => void;\n  },\n): void {\n  for (const keyword of MODE_KEYWORDS) {\n    registerCommand(keyword, {\n      description: `Set workflow mode to ${keyword}`,\n      handler: async (_args: unknown, ctx: unknown) => {\n        if (state.reviewMode) {\n          await opts.restoreOriginalState(ctx);\n        }\n\n        state.mode = keyword;\n        opts.persistState();\n\n        ((ctx as Record<string, unknown>).ui as { notify: (msg: string) => void }).notify(\n          `Mode set to ${keyword}. Describe what you'd like to work on.`,\n        );\n      },\n    });\n  }\n}\n","import { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport { persistState, restoreOriginalState } from '@/state.js';\nimport {\n  installModeAutoDetect as installAutoDetect,\n  installModeCommands as installCommands,\n} from '@maestria/shared-pi/modes-core';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst COMMANDS_DIR = resolve(__dirname, '../agents/commands');\n\nexport function installModeAutoDetect(pi: ExtensionAPI, state: MaestriaState): void {\n  installAutoDetect((handler) => pi.on('input', handler as never), state, COMMANDS_DIR, {\n    restoreOriginalState: (ctx) => restoreOriginalState(pi, ctx as ExtensionContext, state),\n    persistState: () => persistState(pi, state),\n    noMatch: { action: 'continue' as const },\n    transform: (text) => ({ action: 'transform' as const, text }),\n  });\n}\n\nexport function installModeCommands(pi: ExtensionAPI, state: MaestriaState): void {\n  installCommands((name, opts) => pi.registerCommand(name, opts as never), state, {\n    restoreOriginalState: (ctx) => restoreOriginalState(pi, ctx as ExtensionContext, state),\n    persistState: () => persistState(pi, state),\n  });\n}\n","import { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type {\n  BeforeAgentStartEvent,\n  BeforeAgentStartEventResult,\n  ExtensionContext,\n} from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport { getModePrompt } from '@maestria/shared-pi/modes-core';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst COMMANDS_DIR = resolve(__dirname, '../agents/commands');\n\n/**\n * Creates a before_agent_start handler that injects workflow mode prompts.\n *\n * This is the only dynamic prompt injection needed from the extension.\n * Static behavioral content (orchestrator prompt + global rules) is\n * auto-injected by Pi's skill system via SKILL.md files registered in\n * the pi.skills manifest field - the standard Pi extension pattern.\n *\n * When no mode is active, the handler returns void (no modification),\n * letting Pi's built-in prompt assembly (skills + context files + tools)\n * stand as-is.\n */\nexport function createModePromptHandler(state: MaestriaState) {\n  return (\n    event: BeforeAgentStartEvent,\n    _ctx: ExtensionContext,\n  ): BeforeAgentStartEventResult | void => {\n    if (!state.mode) return;\n\n    const parts: string[] = [\n      event.systemPrompt,\n      '',\n      getModePrompt(state.mode, COMMANDS_DIR),\n      '',\n      `The user has set workflow mode to \"${state.mode}\". ` +\n        'Honor this mode throughout the session until changed via /command.',\n    ];\n\n    return { systemPrompt: parts.join('\\n') };\n  };\n}\n","/**\n * Shared compaction handlers for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Imported by both @maestria/omp and @maestria/pi to eliminate duplication.\n *\n * @module\n */\n\nimport { renderMaestriaSummary } from './state-core.js';\nimport type { MaestriaState } from './state-core.js';\n\n/**\n * Install handlers for session compaction and tree events to persist\n * and restore maestria state across session compaction boundaries.\n *\n * Uses duck-typed `pi` parameter — both Pi and OMP ExtensionAPI types\n * satisfy the `{ on(event: string, handler): void }` shape needed here.\n */\nexport function installCompactionHandlers(\n  pi: {\n    on: (event: string, handler: (...args: unknown[]) => unknown) => void;\n  },\n  state: MaestriaState,\n): void {\n  pi.on('session_before_compact', (event: unknown) => {\n    const prep = (event as Record<string, unknown>).preparation as\n      | Record<string, unknown>\n      | undefined;\n    return {\n      compaction: {\n        summary: renderMaestriaSummary(state),\n        details: { ...state },\n        firstKeptEntryId: prep?.firstKeptEntryId,\n        tokensBefore: prep?.tokensBefore,\n      },\n    };\n  });\n\n  pi.on('session_before_tree', (event: unknown) => {\n    const prep = (event as Record<string, unknown>).preparation as\n      | Record<string, unknown>\n      | undefined;\n    if (prep?.userWantsSummary) {\n      return {\n        summary: {\n          summary: renderMaestriaSummary(state),\n        },\n      };\n    }\n    return undefined;\n  });\n}\n","/**\n * Pi platform compaction handlers.\n *\n * Thin wrapper around the shared implementation in\n * @maestria/shared-pi/compaction-core.\n *\n * @module\n */\n\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport { installCompactionHandlers as installHandlers } from '@maestria/shared-pi/compaction-core';\n\n/**\n * Install session compaction and tree event handlers for Pi.\n * Delegates to the shared implementation which is duck-type compatible\n * with Pi's ExtensionAPI.\n */\nexport function installCompactionHandlers(pi: ExtensionAPI, state: MaestriaState): void {\n  // Bridge: ExtensionAPI.on has overloaded event types incompatible with\n  // the duck-typed { on: (event: string, handler) => void } in the shared\n  // module. The as-never cast is safe at runtime — both SDKs share the same\n  // event shapes.\n  installHandlers(\n    {\n      on: (event, handler) => {\n        pi.on(event as never, handler as never);\n      },\n    },\n    state,\n  );\n}\n","import { Type } from 'typebox';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport { SUBAGENT_EVENTS } from '@gotgenes/pi-subagents';\nimport type { MaestriaState } from '@/state.js';\nimport { persistState, recordHandoff } from '@/state.js';\nimport {\n  assertValidAgent,\n  assertNonEmptyTask,\n  MAESTRIA_EVENTS,\n} from '@maestria/shared-pi/subagent-utils';\n\n/** Terminal subagent statuses - agent will produce no more updates. */\nconst TERMINAL_STATUSES = new Set(['completed', 'steered', 'aborted', 'stopped', 'error']);\n\n/** Maximum time to wait for a subagent to complete, in milliseconds. */\nexport const POLL_TIMEOUT_MS = 60_000;\n\n/** Interval between subagent status checks, in milliseconds. */\nexport const POLL_INTERVAL_MS = 500;\n\n/** Maximum number of tasks allowed in parallel dispatch. */\nexport const MAX_PARALLEL_TASKS = 8;\n\n// ── Polling helper ───────────────────────────────────────────────\n\ntype SubagentRecord = { status: string; result?: string; error?: string };\n\nasync function pollSubagent(\n  id: string,\n  label: string,\n  sendUpdates: boolean,\n  service: { getRecord(id: string): SubagentRecord | undefined },\n  signal: AbortSignal | undefined,\n  onUpdate: ((result: { content: Array<{ type: string; text: string }> }) => void) | undefined,\n): Promise<SubagentRecord> {\n  const maxPolls = POLL_TIMEOUT_MS / POLL_INTERVAL_MS;\n  let polls = 0;\n  let record = service.getRecord(id);\n  while (record && !TERMINAL_STATUSES.has(record.status) && polls < maxPolls) {\n    if (signal?.aborted) throw new Error('Maestria subagent call aborted');\n    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));\n    record = service.getRecord(id);\n    polls++;\n    if (sendUpdates) {\n      onUpdate?.({\n        content: [\n          {\n            type: 'text' as const,\n            text: `${label} running... (${Math.round((polls * POLL_INTERVAL_MS) / 1000)}s)`,\n          },\n        ],\n      });\n    }\n  }\n  if (record && !TERMINAL_STATUSES.has(record.status)) {\n    throw new Error(`Subagent ${id} timed out after ${POLL_TIMEOUT_MS}ms`);\n  }\n  if (!record) {\n    throw new Error(`Subagent ${id} was cleaned up before completion`);\n  }\n  return record;\n}\n\n// ── Handoff recording helper ────────────────────────────────────\n\nfunction recordAndPersist(\n  pi: ExtensionAPI,\n  state: MaestriaState,\n  agentName: string,\n  taskText: string,\n): void {\n  const updatedState = recordHandoff(state, 'orchestrator', agentName, taskText);\n  Object.assign(state, updatedState);\n  pi.appendEntry('maestria_state', state);\n}\n\nexport function installSubagentTool(\n  pi: ExtensionAPI,\n  state: MaestriaState,\n  cleanups?: Array<() => void>,\n): void {\n  pi.registerTool({\n    name: 'maestria_subagent',\n    label: 'Maestria Subagent',\n    description: 'Dispatch a task to a @maestria specialist subagent',\n    promptSnippet:\n      'Delegate tasks to @maestria specialist subagents (adventurer, architect, builder, planner, diagnose, reviewer, writer)',\n    promptGuidelines: [\n      'Use maestria_subagent when a task MUST be delegated to a specialist subagent rather than handled directly. Each specialist has focused capabilities: adventurer (recon), architect (design), builder (impl), planner (planning), diagnose (bugs), reviewer (QA), writer (docs).',\n    ],\n    prepareArguments(args: unknown) {\n      return args;\n    },\n    parameters: Type.Object({\n      agent: Type.Optional(Type.String({ description: 'Specialist agent name' })),\n      task: Type.Optional(Type.String({ description: 'Task description for the subagent' })),\n      tasks: Type.Optional(\n        Type.Array(\n          Type.Object({\n            agent: Type.String(),\n            task: Type.String(),\n          }),\n          { description: 'Array of task objects for parallel or chain dispatch' },\n        ),\n      ),\n      mode: Type.Optional(\n        Type.Union([Type.Literal('parallel'), Type.Literal('chain'), Type.Literal('single')]),\n      ),\n    }),\n    async execute(\n      _toolCallId: string,\n      params: {\n        agent?: string;\n        task?: string;\n        tasks?: Array<{ agent: string; task: string }>;\n        mode?: 'parallel' | 'chain' | 'single';\n      },\n      signal: AbortSignal | undefined,\n      onUpdate: ((result: { content: Array<{ type: string; text: string }> }) => void) | undefined,\n      _ctx: ExtensionContext,\n    ) {\n      // Block subagent dispatch when in review mode\n      if (state.reviewMode) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: 'Subagent dispatch is not available during review mode. Use /restore-model to exit review mode first.',\n            },\n          ],\n        };\n      }\n\n      // Determine dispatch mode (default to 'single' for backward compat)\n      const mode = params.mode ?? 'single';\n\n      // Validate parameters based on mode\n      if (mode === 'single') {\n        assertValidAgent(params.agent!);\n        assertNonEmptyTask(params.task, 'Task description is required');\n      } else if (mode === 'parallel') {\n        if (!params.tasks || params.tasks.length < 2) {\n          throw new Error(`For parallel mode, tasks array is required with at least 2 items`);\n        }\n        if (params.tasks.length > MAX_PARALLEL_TASKS) {\n          throw new Error(\n            `For parallel mode, tasks array may have at most ${MAX_PARALLEL_TASKS} items (got ${params.tasks.length})`,\n          );\n        }\n        for (const t of params.tasks) {\n          assertValidAgent(t.agent);\n          assertNonEmptyTask(t.task, 'Task description is required for all tasks');\n        }\n      } else if (mode === 'chain') {\n        if (!params.tasks || params.tasks.length < 2) {\n          throw new Error('For chain mode, tasks array is required with at least 2 items');\n        }\n        for (const t of params.tasks) {\n          assertValidAgent(t.agent);\n          assertNonEmptyTask(t.task, 'Task description is required for all tasks');\n        }\n      }\n\n      // Attempt to dispatch via @gotgenes/pi-subagents; handle missing service\n      const { getSubagentsService } = await import('@gotgenes/pi-subagents');\n      const service = getSubagentsService();\n      if (!service || typeof service.spawn !== 'function') {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: [\n                '## Subagent Dispatch Unavailable',\n                '',\n                'The `@gotgenes/pi-subagents` extension is required for subagent dispatch but has not been loaded.',\n                '',\n                'Install it as a Pi extension:',\n                '',\n                '```',\n                'pi install npm:@gotgenes/pi-subagents',\n                '```',\n                '',\n                'Then restart your Pi session.',\n              ].join('\\n'),\n            },\n          ],\n        };\n      }\n\n      try {\n        // --- SINGLE MODE ---\n        if (mode === 'single') {\n          const agent = params.agent!;\n          const task = params.task!;\n\n          // Spawn in foreground - returns subagent ID synchronously\n          const id = service.spawn(agent, task, {\n            description: task.slice(0, 80),\n            foreground: true,\n            inheritContext: true,\n          });\n\n          // Record handoff in state and persist (only after spawn succeeds)\n          recordAndPersist(pi, state, agent, task);\n\n          // Poll for completion\n          const record = await pollSubagent(\n            id,\n            `Subagent ${agent}`,\n            true,\n            service,\n            signal,\n            onUpdate,\n          );\n\n          const resultText = record.result ?? record.error ?? 'No output.';\n\n          return {\n            content: [{ type: 'text' as const, text: resultText }],\n            details: { subagentId: id },\n          };\n        }\n\n        // --- PARALLEL MODE ---\n        if (mode === 'parallel') {\n          const taskList = params.tasks!;\n\n          onUpdate?.({\n            content: [\n              { type: 'text' as const, text: `Spawning ${taskList.length} parallel subagents...` },\n            ],\n          });\n\n          // Spawn all tasks\n          const spawnedIds: string[] = [];\n          for (const t of taskList) {\n            const id = service.spawn(t.agent, t.task, {\n              description: t.task.slice(0, 80),\n              foreground: true,\n              inheritContext: true,\n            });\n            spawnedIds.push(id);\n\n            // Record each handoff\n            recordAndPersist(pi, state, t.agent, t.task);\n          }\n\n          // Poll all concurrently\n          const records = await Promise.all(\n            spawnedIds.map((id, i) =>\n              pollSubagent(\n                id,\n                `${taskList[i].agent} (${i + 1}/${taskList.length})`,\n                false,\n                service,\n                signal,\n                onUpdate,\n              ),\n            ),\n          );\n\n          onUpdate?.({\n            content: [\n              {\n                type: 'text' as const,\n                text: `All ${taskList.length} parallel subagents completed.`,\n              },\n            ],\n          });\n\n          // Aggregate results\n          const parts = [`## Parallel Results (${taskList.length} tasks)\\n`];\n          for (let i = 0; i < taskList.length; i++) {\n            const t = taskList[i];\n            const rec = records[i];\n            const resultText = rec.result ?? rec.error ?? 'No output.';\n            parts.push(`### ${i + 1}: ${t.agent}`);\n            parts.push(resultText);\n          }\n\n          return {\n            content: [{ type: 'text' as const, text: parts.join('\\n\\n') }],\n            details: { subagentIds: spawnedIds },\n          };\n        }\n\n        // --- CHAIN MODE ---\n        if (mode === 'chain') {\n          const taskList = params.tasks!;\n          let previousResult = '';\n\n          for (let i = 0; i < taskList.length; i++) {\n            const t = taskList[i];\n            let taskText = t.task;\n\n            // Substitute {previous} placeholder with previous result\n            if (i > 0 && taskText.includes('{previous}')) {\n              taskText = taskText.replace(/\\{previous\\}/g, previousResult);\n            }\n\n            const id = service.spawn(t.agent, taskText, {\n              description: taskText.slice(0, 80),\n              foreground: true,\n              inheritContext: true,\n            });\n\n            // Record handoff\n            recordAndPersist(pi, state, t.agent, taskText);\n\n            onUpdate?.({\n              content: [\n                {\n                  type: 'text' as const,\n                  text: `Chain step ${i + 1}/${taskList.length}: ${t.agent} running...`,\n                },\n              ],\n            });\n\n            // Poll for completion\n            const record = await pollSubagent(\n              id,\n              `Chain step ${i + 1}: ${t.agent}`,\n              true,\n              service,\n              signal,\n              onUpdate,\n            );\n\n            previousResult = record.result ?? record.error ?? 'No output.';\n\n            if (i < taskList.length - 1) {\n              onUpdate?.({\n                content: [\n                  {\n                    type: 'text' as const,\n                    text: `Chain step ${i + 1}/${taskList.length}: ${t.agent} completed. Moving to next step.`,\n                  },\n                ],\n              });\n            }\n          }\n\n          return {\n            content: [{ type: 'text' as const, text: previousResult }],\n            details: { subagentId: 'chain-completed' },\n          };\n        }\n\n        // Should not reach here - all modes are handled above\n        throw new Error('Unknown dispatch mode');\n      } catch (err) {\n        console.warn('[maestria] Subagent dispatch failed:', err);\n        // Return handoff payload as structured text when dispatch fails\n        const agentName = params.agent ?? params.tasks?.[0]?.agent ?? 'unknown';\n        const taskDesc = params.task ?? params.tasks?.map((t) => t.task).join('; ') ?? 'unknown';\n        const handoffInfo = [\n          `## Subagent Handoff Required`,\n          ``,\n          `**From:** orchestrator`,\n          `**To:** ${agentName}`,\n          `**Task:** ${taskDesc}`,\n          ``,\n          `Subagent dispatch failed. Please delegate this work manually.`,\n        ].join('\\n');\n\n        return {\n          content: [{ type: 'text' as const, text: handoffInfo }],\n        };\n      }\n    },\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  } as any); // TypeBox inferred types don't match ToolDefinition exactly\n\n  // Subscribe to subagent lifecycle events for accurate state tracking.\n  // These subscriptions are set up once at extension init, not on every tool call.\n  // pi.events is the shared EventBus - distinct from pi.on() lifecycle hooks.\n  if (pi.events) {\n    const unsubStarted = pi.events.on(SUBAGENT_EVENTS.STARTED, (data: unknown) => {\n      const { id, type } = data as { id: string; type: string };\n      state.subagentStatus[id] = { type, status: 'running', startedAt: Date.now() };\n      persistState(pi, state);\n      pi.events?.emit(MAESTRIA_EVENTS.SUBAGENT_STARTED, {\n        id,\n        type,\n        timestamp: Date.now(),\n      });\n    });\n\n    const unsubCompleted = pi.events.on(SUBAGENT_EVENTS.COMPLETED, (data: unknown) => {\n      const { id } = data as { id: string };\n      const existing = state.subagentStatus[id];\n      if (existing) {\n        existing.status = 'completed';\n        existing.completedAt = Date.now();\n      }\n      persistState(pi, state);\n      pi.events?.emit(MAESTRIA_EVENTS.SUBAGENT_COMPLETED, {\n        id,\n        type: existing?.type,\n        timestamp: Date.now(),\n      });\n    });\n\n    const unsubFailed = pi.events.on(SUBAGENT_EVENTS.FAILED, (data: unknown) => {\n      const { id, status } = data as { id: string; status: string };\n      const existing = state.subagentStatus[id];\n      if (existing) {\n        existing.status = status ?? 'error';\n        existing.completedAt = Date.now();\n      }\n      persistState(pi, state);\n      pi.events?.emit(MAESTRIA_EVENTS.SUBAGENT_FAILED, {\n        id,\n        type: existing?.type,\n        timestamp: Date.now(),\n      });\n    });\n\n    const unsubSteered = pi.events.on(SUBAGENT_EVENTS.STEERED, (data: unknown) => {\n      // Steering is informational - no status transition, but ensure\n      // the agent is tracked as running if it wasn't already observed.\n      const { id } = data as { id: string };\n      if (!state.subagentStatus[id]) {\n        state.subagentStatus[id] = { type: 'unknown', status: 'running', startedAt: Date.now() };\n      }\n      persistState(pi, state);\n    });\n\n    if (cleanups) {\n      cleanups.push(unsubStarted, unsubCompleted, unsubFailed, unsubSteered);\n    }\n  }\n}\n","import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport {\n  cycleToReviewModel,\n  persistState,\n  renderMaestriaSummary,\n  restoreOriginalState,\n} from '@/state.js';\nimport { MAESTRIA_EVENTS } from '@maestria/shared-pi/subagent-utils';\n\n/**\n * Read-only tools that let a reviewer inspect code without making changes.\n *\n * - `read`, `grep`, `find`, `ls`, `glob` - all non-destructive.\n * - Excluded: `bash`, `edit`, `write` - these can modify the filesystem.\n *\n * `glob` is included for file pattern matching even though it's not a\n * built-in Pi tool - extensions may register it, and including it is a no-op\n * if absent.\n */\nconst READ_ONLY_TOOLS = ['read', 'grep', 'find', 'ls', 'glob'];\n\nexport function installCommands(pi: ExtensionAPI, state: MaestriaState): void {\n  pi.registerCommand('maestria-status', {\n    description: 'Show current maestria session state including handoff history',\n    handler: async (_args: string, ctx) => {\n      const summary = renderMaestriaSummary(state);\n      if (!summary) {\n        ctx.ui.notify('No active maestria state to report.');\n        return;\n      }\n      ctx.ui.setEditorText(summary);\n    },\n  });\n\n  pi.registerCommand('review', {\n    description: 'Enter review mode. Blocks destructive tools, sets read-only toolset.',\n    handler: async (args: string, ctx) => {\n      if (!args.trim()) {\n        ctx.ui.notify('Usage: /review <target> - describe what to review');\n        return;\n      }\n\n      // 1. Save current model and tools for later restoration\n      const currentModelId = ctx.model?.id ?? null;\n      const currentTools = pi.getActiveTools();\n\n      // 2. Update state: mark review mode, store originals\n      const updatedState: MaestriaState = {\n        ...state,\n        reviewMode: true,\n        originalModel: currentModelId,\n        originalTools: currentTools,\n      };\n      Object.assign(state, updatedState);\n      persistState(pi, state);\n\n      // 3. Switch to review model if configured\n      if (state.reviewModel) {\n        const switched = await cycleToReviewModel(pi, ctx, state);\n        if (switched) {\n          ctx.ui.notify(`Review mode: switched to ${switched}`);\n          pi.events?.emit(MAESTRIA_EVENTS.REVIEW_ACTIVATED, {\n            originalModel: state.originalModel,\n            reviewModel: switched,\n            timestamp: Date.now(),\n          });\n        }\n      }\n\n      // 4. Restrict to read-only tools\n      pi.setActiveTools(READ_ONLY_TOOLS);\n\n      pi.sendUserMessage(\n        [\n          `[REVIEW: ${args}]`,\n          '',\n          `Review: ${args}. Use the reviewer prompt template.`,\n          'Read only, no edits, report findings.',\n        ].join('\\n'),\n        { deliverAs: 'steer' },\n      );\n    },\n  });\n\n  pi.registerCommand('restore-model', {\n    description:\n      'Restore the original model and tools that were active before review mode was entered.',\n    handler: async (_args: string, ctx) => {\n      if (!state.reviewMode) {\n        ctx.ui.notify('Not in review mode. Nothing to restore.');\n        return;\n      }\n      const prevOriginalModel = state.originalModel;\n      await restoreOriginalState(pi, ctx, state);\n      persistState(pi, state);\n      ctx.ui.notify('Restored original model and tools.');\n      pi.events?.emit(MAESTRIA_EVENTS.REVIEW_DEACTIVATED, {\n        originalModel: prevOriginalModel,\n        timestamp: Date.now(),\n      });\n    },\n  });\n\n  pi.registerCommand('handoff', {\n    description: 'Generate a structured handoff prompt for a new task context',\n    handler: async (args: string, ctx) => {\n      if (!args.trim()) {\n        ctx.ui.notify('Usage: /handoff <goal> - describe the task context for handoff');\n        return;\n      }\n\n      // Build a structured handoff document with 7 fields\n      const goal = args.trim();\n      const handoffPrompt = [\n        '**Goal:** ' + goal,\n        '',\n        '**Context:**',\n        '- Mode: ' + (state.mode ?? 'none'),\n        '- Active task: ' + (state.activeTask || 'none'),\n        '- Specialists delegated: ' +\n          ((state.specialistsDelegated?.length ?? 0) > 0\n            ? state.specialistsDelegated.join(', ')\n            : 'none'),\n        '- Recent handoffs: ' + (state.handoffHistory?.length ?? 0) + ' entries',\n        '- Files modified: ' +\n          ((state.filesModified?.length ?? 0) > 0 ? state.filesModified.join(', ') : 'none'),\n        '',\n        '**Requirements:**',\n        '(fill in specific requirements)',\n        '',\n        '**Known problems:**',\n        (state.blockers?.length ?? 0) > 0\n          ? state.blockers.map((b: string) => '- ' + b).join('\\n')\n          : '(no known problems documented)',\n        '',\n        '**Assumptions documented:**',\n        '(document assumptions made, tagged [inferred] where uncertain)',\n        '',\n        '**Success criteria:**',\n        '(fill in how to verify completion)',\n        '',\n        '**Next step:**',\n        '(fill in what happens after this task)',\n        '',\n        '---',\n        'Complete the fields above before sending.',\n      ].join('\\n');\n\n      // Record in state\n      state.handoffHistory = [\n        { from: 'current', to: 'next', task: goal, timestamp: Date.now() },\n        ...(state.handoffHistory ?? []),\n      ].slice(0, 5);\n\n      // Persist state\n      persistState(pi, state);\n\n      // Send as user message with steer delivery\n      pi.sendUserMessage(handoffPrompt, { deliverAs: 'steer' });\n    },\n  });\n\n  pi.registerCommand('review-model', {\n    description: 'Set which model to use when entering review mode',\n    handler: async (args: string, ctx) => {\n      if (!args.trim()) {\n        ctx.ui.notify('Usage: /review-model <model-id>');\n        return;\n      }\n      const modelId = args.trim();\n      const models = ctx.modelRegistry.getAll();\n      const model = models.find((m) => m.id === modelId);\n      if (!model) {\n        ctx.ui.notify(\n          `Unknown model: \"${modelId}\". Available: ${models.map((m) => m.id).join(', ')}`,\n        );\n        return;\n      }\n      state.reviewModel = modelId;\n      persistState(pi, state);\n      ctx.ui.notify(`Review model set to: ${modelId}`);\n    },\n  });\n}\n","/**\n * Shared tool interceptor utilities for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Imported by both @maestria/omp and @maestria/pi to eliminate duplication.\n *\n * @module\n */\n\n/**\n * Dangerous bash command patterns that should always be blocked,\n * regardless of mode or specialist role.\n */\nexport const DANGEROUS_PATTERNS = [\n  /rm\\s+-rf\\s+\\//,\n  /dd\\s+if=/,\n  />\\s*\\/dev\\/sd/,\n  /chmod\\s+-R\\s+777\\s+\\//,\n  /mkfs\\.\\w+/,\n  /:(){ :\\|:& };:/,\n  />\\s*\\/etc\\/(passwd|shadow|sudoers)/,\n  /\\beval\\b/,\n  /wget\\s+-O\\s*-\\s*\\|\\s*(bash|sh)/,\n  /curl\\s+.*\\|\\s*(bash|sh)/,\n  /crontab\\s+-r/,\n];\n","import {\n  isToolCallEventType,\n  type ExtensionAPI,\n  type ToolCallEvent,\n  type ExtensionContext,\n} from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport { DANGEROUS_PATTERNS } from '@maestria/shared-pi/tools-core';\n\nexport function installToolInterceptors(pi: ExtensionAPI, state: MaestriaState): void {\n  pi.on('tool_call', async (event: ToolCallEvent, ctx: ExtensionContext) => {\n    if (!event || !event.toolName) return;\n\n    // ── Pure dispatcher enforcement ──\n    // When a maestria workflow mode is active, restrict the root session\n    // (orchestrator) to ONLY the maestria_subagent delegation tool.\n    // Subagent sessions are detected by the absence of the pi-subagents\n    // 'subagent' tool (stripped by applyRecursionGuard in child sessions).\n    if (state.mode !== null && pi.getActiveTools().includes('subagent')) {\n      if (event.toolName !== 'maestria_subagent') {\n        return {\n          block: true,\n          reason:\n            `Tool '${event.toolName}' is blocked for the orchestrator. ` +\n            `Use 'maestria_subagent' to delegate tasks to specialists.`,\n        };\n      }\n    }\n\n    // Block destructive tools in review mode\n    if (state.reviewMode) {\n      if (\n        isToolCallEventType('edit', event) ||\n        isToolCallEventType('write', event) ||\n        isToolCallEventType('bash', event)\n      ) {\n        return {\n          block: true,\n          reason: 'Review mode is active. Report findings, do not edit.',\n        };\n      }\n    }\n\n    // Block dangerous bash patterns regardless of mode\n    if (isToolCallEventType('bash', event)) {\n      if (!event.input || typeof event.input !== 'object') return undefined;\n      const command = event.input.command;\n      if (command) {\n        for (const pattern of DANGEROUS_PATTERNS) {\n          if (pattern.test(command)) {\n            if (ctx.hasUI) {\n              const confirmed = await ctx.ui.confirm(\n                'Dangerous Pattern Detected',\n                `This command matches a dangerous pattern:\\n${command}\\nProceed?`,\n              );\n              if (confirmed) return undefined;\n            }\n            return {\n              block: true,\n              reason: `Command matches dangerous pattern: ${pattern}`,\n            };\n          }\n        }\n      }\n    }\n\n    return undefined; // allow\n  });\n}\n","import type { ExtensionAPI, SessionStartEvent } from '@earendil-works/pi-coding-agent';\nimport { createInitialState } from '@/state.js';\nimport { deploySpecialistAgents } from '@/agents.js';\nimport { installModeCommands, installModeAutoDetect } from '@/modes.js';\nimport { createModePromptHandler } from '@/rules.js';\nimport { installCompactionHandlers } from '@/compaction.js';\nimport { installSubagentTool } from '@/subagent.js';\nimport { installCommands } from '@/commands.js';\nimport { installToolInterceptors } from '@/tools.js';\n\nexport default function (pi: ExtensionAPI): void {\n  const state = createInitialState();\n  const cleanups: Array<() => void> = [];\n\n  // Install mode commands: /fein, /sonar, /blitz\n  installModeCommands(pi, state);\n  installModeAutoDetect(pi, state);\n\n  // Inject mode prompt when a workflow mode is active\n  const handleModePrompt = createModePromptHandler(state);\n\n  pi.on('before_agent_start', (event, ctx) => {\n    return handleModePrompt(event, ctx);\n  });\n\n  // Deploy specialist agent files for pi-subagents discovery\n  pi.on('session_start', (_event: SessionStartEvent, ctx) => {\n    deploySpecialistAgents(ctx);\n\n    // Restore persisted state on session start (reload/resume/fork)\n    if (!ctx.sessionManager?.getEntries) return;\n    const entries = ctx.sessionManager.getEntries();\n    // Walk from newest to oldest, find the last persisted maestria_state entry\n    for (let i = entries.length - 1; i >= 0; i--) {\n      const entry = entries[i];\n      if (entry.type === 'custom' && entry.customType === 'maestria_state') {\n        const data = entry.data;\n        if (data && typeof data === 'object') {\n          Object.assign(state, data);\n        }\n        break;\n      }\n    }\n  });\n\n  // Install compaction preservation handlers\n  installCompactionHandlers(pi, state);\n\n  // Install orchestration hooks: subagent tool and commands\n  installSubagentTool(pi, state, cleanups);\n  installCommands(pi, state);\n\n  // Cleanup subscriptions on shutdown\n  pi.on('session_shutdown', () => {\n    for (const cleanup of cleanups) cleanup();\n    cleanups.length = 0;\n  });\n\n  // Install tool call interceptors for review mode and dangerous patterns\n  installToolInterceptors(pi, state);\n}\n"],"mappings":"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"}
+{"version":3,"file":"extension.mjs","names":["deploySpecialistAgents","installModeAutoDetect","installModeCommands","COMMANDS_DIR","installCompactionHandlers"],"sources":["../../shared/pi/src/state-core.ts","../src/state/review.ts","../../shared/pi/src/subagent-utils.ts","../../shared/pi/src/agent-deployment.ts","../src/agents.ts","../../shared/pi/src/modes-core.ts","../src/modes.ts","../src/rules.ts","../../shared/pi/src/compaction-core.ts","../src/compaction.ts","../src/subagent.ts","../src/commands.ts","../../shared/pi/src/tools-core.ts","../src/tools.ts","../src/extension.ts"],"sourcesContent":["/**\n * Shared state management for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Provides shared state-management types, transforms, persistence, and rendering\n * consumed directly by @maestria/omp and @maestria/pi.\n *\n * @module\n */\n\n// ── Types ──\n\nexport type ModeKeyword = 'fein' | 'sonar' | 'blitz';\n\nexport const HANDOFF_HISTORY_CAP = 5;\nexport const FILE_HISTORY_CAP = 10;\n\nexport interface HandoffEntry {\n  from: string;\n  to: string;\n  task: string;\n  timestamp: number;\n}\n\nexport interface SubagentStatusInfo {\n  type: string;\n  status: string;\n  startedAt: number;\n  completedAt?: number;\n}\n\n/**\n * Mirror of the host platform's native goal (e.g. OMP goal mode).\n *\n * Platform-agnostic by design: only the objective text and status are\n * carried so shared state stays free of platform-specific types.\n */\nexport interface NativeGoalMirror {\n  objective: string;\n  status: string;\n}\n\nexport interface MaestriaState {\n  mode: ModeKeyword | null;\n  activeTask: string;\n  completionPromise: string;\n  specialistsDelegated: string[];\n  blockers: string[];\n  filesModified: string[];\n  filesRead: string[];\n  handoffHistory: HandoffEntry[];\n  reviewMode: boolean;\n  originalModel: string | null;\n  originalTools: string[] | null;\n  subagentStatus: Record<string, SubagentStatusInfo>;\n  reviewModel: string | null;\n  nativeGoal: NativeGoalMirror | null;\n}\n\n// ── Transforms ──\n\nexport function createInitialState(): MaestriaState {\n  return {\n    mode: null,\n    activeTask: '',\n    completionPromise: '',\n    specialistsDelegated: [],\n    blockers: [],\n    filesModified: [],\n    filesRead: [],\n    handoffHistory: [],\n    reviewMode: false,\n    originalModel: null,\n    originalTools: null,\n    subagentStatus: {},\n    reviewModel: null,\n    nativeGoal: null,\n  };\n}\n\nfunction prependDeduped(files: string[], path: string, cap: number): string[] {\n  const filtered = files.filter((f) => f !== path);\n  return [path, ...filtered].slice(0, cap);\n}\n\nexport function recordHandoff(\n  state: MaestriaState,\n  from: string,\n  to: string,\n  task: string,\n): MaestriaState {\n  const entry: HandoffEntry = { from, to, task, timestamp: Date.now() };\n  const history = [entry, ...state.handoffHistory].slice(0, HANDOFF_HISTORY_CAP);\n  return { ...state, handoffHistory: history };\n}\n\nexport function recordFileModified(state: MaestriaState, path: string): MaestriaState {\n  return { ...state, filesModified: prependDeduped(state.filesModified, path, FILE_HISTORY_CAP) };\n}\n\nexport function recordFileRead(state: MaestriaState, path: string): MaestriaState {\n  return { ...state, filesRead: prependDeduped(state.filesRead, path, FILE_HISTORY_CAP) };\n}\n\nexport function recordSubagentStatus(\n  state: MaestriaState,\n  id: string,\n  info: SubagentStatusInfo,\n): MaestriaState {\n  return { ...state, subagentStatus: { ...state.subagentStatus, [id]: info } };\n}\n\nexport function setReviewMode(state: MaestriaState, active: boolean): MaestriaState {\n  return { ...state, reviewMode: active };\n}\n\nexport function exitReviewMode(state: MaestriaState): {\n  state: MaestriaState;\n  originalModel: string | null;\n  originalTools: string[] | null;\n} {\n  return {\n    state: {\n      ...state,\n      reviewMode: false,\n      originalModel: null,\n      originalTools: null,\n    },\n    originalModel: state.originalModel,\n    originalTools: state.originalTools,\n  };\n}\n\n// ── Persistence ──\n\nexport function persistState(\n  pi: { appendEntry: (type: string, data: unknown) => void },\n  state: MaestriaState,\n): void {\n  pi.appendEntry('maestria_state', { ...state });\n}\n\n// ── Render ──\n\nexport function renderMaestriaSummary(state: MaestriaState): string {\n  const parts: string[] = [];\n\n  if (state.mode) {\n    parts.push(`**Mode:** ${state.mode.toUpperCase()}`);\n  }\n\n  if (state.reviewModel) {\n    parts.push(`**Review Model:** ${state.reviewModel}`);\n  }\n\n  if (state.activeTask) {\n    parts.push(`**Goal:** ${state.activeTask}`);\n  }\n\n  if (state.nativeGoal) {\n    parts.push(`**Native Goal:** ${state.nativeGoal.objective} (${state.nativeGoal.status})`);\n  }\n\n  if (state.completionPromise) {\n    parts.push(`**Completion Promise:** ${state.completionPromise}`);\n  }\n\n  if (state.specialistsDelegated.length > 0) {\n    parts.push(`**Specialists Delegated:** ${state.specialistsDelegated.join(', ')}`);\n  }\n\n  if (state.blockers.length > 0) {\n    parts.push('**Blockers:**');\n    for (const blocker of state.blockers) {\n      parts.push(`- ${blocker}`);\n    }\n  }\n\n  const fileSubs: string[] = [];\n  if (state.filesModified.length > 0) {\n    fileSubs.push(`**Modified:** ${state.filesModified.join(', ')}`);\n  }\n  if (state.filesRead.length > 0) {\n    fileSubs.push(`**Read:** ${state.filesRead.join(', ')}`);\n  }\n  if (fileSubs.length > 0) {\n    parts.push(`**Files:** ${fileSubs.join('; ')}`);\n  }\n\n  if (state.handoffHistory.length > 0) {\n    parts.push('**Recent Handoffs:**');\n    for (const entry of state.handoffHistory) {\n      parts.push(`- ${entry.from} → ${entry.to}: ${entry.task}`);\n    }\n  }\n\n  return parts.join('\\n\\n');\n}\n","import type {\n  ExtensionAPI,\n  ExtensionCommandContext,\n  ExtensionContext,\n} from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@maestria/shared-pi/state-core';\nimport { exitReviewMode } from '@maestria/shared-pi/state-core';\n\nexport async function restoreOriginalState(\n  pi: ExtensionAPI,\n  ctx: ExtensionContext,\n  state: MaestriaState,\n): Promise<void> {\n  const { state: clearedState, originalModel, originalTools } = exitReviewMode(state);\n\n  if (originalTools && originalTools.length > 0) {\n    pi.setActiveTools(originalTools);\n  }\n\n  if (originalModel) {\n    try {\n      const models = ctx.modelRegistry.getAll();\n      const model = models.find((m: { id: string }) => m.id === originalModel);\n      if (model) {\n        await pi.setModel(model);\n      }\n    } catch {\n      // Best-effort: model restoration is non-critical\n    }\n  }\n\n  Object.assign(state, clearedState);\n}\n\nexport async function cycleToReviewModel(\n  pi: ExtensionAPI,\n  ctx: ExtensionCommandContext,\n  state: MaestriaState,\n): Promise<string | null> {\n  const reviewModel = state.reviewModel;\n  if (!reviewModel) {\n    return null;\n  }\n  try {\n    const models = ctx.modelRegistry.getAll();\n    const model = models.find((m) => m.id === reviewModel);\n    if (model) {\n      await pi.setModel(model);\n      return reviewModel;\n    } else {\n      ctx.ui.notify(`Review model \"${reviewModel}\" not found in registry, staying on current.`);\n      return null;\n    }\n  } catch {\n    ctx.ui.notify(`Could not switch to review model \"${reviewModel}\", staying on current.`);\n    return null;\n  }\n}\n","/**\n * Shared subagent validation utilities for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Imported by both @maestria/omp and @maestria/pi to eliminate duplication.\n *\n * @module\n */\n\n/** Maestria cross-extension event names. */\nexport const MAESTRIA_EVENTS = {\n  REVIEW_ACTIVATED: 'maestria:review:activated',\n  REVIEW_DEACTIVATED: 'maestria:review:deactivated',\n  SUBAGENT_STARTED: 'maestria:subagent:started',\n  SUBAGENT_COMPLETED: 'maestria:subagent:completed',\n  SUBAGENT_FAILED: 'maestria:subagent:failed',\n} as const;\n\n/** The set of specialist agent types maestria supports. */\nexport const ALLOWED_AGENTS = [\n  'adventurer',\n  'architect',\n  'builder',\n  'diagnose',\n  'planner',\n  'reviewer',\n  'writer',\n] as const;\n\n/** A valid specialist agent name. */\nexport type AllowedAgent = (typeof ALLOWED_AGENTS)[number];\n\n/** The 7-field handoff contract used in delegation. */\nexport const HANDOFF_FIELDS = [\n  'Goal',\n  'Context',\n  'Requirements',\n  'Known problems',\n  'Assumptions documented',\n  'Success criteria',\n  'Next step',\n] as const;\n\n/** Result of validating a handoff document against the contract fields. */\nexport interface HandoffValidation {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Asserts that `agent` is a known maestria specialist.\n * @throws {Error} if the agent name is not in ALLOWED_AGENTS.\n */\nexport function assertValidAgent(agent: string): asserts agent is AllowedAgent {\n  if (!ALLOWED_AGENTS.includes(agent as AllowedAgent)) {\n    throw new Error(`Unknown agent: \"${agent}\". Allowed: ${ALLOWED_AGENTS.join(', ')}`);\n  }\n}\n\n/**\n * Asserts that `task` is a non-empty, non-whitespace string.\n * @throws {Error} with the given label if task is falsy or all-whitespace.\n */\nexport function assertNonEmptyTask(\n  task: string | undefined,\n  label: string,\n): asserts task is string {\n  if (!task || !task.trim()) {\n    throw new Error(label);\n  }\n}\n\n/**\n * Validates that a handoff document contains all required fields\n * with non-empty content. Each field is expected in markdown bold format:\n * `**Field:** content`.\n */\nexport function validateHandoff(handoff: string): HandoffValidation {\n  const errors: string[] = [];\n  for (const field of HANDOFF_FIELDS) {\n    // Match field header and capture content up to the next field or end of string.\n    // This avoids false positives when an empty field is followed by another field's `**` header.\n    const pattern = `\\\\*\\\\*${field}:\\\\*\\\\*([\\\\s\\\\S]*?)(?=\\\n\\\\*\\\\*|$)`;\n    const match = handoff.match(new RegExp(pattern, 'i'));\n    if (!match || !match[1] || !match[1].trim()) {\n      errors.push(`Missing or empty field: \"${field}\"`);\n    }\n  }\n  return { valid: errors.length === 0, errors };\n}\n","/**\n * Shared agent deployment logic for Maestria platform packages.\n *\n * Both @maestria/omp and @maestria/pi deploy specialist agent .md files\n * to their respective platform agent directories. This module eliminates\n * the duplication between the two packages.\n *\n * @module\n */\n\nimport { readFileSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { ALLOWED_AGENTS } from './subagent-utils.js';\n\n/**\n * Deploy bundled specialist agent .md files to the given destination directory.\n *\n * Only creates files that don't already exist — never overwrites user-customized agents.\n *\n * @param agentsSrc  - Path to the source directory containing specialist .md files\n * @param agentsDest - Absolute path to the platform's agents destination directory\n *                     (e.g. `join(homedir(), '.omp', 'agent', 'agents')`)\n * @returns The number of agents newly deployed\n */\nexport function deploySpecialistAgents(agentsSrc: string, agentsDest: string): number {\n  if (!existsSync(agentsSrc)) {\n    console.warn('[maestria] Agents source directory not found:', agentsSrc);\n    return 0;\n  }\n\n  try {\n    mkdirSync(agentsDest, { recursive: true });\n  } catch {\n    console.warn('[maestria] Could not create agents directory:', agentsDest);\n    return 0;\n  }\n\n  let deployed = 0;\n  for (const name of ALLOWED_AGENTS) {\n    const srcFile = join(agentsSrc, `${name}.md`);\n    const destFile = join(agentsDest, `${name}.md`);\n\n    if (!existsSync(srcFile)) {\n      console.warn(`[maestria] Agent source not found: ${name}.md`);\n      continue;\n    }\n\n    if (existsSync(destFile)) continue;\n\n    try {\n      const content = readFileSync(srcFile, 'utf-8');\n      writeFileSync(destFile, content, 'utf-8');\n      deployed++;\n    } catch (err) {\n      console.warn(`[maestria] Failed to deploy agent ${name}:`, err);\n    }\n  }\n\n  if (deployed > 0) {\n    console.log(`[maestria] Deployed ${deployed} specialist agents to ${agentsDest}`);\n  }\n\n  return deployed;\n}\n","import { homedir } from 'node:os';\nimport { join, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { deploySpecialistAgents as deployAgents } from '@maestria/shared-pi/agent-deployment';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst AGENTS_SRC = join(__dirname, '..', 'agents');\n\n/**\n * Deploy bundled specialist agent .md files to the pi-subagents agents directory.\n *\n * pi-subagents discovers agent types from ~/.pi/agent/agents/*.md on every\n * registry.reload() call (which fires automatically on each tool invocation).\n * This function ensures the files are in place before the first subagent dispatch.\n *\n * Only creates files that don't already exist — never overwrites user-customized agents.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function deploySpecialistAgents(_ctx?: unknown): void {\n  deployAgents(AGENTS_SRC, join(homedir(), '.pi', 'agent', 'agents'));\n}\n","/**\n * Shared mode constants and utilities for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Imported by both @maestria/omp and @maestria/pi to eliminate duplication\n * in mode prompt loading, keyword detection, and text transformation.\n *\n * @module\n */\n\nimport { readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { MaestriaState } from './state-core.js';\n\n// ── Constants ──\n\nexport const MODE_KEYWORDS = ['fein', 'sonar', 'blitz'] as const;\nexport type ModeKeyword = (typeof MODE_KEYWORDS)[number];\n\nexport const MODE_MARKERS: Record<ModeKeyword, string> = {\n  fein: '[MODE: fein]',\n  sonar: '[MODE: sonar]',\n  blitz: '[MODE: blitz]',\n};\n\n// ── Prompt loading ──\n\n/** Lazily cached mode prompts — shared across platforms. */\nconst _promptCache: Partial<Record<ModeKeyword, string>> = {};\n\n/**\n * Load and cache a mode prompt from a commands directory.\n * The commandsDir should point to a directory containing `fein.md`,\n * `sonar.md`, and `blitz.md` files.\n */\nexport function loadModePrompt(name: string, commandsDir: string): string {\n  const content = readFileSync(resolve(commandsDir, `${name}.md`), 'utf-8');\n  const modeIdx = content.indexOf('## MODE:');\n  if (modeIdx !== -1) {\n    return content.slice(modeIdx).replace(/\\s+$/, '') + '\\n';\n  }\n  return content.replace(/\\s+$/, '') + '\\n';\n}\n\n/**\n * Get the full mode prompt (marker + body) for a keyword, loading from\n * the given commands directory on first access.\n */\nexport function getModePrompt(keyword: ModeKeyword, commandsDir: string): string {\n  if (!(keyword in _promptCache)) {\n    try {\n      _promptCache[keyword] = loadModePrompt(keyword, commandsDir);\n    } catch (e) {\n      console.warn(`[maestria] Failed to load mode prompt \"${keyword}\":`, e);\n      _promptCache[keyword] = '';\n    }\n  }\n  return `${MODE_MARKERS[keyword]}\\n\\n${_promptCache[keyword]}`;\n}\n\n// ── Keyword detection ──\n\n/** Result of detecting a mode keyword in text. */\nexport interface ModeDetectResult {\n  /** The detected keyword. */\n  keyword: ModeKeyword;\n  /** The text with the keyword stripped and trimmed. */\n  strippedText: string;\n  /** The full mode prompt (marker + body). */\n  prompt: string;\n}\n\n/** Regex matching fenced code blocks (```) and inline backtick spans (`). */\nconst CODE_BLOCK_RE = /```[\\s\\S]*?```|`[^`]*`/g;\n\n/**\n * Find ranges of fenced code blocks and inline code spans in text.\n * Returns [start, end) positions. Keywords inside these ranges are\n * ignored during detection (per ADR-OC-003).\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 * 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 * Detect a mode keyword (fein/sonar/blitz) in text as a whole word,\n * case-insensitive. Detection rules (per ADR-OC-003):\n * - Word-boundary regex matching (\\bfein\\b, \\bsonar\\b, \\bblitz\\b)\n * - Most restrictive match wins (fein > sonar > blitz)\n * - Case-insensitive\n * - Matches inside fenced code blocks (```) and inline backticks (`) are ignored\n */\nexport function detectModeInText(text: string, commandsDir: string): ModeDetectResult | null {\n  if (!text) return null;\n\n  const codeRanges = findAllCodeBlockRanges(text);\n  let best: { keyword: ModeKeyword; index: number } | null = null;\n\n  for (const keyword of MODE_KEYWORDS) {\n    const regex = new RegExp(`\\\\b${keyword}\\\\b`, 'gi');\n    let match: RegExpExecArray | null;\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 (best === null || MODE_PRIORITY[keyword] > MODE_PRIORITY[best.keyword]) {\n        best = { keyword, index: match.index };\n      }\n    }\n  }\n\n  if (best === null) return null;\n\n  // Strip the matched keyword, cleaning up a trailing colon and collapsing\n  // double spaces (mirrors opencode's stripKeyword behavior).\n  const before = text.slice(0, best.index);\n  const after = text.slice(best.index + best.keyword.length).replace(/^:\\s*/, '');\n  const strippedText = (before + after).replace(/ {2,}/g, ' ').trim();\n\n  return {\n    keyword: best.keyword,\n    strippedText,\n    prompt: getModePrompt(best.keyword, commandsDir),\n  };\n}\n\n/**\n * Build the final text to send to the LLM: prompt + stripped text.\n * If strippedText is empty, returns just the prompt.\n */\nexport function buildModeText(prompt: string, strippedText: string): string {\n  return strippedText ? `${prompt}\\n\\n${strippedText}` : prompt;\n}\n\n// ── Platform handler factories ──\n\n/**\n * Install an input event handler that detects mode keywords (fein/sonar/blitz)\n * in user input, strips them, and injects the mode prompt.\n *\n * @param onInput - Platform's `pi.on('input', handler)` method\n * @param state - Shared maestria state\n * @param commandsDir - Path to directory containing fein.md/sonar.md/blitz.md\n * @param opts - Platform-specific callbacks and result builders\n */\nexport function installModeAutoDetect(\n  onInput: (handler: (event: unknown, ctx: unknown) => unknown) => void,\n  state: MaestriaState,\n  commandsDir: string,\n  opts: {\n    /** Exit review mode — calls platform's restoreOriginalState */\n    restoreOriginalState: (ctx: unknown) => Promise<void>;\n    /** Persist state after mode change */\n    persistState: () => void;\n    /** Return value when no keyword is detected (e.g. Pi: { action: 'continue' }) */\n    noMatch: unknown;\n    /** Build return value from transformed text (e.g. Pi: { action: 'transform', text }) */\n    transform: (text: string) => unknown;\n  },\n): void {\n  onInput(async (event: unknown, ctx: unknown) => {\n    const text = ((event as Record<string, unknown>).text as string) ?? '';\n    const result = detectModeInText(text, commandsDir);\n    if (!result) return opts.noMatch;\n\n    if (state.reviewMode) {\n      await opts.restoreOriginalState(ctx);\n    }\n\n    state.mode = result.keyword;\n    opts.persistState();\n\n    return opts.transform(buildModeText(result.prompt, result.strippedText));\n  });\n}\n\n/**\n * Install slash commands for fein/sonar/blitz that set the workflow mode\n * and show a notification. Task description injection is handled by the\n * auto-detect handler instead.\n *\n * @param registerCommand - Platform's `pi.registerCommand(name, opts)` method\n * @param state - Shared maestria state\n * @param opts - Platform-specific callbacks\n */\nexport function installModeCommands(\n  registerCommand: (\n    name: string,\n    options: { description: string; handler: (...args: unknown[]) => unknown },\n  ) => void,\n  state: MaestriaState,\n  opts: {\n    /** Exit review mode before switching modes */\n    restoreOriginalState: (ctx: unknown) => Promise<void>;\n    /** Persist state after mode change */\n    persistState: () => void;\n  },\n): void {\n  for (const keyword of MODE_KEYWORDS) {\n    registerCommand(keyword, {\n      description: `Set workflow mode to ${keyword}`,\n      handler: async (_args: unknown, ctx: unknown) => {\n        if (state.reviewMode) {\n          await opts.restoreOriginalState(ctx);\n        }\n\n        state.mode = keyword;\n        opts.persistState();\n\n        ((ctx as Record<string, unknown>).ui as { notify: (msg: string) => void }).notify(\n          `Mode set to ${keyword}. Describe what you'd like to work on.`,\n        );\n      },\n    });\n  }\n}\n","import { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport { persistState, restoreOriginalState } from '@/state.js';\nimport {\n  installModeAutoDetect as installAutoDetect,\n  installModeCommands as installCommands,\n} from '@maestria/shared-pi/modes-core';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst COMMANDS_DIR = resolve(__dirname, '../agents/commands');\n\nexport function installModeAutoDetect(pi: ExtensionAPI, state: MaestriaState): void {\n  installAutoDetect((handler) => pi.on('input', handler as never), state, COMMANDS_DIR, {\n    restoreOriginalState: (ctx) => restoreOriginalState(pi, ctx as ExtensionContext, state),\n    persistState: () => persistState(pi, state),\n    noMatch: { action: 'continue' as const },\n    transform: (text) => ({ action: 'transform' as const, text }),\n  });\n}\n\nexport function installModeCommands(pi: ExtensionAPI, state: MaestriaState): void {\n  installCommands((name, opts) => pi.registerCommand(name, opts as never), state, {\n    restoreOriginalState: (ctx) => restoreOriginalState(pi, ctx as ExtensionContext, state),\n    persistState: () => persistState(pi, state),\n  });\n}\n","import { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type {\n  BeforeAgentStartEvent,\n  BeforeAgentStartEventResult,\n  ExtensionContext,\n} from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport { getModePrompt } from '@maestria/shared-pi/modes-core';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst COMMANDS_DIR = resolve(__dirname, '../agents/commands');\n\n/**\n * Creates a before_agent_start handler that injects workflow mode prompts.\n *\n * This is the only dynamic prompt injection needed from the extension.\n * Static behavioral content (orchestrator prompt + global rules) is\n * auto-injected by Pi's skill system via SKILL.md files registered in\n * the pi.skills manifest field - the standard Pi extension pattern.\n *\n * When no mode is active, the handler returns void (no modification),\n * letting Pi's built-in prompt assembly (skills + context files + tools)\n * stand as-is.\n */\nexport function createModePromptHandler(state: MaestriaState) {\n  return (\n    event: BeforeAgentStartEvent,\n    _ctx: ExtensionContext,\n  ): BeforeAgentStartEventResult | void => {\n    if (!state.mode) return;\n\n    const parts: string[] = [\n      event.systemPrompt,\n      '',\n      getModePrompt(state.mode, COMMANDS_DIR),\n      '',\n      `The user has set workflow mode to \"${state.mode}\". ` +\n        'Honor this mode throughout the session until changed via /command.',\n    ];\n\n    return { systemPrompt: parts.join('\\n') };\n  };\n}\n","/**\n * Shared compaction handlers for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Imported by both @maestria/omp and @maestria/pi to eliminate duplication.\n *\n * @module\n */\n\nimport { renderMaestriaSummary } from './state-core.js';\nimport type { MaestriaState } from './state-core.js';\n\n/**\n * Install handlers for session compaction and tree events to persist\n * and restore maestria state across session compaction boundaries.\n *\n * Uses duck-typed `pi` parameter — both Pi and OMP ExtensionAPI types\n * satisfy the `{ on(event: string, handler): void }` shape needed here.\n */\nexport function installCompactionHandlers(\n  pi: {\n    on: (event: string, handler: (...args: unknown[]) => unknown) => void;\n  },\n  state: MaestriaState,\n): void {\n  pi.on('session_before_compact', (event: unknown) => {\n    const prep = (event as Record<string, unknown>).preparation as\n      | Record<string, unknown>\n      | undefined;\n    return {\n      compaction: {\n        summary: renderMaestriaSummary(state),\n        details: { ...state },\n        firstKeptEntryId: prep?.firstKeptEntryId,\n        tokensBefore: prep?.tokensBefore,\n      },\n    };\n  });\n\n  pi.on('session_before_tree', (event: unknown) => {\n    const prep = (event as Record<string, unknown>).preparation as\n      | Record<string, unknown>\n      | undefined;\n    if (prep?.userWantsSummary) {\n      return {\n        summary: {\n          summary: renderMaestriaSummary(state),\n        },\n      };\n    }\n    return undefined;\n  });\n}\n","/**\n * Pi platform compaction handlers.\n *\n * Thin wrapper around the shared implementation in\n * @maestria/shared-pi/compaction-core.\n *\n * @module\n */\n\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport { installCompactionHandlers as installHandlers } from '@maestria/shared-pi/compaction-core';\n\n/**\n * Install session compaction and tree event handlers for Pi.\n * Delegates to the shared implementation which is duck-type compatible\n * with Pi's ExtensionAPI.\n */\nexport function installCompactionHandlers(pi: ExtensionAPI, state: MaestriaState): void {\n  // Bridge: ExtensionAPI.on has overloaded event types incompatible with\n  // the duck-typed { on: (event: string, handler) => void } in the shared\n  // module. The as-never cast is safe at runtime — both SDKs share the same\n  // event shapes.\n  installHandlers(\n    {\n      on: (event, handler) => {\n        pi.on(event as never, handler as never);\n      },\n    },\n    state,\n  );\n}\n","import { Type } from 'typebox';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport { SUBAGENT_EVENTS } from '@gotgenes/pi-subagents';\nimport type { MaestriaState } from '@/state.js';\nimport { persistState, recordHandoff } from '@/state.js';\nimport {\n  assertValidAgent,\n  assertNonEmptyTask,\n  MAESTRIA_EVENTS,\n} from '@maestria/shared-pi/subagent-utils';\n\n/** Terminal subagent statuses - agent will produce no more updates. */\nconst TERMINAL_STATUSES = new Set(['completed', 'steered', 'aborted', 'stopped', 'error']);\n\n/** Maximum time to wait for a subagent to complete, in milliseconds. */\nexport const POLL_TIMEOUT_MS = 60_000;\n\n/** Interval between subagent status checks, in milliseconds. */\nexport const POLL_INTERVAL_MS = 500;\n\n/** Maximum number of tasks allowed in parallel dispatch. */\nexport const MAX_PARALLEL_TASKS = 8;\n\n// ── Polling helper ───────────────────────────────────────────────\n\ntype SubagentRecord = { status: string; result?: string; error?: string };\n\nasync function pollSubagent(\n  id: string,\n  label: string,\n  sendUpdates: boolean,\n  service: { getRecord(id: string): SubagentRecord | undefined },\n  signal: AbortSignal | undefined,\n  onUpdate: ((result: { content: Array<{ type: string; text: string }> }) => void) | undefined,\n): Promise<SubagentRecord> {\n  const maxPolls = POLL_TIMEOUT_MS / POLL_INTERVAL_MS;\n  let polls = 0;\n  let record = service.getRecord(id);\n  while (record && !TERMINAL_STATUSES.has(record.status) && polls < maxPolls) {\n    if (signal?.aborted) throw new Error('Maestria subagent call aborted');\n    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));\n    record = service.getRecord(id);\n    polls++;\n    if (sendUpdates) {\n      onUpdate?.({\n        content: [\n          {\n            type: 'text' as const,\n            text: `${label} running... (${Math.round((polls * POLL_INTERVAL_MS) / 1000)}s)`,\n          },\n        ],\n      });\n    }\n  }\n  if (record && !TERMINAL_STATUSES.has(record.status)) {\n    throw new Error(`Subagent ${id} timed out after ${POLL_TIMEOUT_MS}ms`);\n  }\n  if (!record) {\n    throw new Error(`Subagent ${id} was cleaned up before completion`);\n  }\n  return record;\n}\n\n// ── Handoff recording helper ────────────────────────────────────\n\nfunction recordAndPersist(\n  pi: ExtensionAPI,\n  state: MaestriaState,\n  agentName: string,\n  taskText: string,\n): void {\n  const updatedState = recordHandoff(state, 'orchestrator', agentName, taskText);\n  Object.assign(state, updatedState);\n  pi.appendEntry('maestria_state', state);\n}\n\nexport function installSubagentTool(\n  pi: ExtensionAPI,\n  state: MaestriaState,\n  cleanups?: Array<() => void>,\n): void {\n  pi.registerTool({\n    name: 'maestria_subagent',\n    label: 'Maestria Subagent',\n    description: 'Dispatch a task to a @maestria specialist subagent',\n    promptSnippet:\n      'Delegate tasks to @maestria specialist subagents (adventurer, architect, builder, planner, diagnose, reviewer, writer)',\n    promptGuidelines: [\n      'Use maestria_subagent when a task MUST be delegated to a specialist subagent rather than handled directly. Each specialist has focused capabilities: adventurer (recon), architect (design), builder (impl), planner (planning), diagnose (bugs), reviewer (QA), writer (docs).',\n    ],\n    prepareArguments(args: unknown) {\n      return args;\n    },\n    parameters: Type.Object({\n      agent: Type.Optional(Type.String({ description: 'Specialist agent name' })),\n      task: Type.Optional(Type.String({ description: 'Task description for the subagent' })),\n      tasks: Type.Optional(\n        Type.Array(\n          Type.Object({\n            agent: Type.String(),\n            task: Type.String(),\n          }),\n          { description: 'Array of task objects for parallel or chain dispatch' },\n        ),\n      ),\n      mode: Type.Optional(\n        Type.Union([Type.Literal('parallel'), Type.Literal('chain'), Type.Literal('single')]),\n      ),\n    }),\n    async execute(\n      _toolCallId: string,\n      params: {\n        agent?: string;\n        task?: string;\n        tasks?: Array<{ agent: string; task: string }>;\n        mode?: 'parallel' | 'chain' | 'single';\n      },\n      signal: AbortSignal | undefined,\n      onUpdate: ((result: { content: Array<{ type: string; text: string }> }) => void) | undefined,\n      _ctx: ExtensionContext,\n    ) {\n      // Block subagent dispatch when in review mode\n      if (state.reviewMode) {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: 'Subagent dispatch is not available during review mode. Use /restore-model to exit review mode first.',\n            },\n          ],\n        };\n      }\n\n      // Determine dispatch mode (default to 'single' for backward compat)\n      const mode = params.mode ?? 'single';\n\n      // Validate parameters based on mode\n      if (mode === 'single') {\n        assertValidAgent(params.agent!);\n        assertNonEmptyTask(params.task, 'Task description is required');\n      } else if (mode === 'parallel') {\n        if (!params.tasks || params.tasks.length < 2) {\n          throw new Error(`For parallel mode, tasks array is required with at least 2 items`);\n        }\n        if (params.tasks.length > MAX_PARALLEL_TASKS) {\n          throw new Error(\n            `For parallel mode, tasks array may have at most ${MAX_PARALLEL_TASKS} items (got ${params.tasks.length})`,\n          );\n        }\n        for (const t of params.tasks) {\n          assertValidAgent(t.agent);\n          assertNonEmptyTask(t.task, 'Task description is required for all tasks');\n        }\n      } else if (mode === 'chain') {\n        if (!params.tasks || params.tasks.length < 2) {\n          throw new Error('For chain mode, tasks array is required with at least 2 items');\n        }\n        for (const t of params.tasks) {\n          assertValidAgent(t.agent);\n          assertNonEmptyTask(t.task, 'Task description is required for all tasks');\n        }\n      }\n\n      // Attempt to dispatch via @gotgenes/pi-subagents; handle missing service\n      const { getSubagentsService } = await import('@gotgenes/pi-subagents');\n      const service = getSubagentsService();\n      if (!service || typeof service.spawn !== 'function') {\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: [\n                '## Subagent Dispatch Unavailable',\n                '',\n                'The `@gotgenes/pi-subagents` extension is required for subagent dispatch but has not been loaded.',\n                '',\n                'Install it as a Pi extension:',\n                '',\n                '```',\n                'pi install npm:@gotgenes/pi-subagents',\n                '```',\n                '',\n                'Then restart your Pi session.',\n              ].join('\\n'),\n            },\n          ],\n        };\n      }\n\n      try {\n        // --- SINGLE MODE ---\n        if (mode === 'single') {\n          const agent = params.agent!;\n          const task = params.task!;\n\n          // Spawn in foreground - returns subagent ID synchronously\n          const id = service.spawn(agent, task, {\n            description: task.slice(0, 80),\n            foreground: true,\n            inheritContext: true,\n          });\n\n          // Record handoff in state and persist (only after spawn succeeds)\n          recordAndPersist(pi, state, agent, task);\n\n          // Poll for completion\n          const record = await pollSubagent(\n            id,\n            `Subagent ${agent}`,\n            true,\n            service,\n            signal,\n            onUpdate,\n          );\n\n          const resultText = record.result ?? record.error ?? 'No output.';\n\n          return {\n            content: [{ type: 'text' as const, text: resultText }],\n            details: { subagentId: id },\n          };\n        }\n\n        // --- PARALLEL MODE ---\n        if (mode === 'parallel') {\n          const taskList = params.tasks!;\n\n          onUpdate?.({\n            content: [\n              { type: 'text' as const, text: `Spawning ${taskList.length} parallel subagents...` },\n            ],\n          });\n\n          // Spawn all tasks\n          const spawnedIds: string[] = [];\n          for (const t of taskList) {\n            const id = service.spawn(t.agent, t.task, {\n              description: t.task.slice(0, 80),\n              foreground: true,\n              inheritContext: true,\n            });\n            spawnedIds.push(id);\n\n            // Record each handoff\n            recordAndPersist(pi, state, t.agent, t.task);\n          }\n\n          // Poll all concurrently\n          const records = await Promise.all(\n            spawnedIds.map((id, i) =>\n              pollSubagent(\n                id,\n                `${taskList[i].agent} (${i + 1}/${taskList.length})`,\n                false,\n                service,\n                signal,\n                onUpdate,\n              ),\n            ),\n          );\n\n          onUpdate?.({\n            content: [\n              {\n                type: 'text' as const,\n                text: `All ${taskList.length} parallel subagents completed.`,\n              },\n            ],\n          });\n\n          // Aggregate results\n          const parts = [`## Parallel Results (${taskList.length} tasks)\\n`];\n          for (let i = 0; i < taskList.length; i++) {\n            const t = taskList[i];\n            const rec = records[i];\n            const resultText = rec.result ?? rec.error ?? 'No output.';\n            parts.push(`### ${i + 1}: ${t.agent}`);\n            parts.push(resultText);\n          }\n\n          return {\n            content: [{ type: 'text' as const, text: parts.join('\\n\\n') }],\n            details: { subagentIds: spawnedIds },\n          };\n        }\n\n        // --- CHAIN MODE ---\n        if (mode === 'chain') {\n          const taskList = params.tasks!;\n          let previousResult = '';\n\n          for (let i = 0; i < taskList.length; i++) {\n            const t = taskList[i];\n            let taskText = t.task;\n\n            // Substitute {previous} placeholder with previous result\n            if (i > 0 && taskText.includes('{previous}')) {\n              taskText = taskText.replace(/\\{previous\\}/g, previousResult);\n            }\n\n            const id = service.spawn(t.agent, taskText, {\n              description: taskText.slice(0, 80),\n              foreground: true,\n              inheritContext: true,\n            });\n\n            // Record handoff\n            recordAndPersist(pi, state, t.agent, taskText);\n\n            onUpdate?.({\n              content: [\n                {\n                  type: 'text' as const,\n                  text: `Chain step ${i + 1}/${taskList.length}: ${t.agent} running...`,\n                },\n              ],\n            });\n\n            // Poll for completion\n            const record = await pollSubagent(\n              id,\n              `Chain step ${i + 1}: ${t.agent}`,\n              true,\n              service,\n              signal,\n              onUpdate,\n            );\n\n            previousResult = record.result ?? record.error ?? 'No output.';\n\n            if (i < taskList.length - 1) {\n              onUpdate?.({\n                content: [\n                  {\n                    type: 'text' as const,\n                    text: `Chain step ${i + 1}/${taskList.length}: ${t.agent} completed. Moving to next step.`,\n                  },\n                ],\n              });\n            }\n          }\n\n          return {\n            content: [{ type: 'text' as const, text: previousResult }],\n            details: { subagentId: 'chain-completed' },\n          };\n        }\n\n        // Should not reach here - all modes are handled above\n        throw new Error('Unknown dispatch mode');\n      } catch (err) {\n        console.warn('[maestria] Subagent dispatch failed:', err);\n        // Return handoff payload as structured text when dispatch fails\n        const agentName = params.agent ?? params.tasks?.[0]?.agent ?? 'unknown';\n        const taskDesc = params.task ?? params.tasks?.map((t) => t.task).join('; ') ?? 'unknown';\n        const handoffInfo = [\n          `## Subagent Handoff Required`,\n          ``,\n          `**From:** orchestrator`,\n          `**To:** ${agentName}`,\n          `**Task:** ${taskDesc}`,\n          ``,\n          `Subagent dispatch failed. Please delegate this work manually.`,\n        ].join('\\n');\n\n        return {\n          content: [{ type: 'text' as const, text: handoffInfo }],\n        };\n      }\n    },\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  } as any); // TypeBox inferred types don't match ToolDefinition exactly\n\n  // Subscribe to subagent lifecycle events for accurate state tracking.\n  // These subscriptions are set up once at extension init, not on every tool call.\n  // pi.events is the shared EventBus - distinct from pi.on() lifecycle hooks.\n  if (pi.events) {\n    const unsubStarted = pi.events.on(SUBAGENT_EVENTS.STARTED, (data: unknown) => {\n      const { id, type } = data as { id: string; type: string };\n      state.subagentStatus[id] = { type, status: 'running', startedAt: Date.now() };\n      persistState(pi, state);\n      pi.events?.emit(MAESTRIA_EVENTS.SUBAGENT_STARTED, {\n        id,\n        type,\n        timestamp: Date.now(),\n      });\n    });\n\n    const unsubCompleted = pi.events.on(SUBAGENT_EVENTS.COMPLETED, (data: unknown) => {\n      const { id } = data as { id: string };\n      const existing = state.subagentStatus[id];\n      if (existing) {\n        existing.status = 'completed';\n        existing.completedAt = Date.now();\n      }\n      persistState(pi, state);\n      pi.events?.emit(MAESTRIA_EVENTS.SUBAGENT_COMPLETED, {\n        id,\n        type: existing?.type,\n        timestamp: Date.now(),\n      });\n    });\n\n    const unsubFailed = pi.events.on(SUBAGENT_EVENTS.FAILED, (data: unknown) => {\n      const { id, status } = data as { id: string; status: string };\n      const existing = state.subagentStatus[id];\n      if (existing) {\n        existing.status = status ?? 'error';\n        existing.completedAt = Date.now();\n      }\n      persistState(pi, state);\n      pi.events?.emit(MAESTRIA_EVENTS.SUBAGENT_FAILED, {\n        id,\n        type: existing?.type,\n        timestamp: Date.now(),\n      });\n    });\n\n    const unsubSteered = pi.events.on(SUBAGENT_EVENTS.STEERED, (data: unknown) => {\n      // Steering is informational - no status transition, but ensure\n      // the agent is tracked as running if it wasn't already observed.\n      const { id } = data as { id: string };\n      if (!state.subagentStatus[id]) {\n        state.subagentStatus[id] = { type: 'unknown', status: 'running', startedAt: Date.now() };\n      }\n      persistState(pi, state);\n    });\n\n    if (cleanups) {\n      cleanups.push(unsubStarted, unsubCompleted, unsubFailed, unsubSteered);\n    }\n  }\n}\n","import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport {\n  cycleToReviewModel,\n  persistState,\n  renderMaestriaSummary,\n  restoreOriginalState,\n} from '@/state.js';\nimport { MAESTRIA_EVENTS } from '@maestria/shared-pi/subagent-utils';\n\n/**\n * Read-only tools that let a reviewer inspect code without making changes.\n *\n * - `read`, `grep`, `find`, `ls`, `glob` - all non-destructive.\n * - Excluded: `bash`, `edit`, `write` - these can modify the filesystem.\n *\n * `glob` is included for file pattern matching even though it's not a\n * built-in Pi tool - extensions may register it, and including it is a no-op\n * if absent.\n */\nconst READ_ONLY_TOOLS = ['read', 'grep', 'find', 'ls', 'glob'];\n\nexport function installCommands(pi: ExtensionAPI, state: MaestriaState): void {\n  pi.registerCommand('maestria-status', {\n    description: 'Show current maestria session state including handoff history',\n    handler: async (_args: string, ctx) => {\n      const summary = renderMaestriaSummary(state);\n      if (!summary) {\n        ctx.ui.notify('No active maestria state to report.');\n        return;\n      }\n      ctx.ui.setEditorText(summary);\n    },\n  });\n\n  pi.registerCommand('review', {\n    description: 'Enter review mode. Blocks destructive tools, sets read-only toolset.',\n    handler: async (args: string, ctx) => {\n      if (!args.trim()) {\n        ctx.ui.notify('Usage: /review <target> - describe what to review');\n        return;\n      }\n\n      // 1. Save current model and tools for later restoration\n      const currentModelId = ctx.model?.id ?? null;\n      const currentTools = pi.getActiveTools();\n\n      // 2. Update state: mark review mode, store originals\n      const updatedState: MaestriaState = {\n        ...state,\n        reviewMode: true,\n        originalModel: currentModelId,\n        originalTools: currentTools,\n      };\n      Object.assign(state, updatedState);\n      persistState(pi, state);\n\n      // 3. Switch to review model if configured\n      if (state.reviewModel) {\n        const switched = await cycleToReviewModel(pi, ctx, state);\n        if (switched) {\n          ctx.ui.notify(`Review mode: switched to ${switched}`);\n          pi.events?.emit(MAESTRIA_EVENTS.REVIEW_ACTIVATED, {\n            originalModel: state.originalModel,\n            reviewModel: switched,\n            timestamp: Date.now(),\n          });\n        }\n      }\n\n      // 4. Restrict to read-only tools\n      pi.setActiveTools(READ_ONLY_TOOLS);\n\n      pi.sendUserMessage(\n        [\n          `[REVIEW: ${args}]`,\n          '',\n          `Review: ${args}. Use the reviewer prompt template.`,\n          'Read only, no edits, report findings.',\n        ].join('\\n'),\n        { deliverAs: 'steer' },\n      );\n    },\n  });\n\n  pi.registerCommand('restore-model', {\n    description:\n      'Restore the original model and tools that were active before review mode was entered.',\n    handler: async (_args: string, ctx) => {\n      if (!state.reviewMode) {\n        ctx.ui.notify('Not in review mode. Nothing to restore.');\n        return;\n      }\n      const prevOriginalModel = state.originalModel;\n      await restoreOriginalState(pi, ctx, state);\n      persistState(pi, state);\n      ctx.ui.notify('Restored original model and tools.');\n      pi.events?.emit(MAESTRIA_EVENTS.REVIEW_DEACTIVATED, {\n        originalModel: prevOriginalModel,\n        timestamp: Date.now(),\n      });\n    },\n  });\n\n  pi.registerCommand('handoff', {\n    description: 'Generate a structured handoff prompt for a new task context',\n    handler: async (args: string, ctx) => {\n      if (!args.trim()) {\n        ctx.ui.notify('Usage: /handoff <goal> - describe the task context for handoff');\n        return;\n      }\n\n      // Build a structured handoff document with 7 fields\n      const goal = args.trim();\n      const handoffPrompt = [\n        '**Goal:** ' + goal,\n        '',\n        '**Context:**',\n        '- Mode: ' + (state.mode ?? 'none'),\n        '- Active task: ' + (state.activeTask || 'none'),\n        '- Specialists delegated: ' +\n          ((state.specialistsDelegated?.length ?? 0) > 0\n            ? state.specialistsDelegated.join(', ')\n            : 'none'),\n        '- Recent handoffs: ' + (state.handoffHistory?.length ?? 0) + ' entries',\n        '- Files modified: ' +\n          ((state.filesModified?.length ?? 0) > 0 ? state.filesModified.join(', ') : 'none'),\n        '',\n        '**Requirements:**',\n        '(fill in specific requirements)',\n        '',\n        '**Known problems:**',\n        (state.blockers?.length ?? 0) > 0\n          ? state.blockers.map((b: string) => '- ' + b).join('\\n')\n          : '(no known problems documented)',\n        '',\n        '**Assumptions documented:**',\n        '(document assumptions made, tagged [inferred] where uncertain)',\n        '',\n        '**Success criteria:**',\n        '(fill in how to verify completion)',\n        '',\n        '**Next step:**',\n        '(fill in what happens after this task)',\n        '',\n        '---',\n        'Complete the fields above before sending.',\n      ].join('\\n');\n\n      // Record in state\n      state.handoffHistory = [\n        { from: 'current', to: 'next', task: goal, timestamp: Date.now() },\n        ...(state.handoffHistory ?? []),\n      ].slice(0, 5);\n\n      // Persist state\n      persistState(pi, state);\n\n      // Send as user message with steer delivery\n      pi.sendUserMessage(handoffPrompt, { deliverAs: 'steer' });\n    },\n  });\n\n  pi.registerCommand('review-model', {\n    description: 'Set which model to use when entering review mode',\n    handler: async (args: string, ctx) => {\n      if (!args.trim()) {\n        ctx.ui.notify('Usage: /review-model <model-id>');\n        return;\n      }\n      const modelId = args.trim();\n      const models = ctx.modelRegistry.getAll();\n      const model = models.find((m) => m.id === modelId);\n      if (!model) {\n        ctx.ui.notify(\n          `Unknown model: \"${modelId}\". Available: ${models.map((m) => m.id).join(', ')}`,\n        );\n        return;\n      }\n      state.reviewModel = modelId;\n      persistState(pi, state);\n      ctx.ui.notify(`Review model set to: ${modelId}`);\n    },\n  });\n}\n","/**\n * Shared tool interceptor utilities for Maestria platform packages.\n *\n * Pure TypeScript — no platform-specific dependencies.\n * Imported by both @maestria/omp and @maestria/pi to eliminate duplication.\n *\n * @module\n */\n\n/**\n * Dangerous bash command patterns that should always be blocked,\n * regardless of mode or specialist role.\n */\nexport const DANGEROUS_PATTERNS = [\n  /rm\\s+-rf\\s+\\//,\n  /dd\\s+if=/,\n  />\\s*\\/dev\\/sd/,\n  /chmod\\s+-R\\s+777\\s+\\//,\n  /mkfs\\.\\w+/,\n  /:(){ :\\|:& };:/,\n  />\\s*\\/etc\\/(passwd|shadow|sudoers)/,\n  /\\beval\\b/,\n  /wget\\s+-O\\s*-\\s*\\|\\s*(bash|sh)/,\n  /curl\\s+.*\\|\\s*(bash|sh)/,\n  /crontab\\s+-r/,\n];\n","import {\n  isToolCallEventType,\n  type ExtensionAPI,\n  type ToolCallEvent,\n  type ExtensionContext,\n} from '@earendil-works/pi-coding-agent';\nimport type { MaestriaState } from '@/state.js';\nimport { DANGEROUS_PATTERNS } from '@maestria/shared-pi/tools-core';\n\nexport function installToolInterceptors(pi: ExtensionAPI, state: MaestriaState): void {\n  pi.on('tool_call', async (event: ToolCallEvent, ctx: ExtensionContext) => {\n    if (!event || !event.toolName) return;\n\n    // ── Pure dispatcher enforcement ──\n    // When a maestria workflow mode is active, restrict the root session\n    // (orchestrator) to ONLY the maestria_subagent delegation tool.\n    // Subagent sessions are detected by the absence of the pi-subagents\n    // 'subagent' tool (stripped by applyRecursionGuard in child sessions).\n    if (state.mode !== null && pi.getActiveTools().includes('subagent')) {\n      if (event.toolName !== 'maestria_subagent') {\n        return {\n          block: true,\n          reason:\n            `Tool '${event.toolName}' is blocked for the orchestrator. ` +\n            `Use 'maestria_subagent' to delegate tasks to specialists.`,\n        };\n      }\n    }\n\n    // Block destructive tools in review mode\n    if (state.reviewMode) {\n      if (\n        isToolCallEventType('edit', event) ||\n        isToolCallEventType('write', event) ||\n        isToolCallEventType('bash', event)\n      ) {\n        return {\n          block: true,\n          reason: 'Review mode is active. Report findings, do not edit.',\n        };\n      }\n    }\n\n    // Block dangerous bash patterns regardless of mode\n    if (isToolCallEventType('bash', event)) {\n      if (!event.input || typeof event.input !== 'object') return undefined;\n      const command = event.input.command;\n      if (command) {\n        for (const pattern of DANGEROUS_PATTERNS) {\n          if (pattern.test(command)) {\n            if (ctx.hasUI) {\n              const confirmed = await ctx.ui.confirm(\n                'Dangerous Pattern Detected',\n                `This command matches a dangerous pattern:\\n${command}\\nProceed?`,\n              );\n              if (confirmed) return undefined;\n            }\n            return {\n              block: true,\n              reason: `Command matches dangerous pattern: ${pattern}`,\n            };\n          }\n        }\n      }\n    }\n\n    return undefined; // allow\n  });\n}\n","import type { ExtensionAPI, SessionStartEvent } from '@earendil-works/pi-coding-agent';\nimport { createInitialState } from '@/state.js';\nimport { deploySpecialistAgents } from '@/agents.js';\nimport { installModeCommands, installModeAutoDetect } from '@/modes.js';\nimport { createModePromptHandler } from '@/rules.js';\nimport { installCompactionHandlers } from '@/compaction.js';\nimport { installSubagentTool } from '@/subagent.js';\nimport { installCommands } from '@/commands.js';\nimport { installToolInterceptors } from '@/tools.js';\n\nexport default function (pi: ExtensionAPI): void {\n  const state = createInitialState();\n  const cleanups: Array<() => void> = [];\n\n  // Install mode commands: /fein, /sonar, /blitz\n  installModeCommands(pi, state);\n  installModeAutoDetect(pi, state);\n\n  // Inject mode prompt when a workflow mode is active\n  const handleModePrompt = createModePromptHandler(state);\n\n  pi.on('before_agent_start', (event, ctx) => {\n    return handleModePrompt(event, ctx);\n  });\n\n  // Deploy specialist agent files for pi-subagents discovery\n  pi.on('session_start', (_event: SessionStartEvent, ctx) => {\n    deploySpecialistAgents(ctx);\n\n    // Restore persisted state on session start (reload/resume/fork)\n    if (!ctx.sessionManager?.getEntries) return;\n    const entries = ctx.sessionManager.getEntries();\n    // Walk from newest to oldest, find the last persisted maestria_state entry\n    for (let i = entries.length - 1; i >= 0; i--) {\n      const entry = entries[i];\n      if (entry.type === 'custom' && entry.customType === 'maestria_state') {\n        const data = entry.data;\n        if (data && typeof data === 'object') {\n          Object.assign(state, data);\n        }\n        break;\n      }\n    }\n  });\n\n  // Install compaction preservation handlers\n  installCompactionHandlers(pi, state);\n\n  // Install orchestration hooks: subagent tool and commands\n  installSubagentTool(pi, state, cleanups);\n  installCommands(pi, state);\n\n  // Cleanup subscriptions on shutdown\n  pi.on('session_shutdown', () => {\n    for (const cleanup of cleanups) cleanup();\n    cleanups.length = 0;\n  });\n\n  // Install tool call interceptors for review mode and dangerous patterns\n  installToolInterceptors(pi, state);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maestria/pi",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Maestria extension for the Pi coding agent",
   "keywords": [
     "agent-orchestration",
@@ -31,7 +31,7 @@
     "@types/node": "^26",
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
-    "@maestria/shared-pi": "0.3.0"
+    "@maestria/shared-pi": "0.4.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",

package/skills/global-rules/SKILL.md

@@ -28,7 +28,7 @@ description: >-
 - **!!! Never delete what you didn't create** - If something exists and you want to change or remove it, adapt don't delete. Existing code is there for a reason, even if that reason isn't obvious. Deleting existing systems without understanding them is the #1 trust killer.
 - **Workflow modes** - `fein` explicitly requests the full production pipeline; `sonar` is research-only and does not implement; `blitz` is an explicit low-risk/direct bypass, not a license to skip safety floors. Honor an explicit user mode subject to safety constraints. Mode mechanics are not identical across platforms - do not claim platform guarantees that do not exist. See the orchestrator prompt for details.
 - **Never claim platform guarantees that do not exist** - tool enforcement, context isolation, and maker/checker separation vary by platform. State what is guaranteed versus advisory on the platform you run.
-- **Project `.maestria/`** - `.maestria/workflow.md` and `.maestria/rules.md` in the project root define project-specific workflow sequencing and non-negotiable rules. The orchestrator loads them on start; rules are propagated to all agents via delegation prompts. See the orchestrator prompt for details.
+- **Project `.maestria/`** - `.maestria/workflow.md` and `.maestria/rules.md` in the project root define project-specific workflow sequencing and non-negotiable rules. The orchestrator loads them once per session when needed and reuses the context; rules are propagated to routed agents via delegation prompts. See the orchestrator prompt for details.
 
 ### Tool Routing
 

package/skills/handoff/SKILL.md

@@ -22,4 +22,6 @@ A handoff must always include these 7 fields:
 6. **Success criteria** - How to verify the work is done
 7. **Next step** - What happens after this task completes
 
-Every handoff ends with: "If anything is unclear or ambiguous, ask before proceeding."
+Keep values concise: reference paths, outputs, and prior decisions instead of copying history. Include material information only, and write `none` where a field does not apply.
+
+Every handoff ends with: "If anything is unclear or ambiguous, exhaust available data, document the assumption, and proceed."

package/skills/orchestrator/SKILL.md

@@ -25,7 +25,7 @@ Apply on every invocation unless overridden (see below):
 2. **!!! Git mutations scoped by route** - focused/full routed work delegates commit validation and execution to `/builder`. Direct turns run git on the host: validate, stage only intended files, run required checks, and preserve user authorization before committing. Branch discipline and no-main protections still apply.
 3. **!!! Atomic delegation** - one concern per delegation. Never bundle unrelated work.
 4. **!!! Pure router on routed turns** - produce no artifacts. Output is delegation context, not the product. Direct turns produce their own output.
-5. **!!! Maker/checker split** - writer must not QA. In focused and full routes, every `/builder` code change is followed by `/reviewer`; the reviewer is never the agent that implemented. Where the host cannot enforce separate sessions (e.g. Kimi, Pi, OMP, Hermes), the split is advisory - state the limitation, do not claim enforcement.
+5. **!!! Maker/checker split** - writer must not QA. In focused routes, non-trivial `/builder` work gets one `/reviewer` pass; in full routes, every `/builder` code change is followed by `/reviewer`. The reviewer is never the agent that implemented. Where the host cannot enforce separate sessions (e.g. Kimi, Pi, OMP, Hermes), the split is advisory - state the limitation, do not claim enforcement.
 6. **!!! Ship docs with code** - docs audit (Commit Protocol step 2) before every commit. Non-negotiable.
 7. **!!! Don't anthropomorphize effort** - delegate at machine scale. Choose by trade-off, not perceived effort.
 8. **!!! Set iteration limits** - define max rounds and termination condition. Prevents agent ping-pong.
@@ -51,22 +51,17 @@ Even when overriding, still document the override and why. Transparency > strict
 
 ### Selective Routing
 
-Pick a route per turn. The full pipeline is an explicit option for complex or high-risk work and for explicit `fein` requests - it is not the universal default. If model economics are unknown, prefer `direct` or `focused`; do not default to full fan-out.
+Pick the first applicable route below after applying explicit mode overrides and safety exceptions. The full pipeline is not the universal default.
 
-| Route | What happens | Default for |
+| Route | Trigger | What happens |
 | --- | --- | --- |
-| `direct` | The host executes the turn. No Maestria specialist spawn. If the host cannot safely execute, use the platform's native build/direct capability or switch to focused/full. | Explanation, discovery, tiny edits, familiar low-risk changes |
-| `focused` | One targeted specialist. One `/reviewer` for non-trivial work. | Ordinary code changes, discovery in unfamiliar code |
-| `full` | Bounded recon, design, implementation, and review. Independent review where the host supports it. | Complex or high-risk work; explicit `fein` |
+| `full` | Explicit `fein`; two or more primary specialist outputs (the focused route's mandatory independent reviewer pass does not count); cross-package or cross-cutting work; complex or high-risk work; unclear requirements that need design plus implementation | Bounded recon, design, implementation, and the automatic review loop |
+| `focused` | One targeted specialist owns the required output, including one bounded implementation or investigation | One specialist; one independent review for non-trivial `/builder` work |
+| `direct` | Explanation, discovery without codebase work, or a tiny familiar low-risk change with no specialist output | Host executes; no Maestria specialist or automatic review |
 
-**Route by task class:**
+Safety exceptions override `direct` and `blitz`: security, auth, permissions, data migrations or loss, production impact, irreversible changes, and unresolved safety ambiguity require at least `focused`, or `full` when cross-cutting or high-risk. Ask the user where the project rules require a checkpoint. If classification is otherwise uncertain, choose `focused` and review.
 
-| Task class | Default route | Escalate to |
-| --- | --- | --- |
-| Explanation or discovery | `direct` for explanation. One targeted specialist (`/adventurer`, `/diagnose`, `/architect`) only when codebase exploration is genuinely needed. | `focused`. Never `full` by default. |
-| Tiny edit | `direct` or native builder. No automatic recon or review. | Security, migrations, permissions, production impact, or ambiguity. |
-| Ordinary code change | `focused`: one specialist; one reviewer for non-trivial work. | `full` when the change spans packages, has unclear requirements, or carries real risk. |
-| Complex or high-risk | `full` with independent review where the host supports it. | A second review or more planning only when new risk appears. |
+**Focused `/builder` review threshold:** Treat work as non-trivial when it changes behavior, changes a public interface or configuration, touches multiple production files, or involves data, auth, or security. These cases get one independent focused `/reviewer` pass. Docs-only changes, formatting or comments, test fixtures, and one-file mechanical non-behavioral edits do not automatically require review. If the classification remains uncertain, review.
 
 **Scaling guardrails** (bounds, not measured savings):
 
@@ -75,32 +70,34 @@ Pick a route per turn. The full pipeline is an explicit option for complex or hi
 | Child spawns | 0 | 1-2 | up to existing caps | one sequential path |
 | Review | none | 1 pass on non-trivial work | existing max 3 cycles | 1 pass, then fail loud |
 | Architect/planner | not used | only when design is the task | as the task demands | folded into one delegation |
-| Parallel fan-out | 0 | 1-2 | 3-5 | 0-1 |
+| Parallel fan-out | 0 | 1-2 | one general reviewer plus only risk-matched lenses | one general reviewer plus only risk-matched lenses |
 | Context compaction | none | as the session grows | as the session grows | aggressive; briefings over history |
 
 ### Specialist Table
 
-Route the concern to the specialist that owns it. Avoid builder bias - touch code only after recon, design, planning, diagnosis, or review are complete.
+Route the concern to the specialist that owns it. Direct `/builder` delegation is allowed for concrete atomic work with no identified uncertainty. Add prerequisite specialists only for identified investigation, decision, or diagnosis needs.
 
 | Agent | Role | Delegate when you see |
 | --- | --- | --- |
 | `/adventurer` | Codebase reconnaissance, deep code understanding | "how does X work", "where is Y", "trace Y", "map module", "find all places"; unfamiliar code recon |
 | `/architect` | Architecture decisions, trade-off analysis, ADRs | "should we use X or Y", "trade-off", "design decision", "evaluate options", "ADR" |
-| `/builder` | Focused implementation, single-task execution | Concrete, scoped, atomic task with recon/design already done; feature slice, bug fix, test, refactor |
+| `/builder` | Focused implementation, single-task execution | Concrete, scoped, atomic task with no identified uncertainty; feature slice, bug fix, test, refactor |
 | `/diagnose` | Systematic bug tracing, root cause analysis | "bug", "regression", "broken", "failing test", "crash", "why is X happening" |
 | `/planner` | Implementation plans with phased milestones | "multi-phase feature", "rollout plan", "migration plan", "phased implementation" |
 | `/reviewer` | Code review with quality gates | "review PR", "check changes", "before commit", "QA"; post-implementation validation |
 | `/writer` | Documentation following structured patterns | "document this", "write README", "changelog", "API docs", "explain in prose" |
 
-Delegate to `/builder` ONLY when the task is concrete, atomic, free of design ambiguity, and recon/design is already complete.
+Delegate to `/builder` when the task is concrete, atomic, and free of identified uncertainty. Add recon, architecture, or diagnosis first only when the task identifies a need for that specialist's output.
 
 ### Complexity Classification
 
-| Classification | Default route | User questions |
-| --- | --- | --- |
-| **SIMPLE** | `direct` or `focused` - known files, obvious change, no automatic recon or review | No questions - proceed on existing patterns |
-| **COMPLEX** | `focused` or `full` - unfamiliar or cross-cutting work | No questions - architect exhausts data and documents assumptions. Ask user only for irreversible decisions |
-| **EXPERIMENT** | `focused` with explicit hypothesis and termination condition set upfront | Output is a validated (or invalidated) claim, not shipped code |
+Use these classifications to describe the level of uncertainty and interaction. They do not choose a route or override the Selective Routing trigger table above; apply that table after classifying the work.
+
+| Classification | Uncertainty and interaction |
+| --- | --- |
+| **SIMPLE** | Known files, obvious change, and low uncertainty or interaction. Proceed on existing patterns. |
+| **COMPLEX** | Unfamiliar, cross-cutting, or high-uncertainty work. Gather sufficient evidence and document assumptions. Ask the user only for irreversible decisions. |
+| **EXPERIMENT** | Work with an explicit hypothesis and termination condition set upfront. The output is a validated (or invalidated) claim, not shipped code. |
 
 ## Role-Based Pipeline
 
@@ -118,7 +115,7 @@ The role pipeline is the shape of `full` routes and multi-specialist `focused` r
 
 ### Automatic Review Loop
 
-In `focused` and `full` routes, after every `/builder` task, run the review loop automatically. Direct routes run no automatic review loop.
+In `focused` routes, run one independent `/reviewer` pass for non-trivial `/builder` work. In `full` routes, after every `/builder` task, run the review loop automatically. Direct routes run no automatic review loop.
 
 1. **Build** - run validation (checks, tests) via `/builder`.
 2. **Review** - dispatch `/reviewer` for quality review.
@@ -138,25 +135,25 @@ Need: user override to ship as-is, or architect redesign.
 
 After max 3 cycles with only `[dismiss]` and `[escalate]` items remaining, the pipeline terminates normally (`[escalate]` items are surfaced to the user; `[dismiss]` items are documented).
 
-### Multi-Lens Review Swarm
+### Risk-Matched Full Review
 
-In the `full` route, for non-trivial changes, fan out parallel `/reviewer` passes:
+In the `full` route, after every `/builder` task, dispatch one independent general `/reviewer`. Add a specialist lens only when the requirements or diff show a matching risk:
 
-- **When to use:** multi-concern, security-sensitive, performance-critical, or large diffs.
-- **Dispatch:** 3-5 parallel lenses: security, architecture, performance, UX, general.
-- **Lens exclusivity:** one reviewer per lens per change.
-- **Model diversity:** assign different models/sizes when supported.
+- security for auth, permissions, secrets, or data exposure risks;
+- performance for measured or clearly plausible bottlenecks;
+- architecture for module boundaries, dependency direction, or interface risks;
+- UX for user-facing interaction, accessibility, or responsive behavior risks.
 
-On expensive/slow models, prefer one review pass per the scaling guardrails instead of a swarm.
+Do not dispatch unrelated specialist lenses or expand to a generic 3-5 lens swarm. Lens exclusivity and blind review still apply; assign model diversity only when supported and useful.
 
 ### Review Triage
 
-After all lens reviews return:
+After the general review and any risk-matched lens reviews return:
 
 1. **Collect & Deduplicate** - aggregate findings across lenses.
 2. **Categorize:** `[fix]` -> `/builder`; `[dismiss]` -> comment; `[escalate]` -> flag to user. `fix` beats `dismiss` on conflict. Any `[escalate]` triggers escalation. Items whose fixability is unclear are `[fix]`; items confirmed non-fixable are `[dismiss]`.
 3. **Iterate** - re-review after fixes. Max 3 iterations or until only dismiss/escalate remain.
-4. **Terminate** - pipeline complete when all lenses pass or only non-actionable items remain.
+4. **Terminate** - pipeline complete when the general review and all dispatched risk-matched lenses pass or only non-actionable items remain.
 5. **Commit** - After review approval (no `[fix]` or `[escalate]` items remain), proceed to commit per the Commit Protocol. The review verdict replaces the Commit Protocol's "Stop & Report" step - chain directly into the commit flow. If `[escalate]` items remain, surface them using the escalation format from rules.md and await user resolution before proceeding.
 
 ## Delegation Pattern
@@ -190,15 +187,7 @@ Before delegating to reviewer, verify the access list does not contain biasing b
 
 ### Cognitive Hygiene
 
-Before delegating, check for low-agency traps:
-
-1. **Vague** - "Figure out X" without success definition. Escape: specify output + acceptance criteria.
-2. **Midwit** - Overcomplicating when simpler would work. Escape: simplest possible delegation?
-3. **Attachment** - Assuming current approach because it's familiar. Escape: delegate from zero knowledge?
-4. **Rumination** - Endlessly refining instead of dispatching. Escape: dispatch at reasonable confidence, iterate.
-5. **Overwhelm** - Task too large as one piece. Escape: smallest verifiable slice first.
-
-Most delegation failures come from these traps, not the specialist.
+Before delegating, choose the smallest verifiable delegation with a clear output and acceptance criteria, dispatch at reasonable confidence, and iterate only when evidence requires it.
 
 ### Outcome Specs Over Activity Specs
 
@@ -208,13 +197,13 @@ Specify **what** to achieve, not **how**. Activity specs constrain judgment and
 
 ### Parallel Fan-Out
 
-Delegate independent tasks in parallel, scaled to the route: `focused` 1-2, `full` up to 3-5 on cheap/fast models and 0-1 on expensive/slow models. These are guardrails, not measured savings.
+Delegate independent tasks in parallel, scaled to the route: `focused` 1-2; `full` one general reviewer plus only risk-matched lenses. These are guardrails, not measured savings.
 
 - **Pure recon/design:** recon + architect same turn.
 - **Mixed:** recon + implement + validate one turn.
-- **Multi-lens:** parallel review swarm.
+- **Risk-matched review:** general review plus only applicable specialist lenses.
 - **Parallel branches:** ask user before creating multiple branches. Don't proceed without confirmation.
-- **Parallel speculation:** dispatch same question to multiple specialists with different lenses, synthesize results.
+- **Parallel speculation:** dispatch the same question to multiple specialists only for distinct required outputs, then synthesize results.
 
 ## COMMIT PROTOCOL
 
@@ -255,7 +244,7 @@ Modes override the default route for one turn. A mode keyword in your message ac
 | Mode | Route | When to use |
 | --- | --- | --- |
 | `fein` | `full` - Thinker -> Worker -> Verifier (dynamic role pipeline) | Explicit request for the full production pipeline: complex, high-risk, or production-grade work |
-| `sonar` | Research only - `/adventurer` -> `/architect`/`/planner` -> STOP | Discovery, research, feasibility. Does not implement |
+| `sonar` | Research only - owning specialist -> optional distinct specialist -> STOP | Discovery, research, feasibility. Does not implement |
 | `blitz` | `direct` bypass for low-risk work | Quick fixes, prototypes, known territory |
 
 Mode semantics:
@@ -272,7 +261,7 @@ Mode semantics:
 
 Projects can define custom workflow instructions in `.maestria/workflow.md` (relative to project root). This file tells the orchestrator how to sequence delegation for this project.
 
-**Loading:** When starting on a project, delegate to `/adventurer` to check for `.maestria/workflow.md`. If it exists, read and report its contents. If `.maestria/rules.md` exists, read that too - these are project-specific `!!!` rules that supplement the core rules.
+**Loading:** Load `.maestria/workflow.md` and `.maestria/rules.md` once per session when not already present, reusing context already in the session. For a routed task started without that context, the relevant specialist may load and report it; never add `/adventurer` solely for a direct turn.
 
 **Usage:** Include relevant workflow context in the access list and context sections of each delegation prompt. When `.maestria/rules.md` is present, include its contents in the Known Problems section to ensure subagents follow project-specific constraints.
 
@@ -304,39 +293,19 @@ Mandatory after every builder task that lands a code change (see CRITICAL RULE #
 
 ## Session Flow
 
-After each task:
+During active multi-step routed work:
 
-1. Update the todo list - mark done, check pending items.
-2. Propose the next step - if items remain, suggest the next one. Do not wait for the user to remember.
-3. If nothing is pending, summarize what was accomplished and ask "Is there anything else?".
-4. **!!! Recognize user frustration** - if the user rejects your work twice in a row, stop and re-evaluate. Do not keep iterating in the same direction. Escalate with what was tried, what failed, and what you need to proceed.
+1. Use only these material checkpoint events for progress updates: route selected; delegation completed, blocked, or failed; verification result; review verdict; commit, push, or PR result.
+2. At a checkpoint, update the todo list - mark done and check pending items.
+3. At a checkpoint, propose the next step when items remain.
+4. If nothing is pending, summarize what was accomplished. Routine reads, searches, and tool calls that do not change the plan do not require a checkpoint or user-facing update. Simple and direct turns report the outcome without a next-step prompt or invitation for more work.
+5. **!!! Recognize user frustration** - if the user rejects your work twice in a row, stop and re-evaluate. Do not keep iterating in the same direction. Escalate with what was tried, what failed, and what you need to proceed.
 
 ## Skills for Subagents
 
 Skill loading is trigger-based, scoped to the selected route and task class.
 
-**Your own loads:** `humanizer` always - you write user-facing text. Do not load architecture, planning, review, or documentation skills for a `direct` turn that does not use those roles.
-
-**Routed turns:** subagents start with zero skills - the delegation prompt is the only conduit for skill loading. Include the skill names matching the specialist's role in the delegation prompt; the specialist loads its prescription.
-
-**Proactive path (before every delegation):**
-
-- Read skill prescription (always-load + load-on-trigger matching the task).
-- Verify availability. Install missing always-load skills automatically.
-- Include skill names in delegation prompt for subagent to load.
-- Require acknowledgement in handoff - missing acknowledgement means skills likely not loaded.
-
-**Reactive path (mid-task):**
-
-- Subagent suggests uninstalled skill? Surface via user question. Never install silently.
-- User declines? Spawn subagent anyway - it degrades gracefully and flags missing skill in handoff. Never re-ask.
-
-**Guard rails:**
-
-- Check tool help before installs (don't memorize flags).
-- Install directly - do NOT delegate to `/builder`.
-- Scan available skills for un-prescribed matches.
-- **Miss handling:** Subagent can't find a skill? Install reactively and log. Repeated misses mean prescription needs updating.
+**Routed turns:** subagents start with zero skills - the delegation brief is the conduit for skill loading. Name the role-prescribed and task-relevant skills in the brief; the specialist loads them. Do not add a separate skill-management step unless the task itself calls for it.
 
 ## Human-in-the-Loop