workspace-maxxing 0.1.0

package/dist/scripts/dispatch.js

@@ -0,0 +1,386 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dispatchSkill = dispatchSkill;
+exports.dispatchParallel = dispatchParallel;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const SKILL_NEXT_MAP = {
+    research: 'architecture',
+    architecture: 'none',
+    validation: 'prompt-engineering',
+    'prompt-engineering': 'testing',
+    testing: 'iteration',
+    iteration: 'none',
+    tooling: 'none',
+    worker: 'validation',
+    fixer: 'validation',
+};
+function isValidStatus(value) {
+    return value === 'passed' || value === 'failed' || value === 'escalated';
+}
+function normalizeStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((item) => String(item))
+        .filter((item) => item.trim().length > 0);
+}
+function extractJsonPayload(output) {
+    const trimmed = output.trim();
+    if (!trimmed) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        return typeof parsed === 'object' && parsed !== null
+            ? parsed
+            : null;
+    }
+    catch {
+        // Continue trying to parse trailing JSON from mixed runner logs.
+    }
+    const firstBrace = trimmed.indexOf('{');
+    const lastBrace = trimmed.lastIndexOf('}');
+    if (firstBrace === -1 || lastBrace === -1 || lastBrace <= firstBrace) {
+        return null;
+    }
+    const candidate = trimmed.slice(firstBrace, lastBrace + 1);
+    try {
+        const parsed = JSON.parse(candidate);
+        return typeof parsed === 'object' && parsed !== null
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function renderRunnerCommand(template, skillName, options) {
+    const invocation = options.invocation;
+    const replacements = {
+        '{skill}': skillName,
+        '{workspace}': options.workspacePath ?? process.cwd(),
+        '{batchId}': invocation ? String(invocation.batchId) : '',
+        '{testCaseId}': invocation?.testCaseId ?? '',
+    };
+    return template.replace(/\{skill\}|\{workspace\}|\{batchId\}|\{testCaseId\}/g, (token) => {
+        return replacements[token] ?? token;
+    });
+}
+function createRunnerFailureReport(skillName, message, nextSkill, metrics = {}) {
+    return {
+        skill: skillName,
+        status: 'failed',
+        timestamp: new Date().toISOString(),
+        findings: [message],
+        recommendations: ['Inspect runner command and ensure it outputs a valid JSON report'],
+        metrics,
+        nextSkill,
+    };
+}
+function truncateTelemetryText(value, maxLength = 2000) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength)}...`;
+}
+function writeRunnerTelemetry(skillName, options, details) {
+    try {
+        const runsDir = path.join(options.workspacePath ?? process.cwd(), '.agents', 'iteration', 'runs');
+        fs.mkdirSync(runsDir, { recursive: true });
+        const batchToken = options.invocation ? String(options.invocation.batchId) : 'na';
+        const testCaseToken = options.invocation?.testCaseId ? options.invocation.testCaseId.replace(/[^a-zA-Z0-9-_]/g, '_') : 'na';
+        const fileName = `${Date.now()}-${skillName}-${batchToken}-${testCaseToken}.json`;
+        const filePath = path.join(runsDir, fileName);
+        const telemetry = {
+            skill: skillName,
+            status: details.status,
+            timestamp: details.timestamp,
+            batchId: options.invocation?.batchId,
+            testCaseId: options.invocation?.testCaseId,
+            commandTemplate: details.commandTemplate,
+            renderedCommand: details.renderedCommand,
+            durationMs: details.durationMs,
+            exitCode: details.exitCode,
+            timedOut: details.timedOut,
+            parsedPayload: details.parsedPayload,
+            stdoutLength: details.stdout.length,
+            stderrLength: details.stderr.length,
+            stdoutPreview: truncateTelemetryText(details.stdout),
+            stderrPreview: truncateTelemetryText(details.stderr),
+        };
+        fs.writeFileSync(filePath, JSON.stringify(telemetry, null, 2));
+    }
+    catch {
+        // Best-effort telemetry; dispatch result should not fail due to telemetry write issues.
+    }
+}
+function runExternalRunner(skillName, options) {
+    if (!options.runnerCommand) {
+        return createRunnerFailureReport(skillName, 'Runner command is required for external dispatch mode', 'none');
+    }
+    const command = renderRunnerCommand(options.runnerCommand, skillName, options);
+    const startedAt = Date.now();
+    const timeoutMs = (options.runnerTimeoutSeconds ?? 300) * 1000;
+    try {
+        const stdout = (0, child_process_1.execFileSync)(command, {
+            cwd: options.workspacePath ?? process.cwd(),
+            encoding: 'utf-8',
+            shell: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: timeoutMs,
+        });
+        const parsed = extractJsonPayload(stdout);
+        const elapsedMs = Date.now() - startedAt;
+        const nextSkill = SKILL_NEXT_MAP[skillName] ?? 'none';
+        const commandTemplate = options.runnerCommand ?? '';
+        if (!parsed) {
+            const report = {
+                skill: skillName,
+                status: 'passed',
+                timestamp: new Date().toISOString(),
+                findings: ['External runner completed without JSON payload'],
+                recommendations: ['Emit JSON report for richer metrics and routing decisions'],
+                metrics: {
+                    executionTimeMs: elapsedMs,
+                    outputLength: stdout.length,
+                },
+                nextSkill,
+            };
+            writeRunnerTelemetry(skillName, options, {
+                commandTemplate,
+                renderedCommand: command,
+                status: report.status,
+                timestamp: report.timestamp,
+                durationMs: elapsedMs,
+                exitCode: 0,
+                timedOut: 0,
+                stdout,
+                stderr: '',
+                parsedPayload: 0,
+            });
+            return report;
+        }
+        const findings = normalizeStringArray(parsed.findings);
+        const recommendations = normalizeStringArray(parsed.recommendations);
+        const rawMetrics = parsed.metrics;
+        const metrics = typeof rawMetrics === 'object' && rawMetrics !== null
+            ? rawMetrics
+            : {};
+        const report = {
+            skill: typeof parsed.skill === 'string' && parsed.skill.trim()
+                ? parsed.skill
+                : skillName,
+            status: isValidStatus(parsed.status) ? parsed.status : 'passed',
+            timestamp: typeof parsed.timestamp === 'string' && parsed.timestamp.trim()
+                ? parsed.timestamp
+                : new Date().toISOString(),
+            findings: findings.length > 0 ? findings : ['External runner completed'],
+            recommendations: recommendations.length > 0
+                ? recommendations
+                : ['Proceed using the returned runner output'],
+            metrics: {
+                ...metrics,
+                executionTimeMs: typeof metrics.executionTimeMs === 'number'
+                    ? metrics.executionTimeMs
+                    : elapsedMs,
+            },
+            nextSkill: typeof parsed.nextSkill === 'string' && parsed.nextSkill.trim()
+                ? parsed.nextSkill
+                : nextSkill,
+        };
+        writeRunnerTelemetry(skillName, options, {
+            commandTemplate,
+            renderedCommand: command,
+            status: report.status,
+            timestamp: report.timestamp,
+            durationMs: elapsedMs,
+            exitCode: 0,
+            timedOut: 0,
+            stdout,
+            stderr: '',
+            parsedPayload: 1,
+        });
+        return report;
+    }
+    catch (error) {
+        const err = error;
+        const stderr = err.stderr ? String(err.stderr).trim() : '';
+        const stdout = err.stdout ? String(err.stdout).trim() : '';
+        const baseMessage = err.message ?? 'External runner failed';
+        const detailMessage = [stderr, stdout].find((value) => value.length > 0) ?? baseMessage;
+        const failureReport = createRunnerFailureReport(skillName, detailMessage, 'none', {
+            exitCode: typeof err.status === 'number' ? err.status : -1,
+            timedOut: err.signal === 'SIGTERM' || err.killed ? 1 : 0,
+        });
+        writeRunnerTelemetry(skillName, options, {
+            commandTemplate: options.runnerCommand ?? '',
+            renderedCommand: command,
+            status: failureReport.status,
+            timestamp: failureReport.timestamp,
+            durationMs: Date.now() - startedAt,
+            exitCode: typeof err.status === 'number' ? err.status : -1,
+            timedOut: err.signal === 'SIGTERM' || err.killed ? 1 : 0,
+            stdout,
+            stderr,
+            parsedPayload: 0,
+        });
+        return failureReport;
+    }
+}
+function dispatchSkill(skillName, skillsDir, options = {}) {
+    const skillPath = path.join(skillsDir, skillName, 'SKILL.md');
+    if (!fs.existsSync(skillPath)) {
+        return {
+            skill: skillName,
+            status: 'failed',
+            timestamp: new Date().toISOString(),
+            findings: [`Sub-skill SKILL.md not found: ${skillPath}`],
+            recommendations: ['Ensure the sub-skill directory and SKILL.md exist'],
+            metrics: {},
+            nextSkill: 'none',
+        };
+    }
+    const content = fs.readFileSync(skillPath, 'utf-8');
+    const nameMatch = content.match(/^---\nname:\s*(.+)$/m);
+    const skill = nameMatch ? nameMatch[1].trim() : skillName;
+    const requiresExternalRunner = skillName === 'worker' || skillName === 'fixer';
+    if (requiresExternalRunner && !options.runnerCommand) {
+        return createRunnerFailureReport(skillName, 'External sub-agent runner is required for worker/fixer', 'none');
+    }
+    const usesExternalRunner = Boolean(options.runnerCommand && (skillName === 'worker' || skillName === 'fixer'));
+    if (usesExternalRunner) {
+        return runExternalRunner(skillName, options);
+    }
+    const fallbackRecommendations = ['Follow the sub-skill instructions to complete the task'];
+    if (skillName === 'worker' || skillName === 'fixer') {
+        fallbackRecommendations.push('Configure --runner-command or WORKSPACE_MAXXING_SUBAGENT_RUNNER for true sub-agent execution');
+    }
+    return {
+        skill,
+        status: 'passed',
+        timestamp: new Date().toISOString(),
+        findings: [`Sub-skill "${skill}" loaded successfully`],
+        recommendations: fallbackRecommendations,
+        metrics: {
+            contentLength: content.length,
+            simulatedDispatch: skillName === 'worker' || skillName === 'fixer' ? 1 : 0,
+        },
+        nextSkill: SKILL_NEXT_MAP[skillName] ?? 'none',
+    };
+}
+function dispatchParallel(invocations, skillsDir, options = {}) {
+    return invocations.map((inv) => {
+        const report = dispatchSkill(inv.skill, skillsDir, {
+            ...options,
+            invocation: inv,
+        });
+        return {
+            ...report,
+            batchId: inv.batchId,
+            testCaseId: inv.testCaseId,
+        };
+    });
+}
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    const parseArg = (flag) => {
+        const idx = args.indexOf(flag);
+        return idx !== -1 ? args[idx + 1] : undefined;
+    };
+    const skill = parseArg('--skill');
+    const workspace = parseArg('--workspace');
+    const batchId = parseArg('--batch-id');
+    const testCaseId = parseArg('--test-case-id');
+    const parallel = args.includes('--parallel');
+    const invocationsPath = parseArg('--invocations');
+    const runnerCommand = parseArg('--runner-command') ?? process.env.WORKSPACE_MAXXING_SUBAGENT_RUNNER;
+    const runnerTimeoutRaw = parseArg('--runner-timeout');
+    let runnerTimeoutSeconds;
+    if (runnerTimeoutRaw !== undefined) {
+        const parsedTimeout = Number(runnerTimeoutRaw);
+        if (!Number.isFinite(parsedTimeout) || parsedTimeout <= 0) {
+            console.error('--runner-timeout must be a positive number of seconds');
+            process.exit(1);
+        }
+        runnerTimeoutSeconds = parsedTimeout;
+    }
+    const skillsDir = workspace
+        ? path.join(workspace, '.agents', 'skills', 'workspace-maxxing', 'skills')
+        : path.join(process.cwd(), 'skills');
+    const dispatchOptions = {
+        workspacePath: workspace,
+        runnerCommand,
+        runnerTimeoutSeconds,
+    };
+    if (parallel) {
+        if (!invocationsPath) {
+            console.error('--parallel requires --invocations <path>');
+            process.exit(1);
+        }
+        const parsed = JSON.parse(fs.readFileSync(invocationsPath, 'utf-8'));
+        if (!Array.isArray(parsed)) {
+            console.error('--invocations must point to a JSON array');
+            process.exit(1);
+        }
+        const results = dispatchParallel(parsed, skillsDir, dispatchOptions);
+        console.log(JSON.stringify(results, null, 2));
+    }
+    else {
+        if (!skill) {
+            console.error('Usage: node dispatch.ts --skill <name> --workspace <path> [--batch-id <n>] [--parallel --invocations <path>]');
+            process.exit(1);
+        }
+        const singleInvocation = batchId
+            ? {
+                skill,
+                batchId: parseInt(batchId, 10),
+                testCaseId: testCaseId ?? '',
+            }
+            : undefined;
+        const result = dispatchSkill(skill, skillsDir, {
+            ...dispatchOptions,
+            invocation: singleInvocation,
+        });
+        const output = batchId
+            ? { ...result, batchId: parseInt(batchId, 10) }
+            : result;
+        console.log(JSON.stringify(output, null, 2));
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/scripts/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/scripts/dispatch.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0UA,sCAkDC;AAED,4CAgBC;AA9YD,uCAAyB;AACzB,2CAA6B;AAC7B,iDAA6C;AAoC7C,MAAM,cAAc,GAA2B;IAC7C,QAAQ,EAAE,cAAc;IACxB,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,oBAAoB;IAChC,oBAAoB,EAAE,SAAS;IAC/B,OAAO,EAAE,WAAW;IACpB,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,YAAY;CACpB,CAAC;AAEF,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,WAAW,CAAC;AAC3E,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SAC3B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAClD,CAAC,CAAC,MAAiC;YACnC,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAClD,CAAC,CAAC,MAAiC;YACnC,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAAgB,EAChB,SAAiB,EACjB,OAAwB;IAExB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,MAAM,YAAY,GAA2B;QAC3C,SAAS,EAAE,SAAS;QACpB,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE;QACrD,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;QACzD,cAAc,EAAE,UAAU,EAAE,UAAU,IAAI,EAAE;KAC7C,CAAC;IAEF,OAAO,QAAQ,CAAC,OAAO,CAAC,qDAAqD,EAAE,CAAC,KAAK,EAAE,EAAE;QACvF,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAChC,SAAiB,EACjB,OAAe,EACf,SAAiB,EACjB,UAAkC,EAAE;IAEpC,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,eAAe,EAAE,CAAC,kEAAkE,CAAC;QACrF,OAAO;QACP,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,YAAoB,IAAI;IACpE,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;AAC3C,CAAC;AAED,SAAS,oBAAoB,CAC3B,SAAiB,EACjB,OAAwB,EACxB,OAWC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAClG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClF,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5H,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,SAAS,IAAI,UAAU,IAAI,aAAa,OAAO,CAAC;QAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE9C,MAAM,SAAS,GAAG;YAChB,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO;YACpC,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU;YAC1C,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;YACnC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;YACnC,aAAa,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;YACpD,aAAa,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;SACrD,CAAC;QAEF,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,wFAAwF;IAC1F,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,SAAiB,EACjB,OAAwB;IAExB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,OAAO,yBAAyB,CAAC,SAAS,EAAE,uDAAuD,EAAE,MAAM,CAAC,CAAC;IAC/G,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,4BAAY,EAAC,OAAO,EAAE;YACnC,GAAG,EAAE,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE;YAC3C,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACzC,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC;QAEtD,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAEpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,MAAM,GAAmB;gBAC7B,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,QAAQ;gBAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,QAAQ,EAAE,CAAC,gDAAgD,CAAC;gBAC5D,eAAe,EAAE,CAAC,2DAA2D,CAAC;gBAC9E,OAAO,EAAE;oBACP,eAAe,EAAE,SAAS;oBAC1B,YAAY,EAAE,MAAM,CAAC,MAAM;iBAC5B;gBACD,SAAS;aACV,CAAC;YAEF,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE;gBACvC,eAAe;gBACf,eAAe,EAAE,OAAO;gBACxB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,CAAC;gBACX,QAAQ,EAAE,CAAC;gBACX,MAAM;gBACN,MAAM,EAAE,EAAE;gBACV,aAAa,EAAE,CAAC;aACjB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACrE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI;YACnE,CAAC,CAAC,UAAoC;YACtC,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,MAAM,GAAmB;YAC7B,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;gBAC5D,CAAC,CAAC,MAAM,CAAC,KAAK;gBACd,CAAC,CAAC,SAAS;YACb,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;YAC/D,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;gBACxE,CAAC,CAAC,MAAM,CAAC,SAAS;gBAClB,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACxE,eAAe,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC;gBACzC,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,CAAC,0CAA0C,CAAC;YAChD,OAAO,EAAE;gBACP,GAAG,OAAO;gBACV,eAAe,EAAE,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ;oBAC1D,CAAC,CAAC,OAAO,CAAC,eAAe;oBACzB,CAAC,CAAC,SAAS;aACd;YACD,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;gBACxE,CAAC,CAAC,MAAM,CAAC,SAAS;gBAClB,CAAC,CAAC,SAAS;SACd,CAAC;QAEF,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE;YACvC,eAAe;YACf,eAAe,EAAE,OAAO;YACxB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,MAAM;YACN,MAAM,EAAE,EAAE;YACV,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAOX,CAAC;QAEF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,IAAI,wBAAwB,CAAC;QAC5D,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC;QAExF,MAAM,aAAa,GAAG,yBAAyB,CAC7C,SAAS,EACT,aAAa,EACb,MAAM,EACN;YACE,QAAQ,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,QAAQ,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACzD,CACF,CAAC;QAEF,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE;YACvC,eAAe,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;YAC5C,eAAe,EAAE,OAAO;YACxB,MAAM,EAAE,aAAa,CAAC,MAAM;YAC5B,SAAS,EAAE,aAAa,CAAC,SAAS;YAClC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,QAAQ,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,QAAQ,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,MAAM;YACN,MAAM;YACN,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB,EAAE,SAAiB,EAAE,UAA2B,EAAE;IAC/F,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAE9D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,CAAC,iCAAiC,SAAS,EAAE,CAAC;YACxD,eAAe,EAAE,CAAC,mDAAmD,CAAC;YACtE,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1D,MAAM,sBAAsB,GAAG,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,OAAO,CAAC;IAC/E,IAAI,sBAAsB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACrD,OAAO,yBAAyB,CAC9B,SAAS,EACT,wDAAwD,EACxD,MAAM,CACP,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC;IAC/G,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,uBAAuB,GAAG,CAAC,wDAAwD,CAAC,CAAC;IAC3F,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QACpD,uBAAuB,CAAC,IAAI,CAAC,8FAA8F,CAAC,CAAC;IAC/H,CAAC;IAED,OAAO;QACL,KAAK;QACL,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,CAAC,cAAc,KAAK,uBAAuB,CAAC;QACtD,eAAe,EAAE,uBAAuB;QACxC,OAAO,EAAE;YACP,aAAa,EAAE,OAAO,CAAC,MAAM;YAC7B,iBAAiB,EAAE,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3E;QACD,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC,IAAI,MAAM;KAC/C,CAAC;AACJ,CAAC;AAED,SAAgB,gBAAgB,CAC9B,WAAiC,EACjC,SAAiB,EACjB,UAAmC,EAAE;IAErC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE;YACjD,GAAG,OAAO;YACV,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;QACH,OAAO;YACL,GAAG,MAAM;YACT,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAsB,EAAE;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,QAAQ,CAAC,kBAAkB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC;IACpG,MAAM,gBAAgB,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACtD,IAAI,oBAAwC,CAAC;IAC7C,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YAC1D,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,oBAAoB,GAAG,aAAa,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,SAAS;QACzB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,CAAC;QAC1E,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEvC,MAAM,eAAe,GAA4B;QAC/C,aAAa,EAAE,SAAS;QACxB,aAAa;QACb,oBAAoB;KACrB,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAA8B,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,8GAA8G,CAAC,CAAC;YAC9H,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,gBAAgB,GAAG,OAAO;YAC9B,CAAC,CAAC;gBACA,KAAK;gBACL,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC9B,UAAU,EAAE,UAAU,IAAI,EAAE;aAC7B;YACD,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE;YAC7C,GAAG,eAAe;YAClB,UAAU,EAAE,gBAAgB;SAC7B,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,OAAO;YACpB,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE;YAC/C,CAAC,CAAC,MAAM,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/scripts/generate-tests.d.ts

@@ -0,0 +1,11 @@
+export interface TestCase {
+    stage: string;
+    type: 'sample' | 'edge-case' | 'empty';
+    input: string;
+    expected: string;
+}
+export interface TestCasesOutput {
+    testCases: TestCase[];
+}
+export declare function generateTestCases(workspacePath: string, outputPath?: string): TestCasesOutput;
+//# sourceMappingURL=generate-tests.d.ts.map

package/dist/scripts/generate-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.d.ts","sourceRoot":"","sources":["../../src/scripts/generate-tests.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CAmDjB"}

package/dist/scripts/generate-tests.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTestCases = generateTestCases;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function generateTestCases(workspacePath, outputPath) {
+    const ws = path.resolve(workspacePath);
+    const testCases = [];
+    const stageFolders = getNumberedFolders(ws);
+    if (stageFolders.length === 0) {
+        console.warn('Warning: No numbered stage folders found in workspace');
+    }
+    for (const stage of stageFolders) {
+        const contextPath = path.join(ws, stage, 'CONTEXT.md');
+        let purpose = '';
+        if (fs.existsSync(contextPath)) {
+            const content = fs.readFileSync(contextPath, 'utf-8');
+            const purposeMatch = content.match(/## Purpose\n([\s\S]*?)(?=##|$)/i);
+            if (purposeMatch) {
+                purpose = purposeMatch[1].trim();
+            }
+        }
+        testCases.push({
+            stage,
+            type: 'sample',
+            input: generateSampleInput(stage, purpose),
+            expected: `Stage should fulfill its purpose: ${purpose || 'handle stage-specific processing'}`,
+        });
+        testCases.push({
+            stage,
+            type: 'edge-case',
+            input: generateEdgeCaseInput(stage),
+            expected: `Stage should handle edge case gracefully`,
+        });
+        testCases.push({
+            stage,
+            type: 'empty',
+            input: '',
+            expected: `Stage should handle empty input gracefully`,
+        });
+    }
+    const result = { testCases };
+    if (outputPath) {
+        fs.writeFileSync(outputPath, JSON.stringify(result, null, 2));
+        console.log(`Test cases written to: ${outputPath}`);
+    }
+    return result;
+}
+function generateSampleInput(stage, purpose) {
+    const samples = {
+        '01-input': 'A sample input document with valid data for processing',
+        '02-process': 'Processed data from the input stage ready for transformation',
+        '03-output': 'Final processed data ready for report generation',
+    };
+    return samples[stage] || `Sample data for ${stage}`;
+}
+function generateEdgeCaseInput(stage) {
+    const edgeCases = {
+        '01-input': 'Input with special characters: <>&"\' and very long text that exceeds normal length expectations',
+        '02-process': 'Data with missing fields and inconsistent formatting',
+        '03-output': 'Conflicting output requirements from upstream stages',
+    };
+    return edgeCases[stage] || `Edge case data for ${stage}`;
+}
+function getNumberedFolders(workspacePath) {
+    const entries = fs.readdirSync(workspacePath, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isDirectory() && /^\d{2}-/.test(e.name) && e.name !== '00-meta')
+        .map((e) => e.name);
+}
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    const parseArg = (flag) => {
+        const idx = args.indexOf(flag);
+        return idx !== -1 ? args[idx + 1] : undefined;
+    };
+    const workspace = parseArg('--workspace');
+    const output = parseArg('--output');
+    if (!workspace) {
+        console.error('Usage: node generate-tests.ts --workspace <path> [--output <path>]');
+        process.exit(1);
+    }
+    generateTestCases(workspace, output);
+}
+//# sourceMappingURL=generate-tests.js.map

package/dist/scripts/generate-tests.js.map

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

package/dist/scripts/install-tool.d.ts

@@ -0,0 +1,8 @@
+export type PackageManager = 'npm' | 'pip' | 'npx' | 'brew';
+export interface InstallToolOptions {
+    tool: string;
+    manager: PackageManager;
+    workspace: string;
+}
+export declare function installTool(options: InstallToolOptions): void;
+//# sourceMappingURL=install-tool.d.ts.map

package/dist/scripts/install-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-tool.d.ts","sourceRoot":"","sources":["../../src/scripts/install-tool.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAsB7D"}

package/dist/scripts/install-tool.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installTool = installTool;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+function installTool(options) {
+    const { tool, manager, workspace } = options;
+    const ws = path.resolve(workspace);
+    const validManagers = ['npm', 'pip', 'npx', 'brew'];
+    if (!validManagers.includes(manager)) {
+        throw new Error(`Unsupported package manager: ${manager}. Supported: ${validManagers.join(', ')}`);
+    }
+    const command = manager === 'npx' ? `npx ${tool}` : `${manager} install ${tool}`;
+    console.log(`Installing ${tool} via ${manager}...`);
+    try {
+        (0, child_process_1.execSync)(command, { cwd: ws, stdio: 'inherit' });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to install ${tool}: ${message}`);
+    }
+    updateToolsMd(ws, tool, manager);
+    console.log(`✓ ${tool} installed and added to tool inventory`);
+}
+function updateToolsMd(workspace, tool, manager) {
+    const toolsMdPath = path.join(workspace, '00-meta', 'tools.md');
+    if (!fs.existsSync(toolsMdPath)) {
+        throw new Error(`tools.md not found at: ${toolsMdPath}`);
+    }
+    const content = fs.readFileSync(toolsMdPath, 'utf-8');
+    const now = new Date().toISOString().split('T')[0];
+    const placeholderRow = '| — | — | — | — |';
+    const newRow = `| ${tool} | latest | ${manager} | ${now} |`;
+    let updated;
+    if (content.includes(placeholderRow)) {
+        updated = content.replace(placeholderRow, `${placeholderRow}\n${newRow}`);
+    }
+    else {
+        const pendingIdx = content.indexOf('## Pending Tools');
+        if (pendingIdx !== -1) {
+            updated = content.slice(0, pendingIdx) + newRow + '\n\n' + content.slice(pendingIdx);
+        }
+        else {
+            updated = content + '\n' + newRow + '\n';
+        }
+    }
+    fs.writeFileSync(toolsMdPath, updated);
+}
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    const parseArg = (flag) => {
+        const idx = args.indexOf(flag);
+        return idx !== -1 ? args[idx + 1] : undefined;
+    };
+    const tool = parseArg('--tool');
+    const manager = parseArg('--manager');
+    const workspace = parseArg('--workspace');
+    if (!tool || !manager || !workspace) {
+        console.error('Usage: node install-tool.ts --tool <name> --manager <npm|pip|npx|brew> --workspace <path>');
+        process.exit(1);
+    }
+    installTool({ tool, manager, workspace });
+}
+//# sourceMappingURL=install-tool.js.map