@wix/agent-skills 1.6.0 → 1.8.0

package/skills/wix-headless/references/shared/MCP_PREFIX.md

@@ -1,105 +0,0 @@
-# Wix MCP Tool Prefix — Discovery & Propagation
-
-Wix MCP tools are exposed under one of two prefixes depending on how the user installed the integration:
-
-| Install mode | Prefix |
-|---|---|
-| **Plugin** (typical for end users) | `mcp__plugin_<plugin-name>_wix-mcp-remote__` (e.g. `mcp__plugin_wix-headless_wix-mcp-remote__WixREADME`) |
-| **Direct MCP server** | `mcp__wix-mcp-remote__` (e.g. `mcp__wix-mcp-remote__WixREADME`) |
-
-Tool **suffixes** are identical in both modes: `WixREADME`, `CallWixSiteAPI`, `ListWixSites`, `ManageWixSite`, `SearchWixHeadlessDocumentation`, `SearchWixSDKDocumentation`, `SearchWixRESTDocumentation`, `BrowseWixRESTDocsMenu`, `ReadFullDocsArticle`, `ReadFullDocsMethodSchema`. Only the prefix differs.
-
-Documentation in this plugin uses the canonical short form (`mcp__wix-mcp-remote__<suffix>`) for readability — substitute the discovered prefix at runtime.
-
----
-
-## Discovery — entry-point skills only, once per session
-
-The entry-point skill (`wix-headless`) MUST run this before any other MCP call:
-
-1. Use whatever tool-discovery primitive your runtime provides to look up `WixREADME`.
-2. From the returned tool name, strip the trailing `WixREADME` — what remains (ending in `wix-mcp-remote__`) is the **MCP prefix**. Examples:
-   - Returned name `mcp__plugin_wix_wix-mcp-remote__WixREADME` → prefix `mcp__plugin_wix_wix-mcp-remote__`
-   - Returned name `mcp__wix-mcp-remote__WixREADME` → prefix `mcp__wix-mcp-remote__`
-3. Call `<prefix>WixREADME` once to verify connectivity.
-4. **If discovery returns no match, or the verify call fails:** stop and tell the user:
-   > *"Wix MCP tools are not available in this session. Please ensure the Wix MCP server is connected (or that the Wix plugin is enabled), then restart your client."*
-5. Hold the discovered prefix in working memory for the rest of the session — use it for every MCP call AND pass it into every subagent prompt.
-
----
-
-## Propagation to subagents
-
-Subagents (every Phase 1 / Phase 2 / Phase 3 / Phase 4 implementer) are isolated workers — they see only the prompt their parent gave them, not the parent's session state. Every subagent prompt MUST include this line verbatim near the top:
-
-```
-MCP tool prefix: <discovered prefix>
-Use this prefix for every Wix MCP call. Example: <prefix>CallWixSiteAPI, <prefix>WixREADME.
-```
-
-Without this line the subagent will try the canonical short form and fail in plugin mode.
-
----
-
-## `CallWixSiteAPI` call conventions — read before the first call
-
-`CallWixSiteAPI` is the most error-prone tool in this plugin. Two failure modes recur; avoid both:
-
-**1. Missing required wrapper params.** The tool requires — in addition to `method`, `url`, `body` — these wrapper fields:
-
-- `siteId` — from `wix.config.json` (or the parent prompt)
-- `reason` — one-sentence human reason, e.g. `"Install Wix Stores app for <brand>"`
-- `sourceDocUrl` — the Wix docs URL the recipe is from, e.g. `"https://dev.wix.com/docs/picasso/wix-ai-docs/recipes-v2/manage/platform/recipe-install-wix-apps"`
-
-**2. `body` passed as a stringified JSON.** `body` is typed `anyOf: [object, array]` — pass it as a real structured value. `body: "{\"tenant\":…}"` will be rejected with `Expected object, received string`.
-
-**The safe pattern — follow on the first `CallWixSiteAPI` of each session:**
-
-1. **Load the schema** via your runtime's tool-discovery primitive (the orchestrator's Step 0 already did this for the whole session per `<SKILL_ROOT>/references/commands/mcp-bootstrap.md` — only re-load if you hit a tool-not-found error).
-2. Call with the full shape:
-   ```
-   <prefix>CallWixSiteAPI(
-     siteId: "<siteId from wix.config.json>",
-     reason: "<one-sentence reason>",
-     sourceDocUrl: "<URL of the Wix docs recipe you're following>",
-     method: "POST",
-     url: "https://www.wixapis.com/<service>/<path>",
-     body: { …as a real object, not a string }
-   )
-   ```
-
-**When you see reference snippets written in prose-HTTP form** (e.g. `CallWixSiteAPI: POST /blog/v3/posts` followed by `body: { … }`), translate them into the full tool-call shape above — the prose form omits the wrapper fields for readability, not because they're optional.
-
-## Defensive fallback — required in every implementer agent
-
-If a Wix MCP call returns "tool not found" or the tool name appears unavailable for any reason:
-
-1. Re-discover the tool via your runtime's tool-discovery primitive, looking up the suffix (e.g. `CallWixSiteAPI`).
-2. Use the discovered tool name and retry the call.
-3. **Do NOT bail.** Only escalate to the user if discovery itself returns no match.
-
-This guards against parents that forgot to pass the prefix and against future prefix-scheme changes.
-
----
-
-## Prefer bundled reference docs over external doc reads
-
-Your agent directory includes `.md` reference files with API recipes, call templates, and error handling tailored to your scope. These are your primary source — they document the exact call patterns, body shapes, and edge cases for your use case.
-
-The Wix MCP also exposes documentation tools (`SearchWixRESTDocumentation`, `ReadFullDocsArticle`, `SearchWixSDKDocumentation`, etc.). These are useful when you hit an error or edge case not covered by your reference files. But **prefer your bundled `.md` files first** — each external doc read costs a tool call and 15-30s, and the bundled recipes are already validated for this plugin's flows.
-
-**Rule of thumb:** read your reference files → try the documented recipe → only if you get an unexpected error or need an endpoint not covered, fall back to the MCP doc tools.
-
----
-
-## Absolute paths — never trust CWD-relative instruction locations
-
-Subagents launched by the orchestrator run with the project directory as CWD (e.g. `/Users/.../headless-projects/chairloom/`), not the skill root. Your instruction file and its sibling references live **inside the skill**, not in your CWD — e.g. the stores instructions live at `<skill-root>/references/stores/INSTRUCTIONS.md`.
-
-**Rule:** every implementer prompt MUST include an `Instruction file (absolute path)` line pointing at the right `INSTRUCTIONS.md`. Read that file and only that path. Then use the absolute paths it lists for sibling references. Never:
-
-- Resolve `references/stores/INSTRUCTIONS.md` against your CWD — it doesn't exist there.
-- `Glob **/INSTRUCTIONS.md` or `**/agents/**` to "find" your instructions — that walks the project tree and finds nothing relevant; it's the most expensive failure mode in current runs.
-- Walk up from the project directory looking for the skill root — guess wrong and you'll burn minutes globbing.
-
-If your prompt is missing the absolute `Instruction file` line, ask the parent (don't guess). The `wix-headless` skill is responsible for computing and passing this absolute path in every agent-launch prompt (see `references/ORCHESTRATION.md` § "Agent prompt template").

package/skills/wix-headless/scripts/copy-utility-templates.mjs

@@ -1,153 +0,0 @@
-#!/usr/bin/env node
-// Copy templated utility files into the project for the named phase.
-// Invoked by the wix-headless skill orchestrator before Phase 3 Components or
-// Phase 4 Pages dispatches, so that mechanical SDK-wrapper utilities
-// (back-in-stock.ts, discounts.ts, categories.ts) are on disk by the time
-// agents start.
-//
-// These files are pure templates — same shape regardless of brand. Letting an
-// LLM regenerate them costs tokens and risks drift. Pre-copying is structurally
-// better.
-//
-// Usage (both modes work):
-//   node <SKILL_ROOT>/scripts/copy-utility-templates.mjs <project-dir> <phase>
-//   curl -s https://dev.wix.com/skills/wix-headless/scripts/copy-utility-templates.mjs \
-//     | node --input-type=module - <project-dir> <phase>
-//
-//   <phase> ∈ { "components", "pages" }
-//
-// 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.
-//
-// Template files auto-detect whether they can be read on disk (tgz install)
-// and fall back to HTTP fetch when streamed via stdin.
-//
-// Reads `.wix/site.json` to discover which packs are loaded, then copies the
-// matching templates for the given phase. Never overwrites an existing file
-// (so user customisations and earlier orchestrator state are preserved).
-
-import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "node:fs";
-import { join, dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const SKILL_URL = "https://dev.wix.com/skills/wix-headless";
-
-// Mode detection — see check-manifest.mjs for the same pattern.
-let SKILL_ROOT_DISK = null;
-try {
-  const scriptDir = dirname(fileURLToPath(import.meta.url));
-  const candidate = resolve(scriptDir, "..");
-  if (existsSync(join(candidate, "templates"))) {
-    SKILL_ROOT_DISK = candidate;
-  }
-} catch {
-  // fileURLToPath may fail on non-file URLs; fall through to URL mode.
-}
-
-// Copy a template file (path relative to <SKILL_ROOT>/templates/) into the
-// project at destPath. Returns { ok: true } on success, or { ok: false,
-// reason: "..." } on failure (source missing, HTTP error, IO error).
-async function copyTemplate(sourceRel, destPath) {
-  if (SKILL_ROOT_DISK) {
-    const src = join(SKILL_ROOT_DISK, "templates", sourceRel);
-    if (!existsSync(src)) return { ok: false, reason: `missing on disk: ${src}` };
-    try {
-      mkdirSync(dirname(destPath), { recursive: true });
-      copyFileSync(src, destPath);
-      return { ok: true };
-    } catch (e) {
-      return { ok: false, reason: e.message };
-    }
-  }
-  const url = `${SKILL_URL}/templates/${sourceRel}`;
-  try {
-    const r = await fetch(url);
-    if (r.status === 404) return { ok: false, reason: `missing at ${url}` };
-    if (!r.ok) return { ok: false, reason: `fetch ${url}: HTTP ${r.status}` };
-    const text = await r.text();
-    mkdirSync(dirname(destPath), { recursive: true });
-    writeFileSync(destPath, text);
-    return { ok: true };
-  } catch (e) {
-    return { ok: false, reason: e.message };
-  }
-}
-
-// Hardcoded mapping: { pack, phase, source (relative to templates dir), dest (relative to project) }.
-// To add a new templated utility: ship the file under templates/<pack>/, then add
-// an entry here. Keep this list small — only files that are pure SDK wrappers
-// with no brand-specific content belong here.
-const TEMPLATES = [
-  { pack: "stores", phase: "components", source: "stores/back-in-stock.ts", dest: "src/utils/back-in-stock.ts" },
-  { pack: "ecom", phase: "components", source: "ecom/discounts.ts", dest: "src/utils/discounts.ts" },
-  { pack: "stores", phase: "pages", source: "stores/categories.ts", dest: "src/utils/categories.ts" },
-];
-
-const projectDir = process.argv[2];
-const phase = process.argv[3];
-
-if (!projectDir || !phase) {
-  console.error("usage: copy-utility-templates.mjs <project-dir> <phase>");
-  console.error("  <phase> ∈ { components, pages }");
-  process.exit(2);
-}
-
-if (phase !== "components" && phase !== "pages") {
-  console.error(`copy-utility-templates: invalid phase "${phase}" — must be "components" or "pages"`);
-  process.exit(2);
-}
-
-const sitePath = join(projectDir, ".wix/site.json");
-let loadedPacks;
-try {
-  const site = JSON.parse(readFileSync(sitePath, "utf8"));
-  loadedPacks = new Set(site.verticals ?? []);
-  if (loadedPacks.size === 0) {
-    console.error(`copy-utility-templates: site.json.verticals is empty — has Setup completed?`);
-    process.exit(1);
-  }
-} catch (e) {
-  console.error(`copy-utility-templates: cannot read ${sitePath} (${e.message}). Has Setup completed?`);
-  process.exit(1);
-}
-
-const candidates = TEMPLATES.filter((t) => t.phase === phase && loadedPacks.has(t.pack));
-
-if (candidates.length === 0) {
-  console.log(`copy-utility-templates: no templates for phase "${phase}" with loaded packs ${[...loadedPacks].join(", ")} — nothing to do`);
-  process.exit(0);
-}
-
-const copied = [];
-const skipped = [];
-const errors = [];
-
-for (const { pack, source, dest } of candidates) {
-  const destPath = join(projectDir, dest);
-
-  if (existsSync(destPath)) {
-    skipped.push(dest);
-    continue;
-  }
-
-  const result = await copyTemplate(source, destPath);
-  if (result.ok) {
-    copied.push(dest);
-  } else {
-    errors.push(`failed to copy ${source} → ${dest} (pack "${pack}"): ${result.reason}`);
-  }
-}
-
-const summary = {
-  phase,
-  packs: [...loadedPacks],
-  copied,
-  skipped,
-  errors,
-};
-
-console.log(JSON.stringify(summary, null, 2));
-
-if (errors.length > 0) {
-  process.exit(1);
-}

package/skills/wix-headless/scripts/finalize-run-json.mjs

@@ -1,141 +0,0 @@
-#!/usr/bin/env node
-// Finalize and write .wix/run.json at the end of the build.
-//
-// The orchestrator collects agent returns, timings, and outcome data over the
-// run. This script takes the orchestrator's draft as a JSON blob via stdin,
-// runs the timing-completeness gate (every required phase MUST have non-null
-// seconds, otherwise emit MISSING_TIMING errors), computes totalSeconds from
-// started/ended, writes the canonical .wix/run.json, and prints the perf
-// one-liner the orchestrator shows in the final message.
-//
-// Usage:
-//   echo "$DRAFT_JSON" | node finalize-run-json.mjs <project-dir>
-//
-// Input shape (via stdin):
-//   {
-//     "run":   { started, ended, brand, prompt, verticals, packs },
-//     "outcome": { build, previewUrl, dashboardUrl, ... },
-//     "phases":  [ { phase, status, seconds, data?, errors? }, ... ],
-//     "recoveries": [ ... ],   // optional; from manifest-check script outputs
-//     "errors":     [ ... ],   // optional; from agent returns / orchestrator
-//     "notes":      [ ... ],   // optional
-//     "requiredPhases": ["scaffold","app-install-Wix Stores","env-pull",...]
-//   }
-//
-// `requiredPhases` is the orchestrator's set of skill-invoked phases that MUST
-// have a captured duration (scaffold, every app-install-*, env-pull,
-// seed-utilities, npm-install, build, release|preview, etc.). The set is
-// run-specific (number of app-install-* depends on loaded packs), so the
-// orchestrator passes it in rather than the script guessing.
-//
-// Output:
-//   - Writes .wix/run.json (full shape, with timing-completeness gate applied).
-//   - Prints to stdout: a JSON object with { perfLine, missingTiming, totalSeconds }.
-
-import { writeFileSync, mkdirSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-
-const projectDir = process.argv[2];
-
-if (!projectDir) {
-  console.error("usage: cat draft.json | finalize-run-json.mjs <project-dir>");
-  process.exit(2);
-}
-
-let draft;
-try {
-  draft = JSON.parse(readFileSync(0, "utf8"));
-} catch (e) {
-  console.error(`finalize-run-json: stdin is not valid JSON (${e.message})`);
-  process.exit(2);
-}
-
-const run = draft.run ?? {};
-const phases = Array.isArray(draft.phases) ? [...draft.phases] : [];
-const errors = Array.isArray(draft.errors) ? [...draft.errors] : [];
-const recoveries = Array.isArray(draft.recoveries) ? draft.recoveries : [];
-const notes = Array.isArray(draft.notes) ? draft.notes : [];
-const outcome = draft.outcome ?? {};
-const requiredPhases = Array.isArray(draft.requiredPhases) ? draft.requiredPhases : [];
-
-// ---- 1. Timing completeness gate ------------------------------------------
-const phasesByName = new Map();
-for (const p of phases) {
-  phasesByName.set(p.phase, p);
-}
-
-const missingTiming = [];
-
-for (const required of requiredPhases) {
-  const existing = phasesByName.get(required);
-  if (!existing) {
-    // Missing entry entirely.
-    const entry = { phase: required, status: "unknown", seconds: null };
-    phases.push(entry);
-    phasesByName.set(required, entry);
-    errors.push({ code: "MISSING_TIMING", phase: required });
-    missingTiming.push(required);
-  } else if (existing.seconds === null || existing.seconds === undefined) {
-    existing.seconds = null;
-    if (!errors.some((e) => e.code === "MISSING_TIMING" && e.phase === required)) {
-      errors.push({ code: "MISSING_TIMING", phase: required });
-    }
-    missingTiming.push(required);
-  }
-}
-
-// ---- 2. totalSeconds derivation -------------------------------------------
-if (!run.totalSeconds && run.started && run.ended) {
-  const started = Date.parse(run.started);
-  const ended = Date.parse(run.ended);
-  if (!Number.isNaN(started) && !Number.isNaN(ended) && ended >= started) {
-    run.totalSeconds = Math.round((ended - started) / 1000);
-  }
-}
-
-// ---- 3. Compose final shape -----------------------------------------------
-const final = {
-  version: "1.0",
-  run,
-  outcome,
-  phases,
-  ...(recoveries.length > 0 ? { recoveries } : {}),
-  ...(errors.length > 0 ? { errors } : {}),
-  ...(notes.length > 0 ? { notes } : { notes: [] }),
-};
-
-const wixDir = join(projectDir, ".wix");
-mkdirSync(wixDir, { recursive: true });
-const runJsonPath = join(wixDir, "run.json");
-writeFileSync(runJsonPath, JSON.stringify(final, null, 2) + "\n");
-
-// ---- 4. Perf one-liner ----------------------------------------------------
-// Format: "Built in <Nm Ss> — design-system <n>s · images (phase 1 + phase 2) <n>s · build+release <n>s"
-const fmtSeconds = (sec) => (sec === null || sec === undefined ? "–" : `${sec}s`);
-const fmtTotal = (sec) => {
-  if (sec === null || sec === undefined) return "–";
-  const m = Math.floor(sec / 60);
-  const s = sec % 60;
-  return `${m}m ${s}s`;
-};
-const phaseSeconds = (name) => {
-  const p = phasesByName.get(name);
-  return p && p.seconds !== null && p.seconds !== undefined ? p.seconds : null;
-};
-const designSystem = phaseSeconds("design-system");
-const img1 = phaseSeconds("image-phase-1-decorative");
-const img2 = phaseSeconds("image-phase-2-entity");
-const imgTotal = img1 !== null && img2 !== null ? img1 + img2 : null;
-const build = phaseSeconds("build");
-const release = phaseSeconds("release") ?? phaseSeconds("preview");
-const buildPlusRelease = build !== null && release !== null ? build + release : null;
-
-const perfLine = `Built in ${fmtTotal(run.totalSeconds)} — design-system ${fmtSeconds(designSystem)} · images (phase 1 + phase 2) ${fmtSeconds(imgTotal)} · build+release ${fmtSeconds(buildPlusRelease)}`;
-
-console.log(JSON.stringify({
-  status: missingTiming.length > 0 ? "partial" : "ok",
-  path: runJsonPath,
-  totalSeconds: run.totalSeconds ?? null,
-  missingTiming,
-  perfLine,
-}, null, 2));

package/skills/wix-headless/scripts/init-site-json.mjs

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-// Write the initial .wix/site.json shape during Setup. Site.json is the
-// single source of truth that every downstream phase reads from / appends
-// to. This script writes the canonical initial structure deterministically
-// so the orchestrator never has to compose the shape inline (which used
-// to be LLM-emitted JSON, with the obvious drift risks).
-//
-// Usage:
-//   node init-site-json.mjs <project-dir> <brand-name> <brand-description> <verticals-csv>
-//
-// Example:
-//   node init-site-json.mjs /tmp/proj "Acme Coffee" "Warm cream-and-forest editorial" "stores,ecom,cms,gift-cards"
-//
-// Behavior:
-//   - Refuses to overwrite an existing .wix/site.json (exit 2). The orchestrator
-//     should call this exactly once during Setup. To re-init for testing, the
-//     caller can rm the file first.
-//   - Creates .wix/ if it doesn't exist.
-//   - Outputs a JSON summary to stdout.
-
-import { writeFileSync, existsSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-
-const [, , projectDir, brandName, brandDescription, verticalsCsv] = process.argv;
-
-if (!projectDir || !brandName || brandDescription === undefined || !verticalsCsv) {
-  console.error("usage: init-site-json.mjs <project-dir> <brand-name> <brand-description> <verticals-csv>");
-  process.exit(2);
-}
-
-const verticals = verticalsCsv
-  .split(",")
-  .map((v) => v.trim())
-  .filter(Boolean);
-
-if (verticals.length === 0) {
-  console.error("init-site-json: <verticals-csv> resolved to zero verticals — cms is always loaded, so this is a bug");
-  process.exit(2);
-}
-
-const wixDir = join(projectDir, ".wix");
-const sitePath = join(wixDir, "site.json");
-
-if (existsSync(sitePath)) {
-  console.error(`init-site-json: ${sitePath} already exists — refusing to overwrite. Setup should call this exactly once.`);
-  process.exit(2);
-}
-
-mkdirSync(wixDir, { recursive: true });
-
-const site = {
-  brand: {
-    name: brandName,
-    description: brandDescription,
-  },
-  seeded: {},
-  designTokens: {},
-  verticals,
-};
-
-writeFileSync(sitePath, JSON.stringify(site, null, 2) + "\n");
-
-console.log(JSON.stringify({ status: "ok", path: sitePath, verticals }, null, 2));

package/skills/wix-headless/scripts/preview.sh

@@ -1,45 +0,0 @@
-#!/usr/bin/env bash
-# Build the project and deploy a rotating preview URL.
-#
-# Usage:
-#   bash <SKILL_ROOT>/scripts/preview.sh
-#
-# Run from the project directory (CWD = <project>/). Requires wix.config.json.
-#
-# Output: stdout is the preview URL that `npx @wix/cli preview` printed; the
-# orchestrator captures it and records as outcome.previewUrl in run.json. All
-# other CLI output goes to stderr.
-#
-# `preview` does NOT populate the Frontend link in headless settings — that's
-# what `release.sh` is for. Use preview for fast iteration on a rotating URL;
-# use release for production deploy + transactional-email URL stability.
-#
-# Exit codes:
-#   0 — ok; preview URL on stdout
-#   <other> — build or preview failed; stderr surfaces the underlying error
-#             (TypeScript / Astro errors are code bugs, not endpoint drift —
-#              the orchestrator's recovery ladder doesn't retry build).
-
-set -euo pipefail
-
-# Build first; surface compile errors verbatim if it fails.
-npx @wix/cli build 1>&2
-
-# Preview captures the deployed URL on stdout. We tee its output to stderr for
-# the user-visible log AND parse the URL out for the orchestrator's stdout.
-PREVIEW_OUTPUT="$(mktemp)"
-trap 'rm -f "$PREVIEW_OUTPUT"' EXIT
-
-npx @wix/cli preview 2>&1 | tee "$PREVIEW_OUTPUT" 1>&2
-
-# Wix CLI prints `Site preview URL: <url>` (or similar) — extract the first
-# https URL from the output. If multiple are printed, the first is the canonical
-# preview URL.
-PREVIEW_URL="$(grep -oE 'https://[A-Za-z0-9.-]+\.wix-host\.com[^[:space:]]*' "$PREVIEW_OUTPUT" | head -n 1 || true)"
-
-if [[ -z "$PREVIEW_URL" ]]; then
-  echo "preview.sh: could not extract a *.wix-host.com URL from preview output" >&2
-  exit 1
-fi
-
-echo "$PREVIEW_URL"

package/skills/wix-headless/scripts/release.sh

@@ -1,73 +0,0 @@
-#!/usr/bin/env bash
-# Build the project and release to production. Unlike preview.sh, this populates
-# the Frontend link in dashboard → Settings → Headless Settings → Manage URLs,
-# which Wix injects into transactional emails (order confirmations, password
-# resets, member invites). Use release.sh for production deploys.
-#
-# Usage:
-#   bash <SKILL_ROOT>/scripts/release.sh
-#
-# Run from the project directory (CWD = <project>/). Requires wix.config.json.
-#
-# Output: stdout is the released URL that `npx @wix/cli release` printed
-# (extracted from the line `Site published on <url>`); the orchestrator
-# captures it as outcome.releaseUrl in run.json. All other CLI output goes
-# to stderr.
-#
-# Exit codes:
-#   0 — ok; release URL on stdout
-#   <other> — build or release failed; stderr surfaces the underlying error.
-#             Build failures are code bugs (TypeScript / Astro / missing
-#             module) — the orchestrator does NOT retry. Release auth failures
-#             surface as `Run npx @wix/cli login and retry.`
-#             Known transient release failures are retried by this script.
-
-set -euo pipefail
-
-npx @wix/cli build 1>&2
-
-RELEASE_OUTPUT="$(mktemp)"
-trap 'rm -f "$RELEASE_OUTPUT"' EXIT
-
-release_is_retryable() {
-  grep -Eiq 'ECONNRESET|ETIMEDOUT|EAI_AGAIN|STATE_MISMATCH|temporary system error|temporarily unavailable|try again shortly' "$RELEASE_OUTPUT"
-}
-
-MAX_RELEASE_ATTEMPTS="${WIX_RELEASE_ATTEMPTS:-3}"
-RELEASE_STATUS=1
-
-for ((attempt = 1; attempt <= MAX_RELEASE_ATTEMPTS; attempt++)); do
-  : >"$RELEASE_OUTPUT"
-  set +e
-  npx @wix/cli release 2>&1 | tee "$RELEASE_OUTPUT" 1>&2
-  RELEASE_STATUS=${PIPESTATUS[0]}
-  set -e
-
-  if [[ "$RELEASE_STATUS" -eq 0 ]]; then
-    break
-  fi
-
-  if [[ "$attempt" -lt "$MAX_RELEASE_ATTEMPTS" ]] && release_is_retryable; then
-    sleep_seconds=$((attempt * 5))
-    echo "release.sh: release attempt $attempt failed with a retryable Wix error; retrying in ${sleep_seconds}s" >&2
-    sleep "$sleep_seconds"
-    continue
-  fi
-
-  exit "$RELEASE_STATUS"
-done
-
-# CLI prints `Site published on <url>` — extract the URL after that marker.
-# Fall back to the first Wix-hosted URL if the marker line is not found
-# (CLI wording may vary between versions).
-RELEASE_URL="$(sed -nE 's/.*Site published on ([^[:space:]]+).*/\1/p' "$RELEASE_OUTPUT" | head -n 1 || true)"
-if [[ -z "$RELEASE_URL" ]]; then
-  RELEASE_URL="$(grep -oE 'https://[A-Za-z0-9.-]+\.wix-(site-)?host\.com[^[:space:]]*' "$RELEASE_OUTPUT" | head -n 1 || true)"
-fi
-
-if [[ -z "$RELEASE_URL" ]]; then
-  echo "release.sh: could not extract a release URL from release output" >&2
-  exit 1
-fi
-
-echo "$RELEASE_URL"