@haoyiyin/workflow 0.2.0

package/dist/src/agents/contracts.js

@@ -0,0 +1,431 @@
+/**
+ * Pre-built SubagentContracts for each subagent role.
+ *
+ * Each factory accepts role-specific parameters and returns a fully-formed
+ * SubagentContract ready for dispatch. The contracts encode:
+ *   - The exact permission set the subagent needs
+ *   - Which files it may own (modify) vs. read
+ *   - A structured prompt template
+ *   - An optional output schema for validation
+ */
+// ---------------------------------------------------------------------------
+// Permission presets
+// ---------------------------------------------------------------------------
+const READ_ONLY = {
+    readFiles: true,
+    searchCode: true,
+    runCommands: false,
+    writeFiles: false,
+    gitOperations: false,
+};
+const READ_SEARCH = {
+    readFiles: true,
+    searchCode: true,
+    runCommands: false,
+    writeFiles: false,
+    gitOperations: false,
+};
+const READ_RUN = {
+    readFiles: true,
+    searchCode: true,
+    runCommands: true,
+    writeFiles: false,
+    gitOperations: false,
+};
+const FULL_ACCESS = {
+    readFiles: true,
+    searchCode: true,
+    runCommands: true,
+    writeFiles: true,
+    gitOperations: true,
+};
+// ---------------------------------------------------------------------------
+// Contract factories
+// ---------------------------------------------------------------------------
+/**
+ * Explorer contract: read-only, searches the codebase to answer questions
+ * about structure, dependencies, patterns, or specific implementations.
+ */
+export function explorerContract(params) {
+    const reads = [...params.searchPaths, ...(params.readFiles ?? [])];
+    const questionsBlock = params.questions && params.questions.length > 0
+        ? `\n\n## Questions to Answer\n\n${params.questions.map((q, i) => `${i + 1}. ${q}`).join('\n')}`
+        : '';
+    const prompt = [
+        `Search the codebase for information related to: **${params.query}**`,
+        '',
+        `## Search Scope`,
+        '',
+        params.searchPaths.map((p) => `- \`${p}\``).join('\n'),
+        '',
+        'For each relevant file found, report:',
+        '- File path and purpose',
+        '- Key exports, functions, or classes',
+        '- Dependencies and imports',
+        '- Any notable patterns or issues',
+        questionsBlock,
+    ].join('\n');
+    return {
+        permissions: READ_SEARCH,
+        prompt,
+        owns: [],
+        reads,
+    };
+}
+/**
+ * Implementer contract: writes code, runs tests, works in isolation.
+ * The implementer owns specific files and may modify them.
+ */
+export function implementerContract(params) {
+    const constraintsBlock = params.constraints && params.constraints.length > 0
+        ? `\n\n## Constraints\n\n${params.constraints.map((c) => `- ${c}`).join('\n')}`
+        : '';
+    const testBlock = params.testCommand
+        ? `\n\n## Verification\n\nAfter implementing, run this command to verify:\n\n\`\`\`bash\n${params.testCommand}\n\`\`\``
+        : '';
+    const prompt = [
+        `Implement the following task:`,
+        '',
+        params.task,
+        '',
+        '## Files You Own (may modify)',
+        '',
+        params.ownedFiles.map((f) => `- \`${f}\``).join('\n'),
+        '',
+        '## Approach',
+        '',
+        '1. Read all owned files to understand current state',
+        '2. Implement the changes',
+        '3. Verify the code compiles',
+        '4. Run the test command if provided',
+        '5. Report what you changed and why',
+        constraintsBlock,
+        testBlock,
+        '',
+        '## Output Format',
+        '',
+        'Respond with a JSON block containing:',
+        '```json',
+        '{ "summary": "...", "filesChanged": [...], "testResult": "..." }',
+        '```',
+    ].join('\n');
+    return {
+        permissions: FULL_ACCESS,
+        outputSchema: {
+            summary: 'string',
+            filesChanged: 'object',
+            testResult: 'string',
+        },
+        prompt,
+        owns: [...params.ownedFiles],
+        reads: [...(params.readFiles ?? []), ...params.ownedFiles],
+    };
+}
+/**
+ * Reviewer contract: reads code changes and produces a structured review
+ * report covering correctness, style, security, and performance.
+ */
+export function reviewerContract(params) {
+    const focusBlock = params.focusAreas && params.focusAreas.length > 0
+        ? `\n\n## Focus Areas\n\n${params.focusAreas.map((a) => `- ${a}`).join('\n')}`
+        : '';
+    const criteriaBlock = params.criteria && params.criteria.length > 0
+        ? `\n\n## Review Criteria\n\n${params.criteria.map((c) => `- ${c}`).join('\n')}`
+        : '';
+    const prompt = [
+        `Review the following change:`,
+        '',
+        `> ${params.target}`,
+        '',
+        '## Files to Review',
+        '',
+        params.reviewFiles.map((f) => `- \`${f}\``).join('\n'),
+        '',
+        '## Review Checklist',
+        '',
+        'For each file, evaluate:',
+        '- **Correctness**: Does the logic do what it claims?',
+        '- **Edge Cases**: Are boundary conditions handled?',
+        '- **Error Handling**: Are errors caught and handled gracefully?',
+        '- **Immutability**: Are objects/arrays mutated or replaced?',
+        '- **Naming**: Are names clear and conventional?',
+        '- **Security**: Any injection risks, leaked secrets, or unsafe patterns?',
+        '- **Performance**: Any obvious N+1 queries, unnecessary allocations, or blocking calls?',
+        focusBlock,
+        criteriaBlock,
+        '',
+        '## Output Format',
+        '',
+        'Respond with a JSON block containing:',
+        '```json',
+        '{ "verdict": "approve|request_changes|comment", "summary": "...", "findings": [{ "severity": "critical|high|medium|low", "file": "...", "line": ..., "message": "...", "suggestion": "..." }] }',
+        '```',
+    ].join('\n');
+    return {
+        permissions: READ_ONLY,
+        outputSchema: {
+            verdict: 'string',
+            summary: 'string',
+            findings: 'object',
+        },
+        prompt,
+        owns: [],
+        reads: [...params.reviewFiles],
+    };
+}
+/**
+ * Debugger contract: analyses failures, identifies root causes, and
+ * proposes minimal fixes. Read-only unless explicitly allowed to write.
+ */
+export function debuggerContract(params) {
+    const errorBlock = params.errorOutput
+        ? `\n\n## Error Output\n\n\`\`\`\n${params.errorOutput}\n\`\`\``
+        : '';
+    const reproBlock = params.reproSteps && params.reproSteps.length > 0
+        ? `\n\n## Reproduction Steps\n\n${params.reproSteps.map((s, i) => `${i + 1}. ${s}`).join('\n')}`
+        : '';
+    const prompt = [
+        `Investigate and find the root cause of this issue:`,
+        '',
+        `> ${params.issue}`,
+        '',
+        '## Suspect Files',
+        '',
+        params.suspectFiles.map((f) => `- \`${f}\``).join('\n'),
+        errorBlock,
+        reproBlock,
+        '',
+        '## Process',
+        '',
+        '1. Read each suspect file carefully',
+        '2. Trace the execution path that leads to the failure',
+        '3. Identify the root cause (not just the symptom)',
+        '4. Propose a minimal, safe fix',
+        '5. Explain why the fix addresses the root cause',
+        '',
+        '## Output Format',
+        '',
+        'Respond with a JSON block containing:',
+        '```json',
+        '{ "rootCause": "...", "confidence": "high|medium|low", "fixDescription": "...", "affectedFiles": [...], "prevention": "..." }',
+        '```',
+    ].join('\n');
+    return {
+        permissions: READ_RUN,
+        outputSchema: {
+            rootCause: 'string',
+            confidence: 'string',
+            fixDescription: 'string',
+            affectedFiles: 'object',
+            prevention: 'string',
+        },
+        prompt,
+        owns: [],
+        reads: [...params.suspectFiles],
+    };
+}
+/**
+ * Verifier contract: goal-backward verification. Checks that the
+ * implemented changes actually satisfy the original requirements by
+ * working backward from the goal through each acceptance criterion.
+ */
+export function verifierContract(params) {
+    const criteriaList = params.acceptanceCriteria
+        .map((c, i) => `${i + 1}. ${c}`)
+        .join('\n');
+    const prompt = [
+        `Verify that the implemented changes satisfy the original goal.`,
+        '',
+        '## Original Goal',
+        '',
+        params.goal,
+        '',
+        '## Execution Plan',
+        '',
+        params.plan,
+        '',
+        '## Changed Files',
+        '',
+        params.changedFiles.map((f) => `- \`${f}\``).join('\n'),
+        '',
+        '## Acceptance Criteria',
+        '',
+        criteriaList,
+        '',
+        '## Verification Process',
+        '',
+        'Work backward from each acceptance criterion:',
+        '1. For each criterion, identify what evidence would prove it is met',
+        '2. Check the changed files for that evidence',
+        '3. Mark each criterion as PASS, FAIL, or UNCERTAIN',
+        '4. If any criterion fails, explain the gap',
+        '5. Produce a final verdict',
+        '',
+        '## Output Format',
+        '',
+        'Respond with a JSON block containing:',
+        '```json',
+        '{ "verdict": "pass|fail|partial", "criteriaResults": [{ "criterion": "...", "status": "pass|fail|uncertain", "evidence": "..." }], "gaps": [...], "recommendation": "..." }',
+        '```',
+    ].join('\n');
+    return {
+        permissions: READ_ONLY,
+        outputSchema: {
+            verdict: 'string',
+            criteriaResults: 'object',
+            gaps: 'object',
+            recommendation: 'string',
+        },
+        prompt,
+        owns: [],
+        reads: [...params.changedFiles],
+    };
+}
+/**
+ * Researcher contract: searches the internet for information on a topic.
+ * Returns structured research findings with sources.
+ */
+export function researcherContract(params) {
+    const scopeText = {
+        technical: 'Focus on technical documentation, GitHub repos, Stack Overflow, and official docs.',
+        business: 'Focus on industry reports, market analysis, and business news.',
+        security: 'Focus on CVE databases, security advisories, and best practices.',
+        general: 'Broad search across all sources.',
+    }[params.scope ?? 'general'];
+    const questionsBlock = params.questions && params.questions.length > 0
+        ? `\n\n## Specific Questions to Answer\n\n${params.questions.map((q, i) => `${i + 1}. ${q}`).join('\n')}`
+        : '';
+    const timeRangeText = params.timeRange
+        ? `\n\n## Time Range\nPrioritize results from the last ${params.timeRange}.`
+        : '';
+    const prompt = [
+        `Research the following topic: **${params.topic}**`,
+        '',
+        '## Search Scope',
+        '',
+        scopeText,
+        timeRangeText,
+        '',
+        '## Instructions',
+        '',
+        '1. Search the internet for relevant, authoritative sources',
+        '2. For each source, evaluate: credibility, recency, relevance',
+        '3. Synthesize findings into actionable insights',
+        '4. Note any conflicting information or uncertainties',
+        '',
+        '## Source Quality Guidelines',
+        '',
+        '- **Technical**: Official docs > GitHub repos > Stack Overflow > Blog posts',
+        '- **Business**: Industry reports > News articles > Company blogs',
+        '- **Security**: CVE databases > Official advisories > Security blogs',
+        '',
+        '## Anti-Patterns to Avoid',
+        '',
+        '- Do NOT rely on outdated information (>2 years old unless historical)',
+        '- Do NOT cite low-credibility sources (unverified blogs, forums)',
+        '- Do NOT make assumptions beyond what sources confirm',
+        '',
+        '## Output Format',
+        '',
+        'Respond with a JSON block containing:',
+        '```json',
+        '{',
+        '  "summary": "Executive summary (2-3 sentences)",',
+        '  "findings": [',
+        '    {',
+        '      "insight": "Key finding or answer",',
+        '      "confidence": "high|medium|low",',
+        '      "sources": [{ "title": "...", "url": "...", "date": "..." }]',
+        '    }',
+        '  ],',
+        '  "recommendations": ["Actionable recommendations based on research"],',
+        '  "knowledgeGaps": ["Questions that could not be answered"]',
+        '}',
+        '```',
+        questionsBlock,
+    ].join('\n');
+    return {
+        permissions: {
+            ...READ_ONLY,
+            // Researcher needs web search capability
+            runCommands: true, // For web search/fetch via subagent
+        },
+        outputSchema: {
+            summary: 'string',
+            findings: 'object',
+            recommendations: 'object',
+            knowledgeGaps: 'object',
+        },
+        prompt,
+        owns: [],
+        reads: [],
+    };
+}
+/**
+ * Worktree contract: Creates isolated git worktrees for parallel work.
+ * Replaces the worktree-start skill with a direct subagent dispatch.
+ */
+export function worktreeContract(params) {
+    const baseBranch = params.baseBranch || 'main';
+    const worktreePath = `.claude/worktrees/${params.branchName}`;
+    const prompt = [
+        `Create a git worktree for branch: ${params.branchName}`,
+        '',
+        `**Base Branch**: ${baseBranch}`,
+        `**Worktree Path**: ${worktreePath}`,
+        '',
+        '## Steps',
+        '',
+        '1. Inspect current repo state:',
+        '   - `git rev-parse --show-toplevel` — get repo root',
+        '   - `git status --porcelain --branch` — check current branch',
+        '   - `git branch -a` — list all branches',
+        '',
+        '2. Create worktree:',
+        `   - If branch exists: \`git worktree add ${worktreePath} ${params.branchName}\``,
+        `   - If branch does not exist: \`git worktree add ${worktreePath} -b ${params.branchName} origin/${baseBranch}\``,
+        '',
+        '3. Verify creation:',
+        '   - `git worktree list`',
+        '',
+        '## Error Recovery',
+        '',
+        `- If worktree path exists: \`git worktree remove ${worktreePath} --force\` then retry`,
+        `- If branch exists but worktree missing: \`git worktree add ${worktreePath} ${params.branchName}\``,
+        '',
+        '## Output Format',
+        '',
+        'Return JSON:',
+        '```json',
+        '{',
+        '  "worktreePath": "absolute/path/to/worktree",',
+        '  "branchName": "' + params.branchName + '",',
+        '  "baseBranch": "' + baseBranch + '",',
+        '  "repoRoot": "absolute/path/to/repo",',
+        '  "status": "created|reused|failed",',
+        '  "error": "error message if failed"',
+        '}',
+        '```',
+    ].join('\n');
+    return {
+        permissions: {
+            readFiles: true,
+            searchCode: false,
+            runCommands: true,
+            writeFiles: false,
+            gitOperations: true,
+        },
+        outputSchema: {
+            worktreePath: 'string',
+            branchName: 'string',
+            baseBranch: 'string',
+            repoRoot: 'string',
+            status: 'string',
+            error: 'string',
+        },
+        prompt,
+        owns: [],
+        reads: [],
+    };
+}
+//# sourceMappingURL=contracts.js.map

