@wix/agent-skills 1.35.1 → 1.36.1

package/skills/wix-replatform/lib/expectations-ledger.js

@@ -1,96 +0,0 @@
-'use strict';
-
-const fs = require('node:fs/promises');
-const path = require('node:path');
-
-const LEDGER_FILE = 'EXPECTATIONS.md';
-
-const STARTER = `# Migration expectations
-
-Use this file to record anything you expected the migration to do differently: a
-surprising question, a mapping you expected, or an outcome that did not match your
-intent. Write freely anywhere in this document.
-
-You can also tell the agent: \`add to expectations: <your note>\`. It will preserve
-your note and add safe references to the current migration context. Do not put passwords,
-tokens, customer data, or other secrets here.
-`;
-
-function ledgerPath(projectDir) {
-  return path.join(path.resolve(projectDir), LEDGER_FILE);
-}
-
-async function ensureLedger(projectDir) {
-  const file = ledgerPath(projectDir);
-  await fs.mkdir(path.dirname(file), { recursive: true });
-  try {
-    await fs.writeFile(file, STARTER, { encoding: 'utf8', flag: 'wx' });
-    return { file, created: true };
-  } catch (error) {
-    if (error.code === 'EEXIST') return { file, created: false };
-    throw error;
-  }
-}
-
-function redactSensitiveText(value) {
-  return String(value || '')
-    .replace(/\b(bearer)\s+[A-Za-z0-9._~+/=-]{8,}/gi, '$1 [REDACTED]')
-    .replace(/\b(password|passwd|secret|token|api[-_ ]?key|authorization|cookie)\b\s*([:=])\s*[^\s,;]+/gi, '$1$2[REDACTED]');
-}
-
-function safeArtifactRef(projectDir, ref) {
-  if (!ref) return null;
-  const root = path.resolve(projectDir);
-  const candidate = path.resolve(root, ref);
-  const relative = path.relative(root, candidate);
-  if (relative.startsWith('..') || path.isAbsolute(relative)) return null;
-  return relative || '.';
-}
-
-function nextId(contents) {
-  const ids = [...contents.matchAll(/^##\s+E-(\d+)\b/gm)].map((match) => Number(match[1]));
-  return `E-${String((ids.length ? Math.max(...ids) : 0) + 1).padStart(3, '0')}`;
-}
-
-function formatContext(projectDir, context = {}) {
-  const lines = [];
-  for (const [label, value] of [
-    ['Stage', context.phase],
-    ['State', context.state],
-    ['Active resource', context.resource],
-    ['Source', context.source],
-    ['Target', context.target],
-    ['Decision or approval', context.decision],
-  ]) {
-    if (value) lines.push(`- ${label}: ${redactSensitiveText(value)}`);
-  }
-  for (const ref of context.artifactRefs || []) {
-    const safeRef = safeArtifactRef(projectDir, ref);
-    if (safeRef) lines.push(`- Artifact: \`${safeRef}\``);
-  }
-  return lines.length ? lines.join('\n') : '- No reliable run context was available when this was captured.';
-}
-
-async function appendExpectation(projectDir, expectation, context = {}, now = new Date()) {
-  if (!String(expectation || '').trim()) throw new Error('expectation is required');
-  const { file } = await ensureLedger(projectDir);
-  const contents = await fs.readFile(file, 'utf8');
-  const id = nextId(contents);
-  const original = String(expectation).trim();
-  const note = redactSensitiveText(original).trim();
-  const heading = note === original ? 'User expectation (verbatim)' : 'User expectation (sensitive values redacted)';
-  const entry = `\n## ${id} — ${now.toISOString()}\n\n### ${heading}\n\n${note}\n\n### Context captured by the agent\n\n${formatContext(projectDir, context)}\n`;
-  await fs.appendFile(file, entry, 'utf8');
-  return { file, id, redacted: note !== original };
-}
-
-module.exports = {
-  LEDGER_FILE,
-  STARTER,
-  ledgerPath,
-  ensureLedger,
-  redactSensitiveText,
-  safeArtifactRef,
-  nextId,
-  appendExpectation,
-};

package/skills/wix-replatform/lib/generated-plugin-handoff.js

@@ -1,140 +0,0 @@
-'use strict';
-
-// Exact generated wiring, not a JavaScript analyzer. Configuration comes from the
-// canonical source/mapping artifacts, never from generated --describe output.
-const fs = require('node:fs');
-const path = require('node:path');
-const crypto = require('node:crypto');
-const VERSION = 1;
-const FILES = ['src/import/plugin-handoff.js', 'src/import/run-import.js', 'src/extract/run-extract.js'];
-const HELPERS = ['plugin-entity-read-plan.js', 'structure-bridge-reader.js', 'wix-wp-plugin-v2-client.js'];
-const digest = (bytes) => crypto.createHash('sha256').update(bytes).digest('hex');
-function canonicalEntities(projectDir) {
-  const read = (name) => fs.existsSync(path.join(projectDir, name)) ? JSON.parse(fs.readFileSync(path.join(projectDir, name), 'utf8')) : {};
-  const schema = read('source-schema.json');
-  const mapping = read('mapping/mapping-plan.json');
-  const rows = (value) => Array.isArray(value) ? value : Object.entries(value || {}).filter(([, row]) => row && typeof row === 'object').map(([key, row]) => ({ sourceEntityRef: key, ...row }));
-  const sources = rows(schema.entities);
-  const decisions = require('./website-handoff.js').readEntityMappings(mapping);
-  const referenceOf = (row) => row.sourceEntityRef || row.ref || row.entity || row.sourceEntity || row.entityKey || (typeof row.source === 'string' ? row.source : null);
-  const planned = new Set(decisions.filter((row) => row.targetRef && !['excluded', 'declined', 'pending', 'deferred', 'manual', 'blocked', 'unsupported'].includes(row.status))
-    .map((row) => referenceOf(row)));
-  const combined = new Map(sources.map((row) => [referenceOf(row), row]));
-  for (const decision of decisions) {
-    const key = referenceOf(decision);
-    if (!key) throw new Error('mapping entity lacks identity');
-    const source = combined.get(key) || {};
-    combined.set(key, { ...source, ...decision, sourceMeta: { ...decision.sourceMeta, ...source.sourceMeta } });
-  }
-  return [...combined].filter(([key]) => key).map(([key, row]) => ({
-    sourceEntityRef: key, sourceEntity: row.sourceEntity || row.entityKey || row.entity || (typeof row.source === 'string' ? row.source : key),
-    sourceType: row.sourceType || null,
-    sourceTypes: row.sourceTypes || null,
-    bridgeDesignated: Boolean(row.bridgeDesignated || row.sourceMeta?.extractionPlan || row.fulfillment?.kind === 'structure-bridge-plugin'),
-    sourceMeta: row.sourceMeta?.extractionPlan ? { extractionPlan: row.sourceMeta.extractionPlan } : {},
-    sourcePrerequisites: row.sourcePrerequisites || [],
-    importPlanned: planned.has(key),
-  })).sort((a, b) => a.sourceEntityRef.localeCompare(b.sourceEntityRef));
-}
-function templates(entities) {
-  const config = JSON.stringify({ version: VERSION, entities }, null, 2);
-  const wiring = `'use strict';\nconst runtime = require('../lib/plugin-entity-read-plan.js');\nconst config = ${config};\nmodule.exports = { config, run: (kind, projectDir, args) => runtime.runGeneratedPluginEntrypoint({ kind, projectDir, entities: config.entities }, args) };\n`;
-  const entry = (kind, directory) => `'use strict';\nconst path = require('node:path');\nconst handoff = require('${directory}plugin-handoff.js');\nhandoff.run('${kind}', path.resolve(__dirname, '../..'), process.argv.slice(2)).catch((error) => { console.error(error.message); process.exitCode = 1; });\n`;
-  return { [FILES[0]]: wiring, [FILES[1]]: entry('import', './'), [FILES[2]]: entry('extract', '../import/') };
-}
-function moduleSourceDir() { return path.resolve(__dirname, '../resources/rp-source-wordpress/lib'); }
-function vendorSharedDependencies(projectDir) {
-  const visited = new Set();
-  function copy(file) {
-    if (visited.has(file)) return;
-    visited.add(file);
-    const source = fs.readFileSync(file, 'utf8');
-    const destination = noSymlinks(projectDir, `src/lib/${path.basename(file)}`);
-    fs.mkdirSync(path.dirname(destination), { recursive: true });
-    fs.copyFileSync(file, destination);
-    for (const match of source.matchAll(/require\(['"](.\/[^'"]+)['"]\)/g)) copy(require.resolve(path.resolve(path.dirname(file), match[1])));
-  }
-  copy(path.join(__dirname, 'import-recovery.js'));
-  copy(path.join(__dirname, 'import-readiness-contract.js'));
-}
-function noSymlinks(projectDir, relativePath) {
-  let cursor = path.resolve(projectDir);
-  for (const token of relativePath.split('/')) {
-    cursor = path.join(cursor, token);
-    if (fs.existsSync(cursor) && fs.lstatSync(cursor).isSymbolicLink()) throw new Error('generated handoff symlink refused');
-  }
-  return cursor;
-}
-function validateDispatchMapping(projectDir) {
-  const file = path.join(projectDir, 'mapping/mapping-plan.json');
-  const mapping = fs.existsSync(file) ? JSON.parse(fs.readFileSync(file, 'utf8')) : {};
-  const rows = require('./website-handoff.js').readEntityMappings(mapping);
-  for (const row of rows) {
-    if (!row.targetRef && !['excluded', 'declined', 'pending', 'deferred', 'manual', 'blocked', 'unsupported'].includes(row.status)) {
-      throw new Error('mapping targetRef is missing; normalize the declared legacy target before emitting dispatch, never drop its scope');
-    }
-  }
-}
-function emitPluginHandoff(projectDir) {
-  const entities = canonicalEntities(projectDir);
-  validateDispatchMapping(projectDir);
-  if (!entities.some((entity) => entity.bridgeDesignated)) throw new Error('no canonical bridge entities');
-  const emitted = templates(entities);
-  // Inspect every destination before any mutation. Existing project entrypoints must be
-  // deliberately adapted, never silently replaced by adding one bridge entity.
-  for (const [name, expected] of Object.entries(emitted)) {
-    const file = noSymlinks(projectDir, name);
-    if (!fs.existsSync(file)) continue;
-    const existing = fs.readFileSync(file, 'utf8');
-    let owned = existing === expected;
-    if (!owned && name === FILES[0]) {
-      try {
-        const match = existing.match(/const config = ([\s\S]*?);\nmodule.exports =/);
-        const config = JSON.parse(match[1]);
-        owned = config.version === VERSION && existing === templates(config.entities)[name];
-      } catch { /* Unrecognized wiring belongs to the project. */ }
-    }
-    if (!owned) throw new Error(`refusing to overwrite non-template entrypoint: ${name}; preserve its ordering, self-check, heartbeat and ledger in the project adapter before deliberately replacing it`);
-  }
-  for (const [name, text] of Object.entries(emitted)) {
-    const file = noSymlinks(projectDir, name);
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.writeFileSync(file, text);
-  }
-  for (const helper of HELPERS) {
-    const file = noSymlinks(projectDir, `src/lib/${helper}`);
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.copyFileSync(path.join(moduleSourceDir(), helper), file);
-  }
-  vendorSharedDependencies(projectDir);
-  return { version: VERSION, files: FILES };
-}
-function verifyPluginHandoff(projectDir, selection = {}) {
-  const entities = canonicalEntities(projectDir);
-  const selected = require(path.join(moduleSourceDir(), 'plugin-entity-read-plan.js')).selectPluginEntities(entities, selection);
-  const byRef = new Map(entities.map((entity) => [entity.sourceEntityRef, entity]));
-  const closure = new Map();
-  const visit = (entity, stack = new Set()) => {
-    if (stack.has(entity.sourceEntityRef)) throw new Error('cyclic source prerequisites');
-    if (closure.has(entity.sourceEntityRef)) return;
-    closure.set(entity.sourceEntityRef, entity);
-    for (const ref of entity.sourcePrerequisites) {
-      const source = byRef.get(ref);
-      if (!source) throw new Error('missing canonical source prerequisite');
-      visit(source, new Set([...stack, entity.sourceEntityRef]));
-    }
-  };
-  selected.forEach((entity) => visit(entity));
-  if (![...closure.values()].some((entity) => entity.bridgeDesignated)) return { applicable: false, entities: [] };
-  validateDispatchMapping(projectDir);
-  for (const [name, expected] of Object.entries(templates(entities))) {
-    const file = noSymlinks(projectDir, name);
-    if (!fs.existsSync(file) || fs.readFileSync(file, 'utf8') !== expected) throw new Error(`generated plugin handoff differs from committed template: ${name}`);
-  }
-  for (const helper of HELPERS) {
-    const file = noSymlinks(projectDir, `src/lib/${helper}`);
-    if (!fs.existsSync(file) || digest(fs.readFileSync(file)) !== digest(fs.readFileSync(path.join(moduleSourceDir(), helper)))) throw new Error(`changed vendored plugin helper: ${helper}`);
-  }
-  return { applicable: true, entities: [...closure.values()] };
-}
-module.exports = { VERSION, FILES, HELPERS, canonicalEntities, emitPluginHandoff, verifyPluginHandoff, templates };

package/skills/wix-replatform/lib/import-readiness-contract.js

@@ -1,23 +0,0 @@
-'use strict';
-const fs = require('node:fs');
-const path = require('node:path');
-function files(root) {
-  if (!fs.existsSync(root)) return [];
-  return fs.readdirSync(root, { withFileTypes: true }).flatMap(entry => entry.isDirectory() ? files(path.join(root, entry.name)) : /\.[cm]?js$/.test(entry.name) ? [path.join(root, entry.name)] : []);
-}
-function verifyReadinessContract(projectDir, descriptor) {
-  const manifest = JSON.parse(fs.readFileSync(path.join(projectDir, 'execution/execution-manifest.json'), 'utf8'));
-  const expected = manifest.tasks.filter(task => task.kind === 'import').map(task => ({ taskId: task.id, edges: task.dependencyEdges.map(({ ref, mode }) => ({ ref, mode })).sort((a, b) => a.ref.localeCompare(b.ref)) })).sort((a, b) => a.taskId.localeCompare(b.taskId));
-  const reported = descriptor.dependencyReadiness?.tasks?.map(task => ({ taskId: task.taskId, edges: task.edges.map(({ ref, mode }) => ({ ref, mode })).sort((a, b) => a.ref.localeCompare(b.ref)) })).sort((a, b) => a.taskId.localeCompare(b.taskId));
-  const errors = [];
-  if (JSON.stringify(expected) !== JSON.stringify(reported)) errors.push('dependency_readiness_descriptor_mismatch');
-  for (const file of files(path.join(projectDir, 'src')).filter(file => !/^(?:lib|extract)[/\\]/.test(path.relative(path.join(projectDir, 'src'), file)))) {
-    const text = fs.readFileSync(file, 'utf8'), relative = path.relative(projectDir, file);
-    if (/\b(?:startSetupRun|bindSetupStep|startQuickRun|startDevProbe|createWixSetupExecutor)\b|execution-capability(?:\.js)?/.test(text)) errors.push(`execution_capability_bypass:${relative}`);
-    // Vendored shared libraries live outside the generated transform directory. Generated
-    // transforms must obtain references through gate-owned resolvers, not read local evidence.
-    if (/crosswalk|loadCrosswalk|readEntityCrosswalk|local-state|data[\\/]source-extract/.test(text) && !/(?:^|\/)run-import\.[cm]?js$/.test(relative)) errors.push(`dependency_reference_bypass:${relative}`);
-  }
-  return { ok: errors.length === 0, errors };
-}
-module.exports = { verifyReadinessContract, files };