@wix/agent-skills 1.7.0 → 1.9.0

package/skills/wix-headless/references/stores/PRODUCT_CATALOG_DATA.md

@@ -1,11 +1,11 @@
-# Recipe: Product Catalog Data Setup (Phase 1)
+# Recipe: Product Catalog Data Setup (seed scope)
 
-Replace the default sample products Wix Stores installs with on-brand products via the Stores REST API (`curl` against `wixapis.com/stores/v3/...` with the standard headers from `../shared/AUTHENTICATION.md`). This file covers the `seed-seed` scope — data seeding only. Frontend wiring lives in the astro scope references (`../astro/stores/SHARED_WIRING.md`, `../astro/stores/PRODUCT_PAGES.md`, `../astro/ecom/CART_PAGES.md`, `../astro/stores/HOME_AND_NAV.md`) and should not be read by `seed-seed`.
+Replace the default sample products Wix Stores installs with on-brand products via the Stores REST API (`curl` against `wixapis.com/stores/v3/...` with the standard headers from `../shared/AUTHENTICATION.md`). This file covers the `seed` scope — data seeding only. Frontend wiring lives in the astro scope references (`../astro/stores/SHARED_WIRING.md`, `../astro/stores/PRODUCT_PAGES.md`, `../astro/ecom/CART_PAGES.md`, `../astro/stores/HOME_AND_NAV.md`) and should not be read by `seed`.
 
 > **Critical Rules — Read Before Starting**
 > 1. **V3 only** — all endpoints under `/stores/v3/...` for products.
 > 2. **No improvised endpoints** — if an REST call returns 404, stop and report. Do not guess alternative URLs. Do not loop on `docs-search REST (see DOCS_SEARCH.md)` more than twice on the same topic.
-> 3. **Do not seed categories.** Categories are merchant-driven — created in the Wix dashboard, not by this scope. The storefront's rail, Shop submenu, and `/category/[slug]` route are still wired (Phase 4) and light up automatically once the merchant adds at least one visible category with items (≤ 5 min after creation, the helper's TTL).
+> 3. **Do not seed categories** — they are merchant-driven. See Step 6 for the full rule and how the storefront still wires up automatically.
 
 > **V3 Catalog:** New Wix sites use Catalog V3. All endpoints below live under `/stores/v3/...`. The V1 product endpoints should not be used — they silently return 0 results on V3 catalogs.
 
@@ -22,9 +22,12 @@ Replace the default sample products Wix Stores installs with on-brand products v
 >
 > **If CLI auth is not available, skip this entire section.** The 12 default products remain and can be customized later in the Wix dashboard.
 
-> **API error guard:** If any REST call in Phase 1 returns a 404 or an unexpected error, do **not** retry the same call with a guessed alternative URL or namespace. Report the failing endpoint, request body, and error verbatim to the user, then stop.
+> **API error guard:** If any REST call in this seed scope returns a 404 or an unexpected error, do **not** retry the same call with a guessed alternative URL or namespace. Report the failing endpoint, request body, and error verbatim to the user, then stop.
+
+> **Stores appDefId** for install and `catalogReference.appId`: `215238eb-22a5-4c36-9e7b-e7c08025e04e`. (A different defId — `1380b703-ce81-ff05-f115-39571d94dfcd` — is used for `wixMetadata.appDefId` in the pages scope. Do not swap them.)
+>
+> <!-- REVIEW (appDefId discrepancy): `1380b703-…` is labeled the `wixMetadata.appDefId` here, but `stores/INSTRUCTIONS.md` (back-in-stock split + failure-mode table) calls the same id the back-in-stock app id. One of these labels is wrong — flagged for human review; value left unchanged. -->
 
-> **Stores appDefId** for install and `catalogReference.appId`: `215238eb-22a5-4c36-9e7b-e7c08025e04e`. (A different defId — `1380b703-ce81-ff05-f115-39571d94dfcd` — is used for `wixMetadata.appDefId` in Phase 2. Do not swap them.)
 
 ### Step 0: Ensure Stores App Is Installed
 
