Hoe CodeGraph werkt
Parseer het estate tot een getypeerde graaf, en voer daarna deterministische analyses uit. Er zit geen LLM in het kritieke pad.
De pipeline draait Fixture estate, daarna parsen (COBOL, copybooks, JCL, DB2 DDL), daarna een getypeerde kennisgraaf bouwen, daarna transitieve-afsluitingsimpact plus herkomst, daarna de deterministische analyses, daarna een audit- en bewijsexport, daarna het interactieve dashboard. Bij het laden draait de app dit live via Server-Sent Events, zodat elke fase vertelt met haar echte gemeten latentie in een console, panelen progressief vullen, en een persistente faserail u de Input-, Processing- en Output-trace van elke fase laat openen. Eén bediening speelt de hele run opnieuw af.
De getypeerde kennisgraaf
Gebouwd met networkx en vastgehouden in-memory plus SQLite, heeft de graaf zeven knooptypen (program, copybook, variable, table, jcl, dataset, en een onopgeloste placeholder) en getypeerde randen zoals DEFINES, IMPORTS, REDEFINES, CONTROLS_TYPE_OF, WRITES_VAR, REFERENCES, CALLS, READS and WRITES, EXECUTES, USES_DATASET en PRECEDES. Op de meegeleverde fixture heeft de graaf 47 knopen en 70 randen: 14 programs, 5 copybooks, 17 variables, 3 DB2-tables, 3 JCL-jobs, 4 datasets, en 1 onopgeloste knoop.
Vier deterministische analyses
Dit zijn gewone graafalgoritmen, geen modelaanroepen, dus dezelfde fixture levert bij elke run hetzelfde resultaat.
1. Impactafsluiting met herkomst
Het transitieve afhankelijkheidsstuk van een wijziging, waarbij elke rand haar file:line-bron draagt, zodat u niet alleen ziet wat geraakt wordt maar ook waar het bewijs staat.
2. Naïeve versus graaf-recall
De afsluiting van de graaf, gescoord tegen de bekende ground-truth-afhankelijkheidsset van de fixture, versus een gesimuleerd enkel-bestandvenster, wat een tekstgebaseerde tool daadwerkelijk aan een model voedt.
3. Extractievolgorde
Een koppelings- en blast-radius-score per programma (koppeling gewogen drie, COMP-3-traps gewogen twee, JCL-criticaliteit gewogen twee, onopgeloste calls gewogen vijf) die een veilige strangler-fig-migratievolgorde rangschikt.
4. Bereikbaarheid van dode code en volledigheidspoort
Elke PERFORM, CALL, COPY en DB2-referentie moet oplossen of worden gemarkeerd als needs review, nooit stilzwijgend weggelaten. Onbereikbare paragraphs worden gerapporteerd als illustratie, niet gescoord als kopmetriek.
Eén schakelaar maakt het verschil tastbaar. Vink de naïeve AI-contextweergave aan en de graaf dimt tot het enkele bronbestand met een paar regels context. Zes van de negen wire-transferfeiten verdwijnen, een rode banner vermeldt het gevolg, en terugschakelen herstelt 9/9 met bewijsstukken. Die schakelaar is een illustratie van welke context de retrieval-laag moet leveren, niet de bron van waarde.
Wanneer u klaar bent, schrijft Export JSON een migration-evidence.json-bestand, en Evidence report rendert een afdrukbaar Codebase Topology and Completeness Report: de knoop- en randensamenvatting, closures per module met file:line-herkomst, het recall-resultaat en de methode, de gerangschikte extractievolgorde, de dode-codelijst, en een tijdstempel. Wij positioneren dat als een DORA ICT-assetinventaris en een SOC-2 change-controlbewijs. Een optionele Pydantic-AI-laag kan vragen beantwoorden over de afsluiting, maar die staat standaard uit en is key-gated, en de deterministische demo registreert het resultaat zonder enige key.
