@gonovus-ai/spec-flow-cli 0.0.0-stage → 0.2.0

package/dist/work-item-asset-commands.js

@@ -0,0 +1,211 @@
+import { InvalidArgumentError } from "commander";
+import { open } from "node:fs/promises";
+import { z } from "zod";
+const uuid = (value) => {
+    if (!z.uuid().safeParse(value).success)
+        throw new InvalidArgumentError("Asset and command identities must be UUIDs");
+    return value;
+};
+const maximumBytes = 10 * 1024 * 1024;
+const reservationSchema = z.object({
+    uploadId: z.uuid(),
+    uploadUrl: z.url(),
+    expiresAt: z.iso.datetime(),
+    headers: z.object({ "Content-Type": z.string().max(127) }).strict(),
+});
+/** One published CLI entry with explicit replayable upload phases. The signed
+ * reservation is read from a file rather than repeated in shell arguments.
+ */
+export function registerWorkItemAssetCommands(workItem, runtime) {
+    const commands = workItem
+        .command("asset")
+        .description("Upload and read private task images and attachments");
+    const retry = {
+        retryTransportOnce: true,
+        ambiguousOutcomeMessage: "Asset command outcome is unknown; retry the same phase with its original inputs and command key",
+    };
+    const writeAllowed = () => runtime.dependencies.environment.SPEC_FLOW_PROJECT_READ_TOKEN === undefined;
+    commands
+        .command("reserve")
+        .requiredOption("--project-id <id>")
+        .requiredOption("--work-item-id <id>")
+        .requiredOption("--filename <name>")
+        .requiredOption("--content-type <type>")
+        .requiredOption("--size <bytes>", "Declared byte length", (value) => {
+        if (!/^[1-9][0-9]*$/u.test(value) || Number(value) > 2_147_483_647)
+            throw new InvalidArgumentError("Asset size must be a positive bounded integer");
+        return Number(value);
+    })
+        .requiredOption("--surface <surface>", "description or comment", (value) => {
+        if (value !== "description" && value !== "comment")
+            throw new InvalidArgumentError("Asset surface must be description or comment");
+        return value;
+    })
+        .requiredOption("--idempotency-key <key>", "Keep this key when retrying reservation", uuid)
+        .action(async (options) => {
+        if (!writeAllowed()) {
+            runtime.setExitCode(runtime.rejectWrite());
+            return;
+        }
+        runtime.setExitCode(await runtime.run((client) => client.POST("/v1/projects/{projectId}/work-items/{workItemId}/assets/uploads", {
+            body: {
+                filename: options.filename,
+                contentType: options.contentType,
+                size: options.size,
+                surface: options.surface,
+            },
+            params: {
+                path: options,
+                header: { "idempotency-key": options.idempotencyKey },
+            },
+        }), retry));
+    });
+    commands
+        .command("put")
+        .description("Upload bytes using reserve JSON saved to an owner-only file; this does not link content")
+        .requiredOption("--reservation-file <path>")
+        .requiredOption("--file <path>")
+        .action(async (options) => {
+        if (!writeAllowed()) {
+            runtime.setExitCode(runtime.rejectWrite());
+            return;
+        }
+        runtime.setExitCode(await runtime.run(async () => {
+            const source = await readBoundedFile(options.reservationFile, 32_768);
+            const reservation = reservationSchema.parse(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(source)));
+            const url = new URL(reservation.uploadUrl);
+            if ((url.protocol !== "http:" && url.protocol !== "https:") ||
+                url.username !== "" ||
+                url.password !== "" ||
+                url.hash !== "" ||
+                new Date(reservation.expiresAt).getTime() <= Date.now())
+                throw new Error("Upload reservation is invalid or expired");
+            const bytes = await readBoundedFile(options.file, maximumBytes);
+            const request = () => new Request(url, {
+                method: "PUT",
+                headers: reservation.headers,
+                body: new Uint8Array(bytes),
+                redirect: "error",
+                credentials: "omit",
+                signal: AbortSignal.timeout(60_000),
+            });
+            let response;
+            try {
+                response = await runtime.dependencies.fetch(request());
+            }
+            catch {
+                response = await runtime.dependencies.fetch(request());
+            }
+            await response.body?.cancel();
+            return {
+                response,
+                ...(response.ok
+                    ? { data: { uploadId: reservation.uploadId, uploaded: true } }
+                    : {
+                        error: {
+                            code: "WORK_ITEM_ASSET_UPLOAD_FAILED",
+                            message: "Asset upload failed; retry the same reservation and file before its expiration",
+                        },
+                    }),
+            };
+        }, retry));
+    });
+    commands
+        .command("finalize")
+        .requiredOption("--project-id <id>")
+        .requiredOption("--work-item-id <id>")
+        .requiredOption("--upload-id <id>", "Server-issued upload UUID", uuid)
+        .requiredOption("--idempotency-key <key>", "Keep this key when retrying finalization", uuid)
+        .action(async (options) => {
+        if (!writeAllowed()) {
+            runtime.setExitCode(runtime.rejectWrite());
+            return;
+        }
+        runtime.setExitCode(await runtime.run((client) => client.POST("/v1/projects/{projectId}/work-items/{workItemId}/assets/finalize", {
+            body: { uploadId: options.uploadId },
+            params: {
+                path: options,
+                header: { "idempotency-key": options.idempotencyKey },
+            },
+        }), retry));
+    });
+    commands
+        .command("get")
+        .requiredOption("--project-id <id>")
+        .requiredOption("--asset-id <id>", "Asset UUID", uuid)
+        .action(async (options) => {
+        runtime.setExitCode(await runtime.run((client) => client.GET("/v1/work-item-assets/{assetId}/metadata", {
+            params: {
+                path: { assetId: options.assetId },
+                query: { projectId: options.projectId },
+            },
+        })));
+    });
+    commands
+        .command("download")
+        .requiredOption("--project-id <id>")
+        .requiredOption("--asset-id <id>", "Asset UUID", uuid)
+        .requiredOption("--output-file <path>", "Create a new owner-only file; existing files are never overwritten")
+        .action(async (options) => {
+        runtime.setExitCode(await runtime.run(async (client) => {
+            const params = {
+                path: { assetId: options.assetId },
+                query: { projectId: options.projectId },
+            };
+            const metadata = await client.GET("/v1/work-item-assets/{assetId}/metadata", { params });
+            if (metadata.data === undefined)
+                return metadata;
+            if (metadata.data.asset.size > maximumBytes)
+                return {
+                    response: new Response(null, { status: 400 }),
+                    error: { message: "Asset exceeds the CLI download size limit" },
+                };
+            const content = await client.GET("/v1/work-item-assets/{assetId}", {
+                params,
+                parseAs: "arrayBuffer",
+            });
+            if (content.data === undefined)
+                return content;
+            if (content.data.byteLength !== metadata.data.asset.size)
+                throw new Error("Asset download length did not match its verified metadata");
+            const file = await open(options.outputFile, "wx", 0o600);
+            try {
+                await file.writeFile(new Uint8Array(content.data));
+            }
+            finally {
+                await file.close();
+            }
+            return {
+                response: content.response,
+                data: {
+                    assetId: options.assetId,
+                    filename: metadata.data.asset.filename,
+                    size: content.data.byteLength,
+                    outputFile: options.outputFile,
+                },
+            };
+        }));
+    });
+}
+async function readBoundedFile(path, maximum) {
+    const file = await open(path, "r");
+    try {
+        if (!(await file.stat()).isFile())
+            throw new Error("Asset input must be a regular file");
+        const bytes = Buffer.alloc(maximum + 1);
+        let offset = 0;
+        while (offset < bytes.length) {
+            const read = await file.read(bytes, offset, bytes.length - offset, offset);
+            if (read.bytesRead === 0)
+                break;
+            offset += read.bytesRead;
+        }
+        if (offset === 0 || offset > maximum)
+            throw new Error("Asset input is empty or exceeds its allowed size");
+        return bytes.subarray(0, offset);
+    }
+    finally {
+        await file.close();
+    }
+}
+//# sourceMappingURL=work-item-asset-commands.js.map

