@sixthsummit/ship-cli 0.0.0-stage → 1.2.0

package/lib/migration.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Load an application, legacy route catalog, and disposition mapping from disk
+ * and enforce the migration's exactly-once route accounting invariant.
+ *
+ * @param {{cwd?: string, appPath?: string, catalogPath: string, mappingPath: string}} options
+ */
+export function checkRouteMigration(options: {
+    cwd?: string;
+    appPath?: string;
+    catalogPath: string;
+    mappingPath: string;
+}): Promise<Readonly<{
+    command: "migrate-routes";
+    ok: true;
+    appId: string;
+    catalogRevision: any;
+    routes: number;
+    mapped: number;
+    removed: number;
+    catalog: string;
+    mapping: string;
+}>>;
+/**
+ * Validate already-loaded migration data. This pure entrypoint is intended for
+ * tests and for consumers that generate the catalog in memory.
+ *
+ * Catalog shape:
+ * `{schemaVersion: 1, applicationId, revision, routes: [{id, method, path, source?}]}`
+ *
+ * Mapping shape:
+ * `{schemaVersion: 1, applicationId, catalogRevision, entries: [{legacyRouteId,
+ * operationId} | {legacyRouteId, removal: {decisionId, reason}}]}`
+ *
+ * @param {import("@sixthsummit/ship-core").CompiledApplication<string, readonly import("@sixthsummit/ship-core").AnyModule[]>} application
+ * @param {unknown} catalogDocument
+ * @param {unknown} mappingDocument
+ * @param {{catalogPath?: string, mappingPath?: string}} [options]
+ */
+export function validateRouteMigration(application: import("@sixthsummit/ship-core").CompiledApplication<string, readonly import("@sixthsummit/ship-core").AnyModule[]>, catalogDocument: unknown, mappingDocument: unknown, options?: {
+    catalogPath?: string;
+    mappingPath?: string;
+}): Readonly<{
+    command: "migrate-routes";
+    ok: true;
+    appId: string;
+    catalogRevision: any;
+    routes: number;
+    mapped: number;
+    removed: number;
+    catalog: string;
+    mapping: string;
+}>;
+//# sourceMappingURL=migration.d.ts.map

package/lib/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,6CAFW;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC;;;;;;;;;;IAWpF;AAED;;;;;;;;;;;;;;;GAeG;AACH,oDALW,OAAO,wBAAwB,EAAE,mBAAmB,CAAC,MAAM,EAAE,SAAS,OAAO,wBAAwB,EAAE,SAAS,EAAE,CAAC,mBACnH,OAAO,mBACP,OAAO,YACP;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAC;;;;;;;;;;GAkCtD"}

package/lib/migration.js

