@wix/agent-skills 1.35.1 → 1.36.1

package/skills/wix-replatform/resources/rp-target-wix/lib/write-verification.js

@@ -1,3 +0,0 @@
-'use strict';
-// Compatibility entry point; receipt comparison is shared runtime code.
-module.exports = require('../../../lib/write-verification');

package/skills/wix-replatform/resources/rp-target-wix/scripts/docs-survey-sync.js

@@ -1,150 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-// Fetch a domain's dev.wix.com docs menu(s) and sync
-// domains/<domain>/docs-survey.json. The script owns the surface list (id,
-// title, url, group); verdict fields are authored by hand and preserved
-// across syncs. New surfaces arrive as "unreviewed", which fails validation
-// until triaged; surfaces gone from the docs are marked "removed", which
-// also fails validation until the entry is deleted or its facts revisited.
-//
-// Usage: node docs-survey-sync.js <domain> [<domain>...]
-// Requires domains/<domain>/domain.json to declare docsRoots[] (paths under
-// https://dev.wix.com/docs/, e.g. "api-reference/business-solutions/events").
-
-const path = require('node:path');
-const fs = require('node:fs');
-const { knowledgeRoot, writeJson } = require('../lib/domain-knowledge.js');
-
-const DOCS_BASE = 'https://dev.wix.com/docs/';
-const HEADING_RE = /^(#{1,6}) \[([^\]]+)\]\((https:\/\/dev\.wix\.com\/docs\/[^)]+?)(?:\.md)?\)\s*$/;
-
-async function fetchMenuMarkdown(root) {
-  const url = `${DOCS_BASE}${root}.md`;
-  const response = await fetch(url, { redirect: 'follow' });
-  if (!response.ok) throw new Error(`GET ${url} -> HTTP ${response.status}`);
-  return response.text();
-}
-
-// A menu page lists its whole ancestry too (# Api Reference, ## Business
-// Solutions, ...). Only headings strictly below the fetched root are the
-// domain's own; among those, the surfaces are the deepest headings — the
-// ones with no child headings.
-function extractSurfaces(markdown, root) {
-  const headings = [];
-  let rootTitle = null;
-  for (const line of markdown.split('\n')) {
-    const match = line.match(HEADING_RE);
-    if (!match) continue;
-    const docsPath = match[3].slice(DOCS_BASE.length);
-    if (docsPath === root) rootTitle = match[2];
-    if (!docsPath.startsWith(`${root}/`)) continue;
-    headings.push({ level: match[1].length, title: match[2], docsPath });
-  }
-
-  // A flat tree (all methods as bullets, no sub-headings) is still one
-  // surface — the root itself. Never let a root vanish silently.
-  if (headings.length === 0) {
-    return [
-      {
-        id: root,
-        title: rootTitle || root.split('/').pop(),
-        url: `${DOCS_BASE}${root}`,
-        group: null,
-      },
-    ];
-  }
-
-  const surfaces = [];
-  for (let i = 0; i < headings.length; i += 1) {
-    const heading = headings[i];
-    const next = headings[i + 1];
-    const hasChildren = next && next.level > heading.level;
-    if (hasChildren) continue;
-    const group = [];
-    for (let j = i - 1, level = heading.level; j >= 0; j -= 1) {
-      if (headings[j].level < level) {
-        group.unshift(headings[j].title);
-        level = headings[j].level;
-      }
-    }
-    surfaces.push({
-      id: heading.docsPath,
-      title: heading.title,
-      url: `${DOCS_BASE}${heading.docsPath}`,
-      group: group.join(' › ') || null,
-    });
-  }
-  return surfaces;
-}
-
-function mergeSurvey(existing, domain, roots, fetched) {
-  const previous = new Map(((existing && existing.surfaces) || []).map((entry) => [entry.id, entry]));
-  const surfaces = fetched.map((surface) => {
-    const kept = previous.get(surface.id);
-    previous.delete(surface.id);
-    const verdictFields = kept
-      ? {
-          verdict: kept.verdict,
-          refs: kept.refs,
-          reason: kept.reason,
-          tracking: kept.tracking,
-          reviewedOn: kept.reviewedOn,
-        }
-      : { verdict: 'unreviewed' };
-    for (const key of Object.keys(verdictFields)) {
-      if (verdictFields[key] === undefined) delete verdictFields[key];
-    }
-    return { ...surface, ...verdictFields };
-  });
-  for (const gone of previous.values()) {
-    surfaces.push({ ...gone, removed: true });
-  }
-  surfaces.sort((a, b) => a.id.localeCompare(b.id));
-  return {
-    schemaVersion: 1,
-    domain,
-    fetchedAt: new Date().toISOString().slice(0, 10),
-    roots,
-    surfaces,
-  };
-}
-
-async function syncDomain(domainsDir, domain) {
-  const domainJsonPath = path.join(domainsDir, domain, 'domain.json');
-  const domainJson = JSON.parse(fs.readFileSync(domainJsonPath, 'utf8'));
-  const roots = domainJson.docsRoots;
-  if (!Array.isArray(roots) || roots.length === 0) {
-    throw new Error(`${domain}/domain.json has no docsRoots[]; declare the domain's docs menu roots first`);
-  }
-  const fetchedByRoot = await Promise.all(
-    roots.map((root) => fetchMenuMarkdown(root).then((md) => extractSurfaces(md, root))),
-  );
-  const fetched = fetchedByRoot.flat();
-
-  const surveyPath = path.join(domainsDir, domain, 'docs-survey.json');
-  const existing = fs.existsSync(surveyPath) ? JSON.parse(fs.readFileSync(surveyPath, 'utf8')) : null;
-  const survey = mergeSurvey(existing, domain, roots, fetched);
-  writeJson(surveyPath, survey);
-
-  const unreviewed = survey.surfaces.filter((s) => s.verdict === 'unreviewed').length;
-  const removed = survey.surfaces.filter((s) => s.removed).length;
-  process.stdout.write(
-    `${domain}: ${survey.surfaces.length} surfaces (${unreviewed} unreviewed, ${removed} removed) -> ${path.relative(process.cwd(), surveyPath)}\n`
-  );
-}
-
-async function main() {
-  const domains = process.argv.slice(2).filter((arg) => !arg.startsWith('--'));
-  if (domains.length === 0) {
-    process.stderr.write('Usage: docs-survey-sync.js <domain> [<domain>...]\n');
-    process.exit(2);
-  }
-  const domainsDir = knowledgeRoot(path.resolve(__dirname, '..'));
-  for (const domain of domains) await syncDomain(domainsDir, domain);
-}
-
-main().catch((error) => {
-  process.stderr.write(`ERROR: ${error.message}\n`);
-  process.exit(1);
-});

package/skills/wix-replatform/resources/rp-target-wix/scripts/domain-knowledge-validate.js

@@ -1,69 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const path = require('node:path');
-const { knowledgeRoot, validateKnowledge, writeJson, listMissingDependsOn, checkScope } = require('../lib/domain-knowledge.js');
-
-function main() {
-  const argv = process.argv.slice(2);
-  const args = new Set(argv);
-  const domainsDir = knowledgeRoot(path.resolve(__dirname, '..'));
-
-  if (args.has('--list-missing-deps')) {
-    // The live backlog — entities that have never had dependsOn authored at all.
-    // Non-blocking report, not a validation error; this is the thing to run instead of
-    // trusting a hand-maintained list to stay accurate.
-    const missing = listMissingDependsOn(domainsDir);
-    process.stdout.write(`${missing.length} entit${missing.length === 1 ? 'y has' : 'ies have'} no dependsOn yet:\n`);
-    for (const ref of missing) process.stdout.write(`  ${ref}\n`);
-    return;
-  }
-
-  const checkScopeIndex = argv.indexOf('--check-scope');
-  if (checkScopeIndex !== -1) {
-    // The rp-mapper review-gate check: pass only the plan's own selected scope — checkScope
-    // walks the transitive closure itself. --check-scope stores/product,gift-cards/gift-card,ecom/order
-    const inScopeRefs = (argv[checkScopeIndex + 1] || '').split(',').map((s) => s.trim()).filter(Boolean);
-    if (inScopeRefs.length === 0) {
-      process.stderr.write('ERROR: --check-scope requires a comma-separated list of domain/entity refs\n');
-      process.exit(1);
-    }
-    const result = checkScope(domainsDir, inScopeRefs);
-    if (result.ok) {
-      process.stdout.write('OK: every selected ref resolves, every reachable dependency is in scope, and every reachable entity has been reviewed\n');
-      return;
-    }
-    for (const ref of result.unknownRefs) {
-      process.stdout.write(`UNKNOWN: ${ref} does not resolve to a real domain/entity file\n`);
-    }
-    for (const { ref, missing } of result.missingDependencies) {
-      process.stdout.write(`MISSING: ${ref} depends on ${missing.join(', ')}, not in scope for this plan\n`);
-    }
-    for (const ref of result.unreviewedRefs) {
-      process.stdout.write(`UNREVIEWED: ${ref} is reachable from this scope but has never had dependsOn authored\n`);
-    }
-    process.exit(1);
-  }
-
-  const result = validateKnowledge(domainsDir);
-
-  if (args.has('--write-index')) {
-    writeJson(path.join(domainsDir, 'index.json'), result.generatedIndex);
-    const afterWrite = validateKnowledge(domainsDir);
-    if (!afterWrite.ok) {
-      for (const error of afterWrite.errors) process.stderr.write(`ERROR: ${error}\n`);
-      process.exit(1);
-    }
-    process.stdout.write('OK: domain knowledge index regenerated and valid\n');
-    return;
-  }
-
-  if (!result.ok) {
-    for (const error of result.errors) process.stderr.write(`ERROR: ${error}\n`);
-    process.exit(1);
-  }
-
-  process.stdout.write('OK: domain knowledge valid\n');
-}
-
-main();

package/skills/wix-replatform/resources/rp-target-wix/scripts/domain-knowledge.js

@@ -1,100 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const path = require('node:path');
-const {
-  knowledgeRoot,
-  listDomains,
-  listEntities,
-  readEntityByRef,
-  resolveSource,
-  listFlagged,
-  summarizeEntities,
-} = require('../lib/domain-knowledge.js');
-
-function usage() {
-  return [
-    'Usage:',
-    '  node scripts/domain-knowledge.js list-domains',
-    '  node scripts/domain-knowledge.js list-entities --domain stores',
-    '  node scripts/domain-knowledge.js read-entity --ref stores/product',
-    '  node scripts/domain-knowledge.js resolve-source --source-system woocommerce --source-entity product',
-    '  node scripts/domain-knowledge.js resolve-source --route /wc/v3/products',
-    '  node scripts/domain-knowledge.js list-flagged --flag IMPORT_UNRELIABLE',
-    '  node scripts/domain-knowledge.js summarize-entities --refs stores/product,ecom/order [--include-evidence]',
-  ].join('\n');
-}
-
-function parseArgs(argv) {
-  const args = { _: [] };
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg.startsWith('--')) {
-      const key = arg.slice(2).replace(/-([a-z])/g, (_, char) => char.toUpperCase());
-      const next = argv[i + 1];
-      if (!next || next.startsWith('--')) {
-        args[key] = true;
-      } else {
-        args[key] = next;
-        i += 1;
-      }
-    } else {
-      args._.push(arg);
-    }
-  }
-  return args;
-}
-
-function print(value, pretty) {
-  process.stdout.write(`${JSON.stringify(value, null, pretty ? 2 : 0)}\n`);
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const command = args._[0];
-  const domainsDir = knowledgeRoot(path.resolve(__dirname, '..'));
-
-  if (!command || args.help) {
-    process.stderr.write(`${usage()}\n`);
-    process.exit(command ? 0 : 1);
-  }
-
-  let output;
-  if (command === 'list-domains') {
-    output = { domains: listDomains(domainsDir) };
-  } else if (command === 'list-entities') {
-    if (!args.domain) throw new Error('--domain is required');
-    output = { domain: args.domain, entities: listEntities(domainsDir, args.domain) };
-  } else if (command === 'read-entity') {
-    if (!args.ref) throw new Error('--ref is required');
-    output = readEntityByRef(domainsDir, args.ref);
-  } else if (command === 'resolve-source') {
-    output = {
-      matches: resolveSource(domainsDir, {
-        sourceSystem: args.sourceSystem,
-        sourceEntity: args.sourceEntity,
-        route: args.route,
-      }),
-    };
-  } else if (command === 'list-flagged') {
-    if (!args.flag) throw new Error('--flag is required');
-    output = { flag: args.flag, entities: listFlagged(domainsDir, args.flag) };
-  } else if (command === 'summarize-entities') {
-    if (!args.refs) throw new Error('--refs is required');
-    output = {
-      entities: summarizeEntities(domainsDir, args.refs.split(',').filter(Boolean), {
-        includeEvidence: Boolean(args.includeEvidence),
-      }),
-    };
-  } else {
-    throw new Error(`Unknown command: ${command}\n${usage()}`);
-  }
-  print(output, Boolean(args.pretty));
-}
-
-try {
-  main();
-} catch (error) {
-  process.stderr.write(`${error.message}\n`);
-  process.exit(1);
-}

