# COGANT: Deterministic Codebase-to-GNN Translation

**Daniel Ari Friedman** (2026) · *Zenodo*

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.20705351.svg)](https://doi.org/10.5281/zenodo.20705351)

---

## Abstract

COGANT (Codebase-to-GNN Translation) deterministically converts software repositories into structured Active Inference artifacts expressed in the Active Inference Institute's **Generalized Notation Notation** (GNN — *Generalized Notation Notation*, not graph neural networks). It is best understood as an **evidence compiler**: it propagates reviewable program facts through a fixpoint rule pipeline (in the tradition of fixpoint program analysis) and emits graph, matrix, provenance, visualization, and roundtrip artifacts rather than a single opaque embedding or proof. A program-graph **intermediate representation (IR)** carries confidence and provenance; a fixpoint translation engine applies **22 declarative rules** mapping nodes onto **7 Active Inference mapping kinds**. Each emitted bundle includes a seed-induced structural partition using Markov-blanket role vocabulary, and a **reverse synthesizer** reconstructs a runnable Python package from an emitted GNN bundle, closing a forward→reverse→forward evaluation loop. The v0.6.0 release reports 9,697 passing tests, 95.55% line coverage, and a 25-target round-trip regression corpus. The system has a dual Python/Rust architecture and is MIT-licensed. Code home: https://github.com/ActiveInferenceInstitute/COGANT.

## Keywords

program analysis · Generalized Notation Notation (GNN) · intermediate representation · code property graph · active inference · reproducible research · codebase-to-model translation · cognitive ecosystem modeling

## Publication Details

| Field | Value |
|------|-------|
| **DOI (version)** | [10.5281/zenodo.20705351](https://doi.org/10.5281/zenodo.20705351) |
| **DOI (concept)** | [10.5281/zenodo.20705350](https://doi.org/10.5281/zenodo.20705350) |
| **Published** | 2026-06-15 |
| **Version** | 0.6.0 |
| **License** | MIT |
| **Zenodo record** | https://zenodo.org/records/20705351 |
| **Code** | https://github.com/ActiveInferenceInstitute/COGANT |

## Files

- `COGANT-0.6.0.pdf` - Zenodo PDF

## Citation

> Daniel Ari Friedman (2026). *COGANT: Deterministic Codebase-to-GNN Translation*. Zenodo. https://doi.org/10.5281/zenodo.20705351

## Related

- Zenodo record: https://zenodo.org/records/20705351
- Code repository: https://github.com/ActiveInferenceInstitute/COGANT
- [Full Bibliography](../../pages/BIBLIOGRAPHY.md) · [All Papers](../README.md)