hapax-spine 0.1.1__tar.gz

hapax_spine-0.1.1/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/

hapax_spine-0.1.1/LICENSE

@@ -0,0 +1,104 @@
+Business Source License 1.1
+
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:             Hapax Research LLC
+Licensed Work:        hapax-spine — the SDLC-runtime mechanism (append-only coord
+                      event ledger, dispatch-policy evaluator, capability
+                      registry + receipts, quota arithmetic, EDT measurement,
+                      gate-event producer) for the Hapax n-DLC automation system.
+                      The Licensed Work is (c) 2026 Hapax Research LLC.
+Additional Use Grant: You may make production use of the Licensed Work, provided
+                      that such production use does not include offering the
+                      Licensed Work (or any modified or derivative version of it)
+                      to third parties as a hosted or managed service whose
+                      primary value to those third parties is the governed
+                      n-DLC / agent-lifecycle automation that the Licensed Work
+                      provides.
+Change Date:          2030-07-03
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact the Licensor.
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production
+use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under the
+terms of the Change License, and the rights granted in the paragraph above
+terminate.
+
+If your use of the Licensed Work does not comply with the requirements currently
+in effect as described in this License, you must purchase a commercial license
+from the Licensor, its affiliated entities, or authorized resellers, or you must
+refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies separately
+for each version of the Licensed Work and the Change Date may vary for each
+version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy of
+the Licensed Work. If you receive the Licensed Work in original or modified form
+from a third party, the terms and conditions set forth in this License apply to
+your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other versions
+of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor or
+its affiliates (provided that you may use a trademark or logo of Licensor as
+expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license your
+works, and to refer to it using the trademark "Business Source License", as long
+as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business Source
+License" name and trademark, Licensor covenants to MariaDB, and to all other
+recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version, or
+   a license that is compatible with GPL Version 2.0 or a later version, where
+   "compatible" means that software provided under the Change License can be
+   included in a program with software provided under GPL Version 2.0 or a later
+   version. Licensor may specify additional Change Licenses without limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as the
+   Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+-----------------------------------------------------------------------------
+
+Notices
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

hapax_spine-0.1.1/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: hapax-spine
+Version: 0.1.1
+Summary: The SDLC-runtime mechanism (coord ledger, dispatch-policy evaluator, capability registry + receipts, quota arithmetic, EDT measurement, gate-event producer) for the Hapax n-DLC automation system.
+Project-URL: Homepage, https://github.com/hapax-systems/hapax-spine
+Project-URL: Repository, https://github.com/hapax-systems/hapax-spine
+Author: Hapax Research LLC
+License: Business Source License 1.1
+        
+        License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+        "Business Source License" is a trademark of MariaDB Corporation Ab.
+        
+        -----------------------------------------------------------------------------
+        
+        Parameters
+        
+        Licensor:             Hapax Research LLC
+        Licensed Work:        hapax-spine — the SDLC-runtime mechanism (append-only coord
+                              event ledger, dispatch-policy evaluator, capability
+                              registry + receipts, quota arithmetic, EDT measurement,
+                              gate-event producer) for the Hapax n-DLC automation system.
+                              The Licensed Work is (c) 2026 Hapax Research LLC.
+        Additional Use Grant: You may make production use of the Licensed Work, provided
+                              that such production use does not include offering the
+                              Licensed Work (or any modified or derivative version of it)
+                              to third parties as a hosted or managed service whose
+                              primary value to those third parties is the governed
+                              n-DLC / agent-lifecycle automation that the Licensed Work
+                              provides.
+        Change Date:          2030-07-03
+        Change License:       Apache License, Version 2.0
+        
+        For information about alternative licensing arrangements for the Licensed Work,
+        please contact the Licensor.
+        
+        -----------------------------------------------------------------------------
+        
+        Terms
+        
+        The Licensor hereby grants you the right to copy, modify, create derivative
+        works, redistribute, and make non-production use of the Licensed Work. The
+        Licensor may make an Additional Use Grant, above, permitting limited production
+        use.
+        
+        Effective on the Change Date, or the fourth anniversary of the first publicly
+        available distribution of a specific version of the Licensed Work under this
+        License, whichever comes first, the Licensor hereby grants you rights under the
+        terms of the Change License, and the rights granted in the paragraph above
+        terminate.
+        
+        If your use of the Licensed Work does not comply with the requirements currently
+        in effect as described in this License, you must purchase a commercial license
+        from the Licensor, its affiliated entities, or authorized resellers, or you must
+        refrain from using the Licensed Work.
+        
+        All copies of the original and modified Licensed Work, and derivative works of
+        the Licensed Work, are subject to this License. This License applies separately
+        for each version of the Licensed Work and the Change Date may vary for each
+        version of the Licensed Work released by Licensor.
+        
+        You must conspicuously display this License on each original or modified copy of
+        the Licensed Work. If you receive the Licensed Work in original or modified form
+        from a third party, the terms and conditions set forth in this License apply to
+        your use of that work.
+        
+        Any use of the Licensed Work in violation of this License will automatically
+        terminate your rights under this License for the current and all other versions
+        of the Licensed Work.
+        
+        This License does not grant you any right in any trademark or logo of Licensor or
+        its affiliates (provided that you may use a trademark or logo of Licensor as
+        expressly required by this License).
+        
+        TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+        "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+        OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY, FITNESS
+        FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+        
+        MariaDB hereby grants you permission to use this License's text to license your
+        works, and to refer to it using the trademark "Business Source License", as long
+        as you comply with the Covenants of Licensor below.
+        
+        -----------------------------------------------------------------------------
+        
+        Covenants of Licensor
+        
+        In consideration of the right to use this License's text and the "Business Source
+        License" name and trademark, Licensor covenants to MariaDB, and to all other
+        recipients of the licensed work to be provided by Licensor:
+        
+        1. To specify as the Change License the GPL Version 2.0 or any later version, or
+           a license that is compatible with GPL Version 2.0 or a later version, where
+           "compatible" means that software provided under the Change License can be
+           included in a program with software provided under GPL Version 2.0 or a later
+           version. Licensor may specify additional Change Licenses without limitation.
+        
+        2. To either: (a) specify an additional grant of rights to use that does not
+           impose any additional restriction on the right granted in this License, as the
+           Additional Use Grant; or (b) insert the text "None".
+        
+        3. To specify a Change Date.
+        
+        4. Not to modify this License in any other way.
+        
+        -----------------------------------------------------------------------------
+        
+        Notices
+        
+        The Business Source License (this document, or the "License") is not an Open
+        Source license. However, the Licensed Work will eventually be made available
+        under an Open Source License, as stated in this License.
+License-File: LICENSE
+Keywords: agent-orchestration,capability-routing,dispatch,governance,n-dlc,sdlc,witnessed-ledger
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: pydantic>=2
+Requires-Dist: pyyaml>=6
+Description-Content-Type: text/markdown
+
+# hapax-spine
+
+**The SDLC-runtime mechanism behind the Hapax n-DLC automation system, as a small Python wheel.** It is
+the governed core that turns a stream of work events into scored, routable, auditable state:
+
+- an **append-only coordination event ledger** (+ its projection engine),
+- a **capability registry + receipts** (capabilities identified by attested, measured behavior),
+- a **dispatch-policy evaluator** (fail-closed, receipt-backed),
+- **quota / spend arithmetic**, an **EDT** (equal-depth-of-treatment) fairness measurement engine, and a
+  **gate-event producer** (the observational evidence stream).
+
+It is dependency-light (`pydantic`, `pyyaml`) and consumed by [reins](https://github.com/hapax-systems/reins)
+(the cockpit) and, internally, by hapax-council.
+
+## Install
+
+```sh
+uv add hapax-spine        # or: pip install hapax-spine
+```
+
+## Use
+
+```python
+import hapax.spine.dispatcher_policy as dp
+import hapax.spine.platform_capability_registry as reg
+
+# The instance supplies its config-DATA dir (the registry, quota fixtures, EDT knobs)
+# via HAPAX_SPINE_CONFIG_DIR (or pass an explicit path). Import is always safe; only an
+# unconfigured *load* fails loud.
+registry = reg.load_platform_capability_registry()          # env-injected path
+sources  = dp.load_dispatch_policy_sources(registry_path=my_registry_json)  # or explicit
+```
+
+Set `HAPAX_SPINE_CONFIG_DIR` (and `HAPAX_SPINE_REPO_ROOT`) to your instance's config directory.
+
+## Honest scope
+
+hapax-spine ships the **mechanism**. In v0.1.x the instance **taxonomy** — the routing-class keyspace,
+the reqvec dimensions, the provider/payment rails — ships as *council-default vocabulary*, not yet fully
+injected (see the v1.1 instance-free milestone). So a second instance runs the same engine but currently
+inherits those defaults; making the taxonomy (and the governance axioms) fully injectable is on the
+roadmap. We don't claim capability-/axiom-agnosticism the code doesn't yet deliver.
+
+The 15 modules were extracted history-preserving from hapax-council; the wheel is agents/logos-free and
+imports only `pydantic` + `pyyaml`.
+
+## License
+
+Source-available under the **Business Source License 1.1** (see `LICENSE`): free for all non-competing
+use — self-host, build on it, run your own instance — converting to Apache-2.0 on the change date. Only
+offering it as a competing hosted service is reserved.

hapax_spine-0.1.1/README.md

@@ -0,0 +1,51 @@
+# hapax-spine
+
+**The SDLC-runtime mechanism behind the Hapax n-DLC automation system, as a small Python wheel.** It is
+the governed core that turns a stream of work events into scored, routable, auditable state:
+
+- an **append-only coordination event ledger** (+ its projection engine),
+- a **capability registry + receipts** (capabilities identified by attested, measured behavior),
+- a **dispatch-policy evaluator** (fail-closed, receipt-backed),
+- **quota / spend arithmetic**, an **EDT** (equal-depth-of-treatment) fairness measurement engine, and a
+  **gate-event producer** (the observational evidence stream).
+
+It is dependency-light (`pydantic`, `pyyaml`) and consumed by [reins](https://github.com/hapax-systems/reins)
+(the cockpit) and, internally, by hapax-council.
+
+## Install
+
+```sh
+uv add hapax-spine        # or: pip install hapax-spine
+```
+
+## Use
+
+```python
+import hapax.spine.dispatcher_policy as dp
+import hapax.spine.platform_capability_registry as reg
+
+# The instance supplies its config-DATA dir (the registry, quota fixtures, EDT knobs)
+# via HAPAX_SPINE_CONFIG_DIR (or pass an explicit path). Import is always safe; only an
+# unconfigured *load* fails loud.
+registry = reg.load_platform_capability_registry()          # env-injected path
+sources  = dp.load_dispatch_policy_sources(registry_path=my_registry_json)  # or explicit
+```
+
+Set `HAPAX_SPINE_CONFIG_DIR` (and `HAPAX_SPINE_REPO_ROOT`) to your instance's config directory.
+
+## Honest scope
+
+hapax-spine ships the **mechanism**. In v0.1.x the instance **taxonomy** — the routing-class keyspace,
+the reqvec dimensions, the provider/payment rails — ships as *council-default vocabulary*, not yet fully
+injected (see the v1.1 instance-free milestone). So a second instance runs the same engine but currently
+inherits those defaults; making the taxonomy (and the governance axioms) fully injectable is on the
+roadmap. We don't claim capability-/axiom-agnosticism the code doesn't yet deliver.
+
+The 15 modules were extracted history-preserving from hapax-council; the wheel is agents/logos-free and
+imports only `pydantic` + `pyyaml`.
+
+## License
+
+Source-available under the **Business Source License 1.1** (see `LICENSE`): free for all non-competing
+use — self-host, build on it, run your own instance — converting to Apache-2.0 on the change date. Only
+offering it as a competing hosted service is reserved.

hapax_spine-0.1.1/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hapax-spine"
+version = "0.1.1"
+description = "The SDLC-runtime mechanism (coord ledger, dispatch-policy evaluator, capability registry + receipts, quota arithmetic, EDT measurement, gate-event producer) for the Hapax n-DLC automation system."
+readme = "README.md"
+requires-python = ">=3.12"
+license = { file = "LICENSE" }
+authors = [{ name = "Hapax Research LLC" }]
+keywords = ["sdlc", "n-dlc", "agent-orchestration", "capability-routing", "dispatch", "governance", "witnessed-ledger"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+    "License :: Other/Proprietary License",
+]
+dependencies = ["pydantic>=2", "pyyaml>=6"]
+
+[project.urls]
+Homepage = "https://github.com/hapax-systems/hapax-spine"
+Repository = "https://github.com/hapax-systems/hapax-spine"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hapax"]
+
+[tool.hatch.metadata]
+allow-direct-references = true

hapax_spine-0.1.1/src/hapax/spine/__init__.py

@@ -0,0 +1,15 @@
+"""hapax-spine — the SDLC-runtime MECHANISM, extracted history-preserving from hapax-council.
+
+The append-only coord event ledger, the projection engine, the capability registry + receipts,
+quota arithmetic, the dispatch-policy evaluator, the gate-event producer, and the EDT measurement
+engine — the ~9.6k-LOC agents/logos-free cluster reins consumes.
+
+v1 note (honest): the routing-class keyspace (frozen-11), reqvec dims, and provider/payment rails
+ship as council-DEFAULT vocabulary, not yet fully injected — see the v1.1 instance-free milestone.
+Config-DATA paths ARE injected: set HAPAX_SPINE_CONFIG_DIR (and HAPAX_SPINE_REPO_ROOT) or pass an
+explicit path to the loaders; an unconfigured *load* fails loud, while *import* never raises.
+"""
+
+from hapax.spine.edt_measure import NUM_ROUTING_CLASSES, ROUTING_CLASSES
+
+__all__ = ["ROUTING_CLASSES", "NUM_ROUTING_CLASSES"]

hapax_spine-0.1.1/src/hapax/spine/_config.py

@@ -0,0 +1,58 @@
+"""Import-safe config-DATA path resolution for hapax-spine.
+
+The instance injects its config DATA dir (the platform-capability registry, quota fixtures, EDT knobs)
+via ``HAPAX_SPINE_CONFIG_DIR`` — set it in the process env before import (council, reins, and the wheel's
+own tests all do), or pass an explicit path to a loader.
+
+INVARIANT (the extraction's verify-3 fix): module *import* NEVER raises — a module-level default is always
+a real ``Path`` (a non-existent sentinel when unconfigured), so ``from hapax.spine.X import CONST`` stays
+importable and typed. Only an actual *read* of an unconfigured path fails loud (the sentinel path literally
+names the missing env var, so the error is self-describing).
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+CONFIG_DIR_ENV = "HAPAX_SPINE_CONFIG_DIR"
+REPO_ROOT_ENV = "HAPAX_SPINE_REPO_ROOT"
+
+# A path under this root can never exist, so an unconfigured open() fails loud while import stays safe.
+_UNCONFIGURED_ROOT = Path("/nonexistent/hapax-spine__set_HAPAX_SPINE_CONFIG_DIR")
+
+
+def _injected_config_dir() -> Path | None:
+    root = os.environ.get(CONFIG_DIR_ENV, "").strip()
+    return Path(root).expanduser() if root else None
+
+
+def default_config_path(filename: str) -> Path:
+    """Eager module-constant value: the injected config dir joined to ``filename`` when the env is set at
+    import, else a self-describing non-existent sentinel. NEVER raises."""
+    d = _injected_config_dir()
+    return (d / filename) if d is not None else (_UNCONFIGURED_ROOT / filename)
+
+
+def resolve_config_path(path: Path | None, filename: str) -> Path:
+    """Call-time loader resolver: an explicit ``path`` wins; else re-read the env FRESH (handles
+    env-set-after-import); FAIL LOUD when neither is available."""
+    if path is not None:
+        return Path(path)
+    d = _injected_config_dir()
+    if d is None:
+        raise RuntimeError(
+            f"hapax-spine: cannot load {filename!r} — set {CONFIG_DIR_ENV} to the instance config dir "
+            f"or pass an explicit path to the loader."
+        )
+    return d / filename
+
+
+def repo_root() -> Path:
+    """The instance repo root (``HAPAX_SPINE_REPO_ROOT``), else the config dir's parent, else a sentinel.
+    Used only by relative-path resolvers that historically read council_root. Never raises."""
+    root = os.environ.get(REPO_ROOT_ENV, "").strip()
+    if root:
+        return Path(root).expanduser()
+    d = _injected_config_dir()
+    return d.parent if d is not None else _UNCONFIGURED_ROOT