CommitLore

CommitLore

Deja de revisar la misma mala idea.

Autoridad de decisiones para agentes de codificación, propiedad de Git.
Mantén restricciones, alternativas rechazadas y advertencias en Git — luego entrega solo lo que sigue vigente, para que un agente no reciba una decisión que el repositorio ya revirtió.

Sin memoria alojada. El repositorio es dueño del registro.

English · 한국어 · 日本語 · 简体中文

Instala una vez. Luego inicializa cada repositorio donde quieras que funcione.

curl -fsSL https://raw.githubusercontent.com/MongLong0214/commitlore/v1.2.0/install.sh | sh -s v1.2.0

curl -fsSLO https://raw.githubusercontent.com/MongLong0214/commitlore/v1.2.0/install.sh
sh install.sh v1.2.0

# Or skip the script: the checkout it makes is one you can make yourself.
git clone --depth 1 --branch v1.2.0 https://github.com/MongLong0214/commitlore
node commitlore/dist/commitlore.mjs --version

El código sobrevive. El juicio no.

Un agente propone un enfoque. Tu equipo lo rechaza por una restricción no obvia. El código final preserva el resultado, pero normalmente no el porqué se rechazó la alternativa. Un agente posterior ve solo el código y propone la misma idea otra vez.

CommitLore mantiene ese juicio junto al código.

Qué hace CommitLore

La mayoría de los commits no deberían llevar registro. CommitLore es para el juicio que el código no puede preservar, no para narrar cada cambio.

60 segundos para agentes conscientes de decisiones

1. Instala la CLI

macOS y Linux:

curl -fsSL https://raw.githubusercontent.com/MongLong0214/commitlore/v1.2.0/install.sh | sh -s v1.2.0

Windows:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/MongLong0214/commitlore/v1.2.0/install.ps1))) v1.2.0

Requiere Node.js 22.23.2+ y Git. El script verifica ambos antes de escribir nada.

2. Conecta tu agente

Claude Code:

/plugin marketplace add MongLong0214/commitlore
/plugin install commitlore@commitlore

Codex:

commitlore plugin install-codex

El plugin no pone commitlore en PATH, así que los comandos de abajo necesitan también la instalación de la CLI. Los instaladores también detectan y conectan hosts MCP compatibles donde pueden hacerlo de forma segura; la matriz exacta está abajo.

3. Inicializa un repositorio

cd your-repository
commitlore init
commitlore context .

Inicia una nueva sesión de agente después de instalar o actualizar un plugin: una sesión en ejecución mantiene el runtime que cargó.

Luego trabaja y haz commits normalmente. En integraciones de habilidades compatibles, CommitLore se considera durante solicitudes de commit ordinarias y permanece en silencio cuando no hay nada que valga la pena preservar. No necesitas nombrar CommitLore en cada commit.

¿Quieres que los registros aceptados se preparen sin un aviso por registro? El repositorio puede optar una vez con commitlore auto on. Esa política es propiedad del repositorio y se aplica al equipo, por lo que no se habilita silenciosamente desde esta página.

Qué recibe el agente

Antes de editar src/pricing.ts:

commitlore: active records for src/pricing.ts

Limit
  [claim] r-price01  calculatePrice owns final checkout pricing only

Ruled-out
  [claim] r-price01  Reuse it for admin quotes |
                     eligibility and rounding semantics differ

[claim] significa "considera esto como información". Un repositorio puede optar por el modo más fuerte de autoridad firmada. La entrega da contexto al agente; no bloquea la edición.

Modelo de seguridad →

¿Por qué Git?

El repositorio debería ser dueño del juicio detrás de su código.

CommitLore almacena registros en trailers y notas ordinarios de Git, para que se ramifiquen, fusionen, clonen, revisen y sobrevivan cambios de proveedor junto con el código que explican.

SQLite es solo un índice reconstruible. Bórralo y Git aún conserva el registro.

Encontrar una decisión antigua no es suficiente

Un sistema general de memoria o recuperación pregunta:

¿Qué texto antiguo parece relacionado?

CommitLore pregunta:

¿Qué decisiones registradas siguen aplicando a esta ruta ahora?

Una decisión superada puede ser muy relevante y aun así estar equivocada como guía actual. Relevancia y autoridad son preguntas diferentes.

Cómo funciona

1. Captura — un agente redacta solo el contexto de decisión que el diff no puede mostrar.
2. Verifica — CommitLore comprueba el borrador contra la sesión y el diff preparado.
3. Preserva — el registro aceptado vive en Git con identidad y ciclo de vida.
4. Entrega — antes de una edición posterior, solo se devuelven registros activos para esa ruta.

La mayoría de los commits no llevan registro. El hook de commit valida un registro cuando está presente; no lo inventa.

Un hook existente no se sobrescribe. commitlore init respeta core.hooksPath, mueve cualquier hook ya instalado a <hook>.commitlore-chained, y lo llama primero; commitlore hooks uninstall lo devuelve.

Qué sucede automáticamente

"Disponible" significa que el flujo preparar → verificar → preparar existe. No significa que cada commit elegible se evalúe automáticamente.

