@decocms/blocks-cli 7.37.0 → 7.37.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/blocks-cli",
-  "version": "7.37.0",
+  "version": "7.37.2",
   "type": "module",
   "description": "Deco codegen (generate-blocks, generate-schema, generate-invoke) and Fresh-to-TanStack migration tooling",
   "repository": {
@@ -31,7 +31,7 @@
     "lint:unused": "knip"
   },
   "dependencies": {
-    "@decocms/blocks": "7.37.0",
+    "@decocms/blocks": "7.37.2",
     "ts-morph": "^27.0.0",
     "tsx": "^4.22.5"
   },

package/scripts/deco-migrate-cli.ts

@@ -429,8 +429,7 @@ async function main() {
       console.log(`\n  ${bold("Next steps:")}`);
       console.log(`    cd ${outputDir}`);
       console.log(`    npm install`);
-      console.log(`    npm run generate:blocks`);
-      console.log(`    npm run generate:schema`);
+      console.log(`    npm run generate`);
       console.log(`    npx tsr generate`);
       console.log(`    npm run dev`);
     }

package/scripts/generate-blocks.test.ts

@@ -1,7 +1,5 @@
 import * as cp from "node:child_process";
-import * as fs from "node:fs";
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import * as os from "node:os";
 import { tmpdir } from "node:os";
 import path from "node:path";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
@@ -105,66 +103,3 @@ describe("readBlockDelta", () => {
     expect(delta).toEqual({});
   });
 });
