Metadata-Version: 2.4
Name: hapax-spine
Version: 0.1.3
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.
