@company-semantics/contracts 21.3.0 → 22.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "21.3.0",
+  "version": "22.1.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 = '16094a4fcda0' as const;
-export const SPEC_HASH_FULL = '16094a4fcda0647e96289cdc0e104eab13d9539c043207cdda1ad8c8bf5a4dcb' as const;
+export const SPEC_HASH = '151972b62216' as const;
+export const SPEC_HASH_FULL = '151972b622165a687006fbe1047eb84210072a2c2be50fd1c7651312e5266e1f' as const;

package/src/api/generated.ts

@@ -2959,6 +2959,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/factory/kpis": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read the factory KPI rollup (navigability over traversal_cost events) */
+        get: operations["factoryKpis"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/internal-admin/impersonate/start": {
         parameters: {
             query?: never;
@@ -3805,6 +3822,19 @@ export interface components {
             homeUnitId?: string;
             /** @enum {string} */
             homeUnitRole?: "member" | "unit_owner";
+            stagedPlacement?: {
+                title?: string;
+                /** Format: uuid */
+                managerUserId?: string;
+                /** Format: uuid */
+                homeUnitId?: string;
+                /** @enum {string} */
+                homeUnitRole?: "member" | "unit_owner";
+                /** @default [] */
+                unitOwnerOf: string[];
+                /** @default [] */
+                contributesTo: string[];
+            };
         };
         InviteListResponse: {
             id: string;
@@ -5392,6 +5422,95 @@ export interface components {
             } | null;
             receivedAt: string | null;
         };
+        SoftwareFactoryKpis: {
+            generatedFrom: {
+                events: number;
+                sessions: number;
+            };
+            navigability: {
+                overall: {
+                    p95Reads: number;
+                    p50Reads: number;
+                    p95ContextTokens: number;
+                    p50ContextTokens: number;
+                    reachedEditRate: number;
+                    searchEscapeRate: number;
+                    medianReadsAfterFirstEdit: number;
+                    p95ReadsAfterFirstEdit: number;
+                    navMapUsageBySource: {
+                        [key: string]: number;
+                    };
+                };
+                mapRoi: {
+                    withMap: {
+                        p95Reads: number;
+                        p95ContextTokens: number;
+                        n: number;
+                    };
+                    withoutMap: {
+                        p95Reads: number;
+                        p95ContextTokens: number;
+                        n: number;
+                    };
+                };
+                entropyLeaders: {
+                    prdId: string;
+                    p95Reads: number;
+                    p95ContextTokens: number;
+                    medianReadsAfterFirstEdit: number;
+                }[];
+                bySource: ({
+                    source: string;
+                } & {
+                    p95Reads?: number;
+                    p50Reads?: number;
+                    p95ContextTokens?: number;
+                    p50ContextTokens?: number;
+                    reachedEditRate?: number;
+                    searchEscapeRate?: number;
+                    medianReadsAfterFirstEdit?: number;
+                    p95ReadsAfterFirstEdit?: number;
+                    navMapUsageBySource?: {
+                        [key: string]: number;
+                    };
+                })[];
+                trend: {
+                    recent: {
+                        p95Reads?: number;
+                        p50Reads?: number;
+                        p95ContextTokens?: number;
+                        p50ContextTokens?: number;
+                        reachedEditRate?: number;
+                        searchEscapeRate?: number;
+                        medianReadsAfterFirstEdit?: number;
+                        p95ReadsAfterFirstEdit?: number;
+                        navMapUsageBySource?: {
+                            [key: string]: number;
+                        };
+                    };
+                    prior: {
+                        p95Reads?: number;
+                        p50Reads?: number;
+                        p95ContextTokens?: number;
+                        p50ContextTokens?: number;
+                        reachedEditRate?: number;
+                        searchEscapeRate?: number;
+                        medianReadsAfterFirstEdit?: number;
+                        p95ReadsAfterFirstEdit?: number;
+                        navMapUsageBySource?: {
+                            [key: string]: number;
+                        };
+                    };
+                    deltaP95Reads: number | null;
+                };
+            };
+            throughput: {
+                [key: string]: unknown;
+            } | null;
+            quality: {
+                [key: string]: unknown;
+            } | null;
+        };
         ImpersonationSessionResponse: {
             session: {
                 impersonationSessionId: string;
@@ -10386,6 +10505,40 @@ export interface operations {
             };
         };
     };
+    factoryKpis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Factory KPI rollup (navigability populated; throughput/quality null) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SoftwareFactoryKpis"];
+                };
+            };
+            /** @description Not authenticated */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not an internal admin */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     startImpersonation: {
         parameters: {
             query?: never;

package/src/identity/README.md

@@ -84,7 +84,7 @@ TypeScript types and functions for user identity and display name resolution.
 
 **Internal domains:**
 
-_None._
+- `org`
 
 **External packages:**
 

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

@@ -12,6 +12,7 @@
  * ADR-BE-120). Tree traversal must never consult either.
  */
 import { z } from "zod";
+import { AuthorityMutabilitySchema } from "../org/schemas";
 
 // ---------------------------------------------------------------------------
 // Reporting Relationship Type
@@ -34,6 +35,14 @@ export type ReportingRelationshipType = z.infer<
 export const PeopleOrgChartOwnedUnitSchema = z.object({
   id: z.string().uuid(),
   name: z.string(),
+  // Whether this local structural ownership is DERIVED from reporting topology
+  // (the senior person homed in a unit with no manager inside it — ADR-BE-267/
+  // 294/329) or an explicit grant (`user_managed`). The chart marks a derived
+  // owner with the distinct ✧ marker (not the held-key glyph). A derived owner
+  // can't be revoked in place — only relinquished. Display + affordance gating
+  // only; never an authorization input. Mirrors `WorkspaceMemberUnitDesignation
+  // Entry.mutability`.
+  mutability: AuthorityMutabilitySchema,
 });
 
 export type PeopleOrgChartOwnedUnit = z.infer<