# Coordination Intelligence Upgrades v1.0

**Status:** Architecture appendix — planned, not shipped  
**Layer:** Organizational Intelligence (above TrustScript)  
**Audience:** Platform architects, security engineering leads

---

## 1. Placement in the stack

```
1. TraceScript Core        — operators, receipts, replay
2. TrustScript             — six trusted-state surfaces (shipped in RC1)
3. Domain surfaces         — SmartPeers, CSD/DENSITY, application whitepapers
4. Coordination Intelligence — planned (this document)
```

TrustScript secures **trusted state formation**. Coordination Intelligence governs **how organizations coordinate** across rooms, regimes, privacy boundaries, and multi-party proof edges — without redefining TraceScript Core or TrustScript surfaces.

> Regime and privacy doctrine in this appendix are **org-intelligence preview** material. They are not public TrustScript product surfaces and are not claimed as shipped in RC1.

---

## 2. Upgrade themes (from internal integration spec)

| Theme | Intent | TrustScript relationship |
|-------|--------|--------------------------|
| Regime routing | Route signals by coordination regime (crystal / fluid / unsafe) | Extends phase policy; does not replace Surface 1–4 gates |
| Privacy envelopes | Scoped disclosure and cross-tenant proof boundaries | Complements Surface 6 evidence export |
| Organizational intelligence | Roll-up posture across groups, rooms, and workflows | Observability above surface decision ledger |
| Proof edges | Cross-party verification without shared database | Uses continuity verify + evidence export |
| Promotion freeze | Block canonical promotion under unsafe coordination | Surfaces 1–2 wedge enforcement input |

---

## 3. Planned capabilities

### 3.1 Regime-aware evaluation

Evaluate paths consult coordination state before allowing promotion to canonical memory, workflow truth, or external action release. Unsafe regime → promotion freeze propagates to TrustScript Surface 2 and Surface 4 product-depth scoring.

**Runtime hooks (partial today):** coordination regime actions, CSD/DENSITY state estimates, SmartPeers review substrate coupling.

### 3.2 Privacy envelopes

Privacy envelopes constrain which receipt fields, bindings, and audit bundle sections may cross tenant or counterparty boundaries. Surface 6 evidence export gains envelope-aware redaction modes (planned).

### 3.3 Organizational intelligence rollups

Tenant-level rollups combine:

- TrustScript surface decision distribution
- Proof run outcomes (continuity matched / export failed)
- Workflow governance events
- Coordination state transitions

Portal observability is the first consumer; dedicated org-intelligence dashboards are planned.

### 3.4 Cross-party proof (Proof Edges)

Proof Edges export verification packages verifiable by counterparties without shared Postgres access. Builds on:

- Surface 5 — Recursive Continuity Verifier
- Surface 6 — TraceScript Evidence Export
- Trust Room proof-edge routes (RC1)

---

## 4. What is explicitly not TrustScript

The following internal documents describe **Organizational Intelligence** — tag as preview, do not merchandise as TrustScript surfaces:

- Regime doctrine (coordination regime routing beyond phase policy)
- Privacy envelope specification (cross-tenant redaction policy)
- Organizational intelligence layer product definition

TrustScript remains six surfaces on TraceScript Core. This appendix describes the **next layer up**, not an expansion of Surface count.

---

## 5. Migration path for buyers

1. **Now (RC1):** Deploy TrustScript wedge (Surfaces 1–2) + proof flow (Surfaces 5–6).
2. **Next:** Surfaces 3–4 product depth at scale; Portal surface decision timeline.
3. **Planned:** Coordination Intelligence rollups when regime + privacy envelopes graduate from preview to product routes.

---

## 6. Related documents

- [TrustScript System Architecture v1.0](/downloads/trustscript-system-architecture-v1.0.md)
- [TrustScript hub](/trustscript.html)
- [Architecture — three-layer placement](/architecture.html#three-layer-placement)
- [RC1 proof console](/proof.html)
- [Language foundation roadmap](/foundation.html)