Metadata-Version: 2.4
Name: meridian-dock
Version: 0.3.3
Summary: Convergence debt and meridian docking protocols for multi-agent systems
Author: Meridian Discovery Program
License-Expression: MIT
Project-URL: Documentation, https://github.com/local/meridian-dock
Project-URL: Source, https://github.com/local/meridian-dock
Keywords: coordination,multi-agent,docking,convergence-debt,meridian
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.24
Provides-Extra: crypto
Requires-Dist: cryptography>=42; extra == "crypto"
Dynamic: license-file

# Meridian v0.3

**Thin docking protocols that bound convergence debt** — the cost of becoming able to meet again after independent success.

Not a chain. Not shared rewards. Not full ontology merge.

[![suite](https://img.shields.io/badge/suite-14%2F14%20pass-brightgreen)](results/suite_report.json)
[![version](https://img.shields.io/badge/version-0.3.0-blue)](CHANGELOG.md)
[![license](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)

**Discoveries (read this first):** [`docs/DISCOVERIES.md`](docs/DISCOVERIES.md) · `meridian discoveries`  
**Site:** [`site/index.html`](site/index.html)  
**Note:** [`docs/TECHNICAL_NOTE.md`](docs/TECHNICAL_NOTE.md)

### What we actually found (short)

1. **Convergence debt is real** — local success drives meetability to zero.  
2. **Thin docks restore the bargain** — no shared goals required.  
3. **Hidden interfaces are recoverable** — Debt-Gradient PCA from a scalar friction meter.  
4. **Private objectives stay private** — transfer attacks fail on private R².  
5. **Debt scales with N** — meridians stay thin.  
6. **Rendezvous is poisonable** — hash-pin / quorum / dual-rail defend it.  
7. **Rotation needs ceremony** — parent hash + signatures + policy (HMAC or Ed25519).  
8. **It runs for real agents** — tools, files, multi-process, OpenAI/LangGraph hooks.

---

## Install

**From PyPI (public):**

```powershell
pip install meridian-dock
meridian version          # 0.3.2+
meridian discoveries      # what we found, not just what we shipped
meridian profiles list    # domain dock templates
```

https://pypi.org/project/meridian-dock/

**From source:**

```powershell
cd C:\Users\rimma\meridian
python -m pip install -e .
# optional: pip install -e ".[crypto]"
meridian suite
```

---

## 60-second product loop

```powershell
meridian rendezvous init .\rendezvous.json
meridian dock init .\agent.dock.json --rendezvous .\rendezvous.json
meridian dock maintain .\agent.dock.json --rendezvous .\rendezvous.json
```

```python
from meridian import MeridianMiddleware, MiddlewareConfig
from meridian.adapters import OpenAIToolsAdapter, OpenAIStyleTool

mw = MeridianMiddleware("rendezvous.json", "agent.dock.json",
                        config=MiddlewareConfig(defense="hash_pin"))
mw.start()
adapter = OpenAIToolsAdapter(mw, tools=[...])
# tools=adapter.tool_specs()
# adapter.handle_tool_calls(tool_calls)
```

**Ed25519 rotation (Exp-007):**

```python
from meridian import PkiParty, pki_sign_proposal, pki_activate_if_quorum
from meridian.rotation import make_proposal, legitimate_upgrade, rendezvous_signature
# parties sign with private keys; verifiers use public keys only
```

---

## Laboratory scoreboard

| ID | Result |
|----|--------|
| Exp-001 Meridian Bargain | PASS |
| Exp-002 DG-PCA hidden interface | PASS |
| Exp-003 Non-revelation | PASS |
| Exp-004 Scaling | PASS |
| Exp-005 Poisoning | PASS |
| Exp-006 HMAC rotation | PASS |
| **Exp-007 Ed25519 PKI** | **PASS** |
| W1 / W1b / live / mw / mp / adapter / kit | PASS |

```text
meridian suite
# Passed 14/14  all_pass=True
```

---

## Layout

```
meridian/
  site/index.html          # public one-pager
  docs/TECHNICAL_NOTE.md
  theory/
  src/meridian/            # package (pip install -e .)
  experiments/             # 001–007 + wedges + run_all
  results/                 # locked reports
  examples/
  lab/NOTEBOOK.md
```

---

## Core idea

1. Publish a **rendezvous** dock signature.  
2. Maintain each agent’s public dock every tool turn.  
3. Specialize privately off-dock.  
4. Rotate only via **signed quorum + breaking-change policy** (HMAC or Ed25519).  

Discovery-first · MIT · v0.3.0
