@company-semantics/contracts 58.5.1 → 58.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "58.5.1",
+  "version": "58.6.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 = 'b4aa56c17639' as const;
-export const SPEC_HASH_FULL = 'b4aa56c1763945ca5c741250d51eafeff80cd2d48b5e0441918233b5f9a6a16b' as const;
+export const SPEC_HASH = 'dd2a725d7ebd' as const;
+export const SPEC_HASH_FULL = 'dd2a725d7ebd694db25efbe0e638077984af41551c1989fb374d9a7b8bc4eb3d' as const;

package/src/api/generated.ts

@@ -5065,7 +5065,7 @@ export interface components {
             summary: {
                 executionId: string;
                 /** @enum {string} */
-                kind: "integration.connect" | "integration.disconnect" | "profile.update" | "slack.send" | "data.ingest" | "data.scope" | "system.cleanup" | "member.changeManager" | "companyMd.ingest" | "companyMd.commentPass" | "semantic.transform" | "companyMd.importContextDoc";
+                kind: "integration.connect" | "integration.disconnect" | "integration.purge" | "profile.update" | "slack.send" | "data.ingest" | "data.scope" | "system.cleanup" | "member.changeManager" | "companyMd.ingest" | "companyMd.commentPass" | "semantic.transform" | "companyMd.importContextDoc";
                 target: {
                     /** @constant */
                     type: "slack";
@@ -9116,7 +9116,7 @@ export interface operations {
             query?: {
                 cursor?: string;
                 limit?: number;
-                kind?: "integration.connect" | "integration.disconnect" | "profile.update" | "slack.send" | "data.ingest" | "data.scope" | "system.cleanup" | "member.changeManager" | "companyMd.ingest" | "companyMd.commentPass" | "semantic.transform" | "companyMd.importContextDoc";
+                kind?: "integration.connect" | "integration.disconnect" | "integration.purge" | "profile.update" | "slack.send" | "data.ingest" | "data.scope" | "system.cleanup" | "member.changeManager" | "companyMd.ingest" | "companyMd.commentPass" | "semantic.transform" | "companyMd.importContextDoc";
                 targetType?: string;
                 periodStart?: string;
                 periodEnd?: string;
@@ -9251,7 +9251,7 @@ export interface operations {
             query?: {
                 limit?: number;
                 offset?: number;
-                kind?: "integration.connect" | "integration.disconnect" | "profile.update" | "slack.send" | "data.ingest" | "data.scope" | "system.cleanup" | "member.changeManager" | "companyMd.ingest" | "companyMd.commentPass" | "semantic.transform" | "companyMd.importContextDoc";
+                kind?: "integration.connect" | "integration.disconnect" | "integration.purge" | "profile.update" | "slack.send" | "data.ingest" | "data.scope" | "system.cleanup" | "member.changeManager" | "companyMd.ingest" | "companyMd.commentPass" | "semantic.transform" | "companyMd.importContextDoc";
                 kindPrefix?: string;
             };
             header?: never;

package/src/execution/__tests__/registry.test.ts

@@ -53,6 +53,27 @@ describe("EXECUTION_KINDS golden snapshot", () => {
           templateId: "integration.disconnect",
         },
       },
+      "integration.purge": {
+        kind: "integration.purge",
+        domain: "integration",
+        display: {
+          label: "Purge integration data",
+          pastTenseLabel: "Integration data purged",
+          icon: "unlink",
+        },
+        governance: {
+          visibility: "admin",
+          requiresAdmin: true,
+        },
+        ui: {
+          showInAdmin: true,
+          showInTimeline: true,
+          confirmBeforeRun: true,
+        },
+        explanation: {
+          templateId: "integration.purge",
+        },
+      },
       "profile.update": {
         kind: "profile.update",
         domain: "profile",

package/src/execution/kinds.ts

@@ -36,6 +36,10 @@
 export type ExecutionKind =
   | "integration.connect"
   | "integration.disconnect"
+  /** Break-glass HRIS purge: disconnect plus an irreversible unwind of all
+   *  facts still exclusively source-owned, tombstoning the connection as
+   *  `purged`. Only providers enrolled in RETAIN_ON_DISCONNECT qualify. */
+  | "integration.purge"
   | "profile.update"
   | "slack.send"
   | "data.ingest"

package/src/execution/registry.ts

@@ -76,6 +76,29 @@ export const EXECUTION_KINDS = {
       templateId: "integration.disconnect",
     },
   },
+  "integration.purge": {
+    kind: "integration.purge",
+    domain: "integration",
+    display: {
+      label: "Purge integration data",
+      pastTenseLabel: "Integration data purged",
+      icon: "unlink",
+    },
+    governance: {
+      visibility: "admin",
+      requiresAdmin: true,
+      // Irreversible by design: the unwind deletes source-owned facts and
+      // history, so no kind reverses this one (reversibleBy stays unset).
+    },
+    ui: {
+      showInAdmin: true,
+      showInTimeline: true,
+      confirmBeforeRun: true,
+    },
+    explanation: {
+      templateId: "integration.purge",
+    },
+  },
   "profile.update": {
     kind: "profile.update",
     domain: "profile",

package/src/integrations/README.md

@@ -36,6 +36,8 @@ alongside `Meetings`, `Comms`, and `Docs`.
 - `HrConnectInputSchema` — Input submitted by the app to initiate an HR provider connection.
 - `HrConnectionStatus` _(type)_
 - `HrConnectionStatusSchema` — Health of the most recent HR provider sync.
+- `HrisPurgeImpact` _(type)_
+- `HrisPurgeImpactSchema` — Impact of a break-glass HRIS purge (`integration.purge`), counted per entity.
 
 <!-- END GENERATED: readme-public-api -->
 

package/src/integrations/index.ts

@@ -3,6 +3,14 @@
  *
  * @see ./schemas.ts for the full schema definitions and invariants.
  */
-export { HrConnectionStatusSchema, HrConnectInputSchema } from "./schemas";
+export {
+  HrConnectionStatusSchema,
+  HrConnectInputSchema,
+  HrisPurgeImpactSchema,
+} from "./schemas";
 
-export type { HrConnectionStatus, HrConnectInput } from "./schemas";
+export type {
+  HrConnectionStatus,
+  HrConnectInput,
+  HrisPurgeImpact,
+} from "./schemas";

package/src/integrations/schemas.ts

@@ -146,3 +146,90 @@ export const HrConnectInputSchema = z
     description: "Input to initiate an HR provider connection.",
   });
 export type HrConnectInput = z.infer<typeof HrConnectInputSchema>;
+
+// =============================================================================
+// HRIS purge impact
+// =============================================================================
+
+/**
+ * Impact of a break-glass HRIS purge (`integration.purge`), counted per
+ * entity. One shape serves four readers: the purge-preview response, the
+ * execution result, the `integration.purged` fact details, and the
+ * `connection.purged` audit metadata. Preview and purge are built from the
+ * same predicate builders, so on an unchanged org the previewed counts and
+ * the executed counts are equal by construction.
+ */
+export const HrisPurgeImpactSchema = z
+  .object({
+    peopleUnlinked: z.number().int().min(0).meta({
+      description: "Provider identity links deleted (people unlinked).",
+    }),
+    personsRetained: z
+      .number()
+      .int()
+      .min(0)
+      .meta({
+        description:
+          "Persons left in the graph — always all of them; persons are " +
+          "never deleted by a purge, only unlinked from the provider.",
+      }),
+    unitsArchived: z.number().int().min(0).meta({
+      description: "Source-owned org units soft-archived.",
+    }),
+    unitsRetained: z.number().int().min(0).meta({
+      description:
+        "Provider-imported org units retained because a user claimed them.",
+    }),
+    positionsClosed: z.number().int().min(0).meta({
+      description: "Source-owned positions closed (never deleted).",
+    }),
+    positionsRetained: z.number().int().min(0).meta({
+      description:
+        "Provider-imported positions retained because a user claimed them.",
+    }),
+    occupanciesEnded: z.number().int().min(0).meta({
+      description: "Source-owned occupancies ended (employment history kept).",
+    }),
+    occupanciesRetained: z.number().int().min(0).meta({
+      description:
+        "Provider-imported occupancies retained because a user claimed them.",
+    }),
+    reportingEdgesRemoved: z.number().int().min(0).meta({
+      description: "Source-owned reporting edges deleted.",
+    }),
+    reportingEdgesRetained: z
+      .number()
+      .int()
+      .min(0)
+      .meta({
+        description:
+          "Provider-imported reporting edges retained because a user took " +
+          "ownership of them (user_override or human_confirmed authority).",
+      }),
+    syncRunsDeleted: z.number().int().min(0).meta({
+      description: "Sync-run history rows deleted.",
+    }),
+    conflictsDeleted: z.number().int().min(0).meta({
+      description: "Conflict-ledger rows deleted.",
+    }),
+    acknowledgementsDeleted: z.number().int().min(0).meta({
+      description: "Divergence acknowledgements deleted.",
+    }),
+    sourceUnitMappingsDeleted: z.number().int().min(0).meta({
+      description: "Source-unit mapping rows deleted.",
+    }),
+    authorityRowsDeleted: z
+      .number()
+      .int()
+      .min(0)
+      .meta({
+        description:
+          "source-authority rows deleted — only rows whose authority is the " +
+          "provider itself; human-confirmed and user-override rows are never " +
+          "touched.",
+      }),
+  })
+  .meta({
+    description: "Per-entity impact of a break-glass HRIS purge.",
+  });
+export type HrisPurgeImpact = z.infer<typeof HrisPurgeImpactSchema>;

package/src/message-parts/__tests__/confirmation.test.ts

@@ -114,6 +114,7 @@ describe("CONFIRMATION_LABELS", () => {
     expect(CONFIRMATION_LABELS).toStrictEqual({
       "integration.connect": "Connect Integration",
       "integration.disconnect": "Disconnect Integration",
+      "integration.purge": "Purge Integration Data",
       "profile.update": "Update Profile",
       "slack.send": "Send Slack Message",
       "data.ingest": "Import Channel",

package/src/message-parts/confirmation.ts

@@ -39,6 +39,7 @@ export type ConfirmationRiskLevel =
 export const CONFIRMATION_LABELS: Record<ExecutionKind, string> = {
   "integration.connect": "Connect Integration",
   "integration.disconnect": "Disconnect Integration",
+  "integration.purge": "Purge Integration Data",
   "profile.update": "Update Profile",
   "slack.send": "Send Slack Message",
   "data.ingest": "Import Channel",