Problema
El Oráculo (sistema de preguntas sobre el corpus) “ve todo el corpus” pero el indexador existente solo recorría src/content/wiki/. Los briefings operativos estratégicos almacenados en public/supercontext/ — auditoría suprema, estado operativo (STATE.md), roadmap (NEXT.md), auditorías cerradas — nunca se indexaban.
Síntoma: al preguntar “¿qué es la auditoría suprema?” el Oráculo divagaba a skills de Claude Method, ignorando el documento fuente.
Raíz: scripts/bib_ingest_claude_method.mjs estaba acoplado al namespace hardcodeado claude-method/. Reutilizarlo con Supercontexto requería duplicar o refactorizar.
Solución
Se generaliza el indexador existente con flags aditivos retrocompatibles:
--namespace <name>— prefijo del corpus (default:claude-method, ahora soportasupercontext)--app <app>— valor del campoappen chunks (default: namespace)--exclude <regex>— path patterns a omitir (ej.^(LOG\.md|reports/))
Sin flags, el script indexa claude-method exactamente como antes (no-regresión verificada).
Nuevo workflow: bib-reindex-supercontext.yml
| Característica | Detalle |
|---|---|
| Trigger | Cron diario 00:45 UTC + workflow_dispatch manual |
| Scope | public/supercontext/ recursivo, excluye LOG.md y reports/ |
| Namespace | supercontext — aislado del Help Widget |
| Chunks | 27 docs → 382 chunks (dry-run, 0 errores) |
| Credenciales | CF Access headers (runtime) |
Aislamiento del Help Widget
Los chunks llevan source_path: supercontext/<...>, que NO casa con el filtro user-facing del Help (^wiki/crearack--). Así:
- El Help Widget sigue sin exponer estos briefings internos al usuario final.
- El Oráculo y el staff (que ven todo el corpus, no filtrado) sí los encuentran.
- Seguridad operativa: confidencial interno (auditorías, decisiones) accesible solo a bib_ask admin.
Impacto
- Oráculo deja de ser ciego a briefings del Supercontexto (resolución de s109).
- Indexador generalizado abre camino para indexar futuras fuentes de docs Markdown sin duplicación.
- Flujo de re-indexación automatizado = corpus fresco sin intervención manual.
Cambios técnicos
Archivo: scripts/bib_ingest_claude_method.mjs
- Globalización:
NAMESPACEyAPPvariables (default:claude-method) - Parsing de
--namespace,--app,--excludeen CLI - Aplicación de regex de exclusión post-walk antes del parse
Archivo: .github/workflows/bib-reindex-supercontext.yml (new)
- 62 líneas
- Reutiliza
bib_ingest_claude_method.mjscon--namespace supercontext --app supercontext --exclude '^(LOG\.md|reports/)' - Usa secretos
CF_ACCESS_CLIENT_ID,CF_ACCESS_CLIENT_SECRET(MCP push)
Próximos pasos
- Ejecutar
workflow_dispatchpara pasada inicial (sube 382 chunks). - Verificar en bib_ask que responde correctamente sobre auditoría suprema, estados, etc.
- Monitorizar cron para detectar cambios grandes en Supercontexto.
Véase también
- [[entity—biblioteca—service—bib-ingest]] — servicio base de ingestión del corpus