@forgecart/cli 1.1.0 → 2.1.0

package/dist/bin/forgecart.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/forgecart.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from '../src/cli.js';
+void run();
+//# sourceMappingURL=forgecart.js.map

package/dist/bin/forgecart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgecart.js","sourceRoot":"","sources":["../../bin/forgecart.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,KAAK,GAAG,EAAE,CAAC"}

package/dist/src/cli.d.ts

@@ -1,3 +1,16 @@
 import { Command } from 'commander';
+/** CLI version, kept in sync with `package.json`. */
+export declare const CLI_VERSION = "2.0.0";
+/**
+ * Build the `forgecart` commander program with the full command surface.
+ *
+ * `init` is fully implemented; the remaining commands are registered with their
+ * exact options/arguments but announce that they arrive with the publish
+ * pipeline.
+ */
 export declare function createProgram(): Command;
-//# sourceMappingURL=cli.d.ts.map
+/**
+ * Parse argv and execute the program. Any thrown error is surfaced on stderr and
+ * the process exits with a non-zero status. Errors are never swallowed.
+ */
+export declare function run(argv?: string[]): Promise<void>;

package/dist/src/cli.js

@@ -1,32 +1,47 @@
 import { Command } from 'commander';
-import { createDeleteCommand } from './commands/delete.js';
-import { createDeployCommand } from './commands/deploy.js';
-import { createEnvCommand } from './commands/env.js';
-import { createInitApplicationCommand, createInitCommand, } from './commands/init.js';
-import { createListCommand } from './commands/list.js';
-import { createLoginCommand } from './commands/login.js';
-import { createLogsCommand } from './commands/logs.js';
-import { createScaleCommand } from './commands/scale.js';
-import { createStatusCommand } from './commands/status.js';
-import { createWhoamiCommand } from './commands/whoami.js';
+import { createInitCommand } from './commands/init.js';
+import { createDeleteCommand, createDeployCommand, createEnvCommand, createInitApplicationCommand, createListCommand, createLogsCommand, createScaleCommand, createStatusCommand, createWhoamiCommand, } from './commands/placeholders.js';
+import { printError } from './output.js';
+/** CLI version, kept in sync with `package.json`. */
+export const CLI_VERSION = '2.0.0';
+/**
+ * Build the `forgecart` commander program with the full command surface.
+ *
+ * `init` is fully implemented; the remaining commands are registered with their
+ * exact options/arguments but announce that they arrive with the publish
+ * pipeline.
+ */
 export function createProgram() {
     const program = new Command();
     program
         .name('forgecart')
-        .description('CLI tool for deploying applications to ForgeCart')
-        .version('1.0.0');
-    // Add commands
-    program.addCommand(createLoginCommand());
+        .description('CLI for scaffolding and operating ForgeCart channel storefronts')
+        .version(CLI_VERSION);
     program.addCommand(createInitCommand());
     program.addCommand(createInitApplicationCommand());
     program.addCommand(createDeployCommand());
     program.addCommand(createListCommand());
     program.addCommand(createStatusCommand());
+    program.addCommand(createLogsCommand());
     program.addCommand(createDeleteCommand());
     program.addCommand(createScaleCommand());
     program.addCommand(createEnvCommand());
-    program.addCommand(createLogsCommand());
     program.addCommand(createWhoamiCommand());
     return program;
 }
+/**
+ * Parse argv and execute the program. Any thrown error is surfaced on stderr and
+ * the process exits with a non-zero status. Errors are never swallowed.
+ */
+export async function run(argv = process.argv) {
+    const program = createProgram();
+    try {
+        await program.parseAsync(argv);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        printError(`Error: ${message}`);
+        process.exitCode = 1;
+    }
+}
 //# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE1D,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;IAE7B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,WAAW,CAAC,kDAAkD,CAAC;SAC/D,OAAO,CAAC,OAAO,CAAC,CAAA;IAEnB,eAAe;IACf,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAA;IACxC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;IACvC,OAAO,CAAC,UAAU,CAAC,4BAA4B,EAAE,CAAC,CAAA;IAClD,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA;IACzC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;IACvC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA;IACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA;IACzC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAA;IACxC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACtC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;IACvC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA;IAEzC,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,WAAW,CAAC,iEAAiE,CAAC;SAC9E,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAiB,OAAO,CAAC,IAAI;IACrD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,UAAU,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/src/commands/init.d.ts

@@ -1,4 +1,41 @@
 import { Command } from 'commander';
+/** Default shop API base. Overridable via `--api-url`. */
+export declare const DEFAULT_SHOP_API_URL = "https://api.forgecart.com";
+/**
+ * Environment variable naming a dependency-warmed storefront template — a copy
+ * of the bundled template with `node_modules` (and the generated
+ * `package-lock.json`) already installed. The workspace-pod image bakes one at
+ * build time (`docker/workspace-pod/Dockerfile`) and exports this variable so a
+ * pod scaffold copies warm dependencies instead of paying a cold `npm install`.
+ */
+export declare const WORKSPACE_TEMPLATE_DIR_ENV = "WORKSPACE_TEMPLATE_DIR";
+/**
+ * Marker file, relative to the scaffolded storefront root, recording that
+ * `node_modules` was copied fully installed from a warmed template whose
+ * manifest matches this CLI's bundled template. Orchestrators (the agent's
+ * `ChannelWorkspaceService`) skip their `npm install` step when the marker is
+ * present right after a fresh scaffold; its absence always falls back to a
+ * regular install, so older images and cold scaffolds keep working unchanged.
+ */
+export declare const DEPS_READY_MARKER_PATH = ".forgecart/deps-ready.json";
+/** Resolved options for `forgecart init`. */
+export interface InitOptions {
+    /** Channel token (required). */
+    token?: string;
+    /** Shop API base URL. */
+    apiUrl: string;
+    /** Whether to also scaffold a NestJS application (planned for a later phase). */
+    application?: boolean;
+}
+/**
+ * Run `forgecart init`.
+ *
+ * Resolves the target directory, scaffolds the storefront from the warmed
+ * template when one is available (see {@link resolveScaffoldPlan}) or the
+ * bundled template otherwise, writes the ForgeCart config and `.env.local`, and
+ * prints next steps. Throws a clear Error on any failure (missing token,
+ * missing template, copy failure).
+ */
+export declare function runInit(name: string | undefined, options: InitOptions): Promise<void>;
+/** Build the `init [name]` command. */
 export declare function createInitCommand(): Command;
-export declare function createInitApplicationCommand(): Command;
-//# sourceMappingURL=init.d.ts.map