gdk9-cli 0.3.0__tar.gz → 0.4.0__tar.gz

gdk9_cli-0.4.0/PKG-INFO

@@ -0,0 +1,138 @@
+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.

gdk9_cli-0.4.0/README.md

@@ -0,0 +1,102 @@
+# 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.

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/__init__.py

@@ -2,4 +2,4 @@ __all__ = [
   "__version__",
 ]
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/cli.py

@@ -12,10 +12,10 @@ from .io_utils import read_input
 from .principles import Principle, load_principle
 from .utilization import attune, sigil
 from .tokenize import summarize_tokens_table, to_json_payload, annotate_text, delimiter_set
-from .optimize import optimize_attunement, apply_plan, Plan, optimize_substitution, EditPlan, apply_edit_plan
+from .optimize import optimize_attunement, apply_plan, Plan, optimize_substitution, apply_edit_plan
 from .log import logger
 from .ansi import supports_color, colorize
-from .fmt import Box, section, kv, fmt_dr, fmt_float_e, fmt_class, fmt_valid, fmt_form, energy_bar, vlen
+from .fmt import Box, section, kv, fmt_dr, fmt_float_e, fmt_class, fmt_valid, energy_bar, vlen
 from .state import load_state, save_state, list_symbols, set_symbol, merge_state, set_rule
 from .imply import make_fusion, make_split, apply_rule, Rule
 from .kernel_cli import run_kernel
