hakodesh 0.2.2__tar.gz → 0.2.3__tar.gz

hakodesh-0.2.3/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: hakodesh
+Version: 0.2.3
+Summary: Host-agnostic empty book with a deterministic procedural-memory runtime.
+Author: Shelleyguitar
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://pypi.org/project/hakodesh/
+Keywords: cli,sdk,spells,agents,receipts,akashic,grimoire
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: platformdirs<5,>=4.2
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# hakodesh
+
+Host-agnostic Python CLI and SDK. After `pip install hakodesh` the user book is empty. Your LLM or agents **mint** spells, enchantments, wards, and combos as they need them. Repeated structured workflows can be **remembered** and, after a configurable promotion policy, executed as deterministic procedures **without another LLM pass**.
+
+PyPI name and import: **hakodesh**. The command you type is **devra** — that is the `snx` role: `devra <spell> [args...]` casts a minted spell. `hakodesh` is the same CLI binary.
+
+This package does **not** prove SNX token savings. Measurements are recall, correctness, straight-through execution, re-entry, model turns, and host-reported context crossing.
+
+## Release
+
+Current PyPI version is **0.2.3**. `pip install hakodesh` installs this release. The command you type is **devra**.
+
+**0.2.0 and 0.2.1 were withdrawn** from the index (deleted, not yanked). 0.2.0's procedure integrity did not cover approval or routing state and parameterized replay reused last-seen literals. **0.1.0 remains** installable. **0.2.2 remains** as the previous current. 0.2.3 is the same runtime as 0.2.2; it teaches `devra` (the `snx` role), `spellbook`, and first-class `enchant` / `ward` / `combo`.
+
+Procedures are HMAC-authenticated with the home chain key. Arguments that vary across training traces become required slots; `decide` / `run` take `--bind name=value`. Unsigned 0.2.0 `vN.json` files fail closed until re-promoted.
+
+## Install
+
+```bash
+pip install hakodesh
+devra hello
+```
+
+Data home: `HAKODESH_HOME` or the platform user-data directory for `hakodesh`. Never `~/spells`.
+
+## Kernel commands
+
+These are the runtime, not starter spells. Minted spell names are **kebab-case**. Kernel verbs are single tokens (`devra`, `spellbook`, `run`). Two-word leftovers stay kebab as aliases (`grimoire-seal`, `run-intent`, `next-action`).
+
+### Cast
+
+| Command | What it does |
+|---|---|
+| `devra <spell> [args...]` | Cast a minted spell. Same job `snx <spell>` has on Magus. Alias: `hakodesh devra …` / `invoke` |
+
+### Spellbook
+
+| Command | What it does |
+|---|---|
+| `devra mint <name> --kind spell\|enchantment\|ward\|combo` | Scaffold into the spellbook (preview; `--confirm` writes) |
+| `devra spellbook` | List user artifacts (empty at install). Aliases: `catalog`, `book` |
+| `devra route "<intent>"` | Rank minted names plus kernel commands (may include procedure candidates) |
+
+### Kinds — enchantments, wards, combos
+
+These were never gone. They are first-class kernel commands:
+
+| Command | What it does |
+|---|---|
+| `devra enchant bind\|lift <name> --settings <path>` | Bind or lift a minted **enchantment** |
+| `devra ward status\|lock\|unlock\|check <name>` | Fail-closed **ward** |
+| `devra combo seal\|cast\|list [name]` | Sealed **combo** pipelines of minted spells |
+
+### Memory
+
+| Command | What it does |
+|---|---|
+| `devra remember --intent "…" --step spell:name --source host` | Record a structured execution trace (not an opaque receipt) |
+| `devra recall "<intent>"` | Local deterministic procedure recall |
+| `devra decide "<intent>" [--bind name=value]` | `execute` / `ask_model` / `ambiguous` / `blocked` / `not_found` |
+| `devra run "<intent>" [--bind name=value]` | Straight-through execute when decide says `execute`. Alias: `run-intent` |
+| `devra next --intent "…" [--bind name=value]` | Next validated procedure step, or a suggestion. Alias: `next-action` |
+| `devra rites` | List promoted procedures. Alias: `procedures` |
+| `devra approve <id> --confirm` | Approve a high-risk procedure |
+| `devra promote [--replace]` | Run promotion now (remember already tries after each success) |
+| `devra policy` | Show promotion policy (three-success default is an implementation policy, not SNX history) |
+| `devra metrics` | Recall / straight-through / re-entry / context-crossing stats |
+| `devra benchmark` | Isolated tempfile-home bench (not the operator home) |
+
+### Ledger
+
+| Command | What it does |
+|---|---|
+| `devra akashic` | Verify HMAC chain; `--tail N` |
+| `devra grimoire` | Cast ledger stats. `grimoire seal --confirm` writes the Merkle seal; `grimoire verify` checks it. Alias: `grimoire-seal` |
+| `devra protocol` | Print the `hakodesh.event/v1` contract descriptor |
+
+`--like` on an empty book uses the **kind template** in the wheel. After one spell exists, `--like <that>` copies its shape.
+
+Every mint and cast emits `hakodesh.event/v1`. Akashic is SHA-256 linked and HMAC-SHA256 signed. Grimoire is Merkle-sealed with the same chain key. Promoted procedures use that same home key for `procedure_mac`. The keystore is `$HAKODESH_HOME/keys` (0700/0600), minted on first seal, never in the wheel.
+
+Notifications default to `none`. The package does not write LaunchAgents or editor hooks until you mint and bind an enchantment.
+
+## SDK
+
+```python
+from hakodesh.catalog import catalog
+from hakodesh.mint import mint
+from hakodesh import events, akashic, grimoire
+from hakodesh.enchant import bind, lift
+from hakodesh.ward import unlock
+from hakodesh.combo import seal, cast
+from hakodesh.memory import remember, recall, decide, run_intent, next_action, approve
+```
+
+See `docs/PROCEDURAL_MEMORY.md` and `docs/MIGRATION.md`.
+
+## Empty book law
+
+A fresh install has zero user spells, enchantments, wards, combos, or promoted procedures. Discovery picks up a file the moment it lands under `HAKODESH_HOME/book/`.

