Metadata-Version: 2.4
Name: gdk9-cli
Version: 0.4.0
Summary: GDk9 CLI — symbolic energy analysis, implication engine, and DCG tools
Author-email: Adam Grange <adamgrange@proton.me>
License: AGPL-3.0-or-later
Keywords: gdk9,energy,symbolic,cli,dcg,implication,numerology
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Environment :: Console
Classifier: Topic :: Text Processing
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Utilities
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: egglog
Requires-Dist: egglog>=13.0.0; extra == "egglog"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: pyflakes; extra == "dev"
Requires-Dist: build; extra == "dev"
Provides-Extra: build
Requires-Dist: build; extra == "build"
Provides-Extra: secure
Requires-Dist: cryptography>=42.0.0; extra == "secure"
Dynamic: license-file

# GDk9

**Symbolic energy toolkit: a zero-dependency Python CLI, the KeySuite reference runtime, and a web console for the GDk9 implication grammar.**

[![CI](https://github.com/ao3575911/gdk9/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/ao3575911/gdk9/actions/workflows/ci.yml)
[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0--or--later-blue.svg)](LICENSE)
![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)

![GDk9 demo](docs/img/gdk9_demo.gif)

GDk9 treats letters as energetic operators. The `gdk9` CLI analyzes, profiles,
transforms and encrypts text with the GDk9 implication engine; **KeySuite** is the
deterministic reference runtime for the GDk9 grammar, with conformance vectors; the
**KeySuite console** is a local React UI over the same algebra.

## Install

Requires Python 3.9+. The core CLI has no runtime dependencies.

```bash
git clone https://github.com/ao3575911/gdk9.git
cd gdk9
python -m venv .venv && . .venv/bin/activate
pip install -e .
```

Optional extras: `pip install -e ".[secure]"` (AES-GCM via `cryptography`),
`".[dev]"` (pytest, ruff, build), `".[egglog]"` (egglog bridge, Python 3.11+).

## Quickstart

```bash
gdk9 --version
gdk9 analyze "Hello, world!"
gdk9 profile "The quick brown fox jumps over the lazy dog"
gdk9 dcg classify FWEM
gdk9 kernel eval "FWEM"
python examples/01_analyze.py
```

KeySuite runtime (Python 3.10+):

```bash
cd packages/keysuite-runtime
pip install -r requirements.txt && pip install -e .
keysuite "C C . 3 3"
keysuite conformance conformance/vectors
```

KeySuite console (Node 22):

```bash
cd apps/keysuite-console
npm ci
npm test
npm run dev      # http://localhost:5173
```

More: [Quickstart](docs/QUICKSTART.md) · [CLI reference](docs/CLI.md) ·
[API](docs/API.md) · [Architecture](docs/ARCHITECTURE.md) ·
[Alphabet handbook](docs/ALPHABET.md) · [Examples](examples/)

## Repository layout

| Path | What it is | Stack | License |
| --- | --- | --- | --- |
| `gdk9/`, `tests/`, `examples/`, `docs/` | `gdk9-cli` package: CLI, kernel, DCG, crypto, plugins | Python 3.9+ | AGPL-3.0-or-later |
| `packages/keysuite-runtime/` | KeySuite reference runtime, REST/WebSocket API, conformance vectors | Python 3.10+ | MIT |
| `apps/keysuite-console/` | KeySuite local web console | TypeScript, React, Vite | MIT |
| `legacy/gdk9-fork/` | Snapshot of the AGI-H4X/gdk9 fork (unmaintained) | Python | GPL-3.0 |
| `legacy/gdk9-alphabet/` | Early hollow-vector character embedding (unmaintained) | Python | MIT |
| `legacy/symphi-engine/` | Early SymPhi physics-aware engine (unmaintained) | Python | GPL-3.0 |
| `docs/keysuite-gist.md` | Original KeySuite gist README | Markdown | — |

Each subproject was merged with its full git history (`git log -- <path>`).
`legacy/` is kept for reference only and is excluded from lint and CI.

## Running tests

```bash
# gdk9 CLI
pip install -e ".[dev]"
python -m pytest -q
ruff check .

# KeySuite runtime
cd packages/keysuite-runtime && python -m pytest -q && keysuite conformance conformance/vectors

# KeySuite console
cd apps/keysuite-console && npm ci && npm test && npm run typecheck
```

CI runs all three on every push and pull request to `main`.

## License

The repository as a whole is licensed under the
[GNU Affero General Public License v3.0 or later](LICENSE).

**LICENSES:** subfolders keep their original licenses, each with its own `LICENSE` file:
`packages/keysuite-runtime/`, `apps/keysuite-console/` and `legacy/gdk9-alphabet/` are
MIT; `legacy/gdk9-fork/` and `legacy/symphi-engine/` are GPL-3.0.
