docs: audit financial fabric vnext contract

workplans/RAIL-FAB-WP-0017-financial-fabric-model-reset.md

@@ -4,11 +4,11 @@ type: workplan
 title: "Financial Fabric Model Reset"
 domain: railiance
 repo: railiance-fabric
-status: ready
+status: active
 owner: codex
 topic_slug: railiance
 created: "2026-05-23"
-updated: "2026-05-23"
+updated: "2026-05-24"
 state_hub_workstream_id: "39cc363c-6e2a-46a2-bd19-cee7ff6fc149"
 ---
 
@@ -54,7 +54,7 @@ work can rebuild the graph from accountability roots and deployment automation.
 
 ```task
 id: RAIL-FAB-WP-0017-T01
-status: todo
+status: done
 priority: high
 state_hub_task_id: "3d259e3c-5534-4b6a-930a-d085d3db57e4"
 ```
@@ -80,11 +80,24 @@ Done when:
 - follow-on tasks have enough detail to implement without rediscovering the
   whole codebase.
 
+Result:
+
+- Added `docs/financial-fabric-model-audit.md`.
+- Listed affected schemas, Python modules, registry/API surfaces, docs,
+  fixtures, tests, and projections.
+- Documented compatibility risks for State Hub ingest, Graph Explorer,
+  provider/consumer query commands, registry storage, test fixtures, canon
+  mapping, and the existing accepted graph baseline.
+- Defined a migration approach that preserves `v1alpha1` declarations as
+  legacy evidence, adds a versioned vNext contract, reuses the existing
+  discovery/reconciliation mechanics, seeds the current one-fabric Railiance
+  baseline, and coordinates State Hub changes through `STATE-WP-0051`.
+
 ## T02 - Define The VNext Fabric Semantic Contract
 
 ```task
 id: RAIL-FAB-WP-0017-T02
-status: todo
+status: done
 priority: high
 state_hub_task_id: "8bbab878-0bff-4302-a925-15a8aceabf9b"
 ```
@@ -111,6 +124,20 @@ Done when:
 - examples cover the current single Railiance fabric, a tenant subfabric, and a
   cross-boundary utility edge.
 
+Result:
+
+- Added `docs/financial-fabric-vnext-contract.md`.
+- Defined a proposed `railiance.fabric/v1alpha2` / `financial-fabric-v1`
+  export shape with top-level netkingdom, actor, fabric, node, edge, and
+  unresolved sections.
+- Defined actor roles, fabric/subfabric containment, ownership resolution,
+  cross-boundary utility edges, accounting attribution, and evidence/provenance
+  shape.
+- Mapped legacy declaration kinds and existing edge types to vNext disposition.
+- Included examples for the current single Railiance fabric, a future tenant
+  subfabric, and a cross-subfabric utility edge.
+- Listed State Hub import requirements for `STATE-WP-0051`.
+
 ## T03 - Refactor Core Validation And Registry Materialization
 
 ```task
@@ -238,4 +265,3 @@ Done when:
 - The State Hub export schema is updated or a controlled reset path is
   documented.
 - Existing tests are updated or replaced with coverage for the new model.
-