hakodesh 0.2.2__tar.gz → 0.2.4__tar.gz

{hakodesh-0.2.2/src/hakodesh.egg-info → hakodesh-0.2.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: hakodesh
-Version: 0.2.2
-Summary: Host-agnostic empty book with a deterministic procedural-memory runtime.
+Version: 0.2.4
+Summary: Host-agnostic empty book: mint spells, enchantments, wards, and combos as you need them.
 Author: Shelleyguitar
 License-Expression: LicenseRef-Proprietary
 Project-URL: Homepage, https://pypi.org/project/hakodesh/
@@ -26,20 +26,10 @@ 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**.
+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.
 
 PyPI name, import, and command: **hakodesh**. Not snax. Not snx.
 
-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.2**. `pip install hakodesh` installs this release.
-
-**0.2.0 was withdrawn** from the index (deleted, not yanked) because procedure integrity did not cover approval or routing state and parameterized replay reused last-seen literals. **0.1.0 remains** installable. 0.2.2 is the same runtime as the Watson HMAC / `--bind` fix first shipped as 0.2.1; this version only makes the public page and shipped docs match that fact.
-
-Procedures are HMAC-authenticated with the home chain key. Arguments that vary across training traces become required slots; `decide` / `run-intent` take `--bind name=value`. Unsigned 0.2.0 `vN.json` files fail closed until re-promoted.
-
 ## Install
 
 ```bash
@@ -55,18 +45,9 @@ These are the runtime, not starter spells:
 | Command | What it does |
 |---|---|
 | `hakodesh catalog` | User artifacts in the book (empty at install) |
-| `hakodesh route "<intent>"` | Rank minted names plus kernel commands (may include procedure candidates) |
+| `hakodesh route "<intent>"` | Rank minted names plus kernel commands |
 | `hakodesh invoke <name> [args...]` | Cast a minted spell by name |
 | `hakodesh mint <name> --kind spell\|enchantment\|ward\|combo` | Scaffold into the book (preview; `--confirm` writes) |
-| `hakodesh remember --intent "…" --step spell:name --source host` | Record a structured execution trace (not an opaque receipt) |
-| `hakodesh recall "<intent>"` | Local deterministic procedure recall |
-| `hakodesh decide "<intent>" [--bind name=value]` | `execute` / `ask_model` / `ambiguous` / `blocked` / `not_found` |
-| `hakodesh run-intent "<intent>" [--bind name=value]` | Straight-through execute when decide says `execute` |
-| `hakodesh next-action --intent "…" [--bind name=value]` | Next validated procedure step, or a suggestion |
-| `hakodesh procedures` | List promoted procedures |
-| `hakodesh approve <id> --confirm` | Approve a high-risk procedure |
-| `hakodesh policy` | Show promotion policy (three-success default is an implementation policy, not SNX history) |
-| `hakodesh metrics` | Recall / straight-through / re-entry / context-crossing stats |
 | `hakodesh akashic` | Verify HMAC chain; `--tail N` |
 | `hakodesh grimoire` | Cast ledger stats |
 | `hakodesh grimoire-seal` | RFC 6962 Merkle seal (preview; `--confirm` writes; `--verify`) |
@@ -77,7 +58,7 @@ These are the runtime, not starter spells:
 
 `--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.
+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. 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.
 
@@ -90,11 +71,8 @@ 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/`.
+A fresh install has zero user spells, enchantments, wards, or combos. Discovery picks up a file the moment it lands under `HAKODESH_HOME/book/`.

hakodesh-0.2.4/README.md

@@ -0,0 +1,52 @@
+# 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.
+
+PyPI name, import, and command: **hakodesh**. Not snax. Not snx.
+
+## Install
+
+```bash
+pip install hakodesh
+```
+
+Data home: `HAKODESH_HOME` or the platform user-data directory for `hakodesh`. Never `~/spells`.
+
+## Kernel commands
+
+These are the runtime, not starter spells:
+
+| Command | What it does |
+|---|---|
+| `hakodesh catalog` | User artifacts in the book (empty at install) |
+| `hakodesh route "<intent>"` | Rank minted names plus kernel commands |
+| `hakodesh invoke <name> [args...]` | Cast a minted spell by name |
+| `hakodesh mint <name> --kind spell\|enchantment\|ward\|combo` | Scaffold into the book (preview; `--confirm` writes) |
+| `hakodesh akashic` | Verify HMAC chain; `--tail N` |
+| `hakodesh grimoire` | Cast ledger stats |
+| `hakodesh grimoire-seal` | RFC 6962 Merkle seal (preview; `--confirm` writes; `--verify`) |
+| `hakodesh enchant bind\|lift <name> --settings <path>` | Bind or lift a minted enchantment |
+| `hakodesh ward status\|lock\|unlock\|check <name>` | Fail-closed ward kernel |
+| `hakodesh combo seal\|cast\|list [name]` | Sealed pipelines of minted spells |
+| `hakodesh <minted-name> [args...]` | Cast after mint |
+
+`--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. 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
+```
+
+## Empty book law
+
+A fresh install has zero user spells, enchantments, wards, or combos. Discovery picks up a file the moment it lands under `HAKODESH_HOME/book/`.

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

@@ -16,7 +16,7 @@ Canonical JSON: sorted keys, compact separators, UTF-8. Same hashes as `everplay
 
 Default `notification_policy` is `none`.
 
-Mint emits kind `artifact.minted`. Casts emit `spell.cast.started` / `completed` / `failed`. Procedure lifecycle emits `procedure.recorded`, `procedure.promoted`, `procedure.executed`, `procedure.failed`, `procedure.decision`, and `procedure.approved`. Procedure artifacts are HMAC-SHA256 authenticated with the home chain key.
+Mint emits kind `artifact.minted`. Casts emit `spell.cast.started` / `completed` / `failed`.
 
 ## Akashic chain
 
@@ -54,12 +54,3 @@ All runtime state is under `HAKODESH_HOME` (or platformdirs):
 - `akashic/`
 - `grimoire.jsonl` / `grimoire_head.json`
 - `keys/`
-- `memory/traces.jsonl`
-- `memory/procedures/<id>/vN.json`
-- `memory/policy.json`
-- `memory/metrics.jsonl`
-
-## Procedural memory
-
-See `docs/PROCEDURAL_MEMORY.md`. Promotion default: three successful structured traces, same procedure signature, compatible safety scope, inside `window_seconds`. That default is an implementation policy, not SNX history. Opaque receipts are not a promotion source.
-

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

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hakodesh"
-version = "0.2.2"
-description = "Host-agnostic empty book with a deterministic procedural-memory runtime."
+version = "0.2.4"
+description = "Host-agnostic empty book: mint spells, enchantments, wards, and combos as you need them."
 readme = "README.md"
 requires-python = ">=3.10"
 license = "LicenseRef-Proprietary"
@@ -44,5 +44,4 @@ hakodesh = ["templates/*", "contracts/*.json"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-pythonpath = ["src"]
 addopts = "-q"

{hakodesh-0.2.2 → hakodesh-0.2.4}/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.4}/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.4}/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.4}/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.4}/src/hakodesh/events.py

