Metadata-Version: 2.4
Name: universal-harness
Version: 1.2.0
Summary: Universal Harness (UH) — thin namespace facade over aiking-core governance for cross-substrate agents (AGPL-3.0-or-later or commercial)
Project-URL: Homepage, https://github.com/aiking931931/ai-king
Project-URL: Issues, https://github.com/aiking931931/ai-king/issues
Project-URL: Commercial License, https://github.com/aiking931931/ai-king/blob/main/aiking/packages/universal-harness/COMMERCIAL_LICENSE.md
Project-URL: AI King, https://ai-king.dev
Author-email: "AI King (Chen-Xuan Wang)" <me@ai-king.dev>
License-Expression: AGPL-3.0-or-later
Keywords: agent-governance,ai-king,aiking,cbua,claude-code,cross-substrate,harness,hermes,openclaw,sancio,universal-harness,wiredo
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: aiking-core<2.0,>=1.1.1
Description-Content-Type: text/markdown

# universal-harness

> Cross-substrate agent governance namespace — a thin facade over
> [`aiking-core`](https://pypi.org/project/aiking-core/) that lets
> agents running on **any substrate** (Claude Code, Hermes, Sancio,
> OpenClaw, custom CLI clients) reach for the same guards, hooks,
> routers, and ZIQ retrieval pipeline under a brand-neutral name.

## Install

```bash
pip install universal-harness
# or, via the AI King brand entrypoint:
pip install "aiking[uh]"
```

## What it gives you

`universal_harness` re-exports the governance primitives shipped by
[`aiking-core`](https://github.com/aiking931931/ai-king) — no duplicate
logic, just brand-neutral names so substrate-specific adapters
(`claude-code-harness`, `hermes-agent-harness`, `sancio-harness`,
`openclaw-harness`) can depend on a stable interface.

```python
from universal_harness import ziq, fieldread, cerno, FEATURE_META

router = ziq.C0Router()
verdict = router.classify_with_hysteresis(...)
```

This is the same `aiking_core.ziq.C0Router` you'd get via
`from aiking_core.ziq import C0Router` — UH only re-binds the name so
your downstream code doesn't carry an `aiking_*` brand stamp.

## License

AGPL-3.0-or-later. Commercial licensing available for adopters who need
to ship closed-source derivatives —
see [`COMMERCIAL_LICENSE.md`](./COMMERCIAL_LICENSE.md).

## Versioning

Tracks `aiking-core` in lockstep via
`[tool.aiking.version_sync.locked]` in the workspace `pyproject.toml`.
A PR cannot bump `aiking-core` without bumping the locked-set, and
`scripts/sync_versions.py --check` is wired into CI to enforce this.

## Phase 2 migration note

During 2026-05-12 → 2026-11-01, some governance modules (`guards`,
`hooks`, `c0_router`, `cli`) still live in the legacy `concinno`
package and are exposed through `aiking_core` via the
`concinno-shim`. If you need one of those today, fall back to
`from concinno.guards import …` — it will keep working until the EOL
date documented in `aiking-master-plan-v1-2026-05-12.md`.

## Companion packages

| Package | License | Role |
| --- | --- | --- |
| `aiking-core` | AGPL-3.0-or-later | Engine — owns the actual logic |
| `universal-harness` | AGPL-3.0-or-later | Brand-neutral facade (this package) |
| `claude-code-harness` | MIT | Claude Code substrate adapter |
| `hermes-agent-harness` | MIT | Hermes substrate adapter |
| `sancio-harness` | MIT | Sancio substrate adapter |
| `openclaw-harness` | MIT | OpenClaw substrate adapter |
| `aiking` | MIT | Meta-package with `extras_require` aliases |
