@decocms/blocks-cli 7.72.0 → 7.72.1

package/package.json

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

package/scripts/htmx-analyze.ts

@@ -82,7 +82,7 @@ Options:
   --help, -h       Show this help
 
 The output is read-only. Codemods that rewrite htmx to React are a
-planned follow-up — see the deco-to-tanstack-migration skill for the
+planned follow-up — see the source-deco-fresh skill (decocms/migrations) for the
 per-pattern rewrite recipes.
 `);
 }

package/scripts/migrate/phase-analyze.ts

@@ -732,7 +732,7 @@ export function analyze(ctx: MigrationContext): void {
       }
     }
     console.log(
-      "    See: deco-to-tanstack-migration skill, 'useComponent / partial sections' section",
+      "    See: source-deco-fresh skill (decocms/migrations), 'useComponent / partial sections' section",
     );
   }
 

package/scripts/migrate/phase-report.ts

@@ -12,7 +12,7 @@ const CSS_REVIEW_KEYWORDS = [
   "tailwind.config.ts",
   "safelist",
   "oklch",
-  "css-styling.md",
+  "styling.md",
   "@theme",
   "@apply",
   "@utility",

package/scripts/migrate/phase-transform.ts

@@ -178,7 +178,7 @@ export function transform(ctx: MigrationContext): void {
           "    </button>\n" +
           "  )}\n\n" +
           "Add \"use client\" to the top of the file. " +
-          "See deco-to-tanstack-migration skill, 'Ver mais / Load More' section.",
+          "See source-deco-fresh skill (decocms/migrations), 'Ver mais / Load More' section.",
         severity: "warning",
       });
     }
@@ -209,7 +209,7 @@ export function transform(ctx: MigrationContext): void {
           "(a) local React state for client-side toggles, " +
           "(b) `createServerFn` + `useMutation` for server actions, or " +
           "(c) a direct `invoke` call (`~/server/invoke`) for ad-hoc loaders. " +
-          "See: deco-to-tanstack-migration skill, 'useComponent / partial sections' section.",
+          "See: source-deco-fresh skill (decocms/migrations), 'useComponent / partial sections' section.",
         severity: "error",
       });
     }

package/scripts/migrate/post-cleanup/rules.ts

@@ -2,7 +2,8 @@
  * Post-migration cleanup audit — rule implementations.
  *
  * Each rule mirrors a section in
- * `.agents/skills/deco-to-tanstack-migration/references/post-migration-cleanup.md`.
+ * the `target-tanstack-deco` skill in decocms/migrations
+ * (`references/post-migration-cleanup.md`).
  * The intent is to take the human checklist and make it programmatically
  * detectable so future migrations get the same scrubbing automatically.
  *
@@ -1234,7 +1235,7 @@ const ruleHtmxResidue: Rule = {
         severity: "warning",
         file: `${rel}:${firstLine}`,
         message: `${occurrences.length} hx-* element(s) — ${catSummary}`,
-        fix: `Rewrite per .agents/skills/deco-to-tanstack-migration/references/htmx-rewrite.md (run \`deco-htmx-analyze\` for the per-category breakdown)`,
+        fix: `Rewrite per the source-deco-fresh skill (decocms/migrations), references/htmx-rewrite.md (run \`deco-htmx-analyze\` for the per-category breakdown)`,
         meta: {
           total: occurrences.length,
           byCategory: Object.fromEntries(byCat),

package/scripts/migrate/templates/cursor-rules.ts

@@ -38,8 +38,8 @@ alwaysApply: true
   https://github.com/decocms/blocks/blob/main/.cursor/rules/migration-tooling-policy.mdc
 - **Plan (living tracker, decisions + waves):**
   https://github.com/decocms/blocks/blob/main/MIGRATION_TOOLING_PLAN.md
-- **Migration skill (phase playbook):**
-  https://github.com/decocms/blocks/blob/main/.agents/skills/deco-to-tanstack-migration/SKILL.md
+- **Migration skills (phase playbook):** \`source-deco-fresh\` and
+  \`target-tanstack-deco\` in \`decocms/migrations\` (internal; referred to by name)
 
 ## What you need to know in this site
 

package/scripts/migrate/templates/lib-utils.ts

@@ -52,7 +52,7 @@ const STUB =
   "[deco-migrate] \`~/lib/vtex-transform.toProduct\` is a generated stub. " +
   "Replace with: import { toProduct } from '@decocms/apps-vtex/utils/transform' " +
   "(canonical signature: \`toProduct(product, sku, level, options)\`). " +
-  "Run \`deco-post-cleanup --fix\` or see the deco-to-tanstack-migration skill " +
+  "Run \`deco-post-cleanup --fix\` or see the target-tanstack-deco skill " +
   "(post-migration-cleanup § 5).";
 
 export function toProduct(_vtexProduct: any, ..._rest: any[]): Product {
@@ -68,7 +68,7 @@ const STUB_GET_IS_COOKIES =
   "[deco-migrate] \`~/lib/vtex-intelligent-search.getISCookiesFromBag\` is a " +
   "generated stub. Refactor: extract IS cookies from " +
   "\`request.headers.get('cookie')\` directly. The bag-based lookup mechanism " +
-  "does not exist on TanStack Start. See the deco-to-tanstack-migration " +
+  "does not exist on TanStack Start. See the target-tanstack-deco " +
   "skill (post-migration-cleanup § 5).";
 
 export function getISCookiesFromBag(_req?: any): Record<string, string> {
@@ -127,7 +127,7 @@ const STUB_WITH_SEGMENT_COOKIE =
   "stub. Replace with: import { withSegmentCookie } from " +
   "'@decocms/apps-vtex/utils/segment' (canonical signature: " +
   "\`withSegmentCookie(segment, headers?)\`). Run \`deco-post-cleanup --fix\` " +
-  "or see the deco-to-tanstack-migration skill.";
+  "or see the target-tanstack-deco skill.";
 
 export function getSegmentFromBag(_req?: any): Record<string, unknown> | null {
   throw new Error(STUB_GET_SEGMENT_FROM_BAG);

package/scripts/migrate/transforms/css.ts

@@ -3,7 +3,7 @@
  * source site's custom CSS before it's appended to the generated
  * `src/styles/app.css` (see templates/app-css.ts).
  *
- * Covers two gotchas from the migration skill (references/css-styling.md):
+ * Covers two gotchas from the migration skill (target-tanstack-deco, references/styling.md):
  *   - the v3 `theme()` CSS helper function is gone in v4 — CSS-first config
  *     means theme values live as custom properties, so `theme(colors.x.y)`
  *     must become `var(--color-x-y)` (gotcha referenced alongside #48).

package/scripts/migrate/transforms/htmx-on-events.ts

@@ -73,7 +73,7 @@ const TODO_BLOCK = `${TODO_MARKER}
 // Fresh-only globals like \`globalThis.window.STOREFRONT\` or
 // \`useScript(...)\`. Verify each handler matches a TanStack Start
 // equivalent (state hook, platform hook, or server function) — see
-// .agents/skills/deco-to-tanstack-migration/references/htmx-rewrite.md
+// the source-deco-fresh skill (decocms/migrations), references/htmx-rewrite.md
 // § Pattern 1 (event-handler).`;
 
 /**

package/scripts/migrate/transforms/imports.ts

@@ -90,7 +90,7 @@ const IMPORT_RULES: Array<[RegExp, string | null]> = [
   // no src/hooks/ dir and no ./hooks/* export; verified via `git log
   // --diff-filter=A -- '**/shopify/hooks/**'` returning nothing across all
   // history). The legacy migration reference
-  // (.agents/skills/deco-to-tanstack-migration/references/platform-hooks/README.md)
+  // (`target-tanstack-deco` skill in decocms/migrations, references/platform-hooks.md)
   // confirms Shopify's useCart/useUser/useWishlist were always meant to be
   // site-local no-op stubs, and templates/hooks.ts's generateHooks() still
   // scaffolds them at src/hooks/use{Cart,User,Wishlist}.ts for every

package/scripts/migrate/transforms/tailwind-renames.ts

@@ -145,7 +145,7 @@ export const TEXT_SIZE_MAP: Record<string, string> = {
 };
 
 export interface GotchaFinding {
-  /** Gotcha number in the deco-to-tanstack-migration skill's css-styling.md */
+  /** Gotcha number in the target-tanstack-deco skill's references/styling.md (decocms/migrations) */
   gotcha: number;
   message: string;
 }
@@ -165,7 +165,7 @@ export function detectDaisyUiV5StructuralIssues(content: string): GotchaFinding[
       gotcha: 37,
       message:
         "DaisyUI .collapse usage found — its expand/collapse chain breaks under Tailwind v4. " +
-        "Replace with native <details>/<summary> (see skill css-styling.md #37).",
+        "Replace with native <details>/<summary> (see target-tanstack-deco skill, references/styling.md #37).",
     });
   }
 
