@dailephd/my-dev-kit-orchestrator 1.0.0

package/dist/commands/prompt.js

@@ -0,0 +1,198 @@
+"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.makePromptCommand = makePromptCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const run_1 = require("../run");
+const promptGenerator_1 = require("../promptGenerator");
+const stageDetector_1 = require("../stageDetector");
+const artifactLifecycle_1 = require("../artifactLifecycle");
+const correctionState_1 = require("../correctionState");
+const promptGenerator_2 = require("../promptGenerator");
+function buildLifecycleContextBlock(stage, states, stateFile) {
+    const dominantState = states.find((s) => s !== 'complete' && s !== 'missing') ?? states[0];
+    if (dominantState === 'complete')
+        return '';
+    const record = stateFile.artifacts[stage.artifactFile];
+    const reason = record?.reason;
+    const lines = ['=== LIFECYCLE CONTEXT ==='];
+    if (dominantState === 'blocked') {
+        lines.push(`Current artifact state: blocked`);
+        if (reason)
+            lines.push(`Reason: ${reason}`);
+        lines.push('');
+        lines.push('This artifact is blocked. Do not guess or fabricate missing information.');
+        lines.push('Document the blocker clearly in the artifact. Identify what external input');
+        lines.push('or decision is needed before work can continue.');
+    }
+    else if (dominantState === 'incomplete') {
+        lines.push(`Current artifact state: incomplete`);
+        if (reason)
+            lines.push(`Reason: ${reason}`);
+        lines.push('');
+        lines.push('This artifact is marked incomplete. Finish the unfinished sections.');
+        lines.push('Preserve existing content that is already correct. Review and complete');
+        lines.push('what remains before marking this artifact done.');
+    }
+    else if (dominantState === 'stale') {
+        lines.push(`Current artifact state: stale`);
+        lines.push('');
+        lines.push('This artifact is stale - an upstream artifact changed after this one was');
+        lines.push('completed. Reconcile this artifact against the newer upstream artifacts');
+        lines.push('before continuing. Review what changed and update accordingly.');
+    }
+    else {
+        return '';
+    }
+    lines.push('=========================');
+    lines.push('');
+    return lines.join('\n');
+}
+function makePromptCommand() {
+    const cmd = new commander_1.Command('prompt');
+    cmd
+        .description('Print the next stage prompt for the active or selected run')
+        .argument('[stage]', 'specific stage name in lowercase kebab-case (optional)')
+        .option('--run <run-id>', 'select a specific workflow run by ID')
+        .option('--root <path>', 'project root directory (default: current working directory)')
+        .action((stage, options) => {
+        const projectRoot = path.resolve(options.root ?? process.cwd());
+        let meta;
+        if (options.run) {
+            const runFolder = (0, run_1.getRunFolder)(projectRoot, options.run);
+            if (!fs.existsSync(runFolder)) {
+                console.error(`Error: run not found: ${options.run}`);
+                process.exit(1);
+            }
+            try {
+                meta = (0, run_1.loadRun)(runFolder);
+            }
+            catch {
+                console.error(`Error: could not load run: ${options.run}`);
+                process.exit(1);
+            }
+        }
+        else {
+            meta = (0, run_1.getMostRecentRun)(projectRoot);
+            if (!meta) {
+                console.error('No runs found. Run: my-dev-kit-orchestrator start "<request>"');
+                process.exit(1);
+            }
+        }
+        const stateFile = (0, artifactLifecycle_1.readArtifactStateFile)(meta.runFolder);
+        if (stage) {
+            const stageExists = meta.stages.some((s) => s.name === stage);
+            if (!stageExists) {
+                const available = meta.stages.map((s) => s.name).join(', ');
+                console.error(`Error: stage "${stage}" does not exist in ${meta.mode} workflow.\nAvailable stages: ${available}`);
+                process.exit(1);
+            }
+            const missingPrior = (0, stageDetector_1.getMissingPriorArtifacts)(meta, stage);
+            if (missingPrior.length > 0) {
+                console.error(`Warning: the following required prior artifacts are missing:\n` +
+                    missingPrior.map((f) => `  - ${f}`).join('\n') +
+                    `\n\nReturn to the stage that produces the missing artifact before continuing.\n` +
+                    `Next missing stage: ${(0, stageDetector_1.getNextStage)(meta)?.name ?? 'none'}`);
+                process.exit(1);
+            }
+            const stageObj = meta.stages.find((s) => s.name === stage);
+            const states = (0, stageDetector_1.resolveCurrentArtifactStates)(meta, stateFile, stageObj);
+            const lifecycleBlock = buildLifecycleContextBlock(stageObj, states, stateFile);
+            try {
+                const promptText = (0, promptGenerator_1.generateStagePrompt)(meta, stage);
+                process.stdout.write(lifecycleBlock + promptText);
+            }
+            catch (err) {
+                console.error(`Error generating prompt: ${err.message}`);
+                process.exit(1);
+            }
+        }
+        else {
+            if ((0, stageDetector_1.isRunCompleteWithLifecycle)(meta, stateFile)) {
+                if ((0, stageDetector_1.isRunComplete)(meta)) {
+                    console.log(`Run ${meta.runId} is complete - all expected artifacts are present.\n\n` +
+                        `To view the final report:\n  ${path.join(meta.runFolder, 'artifacts/final-report.txt')}\n\n` +
+                        `To inspect run status:\n  my-dev-kit-orchestrator status`);
+                }
+                else {
+                    console.log(`Run ${meta.runId} is complete - all artifacts are in complete state.\n\n` +
+                        `To view the final report:\n  ${path.join(meta.runFolder, 'artifacts/final-report.txt')}\n\n` +
+                        `To inspect run status:\n  my-dev-kit-orchestrator status`);
+                }
+                return;
+            }
+            // Check for active correction routing (judge-report.txt with non-PASS verdict)
+            const correctionState = (0, correctionState_1.readCorrectionState)(meta.runFolder);
+            if (correctionState && correctionState.routeStatus === 'correction_required' && correctionState.routedStage) {
+                try {
+                    const correctionPrompt = (0, promptGenerator_2.generateCorrectionPrompt)(meta, correctionState);
+                    process.stdout.write(correctionPrompt);
+                }
+                catch (err) {
+                    console.error(`Error generating correction prompt: ${err.message}`);
+                    process.exit(1);
+                }
+                return;
+            }
+            if (correctionState && correctionState.routeStatus === 'blocked') {
+                console.log(`Run ${meta.runId} is blocked by judge verdict: ${correctionState.verdict}\n\n` +
+                    `This run requires external resolution (e.g. scope clarification or design restart)\n` +
+                    `before it can continue automatically.\n\n` +
+                    `Inspect the judge report:\n  ${meta.runFolder}/artifacts/judge-report.txt\n\n` +
+                    `To inspect run status:\n  my-dev-kit-orchestrator status`);
+                return;
+            }
+            const nextStage = (0, stageDetector_1.getNextStageWithLifecycle)(meta, stateFile);
+            if (!nextStage) {
+                console.log('No missing stage artifact remains.');
+                return;
+            }
+            const states = (0, stageDetector_1.resolveCurrentArtifactStates)(meta, stateFile, nextStage);
+            const lifecycleBlock = buildLifecycleContextBlock(nextStage, states, stateFile);
+            try {
+                const promptText = (0, promptGenerator_1.generateStagePrompt)(meta, nextStage.name);
+                process.stdout.write(lifecycleBlock + promptText);
+            }
+            catch (err) {
+                console.error(`Error generating prompt: ${err.message}`);
+                process.exit(1);
+            }
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/commands/prompt.js.map

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

package/dist/commands/start.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function makeStartCommand(): Command;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,gBAAgB,IAAI,OAAO,CA6D1C"}

package/dist/commands/start.js

@@ -0,0 +1,100 @@
+"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.makeStartCommand = makeStartCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const types_1 = require("../types");
+const run_1 = require("../run");
+const workspace_1 = require("../workspace");
+function makeStartCommand() {
+    const cmd = new commander_1.Command('start');
+    cmd
+        .description('Start a new workflow run')
+        .argument('<request>', 'the software change request or description')
+        .option('--mode <mode>', `workflow mode (${types_1.VALID_MODES.join(' | ')})`, 'feature')
+        .option('--root <path>', 'project root directory (default: current working directory)')
+        .option('--name <run-name>', 'readable name to include in the run ID')
+        .option('--output-dir <path>', 'custom run output directory')
+        .option('--source <path>', 'source repository root (required for extraction mode)')
+        .option('--target <path>', 'target repository root (required for extraction mode)')
+        .action((request, options) => {
+        if (!(0, types_1.isValidMode)(options.mode)) {
+            console.error(`Error: invalid mode "${options.mode}". Allowed values: ${types_1.VALID_MODES.join(', ')}`);
+            process.exit(1);
+        }
+        if (options.mode === 'extraction') {
+            if (!options.source) {
+                console.error('Error: --source <path> is required for extraction mode');
+                process.exit(1);
+            }
+            if (!options.target) {
+                console.error('Error: --target <path> is required for extraction mode');
+                process.exit(1);
+            }
+        }
+        const sourceRepoRoot = options.source ? path.resolve(options.source) : undefined;
+        const targetRepoRoot = options.target ? path.resolve(options.target) : undefined;
+        // For extraction mode, run artifacts live under the target repository
+        const projectRoot = targetRepoRoot ?? path.resolve(options.root ?? process.cwd());
+        (0, workspace_1.initWorkspace)(projectRoot);
+        try {
+            const meta = (0, run_1.createRun)({
+                request,
+                mode: options.mode,
+                projectRoot,
+                name: options.name,
+                outputDir: options.outputDir ? path.resolve(options.outputDir) : undefined,
+                sourceRepoRoot,
+                targetRepoRoot,
+            });
+            const lines = [`Created workflow run:\n${meta.runFolder}\n\nMode:\n${meta.mode}`];
+            if (meta.sourceRepoRoot) {
+                lines.push(`\nSource repository:\n${meta.sourceRepoRoot}`);
+            }
+            if (meta.targetRepoRoot) {
+                lines.push(`\nTarget repository:\n${meta.targetRepoRoot}`);
+            }
+            lines.push(`\nNext:\n  my-dev-kit-orchestrator prompt`);
+            console.log(lines.join(''));
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function makeStatusCommand(): Command;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,iBAAiB,IAAI,OAAO,CAwI3C"}

package/dist/commands/status.js

@@ -0,0 +1,191 @@
+"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.makeStatusCommand = makeStatusCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const run_1 = require("../run");
+const stageDetector_1 = require("../stageDetector");
+const artifactLifecycle_1 = require("../artifactLifecycle");
+const promptChecker_1 = require("../promptChecker");
+const traceChecker_1 = require("../traceChecker");
+const correctionState_1 = require("../correctionState");
+function lifecycleLabel(status) {
+    const label = `  [${status.lifecycleState.padEnd(10)}] ${status.artifactFile}`;
+    if (status.reason) {
+        return [label, `                Reason: ${status.reason}`];
+    }
+    return [label];
+}
+function makeStatusCommand() {
+    const cmd = new commander_1.Command('status');
+    cmd
+        .description('Show the current or selected workflow run status')
+        .option('--run <run-id>', 'select a specific workflow run by ID')
+        .option('--root <path>', 'project root directory (default: current working directory)')
+        .action((options) => {
+        const projectRoot = path.resolve(options.root ?? process.cwd());
+        let meta;
+        if (options.run) {
+            const runFolder = (0, run_1.getRunFolder)(projectRoot, options.run);
+            if (!fs.existsSync(runFolder)) {
+                console.error(`Error: run not found: ${options.run}`);
+                process.exit(1);
+            }
+            try {
+                meta = (0, run_1.loadRun)(runFolder);
+            }
+            catch {
+                console.error(`Error: could not load run.json for: ${options.run}`);
+                process.exit(1);
+            }
+        }
+        else {
+            meta = (0, run_1.getMostRecentRun)(projectRoot);
+            if (!meta) {
+                console.log('No runs found.\n\nNext:\n  my-dev-kit-orchestrator start "<software change request>"');
+                return;
+            }
+        }
+        const stateFile = (0, artifactLifecycle_1.readArtifactStateFile)(meta.runFolder);
+        const lifecycleStatuses = (0, stageDetector_1.getArtifactLifecycleStatuses)(meta, stateFile);
+        const legacyStatuses = (0, stageDetector_1.getArtifactStatuses)(meta);
+        const nextStage = (0, stageDetector_1.getNextStageWithLifecycle)(meta, stateFile);
+        const presentArtifacts = legacyStatuses.filter((s) => s.present);
+        const nonCompleteArtifacts = lifecycleStatuses.filter((s) => s.lifecycleState !== 'complete');
+        const supportingReports = (0, stageDetector_1.getSupportingReportStatuses)(meta);
+        const lines = [
+            `Run:`,
+            `  ${meta.runId}`,
+            ``,
+            `Mode:`,
+            `  ${meta.mode}`,
+            ``,
+            `Request:`,
+            `  ${meta.request}`,
+            ``,
+            `Run folder:`,
+            `  ${meta.runFolder}`,
+            ``,
+            ...(meta.sourceRepoRoot ? [`Source repository:`, `  ${meta.sourceRepoRoot}`, ``] : []),
+            ...(meta.targetRepoRoot ? [`Target repository:`, `  ${meta.targetRepoRoot}`, ``] : []),
+            `Current / next stage:`,
+            `  ${nextStage ? nextStage.name : '(complete)'}`,
+            ``,
+            `Available prompts:`,
+            ...meta.stages.map((s) => `  - ${s.name}`),
+            ``,
+            `Artifacts:`,
+            ...lifecycleStatuses.flatMap(lifecycleLabel),
+            ``,
+            `Present artifacts: ${presentArtifacts.length}/${legacyStatuses.length}`,
+            `Non-complete artifacts: ${nonCompleteArtifacts.length}`,
+            ``,
+            `Supporting reports:`,
+            ...(supportingReports.length > 0
+                ? supportingReports.map((r) => `  ${r.present ? '[present]' : '[missing]'} ${r.reportFile}`)
+                : [`  (none for this workflow mode)`]),
+            ``,
+        ];
+        // Content check summary
+        const checkResults = (0, promptChecker_1.readCheckResults)(meta.runFolder);
+        if (checkResults) {
+            const aResults = checkResults.artifactResults;
+            const pResults = checkResults.promptResults;
+            const allResults = [...aResults, ...pResults];
+            const pass = allResults.filter((r) => r.passed && !r.issues.some((i) => i.severity === 'warn')).length;
+            const warn = allResults.filter((r) => r.passed && r.issues.some((i) => i.severity === 'warn')).length;
+            const fail = allResults.filter((r) => !r.passed).length;
+            lines.push(`Content check: ${pass} pass, ${warn} warn, ${fail} fail  (run: my-dev-kit-orchestrator check)`);
+        }
+        else {
+            lines.push(`Content check: not run  (run: my-dev-kit-orchestrator check)`);
+        }
+        lines.push(``);
+        // Trace check summary
+        const traceResults = (0, traceChecker_1.readTraceCheckResults)(meta.runFolder);
+        if (traceResults) {
+            const tr = traceResults.traceResults;
+            const pass = tr.filter((r) => r.passed && !r.issues.some((i) => i.severity === 'warn')).length;
+            const warn = tr.filter((r) => r.passed && r.issues.some((i) => i.severity === 'warn')).length;
+            const fail = tr.filter((r) => !r.passed).length;
+            lines.push(`Trace check: ${pass} pass, ${warn} warn, ${fail} fail  (run: my-dev-kit-orchestrator check --trace)`);
+        }
+        else {
+            lines.push(`Trace check: not run  (run: my-dev-kit-orchestrator check --trace)`);
+        }
+        lines.push(``);
+        // Judge correction routing summary
+        const correctionState = (0, correctionState_1.readCorrectionState)(meta.runFolder);
+        if (correctionState) {
+            if (correctionState.routeStatus === 'pass') {
+                lines.push(`Judge correction: PASS - no correction required`);
+            }
+            else if (correctionState.routeStatus === 'correction_required') {
+                lines.push(`Judge correction: ${correctionState.verdict} → correction required`);
+                lines.push(`  Routed stage: ${correctionState.routedStage}`);
+                if (correctionState.warnings.length > 0) {
+                    lines.push(`  Warning: ${correctionState.warnings[0]}`);
+                }
+            }
+            else if (correctionState.routeStatus === 'blocked') {
+                lines.push(`Judge correction: ${correctionState.verdict} - run is blocked`);
+                lines.push(`  This run requires external resolution before it can continue.`);
+            }
+            else if (correctionState.routeStatus === 'unknown_verdict') {
+                lines.push(`Judge correction: unrecognized verdict in judge-report.txt`);
+                if (correctionState.errors.length > 0) {
+                    lines.push(`  Error: ${correctionState.errors[0]}`);
+                }
+            }
+            else if (correctionState.routeStatus === 'missing_verdict') {
+                lines.push(`Judge correction: no verdict found in judge-report.txt`);
+            }
+            lines.push(``);
+        }
+        if (nextStage) {
+            lines.push(`Next:`);
+            lines.push(`  my-dev-kit-orchestrator prompt`);
+        }
+        else {
+            lines.push(`Status: All artifacts complete.`);
+            lines.push(`  my-dev-kit-orchestrator prompt final-report`);
+        }
+        console.log(lines.join('\n'));
+    });
+    return cmd;
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/contractChecker.d.ts

@@ -0,0 +1,53 @@
+import { RunMetadata } from './run';
+export type ArtifactContractSeverity = 'pass' | 'warn' | 'fail';
+export interface ArtifactContractIssue {
+    code: string;
+    severity: ArtifactContractSeverity;
+    message: string;
+    suggestedFix?: string;
+    section?: string;
+}
+export interface ArtifactContractCheckResult {
+    artifactFile: string;
+    artifactKind: string;
+    stageName: string;
+    mode: string;
+    issues: ArtifactContractIssue[];
+    passed: boolean;
+    checkedAt: string;
+}
+export interface RunContractCheckResult {
+    runId: string;
+    mode: string;
+    modeValid: boolean;
+    results: ArtifactContractCheckResult[];
+    modeIssues: ArtifactContractIssue[];
+    checkedAt: string;
+}
+export interface ModeContractSummary {
+    mode: string;
+    stages: Array<{
+        stageName: string;
+        artifactFile: string;
+        artifactKind: string;
+        predecessors: string[];
+        requiredSections: string[];
+    }>;
+}
+export interface ContractCheckOptions {
+    strict?: boolean;
+}
+export declare function isSectionPlaceholderContent(content: string): boolean;
+export declare function checkArtifactContract(runFolder: string, artifactFile: string, stageName: string, mode: string, predecessorFiles: string[], options?: ContractCheckOptions): ArtifactContractCheckResult;
+export declare function checkRunArtifactContracts(meta: RunMetadata, options?: ContractCheckOptions): RunContractCheckResult;
+export interface StageGateViolation {
+    gateName: string;
+    severity: 'fail';
+    message: string;
+    missingArtifact: string;
+    presentArtifact: string;
+    suggestedFix: string;
+}
+export declare function checkStageGates(meta: RunMetadata): StageGateViolation[];
+export declare function resolveArtifactContractsForMode(mode: string): ModeContractSummary | null;
+//# sourceMappingURL=contractChecker.d.ts.map

package/dist/contractChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractChecker.d.ts","sourceRoot":"","sources":["../src/contractChecker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAWpC,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,wBAAwB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAOD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpE;AAqCD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE,oBAAyB,GACjC,2BAA2B,CAoH7B;AAID,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,oBAAyB,GACjC,sBAAsB,CAsExB;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAsBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,EAAE,CA8BvE;AAID,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAoBxF"}