@dailephd/my-dev-kit-orchestrator 1.0.0

package/dist/commands/export.js

@@ -0,0 +1,248 @@
+"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.buildExportText = buildExportText;
+exports.makeExportCommand = makeExportCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const run_1 = require("../run");
+const correctionState_1 = require("../correctionState");
+const traceChecker_1 = require("../traceChecker");
+const promptChecker_1 = require("../promptChecker");
+// ─── Path safety ──────────────────────────────────────────────────────────────
+function isSafePath(outputPath) {
+    // Must be an absolute resolved path (caller should path.resolve first)
+    const resolved = path.resolve(outputPath);
+    // Refuse if the path is a directory
+    if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {
+        return { safe: false, reason: 'output path is a directory' };
+    }
+    // Refuse if the path is a symbolic link
+    try {
+        const lstat = fs.lstatSync(resolved);
+        if (lstat.isSymbolicLink()) {
+            return { safe: false, reason: 'output path is a symbolic link' };
+        }
+    }
+    catch {
+        // File does not exist -- that is fine
+    }
+    // Refuse path traversal sequences in the raw argument
+    if (outputPath.includes('..')) {
+        return { safe: false, reason: 'output path contains path traversal (..)' };
+    }
+    return { safe: true };
+}
+// ─── Format helpers ───────────────────────────────────────────────────────────
+function sectionHeader(title) {
+    return `\n=== ${title} ===\n`;
+}
+function artifactChecklist(runFolder, stages) {
+    const lines = [];
+    for (const stage of stages) {
+        const fullPath = path.join(runFolder, stage.artifactFile);
+        const exists = fs.existsSync(fullPath);
+        const marker = exists ? '[present]' : '[missing]';
+        lines.push(`  ${marker} ${stage.artifactFile} (${stage.name})`);
+    }
+    return lines.join('\n');
+}
+function formatCorrectionState(runFolder) {
+    const state = (0, correctionState_1.readCorrectionState)(runFolder);
+    if (!state)
+        return '  no judge report';
+    if (state.routeStatus === 'pass')
+        return '  PASS -- no correction required';
+    if (state.routeStatus === 'correction_required') {
+        return `  ${state.verdict} -> correction required (routed stage: ${state.routedStage})`;
+    }
+    if (state.routeStatus === 'blocked') {
+        return `  ${state.verdict} -- run is blocked (external resolution required)`;
+    }
+    return `  ${state.routeStatus}`;
+}
+function readJudgeVerdict(runFolder) {
+    const p = path.join(runFolder, 'artifacts', 'judge-report.txt');
+    if (!fs.existsSync(p))
+        return '  no judge report';
+    const state = (0, correctionState_1.readCorrectionState)(runFolder);
+    if (!state || !state.verdict)
+        return '  judge report present but verdict not parsed';
+    return `  ${state.verdict}`;
+}
+function readVerificationEvidence(runFolder) {
+    const p = path.join(runFolder, 'artifacts', 'verification-report.txt');
+    if (!fs.existsSync(p))
+        return '  no verification report';
+    const content = fs.readFileSync(p, 'utf8');
+    const lines = content.split('\n');
+    // Extract up to 20 lines of evidence summary (first non-empty lines)
+    const evidence = lines.filter((l) => l.trim()).slice(0, 20);
+    if (evidence.length === 0)
+        return '  verification report is empty';
+    return evidence.map((l) => `  ${l}`).join('\n');
+}
+function formatTraceCheckSummary(runFolder) {
+    const results = (0, traceChecker_1.readTraceCheckResults)(runFolder);
+    if (!results)
+        return '  trace check not run';
+    const tr = results.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;
+    return `  trace: ${pass} pass, ${fail} fail, ${warn} warn (checked: ${results.checkedAt})`;
+}
+function formatCheckResultsSummary(runFolder) {
+    const results = (0, promptChecker_1.readCheckResults)(runFolder);
+    if (!results)
+        return '  content check not run';
+    const ar = results.artifactResults;
+    const aPass = ar.filter((r) => r.passed && !r.issues.some((i) => i.severity === 'warn')).length;
+    const aWarn = ar.filter((r) => r.passed && r.issues.some((i) => i.severity === 'warn')).length;
+    const aFail = ar.filter((r) => !r.passed).length;
+    return `  content check: ${aPass} pass, ${aFail} fail, ${aWarn} warn (checked: ${results.checkedAt})`;
+}
+function listMissingArtifacts(runFolder, stages) {
+    const missing = stages.filter((s) => !fs.existsSync(path.join(runFolder, s.artifactFile)));
+    if (missing.length === 0)
+        return '  none';
+    return missing.map((s) => `  missing: ${s.artifactFile} (${s.name})`).join('\n');
+}
+function formatNextCommand(meta) {
+    const correctionState = (0, correctionState_1.readCorrectionState)(meta.runFolder);
+    if (correctionState && correctionState.routeStatus === 'correction_required') {
+        return `  my-dev-kit-orchestrator prompt --run ${meta.runId}  # correction: ${correctionState.routedStage}`;
+    }
+    if (correctionState && correctionState.routeStatus === 'blocked') {
+        return `  # run is blocked -- resolve externally, then: my-dev-kit-orchestrator status --run ${meta.runId}`;
+    }
+    return `  my-dev-kit-orchestrator prompt --run ${meta.runId}`;
+}
+// ─── Export format builder ────────────────────────────────────────────────────
+function buildExportText(meta) {
+    const parts = [];
+    parts.push('my-dev-kit-orchestrator run handoff export');
+    parts.push(`Generated: ${new Date().toISOString()}`);
+    parts.push(sectionHeader('Run identity'));
+    parts.push(`  Run ID:       ${meta.runId}`);
+    parts.push(`  Mode:         ${meta.mode}`);
+    parts.push(`  Status:       ${meta.status}`);
+    parts.push(`  Created:      ${meta.createdAt}`);
+    parts.push(`  Current stage: ${meta.currentStage}`);
+    parts.push(`  Run folder:   ${meta.runFolder}`);
+    parts.push(sectionHeader('Request'));
+    parts.push(`  ${meta.request}`);
+    parts.push(sectionHeader('Artifact checklist'));
+    parts.push(artifactChecklist(meta.runFolder, meta.stages));
+    parts.push(sectionHeader('Missing artifacts'));
+    parts.push(listMissingArtifacts(meta.runFolder, meta.stages));
+    parts.push(sectionHeader('Judge verdict'));
+    parts.push(readJudgeVerdict(meta.runFolder));
+    parts.push(sectionHeader('Correction state'));
+    parts.push(formatCorrectionState(meta.runFolder));
+    parts.push(sectionHeader('Verification evidence'));
+    parts.push(readVerificationEvidence(meta.runFolder));
+    parts.push(sectionHeader('Check summaries'));
+    parts.push(formatCheckResultsSummary(meta.runFolder));
+    parts.push(formatTraceCheckSummary(meta.runFolder));
+    parts.push(sectionHeader('Next command'));
+    parts.push(formatNextCommand(meta));
+    parts.push('');
+    return parts.join('\n');
+}
+// ─── Command ──────────────────────────────────────────────────────────────────
+function makeExportCommand() {
+    const cmd = new commander_1.Command('export');
+    cmd
+        .description('Export a portable plain-text run handoff for use in another session or agent')
+        .option('--run <run-id>', 'select a specific workflow run by ID')
+        .option('--root <path>', 'project root directory (default: current working directory)')
+        .option('--out <file>', 'write export to this file (default: print to stdout)')
+        .option('--overwrite', 'allow overwriting an existing output file (default: refuse if file exists)')
+        .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 exportText = buildExportText(meta);
+        if (!options.out) {
+            process.stdout.write(exportText);
+            return;
+        }
+        const outPath = path.resolve(options.out);
+        // Path safety checks
+        const safety = isSafePath(outPath);
+        if (!safety.safe) {
+            console.error(`Error: output path rejected: ${safety.reason}`);
+            process.exit(1);
+        }
+        // Refuse to overwrite unless --overwrite is set
+        if (fs.existsSync(outPath) && !options.overwrite) {
+            console.error(`Error: output file already exists: ${outPath}\n` +
+                `Use --overwrite to replace it.`);
+            process.exit(1);
+        }
+        // Ensure parent directory exists
+        const outDir = path.dirname(outPath);
+        if (!fs.existsSync(outDir)) {
+            console.error(`Error: output directory does not exist: ${outDir}`);
+            process.exit(1);
+        }
+        fs.writeFileSync(outPath, exportText, 'utf8');
+        console.log(`Export written to: ${outPath}`);
+    });
+    return cmd;
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

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

