@wix/agent-skills 1.36.0 → 1.36.1

package/skills/wix-replatform/lib/operator-identity.js

@@ -1,47 +0,0 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-const os = require('node:os');
-const {
-  execFileSync
-} = require('node:child_process');
-const GUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function resolveOperatorIdentity({
-  accountFile = path.join(os.homedir(), '.wix/auth/account.json'),
-  readFile = fs.readFileSync
-} = {}) {
-  try {
-    const id = JSON.parse(readFile(accountFile, 'utf8'))?.userInfo?.userId;
-    return typeof id === 'string' && GUID.test(id) ? id : null;
-  } catch {
-    return null;
-  }
-}
-function requireOperatorIdentity({
-  whoami = () => execFileSync('wix', ['whoami'], {
-    encoding: 'utf8',
-    timeout: 10000,
-    stdio: ['ignore', 'pipe', 'ignore']
-  }),
-  now = () => new Date().toISOString(),
-  ...options
-} = {}) {
-  const userId = resolveOperatorIdentity(options);
-  let displayName;
-  try {
-    displayName = whoami()?.trim();
-  } catch {/* fail closed below */}
-  if (!userId || !displayName) throw new Error('Authenticated Wix user GUID and non-empty wix whoami identity required for approval');
-  return {
-    userId,
-    displayName,
-    source: 'wix-cli-session',
-    observedAt: now()
-  };
-}
-module.exports = {
-  GUID,
-  resolveOperatorIdentity,
-  requireOperatorIdentity
-};

package/skills/wix-replatform/lib/orchestration-decisions.js