package/skills/wix-replatform/resources/rp-target-wix/scripts/verify-stores.js

@@ -1,112 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-const { startDevProbe } = require('../../../lib/execution-capability');
-
-const fs = require('fs');
-const path = require('path');
-const w = require('../lib/wix-writers');
-const verify = require('../lib/stores-verification');
-const {
-  createContractLedgerProposalFromStoresVerification,
-  writeProposal,
-} = require('../lib/contract-ledger');
-
-function usage() {
-  console.error(`Usage:
-  node scripts/verify-stores.js stores subscription-create --artifact <file> [--proposal-artifact <file>] [--marker <id>] [--no-cleanup]
-  node scripts/verify-stores.js stores inventory-import --env <test-target-config> --artifact <file>
-  node scripts/verify-stores.js stores product-count --artifact <file>
-  node scripts/verify-stores.js stores product-by-source-marker --marker-path <path> --marker-value <value> --artifact <file>
-  node scripts/verify-stores.js stores delete-probe --product-id <id> --artifact <file>
-
-Credentials:
-  WIX_AUTH_TOKEN and WIX_SITE_ID must be set in the environment.`);
-}
-
-function parseArgs(argv) {
-  const args = [...argv];
-  if (args[0] === 'verify') args.shift();
-  if (args[0] !== 'stores') {
-    usage();
-    process.exit(2);
-  }
-  args.shift();
-  const command = args.shift();
-  const options = {};
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === '--no-cleanup') {
-      options.cleanup = false;
-    } else if (arg.startsWith('--')) {
-      options[arg.slice(2).replace(/-([a-z])/g, (_, c) => c.toUpperCase())] = args[++i];
-    } else {
-      throw new Error(`unexpected argument: ${arg}`);
-    }
-  }
-  return { command, options };
-}
-
-function loadEnvFile(file) {
-  if (!file || !fs.existsSync(file)) return;
-  const text = fs.readFileSync(file, 'utf8');
-  for (const line of text.split(/\r?\n/)) {
-    const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)=(.*)\s*$/);
-    if (!match || process.env[match[1]]) continue;
-    process.env[match[1]] = match[2].replace(/^['"]|['"]$/g, '');
-  }
-}
-
-(async () => {
-  const { command, options } = parseArgs(process.argv.slice(2));
-  loadEnvFile(options.env || path.join(process.cwd(), 'config/wix.env'));
-  const authToken = process.env.WIX_AUTH_TOKEN;
-  const siteId = process.env.WIX_SITE_ID;
-  if (!authToken || !siteId) throw new Error('WIX_AUTH_TOKEN and WIX_SITE_ID are required');
-  const wix = w.createWixClient({ authToken, capability: startDevProbe({ siteId, confirmation: process.env.RP_SENTINEL_CONFIRM }) });
-  const common = { wix, siteId, artifactPath: options.artifact };
-
-  let result;
-  if (command === 'subscription-create') {
-    result = await verify.verifyStoresSubscriptionCreate({
-      ...common,
-      marker: options.marker,
-      cleanup: options.cleanup !== false,
-    });
-    if (options.proposalArtifact) {
-      result.artifactPath = options.artifact ? path.resolve(options.artifact) : null;
-      const proposal = createContractLedgerProposalFromStoresVerification(result);
-      proposal.sourceVerification.artifactPath = result.artifactPath;
-      writeProposal(options.proposalArtifact, proposal);
-      result.contractLedgerProposal = {
-        path: path.resolve(options.proposalArtifact),
-        status: proposal.status,
-        proposalId: proposal.proposalId,
-      };
-      if (options.artifact) {
-        fs.writeFileSync(options.artifact, `${JSON.stringify(result, null, 2)}\n`);
-      }
-    }
-  } else if (command === 'inventory-import') {
-    if (!options.artifact) throw new Error('inventory-import requires --artifact for recovery and verification evidence');
-    result = await verify.verifyStoresInventoryImport(common);
-  } else if (command === 'product-count') {
-    result = await verify.verifyStoresProductCount(common);
-  } else if (command === 'product-by-source-marker') {
-    result = await verify.verifyStoresProductBySourceMarker({
-      ...common,
-      markerPath: options.markerPath,
-      markerValue: options.markerValue,
-    });
-  } else if (command === 'delete-probe') {
-    result = await verify.verifyStoresDeleteProbe({ ...common, productId: options.productId });
-  } else {
-    usage();
-    process.exit(2);
-  }
-
-  console.log(JSON.stringify(result, null, 2));
-  process.exit(result.status === 'passed' ? 0 : 1);
-})().catch((error) => {
-  console.error(error && error.message ? error.message : error);
-  process.exit(1);
-});