@haoyiyin/workflow 0.2.0

package/dist/src/router/types.js

@@ -0,0 +1,24 @@
+/**
+ * Router system types - Controls all user input routing
+ */
+/** Main Agent is NEVER allowed to do these */
+export const MAIN_AGENT_PROHIBITED = {
+    readSourceFiles: true, // ❌ Cannot read .ts, .js, .py, etc.
+    searchCodebase: true, // ❌ Cannot search/grep
+    writeFiles: true, // ❌ Cannot write any files
+    runBuildCommands: true, // ❌ Cannot npm build, tsc, etc.
+    runTests: true, // ❌ Cannot run tests
+    editLargeFiles: true, // ❌ Cannot edit >50 lines
+    longRunningTasks: true, // ❌ Cannot run >30s tasks
+};
+/** Keywords that trigger specific routes */
+export const ROUTE_KEYWORDS = {
+    plan: ['plan', 'implement', 'add feature', 'refactor', 'migrate', 'create'],
+    'quick-task': ['fix typo', 'rename', 'small change', 'quick', 'trivial'],
+    execute: ['execute', 'run plan', 'do plan', 'implement plan'],
+    review: ['review', 'check code', 'audit', 'review diff', 'cr'],
+    debug: ['debug', 'fix bug', 'investigate', 'root cause', 'flaky'],
+    tdd: ['tdd', 'test first', 'red green', 'write test'],
+    general: ['what', 'how', 'explain', 'tell me', 'search', 'find'],
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/router/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwGH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,eAAe,EAAE,IAAI,EAAO,oCAAoC;IAChE,cAAc,EAAE,IAAI,EAAQ,uBAAuB;IACnD,UAAU,EAAE,IAAI,EAAY,2BAA2B;IACvD,gBAAgB,EAAE,IAAI,EAAM,gCAAgC;IAC5D,QAAQ,EAAE,IAAI,EAAc,qBAAqB;IACjD,cAAc,EAAE,IAAI,EAAQ,0BAA0B;IACtD,gBAAgB,EAAE,IAAI,EAAM,0BAA0B;CACvD,CAAA;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC;IAC3E,YAAY,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,CAAC;IACxE,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC;IAC7D,MAAM,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC;IAC9D,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC;IACjE,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IACrD,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;CACjE,CAAA"}

package/dist/src/skills/agents-md/index.d.ts

@@ -0,0 +1,9 @@
+import { Skill } from '../skill.js';
+import type { SkillContext } from '../types.js';
+export declare class AgentsMdSkill extends Skill<any, any> {
+    constructor();
+    execute(input: any, context: SkillContext): Promise<any>;
+}
+export declare const agentsMdSkill: AgentsMdSkill;
+export default agentsMdSkill;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/skills/agents-md/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/skills/agents-md/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAQ/C,qBAAa,aAAc,SAAQ,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;;IAE1C,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;CAkB/D;AACD,eAAO,MAAM,aAAa,eAAsB,CAAA;AAChD,eAAe,aAAa,CAAA"}

package/dist/src/skills/agents-md/index.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { Skill } from '../skill.js';
+import { createDispatcher } from '../../agents/dispatcher.js';
+import { createMainAgentGuard } from '../../guard/main-agent.js';
+const P = { readFiles: true, searchCode: false, runCommands: false, writeFiles: false, gitOperations: false };
+const PRW = { readFiles: true, searchCode: false, runCommands: false, writeFiles: true, gitOperations: false };
+const AgentsMdInputSchema = z.object({ type: z.enum(['CLAUDE', 'AGENTS', 'CONTEXT']).default('CLAUDE'), update: z.boolean().default(false), model: z.string().optional() });
+export class AgentsMdSkill extends Skill {
+    constructor() { super({ name: 'agents-md', description: 'Create/update agent instructions', requires: [], inputSchema: AgentsMdInputSchema }); }
+    async execute(input, context) {
+        const { config, logger } = context;
+        const dispatcher = createDispatcher(logger);
+        const guard = createMainAgentGuard({}, logger);
+        const filename = `${input.type}.md`;
+        guard.activateEmbargo();
+        try {
+            const explore = await dispatcher.dispatch({ role: 'explorer', model: input.model || config.defaultModel }, { permissions: P, prompt: `Collect repo evidence: package.json, README, configs.`, owns: [], reads: ['package.json', 'README.md', filename] });
+            await dispatcher.dispatch({ role: 'implementer', model: input.model || 'sonnet' }, { permissions: PRW, prompt: `${input.update ? 'Update' : 'Create'} ${filename}. Evidence: ${explore.output.slice(0, 3000)}. Include: Overview, Tech Stack, Commands, Conventions.`, owns: [filename], reads: [] });
+            return { filePath: filename, mode: input.update ? 'updated' : 'created', evidence: ['package.json'], rules: ['Overview'], assumptions: [], summary: `${filename} done` };
+        }
+        finally {
+            guard.deactivateEmbargo();
+        }
+    }
+}
+export const agentsMdSkill = new AgentsMdSkill();
+export default agentsMdSkill;
+//# sourceMappingURL=index.js.map

package/dist/src/skills/agents-md/index.js.map

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

package/dist/src/skills/execute-plan/index.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Enhanced Execute Plan Skill - Orchestrates TDD and Review skills
+ *
+ * Architecture: Orchestrator pattern
+ * - Executes waves sequentially
+ * - Each task uses TDD skill (RED/GREEN/REFACTOR)
+ * - Verification uses review-diff skill
+ * - Lifecycle managed via hooks
+ * - Task-level worktree isolation via worktreeContract subagent
+ */
+import { z } from 'zod';
+import { Skill } from '../skill.js';
+import type { SkillContext } from '../types.js';
+declare const ExecuteInputSchema: z.ZodObject<{
+    plan: z.ZodAny;
+    waves: z.ZodArray<z.ZodAny, "many">;
+    skipVerify: z.ZodOptional<z.ZodBoolean>;
+    model: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    waves: any[];
+    model?: string | undefined;
+    plan?: any;
+    skipVerify?: boolean | undefined;
+}, {
+    waves: any[];
+    model?: string | undefined;
+    plan?: any;
+    skipVerify?: boolean | undefined;
+}>;
+declare const ExecuteOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    results: z.ZodArray<z.ZodAny, "many">;
+    verification: z.ZodAny;
+    wavesCompleted: z.ZodNumber;
+    totalWaves: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    results: any[];
+    wavesCompleted: number;
+    totalWaves: number;
+    verification?: any;
+}, {
+    success: boolean;
+    results: any[];
+    wavesCompleted: number;
+    totalWaves: number;
+    verification?: any;
+}>;
+type ExecuteInput = z.infer<typeof ExecuteInputSchema>;
+type ExecuteOutput = z.infer<typeof ExecuteOutputSchema>;
+export declare class ExecutePlanSkill extends Skill<ExecuteInput, ExecuteOutput> {
+    constructor();
+    execute(input: ExecuteInput, context: SkillContext): Promise<ExecuteOutput>;
+    /**
+     * Execute a wave using TDD skill for each task
+     * Parallel execution with Promise.allSettled
+     */
+    private executeWaveWithTDD;
+    /**
+     * Execute single task using TDD skill with task-level worktree isolation
+     * Each task gets its own worktree for true isolation
+     * Uses worktreeContract instead of worktree-start skill
+     */
+    private executeTaskWithTDD;
+    /**
+     * Run verification using review-diff skill
+     * Returns structured verification result
+     */
+    private runVerificationWithReviewDiff;
+    /**
+     * Verify goals using review-diff skill
+     */
+    private verifyGoalsWithReviewDiff;
+    /**
+     * Verify code quality using review-diff skill
+     */
+    private verifyQualityWithReviewDiff;
+    /**
+     * Verify tests by checking TDD results
+     */
+    private verifyTests;
+    /**
+     * Handle wave failure
+     */
+    private handleWaveFailure;
+    /**
+     * Merge completed task worktrees back to main worktree with automatic conflict resolution
+     * Called after each successful wave
+     *
+     * Conflict Resolution Strategy:
+     * 1. Try merge --no-ff
+     * 2. If conflict, analyze with debugger subagent
+     * 3. Auto-resolve based on conflict type (imports, adjacent changes, etc.)
+     * 4. If cannot auto-resolve, try rebase-merging or manual merge
+     * 5. Last resort: mark for manual resolution
+     */
+    private mergeTaskWorktrees;
+    /**
+     * Merge a single branch with conflict detection and auto-resolution
+     */
+    private mergeSingleBranch;
+    /**
+     * Parse merge result from subagent output
+     */
+    private parseMergeResult;
+    /**
+     * Auto-resolve merge conflicts using debugger subagent
+     */
+    private autoResolveConflicts;
+    /**
+     * Resolve a single file conflict
+     */
+    private resolveSingleFile;
+    /**
+     * Parse conflict analysis from subagent output
+     */
+    private parseConflictAnalysis;
+    /**
+     * Apply conflict resolution strategy
+     */
+    private applyConflictStrategy;
+    /**
+     * Intelligently combine changes from both branches
+     */
+    private combineFileChanges;
+    /**
+     * Parse resolution result
+     */
+    private parseResolutionResult;
+    /**
+     * Parse worktree output from subagent
+     */
+    private parseWorktreeOutput;
+    /**
+     * Helper to trigger hooks with error handling
+     */
+    private triggerHook;
+}
+export declare const executePlanSkill: ExecutePlanSkill;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/skills/execute-plan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/skills/execute-plan/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAmB/C,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;EAKtB,CAAA;AAEF,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAMvB,CAAA;AAEF,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AACtD,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAExD,qBAAa,gBAAiB,SAAQ,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC;;IAShE,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAmHjF;;;OAGG;YACW,kBAAkB;IA2EhC;;;;OAIG;YACW,kBAAkB;IAyDhC;;;OAGG;YACW,6BAA6B;IAsC3C;;OAEG;YACW,yBAAyB;IA8BvC;;OAEG;YACW,2BAA2B;IA4BzC;;OAEG;YACW,WAAW;IAgDzB;;OAEG;YACW,iBAAiB;IAc/B;;;;;;;;;;OAUG;YACW,kBAAkB;IA4ChC;;OAEG;YACW,iBAAiB;IA6E/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;OAEG;YACW,oBAAoB;IAyBlC;;OAEG;YACW,iBAAiB;IAyD/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;YACW,qBAAqB;IA6CnC;;OAEG;YACW,kBAAkB;IAqDhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiD3B;;OAEG;YACW,WAAW;CAc1B;AACD,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}