Supercontexto Fase 6 · Métricas y utility_score

Supercontexto Fase 6 · Métricas y utility_score

Resumen

La Fase 6 es la última fase del roadmap del Supercontexto. Introduce un sistema de métricas de uso para la wiki Supercontexto mediante un utility_score por página, un cron diario que lo recalcula, visibilidad en el health endpoint y un runbook para usar la wiki desde Obsidian.

PR #7 — mergeado 2026-04-22 — commit b18fd13.

Componentes añadidos

1. Tabla bib_wiki_utility (eventos)

Cada vez que una página wiki es consultada, referenciada o verificada, se inserta un evento en bib_wiki_utility:

INSERT INTO bib_wiki_utility (page_slug, event, weight, source)
VALUES (?, 'query_hit', 1.0, ?)

Los tipos de evento son: query_hit, ingest_reference, manual_link, lint_verify.

2. Tool MCP wiki_utility_recompute

Nuevo tool que agrega los eventos de bib_wiki_utility dentro de una ventana configurable since_days (default: 30) y actualiza utility_score en bib_wiki_pages para todas las páginas active/draft.

Detalles operativos:

• Páginas sin eventos recientes → score 0 (penalización natural).
• Actualización vía db.batch() en chunks de 50 statements (límite D1 seguro).
• Parámetro dry_run=true para preview sin aplicar.
• Registra resultado en bib_wiki_log con operation='curate' y actor='agent-utility'.

→ Ver: entity--mcp--tool--wiki-utility-recompute

3. Workflow CI wiki-utility.yml

Cron diario a 06:00 UTC que llama a wiki_utility_recompute vía HTTP MCP. Se ejecuta después de Lint (04:30) y Curator (05:00) para que todos los eventos del día estén contabilizados.

on:
  schedule:
    - cron: "0 6 * * *"
  workflow_dispatch:  # también invocable manualmente

4. Health check checkWiki en /api/health

Nueva fila “Wiki Supercontexto” en el dashboard de health. Semáforo basado en:

Métricas expuestas: total de páginas, distribución por status, contradicciones abiertas/totales, tokens consumidos en 7 días, top slug por utility_score.

5. Registro de query_hit en bib_ask

El handler handlers/archivo.ts ahora detecta si las fuentes devueltas en una respuesta bib_ask son páginas wiki (path que coincide con src/content/wiki/*.md), extrae sus slugs y registra un evento query_hit en bib_wiki_utility. Es fail-silent — no bloquea la respuesta.

6. Runbook Obsidian

Guía para abrir src/content/wiki/ como vault de Obsidian local (lectura offline, graph view, backlinks).

→ Ver: runbook--wiki--obsidian-setup

Diagrama de flujo de métricas

bib_ask()
  └─→ query_hit → bib_wiki_utility
                          ↓
                  wiki-utility.yml (06:00 UTC)
                          ↓
               wiki_utility_recompute
                          ↓
             bib_wiki_pages.utility_score
                          ↓
                  /api/health (checkWiki)

Fases del roadmap (referencia)

Archivos clave

Coste proyectado

Test plan

• Verificar fila “Wiki Supercontexto” en widget Salud del sistema (/api/health).
• Hacer bib_ask sobre tema wiki → verificar inserts en bib_wiki_utility.
• Disparar wiki-utility.yml manualmente con dry_run=true.
• Abrir vault Obsidian según runbook y promover con /wiki-promote runbook--wiki--obsidian-setup.

Véase también

• [[entity—mcp—tool—wiki-utility-recompute]]
• [[runbook—wiki—obsidian-setup]]
• [[feature—supercontext—fase-4-query-con-cierre]]
• [[concept—biblioteca—supercontexto]]