TRUGS Tools

The TRUGS language CLI. One binary, trug — validate TRUG graphs, compile and decompile TRL, graph-node CRUD, Dark Code compliance, and corpus audit. Implements TRUGS 2.0 (core_v2.0.0).

TRUG/L (TRL) is a constrained subset of English: every valid sentence compiles to a graph and every graph decompiles back to the sentence, losslessly. You write TRL when communicating; you store and validate TRUGS (the JSON graph) when executing. The sentence is the graph.

Install

pip install trugs-tools

Quickstart

trug --help                          # the verb list, one summary per verb
trug validate first.trug.json        # the 12 structural rules -> VALID / INVALID
trug trl compile hello.trl > hello.trug.json   # TRL sentence -> TRUG graph (saved to file)
trug trl decompile hello.trug.json             # graph -> the sentence, losslessly
trug compliance src/                 # Dark Code compliance scan

New to TRUGS? The five-minute on-ramp: GETTING_STARTED.md

Command surface

Eight verbs on the trug binary:

Every verb documents examples and exit codes: trug <verb> --help.

Folder cartography — keeping a directory tree and its TRUG graph in sync and rendering ARCHITECTURE.md — is the sibling package trugs-folder (binary: trug-a-folder).

Role in the TRUGS-LLC portfolio

• TRUGS — the specification (CORE + TRL + reference papers) and the getting-started guide.
• TRUGS-TOOLS (this repo) — the language CLI trug (this package) + the cartography tool trug-a-folder (trugs-folder/).
• TRUGS-STORE — the swappable graph-storage backend both tools sit on.

Documentation

• CHANGELOG.md — version history, including the 2.0 boundary statement and the v1 migration table
• GETTING_STARTED.md — the on-ramp
• SECURITY.md · CONTRIBUTING.md

Development

make dev      # editable installs: the trug CLI + the bundled trugs-folder suite
make check    # the Tier-1 gate — the bundled trugs-folder tests + self-validation

The last make check step is Layer-4 self-description: the engine validates the repo's own folder.trug.json against the TRUGS CORE rules it implements.

License

Apache-2.0 — see LICENSE and NOTICE.