hakodesh-0.2.3/README.md

@@ -0,0 +1,100 @@
+# hakodesh
+
+Host-agnostic Python CLI and SDK. After `pip install hakodesh` the user book is empty. Your LLM or agents **mint** spells, enchantments, wards, and combos as they need them. Repeated structured workflows can be **remembered** and, after a configurable promotion policy, executed as deterministic procedures **without another LLM pass**.
+
+PyPI name and import: **hakodesh**. The command you type is **devra** — that is the `snx` role: `devra <spell> [args...]` casts a minted spell. `hakodesh` is the same CLI binary.
+
+This package does **not** prove SNX token savings. Measurements are recall, correctness, straight-through execution, re-entry, model turns, and host-reported context crossing.
+
+## Release
+
+Current PyPI version is **0.2.3**. `pip install hakodesh` installs this release. The command you type is **devra**.
+
+**0.2.0 and 0.2.1 were withdrawn** from the index (deleted, not yanked). 0.2.0's procedure integrity did not cover approval or routing state and parameterized replay reused last-seen literals. **0.1.0 remains** installable. **0.2.2 remains** as the previous current. 0.2.3 is the same runtime as 0.2.2; it teaches `devra` (the `snx` role), `spellbook`, and first-class `enchant` / `ward` / `combo`.
+
+Procedures are HMAC-authenticated with the home chain key. Arguments that vary across training traces become required slots; `decide` / `run` take `--bind name=value`. Unsigned 0.2.0 `vN.json` files fail closed until re-promoted.
+
+## Install
+
+```bash
+pip install hakodesh
+devra hello
+```
+
+Data home: `HAKODESH_HOME` or the platform user-data directory for `hakodesh`. Never `~/spells`.
+
+## Kernel commands
+
+These are the runtime, not starter spells. Minted spell names are **kebab-case**. Kernel verbs are single tokens (`devra`, `spellbook`, `run`). Two-word leftovers stay kebab as aliases (`grimoire-seal`, `run-intent`, `next-action`).
+
+### Cast
+
+| Command | What it does |
+|---|---|
+| `devra <spell> [args...]` | Cast a minted spell. Same job `snx <spell>` has on Magus. Alias: `hakodesh devra …` / `invoke` |
+
+### Spellbook
+
+| Command | What it does |
+|---|---|
+| `devra mint <name> --kind spell\|enchantment\|ward\|combo` | Scaffold into the spellbook (preview; `--confirm` writes) |
+| `devra spellbook` | List user artifacts (empty at install). Aliases: `catalog`, `book` |
+| `devra route "<intent>"` | Rank minted names plus kernel commands (may include procedure candidates) |
+
+### Kinds — enchantments, wards, combos
+
+These were never gone. They are first-class kernel commands:
+
+| Command | What it does |
+|---|---|
+| `devra enchant bind\|lift <name> --settings <path>` | Bind or lift a minted **enchantment** |
+| `devra ward status\|lock\|unlock\|check <name>` | Fail-closed **ward** |
+| `devra combo seal\|cast\|list [name]` | Sealed **combo** pipelines of minted spells |
+
+### Memory
+
+| Command | What it does |
+|---|---|
+| `devra remember --intent "…" --step spell:name --source host` | Record a structured execution trace (not an opaque receipt) |
+| `devra recall "<intent>"` | Local deterministic procedure recall |
+| `devra decide "<intent>" [--bind name=value]` | `execute` / `ask_model` / `ambiguous` / `blocked` / `not_found` |
+| `devra run "<intent>" [--bind name=value]` | Straight-through execute when decide says `execute`. Alias: `run-intent` |
+| `devra next --intent "…" [--bind name=value]` | Next validated procedure step, or a suggestion. Alias: `next-action` |
+| `devra rites` | List promoted procedures. Alias: `procedures` |
+| `devra approve <id> --confirm` | Approve a high-risk procedure |
+| `devra promote [--replace]` | Run promotion now (remember already tries after each success) |
+| `devra policy` | Show promotion policy (three-success default is an implementation policy, not SNX history) |
+| `devra metrics` | Recall / straight-through / re-entry / context-crossing stats |
+| `devra benchmark` | Isolated tempfile-home bench (not the operator home) |
+
+### Ledger
+
+| Command | What it does |
+|---|---|
+| `devra akashic` | Verify HMAC chain; `--tail N` |
+| `devra grimoire` | Cast ledger stats. `grimoire seal --confirm` writes the Merkle seal; `grimoire verify` checks it. Alias: `grimoire-seal` |
+| `devra protocol` | Print the `hakodesh.event/v1` contract descriptor |
+
+`--like` on an empty book uses the **kind template** in the wheel. After one spell exists, `--like <that>` copies its shape.
+
+Every mint and cast emits `hakodesh.event/v1`. Akashic is SHA-256 linked and HMAC-SHA256 signed. Grimoire is Merkle-sealed with the same chain key. Promoted procedures use that same home key for `procedure_mac`. The keystore is `$HAKODESH_HOME/keys` (0700/0600), minted on first seal, never in the wheel.
+
+Notifications default to `none`. The package does not write LaunchAgents or editor hooks until you mint and bind an enchantment.
+
+## SDK
+
+```python
+from hakodesh.catalog import catalog
+from hakodesh.mint import mint
+from hakodesh import events, akashic, grimoire
+from hakodesh.enchant import bind, lift
+from hakodesh.ward import unlock
+from hakodesh.combo import seal, cast
+from hakodesh.memory import remember, recall, decide, run_intent, next_action, approve
+```
+
+See `docs/PROCEDURAL_MEMORY.md` and `docs/MIGRATION.md`.
+
+## Empty book law
+
+A fresh install has zero user spells, enchantments, wards, combos, or promoted procedures. Discovery picks up a file the moment it lands under `HAKODESH_HOME/book/`.

