@wix/agent-skills 1.7.0 → 1.8.0

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

@@ -1,101 +0,0 @@
-#!/usr/bin/env node
-// Write the initial .wix/site.json — slim metadata snapshot for resume
-// detection + run.json composition. Subagents do NOT read this file during
-// the run; the orchestrator is the sole reader/writer and inlines anything
-// downstream phases need into their prompts.
-//
-// Final shape:
-//   {
-//     "brand":     { "name": "...", "description": "..." },
-//     "frontend":  "astro" | "custom",
-//     "verticals": ["stores", "cms", ...],
-//     "siteId":    "..." (optional — Setup Step 1 may patch later),
-//     "appId":     "..." (optional — Setup Step 1 may patch later)
-//   }
-//
-// Usage:
-//   node init-site-json.mjs <project-dir> <brand-name> <brand-description> \
-//     <verticals-csv> --frontend <astro|custom> \
-//     [--site-id <id>] [--app-id <id>]
-//   (In practice only "astro" reaches this step — custom frontends route to the
-//    not-available stub before Discovery's approval/site.json write.)
-//
-// Behavior:
-//   - Refuses to overwrite an existing .wix/site.json (exit 2). The orchestrator
-//     should call this exactly once during Discovery's "After Approval" step.
-//     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 ALLOWED_FRONTENDS = new Set(["astro", "custom"]);
-
-let frontend = "astro";
-let siteId;
-let appId;
-const positional = [];
-const rawArgs = process.argv.slice(2);
-for (let i = 0; i < rawArgs.length; i++) {
-  const arg = rawArgs[i];
-  if (arg === "--frontend") {
-    frontend = rawArgs[++i];
-  } else if (arg.startsWith("--frontend=")) {
-    frontend = arg.slice("--frontend=".length);
-  } else if (arg === "--site-id") {
-    siteId = rawArgs[++i];
-  } else if (arg.startsWith("--site-id=")) {
-    siteId = arg.slice("--site-id=".length);
-  } else if (arg === "--app-id") {
-    appId = rawArgs[++i];
-  } else if (arg.startsWith("--app-id=")) {
-    appId = arg.slice("--app-id=".length);
-  } else {
-    positional.push(arg);
-  }
-}
-
-if (!ALLOWED_FRONTENDS.has(frontend)) {
-  console.error(`init-site-json: --frontend must be one of ${[...ALLOWED_FRONTENDS].join(", ")}; got ${JSON.stringify(frontend)}`);
-  process.exit(2);
-}
-
-const [projectDir, brandName, brandDescription, verticalsCsv] = positional;
-
-if (!projectDir || !brandName || brandDescription === undefined || !verticalsCsv) {
-  console.error("usage: init-site-json.mjs <project-dir> <brand-name> <brand-description> <verticals-csv> --frontend <astro|custom> [--site-id <id>] [--app-id <id>]");
-  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. Discovery should call this exactly once.`);
-  process.exit(2);
-}
-
-mkdirSync(wixDir, { recursive: true });
-
-const site = {
-  brand: { name: brandName, description: brandDescription },
-  frontend,
-  verticals,
-};
-if (siteId) site.siteId = siteId;
-if (appId) site.appId = appId;
-
-writeFileSync(sitePath, JSON.stringify(site, null, 2) + "\n");
-
-console.log(JSON.stringify({ status: "ok", path: sitePath, frontend, verticals, ...(siteId ? { siteId } : {}), ...(appId ? { appId } : {}) }, 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@latest 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@latest 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@latest 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@latest 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@latest login and retry.`
-#             Known transient release failures are retried by this script.
-
-set -euo pipefail
-
-npx @wix/cli@latest 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@latest 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"