@company-semantics/contracts 52.0.0 → 53.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "52.0.0",
+  "version": "53.0.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = 'd0171aedf623' as const;
-export const SPEC_HASH_FULL = 'd0171aedf623604dc721fb42b626ebc019afcc2fda9be59e1f06360cd6a4fcca' as const;
+export const SPEC_HASH = 'b8fe0a02c492' as const;
+export const SPEC_HASH_FULL = 'b8fe0a02c49284e732adac870b9b0ff155865b53f5cc8571aa0eb77c4af78859' as const;

package/src/api/generated.ts

@@ -738,7 +738,7 @@ export interface paths {
         patch: operations["changeMemberRole"];
         trace?: never;
     };
-    "/api/workspace/members/{id}/manager": {
+    "/api/reporting/positions/{positionId}/manager": {
         parameters: {
             query?: never;
             header?: never;
@@ -746,14 +746,13 @@ export interface paths {
             cookie?: never;
         };
         get?: never;
-        put?: never;
+        /** Set or clear a seat's solid-line manager (org-chart reporting edge) */
+        put: operations["setSeatManager"];
         post?: never;
-        /** Clear a member's solid-line manager (org-chart reporting edge) */
-        delete: operations["clearMemberManager"];
+        delete?: never;
         options?: never;
         head?: never;
-        /** Set a member's solid-line manager (org-chart reporting edge) */
-        patch: operations["setMemberManager"];
+        patch?: never;
         trace?: never;
     };
     "/api/reporting/move/preview": {
@@ -1409,6 +1408,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/org/reconciliation": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the workspace’s standing disagreements with the connected HRIS
+         * @description The org’s still-open divergences, newest first, whether they arose during a sync run or during app use. Distinct from the run-scoped conflicts view, which reports what one run refused. Read-only: nothing here is sent to the HRIS.
+         */
+        get: operations["getOrgReconciliation"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/org/reconciliation/divergences/{divergenceId}/resolution": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Acknowledge a standing disagreement with the connected HRIS
+         * @description Records LOCALLY that this workspace has seen the disagreement. Nothing is sent to the HRIS — the result’s sentToSource is always false — and the divergence stays open in the ledger, now carrying acknowledgedAt. Idempotent: acknowledging twice returns the first acknowledgement’s timestamp.
+         */
+        post: operations["resolveOrgDivergence"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/company-md/tree": {
         parameters: {
             query?: never;
@@ -4340,35 +4379,23 @@ export interface components {
             /** @enum {string} */
             newRole: "admin" | "member";
         };
-        SetMemberManagerResponse: {
+        SetSeatManagerResponse: {
             success: boolean;
-            memberId: string;
-            manager: ({
-                /** @constant */
-                kind: "member";
-                /** Format: uuid */
-                userId: string;
-            } | {
-                /** @constant */
-                kind: "open-role";
+            /** Format: uuid */
+            reportPositionId: string;
+            manager: {
                 /** Format: uuid */
-                openRoleId: string;
-            }) | null;
-            relationshipType: string;
+                positionId: string;
+            } | null;
+            /** @constant */
+            relationshipType: "solid";
             message: string;
         };
-        SetMemberManagerRequest: {
+        SetSeatManagerRequest: {
             manager: {
-                /** @constant */
-                kind: "member";
-                /** Format: uuid */
-                userId: string;
-            } | {
-                /** @constant */
-                kind: "open-role";
                 /** Format: uuid */
-                openRoleId: string;
-            };
+                positionId: string;
+            } | null;
         };
         MovePreviewRequest: {
             /** @constant */
@@ -4934,6 +4961,10 @@ export interface components {
             /** @enum {string} */
             decision: "accept" | "reject";
         };
+        ResolveOrgDivergenceRequest: {
+            /** @constant */
+            resolution: "acknowledged";
+        };
         CompanyMdListResponse: {
             items: {
                 id: string;
@@ -5673,7 +5704,7 @@ export interface components {
                 /** @enum {string} */
                 status: "open" | "hiring" | "filled" | "closed";
                 filledByUserId: string | null;
-                reportsToUserId: string | null;
+                reportsToPositionId: string | null;
                 createdAt: string;
                 updatedAt: string;
             }[];
@@ -5691,7 +5722,7 @@ export interface components {
                 /** @enum {string} */
                 status: "open" | "hiring" | "filled" | "closed";
                 filledByUserId: string | null;
-                reportsToUserId: string | null;
+                reportsToPositionId: string | null;
                 createdAt: string;
                 updatedAt: string;
             };
@@ -5708,7 +5739,8 @@ export interface components {
                 hiring: boolean;
                 occupants: {
                     /** Format: uuid */
-                    userId: string;
+                    personId: string;
+                    userId: string | null;
                     fullName: string;
                     avatarUrl: string | null;
                     primaryUnitId: string | null;
@@ -5720,6 +5752,7 @@ export interface components {
                         mutability: "derived" | "user_managed";
                     }[];
                 }[];
+                integrity: "canonical_placement_conflict" | null;
             }[];
             seatEdges: {
                 /** Format: uuid */
@@ -7926,50 +7959,28 @@ export interface operations {
             };
         };
     };
-    clearMemberManager: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Manager cleared successfully */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["SetMemberManagerResponse"];
-                };
-            };
-        };
-    };
-    setMemberManager: {
+    setSeatManager: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                id: string;
+                positionId: string;
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["SetMemberManagerRequest"];
+                "application/json": components["schemas"]["SetSeatManagerRequest"];
             };
         };
         responses: {
-            /** @description Manager set successfully */
+            /** @description The seat's solid-line manager edge was set or cleared */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SetMemberManagerResponse"];
+                    "application/json": components["schemas"]["SetSeatManagerResponse"];
                 };
             };
         };
@@ -8898,6 +8909,55 @@ export interface operations {
             };
         };
     };