{hakodesh-0.2.2 → hakodesh-0.2.3}/docs/IMPLEMENTATION.md

@@ -1,4 +1,4 @@
-# Hakodesh 0.2.2 — procedural memory implementation report
+# Hakodesh 0.2.3 — procedural memory implementation report
 
 This implementation does **not** prove SNX token savings. Tests and measurements establish local recall, promotion, straight-through execution, fail-closed safety, and host-reported context accounting only.
 
@@ -10,14 +10,14 @@ Public 0.2.0 needed correction. 0.2.1 ships:
 |---|---|
 | HKD-020-001 | HMAC-SHA256 `procedure_mac` over the full authenticated body including `risk.approved`; `approve()` writes `vN+1` and emits `procedure.approved` |
 | HKD-020-002 | `intent_example`, `normalized_intent`, tags, aliases, and status are in the authenticated body |
-| HKD-020-003 | Varying training args become required slots; `run-intent --bind` / SDK `bindings=`; fail closed if missing |
+| HKD-020-003 | Varying training args become required slots; `run --bind` / SDK `bindings=`; fail closed if missing |
 | HKD-020-004 | Every success slice is searched; the latest clean cluster is promoted |
 | HKD-020-005 | Promotion uses `_cluster_confidence` vs `min_confidence`; policy probabilities must be in `[0, 1]` |
 | HKD-020-006 | Benchmark no longer double-counts `task_complete` on a successful replay |
 | HKD-020-007 | `procedure.recorded`, `procedure.failed`, and `procedure.decision` are emitted |
 | HKD-020-008 | 0.1.0 **sdist** sha256 `3e5959447bd1999797104a7fe27a3b6bc1253d2fb534d03809fbc7ed4ae91257`; **wheel** sha256 `7e74e20de8aa1af606299ae64d2fc01c89627dc405b668f159c957b1b23c8145` |
 
