sourcebook

Findet die Dateien, die dein KI-Agent vergessen hat zu ändern.

Eine Sicherheitsebene für Codeänderungen. sourcebook analysiert Git-Diffs auf Vollständigkeit — es markiert Dateien, die hätten geändert werden müssen, aber nicht geändert wurden. Regelbasierte strukturelle Erkennung plus KI-gestützte semantische Analyse. Null Fehlalarme bei sauberen Diffs.

npx sourcebook init # sets up Claude Code hooks + generates CLAUDE.md
npx sourcebook check # check your current diff for missing files
npx sourcebook scan-history # see what you've been missing

Was es erkennt

Dein KI-Agent hat den Handler geändert. Hat er den Test aktualisiert? Das zugehörige Modul? Die Konfiguration, die auf den alten Wert verweist?

sourcebook prüft dein Diff gegen die tatsächliche Struktur des Repos:

• Fehlende Testdateien — Quelldatei geändert, Testdatei nicht

• Zugehörige Module — Dateien, die importieren oder von dem importiert werden, was du geändert hast

• Co-Change-Begleiter — Dateien, die historisch in Git-Commits zusammen geändert werden

• Blast-Radius von Hub-Dateien — du hast etwas mit über 50 Abhängigkeiten berührt

Mit --ai: semantische Beziehungen zwischen Modulen, Feldumbenennungen, die Migrationen erfordern, veraltete Validierungslogik.

Related MCP server: Carto MCP Server

Wichtige Statistiken

Vier Oberflächen

1. CLI

Führe es auf jedem Diff aus. Keine Einrichtung erforderlich.

npx sourcebook check # check staged/unstaged changes
npx sourcebook check --ai # add AI semantic analysis (requires ANTHROPIC_API_KEY)
npx sourcebook check --quiet # exit code only (for CI/scripts)
npx sourcebook check --branch main # compare vs a branch

2. Claude Code Hooks

Ein Befehl richtet Pre-Commit-Hooks ein. Der Agent bearbeitet eine Datei, sourcebook prüft das Diff, der Agent sieht, was fehlt — alles bevor der Commit landet.

npx sourcebook init # generates CLAUDE.md + installs hooks

3. MCP-Server

Veröffentlicht in der offiziellen MCP-Registry. Agenten können bei Bedarf die Repo-Struktur, den Blast-Radius, Konventionen und Co-Change-Daten abfragen.

npx sourcebook serve

Zum MCP-Client hinzufügen:

{
 "mcpServers": {
 "sourcebook": {
 "command": "npx",
 "args": ["-y", "sourcebook", "serve", "--dir", "/path/to/your/project"]
 }
 }
}

4. GitHub App (bald verfügbar)

Automatisierte Vollständigkeitsprüfungen bei jedem Pull Request. Trage dich in die Warteliste ein.

Befehle

Funktionsweise

Ebene A — Regelbasiert (kein LLM, <1 Sekunde)

1. Co-Change-Analyse — durchsucht die Git-Historie nach Dateien, die zusammen geändert werden. Wenn du auth.ts berührt hast und es in 88% der Commits zusammen mit session.ts geändert wird, markiert sourcebook session.ts.

2. Testdateierkennung — ordnet Quelldateien Testdateien über Namenskonventionen und Co-Change-Historie zu.

3. Import-Graph — erstellt einen Abhängigkeitsgraphen und prüft, ob Dateien, die deine geänderten Dateien importieren (oder von ihnen importiert werden), ebenfalls Aktualisierungen benötigen.

4. Hub-Erkennung — markiert, wenn du eine Datei mit hohem Fan-in (viele Abhängigkeiten) geändert hast. Diese Änderungen haben einen Blast-Radius.

Ebene B — KI-gestützt (~$0.012/Durchlauf)

Sendet das Diff plus Abhängigkeitskontext an Claude Sonnet. Erkennt semantische Beziehungen, die Ebene A nicht sehen kann — Feldumbenennungen, die Migrationen erfordern, Validierungslogik, die von alten Schemata ausgeht, modulübergreifende Abhängigkeiten ohne Import-Link.

Jeder KI-Vorschlag erfordert einen Abhängigkeitsnachweis. Halluzinierte Dateipfade werden herausgefiltert. Die Vollständigkeitsprüfung stellt sicher, dass es keine Fehlalarme gibt: Wenn das Diff tatsächlich vollständig ist, bleibt Ebene B stumm.

Konfiguration

# Required for --ai flag only
export ANTHROPIC_API_KEY=sk-ant-...

Keine weitere Konfiguration erforderlich. sourcebook liest die Git-Historie und Dateistruktur deines Repos direkt aus.

Sprachunterstützung

Forschung

Basiert auf echten Benchmarks, nicht auf Vermutungen:

• Validierungsergebnisse prüfen — Methodik und Genauigkeitsdaten

• Benchmark: 19 Aufgaben, 10 Repos, 4 Sprachen — kontrollierte Agenten-Leistungstests

• Warum automatisch generierter Kontext Agenten verschlechtert — die Erkenntnis der ETH Zürich, die unseren Ansatz geprägt hat

Lizenz

BSL-1.1 — Source-Available, kostenlos nutzbar, darf nicht als gehosteter Dienst angeboten werden. Wird am 25.03.2030 zu MIT. Siehe LICENSE für Details.

sourcebook.run · GitHub · npm · @maroond_

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers