genesis-repository-truth-context

Genesis Repository Truth Context Compiler

Deterministic codebase fact extraction and context engineering compiler for autonomous coding agents (Codex CLI, Claude Code, Cursor, Gemini).

---

1. What Problem Does This Solve?

Coding agents frequently hallucinate build commands, invent nonexistent dependencies, execute incorrect test runners, or misinterpret project topology when fed uncurated repository dumps or generic README files.

genesis-repository-truth-context solves this by statically inspecting project manifests (package.json, pyproject.toml, Cargo.toml), git telemetry, and risk zones to compile a compact, verified fact manifest. Crucially, it enforces strict structural separation between Verified Facts (deterministic ground truth) and Heuristic Inferences (static hypotheses), preventing models from treating guesses as established truth.

2. Who Buys It?

• AI Engineers and Agentic Framework Developers.
• Engineering teams using autonomous coding agents in large or complex codebases.
• Platform architects building context-injection pipelines for enterprise LLM agents.

3. What Does It Output?

• A compact, token-efficient Markdown context document optimized for LLM system prompts.
• Structured JSON (--json) for automated agent orchestration harnesses.

4. How Fast Can You Test It?

Under 3 seconds. Run:

python3 -m genesis_truth_context ./tests/fixtures/sample_repo

5. Why Is This Different From Generic README Summarizers?

Generic summarizers produce unverified prose with no operational guarantees. genesis-truth-context runs AST and manifest parsers to extract factual test/build commands, dirty git states, and security risk zones, while cleanly demarcating inferences so agents never act blindly on assumptions.

---

Installation & Usage

# Compile truth context for current repository
python3 -m genesis_truth_context .

# Output to markdown file for agent system prompt
python3 -m genesis_truth_context /path/to/repo --out ./agent-context.md

# Output machine-readable JSON for orchestration pipeline
python3 -m genesis_truth_context /path/to/repo --json

Compiler Architecture & Separation of Concerns

Repository Root
 ├── Git Telemetry        ──┐
 ├── Package Manifests    ──┼──► [VERIFIED FACTS]     ──► High Confidence Constraints
 ├── Build & Test Scripts ──┤                               (Zero Model Guesswork)
 └── Security Risk Zones  ──┘
 
 Static AST Patterns      ─────► [INFERENCES]         ──► Explicitly Labelled Hypotheses
                                                            (Requires Pre-flight Confirmation)

Supported Manifest Ecosystems

• Node.js: package.json (scripts, dependencies, devDependencies)
• Python: pyproject.toml, requirements.txt, pytest.ini
• Rust: Cargo.toml (packages, targets, cargo test/build)
• Git: Working tree cleanliness, branch tracking, commit hash verification

License

Commercial — Genesis Code (genesiscode2026). See LICENSE.