reindex-lgcc/.opencode/skills/reindex-activities/SKILL.md

1.4 KiB

name description
reindex-activities Use when reindexing Carpa data from Directus to Typesense. Covers activities, conferences, entrelineas, and print-materials collections. Run from the reindex-activities/ directory.

Reindex Carpa → Typesense

Scripts para reindexar datos desde Directus a Typesense usando upsert, ubicados en C:\Users\Esteban\Documents\Carpa Code\reindex-activities\.

Scripts disponibles

Colección Comando
activities + paragraphs node reindex.mjs --collection activities
conferences + paragraphs node reindex.mjs --collection conferences
entrelineas node reindex-entrelineas.mjs
print-materials node reindex-print-materials.mjs

Flags comunes

  • --dry-run — valida transformación sin escribir en Typesense
  • --limit N — procesar solo N registros
  • --offset N — saltar los primeros N registros

Configuración

Copiar .env.example a .env. Cada script acepta vars específicas:

  • reindex.mjs: DIRECTUS_URL, DIRECTUS_TOKEN, TYPESENSE_URL, TYPESENSE_ADMIN_KEY
  • reindex-entrelineas.mjs: fallback a ENTRELINEAS_DIRECTUS_*DIRECTUS_*
  • reindex-print-materials.mjs: fallback a PRINT_DIRECTUS_*DIRECTUS_*

Workflow típico

  1. Validar con --dry-run --limit 5
  2. Si la transformación se ve bien, ejecutar sin flags para index completo
  3. Si hay errores, revisar los primeros 10 mostrados en el reporte