sdx-cli 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dana0550
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,266 @@
+<p align="center">
+  <img src="./assets/readme/banner_v2.png" alt="SDX hero" width="100%" />
+</p>
+
+<h1 align="center">SDX CLI</h1>
+
+<p align="center">
+  System design intelligence across many repositories, with one docs-first workspace.
+</p>
+
+<p align="center">
+  <a href="https://github.com/dana0550/system-desiigner/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/dana0550/system-desiigner/ci.yml?branch=main&label=CI" alt="CI"></a>
+  <a href="https://github.com/dana0550/system-desiigner/actions/workflows/release.yml"><img src="https://img.shields.io/github/actions/workflow/status/dana0550/system-desiigner/release.yml?branch=main&label=Release" alt="Release"></a>
+  <a href="https://github.com/dana0550/system-desiigner/releases"><img src="https://img.shields.io/github/v/release/dana0550/system-desiigner" alt="GitHub release"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D20-339933" alt="Node 20+">
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-0E8A92" alt="MIT"></a>
+</p>
+
+<p align="center">
+  <a href="#one-command-setup">One-Command Setup</a> •
+  <a href="#daily-workflow">Daily Workflow</a> •
+  <a href="#for-codex-agents">For Codex Agents</a> •
+  <a href="#release-process">Release Process</a>
+</p>
+
+## What SDX is
+SDX gives your team a single architecture workspace that sits above service repos.
+
+You use it to:
+- map services across repos,
+- track contracts,
+- review new service plans,
+- draft cross-team integration handoffs,
+- publish cross-repo spec-system contract-change PRs,
+- generate Codex-ready context packs.
+
+v1 remains manual-triggered. SDX can open draft notice PRs when you run publish commands, but it does not autonomously mutate runtime infrastructure.
+
+## One-Command Setup
+### Org Initialization
+Run this to initialize SDX for a GitHub org:
+
+```bash
+npx --yes sdx-cli@latest bootstrap quick <org>
+```
+
+Default naming rule:
+- org-only input uses `<org>-system-designer` as the design repo/workspace name.
+- explicit `<org>/<design-repo>` remains fully supported as an override.
+
+This requires `sdx-cli` to be available on npm.
+
+Examples:
+
+```bash
+# default design repo name: <org>-system-designer
+npx --yes sdx-cli@latest bootstrap quick dana0550
+
+# explicit design repo name override
+npx --yes sdx-cli@latest bootstrap quick dana0550/platform-architecture
+```
+
+If npm publishing is not enabled yet in your org, use source mode:
+
+```bash
+git clone https://github.com/dana0550/system-desiigner.git
+cd system-desiigner
+npm ci && npm run build
+node ./bin/run.js bootstrap quick <org>
+```
+
+This creates a dedicated workspace and a pinned wrapper script:
+- `.sdx/config.json`
+- `.sdx/install.json`
+- `scripts/sdx`
+
+Then run:
+
+```bash
+cd ./<org>-system-designer
+./scripts/sdx status
+```
+
+### Quick bootstrap flags
+```bash
+npx --yes sdx-cli@latest bootstrap quick dana0550 \
+  --seed \
+  --createRemote
+```
+
+- `--seed`: auto-runs repo sync + default map seed (`all-services`) when `GITHUB_TOKEN` is present.
+- `--createRemote` (alias: `--create-remote`): creates the design repo remotely (dedicated mode).
+- `--inPlace` (alias: `--in-place`): initialize current directory instead of `./<design-repo>`.
+- `--dir <path>`: override target directory.
+- `--pin <version>`: pin wrapper to a specific CLI version.
+
+## Daily Workflow
+From your SDX workspace root:
+
+```bash
+./scripts/sdx repo sync --org <org>
+./scripts/sdx repo add --name <repo-name> --path </abs/path/to/local/clone>
+
+./scripts/sdx map create platform-core --org <org>
+./scripts/sdx map include platform-core repo-a repo-b
+./scripts/sdx map exclude platform-core legacy-repo
+./scripts/sdx map build platform-core
+
+./scripts/sdx contracts extract --map platform-core
+./scripts/sdx docs generate --map platform-core
+```
+
+For planning and rollout:
+
+```bash
+./scripts/sdx plan review --map platform-core --plan ./plans/new-service.md
+./scripts/sdx service propose --map platform-core --brief ./plans/new-service-brief.md
+./scripts/sdx handoff draft --map platform-core --service payments-orchestrator
+```
+
+For Codex:
+
+```bash
+./scripts/sdx codex run implementation-plan --map platform-core --input ./plans/new-service.md
+```
+
+## Cross-Repo Tech-Lead PRs (Spec-System Native)
+Use this flow when SDX should create real `CC-*` contract-change PRs in downstream repos that have spec-system initialized.
+
+```bash
+# 1) Publish contract-change assignments (draft PRs by default)
+./scripts/sdx publish notices --map platform-core --source-repo spec-system
+
+# optionally publish one CC only
+./scripts/sdx publish notices --map platform-core --source-repo spec-system --contract-change-id CC-101
+
+# service onboarding mode: build source CC (`change_type: service_added`) from plan, then publish downstream PRs
+./scripts/sdx publish notices --map platform-core --source-repo spec-system \
+  --notice-type service \
+  --plan ./plans/new-service-notice.md
+
+# make PRs ready-for-review instead of drafts
+./scripts/sdx publish notices --map platform-core --source-repo spec-system --ready
+
+# dry run preview
+./scripts/sdx publish notices --map platform-core --source-repo spec-system --dry-run
+
+# 2) Refresh lifecycle state from existing PR URLs
+./scripts/sdx publish sync --map platform-core --source-repo spec-system
+```
+
+Notes:
+- SDX creates/updates target repo spec-system artifacts:
+  - `docs/CONTRACT_CHANGES.md`
+  - `docs/contracts/CC-###-<slug>.md`
+- If a target repo is missing valid spec-system docs, publish fails fast with an explicit error.
+- Source writeback still uses source sync PRs (no direct default-branch writes).
+- Tokens need `contents:write` and `pull_requests:write` on source + target repos.
+
+### Service Plan Requirements (`--notice-type service --plan <file>`)
+The plan file must include these sections:
+
+- `## Service Identity` with bullets for `service_id` and/or `name`
+- `## Summary`
+- `## Contract Surface`
+- `## Compatibility and Migration Guidance`
+- `## Target Repositories` with table columns: `repo | owner | context`
+
+## Prompt-Driven Scope Edits
+Preview first, apply second:
+
+```bash
+./scripts/sdx prompt "exclude legacy-repo from map" --map platform-core
+./scripts/sdx prompt "exclude legacy-repo from map" --map platform-core --apply
+```
+
+## For Codex Agents
+Use this minimal runbook when an agent needs architecture context quickly:
+
+1. `./scripts/sdx status`
+2. `./scripts/sdx map status <map-id>`
+3. `./scripts/sdx map build <map-id>`
+4. `./scripts/sdx contracts extract --map <map-id>`
+5. `./scripts/sdx codex run <task-type> --map <map-id> --input <file>`
+
+Where outputs land:
+- `maps/<map-id>/service-map.json|md|mmd`
+- `maps/<map-id>/contracts.json|md`
+- `codex/context-packs/*.json`
+- `codex/runs/*.md|json`
+
+## Command Surface
+```bash
+sdx init
+sdx bootstrap org
+sdx bootstrap consumer
+sdx bootstrap quick
+
+sdx repo sync
+sdx repo add
+
+sdx map create|include|exclude|remove-override|status|build
+sdx prompt
+
+sdx contracts extract
+sdx docs generate
+sdx plan review
+sdx service propose
+sdx handoff draft
+sdx publish notices|sync|wiki
+sdx codex run
+
+sdx status
+sdx version
+sdx migrate artifacts
+```
+
+Full help:
+
+```bash
+sdx --help
+sdx <topic> --help
+sdx <topic> <command> --help
+```
+
+## Release Process
+This repo uses Changesets and releases from `main`.
+
+- Add a changeset for user-facing changes:
+  - `npm run changeset`
+- Merges to `main` trigger the release workflow.
+- Workflow behavior:
+  - versions packages from pending changesets,
+  - commits and pushes the release version/changelog to `main`,
+  - publishes to npm,
+  - creates a GitHub Release tag (`vX.Y.Z`).
+- Manual recovery mode:
+  - run the `release` workflow via `workflow_dispatch` with `publish_existing=true` to publish the current `package.json` version when prior npm publish failed.
+- Publish prerequisites:
+  - configure npm auth for CI (`NPM_TOKEN` repo secret),
+  - allow workflow pushes to `main` under your branch protection policy.
+
+Maintainer commands:
+
+```bash
+npm run version-packages
+npm run release
+```
+
+## Environment
+```bash
+export GITHUB_TOKEN=<token>
+export CODEX_CMD=<optional-codex-binary-name>
+```
+
+## Local Development
+```bash
+npm ci
+npm run typecheck
+npm test
+npm run build
+node ./bin/run.js --help
+```
+
+## License
+MIT

