assistant-ui 0.0.125 → 0.0.127

package/dist/lib/cloud-setup-login.js

@@ -2,7 +2,7 @@ import { abortable } from "./cloud-abort.js";
 import { validateCloudUrl } from "./cloud-url.js";
 import { randomUUID } from "node:crypto";
 import { StatewireClient, StatewireHttp } from "statewire";
-//#region src/lib/cloud-setup-login.ts
+// src/lib/cloud-setup-login.ts
 const validInputs = (inputs) => Array.isArray(inputs) && inputs.every((input) => input !== null && typeof input === "object" && typeof input.id === "string" && typeof input.status === "string");
 const setupLoginUrl = (authorization, issuer, attempt = randomUUID()) => {
 	const url = new URL(authorization.verificationUriComplete);
@@ -131,7 +131,6 @@ const connectCloudLoginSetup = async (url) => {
 		dispose
 	};
 };
-//#endregion
 export { connectCloudLoginSetup, setupLoginUrl };
 
 //# sourceMappingURL=cloud-setup-login.js.map

package/dist/lib/cloud-url.js

@@ -1,4 +1,4 @@
-//#region src/lib/cloud-url.ts
+// src/lib/cloud-url.ts
 const validateCloudUrl = (value) => {
 	const url = new URL(value);
 	if (url.username || url.password || url.search || url.hash || url.protocol !== "https:" && !(url.protocol === "http:" && [
@@ -8,7 +8,6 @@ const validateCloudUrl = (value) => {
 	].includes(url.hostname))) throw new Error("Cloud, accounts and setup URLs must use HTTPS or HTTP localhost for development.");
 	return value.replace(/\/+$/, "");
 };
-//#endregion
 export { validateCloudUrl };
 
 //# sourceMappingURL=cloud-url.js.map

package/dist/lib/create-project.js

@@ -8,7 +8,7 @@ import * as fs$1 from "node:fs";
 import * as path$1 from "node:path";
 import * as os$1 from "node:os";
 import { parse, printParseErrorCode } from "jsonc-parser";
-//#region src/lib/create-project.ts
+// src/lib/create-project.ts
 const LOCAL_PROJECT_ARTIFACT_DIRS = [
 	"node_modules",
 	".next",
@@ -423,7 +423,6 @@ async function installShadcnRegistry(projectDir, components, label, pm) {
 		throw new Error(`Failed to install ${label}: ${message}`);
 	}
 }
-//#endregion
 export { cleanupPendingProjectDownloads, downloadProject, reconcileAssistantUIImportLayout, resolveLatestReleaseRef, scaffoldProject, scanRequiredComponents, transformProject };
 
 //# sourceMappingURL=create-project.js.map

package/dist/lib/handle-cli-error.js

@@ -1,6 +1,6 @@
 import { SpawnSignalError } from "./run-spawn.js";
 import { constants } from "node:os";
-//#region src/lib/handle-cli-error.ts
+// src/lib/handle-cli-error.ts
 function handleCliError(error) {
 	if (error instanceof SpawnSignalError) {
 		process.exitCode = 128 + (constants.signals[error.signal] ?? 0);
@@ -11,7 +11,6 @@ function handleCliError(error) {
 	console.error(error);
 	process.exitCode = 1;
 }
-//#endregion
 export { handleCliError };
 
 //# sourceMappingURL=handle-cli-error.js.map

package/dist/lib/install-ai-sdk-lib.js

@@ -1,5 +1,5 @@
 import { installPackageIfNeeded } from "./utils/package-installer.js";
-//#region src/lib/install-ai-sdk-lib.ts
+// src/lib/install-ai-sdk-lib.ts
 async function installAiSdkLib() {
 	await installPackageIfNeeded({
 		packageName: "@assistant-ui/ai-sdk",
@@ -16,7 +16,6 @@ async function installAiSdkLib() {
 		notFoundMessage: "No legacy AI SDK imports found; skipping installation."
 	});
 }
-//#endregion
 export { installAiSdkLib as default };
 
 //# sourceMappingURL=install-ai-sdk-lib.js.map

package/dist/lib/install-edge-lib.js

@@ -1,5 +1,5 @@
 import { installPackageIfNeeded } from "./utils/package-installer.js";
-//#region src/lib/install-edge-lib.ts
+// src/lib/install-edge-lib.ts
 async function installEdgeLib() {
 	await installPackageIfNeeded({
 		packageName: "@assistant-ui/ai-sdk",
@@ -9,7 +9,6 @@ async function installEdgeLib() {
 		notFoundMessage: "No Edge Runtime imports found; skipping installation."
 	});
 }
-//#endregion
 export { installEdgeLib as default };
 
 //# sourceMappingURL=install-edge-lib.js.map

package/dist/lib/run-spawn.js

@@ -1,5 +1,5 @@
 import { spawn } from "cross-spawn";
-//#region src/lib/run-spawn.ts
+// src/lib/run-spawn.ts
 var SpawnExitError = class extends Error {
 	code;
 	stderr;
@@ -113,7 +113,6 @@ function runSpawn(command, args, cwd) {
 function runSpawnCapture(command, args, cwd) {
 	return spawnProcess(command, args, cwd, true);
 }
-//#endregion
 export { SpawnExitError, SpawnSignalError, hasActiveSpawn, runSpawn, runSpawnCapture };
 
 //# sourceMappingURL=run-spawn.js.map

package/dist/lib/safe-project-file.d.ts

@@ -0,0 +1,2 @@
+export declare const assertSafeProjectFile: (file: string, projectRoot: string) => void;
+//# sourceMappingURL=safe-project-file.d.ts.map

package/dist/lib/safe-project-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-project-file.d.ts","sourceRoot":"","sources":["../../src/lib/safe-project-file.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,SA2BtE,CAAC"}

package/dist/lib/safe-project-file.js

@@ -0,0 +1,25 @@
+import fs from "node:fs";
+import path from "node:path";
+// src/lib/safe-project-file.ts
+const assertSafeProjectFile = (file, projectRoot) => {
+	try {
+		if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`${file} is a symbolic link`);
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	const root = fs.realpathSync(projectRoot);
+	let parent = path.dirname(file);
+	const missing = [];
+	while (!fs.existsSync(parent)) {
+		const next = path.dirname(parent);
+		if (next === parent) break;
+		missing.unshift(path.basename(parent));
+		parent = next;
+	}
+	const resolvedParent = path.join(fs.realpathSync(parent), ...missing);
+	const relative = path.relative(root, resolvedParent);
+	if (relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) throw new Error(`${file} has a parent directory outside the project`);
+};
+export { assertSafeProjectFile };
+
+//# sourceMappingURL=safe-project-file.js.map

package/dist/lib/safe-project-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-project-file.js","names":[],"sources":["../../src/lib/safe-project-file.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport const assertSafeProjectFile = (file: string, projectRoot: string) => {\n  try {\n    if (fs.lstatSync(file).isSymbolicLink()) {\n      throw new Error(`${file} is a symbolic link`);\n    }\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n  }\n\n  const root = fs.realpathSync(projectRoot);\n  let parent = path.dirname(file);\n  const missing: string[] = [];\n  while (!fs.existsSync(parent)) {\n    const next = path.dirname(parent);\n    if (next === parent) break;\n    missing.unshift(path.basename(parent));\n    parent = next;\n  }\n  const resolvedParent = path.join(fs.realpathSync(parent), ...missing);\n  const relative = path.relative(root, resolvedParent);\n  if (\n    relative === \"..\" ||\n    relative.startsWith(`..${path.sep}`) ||\n    path.isAbsolute(relative)\n  ) {\n    throw new Error(`${file} has a parent directory outside the project`);\n  }\n};\n"],"mappings":";;;AAGA,MAAa,yBAAyB,MAAc,gBAAwB;CAC1E,IAAI;EACF,IAAI,GAAG,UAAU,IAAI,CAAC,CAAC,eAAe,GACpC,MAAM,IAAI,MAAM,GAAG,KAAK,oBAAoB;CAEhD,SAAS,OAAO;EACd,IAAK,MAAgC,SAAS,UAAU,MAAM;CAChE;CAEA,MAAM,OAAO,GAAG,aAAa,WAAW;CACxC,IAAI,SAAS,KAAK,QAAQ,IAAI;CAC9B,MAAM,UAAoB,CAAC;CAC3B,OAAO,CAAC,GAAG,WAAW,MAAM,GAAG;EAC7B,MAAM,OAAO,KAAK,QAAQ,MAAM;EAChC,IAAI,SAAS,QAAQ;EACrB,QAAQ,QAAQ,KAAK,SAAS,MAAM,CAAC;EACrC,SAAS;CACX;CACA,MAAM,iBAAiB,KAAK,KAAK,GAAG,aAAa,MAAM,GAAG,GAAG,OAAO;CACpE,MAAM,WAAW,KAAK,SAAS,MAAM,cAAc;CACnD,IACE,aAAa,QACb,SAAS,WAAW,KAAK,KAAK,KAAK,KACnC,KAAK,WAAW,QAAQ,GAExB,MAAM,IAAI,MAAM,GAAG,KAAK,4CAA4C;AAExE"}

package/dist/lib/transform.js

@@ -4,7 +4,7 @@ import * as fs$1 from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import debug from "debug";
-//#region src/lib/transform.ts
+// src/lib/transform.ts
 const log = debug("codemod:transform");
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -70,7 +70,6 @@ async function transform(codemod, source, transformOptions, options = { logStatu
 	}
 	return [];
 }
-//#endregion
 export { getRelevantFiles, transform };
 
 //# sourceMappingURL=transform.js.map

package/dist/lib/upgrade.js

@@ -4,7 +4,7 @@ import installEdgeLib from "./install-edge-lib.js";
 import installAiSdkLib from "./install-ai-sdk-lib.js";
 import debug from "debug";
 import { Presets, SingleBar } from "cli-progress";
-//#region src/lib/upgrade.ts
+// src/lib/upgrade.ts
 const bundle = [
 	"v0-9/edge-package-split",
 	"v0-11/content-part-to-message-part",
@@ -63,7 +63,6 @@ async function upgrade(options) {
 	log("Upgrade complete.");
 	logger.success("Upgrade complete!");
 }
-//#endregion
 export { upgrade };
 
 //# sourceMappingURL=upgrade.js.map

package/dist/lib/utils/config.js

@@ -1,7 +1,7 @@
 import { logger } from "./logger.js";
 import * as fs$1 from "node:fs";
 import * as path$1 from "node:path";
-//#region src/lib/utils/config.ts
+// src/lib/utils/config.ts
 const CONFIG_FILE_NAMES = ["assistant-ui.json", "components.json"];
 function getConfig(cwd = process.cwd()) {
 	for (const fileName of CONFIG_FILE_NAMES) {
@@ -23,7 +23,6 @@ function saveConfig(config, cwd = process.cwd()) {
 function hasConfig(cwd = process.cwd()) {
 	return CONFIG_FILE_NAMES.some((fileName) => fs$1.existsSync(path$1.join(cwd, fileName)));
 }
-//#endregion
 export { getConfig, hasConfig, saveConfig };
 
 //# sourceMappingURL=config.js.map

package/dist/lib/utils/download.js

@@ -1,5 +1,5 @@
 import { downloadTemplate } from "giget";
-//#region src/lib/utils/download.ts
+// src/lib/utils/download.ts
 const DOWNLOAD_TIMEOUT_MS = 3e4;
 function resolveGitHubAuthToken() {
 	return (process.env.GIGET_AUTH ?? process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN)?.trim() || void 0;
@@ -35,7 +35,6 @@ async function withStagedDownload(source, options, timeoutMessage, cleanup, cons
 		}
 	}
 }
-//#endregion
 export { DOWNLOAD_TIMEOUT_MS, resolveGitHubAuthToken, withStagedDownload };
 
 //# sourceMappingURL=download.js.map

package/dist/lib/utils/file-scanner.js

@@ -1,7 +1,7 @@
 import * as fs$1 from "node:fs";
 import * as path$1 from "node:path";
 import { sync } from "glob";
-//#region src/lib/utils/file-scanner.ts
+// src/lib/utils/file-scanner.ts
 function* readProjectFiles(pattern, options) {
 	const files = sync(pattern, options);
 	for (const file of files) {
@@ -32,7 +32,6 @@ function scanForImport(importPattern, options = {}) {
 	})) if (patterns.some((p) => content.includes(p))) return true;
 	return false;
 }
-//#endregion
 export { readProjectFiles, scanForImport };
 
 //# sourceMappingURL=file-scanner.js.map

package/dist/lib/utils/logger.js

@@ -1,5 +1,5 @@
 import chalk from "chalk";
-//#region src/lib/utils/logger.ts
+// src/lib/utils/logger.ts
 const logger = {
 	info: (message) => {
 		console.log(chalk.blue(message));
@@ -20,7 +20,6 @@ const logger = {
 		console.log("");
 	}
 };
-//#endregion
 export { logger };
 
 //# sourceMappingURL=logger.js.map

package/dist/lib/utils/package-installer.js

@@ -1,7 +1,7 @@
 import { logger } from "./logger.js";
 import { askQuestion, installPackage, isPackageInstalled } from "./package-manager.js";
 import { scanForImport } from "./file-scanner.js";
-//#region src/lib/utils/package-installer.ts
+// src/lib/utils/package-installer.ts
 async function installPackageIfNeeded(config) {
 	if (!scanForImport(config.importPatterns)) {
 		logger.info(config.notFoundMessage);
@@ -16,7 +16,6 @@ async function installPackageIfNeeded(config) {
 		if (!await installPackage(config.packageName)) throw new Error(`Failed to install ${config.packageName}`);
 	} else logger.info("Skipping installation.");
 }
-//#endregion
 export { installPackageIfNeeded };
 
 //# sourceMappingURL=package-installer.js.map

package/dist/lib/utils/package-json.js

@@ -1,11 +1,10 @@
 import { logger } from "./logger.js";
-//#region src/lib/utils/package-json.ts
+// src/lib/utils/package-json.ts
 function logPackageJsonParseError(packageJsonPath, commandName) {
 	logger.error("Could not parse package.json.");
 	console.error(`Package path: ${packageJsonPath}`);
 	console.error(`Fix the JSON syntax in that file, then run: assistant-ui ${commandName}`);
 }
-//#endregion
 export { logPackageJsonParseError };
 
 //# sourceMappingURL=package-json.js.map

package/dist/lib/utils/package-manager.js

@@ -4,7 +4,7 @@ import * as fs$1 from "node:fs";
 import * as path$1 from "node:path";
 import { detect } from "detect-package-manager";
 import * as readline from "node:readline";
-//#region src/lib/utils/package-manager.ts
+// src/lib/utils/package-manager.ts
 function dlxCommand(pm) {
 	switch (pm) {
 		case "pnpm": return ["pnpm", ["dlx"]];
@@ -106,7 +106,6 @@ async function installPackage(packageName, cwd) {
 		return false;
 	}
 }
-//#endregion
 export { askQuestion, dlxCommand, getInstallCommand, installPackage, isPackageInstalled, resolvePackageManager, resolvePackageManagerForCwd };
 
 //# sourceMappingURL=package-manager.js.map

package/dist/lib/utils/registry.js

@@ -1,6 +1,6 @@
 import * as fs$1 from "node:fs";
 import * as path$1 from "node:path";
-//#region src/lib/utils/registry.ts
+// src/lib/utils/registry.ts
 const REGISTRY_BASE_URL = "https://r.assistant-ui.com";
 const SHARED_REGISTRY_ITEMS = /* @__PURE__ */ new Set(["utils"]);
 function detectRegistryPlatform(cwd) {
@@ -30,7 +30,6 @@ function resolveRegistryItemUrl(component, style, platform = "web") {
 	if (style === void 0) return `${REGISTRY_BASE_URL}/base/${encodeURIComponent(component)}.json`;
 	return `${style.startsWith("base-") ? `${REGISTRY_BASE_URL}/styles/${encodeURIComponent(style)}` : REGISTRY_BASE_URL}/${encodeURIComponent(component)}.json`;
 }
-//#endregion
 export { SHARED_REGISTRY_ITEMS, detectRegistryPlatform, getComponentsJsonStyle, resolveQuickStartRegistryUrl, resolveRegistryItemUrl };
 
 //# sourceMappingURL=registry.js.map

package/dist/lib/utils/workspace.js

@@ -1,6 +1,6 @@
 import * as fs$1 from "node:fs";
 import * as path$1 from "node:path";
-//#region src/lib/utils/workspace.ts
+// src/lib/utils/workspace.ts
 function resolveRealPath(inputPath) {
 	const resolved = path$1.resolve(inputPath);
 	try {
@@ -22,7 +22,6 @@ function findWorkspaceRoot(cwd) {
 		dir = path$1.dirname(dir);
 	}
 }
-//#endregion
 export { findWorkspaceRoot, resolveRealPath };
 
 //# sourceMappingURL=workspace.js.map

package/dist/program.js

@@ -9,11 +9,10 @@ import { mcp } from "./commands/mcp.js";
 import { update } from "./commands/update.js";
 import { codemodCommand, upgradeCommand } from "./commands/upgrade.js";
 import { Command } from "commander";
-//#region src/program.ts
+// src/program.ts
 function buildProgram() {
 	return new Command().name("assistant-ui").description("add components and dependencies to your project").addCommand(add).addCommand(create).addCommand(init).addCommand(mcp).addCommand(codemodCommand).addCommand(upgradeCommand).addCommand(update).addCommand(agent).addCommand(cloud).addCommand(info).addCommand(doctor);
 }
-//#endregion
 export { buildProgram };
 
 //# sourceMappingURL=program.js.map

package/dist/run.js

@@ -1,9 +1,8 @@
 import { buildProgram } from "./program.js";
-//#region src/run.ts
+// src/run.ts
 async function runCli() {
 	await buildProgram().parseAsync();
 }
-//#endregion
 export { runCli };
 
 //# sourceMappingURL=run.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistant-ui",
-  "version": "0.0.125",
+  "version": "0.0.127",
   "description": "CLI for assistant-ui",
   "keywords": [
     "cli",
@@ -39,20 +39,20 @@
     "glob": "^13.0.6",
     "jscodeshift": "^17.4.0",
     "jsonc-parser": "^3.3.1",
-    "react": "^19.3.0",
+    "react": "^19.3.1",
     "semver": "^7.8.5",
-    "statewire": "^0.19.4"
+    "statewire": "^0.22.1"
   },
   "devDependencies": {
-    "@assistant-ui/x-buildutils": "0.0.30",
+    "@assistant-ui/x-buildutils": "0.0.32",
     "@types/cli-progress": "^3.11.6",
     "@types/cross-spawn": "^6.0.6",
     "@types/debug": "^4.1.13",
     "@types/jscodeshift": "^17.3.0",
-    "@types/node": "^26.6.4",
+    "@types/node": "^26.6.5",
     "@types/semver": "^7.8.0",
-    "@vitest/coverage-v8": "^5.0.3",
-    "vitest": "^5.0.3"
+    "@vitest/coverage-v8": "^5.0.5",
+    "vitest": "^5.0.5"
   },
   "publishConfig": {
     "access": "public",

package/src/commands/cloud.test.ts

@@ -11,6 +11,7 @@ const {
   cloudAccessToken,
   savedCloudAccessToken,
   runCloudCommand,
+  sendCloudCommand,
   loginToCloud,
   provisionCloudHarness,
   scaffold,
@@ -23,6 +24,7 @@ const {
   cloudAccessToken: vi.fn(),
   savedCloudAccessToken: vi.fn(),
   runCloudCommand: vi.fn(),
+  sendCloudCommand: vi.fn(),
   loginToCloud: vi.fn(),
   provisionCloudHarness: vi.fn(),
   scaffold: vi.fn(),
@@ -45,6 +47,7 @@ vi.mock("../lib/cloud-auth", async (importOriginal) => ({
 vi.mock("../lib/cloud-remote", async (importOriginal) => ({
   ...(await importOriginal<typeof import("../lib/cloud-remote")>()),
   runCloudCommand,
+  sendCloudCommand,
 }));
 vi.mock("../lib/cloud-provision", async (importOriginal) => ({
   ...(await importOriginal<typeof import("../lib/cloud-provision")>()),
@@ -102,6 +105,106 @@ const options = {
 };
 
 describe("cloud setup", () => {
+  it("creates a new organization and project through Cloud commands", async () => {
+    const directory = await fixture();
+    fetchOrganizations.mockResolvedValue([]);
+    fetchProjects.mockResolvedValue([]);
+    sendCloudCommand.mockReset();
+    sendCloudCommand
+      .mockResolvedValueOnce({
+        exitCode: 0,
+        stdout: JSON.stringify({
+          id: "org-new",
+          slug: "new-team",
+          name: "New",
+        }),
+      })
+      .mockResolvedValueOnce({
+        exitCode: 0,
+        stdout: JSON.stringify({
+          id: "project-new",
+          slug: "chat-app",
+          name: "Chat",
+        }),
+      });
+    provisionCloudHarness.mockResolvedValueOnce({
+      project_id: "project-new",
+      workspace_id: "shared-workspace",
+      harness_id: "harness-1",
+      harness_origin: "https://harness.example.com",
+      api_origin: "https://project.example.com",
+      api_key: "cloud-server-key",
+    });
+    await setupCloud(directory, {
+      ...options,
+      newOrg: "new-team",
+      newProject: "chat-app",
+      name: "Chat",
+    });
+    expect(sendCloudCommand.mock.calls).toEqual([
+      [
+        options.apiUrl,
+        ["orgs", "create", "new-team", "--name", "Chat", "--json"],
+        "oauth-access",
+      ],
+      [
+        options.apiUrl,
+        [
+          "projects",
+          "create",
+          "chat-app",
+          "--name",
+          "Chat",
+          "--org",
+          "org-new",
+          "--json",
+        ],
+        "oauth-access",
+      ],
+    ]);
+    expect(createProject).not.toHaveBeenCalled();
+    expect(provisionCloudHarness).toHaveBeenLastCalledWith(
+      options.apiUrl,
+      "oauth-access",
+      expect.objectContaining({ org_id: "org-new", project_id: "project-new" }),
+    );
+  });
+
+  it("refuses a creation answer without an id, slug and name", async () => {
+    const directory = await fixture();
+    fetchProjects.mockResolvedValue([]);
+    sendCloudCommand.mockReset();
+    const before = provisionCloudHarness.mock.calls.length;
+    for (const stdout of [
+      JSON.stringify({ project: { id: "p" } }),
+      JSON.stringify({ id: "", slug: "chat-app", name: "Chat" }),
+      "not json",
+    ]) {
+      sendCloudCommand.mockResolvedValueOnce({ exitCode: 0, stdout });
+      await expect(
+        setupCloud(directory, { ...options, newProject: "chat-app" }),
+      ).rejects.toThrow(/Unexpected response from `projects create/);
+    }
+    expect(provisionCloudHarness.mock.calls.length).toBe(before);
+  });
+
+  it("stops with the Cloud command's error when creation is refused", async () => {
+    const directory = await fixture();
+    fetchProjects.mockResolvedValue([]);
+    sendCloudCommand.mockReset();
+    sendCloudCommand.mockResolvedValueOnce({
+      exitCode: 1,
+      stderr: "You don't have permission to create projects in team.\n",
+    });
+    const before = provisionCloudHarness.mock.calls.length;
+    await expect(
+      setupCloud(directory, { ...options, newProject: "chat-app" }),
+    ).rejects.toThrow(
+      "Could not create project: You don't have permission to create projects in team.",
+    );
+    expect(provisionCloudHarness.mock.calls.length).toBe(before);
+  });
+
   it("selects an existing project and scaffolds a shared harness with server-only credentials", async () => {
     const directory = await fixture();
     await setupCloud(directory, { ...options, org: "team", project: "chat" });
@@ -293,4 +396,57 @@ describe("cloud remote forwarding", () => {
     expect(savedCloudAccessToken).toHaveBeenCalled();
     expect(cloudAccessToken).not.toHaveBeenCalled();
   });
+
+  it("answers help for a local command here, with its flags", async () => {
+    const write = vi
+      .spyOn(process.stdout, "write")
+      .mockImplementation(() => true);
+    try {
+      await expect(forwarded(["help", "setup"])).resolves.toEqual([]);
+      const text = write.mock.calls.map(([chunk]) => String(chunk)).join("");
+      expect(text).toMatch(/--new-project <slug>/);
+      expect(text).toMatch(/--backend-url <url>/);
+    } finally {
+      write.mockRestore();
+    }
+  });
+
+  it("sends the directory defaults and the action handlers along", async () => {
+    runCloudCommand.mockImplementationOnce(async (_args, options) => {
+      expect(typeof options.defaults).toBe("function");
+      expect(typeof options.openUrl).toBe("function");
+      return 0;
+    });
+    await cloud.parseAsync(["projects", "show"], { from: "user" });
+    expect(runCloudCommand).toHaveBeenCalled();
+  });
+});
+
+describe("cloud --no-open", () => {
+  const sent = async (argv: string[]) => {
+    runCloudCommand.mockClear();
+    runCloudCommand.mockResolvedValue(0);
+    await cloud.parseAsync(argv, { from: "user" });
+    const [args, options] = runCloudCommand.mock.calls[0]!;
+    return { args, noOpen: options.noOpen };
+  };
+
+  it("is the client's flag before --, and the remote command's after it", async () => {
+    await expect(
+      sent(["projects", "list", "--no-open", "--json"]),
+    ).resolves.toEqual({
+      args: ["projects", "list", "--json"],
+      noOpen: true,
+    });
+    await expect(
+      sent(["projects", "show", "--", "--no-open"]),
+    ).resolves.toEqual({
+      args: ["projects", "show", "--no-open"],
+      noOpen: false,
+    });
+    await expect(sent(["projects", "list"])).resolves.toEqual({
+      args: ["projects", "list"],
+      noOpen: false,
+    });
+  });
 });