TruCo.

Deterministic structural snapshots for C# solutions.

TruCo (Truth Collector) extracts Declaration Truth from a repository into reproducible artifacts: What is explicitly declared, in a stable form for review, comparison, and LLM workflows. It can serve as a Name Authority for structural analysis, while leaving relational questions to other tools. The project is currently in closed review; documentation, examples, and prebuilt binaries are shared selectively, the source repository remains private.

Download latest version To Documentation →

How a solution becomes a snapshot

TruCo reads the explicitly authored declarations inside a selected .sln or .slnx boundary, and serializes them into a deterministic snapshot. Ordering, formatting, and filtering are kept stable.

C# Repository (Input)

/MyProject
├── MyProject.csproj
├── Program.cs
├── /bin      	(ignored)
└── /obj      	(ignored)
└── /tests      (can be ignored)

Snapshot (Output)

# Snapshot: MyProject
// strict domain limits applied
// timestamp: frozen

## File: Program.cs
public class Program {
    public static void Main() { 
        // deterministischer Code 
    }
}

Documentation

Getting Started & Usage

The CLI is executed directly in the root directory of your project to generate the snapshot: 

truco snapshot ./MyProject

Options & Flags

  • --output <path>: Defines the output location.
  • --ignore-tests: Excludes unit tests from the snapshot.
  • --source-generators: Applies strict "fail-hard" logic for syntax boundaries.

Full Documentation

Further examples, formalizations of deterministic properties, and use cases can be found in the detailed repository README.

Download

The download provided is for private review purposes only. The repository remains private during closed review.

Feedback & Support

Have you found an error or have suggestions for the project? Write me an email directly. Any feedback regarding logic or experience is extremely valuable!

Compose Email