+    getOrgReconciliation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The org’s open divergences, newest first — each carrying both sides, the winning tier and the human-readable reason (contracts OrgReconciliationLedger) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    resolveOrgDivergence: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                divergenceId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ResolveOrgDivergenceRequest"];
+            };
+        };
+        responses: {
+            /** @description The acknowledgement, with sentToSource pinned false (contracts ResolveOrgDivergenceResult) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No open divergence with that id — it belongs to another workspace, a later statement superseded it, or it has since been settled */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getCompanyMdTree: {
         parameters: {
             query?: {
@@ -10848,17 +10908,10 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    manager: ({
-                        /** @constant */
-                        kind: "member";
-                        /** Format: uuid */
-                        userId: string;
-                    } | {
-                        /** @constant */
-                        kind: "open-role";
+                    manager: {
                         /** Format: uuid */
-                        openRoleId: string;
-                    }) | null;
+                        positionId: string;
+                    } | null;
                 };
             };
         };

package/src/generated/openapi-routes.ts

@@ -138,6 +138,8 @@ export const openApiRoutes = {
   '/api/org/cancel-deletion': ['POST'],
   '/api/org/delete': ['POST'],
   '/api/org/deletion-eligibility': ['GET'],
+  '/api/org/reconciliation': ['GET'],
+  '/api/org/reconciliation/divergences/{divergenceId}/resolution': ['POST'],
   '/api/org/system-events': ['GET'],
   '/api/org/system-events/{id}/acknowledge': ['POST'],
   '/api/org/transfer-eligibility': ['GET'],
@@ -154,6 +156,7 @@ export const openApiRoutes = {
   '/api/rbac/roles': ['GET'],
   '/api/reporting/move/apply': ['POST'],
   '/api/reporting/move/preview': ['POST'],
+  '/api/reporting/positions/{positionId}/manager': ['PUT'],
   '/api/scope/check': ['GET'],
   '/api/scope/check-batch': ['POST'],
   '/api/shared/{token}': ['GET'],
@@ -192,7 +195,6 @@ export const openApiRoutes = {
   '/api/workspace/invites/{id}': ['DELETE'],
   '/api/workspace/members': ['GET'],
   '/api/workspace/members/{id}': ['DELETE', 'GET'],
-  '/api/workspace/members/{id}/manager': ['DELETE', 'PATCH'],
   '/api/workspace/members/{id}/role': ['PATCH'],
   '/api/workspace/name': ['PATCH'],
   '/api/workspace/organization': ['PATCH'],

package/src/identity/README.md

@@ -49,8 +49,6 @@ TypeScript types and functions for user identity and display name resolution.
 - `MeResponse` _(type)_
 - `MeResponseSchema` — Full identity context returned by GET /api/me.
 - `NameSource` _(type)_ — Source of the user's name data.
-- `OrgChartActorRef` _(type)_
-- `OrgChartActorRefSchema`
 - `PeopleOrgChartOwnedUnit` _(type)_
 - `PeopleOrgChartOwnedUnitSchema`
 - `PeopleOrgChartResponse` _(type)_
@@ -65,6 +63,8 @@ TypeScript types and functions for user identity and display name resolution.
 - `PeopleOrgChartSeatStatusSchema`
 - `Person` _(type)_
 - `PersonSchema`
+- `PositionRef` _(type)_
+- `PositionRefSchema` — A reference to a POSITION in the org graph.
 - `ProfileResponse` _(type)_
 - `ProfileResponseSchema`
 - `ReportingRelationshipType` _(type)_

package/src/identity/__tests__/people-org-chart.test.ts

@@ -51,25 +51,60 @@ describe("PeopleOrgChartSeatOccupantSchema", () => {
 });
 
 describe("PeopleOrgChartSeatSchema", () => {
+  const filledSeat = {
+    id: POSITION_ID,
+    unitId: UNIT_ID,
+    title: "Analyst",
+    status: "filled",
+    hiring: false,
+    occupants: [
+      {
+        personId: PERSON_ID,
+        userId: null,
+        fullName: "Ada Lovelace",
+        avatarUrl: null,
+        primaryUnitId: null,
+        ownedUnits: [],
+      },
+    ],
+    integrity: null,
+  };
+
   it("admits a filled seat whose only occupant is accountless", () => {
-    const seat = PeopleOrgChartSeatSchema.parse({
-      id: POSITION_ID,
-      unitId: UNIT_ID,
-      title: "Analyst",
-      status: "filled",
-      hiring: false,
-      occupants: [
-        {
-          personId: PERSON_ID,
-          userId: null,
-          fullName: "Ada Lovelace",
-          avatarUrl: null,
-          primaryUnitId: null,
-          ownedUnits: [],
-        },
-      ],
-    });
+    const seat = PeopleOrgChartSeatSchema.parse(filledSeat);
     expect(seat.occupants).toHaveLength(1);
     expect(seat.occupants[0]?.userId).toBeNull();
+    expect(seat.integrity).toBeNull();
+  });
+
+  // The marker is what separates a breached seat from a vacancy: both carry
+  // `occupants: []`, so a consumer reading only the occupant list would offer
+  // to fill a seat whose holder the server deliberately withheld.
+  it("admits a seat whose withheld holder is flagged as a placement conflict", () => {
+    const seat = PeopleOrgChartSeatSchema.parse({
+      ...filledSeat,
+      occupants: [],
+      integrity: "canonical_placement_conflict",
+    });
+    expect(seat.integrity).toBe("canonical_placement_conflict");
+  });
+
+  // .nullable() WITHOUT .optional(), for the same reason as occupant.userId:
+  // the server always emits the key, so "no marker" must be spelled null rather
+  // than left to an absent field a consumer would read as healthy by default.
+  it("rejects an absent integrity — nullable is not optional", () => {
+    const { integrity: _omitted, ...withoutIntegrity } = filledSeat;
+    expect(PeopleOrgChartSeatSchema.safeParse(withoutIntegrity).success).toBe(
+      false,
+    );
+  });
+
+  it("rejects an unknown integrity marker", () => {
+    expect(
+      PeopleOrgChartSeatSchema.safeParse({
+        ...filledSeat,
+        integrity: "something_else",
+      }).success,
+    ).toBe(false);
   });
 });

package/src/identity/__tests__/position-ref.test.ts

@@ -0,0 +1,44 @@
+import { describe, it, expect } from "vitest";
+
+import { PositionRefSchema } from "../position-ref.js";
+
+const POSITION_ID = "11111111-1111-4111-8111-111111111111";
+const USER_ID = "22222222-2222-4222-8222-222222222222";
+
+describe("PositionRefSchema", () => {
+  it("accepts a reference carrying a uuid positionId", () => {
+    expect(PositionRefSchema.parse({ positionId: POSITION_ID })).toEqual({
+      positionId: POSITION_ID,
+    });
+  });
+
+  it("rejects a non-uuid positionId", () => {
+    expect(PositionRefSchema.safeParse({ positionId: "seat-1" }).success).toBe(
+      false,
+    );
+  });
+
+  it("rejects an absent positionId", () => {
+    expect(PositionRefSchema.safeParse({}).success).toBe(false);
+  });
+
+  // The retired OrgChartActorRef union spelled a filled seat as
+  // `{ kind: 'member', userId }`. Nothing in the write vocabulary speaks that
+  // shape any more: a user id is not a way to name a chart actor, because most
+  // people in an org graph have no account at all.
+  it("does not admit the retired member arm — a userId is not a position", () => {
+    const result = PositionRefSchema.safeParse({
+      kind: "member",
+      userId: USER_ID,
+    });
+    expect(result.success).toBe(false);
+  });
+
+  // Not strict(): unknown keys are stripped rather than rejected, matching the
+  // rest of the identity vocabulary.
+  it("strips unknown keys rather than rejecting them", () => {
+    expect(
+      PositionRefSchema.parse({ positionId: POSITION_ID, kind: "open-role" }),
+    ).toEqual({ positionId: POSITION_ID });
+  });
+});

package/src/identity/index.ts

@@ -64,7 +64,6 @@ export type {
 // People Org Chart (GET /api/users/org-chart)
 export {
   ReportingRelationshipTypeSchema,
-  OrgChartActorRefSchema,
   PeopleOrgChartOwnedUnitSchema,
   PeopleOrgChartSeatStatusSchema,
   PeopleOrgChartSeatOccupantSchema,
@@ -74,7 +73,6 @@ export {
 } from "./people-org-chart";
 export type {
   ReportingRelationshipType,
-  OrgChartActorRef,
   PeopleOrgChartOwnedUnit,
   PeopleOrgChartSeatStatus,
   PeopleOrgChartSeatOccupant,
@@ -83,6 +81,12 @@ export type {
   PeopleOrgChartResponse,
 } from "./people-org-chart";
 
+// Position Ref — the single org-graph WRITE reference (ADR-CONTRACTS-131).
+// Not chart vocabulary: three write schemas outside the chart speak it, which
+// is why it is named for the Position and exported from its own module.
+export { PositionRefSchema } from "./position-ref";
+export type { PositionRef } from "./position-ref";
+
 // Person — the org-graph node for a human (0..1 User link), per ADR-CTRL-182
 export { PersonSchema } from "./person";
 export type { Person } from "./person";

package/src/identity/people-org-chart.ts

@@ -7,7 +7,10 @@
  * The chart is position-centric (ADR-CONT-093/094): every actor is a `seat`
  * (a `positions` row) carrying its seat-scoped attributes plus an `occupants[]`
  * array; reporting is expressed seat→seat in `seatEdges[]`. A VACANT seat (no
- * occupants) is the old "open role"; an OCCUPIED seat is the old "member".
+ * occupants AND a null `integrity` marker) is the old "open role"; an OCCUPIED
+ * seat is the old "member". A seat whose `integrity` marker is set is neither:
+ * its holder exists but was withheld, so it must never be offered as an open
+ * role.
  *
  * Person-level reporting is intentionally distinct from
  * `org_unit_relationships.type = 'reports_to'` (unit-to-unit graph overlay,
@@ -25,14 +28,6 @@ export type ReportingRelationshipType = z.infer<
   typeof ReportingRelationshipTypeSchema
 >;
 
-// Actor reference (member | open-role). Retained WRITE-ONLY: the set-manager
-// request/response (`org/schemas`) still speaks this vocabulary; the read model
-// is now seat→seat (ADR-CONT-094) and no longer references it. Defined in its
-// own zero-dependency module to avoid a module-init cycle with `org/schemas`,
-// and re-exported here so the existing barrel import site keeps working.
-export { OrgChartActorRefSchema } from "./org-chart-actor";
-export type { OrgChartActorRef } from "./org-chart-actor";
-
 // ---------------------------------------------------------------------------
 // Owned unit — shared by the seat occupant (below)
 // ---------------------------------------------------------------------------
@@ -67,13 +62,14 @@ export type PeopleOrgChartOwnedUnit = z.infer<
 // its SEAT-SCOPED attributes (unit placement, title, seat-existence status,
 // hiring/staffing sub-state) plus an `occupants[]` array of PERSON-SCOPED
 // attributes for whoever currently holds it. The split is structural, not
-// member-vs-open-role: a VACANT seat (`occupants: []`) is the old "open role";
+// member-vs-open-role: a VACANT seat (`occupants: []` with `integrity: null`)
+// is the old "open role";
 // an OCCUPIED seat (`occupants.length >= 1`) is the old "member" (N occupants
 // for a co-occupied seat — forward-compatible; live data is 0/1). Reporting is
 // expressed seat→seat in `seatEdges[]`, NOT on the seat, so the edge list stays
-// the single source of truth for placement (ADR-CTRL-159). `OrgChartActorRef`
-// is retained write-only (set-manager request/response) and is absent from this
-// read model.
+// the single source of truth for placement (ADR-CTRL-159). The write model
+// names the same actors with a `PositionRef` (`identity/position-ref`), so read
+// and write now agree that a chart actor IS a position.
 //
 // `seats[]` + `seatEdges[]` are now the ONLY shape — the legacy
 // `nodes`/`edges`/`openRoles` half was removed in ADR-CONT-094 (breaking).
@@ -144,7 +140,22 @@ export const PeopleOrgChartSeatSchema = z.object({
   // The seat's current holders. [] ⇒ vacant (the old "open role"); >= 1 ⇒
   // occupied (the old "member"). Every canonical occupant appears, account or
   // not — occupancy, not account linkage, is what admits a person here.
+  //
+  // READ WITH `integrity` BELOW: `occupants: []` means vacant ONLY when
+  // `integrity` is null.
   occupants: z.array(PeopleOrgChartSeatOccupantSchema),
+  // Structural integrity of the OCCUPANT LIST above. null ⇒ the list is
+  // complete and `occupants: []` is a true vacancy.
+  //
+  // `canonical_placement_conflict` ⇒ at least one person holding this seat was
+  // WITHHELD from `occupants` because they hold more than one live canonical
+  // placement (ADR-BE-559). The projector refuses to bless one of the
+  // conflicting placements, so the seat renders with its holder unnamed — and
+  // an EMPTY `occupants` on such a seat is NOT a vacancy. A consumer must not
+  // offer to fill, staff, or reorg a flagged seat as an open role: the seat has
+  // a holder the server declines to name, and the breach is recorded
+  // server-side as `org_chart.canonical_placement_conflict`.
+  integrity: z.enum(["canonical_placement_conflict"]).nullable(),
 });
 
 export type PeopleOrgChartSeat = z.infer<typeof PeopleOrgChartSeatSchema>;
@@ -152,8 +163,8 @@ export type PeopleOrgChartSeat = z.infer<typeof PeopleOrgChartSeatSchema>;
 // A seat→seat reporting edge — one row per `position_reporting` row (NOT a
 // member cross-product). Endpoints are positionIds; resolve each to its seat in
 // `seats[]`. Mirrors the legacy person-keyed `PeopleOrgChartEdge`, but keyed by
-// the stable seat identity so a vacant seat's edge is expressible without an
-// `OrgChartActorRef`.
+// the stable seat identity so a vacant or accountless seat's edge is
+// expressible at all — the same identity the write model spells `PositionRef`.
 export const PeopleOrgChartSeatEdgeSchema = z.object({
   reportPositionId: z.string().uuid(),
   managerPositionId: z.string().uuid(),

package/src/identity/position-ref.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+
+/**
+ * A reference to a POSITION in the org graph.
+ *
+ * Replaces the two-arm OrgChartActorRef union, which was already degenerate:
+ * `openRoleId` WAS a positions.id, and `{ kind:'member', userId }` was only a
+ * slow way to name a seat -- every consumer immediately resolved it through
+ * `resolveSeat`. Once occupants are person-keyed the `member` arm has no
+ * definition at all, because most people in an org graph have no account.
+ *
+ * Named PositionRef, not OrgChartSeatRef: it is consumed by the member-manager
+ * schema, the open-role reports-to schema and the reporting route, so it
+ * already spreads well past the chart. The thing referenced is a Position.
+ *
+ * An OBJECT rather than a bare uuid so `{ manager: PositionRef | null }` keeps
+ * `null` meaning "clear", the field name says what the uuid is, and future edge
+ * attributes have a home.
+ *
+ * Zero-dependency (zod only) to avoid the module-init cycle that caused the
+ * original actor-ref file to be split out.
+ */
+export const PositionRefSchema = z.object({ positionId: z.string().uuid() });
+export type PositionRef = z.infer<typeof PositionRefSchema>;

package/src/index.ts

@@ -175,7 +175,6 @@ export type {
 // People Org Chart (GET /api/users/org-chart)
 export {
   ReportingRelationshipTypeSchema,
-  OrgChartActorRefSchema,
   PeopleOrgChartOwnedUnitSchema,
   PeopleOrgChartSeatStatusSchema,
   PeopleOrgChartSeatOccupantSchema,
@@ -185,7 +184,6 @@ export {
 } from "./identity/index";
 export type {
   ReportingRelationshipType,
-  OrgChartActorRef,
   PeopleOrgChartOwnedUnit,
   PeopleOrgChartSeatStatus,
   PeopleOrgChartSeatOccupant,
@@ -194,6 +192,10 @@ export type {
   PeopleOrgChartResponse,
 } from "./identity/index";
 
+// Position Ref — the single org-graph WRITE reference (ADR-CONTRACTS-131)
+export { PositionRefSchema } from "./identity/index";
+export type { PositionRef } from "./identity/index";
+
 // Person — the org-graph node for a human (0..1 User link), per ADR-CTRL-182
 export { PersonSchema } from "./identity/index";
 export type { Person } from "./identity/index";
@@ -681,6 +683,23 @@ export type {
   OrgStructureInferenceDecisionResult,
 } from "./org/index";
 
+// Org reconciliation ledger: the org's STANDING disagreements with the connected
+// HRIS — the open ones only, sync-time (runId set) and app-time (runId null)
+// alike. Complements the run-scoped conflicts view rather than replacing it, and
+// resolution is a LOCAL decision only. (ADR-BE-564)
+export {
+  OrgDivergenceSchema,
+  OrgReconciliationLedgerSchema,
+  OrgDivergenceResolutionSchema,
+  ResolveOrgDivergenceResultSchema,
+} from "./org/index";
+export type {
+  OrgDivergence,
+  OrgReconciliationLedger,
+  OrgDivergenceResolution,
+  ResolveOrgDivergenceResult,
+} from "./org/index";
+
 // Org transformation wire vocabulary: intent -> simulation -> preview. The
 // engine turns a TransformationRequest into scored mutation bundles and returns
 // a TransformationPreview the operator confirms before apply. (ADR-CONTRACTS-072)