@@ -98,9 +98,9 @@ SUBJECT_FIELDS = frozenset(
 )
 
 _EVENT_ID = re.compile(r"^evt_[a-f0-9]{32}$")
-_IDEMPOTENCY_KEY = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$")
+_IDEMPOTENCY_KEY = re.compile(r"^[A-Za-z0-9֐-׿][A-Za-z0-9._:\-֐-׿]{7,127}$")
 _STATE = re.compile(r"^[a-z][a-z0-9._-]{1,63}$")
-_ACTOR_ID = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._:-]{2,127}$")
+_ACTOR_ID = re.compile(r"^[A-Za-z0-9֐-׿][A-Za-z0-9._:\-֐-׿]{2,127}$")
 _SENSITIVE_KEY = re.compile(
     r"(?:^|_)(?:token|secret|password|authorization|api_?key|private_?key|"
     r"webhook_?url|credential)(?:$|_)",

{hakodesh-0.2.2 → hakodesh-0.2.4}/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.4}/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

{hakodesh-0.2.2 → hakodesh-0.2.4/src/hakodesh.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: hakodesh
-Version: 0.2.2
-Summary: Host-agnostic empty book with a deterministic procedural-memory runtime.
+Version: 0.2.4
+Summary: Host-agnostic empty book: mint spells, enchantments, wards, and combos as you need them.
 Author: Shelleyguitar
 License-Expression: LicenseRef-Proprietary
 Project-URL: Homepage, https://pypi.org/project/hakodesh/
@@ -26,20 +26,10 @@ 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**.
+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.
 
 PyPI name, import, and command: **hakodesh**. Not snax. Not snx.
 
-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.2**. `pip install hakodesh` installs this release.
-
-**0.2.0 was withdrawn** from the index (deleted, not yanked) because procedure integrity did not cover approval or routing state and parameterized replay reused last-seen literals. **0.1.0 remains** installable. 0.2.2 is the same runtime as the Watson HMAC / `--bind` fix first shipped as 0.2.1; this version only makes the public page and shipped docs match that fact.
-
-Procedures are HMAC-authenticated with the home chain key. Arguments that vary across training traces become required slots; `decide` / `run-intent` take `--bind name=value`. Unsigned 0.2.0 `vN.json` files fail closed until re-promoted.
-
 ## Install
 
 ```bash
@@ -55,18 +45,9 @@ These are the runtime, not starter spells:
 | Command | What it does |
 |---|---|
 | `hakodesh catalog` | User artifacts in the book (empty at install) |
-| `hakodesh route "<intent>"` | Rank minted names plus kernel commands (may include procedure candidates) |
+| `hakodesh route "<intent>"` | Rank minted names plus kernel commands |
 | `hakodesh invoke <name> [args...]` | Cast a minted spell by name |
 | `hakodesh mint <name> --kind spell\|enchantment\|ward\|combo` | Scaffold into the book (preview; `--confirm` writes) |
-| `hakodesh remember --intent "…" --step spell:name --source host` | Record a structured execution trace (not an opaque receipt) |
-| `hakodesh recall "<intent>"` | Local deterministic procedure recall |
-| `hakodesh decide "<intent>" [--bind name=value]` | `execute` / `ask_model` / `ambiguous` / `blocked` / `not_found` |
-| `hakodesh run-intent "<intent>" [--bind name=value]` | Straight-through execute when decide says `execute` |
-| `hakodesh next-action --intent "…" [--bind name=value]` | Next validated procedure step, or a suggestion |
-| `hakodesh procedures` | List promoted procedures |
-| `hakodesh approve <id> --confirm` | Approve a high-risk procedure |
-| `hakodesh policy` | Show promotion policy (three-success default is an implementation policy, not SNX history) |
-| `hakodesh metrics` | Recall / straight-through / re-entry / context-crossing stats |
 | `hakodesh akashic` | Verify HMAC chain; `--tail N` |
 | `hakodesh grimoire` | Cast ledger stats |
 | `hakodesh grimoire-seal` | RFC 6962 Merkle seal (preview; `--confirm` writes; `--verify`) |
@@ -77,7 +58,7 @@ These are the runtime, not starter spells:
 
 `--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.
+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. 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.
 
@@ -90,11 +71,8 @@ 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/`.
+A fresh install has zero user spells, enchantments, wards, or combos. Discovery picks up a file the moment it lands under `HAKODESH_HOME/book/`.

{hakodesh-0.2.2 → hakodesh-0.2.4}/src/hakodesh.egg-info/SOURCES.txt

@@ -4,9 +4,6 @@ README.md
 pyproject.toml
 setup.cfg
 docs/EXTRACT.md
-docs/IMPLEMENTATION.md
-docs/MIGRATION.md
-docs/PROCEDURAL_MEMORY.md
 docs/PROTOCOL.md
 src/hakodesh/__init__.py
 src/hakodesh/__main__.py
@@ -50,5 +47,4 @@ src/hakodesh/templates/spell.py.tmpl
 src/hakodesh/templates/ward.json.tmpl
 tests/test_agnostic.py
 tests/test_empty_book.py
-tests/test_events.py
-tests/test_procedural_memory.py
+tests/test_events.py

hakodesh-0.2.2/README.md

@@ -1,74 +0,0 @@
-# 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, import, and command: **hakodesh**. Not snax. Not snx.
-
-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.2**. `pip install hakodesh` installs this release.
-
-**0.2.0 was withdrawn** from the index (deleted, not yanked) because procedure integrity did not cover approval or routing state and parameterized replay reused last-seen literals. **0.1.0 remains** installable. 0.2.2 is the same runtime as the Watson HMAC / `--bind` fix first shipped as 0.2.1; this version only makes the public page and shipped docs match that fact.
-
-Procedures are HMAC-authenticated with the home chain key. Arguments that vary across training traces become required slots; `decide` / `run-intent` take `--bind name=value`. Unsigned 0.2.0 `vN.json` files fail closed until re-promoted.
-
-## Install
-
-```bash
-pip install hakodesh
-```
-
-Data home: `HAKODESH_HOME` or the platform user-data directory for `hakodesh`. Never `~/spells`.
-
-## Kernel commands
-
-These are the runtime, not starter spells:
-
-| Command | What it does |
-|---|---|
-| `hakodesh catalog` | User artifacts in the book (empty at install) |
-| `hakodesh route "<intent>"` | Rank minted names plus kernel commands (may include procedure candidates) |
-| `hakodesh invoke <name> [args...]` | Cast a minted spell by name |
-| `hakodesh mint <name> --kind spell\|enchantment\|ward\|combo` | Scaffold into the book (preview; `--confirm` writes) |
-| `hakodesh remember --intent "…" --step spell:name --source host` | Record a structured execution trace (not an opaque receipt) |
-| `hakodesh recall "<intent>"` | Local deterministic procedure recall |
-| `hakodesh decide "<intent>" [--bind name=value]` | `execute` / `ask_model` / `ambiguous` / `blocked` / `not_found` |
-| `hakodesh run-intent "<intent>" [--bind name=value]` | Straight-through execute when decide says `execute` |
-| `hakodesh next-action --intent "…" [--bind name=value]` | Next validated procedure step, or a suggestion |
-| `hakodesh procedures` | List promoted procedures |
-| `hakodesh approve <id> --confirm` | Approve a high-risk procedure |
-| `hakodesh policy` | Show promotion policy (three-success default is an implementation policy, not SNX history) |
-| `hakodesh metrics` | Recall / straight-through / re-entry / context-crossing stats |
-| `hakodesh akashic` | Verify HMAC chain; `--tail N` |
-| `hakodesh grimoire` | Cast ledger stats |
-| `hakodesh grimoire-seal` | RFC 6962 Merkle seal (preview; `--confirm` writes; `--verify`) |
-| `hakodesh enchant bind\|lift <name> --settings <path>` | Bind or lift a minted enchantment |
-| `hakodesh ward status\|lock\|unlock\|check <name>` | Fail-closed ward kernel |
-| `hakodesh combo seal\|cast\|list [name]` | Sealed pipelines of minted spells |
-| `hakodesh <minted-name> [args...]` | Cast after mint |
-
-`--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/docs/IMPLEMENTATION.md

@@ -1,75 +0,0 @@
-# Hakodesh 0.2.2 — 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.
-
-## 0.2.1 Watson corrections (HKD-020)
-
-Public 0.2.0 needed correction. 0.2.1 ships:
-
-| ID | Fix |
-|---|---|
-| 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-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/
-
-## Files changed
-
-New:
-
-- `src/hakodesh/memory/` — traces, policy, recall, promote, procedures, decide, execute, metrics, risk, scope, adapter
-- `src/hakodesh/benchmark.py`
-- `tests/test_procedural_memory.py`
-- `docs/PROCEDURAL_MEMORY.md`
-- `docs/MIGRATION.md`
-- `docs/IMPLEMENTATION.md`
-
-Modified:
-
-- `src/hakodesh/{cli,catalog,home,events,__init__}.py`
-- `src/hakodesh/contracts/hakodesh-event-v1.json`
-- `pyproject.toml` (0.2.2)
-- `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.
-
-## Promotion and time-window policy
-
-Default: **3** successful traces, same procedure signature, compatible env+safety scope, cluster span ≤ `window_seconds` (default 30 days), `failure_policy=block_on_any_in_window`. Failures and incorrect correctness do not count. The three-success default is an **implementation policy**, not SNX history. Policy fields are copied onto promotion receipts.
-
-## Model boundary
-
-Straight-through runs set `model_reasoning_reentered=false`, `model_turns=0`, `model_crossed_bytes=0`. Metrics distinguish `locally_produced` vs host-supplied `model_crossed`. Receipt size is not treated as reasoning avoided. Billed tokens are recorded only when the host supplies them.
-
-## Safety behavior
-
-Wards run at the execution boundary before `dispatch.invoke`. Procedure HMAC (home chain key) and hash are checked before replay; routing fields and `risk.approved` are in the authenticated body. Scope mismatch, unbound parameters, and missing high-risk approval return `blocked` / `needs_model_reasoning` with `recovery.suggestion=null`. Tamper fails closed. HMAC Akashic + Grimoire Merkle + receipt redaction are unchanged.
-
-## Backward compatibility
-
-`catalog`, `route` (richer keys), `mint` preview/`--confirm`, `invoke <name>`, `combo`, existing events remain. Fresh install: zero user artifacts and zero procedures.
-
-## Tests run and results
-
-`python3 -m pytest tests -q` → **43 passed** (legacy empty-book / events / agnostic + original procedural cases + Watson HKD-020 adversarial tests).
-
-## Known limitations
-
-- Recall is lexical, not semantic. Unrelated paraphrases correctly fall through to `ask_model`.
-- `snx tokenomics` / billed-token A/B is out of scope (Hakodesh-only).
-- Drive git for 0.1.0 was unreadable (I/O); this tree is bootstrapped from the PyPI 0.1.0 **sdist** sha256 `3e5959447bd1999797104a7fe27a3b6bc1253d2fb534d03809fbc7ed4ae91257` (the **wheel** sha256 is `7e74e20de8aa1af606299ae64d2fc01c89627dc405b668f159c957b1b23c8145`; do not label the wheel digest as the sdist).
-- Auto-promote writes the first eligible version; further identical successes do not silently overwrite.
-
-## Metrics still requiring a controlled experiment
-
-Causal tokens-per-completed-task (spells vs raw vs procedures), billed input+output tokens, and any comparison to Magus SNX. Those need a frozen task suite with API-reported tokens. This runtime only instruments recall, route precision (when labeled), straight-through rate, re-entry, reuse depth, model turns, and context-byte split.