@haoyiyin/workflow 0.2.0

package/dist/src/skills/systematic-debugging/index.js

@@ -0,0 +1,305 @@
+/**
+ * Systematic Debugging Skill - Find root cause before fixing
+ *
+ * Use case: Bug investigation, test failure, unexpected behavior
+ * Pattern: Reproduce → Gather Evidence → Diagnose (hypothesize + test) →
+ *          Apply Fix → Verify
+ *
+ * CRITICAL RULE: No fix before root cause is confirmed.
+ * Spawns debugger subagent(s) for each phase.
+ * Prevents the "fix-first-ask-questions-later" anti-pattern.
+ */
+import { z } from 'zod';
+import { Skill } from '../skill.js';
+import { createDispatcher } from '../../agents/dispatcher.js';
+import { researcherContract } from '../../agents/contracts.js';
+import { createMainAgentGuard } from '../../guard/main-agent.js';
+// ---------------------------------------------------------------------------
+// Schemas
+// ---------------------------------------------------------------------------
+const DebugInputSchema = z.object({
+    symptom: z.string().min(1, 'Symptom description is required'),
+    reproduceCommand: z.string().optional(),
+    logs: z.string().optional(),
+    recentChanges: z.string().optional(),
+    model: z.string().optional(),
+});
+const DebugOutputSchema = z.object({
+    rootCause: z.string(),
+    confidence: z.enum(['high', 'medium', 'low']),
+    location: z.object({
+        file: z.string().optional(),
+        line: z.number().optional(),
+        function: z.string().optional(),
+    }),
+    fixApplied: z.boolean(),
+    fixDescription: z.string().optional(),
+    verification: z.string(),
+    risks: z.array(z.string()),
+    tokensUsed: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Prompt builders (pure functions)
+// ---------------------------------------------------------------------------
+function buildReproducePrompt(symptom, reproduceCommand, logs) {
+    const sections = [
+        `## Reproduce the Issue`,
+        '',
+        `**Symptom**: ${symptom}`,
+    ];
+    if (reproduceCommand) {
+        sections.push('', `**Command**: \`${reproduceCommand}\``);
+    }
+    if (logs) {
+        sections.push('', '## Logs', '', logs.slice(0, 2000));
+    }
+    sections.push('', 'Confirm reproduction. Report exact steps, observed vs expected.');
+    return sections.join('\n');
+}
+function buildEvidencePrompt(symptom, reproOutput, recentChanges) {
+    return [
+        `## Gather Evidence`,
+        '',
+        `**Symptom**: ${symptom}`,
+        '',
+        '## Reproduction',
+        reproOutput.slice(0, 2000),
+        '',
+        recentChanges
+            ? `## Recent Changes\n${recentChanges}`
+            : '## Recent Changes\nCheck git log for related commits.',
+        '',
+        'Identify suspect files, key functions, failure points.',
+        'Trace execution path. Look for error handling gaps, state issues, race conditions.',
+    ].join('\n');
+}
+function buildDiagnosePrompt(symptom, evidenceOutput, knownIssues) {
+    return [
+        `## Diagnose Root Cause`,
+        '',
+        `**Symptom**: ${symptom}`,
+        '',
+        '## Evidence',
+        evidenceOutput.slice(0, 3000),
+        ...(knownIssues ? ['', '## Known Issues (from research)', knownIssues.slice(0, 1000)] : []),
+        '',
+        '## Process',
+        '1. Form 2-3 hypotheses, rank by likelihood',
+        '2. Test top hypothesis with targeted checks',
+        '3. Eliminate incorrect hypotheses',
+        '4. Confirm root cause with evidence',
+        '',
+        '## CRITICAL: Diagnosis Only — NO Fix Yet',
+        'Do NOT write any code changes in this phase.',
+        'You are confirming the root cause, not fixing it.',
+        '',
+        '## Output Format',
+        '',
+        '```',
+        'Root Cause: <description>',
+        'Confidence: high|medium|low',
+        'File: <path>',
+        'Line: <number>',
+        'Function: <name>',
+        'Evidence: <proof>',
+        'Eliminated: <hypotheses ruled out>',
+        'Fix: <proposed fix description>',
+        '```',
+    ].join('\n');
+}
+function buildApplyFixPrompt(diagnosis) {
+    return [
+        `## Apply Fix`,
+        '',
+        `**Root Cause**: ${diagnosis.rootCause}`,
+        `**Confidence**: ${diagnosis.confidence}`,
+        diagnosis.file ? `**File**: ${diagnosis.file}` : '',
+        diagnosis.line ? `**Line**: ${diagnosis.line}` : '',
+        '',
+        'Apply ONE minimal fix targeting the confirmed root cause.',
+        'Run reproduction test to confirm fix works.',
+        'Do NOT refactor unrelated code.',
+        diagnosis.confidence === 'low'
+            ? 'Low confidence: prefer a safer, more conservative fix.'
+            : '',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+function buildVerifyPrompt(symptom, fixOutput) {
+    return [
+        `## Verify Fix`,
+        '',
+        `**Original**: ${symptom}`,
+        '',
+        '## Fix Applied',
+        fixOutput.slice(0, 2000),
+        '',
+        'Re-run reproduction steps. Run full test suite.',
+        'Return PASS or FAIL with details.',
+    ].join('\n');
+}
+function parseDiagnosis(output) {
+    const rootCauseMatch = output.match(/root cause:?\s*(.+)/i);
+    const confidenceMatch = output.match(/confidence:?\s*(high|medium|low)/i);
+    const fileMatch = output.match(/file:?\s*(\S+\.\w+)/i);
+    const lineMatch = output.match(/line:?\s*(\d+)/i);
+    const funcMatch = output.match(/function:?\s*(\S+)/i);
+    const fixMatch = output.match(/fix:?\s*(.+)/i);
+    let confidence = 'medium';
+    if (confidenceMatch) {
+        const c = confidenceMatch[1].toLowerCase();
+        if (c === 'high' || c === 'medium' || c === 'low')
+            confidence = c;
+    }
+    return {
+        rootCause: rootCauseMatch?.[1]?.trim() ?? output.slice(0, 200),
+        confidence,
+        file: fileMatch?.[1]?.trim(),
+        line: lineMatch ? parseInt(lineMatch[1], 10) : undefined,
+        func: funcMatch?.[1]?.trim(),
+        fixDescription: fixMatch?.[1]?.trim(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Skill class
+// ---------------------------------------------------------------------------
+export class SystematicDebuggingSkill extends Skill {
+    constructor() {
+        super({
+            name: 'systematic-debugging',
+            description: 'Find root cause before fixing. Spawns debugger subagent for systematic diagnosis.',
+            requires: ['tdd'],
+            inputSchema: DebugInputSchema,
+            outputSchema: DebugOutputSchema,
+        });
+    }
+    async execute(input, context) {
+        const { config, logger } = context;
+        const dispatcher = createDispatcher(logger);
+        const guard = createMainAgentGuard({}, logger);
+        let totalTokens = 0;
+        guard.activateEmbargo();
+        try {
+            // Step 1: Reproduce
+            logger.info(`[debug] Reproducing: ${input.symptom.slice(0, 80)}`);
+            const reproResult = await dispatcher.dispatch({ role: 'debugger', model: input.model || config.defaultModel }, {
+                permissions: {
+                    readFiles: true,
+                    searchCode: false,
+                    runCommands: true,
+                    writeFiles: false,
+                    gitOperations: false,
+                },
+                prompt: buildReproducePrompt(input.symptom, input.reproduceCommand, input.logs),
+                owns: [],
+                reads: [],
+            });
+            totalTokens += reproResult.tokensUsed;
+            // Step 2: Gather evidence (read-only)
+            logger.info('[debug] Gathering evidence');
+            const evidenceResult = await dispatcher.dispatch({ role: 'explorer', model: input.model || config.defaultModel }, {
+                permissions: {
+                    readFiles: true,
+                    searchCode: true,
+                    runCommands: false,
+                    writeFiles: false,
+                    gitOperations: false,
+                },
+                prompt: buildEvidencePrompt(input.symptom, reproResult.output, input.recentChanges),
+                owns: [],
+                reads: [],
+            });
+            totalTokens += evidenceResult.tokensUsed;
+            // Step 2b: Research known issues (optional)
+            let knownIssuesContext = '';
+            const shouldResearch = /npm|yarn|package|version|error|fail|crash|exception/i.test(input.symptom);
+            if (shouldResearch) {
+                logger.info('[debug] Step 2b: Researching known issues...');
+                const researchResult = await dispatcher.dispatch({ role: 'researcher', model: input.model || config.defaultModel }, researcherContract({
+                    topic: input.symptom,
+                    scope: 'technical',
+                    questions: [
+                        'Are there known issues or bug reports?',
+                        'Any recent breaking changes or deprecations?',
+                        'What are common solutions or workarounds?'
+                    ],
+                    timeRange: '1y'
+                }));
+                totalTokens += researchResult.tokensUsed;
+                knownIssuesContext = researchResult.output.slice(0, 1200);
+                logger.info(`[debug] Research complete: ${knownIssuesContext ? 'found known issues' : 'no relevant results'}`);
+            }
+            // Step 3: Diagnose (NO FIX YET)
+            logger.info('[debug] Diagnosing root cause (no fix yet)');
+            const diagnoseResult = await dispatcher.dispatch({ role: 'debugger', model: input.model || config.defaultModel }, {
+                permissions: {
+                    readFiles: true,
+                    searchCode: false,
+                    runCommands: true,
+                    writeFiles: false,
+                    gitOperations: false,
+                },
+                prompt: buildDiagnosePrompt(input.symptom, evidenceResult.output, knownIssuesContext),
+                owns: [],
+                reads: [],
+            });
+            totalTokens += diagnoseResult.tokensUsed;
+            const diagnosis = parseDiagnosis(diagnoseResult.output);
+            // Step 4: Apply fix (only after root cause confirmed)
+            logger.info(`[debug] Applying fix (confidence: ${diagnosis.confidence})`);
+            const fixResult = await dispatcher.dispatch({
+                role: 'debugger',
+                model: input.model || config.defaultModel,
+                isolation: 'worktree',
+            }, {
+                permissions: {
+                    readFiles: true,
+                    searchCode: false,
+                    runCommands: true,
+                    writeFiles: true,
+                    gitOperations: false,
+                },
+                prompt: buildApplyFixPrompt(diagnosis),
+                owns: diagnosis.file ? [diagnosis.file] : [],
+                reads: [],
+            });
+            totalTokens += fixResult.tokensUsed;
+            // Step 5: Verify
+            logger.info('[debug] Verifying fix');
+            const verifyResult = await dispatcher.dispatch({ role: 'verifier', model: input.model || config.defaultModel }, {
+                permissions: {
+                    readFiles: false,
+                    searchCode: false,
+                    runCommands: true,
+                    writeFiles: false,
+                    gitOperations: false,
+                },
+                prompt: buildVerifyPrompt(input.symptom, fixResult.output),
+                owns: [],
+                reads: [],
+            });
+            totalTokens += verifyResult.tokensUsed;
+            return {
+                rootCause: diagnosis.rootCause,
+                confidence: diagnosis.confidence,
+                location: {
+                    file: diagnosis.file,
+                    line: diagnosis.line,
+                    function: diagnosis.func,
+                },
+                fixApplied: fixResult.status === 'success',
+                fixDescription: diagnosis.fixDescription ?? fixResult.output.slice(0, 500),
+                verification: verifyResult.output.slice(0, 500),
+                risks: [],
+                tokensUsed: totalTokens,
+            };
+        }
+        finally {
+            guard.deactivateEmbargo();
+        }
+    }
+}
+export const systematicDebuggingSkill = new SystematicDebuggingSkill();
+export default systematicDebuggingSkill;
+//# sourceMappingURL=index.js.map

package/dist/src/skills/systematic-debugging/index.js.map

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

package/dist/src/skills/tdd/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * TDD Skill - Enforces RED/GREEN/REFACTOR cycle via subagent dispatch
+ *
+ * Use case: Implement feature with test-first approach
+ * Pattern: RED (write failing test) → GREEN (minimal implementation) →
+ *          REFACTOR (improve while green) → VERIFY (full suite)
+ *
+ * Spawns implementer subagent with TDD contract at each phase.
+ * Enforces the cycle: no implementation before a failing test exists.
+ */
+import { z } from 'zod';
+import { Skill } from '../skill.js';
+import type { SkillContext } from '../types.js';
+declare const TDDInputSchema: z.ZodObject<{
+    behavior: z.ZodString;
+    testFile: z.ZodOptional<z.ZodString>;
+    targetFile: z.ZodString;
+    testLevel: z.ZodDefault<z.ZodEnum<["unit", "integration", "e2e", "contract"]>>;
+    model: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    behavior: string;
+    targetFile: string;
+    testLevel: "contract" | "unit" | "integration" | "e2e";
+    model?: string | undefined;
+    testFile?: string | undefined;
+}, {
+    behavior: string;
+    targetFile: string;
+    model?: string | undefined;
+    testFile?: string | undefined;
+    testLevel?: "contract" | "unit" | "integration" | "e2e" | undefined;
+}>;
+declare const TDDOutputSchema: z.ZodObject<{
+    status: z.ZodEnum<["success", "failure", "invalid-red"]>;
+    phases: z.ZodArray<z.ZodObject<{
+        phase: z.ZodEnum<["red", "green", "refactor"]>;
+        status: z.ZodEnum<["pass", "fail", "skipped"]>;
+        command: z.ZodString;
+        evidence: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "pass" | "fail" | "skipped";
+        phase: "refactor" | "red" | "green";
+        command: string;
+        evidence: string;
+    }, {
+        status: "pass" | "fail" | "skipped";
+        phase: "refactor" | "red" | "green";
+        command: string;
+        evidence: string;
+    }>, "many">;
+    broaderVerification: z.ZodObject<{
+        command: z.ZodString;
+        result: z.ZodEnum<["PASS", "FAIL", "NOT_RUN"]>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        result: "PASS" | "FAIL" | "NOT_RUN";
+    }, {
+        command: string;
+        result: "PASS" | "FAIL" | "NOT_RUN";
+    }>;
+    filesModified: z.ZodArray<z.ZodString, "many">;
+    summary: z.ZodString;
+    tokensUsed: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: "success" | "failure" | "invalid-red";
+    tokensUsed: number;
+    summary: string;
+    phases: {
+        status: "pass" | "fail" | "skipped";
+        phase: "refactor" | "red" | "green";
+        command: string;
+        evidence: string;
+    }[];
+    filesModified: string[];
+    broaderVerification: {
+        command: string;
+        result: "PASS" | "FAIL" | "NOT_RUN";
+    };
+}, {
+    status: "success" | "failure" | "invalid-red";
+    tokensUsed: number;
+    summary: string;
+    phases: {
+        status: "pass" | "fail" | "skipped";
+        phase: "refactor" | "red" | "green";
+        command: string;
+        evidence: string;
+    }[];
+    filesModified: string[];
+    broaderVerification: {
+        command: string;
+        result: "PASS" | "FAIL" | "NOT_RUN";
+    };
+}>;
+type TDDInput = z.infer<typeof TDDInputSchema>;
+type TDDOutput = z.infer<typeof TDDOutputSchema>;
+export declare class TDDSkill extends Skill<TDDInput, TDDOutput> {
+    constructor();
+    execute(input: TDDInput, context: SkillContext): Promise<TDDOutput>;
+}
+export declare const tddSkill: TDDSkill;
+export default tddSkill;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/skills/tdd/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/skills/tdd/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAQ/C,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAQlB,CAAA;AASF,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUnB,CAAA;AAEF,KAAK,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC9C,KAAK,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AA4HhD,qBAAa,QAAS,SAAQ,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC;;IAYhD,OAAO,CACX,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,SAAS,CAAC;CAuNtB;AAED,eAAO,MAAM,QAAQ,UAAiB,CAAA;AACtC,eAAe,QAAQ,CAAA"}