package/dist/work-item-asset-commands.js.map

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

package/dist/work-item-exchange-file.d.ts

@@ -0,0 +1,4 @@
+import type { paths } from "@spec-flow/api-client";
+type ImportBody = NonNullable<paths["/v1/projects/{projectId}/work-items/import"]["post"]["requestBody"]>["content"]["application/json"];
+export declare function readWorkItemImportFile(path: string): Promise<ImportBody | null>;
+export {};

package/dist/work-item-exchange-file.js

@@ -0,0 +1,66 @@
+import { open } from "node:fs/promises";
+import { z } from "zod";
+// Mirrors the generated import request bounds. Project metadata in an export
+// is descriptive only; the explicit command Project selects the destination.
+const maximumBytes = 1_048_576;
+const documentSchema = z.object({
+    project: z.unknown().optional(),
+    tasks: z.array(z.object({
+        title: z.string().max(300),
+        description: z.string().max(20_000).optional(),
+        status: z.string().max(200),
+        priority: z.string().max(200).optional(),
+        startDate: z.string().max(40).nullable().optional(),
+        dueDate: z.string().max(40).nullable().optional(),
+        userId: z.string().max(200).nullable().optional(),
+        labels: z.array(z.object({
+            name: z.string().max(120),
+            color: z.string().max(100),
+        }).strict()).max(1000).optional(),
+    }).strict()).min(1).max(1000),
+}).strict();
+export async function readWorkItemImportFile(path) {
+    try {
+        const file = await open(path, "r");
+        try {
+            if (!(await file.stat()).isFile()) {
+                return null;
+            }
+            // Bound the actual read, including when the file changes after stat.
+            const buffer = Buffer.alloc(maximumBytes + 1);
+            let length = 0;
+            while (length < buffer.length) {
+                const { bytesRead } = await file.read(buffer, length, buffer.length - length, length);
+                if (bytesRead === 0) {
+                    break;
+                }
+                length += bytesRead;
+            }
+            if (length > maximumBytes) {
+                return null;
+            }
+            const source = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(buffer.subarray(0, length)));
+            const parsed = documentSchema.safeParse(source);
+            if (!parsed.success) {
+                return null;
+            }
+            return { tasks: parsed.data.tasks.map((task) => ({
+                    title: task.title,
+                    status: task.status,
+                    ...(task.description === undefined ? {} : { description: task.description }),
+                    ...(task.priority === undefined ? {} : { priority: task.priority }),
+                    ...(task.startDate === undefined ? {} : { startDate: task.startDate }),
+                    ...(task.dueDate === undefined ? {} : { dueDate: task.dueDate }),
+                    ...(task.userId === undefined ? {} : { userId: task.userId }),
+                    ...(task.labels === undefined ? {} : { labels: task.labels }),
+                })) };
+        }
+        finally {
+            await file.close();
+        }
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=work-item-exchange-file.js.map

package/dist/work-item-exchange-file.js.map

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

package/dist/work-item-resource-link-commands.d.ts

@@ -0,0 +1,23 @@
+import { type Command } from "commander";
+import type createClient from "openapi-fetch";
+import type { paths } from "@spec-flow/api-client";
+type Client = ReturnType<typeof createClient<paths>>;
+interface Runtime {
+    readonly run: (request: (client: Client) => Promise<{
+        readonly data?: unknown;
+        readonly error?: unknown;
+        readonly response: Response;
+    }>, options?: {
+        readonly retryTransportOnce?: boolean;
+        readonly ambiguousOutcomeMessage?: string;
+    }) => Promise<number>;
+    readonly setExitCode: (value: number) => void;
+    readonly canWrite: () => boolean;
+    readonly rejectWrite: () => number;
+    readonly parseOpaqueVersion: (value: string) => string;
+    readonly parseLimit: (value: string) => number;
+}
+/** Extend the existing resource-oriented CLI. Targets remain independent
+ * resources; these commands never fetch external content or select a Revision. */
+export declare function registerWorkItemResourceLinkCommands(workItem: Command, spec: Command, runtime: Runtime): void;
+export {};

package/dist/work-item-resource-link-commands.js

@@ -0,0 +1,85 @@
+import { InvalidArgumentError } from "commander";
+import { z } from "zod";
+const uuid = (value) => {
+    if (!z.uuid().safeParse(value).success)
+        throw new InvalidArgumentError("Resource link and command identities must be UUIDs");
+    return value;
+};
+const kind = (value) => {
+    const parsed = z.enum(["spec", "document", "other"]).safeParse(value);
+    if (!parsed.success)
+        throw new InvalidArgumentError("Resource kind must be spec, document, or other");
+    return parsed.data;
+};
+function targetFor(options) {
+    if (options.kind === "spec") {
+        if (options.specId === undefined || options.title !== undefined || options.url !== undefined)
+            throw new InvalidArgumentError("Spec links require --spec-id and do not accept --title or --url");
+        return { kind: "spec", projectId: options.specProjectId ?? options.projectId, specId: options.specId };
+    }
+    if (options.title === undefined || options.url === undefined || options.specId !== undefined || options.specProjectId !== undefined)
+        throw new InvalidArgumentError("Document and other links require --title and --url and do not accept Spec flags");
+    return { kind: options.kind, title: options.title, url: options.url };
+}
+/** Extend the existing resource-oriented CLI. Targets remain independent
+ * resources; these commands never fetch external content or select a Revision. */
+export function registerWorkItemResourceLinkCommands(workItem, spec, runtime) {
+    workItem.command("github-links").description("Read stored GitHub issue, pull request and branch associations")
+        .requiredOption("--project-id <projectId>")
+        .requiredOption("--work-item-id <workItemId>")
+        .action(async (options) => {
+        runtime.setExitCode(await runtime.run((client) => client.GET("/v1/projects/{projectId}/work-items/{workItemId}/github-links", { params: { path: options } })));
+    });
+    const links = workItem.command("resource-link").description("Manage optional Spec, document, and other task references");
+    links.command("list")
+        .requiredOption("--project-id <projectId>")
+        .requiredOption("--work-item-id <workItemId>")
+        .action(async (options) => {
+        runtime.setExitCode(await runtime.run((client) => client.GET("/v1/projects/{projectId}/work-items/{workItemId}/resource-links", { params: { path: options } })));
+    });
+    links.command("add")
+        .requiredOption("--project-id <projectId>")
+        .requiredOption("--work-item-id <workItemId>")
+        .requiredOption("--kind <kind>", "spec, document, or other", kind)
+        .option("--spec-project-id <projectId>", "Target Spec Project; defaults to the task Project")
+        .option("--spec-id <specId>", "Stable public Spec identity")
+        .option("--title <title>", "Document or other resource label")
+        .option("--url <url>", "HTTP(S) resource locator, without embedded credentials")
+        .requiredOption("--idempotency-key <key>", "Reuse the same key and target when retrying", uuid)
+        .action(async (options) => {
+        if (!runtime.canWrite()) {
+            runtime.setExitCode(runtime.rejectWrite());
+            return;
+        }
+        const target = targetFor(options);
+        runtime.setExitCode(await runtime.run((client) => client.POST("/v1/projects/{projectId}/work-items/{workItemId}/resource-links", {
+            body: { target }, params: { path: { projectId: options.projectId, workItemId: options.workItemId }, header: { "idempotency-key": options.idempotencyKey } },
+        }), { retryTransportOnce: true, ambiguousOutcomeMessage: "Resource link outcome is unknown; retry the same target and command key" }));
+    });
+    links.command("remove")
+        .requiredOption("--project-id <projectId>")
+        .requiredOption("--work-item-id <workItemId>")
+        .requiredOption("--link-id <linkId>", "Resource link UUID returned by list", uuid)
+        .requiredOption("--expected-version <version>", "Opaque link version returned by list", runtime.parseOpaqueVersion)
+        .requiredOption("--idempotency-key <key>", "Reuse the same key and version when retrying", uuid)
+        .action(async (options) => {
+        if (!runtime.canWrite()) {
+            runtime.setExitCode(runtime.rejectWrite());
+            return;
+        }
+        runtime.setExitCode(await runtime.run((client) => client.DELETE("/v1/projects/{projectId}/work-items/{workItemId}/resource-links/{linkId}", {
+            params: { path: { projectId: options.projectId, workItemId: options.workItemId, linkId: options.linkId }, header: { "if-match": options.expectedVersion, "idempotency-key": options.idempotencyKey } },
+        }), { retryTransportOnce: true, ambiguousOutcomeMessage: "Resource unlink outcome is unknown; retry the same link, version and command key" }));
+    });
+    spec.command("work-items").description("Read currently authorized tasks referencing a Spec")
+        .requiredOption("--project-id <projectId>")
+        .requiredOption("--spec-id <specId>")
+        .option("--limit <limit>", "Maximum results, 1 through 100", runtime.parseLimit, 50)
+        .option("--cursor <cursor>", "Opaque cursor from the previous page")
+        .action(async (options) => {
+        runtime.setExitCode(await runtime.run((client) => client.GET("/v1/projects/{projectId}/specs/{specId}/work-items", {
+            params: { path: { projectId: options.projectId, specId: options.specId }, query: { limit: options.limit, ...(options.cursor === undefined ? {} : { cursor: options.cursor }) } },
+        })));
+    });
+}
+//# sourceMappingURL=work-item-resource-link-commands.js.map

package/dist/work-item-resource-link-commands.js.map

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

package/dist/work-item-time-entry-input.d.ts

@@ -0,0 +1,4 @@
+/** ISO/calendar validation ported from Kaneo time-entry/schema.ts (MIT). */
+export declare function parseTimeEntryTimestamp(value: string): string;
+export declare function parseTimeEntryUuid(value: string): string;
+export declare function parseTimeEntryDescription(value: string): string;

package/dist/work-item-time-entry-input.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+/** ISO/calendar validation ported from Kaneo time-entry/schema.ts (MIT). */
+export function parseTimeEntryTimestamp(value) {
+    const validFormat = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:\d{2})$/u.test(value);
+    const year = Number(value.slice(0, 4));
+    const month = Number(value.slice(5, 7));
+    const day = Number(value.slice(8, 10));
+    const calendar = new Date(0);
+    calendar.setUTCFullYear(year, month - 1, day);
+    if (!validFormat || Number.isNaN(Date.parse(value)) || year === 0 || calendar.getUTCFullYear() !== year || calendar.getUTCMonth() !== month - 1 || calendar.getUTCDate() !== day)
+        throw new Error("Time Entry timestamp must be a valid ISO 8601 date-time with an offset");
+    const timestamp = new Date(value);
+    if (timestamp.getUTCFullYear() < 1 || timestamp.getUTCFullYear() > 9999)
+        throw new Error("Time Entry UTC year must be between 1 and 9999");
+    return timestamp.toISOString();
+}
+export function parseTimeEntryUuid(value) {
+    if (!z.uuid().safeParse(value).success)
+        throw new Error("Time Entry identifier and command key must be UUIDs");
+    return value;
+}
+export function parseTimeEntryDescription(value) {
+    if (value.length > 20_000 || value.includes("\0"))
+        throw new Error("Time Entry description exceeds the allowed limit");
+    return value;
+}
+//# sourceMappingURL=work-item-time-entry-input.js.map

package/dist/work-item-time-entry-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-time-entry-input.js","sourceRoot":"","sources":["../src/work-item-time-entry-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,WAAW,GAAG,0EAA0E,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3G,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,QAAQ,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5Q,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,cAAc,EAAE,GAAG,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC3I,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC;AACjC,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC/G,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACvH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@gonovus-ai/spec-flow-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "SpecFlow supported command-line client",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gonovus-ai/spec-flow.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "type": "module",
+  "bin": {
+    "specflow": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24.0.0 <25.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "dependencies": {
+    "@napi-rs/keyring": "1.3.0",
+    "commander": "15.0.0",
+    "open": "11.0.0",
+    "openapi-fetch": "^0.17.0",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "@spec-flow/api-client": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/build-cli-default-origin.mjs",
+    "lint": "eslint .",
+    "test": "vitest run --root ../.. --project cli",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }