@company-semantics/contracts 90.0.0 → 91.1.0

package/src/affordances/index.ts

@@ -0,0 +1,39 @@
+/**
+ * Affordance vocabulary barrel (control ADR affordance-system).
+ * Import from '@company-semantics/contracts' (root).
+ */
+export { AFFORDANCE_IDS, AffordanceIdSchema } from "./ids";
+export type { AffordanceId } from "./ids";
+export {
+  AFFORDANCE_ARGS,
+  NO_ARG_AFFORDANCE_IDS,
+  ReviewOpenArgsSchema,
+} from "./args";
+export type { AffordanceArgs } from "./args";
+export {
+  AFFORDANCE_AVAILABILITY_IDS,
+  AFFORDANCE_BINDING_KINDS,
+  AFFORDANCE_UNAVAILABLE_REASONS,
+  AffordanceAvailabilityIdSchema,
+  AffordanceAvailabilitySchema,
+} from "./availability";
+export type {
+  AffordanceAvailability,
+  AffordanceAvailabilityId,
+  AffordanceBindingKind,
+  AffordanceUnavailableReason,
+} from "./availability";
+export {
+  AFFORDANCE_AVAILABILITY_OF,
+  AFFORDANCE_BINDING_KIND_OF,
+  AffordanceSchema,
+  MAX_OFFERED_AFFORDANCES,
+  OfferedAffordanceSchema,
+  PROJECTED_AFFORDANCE_IDS,
+  sameAffordances,
+} from "./affordance";
+export type {
+  Affordance,
+  OfferedAffordance,
+  ProjectedAffordanceId,
+} from "./affordance";

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 = 'ba43b4881a93' as const;
-export const SPEC_HASH_FULL = 'ba43b4881a9318819726dfe0c0465ecae3802951f7f558fec6786a7171195a91' as const;
+export const SPEC_HASH = '2d074ecfa53c' as const;
+export const SPEC_HASH_FULL = '2d074ecfa53c0f377dfda06d9a46167a9cfc77eb3878e2cd71b8a04149c700b7' as const;

package/src/api/generated.ts

