my-dev-kit-orchestrator 0.2.0

package/README.md

@@ -0,0 +1,206 @@
+# my-dev-kit-orchestrator
+
+`my-dev-kit-orchestrator` is a CLI-first workflow shell for design-first software development with coding agents.
+
+It is for teams or individual developers who want a coding agent to work through a bounded sequence of design, pseudocode, testing, implementation, and verification steps instead of jumping straight from a raw request to code.
+
+## Capabilities
+
+`v0.1.0` provided the workflow shell:
+
+- a small CLI command surface
+- five workflow modes: `feature`, `repair`, `test`, `refactor`, `harden`
+- local run folders under `.my-dev-kit-orchestrator/runs/`
+- stage-specific prompt generation
+- plain-text prompt and artifact files
+- simple stage advancement based on expected artifact file existence
+
+`v0.2.0` added graph-guided architecture context support:
+
+- architecture-context stage prompt now guides the coding agent through graph-guided context acquisition with `my-dev-kit`
+- generated prompt includes the full retrieval sequence, retrieval evidence report template, and ArchitectureContextPacket template
+- `status` command shows supporting report presence for the architecture-context stage
+- stage progression remains based on required artifact presence only
+
+The CLI owns workflow order and prompt generation. Each run advances as the expected artifact files appear on disk.
+
+## How it works with my-dev-kit
+
+`my-dev-kit` and `my-dev-kit-orchestrator` have different responsibilities.
+
+- `my-dev-kit` retrieves bounded project context through graph-guided architecture context workflows such as indexing, search, lookup, slice generation, source retrieval, and optional semantic inspection
+- `my-dev-kit-orchestrator` organizes the staged design-to-code workflow after context acquisition
+- the coding agent records retrieval evidence in `reports/architecture-context-retrieval-report.txt`
+- the coding agent synthesizes that evidence into `artifacts/architecture-context-packet.txt`
+- downstream stages consume the ArchitectureContextPacket rather than raw retrieval output
+
+See [ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/WORKFLOWS.md](docs/WORKFLOWS.md), and [docs/ARTIFACTS.md](docs/ARTIFACTS.md) for the detailed design.
+
+## Non-goals for v0.1.0
+
+Version `0.1.0` does not include:
+
+- direct LLM execution
+- automatic coding-agent execution
+- automatic `my-dev-kit` command execution
+- full JSON schema validation for artifacts
+- automatic judge routing
+- design-map generation
+- extra low-level CLI commands beyond `init`, `start`, `status`, `prompt`, and `list`
+
+Architecture-context prompts may suggest use of `my-dev-kit` when it is available, but `my-dev-kit-orchestrator` does not run `my-dev-kit` automatically.
+
+## Command surface
+
+```text
+my-dev-kit-orchestrator init
+my-dev-kit-orchestrator start "<request>"
+my-dev-kit-orchestrator start --mode <feature|repair|test|refactor|harden> "<request>"
+my-dev-kit-orchestrator status
+my-dev-kit-orchestrator status --run <run-id>
+my-dev-kit-orchestrator prompt
+my-dev-kit-orchestrator prompt <stage>
+my-dev-kit-orchestrator prompt <stage> --run <run-id>
+my-dev-kit-orchestrator list
+my-dev-kit-orchestrator list --mode <mode>
+```
+
+Common flags:
+
+- `--root <path>`: use a specific project root
+- `--mode <mode>`: choose the workflow mode for `start`
+- `--name <run-name>`: use a readable suffix in the run ID
+- `--run <run-id>`: target a specific run for `status` or `prompt`
+- `--output-dir <path>`: write runs outside the default workspace
+
+## Quick start
+
+1. Install dependencies and build the CLI:
+
+   ```bash
+   npm install
+   npm run build
+   ```
+
+2. Initialize the workspace in your project:
+
+   ```bash
+   node dist/cli.js init
+   ```
+
+3. Start a workflow run:
+
+   ```bash
+   node dist/cli.js start "add audit logging to the export command"
+   ```
+
+4. Print the next stage prompt:
+
+   ```bash
+   node dist/cli.js prompt
+   ```
+
+5. Paste the prompt into your coding tool of choice and save the returned artifact into the run folder.
+
+6. Continue stage by stage:
+
+   ```bash
+   node dist/cli.js status
+   node dist/cli.js prompt
+   node dist/cli.js list
+   ```
+
+If you link the package locally, you can use the installed command directly:
+
+```bash
+npm link
+my-dev-kit-orchestrator --help
+```
+
+## Supported modes
+
+### `feature`
+
+Use for new behavior or intentional behavior changes.
+
+Stage order:
+`request-brief -> architecture-context -> behavior-model -> pseudocode-packet -> test-strategy -> implementation -> test-implementation -> verification -> judge -> final-report`
+
+### `repair`
+
+Use when observed behavior diverges from intended design.
+
+Stage order:
+`observed-behavior-report -> architecture-context -> behavior-trace -> divergence-report -> correction-design -> regression-test-strategy -> implementation -> test-implementation -> verification -> judge -> final-report`
+
+### `test`
+
+Use for behavior-derived test design or test implementation for existing behavior.
+
+Stage order:
+`test-target-brief -> architecture-context -> behavior-reconstruction -> pseudocode-summary -> test-strategy -> test-implementation -> verification -> judge -> final-report`
+
+### `refactor`
+
+Use for structure changes that must preserve behavior.
+
+Stage order:
+`refactor-brief -> architecture-context -> existing-behavior-map -> preserved-invariant-list -> compatibility-test-strategy -> refactor-pseudocode-packet -> implementation -> test-implementation -> verification -> judge -> final-report`
+
+### `harden`
+
+Use for validation, guard, resilience, and failure-handling work.
+
+Stage order:
+`hardening-brief -> architecture-context -> assumption-report -> failure-mode-matrix -> guard-pseudocode-packet -> resilience-test-strategy -> implementation -> test-implementation -> verification -> judge -> final-report`
+
+## Run folder layout
+
+Each run lives under `.my-dev-kit-orchestrator/runs/<run-id>/`.
+
+```text
+.my-dev-kit-orchestrator/
+  config.json
+  runs/
+    <run-id>/
+      00-request.txt
+      run.json
+      prompts/
+      artifacts/
+      reports/
+```
+
+Key files and folders:
+
+- `00-request.txt`: the original request passed to `start`
+- `run.json`: run metadata, mode, and ordered stage definitions
+- `prompts/`: generated stage prompt files such as `01-request-brief.prompt.txt`
+- `artifacts/`: stage outputs such as `request-brief.txt` and `pseudocode-packet.txt`
+- `reports/`: reserved run folder for report-oriented outputs and future expansion
+
+The next stage is determined by the first expected artifact file that is missing for the current workflow.
+
+## Install, build, test
+
+```bash
+npm install
+npm run build
+npx tsc --noEmit
+npm test
+```
+
+Optional local lint check:
+
+```bash
+npm run lint
+```
+
+## Documentation
+
+- [ARCHITECTURE.md](docs/ARCHITECTURE.md)
+- [docs/USAGE.md](docs/USAGE.md)
+- [docs/WORKFLOWS.md](docs/WORKFLOWS.md)
+- [docs/ARTIFACTS.md](docs/ARTIFACTS.md)
+- [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)
+- [CHANGELOG.md](CHANGELOG.md)
+- [ROADMAP.md](docs/ROADMAP.md)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const program_1 = require("./program");
+const program = (0, program_1.createProgram)();
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA,uCAA0C;AAE1C,MAAM,OAAO,GAAG,IAAA,uBAAa,GAAE,CAAC;AAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

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/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;AAOpC,wBAAgB,iBAAiB,IAAI,OAAO,CAmF3C"}

