sa-orchestration/README.md

# SA-Orchestration plugin (v0.1.0)

First slice of the SA-Core / MissionNet alignment layer above the Fluent stack.

## What it does

Records three kinds of canonical artifacts that Fluent does not natively carry:

| Artifact | Table | Concept |
|---|---|---|
| Arbitration record | `wp_sa_arbitration` | Manager-as-arbiter outcome (rationale, projection_type, demand_ref) |
| Demand → Plan linkage | `wp_sa_arbitration_plan_link` | Edges from an arbitration to its resulting Plan refs |
| Acceptance event chain | `wp_sa_acceptance_event` | Append-only events: result_claimed → acceptance_disputed → acceptance_affirmed |

Each row has a corresponding markdown file in the **Asterion ledger** at `wp-content/sa-asterion/`. **Asterion is canonical-at-write; the DB is cache.** If the file write fails, no DB row is created.

## REST endpoints (admin-only)

```
POST /wp-json/sa-orch/v1/arbitration
POST /wp-json/sa-orch/v1/acceptance
GET  /wp-json/sa-orch/v1/demand/{surface}/{ref}/trace
```

All require `current_user_can('manage_options')`.

## Schema reference

See [SA-orchestration repo](../../../../../SleeperAgents/SA-orchestration) — `FLUENT_DATA_MAPPING.md` and `CORE_MODEL.md` for vocabulary.

## Status

v0.1.0 — minimum viable. No admin UI. No advanced features. Plugin code currently lives at `wp-content/plugins/sa-orchestration/`; canonical home should move to the SA-orchestration repo at a future milestone.