@company-semantics/contracts 92.0.0 → 93.1.0

package/src/api/generated.ts

@@ -3911,6 +3911,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/factory/lineage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read change lineage: each release with its commits, PRDs, workers, run and health */
+        get: operations["factoryLineage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/factory/quality/changes": {
         parameters: {
             query?: never;
@@ -6893,6 +6910,13 @@ export interface components {
                         requiredScope?: string;
                     };
                 };
+                workspace?: {
+                    manageSettings: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
             };
             chatMentions: boolean;
             chatMultiParty: boolean;
@@ -7161,6 +7185,63 @@ export interface components {
                 } | {
                     /** @constant */
                     id: "hris.resyncDirectory";
+                } | {
+                    /** @constant */
+                    id: "integrations.open";
+                } | {
+                    /** @constant */
+                    id: "hris.connect";
+                } | {
+                    /** @constant */
+                    id: "account.editProfile";
+                } | {
+                    /** @constant */
+                    id: "workspace.openOrgSettings";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.addFile";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.openUpdate";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "orgStructure.openReview";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "chat.open";
+                    args: {
+                        chatId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openDoc";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openHistory";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "team.open";
+                    args: {
+                        unitId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "execution.open";
+                    args: {
+                        executionId: string;
+                    };
                 })[];
             } | {
                 /** @constant */
@@ -7202,6 +7283,63 @@ export interface components {
                 } | {
                     /** @constant */
                     id: "hris.resyncDirectory";
+                } | {
+                    /** @constant */
+                    id: "integrations.open";
+                } | {
+                    /** @constant */
+                    id: "hris.connect";
+                } | {
+                    /** @constant */
+                    id: "account.editProfile";
+                } | {
+                    /** @constant */
+                    id: "workspace.openOrgSettings";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.addFile";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.openUpdate";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "orgStructure.openReview";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "chat.open";
+                    args: {
+                        chatId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openDoc";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openHistory";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "team.open";
+                    args: {
+                        unitId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "execution.open";
+                    args: {
+                        executionId: string;
+                    };
                 })[];
             } | {
                 /** @constant */
@@ -7245,6 +7383,63 @@ export interface components {
                 } | {
                     /** @constant */
                     id: "hris.resyncDirectory";
+                } | {
+                    /** @constant */
+                    id: "integrations.open";
+                } | {
+                    /** @constant */
+                    id: "hris.connect";
+                } | {
+                    /** @constant */
+                    id: "account.editProfile";
+                } | {
+                    /** @constant */
+                    id: "workspace.openOrgSettings";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.addFile";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.openUpdate";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "orgStructure.openReview";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "chat.open";
+                    args: {
+                        chatId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openDoc";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openHistory";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "team.open";
+                    args: {
+                        unitId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "execution.open";
+                    args: {
+                        executionId: string;
+                    };
                 })[];
             } | {
                 /** @constant */
@@ -7288,6 +7483,63 @@ export interface components {
                 } | {
                     /** @constant */
                     id: "hris.resyncDirectory";
+                } | {
+                    /** @constant */
+                    id: "integrations.open";
+                } | {
+                    /** @constant */
+                    id: "hris.connect";
+                } | {
+                    /** @constant */
+                    id: "account.editProfile";
+                } | {
+                    /** @constant */
+                    id: "workspace.openOrgSettings";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.addFile";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.openUpdate";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "orgStructure.openReview";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "chat.open";
+                    args: {
+                        chatId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openDoc";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openHistory";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "team.open";
+                    args: {
+                        unitId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "execution.open";
+                    args: {
+                        executionId: string;
+                    };
                 })[];
             }) | null;
             error?: string;
@@ -7316,7 +7568,7 @@ export interface components {
         AffordanceStateResponse: {
             entries: {
                 /** @enum {string} */
-                id: "sourceSync.findFiles" | "integrations.connectGoogleDrive" | "sourceSync.enable" | "billing.open" | "orgStructure.reanalyze" | "hris.resyncDirectory" | "review.open";
+                id: "sourceSync.findFiles" | "integrations.connectGoogleDrive" | "sourceSync.enable" | "billing.open" | "orgStructure.reanalyze" | "hris.resyncDirectory" | "review.open" | "integrations.open" | "hris.connect" | "account.editProfile" | "workspace.openOrgSettings" | "sourceSync.addFile" | "sourceSync.openUpdate" | "orgStructure.openReview" | "chat.open" | "companyMd.openDoc" | "companyMd.openHistory" | "team.open" | "execution.open";
                 /** @enum {string} */
                 policy: "allowed" | "blocked";
                 availability: {
@@ -8415,6 +8667,90 @@ export interface components {
                 contextLabel: string;
                 provider: string | null;
                 href: string;
+                affordance?: {
+                    /** @constant */
+                    id: "sourceSync.findFiles";
+                } | {
+                    /** @constant */
+                    id: "integrations.connectGoogleDrive";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.enable";
+                } | {
+                    /** @constant */
+                    id: "billing.open";
+                } | {
+                    /** @constant */
+                    id: "orgStructure.reanalyze";
+                } | {
+                    /** @constant */
+                    id: "hris.resyncDirectory";
+                } | {
+                    /** @constant */
+                    id: "integrations.open";
+                } | {
+                    /** @constant */
+                    id: "hris.connect";
+                } | {
+                    /** @constant */
+                    id: "account.editProfile";
+                } | {
+                    /** @constant */
+                    id: "workspace.openOrgSettings";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.addFile";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.openUpdate";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "orgStructure.openReview";
+                    args: {
+                        proposalId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "chat.open";
+                    args: {
+                        chatId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openDoc";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "companyMd.openHistory";
+                    args: {
+                        docId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "team.open";
+                    args: {
+                        unitId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "execution.open";
+                    args: {
+                        executionId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "review.open";
+                    args: {
+                        /** @enum {string} */
+                        requestType: "org-structure/review" | "source-sync/candidates" | "source-sync/synthesis";
+                        requestId: string;
+                    };
+                };
                 createdAt: string;
             }[];
         };
@@ -8437,6 +8773,90 @@ export interface components {
                     contextLabel: string;
                     provider: string | null;
                     href: string;
+                    affordance?: {
+                        /** @constant */
+                        id: "sourceSync.findFiles";
+                    } | {
+                        /** @constant */
+                        id: "integrations.connectGoogleDrive";
+                    } | {
+                        /** @constant */
+                        id: "sourceSync.enable";
+                    } | {
+                        /** @constant */
+                        id: "billing.open";
+                    } | {
+                        /** @constant */
+                        id: "orgStructure.reanalyze";
+                    } | {
+                        /** @constant */
+                        id: "hris.resyncDirectory";
+                    } | {
+                        /** @constant */
+                        id: "integrations.open";
+                    } | {
+                        /** @constant */
+                        id: "hris.connect";
+                    } | {
+                        /** @constant */
+                        id: "account.editProfile";
+                    } | {
+                        /** @constant */
+                        id: "workspace.openOrgSettings";
+                    } | {
+                        /** @constant */
+                        id: "sourceSync.addFile";
+                    } | {
+                        /** @constant */
+                        id: "sourceSync.openUpdate";
+                        args: {
+                            proposalId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "orgStructure.openReview";
+                        args: {
+                            proposalId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "chat.open";
+                        args: {
+                            chatId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "companyMd.openDoc";
+                        args: {
+                            docId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "companyMd.openHistory";
+                        args: {
+                            docId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "team.open";
+                        args: {
+                            unitId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "execution.open";
+                        args: {
+                            executionId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "review.open";
+                        args: {
+                            /** @enum {string} */
+                            requestType: "org-structure/review" | "source-sync/candidates" | "source-sync/synthesis";
+                            requestId: string;
+                        };
+                    };
                     createdAt: string;
                 };
             } | {
@@ -8857,6 +9277,11 @@ export interface components {
                     };
                     eventTimestamp: string;
                 }[];
+                pausedAuth?: {
+                    since: string;
+                    lane: number;
+                    reason: string | null;
+                } | null;
             }[];
         };
         FactorySnapshotResponse: {
@@ -8993,6 +9418,49 @@ export interface components {
                 [key: string]: unknown;
             } | null;
         };
+        FactoryLineageResponse: {
+            releases: {
+                key: string;
+                manifestId: string | null;
+                stationId: string;
+                /** @enum {string} */
+                status: "in_progress" | "applied" | "rolled_back";
+                intendedAt: string | null;
+                appliedAt: string | null;
+                durationMs: number | null;
+                surfaces: string[];
+                shas: {
+                    [key: string]: string;
+                } | null;
+                run: {
+                    id: string;
+                    attempt: number;
+                    repository: string;
+                    url: string;
+                } | null;
+                health: {
+                    /** @enum {string} */
+                    releaseInvariant: "ok" | "failed" | "unproven" | "unknown";
+                    /** @enum {string} */
+                    windowMetric: "ok" | "failed" | "unproven" | "unknown";
+                    /** @enum {string} */
+                    pointProbe: "ok" | "failed" | "unproven" | "unknown";
+                    rolledBack: boolean;
+                } | null;
+                commitsRecorded: boolean;
+                changesTruncated: boolean;
+                changes: {
+                    repo: string;
+                    sha: string;
+                    prdId: string | null;
+                    pr: number | null;
+                    worker: {
+                        stationId: string;
+                        executorId: string;
+                    } | null;
+                }[];
+            }[];
+        };
         CreateQualityChangeResponse: {
             /** Format: uuid */
             planId: string;
@@ -17501,6 +17969,43 @@ export interface operations {
             };
         };
     };
+    factoryLineage: {
+        parameters: {
+            query?: {
+                limit?: number;
+                prdId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Lineage records, newest release first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FactoryLineageResponse"];
+                };
+            };
+            /** @description Not authenticated */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not an internal admin */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     createQualityChange: {
         parameters: {
             query?: never;

package/src/api/primitives.ts

@@ -1,5 +1,10 @@
 import { z } from "zod";
 
+import {
+  AffordanceSchema,
+  MAX_OFFERED_AFFORDANCES,
+} from "../affordances/affordance";
+
 /** Generic factory for cursor-paginated responses. */
 export function CursorPageSchema<T extends z.ZodTypeAny>(itemSchema: T) {
   return z.object({
@@ -15,6 +20,14 @@ export const ErrorResponseSchema = z.object({
     code: z.string(),
     message: z.string(),
     retryable: z.boolean(),
+    /**
+     * The catalog affordances that resolve this error, when any do (control ADR
+     * affordance-system) — e.g. billing.open on a billing refusal for a viewer
+     * who may open billing. Present only when non-empty; the message states the
+     * fact and never tells the reader what to do.
+     */
+    // prettier-ignore
+    affordances: z.array(AffordanceSchema).min(1).max(MAX_OFFERED_AFFORDANCES).optional(),
   }),
 });
 

package/src/billing/README.md

@@ -221,6 +221,7 @@ owner is always its owner contradicts ADR-BE-296, and nothing imported them.
 
 **Internal domains:**
 
+- `affordances`
 - `api`
 
 **External packages:**

package/src/billing/refusals.ts

@@ -40,6 +40,11 @@
  */
 import { z } from "zod";
 
+import {
+  AffordanceSchema,
+  MAX_OFFERED_AFFORDANCES,
+} from "../affordances/affordance";
+
 import { type AiPauseReason } from "./vocabulary";
 
 /* -------------------------------------------------------------------------- */
@@ -216,5 +221,12 @@ export const BillingRefusalPartSchema = z
     orgId: z.string(),
     /** Whether retrying the same turn could succeed once the cause clears. */
     retryable: z.boolean(),
+    /**
+     * The catalog affordances that resolve the refusal for this viewer (control
+     * ADR affordance-system), e.g. billing.open. Present only when non-empty;
+     * the app renders them as controls beside the code's fact.
+     */
+    // prettier-ignore
+    affordances: z.array(AffordanceSchema).min(1).max(MAX_OFFERED_AFFORDANCES).optional(),
   })
   .strict();