package/dist/commands/prompt.js

@@ -0,0 +1,122 @@
+"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");
+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);
+            }
+        }
+        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);
+            }
+            try {
+                const promptText = (0, promptGenerator_1.generateStagePrompt)(meta, stage);
+                process.stdout.write(promptText);
+            }
+            catch (err) {
+                console.error(`Error generating prompt: ${err.message}`);
+                process.exit(1);
+            }
+        }
+        else {
+            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`);
+                return;
+            }
+            const nextStage = (0, stageDetector_1.getNextStage)(meta);
+            if (!nextStage) {
+                console.log('No missing stage artifact remains.');
+                return;
+            }
+            try {
+                const promptText = (0, promptGenerator_1.generateStagePrompt)(meta, nextStage.name);
+                process.stdout.write(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,CAoC1C"}

package/dist/commands/start.js

@@ -0,0 +1,75 @@
+"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')
+        .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);
+        }
+        const projectRoot = 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,
+            });
+            console.log(`Created workflow run:\n${meta.runFolder}\n\nMode:\n${meta.mode}\n\nNext:\n  my-dev-kit-orchestrator prompt`);
+        }
+        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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,4CAoCC;AA1CD,yCAAoC;AACpC,2CAA6B;AAC7B,oCAAoD;AACpD,gCAAmC;AACnC,4CAA6C;AAE7C,SAAgB,gBAAgB;IAC9B,MAAM,GAAG,GAAG,IAAI,mBAAO,CAAC,OAAO,CAAC,CAAC;IACjC,GAAG;SACA,WAAW,CAAC,0BAA0B,CAAC;SACvC,QAAQ,CAAC,WAAW,EAAE,4CAA4C,CAAC;SACnE,MAAM,CAAC,eAAe,EAAE,kBAAkB,mBAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC;SAChF,MAAM,CAAC,eAAe,EAAE,6DAA6D,CAAC;SACtF,MAAM,CAAC,mBAAmB,EAAE,wCAAwC,CAAC;SACrE,MAAM,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;SAC5D,MAAM,CAAC,CAAC,OAAe,EAAE,OAA2E,EAAE,EAAE;QACvG,IAAI,CAAC,IAAA,mBAAW,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,CAAC,IAAI,sBAAsB,mBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAChE,IAAA,yBAAa,EAAC,WAAW,CAAC,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,eAAS,EAAC;gBACrB,OAAO;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,WAAW;gBACX,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3E,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CACT,0BAA0B,IAAI,CAAC,SAAS,cAAc,IAAI,CAAC,IAAI,6CAA6C,CAC7G,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IACL,OAAO,GAAG,CAAC;AACb,CAAC"}

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;AAMpC,wBAAgB,iBAAiB,IAAI,OAAO,CA+E3C"}