@company-semantics/contracts 53.0.1 → 55.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "53.0.1",
+  "version": "55.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 = '691f7bd81d0c' as const;
-export const SPEC_HASH_FULL = '691f7bd81d0c34aebd47c457a170dd48443a3f9eb007312fa97af00d9a4ccf30' as const;
+export const SPEC_HASH = '6eb28e0d82f9' as const;
+export const SPEC_HASH_FULL = '6eb28e0d82f9d1d88e4fc954ece5377c85ddd6da30b6171c4d2aa75f347c09ed' as const;

package/src/api/generated.ts

@@ -4982,6 +4982,7 @@ export interface components {
                 type: "company" | "department" | "team" | "cross_team" | "doc" | "goal" | "source" | "map" | "context_bank";
                 canEdit: boolean;
                 memberCount: number;
+                openRoleCount: number;
                 description?: string;
                 orderKey?: string;
                 /** @enum {string} */

package/src/content/schemas.ts

@@ -58,6 +58,12 @@ const CompanyMdTreeNodeSchema = z.object({
   ]),
   canEdit: z.boolean(),
   memberCount: z.number().int(),
+  /**
+   * Active open roles (`open` + `hiring`) on this node's owning unit — the
+   * companion to `memberCount` in the "(N + M open)" split. DIRECT per-unit,
+   * not a subtree rollup, matching this projection's `memberCount` scope.
+   */
+  openRoleCount: z.number().int().min(0),
   description: z.string().optional(),
   /** Fractional-index key for ordered entity wrappers (unit/context). */
   orderKey: z.string().optional(),

package/src/integrations/schemas.ts

@@ -28,15 +28,31 @@ import { z } from "zod";
 export const HrConnectionStatusSchema = z
   .object({
     connected: z.boolean().meta({
-      description: "Whether an HR provider is currently connected.",
+      description:
+        "Whether an HR provider is currently connected AND usable. False " +
+        "whenever the integration cannot sync — read `credentialState` to " +
+        "tell a never-connected integration from one whose grant died.",
+    }),
+    credentialState: z.enum(["usable", "unusable", "absent"]).meta({
+      description:
+        "Why the integration is or is not working. 'usable' — a connection " +
+        "exists and its credential works (`connected` is true). 'unusable' " +
+        "— a connection exists but its credential cannot be used (expired " +
+        "or revoked grant); previously synced data remains, and the user " +
+        "must reconnect. 'absent' — no connection at all. Distinguishing " +
+        "'unusable' from 'absent' is the whole point: both leave " +
+        "`connected` false, but only one of them is the user's fault to fix " +
+        "by connecting for the first time.",
     }),
     connectionId: z
       .string()
       .nullable()
       .meta({
         description:
-          "Stable id of the active connection — the handle the app passes to " +
-          "`integration.disconnect`. Null when not connected.",
+          "Stable id of the connection row — the handle the app passes to " +
+          "`integration.disconnect`. Present whenever a connection exists, " +
+          "including when `credentialState` is 'unusable', so a dead " +
+          "integration can still be disconnected. Null only when 'absent'.",
       }),
     employeeCount: z.number().int().nonnegative().nullable().meta({
       description:

package/src/message-parts/preview.ts

@@ -42,8 +42,13 @@ export type IntegrationProvider = "slack" | "google" | "zoom";
  * - 'google_drive' → provider='google', service='drive'
  * - 'google_meet' → provider='google', service='meet'
  * - 'zoom' → provider='zoom', service=''
+ * - 'bamboohr' → provider='bamboohr', service=''
+ *
+ * This union is the single definition of the vocabulary; the backend's
+ * `providers/integration-key.ts` must mirror it exactly.
  */
-export type IntegrationKey = "slack" | "google_drive" | "google_meet" | "zoom";
+export type IntegrationKey =
+  "slack" | "google_drive" | "google_meet" | "zoom" | "bamboohr";
 
 /**
  * Content structure for integration artifacts.

package/src/org/company-md.ts

@@ -168,6 +168,14 @@ export interface CompanyMdTreeNode extends CompanyMdNodeIdentity {
   readonly type: CompanyMdNodeType;
   readonly canEdit: boolean;
   readonly memberCount: number;
+  /**
+   * Active open roles (`open` + `hiring`) on this node's owning unit, the
+   * companion to `memberCount` in the "(N + M open)" people-count split.
+   * Unlike `OrgUnitTreeNode.openRoleCount` this is a DIRECT per-unit count,
+   * not a subtree rollup — it is paired with this projection's `memberCount`,
+   * which is itself direct, so the two halves of one badge share a scope.
+   */
+  readonly openRoleCount: number;
   readonly description?: string;
   /**
    * Fractional-index key for stable ordering. Present on ordered entity