-Public **0.2.0** needed that correction and was later withdrawn from the index. **0.2.2** is the same runtime with README and shipped docs that match the live index: https://pypi.org/project/hakodesh/0.2.2/
+Public **0.2.0** needed that correction and was later withdrawn from the index. **0.2.1** (the HMAC/`--bind` runtime) was also Chrome-deleted after **0.2.2** landed. **0.2.3** is that same runtime with `devra` / `spellbook` / kinds as the taught CLI: https://pypi.org/project/hakodesh/0.2.3/
 
 ## Files changed
 
@@ -34,14 +34,14 @@ Modified:
 
 - `src/hakodesh/{cli,catalog,home,events,__init__}.py`
 - `src/hakodesh/contracts/hakodesh-event-v1.json`
-- `pyproject.toml` (0.2.2)
+- `pyproject.toml` (0.2.3)
 - `README.md`, `docs/PROTOCOL.md`
 
 SNX was not modified.
 
 ## Architecture implemented
 
-Structured host/agent/executor traces → configurable promotion → versioned hashed procedures → local recall (Jaccard + sequence + tags, no LLM/network) → `decide` → optional straight-through `run-intent` via existing `dispatch.invoke`. Compact receipts stay small; audit JSON stays on disk. Optional `ModelAdapter` exists for hosts and is never called by the executor.
+Structured host/agent/executor traces → configurable promotion → versioned hashed procedures → local recall (Jaccard + sequence + tags, no LLM/network) → `decide` → optional straight-through `run` via existing `dispatch.invoke`. Compact receipts stay small; audit JSON stays on disk. Optional `ModelAdapter` exists for hosts and is never called by the executor.
 
 ## Promotion and time-window policy
 