@@ -1566,6 +1566,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/integrations/bamboohr/sync": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Run a BambooHR sync now (returns the run summary) */
+        post: operations["syncBambooHrNow"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/org/reconciliation": {
         parameters: {
             query?: never;
@@ -1666,6 +1683,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/org/structure-inference/runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Launch one org-structure reanalyze workflow and its inference run
+         * @description Mints an org-structure/reanalyze analysis workflow, opens its pending run and schedules the job, all in one transaction (ADR-BE-606, ADR-BE-703): the snapshot, the model calls and the deterministic gate execute on the worker, and the outcome is read back by polling GET /api/org/structure-inference/proposal, whose run field carries this run’s id and status, or GET /api/analysis-workflows/{workflowId} for the workflow. At most one inference is in flight per org — a second POST joins the run already under way. Explicitly operator-triggered: there is no schedule and no sync hook.
+         */
+        post: operations["runOrgStructureInference"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/analysis-workflows/{id}": {
         parameters: {
             query?: never;
@@ -1726,6 +1763,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/affordances/state": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the live policy and availability of offered affordances
+         * @description For exactly the affordance ids named in `ids` (the ids a settled outcome offered — never the catalog), whether the viewer is shown each one (`policy`, from the same capability derivation as GET /api/capabilities) and whether the org’s current state permits it (`availability`). Entries come back in request order, deduped. NON-AUTHORITATIVE: this answer is advisory UX state; the route each affordance binds to stays the only enforcement and may still refuse. Org-scoped: requires active membership of the session org, because availability discloses org state.
+         */
+        get: operations["getAffordanceState"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/company-md/tree": {
         parameters: {
             query?: never;
@@ -4271,6 +4328,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/internal-admin/quality/decisions/{id}/diagnosis": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** A decision's diagnosis: stable vs flaky failures, failure kinds by bucket, suspected component and findings */
+        get: operations["getQualityDecisionDiagnosis"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/comments": {
         parameters: {
             query?: never;
@@ -6791,6 +6865,34 @@ export interface components {
                         requiredScope?: string;
                     };
                 };
+                integrations?: {
+                    manage: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
+                sourceSync?: {
+                    manage: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
+                billing?: {
+                    view: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
+                orgStructure?: {
+                    analyze: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
             };
             chatMentions: boolean;
             chatMultiParty: boolean;
@@ -6799,6 +6901,17 @@ export interface components {
                 reason: ("BILLING_INACTIVE" | "SEAT_SUBSCRIPTION_PAST_DUE" | "AI_BALANCE_EXHAUSTED" | "AI_BUDGET_EXHAUSTED" | "BYO_KEY_INVALID") | null;
             };
         };
+        BambooHrSyncRunResponse: {
+            /** Format: uuid */
+            runId: string;
+            processed: number;
+            changed: number;
+            skipped: number;
+            conflicts: number;
+            failures: number;
+            sinceCursor: string | null;
+            status: string;
+        };
         ResolveOrgDivergenceRequest: {
             /** @constant */
             resolution: "acknowledged";
@@ -6976,6 +7089,23 @@ export interface components {
             fingerprint: string;
             note?: string;
         };
+        RunStructureInferenceRefusal: {
+            /** @constant */
+            ran: false;
+            /** @enum {string} */
+            reason: "no_sync_run" | "no_persons" | "reporting_not_keyed";
+            message: string;
+        };
+        RunStructureInferenceAccepted: {
+            /** @constant */
+            ran: true;
+            /** Format: uuid */
+            runId: string;
+            workflowId: string | null;
+            /** @enum {string} */
+            status: "pending" | "running";
+            alreadyRunning: boolean;
+        };
         AnalysisWorkflowProjectionResponse: {
             /** Format: uuid */
             id: string;
@@ -6986,7 +7116,180 @@ export interface components {
             completedAt: string | null;
             progress: unknown | null;
             result: unknown | null;
-            outcome: unknown | null;
+            outcome: ({
+                /** @constant */
+                workflowType: "source-sync/discover";
+                executionEpoch: number;
+                /** @enum {string} */
+                kind: "produced" | "empty" | "partial" | "stopped" | "failed" | "abandoned" | "unknown";
+                /** @enum {string} */
+                reason: "candidates_found" | "nothing_found" | "nothing_relevant" | "budget_exhausted" | "file_ceiling" | "stopped_by_user" | "plan_coverage_refused" | "billing_refused" | "drive_auth" | "drive_unavailable" | "no_connection" | "source_sync_off" | "internal_error" | "abandoned" | "unrecognized_terminal_state";
+                facts: {
+                    probesTotal: number;
+                    probesDone: number;
+                    filesSeen: number;
+                    filesShown: number;
+                    filesHidden: number;
+                    filesDropped: number;
+                    coveragePercent: number | null;
+                } | null;
+                disposition: {
+                    /** @constant */
+                    kind: "review";
+                    /** @enum {string} */
+                    requestType: "org-structure/review" | "source-sync/candidates" | "source-sync/synthesis";
+                    requestId: string;
+                } | {
+                    /** @constant */
+                    kind: "narrate";
+                };
+                affordances: ({
+                    /** @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 */
+                workflowType: "source-sync/synthesize";
+                executionEpoch: number;
+                /** @enum {string} */
+                kind: "produced" | "empty" | "partial" | "stopped" | "failed" | "abandoned" | "unknown";
+                /** @enum {string} */
+                reason: "updates_ready" | "updates_applied" | "stopped_by_user" | "paused_billing" | "synthesis_incomplete" | "approval_mismatch" | "landing_refused" | "standing_order_refused" | "no_connection" | "source_sync_off" | "internal_error" | "abandoned" | "unrecognized_terminal_state";
+                facts: {
+                    scopeCount: number;
+                    violationCount: number;
+                } | null;
+                disposition: {
+                    /** @constant */
+                    kind: "review";
+                    /** @enum {string} */
+                    requestType: "org-structure/review" | "source-sync/candidates" | "source-sync/synthesis";
+                    requestId: string;
+                } | {
+                    /** @constant */
+                    kind: "narrate";
+                };
+                affordances: ({
+                    /** @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 */
+                workflowType: "org-structure/hris-connect";
+                executionEpoch: number;
+                /** @enum {string} */
+                kind: "produced" | "empty" | "partial" | "stopped" | "failed" | "abandoned" | "unknown";
+                /** @enum {string} */
+                reason: "proposal_ready" | "directory_synced" | "analysis_already_running" | "proposal_blocked" | "no_sync_run" | "no_persons" | "reporting_not_keyed" | "stopped_by_user" | "sync_failed" | "snapshot_too_large" | "model_failed" | "run_too_large" | "placement_failed" | "internal_error" | "abandoned" | "unrecognized_terminal_state";
+                facts: {
+                    departmentCount: number;
+                    teamCount: number;
+                    placedCount: number;
+                    reviewItemCount: number;
+                } | null;
+                disposition: {
+                    /** @constant */
+                    kind: "review";
+                    /** @enum {string} */
+                    requestType: "org-structure/review" | "source-sync/candidates" | "source-sync/synthesis";
+                    requestId: string;
+                } | {
+                    /** @constant */
+                    kind: "narrate";
+                };
+                affordances: ({
+                    /** @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 */
+                workflowType: "org-structure/reanalyze";
+                executionEpoch: number;
+                /** @enum {string} */
+                kind: "produced" | "empty" | "partial" | "stopped" | "failed" | "abandoned" | "unknown";
+                /** @enum {string} */
+                reason: "proposal_ready" | "directory_synced" | "analysis_already_running" | "proposal_blocked" | "no_sync_run" | "no_persons" | "reporting_not_keyed" | "stopped_by_user" | "sync_failed" | "snapshot_too_large" | "model_failed" | "run_too_large" | "placement_failed" | "internal_error" | "abandoned" | "unrecognized_terminal_state";
+                facts: {
+                    departmentCount: number;
+                    teamCount: number;
+                    placedCount: number;
+                    reviewItemCount: number;
+                } | null;
+                disposition: {
+                    /** @constant */
+                    kind: "review";
+                    /** @enum {string} */
+                    requestType: "org-structure/review" | "source-sync/candidates" | "source-sync/synthesis";
+                    requestId: string;
+                } | {
+                    /** @constant */
+                    kind: "narrate";
+                };
+                affordances: ({
+                    /** @constant */
+                    id: "sourceSync.findFiles";
+                } | {
+                    /** @constant */
+                    id: "integrations.connectGoogleDrive";
+                } | {
+                    /** @constant */
+                    id: "sourceSync.enable";
+                } | {
+                    /** @constant */
+                    id: "billing.open";
+                } | {
+                    /** @constant */
+                    id: "orgStructure.reanalyze";
+                } | {
+                    /** @constant */
+                    id: "hris.resyncDirectory";
+                })[];
+            }) | null;
             error?: string;
             capabilities: {
                 canStop: boolean;
@@ -7010,6 +7313,26 @@ export interface components {
             /** @enum {string} */
             result: "delivered" | "deferred" | "busy" | "skipped" | "not_settled";
         };
+        AffordanceStateResponse: {
+            entries: {
+                /** @enum {string} */
+                id: "sourceSync.findFiles" | "integrations.connectGoogleDrive" | "sourceSync.enable" | "billing.open" | "orgStructure.reanalyze" | "hris.resyncDirectory" | "review.open";
+                /** @enum {string} */
+                policy: "allowed" | "blocked";
+                availability: {
+                    /** @constant */
+                    state: "available";
+                } | {
+                    /** @constant */
+                    state: "already_satisfied";
+                } | {
+                    /** @constant */
+                    state: "unavailable";
+                    /** @enum {string} */
+                    reason: "conflicting_operation" | "missing_dependency" | "resource_gone" | "temporarily_disabled";
+                };
+            }[];
+        };
         CompanyMdListResponse: {
             items: {
                 id: string;
@@ -8122,7 +8445,7 @@ export interface components {
                 notification: {
                     id: string;
                     /** @enum {string} */
-                    kind: "companyMd.access_requested" | "companyMd.access_request_approved" | "companyMd.access_request_denied" | "comment.mention" | "comment.reply" | "chat.mention" | "proactive.org_became_shared" | "proactive.brief_morning" | "proactive.billing_balance_below_half" | "proactive.billing_balance_below_threshold" | "proactive.billing_auto_recharge_succeeded" | "proactive.billing_top_up_credited" | "proactive.billing_monthly_budget_80" | "proactive.billing_monthly_budget_100" | "proactive.billing_user_monthly_limit_reached" | "proactive.billing_byo_key_invalid" | "proactive.billing_provider_price_changed" | "proactive.billing_payment_recovered" | "proactive.billing_balance_exhausted" | "proactive.billing_auto_recharge_failed" | "proactive.billing_payment_past_due" | "proactive.billing_suspended" | "proactive.billing_subscription_canceled" | "proactive.source_sync_docs_updated" | "proactive.source_sync_review_ready" | "proactive.org_structure_review_ready";
+                    kind: "companyMd.access_requested" | "companyMd.access_request_approved" | "companyMd.access_request_denied" | "comment.mention" | "comment.reply" | "chat.mention" | "proactive.org_became_shared" | "proactive.brief_morning" | "proactive.billing_balance_below_half" | "proactive.billing_balance_below_threshold" | "proactive.billing_auto_recharge_succeeded" | "proactive.billing_top_up_credited" | "proactive.billing_monthly_budget_80" | "proactive.billing_monthly_budget_100" | "proactive.billing_user_monthly_limit_reached" | "proactive.billing_byo_key_invalid" | "proactive.billing_provider_price_changed" | "proactive.billing_payment_recovered" | "proactive.billing_balance_exhausted" | "proactive.billing_auto_recharge_failed" | "proactive.billing_payment_past_due" | "proactive.billing_suspended" | "proactive.billing_subscription_canceled" | "proactive.source_sync_docs_updated" | "proactive.source_sync_review_ready" | "proactive.org_structure_review_ready" | "proactive.workflow_needs_attention" | "proactive.workflow_finished";
                     target: {
                         /** @enum {string} */
                         type: "company_md" | "org_unit" | "org" | "execution";
@@ -12932,6 +13255,33 @@ export interface operations {
             };
         };
     };
+    syncBambooHrNow: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sync run summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BambooHrSyncRunResponse"];
+                };
+            };
+            /** @description No active BambooHR connection, or BambooHR no longer recognizes the organization */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getOrgReconciliation: {
         parameters: {
             query?: never;
@@ -13079,6 +13429,35 @@ export interface operations {
             };
         };
     };
+    runOrgStructureInference: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A named refusal with its operator-facing next step: no directory imported yet, a sync that imported nobody, or a credential whose sync could not key reporting edges (reporting_not_keyed) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RunStructureInferenceRefusal"];
+                };
+            };
+            /** @description A run is under way — freshly launched, or already in flight (alreadyRunning: true). Carries the runId the poll surface matches against and the workflowId of the org-structure/reanalyze workflow it executes (null only when the joined run predates the workflow launch) */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RunStructureInferenceAccepted"];
+                };
+            };
+        };
+    };
     getAnalysisWorkflow: {
         parameters: {
             query?: never;
@@ -13196,6 +13575,42 @@ export interface operations {
             };
         };
     };
+    getAffordanceState: {
+        parameters: {
+            query: {
+                ids: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Policy and availability per requested affordance id, in request order */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AffordanceStateResponse"];
+                };
+            };
+            /** @description An id is not a known affordance, the list is empty, or it is too long */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The viewer is not an active member of the session org */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getCompanyMdTree: {
         parameters: {
             query?: {
@@ -18064,6 +18479,47 @@ export interface operations {
             };
         };
     };
+    getQualityDecisionDiagnosis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The decision, whether its diagnosis is stored, pending or not applicable, and the report once stored */
+            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 decision */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     listCommentThreads: {
         parameters: {
             query: {

package/src/generated/openapi-routes.ts

@@ -9,6 +9,7 @@ export const openApiRoutes = {
   '/api/account/deletion-eligibility': ['GET'],
   '/api/account/sessions': ['GET'],
   '/api/account/sessions/{sessionId}': ['DELETE'],
+  '/api/affordances/state': ['GET'],
   '/api/analysis-workflows/{id}': ['GET'],
   '/api/analysis-workflows/{id}/settlement': ['POST'],
   '/api/analysis-workflows/{id}/stop': ['POST'],
@@ -101,6 +102,7 @@ export const openApiRoutes = {
   '/api/factory/quality/plans/{planId}/decision': ['GET'],
   '/api/factory/snapshot': ['GET'],
   '/api/ingestion/operations/{id}': ['GET'],
+  '/api/integrations/bamboohr/sync': ['POST'],
   '/api/internal-admin/impersonate/end': ['POST'],
   '/api/internal-admin/impersonate/session': ['GET'],
   '/api/internal-admin/impersonate/start': ['POST'],
@@ -110,6 +112,7 @@ export const openApiRoutes = {
   '/api/internal-admin/quality/candidates/{id}/accept': ['POST'],
   '/api/internal-admin/quality/candidates/{id}/reject': ['POST'],
   '/api/internal-admin/quality/changes/manual': ['POST'],
+  '/api/internal-admin/quality/decisions/{id}/diagnosis': ['GET'],
   '/api/internal-admin/quality/escalations': ['GET'],
   '/api/internal-admin/quality/escalations/{id}/resolve': ['POST'],
   '/api/internal-admin/quality/graders': ['GET'],
@@ -180,6 +183,7 @@ export const openApiRoutes = {
   '/api/org/structure-findings': ['GET'],
   '/api/org/structure-findings/{findingId}/dismiss': ['POST'],
   '/api/org/structure-findings/{findingId}/reopen': ['POST'],
+  '/api/org/structure-inference/runs': ['POST'],
   '/api/org/system-events': ['GET'],
   '/api/org/system-events/{id}/acknowledge': ['POST'],
   '/api/org/transfer-eligibility': ['GET'],