@company-semantics/contracts 89.1.0 → 89.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "89.1.0",
+  "version": "89.2.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -177,8 +177,9 @@
       "picomatch@<4.0.4": ">=4.0.4",
       "esbuild@<0.28.1": ">=0.28.1",
       "linkify-it@<5.0.2": ">=5.0.2",
-      "postcss@<8.5.18": ">=8.5.18",
-      "markdown-it@<14.2.0": ">=14.2.0"
+      "postcss@<8.5.23": ">=8.5.23",
+      "markdown-it@<14.2.0": ">=14.2.0",
+      "@humanfs/node@<0.16.8": ">=0.16.8 <0.17.0"
     }
   },
   "lint-staged": {
@@ -186,5 +187,5 @@
     "*.md": "markdownlint-cli2",
     "package.json": "node -e \"JSON.parse(require('fs').readFileSync('package.json'))\""
   },
-  "securityRequirementsVersion": "bfd57aaebc7d47d195f06ba507ed3fb56da0faa9c40aca3c00f2e63dbd3b617b"
+  "securityRequirementsVersion": "8700b9fe36f8c948f12970ec54128e4f1955986dd9b634114f7501fdb1884267"
 }

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 = '50b15a02e5ef' as const;
-export const SPEC_HASH_FULL = '50b15a02e5efb3a03bd903551f31a4c74693891d2577816c34a030d09909e389' as const;
+export const SPEC_HASH = '7144c9a832d5' as const;
+export const SPEC_HASH_FULL = '7144c9a832d55cf9179e5825c6c8fa486bf7130c0d1022d1b721f175dcf99f6d' as const;

package/src/api/generated.ts

@@ -1675,7 +1675,7 @@ export interface paths {
         };
         /**
          * Read one analysis workflow’s generic lifecycle envelope
-         * @description The domain-agnostic projection a client polls: identity, registered type, activity-free lifecycle state, start and completion times, the opaque domain progress and result payloads (null until the domain adapter supplies them), a closed failure class on a failed workflow, and the capabilities the surface may offer — canStop from the generic layer, canContinue as the domain declares it. Org-scoped: a workflow in another workspace answers 404.
+         * @description The domain-agnostic projection a client polls: identity, registered type, activity-free lifecycle state, start and completion times, the opaque domain progress and result payloads (null until the domain adapter supplies them), a closed failure class on a failed workflow, the frozen typed outcome of the current execution epoch once it settles (null until then), and the capabilities the surface may offer — canStop from the generic layer, canContinue as the domain declares it. Org-scoped: a workflow in another workspace answers 404.
          */
         get: operations["getAnalysisWorkflow"];
         put?: never;
@@ -1706,6 +1706,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/analysis-workflows/{id}/settlement": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Deliver a settled analysis workflow’s outcome into its launching conversation now
+         * @description An ACCELERATOR, never required for correctness (control ADR-CTRL-540): every terminal transition records a settlement that the server delivers on its own — immediately after settling, and on the reconciler sweep. The app calls this when its poll sees the current execution epoch settle, so the settlement turn appears without waiting. Idempotent: a second call for the same epoch answers skipped or delivered and writes nothing new. Answers not_settled while the epoch is still moving. Org-scoped: a workflow in another workspace answers 404.
+         */
+        post: operations["deliverAnalysisWorkflowSettlement"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/company-md/tree": {
         parameters: {
             query?: never;
@@ -4200,6 +4220,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/internal-admin/quality/graders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Every grader version with its calibration and the severities it may gate */
+        get: operations["listQualityGraders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/internal-admin/quality/graders/{id}/label-queue": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** A judge's unlabeled samples with their case content; the judge's verdict is hidden */
+        get: operations["getQualityGraderLabelQueue"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/internal-admin/quality/graders/{id}/labels": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Label a judged sample, then recalibrate the judge; reveals the judge's verdict */
+        post: operations["submitQualityGraderLabel"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/comments": {
         parameters: {
             query?: never;
@@ -6915,6 +6986,7 @@ export interface components {
             completedAt: string | null;
             progress: unknown | null;
             result: unknown | null;
+            outcome: unknown | null;
             error?: string;
             capabilities: {
                 canStop: boolean;
@@ -6934,6 +7006,10 @@ export interface components {
             /** @constant */
             reason: "not_running";
         };
+        DeliverWorkflowSettlementResponse: {
+            /** @enum {string} */
+            result: "delivered" | "deferred" | "busy" | "skipped" | "not_settled";
+        };
         CompanyMdListResponse: {
             items: {
                 id: string;
@@ -13002,6 +13078,42 @@ export interface operations {
             };
         };
     };
+    deliverAnalysisWorkflowSettlement: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description What the delivery attempt did */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliverWorkflowSettlementResponse"];
+                };
+            };
+            /** @description The workflow id is not a uuid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No such workflow in this workspace */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getCompanyMdTree: {
         parameters: {
             query?: {
@@ -17743,6 +17855,133 @@ export interface operations {
             };
         };
     };
+    listQualityGraders: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Grader versions with confusion matrices by severity and failure kind */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not an internal admin, or missing internal.manage_quality */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getQualityGraderLabelQueue: {
+        parameters: {
+            query?: {
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Samples waiting for a label, newest run first, without verdicts */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not an internal admin, or missing internal.manage_quality */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No such judge */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    submitQualityGraderLabel: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** Format: uuid */
+                    runId: string;
+                    caseId: string;
+                    sample: number;
+                    humanPassed: boolean;
+                    humanFailureKind?: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description The label, the judge's verdict and the recomputed calibration */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not an internal admin, missing internal.manage_quality, or no CSRF token */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No such judge, or the judge graded no such sample */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The sample is already labeled, or the judge gave no valid verdict */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     listCommentThreads: {
         parameters: {
             query: {

package/src/generated/openapi-routes.ts

@@ -10,6 +10,7 @@ export const openApiRoutes = {
   '/api/account/sessions': ['GET'],
   '/api/account/sessions/{sessionId}': ['DELETE'],
   '/api/analysis-workflows/{id}': ['GET'],
+  '/api/analysis-workflows/{id}/settlement': ['POST'],
   '/api/analysis-workflows/{id}/stop': ['POST'],
   '/api/auth/consent/grant': ['POST'],
   '/api/billing/price-list': ['GET'],
@@ -111,6 +112,9 @@ export const openApiRoutes = {
   '/api/internal-admin/quality/changes/manual': ['POST'],
   '/api/internal-admin/quality/escalations': ['GET'],
   '/api/internal-admin/quality/escalations/{id}/resolve': ['POST'],
+  '/api/internal-admin/quality/graders': ['GET'],
+  '/api/internal-admin/quality/graders/{id}/label-queue': ['GET'],
+  '/api/internal-admin/quality/graders/{id}/labels': ['POST'],
   '/api/internal-admin/quality/plans/{planId}/status': ['GET'],
   '/api/internal-admin/quality/references/floor': ['PUT'],
   '/api/internal-admin/quality/spend': ['GET'],