Metadata-Version: 2.4
Name: trugs-tools
Version: 1.0.0
Summary: TRUGS CLI tools — validation, generation, memory, folder lifecycle, AAA protocol. Single `tg` binary with git-style subcommands.
Author: Xepayac LLC
License: Apache-2.0
Project-URL: Homepage, https://github.com/TRUGS-LLC/TRUGS-TOOLS
Project-URL: Issues, https://github.com/TRUGS-LLC/TRUGS-TOOLS/issues
Project-URL: Source, https://github.com/TRUGS-LLC/TRUGS-TOOLS
Project-URL: Documentation, https://github.com/TRUGS-LLC/TRUGS-TOOLS/blob/main/REFERENCE/
Keywords: trugs,cli,graph,spec,tg
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: trugs-store>=0.1.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: jsonschema>=4.0
Requires-Dist: requests>=2.28
Provides-Extra: web
Requires-Dist: httpx>=0.24; extra == "web"
Requires-Dist: beautifulsoup4>=4.12; extra == "web"
Requires-Dist: lxml>=4.9; extra == "web"
Provides-Extra: llm
Requires-Dist: anthropic>=0.20; extra == "llm"
Requires-Dist: openai>=1.0; extra == "llm"
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: pytest-cov>=4.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.21; extra == "test"
Requires-Dist: respx>=0.20; extra == "test"
Requires-Dist: httpx>=0.24; extra == "test"
Requires-Dist: beautifulsoup4>=4.12; extra == "test"
Requires-Dist: lxml>=4.9; extra == "test"
Provides-Extra: dev
Requires-Dist: trugs-tools[test]; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# TRUGS Tools

**CLI toolkit for the TRUGS specification.** One binary `tg` with git-style nested subcommands — validation, generation, memory, folder lifecycle, AAA protocol, and more.

## Install

```bash
pip install trugs-tools
```

## Quickstart

```bash
tg --help                # see all commands
tg init my-project       # create folder.trug.json
tg check                 # validate it
tg compliance .          # Dark Code compliance scan
tg memory remember ~/.../memory.trug.json "decision text" --type project --rule "terse"
tg aaa validate my-issue.aaa.md
```

## Command surface

36 operations under one binary:

- **Lifecycle:** `init`, `check`, `sync`, `render`, `validate`
- **Inspection:** `info`, `ls`, `where`, `find`
- **CRUD:** `add`, `get`, `update`, `delete`, `mv`, `link`, `unlink`, `dim`
- **Special:** `compliance`, `trl`, `export`, `import`
- **Memory:** `tg memory <sub>` — 8 subs including remember/recall/forget/associate/render/audit/import/reconcile
- **AAA:** `tg aaa <sub>` — generate, validate
- **EPIC:** `tg epic sync`

## Role in the TRUGS-LLC portfolio

- **[TRUGS](https://github.com/TRUGS-LLC/TRUGS)** — spec (CORE + TRL + reference papers). Zero CLIs, zero code.
- **[TRUGS-AGENT](https://github.com/TRUGS-LLC/TRUGS-AGENT)** — marketing hub + orientation (concept folders with examples). Zero install to read.
- **TRUGS-TOOLS** (this repo) — reference + implementation (CLIs + schemas + tests). Install when you want automation.
- **[TRUGS-STORE](https://github.com/TRUGS-LLC/TRUGS-STORE)** — swappable graph storage backend.

## Documentation

- [CHANGELOG.md](./CHANGELOG.md) — version history
- [REFERENCE/](./REFERENCE/) — SPEC_*.md docs for each tool
- [branches/](./branches/) — experimental branch vocabularies

## License

Apache-2.0 — see [LICENSE](./LICENSE)
