@cmssy/cli 14.0.0 → 14.2.0

package/assets/init/astro/src/cmssy/layout-slot.tsx

@@ -2,6 +2,7 @@ import {
   CmssyBlock,
   buildBlockContext,
   buildBlockMap,
+  type CmssyBlockPage,
   type CmssyLayoutGroup,
 } from "@cmssy/react";
 import { CmssyLazyLayout } from "@cmssy/react/client";
@@ -12,6 +13,7 @@ import { blocks } from "./blocks";
 export interface LayoutSlotProps {
   groups: CmssyLayoutGroup[];
   position: CmssyRegion<typeof layout>;
+  page: CmssyBlockPage;
   locale: string;
   defaultLocale: string;
   enabledLocales: string[];
@@ -23,6 +25,7 @@ export interface LayoutSlotProps {
 export default function LayoutSlot({
   groups,
   position,
+  page,
   locale,
   defaultLocale,
   enabledLocales,
@@ -35,6 +38,7 @@ export default function LayoutSlot({
       <CmssyLazyLayout
         groups={groups}
         position={position}
+        page={page}
         locale={locale}
         defaultLocale={defaultLocale}
         enabledLocales={enabledLocales}
@@ -50,7 +54,14 @@ export default function LayoutSlot({
   if (!group) return null;
 
   const blockMap = buildBlockMap(blocks);
-  const context = buildBlockContext(locale, defaultLocale, enabledLocales);
+  const context = buildBlockContext(
+    locale,
+    defaultLocale,
+    enabledLocales,
+    false,
+    undefined,
+    { page },
+  );
 
   return (
     <>

package/assets/init/astro/src/pages/[...path].astro

@@ -11,7 +11,7 @@ import LayoutSlot from "../cmssy/layout-slot";
 
 export const prerender = false;
 
-const { page, layouts, locale, defaultLocale, enabledLocales } = await loadCmssyPage(
+const { page, layouts, pageContext, locale, defaultLocale, enabledLocales } = await loadCmssyPage(
   cmssy,
   Astro.request,
   Astro.url,
@@ -33,6 +33,7 @@ const { data: blockData, content: blockContent } = await resolveEditorBlockData(
 
 const layoutSlot = {
   groups: layouts,
+  page: pageContext,
   blocks,
   locale,
   defaultLocale,
@@ -54,6 +55,7 @@ const [header, footer] = await Promise.all([
     <LayoutSlot
       groups={layouts}
       position="header"
+      page={pageContext}
       locale={locale}
       defaultLocale={defaultLocale}
       enabledLocales={enabledLocales}
@@ -77,6 +79,7 @@ const [header, footer] = await Promise.all([
     <LayoutSlot
       groups={layouts}
       position="footer"
+      page={pageContext}
       locale={locale}
       defaultLocale={defaultLocale}
       enabledLocales={enabledLocales}

package/assets/init/astro/src/pages/cmssy-edit/[...path].astro

@@ -10,6 +10,7 @@ export const prerender = false;
 const {
   page,
   layouts,
+  pageContext,
   locale,
   defaultLocale,
   enabledLocales,
@@ -29,6 +30,7 @@ const editorOrigin = resolveEditorOrigin(cmssy.editorOrigin);
       client:load
       groups={layouts}
       position="header"
+      page={pageContext}
       locale={locale}
       defaultLocale={defaultLocale}
       enabledLocales={enabledLocales}
@@ -48,6 +50,7 @@ const editorOrigin = resolveEditorOrigin(cmssy.editorOrigin);
       client:load
       groups={layouts}
       position="footer"
+      page={pageContext}
       locale={locale}
       defaultLocale={defaultLocale}
       enabledLocales={enabledLocales}

package/assets/init/remix/app/cmssy/layout-slot.tsx

@@ -2,6 +2,7 @@ import {
   CmssyBlock,
   buildBlockContext,
   buildBlockMap,
+  type CmssyBlockPage,
   type CmssyLayoutGroup,
 } from "@cmssy/react";
 import { CmssyLazyLayout } from "@cmssy/react/client";
@@ -12,6 +13,7 @@ import { blocks } from "./blocks";
 export interface LayoutSlotProps {
   groups: CmssyLayoutGroup[];
   position: CmssyRegion<typeof layout>;
+  page: CmssyBlockPage;
   locale: string;
   defaultLocale: string;
   enabledLocales: string[];
@@ -23,6 +25,7 @@ export interface LayoutSlotProps {
 export function LayoutSlot({
   groups,
   position,
+  page,
   locale,
   defaultLocale,
   enabledLocales,
@@ -35,6 +38,7 @@ export function LayoutSlot({
       <CmssyLazyLayout
         groups={groups}
         position={position}
+        page={page}
         locale={locale}
         defaultLocale={defaultLocale}
         enabledLocales={enabledLocales}
@@ -50,7 +54,14 @@ export function LayoutSlot({
   if (!group) return null;
 
   const blockMap = buildBlockMap(blocks);
-  const context = buildBlockContext(locale, defaultLocale, enabledLocales);
+  const context = buildBlockContext(
+    locale,
+    defaultLocale,
+    enabledLocales,
+    false,
+    undefined,
+    { page },
+  );
 
   return (
     <>

package/assets/init/remix/app/routes/page.tsx

@@ -45,6 +45,7 @@ export async function loader(args: Route.LoaderArgs) {
 
   const slotOptions = {
     groups: data.layouts,
+    page: data.pageContext,
     blocks,
     locale: data.locale,
     defaultLocale: data.defaultLocale,
@@ -72,6 +73,7 @@ export default function CmssyPage({ loaderData }: Route.ComponentProps) {
   const {
     page,
     layouts,
+    pageContext,
     locale,
     defaultLocale,
     enabledLocales,
@@ -92,6 +94,7 @@ export default function CmssyPage({ loaderData }: Route.ComponentProps) {
     <LayoutSlot
       groups={layouts}
       position={position}
+      page={pageContext}
       locale={locale}
       defaultLocale={defaultLocale}
       enabledLocales={enabledLocales}

package/dist/index.js

@@ -13,6 +13,10 @@ var BAD_TOKEN_HINT = {
   message: "the cmssy API rejected the token",
   fix: "create an API token in the cmssy dashboard (Settings \u2192 API Tokens) and pass it via --token or CMSSY_API_TOKEN"
 };
+var NEEDS_MANIFEST_WRITE_HINT = {
+  message: "the token's user cannot write this workspace's block manifest",
+  fix: "the token's user needs the PAGES_EDIT permission in the selected workspace"
+};
 var NEEDS_PAGES_EDIT_HINT = {
   message: "the token's user cannot read this workspace's settings",
   fix: "the token's user needs the PAGES_EDIT permission in the selected workspace"
@@ -68,8 +72,11 @@ async function adminGraphql(query, variables, options) {
       `the cmssy API rejected the request - ${errors.map((error) => error.message ?? "GraphQL error").join("; ")}`
     );
   }
-  if (!response.ok || envelope?.data === void 0) {
-    throw new CliError(`the cmssy API responded with HTTP ${response.status}`);
+  if (!response.ok || envelope?.data == null) {
+    throw new CliError(
+      `the cmssy API returned no data (HTTP ${response.status})`,
+      "check that CMSSY_API_URL points at the cmssy admin API (https://api.cmssy.io/graphql), not the delivery endpoint"
+    );
   }
   return envelope.data;
 }
@@ -95,6 +102,14 @@ var UPDATE_PREVIEW_URL_MUTATION = `mutation CliSetPreviewUrl($input: UpdateSiteC
     }
   }
 }`;
+var SAVE_BLOCK_MANIFEST_MUTATION = `mutation CliSaveBlockManifest($blocks: JSON!, $regions: JSON) {
+  blockManifest {
+    save(blocks: $blocks, regions: $regions) {
+      hash
+      updatedAt
+    }
+  }
+}`;
 async function fetchMyWorkspaces(options) {
   const data = await adminGraphql(WORKSPACES_MINE_QUERY, {}, options);
   return data.workspace.mine;
@@ -114,6 +129,31 @@ async function setPreviewUrl(previewUrl, options) {
     { ...options, denied: NEEDS_PAGES_EDIT_HINT }
   );
 }
+var BLOCK_MANIFEST_HASH_QUERY = `query CliBlockManifestHash {
+  blockManifest {
+    get {
+      hash
+    }
+  }
+}`;
+async function fetchBlockManifestHash(options) {
+  const data = await adminGraphql(
+    BLOCK_MANIFEST_HASH_QUERY,
+    {},
+    {
+      ...options,
+      denied: NEEDS_MANIFEST_WRITE_HINT
+    }
+  );
+  return data.blockManifest.get?.hash ?? null;
+}
+async function saveBlockManifest(manifest, options) {
+  const data = await adminGraphql(SAVE_BLOCK_MANIFEST_MUTATION, manifest, {
+    ...options,
+    denied: NEEDS_MANIFEST_WRITE_HINT
+  });
+  return data.blockManifest.save;
+}
 
 // src/format.ts
 var GREEN = "\x1B[32m";
@@ -601,6 +641,25 @@ function runAddBlock(options, deps) {
   }
 }
 
+// src/args.ts
+function flagValue(args, name) {
+  const index = args.findIndex((arg) => arg === name);
+  if (index !== -1) {
+    const value = args[index + 1];
+    if (value === void 0 || value.startsWith("--")) {
+      throw new CliError(
+        `${name} needs a value`,
+        `pass ${name} <value>, or ${name}=<value>`
+      );
+    }
+    return value;
+  }
+  return args.find((arg) => arg.startsWith(`${name}=`))?.slice(name.length + 1);
+}
+function hasFlag(args, name) {
+  return args.includes(name);
+}
+
 // src/init.ts
 import {
   copyFileSync as copyFileSync2,
@@ -1464,8 +1523,345 @@ async function runLink(options, deps) {
   }
 }
 
+// src/sync-manifest.ts
+import { existsSync as existsSync7 } from "fs";
+import { isAbsolute, join as join8 } from "path";
+import {
+  buildBlockManifest
+} from "@cmssy/core";
+
+// src/site-modules.ts
+import { mkdirSync as mkdirSync3, rmSync, writeFileSync as writeFileSync5 } from "fs";
+import { basename, join as join7, resolve as resolve3 } from "path";
+import { pathToFileURL } from "url";
+import { build } from "esbuild";
+var RUNTIME_ONLY_MODULES = ["server-only", "client-only"];
+var ASSET_EXTENSIONS = [
+  ".module.css",
+  ".module.scss",
+  ".module.sass",
+  ".module.less",
+  ".css",
+  ".scss",
+  ".sass",
+  ".less",
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".svg",
+  ".webp",
+  ".avif",
+  ".ico",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".otf",
+  ".mp4",
+  ".webm",
+  ".mp3",
+  ".md",
+  ".mdx"
+];
+var assetLoaders = Object.fromEntries(
+  ASSET_EXTENSIONS.map((extension) => [extension, "empty"])
+);
+var runtimeOnlyModules = {
+  name: "cmssy-runtime-only-modules",
+  setup(api) {
+    const filter = new RegExp(`^(${RUNTIME_ONLY_MODULES.join("|")})$`);
+    api.onResolve({ filter }, (args) => ({
+      path: args.path,
+      namespace: "cmssy-empty"
+    }));
+    api.onLoad({ filter: /.*/, namespace: "cmssy-empty" }, () => ({
+      contents: "export {};",
+      loader: "js"
+    }));
+  }
+};
+async function loadSiteModule(cwd, entry) {
+  const entryPath = resolve3(cwd, entry);
+  let code;
+  try {
+    const result = await build({
+      absWorkingDir: cwd,
+      entryPoints: [entryPath],
+      bundle: true,
+      platform: "node",
+      format: "esm",
+      target: "node20",
+      write: false,
+      packages: "external",
+      jsx: "automatic",
+      loader: assetLoaders,
+      define: { "import.meta.env": "process.env" },
+      plugins: [runtimeOnlyModules],
+      logLevel: "silent"
+    });
+    code = result.outputFiles[0]?.text ?? "";
+  } catch (error) {
+    const messages = error && typeof error === "object" && "errors" in error ? error.errors.map(
+      (issue) => issue.location ? `${issue.location.file}:${issue.location.line} ${issue.text}` : issue.text
+    ) : [error instanceof Error ? error.message : String(error)];
+    throw new CliError(`could not compile ${entry}`, messages.join("\n  "));
+  }
+  const dir = join7(cwd, "node_modules", ".cache", "cmssy");
+  const file = join7(
+    dir,
+    `${basename(entry).replace(/\.[^.]+$/, "")}.${process.pid}.${Date.now()}.mjs`
+  );
+  try {
+    mkdirSync3(dir, { recursive: true });
+    writeFileSync5(file, code);
+  } catch (error) {
+    throw new CliError(
+      `could not write the compiled ${entry} to ${dir}`,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  try {
+    return await import(pathToFileURL(file).href);
+  } catch (error) {
+    throw new CliError(
+      `could not load ${entry}`,
+      error instanceof Error ? error.message : String(error)
+    );
+  } finally {
+    rmSync(file, { force: true });
+  }
+}
+
+// src/sync-manifest.ts
+var BLOCKS_CANDIDATES = [
+  "cmssy/blocks.ts",
+  "cmssy/blocks.tsx",
+  "src/cmssy/blocks.ts",
+  "src/cmssy/blocks.tsx",
+  "app/cmssy/blocks.ts",
+  "app/cmssy/blocks.tsx"
+];
+var CONFIG_CANDIDATES = [
+  "cmssy.config.ts",
+  "cmssy.config.mts",
+  "src/cmssy.config.ts",
+  "src/cmssy.config.mts",
+  "app/cmssy.config.ts"
+];
+var SYNC_MANIFEST_USAGE = [
+  "  cmssy sync-manifest [--blocks <path>] [--config <path>] [--token <cs_...>]",
+  "                      [--org <slug>] [--workspace <slug>] [--dry-run] [--help]"
+];
+function findModule(cwd, requested, candidates, flag) {
+  if (requested?.trim()) {
+    const path = requested.trim();
+    if (!existsSync7(isAbsolute(path) ? path : join8(cwd, path))) {
+      throw new CliError(`${path} does not exist`, `check the ${flag} path`);
+    }
+    return path;
+  }
+  const found = candidates.find(
+    (candidate) => existsSync7(join8(cwd, candidate))
+  );
+  if (!found) {
+    throw new CliError(
+      `no ${candidates[0]} found in ${cwd}`,
+      `looked for ${candidates.join(", ")} - pass ${flag} <path> to name the file`
+    );
+  }
+  return found;
+}
+function isBlockSource(value) {
+  return !!value && typeof value === "object" && typeof value.type === "string" && !!value.props && typeof value.props === "object";
+}
+function readBlocks(module, path) {
+  const exported = module.blocks ?? module.default;
+  if (!Array.isArray(exported)) {
+    throw new CliError(
+      `${path} does not export a \`blocks\` array`,
+      "export const blocks = [heroBlock, ...] - the same list the app renders from"
+    );
+  }
+  const invalid = exported.findIndex((block) => !isBlockSource(block));
+  if (invalid !== -1) {
+    throw new CliError(
+      `${path}: blocks[${invalid}] is not a block definition`,
+      "every entry must come from defineBlock({ type, props, component })"
+    );
+  }
+  const category = typeof module.category === "string" ? module.category : void 0;
+  return { blocks: exported, category };
+}
+function isLayout(value) {
+  return !!value && typeof value === "object" && Array.isArray(value.regions);
+}
+function readConfig(module, path) {
+  const cmssy = module.cmssy;
+  const site = cmssy && typeof cmssy === "object" ? cmssy : null;
+  const layout = isLayout(module.layout) ? module.layout : isLayout(site?.layout) ? site.layout : null;
+  if (!layout && module.layout !== void 0) {
+    throw new CliError(
+      `${path} exports \`layout\`, but it is not a defineCmssyLayout() result`,
+      "export const layout = defineCmssyLayout({ regions: [...] })"
+    );
+  }
+  return {
+    layout,
+    org: typeof site?.org === "string" ? site.org : void 0,
+    workspaceSlug: typeof site?.workspaceSlug === "string" ? site.workspaceSlug : void 0
+  };
+}
+function resolveSlug(flag, fromConfig, fromEnv, variable, flagName) {
+  const value = flag?.trim() || fromConfig?.trim() || fromEnv?.trim();
+  if (!value) {
+    throw new CliError(
+      `no workspace to push to: ${variable} is not set`,
+      `run cmssy link first, or pass ${flagName} <slug>`
+    );
+  }
+  return value;
+}
+function resolveToken2(options, env) {
+  const token = options.token?.trim() || env.CMSSY_API_TOKEN?.trim();
+  if (!token) {
+    throw new CliError(
+      "no API token given",
+      "create an API token in the cmssy dashboard (Settings \u2192 API Tokens) and set CMSSY_API_TOKEN in the deploy environment, or pass --token cs_..."
+    );
+  }
+  return token;
+}
+function matchWorkspace(workspaces, org, slug) {
+  const match = workspaces.find(
+    (workspace) => workspace.slug === slug && (workspace.organizationSlug ?? null) === org
+  );
+  if (!match) {
+    const known = workspaces.map(
+      (workspace) => `${workspace.organizationSlug ?? "?"}/${workspace.slug}`
+    ).join(", ");
+    throw new CliError(
+      `the token's user is not a member of ${org}/${slug}`,
+      known ? `the token can reach: ${known} - check CMSSY_ORG_SLUG and CMSSY_WORKSPACE_SLUG` : "the token's user belongs to no workspace - check the token"
+    );
+  }
+  return match;
+}
+function describe(manifest) {
+  const lines = [
+    `  blocks: ${manifest.blocks.map((block) => block.type).join(", ") || "-"}`
+  ];
+  if (!manifest.regions) {
+    lines.push("  regions: none declared - the stored regions are kept");
+    return lines;
+  }
+  const regions = manifest.regions.map((region) => {
+    const settings = region.settings ? Object.keys(region.settings) : [];
+    return settings.length ? `${region.id} (${settings.join(", ")})` : region.id;
+  });
+  lines.push(`  regions: ${regions.join(", ") || "-"}`);
+  return lines;
+}
+async function collectManifest(options, deps) {
+  const load = deps.load ?? loadSiteModule;
+  const blocksPath = findModule(
+    deps.cwd,
+    options.blocks,
+    BLOCKS_CANDIDATES,
+    "--blocks"
+  );
+  const configPath = findModule(
+    deps.cwd,
+    options.config,
+    CONFIG_CANDIDATES,
+    "--config"
+  );
+  const { blocks, category } = readBlocks(
+    await load(deps.cwd, blocksPath),
+    blocksPath
+  );
+  const config = readConfig(await load(deps.cwd, configPath), configPath);
+  if (blocks.length === 0) {
+    throw new CliError(
+      `${blocksPath} exports an empty \`blocks\` array`,
+      "register at least one block - cmssy add block <name>"
+    );
+  }
+  const manifest = buildBlockManifest(blocks, {
+    category,
+    regions: config.layout?.regions
+  });
+  return {
+    manifest,
+    blocksPath,
+    configPath,
+    org: config.org,
+    workspaceSlug: config.workspaceSlug
+  };
+}
+async function runSyncManifest(options, deps) {
+  if (options.help) {
+    deps.log("usage:");
+    for (const line of SYNC_MANIFEST_USAGE) deps.log(line);
+    return 0;
+  }
+  try {
+    loadEnvFiles(deps.cwd, deps.env);
+    const collected = await collectManifest(options, deps);
+    const { manifest } = collected;
+    if (options.dryRun) {
+      deps.log(JSON.stringify(manifest, null, 2));
+      return 0;
+    }
+    const token = resolveToken2(options, deps.env);
+    const org = resolveSlug(
+      options.org,
+      collected.org,
+      deps.env.CMSSY_ORG_SLUG,
+      "CMSSY_ORG_SLUG",
+      "--org"
+    );
+    const slug = resolveSlug(
+      options.workspace,
+      collected.workspaceSlug,
+      deps.env.CMSSY_WORKSPACE_SLUG,
+      "CMSSY_WORKSPACE_SLUG",
+      "--workspace"
+    );
+    const request2 = {
+      token,
+      apiUrl: deps.env.CMSSY_API_URL,
+      fetch: deps.fetch
+    };
+    const workspace = matchWorkspace(
+      await fetchMyWorkspaces(request2),
+      org,
+      slug
+    );
+    const scoped = { ...request2, workspaceId: workspace.id };
+    const before = await fetchBlockManifestHash(scoped);
+    const saved = await saveBlockManifest(manifest, scoped);
+    const unchanged = before === saved.hash;
+    const count = `${manifest.blocks.length} block${manifest.blocks.length === 1 ? "" : "s"}${manifest.regions ? ` and ${manifest.regions.length} region${manifest.regions.length === 1 ? "" : "s"}` : ""}`;
+    deps.log(
+      unchanged ? `cmssy: ${org}/${slug} already has this manifest - ${count} unchanged (${collected.blocksPath}, ${collected.configPath})` : `cmssy: pushed ${count} to ${org}/${slug} (${collected.blocksPath}, ${collected.configPath})`
+    );
+    for (const line of describe(manifest)) deps.log(line);
+    deps.log(
+      unchanged ? `  manifest ${saved.hash.slice(0, 12)} - last updated ${saved.updatedAt}` : `  manifest ${saved.hash.slice(0, 12)} - updated ${saved.updatedAt}`
+    );
+    return 0;
+  } catch (error) {
+    if (error instanceof CliError) {
+      deps.log(`cmssy: ${error.message}`);
+      if (error.fix) deps.log(`  ${error.fix}`);
+      return 1;
+    }
+    throw error;
+  }
+}
+
 // src/types-command.ts
-import { mkdirSync as mkdirSync3, readFileSync as readFileSync7, readdirSync, writeFileSync as writeFileSync5 } from "fs";
+import { mkdirSync as mkdirSync4, readFileSync as readFileSync7, readdirSync, writeFileSync as writeFileSync6 } from "fs";
 import { dirname as dirname3, relative, resolve as resolvePath } from "path";
 import { DEFAULT_CMSSY_API_URL } from "@cmssy/core";
 
@@ -1774,7 +2170,7 @@ function describeDrift(previous, next) {
   report("fields", declared(body(previous), fields), declared(body(next), fields));
   return lines.length ? lines : ["the generated output differs"];
 }
-function resolve3(value, fromEnv, variable) {
+function resolve4(value, fromEnv, variable) {
   const resolved = value?.trim() || fromEnv?.trim();
   if (!resolved) {
     throw new CliError(
@@ -1856,8 +2252,8 @@ function syncOperations(options, deps) {
     return 1;
   }
   try {
-    mkdirSync3(dirname3(outPath), { recursive: true });
-    writeFileSync5(outPath, source);
+    mkdirSync4(dirname3(outPath), { recursive: true });
+    writeFileSync6(outPath, source);
   } catch (error) {
     throw new CliError(
       `could not write ${shown}: ${error.message}`,
@@ -1874,8 +2270,8 @@ async function runTypes(options, deps) {
   try {
     loadEnvFiles(deps.cwd, deps.env);
     operationsStatus = syncOperations(options, deps);
-    const org = resolve3(options.org, deps.env.CMSSY_ORG_SLUG, "CMSSY_ORG_SLUG");
-    const workspace = resolve3(
+    const org = resolve4(options.org, deps.env.CMSSY_ORG_SLUG, "CMSSY_ORG_SLUG");
+    const workspace = resolve4(
       options.workspace,
       deps.env.CMSSY_WORKSPACE_SLUG,
       "CMSSY_WORKSPACE_SLUG"
@@ -1922,8 +2318,8 @@ async function runTypes(options, deps) {
       deps.log("  run `cmssy types` and commit the result");
       return 1;
     }
-    mkdirSync3(dirname3(outPath), { recursive: true });
-    writeFileSync5(outPath, source);
+    mkdirSync4(dirname3(outPath), { recursive: true });
+    writeFileSync6(outPath, source);
     const fieldCount = models.reduce(
       (total, model) => total + model.fields.length,
       0
@@ -1952,16 +2348,9 @@ var USAGE = [
   "  cmssy add block <name> [--dir <path>]",
   "  cmssy link [--token <cs_...>] [--workspace <slug>] [--preview-url <url>]",
   "  cmssy types [--out <path>] [--operations-out <path>] [--no-operations]",
-  "              [--check] [--org <slug>] [--workspace <slug>]"
+  "              [--check] [--org <slug>] [--workspace <slug>]",
+  ...SYNC_MANIFEST_USAGE
 ].join("\n");
-function flagValue(args, name) {
-  const index = args.findIndex((arg) => arg === name);
-  if (index !== -1) return args[index + 1];
-  return args.find((arg) => arg.startsWith(`${name}=`))?.slice(name.length + 1);
-}
-function hasFlag(args, name) {
-  return args.includes(name);
-}
 async function runLinkCommand(args) {
   const rl = process.stdin.isTTY ? createInterface({ input: process.stdin, output: process.stdout }) : null;
   try {
@@ -2029,6 +2418,26 @@ async function main() {
     );
     return;
   }
+  if (command === "sync-manifest") {
+    process.exitCode = await runSyncManifest(
+      {
+        help: hasFlag(args, "--help"),
+        blocks: flagValue(args, "--blocks"),
+        config: flagValue(args, "--config"),
+        token: flagValue(args, "--token"),
+        org: flagValue(args, "--org"),
+        workspace: flagValue(args, "--workspace"),
+        dryRun: hasFlag(args, "--dry-run")
+      },
+      {
+        cwd: process.cwd(),
+        env: process.env,
+        log: (line) => console.log(line),
+        fetch: globalThis.fetch
+      }
+    );
+    return;
+  }
   console.error(USAGE);
   process.exitCode = command === void 0 || command === "--help" ? 0 : 1;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/cli",
-  "version": "14.0.0",
+  "version": "14.2.0",
   "description": "The cmssy CLI: `cmssy init` wires cmssy into an existing Next.js, Astro or React Router app; `cmssy link` connects it to a workspace and verifies the editor wiring.",
   "keywords": [
     "cmssy",
@@ -27,7 +27,8 @@
     "assets"
   ],
   "dependencies": {
-    "@cmssy/core": "14.0.0"
+    "esbuild": "^0.27.7",
+    "@cmssy/core": "14.2.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",