regwatch-co

Consulta leyes, proyectos de ley y sentencias de Colombia — y comprueba si un artículo sigue vigente.

En Colombia las normas cambian: una ley nueva puede modificar o derogar otra anterior. Buscar el texto en internet no siempre basta, porque lo que importaba ayer puede no ser lo que rige hoy.

regwatch-co es una herramienta abierta para:

1. Buscar normas, proyectos del Senado y providencias de la Corte Constitucional.

2. Preguntar si un artículo sigue vigente en una fecha concreta.

3. Ver de dónde salió cada dato, con enlace a la página oficial.

Puedes usarla desde el navegador (también en el móvil), desde la terminal o desde un asistente de IA conectado al proyecto.

Esto no es asesoría jurídica. Es un índice que te acerca al texto oficial. La decisión final siempre es tuya, leyendo la fuente.

Un ejemplo concreto

Imagina que quieres saber qué pasa con la Ley 1616 de 2013 (salud mental) hoy.

En lugar de quedarte solo con el texto original, regwatch-co te muestra si algún artículo fue modificado después, por qué norma, desde cuándo y con un enlace para verificarlo tú mismo:

ley 1616 de 2013 · Vigencia a día de hoy

AFECTADA
  Artículo 1 · cambiado por la ley 2460 de 2025 · efecto 2025-06-18
  Enlace a la fuente oficial ↗

Esa es la idea del producto: no solo «encontrar la ley», sino entender qué sigue en pie.

Related MCP server: LeyChile MCP

¿Qué puedes hacer?

Otras preguntas típicas que resuelve

• «¿Este artículo ya fue modificado?»

• «¿Qué proyectos de ley hay sobre X en el Senado?»

• «¿Qué dijo la Corte sobre este tema?» (dentro de lo que ya está cargado)

Cómo empezar (lo más simple)

Para probar la interfaz localmente necesitas Node.js 24 o superior, pnpm y un proyecto en Supabase con los datos (o tu propia carga; ver más abajo).

git clone https://github.com/LesVulture/regwatch-co.git
cd regwatch-co
pnpm install

cp .env.example .env
# Completa SUPABASE_URL, SUPABASE_ANON_KEY y, si vas a cargar datos, SUPABASE_DB_URL

pnpm web:dev

Abre http://localhost:3000 en el navegador.

También puedes usar la interfaz de terminal:

pnpm tui

Casos de uso paso a paso

Buscar en la web

1. Arranca con pnpm web:dev.

2. Escribe una consulta en lenguaje cotidiano.

3. Filtra por tipo si quieres (norma, proyecto o providencia).

4. Abre el resultado y sigue el enlace a la fuente oficial cuando lo necesites.

Rutas útiles:

Preguntar por escrito (con citas)

pnpm qa "¿Qué obligaciones tiene el Estado en política migratoria?"

Si el sistema no tiene texto suficiente para responder con honestidad, se niega a inventar. Prefiere decir que no consta a completar con conjeturas.

Conectar un asistente de IA (MCP)

Si usas Claude Desktop, Cursor u otra herramienta compatible con MCP:

{
  "mcpServers": {
    "regwatch-co": {
      "command": "node",
      "args": ["/ruta/absoluta/a/regwatch-co/mcp/src/server.ts"],
      "env": {
        "SUPABASE_URL": "https://TU-PROYECTO.supabase.co",
        "SUPABASE_ANON_KEY": "sb_publishable_..."
      }
    }
  }
}

Expone dos herramientas de consulta (solo lectura): buscar normatividad y consultar vigencia.

Qué datos incluye hoy

El proyecto está en construcción. Funciona de punta a punta, pero el volumen de texto completo de leyes aún es un piloto.

El estado medido día a día está en docs/ESTADO.md.

Para quien desarrolla o opera el sistema

A partir de aquí el lenguaje es más técnico.

Requisitos

• Node.js ≥ 24 (el repo fija 24 en .nvmrc)

• pnpm 11

• Supabase (Postgres + pgvector)

• Opcional: Ollama con nomic-embed-text para búsqueda semántica

• Opcional: sesión de Claude Code para pnpm qa

ollama pull nomic-embed-text
claude   # una vez, si vas a usar Q&A

Sin Ollama la búsqueda sigue funcionando en modo léxico y lo indica. Sin Claude, el resto del sistema sigue disponible.

Configura el hook de Git (recomendado si vas a hacer push):

git config core.hooksPath .githooks

Eso evita empujar por accidente ramas backup/* con historia que no debe republicarse.

Comprueba que el árbol está sano:

pnpm verify

Recolectar e importar datos

Los recolectores no escriben directo en la base. Primero guardan un archivo JSON; después un comando aparte lo importa. Así puedes revisar una corrida antes de tocarla.

pnpm collect:senado
pnpm collect:corte
pnpm collect:articulado Ley 1616 2013

pnpm db:load
pnpm db:load-providencias
pnpm db:load-chunks artefactos/articulado-ley_1616_2013.json --crear-norma
pnpm embed:chunks

Para sumar otra norma al piloto:

pnpm collect:articulado Ley 1751 2015
pnpm db:load-chunks artefactos/articulado-ley_1751_2015.json --crear-norma
pnpm embed:chunks

La recolección diaria en GitHub Actions está en .github/workflows/collect.yml (Senado + Corte del año + carga, si el secreto SUPABASE_DB_URL está configurado).

Cómo está organizado el código

En qué se diferencia de un buscador cualquiera

• Cada resultado importante puede rastrearse hasta una página oficial.

• La vigencia no la «adivina» un modelo de lenguaje: se basa en afectaciones registradas con su prueba.

• Si no hay afectaciones cargadas, el sistema no afirma que la norma esté vigente para siempre: dice que no consta cambio capturado.

• No republica notas editoriales de compilaciones privadas; solo el texto normativo de dominio público.

Detalle de reglas: GOVERNANCE.md. Plan histórico: PLAN-V2.md.

Coste de APIs de pago: ninguna. Los embeddings corren en Ollama local; el Q&A usa la sesión OAuth de Claude Code. Lo demás es Supabase.

Documentación

Licencia

MIT — ver LICENSE.

El código es MIT. El texto de las normas pertenece a sus fuentes oficiales; cada registro enlaza a la suya.