-
-describe("generate-blocks legacy artifact sync", () => {
-  let tmpDir: string;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "generate-blocks-legacy-"));
-    // Minimal .deco/blocks/ dir with one block so output is non-empty.
-    fs.mkdirSync(path.join(tmpDir, ".deco", "blocks"), { recursive: true });
-    fs.writeFileSync(
-      path.join(tmpDir, ".deco", "blocks", "pages-Home.json"),
-      JSON.stringify({ path: "/" }),
-    );
-  });
-
-  afterEach(() => {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  it("syncs .ts and .json to the old path when legacy file is detected", () => {
-    const oldDir = path.join(tmpDir, "src", "server", "cms");
-    fs.mkdirSync(oldDir, { recursive: true });
-    fs.writeFileSync(path.join(oldDir, "blocks.gen.ts"), "// stale\n");
-
-    const { code, stderr } = runGenerator([], { cwd: tmpDir });
-    expect(code).toBe(0);
-
-    expect(stderr).toContain("src/server/cms/blocks.gen.ts");
-    expect(stderr).toContain(".deco/blocks.gen.ts");
-    expect(stderr).toContain("Update importers to use the new path");
-
-    // New path must exist.
-    expect(fs.existsSync(path.join(tmpDir, ".deco", "blocks.gen.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(tmpDir, ".deco", "blocks.gen.json"))).toBe(true);
-
-    // Old .ts must be synced (stub content, not the stale placeholder).
-    const oldTs = fs.readFileSync(path.join(oldDir, "blocks.gen.ts"), "utf-8");
-    expect(oldTs).not.toBe("// stale\n");
-
-    // Old .json sibling must be synced — the Vite plugin reads it by suffix.
-    const oldJson = path.join(oldDir, "blocks.gen.json");
-    expect(fs.existsSync(oldJson)).toBe(true);
-    const oldContent = JSON.parse(fs.readFileSync(oldJson, "utf-8"));
-    const newContent = JSON.parse(
-      fs.readFileSync(path.join(tmpDir, ".deco", "blocks.gen.json"), "utf-8"),
-    );
-    expect(oldContent).toEqual(newContent);
-  }, 30_000);
-
-  it("does not warn and does not sync when an explicit --out-file is passed", () => {
-    const oldDir = path.join(tmpDir, "src", "server", "cms");
-    fs.mkdirSync(oldDir, { recursive: true });
-    fs.writeFileSync(path.join(oldDir, "blocks.gen.ts"), "// stale\n");
-
-    const explicitOut = path.join(tmpDir, "custom", "blocks.gen.ts");
-    const { code, stderr } = runGenerator(["--out-file", explicitOut], { cwd: tmpDir });
-    expect(code).toBe(0);
-
-    expect(stderr).not.toContain("Generator default output moved");
-    expect(fs.existsSync(explicitOut)).toBe(true);
-    // Old file must be untouched.
-    expect(fs.readFileSync(path.join(oldDir, "blocks.gen.ts"), "utf-8")).toBe("// stale\n");
-  }, 30_000);
-});

package/scripts/generate-blocks.ts

@@ -27,10 +27,6 @@
  *                 --out-file by swapping its extension, so passing --out-file
  *                 moves both artifacts together)
  *
- * If no `--out-file` is passed and the OLD default (src/server/cms/blocks.gen.ts)
- * still exists on disk, a one-line legacy warning is printed to stderr and the
- * NEW default is written anyway — see lib/legacyArtifact.ts.
- *
  * Programmatic:
  *   import { generateBlocks } from "@decocms/blocks-cli/generate-blocks";
  *   await generateBlocks({ blocksDir, outFile });
@@ -49,7 +45,6 @@ import {
   singleDecodeBlockName,
 } from "./lib/blocks-dedupe";
 import { buildCsvRedirectBlocks } from "./lib/csv-redirects";
-import { syncLegacyArtifact, warnLegacyArtifact } from "./lib/legacyArtifact";
 
 const TS_STUB = [
   "// Auto-generated — thin wrapper around blocks.gen.json.",
@@ -321,24 +316,10 @@ if (isMainModule()) {
   };
 
   const blocksDir = path.resolve(process.cwd(), arg("blocks-dir", ".deco/blocks"));
-  const OUT_FILE_EXPLICIT = args.includes("--out-file");
   const NEW_DEFAULT_OUT_FILE = ".deco/blocks.gen.ts";
-  const OLD_DEFAULT_OUT_FILE = "src/server/cms/blocks.gen.ts";
   const outFile = path.resolve(process.cwd(), arg("out-file", NEW_DEFAULT_OUT_FILE));
-  const oldFilePath = path.resolve(process.cwd(), OLD_DEFAULT_OUT_FILE);
-  const hasLegacy = !OUT_FILE_EXPLICIT && fs.existsSync(oldFilePath);
-  if (hasLegacy) {
-    warnLegacyArtifact(OLD_DEFAULT_OUT_FILE, NEW_DEFAULT_OUT_FILE);
-  }
 
-  generateBlocks({ blocksDir, outFile }).then((result) => {
-    if (hasLegacy) {
-      syncLegacyArtifact(oldFilePath, result.outFile);
-      // The .ts is a Vite stub — the plugin reads the .json sibling by suffix.
-      // Sync the JSON too so the Vite interceptor at the old path finds it.
-      syncLegacyArtifact(oldFilePath.replace(/\.ts$/, ".json"), result.jsonFile);
-    }
-  }).catch((err) => {
+  generateBlocks({ blocksDir, outFile }).catch((err) => {
     console.error(err);
     process.exit(1);
   });

package/scripts/generate-loaders.test.ts

@@ -62,58 +62,3 @@ describe("generate-loaders — loader vs action emit", () => {
     expect(out).not.toContain('createLoaderEntry("site/actions/addToCart"');
   });
 });
-
-describe("generate-loaders legacy artifact sync", () => {
-  let tmpDir: string;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "generate-loaders-legacy-"));
-    const write = (rel: string, content: string) => {
-      const abs = path.join(tmpDir, rel);
-      fs.mkdirSync(path.dirname(abs), { recursive: true });
-      fs.writeFileSync(abs, content);
-    };
-    write("src/loaders/related.ts", "export default async () => [];\n");
-  });
-
-  afterEach(() => {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  it("syncs to the old path when legacy file is detected", () => {
-    const oldDir = path.join(tmpDir, "src", "server", "cms");
-    fs.mkdirSync(oldDir, { recursive: true });
-    fs.writeFileSync(path.join(oldDir, "loaders.gen.ts"), "// stale\n");
-
-    const { code, stderr } = run(tmpDir);
-    expect(code).toBe(0);
-
-    expect(stderr).toContain("src/server/cms/loaders.gen.ts");
-    expect(stderr).toContain(".deco/loaders.gen.ts");
-    expect(stderr).toContain("Update importers to use the new path");
-
-    // New path must exist.
-    expect(fs.existsSync(path.join(tmpDir, ".deco", "loaders.gen.ts"))).toBe(true);
-
-    // Old file must be synced as a re-export shim (not the stale placeholder,
-    // and not a verbatim copy — a byte copy would carry `.deco/`-relative
-    // import paths that break at the deeper legacy location).
-    const oldContent = fs.readFileSync(path.join(oldDir, "loaders.gen.ts"), "utf-8");
-    expect(oldContent).not.toBe("// stale\n");
-    expect(oldContent).toContain('export * from "../../../.deco/loaders.gen"');
-  }, 30_000);
-
-  it("does not warn and does not sync when an explicit --out-file is passed", () => {
-    const oldDir = path.join(tmpDir, "src", "server", "cms");
-    fs.mkdirSync(oldDir, { recursive: true });
-    fs.writeFileSync(path.join(oldDir, "loaders.gen.ts"), "// stale\n");
-
-    const explicitOut = path.join(tmpDir, "custom", "loaders.gen.ts");
-    const { code, stderr } = run(tmpDir, ["--out-file", explicitOut]);
-    expect(code).toBe(0);
-
-    expect(stderr).not.toContain("Generator default output moved");
-    expect(fs.existsSync(explicitOut)).toBe(true);
-    expect(fs.readFileSync(path.join(oldDir, "loaders.gen.ts"), "utf-8")).toBe("// stale\n");
-  }, 30_000);
-});

package/scripts/generate-loaders.ts

@@ -43,14 +43,9 @@
  *   --exclude             comma-separated list of loader keys to skip (they have custom wiring)
  *   --prune-by-decofile   only emit entries whose key appears as `__resolveType` in any JSON
  *   --decofile-dir        @deprecated alias for --prune-by-decofile
- *
- * If no `--out-file` is passed and the OLD default (src/server/cms/loaders.gen.ts)
- * still exists on disk, a one-line legacy warning is printed to stderr and the
- * NEW default is written anyway — see lib/legacyArtifact.ts.
  */
 import fs from "node:fs";
 import path from "node:path";
-import { syncLegacyArtifact, warnLegacyArtifact } from "./lib/legacyArtifact";
 
 const args = process.argv.slice(2);
 function arg(name: string, fallback: string): string {
@@ -60,15 +55,8 @@ function arg(name: string, fallback: string): string {
 
 const loadersDir = path.resolve(process.cwd(), arg("loaders-dir", "src/loaders"));
 const actionsDir = path.resolve(process.cwd(), arg("actions-dir", "src/actions"));
-const OUT_FILE_EXPLICIT = args.includes("--out-file");
 const NEW_DEFAULT_OUT_FILE = ".deco/loaders.gen.ts";
-const OLD_DEFAULT_OUT_FILE = "src/server/cms/loaders.gen.ts";
 const outFile = path.resolve(process.cwd(), arg("out-file", NEW_DEFAULT_OUT_FILE));
-const oldLoadersPath = path.resolve(process.cwd(), OLD_DEFAULT_OUT_FILE);
-const hasLegacy = !OUT_FILE_EXPLICIT && fs.existsSync(oldLoadersPath);
-if (hasLegacy) {
-  warnLegacyArtifact(OLD_DEFAULT_OUT_FILE, NEW_DEFAULT_OUT_FILE);
-}
 const excludeRaw = arg("exclude", "");
 const excludeSet = new Set(excludeRaw.split(",").map((s) => s.trim()).filter(Boolean));
 
@@ -256,7 +244,6 @@ lines.push("");
 
 fs.mkdirSync(path.dirname(outFile), { recursive: true });
 fs.writeFileSync(outFile, lines.join("\n"));
-if (hasLegacy) syncLegacyArtifact(oldLoadersPath, outFile);
 
 const filterNote = cmsReferences
   ? ` (filtered against ${cmsReferences.size} CMS __resolveType references; pruned ${prunedCount} dead entries)`

package/scripts/generate-schema.test.ts

@@ -252,10 +252,10 @@ describe("typeToJsonSchema loader block-ref matching", () => {
 });
 
 // ---------------------------------------------------------------------------
-// Default output path (.deco/) + legacy warning — subprocess, mirrors the
-// pattern in generate-sections.test.ts. generate-schema.ts IS guarded by
-// isMainModule(), but it's still driven as a subprocess here so the CLI's
-// argv-parsed OUT_REL/legacy-check top-level code runs against a real cwd.
+// Default output path (.deco/) — subprocess, mirrors the pattern in
+// generate-sections.test.ts. generate-schema.ts IS guarded by isMainModule(),
+// but it's still driven as a subprocess here so the CLI's argv-parsed OUT_REL
+// top-level code runs against a real cwd.
 // ---------------------------------------------------------------------------
 
 const SCRIPT = path.resolve(__dirname, "generate-schema.ts");
@@ -313,39 +313,9 @@ describe("generate-schema default output path (.deco/)", () => {
     expect(meta.manifest.blocks.sections).toHaveProperty("site/sections/Hero.tsx");
   }, 30_000);
 
-  it("warns once to stderr naming both paths when the OLD default file exists and no --out is passed, but still writes the NEW default", () => {
-    const oldDefaultDir = path.join(tmpDir, "src", "server", "admin");
-    fs.mkdirSync(oldDefaultDir, { recursive: true });
-    fs.writeFileSync(path.join(oldDefaultDir, "meta.gen.json"), "{}");
-
+  it("does not warn about a legacy default path", () => {
     const { code, stderr } = runGenerator(["--skip-apps"], { cwd: tmpDir });
     expect(code).toBe(0);
-
-    expect(stderr).toContain("src/server/admin/meta.gen.json");
-    expect(stderr).toContain(".deco/meta.gen.json");
-    expect(stderr).toContain("Update importers to use the new path");
-
-    const newDefault = path.join(tmpDir, ".deco", "meta.gen.json");
-    expect(fs.existsSync(newDefault)).toBe(true);
-
-    // Old file must be kept in sync so mid-migration imports still work.
-    const oldDefault = path.join(tmpDir, "src", "server", "admin", "meta.gen.json");
-    expect(fs.existsSync(oldDefault)).toBe(true);
-    const oldContent = JSON.parse(fs.readFileSync(oldDefault, "utf-8"));
-    const newContent = JSON.parse(fs.readFileSync(newDefault, "utf-8"));
-    expect(oldContent).toEqual(newContent);
-  }, 30_000);
-
-  it("does not warn when an explicit --out is passed, even if the OLD default file exists", () => {
-    const oldDefaultDir = path.join(tmpDir, "src", "server", "admin");
-    fs.mkdirSync(oldDefaultDir, { recursive: true });
-    fs.writeFileSync(path.join(oldDefaultDir, "meta.gen.json"), "{}");
-
-    const explicitOut = path.join(tmpDir, "custom", "meta.gen.json");
-    const { code, stderr } = runGenerator(["--skip-apps", "--out", explicitOut], { cwd: tmpDir });
-    expect(code).toBe(0);
-
     expect(stderr).not.toContain("Generator default output moved");
-    expect(fs.existsSync(explicitOut)).toBe(true);
   }, 30_000);
 });

package/scripts/generate-schema.ts

@@ -33,10 +33,6 @@ import { fileURLToPath } from "node:url";
  *                 from disk with no runtime (FS-based Studio / Eitri stack).
  *   --framework   With --compose, the value written to the `framework` field
  *                 (default: "tanstack-start").
- *
- * If no `--out` is passed and the OLD default (src/server/admin/meta.gen.json)
- * still exists on disk, a one-line legacy warning is printed to stderr and the
- * NEW default is written anyway — see lib/legacyArtifact.ts.
  */
 import {
   type Symbol as MorphSymbol,
@@ -47,7 +43,6 @@ import {
   type Type,
 } from "ts-morph";
 import { isExcludedCodegenFile } from "./lib/codegenExclusions";
-import { syncLegacyArtifact, warnLegacyArtifact } from "./lib/legacyArtifact";
 
 // ---------------------------------------------------------------------------
 // CLI arg parsing
@@ -56,12 +51,9 @@ import { syncLegacyArtifact, warnLegacyArtifact } from "./lib/legacyArtifact";
 // here) so that importing this module for its pure exports
 // (definitionIdForPath, applyWidgetFormat, typeToJsonSchema — see
 // generate-schema.test.ts) never reads argv or touches the filesystem.
-// Without the guard, every import used to run an `fs.existsSync` check
-// against the *importing process's* cwd and could print a legacy-artifact
-// warning to stderr as an import-time side effect, unrelated to whatever
-// the test actually wanted to exercise. generateMeta() (below) and the
-// final write are themselves only reached inside `if (isMainModule())`, so
-// these vars only need real values in that same case.
+// generateMeta() (below) and the final write are themselves only reached
+// inside `if (isMainModule())`, so these vars only need real values in that
+// same case.
 // ---------------------------------------------------------------------------
 const argv = process.argv.slice(2);
 function arg(name: string, fallback: string): string {
@@ -70,7 +62,6 @@ function arg(name: string, fallback: string): string {
 }
 
 const NEW_DEFAULT_OUT_REL = ".deco/meta.gen.json";
-const OLD_DEFAULT_OUT_REL = "src/server/admin/meta.gen.json";
 
 let SITE_NAMESPACE = "site";
 let SITE_NAME = "storefront";
@@ -90,8 +81,6 @@ let COMPOSE = false;
 // Value written to the composed meta's `framework` field (only used with
 // --compose). Defaults to composeMeta's historical "tanstack-start".
 let FRAMEWORK = "tanstack-start";
-let _hasLegacySchema = false;
-let _oldSchemaPath = "";
 
 if (isMainModule()) {
   SITE_NAMESPACE = arg("namespace", SITE_NAMESPACE);
@@ -101,16 +90,10 @@ if (isMainModule()) {
   LOADERS_REL = arg("loaders", LOADERS_REL);
   APPS_REL = arg("apps", APPS_REL);
   SKIP_APPS = argv.includes("--skip-apps");
-  const outFileExplicit = argv.includes("--out");
   OUT_REL = arg("out", NEW_DEFAULT_OUT_REL);
   PLATFORM = arg("platform", PLATFORM);
   COMPOSE = argv.includes("--compose");
   FRAMEWORK = arg("framework", FRAMEWORK);
-  _oldSchemaPath = path.resolve(process.cwd(), OLD_DEFAULT_OUT_REL);
-  _hasLegacySchema = !outFileExplicit && fs.existsSync(_oldSchemaPath);
-  if (_hasLegacySchema) {
-    warnLegacyArtifact(OLD_DEFAULT_OUT_REL, NEW_DEFAULT_OUT_REL);
-  }
 }
 
 // ---------------------------------------------------------------------------
@@ -1541,7 +1524,6 @@ if (isMainModule()) {
     const outPath = path.resolve(process.cwd(), OUT_REL);
     fs.mkdirSync(path.dirname(outPath), { recursive: true });
     fs.writeFileSync(outPath, JSON.stringify(meta, null, 2));
-    if (_hasLegacySchema) syncLegacyArtifact(_oldSchemaPath, outPath);
 
     const defCount = Object.keys(meta.schema.definitions).length;
     const secCount = Object.keys(meta.manifest.blocks.sections || {}).length;

package/scripts/generate-sections.test.ts

@@ -115,48 +115,9 @@ describe("generate-sections default output path (.deco/)", () => {
     const newDefault = path.join(tmpDir, ".deco", "sections.gen.ts");
     expect(fs.existsSync(newDefault)).toBe(true);
     expect(fs.readFileSync(newDefault, "utf-8")).toContain("site/sections/Hero.tsx");
-    // No legacy file present, so no warning is expected.
+    // No legacy default path is written anymore, so no warning is expected.
     expect(stderr).not.toContain("Generator default output moved");
   }, 30_000);
-
-  it("warns once to stderr naming both paths when the OLD default file exists and no --out-file is passed, but still writes the NEW default", () => {
-    const oldDefaultDir = path.join(tmpDir, "src", "server", "cms");
-    fs.mkdirSync(oldDefaultDir, { recursive: true });
-    fs.writeFileSync(path.join(oldDefaultDir, "sections.gen.ts"), "// stale\n");
-
-    const { code, stderr } = runGenerator([], { cwd: tmpDir });
-    expect(code).toBe(0);
-
-    expect(stderr).toContain("src/server/cms/sections.gen.ts");
-    expect(stderr).toContain(".deco/sections.gen.ts");
-    expect(stderr).toContain("Update importers to use the new path");
-
-    const newDefault = path.join(tmpDir, ".deco", "sections.gen.ts");
-    expect(fs.existsSync(newDefault)).toBe(true);
-    expect(fs.readFileSync(newDefault, "utf-8")).toContain("site/sections/Hero.tsx");
-
-    // Old file is kept in sync as a re-export shim (NOT a verbatim copy — a
-    // byte copy would carry `.deco/`-relative import paths that break at the
-    // deeper legacy location). It re-exports the new file so mid-migration
-    // imports still resolve at any depth.
-    const oldDefault = path.join(tmpDir, "src", "server", "cms", "sections.gen.ts");
-    const oldContent = fs.readFileSync(oldDefault, "utf-8");
-    expect(oldContent).toContain('export * from "../../../.deco/sections.gen"');
-    expect(oldContent).not.toContain("site/sections/Hero.tsx");
-  }, 30_000);
-
-  it("does not warn when an explicit --out-file is passed, even if the OLD default file exists", () => {
-    const oldDefaultDir = path.join(tmpDir, "src", "server", "cms");
-    fs.mkdirSync(oldDefaultDir, { recursive: true });
-    fs.writeFileSync(path.join(oldDefaultDir, "sections.gen.ts"), "// stale\n");
-
-    const explicitOut = path.join(tmpDir, "custom", "sections.gen.ts");
-    const { code, stderr } = runGenerator(["--out-file", explicitOut], { cwd: tmpDir });
-    expect(code).toBe(0);
-
-    expect(stderr).not.toContain("Generator default output moved");
-    expect(fs.existsSync(explicitOut)).toBe(true);
-  }, 30_000);
 });
 
 describe("generate-sections --registry", () => {

package/scripts/generate-sections.ts

@@ -28,15 +28,10 @@
  *                   Built from every scanned section file, not just the ones
  *                   carrying convention exports. Off by default so existing
  *                   Vite sites regenerating sections.gen.ts in CI see zero diff.
- *
- * If no `--out-file` is passed and the OLD default (src/server/cms/sections.gen.ts)
- * still exists on disk, a one-line legacy warning is printed to stderr and the
- * NEW default is written anyway — see lib/legacyArtifact.ts.
  */
 import fs from "node:fs";
 import path from "node:path";
 import { isExcludedCodegenFile } from "./lib/codegenExclusions";
-import { syncLegacyArtifact, warnLegacyArtifact } from "./lib/legacyArtifact";
 
 const args = process.argv.slice(2);
 function arg(name: string, fallback: string): string {
@@ -45,15 +40,8 @@ function arg(name: string, fallback: string): string {
 }
 
 const sectionsDir = path.resolve(process.cwd(), arg("sections-dir", "src/sections"));
-const OUT_FILE_EXPLICIT = args.includes("--out-file");
 const NEW_DEFAULT_OUT_FILE = ".deco/sections.gen.ts";
-const OLD_DEFAULT_OUT_FILE = "src/server/cms/sections.gen.ts";
 const outFile = path.resolve(process.cwd(), arg("out-file", NEW_DEFAULT_OUT_FILE));
-const oldSectionsPath = path.resolve(process.cwd(), OLD_DEFAULT_OUT_FILE);
-const hasLegacy = !OUT_FILE_EXPLICIT && fs.existsSync(oldSectionsPath);
-if (hasLegacy) {
-  warnLegacyArtifact(OLD_DEFAULT_OUT_FILE, NEW_DEFAULT_OUT_FILE);
-}
 const EMIT_REGISTRY = args.includes("--registry");
 
 interface SectionMeta {
@@ -295,7 +283,6 @@ fs.writeFileSync(
   outFile,
   lines.join("\n").replace(/\n{3,}/g, "\n\n").replace(/\n*$/, "\n"),
 );
-if (hasLegacy) syncLegacyArtifact(oldSectionsPath, outFile);
 
 console.log(
   `Generated section metadata for ${entries.length} sections → ${path.relative(process.cwd(), outFile)}`,

package/scripts/migrate/phase-report.ts

@@ -199,7 +199,7 @@ export function report(ctx: MigrationContext): void {
   lines.push("- [ ] `src/hooks/useCart.ts` — wire to actual server functions for your platform");
   lines.push("- [ ] `src/worker-entry.ts` — verify CSP, proxy, and segment builder");
   lines.push("- [ ] See the **CSS Migration** section above for DaisyUI v4→v5 / Tailwind v3→v4 findings specific to this site");
-  lines.push("- [ ] Run `npm run generate:blocks` and `npm run generate:schema` after migration");
+  lines.push("- [ ] Run `npm run generate` (unified: blocks, sections, loaders, schema) after migration");
   lines.push("");
 
   // Known Issues
@@ -250,9 +250,8 @@ export function report(ctx: MigrationContext): void {
   lines.push("# 1. Install dependencies (bun is the canonical PM)");
   lines.push("bun install");
   lines.push("");
-  lines.push("# 2. Generate CMS blocks and schema");
-  lines.push("bun run generate:blocks");
-  lines.push("bun run generate:schema");
+  lines.push("# 2. Generate CMS artifacts (blocks, sections, loaders, schema)");
+  lines.push("bun run generate");
   lines.push("");
   lines.push("# 3. Generate routes");
   lines.push("bunx tsr generate");

package/scripts/migrate/phase-verify.ts

@@ -20,7 +20,6 @@ const REQUIRED_FILES = [
   // Deploy / preview / sync-secrets pipelines are owned by Cloudflare
   // Workers Builds (D6.3) -- configured in the CF dashboard, not via
   // GitHub workflow files in the site repo.
-  ".github/workflows/regen-blocks.yml",
   ".github/workflows/lockfile-check.yml",
   "knip.config.ts",
   ".prettierrc",

package/scripts/lib/legacyArtifact.ts

@@ -1,64 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-
-/**
- * Generator default output paths flipped from `src/server/{cms,admin}/` to
- * `.deco/` (framework artifacts live in the framework's folder, not mixed
- * into app source). Sites that never pass an explicit `--out`/`--out-file`
- * flag pick up the new default silently — except when the OLD default file
- * is still sitting on disk, which almost always means something (an
- * importer, a `.gitignore` entry, a stale CI cache check) still points at
- * it. In that case we warn once, to stderr, and then write to the NEW
- * default anyway: the artifact is regenerated code, so there's no reason to
- * block the run — the warning is just a nudge to go clean up the stale file
- * and its importers.
- *
- * An explicit flag means the caller made a deliberate choice about where
- * output goes; it gets no warning and no guard.
- */
-export function warnLegacyArtifact(oldPath: string, newPath: string): void {
-  console.warn(
-    `[deco] Generator default output moved: ${oldPath} -> ${newPath}. Update importers to use the new path, then delete the old file.`,
-  );
-}
-
-/**
- * Keeps the legacy `oldPath` in sync with the freshly-generated `newPath` so
- * sites mid-migration whose imports still point at the old location keep
- * working without a full migration first. Call this after generation
- * completes, only when the old file was detected.
- *
- * For `.ts`/`.tsx` artifacts a verbatim copy would be broken: the generated
- * file's import specifiers are relative to `newPath`'s directory (`.deco/`,
- * one level deep), but `oldPath` lives deeper (`src/server/cms/`), so every
- * `../src/...` specifier would resolve to a nonexistent path and crash the
- * dev server on boot. Instead we write a re-export shim pointing at `newPath`
- * — one specifier, correct at any depth, and self-documenting the deprecation.
- * The generated `.gen.ts` files only have named exports, so `export *` forwards
- * everything (including type exports). Non-TS artifacts (e.g. `.json` schema)
- * have no import paths, so a byte copy is still correct.
- */
-export function syncLegacyArtifact(oldPath: string, newPath: string): void {
-  fs.mkdirSync(path.dirname(oldPath), { recursive: true });
-
-  if (!/\.tsx?$/.test(oldPath)) {
-    fs.copyFileSync(newPath, oldPath);
-    return;
-  }
-
-  const newRel = path.relative(process.cwd(), newPath).replace(/\\/g, "/");
-  let specifier = path
-    .relative(path.dirname(oldPath), newPath)
-    .replace(/\\/g, "/")
-    .replace(/\.tsx?$/, "");
-  if (!specifier.startsWith(".")) specifier = `./${specifier}`;
-
-  fs.writeFileSync(
-    oldPath,
-    `// AUTO-GENERATED — DO NOT EDIT.\n` +
-      `// Deprecated path: the generator now writes to "${newRel}".\n` +
-      `// This file only re-exports it so mid-migration imports keep working.\n` +
-      `// Update your imports to the new path, then delete this file.\n` +
-      `export * from "${specifier}";\n`,
-  );
-}