package/bin/dev.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+const {spawnSync} = require('node:child_process')
+const path = require('node:path')
+
+const tsxBin = path.join(__dirname, '..', 'node_modules', '.bin', process.platform === 'win32' ? 'tsx.cmd' : 'tsx')
+const result = spawnSync(tsxBin, ['src/index.ts', ...process.argv.slice(2)], {
+  stdio: 'inherit',
+})
+
+process.exit(result.status ?? 1)

package/bin/run.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/index').run().catch(require('@oclif/core/handle'))

package/dist/commands/bootstrap/consumer.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const bootstrapConsumer_1 = require("../../lib/bootstrapConsumer");
+class BootstrapConsumerCommand extends core_1.Command {
+    static description = 'Initialize an sdx workspace for use in another org/repository';
+    static flags = {
+        org: core_1.Flags.string({ char: 'o', required: true, description: 'GitHub organization name' }),
+        designRepo: core_1.Flags.string({
+            required: true,
+            aliases: ['design-repo'],
+            description: 'Design repository name for this sdx instance',
+        }),
+        mode: core_1.Flags.string({
+            options: ['dedicated', 'in-place'],
+            default: 'dedicated',
+            description: 'Bootstrap mode (default dedicated repo, optional in-place repo initialization)',
+        }),
+        targetDir: core_1.Flags.string({
+            required: false,
+            aliases: ['target-dir'],
+            description: 'Optional target directory (default: ./<design-repo> for dedicated, . for in-place)',
+        }),
+        pin: core_1.Flags.string({
+            required: false,
+            description: 'Pin wrapper script to a specific sdx-cli version (defaults to current CLI package version)',
+        }),
+        seedDefaultMap: core_1.Flags.boolean({
+            default: false,
+            aliases: ['seed-default-map'],
+            description: 'Seed all-services map by running repo sync + map create + map build',
+        }),
+        createRemote: core_1.Flags.boolean({
+            default: false,
+            aliases: ['create-remote'],
+            description: 'Create the remote design repository in GitHub (dedicated mode only)',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(BootstrapConsumerCommand);
+        const result = await (0, bootstrapConsumer_1.bootstrapConsumer)({
+            org: flags.org,
+            designRepo: flags.designRepo,
+            mode: flags.mode,
+            targetDir: flags.targetDir,
+            pin: flags.pin,
+            seedDefaultMap: flags.seedDefaultMap,
+            createRemote: flags.createRemote,
+            cwd: process.cwd(),
+        });
+        this.log(`Consumer bootstrap complete.`);
+        this.log(`Target directory: ${result.targetDir}`);
+        this.log(`Mode: ${result.mode}`);
+        this.log(`Pinned CLI version: ${result.pinnedVersion}`);
+        if (result.remoteUrl) {
+            this.log(`Remote repository: ${result.remoteUrl} (${result.remoteCreated ? 'created' : 'already existed'})`);
+        }
+        if (result.seededDefaultMap) {
+            this.log(`Seeded map: all-services`);
+        }
+        if (result.warnings.length > 0) {
+            this.log('Warnings:');
+            for (const warning of result.warnings) {
+                this.log(`- ${warning}`);
+            }
+        }
+        if (result.nextSteps.length > 0) {
+            this.log('Next steps:');
+            for (const step of result.nextSteps) {
+                this.log(`- ${step}`);
+            }
+        }
+    }
+}
+exports.default = BootstrapConsumerCommand;

package/dist/commands/bootstrap/org.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const bootstrap_1 = require("../../lib/bootstrap");
+const project_1 = require("../../lib/project");
+const config_1 = require("../../lib/config");
+class BootstrapOrgCommand extends core_1.Command {
+    static description = 'Bootstrap this repository as an org-level system design workspace';
+    static flags = {
+        org: core_1.Flags.string({ char: 'o', required: true, description: 'GitHub organization name' }),
+        repo: core_1.Flags.string({ char: 'r', required: true, description: 'Design repository name' }),
+    };
+    static args = {
+        target: core_1.Args.string({ required: false, description: 'Optional reserved positional arg' }),
+    };
+    async run() {
+        const { flags } = await this.parse(BootstrapOrgCommand);
+        const context = (0, project_1.loadProject)(process.cwd());
+        (0, bootstrap_1.createBootstrapStructure)(flags.org, flags.repo, context.cwd);
+        context.config.outputRepo.org = flags.org;
+        context.config.outputRepo.repo = flags.repo;
+        context.config.github.defaultOrg = flags.org;
+        (0, config_1.saveConfig)(context.config, context.cwd);
+        (0, project_1.recordRun)(context.db, 'bootstrap_org', 'ok', undefined, { org: flags.org, repo: flags.repo });
+        context.db.close();
+        this.log(`Bootstrapped for org '${flags.org}' and design repo '${flags.repo}'.`);
+    }
+}
+exports.default = BootstrapOrgCommand;

package/dist/commands/bootstrap/quick.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const bootstrapConsumer_1 = require("../../lib/bootstrapConsumer");
+const bootstrapQuick_1 = require("../../lib/bootstrapQuick");
+class BootstrapQuickCommand extends core_1.Command {
+    static description = 'One-command bootstrap for a consumer workspace';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> dana0550',
+        '<%= config.bin %> <%= command.id %> dana0550/dana0550-system-designer --seed',
+    ];
+    static args = {
+        target: core_1.Args.string({
+            required: true,
+            description: 'GitHub org or org/design-repo target',
+        }),
+    };
+    static flags = {
+        inPlace: core_1.Flags.boolean({
+            default: false,
+            aliases: ['in-place'],
+            description: 'Initialize in the current directory instead of creating ./<design-repo>',
+        }),
+        dir: core_1.Flags.string({
+            required: false,
+            description: 'Optional target directory override',
+        }),
+        pin: core_1.Flags.string({
+            required: false,
+            description: 'Optional pinned sdx-cli version for scripts/sdx wrapper',
+        }),
+        seed: core_1.Flags.boolean({
+            default: false,
+            description: 'Seed all-services map after bootstrap (requires GITHUB_TOKEN)',
+        }),
+        createRemote: core_1.Flags.boolean({
+            default: false,
+            aliases: ['create-remote'],
+            description: 'Create remote design repo in GitHub (dedicated mode only)',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BootstrapQuickCommand);
+        const target = (0, bootstrapQuick_1.parseBootstrapQuickTarget)(args.target);
+        const mode = flags.inPlace ? 'in-place' : 'dedicated';
+        const result = await (0, bootstrapConsumer_1.bootstrapConsumer)({
+            org: target.org,
+            designRepo: target.designRepo,
+            mode,
+            targetDir: flags.dir,
+            pin: flags.pin,
+            seedDefaultMap: flags.seed,
+            createRemote: flags.createRemote,
+            cwd: process.cwd(),
+        });
+        this.log('Bootstrap complete.');
+        this.log(`Design repo: ${target.designRepo}`);
+        this.log(`Workspace: ${result.targetDir}`);
+        this.log(`Pinned version: ${result.pinnedVersion}`);
+        this.log(`Wrapper: ${result.targetDir}/scripts/sdx`);
+        this.log('');
+        this.log('Start here:');
+        this.log(`- cd ${result.targetDir}`);
+        this.log('- ./scripts/sdx status');
+        this.log('- ./scripts/sdx repo sync --org <org>');
+        if (result.seededDefaultMap) {
+            this.log('- ./scripts/sdx map status all-services');
+        }
+        else {
+            this.log('- ./scripts/sdx map create all-services --org <org>');
+            this.log('- ./scripts/sdx map build all-services');
+        }
+        if (result.warnings.length > 0) {
+            this.log('');
+            this.log('Warnings:');
+            for (const warning of result.warnings) {
+                this.log(`- ${warning}`);
+            }
+        }
+    }
+}
+exports.default = BootstrapQuickCommand;

package/dist/commands/codex/run.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const codex_1 = require("../../lib/codex");
+const project_1 = require("../../lib/project");
+class CodexRunCommand extends core_1.Command {
+    static description = 'Run Codex CLI with generated architecture context pack';
+    static flags = {
+        map: core_1.Flags.string({ required: true, description: 'Map identifier' }),
+        input: core_1.Flags.string({ required: false, description: 'Optional additional input file path' }),
+    };
+    static args = {
+        taskType: core_1.Args.string({ required: true, description: 'Codex task type label' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CodexRunCommand);
+        const context = (0, project_1.loadProject)(process.cwd());
+        const result = (0, codex_1.runCodexTask)({
+            mapId: flags.map,
+            taskType: args.taskType,
+            codexCommand: context.config.codex.cmd,
+            inputFile: flags.input,
+            cwd: context.cwd,
+        });
+        (0, project_1.recordRun)(context.db, 'codex_run', result.exitCode === 0 ? 'ok' : 'error', flags.map, result);
+        context.db.close();
+        this.log(`Codex run completed with exit code ${result.exitCode}.`);
+        this.log(`Context pack: ${result.contextPackPath}`);
+        this.log(`Prompt file: ${result.promptPath}`);
+        this.log(`Run output: ${result.runMarkdownPath}`);
+        if (result.exitCode !== 0) {
+            throw new Error(`Codex run failed with non-zero exit code ${result.exitCode}. See ${result.runMarkdownPath}`);
+        }
+    }
+}
+exports.default = CodexRunCommand;

package/dist/commands/contracts/extract.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const project_1 = require("../../lib/project");
+const workflows_1 = require("../../lib/workflows");
+class ContractsExtractCommand extends core_1.Command {
+    static description = 'Extract and catalog API/event contracts for a map scope';
+    static flags = {
+        map: core_1.Flags.string({ required: true, description: 'Map identifier' }),
+    };
+    async run() {
+        const { flags } = await this.parse(ContractsExtractCommand);
+        const context = (0, project_1.loadProject)(process.cwd());
+        const result = (0, workflows_1.extractContractArtifacts)(flags.map, context.db, context.cwd);
+        (0, project_1.recordRun)(context.db, 'contracts_extract', 'ok', flags.map, { count: result.count });
+        context.db.close();
+        this.log(`Extracted ${result.count} contracts for map '${flags.map}'.`);
+        this.log(`JSON: ${result.jsonPath}`);
+        this.log(`Markdown: ${result.markdownPath}`);
+    }
+}
+exports.default = ContractsExtractCommand;

package/dist/commands/docs/generate.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const project_1 = require("../../lib/project");
+const workflows_1 = require("../../lib/workflows");
+class DocsGenerateCommand extends core_1.Command {
+    static description = 'Generate architecture docs and dependency notes for a map';
+    static flags = {
+        map: core_1.Flags.string({ required: true, description: 'Map identifier' }),
+    };
+    async run() {
+        const { flags } = await this.parse(DocsGenerateCommand);
+        const context = (0, project_1.loadProject)(process.cwd());
+        const result = (0, workflows_1.generateDocsArtifacts)(flags.map, context.db, context.cwd);
+        (0, project_1.recordRun)(context.db, 'docs_generate', 'ok', flags.map, result);
+        context.db.close();
+        this.log(`Generated docs for map '${flags.map}'.`);
+        this.log(`Architecture: ${result.architecturePath}`);
+        this.log(`Dependencies: ${result.dependencyPath}`);
+    }
+}
+exports.default = DocsGenerateCommand;

package/dist/commands/handoff/draft.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const core_1 = require("@oclif/core");
+const contracts_1 = require("../../lib/contracts");
+const fs_1 = require("../../lib/fs");
+const handoff_1 = require("../../lib/handoff");
+const project_1 = require("../../lib/project");
+const repoRegistry_1 = require("../../lib/repoRegistry");
+const scope_1 = require("../../lib/scope");
+class HandoffDraftCommand extends core_1.Command {
+    static description = 'Generate per-repository handoff integration drafts for a new service';
+    static flags = {
+        map: core_1.Flags.string({ required: true, description: 'Map identifier' }),
+        service: core_1.Flags.string({ required: true, description: 'New service identifier' }),
+    };
+    async run() {
+        const { flags } = await this.parse(HandoffDraftCommand);
+        const context = (0, project_1.loadProject)(process.cwd());
+        const scope = (0, scope_1.loadScopeManifest)(flags.map, context.cwd);
+        const repoMap = new Map((0, repoRegistry_1.listAllRepos)(context.db).map((repo) => [repo.name, repo]));
+        const contracts = (0, contracts_1.extractContracts)(flags.map, scope, repoMap);
+        const handoff = (0, handoff_1.buildHandoff)(flags.map, flags.service, scope, contracts);
+        const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const outJsonPath = node_path_1.default.join(context.cwd, 'handoffs', `${stamp}-${flags.map}-${flags.service}.json`);
+        const outMdPath = node_path_1.default.join(context.cwd, 'handoffs', `${stamp}-${flags.map}-${flags.service}.md`);
+        (0, fs_1.writeJsonFile)(outJsonPath, handoff);
+        (0, fs_1.writeTextFile)(outMdPath, (0, handoff_1.renderHandoffMarkdown)(handoff));
+        (0, project_1.recordRun)(context.db, 'handoff_draft', 'ok', flags.map, {
+            service: flags.service,
+            targets: handoff.targets.length,
+            output: outMdPath,
+        });
+        context.db.close();
+        this.log(`Handoff draft generated: ${outMdPath}`);
+    }
+}
+exports.default = HandoffDraftCommand;

package/dist/commands/init.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const project_1 = require("../lib/project");
+class InitCommand extends core_1.Command {
+    static description = 'Initialize sdx config, database, and output directories';
+    async run() {
+        const context = (0, project_1.initProject)(process.cwd());
+        context.db.close();
+        this.log('Initialized sdx workspace.');
+        this.log(`Root: ${context.rootDir}`);
+    }
+}
+exports.default = InitCommand;