@mycadet/assistant 0.12.7 → 0.12.9

package/src/cli/lib/__tests__/plugin-details.test.ts

@@ -3,7 +3,7 @@
  *
  * At the default ref, the catalog entry is resolved from the gated plugin
  * catalog (the same source search and install-by-name use): these tests run
- * with platform features disabled (`CADET_DISABLE_PLATFORM`) so the catalog is
+ * with platform features disabled (`CADET_DISABLE_CLOUD`) so the catalog is
  * the bundled manifest — real plugin names / pinned SHAs, zero network. An
  * explicit historical `ref` instead reads the GitHub `plugins/marketplace.json`
  * at that revision (a git lookup, matching pin history / inspect). GitHub is
@@ -15,7 +15,7 @@
  *   - directory listings (`/contents/<path>` → entry array or 404),
  *   - raw file downloads (a listing entry's `download_url`).
  *
- * A separate suite drives the platform-enabled path with a failing catalog
+ * A separate suite drives the cloud-enabled path with a failing catalog
  * fetch to prove the detail view degrades (local + repo fallback) on an outage.
  */
 
@@ -143,8 +143,8 @@ function sha16(buf: Buffer): string {
 }
 
 const ORIGINAL_ENV = {
-  IS_PLATFORM: process.env.IS_PLATFORM,
-  CADET_DISABLE_PLATFORM: process.env.CADET_DISABLE_PLATFORM,
+  IS_CLOUD: process.env.IS_CLOUD,
+  CADET_DISABLE_CLOUD: process.env.CADET_DISABLE_CLOUD,
 };
 
 function restoreEnv(): void {
@@ -163,8 +163,8 @@ describe("getPluginDetails (bundled catalog, offline)", () => {
   beforeEach(() => {
     workspace = mkdtempSync(join(tmpdir(), "plugin-details-"));
     invalidatePluginCatalogCache();
-    process.env.CADET_DISABLE_PLATFORM = "true";
-    delete process.env.IS_PLATFORM;
+    process.env.CADET_DISABLE_CLOUD = "true";
+    delete process.env.IS_CLOUD;
   });
 
   afterEach(() => {
@@ -729,7 +729,7 @@ describe("getPluginDetails (bundled catalog, offline)", () => {
 });
 
 describe("getPluginDetails (catalog unavailable, platform enabled)", () => {
-  // A fetch that always rejects — the platform catalog fetch fails, and no
+  // A fetch that always rejects — the cloud catalog fetch fails, and no
   // GitHub enrichment should be attempted for the degraded cases below.
   const failingFetch = (async () => {
     throw new Error("network down");
@@ -738,8 +738,8 @@ describe("getPluginDetails (catalog unavailable, platform enabled)", () => {
   beforeEach(() => {
     workspace = mkdtempSync(join(tmpdir(), "plugin-details-"));
     invalidatePluginCatalogCache();
-    delete process.env.IS_PLATFORM;
-    delete process.env.CADET_DISABLE_PLATFORM;
+    delete process.env.IS_CLOUD;
+    delete process.env.CADET_DISABLE_CLOUD;
   });
 
   afterEach(() => {
@@ -801,7 +801,7 @@ describe("getPluginDetails (catalog unavailable, platform enabled)", () => {
   }
 
   test("404s a not-installed plugin whose only catalog row has a malformed source", async () => {
-    // GIVEN a platform catalog row pinned to a mutable ref (not a full SHA) —
+    // GIVEN a cloud catalog row pinned to a mutable ref (not a full SHA) —
     // platform rows are not source-validated, so this reaches the detail view;
     // install-by-name would refuse it
     const fetch = platformCatalogFetch({

package/src/cli/lib/__tests__/plugins-install-offline.test.ts

@@ -1,12 +1,12 @@
 /**
  * Install-by-name in disable-platform (air-gapped / self-hosted) mode.
  *
- * With `CADET_DISABLE_PLATFORM=true` there is no platform to serve a verified
+ * With `CADET_DISABLE_CLOUD=true` there is no platform to serve a verified
  * tarball, so `assistant plugins install <name>` resolves the pin from the
  * bundled marketplace catalog and installs through the trusted GitHub path
  * (`trustedSource`, which preserves the curated adapter stub) — with zero
  * platform calls. A name absent from the bundled catalog fails clearly. With
- * platform features enabled, the platform install endpoint is used unchanged.
+ * platform features enabled, the cloud install endpoint is used unchanged.
  */
 
 import {
@@ -28,7 +28,7 @@ const installPluginCalls: InstallPluginOptions[] = [];
 const platformInstallCalls: Array<{ name: string; force?: boolean }> = [];
 
 const realGithub = await import("../install-from-github.js");
-const realPlatform = await import("../install-from-platform.js");
+const realPlatform = await import("../install-from-cloud.js");
 const realCatalogCache = await import("../plugin-catalog-cache.js");
 let platformCatalogSource: PluginMatchSource = {
   kind: "github",
@@ -51,7 +51,7 @@ mock.module("../install-from-github.js", () => ({
   },
 }));
 
-mock.module("../install-from-platform.js", () => ({
+mock.module("../install-from-cloud.js", () => ({
   ...realPlatform,
   installPluginViaPlatform: async (opts: { name: string; force?: boolean }) => {
     platformInstallCalls.push(opts);
@@ -104,8 +104,8 @@ async function runInstall(name: string): Promise<void> {
 }
 
 describe("plugins install by name — disable-platform mode", () => {
-  const savedDisable = process.env.CADET_DISABLE_PLATFORM;
-  const savedIsPlatform = process.env.IS_PLATFORM;
+  const savedDisable = process.env.CADET_DISABLE_CLOUD;
+  const savedIsPlatform = process.env.IS_CLOUD;
   const savedExitCode = process.exitCode;
 
   beforeEach(() => {
@@ -123,22 +123,22 @@ describe("plugins install by name — disable-platform mode", () => {
 
   afterEach(() => {
     if (savedDisable === undefined) {
-      delete process.env.CADET_DISABLE_PLATFORM;
+      delete process.env.CADET_DISABLE_CLOUD;
     } else {
-      process.env.CADET_DISABLE_PLATFORM = savedDisable;
+      process.env.CADET_DISABLE_CLOUD = savedDisable;
     }
     if (savedIsPlatform === undefined) {
-      delete process.env.IS_PLATFORM;
+      delete process.env.IS_CLOUD;
     } else {
-      process.env.IS_PLATFORM = savedIsPlatform;
+      process.env.IS_CLOUD = savedIsPlatform;
     }
     process.exitCode = savedExitCode;
     mock.restore();
   });
 
   test("installs a bundled plugin via the trusted GitHub path with no platform call", async () => {
-    process.env.CADET_DISABLE_PLATFORM = "true";
-    delete process.env.IS_PLATFORM;
+    process.env.CADET_DISABLE_CLOUD = "true";
+    delete process.env.IS_CLOUD;
 
     await runInstall(BUNDLED_PLUGIN);
 
@@ -159,8 +159,8 @@ describe("plugins install by name — disable-platform mode", () => {
   });
 
   test("errors clearly for a name absent from the bundled catalog", async () => {
-    process.env.CADET_DISABLE_PLATFORM = "true";
-    delete process.env.IS_PLATFORM;
+    process.env.CADET_DISABLE_CLOUD = "true";
+    delete process.env.IS_CLOUD;
     const errSpy = spyOn(console, "error").mockImplementation(() => {});
 
     await runInstall("definitely-not-a-real-plugin");
@@ -173,8 +173,8 @@ describe("plugins install by name — disable-platform mode", () => {
   });
 
   test("does not install a feature-gated bundled integration", async () => {
-    process.env.CADET_DISABLE_PLATFORM = "true";
-    delete process.env.IS_PLATFORM;
+    process.env.CADET_DISABLE_CLOUD = "true";
+    delete process.env.IS_CLOUD;
 
     await runInstall("gamma");
 
@@ -183,9 +183,9 @@ describe("plugins install by name — disable-platform mode", () => {
     expect(process.exitCode).toBe(1);
   });
 
-  test("uses the platform install endpoint when platform features are enabled", async () => {
-    delete process.env.CADET_DISABLE_PLATFORM;
-    delete process.env.IS_PLATFORM;
+  test("uses the cloud install endpoint when platform features are enabled", async () => {
+    delete process.env.CADET_DISABLE_CLOUD;
+    delete process.env.IS_CLOUD;
 
     await runInstall(BUNDLED_PLUGIN);
 
@@ -196,8 +196,8 @@ describe("plugins install by name — disable-platform mode", () => {
   });
 
   test("does not install a name absent from a successful platform catalog", async () => {
-    delete process.env.CADET_DISABLE_PLATFORM;
-    delete process.env.IS_PLATFORM;
+    delete process.env.CADET_DISABLE_CLOUD;
+    delete process.env.IS_CLOUD;
     const errSpy = spyOn(console, "error").mockImplementation(() => {});
 
     await runInstall("gamma");
@@ -210,9 +210,9 @@ describe("plugins install by name — disable-platform mode", () => {
     );
   });
 
-  test("installs a platform-visible local package without the platform tar endpoint", async () => {
-    delete process.env.CADET_DISABLE_PLATFORM;
-    delete process.env.IS_PLATFORM;
+  test("installs a cloud-visible local package without the cloud tar endpoint", async () => {
+    delete process.env.CADET_DISABLE_CLOUD;
+    delete process.env.IS_CLOUD;
     platformCatalogSource = {
       kind: "local",
       path: "plugins/mcp-catalog/fathom",

package/src/cli/lib/bundled-marketplace.json

@@ -611,7 +611,7 @@
         "repo": "vargasjr-dev/cadet-client-qa",
         "ref": "4f559d865eaa04b68285f8e4fae4a05fc18fe88f"
       },
-      "description": "Cross-platform QA rig for mycadet clients: mock the platform backend, boot the real chat UI, and verify feature branches in headless Chromium (web), an iOS simulator, or Electron with screenshot and video proof.",
+      "description": "Cross-platform QA rig for mycadet clients: mock the cloud backend, boot the real chat UI, and verify feature branches in headless Chromium (web), an iOS simulator, or Electron with screenshot and video proof.",
       "category": "developer",
       "homepage": "https://github.com/vargasjr-dev/cadet-client-qa",
       "license": "MIT",

package/src/cli/lib/inspect-plugin.ts

@@ -30,7 +30,7 @@ import {
   readInstalledPlugin,
 } from "./list-installed-plugins.js";
 import {
-  arePlatformFeaturesEnabled,
+  areCloudFeaturesEnabled,
   readBundledLocalPluginCatalog,
 } from "./plugin-catalog-local.js";
 import { isPluginCatalogEntryVisible } from "./plugin-catalog-visibility.js";
@@ -348,7 +348,7 @@ export async function inspectPlugin(
   let remoteError: string | null = null;
   const installedLocalSource = local?.source?.kind === "local";
   const useBundledLocalCatalog =
-    installedLocalSource || (!installed && !arePlatformFeaturesEnabled());
+    installedLocalSource || (!installed && !areCloudFeaturesEnabled());
   try {
     if (useBundledLocalCatalog) {
       const catalog = deps.localCatalog ?? readBundledLocalPluginCatalog();

package/src/cli/lib/{install-from-platform.ts → install-from-cloud.ts}

@@ -1,7 +1,7 @@
 /**
- * Install a plugin by name from the platform's public install endpoint.
+ * Install a plugin by name from the cloud's public install endpoint.
  *
- * Plugin installs are platform-managed and content flows *through* the platform
+ * Plugin installs are cloud-managed and content flows *through* the cloud
  * (npm-style): the endpoint assembles a `.tgz` of the plugin's files from the
  * pinned commit, server-side, and serves it as `application/gzip`. The daemon
  * downloads that tarball, verifies its integrity against the `ETag` sha256,
@@ -21,7 +21,7 @@
  * {@link ./install-from-github}). The CLI command `assistant plugins install
  * <name>` calls {@link installPluginViaPlatform}, which resolves production
  * deps (platform base URL, optional API key, attribution) and delegates to
- * {@link installPluginFromPlatform}.
+ * {@link installPluginFromCloud}.
  */
 
 import { createHash } from "node:crypto";
@@ -33,7 +33,7 @@ import {
   MALFORMED_USTAR_SIZE,
   parseUstarSizeField,
 } from "../../archive/ustar-size.js";
-import { getPlatformBaseUrl } from "../../config/env.js";
+import { getCloudBaseUrl } from "../../config/env.js";
 import { getExistingDeviceId } from "../../util/device-id.js";
 import { getWorkspacePluginsDir } from "../../util/platform.js";
 import { getPluginManifestInstallAction } from "../../util/plugin-manifest.js";
@@ -87,11 +87,11 @@ export class PluginArchiveError extends Error {
   }
 }
 
-/** The plugin exceeds the platform's install size cap (HTTP 413). */
+/** The plugin exceeds the cloud's install size cap (HTTP 413). */
 export class PluginTooLargeError extends Error {
   constructor(readonly pluginName: string) {
     super(
-      `Plugin "${pluginName}" is too large to install (the platform enforces a size cap).`,
+      `Plugin "${pluginName}" is too large to install (the cloud enforces a size cap).`,
     );
     this.name = "PluginTooLargeError";
   }
@@ -108,7 +108,7 @@ export class PluginRateLimitedError extends Error {
 }
 
 /** Options controlling which plugin to install and how. */
-export interface InstallFromPlatformOptions {
+export interface InstallFromCloudOptions {
   readonly name: string;
   /** Overwrite an existing install in place. Preserved on disk until download+verify succeed. */
   readonly force?: boolean;
@@ -121,11 +121,11 @@ export interface InstallFromPlatformOptions {
 }
 
 /** Dependencies injected by the caller. */
-export interface InstallFromPlatformDeps {
+export interface InstallFromCloudDeps {
   /** HTTP client. Production callers pass `globalThis.fetch.bind(globalThis)`. */
   readonly fetch: FetchLike;
   /** Platform base URL (no trailing slash required). */
-  readonly platformBaseUrl: string;
+  readonly cloudBaseUrl: string;
   /** Assistant API key. When present the install is attributed to the real user/org. */
   readonly apiKey?: string;
   /** Override the workspace plugins directory. Falls back to {@link getWorkspacePluginsDir}. */
@@ -160,16 +160,16 @@ const defaultSleep = (ms: number): Promise<void> =>
   new Promise((r) => setTimeout(r, ms));
 
 /**
- * Download, verify, and extract a plugin from the platform install endpoint.
+ * Download, verify, and extract a plugin from the cloud install endpoint.
  *
  * Staging mirrors {@link installPlugin}: the tree is extracted into a sibling
  * staging dir and only swapped into `<pluginsDir>/<name>` once the download,
  * integrity check, and extraction all succeed — so a transient failure leaves
  * a previously installed copy untouched even under `force`.
  */
-export async function installPluginFromPlatform(
-  opts: InstallFromPlatformOptions,
-  deps: InstallFromPlatformDeps,
+export async function installPluginFromCloud(
+  opts: InstallFromCloudOptions,
+  deps: InstallFromCloudDeps,
 ): Promise<InstallPluginResult> {
   const name = sanitizePluginName(opts.name);
   const force = opts.force ?? false;
@@ -240,10 +240,10 @@ export async function installPluginFromPlatform(
 }
 
 /**
- * Resolve production deps and install `name` from the platform endpoint.
+ * Resolve production deps and install `name` from the cloud endpoint.
  *
  * The CLI command `assistant plugins install <name>` calls this. It resolves
- * the platform base URL the daemon already uses, sends the assistant API key
+ * the cloud base URL the daemon already uses, sends the assistant API key
  * when one is configured (attributing the install to the real user/org, else
  * anonymous), and forwards best-effort attribution (`installation_id`,
  * `assistant_version`).
@@ -252,11 +252,11 @@ export async function installPluginViaPlatform(
   opts: { name: string; force?: boolean; conversationId?: string },
   deps: { fetch: FetchLike; confirmStaged?: ConfirmStagedInstall },
 ): Promise<InstallPluginResult> {
-  const platformBaseUrl = getPlatformBaseUrl();
+  const cloudBaseUrl = getCloudBaseUrl();
   const apiKey = await resolveAssistantApiKey();
   const installationId = getExistingDeviceId() ?? undefined;
 
-  return installPluginFromPlatform(
+  return installPluginFromCloud(
     {
       name: opts.name,
       force: opts.force,
@@ -266,7 +266,7 @@ export async function installPluginViaPlatform(
     },
     {
       fetch: deps.fetch,
-      platformBaseUrl,
+      cloudBaseUrl,
       ...(apiKey ? { apiKey } : {}),
       ...(deps.confirmStaged ? { confirmStaged: deps.confirmStaged } : {}),
     },
@@ -276,12 +276,12 @@ export async function installPluginViaPlatform(
 /**
  * Best-effort resolution of the assistant API key through the authorized
  * platform client (the same credential path `plugins publish` uses); the
- * install proceeds anonymously when the daemon isn't connected to the platform.
+ * install proceeds anonymously when the daemon isn't connected to the cloud.
  */
 async function resolveAssistantApiKey(): Promise<string | undefined> {
   try {
-    const { CadetPlatformClient } = await import("../../platform/client.js");
-    const client = await CadetPlatformClient.create();
+    const { CadetCloudClient } = await import("../../cloud/client.js");
+    const client = await CadetCloudClient.create();
     return client?.assistantApiKey || undefined;
   } catch {
     return undefined;
@@ -294,12 +294,12 @@ async function resolveAssistantApiKey(): Promise<string | undefined> {
  */
 async function downloadInstallArchive(
   name: string,
-  opts: InstallFromPlatformOptions,
-  deps: InstallFromPlatformDeps,
+  opts: InstallFromCloudOptions,
+  deps: InstallFromCloudDeps,
 ): Promise<{ body: Buffer; meta: InstallResponseMeta }> {
-  const url = buildInstallUrl(deps.platformBaseUrl, name, opts);
+  const url = buildInstallUrl(deps.cloudBaseUrl, name, opts);
   const headers: Record<string, string> = {
-    // The platform (Django) 406s a specific `application/gzip` Accept, so ask
+    // The cloud (Django) 406s a specific `application/gzip` Accept, so ask
     // for anything and sniff the body ourselves (see extractPluginTarball).
     Accept: "*/*",
     "User-Agent": USER_AGENT,
@@ -375,11 +375,11 @@ function retryDelayMs(res: Response, attempt: number): number {
 
 /** Build the install URL, appending optional attribution query params. */
 function buildInstallUrl(
-  platformBaseUrl: string,
+  cloudBaseUrl: string,
   name: string,
-  opts: InstallFromPlatformOptions,
+  opts: InstallFromCloudOptions,
 ): string {
-  const base = platformBaseUrl.replace(/\/+$/, "");
+  const base = cloudBaseUrl.replace(/\/+$/, "");
   const url = new URL(
     `${base}/v1/plugins/${encodeURIComponent(name)}/install/`,
   );
@@ -463,7 +463,7 @@ function isGzip(buf: Buffer): boolean {
 /**
  * Extract a plugin archive into `destDir`, returning the number of regular
  * files written. The archive is gunzipped when it carries the gzip magic bytes
- * and treated as a plain (uncompressed) POSIX tar otherwise — the platform
+ * and treated as a plain (uncompressed) POSIX tar otherwise — the cloud
  * advertises `application/gzip` but may serve either, so the body is sniffed
  * rather than trusted by content-type. Entries are already plugin-root-relative
  * (the endpoint re-roots the tarball), so they are extracted as-is — but archive

package/src/cli/lib/install-from-github.ts

@@ -592,7 +592,7 @@ export async function installPlugin(
  * install is left behind; a decline then surfaces as
  * {@link PluginInstallDeclinedError}. A no-op when no gate was supplied.
  *
- * Shared by {@link installPlugin} and the platform-endpoint install so both
+ * Shared by {@link installPlugin} and the cloud-endpoint install so both
  * abort a declined install the same way.
  */
 export async function confirmStagedOrAbort(
@@ -649,7 +649,7 @@ export interface FinalizeStagedInstallParams {
  * `<pluginsDir>/<name>`. Returns the final install path and the fingerprint that
  * was recorded.
  *
- * Shared by {@link installPlugin} (fresh materialization), the platform-endpoint
+ * Shared by {@link installPlugin} (fresh materialization), the cloud-endpoint
  * install, and the merge-based `plugins upgrade --strategy` path so all record
  * identical provenance, install dependencies the same way, and use the same
  * atomic rm+rename swap. Dependencies land in `<stagingDir>/node_modules/` — a
@@ -821,7 +821,7 @@ export interface InstallMeta {
   readonly commit: string | null;
   /**
    * Integrity digest of the downloaded artifact, when the install came through
-   * the platform install endpoint (`ETag: "sha256:<hex>"`). Recorded verbatim
+   * the cloud install endpoint (`ETag: "sha256:<hex>"`). Recorded verbatim
    * (including the `sha256:` prefix) as a stable id for caching / dedupe and to
    * document what was verified. Absent for git-cloned installs, which have no
    * single artifact to hash.
@@ -1179,7 +1179,7 @@ function normalizeInstalledManifest(
  * (`buildPluginFromDir`) hard-requires a `package.json` validated against
  * `PluginPackageJsonSchema` and silently skips the plugin when it's missing.
  *
- * Used by both the GitHub clone path and the platform tarball path. The
+ * Used by both the GitHub clone path and the cloud tarball path. The
  * synthesized manifest carries the install name and the default
  * `@mycadet/plugin-api` peer dependency range. No foreign-ecosystem
  * manifest data is read: the install name is the only identity we trust

package/src/cli/lib/plugin-catalog-cache.ts

@@ -4,16 +4,16 @@
  * Platform-first: when platform features are enabled the catalog is fetched
  * from Cadet Cloud and any fetch failure propagates (fail hard — no
  * stale-cache smoothing). Successful loads are held per git ref for a short
- * TTL. When `CADET_DISABLE_PLATFORM` disables platform features the bundled
+ * TTL. When `CADET_DISABLE_CLOUD` disables platform features the bundled
  * offline manifest is read instead, with zero network calls.
  */
 
-import { arePlatformFeaturesEnabled } from "../../platform/feature-gate.js";
+import { areCloudFeaturesEnabled } from "../../cloud/feature-gate.js";
+import { fetchPluginCatalogFromPlatform } from "./plugin-catalog-cloud.js";
 import {
   readBundledLocalPluginCatalog,
   readBundledPluginCatalog,
 } from "./plugin-catalog-local.js";
-import { fetchPluginCatalogFromPlatform } from "./plugin-catalog-platform.js";
 import { filterPluginCatalogByFeatureFlags } from "./plugin-catalog-visibility.js";
 import type { PluginCatalog, SearchPluginsDeps } from "./search-plugins.js";
 
@@ -30,9 +30,9 @@ type PluginCatalogLoadDeps = Pick<SearchPluginsDeps, "fetch">;
 const cache = new Map<string, CacheEntry>();
 
 /**
- * Add bundled local packages without overriding platform-authoritative rows.
+ * Add bundled local packages without overriding cloud-authoritative rows.
  * A platform row without an integration borrows the bundled row's
- * integration of the same name, so an integration the platform omits or
+ * integration of the same name, so an integration the cloud omits or
  * serves malformed never disappears from the catalog.
  */
 export function mergePlatformCatalogWithBundledLocals(
@@ -64,7 +64,7 @@ export function mergePlatformCatalogWithBundledLocals(
  *
  * With platform features disabled the bundled manifest is returned directly —
  * an in-memory constant, no network and no TTL. Otherwise the catalog is
- * fetched from the platform and, on success, cached per ref for the TTL; a
+ * fetched from the cloud and, on success, cached per ref for the TTL; a
  * fetch failure propagates so the caller can surface it (e.g. map a rate-limit
  * to 503) — no stale catalog is ever served.
  */
@@ -72,7 +72,7 @@ async function loadPluginCatalog(
   ref: string,
   deps: PluginCatalogLoadDeps,
 ): Promise<PluginCatalog> {
-  if (!arePlatformFeaturesEnabled()) {
+  if (!areCloudFeaturesEnabled()) {
     return { ...readBundledPluginCatalog(), ref };
   }
 

package/src/cli/lib/{plugin-catalog-platform.ts → plugin-catalog-cloud.ts}

@@ -1,10 +1,10 @@
 /**
  * Fetch the installable plugin catalog from Cadet Cloud.
  *
- * The platform serves a flattened view of the curated marketplace at
+ * The cloud serves a flattened view of the curated marketplace at
  * `GET {PLATFORM}/v1/plugins/`. Rows are normalized to {@link MarketplaceEntry}
  * and projected via the shared {@link projectMarketplaceEntries} helper, so a
- * catalog sourced from the platform is indistinguishable from one read off
+ * catalog sourced from the cloud is indistinguishable from one read off
  * GitHub.
  *
  * Every failure mode (non-2xx, unreachable/aborted, malformed envelope)
@@ -16,7 +16,7 @@
 
 import { z } from "zod";
 
-import { getPlatformBaseUrl } from "../../config/env.js";
+import { getCloudBaseUrl } from "../../config/env.js";
 import { getLogger } from "../../util/logger.js";
 import {
   type MarketplaceEntry,
@@ -33,7 +33,7 @@ import { USER_AGENT } from "./user-agent.js";
 const log = getLogger("plugin-catalog");
 
 /**
- * One flattened row from the platform catalog. Unknown keys (`id`,
+ * One flattened row from the cloud catalog. Unknown keys (`id`,
  * `display_name`) are accepted and dropped (zod strips them by default).
  * `integration` is validated separately by {@link integrationSchema}.
  */
@@ -57,14 +57,14 @@ const platformCatalogSchema = z.object({
 });
 
 /**
- * Fetch and project the platform catalog. Rows missing `repo`/`ref` are
+ * Fetch and project the cloud catalog. Rows missing `repo`/`ref` are
  * skipped; the rest are deduped by name and sorted alphabetically.
  */
 export async function fetchPluginCatalogFromPlatform(
   deps: SearchPluginsDeps,
   opts?: { ref?: string },
 ): Promise<PluginCatalog> {
-  const url = `${getPlatformBaseUrl().replace(/\/+$/, "")}/v1/plugins/`;
+  const url = `${getCloudBaseUrl().replace(/\/+$/, "")}/v1/plugins/`;
 
   let res: Response;
   try {

package/src/cli/lib/plugin-catalog-local.ts

@@ -6,7 +6,7 @@
  * treatment as the feature-flag registry.
  *
  * `getPluginCatalog` selects this reader only when platform features are
- * disabled (air-gapped / self-hosted, `CADET_DISABLE_PLATFORM=true`). Importing
+ * disabled (air-gapped / self-hosted, `CADET_DISABLE_CLOUD=true`). Importing
  * the JSON directly (resolveJsonModule) inlines it into the bundle, so there is
  * no filesystem path resolution and the manifest is always present at runtime —
  * it works identically in dev, Docker, and an npm-packed macOS install.
@@ -30,7 +30,7 @@ import {
 
 // Re-exported so `local`-tagged CLI commands can gate on platform features
 // without importing `platform/` directly (cli/no-daemon-internals allows lib).
-export { arePlatformFeaturesEnabled } from "../../platform/feature-gate.js";
+export { areCloudFeaturesEnabled } from "../../cloud/feature-gate.js";
 export { isPluginCatalogEntryVisible };
 
 let memoizedEntries: readonly MarketplaceEntry[] | undefined;

package/src/cli/lib/publish-plugin.ts

@@ -1,10 +1,10 @@
 /**
  * `assistant plugins publish` — validate a local plugin, resolve its git
- * context, and submit it to the Cadet marketplace catalog via the platform
+ * context, and submit it to the Cadet marketplace catalog via the cloud
  * API.
  *
  * The flow mirrors `npm publish`: validate the package locally, resolve the
- * version (commit SHA), and POST to a registry endpoint. The platform then
+ * version (commit SHA), and POST to a registry endpoint. The cloud then
  * creates a pull request against `vargasjr-dev/mycadet` using the
  * Cadet Automation GitHub App.
  *
@@ -75,7 +75,7 @@ export interface PublishResult {
 
 export interface PublishDeps {
   fetch: typeof globalThis.fetch;
-  platformBaseUrl: string;
+  cloudBaseUrl: string;
   apiKey: string;
 }
 
@@ -324,7 +324,7 @@ export async function postPublishRequest(
   deps: PublishDeps,
 ): Promise<PublishResult> {
   const resp = await deps.fetch(
-    `${deps.platformBaseUrl.replace(/\/+$/, "")}/v1/plugins/publish/`,
+    `${deps.cloudBaseUrl.replace(/\/+$/, "")}/v1/plugins/publish/`,
     {
       method: "POST",
       headers: {
@@ -343,12 +343,12 @@ export async function postPublishRequest(
  *
  * Returns `null` when not connected to Cadet Cloud (no API key
  * or base URL configured). The CLI command uses this to avoid hoisting
- * `CadetPlatformClient` into its static import graph; resolving it lazily
+ * `CadetCloudClient` into its static import graph; resolving it lazily
  * keeps that daemon code out of the CLI process until the command needs it.
  */
 export async function resolvePlatformDeps(): Promise<PublishDeps | null> {
-  const { CadetPlatformClient } = await import("../../platform/client.js");
-  const client = await CadetPlatformClient.create();
+  const { CadetCloudClient } = await import("../../cloud/client.js");
+  const client = await CadetCloudClient.create();
   if (!client) {
     return null;
   }
@@ -357,8 +357,7 @@ export async function resolvePlatformDeps(): Promise<PublishDeps | null> {
   // privately, so we use its fetch method directly.
   return {
     fetch: globalThis.fetch.bind(globalThis),
-    platformBaseUrl: (client as unknown as { platformBaseUrl: string })
-      .platformBaseUrl,
+    cloudBaseUrl: (client as unknown as { cloudBaseUrl: string }).cloudBaseUrl,
     apiKey: (client as unknown as { apiKey: string }).apiKey,
   };
 }
@@ -581,7 +580,7 @@ export async function runPublish(
     }
   }
 
-  // 7. Submit to the platform API
+  // 7. Submit to the cloud API
   const platformDeps = await resolvePlatformDeps();
   if (!platformDeps) {
     const msg =

package/src/cli/lib/search-plugins.ts

@@ -70,7 +70,7 @@ export interface PluginSearchMatch {
   readonly description?: string;
   /**
    * Plugin icon: a curated emoji from the marketplace entry, or an icon URL
-   * served by the platform catalog when the plugin ships a bundled image.
+   * served by the cloud catalog when the plugin ships a bundled image.
    */
   readonly icon?: string;
   /**
@@ -149,7 +149,7 @@ export interface PluginCatalog {
  * Project a marketplace entry onto the catalog match shape, building a
  * a source-specific locator for display.
  *
- * Shared by the platform fetcher and bundled reader so all catalog sources
+ * Shared by the cloud fetcher and bundled reader so all catalog sources
  * project entries identically.
  */
 export function marketplaceMatch(entry: MarketplaceEntry): PluginSearchMatch {