@salesforce/afv-skills 1.58.0 → 1.60.0

package/skills/experience-ui-bundle-app-coordinate/SKILL.md

@@ -42,7 +42,7 @@ Before starting any phase, verify these preconditions are met:
 
 1. **Authenticated Salesforce org**: Run `sf org display` to confirm a default org is set and authenticated. If not, prompt the user to authenticate: `sf org login web`
 2. **Required CLI tools**: Verify `sf`, `npm`, and `npx` are available (declared in metadata.cliTools)
-3. **Node.js version**: Run `scripts/check-prerequisites.sh` and report any errors it returns
+3. **Node.js version**: Run `node scripts/check-prerequisites.mjs` and report any errors
 4. **Org features** (if deploying): Experience Cloud enabled, appropriate licenses, and Sites enabled
 
 If any precondition fails, stop and report the specific missing requirement before attempting any phase execution.
@@ -114,7 +114,7 @@ Offer prebuilt starter template (experience-ui-bundle-project-generate)
     v
 If template chosen: scaffold via sf template generate project -- Phase 1 skipped
     v
-If declined: run scripts/check-sfdx-project.sh
+If declined: run node scripts/check-sfdx-project.mjs
     v
 If missing: create sfdx-project.json
     v
@@ -123,7 +123,7 @@ Verify project directory initialized
 
 Offers a faster, less error-prone starting point before building from scratch. If no template is used, ensures an SFDX project exists before attempting to generate a UI bundle — without this, `sf template generate ui-bundle` will fail with a hard error. Always check first — do not assume the project structure exists.
 
-**Action:** Load `experience-ui-bundle-project-generate` and offer the two starter templates. If declined, run `scripts/check-sfdx-project.sh` and report any errors it returns. If the script reports an error, create the missing `sfdx-project.json` before proceeding.
+**Action:** Load `experience-ui-bundle-project-generate` and offer the two starter templates. If declined, run `node scripts/check-sfdx-project.mjs`; on error, create the missing `sfdx-project.json` before proceeding.
 
 ### Phase 1: Scaffolding (Foundation)
 
@@ -154,7 +154,7 @@ Creates the UI bundle directory structure, meta XML (including hosting target),
 - `package.json` — remove now-unused dependencies (`vite-plugin-graphql-codegen`, `@graphql-codegen/*`, `playwright`, `vitest`, etc.) and their npm scripts, not just the config files.
 - Any component/page that imports a deleted hook, client, or shadcn component (e.g. `useAsyncData`, `graphqlClient`) must have that import and its usage removed or replaced — never leave an import pointing at a file that no longer exists.
 - Do NOT re-add a file you just deleted elsewhere in the same pass (e.g. deleting `codegen.yml` while still emitting `.graphqlrc.yml`) — decide scope once per concern and apply it consistently across every file that touches that concern.
-- Before finishing Phase 4, run `scripts/check-dangling-refs.sh <deleted-basename>` for each deleted file and report any errors it returns.
+- Before finishing Phase 4, run `node scripts/check-dangling-refs.mjs <deleted-basename>` for each deleted file and report any errors.
 
 ### Phase 2: Features (Required if prompt mentions feature keywords — see "Prompt Classification Keywords" above)
 
@@ -378,12 +378,12 @@ Execute each phase sequentially following the standard pattern in `references/ph
 ---
 
 **Phase 0 -- Template Offer & Bootstrap**
-- Load `experience-ui-bundle-project-generate`, offer templates. If chosen: skip Phase 1, continue at Phase 2. If declined: run `scripts/check-sfdx-project.sh`, create project if missing.
+- Load `experience-ui-bundle-project-generate`, offer templates. If chosen: skip Phase 1, continue at Phase 2. If declined: run `node scripts/check-sfdx-project.mjs`, create project if missing.
 
 **Phase 1 -- Scaffolding** (skip if template used in Phase 0)
-- **Precondition**: `scripts/check-sfdx-project.sh` passes
+- **Precondition**: `node scripts/check-sfdx-project.mjs` passes
 - Load `experience-ui-bundle-metadata-generate`. Determine hosting target FIRST. Run `sf template generate ui-bundle --template reactbasic`, configure meta XML with `<target>`.
-- **Post-verification**: `scripts/check-phase-1-complete.sh` passes
+- **Post-verification**: `node scripts/check-phase-1-complete.mjs` passes
 
 **Phase 2 -- Features** (run on any feature keyword, even if pre-installed — see "Prompt Classification Keywords")
 - Load `experience-ui-bundle-features-generate`. Install features, integrate examples. Verify with `npm run build`.
@@ -395,25 +395,25 @@ Execute each phase sequentially following the standard pattern in `references/ph
 - Load `experience-ui-bundle-salesforce-data-access`. Fetch schema, ground entities, generate queries/mutations. Verify with `npx eslint`.
 
 **Phase 4 -- UI** (ALWAYS REQUIRED)
