hakodesh 0.1.0__tar.gz

hakodesh-0.1.0/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2026 Shelleyguitar. All rights reserved.
+
+This software is proprietary. You may install and use the published PyPI
+package. You may not redistribute, sublicense, or sell the source except as
+allowed by a separate written license from the copyright holder.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

hakodesh-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include docs/*.md
+include LICENSE
+include README.md
+include pyproject.toml
+graft src/hakodesh
+graft tests
+global-exclude *.pyc
+global-exclude __pycache__

hakodesh-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: hakodesh
+Version: 0.1.0
+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/
+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.
+
+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.1.0/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.1.0/docs/EXTRACT.md

@@ -0,0 +1,25 @@
+# Kernel extract
+
+Donor tarball: `gdrive:icarus_snx_backup/icarus-snx-spells.tgz`
+
+- md5 `76b1e4a2546b524676d458c1fa247d87`
+- bytes `112215291`
+- Canonical members taken from prefix `ICARUSspells/spells/`:
+  - `snax/snax/akashic.py`
+  - `snax/snax/events.py`
+  - `snax/snax/dispatch.py`
+  - `snax/snax/discovery.py`
+  - `snax/snax/cli.py`
+  - `snax/snax/common.py`
+  - `snax/snax/spells/mint.py`
+  - `snax/snax/spells/enchant.py`
+  - `snax/snax/spells/keyrite.py`
+  - `snax/snax/spells/grimoire.py`
+  - `snax/snax/spells/grimoire_seal.py`
+  - `snax/snax/spells/scroll.py`
+  - `snax/snax/spells/invoke.py`
+  - `contracts/everplay-event-v1.json`
+
+Left in the tarball: spell corpus, keystore, host ledgers, worktrees, LaunchAgents.
+
+Those engines were rewritten as host-agnostic hakodesh. Event schema is `hakodesh.event/v1` with the same `event_id` hash. A reader may verify harvested `everplay.event/v1` lines.

hakodesh-0.1.0/docs/PROTOCOL.md

@@ -0,0 +1,56 @@
+# hakodesh protocol
+
+## Empty-book law
+
+Install ships kernel + kind templates only. `HAKODESH_HOME/book/` starts empty. User artifacts appear only via `hakodesh mint … --confirm`.
+
+## Event identity
+
+Schema: `hakodesh.event/v1`.
+
+```
+event_id = "evt_" + sha256(actor_id + NUL + idempotency_key).hexdigest()[:32]
+```
+
+Canonical JSON: sorted keys, compact separators, UTF-8. Same hashes as `everplay.event/v1`. Harvested legacy lines may be verified by swapping `schema_version` for the hash check; hakodesh does not emit Everplay actor rosters.
+
+Default `notification_policy` is `none`.
+
+Mint emits kind `artifact.minted`. Casts emit `spell.cast.started` / `completed` / `failed`.
+
+## Akashic chain
+
+`HAKODESH_HOME/akashic/events.jsonl` is append-only.
+
+Each sealed line carries:
+
+- `chain.prev` / `chain.self` — SHA-256 linkage over `prev + canonical_body`
+- `chain.sig` — HMAC-SHA256 over the same bytes
+- `chain.alg` = `hmac-sha256`
+
+The first sealed line's `prev` is `genesis`, or the SHA-256 of any unchained legacy prefix (`legacy_anchor`). `events_head.json` stores length, tail `self`, key fingerprint, seal offset, frozen prefix hash, signed high-water mark, and two head MACs.
+
+Key: `$HAKODESH_HOME/keys/akashic-chain-hmac` (dir 0700, file 0600), minted on first seal, never in the wheel.
+
+## 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.
+
+## Mint lifecycle
+
+1. Preview (default): show the path and bytes that would land.
+2. `--confirm`: write only under `HAKODESH_HOME/book/<kind>/`.
+3. Emit `artifact.minted`.
+4. Catalog discovers the file immediately.
+
+Empty `--like` uses the wheel template for that kind. `--like <existing>` is allowed once that artifact exists.
+
+## Paths
+
+All runtime state is under `HAKODESH_HOME` (or platformdirs):
+
+- `book/spells|enchantments|wards|combos/`
+- `receipts/`
+- `akashic/`
+- `grimoire.jsonl` / `grimoire_head.json`
+- `keys/`

hakodesh-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hakodesh"
+version = "0.1.0"
+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"
+license-files = ["LICENSE"]
+authors = [{name = "Shelleyguitar"}]
+keywords = ["cli", "sdk", "spells", "agents", "receipts", "akashic", "grimoire"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = ["platformdirs>=4.2,<5"]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "build>=1.2", "twine>=5.0"]
+
+[project.scripts]
+hakodesh = "hakodesh.cli:main"
+
+[project.urls]
+Homepage = "https://pypi.org/project/hakodesh/"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+hakodesh = ["templates/*", "contracts/*.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

hakodesh-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

hakodesh-0.1.0/src/hakodesh/__init__.py

@@ -0,0 +1,27 @@
+"""hakodesh — empty book, mint as you go."""
+
+from .akashic import inscribe, verify_chain
+from .catalog import catalog as list_catalog
+from .catalog import route
+from .combo import cast as combo_cast
+from .combo import seal as combo_seal
+from .enchant import bind, lift
+from .events import make_event, validate_event
+from .grimoire import seal as grimoire_seal
+from .ward import unlock
+
+__version__ = "0.1.0"
+__all__ = [
+    "list_catalog",
+    "route",
+    "make_event",
+    "validate_event",
+    "inscribe",
+    "verify_chain",
+    "grimoire_seal",
+    "bind",
+    "lift",
+    "unlock",
+    "combo_seal",
+    "combo_cast",
+]

hakodesh-0.1.0/src/hakodesh/__main__.py

@@ -0,0 +1,4 @@
+from hakodesh.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())