prep docs and service updates

docs/modules/policy/prep/2025-11-20-trust-weighting-prep.md

@@ -0,0 +1,25 @@
+# Trust Weighting UI/API Prep — PREP-POLICY-ENGINE-30-101-TRUST-WEIGHTING-UI-
+
+Status: Draft (2025-11-20)
+Owners: Policy Guild
+Scope: Capture the UI/API surfaces for trust weighting once change events (30-003) are available.
+
+## Dependencies
+- Change events payload (30-003) and overlay schema (30-001).
+- UI design tokens/UX from Console/Policy surfaces (not yet provided).
+
+## Proposed API surface (draft)
+- `GET /policy/trust-weighting` → returns current weights per source (`cartographer`, `concelier`, `scanner`, `advisory_ai`, etc.) and effective profile hash.
+- `PUT /policy/trust-weighting` → accepts deterministic payload sorted by `source` with fields: `{source, weight, justification?, updated_at}`.
+- `GET /policy/trust-weighting/preview?overlay_hash=` → previews recalculated statuses using supplied weights (calls simulation bridge under the hood).
+
+## Determinism & validation
+- Weights are decimals with fixed scale 3; sum not required to 1 but capped at max per policy profile.
+- Payloads canonical JSON ordering; timestamps UTC.
+
+## Acceptance to close PREP
+- Align sources list with 30-003 change event fields and overlay inputs.
+- Document schema at `docs/modules/policy/schemas/trust-weighting@draft.json` and sample at `docs/modules/policy/samples/trust-weighting@draft.json`.
+
+## Handoff
+Treat this as the prep artefact for PREP-POLICY-ENGINE-30-101-TRUST-WEIGHTING-UI-. Finalize once 30-003 is frozen and UI tokens arrive; then move implementation to DOING.