package/dist/src/agents/contracts.js.map

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

package/dist/src/agents/dispatcher-enhanced.d.ts

@@ -0,0 +1,68 @@
+import type { SubagentConfig, SubagentContract } from './types.js';
+declare enum CircuitState {
+    CLOSED = "closed",
+    OPEN = "open",
+    HALF_OPEN = "half-open"
+}
+interface CircuitBreakerConfig {
+    failureThreshold: number;
+    successThreshold: number;
+    timeout: number;
+}
+interface RetryPolicyConfig {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+    retryableErrors: string[];
+}
+export declare class ResilientDispatcher {
+    private circuitBreaker;
+    private retryPolicy;
+    private tokenBudget;
+    constructor(circuitConfig?: Partial<CircuitBreakerConfig>, retryConfig?: Partial<RetryPolicyConfig>);
+    /**
+     * Dispatch a subagent with resilience
+     */
+    dispatch<T>(config: SubagentConfig, contract: SubagentContract, options?: {
+        fallback?: () => T;
+        onRetry?: (attempt: number, error: Error) => void;
+    }): Promise<T>;
+    /**
+     * Dispatch multiple subagents in parallel with resilience
+     */
+    dispatchParallel<T>(configs: SubagentConfig[], contract: SubagentContract): Promise<(T | {
+        success: false;
+        error: string;
+    })[]>;
+    /**
+     * Build fresh prompt with minimal context
+     */
+    private buildFreshPrompt;
+    /**
+     * Spawn subagent process
+     */
+    private spawnSubagent;
+    /**
+     * Parse subagent result
+     */
+    private parseResult;
+    /**
+     * Generate unique ID
+     */
+    private generateId;
+    /**
+     * Get health status
+     */
+    getHealth(): {
+        circuitState: CircuitState;
+        tokenUsage: {
+            used: number;
+            limit: number;
+            percentage: number;
+        };
+    };
+}
+export { CircuitState };
+export type { CircuitBreakerConfig, RetryPolicyConfig };
+//# sourceMappingURL=dispatcher-enhanced.d.ts.map

package/dist/src/agents/dispatcher-enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-enhanced.d.ts","sourceRoot":"","sources":["../../../src/agents/dispatcher-enhanced.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAiC,MAAM,YAAY,CAAA;AAGjG,aAAK,YAAY;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAGD,UAAU,oBAAoB;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAGD,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AA0GD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAAa;gBAG9B,aAAa,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAC7C,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAmB1C;;OAEG;IACG,QAAQ,CAAC,CAAC,EACd,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAA;QAClB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;KAClD,GACA,OAAO,CAAC,CAAC,CAAC;IAmBb;;OAEG;IACG,gBAAgB,CAAC,CAAC,EACtB,OAAO,EAAE,cAAc,EAAE,EACzB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAsBrD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;YACW,aAAa;IAsF3B;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,SAAS,IAAI;QACX,YAAY,EAAE,YAAY,CAAA;QAC1B,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;KAChE;CAMF;AAED,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,CAAA"}