@@ -211,7 +214,7 @@ Emit a structured JSON block at the end of your completion message per `../share
 {
   "status": "complete",
   "phase": "stores-seed",
-  "scope": "seed-seed",
+  "scope": "seed",
   "summary": "Deleted {N} default products; created {N} on-brand products with variants",
   "data": {
     "products": [
@@ -220,14 +223,14 @@ Emit a structured JSON block at the end of your completion message per `../share
         "name": "<name>",
         "slug": "<slug>",
         "variantId": "<uuid>",
-        "price": 0,
-        "inventory": 0,
+        "price": 48.0,
+        "inventory": 50,
         "sku": "<sku>"
       }
     ],
     "categories": [],
-    "deletedCount": 0,
-    "createdCount": 0
+    "deletedCount": 12,
+    "createdCount": 3
   },
   "files": [],
   "errors": []
@@ -238,12 +241,12 @@ Emit a structured JSON block at the end of your completion message per `../share
 
 The JSON block MUST be the last content in your message. Parent skill consumes `data.products[*].slug` and `data.products[*].variantId` for the Phase 4 Pages scopes.
 
-### Phase 1 Boundary — Do Not Touch Other Site Data
+### Seed Boundary — Do Not Touch Other Site Data
 
-Phase 1 is complete after Step 7. Do **not** attempt any of the following, even if they seem like reasonable polish:
+The seed scope is complete after Step 7. Do **not** attempt any of the following, even if they seem like reasonable polish:
 
 - Cleaning up "orphan customizations", "All Products" containers, brand records, or any other catalog metadata you didn't create.
-- Creating, renaming, or deleting any category — categories are merchant-driven (see Step 6). The auto-managed "All Products" category (handle `online_stores_all_products`) stays in place; the frontend filters it out by handle.
+- Creating, renaming, or deleting any category — see Step 6 (leave the auto-managed "All Products" category in place).
 - Verifying your work via additional `query` calls beyond the Step 5 verification already performed.
 
-Phase 2+ (frontend wiring) is covered in the astro scope references (`../astro/stores/SHARED_WIRING.md`, `../astro/stores/PRODUCT_PAGES.md`, `../astro/stores/CATEGORY_PAGES.md`, `../astro/ecom/CART_PAGES.md`, `../astro/stores/HOME_AND_NAV.md`) — do not read them during `seed-seed`.
+Phase 2+ (frontend wiring) is covered in the astro scope references (`../astro/stores/SHARED_WIRING.md`, `../astro/stores/PRODUCT_PAGES.md`, `../astro/stores/CATEGORY_PAGES.md`, `../astro/ecom/CART_PAGES.md`, `../astro/stores/HOME_AND_NAV.md`) — do not read them during `seed`.

package/skills/wix-headless/references/verticals/_schema.json

@@ -33,7 +33,7 @@
           "description": { "type": "string" }
         }
       },
-      "description": "Feature blurbs for DISCOVERY.md Step 3 Section B."
+      "description": "Feature blurbs for DISCOVERY-create.md Step 3 Section B."
     },
     "apps": {
       "type": "array",

package/skills/wix-headless/references/verticals/_schema.md

@@ -29,13 +29,13 @@ requires: []                          # optional — verticals that must be co-l
                                       # If a pack with `requires:` is loaded, every name in the list MUST be in the same read batch.
 
 # --- Plan contribution ---
-features:                             # human-readable feature blurbs. Used in DISCOVERY.md Step 3 Section B.
+features:                             # human-readable feature blurbs. Used in DISCOVERY-create.md Step 3 Section B.
   - name: "Product catalog"
     description: "Browse products with images, prices, and variants."
 
 # --- Plan Pages table ---
 apps:                                 # zero or one entry per pack. apps[0].name fills the Source column
-  - name: "Wix Stores"                # of DISCOVERY.md Step 3 Section C.
+  - name: "Wix Stores"                # of DISCOVERY-create.md Step 3 Section C.
     appDefId: "215238eb-22a5-4c36-9e7b-e7c08025e04e"
 
 routes:                               # routes the pack ships. Each entry → one row in the Pages table.
@@ -65,7 +65,7 @@ disabled: false                       # if true, the pack ships its code but its
 | `description` | string | yes | One-line label — what the pack provides |
 | `triggers` | string[] | yes (empty allowed for transitive-only packs) | Case-insensitive substrings. SKILL.md routing table is the actual source of truth for what gets loaded; this is human reference. |
 | `requires` | string[] | no | Verticals that must be co-loaded in the same read batch |
-| `features` | object[] | yes | `{name, description}` — used in DISCOVERY.md Step 3 Section B |
+| `features` | object[] | yes | `{name, description}` — used in DISCOVERY-create.md Step 3 Section B |
 | `apps` | object[] | no | Zero or one entry. `apps[0].name` fills the Source column of the Pages table; absence implies built-in (cms uses `"CMS (builtin)"` literal). |
 | `routes` | object[] | no | `{route, name?}` — one row per entry in the Pages table |
 | `disabled` | bool | no | If true, the pack's surfaces are inactive by default. DISCOVERY plan skips disabled packs from Sections B + C. Today only `gift-cards`. Default false. |

package/skills/wix-headless/references/verticals/blog.md

@@ -26,6 +26,6 @@ disabled: false
 
 Loaded when the user's prompt mentions blogging, publishing, or editorial content.
 
-> **Discovery contract.** Phase 1 reads only the frontmatter above. Phase 2+ implementation (post seeding, RSS, page composition, ricos rendering) lives in an upstream skill plus this skill's own `templates/blog/` + `references/blog/INSTRUCTIONS.md`:
+> **Discovery contract.** Phase 1 reads only the frontmatter above. Phase 2+ implementation (post seeding, RSS, page composition, ricos rendering) lives in an upstream skill plus this skill's own `references/astro/blog/` + `references/blog/INSTRUCTIONS.md`:
 >
 > - `@skills/wix-manage` ships the seeding recipe — `references/blog/how-to-create-blog-posts.md`.

package/skills/wix-headless/references/verticals/bookings.md

@@ -0,0 +1,39 @@
+---
+name: bookings
+description: "Service-based booking — services catalog, availability calendar, and booking flow via Wix Bookings."
+triggers: ["booking", "appointment", "schedule", "reserve", "class", "session", "consult", "therapy", "lesson", "coaching", "trainer", "tutor", "salon", "spa", "clinic"]
+requires: []
+
+features:
+  - name: "Services catalog"
+    description: "Browse bookable appointment services with descriptions, duration, and pricing."
+  - name: "Online booking"
+    description: "Pick an available time slot on a calendar, complete the service's booking form, and confirm."
+  - name: "Secure checkout"
+    description: "Free or pay-in-person bookings confirm instantly; paid services hand off to Wix's secure hosted checkout."
+
+apps:
+  - name: "Wix Bookings"
+    appDefId: "13d21c63-b5ec-5912-8397-c3a5ddb27a97"
+
+routes:
+  - route: "/services"
+  - route: "/services/[slug]"
+    name: "Service Detail"
+  - route: "/booking-confirmation"
+    name: "Booking Confirmation"
+  - route: "Hosted by Wix"
+    name: "Secure Checkout"
+
+disabled: false
+---
+
+# Bookings Pack
+
+Loaded when the user's prompt implies offering appointments, classes, or sessions.
+
+> **Discovery contract.** Phase 1 reads only the frontmatter above to compose the plan's Pages table. Phase 2+ implementation (seeding, page composition, theming) lives in this skill's own `references/astro/templates/bookings/` + `references/bookings/INSTRUCTIONS.md`.
+>
+> - Seed recipe: `<SKILL_ROOT>/references/bookings/SERVICES_DATA.md` (service creation via Wix Bookings REST API).
+>
+> No per-pack `seed`, `components`, `componentsCss`, or `pages` blocks live in this skill anymore.

package/skills/wix-headless/references/verticals/cms.md

@@ -23,7 +23,7 @@ disabled: false
 
 Always loaded. Provides Home + About + FAQ content pages editable from the Wix dashboard's Content Manager.
 
-> **Discovery contract.** Phase 1 reads only the frontmatter above. Phase 2+ implementation (collection schemas, item seeding, page composition) lives in an upstream skill plus this skill's own `templates/cms/` + `references/cms/INSTRUCTIONS.md`:
+> **Discovery contract.** Phase 1 reads only the frontmatter above. Phase 2+ implementation (collection schemas, item seeding, page composition) lives in an upstream skill plus this skill's own `references/astro/cms/` + `references/cms/INSTRUCTIONS.md`:
 >
 > - `@skills/wix-manage` ships the recipes — `references/cms/cms-schema-management.md`, `cms-data-items-crud.md`, `cms-references-and-relationships.md`.
 >

package/skills/wix-headless/references/verticals/ecom.md

@@ -12,7 +12,7 @@ apps: []   # no app to install — @wix/ecom works with any installed catalog ap
 routes:
   - route: "/cart"
   - route: "/thank-you"
-  - route: "Hosted by Wix"   # Wix-hosted endpoint — no .astro file. Listed so the discovery plan's Section C table includes a Checkout row (omitting it created user anxiety in the 2026 dolls-store run; the cart appeared to "go nowhere"). The route cell renders the literal string "Hosted by Wix".
+  - route: "Hosted by Wix"   # Wix-hosted endpoint — no .astro file. Listed so the discovery plan's Section C table includes a Checkout row for the Wix-hosted endpoint. The route cell renders the literal string "Hosted by Wix".
     name: "Checkout"
 
 disabled: false
@@ -22,4 +22,4 @@ disabled: false
 
 Vertical-agnostic ecommerce cart, checkout, and order confirmation. Co-loaded by any pack that needs cart/checkout (today: `stores`, `gift-cards`; future: `bookings`, `events`) via the `requires:` field. Never user-triggered.
 
-> **Discovery contract.** Phase 1 reads only the frontmatter above. Phase 2+ implementation (cart wiring, checkout redirect, discount codes) lives in this skill's own `templates/ecom/` + `references/ecom/INSTRUCTIONS.md`.
+> **Discovery contract.** Phase 1 reads only the frontmatter above. Phase 2+ implementation (cart wiring, checkout redirect, discount codes) lives in this skill's own `references/astro/ecom/` + `references/ecom/INSTRUCTIONS.md`.

package/skills/wix-headless/references/verticals/gift-cards.md

@@ -21,4 +21,4 @@ disabled: true
 
 Passive vertical: code ships in every site that has a storefront, but every gift-card surface only renders if the **Wix Gift Card app** is enabled in the site's dashboard. Never user-triggered.
 
-> **Discovery contract.** Phase 1 reads only the frontmatter above. Because `disabled: true`, the discovery plan never promises any gift-card surface to the user. Phase 2+ implementation (runtime probe, buy flow, nav/home contributions) lives in this skill's own `templates/gift-cards/` + `references/gift-cards/INSTRUCTIONS.md`; the `astro-stores-demo` includes a working `gift-card.astro` reference.
+> **Discovery contract.** Phase 1 reads only the frontmatter above. Because `disabled: true`, the discovery plan never promises any gift-card surface to the user. Phase 2+ implementation (runtime probe, buy flow, nav/home contributions) lives in this skill's own `references/astro/templates/gift-cards/` + `references/gift-cards/INSTRUCTIONS.md`; see `references/astro/templates/gift-cards/gift-cards.astro` for the working buy-page reference.

package/skills/wix-headless/references/verticals/stores.md

@@ -26,7 +26,7 @@ disabled: false
 
 Loaded when the user's prompt implies selling products.
 
-> **Discovery contract.** Phase 1 reads only the frontmatter above to compose the plan's Pages table. Phase 2+ implementation (seeding, page composition, theming) lives in an upstream skill plus this skill's own `templates/stores/` + `references/stores/INSTRUCTIONS.md`:
+> **Discovery contract.** Phase 1 reads only the frontmatter above to compose the plan's Pages table. Phase 2+ implementation (seeding, page composition, theming) lives in an upstream skill plus this skill's own `references/astro/templates/stores/` + `references/stores/INSTRUCTIONS.md`:
 >
 > - `@skills/wix-manage` ships the seeding recipes — `references/stores/setup-online-store-catalog-v3.md`, `bulk-create-products-with-options.md`, `create-product-from-image.md`.
 >

package/skills/wix-headless/scripts/check-manifest.mjs

@@ -11,9 +11,29 @@
 //   curl -s https://dev.wix.com/skills/wix-headless/scripts/check-manifest.mjs \
 //     | node --input-type=module - <project-dir> <phase> <packs-csv>
 //
-//   <phase> ∈ { "components", "pages" }
+//   <phase> ∈ { "components", "pages", "integration" }  (astro scaffold mode; integration = custom frontend)
 //   <packs-csv> = comma-separated pack names (loaded verticals), e.g. "stores,ecom,cms"
 //
+// Integration mode (frontend = "custom") — verify the CONNECTION, not pack files:
+//   node <SKILL_ROOT>/scripts/check-manifest.mjs <project-dir> integration <connection-plan.json> \
+//        [--build-output <dir>]
+//   where <connection-plan.json> is the connection-plan subagent's returned JSON
+//   ({ data: { bindingMap, augmentation, persistenceSwap } } or that object directly).
+//   Verifies the connection per the three connection kinds:
+//     - bindingMap     (none/static)  → each region's `file` now carries a Wix SDK script
+//                                        (createClient / @wix/sdk / OAuthStrategy)
+//     - augmentation   (none/static)  → each inject `file` has its component + SDK call
+//                                        (+ a <form> + createSubmission for form capabilities)
+//     - persistenceSwap (own/SPA)     → each `sourceFile` carries a bundled @wix/sdk import
+//                                        AND a @wix/data CRUD call (items.query/insert/update/remove)
+//   …and the always-connect invariant: at least one connection of ANY kind exists.
+//   --build-output <dir>: for own-build SPAs, assert the build output dir exists and is
+//     non-empty. Run this form POST-BUILD (the dir doesn't exist until `npm run build`);
+//     run the plain form post-wiring/pre-build to verify the source connection. Catches the
+//     "published the un-built dev entry → 404" failure (SPA plan Break 4).
+//   Exit 1 if any claimed connection is missing, zero connections were made, or
+//   --build-output was given and the dir is missing/empty.
+//
 // Note: `node <(curl ...)` does NOT work for .mjs files — Node sees /dev/fd/N
 // with no extension and rejects ESM syntax. Use the stdin form above.
 //
@@ -33,7 +53,7 @@
 //   - Exit 0 on happy path or recoverable misses.
 //   - Exit 1 if any file is unrecoverably missing.
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, readdirSync } from "node:fs";
 import { join, dirname, basename, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -86,18 +106,135 @@ async function copySkillFile(relPath, destPath) {
   return true;
 }
 
-const [, , projectDir, phase, packsCsv] = process.argv;
+// Integration-mode check: verify the connection plan was wired into the site.
+async function checkIntegration(projectDir, planPath, buildOutputDir) {
+  if (!existsSync(planPath)) {
+    console.error(`check-manifest: connection plan not found at ${planPath}`);
+    process.exit(2);
+  }
+  let plan;
+  try {
+    plan = JSON.parse(readFileSync(planPath, "utf8"));
+  } catch (e) {
+    console.error(`check-manifest: could not parse connection plan JSON: ${e.message}`);
+    process.exit(2);
+  }
+  const data = plan.data ?? plan;
+  const bindingMap = Array.isArray(data.bindingMap) ? data.bindingMap : [];
+  const augmentation = Array.isArray(data.augmentation) ? data.augmentation : [];
+  const persistenceSwap = Array.isArray(data.persistenceSwap) ? data.persistenceSwap : [];
+
+  // A Wix SDK reference is present if the file imports @wix/sdk / calls createClient / OAuthStrategy.
+  // Matches BOTH the CDN form (`from "https://esm.sh/@wix/sdk"`) and the bundled form (`from "@wix/sdk"`).
+  const SDK_MARKER = /@wix\/sdk|createClient\s*\(|OAuthStrategy\s*\(/;
+  // A @wix/data CRUD call is present (persistence swap wired the data layer to the collection).
+  const DATA_MARKER = /@wix\/data|items\s*\.\s*(query|insert|update|remove)\s*\(|\.items\s*\.\s*(query|insert|update|remove)\s*\(/;
+  const fileHasSdk = (file) => {
+    const p = join(projectDir, file);
+    if (!existsSync(p)) return { exists: false, sdk: false, data: false, text: "" };
+    const text = readFileSync(p, "utf8");
+    return { exists: true, sdk: SDK_MARKER.test(text), data: DATA_MARKER.test(text), text };
+  };
+
+  const wired = [];
+  const missing = [];
+  let anySdk = false;
+
+  // (a) Each claimed binding-map region's file must now carry a Wix SDK script.
+  for (const r of bindingMap) {
+    if (!r.file) continue;
+    const { exists, sdk } = fileHasSdk(r.file);
+    if (exists && sdk) { anySdk = true; wired.push({ kind: "binding", file: r.file, anchor: r.anchor ?? null, entity: r.entity ?? null }); }
+    else missing.push({ kind: "binding", file: r.file, anchor: r.anchor ?? null, code: exists ? "REGION_NOT_WIRED" : "FILE_MISSING",
+      remediation: exists ? `no Wix SDK <script> found in ${r.file} for region ${r.anchor} — the wiring subagent did not connect it.` : `${r.file} not found in project.` });
+  }
+
+  // (b) Each augmentation's inject file must carry the SDK call (and a <form> for form capabilities).
+  for (const a of augmentation) {
+    const file = a.injectAt?.file;
+    if (!file) { missing.push({ kind: "augmentation", file: null, code: "NO_INJECT_FILE", remediation: `augmentation "${a.capability}" has no injectAt.file.` }); continue; }
+    const { exists, sdk, text } = fileHasSdk(file);
+    const isForm = /form/i.test(a.app ?? "") || /rsvp|lead|contact|form/i.test(a.capability ?? "") || (a.component ?? "").includes("form");
+    const formOk = !isForm || (/<form/i.test(text) && /createSubmission\s*\(/.test(text));
+    if (exists && sdk && formOk) { anySdk = true; wired.push({ kind: "augmentation", file, capability: a.capability ?? null, component: a.component ?? null }); }
+    else missing.push({ kind: "augmentation", file, capability: a.capability ?? null,
+      code: !exists ? "FILE_MISSING" : !sdk ? "AUGMENT_NOT_WIRED" : "FORM_NOT_INJECTED",
+      remediation: !exists ? `${file} not found.` : !sdk ? `no Wix SDK <script> in ${file} for the "${a.capability}" augmentation.` : `expected an injected <form> + createSubmission() in ${file} for "${a.capability}".` });
+  }
+
+  // (c) Each persistence swap's source file must carry the bundled SDK import AND a @wix/data CRUD call.
+  // (own-build SPAs: the data layer was rewritten in source — not a <script> injection.)
+  for (const s of persistenceSwap) {
+    const file = s.sourceFile;
+    if (!file) { missing.push({ kind: "persistenceSwap", file: null, code: "NO_SOURCE_FILE", remediation: `persistenceSwap entry has no sourceFile (the data-layer file to rewrite / fresh data module to write).` }); continue; }
+    const { exists, sdk, data: hasData } = fileHasSdk(file);
+    if (exists && sdk && hasData) { anySdk = true; wired.push({ kind: "persistenceSwap", file, collection: s.inferredShape?.collection ?? null }); }
+    else missing.push({ kind: "persistenceSwap", file,
+      code: !exists ? "FILE_MISSING" : !sdk ? "SDK_NOT_IMPORTED" : "DATA_NOT_WIRED",
+      remediation: !exists ? `${file} not found — the data layer was not rewritten / the fresh data module was not written.`
+        : !sdk ? `no @wix/sdk import in ${file} — the persistence swap must import createClient/OAuthStrategy (bundled, not CDN).`
+        : `no @wix/data CRUD call (items.query/insert/update/remove) in ${file} — the data layer still uses its old storage, not the Wix collection.` });
+  }
+
+  // (d) Always-connect invariant: at least one connection of ANY kind must exist.
+  const alwaysConnect = anySdk;
+  if (!alwaysConnect) {
+    missing.push({ kind: "invariant", code: "NO_CONNECTION", remediation: "ALWAYS-CONNECT VIOLATION: no Wix SDK connection found anywhere in the site. Integration mode must wire, augment, or persistence-swap at least one capability — a hosting-only release is not acceptable." });
+  }
+
+  // (e) Build-output assertion (own-build SPAs, post-build): the deployable dir must exist + be non-empty,
+  // so release publishes the built app — not the un-built dev entry that 404s in production.
+  let buildOutput = null;
+  if (buildOutputDir) {
+    const outPath = join(projectDir, buildOutputDir);
+    const ok = existsSync(outPath) && readdirSync(outPath).length > 0;
+    buildOutput = { dir: buildOutputDir, exists: ok };
+    if (!ok) missing.push({ kind: "buildOutput", file: buildOutputDir, code: "BUILD_OUTPUT_MISSING",
+      remediation: `build output dir "${buildOutputDir}" is missing or empty — run the project's own build (npm run build) before release and point wix.config.json.site.outputDirectory at it. Never publish the un-built source entry.` });
+  }
+
+  const summary = {
+    phase: "integration",
+    counts: { wired: wired.length, missing: missing.length, bindingRegions: bindingMap.length, augmentations: augmentation.length, persistenceSwaps: persistenceSwap.length },
+    alwaysConnect,
+    ...(buildOutput ? { buildOutput } : {}),
+    wired,
+    missing,
+  };
+  console.log(JSON.stringify(summary, null, 2));
+  process.exit(missing.length > 0 ? 1 : 0);
+}
+
+// Parse args: positionals + optional --build-output <dir> (integration only).
+const argv = process.argv.slice(2);
+const positionals = [];
+let buildOutputDir = null;
+for (let i = 0; i < argv.length; i++) {
+  const a = argv[i];
+  if (a === "--build-output") buildOutputDir = argv[++i];
+  else if (a.startsWith("--build-output=")) buildOutputDir = a.slice("--build-output=".length);
+  else positionals.push(a);
+}
+const [projectDir, phase, thirdArg] = positionals;
 
-if (!projectDir || !phase || !packsCsv) {
-  console.error("usage: check-manifest.mjs <project-dir> <phase> <packs-csv>");
+if (!projectDir || !phase || !thirdArg) {
+  console.error("usage: check-manifest.mjs <project-dir> <phase> <packs-csv | connection-plan.json> [--build-output <dir>]");
   process.exit(2);
 }
 
+// --- Integration mode: verify the connection was actually wired into the site ---
+if (phase === "integration") {
+  await checkIntegration(projectDir, thirdArg, buildOutputDir);
+  // checkIntegration exits the process.
+}
+
 if (phase !== "components" && phase !== "pages") {
-  console.error(`check-manifest: invalid phase "${phase}" — must be "components" or "pages"`);
+  console.error(`check-manifest: invalid phase "${phase}" — must be "components", "pages", or "integration"`);
   process.exit(2);
 }
 
+const packsCsv = thirdArg;
+
 const packs = packsCsv.split(",").map((p) => p.trim()).filter(Boolean);
 
 // Map a `creates:` file path to its template path (relative to skill root).