@sdd-method/sdd-cli 0.9.0

package/dist/verbs/init.js

@@ -0,0 +1,90 @@
+import { runInit } from "../lib/init/index.js";
+import { INTEGRATION_PROFILE_TYPES, isIntegrationProfileType, } from "../lib/init/integration.js";
+const VALID_PROFILES = [
+    "platform",
+    "application",
+    "integration",
+];
+export function registerInit(program) {
+    program
+        .command("init")
+        .description("Scaffold a new SDD repository from a method baseline bundle")
+        .requiredOption("--profile <profile>", "repo profile: platform | application | integration")
+        .requiredOption("--bundle <path>", "path to the method-baseline tarball")
+        .option("--app-id <id>", "app identifier (required for --profile application)")
+        .option("--integration-id <id>", "integration identifier (required for --profile integration)")
+        .option("--profile-type <type>", `integration profile type: ${INTEGRATION_PROFILE_TYPES.join(" | ")}`)
+        .option("--provider-name <name>", "human-readable provider name")
+        .option("--published-by <value>", "integration publisher: internal | third-party")
+        .option("--sdk-version <ver>", "integration SDK version")
+        .option("--supported-asset-types <csv>", "comma-separated supported asset types (default: vehicle)")
+        .option("--inbound-only", "mark integration as inbound-only")
+        .option("--outbound-only", "mark integration as outbound-only")
+        .option("--platform-name <name>", "human-readable platform name (required for --profile platform)")
+        .option("--platform-id <slug>", "kebab-case platform slug (defaults to kebab-case of --platform-name)")
+        .option("--target-dir <dir>", "target directory", process.cwd())
+        .option("--allow-existing", "allow bootstrapping into a non-empty directory")
+        .option("--no-git-init", "skip git init")
+        .option("--dry-run", "report planned actions without writing")
+        .option("--platform-root <dir>", "path to sdd-method for post-bootstrap app-dependencies validation")
+        .option("--agent-harness <name>", "opt into a harness-specific hooks baseline. Supported: claude-code")
+        .action(async (opts) => {
+        if (!VALID_PROFILES.includes(opts.profile)) {
+            process.stderr.write(`[FAIL] --profile must be one of: ${VALID_PROFILES.join(", ")}\n`);
+            process.exit(1);
+        }
+        const profile = opts.profile;
+        if (profile === "integration" && opts.profileType) {
+            if (!isIntegrationProfileType(opts.profileType)) {
+                process.stderr.write(`[FAIL] --profile-type must be one of: ${INTEGRATION_PROFILE_TYPES.join(", ")}\n`);
+                process.exit(1);
+            }
+        }
+        if (opts.publishedBy !== undefined &&
+            opts.publishedBy !== "internal" &&
+            opts.publishedBy !== "third-party") {
+            process.stderr.write(`[FAIL] --published-by must be one of: internal, third-party\n`);
+            process.exit(1);
+        }
+        const supportedAssetTypes = opts.supportedAssetTypes
+            ? opts.supportedAssetTypes
+                .split(",")
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0)
+            : undefined;
+        const { exitCode } = await runInit({
+            profile,
+            bundle: opts.bundle,
+            targetDir: opts.targetDir,
+            allowExisting: opts.allowExisting === true,
+            gitInit: opts.gitInit,
+            dryRun: opts.dryRun === true,
+            ...(opts.platformRoot ? { platformRoot: opts.platformRoot } : {}),
+            ...(opts.appId ? { appId: opts.appId } : {}),
+            ...(opts.integrationId ? { integrationId: opts.integrationId } : {}),
+            ...(opts.profileType && isIntegrationProfileType(opts.profileType)
+                ? { profileType: opts.profileType }
+                : {}),
+            ...(opts.providerName ? { providerName: opts.providerName } : {}),
+            ...(opts.publishedBy === "internal" || opts.publishedBy === "third-party"
+                ? { publishedBy: opts.publishedBy }
+                : {}),
+            ...(opts.sdkVersion ? { sdkVersion: opts.sdkVersion } : {}),
+            ...(supportedAssetTypes ? { supportedAssetTypes } : {}),
+            ...(opts.inboundOnly !== undefined ? { inboundOnly: opts.inboundOnly } : {}),
+            ...(opts.outboundOnly !== undefined ? { outboundOnly: opts.outboundOnly } : {}),
+            ...(opts.platformName ? { platformName: opts.platformName } : {}),
+            ...(opts.platformId ? { platformId: opts.platformId } : {}),
+            ...(opts.agentHarness === "claude-code"
+                ? { agentHarness: opts.agentHarness }
+                : {}),
+        });
+        if (opts.agentHarness !== undefined &&
+            opts.agentHarness !== "claude-code") {
+            process.stderr.write(`[WARN] Unsupported --agent-harness "${opts.agentHarness}"; only "claude-code" is recognised today. Hooks baseline skipped.\n`);
+        }
+        if (exitCode !== 0)
+            process.exit(exitCode);
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/verbs/init.js.map

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

package/dist/verbs/list.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/verbs/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8BnD"}

package/dist/verbs/list.js

@@ -0,0 +1,43 @@
+import { runList } from "../lib/list/index.js";
+const VALID_PROFILES = [
+    "platform",
+    "application",
+    "integration",
+];
+export function registerList(program) {
+    program
+        .command("list")
+        .description("Enumerate SDD repositories discoverable in the current workspace")
+        .option("--profile <profile>", "filter by profile: platform | application | integration")
+        .option("--workspace-root <path>", "workspace directory to walk (repeatable; defaults to cwd)", collectRoots, [])
+        .option("--format <format>", "output format: text | json", "text")
+        .action(async (opts) => {
+        const profileFilter = parseProfile(opts.profile);
+        const format = parseFormat(opts.format);
+        const { exitCode } = await runList({
+            workspaceRoots: opts.workspaceRoot ?? [],
+            format,
+            ...(profileFilter ? { profileFilter } : {}),
+        }, (s) => process.stdout.write(s));
+        if (exitCode !== 0)
+            process.exit(exitCode);
+    });
+}
+function collectRoots(value, prior) {
+    prior.push(value);
+    return prior;
+}
+function parseProfile(value) {
+    if (value === undefined)
+        return undefined;
+    if (!VALID_PROFILES.includes(value)) {
+        throw new Error(`Unknown --profile "${value}". Expected one of: ${VALID_PROFILES.join(", ")}`);
+    }
+    return value;
+}
+function parseFormat(value) {
+    if (value === "text" || value === "json")
+        return value;
+    throw new Error(`Unknown --format "${value}". Expected "text" or "json".`);
+}
+//# sourceMappingURL=list.js.map

package/dist/verbs/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/verbs/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,MAAM,cAAc,GAAuB;IACzC,UAAU;IACV,aAAa;IACb,aAAa;CACd,CAAC;AAQF,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,kEAAkE,CACnE;SACA,MAAM,CACL,qBAAqB,EACrB,yDAAyD,CAC1D;SACA,MAAM,CACL,yBAAyB,EACzB,2DAA2D,EAC3D,YAAY,EACZ,EAAc,CACf;SACA,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,CAAC;SACjE,MAAM,CAAC,KAAK,EAAE,IAA0B,EAAE,EAAE;QAC3C,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,OAAO,CAChC;YACE,cAAc,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;YACxC,MAAM;YACN,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,EACD,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAC/B,CAAC;QACF,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,KAAe;IAClD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB;IAC7C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAgB,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,uBAAuB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,KAAgB,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACvD,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,+BAA+B,CAAC,CAAC;AAC7E,CAAC"}

package/dist/verbs/mcp.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerMcp(program: Command): void;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/verbs/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/verbs/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0BlD"}

package/dist/verbs/mcp.js

@@ -0,0 +1,22 @@
+import { runMcpServe } from "../lib/mcp/server.js";
+export function registerMcp(program) {
+    const mcp = program
+        .command("mcp")
+        .description("Model Context Protocol (MCP) server management. See `sdd-cli mcp serve --help` for the stdio server.");
+    mcp
+        .command("serve")
+        .description("Start a local stdio MCP server exposing the SDD as resources and tools. Spawned by an MCP client (e.g. Claude Code) over stdio.")
+        .option("--sdd-repo <dir>", "explicit SDD repository path; overrides sibling discovery but is itself overridden by the SDD_REPO_PATH environment variable")
+        .action(async (opts) => {
+        try {
+            await runMcpServe({
+                ...(opts.sddRepo ? { sddRepo: opts.sddRepo } : {}),
+            });
+        }
+        catch {
+            // Fatal errors are already surfaced on stderr by runMcpServe.
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/verbs/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/verbs/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMnD,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CACV,sGAAsG,CACvG,CAAC;IAEJ,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CACV,iIAAiI,CAClI;SACA,MAAM,CACL,kBAAkB,EAClB,8HAA8H,CAC/H;SACA,MAAM,CAAC,KAAK,EAAE,IAA8B,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,WAAW,CAAC;gBAChB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/verbs/plan.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerPlan(program: Command): void;
+//# sourceMappingURL=plan.d.ts.map

package/dist/verbs/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/verbs/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4CnD"}

package/dist/verbs/plan.js

@@ -0,0 +1,41 @@
+import { runPlanPilot } from "../lib/plan/index.js";
+export function registerPlan(program) {
+    program
+        .command("plan")
+        .description("Scaffold a plan markdown file from a method-distributed template. Currently supports --pilot for pilot-kickoff plans; future subcommands may add --initiative / --migration.")
+        .option("--pilot", "scaffold a pilot-kickoff plan (requires --service, --capability, --domain)", false)
+        .option("--service <name>", "service / pilot name, e.g. party-management")
+        .option("--capability <name>", "capability under test, e.g. organization-management")
+        .option("--domain <name>", "domain the capability belongs to, e.g. party")
+        .option("--workspace-root <path>", "SDD root (defaults to cwd)")
+        .option("--output <path>", "destination file (defaults to content/product/plans/{service}-pilot-kickoff.md)")
+        .option("--dry-run", "print rendered output to stdout without writing", false)
+        .action(async (opts) => {
+        if (opts.pilot !== true) {
+            process.stderr.write("[FAIL] plan: no mode specified. Pass --pilot (other modes not yet implemented).\n");
+            process.exit(1);
+        }
+        const missing = [];
+        if (!opts.service)
+            missing.push("--service");
+        if (!opts.capability)
+            missing.push("--capability");
+        if (!opts.domain)
+            missing.push("--domain");
+        if (missing.length > 0) {
+            process.stderr.write(`[FAIL] plan --pilot: missing required flag(s): ${missing.join(", ")}\n`);
+            process.exit(1);
+        }
+        const result = await runPlanPilot({
+            sddRoot: opts.workspaceRoot ?? process.cwd(),
+            service: opts.service,
+            capability: opts.capability,
+            domain: opts.domain,
+            ...(opts.output !== undefined ? { outputPath: opts.output } : {}),
+            ...(opts.dryRun === true ? { dryRun: true } : {}),
+        }, (s) => process.stdout.write(s));
+        if (result.exitCode !== 0)
+            process.exit(result.exitCode);
+    });
+}
+//# sourceMappingURL=plan.js.map

package/dist/verbs/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/verbs/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAYpD,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,8KAA8K,CAC/K;SACA,MAAM,CAAC,SAAS,EAAE,4EAA4E,EAAE,KAAK,CAAC;SACtG,MAAM,CAAC,kBAAkB,EAAE,6CAA6C,CAAC;SACzE,MAAM,CAAC,qBAAqB,EAAE,qDAAqD,CAAC;SACpF,MAAM,CAAC,iBAAiB,EAAE,8CAA8C,CAAC;SACzE,MAAM,CAAC,yBAAyB,EAAE,4BAA4B,CAAC;SAC/D,MAAM,CAAC,iBAAiB,EAAE,iFAAiF,CAAC;SAC5G,MAAM,CAAC,WAAW,EAAE,iDAAiD,EAAE,KAAK,CAAC;SAC7E,MAAM,CAAC,KAAK,EAAE,IAA0B,EAAE,EAAE;QAC3C,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mFAAmF,CACpF,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kDAAkD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACzE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B;YACE,OAAO,EAAE,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE;YAC5C,OAAO,EAAE,IAAI,CAAC,OAAQ;YACtB,UAAU,EAAE,IAAI,CAAC,UAAW;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAO;YACpB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,EACD,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAC/B,CAAC;QACF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/verbs/sync.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerSync(program: Command): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/verbs/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/verbs/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+BnD"}

package/dist/verbs/sync.js

@@ -0,0 +1,27 @@
+import { runSync } from "../lib/sync/index.js";
+export function registerSync(program) {
+    program
+        .command("sync")
+        .description("Pull the latest upstream method baseline into this SDD repository")
+        .requiredOption("--bundle <path>", "path to the method-baseline tarball")
+        .option("--target-repo <dir>", "target SDD repo", process.cwd())
+        .option("--dry-run", "report planned actions without writing")
+        .option("--allow-overwrite", "accept overwrites of locally-modified method content")
+        .option("--no-delete", "preserve files removed upstream")
+        .option("--agent-harness <name>", "refresh the harness-specific hooks baseline. Supported: claude-code")
+        .action(async (opts) => {
+        const { exitCode } = await runSync({
+            bundle: opts.bundle,
+            targetRepo: opts.targetRepo,
+            dryRun: opts.dryRun === true,
+            allowOverwrite: opts.allowOverwrite === true,
+            delete: opts.delete,
+            ...(opts.agentHarness === "claude-code"
+                ? { agentHarness: opts.agentHarness }
+                : {}),
+        });
+        if (exitCode !== 0)
+            process.exit(exitCode);
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/verbs/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/verbs/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAW/C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,mEAAmE,CACpE;SACA,cAAc,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;SACxE,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC/D,MAAM,CAAC,WAAW,EAAE,wCAAwC,CAAC;SAC7D,MAAM,CACL,mBAAmB,EACnB,sDAAsD,CACvD;SACA,MAAM,CAAC,aAAa,EAAE,iCAAiC,CAAC;SACxD,MAAM,CACL,wBAAwB,EACxB,qEAAqE,CACtE;SACA,MAAM,CAAC,KAAK,EAAE,IAA0B,EAAE,EAAE;QAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,OAAO,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI;YAC5B,cAAc,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI;YAC5C,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,aAAa;gBACrC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE;gBACrC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QACH,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/verbs/validate.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerValidate(program: Command): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/verbs/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/verbs/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsBvD"}

package/dist/verbs/validate.js

@@ -0,0 +1,21 @@
+import { runValidate } from "../lib/validate/index.js";
+export function registerValidate(program) {
+    program
+        .command("validate")
+        .description("Run the method-level validation suite for this SDD repository")
+        .option("--target-repo <dir>", "target SDD repo", process.cwd())
+        .option("--platform-root <dir>", "path to the sdd-method (or platform) repo, required for app-dependencies")
+        .option("--validator <name>", "run only the named validator")
+        .option("--strict", "treat warnings as failures")
+        .action(async (opts) => {
+        const { exitCode } = await runValidate({
+            targetRepo: opts.targetRepo,
+            ...(opts.platformRoot ? { platformRoot: opts.platformRoot } : {}),
+            ...(opts.validator ? { validator: opts.validator } : {}),
+            strict: opts.strict === true,
+        });
+        if (exitCode !== 0)
+            process.exit(exitCode);
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/verbs/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/verbs/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AASvD,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CACV,+DAA+D,CAChE;SACA,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC/D,MAAM,CACL,uBAAuB,EACvB,0EAA0E,CAC3E;SACA,MAAM,CAAC,oBAAoB,EAAE,8BAA8B,CAAC;SAC5D,MAAM,CAAC,UAAU,EAAE,4BAA4B,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,IAA8B,EAAE,EAAE;QAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,WAAW,CAAC;YACrC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI;SAC7B,CAAC,CAAC;QACH,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@sdd-method/sdd-cli",
+  "version": "0.9.0",
+  "description": "Method-layer CLI for SDD repository lifecycle — init, sync, validate, list, plan, generate-claude-md, mcp serve. v0.9.0 ships method enforcement automation Phases 0+1+2 per ADR 0129: GitHub Actions CI baseline seeded by init/sync (Layer 1 authoritative) and opt-in Claude Code hooks via --agent-harness claude-code (Layer 2 accelerator), both delegating to sdd-cli validate with per-entry ownership.",
+  "keywords": [
+    "sdd-method",
+    "sdd",
+    "spec-driven-development",
+    "cli"
+  ],
+  "homepage": "https://github.com/tomfosteruk/sdd-cli#readme",
+  "bugs": {
+    "url": "https://github.com/tomfosteruk/sdd-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tomfosteruk/sdd-cli.git"
+  },
+  "license": "Apache-2.0",
+  "author": "Tom Foster",
+  "type": "module",
+  "bin": {
+    "sdd-cli": "dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^12.1.0",
+    "yaml": "^2.5.0",
+    "zod": "^4.3.6"
+  }
+}

package/scripts/README.md

@@ -0,0 +1,48 @@
+# Bundled upstream scripts
+
+Frozen copies of bash scripts from
+[`sdd-method`](https://github.com/tomfosteruk/sdd-method) that
+`sdd-cli` either shells out to (`validate-*`) or retains as a regression
+oracle (`sync-method-baseline.sh`, which is superseded by native TypeScript
+sync in v0.2.0 but kept so `tests/parity/` can keep catching drift).
+
+Files in this directory are **byte-identical** to their upstream source. Do
+not edit here — edit upstream, then run the refresh procedure below to copy
+the new version in. Byte-identity keeps `diff` usable as a drift-detection
+signal.
+
+## Provenance
+
+| File | Upstream path | Pinned to |
+|---|---|---|
+| `sync-method-baseline.sh` | `orchestration/scripts/sync-method-baseline.sh` | `4d80826` |
+| `validate-app-docs.sh` | `orchestration/scripts/validate-app-docs.sh` | `db4cb25` |
+| `validate-app-dependencies.sh` | `orchestration/scripts/validate-app-dependencies.sh` | `db4cb25` |
+| `validate-integration-docs.sh` | `orchestration/scripts/validate-integration-docs.sh` | `db4cb25` |
+
+Only the validators that accept a `--*-root` flag are bundled. The
+no-flag validators (`validate-adr-structure.sh`, `validate-spec-lifecycle.sh`,
+`validate-runway-classification.sh`) compute their root as `SCRIPT_DIR/../..`,
+which means they only make sense when run from the target repo's own
+`orchestration/scripts/` directory (where `sync` places them). The
+`sdd-cli validate` dispatcher spawns those directly from the target repo.
+
+## Refresh procedure
+
+```bash
+cp ../sdd-method/orchestration/scripts/<script>.sh scripts/
+# Then update the SHA in this README and commit both together.
+```
+
+Automation (pre-build sync step) is a later milestone. Refresh is currently
+manual and visible.
+
+## Lifecycle
+
+The `sync-method-baseline.sh` oracle is frozen at 4a8cd05 and stays for
+regression testing — the native TS sync is tested against it in
+`tests/parity/`.
+
+The `validate-*.sh` scripts are what `sdd-cli validate` spawns. Native TS
+reimplementation of individual validators is v0.3.0+, smallest-first
+(adr-structure, spec-lifecycle).