@@ -248,7 +248,7 @@ export function detectLogicalPropertyConflict(classes: string[]): GotchaFinding[
         message:
           `Mixed "${shorthand}-*" with "${sides[0]}-*"/"${sides[1]}-*" in the same className — ` +
           `Tailwind v4's logical properties (padding-inline vs padding-inline-start) don't cascade the same as v3's physical properties. ` +
-          `Replace the shorthand with explicit longhand at every breakpoint (see skill css-styling.md #42).`,
+          `Replace the shorthand with explicit longhand at every breakpoint (see target-tanstack-deco skill, references/styling.md #42).`,
       });
       break; // one finding per className string is enough signal
     }

package/scripts/migrate-post-cleanup.ts

@@ -4,7 +4,8 @@
  *
  * Read-only audit that scans a migrated site for dead code and obsolete
  * boilerplate that the framework now owns. Mirrors the human checklist at
- * `.agents/skills/deco-to-tanstack-migration/references/post-migration-cleanup.md`
+ * the `target-tanstack-deco` skill in decocms/migrations
+ * (`references/post-migration-cleanup.md`)
  * but turns it into something CI can actually run.
  *
  * Usage (from a migrated site directory):
@@ -93,7 +94,7 @@ function showHelp() {
     npx -p @decocms/blocks-cli deco-post-cleanup --fix
     npx -p @decocms/blocks-cli deco-post-cleanup --fix --strict   # fail CI if anything left
 
-  See: .agents/skills/deco-to-tanstack-migration/references/post-migration-cleanup.md
+  See: the target-tanstack-deco skill in decocms/migrations (references/post-migration-cleanup.md)
   `);
 }
 

package/scripts/migrate.ts

@@ -298,7 +298,10 @@ function bootstrap(ctx: { sourceDir: string }) {
 /** A site slug: lower-case, the shape SITE_CREATE itself enforces. */
 const SITE_SLUG = /^[a-z0-9][a-z0-9._-]*$/;
 
-const CONTROL_PLANE_URL = "https://control-plane.decocms.com";
+// control-plane.decocms.com has no DNS record; with it as the default, provisioning
+// failed on every run that did not override DECO_CONTROL_PLANE_URL, as a fetch error the
+// phase prints as a warning and moves past. This is the host that serves /mcp.
+const CONTROL_PLANE_URL = "https://control-plane.infra.deco.cx";
 
 /** `owner/name` of the repo in `dir`, from its `origin` remote, or null. */
 function repoFullName(dir: string): string | null {