Los usuarios en hosts de habilidades compatibles no necesitan decir "registra esto en CommitLore" en cada commit. La limitación restante es la iniciación del host, no un comando de usuario requerido por registro.

Un informe de campo, no una medición

Una ejecución, en un repositorio no relacionado, por alguien que instala v1.2.0 por primera vez. Nada aquí fue medido y nada de esto está en los registros de evidencia. Está en esta página porque el párrafo anterior afirma un bucle que ninguna tabla aquí cubre.

Pidieron a un agente que arreglara un error de redondeo, mencionaron de paso que una biblioteca decimal ya había sido considerada y descartada, y terminaron con "haz el commit". CommitLore nunca fue nombrado. Parte de lo que llevó el commit:

Ruled-out: adopting a decimal library such as Decimal.js | the backend is a
  number contract, so it is meaningless
Warn: do not revert the test file to console.assert: it exits 0 even on
  failure, so CI passes silently
Provenance: drafted

El Warn no fue dictado al agente. Cayó en la trampa mientras trabajaba y lo dejó para quien viniera después. Provenance: drafted registra que ningún humano leyó el registro, lo que lo califica como claim — entregado como un informe para considerar, no una orden.

Una sesión posterior sin historial compartido recibió la tarea de adoptar la biblioteca decimal después de todo. No lo hizo, y nombró el registro como su razón. También leyó la calificación: un claim no es una instrucción, así que verificó la razón declarada contra el código antes de estar de acuerdo.

A diferencia del almacenamiento de memoria

CommitLore es intencionalmente más estrecho. No es un sistema general de memoria de usuario, archivo de conversación o reemplazo de base de datos vectorial.

Evidencia

El tiempo de construcción del índice sigue el número de registros, no el número de commits: la pasada costosa se ejecuta una vez por registro, así que un historial largo con poco registrado se construye más rápido que uno corto denso en registros.

El alcance de ruta es lo que evita que un historial grande llegue al modelo. En el corpus #167, solo 2 de 10,002 registros lo hicieron:

Eso mide exposición y recuperación con un presupuesto fijo de dos registros — no costo de tokens, costo facturado, precisión o comportamiento del agente. Un corpus, una consulta, un modelo de incrustación fijado.

El estudio de agentes no establece un efecto universal del modelo. La entrega no es prueba de que un modelo leyó o siguió un registro.

Métodos, tablas completas, exclusiones y resultados negativos →

Límites, confianza y privacidad

• La captura es asistida, no determinista. Las habilidades compatibles consideran solicitudes de commit ordinarias, pero ningún host está certificado para evaluar cada commit elegible.
• El modo de directiva predeterminado no es autenticación. Coincide con el encabezado del autor del commit, y cualquiera que pueda escribir un commit puede establecer ese encabezado — por lo que un [directive] en modo predeterminado es metadatos de política, no prueba de identidad. El modo de firma además requiere el estado verificado propio de Git y una coincidencia en la lista de permitidos de commitlore.trustedSigner local al repositorio; una lista de permitidos de firmantes ausente, vacía o ilegible no autoriza a nadie, por lo que el modo falla de forma cerrada.
• Guard es un aviso experimental, no una red de seguridad: precisión 44.8% (IC de Wilson del 95%: 32.7%–57.5%), recall 22.0% en el corpus de 417 decisiones. Un resultado de guard vacío no es un veredicto de seguridad.
• La entrega gasta tokens en cada llamada de herramienta coincidente. El hook previo a la edición se activa en Read así como en Edit, Write, MultiEdit y NotebookEdit, por lo que se ejecuta con mucha más frecuencia de lo que un agente de edición hace commits. Cada activación gasta hasta el presupuesto de carga útil — 800 tokens por defecto, cambiado con --budget. Un repositorio sin registros no gasta nada, lo que significa que este es un costo que llega con la adopción, no con la instalación.
• Una respuesta puede ser parcial. La cobertura se divulga; la ausencia en un resultado parcial no es prueba de que no exista ningún registro. La cobertura en todo el repositorio, los anclajes de símbolos y un constructor de registros interactivo siguen abiertos: #32, #33.
• Los trailers de commit viajan con un clon; las notas no. Git no obtiene refs/notes/* por defecto, por lo que un registro en refs/notes/commitlore está ausente de un clon ordinario hasta que commitlore init configura ese espejo.
• No hay backend alojado. Pero una vez que el servidor o el hook devuelve contexto, el host maneja ese contexto bajo su propia política; CommitLore no controla ese flujo de datos.

Seguridad · Compatibilidad · Evidencia

Pruébalo en un repositorio con historial.
_{Cuéntanos dónde falla el alcance de ruta, el ciclo de vida, la captura o la instalación.}

Reporta un caso de fallo · Lee la autoauditoría

Documentación

• Instalar, actualizar y desinstalar
• Referencia de CLI
• Flujo de trabajo de captura
• Protocolo de registros
• Modelo de seguridad
• Evidencia y limitaciones
• Contrato de producción
• Índice de documentación

Contribución

CONTRIBUTING.md cubre el protocolo de registros al que este repositorio se adhiere, la puerta de lanzamiento y cómo reproducir la evidencia.

Licencia

MIT — ver LICENSE.