-- **Precondition**: `scripts/check-phase-1-complete.sh` passes
+- **Precondition**: `node scripts/check-phase-1-complete.mjs` passes
 - Load `experience-ui-bundle-frontend-generate`. Build layout, pages, components. Replace all boilerplate.
-- **Post-verification**: `scripts/check-phase-4-complete.sh` passes
+- **Post-verification**: `node scripts/check-phase-4-complete.mjs` passes
 - **CRITICAL**: Phase 4 generates the actual React UI. Never skip.
 
 **Phase 5 -- Integrations** (skip if not requested)
 - Load `experience-ui-bundle-agentforce-client-generate` (5a) and/or `experience-ui-bundle-file-upload-generate` (5b) as needed.
 
 **Phase 6 -- Deployment**
-- **Precondition**: `scripts/check-phase-6-ready.sh` passes
+- **Precondition**: `node scripts/check-phase-6-ready.mjs` passes
 - Load `experience-ui-bundle-deploy`. Follow 7-step sequence. Prefer `scripts/org-setup.mjs` if available.
 - **CRITICAL**: Guard against empty schema — retry fetch 3x before codegen.
 
 **Phase 7a -- Experience Site** (external users)
-- **Trigger**: `scripts/check-hosting-target.sh` outputs "ExperienceSite"
+- **Trigger**: `node scripts/check-hosting-target.mjs` outputs "ExperienceSite"
 - Load `experience-ui-bundle-site-generate`. Deploy site infrastructure.
 
 **Phase 7b -- Custom Application** (internal users)
-- **Trigger**: `scripts/check-hosting-target.sh` outputs "CustomApplication"
+- **Trigger**: `node scripts/check-hosting-target.mjs` outputs "CustomApplication"
 - Load `experience-ui-bundle-custom-app-generate`. Deploy app metadata.
 
 ### STEP 2.5: Phase Completion Validation

package/skills/experience-ui-bundle-app-coordinate/references/phase-completion-validation.md

@@ -3,7 +3,7 @@
 Before proceeding to STEP 3 (Final Summary), validate that all required phases were executed:
 
 **Critical Validation (MUST pass):**
-- [ ] **Phase 0 (Template Offer & Bootstrap) executed**: If no template was used, run `scripts/check-sfdx-project.sh`. If it returns non-zero, STOP and report error:
+- [ ] **Phase 0 (Template Offer & Bootstrap) executed**: If no template was used, run `node scripts/check-sfdx-project.mjs`. If it returns non-zero, STOP and report error:
   ```text
   ERROR: No SFDX project detected. Phase 0 (Bootstrap) is REQUIRED before scaffolding.
   Run `sf project generate` (or create sfdx-project.json) before invoking
@@ -11,7 +11,7 @@ Before proceeding to STEP 3 (Final Summary), validate that all required phases w
   ```
   If a template was used in Phase 0, this check is satisfied by the template's own scaffolding — skip re-running the script.
 
-- [ ] **Phase 1 hosting target resolved**: Run `scripts/check-hosting-target.sh`. If it returns non-zero, STOP and report error:
+- [ ] **Phase 1 hosting target resolved**: Run `node scripts/check-hosting-target.mjs`. If it returns non-zero, STOP and report error:
   ```text
   ERROR: Hosting target was not resolved in Phase 1. A UI bundle without a <target> in its
   meta XML will not be visible in the org. Determine Experience Site vs Custom Application
@@ -33,7 +33,7 @@ Before proceeding to STEP 3 (Final Summary), validate that all required phases w
   Exactly one of Phase 7a/7b must run -- it is never optional or "skipped".
   ```
 
