Metadata-Version: 2.4
Name: claude-code-harness
Version: 1.2.0
Summary: Claude Code Harness (CCH) — Claude Code substrate adapter for AI King ecosystem (MIT)
Project-URL: Homepage, https://github.com/aiking931931/ai-king
Project-URL: Issues, https://github.com/aiking931931/ai-king/issues
Project-URL: AI King, https://ai-king.dev
Author-email: "AI King (Chen-Xuan Wang)" <me@ai-king.dev>
License-Expression: MIT
Keywords: agent-governance,ai-king,aiking,anthropic,cbua,claude,claude-code,guards,harness,hooks,substrate-adapter,wiredo
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
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
Requires-Dist: universal-harness<2.0,>=1.1.1
Description-Content-Type: text/markdown

# claude-code-harness

> Claude Code substrate adapter for the AI King agent governance
> ecosystem — wires AI King's guards / hooks / ZIQ retrieval into
> Claude Code's hook + skill + settings layers without forcing
> AGPL obligations onto your private hook scripts.

## Install

```bash
pip install "aiking[cch]"
# or directly:
pip install claude-code-harness
```

## What this adapter does

Claude Code already ships its own substrate primitives (hook system,
skill registry, MCP, settings JSON). `claude-code-harness` bridges
those primitives to the AI King engine (`aiking-core`) so you get:

- AI King's red/blue Opus dispatch chain available from Claude Code
  hook handlers
- ZIQ router + FieldRead RAG accessible from any Claude Code Skill
- Shared FEATURE_META / config / state_store across Claude Code
  sessions and other substrates running CCH-compatible agents

## Why MIT (not AGPL)

The engine (`aiking-core`) is AGPL-3.0-or-later because mass
distribution of the engine itself is what AI King protects. The
substrate adapter — this package — is MIT so corporate / closed-source
adopters can integrate without auditing their own settings JSON for
AGPL-incompatible terms.

## License

MIT. See [`LICENSE`](./LICENSE).

## Phase 2 status (2026-05-12)

This package is a **namespace placeholder** during Phase 2 of the
AI King rebrand. Public API stubs (`register_hooks`,
`settings_snippet`, `skill_loader`) land in Wave UH-3b once the
remaining governance modules finish migrating into `aiking-core`.

Track progress via
`_AI_BRAIN/05_Planning/aiking-master-plan-v1-2026-05-12.md` §2 thread
A3 / A5.
