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 — 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.