-- [ ] **No dangling references after scaffold pruning**: If any file was deleted during Phase 1 scaffold pruning (see "Prune unused scaffold" in SKILL.md), run `scripts/check-dangling-refs.sh <deleted-basename>` for each deleted file. If it returns non-zero (e.g. `vite.config.ts` still imports `vite-plugin-graphql-codegen` after `codegen.yml` was deleted, or a page still imports a deleted hook/component), STOP and report error:
+- [ ] **No dangling references after scaffold pruning**: If any file was deleted during Phase 1 scaffold pruning (see "Prune unused scaffold" in SKILL.md), run `node scripts/check-dangling-refs.mjs <deleted-basename>` for each deleted file. If it returns non-zero (e.g. `vite.config.ts` still imports `vite-plugin-graphql-codegen` after `codegen.yml` was deleted, or a page still imports a deleted hook/component), STOP and report error:
   ```text
   ERROR: Scaffold pruning left a dangling reference -- <file> was deleted but <other-file>
   still imports/references it. Remove the reference (or restore the file) before completing

package/skills/experience-ui-bundle-app-coordinate/references/phase-execution-pattern.md

@@ -4,21 +4,23 @@ Each phase follows this standard pattern:
 
 | Step | What to do | Why |
 |------|-----------|-----|
-| **0. Precondition Check** | Run `scripts/check-phase-N-*.sh` script | Verifies prerequisites are met before proceeding |
+| **0. Precondition Check** | Run the matching `node scripts/check-phase-N-*.mjs` script | Verifies prerequisites are met before proceeding |
 | **1. Load skill** | Invoke the skill for this phase | Gives you current rules, patterns, constraints |
 | **2. Execute** | Follow the loaded skill's workflow | The skill defines HOW to do the work correctly |
 | **3. Verify** | Run lint and build | Catch errors before moving to next phase |
-| **4. Post-verification** | Run `scripts/check-phase-N-complete.sh` (if available) | Machine-checkable validation of phase completion |
+| **4. Post-verification** | Run the matching `node scripts/check-phase-N-complete.mjs` (if available) | Machine-checkable validation of phase completion |
 | **5. Checkpoint** | Confirm phase completion | Ensures dependencies satisfied for next phase |
 
 **CRITICAL: Do NOT skip step 1 (loading the skill).** Skills evolve — always load the current version.
 
+**Always invoke every script via `node` (never as a bare executable)** so it works on Windows cmd/PowerShell as well as macOS/Linux/Git Bash.
+
 ## Available Verification Scripts
 
-- `scripts/check-sfdx-project.sh` - Validates SFDX project exists (Phase 0/1 prerequisite)
-- `scripts/check-phase-1-complete.sh` - Verifies scaffold complete (Phase 4/6 prerequisite)
-- `scripts/check-phase-4-complete.sh` - Verifies UI build complete (Phase 6 prerequisite)
-- `scripts/check-phase-6-ready.sh` - Verifies deployment prerequisites met
-- `scripts/check-hosting-target.sh` - Determines which hosting target is configured
+- `node scripts/check-sfdx-project.mjs` - Validates SFDX project exists (Phase 0/1 prerequisite)
+- `node scripts/check-phase-1-complete.mjs` - Verifies scaffold complete (Phase 4/6 prerequisite)
+- `node scripts/check-phase-4-complete.mjs` - Verifies UI build complete (Phase 6 prerequisite)
+- `node scripts/check-phase-6-ready.mjs` - Verifies deployment prerequisites met
+- `node scripts/check-hosting-target.mjs` - Determines which hosting target is configured
 
 All scripts exit 0 on success, exit 1 on failure with an error message.

package/skills/experience-ui-bundle-app-coordinate/scripts/check-dangling-refs.mjs

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+// Verify no surviving file still imports/references a file deleted during
+// scaffold pruning.
+// Usage: node check-dangling-refs.mjs <deleted-basename> [<deleted-basename> ...]
+//   <deleted-basename> is the file name without extension, e.g. "codegen" for
+//   codegen.yml, "graphqlClient" for src/api/graphqlClient.ts, "useAsyncData"
+//   for the deleted hook.
+//
+// Always invoke via `node` (never as a bare executable) so this works on
+// Windows cmd/PowerShell as well as macOS/Linux/Git Bash. Quote each
+// <deleted-basename> argument.
+//
+// Exit 0 if no dangling references found, exit 1 with error message(s) if
+// any are found.
+
+import fs from "node:fs";
+import path from "node:path";
+
+const EXCLUDE_DIRS = new Set(["node_modules", "dist", "build", ".git"]);
+const UIBUNDLES_DIR = path.join("force-app", "main", "default", "uiBundles");
+
+// Filesystem read errors encountered while walking the bundle or reading a
+// file. A dangling-reference scan that could not read part of the tree has NOT
+// proven the reference is gone, so any entry here must turn a would-be SUCCESS
+// into a non-zero exit (see the end of the script).
+const ioErrors = [];
+
+function findBundleDir() {
+  let entries;
+  try {
+    entries = fs.readdirSync(UIBUNDLES_DIR, { withFileTypes: true });
+  } catch {
+    // uiBundles dir absent/unreadable: return "" so the caller emits an explicit
+    // "No UI bundle directory found" error and exits non-zero. This is a handled,
+    // expected case (e.g. a fresh project), not a silently-swallowed failure.
+    return "";
+  }
+  const dirs = entries
+    .filter((e) => e.isDirectory())
+    .map((e) => e.name)
+    .sort();
+  return dirs.length > 0 ? path.join(UIBUNDLES_DIR, dirs[0]) : "";
+}
+
+function collectFiles(dir, out) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch (err) {
+    // A subdirectory we cannot list may hide a surviving reference. Record it so
+    // the run fails rather than reporting an untrustworthy SUCCESS.
+    ioErrors.push(`could not read directory '${dir}': ${err.message}`);
+    return;
+  }
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (EXCLUDE_DIRS.has(entry.name)) continue;
+      collectFiles(full, out);
+    } else if (entry.isFile()) {
+      out.push(full);
+    }
+  }
+}
+
+const basenames = process.argv.slice(2);
+
+if (basenames.length === 0) {
+  console.error(
+    "ERROR: check-dangling-refs.mjs requires at least one deleted-file basename as an argument",
+  );
+  process.exit(1);
+}
+
+const bundleDir = findBundleDir();
+
+if (!bundleDir) {
+  console.error(`ERROR: No UI bundle directory found in ${UIBUNDLES_DIR}${path.sep}`);
+  process.exit(1);
+}
+
+const files = [];
+collectFiles(bundleDir, files);
+
+let foundDangling = false;
+
+for (const basename of basenames) {
+  const matches = [];
+  for (const file of files) {
+    let content;
+    try {
+      content = fs.readFileSync(file, "utf8");
+    } catch (err) {
+      // Could not read a surviving file — record and skip. We cannot confirm it
+      // is free of the deleted reference, so the run must not report SUCCESS.
+      ioErrors.push(`could not read file '${file}': ${err.message}`);
+      continue;
+    }
+    if (content.includes(basename)) {
+      matches.push(file);
+    }
+  }
+
+  if (matches.length > 0) {
+    foundDangling = true;
+    console.error(`ERROR: Dangling reference to deleted file '${basename}' found in:`);
+    for (const match of matches) {
+      console.error(`  - ${match}`);
+    }
+  }
+}
+
+if (foundDangling) {
+  process.exit(1);
+}
+
+// A read failure means the scan was incomplete — do not claim SUCCESS.
+if (ioErrors.length > 0) {
+  console.error(
+    "ERROR: dangling-reference scan is incomplete — some paths could not be read:",
+  );
+  for (const e of ioErrors) {
+    console.error(`  - ${e}`);
+  }
+  console.error(
+    "Resolve the read errors above and re-run; not reporting SUCCESS on an incomplete scan.",
+  );
+  process.exit(1);
+}
+
+console.log(`SUCCESS: No dangling references found for: ${basenames.join(" ")}`);
+process.exit(0);

package/skills/experience-ui-bundle-app-coordinate/scripts/check-hosting-target.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+// Check which hosting target is configured in .uibundle-meta.xml files.
+// Usage: node check-hosting-target.mjs
+//
+// Always invoke via `node` (never as a bare executable) so this works on
+// Windows cmd/PowerShell as well as macOS/Linux/Git Bash.
+//
+// Prints "ExperienceSite" or "CustomApplication" to stdout and exits 0 on
+// success. Exits 1 with an error message if no .uibundle-meta.xml files
+// are found, or none declare a valid target.
+
+import fs from "node:fs";
+import path from "node:path";
+
+const EXCLUDE_DIRS = new Set(["node_modules", "dist", "build", ".git"]);
+
+function findMetaFiles(dir, out) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (EXCLUDE_DIRS.has(entry.name)) continue;
+      findMetaFiles(full, out);
+    } else if (entry.isFile() && entry.name.endsWith(".uibundle-meta.xml")) {
+      out.push(full);
+    }
+  }
+}
+
+const metaFiles = [];
+findMetaFiles(".", metaFiles);
+
+if (metaFiles.length === 0) {
+  console.error("ERROR: No .uibundle-meta.xml files found");
+  process.exit(1);
+}
+
+const contents = metaFiles.map((f) => {
+  try {
+    return fs.readFileSync(f, "utf8");
+  } catch {
+    return "";
+  }
+});
+
+if (contents.some((c) => c.includes("<target>ExperienceSite</target>"))) {
+  console.log("ExperienceSite");
+  process.exit(0);
+}
+
+if (contents.some((c) => c.includes("<target>CustomApplication</target>"))) {
+  console.log("CustomApplication");
+  process.exit(0);
+}
+
+console.error("ERROR: No valid hosting target found in .uibundle-meta.xml");
+process.exit(1);

package/skills/experience-ui-bundle-app-coordinate/scripts/check-phase-1-complete.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+// Verify Phase 1 (Scaffolding) completed successfully.
+// Usage: node check-phase-1-complete.mjs
+//
+// Always invoke via `node` (never as a bare executable) so this works on
+// Windows cmd/PowerShell as well as macOS/Linux/Git Bash.
+//
+// Exit 0 if complete, exit 1 with an error message if incomplete.
+
+import fs from "node:fs";
+import path from "node:path";
+
+const UIBUNDLES_DIR = path.join("force-app", "main", "default", "uiBundles");
+
+function findBundleDir() {
+  let entries;
+  try {
+    entries = fs.readdirSync(UIBUNDLES_DIR, { withFileTypes: true });
+  } catch {
+    return "";
+  }
+  const dirs = entries
+    .filter((e) => e.isDirectory())
+    .map((e) => e.name)
+    .sort();
+  return dirs.length > 0 ? path.join(UIBUNDLES_DIR, dirs[0]) : "";
+}
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+const bundleDir = findBundleDir();
+
+if (!bundleDir) {
+  fail(
+    `ERROR: Phase 1 incomplete: No UI bundle directory found in ${UIBUNDLES_DIR}${path.sep}`,
+  );
+}
+
+if (!fs.existsSync(path.join(bundleDir, "src"))) {
+  fail(`ERROR: Phase 1 incomplete: No src/ directory found in ${bundleDir}`);
+}
+
+const metaFiles = fs
+  .readdirSync(bundleDir)
+  .filter((name) => name.endsWith(".uibundle-meta.xml"));
+
+if (metaFiles.length === 0) {
+  fail(`ERROR: Phase 1 incomplete: No .uibundle-meta.xml file found in ${bundleDir}`);
+}
+
+const hasTarget = metaFiles.some((name) => {
+  try {
+    return fs.readFileSync(path.join(bundleDir, name), "utf8").includes("<target>");
+  } catch {
+    return false;
+  }
+});
+
+if (!hasTarget) {
+  fail("ERROR: Phase 1 incomplete: .uibundle-meta.xml missing <target> element");
+}
+
+if (!fs.existsSync(path.join(bundleDir, "package.json"))) {
+  fail(`ERROR: Phase 1 incomplete: No package.json found in ${bundleDir}`);
+}
+
+console.log("SUCCESS: Phase 1 complete: Scaffold verified");
+process.exit(0);

package/skills/experience-ui-bundle-app-coordinate/scripts/check-phase-4-complete.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+// Verify Phase 4 (UI) completed successfully.
+// Usage: node check-phase-4-complete.mjs
+//
+// Always invoke via `node` (never as a bare executable) so this works on
+// Windows cmd/PowerShell as well as macOS/Linux/Git Bash.
+//
+// Exit 0 if complete, exit 1 with an error message if incomplete.
+
+import fs from "node:fs";
+import path from "node:path";
+
+const UIBUNDLES_DIR = path.join("force-app", "main", "default", "uiBundles");
+
+function findBundleDir() {
+  let entries;
+  try {
+    entries = fs.readdirSync(UIBUNDLES_DIR, { withFileTypes: true });
+  } catch {
+    return "";
+  }
+  const dirs = entries
+    .filter((e) => e.isDirectory())
+    .map((e) => e.name)
+    .sort();
+  return dirs.length > 0 ? path.join(UIBUNDLES_DIR, dirs[0]) : "";
+}
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function findTsxFiles(dir) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      out.push(...findTsxFiles(full));
+    } else if (entry.isFile() && entry.name.endsWith(".tsx")) {
+      out.push(full);
+    }
+  }
+  return out;
+}
+
+const bundleDir = findBundleDir();
+
+if (!bundleDir) {
+  fail("ERROR: Phase 4 cannot run: No UI bundle directory found (Phase 1 not complete)");
+}
+
+// Check Phase 1 scaffold prerequisites
+const packageJsonPath = path.join(bundleDir, "package.json");
+if (!fs.existsSync(packageJsonPath)) {
+  fail("ERROR: Phase 4 cannot run: No package.json found (Phase 1 not complete)");
+}
+
+let packageJsonContent = "";
+try {
+  packageJsonContent = fs.readFileSync(packageJsonPath, "utf8");
+} catch {
+  packageJsonContent = "";
+}
+
+if (!packageJsonContent.includes('"react"')) {
+  fail("ERROR: Phase 4 cannot run: React dependencies not installed in package.json");
+}
+
+// Check Phase 4 completion
+if (!fs.existsSync(path.join(bundleDir, "src", "App.tsx"))) {
+  fail(`ERROR: Phase 4 incomplete: No App.tsx found in ${path.join(bundleDir, "src")}${path.sep}`);
+}
+
+const pagesDir = path.join(bundleDir, "src", "pages");
+if (!fs.existsSync(pagesDir) || !fs.statSync(pagesDir).isDirectory()) {
+  fail(`ERROR: Phase 4 incomplete: No pages/ directory found in ${path.join(bundleDir, "src")}${path.sep}`);
+}
+
+if (findTsxFiles(pagesDir).length === 0) {
+  fail("ERROR: Phase 4 incomplete: No .tsx files found in pages/ directory");
+}
+
+if (!fs.existsSync(path.join(bundleDir, "dist", "index.html"))) {
+  fail("ERROR: Phase 4 incomplete: No dist/index.html found (build not complete)");
+}
+
+console.log("SUCCESS: Phase 4 complete: UI verified");
+process.exit(0);

package/skills/experience-ui-bundle-app-coordinate/scripts/check-phase-6-ready.mjs

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+// Verify Phase 6 (Deployment) prerequisites are met.
+// Usage: node check-phase-6-ready.mjs
+//
+// Always invoke via `node` (never as a bare executable) so this works on
+// Windows cmd/PowerShell as well as macOS/Linux/Git Bash.
+//
+// Exit 0 if ready, exit 1 with an error message if not ready.
+
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+
+const UIBUNDLES_DIR = path.join("force-app", "main", "default", "uiBundles");
+
+function findBundleDir() {
+  let entries;
+  try {
+    entries = fs.readdirSync(UIBUNDLES_DIR, { withFileTypes: true });
+  } catch {
+    return "";
+  }
+  const dirs = entries
+    .filter((e) => e.isDirectory())
+    .map((e) => e.name)
+    .sort();
+  return dirs.length > 0 ? path.join(UIBUNDLES_DIR, dirs[0]) : "";
+}
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+const bundleDir = findBundleDir();
+
+if (!bundleDir) {
+  fail("ERROR: Phase 6 cannot run: No UI bundle directory found (Phase 1 not complete)");
+}
+
+// Check build artifact exists
+if (!fs.existsSync(path.join(bundleDir, "dist", "index.html"))) {
+  fail("ERROR: Phase 6 cannot run: No dist/index.html found (Phase 4 build not complete)");
+}
+
+// Check org authentication
+// `shell: true` resolves `sf`/`sf.cmd` across macOS/Linux/Git Bash and native
+// Windows shells alike.
+const orgDisplay = spawnSync("sf", ["org", "display", "--json"], {
+  shell: true,
+  stdio: "ignore",
+});
+
+if (orgDisplay.status !== 0) {
+  fail("ERROR: Phase 6 cannot run: No authenticated org found (run: sf org login web)");
+}
+
+// Check hosting target is set
+const metaFiles = fs
+  .readdirSync(bundleDir)
+  .filter((name) => name.endsWith(".uibundle-meta.xml"));
+
+const hasTarget = metaFiles.some((name) => {
+  try {
+    return fs.readFileSync(path.join(bundleDir, name), "utf8").includes("<target>");
+  } catch {
+    return false;
+  }
+});
+
+if (!hasTarget) {
+  fail(
+    "ERROR: Phase 6 cannot run: .uibundle-meta.xml missing <target> element (Phase 1 not complete)",
+  );
+}
+
+console.log("SUCCESS: Phase 6 ready: All deployment prerequisites met");
+process.exit(0);

package/skills/experience-ui-bundle-app-coordinate/scripts/check-prerequisites.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+// Check prerequisites for UI Bundle app building.
+// Usage: node check-prerequisites.mjs
+//
+// Always invoke via `node` (never as a bare executable) so this works on
+// Windows cmd/PowerShell as well as macOS/Linux/Git Bash.
+//
+// Exit 0 if all prerequisites are met, exit 1 with an error message if any
+// are missing.
+
+const [major] = process.versions.node.split(".").map(Number);
+
+if (!Number.isFinite(major) || major < 20) {
+  console.error(
+    `ERROR: Node.js version ${process.versions.node} detected. Requires >= 20.x`,
+  );
+  process.exit(1);
+}
+
+console.log(`SUCCESS: Node.js v${process.versions.node} meets the >= 20.x requirement`);
+process.exit(0);

package/skills/experience-ui-bundle-app-coordinate/scripts/check-sfdx-project.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// Check if sfdx-project.json exists and is valid JSON.
+// Usage: node check-sfdx-project.mjs
+//
+// Always invoke via `node` (never as a bare executable) so this works on
+// Windows cmd/PowerShell as well as macOS/Linux/Git Bash.
+//
+// Exit 0 if sfdx-project.json exists and parses as JSON, exit 1 with an
+// error message otherwise.
+
+import fs from "node:fs";
+
+const SFDX_PROJECT = "sfdx-project.json";
+
+if (!fs.existsSync(SFDX_PROJECT)) {
+  console.error("ERROR: sfdx-project.json not found");
+  process.exit(1);
+}
+
+try {
+  JSON.parse(fs.readFileSync(SFDX_PROJECT, "utf8"));
+} catch {
+  console.error("ERROR: sfdx-project.json is not valid JSON");
+  process.exit(1);
+}
+
+console.log("sfdx-project.json is valid");
+process.exit(0);

package/skills/experience-ui-bundle-custom-app-generate/SKILL.md

@@ -8,6 +8,8 @@ metadata:
   relatedSkills:
     - "platform-custom-application-generate"
   cliTools:
+    - tool: ["node"]
+      semver: ">=18.0.0"
     - tool: ["sf"]
       semver: ">=2.0.0"
   mcpTools:
@@ -76,7 +78,7 @@ Use the default template in the doc below. Values in `{braces}` are resolved pro
 ### Step 5: Update UI Bundle Meta XML
 This step edits an **existing** file — it never creates a new one. `UIBundle` is a bundle-style metadata type: its meta XML normally lives inside its own folder at `uiBundles/{appName}/{appName}.uibundle-meta.xml`, alongside the bundle's other source files (e.g. `index.html`, `src/`). Some older or hand-authored projects may instead have it at the flat path `uiBundles/{appName}.uibundle-meta.xml` (no subfolder).
 
-Run `scripts/resolve-uibundle-path.sh "{appName}"` — it prints the path of the existing meta XML (preferring the nested layout, falling back to the flat layout). Edit that exact file in place; do not create a second file at the other path or migrate it to a different layout as part of this skill.
+Run `node scripts/resolve-uibundle-path.mjs "{appName}"` — it prints the path of the existing meta XML (preferring the nested layout, falling back to the flat layout). Always invoke via `node` (never as a bare executable) so this works on Windows as well as macOS/Linux. Edit that exact file in place; do not create a second file at the other path or migrate it to a different layout as part of this skill.
 
 If Step 2 confirmed the `target` field exists on `UIBundle`, add `<target>CustomApplication</target>` inside the existing `<UIBundle>` element of that file, preserving every other existing element and value untouched (skip this step entirely if the field doesn't exist in the org's API version — do not create the file or add `<target>` in that case).