@@ -1,248 +0,0 @@
-'use strict';
-
-const DECISION_ALIASES = {
-  sourceUrl: ['sourceSiteUrl', 'sourceUrl'],
-  sourceMode: ['sourceMode', 'sourceAcquisitionMode'],
-  targetSiteStrategy: ['targetSiteStrategy', 'destinationStrategy'],
-  deliveryMode: ['deliveryMode'],
-  automationMode: ['automationMode', 'interactionMode', 'runMode'],
-  websiteScope: ['websiteScope', 'frontendScope'],
-  faceliftMode: ['faceliftMode', 'facelift'],
-  fileInputPaths: ['fileInputPaths'],
-  sourcePlatform: ['sourcePlatform'],
-  sourceCredentialRef: ['sourceCredentialRef'],
-  managementImportMode: ['managementImportMode', 'importMode'],
-  includeAdditionalFiles: ['includeAdditionalFiles'],
-  targetSiteType: ['targetSiteType'],
-  targetSiteBusinessType: ['targetSiteBusinessType'],
-  editorWebsiteDecision: ['editorWebsiteDecision'],
-};
-
-function readDecisionValue(decisions, keys) {
-  for (const key of keys) {
-    const entry = decisions && decisions[key];
-    if (entry && Object.prototype.hasOwnProperty.call(entry, 'value') && entry.value != null) {
-      return entry.value;
-    }
-  }
-  return null;
-}
-
-function getDecisionEntry(decisions, canonicalKey) {
-  const keys = DECISION_ALIASES[canonicalKey] || [canonicalKey];
-  for (const key of keys) {
-    const entry = decisions && decisions[key];
-    if (entry && Object.prototype.hasOwnProperty.call(entry, 'value') && entry.value != null) {
-      return entry;
-    }
-  }
-  return null;
-}
-
-// The only sourceMode values the router and preflight understand. Anything else is an
-// intake error: an unknown mode must never fall through to the public credential set.
-const CANONICAL_SOURCE_MODES = Object.freeze(['private_data', 'public_content', 'files_only']);
-
-// `authenticated_api` is an alias because preflight already treats it as private mode.
-const SOURCE_MODE_ALIASES = Object.freeze({
-  private_authenticated: 'private_data',
-  public_content_only: 'public_content',
-  authenticated_api: 'private_data',
-});
-
-// Decision keys that record sourceMode (see DECISION_ALIASES.sourceMode).
-const SOURCE_MODE_DECISION_KEYS = Object.freeze([...DECISION_ALIASES.sourceMode]);
-
-// Returns the canonical mode for a known value or alias, and the raw value otherwise.
-// Never throws: callers check validity with isKnownSourceMode().
-function normalizeSourceMode(value) {
-  if (value == null) return null;
-  if (typeof value === 'string' && Object.prototype.hasOwnProperty.call(SOURCE_MODE_ALIASES, value)) {
-    return SOURCE_MODE_ALIASES[value];
-  }
-  return value;
-}
-
-function isKnownSourceMode(value) {
-  if (typeof value !== 'string') return false;
-  return CANONICAL_SOURCE_MODES.includes(value) || Object.prototype.hasOwnProperty.call(SOURCE_MODE_ALIASES, value);
-}
-
-function invalidSourceModeMessage(value) {
-  const aliases = Object.entries(SOURCE_MODE_ALIASES).map(([alias, target]) => `${alias} -> ${target}`).join(', ');
-  return `invalid sourceMode ${JSON.stringify(value)}; use one of ${CANONICAL_SOURCE_MODES.join(', ')} (aliases: ${aliases})`;
-}
-
-function normalizeTargetSiteStrategy(value) {
-  if (value == null) return null;
-  switch (value) {
-    case 'new':
-      return 'new_site';
-    case 'existing':
-      return 'existing_site';
-    default:
-      return value;
-  }
-}
-
-function normalizeAutomationMode(value) {
-  if (value == null) return null;
-  switch (value) {
-    case '1-click':
-    case '1click':
-    case 'one-click':
-    case 'one_click':
-      return 'one_click';
-    case 'manual':
-      return 'manual';
-    default:
-      return value;
-  }
-}
-
-function normalizeDeliveryMode(value) {
-  if (value == null) return null;
-  switch (String(value).trim().toLowerCase()) {
-    case 'both':
-    case 'management+website':
-    case 'management_and_website':
-      return 'management_and_website';
-    case 'management':
-    case 'website':
-      return String(value).trim().toLowerCase();
-    default:
-      return value;
-  }
-}
-
-function normalizeManagementImportMode(value) {
-  if (value == null) return null;
-  switch (String(value).trim().toLowerCase()) {
-    case 'quick':
-    case 'quick_mode':
-      return 'quick';
-    case 'standard':
-    case 'normal':
-      return 'standard';
-    default:
-      return value;
-  }
-}
-
-function normalizeFaceliftMode(value) {
-  if (value === true) return 'requested';
-  if (value === false || value == null) return 'off';
-  return ['requested', 'facelift', 'on', 'true'].includes(String(value).trim().toLowerCase()) ? 'requested' : 'off';
-}
-
-function getDecisionValue(decisions, canonicalKey) {
-  const keys = DECISION_ALIASES[canonicalKey] || [canonicalKey];
-  const value = readDecisionValue(decisions, keys);
-  if (canonicalKey === 'sourceMode') {
-    return normalizeSourceMode(value);
-  }
-  if (canonicalKey === 'targetSiteStrategy') {
-    return normalizeTargetSiteStrategy(value);
-  }
-  if (canonicalKey === 'automationMode') {
-    return normalizeAutomationMode(value);
-  }
-  if (canonicalKey === 'deliveryMode') {
-    return normalizeDeliveryMode(value);
-  }
-  if (canonicalKey === 'managementImportMode') {
-    return normalizeManagementImportMode(value);
-  }
-  if (canonicalKey === 'faceliftMode') return normalizeFaceliftMode(value);
-  return value;
-}
-
-// The destination site type is an explicit operator choice for a new site.
-// "editor" is deliberately not a value: it is an incomplete answer until Studio or Harmony
-// is known, and the classic Wix Editor is not a supported choice.
-const SITE_TYPES = Object.freeze(['headless', 'studio', 'harmony']);
-const EDITOR_SITE_TYPES = Object.freeze(['studio', 'harmony']);
-const SITE_BUSINESS_TYPES = Object.freeze(['store', 'bookings', 'other', 'unknown']);
-const SITE_BUSINESS_TYPE_SOURCES = Object.freeze(['user', 'context', 'not_asked']);
-
-// The one site-type request's choice ids, each mapped to the decision pair it records.
-const SITE_TYPE_CHOICES = Object.freeze({
-  headless: { siteType: 'headless', businessType: null },
-  studio: { siteType: 'studio', businessType: null },
-  harmony_store: { siteType: 'harmony', businessType: 'store' },
-  harmony_bookings: { siteType: 'harmony', businessType: 'bookings' },
-  harmony_other: { siteType: 'harmony', businessType: 'other' },
-  harmony: { siteType: 'harmony', businessType: 'unknown' },
-});
-
-function isNewSiteStrategy(value) {
-  return normalizeTargetSiteStrategy(value) === 'new_site';
-}
-
-function isEditorSiteType(value) {
-  return EDITOR_SITE_TYPES.includes(value);
-}
-
-// Returns the persisted pair, or null when no type is recorded. `errors` names a recorded
-// value the router must not act on (unknown type, Harmony without its business type, or a
-// business type recorded for a non-Harmony site).
-function readSiteTypeDecision(decisions) {
-  const typeEntry = getDecisionEntry(decisions, 'targetSiteType');
-  const businessEntry = getDecisionEntry(decisions, 'targetSiteBusinessType');
-  if (!typeEntry) {
-    return businessEntry
-      ? { siteType: null, businessType: null, errors: ['targetSiteBusinessType is recorded without targetSiteType'] }
-      : null;
-  }
-  const errors = [];
-  const siteType = typeEntry.value;
-  if (!SITE_TYPES.includes(siteType)) errors.push(`targetSiteType must be one of ${SITE_TYPES.join(', ')} (got ${JSON.stringify(siteType)})`);
-  let businessType = null;
-  let businessTypeSource = null;
-  if (businessEntry) {
-    businessType = businessEntry.value;
-    businessTypeSource = businessEntry.source;
-    if (siteType !== 'harmony') errors.push('targetSiteBusinessType is valid only with targetSiteType=harmony');
-    if (!SITE_BUSINESS_TYPES.includes(businessType)) errors.push(`targetSiteBusinessType must be one of ${SITE_BUSINESS_TYPES.join(', ')} (got ${JSON.stringify(businessType)})`);
-    if (!SITE_BUSINESS_TYPE_SOURCES.includes(businessTypeSource)) errors.push(`targetSiteBusinessType source must be one of ${SITE_BUSINESS_TYPE_SOURCES.join(', ')}`);
-  } else if (siteType === 'harmony') {
-    errors.push('targetSiteType=harmony requires targetSiteBusinessType in the same decision write');
-  }
-  return {
-    siteType,
-    businessType,
-    businessTypeSource,
-    businessTypeEvidenceRef: businessEntry && businessEntry.evidenceRef ? businessEntry.evidenceRef : null,
-    errors,
-  };
-}
-
-function isExplicitUserOneClick(decisions) {
-  const entry = getDecisionEntry(decisions, 'automationMode');
-  return Boolean(entry && entry.source === 'user' && normalizeAutomationMode(entry.value) === 'one_click');
-}
-
-module.exports = {
-  EDITOR_SITE_TYPES,
-  SITE_BUSINESS_TYPES,
-  SITE_BUSINESS_TYPE_SOURCES,
-  SITE_TYPE_CHOICES,
-  SITE_TYPES,
-  isEditorSiteType,
-  isNewSiteStrategy,
-  readSiteTypeDecision,
-  CANONICAL_SOURCE_MODES,
-  SOURCE_MODE_ALIASES,
-  SOURCE_MODE_DECISION_KEYS,
-  invalidSourceModeMessage,
-  isKnownSourceMode,
-  getDecisionEntry,
-  getDecisionValue,
-  isExplicitUserOneClick,
-  normalizeAutomationMode,
-  normalizeDeliveryMode,
-  normalizeManagementImportMode,
-  normalizeFaceliftMode,
-  normalizeSourceMode,
-  normalizeTargetSiteStrategy,
-};