AutoGineer
Generated banner for Rp Quick Runtime
Generated logo for Rp Quick Runtime

Rp Quick Runtime

WixOfficialPublished by Wix

  • Skill
  • Tool integration
  • Automation and integrations
  • MIT
  • Low risk
  • Has scripts
Download ZIP

From the author

Shared deterministic target-limit recovery and final-report runtime every rp-quick-<platform> quick-mode adapter uses before a Wix Stores write.
— the description by Wix

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The rp-quick-runtime is a shared library designed for use by quick-mode platform adapters. It provides a standardized mechanism to enforce Wix Stores data limits, such as SKU length and tag count, ensuring that data is trimmed or capped deterministically rather than silently skipped. It manages the recovery ledger and generates a final report, providing operators with a clear, actionable summary of any data modifications made during the import process.

What it does

  • Normalizes product data by applying deterministic caps and trims to SKUs and tag lists.
  • Ensures trimmed SKUs remain unique using source-ID-derived suffixes.
  • Ledgers recovery events to a durable NDJSON file for auditability.
  • Tracks recovery counts and record status for comprehensive reporting.
  • Generates a human-readable final report detailing import outcomes and recovery breakdowns.

When to use it

  • When building or maintaining a quick-mode adapter for Wix Stores.
  • When you need to enforce strict data limits on product attributes during migration.
  • When you require a transparent audit trail of data modifications made during an automated import.
  • When you want to avoid silent data loss during platform-to-platform record synchronization.

Advantages

  • Prevents silent record skipping by enforcing limits deterministically.
  • Maintains data integrity through stable, unique SKU generation.
  • Provides a clear, actionable final report for operators.
  • Standardizes recovery logic across multiple platform adapters.

Usage examples

“How do I normalize a product SKU and tag list before writing to Wix Stores?”
Use the normalizeProduct function to receive capped/trimmed values and a list of recovery events, then proceed with the write operation.
“How do I record a recovery event after a successful write?”
Call appendRecoveries to log the event to the ledger and recordRecoveredRecord to update the summary statistics.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/wix/rp-quick-runtime/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip rp-quick-runtime.zip -d .agents/skills

Documentation by Wix

rp-quick-runtime

Not invoked directly — this is a shared library (lib/limit-recovery.js), not a standalone adapter. Every rp-quick-<platform> quick-mode adapter (rp-quick-shopify, rp-quick-woocommerce) requires it from its own scripts/quick-mode.js and must use it from its first version (spec 0051, Decision 1). Platform adapters own source extraction and field semantics; this runtime owns target-limit enforcement, recovery-ledger aggregation, and the human-readable final report — so a Wix Stores validation limit never silently turns an otherwise-valid record into an opaque skip.

const recovery = require('../rp-quick-runtime/lib/limit-recovery.js');

const normalized = recovery.normalizeProduct({ sourceId, sku, tagIds });
// normalized.sku / normalized.tagIds are the capped/trimmed values to write;
// normalized.recoveries lists what was capped or trimmed, if anything.
await writeProduct({ ...product, sku: normalized.sku, tagIds: normalized.tagIds });
// Record written_with_loss only after the target write succeeds.
if (normalized.recoveries.length) {
  await recovery.appendRecoveries(projectDir, adapterName, sourceId, normalized.recoveries);
  recovery.recordRecoveredRecord(summary, normalized.recoveries);
}
// ...after the run:
await recovery.writeFinalReport(projectDir, summary);

normalizeProduct applies the two verified Stores limits deterministically: caps tagIds at STORES_PRODUCT_TAGS_MAX (first-seen source order, extras omitted) and trims sku to STORES_SKU_MAX Unicode-safe characters with a stable source-ID-derived suffix so a trimmed SKU stays unique. Every cap/trim is reported back in recoveries[], never applied silently.

appendRecoveries ledgers each recovery to execution/quick-limit-recoveries.ndjson under the adapter's own name, tagged outcome: written_with_loss — the durable record of what was preserved versus lost, per source record. Call it only after the target write succeeds.

recordRecoveredRecord increments summary.recovered once for the written source record and increments summary.recoveryCounts once for each recovery event on that record.

writeFinalReport renders execution/quick-mode-final-report.md: a count of records imported with deterministic recovery plus a per-recovery-code breakdown, so the operator gets a compact, actionable account instead of a bare skip count.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs Node.js

Security

What our scanner noticed· Low risk

  • Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Wix
Publisher
Wix (Official)
Source
wix/skills · wix-replatform/resources/rp-quick-runtime · commit d168bc2
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Wix or Wix.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download rp-quick-runtime.zip