@caelo-cms/provisioning 0.10.47 → 0.10.49

package/src/cli-routing.test.ts

@@ -0,0 +1,45 @@
+// SPDX-License-Identifier: MPL-2.0
+
+import { describe, expect, it } from "bun:test";
+import { initDelegatesToWizard, resolveCliRoute } from "./cli-routing.js";
+
+const HANDLERS = ["init", "upgrade", "wizard", "version", "--version", "-v"];
+const argv = (...rest: string[]) => ["bun", "cli.js", ...rest];
+
+describe("resolveCliRoute", () => {
+  it("routes the documented flags-only invocation to the wizard", () => {
+    expect(
+      resolveCliRoute(argv("--provider", "gcp-firebase", "--domain", "example.com"), HANDLERS),
+    ).toEqual({ kind: "wizard" });
+  });
+
+  it("routes a bare invocation to the wizard", () => {
+    expect(resolveCliRoute(argv(), HANDLERS)).toEqual({ kind: "wizard" });
+  });
+
+  it("dispatches known sub-commands, including flag-shaped ones", () => {
+    expect(resolveCliRoute(argv("upgrade", "--channel", "rc"), HANDLERS)).toEqual({
+      kind: "handler",
+      name: "upgrade",
+    });
+    expect(resolveCliRoute(argv("--version"), HANDLERS)).toEqual({
+      kind: "handler",
+      name: "--version",
+    });
+  });
+
+  it("prints usage for unknown sub-commands, --no-wizard and --help", () => {
+    expect(resolveCliRoute(argv("deploy"), HANDLERS)).toEqual({ kind: "usage" });
+    expect(resolveCliRoute(argv("--no-wizard"), HANDLERS)).toEqual({ kind: "usage" });
+    expect(resolveCliRoute(argv("--help"), HANDLERS)).toEqual({ kind: "usage" });
+  });
+});
+
+describe("initDelegatesToWizard", () => {
+  it("hands every cloud provider to the wizard and keeps self-hosted on init", () => {
+    for (const p of ["gcp", "gcp-firebase", "aws", "azure"]) {
+      expect(initDelegatesToWizard(p)).toBe(true);
+    }
+    expect(initDelegatesToWizard("self-hosted")).toBe(false);
+  });
+});

package/src/cli-routing.ts

@@ -0,0 +1,43 @@
+// SPDX-License-Identifier: MPL-2.0
+
+/**
+ * Argv → command routing for `cms-provision`, kept free of side effects so
+ * it can be unit-tested (cli.ts dispatches at module load).
+ *
+ * The documented one-command entry point (CLAUDE.md §11.C) is
+ * `bunx @caelo-cms/provisioning --provider gcp --domain …` — flags only,
+ * no sub-command. That shape must reach the wizard; treating the first
+ * flag as an unknown sub-command silently prints usage instead.
+ */
+
+/** What the CLI should do for a given argv. */
+export type CliRoute = { kind: "handler"; name: string } | { kind: "wizard" } | { kind: "usage" };
+
+/**
+ * Resolve the route for `argv` (a full `process.argv`, so the sub-command
+ * sits at index 2).
+ *
+ * @param handlerNames - registered sub-commands; flag-shaped names such as
+ *   `--version` win over the wizard fallback.
+ */
+export function resolveCliRoute(argv: readonly string[], handlerNames: Iterable<string>): CliRoute {
+  const first = argv[2];
+  if (first !== undefined && new Set(handlerNames).has(first)) {
+    return { kind: "handler", name: first };
+  }
+  const flagsOnly = first === undefined || first.startsWith("-");
+  if (!flagsOnly) return { kind: "usage" };
+  if (argv.includes("--no-wizard") || argv.includes("--help") || argv.includes("-h")) {
+    return { kind: "usage" };
+  }
+  return { kind: "wizard" };
+}
+
+/**
+ * Whether `init --provider <p>` belongs to the wizard. Only self-hosted
+ * keeps the compose-file `init` flow; every cloud provider is provisioned
+ * end-to-end by the wizard rather than by printed manual Pulumi steps.
+ */
+export function initDelegatesToWizard(provider: string): boolean {
+  return provider !== "self-hosted";
+}