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. For the syntax this compiler supports, it compiles sentence structure to a TRUG graph and decompiles that representation to canonical TRL. Sugar tokens and original formatting are not preserved. Decompiling arbitrary valid TRUG graphs does not guarantee recompilable TRL or preservation of JSON properties. Write TRL when communicating; store and validate TRUGS (the JSON graph) when executing.

Install

pip install trugs-tools

Quickstart

trug --help                          # the verb list, one summary per verb
trug validate first.trug.json        # the 16 CORE 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. For trug trl, content syntax, grammar, vocabulary and validation failures exit 1; usage errors (bad arguments, missing or unreadable files, or expected JSON) exit 2.

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).
• TRUGS-STORE — the swappable graph-storage backend used by the language CLI.

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 install of the trug CLI with test dependencies (.[test])
make check    # pytest tests/, then trug validate folder.trug.json

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.

Scope

This software does not include self-modifying TRUGS: graphs that change their own structure while they run.

License

Apache-2.0 — see LICENSE and NOTICE.