rp-telemetry

Records structured telemetry events and run rollups for RePlatform migration runs.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/divinaarmuela/Content --skill rp-telemetry-divinaarmuela
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rp-telemetry
Source: https://github.com/divinaarmuela/Content/tree/main/.claude/skills/replatform/resources/rp-telemetry
Command: npx skills add https://github.com/divinaarmuela/Content --skill rp-telemetry-divinaarmuela

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Migration runs to Wix produce no structured feedback about what went wrong, where time was spent, or which skills need improvement. This Skill captures halts, errors, fidelity losses, API gaps, coverage gaps, user decisions, and pipeline defects as validated, privacy-scrubbed telemetry events, plus a finalized run rollup with stage timings, volumes, and verification results. ## Core Features & Use Cases - Validated event recording: A recorder CLI enforces a strict event taxonomy (halt_needs_user, error, fidelity_loss, api_gap, skill_coverage_gap, user_decision, pipeline_defect), folds repeated occurrences per problem class, and rejects unknown fields or invalid enums. - Run lifecycle tracking: Commands for start, dims, stage boundaries, wait intervals, metering (model/API/script latency and token counts), and finalize produce a complete run document with active vs waiting time and derived cost. - Privacy and BI push: A mechanical scrub removes secrets, URLs, and emails from free text, and finalized runs are pushed to a Wix BI sink with GUID validation and batching. - Use Case: During a WordPress-to-Wix migration, the orchestrator starts telemetry at run begin, records an api_gap event when a Wix API cannot express an operation, meters import-stage API latency from the audit log, and finalizes with per-entity volumes and operator acceptance. ## Quick Start Ask the agent to start telemetry for the current migration project by running the recorder's start command with the source platform dimensions, then record events and finalize the run when it reaches a terminal state.

Frequently Asked Questions about rp-telemetry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record telemetry events during a Wix migration run?

Run the recorder CLI with node scripts/rp-telemetry.js record followed by a JSON event payload and --project pointing at the migration directory. The recorder validates the event against the taxonomy, scrubs secrets, folds repeated occurrences, and appends to the run journal.

What event types does the migration telemetry recorder support?

It supports halt_needs_user, manual_action_required, error, fidelity_loss, api_gap, skill_coverage_gap, user_decision, and pipeline_defect. Each type has defined subtypes and required fields, and the recorder rejects unknown fields or invalid enum values.

How is API latency measured for the import stage?

Run scripts/meter-from-audit.js against the migration project to derive api_ms, api_calls, and api_retries from logs/import-audit.ndjson. It collapses per-item audit rows by batch identity so one bulk call's latency is counted once rather than multiplied by item count.

Does the telemetry recorder handle run resumes after a halt?

Yes. Calling start on a project with an unfinalized run resumes it as the same run and attempt with one more session, closing any open wait interval. Start after a finalized run opens the next attempt automatically.

Why does the recorder reject my telemetry event?

Rejections list the exact fields to fix, such as invalid enum values, unknown fields, missing error_code on error events, or free text exceeding 400 characters. Fix the listed fields and retry; rejections are counted against telemetry health.

Can I edit run-telemetry.json or telemetry files by hand?

No. The recorder owns all writes to run-telemetry.json and the telemetry directory through atomic journal appends. Hand-editing is prohibited because the finalized document is a pure function of the journal and must stay reproducible.