V48 (specification-implementation): Modularize reads experience page clients and models

Split oversized Reads clients and models into named component units, co-located
hooks, and pure model builders per BITCODE_SOURCE_LAYOUT. Thin ReadPageClient
orchestration; extract pipeline telemetry, route aside, repository field/units,
scenario actions/review/list; split read-route-model and enterprise UX types;
document entry paths in README and FAMILIARIZATION §7.3.

Author: geraldarthurdavis

FAMILIARIZATION.md

@@ -390,6 +390,25 @@ Shares synthesis pipeline core; **read lens** / neediness finalization continues
 in later V48 gates. Workbench panels under `Reads*` + `models/deposit-read-*`
 (historical name; deposit+read shared workbench models).
 
+**Reads modularization (entry paths):**
+
+- Page orchestration: `uapi/components/reads/ReadPageClient/ReadPageClient.tsx`
+  with hooks (`use-read-live-runs`, `use-read-url-navigation`,
+  `use-read-pipeline-telemetry`, `use-read-session-projections`,
+  `use-read-activity-recording`, `use-read-route-params`)
+- Pipelines master-detail: `ReadsPipelinesSection` + `ReadsPipelineTelemetry`
+- Route aside: `ReadsRouteStateAside` + pure rows in `models/read-route-rows.ts`
+- Route model facade: `models/read-route-model.ts` (types in
+  `read-route-session-types.ts`; procurement / fit / settlement builders
+  co-located siblings)
+- Enterprise reading steps: `enterprise-reading-ux-types.ts` +
+  `enterprise-reading-ux-state.ts`
+- Repository supply: `ReadsRepositoryContextPanel` + `use-reads-repository-vcs`
+  + field grid / connection / supply / guidance units
+- Scenario measurement: `ReadsReadScenarioPanel` + `use-read-scenario-actions`
+  + fitting review / scenario list units
+- Evidence rows: `deposit-read-evidence-*-rows.ts` facades under `models/`
+
 ### 7.4 Packs (`/packs`)
 
 Network-scope PackActivity master-detail (ledgerized history).  
@@ -427,6 +446,19 @@ utilities). Prefer `/packs` as post-auth landing, not Terminal.
 Identity, wallet, GitHub externals, interfaces, organization/treasury panes.  
 Route: `/auxillaries/[pane]`. Overlays can open from product pages.
 
+| Concern | Location under `uapi/components/auxillaries/` |
+| --- | --- |
+| Surface shell + step wiring | `AuxillariesSurface/` (`hooks/`, `models/`, dynamic pane imports) |
+| Profile | `AuxillariesProfilePane/` + `Profile*Section/`, `OrganizationAuthoritySection/` |
+| Wallet / BTD | `AuxillariesWalletPane/` + `WalletBtdPostureSection/`, `AuxillariesWalletConnectionPanel/` |
+| Externals / GitHub | `AuxillariesExternalsPane/` + `ExternalsConnectedWorkspace/`, `ExternalsWalletRequiredGate/` |
+| Interfaces | `AuxillariesInterfacesPane/` + `InterfaceAdmissionCatalog/` |
+| Organization | `organization/OrganizationSettings/` (tab units) + `BTDTreasuryManagement/` |
+| Shared chrome | `headers/`, `shared/` (tabs, stat grids, preference cards, workspace sections) |
+
+Layout contract: `uapi/components/auxillaries/README.md` and
+`internal-docs/BITCODE_SOURCE_LAYOUT.md`.
+
 ### 7.8 Bitcode base
 
 Shared chrome: `Nav`, `AuthProvider`, `ProductRouteShell`, `BitcodePipelinesTable`,

uapi/components/reads/README.md

@@ -6,21 +6,52 @@
 reads/
   README.md
   models/
-    deposit-read-workbench.ts              # stable public re-exports
-    deposit-read-workbench-types.ts        # source revision + workbench types
-    deposit-read-workbench-snapshot.ts     # live shell snapshot builder
-    deposit-read-workbench-normalize.ts    # snapshot → deposit/read/fit view model
-    deposit-read-evidence-rows.ts          # pure evidence/key-value row builders
-    enterprise-reading-ux-state.ts
-    read-route-model.ts
+    deposit-read-workbench.ts                    # stable public re-exports
+    deposit-read-workbench-types.ts
+    deposit-read-workbench-snapshot.ts
+    deposit-read-workbench-normalize.ts          # normalize snapshot → view model
+    deposit-read-workbench-normalize-helpers.ts
+    deposit-read-evidence-rows.ts                # evidence facade
+    deposit-read-evidence-row-builders.ts        # row-builder facade
+    deposit-read-evidence-disclosure-rows.ts
+    deposit-read-evidence-asset-pack-rows.ts
+    deposit-read-evidence-need-rows.ts
+    enterprise-reading-ux-types.ts               # step catalog + types
+    enterprise-reading-ux-state.ts               # builders + re-exports
+    read-route-session-types.ts
+    read-route-helpers.ts
+    read-procurement-governance.ts
+    read-fit-measurement-review.ts
+    read-settlement-rights-delivery.ts
+    read-route-model.ts                          # session facade + stage helpers
+    read-route-rows.ts                           # session / procurement / authority rows
     read-scenarios.ts
     read-format.ts
     read-workbench-values.ts
   ReadPageClient/
-    ReadPageClient.tsx
-    hooks/use-read-route-params.ts
+    ReadPageClient.tsx                           # thin orchestration
+    hooks/
+      use-read-route-params.ts
+      use-read-live-runs.ts
+      use-read-url-navigation.ts
+      use-read-pipeline-telemetry.ts
+      use-read-session-projections.ts
+      use-read-activity-recording.ts
+  ReadsPipelinesSection/
+  ReadsPipelineTelemetry/
+  ReadsRouteStateAside/
+  ReadsPipelinesMaster/
+  ReadsRepositoryContextPanel/
+    hooks/use-reads-repository-vcs.ts
+  ReadsRepositoryFieldGrid/
+  ReadsRepositoryConnectionUnit/
+  ReadsRepositorySupplyUnit/
+  ReadsRepositoryGuidanceUnit/
+  ReadsReadScenarioPanel/
+    hooks/use-read-scenario-actions.ts
+  ReadsReadScenarioFittingReview/
+  ReadsReadScenarioList/
   ReadsDepositReadWorkbench/
-    ReadsDepositReadWorkbench.tsx          # orchestration only
     hooks/
       use-deposit-read-activity-recording.ts
       use-deposit-read-harness.ts
@@ -33,14 +64,16 @@ reads/
   ReadsMeasuredReadAdmissionPanel/
   ReadsFitWorkbenchPanel/
   ReadsEnterpriseReadingSteps/
-  ReadsRepositoryContextPanel/
-  ReadsReadScenarioPanel/
-  ReadsPipelinesMaster/
 ```
 
 Page shell: `uapi/app/reads/`.
 
-Import Bitcode only. Full filesystem contract: `internal-docs/BITCODE_SOURCE_LAYOUT.md`.
+Import Bitcode only (no cross-experience imports for new work). Full filesystem
+contract: `internal-docs/BITCODE_SOURCE_LAYOUT.md`.
 
 Stable external import for workbench models remains:
 `@/components/reads/models/deposit-read-workbench`.
+
+Stable external import for route model remains:
+`@/components/reads/models/read-route-model` (also via deprecated
+`@/app/reads/read-route-model` re-export).