@haoyiyin/workflow 0.2.0

package/dist/src/index.js

@@ -0,0 +1,41 @@
+/**
+ * yi-workflow - Production workflow skills for coding agents
+ *
+ * Core Architecture:
+ * 1. Main Agent = Orchestrator only (NEVER executes work)
+ * 2. Router = Classifies ALL user input and dispatches to subagents
+ * 3. Subagents = Do ALL actual work
+ * 4. Guard = Enforces Main Agent never does prohibited operations
+ */
+// Export hooks
+export { HookManager, createHookManager } from './hooks/manager.js';
+export { HookLoader, createHookLoader } from './hooks/loader.js';
+// Export state
+export { StateManagerImpl, createStateManager } from './state/manager.js';
+export { FilePersistence, createPersistence } from './state/persistence.js';
+export { validateState, isValidState, sanitizeState } from './state/validator.js';
+export { cleanupOldStates, cleanupEmptyDirs, getStateStats } from './state/cleanup.js';
+// Export skills
+export { Skill } from './skills/skill.js';
+export { Registry, createRegistry } from './skills/registry.js';
+export { toPlanSkill } from './skills/to-plan/index.js';
+export { executePlanSkill } from './skills/execute-plan/index.js';
+export { quickTaskSkill } from './skills/quick-task/index.js';
+export { reviewDiffSkill } from './skills/review-diff/index.js';
+export { tddSkill } from './skills/tdd/index.js';
+export { systematicDebuggingSkill } from './skills/systematic-debugging/index.js';
+export { agentsMdSkill } from './skills/agents-md/index.js';
+// Export agents - dispatcher
+export { SubagentDispatcher, createDispatcher, createProcessExecutor } from './agents/dispatcher.js';
+// Export agents - contracts
+export { explorerContract, implementerContract, reviewerContract, debuggerContract, verifierContract, } from './agents/contracts.js';
+// Export router
+export { createRouter } from './router/router.js';
+export { ROUTE_KEYWORDS, MAIN_AGENT_PROHIBITED } from './router/types.js';
+// Export guard
+export { createMainAgentGuard } from './guard/main-agent.js';
+// Export utils
+export { createLogger } from './utils/logger.js';
+export { getCurrentBranch, getBaseBranch, isWorktree } from './utils/git.js';
+export { getPlansPath, getStatePath } from './utils/paths.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAQhE,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACjF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOtF,gBAAgB;AAChB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAQ3D,6BAA6B;AAC7B,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAkBpG,4BAA4B;AAC5B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,uBAAuB,CAAA;AAS9B,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAYzE,eAAe;AACf,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAQ5D,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/src/persistence/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Persistence layer exports
+ */
+export { StateMdManager } from './state-md.js';
+export { PlanMdManager } from './plan-md.js';
+export type { Task, Wave, Plan, TaskResult, VerificationResult, DimensionResult, WorkflowState, StateMdManager as IStateMdManager, PlanMdManager as IPlanMdManager, PersistenceManager } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/persistence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/persistence/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,YAAY,EACV,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,cAAc,IAAI,eAAe,EACjC,aAAa,IAAI,cAAc,EAC/B,kBAAkB,EACnB,MAAM,YAAY,CAAA"}

package/dist/src/persistence/index.js

@@ -0,0 +1,6 @@
+/**
+ * Persistence layer exports
+ */
+export { StateMdManager } from './state-md.js';
+export { PlanMdManager } from './plan-md.js';
+//# sourceMappingURL=index.js.map

package/dist/src/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/persistence/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/src/persistence/plan-md.d.ts

@@ -0,0 +1,11 @@
+import type { Plan, PlanMdManager as IPlanMdManager } from './types.js';
+export declare class PlanMdManager implements IPlanMdManager {
+    private planPath;
+    constructor(planPath?: string);
+    writePlan(plan: Plan): Promise<void>;
+    readPlan(): Promise<Plan>;
+    updateTaskStatus(taskId: string, status: 'pending' | 'in_progress' | 'complete'): Promise<void>;
+    private generatePlanMarkdown;
+    private parsePlan;
+}
+//# sourceMappingURL=plan-md.d.ts.map