@@ -0,0 +1,303 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { GRAPH_CLI_EXIT, GraphCliError, loadApplication } from "./graph.js";
+const HTTP_METHODS = new Set(["DELETE", "GET", "HEAD", "OPTIONS", "PATCH", "POST", "PUT"]);
+/**
+ * Load an application, legacy route catalog, and disposition mapping from disk
+ * and enforce the migration's exactly-once route accounting invariant.
+ *
+ * @param {{cwd?: string, appPath?: string, catalogPath: string, mappingPath: string}} options
+ */
+export async function checkRouteMigration(options) {
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const catalogPath = resolve(cwd, options.catalogPath);
+    const mappingPath = resolve(cwd, options.mappingPath);
+    const application = await loadApplication({ cwd, appPath: options.appPath });
+    const catalog = await readJsonDocument(catalogPath, "catalog");
+    const mapping = await readJsonDocument(mappingPath, "mapping");
+    return validateRouteMigration(application, catalog, mapping, { catalogPath, mappingPath });
+}
+/**
+ * Validate already-loaded migration data. This pure entrypoint is intended for
+ * tests and for consumers that generate the catalog in memory.
+ *
+ * Catalog shape:
+ * `{schemaVersion: 1, applicationId, revision, routes: [{id, method, path, source?}]}`
+ *
+ * Mapping shape:
+ * `{schemaVersion: 1, applicationId, catalogRevision, entries: [{legacyRouteId,
+ * operationId} | {legacyRouteId, removal: {decisionId, reason}}]}`
+ *
+ * @param {import("@sixthsummit/ship-core").CompiledApplication<string, readonly import("@sixthsummit/ship-core").AnyModule[]>} application
+ * @param {unknown} catalogDocument
+ * @param {unknown} mappingDocument
+ * @param {{catalogPath?: string, mappingPath?: string}} [options]
+ */
+export function validateRouteMigration(application, catalogDocument, mappingDocument, options = {}) {
+    const diagnostics = [];
+    const catalog = readCatalog(catalogDocument, diagnostics);
+    const mapping = readMapping(mappingDocument, diagnostics);
+    if (catalog && mapping) {
+        validateDocumentIdentity(application.id, catalog, mapping, diagnostics);
+        validateExactlyOnceMapping(application.graph, catalog, mapping, diagnostics);
+    }
+    if (diagnostics.length > 0) {
+        throw new GraphCliError(sortDiagnostics(diagnostics), GRAPH_CLI_EXIT.applicationInvalid);
+    }
+    const mapped = mapping.entries.filter((entry) => entry.operationId !== undefined).length;
+    const removed = mapping.entries.length - mapped;
+    return Object.freeze({
+        command: "migrate-routes",
+        ok: true,
+        appId: application.id,
+        catalogRevision: catalog.revision,
+        routes: catalog.routes.length,
+        mapped,
+        removed,
+        catalog: options.catalogPath ?? "(memory)",
+        mapping: options.mappingPath ?? "(memory)",
+    });
+}
+function readCatalog(document, diagnostics) {
+    if (!isObject(document)) {
+        invalid(diagnostics, "SHIP_MIGRATION_CATALOG_INVALID", "catalog", "must be an object");
+        return undefined;
+    }
+    if (document.schemaVersion !== 1) {
+        invalid(diagnostics, "SHIP_MIGRATION_CATALOG_INVALID", "catalog.schemaVersion", "must equal 1");
+    }
+    const applicationId = readRequiredString(document.applicationId, "catalog.applicationId", "SHIP_MIGRATION_CATALOG_INVALID", diagnostics);
+    const revision = readRequiredString(document.revision, "catalog.revision", "SHIP_MIGRATION_CATALOG_INVALID", diagnostics);
+    if (!Array.isArray(document.routes)) {
+        invalid(diagnostics, "SHIP_MIGRATION_CATALOG_INVALID", "catalog.routes", "must be an array");
+        return undefined;
+    }
+    const routes = [];
+    for (const [index, value] of document.routes.entries()) {
+        const path = `catalog.routes[${index}]`;
+        if (!isObject(value)) {
+            invalid(diagnostics, "SHIP_MIGRATION_CATALOG_INVALID", path, "must be an object");
+            continue;
+        }
+        const id = readRequiredString(value.id, `${path}.id`, "SHIP_MIGRATION_CATALOG_INVALID", diagnostics);
+        const method = readRequiredString(value.method, `${path}.method`, "SHIP_MIGRATION_CATALOG_INVALID", diagnostics);
+        const routePath = readRequiredString(value.path, `${path}.path`, "SHIP_MIGRATION_CATALOG_INVALID", diagnostics);
+        if (method && (!HTTP_METHODS.has(method) || method !== method.toUpperCase())) {
+            invalid(diagnostics, "SHIP_MIGRATION_CATALOG_INVALID", `${path}.method`, "must be an uppercase supported HTTP method");
+        }
+        if (routePath && (!routePath.startsWith("/") || /[?#]/u.test(routePath))) {
+            invalid(diagnostics, "SHIP_MIGRATION_CATALOG_INVALID", `${path}.path`, "must be an absolute path without a query string or fragment");
+        }
+        if (value.source !== undefined && !isNonEmptyString(value.source)) {
+            invalid(diagnostics, "SHIP_MIGRATION_CATALOG_INVALID", `${path}.source`, "must be a non-empty string when present");
+        }
+        if (id && method && HTTP_METHODS.has(method) && routePath?.startsWith("/")) {
+            routes.push({ id, method, path: routePath, source: value.source });
+        }
+    }
+    diagnoseDuplicates(routes, (route) => route.id, "SHIP_MIGRATION_LEGACY_ID_DUPLICATE", (key) => `legacy route id ${JSON.stringify(key)} occurs more than once`, "Give every source registration one stable unique id.", diagnostics);
+    diagnoseDuplicates(routes, (route) => `${route.method} ${route.path}`, "SHIP_MIGRATION_LEGACY_ROUTE_DUPLICATE", (key) => `legacy method/path ${JSON.stringify(key)} is registered more than once`, "Resolve the duplicate registration or record one approved catalog delta before mapping.", diagnostics);
+    return applicationId && revision ? { applicationId, revision, routes } : undefined;
+}
+function readMapping(document, diagnostics) {
+    if (!isObject(document)) {
+        invalid(diagnostics, "SHIP_MIGRATION_MAPPING_INVALID", "mapping", "must be an object");
+        return undefined;
+    }
+    if (document.schemaVersion !== 1) {
+        invalid(diagnostics, "SHIP_MIGRATION_MAPPING_INVALID", "mapping.schemaVersion", "must equal 1");
+    }
+    const applicationId = readRequiredString(document.applicationId, "mapping.applicationId", "SHIP_MIGRATION_MAPPING_INVALID", diagnostics);
+    const catalogRevision = readRequiredString(document.catalogRevision, "mapping.catalogRevision", "SHIP_MIGRATION_MAPPING_INVALID", diagnostics);
+    if (!Array.isArray(document.entries)) {
+        invalid(diagnostics, "SHIP_MIGRATION_MAPPING_INVALID", "mapping.entries", "must be an array");
+        return undefined;
+    }
+    const entries = [];
+    for (const [index, value] of document.entries.entries()) {
+        const path = `mapping.entries[${index}]`;
+        if (!isObject(value)) {
+            invalid(diagnostics, "SHIP_MIGRATION_MAPPING_INVALID", path, "must be an object");
+            continue;
+        }
+        const legacyRouteId = readRequiredString(value.legacyRouteId, `${path}.legacyRouteId`, "SHIP_MIGRATION_MAPPING_INVALID", diagnostics);
+        const hasOperation = isNonEmptyString(value.operationId);
+        const hasRemoval = isObject(value.removal);
+        if (hasOperation === hasRemoval) {
+            invalid(diagnostics, "SHIP_MIGRATION_MAPPING_INVALID", path, "must declare exactly one of operationId or removal");
+            continue;
+        }
+        if (!legacyRouteId)
+            continue;
+        if (hasOperation) {
+            entries.push({ legacyRouteId, operationId: value.operationId });
+            continue;
+        }
+        const decisionId = readRequiredString(value.removal.decisionId, `${path}.removal.decisionId`, "SHIP_MIGRATION_MAPPING_INVALID", diagnostics);
+        const reason = readRequiredString(value.removal.reason, `${path}.removal.reason`, "SHIP_MIGRATION_MAPPING_INVALID", diagnostics);
+        if (decisionId && reason)
+            entries.push({ legacyRouteId, removal: { decisionId, reason } });
+    }
+    diagnoseDuplicates(entries, (entry) => entry.legacyRouteId, "SHIP_MIGRATION_DISPOSITION_DUPLICATE", (key) => `legacy route ${JSON.stringify(key)} has more than one disposition`, "Keep exactly one operation mapping or approved removal for each legacy route id.", diagnostics);
+    diagnoseDuplicates(entries.filter((entry) => entry.operationId !== undefined), (entry) => entry.operationId, "SHIP_MIGRATION_OPERATION_DUPLICATE", (key) => `target operation ${JSON.stringify(key)} receives more than one legacy route`, "Give every legacy method/path its own operation id or record an approved removal.", diagnostics);
+    return applicationId && catalogRevision ? { applicationId, catalogRevision, entries } : undefined;
+}
+function validateDocumentIdentity(applicationId, catalog, mapping, diagnostics) {
+    for (const [path, actual] of [
+        ["catalog.applicationId", catalog.applicationId],
+        ["mapping.applicationId", mapping.applicationId],
+    ]) {
+        if (actual !== applicationId) {
+            diagnostics.push({
+                code: "SHIP_MIGRATION_APPLICATION_MISMATCH",
+                severity: "error",
+                message: `${path} ${JSON.stringify(actual)} does not match target app ${JSON.stringify(applicationId)}`,
+                hint: "Generate the catalog and mapping for the application being checked.",
+                path,
+            });
+        }
+    }
+    if (mapping.catalogRevision !== catalog.revision) {
+        diagnostics.push({
+            code: "SHIP_MIGRATION_CATALOG_REVISION_MISMATCH",
+            severity: "error",
+            message: `mapping revision ${JSON.stringify(mapping.catalogRevision)} does not match catalog revision ${JSON.stringify(catalog.revision)}`,
+            hint: "Regenerate or explicitly review the mapping against the candidate-SHA catalog.",
+            path: "mapping.catalogRevision",
+        });
+    }
+}
+function validateExactlyOnceMapping(graph, catalog, mapping, diagnostics) {
+    const routesById = new Map(catalog.routes.map((route) => [route.id, route]));
+    const entriesByLegacyId = new Map();
+    for (const entry of mapping.entries) {
+        const entries = entriesByLegacyId.get(entry.legacyRouteId) ?? [];
+        entries.push(entry);
+        entriesByLegacyId.set(entry.legacyRouteId, entries);
+    }
+    for (const route of catalog.routes) {
+        if (!entriesByLegacyId.has(route.id)) {
+            diagnostics.push({
+                code: "SHIP_MIGRATION_DISPOSITION_MISSING",
+                severity: "error",
+                message: `legacy route ${JSON.stringify(route.id)} (${route.method} ${route.path}) has no disposition`,
+                hint: "Map it to one operation id or record an approved removal.",
+                path: route.id,
+            });
+        }
+    }
+    const operationsById = new Map(graph.operations.map((operation) => [operation.id, operation]));
+    for (const entry of mapping.entries) {
+        const route = routesById.get(entry.legacyRouteId);
+        if (!route) {
+            diagnostics.push({
+                code: "SHIP_MIGRATION_LEGACY_UNKNOWN",
+                severity: "error",
+                message: `mapping references unknown legacy route ${JSON.stringify(entry.legacyRouteId)}`,
+                hint: "Use an id from the current candidate-SHA route catalog.",
+                path: entry.legacyRouteId,
+            });
+            continue;
+        }
+        if (entry.operationId === undefined)
+            continue;
+        const operation = operationsById.get(entry.operationId);
+        if (!operation) {
+            diagnostics.push({
+                code: "SHIP_MIGRATION_OPERATION_NOT_FOUND",
+                severity: "error",
+                message: `target operation ${JSON.stringify(entry.operationId)} does not exist`,
+                hint: "Use an operation id from the compiled target application graph.",
+                operationId: entry.operationId,
+            });
+            continue;
+        }
+        if (operation.transport?.kind !== "http" ||
+            typeof operation.transport.metadata?.method !== "string" ||
+            typeof operation.transport.metadata?.path !== "string") {
+            diagnostics.push({
+                code: "SHIP_MIGRATION_OPERATION_NOT_HTTP",
+                severity: "error",
+                message: `target operation ${JSON.stringify(entry.operationId)} has no concrete HTTP method/path`,
+                hint: "Map legacy HTTP routes only to operations with an http transport declaration.",
+                operationId: entry.operationId,
+            });
+            continue;
+        }
+        if (operation.transport.metadata.method !== route.method) {
+            diagnostics.push({
+                code: "SHIP_MIGRATION_METHOD_MISMATCH",
+                severity: "error",
+                message: `${entry.operationId} uses ${operation.transport.metadata.method}; legacy route ${entry.legacyRouteId} uses ${route.method}`,
+                hint: "Preserve the method or record an approved removal and replacement contract.",
+                operationId: entry.operationId,
+            });
+        }
+        if (operation.transport.metadata.path !== route.path) {
+            diagnostics.push({
+                code: "SHIP_MIGRATION_PATH_MISMATCH",
+                severity: "error",
+                message: `${entry.operationId} uses ${operation.transport.metadata.path}; legacy route ${entry.legacyRouteId} uses ${route.path}`,
+                hint: "Preserve the exact public path or record an approved removal and replacement contract.",
+                operationId: entry.operationId,
+            });
+        }
+    }
+}
+async function readJsonDocument(path, kind) {
+    let source;
+    try {
+        source = await readFile(path, "utf8");
+    }
+    catch (cause) {
+        throw documentError("SHIP_MIGRATION_DOCUMENT_READ_FAILED", `${kind} document could not be read at ${JSON.stringify(path)}`, "Pass a readable JSON document generated for the current migration candidate.", path, cause);
+    }
+    try {
+        return JSON.parse(source);
+    }
+    catch (cause) {
+        throw documentError("SHIP_MIGRATION_DOCUMENT_JSON_INVALID", `${kind} document at ${JSON.stringify(path)} is not valid JSON`, "Regenerate the document; do not hand-repair a partial artifact.", path, cause);
+    }
+}
+function readRequiredString(value, path, code, diagnostics) {
+    if (isNonEmptyString(value))
+        return value;
+    invalid(diagnostics, code, path, "must be a non-empty string");
+    return undefined;
+}
+function diagnoseDuplicates(items, keyOf, code, message, hint, diagnostics) {
+    const counts = new Map();
+    for (const item of items) {
+        const key = keyOf(item);
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    for (const [key, count] of counts) {
+        if (count > 1) {
+            diagnostics.push({ code, severity: "error", message: message(key), hint, path: key });
+        }
+    }
+}
+function invalid(diagnostics, code, path, requirement) {
+    diagnostics.push({
+        code,
+        severity: "error",
+        message: `${path} ${requirement}`,
+        hint: "Use the documented schemaVersion 1 migration document shape.",
+        path,
+    });
+}
+function documentError(code, message, hint, path, cause) {
+    return new GraphCliError([{ code, severity: "error", message, hint, path }], GRAPH_CLI_EXIT.usageOrLoadError, { cause });
+}
+function sortDiagnostics(diagnostics) {
+    return diagnostics.sort((left, right) => [left.code, left.path ?? "", left.operationId ?? "", left.message]
+        .join("\0")
+        .localeCompare([right.code, right.path ?? "", right.operationId ?? "", right.message].join("\0")));
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=migration.js.map

package/lib/migration.js.map

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

package/lib/release-manifest.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "packageManager": "pnpm@10.34.6",
+  "packages": {
+    "@sixthsummit/ship-core": "1.1.1",
+    "@sixthsummit/ship-hono": "1.2.0",
+    "@sixthsummit/ship-contract": "1.3.0"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.14",
+    "hono": "4.13.7",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.11",
+    "@sixthsummit/ship-cli": "1.2.0",
+    "@types/node": "^24.1.0",
+    "@vitest/coverage-v8": "^4.1.8",
+    "tsx": "^4.20.3",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.8"
+  }
+}

package/lib/ship-api.d.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * @typedef {{
+ *   name?: string,
+ *   description?: string,
+ *   version?: string,
+ *   packageJsonPath?: string,
+ *   cwd?: string,
+ *   templateDirectory?: string,
+ *   releaseManifestPath?: string,
+ *   releaseManifest?: import("./create.js").ScaffoldReleaseManifest,
+ *   includeCreate?: boolean,
+ *   install?: (targetDirectory: string) => void
+ * }} CliOptions
+ */
+/** @param {Command} program @param {CliOptions} [options] */
+export function registerApplicationCommands(program: Command, options?: CliOptions): Command;
+/**
+ * @param {CliOptions} [options]
+ * @returns {Command}
+ */
+export function createCli(options?: CliOptions): Command;
+/** @param {string[]} [argv] */
+export function runCli(argv?: string[]): Promise<void>;
+export type CliOptions = {
+    name?: string;
+    description?: string;
+    version?: string;
+    packageJsonPath?: string;
+    cwd?: string;
+    templateDirectory?: string;
+    releaseManifestPath?: string;
+    releaseManifest?: import("./create.js").ScaffoldReleaseManifest;
+    includeCreate?: boolean;
+    install?: (targetDirectory: string) => void;
+};
+import { Command } from "commander";
+//# sourceMappingURL=ship-api.d.ts.map

package/lib/ship-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship-api.d.ts","sourceRoot":"","sources":["../src/ship-api.js"],"names":[],"mappings":";AAkBA;;;;;;;;;;;;;GAaG;AAEH,6DAA6D;AAC7D,qDADY,OAAO,YAAkB,UAAU,WA6H9C;AAED;;;GAGG;AACH,oCAHW,UAAU,GACR,OAAO,CAWnB;AAED,+BAA+B;AAC/B,8BADY,MAAM,EAAE,iBAGnB;yBA/JY;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,aAAa,EAAE,uBAAuB,CAAC;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C;wBAzBoB,WAAW"}

package/lib/ship-api.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { generateContractArtifacts } from "./contract.js";
+import { createOperationProject, loadScaffoldReleaseManifest } from "./create.js";
+import { affectedApplication, checkApplication, inspectApplication, runGraphCommand, } from "./graph.js";
+import { checkRouteMigration } from "./migration.js";
+const packageDirectory = join(dirname(fileURLToPath(import.meta.url)), "..");
+/**
+ * @typedef {{
+ *   name?: string,
+ *   description?: string,
+ *   version?: string,
+ *   packageJsonPath?: string,
+ *   cwd?: string,
+ *   templateDirectory?: string,
+ *   releaseManifestPath?: string,
+ *   releaseManifest?: import("./create.js").ScaffoldReleaseManifest,
+ *   includeCreate?: boolean,
+ *   install?: (targetDirectory: string) => void
+ * }} CliOptions
+ */
+/** @param {Command} program @param {CliOptions} [options] */
+export function registerApplicationCommands(program, options = {}) {
+    if (options.includeCreate !== false) {
+        program
+            .command("create <project-name>")
+            .description("Create a tested operation-native Ship application")
+            .option("--current-dir", "Write into the current empty directory")
+            .option("--skip-install", "Do not install dependencies")
+            .action(async (projectName, commandOptions) => {
+            try {
+                const releaseManifest = options.releaseManifest ??
+                    (await loadScaffoldReleaseManifest(options.releaseManifestPath ?? join(packageDirectory, "lib/release-manifest.json")));
+                const result = await createOperationProject({
+                    projectName,
+                    cwd: options.cwd,
+                    currentDirectory: commandOptions.currentDir,
+                    skipInstall: commandOptions.skipInstall,
+                    templateDirectory: options.templateDirectory ?? join(packageDirectory, "templates/operation"),
+                    releaseManifest,
+                    install: options.install,
+                });
+                process.stdout.write(`${result.packageName} created at ${result.targetDirectory}${result.installed ? "" : " (install skipped)"}\n`);
+            }
+            catch (error) {
+                process.stderr.write(`ship-api create: ${error instanceof Error ? error.message : String(error)}\n`);
+                process.exitCode = 2;
+            }
+        });
+    }
+    program
+        .command("check")
+        .description("Compile and validate the application graph")
+        .option("-a, --app <path>", "Application module with a named `app` export", "ship.config.ts")
+        .option("--format <format>", "Output format: human or json", "human")
+        .option("--emit [path]", "Write the deterministic graph JSON")
+        .action(async (options) => {
+        process.exitCode = await runGraphCommand(() => checkApplication({
+            appPath: options.app,
+            emit: options.emit === true ? ".ship/graph.json" : options.emit,
+        }), options);
+    });
+    program
+        .command("inspect <kind> [id]")
+        .description("Inspect an app, module, operation, provider, channel, or job graph node")
+        .option("-a, --app <path>", "Application module with a named `app` export", "ship.config.ts")
+        .option("--format <format>", "Output format: human or json", "human")
+        .action(async (kind, id, options) => {
+        process.exitCode = await runGraphCommand(() => inspectApplication(kind, id, { appPath: options.app }), options);
+    });
+    program
+        .command("affected <kind> <id>")
+        .description("Show graph surfaces affected by a module, operation, provider, channel, or job")
+        .option("-a, --app <path>", "Application module with a named `app` export", "ship.config.ts")
+        .option("--format <format>", "Output format: human or json", "human")
+        .action(async (kind, id, options) => {
+        process.exitCode = await runGraphCommand(() => affectedApplication(kind, id, { appPath: options.app }), options);
+    });
+    program
+        .command("contract")
+        .description("Emit deterministic client-contract and OpenAPI artifacts")
+        .option("-a, --app <path>", "Application module with a named `app` export", "ship.config.ts")
+        .option("--out <path>", "Client contract output", ".ship/contract.json")
+        .option("--typescript <path>", "Browser-safe TypeScript contract output", ".ship/contract.ts")
+        .option("--openapi <path>", "OpenAPI output", ".ship/openapi.json")
+        .option("--openapi-title <title>", "OpenAPI document title")
+        .option("--api-version <version>", "Advertised API version", "0.0.0")
+        .option("--format <format>", "Output format: human or json", "human")
+        .action(async (options) => {
+        process.exitCode = await runGraphCommand(() => generateContractArtifacts({
+            appPath: options.app,
+            out: options.out,
+            typescript: options.typescript,
+            openapi: options.openapi,
+            title: options.openapiTitle,
+            version: options.apiVersion,
+        }), options);
+    });
+    program
+        .command("migrate-routes")
+        .description("Check an exactly-once legacy-route to operation mapping")
+        .requiredOption("--catalog <path>", "Legacy route catalog JSON")
+        .requiredOption("--mapping <path>", "Legacy route disposition JSON")
+        .option("-a, --app <path>", "Application module with a named `app` export", "ship.config.ts")
+        .option("--format <format>", "Output format: human or json", "human")
+        .action(async (options) => {
+        process.exitCode = await runGraphCommand(() => checkRouteMigration({
+            appPath: options.app,
+            catalogPath: options.catalog,
+            mappingPath: options.mapping,
+        }), options);
+    });
+    return program;
+}
+/**
+ * @param {CliOptions} [options]
+ * @returns {Command}
+ */
+export function createCli(options = {}) {
+    const packageJson = JSON.parse(readFileSync(options.packageJsonPath ?? join(packageDirectory, "package.json"), "utf8"));
+    const program = new Command()
+        .name(options.name ?? "ship-api")
+        .description(options.description ?? "Inspect and project a compiled Ship application")
+        .version(options.version ?? packageJson.version);
+    return registerApplicationCommands(program, options);
+}
+/** @param {string[]} [argv] */
+export async function runCli(argv = process.argv) {
+    await createCli().parseAsync(argv);
+}
+//# sourceMappingURL=ship-api.js.map

package/lib/ship-api.js.map

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