@@ -57,7 +57,7 @@ Wards run at the execution boundary before `dispatch.invoke`. Procedure HMAC (ho
 
 ## Backward compatibility
 
-`catalog`, `route` (richer keys), `mint` preview/`--confirm`, `invoke <name>`, `combo`, existing events remain. Fresh install: zero user artifacts and zero procedures.
+`spellbook` (aliases `catalog`, `book`), `route` (richer keys), `mint` preview/`--confirm`, `devra <spell>` to cast, `combo` / `ward` / `enchant`, existing events remain. Fresh install: zero user artifacts and zero procedures.
 
 ## Tests run and results
 

{hakodesh-0.2.2 → hakodesh-0.2.3}/docs/MIGRATION.md

@@ -1,8 +1,23 @@
 # Migration
 
+## 0.2.2 → 0.2.3
+
+0.2.3 does **not** change runtime behavior. It is the CLI-name release: **devra** is the caster (`snx` role), **spellbook** lists artifacts, and enchantments / wards / combos are first-class kinds. Old names remain aliases. Current install is **0.2.3**. **0.2.0 and 0.2.1 were withdrawn** (deleted, not yanked). **0.1.0 and 0.2.2 stay.**
+
+| Old | Now |
+|---|---|
+| `snx <spell>` / `invoke` / type the name | `devra <spell>` (package CLI alias: `hakodesh`) |
+| `catalog` / `book` | `spellbook` |
+| `run-intent` | `run` |
+| `next-action` | `next` |
+| `procedures` | `rites` |
+| `grimoire-seal` / `grimoire-seal --verify` | `grimoire seal` / `grimoire verify` |
+
+Nothing is hidden. Enchantments, wards, and combos are the `kinds` group: `enchant`, `ward`, `combo`. `promote`, `benchmark`, and `protocol` sit in memory/ledger.
+
 ## 0.2.1 → 0.2.2
 
-0.2.2 does **not** change runtime behavior. It is the public-metadata release: README and shipped docs now match the live index. Current install is **0.2.2**. **0.2.0 was withdrawn** (deleted, not yanked). **0.1.0 stays.** 0.2.1 on the index is replaced by 0.2.2 after this upload.
+0.2.2 does **not** change runtime behavior. It is the public-metadata release: README and shipped docs now match the live index. Current install is **0.2.2**. **0.2.0 and 0.2.1 were withdrawn** (deleted, not yanked). **0.1.0 stays.**
 
 ## 0.2.0 → 0.2.1
 
@@ -18,7 +33,7 @@
 | Benchmark accounting | One `task_complete` per successful replay (execute already records it). |
 | Lifecycle events | `procedure.recorded`, `procedure.failed`, `procedure.decision`, and `procedure.approved` are now emitted. |
 
-**PyPI current is 0.2.2:** https://pypi.org/project/hakodesh/0.2.2/ — 0.2.0 was withdrawn (deleted, not yanked). 0.1.0 stays on the index.
+**PyPI current is 0.2.3:** https://pypi.org/project/hakodesh/0.2.3/ — 0.2.0 and 0.2.1 were withdrawn (deleted, not yanked). 0.1.0 and 0.2.2 stay on the index.
 
 ## 0.1.0 → 0.2.0
 
@@ -27,7 +42,7 @@ Hakodesh 0.2.0 is a compatibility-preserving extension. Existing 0.1.0 homes kee
 ## What stays the same
 
 - Empty-book law: fresh install still has zero user spells, enchantments, wards, combos, **and** zero promoted procedures.
-- `catalog`, `mint` (preview / `--confirm`), `invoke <name>`, `combo`, Akashic HMAC chain, Grimoire Merkle seal, wards, enchant bind/lift.
+- `spellbook` (aliases `catalog`, `book`), `mint` (preview / `--confirm`), `devra <spell>` to cast, `combo`, Akashic HMAC chain, Grimoire Merkle seal, wards, enchant bind/lift.
 - Existing `hakodesh.event/v1` lines remain readable. New kinds are additive.
 - Data still lives under `HAKODESH_HOME`, never `~/spells`.
 
@@ -40,7 +55,7 @@ Hakodesh 0.2.0 is a compatibility-preserving extension. Existing 0.1.0 homes kee
 | `$HAKODESH_HOME/memory/policy.json` | Promotion policy (created when saved) |
 | `$HAKODESH_HOME/memory/metrics.jsonl` | Recall / decide / execute instrumentation |
 
-New kernel commands: `remember`, `recall`, `decide`, `run-intent`, `next-action`, `promote`, `procedures`, `approve`, `metrics`, `policy`, `benchmark`.
+New kernel commands: `remember`, `recall`, `decide`, `run` (alias `run-intent`), `next` (alias `next-action`), `rites` (alias `procedures`), `approve`, `metrics`, `policy`, `promote`, `benchmark`, `protocol`. Cast is `devra`. Artifact list is `spellbook`. `grimoire seal` / `grimoire verify` replace `grimoire-seal` as the taught form.
 
 `route` still returns `matches`. It may also include `procedures` and `decision_hint`.
 

{hakodesh-0.2.2 → hakodesh-0.2.3}/docs/PROCEDURAL_MEMORY.md

@@ -1,6 +1,6 @@
 # Procedural memory
 
-Hakodesh 0.2.2 ships a **deterministic procedural-memory runtime** (same behavior as 0.2.1). It does not use an LLM, embeddings service, or network call on the default recall / decide / execute path.
+Hakodesh 0.2.3 ships a **deterministic procedural-memory runtime** (same behavior as 0.2.2 / 0.2.1). It does not use an LLM, embeddings service, or network call on the default recall / decide / execute path.
 
 This is not a claim about SNX token savings. The three-success promotion default is an **implementation policy**, not evidence about SNX's historical rule.
 
@@ -24,7 +24,7 @@ host/agent structured trace
         ▼
  decide() ── execute | ask_model | ambiguous | blocked | not_found
         │
-        ├── execute ──► run-intent: ward + HMAC + scope + approval + bindings, then dispatch.invoke
+        ├── execute ──► run: ward + HMAC + scope + approval + bindings, then dispatch.invoke
         │                 compact receipt; audit on disk
         └── otherwise ──► needs_model_reasoning; no speculative recovery
 ```
@@ -51,7 +51,7 @@ Low-confidence and ambiguous matches never execute automatically.
 | Crosses into a model | Stays local |
 |---|---|
 | Host-reported `model_crossed_bytes` / `billed_tokens` / `model_turns` | traces, procedures, receipts, Akashic, Grimoire, metrics.jsonl, compact CLI JSON |
-| Optional host `ModelAdapter.reason` after `needs_model_reasoning` | straight-through `run-intent` |
+| Optional host `ModelAdapter.reason` after `needs_model_reasoning` | straight-through `run` |
 
 The executor never instantiates a model adapter. Receipt **size** is not a proxy for reasoning avoided.
 
@@ -83,16 +83,16 @@ Visible on every promotion receipt and `hakodesh policy`.
 ## CLI
 
 ```
-hakodesh remember --intent "…" --step spell:name[:arg] --source host --outcome success
-hakodesh recall "…"
-hakodesh decide "…" [--bind name=value]
-hakodesh run-intent "…" [--bind name=value]
-hakodesh next-action --intent "…" [--bind name=value]
-hakodesh procedures
-hakodesh approve proc_… --confirm
-hakodesh policy
-hakodesh metrics
-hakodesh benchmark
+devra remember --intent "…" --step spell:name[:arg] --source host --outcome success
+devra recall "…"
+devra decide "…" [--bind name=value]
+devra run "…" [--bind name=value]
+devra next --intent "…" [--bind name=value]
+devra rites
+devra approve proc_… --confirm
+devra policy
+devra metrics
+devra benchmark
 ```
 
 ## SDK

{hakodesh-0.2.2 → hakodesh-0.2.3}/docs/PROTOCOL.md

@@ -34,7 +34,7 @@ Key: `$HAKODESH_HOME/keys/akashic-chain-hmac` (dir 0700, file 0600), minted on f
 
 ## Grimoire Merkle seal
 
-`HAKODESH_HOME/grimoire.jsonl` is the cast ledger. `grimoire-seal` builds RFC 6962 trees (leaf prefix `0x00`, node prefix `0x01`): per-day batch roots, then a master root over `day + 0x1f + day_root` leaves. Head MAC: `HMAC(grimoire-merkle:{root}:{lines}:{key_fp})` with the Akashic chain key.
+`HAKODESH_HOME/grimoire.jsonl` is the cast ledger. `grimoire seal` builds RFC 6962 trees (leaf prefix `0x00`, node prefix `0x01`): per-day batch roots, then a master root over `day + 0x1f + day_root` leaves. Head MAC: `HMAC(grimoire-merkle:{root}:{lines}:{key_fp})` with the Akashic chain key. `grimoire-seal` remains an alias.
 
 ## Mint lifecycle
 

{hakodesh-0.2.2 → hakodesh-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hakodesh"
-version = "0.2.2"
+version = "0.2.3"
 description = "Host-agnostic empty book with a deterministic procedural-memory runtime."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -29,6 +29,7 @@ dev = ["pytest>=8.0", "build>=1.2", "twine>=5.0"]
 
 [project.scripts]
 hakodesh = "hakodesh.cli:main"
+devra = "hakodesh.cli:main"
 
 [project.urls]
 Homepage = "https://pypi.org/project/hakodesh/"

{hakodesh-0.2.2 → hakodesh-0.2.3}/src/hakodesh/__init__.py

@@ -11,7 +11,7 @@ from .grimoire import seal as grimoire_seal
 from .memory import approve, decide, metrics_summary, next_action, recall, remember, run_intent
 from .ward import unlock
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"
 __all__ = [
     "list_catalog",
     "route",

{hakodesh-0.2.2 → hakodesh-0.2.3}/src/hakodesh/catalog.py

@@ -7,28 +7,45 @@ from pathlib import Path
 
 from . import home as paths
 
-KERNEL = (
-    "mint",
-    "catalog",
-    "route",
-    "invoke",
-    "akashic",
-    "grimoire",
-    "grimoire-seal",
-    "enchant",
-    "ward",
-    "combo",
-    "remember",
-    "recall",
-    "decide",
-    "run-intent",
-    "next-action",
-    "promote",
-    "procedures",
-    "approve",
-    "metrics",
-    "policy",
-)
+# Advertised kernel — primary names only. Old names live in ALIASES and still dispatch.
+# `devra` is the snx-shaped caster: `devra <spell> [args...]`.
+# Minted spell names are kebab-case. Kernel verbs are single tokens unless they already were kebab aliases.
+KERNEL_GROUPS = {
+    "cast": ("devra",),
+    "spellbook": ("mint", "spellbook", "route"),
+    "kinds": ("enchant", "ward", "combo"),
+    "memory": (
+        "remember",
+        "recall",
+        "decide",
+        "run",
+        "next",
+        "rites",
+        "approve",
+        "promote",
+        "policy",
+        "metrics",
+        "benchmark",
+    ),
+    "ledger": ("akashic", "grimoire", "protocol"),
+}
+KERNEL = tuple(name for group in KERNEL_GROUPS.values() for name in group)
+ALIASES = {
+    "catalog": "spellbook",
+    "book": "spellbook",
+    "invoke": "devra",
+    "run-intent": "run",
+    "run_intent": "run",
+    "next-action": "next",
+    "next_action": "next",
+    "procedures": "rites",
+    "grimoire-seal": "grimoire",
+}
+KINDS_DETAIL = {
+    "enchant": "enchantments — bind|lift <name> --settings PATH [--confirm]",
+    "ward": "wards — status|lock|unlock|check <name>",
+    "combo": "combos — seal|cast|list [name]",
+}
 
 
 def _load_spell(path: Path):
@@ -86,6 +103,9 @@ def catalog(root: Path | None = None):
             for item in items
         ],
         "kernel": list(KERNEL),
+        "groups": {key: list(names) for key, names in KERNEL_GROUPS.items()},
+        "aliases": dict(ALIASES),
+        "kinds": dict(KINDS_DETAIL),
     }
 
 
@@ -97,6 +117,10 @@ def route(intent: str, root: Path | None = None):
     intent = (intent or "").lower()
     scored = []
     haystacks = [(name, "kernel command %s" % name, "kernel") for name in KERNEL]
+    haystacks.extend(
+        (alias, "kernel command %s alias %s" % (alias, target), "kernel")
+        for alias, target in ALIASES.items()
+    )
     for item in user_artifacts(root):
         desc = item.get("descriptor") or {}
         hay = "%s %s %s" % (item["name"], desc.get("purpose", ""), " ".join(desc.get("tags") or []))

{hakodesh-0.2.2 → hakodesh-0.2.3}/src/hakodesh/cli.py

@@ -1,4 +1,4 @@
-"""hakodesh CLI — JSON in / JSON out. No snx shim."""
+"""devra CLI — JSON in / JSON out. Package import remains hakodesh."""
 from __future__ import annotations
 
 import json
@@ -96,8 +96,13 @@ def main(argv=None) -> int:
     if not argv or argv[0] in ("-h", "--help", "help"):
         emit(
             {
-                "usage": "hakodesh <catalog|route|invoke|mint|akashic|grimoire|grimoire-seal|enchant|ward|combo|remember|recall|decide|run-intent|next-action|promote|procedures|approve|metrics|policy|NAME> [args]",
+                "usage": "devra <command> [args]",
+                "package": "hakodesh",
+                "cast": "devra <spell> [args...]",
+                "groups": {key: list(names) for key, names in catalog.KERNEL_GROUPS.items()},
+                "kinds": dict(catalog.KINDS_DETAIL),
                 "kernel": list(catalog.KERNEL),
+                "aliases": dict(catalog.ALIASES),
             }
         )
         return 0
@@ -115,16 +120,16 @@ def main(argv=None) -> int:
 
 def _dispatch(cmd, rest):
     confirm = _has(rest, "--confirm")
-    if cmd == "catalog":
+    if cmd in {"spellbook", "book", "catalog"}:
         return catalog.catalog()
     if cmd == "route":
         return catalog.route(" ".join(rest))
-    if cmd == "invoke":
+    if cmd in {"devra", "invoke"}:
         if not rest:
-            return {"ok": False, "error": "usage: invoke <name> [args...]"}
+            return {"ok": False, "error": "usage: devra <spell> [args...]"}
         if rest[0] == "--route":
             return catalog.route(" ".join(rest[1:]))
-        if rest[0] == "--catalog":
+        if rest[0] in {"--catalog", "--spellbook"}:
             return catalog.catalog()
         return dispatch.invoke(rest[0], rest[1:])
     if cmd == "mint":
@@ -141,7 +146,16 @@ def _dispatch(cmd, rest):
             return {"ok": True, "events": akashic.tail_events(n)}
         return akashic.verify_chain(strict=_has(rest, "--strict"))
     if cmd == "grimoire":
-        return grimoire.stats()
+        if _has(rest, "--verify"):
+            return grimoire.verify()
+        action = rest[0] if rest else "stats"
+        if action in {"stats", "status"}:
+            return grimoire.stats()
+        if action == "seal":
+            return grimoire.seal(confirm=confirm)
+        if action == "verify":
+            return grimoire.verify()
+        return {"ok": False, "error": "usage: grimoire [stats|seal|verify]"}
     if cmd == "grimoire-seal":
         if _has(rest, "--verify"):
             return grimoire.verify()
@@ -287,14 +301,14 @@ def _memory_dispatch(cmd, rest, confirm):
     if cmd == "decide":
         bindings, leftover = _parse_bindings(rest)
         return decide(" ".join(leftover), bindings=bindings or None)
-    if cmd in {"run-intent", "run_intent"}:
+    if cmd in {"run", "run-intent", "run_intent"}:
         bindings, leftover = _parse_bindings(rest)
         return run_intent(
             " ".join(x for x in leftover if x != "--full"),
             full=_has(rest, "--full"),
             bindings=bindings or None,
         )
-    if cmd in {"next-action", "next_action"}:
+    if cmd in {"next", "next-action", "next_action"}:
         bindings, leftover = _parse_bindings(rest)
         after = _flag(leftover, "--after-step")
         intent = _flag(leftover, "--intent") or " ".join(
@@ -307,7 +321,7 @@ def _memory_dispatch(cmd, rest, confirm):
         )
     if cmd == "promote":
         return promote_mod.maybe_promote(replace=_has(rest, "--replace"))
-    if cmd == "procedures":
+    if cmd in {"rites", "procedures"}:
         rows = procedures_mod.list_procedures()
         return {"ok": True, "count": len(rows), "procedures": rows}
     if cmd == "approve":

{hakodesh-0.2.2 → hakodesh-0.2.3}/src/hakodesh/dispatch.py

@@ -8,8 +8,8 @@ from . import akashic, catalog, events, grimoire
 
 def invoke(name: str, args=None, *, surface="cli", root=None) -> dict:
     args = list(args or [])
-    if name == "invoke":
-        return {"ok": False, "error": "invoke cannot invoke itself"}
+    if name in {"invoke", "devra"}:
+        return {"ok": False, "error": "%s cannot invoke itself" % name}
     reg = catalog.registry(root)
     item = reg.get(name)
     if not item or item["kind"] != "spell" or item.get("run") is None:

{hakodesh-0.2.2 → hakodesh-0.2.3}/src/hakodesh/grimoire.py

@@ -98,7 +98,19 @@ def log_cast(
     event_id=None,
     root=None,
 ):
-    if spell in {"grimoire", "grimoire-seal", "akashic", "catalog", "route"}:
+    if spell in {
+        "grimoire",
+        "grimoire-seal",
+        "akashic",
+        "catalog",
+        "book",
+        "spellbook",
+        "devra",
+        "invoke",
+        "route",
+        "rites",
+        "procedures",
+    }:
         return {"ok": True, "status": "excluded", "spell": spell}
     try:
         try:

{hakodesh-0.2.2 → hakodesh-0.2.3}/src/hakodesh/memory/__init__.py

@@ -1,4 +1,4 @@
-"""Procedural memory runtime: remember, recall, decide, run-intent, promote."""
+"""Procedural memory runtime: remember, recall, decide, run, next, rites."""
 from __future__ import annotations
 
 from .decide import decide