package/dist/commands/init.d.ts

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

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

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

package/dist/commands/init.js

@@ -0,0 +1,59 @@
+"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.makeInitCommand = makeInitCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const workspace_1 = require("../workspace");
+function makeInitCommand() {
+    const cmd = new commander_1.Command('init');
+    cmd
+        .description('Initialize the my-dev-kit-orchestrator workspace inside the current project')
+        .option('--root <path>', 'project root directory (default: current working directory)')
+        .action((options) => {
+        const projectRoot = path.resolve(options.root ?? process.cwd());
+        const alreadyExists = (0, workspace_1.workspaceExists)(projectRoot);
+        (0, workspace_1.initWorkspace)(projectRoot);
+        const wsDir = (0, workspace_1.getWorkspaceRoot)(projectRoot);
+        if (alreadyExists) {
+            console.log(`Workspace already initialized at:\n${wsDir}`);
+        }
+        else {
+            console.log(`Initialized my-dev-kit-orchestrator workspace.\n\nWorkspace:\n${wsDir}\n\nNext:\n  my-dev-kit-orchestrator start "<software change request>"`);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,0CAmBC;AAvBD,yCAAoC;AACpC,2CAA6B;AAC7B,4CAAgF;AAEhF,SAAgB,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,mBAAO,CAAC,MAAM,CAAC,CAAC;IAChC,GAAG;SACA,WAAW,CAAC,6EAA6E,CAAC;SAC1F,MAAM,CAAC,eAAe,EAAE,6DAA6D,CAAC;SACtF,MAAM,CAAC,CAAC,OAA0B,EAAE,EAAE;QACrC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAChE,MAAM,aAAa,GAAG,IAAA,2BAAe,EAAC,WAAW,CAAC,CAAC;QAEnD,IAAA,yBAAa,EAAC,WAAW,CAAC,CAAC;QAE3B,MAAM,KAAK,GAAG,IAAA,4BAAgB,EAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,iEAAiE,KAAK,wEAAwE,CAAC,CAAC;QAC9J,CAAC;IACH,CAAC,CAAC,CAAC;IACL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/list.d.ts

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

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

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

package/dist/commands/list.js

@@ -0,0 +1,101 @@
+"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.makeListCommand = makeListCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const types_1 = require("../types");
+const run_1 = require("../run");
+const stageDetector_1 = require("../stageDetector");
+function makeListCommand() {
+    const cmd = new commander_1.Command('list');
+    cmd
+        .description('List previous workflow runs')
+        .option('--mode <mode>', `filter by workflow mode (${types_1.VALID_MODES.join(' | ')})`)
+        .option('--root <path>', 'project root directory (default: current working directory)')
+        .action((options) => {
+        if (options.mode !== undefined && !(0, types_1.isValidMode)(options.mode)) {
+            console.error(`Error: invalid mode "${options.mode}". Allowed values: ${types_1.VALID_MODES.join(', ')}`);
+            process.exit(1);
+        }
+        const projectRoot = path.resolve(options.root ?? process.cwd());
+        const folders = (0, run_1.listRunFolders)(projectRoot);
+        if (folders.length === 0) {
+            console.log('No runs found.\n\nNext:\n  my-dev-kit-orchestrator start "<software change request>"');
+            return;
+        }
+        const runs = folders
+            .map((folder) => {
+            try {
+                return (0, run_1.loadRun)(folder);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((r) => r !== null);
+        const filtered = options.mode
+            ? runs.filter((r) => r.mode === options.mode)
+            : runs;
+        if (filtered.length === 0) {
+            console.log(`No runs found for mode: ${options.mode}`);
+            return;
+        }
+        const lines = [];
+        for (const meta of filtered) {
+            if (!meta)
+                continue;
+            const nextStage = (0, stageDetector_1.getNextStage)(meta);
+            const requestLabel = meta.request.length > 60
+                ? meta.request.slice(0, 57) + '...'
+                : meta.request;
+            const status = nextStage ? 'in_progress' : 'complete';
+            const currentStage = nextStage ? nextStage.name : '(complete)';
+            lines.push(`─────────────────────────────────────────────`);
+            lines.push(`Run ID:       ${meta.runId}`);
+            lines.push(`Mode:         ${meta.mode}`);
+            lines.push(`Request:      ${requestLabel}`);
+            lines.push(`Status:       ${status}`);
+            lines.push(`Created:      ${meta.createdAt}`);
+            lines.push(`Next stage:   ${currentStage}`);
+            lines.push(`Run folder:   ${meta.runFolder}`);
+        }
+        lines.push(`─────────────────────────────────────────────`);
+        lines.push(`Total: ${filtered.length} run(s)`);
+        console.log(lines.join('\n'));
+    });
+    return cmd;
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/mark.d.ts

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

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

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

package/dist/commands/mark.js

@@ -0,0 +1,139 @@
+"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.makeMarkCommand = makeMarkCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const run_1 = require("../run");
+const fs = __importStar(require("fs"));
+const artifactLifecycle_1 = require("../artifactLifecycle");
+const artifactLifecycle_2 = require("../artifactLifecycle");
+function resolveArtifactKey(artifactName, runFolder, stages) {
+    const allFiles = [];
+    for (const stage of stages) {
+        allFiles.push(stage.artifactFile);
+        if (stage.additionalArtifactFiles) {
+            allFiles.push(...stage.additionalArtifactFiles);
+        }
+    }
+    // Exact match first (e.g., artifacts/request-brief.txt)
+    if (allFiles.includes(artifactName))
+        return artifactName;
+    // Basename match (e.g., request-brief.txt)
+    const baseName = path.basename(artifactName);
+    return allFiles.find((f) => path.basename(f) === baseName);
+}
+function makeMarkCommand() {
+    const cmd = new commander_1.Command('mark');
+    cmd
+        .description('Manually set the lifecycle state of a run artifact')
+        .argument('<artifact-name>', 'artifact filename (e.g., request-brief.txt)')
+        .requiredOption('--state <state>', 'lifecycle state: incomplete | blocked | complete')
+        .option('--reason <reason>', 'reason for the state change (required for blocked and incomplete)')
+        .option('--run <run-id>', 'select a specific workflow run by ID')
+        .option('--root <path>', 'project root directory (default: current working directory)')
+        .action((artifactName, options) => {
+        const projectRoot = path.resolve(options.root ?? process.cwd());
+        if ((0, artifactLifecycle_1.isForbiddenManualState)(options.state)) {
+            console.error(`Error: "${options.state}" cannot be set manually.\n` +
+                `  "missing" is computed from file absence.\n` +
+                `  "stale" is computed from upstream artifact timestamps.\n` +
+                `Allowed manual states: incomplete, blocked, complete`);
+            process.exit(1);
+        }
+        if (!(0, artifactLifecycle_1.isManualState)(options.state)) {
+            console.error(`Error: invalid state "${options.state}".\n` +
+                `Allowed manual states: incomplete, blocked, complete`);
+            process.exit(1);
+        }
+        const state = options.state;
+        if ((state === 'blocked' || state === 'incomplete') && !options.reason) {
+            console.error(`Error: --reason is required when marking an artifact as ${state}.\n` +
+                `Example: my-dev-kit-orchestrator mark ${artifactName} --state ${state} --reason "Explain why"`);
+            process.exit(1);
+        }
+        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.error('No runs found. Run: my-dev-kit-orchestrator start "<request>"');
+                process.exit(1);
+            }
+        }
+        const artifactKey = resolveArtifactKey(artifactName, meta.runFolder, meta.stages);
+        if (!artifactKey) {
+            const knownArtifacts = meta.stages.flatMap((s) => [
+                s.artifactFile,
+                ...(s.additionalArtifactFiles ?? []),
+            ]);
+            console.error(`Error: unknown artifact "${artifactName}".\n` +
+                `Known artifacts for this run:\n` +
+                knownArtifacts.map((f) => `  - ${path.basename(f)}`).join('\n'));
+            process.exit(1);
+        }
+        (0, artifactLifecycle_1.setArtifactManualState)(meta.runFolder, artifactKey, state, {
+            reason: options.reason,
+        });
+        // Warn if marking complete but file is missing
+        if (state === 'complete') {
+            const stateFile = (0, artifactLifecycle_1.readArtifactStateFile)(meta.runFolder);
+            const effectiveState = (0, artifactLifecycle_2.resolveArtifactState)(meta.runFolder, artifactKey, meta.stages, stateFile);
+            if (effectiveState === 'missing') {
+                console.warn(`Warning: "${path.basename(artifactKey)}" was marked complete but the artifact file does not exist.\n` +
+                    `  Effective state remains: missing\n` +
+                    `  Create the file before the stage can be considered complete.`);
+            }
+        }
+        const reasonMsg = options.reason ? ` - ${options.reason}` : '';
+        console.log(`Marked ${path.basename(artifactKey)} as ${state}${reasonMsg}\n` +
+            `Run: ${meta.runId}`);
+    });
+    return cmd;
+}
+//# sourceMappingURL=mark.js.map

package/dist/commands/mark.js.map

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

package/dist/commands/prompt.d.ts

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

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

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