package/dist/src/persistence/plan-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-md.d.ts","sourceRoot":"","sources":["../../../src/persistence/plan-md.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAQ,aAAa,IAAI,cAAc,EAAE,MAAM,YAAY,CAAA;AAE7E,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,QAAQ,GAAE,MAA4B;IAI5C,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrG,OAAO,CAAC,oBAAoB;IA+B5B,OAAO,CAAC,SAAS;CAwElB"}

package/dist/src/persistence/plan-md.js

@@ -0,0 +1,125 @@
+/**
+ * PLAN.md manager for execution plan persistence
+ */
+import { promises as fs } from 'fs';
+import { dirname } from 'path';
+export class PlanMdManager {
+    planPath;
+    constructor(planPath = '.pi/state/PLAN.md') {
+        this.planPath = planPath;
+    }
+    async writePlan(plan) {
+        // Ensure directory exists
+        await fs.mkdir(dirname(this.planPath), { recursive: true });
+        const content = this.generatePlanMarkdown(plan);
+        await fs.writeFile(this.planPath, content, 'utf-8');
+    }
+    async readPlan() {
+        const content = await fs.readFile(this.planPath, 'utf-8');
+        return this.parsePlan(content);
+    }
+    async updateTaskStatus(taskId, status) {
+        const content = await fs.readFile(this.planPath, 'utf-8');
+        const statusChar = status === 'complete' ? 'x' : status === 'in_progress' ? '~' : ' ';
+        const updated = content.replace(new RegExp(`- \\[.] ${taskId}:`), `- [${statusChar}] ${taskId}:`);
+        await fs.writeFile(this.planPath, updated, 'utf-8');
+    }
+    generatePlanMarkdown(plan) {
+        return `# Execution Plan
+
+## Goal
+${plan.goal}
+
+## Tasks
+${plan.tasks.map(t => `- [ ] ${t.id}: ${t.description} (${t.estimatedComplexity})`).join('\n')}
+
+## Dependencies
+${Object.entries(plan.dependencies).length > 0
+            ? Object.entries(plan.dependencies).map(([task, deps]) => `- ${task}: ${deps.join(', ')}`).join('\n')
+            : '- No dependencies'}
+
+## Waves
+${plan.waves.map(w => `- ${w.id}: ${w.tasks.join(', ')}`).join('\n')}
+
+## Verification Criteria
+${plan.verificationCriteria.map(c => `- ${c}`).join('\n')}
+
+## Estimated Effort
+- Total Tasks: ${plan.tasks.length}
+- Parallel Waves: ${plan.waves.length}
+- Estimated Duration: ${plan.estimatedDuration}ms
+
+## Rationale
+${plan.rationale}
+`;
+    }
+    parsePlan(content) {
+        const goalMatch = content.match(/## Goal\n(.+)/);
+        const tasksMatch = content.match(/## Tasks\n([\s\S]*?)(?=\n## |$)/);
+        const depsMatch = content.match(/## Dependencies\n([\s\S]*?)(?=\n## |$)/);
+        const wavesMatch = content.match(/## Waves\n([\s\S]*?)(?=\n## |$)/);
+        const criteriaMatch = content.match(/## Verification Criteria\n([\s\S]*?)(?=\n## |$)/);
+        const durationMatch = content.match(/- Estimated Duration: (\d+)/);
+        const rationaleMatch = content.match(/## Rationale\n([\s\S]*?)(?=\n## |$)/);
+        // Parse tasks
+        const tasks = [];
+        if (tasksMatch) {
+            const taskLines = tasksMatch[1].split('\n').filter(l => l.trim().startsWith('- ['));
+            for (const line of taskLines) {
+                const match = line.match(/- \[[x\s~]]\s+(\w+):\s+(.+)\s+\((\w+)\)/);
+                if (match) {
+                    tasks.push({
+                        id: match[1],
+                        description: match[2],
+                        estimatedComplexity: match[3]
+                    });
+                }
+            }
+        }
+        // Parse dependencies
+        const dependencies = {};
+        if (depsMatch && depsMatch[1].trim() !== '- No dependencies') {
+            const depLines = depsMatch[1].split('\n').filter(l => l.trim().startsWith('- '));
+            for (const line of depLines) {
+                const match = line.match(/- (\w+):\s*(.+)/);
+                if (match) {
+                    dependencies[match[1]] = match[2].split(',').map(s => s.trim()).filter(s => s);
+                }
+            }
+        }
+        // Parse waves
+        const waves = [];
+        if (wavesMatch) {
+            const waveLines = wavesMatch[1].split('\n').filter(l => l.trim().startsWith('- '));
+            for (const line of waveLines) {
+                const match = line.match(/- (\w+):\s*(.+)/);
+                if (match) {
+                    waves.push({
+                        id: match[1],
+                        tasks: match[2].split(',').map(s => s.trim()).filter(s => s)
+                    });
+                }
+            }
+        }
+        // Parse verification criteria
+        const verificationCriteria = [];
+        if (criteriaMatch) {
+            const criteriaLines = criteriaMatch[1].split('\n').filter(l => l.trim().startsWith('- '));
+            for (const line of criteriaLines) {
+                const criterion = line.replace(/^- /, '').trim();
+                if (criterion)
+                    verificationCriteria.push(criterion);
+            }
+        }
+        return {
+            goal: goalMatch?.[1] || '',
+            tasks,
+            dependencies,
+            waves,
+            verificationCriteria,
+            estimatedDuration: durationMatch ? parseInt(durationMatch[1], 10) : 0,
+            rationale: rationaleMatch?.[1]?.trim() || ''
+        };
+    }
+}
+//# sourceMappingURL=plan-md.js.map

package/dist/src/persistence/plan-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-md.js","sourceRoot":"","sources":["../../../src/persistence/plan-md.ts"],"names":[],"mappings":"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"}

package/dist/src/persistence/state-md.d.ts

@@ -0,0 +1,17 @@
+import type { WorkflowState, Plan, TaskResult, VerificationResult, StateMdManager as IStateMdManager } from './types.js';
+export declare class StateMdManager implements IStateMdManager {
+    private statePath;
+    constructor(statePath?: string);
+    initialize(goal: string): Promise<void>;
+    updatePhase(phase: WorkflowState['phase']): Promise<void>;
+    recordPlan(plan: Plan): Promise<void>;
+    recordTaskComplete(taskId: string, result: TaskResult): Promise<void>;
+    recordVerification(verification: VerificationResult): Promise<void>;
+    readCurrentState(): Promise<WorkflowState>;
+    private formatPlanSection;
+    private formatVerificationSection;
+    private replaceSection;
+    private appendToSection;
+    private parseState;
+}
+//# sourceMappingURL=state-md.d.ts.map

package/dist/src/persistence/state-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-md.d.ts","sourceRoot":"","sources":["../../../src/persistence/state-md.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,YAAY,CAAA;AAExH,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,SAAS,CAAQ;gBAEb,SAAS,GAAE,MAA6B;IAI9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCvC,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzD,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrE,kBAAkB,CAAC,YAAY,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAKhD,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,yBAAyB;IAkBjC,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,UAAU;CA2BnB"}

package/dist/src/persistence/state-md.js

@@ -0,0 +1,143 @@
+/**
+ * STATE.md manager for workflow state persistence
+ */
+import { promises as fs } from 'fs';
+import { dirname } from 'path';
+export class StateMdManager {
+    statePath;
+    constructor(statePath = '.pi/state/STATE.md') {
+        this.statePath = statePath;
+    }
+    async initialize(goal) {
+        // Ensure directory exists
+        await fs.mkdir(dirname(this.statePath), { recursive: true });
+        const content = `# Workflow State
+
+## Goal
+${goal}
+
+## Status
+- Phase: planning
+- Started: ${new Date().toISOString()}
+- Last Updated: ${new Date().toISOString()}
+
+## Plan
+<!-- Populated by plan skill -->
+
+## Completed Tasks
+<!-- Updated during execution -->
+
+## Verification Results
+<!-- Populated by verify phase -->
+
+## Token Usage
+- Plan Phase: 0
+- Execute Phase: 0
+- Verify Phase: 0
+- Total: 0 / 1000000
+`;
+        await fs.writeFile(this.statePath, content, 'utf-8');
+    }
+    async updatePhase(phase) {
+        const content = await fs.readFile(this.statePath, 'utf-8');
+        const updated = content.replace(/- Phase: .*/, `- Phase: ${phase}`).replace(/- Last Updated: .*/, `- Last Updated: ${new Date().toISOString()}`);
+        await fs.writeFile(this.statePath, updated, 'utf-8');
+    }
+    async recordPlan(plan) {
+        const content = await fs.readFile(this.statePath, 'utf-8');
+        const planSection = this.formatPlanSection(plan);
+        const updated = this.replaceSection(content, 'Plan', planSection);
+        await fs.writeFile(this.statePath, updated, 'utf-8');
+    }
+    async recordTaskComplete(taskId, result) {
+        const content = await fs.readFile(this.statePath, 'utf-8');
+        const entry = `- [x] ${taskId}: ${result.success ? '✓' : '✗'} (${result.duration}ms) - ${result.notes || ''}\n`;
+        const updated = this.appendToSection(content, 'Completed Tasks', entry);
+        await fs.writeFile(this.statePath, updated, 'utf-8');
+    }
+    async recordVerification(verification) {
+        const content = await fs.readFile(this.statePath, 'utf-8');
+        const verificationSection = this.formatVerificationSection(verification);
+        const updated = this.replaceSection(content, 'Verification Results', verificationSection);
+        await fs.writeFile(this.statePath, updated, 'utf-8');
+    }
+    async readCurrentState() {
+        const content = await fs.readFile(this.statePath, 'utf-8');
+        return this.parseState(content);
+    }
+    formatPlanSection(plan) {
+        return `
+### Goal
+${plan.goal}
+
+### Tasks (${plan.tasks.length})
+${plan.tasks.map(t => `- ${t.id}: ${t.description} (${t.estimatedComplexity})`).join('\n')}
+
+### Waves (${plan.waves.length})
+${plan.waves.map(w => `- ${w.id}: ${w.tasks.join(', ')}`).join('\n')}
+
+### Verification Criteria
+${plan.verificationCriteria.map(c => `- ${c}`).join('\n')}
+
+### Estimated Duration
+${plan.estimatedDuration}ms
+
+### Rationale
+${plan.rationale}
+`;
+    }
+    formatVerificationSection(verification) {
+        const results = [];
+        if (verification.dimensions.goals) {
+            results.push(`- Goals: ${verification.dimensions.goals.success ? '✓ PASS' : '✗ FAIL'}`);
+        }
+        if (verification.dimensions.quality) {
+            results.push(`- Quality: ${verification.dimensions.quality.success ? '✓ PASS' : '✗ FAIL'}`);
+        }
+        if (verification.dimensions.tests) {
+            results.push(`- Tests: ${verification.dimensions.tests.success ? '✓ PASS' : '✗ FAIL'}`);
+        }
+        results.push(`- Overall: ${verification.success ? '✓ PASSED' : '✗ FAILED'}`);
+        return `
+${results.join('\n')}
+`;
+    }
+    replaceSection(content, sectionName, newContent) {
+        const pattern = new RegExp(`(## ${sectionName}\\n)([\\s\\S]*?)(?=\\n## |$)`, 'g');
+        return content.replace(pattern, `## ${sectionName}\n${newContent}\n`);
+    }
+    appendToSection(content, sectionName, entry) {
+        const pattern = new RegExp(`(## ${sectionName}\\n)([\\s\\S]*?)(?=\\n## |$)`, 'g');
+        const match = pattern.exec(content);
+        if (match) {
+            const current = match[2] || '';
+            return content.replace(pattern, `## ${sectionName}\n${current}${entry}`);
+        }
+        return content;
+    }
+    parseState(content) {
+        const phaseMatch = content.match(/- Phase: (\w+)/);
+        const goalMatch = content.match(/## Goal\n(.+)/);
+        const startedMatch = content.match(/- Started: (.+)/);
+        const totalMatch = content.match(/### Tasks \((\d+)\)/);
+        const completedMatch = content.match(/## Completed Tasks\n([\s\S]*?)(?=\n## |$)/);
+        const completedTasks = completedMatch
+            ? completedMatch[1].split('\n').filter(l => l.trim().startsWith('- [x]')).length
+            : 0;
+        const totalTasks = totalMatch ? parseInt(totalMatch[1], 10) : 0;
+        return {
+            goal: goalMatch?.[1] || '',
+            phase: phaseMatch?.[1] || 'planning',
+            started: startedMatch?.[1] || new Date().toISOString(),
+            lastUpdated: new Date().toISOString(),
+            totalTasks,
+            completedTasks: [],
+            tokenUsage: {
+                used: 0,
+                limit: 1000000,
+                percentage: 0
+            }
+        };
+    }
+}
+//# sourceMappingURL=state-md.js.map

package/dist/src/persistence/state-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-md.js","sourceRoot":"","sources":["../../../src/persistence/state-md.ts"],"names":[],"mappings":"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"}

package/dist/src/persistence/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Persistence layer types for STATE.md and PLAN.md
+ */
+export interface Task {
+    id: string;
+    description: string;
+    estimatedComplexity: 'low' | 'medium' | 'high';
+    relatedFiles?: string[];
+    verificationCriteria?: string[];
+}
+export interface Wave {
+    id: string;
+    tasks: string[];
+}
+export interface Plan {
+    goal: string;
+    tasks: Task[];
+    dependencies: Record<string, string[]>;
+    waves: Wave[];
+    verificationCriteria: string[];
+    estimatedDuration: number;
+    rationale: string;
+}
+export interface TaskResult {
+    taskId: string;
+    success: boolean;
+    filesModified: string[];
+    testsAdded: string[];
+    duration: number;
+    notes: string;
+    error?: string;
+    phases?: {
+        phase: string;
+        status: string;
+        command?: string;
+        evidence?: string;
+    }[];
+    worktreePath?: string;
+    branchName?: string;
+}
+export interface VerificationResult {
+    success: boolean;
+    dimensions: {
+        goals?: DimensionResult;
+        quality?: DimensionResult;
+        tests?: DimensionResult;
+    };
+}
+export interface DimensionResult {
+    success: boolean;
+    details?: unknown;
+    evidence?: string[];
+    gaps?: string[];
+}
+export interface WorkflowState {
+    goal: string;
+    phase: 'planning' | 'executing' | 'verifying' | 'complete';
+    started: string;
+    lastUpdated: string;
+    totalTasks: number;
+    completedTasks: TaskResult[];
+    tokenUsage: {
+        used: number;
+        limit: number;
+        percentage: number;
+    };
+}
+export interface StateMdManager {
+    initialize(goal: string): Promise<void>;
+    updatePhase(phase: WorkflowState['phase']): Promise<void>;
+    recordPlan(plan: Plan): Promise<void>;
+    recordTaskComplete(taskId: string, result: TaskResult): Promise<void>;
+    recordVerification(verification: VerificationResult): Promise<void>;
+    readCurrentState(): Promise<WorkflowState>;
+}
+export interface PlanMdManager {
+    writePlan(plan: Plan): Promise<void>;
+    readPlan(): Promise<Plan>;
+    updateTaskStatus(taskId: string, status: 'pending' | 'in_progress' | 'complete'): Promise<void>;
+}
+export interface PersistenceManager {
+    state: StateMdManager;
+    plan: PlanMdManager;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/persistence/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/persistence/types.ts"],"names":[],"mappings":"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"}

package/dist/src/persistence/types.js

@@ -0,0 +1,5 @@
+/**
+ * Persistence layer types for STATE.md and PLAN.md
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/persistence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/persistence/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/router/classifier.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Request Classifier - determines what type of subagent should handle a request.
+ *
+ * Analyzes user request text and contextual signals to produce an
+ * IntentClassification, then builds a RoutingDecision with the appropriate
+ * SubagentConfig and SubagentContract.
+ *
+ * Classification follows a priority-ordered chain:
+ *   1. execute (plan file exists / mid-execution)
+ *   2. quick-task (trivial typo/whitespace, small scoped change)
+ *   3. review (code review request)
+ *   4. debug (root cause analysis)
+ *   5. tdd (test-driven development request)
+ *   6. plan (new feature / significant change)
+ *   7. general (catch-all)
+ */
+import type { SubagentConfig } from '../agents/types.js';
+import type { IntentType, IntentClassification, RoutingDecision, PermissionSet, RouterConfig } from './types.js';
+/** Context signals used alongside the raw request text. */
+export interface ClassificationContext {
+    /** Whether a plan file already exists for this task/feature */
+    planFileExists: boolean;
+    /** Whether the user is in the middle of executing a plan */
+    isExecutingPlan: boolean;
+    /** Whether there are uncommitted changes in the working tree */
+    hasUncommittedChanges: boolean;
+    /** The current branch name (if available) */
+    currentBranch?: string;
+    /** Any files the user explicitly mentioned */
+    mentionedFiles: string[];
+}
+/** Extended classification result with diagnostic metadata. */
+export interface ClassifierResult {
+    /** The intent classification */
+    classification: IntentClassification;
+    /** The full routing decision (contract + config) */
+    routing: RoutingDecision;
+    /** Confidence score 0-1 */
+    confidence: number;
+    /** Which rule matched */
+    matchedRule: string;
+    /** Alternative classifications that were considered */
+    alternatives: Array<{
+        type: IntentType;
+        confidence: number;
+    }>;
+}
+/**
+ * Analyzes user requests and produces routing decisions.
+ *
+ * Classification runs through a priority-ordered chain:
+ * 1. Context-based: plan exists → 'execute'
+ * 2. Pattern-based: trivial-edit → quick-task, review, debug, tdd, plan, general
+ * 3. Fallback: 'general'
+ *
+ * Usage:
+ * ```typescript
+ * const classifier = new RequestClassifier(config)
+ * const result = classifier.classify("Fix the typo in src/utils.ts", {
+ *   planFileExists: false,
+ *   isExecutingPlan: false,
+ *   hasUncommittedChanges: true,
+ *   mentionedFiles: ['src/utils.ts'],
+ * })
+ * // result.classification.type === 'quick-task'
+ * ```
+ */
+export declare class RequestClassifier {
+    private readonly config;
+    /** Priority-ordered classification rules. */
+    private readonly rules;
+    constructor(config: RouterConfig);
+    /**
+     * If a plan file exists or we are mid-execution, route to execute.
+     */
+    private checkContextExecute;
+    /**
+     * Classify a user request and produce a full routing decision.
+     *
+     * @param request - Raw user request text
+     * @param context - Contextual signals to improve accuracy
+     * @returns ClassifierResult with classification metadata and routing decision
+     */
+    classify(request: string, context: ClassificationContext): ClassifierResult;
+    /**
+     * Classify intent only (without building a full routing decision).
+     */
+    classifyIntent(request: string, context: ClassificationContext): IntentClassification;
+    /**
+     * Produce just the routing decision.
+     */
+    route(request: string, context: ClassificationContext): RoutingDecision;
+    /** Get recommended token budget for an intent type. */
+    getTokenBudget(type: IntentType): number;
+    /** Get subagent role for an intent type. */
+    getSubagentRole(type: IntentType): SubagentConfig['role'];
+    /** Get default permissions for an intent type (returns a copy). */
+    getSubagentPermissions(type: IntentType): PermissionSet;
+    /**
+     * Generate a human-readable classification summary for logging.
+     */
+    describeClassification(result: ClassifierResult): string;
+    /**
+     * Compute alternative classifications based on the winning type.
+     */
+    private computeAlternatives;
+}
+//# sourceMappingURL=classifier.d.ts.map

package/dist/src/router/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../src/router/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,eAAe,EAEf,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAA;AAOnB,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,cAAc,EAAE,OAAO,CAAA;IACvB,4DAA4D;IAC5D,eAAe,EAAE,OAAO,CAAA;IACxB,gEAAgE;IAChE,qBAAqB,EAAE,OAAO,CAAA;IAC9B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,cAAc,EAAE,oBAAoB,CAAA;IACpC,oDAAoD;IACpD,OAAO,EAAE,eAAe,CAAA;IACxB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC9D;AAuVD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAMpB;gBAEU,MAAM,EAAE,YAAY;IAchC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,gBAAgB;IAqD3E;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,oBAAoB;IAIrF;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,eAAe;IAQvE,uDAAuD;IACvD,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIxC,4CAA4C;IAC5C,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC;IAIzD,mEAAmE;IACnE,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa;IAQvD;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAmBxD;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAa5B"}