@@ -272,7 +272,6 @@ def cmd_synthesize(args: argparse.Namespace, principle: Principle, use_color: bo
         elif ch == "0":
           coloured += colorize("0", "dim", True)
         elif ch == "#":
-          dr_v = int(line[0]) if line and line[0].isdigit() else 9
           coloured += colorize(ch, "bright_white", True)
         else:
           coloured += colorize(ch, "dim", True) if ch in ":-" else ch
@@ -312,7 +311,6 @@ def cmd_principles(args: argparse.Namespace, current: Principle) -> int:
   if args.action == "install":
     if not args.file:
       raise InputError("--file is required for install")
-    import shutil
     from pathlib import Path
     try:
       # Validate first
@@ -494,7 +492,7 @@ def build_parser() -> argparse.ArgumentParser:
   sym_add = sym_sub.add_parser("add", help="Add or update a symbol")
   sym_add.add_argument("name")
   sym_add.add_argument("energy", type=float)
-  sym_list = sym_sub.add_parser("list", aliases=["ls"], help="List symbols")
+  sym_sub.add_parser("list", aliases=["ls"], help="List symbols")
 
   imp = sub.add_parser("imply", aliases=["im"], help="Define and apply rules")
   imp_sub = imp.add_subparsers(dest="imply_cmd", required=True)
@@ -507,7 +505,7 @@ def build_parser() -> argparse.ArgumentParser:
   imp_ds.add_argument("out_a")
   imp_ds.add_argument("out_b")
   imp_ds.add_argument("ratio", type=float)
-  imp_list = imp_sub.add_parser("list", aliases=["ls"], help="List rules")
+  imp_sub.add_parser("list", aliases=["ls"], help="List rules")
   imp_ap = imp_sub.add_parser("apply", aliases=["ap"], help="Apply rule to input symbol names")
   imp_ap.add_argument("rule")
   imp_ap.add_argument("inputs", nargs="+")
@@ -539,12 +537,12 @@ def build_parser() -> argparse.ArgumentParser:
   ker_se.add_argument("--parts", help="Comma-separated split output names when using split")
   ker_se.add_argument("--energies", help="Comma-separated split output energies when using split")
 
-  repl = sub.add_parser("repl", aliases=["sh"], help="Interactive REPL for symbols and imply")
+  sub.add_parser("repl", aliases=["sh"], help="Interactive REPL for symbols and imply")
 
   # plugin management
   pl = sub.add_parser("plugin", aliases=["pl"], help="Manage and load plugins (rule packs/grammars)")
   pl_sub = pl.add_subparsers(dest="plugin_cmd", required=True)
-  pl_list = pl_sub.add_parser("list", help="List discovered plugins in search paths")
+  pl_sub.add_parser("list", help="List discovered plugins in search paths")
   pl_val = pl_sub.add_parser("validate", help="Validate a plugin pack (YAML/JSON/Python)")
   pl_val.add_argument("name_or_path")
   pl_info = pl_sub.add_parser("info", help="Show plugin metadata")
@@ -560,7 +558,7 @@ def build_parser() -> argparse.ArgumentParser:
   # rich help
   hp = sub.add_parser("help", aliases=["h"], help="Show help or subcommand help (e.g. 'gdk9 help plugin')")
   hp.add_argument("topic", nargs="?", help="Optional topic or subcommand name")
-  hb = sub.add_parser("handbook", aliases=["hb"], help="Print comprehensive handbook (EN + RU)")
+  sub.add_parser("handbook", aliases=["hb"], help="Print comprehensive handbook (EN + RU)")
 
   # reset/clear
   rst = sub.add_parser("reset", aliases=["clear"], help="Reset state/config to defaults for a fresh start")
@@ -686,7 +684,6 @@ def main(argv: list[str] | None = None) -> int:
           sc  = r["class"]
           e   = r["energy"]
           vec = r["vector"]
-          form = "DC" if ch.isupper() else "ac"
           form_s = colorize("DC", "bold", use_color) if ch.isupper() \
                    else colorize("ac", "dim", use_color)
           t.row([colorize(ch, "bold", use_color),

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/egglog_bridge/dr_egglog.py

@@ -11,7 +11,7 @@ Saturation is two-phase so unbounded integer growth cannot explode the e-graph
 """
 from __future__ import annotations
 
-from typing import List, Sequence
+from typing import Sequence
 
 from egglog import (
     EGraph,

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/imply.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import math
 import re
 from dataclasses import dataclass, asdict
-from typing import Any, Dict, List, Tuple
+from typing import Any, Dict, List
 
 from .errors import InputError
 

gdk9_cli-0.4.0/gdk9/keysuite_bridge/__init__.py

@@ -0,0 +1,7 @@
+"""KeySuite conformance bridge adapters (outside gdk9.kernel).
+
+Phase B spike: thin helpers that map *partial-fit* vector classes onto
+existing kernel primitives. No FSM, no invented implication maths.
+See docs/KEYSUITE_BRIDGE.md.
+"""
+__version__ = "0.1.0"

gdk9_cli-0.4.0/gdk9/keysuite_bridge/compose.py

@@ -0,0 +1,35 @@
+"""Compose-vector adapter: content tokens → kernel Expression names.
+
+KeySuite ``compose.basic.*`` emits concatenated content on COMMIT. The kernel
+has no token stream or IDLE/COMPOSE FSM (Phase A: partial). This adapter only:
+
+1. Drops known COMMIT event tokens (SPACE / ENTER / TAB / TIMEOUT / DONE).
+2. Treats remaining tokens as symbol names for ``Expression.from_names``.
+3. Returns the expression for callers to assert ``text()`` / fusion energy.
+
+It does **not** implement bind, mode, abort, escape, rollback, or ERROR.
+"""
+from __future__ import annotations
+
+from typing import Sequence
+
+from gdk9.kernel import Expression, KernelPrinciple
+
+# Grammar COMMIT set (gdk9_keysuite grammar) — stripped, not executed as FSM.
+_COMMIT_TOKENS = frozenset({"SPACE", "ENTER", "TAB", "TIMEOUT", "DONE"})
+
+
+def content_names(tokens: Sequence[str]) -> tuple[str, ...]:
+  """Return non-COMMIT tokens as ordered symbol names."""
+  return tuple(t for t in tokens if t not in _COMMIT_TOKENS)
+
+
+def expression_from_compose_tokens(
+  tokens: Sequence[str],
+  principle: KernelPrinciple | None = None,
+) -> Expression:
+  """Build a kernel Expression from compose-vector content tokens."""
+  names = content_names(tokens)
+  if not names:
+    raise ValueError("compose adapter: no content tokens after stripping COMMIT")
+  return Expression.from_names(names, principle or KernelPrinciple.default())

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/optimize.py

@@ -246,7 +246,6 @@ def optimize_substitution(
   # DP over residues with minimal edits, tracking choices
   # state: residue -> (count, prev_residue, (pos, r, repl))
   best: Dict[int, Tuple[int, int, Tuple[int, int, Optional[str]]]] = {0: (0, -1, (-1, 0, None))}
-  frontier = [0]
   for i in range(n):
     new_best = best.copy()
     for res, (cnt, prev, info) in best.items():

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/plugins/__init__.py

@@ -5,5 +5,7 @@ grammars and rule packs at runtime. See `registry.py` for the current
 experimental surface.
 """
 
-from .registry import PluginRegistry  # re-export for convenience
+from .registry import PluginRegistry
+
+__all__ = ["PluginRegistry"]
 

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/plugins/loader.py

@@ -7,7 +7,7 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Any, Dict, Iterable, List, Optional, Tuple
 
-from ..errors import ConfigError, InputError
+from ..errors import ConfigError
 from ..imply import make_fusion, make_split, Rule, apply_rule
 from ..state import set_rule, set_symbol
 from ..principles import Principle

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/plugins/registry.py

@@ -8,7 +8,7 @@ This is a minimal in-memory registry intended as a stepping stone toward a
 dynamic plugin loader.
 """
 
-from typing import Any, Callable, Dict, Iterable, Optional
+from typing import Any, Callable, Dict, Iterable
 
 
 class PluginRegistry:

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/subs.py

@@ -4,7 +4,7 @@ import json
 from typing import Dict, List
 
 from .principles import Principle
-from .energy import char_energy, digital_root
+from .energy import char_energy
 
 
 ALL_LETTERS = [chr(c) for c in range(ord('A'), ord('Z') + 1)] + [chr(c) for c in range(ord('a'), ord('z') + 1)]

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9/tokenize.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import json
 import re
 from dataclasses import dataclass
-from typing import Dict, Iterable, List, Tuple
+from typing import Dict, List, Tuple
 
 from .ansi import colorize
 from .energy import string_energy, char_energy

gdk9_cli-0.4.0/gdk9_cli.egg-info/PKG-INFO

@@ -0,0 +1,138 @@
+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.

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/gdk9_cli.egg-info/SOURCES.txt

@@ -1,16 +1,6 @@
 LICENSE
 README.md
 pyproject.toml
-examples/01_analyze.py
-examples/02_profile.py
-examples/03_assign.py
-examples/04_dcg.py
-examples/05_tokenize.py
-examples/06_synthesize.py
-examples/07_api.py
-examples/08_kernel.py
-examples/09_kernel_search_walkthrough.py
-examples/10_conserve_vs_naive.py
 gdk9/__init__.py
 gdk9/ansi.py
 gdk9/cli.py
@@ -48,6 +38,8 @@ gdk9/kernel/principle.py
 gdk9/kernel/proof.py
 gdk9/kernel/rule.py
 gdk9/kernel/symbol.py
+gdk9/keysuite_bridge/__init__.py
+gdk9/keysuite_bridge/compose.py
 gdk9/plugins/__init__.py
 gdk9/plugins/loader.py
 gdk9/plugins/registry.py
@@ -57,12 +49,6 @@ gdk9_cli.egg-info/dependency_links.txt
 gdk9_cli.egg-info/entry_points.txt
 gdk9_cli.egg-info/requires.txt
 gdk9_cli.egg-info/top_level.txt
-scripts/batch_analyze.py
-scripts/export_json.py
-scripts/make_zip.py
-scripts/profile_compare.py
-scripts/watch_file.py
-tests/conftest.py
 tests/test_crypto.py
 tests/test_crypto_secure.py
 tests/test_dcg.py
@@ -77,9 +63,4 @@ tests/test_rules_commit.py
 tests/test_rules_reversibility.py
 tests/test_state_crdt.py
 tests/test_tokenize.py
-tests/test_tokenize_metrics.py
-tests/experiment/__init__.py
-tests/experiment/test_conserve_vs_naive.py
-tests/kernel/test_kernel_energy.py
-tests/kernel/test_kernel_rules.py
-tests/kernel/test_kernel_search_bound.py
+tests/test_tokenize_metrics.py

gdk9_cli-0.4.0/gdk9_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+gdk9

{gdk9_cli-0.3.0 → gdk9_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gdk9-cli"
-version = "0.3.0"
+version = "0.4.0"
 description = "GDk9 CLI — symbolic energy analysis, implication engine, and DCG tools"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -37,7 +37,7 @@ build = ["build"]
 secure = ["cryptography>=42.0.0"]
 
 [tool.setuptools]
-packages = { find = { where = ["."] } }
+packages = { find = { where = ["."], include = ["gdk9*"] } }
 
 [tool.setuptools.package-data]
 gdk9 = ["data/*.json"]
@@ -45,8 +45,15 @@ gdk9 = ["data/*.json"]
 [tool.ruff]
 line-length = 100
 target-version = "py39"
+# Legacy snapshots and the TS console are not linted.
+extend-exclude = ["legacy", "apps"]
+
+[tool.ruff.lint]
+# Syntax errors and pyflakes (unused/undefined names). Style rules are not enforced.
+select = ["E9", "F"]
 
 [tool.pytest.ini_options]
+testpaths = ["tests"]
 markers = [
   "egglog: requires optional egglog extra (pip install '.[egglog]'); skips if missing",
 ]