@company-semantics/contracts 27.7.0 → 27.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "27.7.0",
+  "version": "27.8.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 = '628fe99ff916' as const;
-export const SPEC_HASH_FULL = '628fe99ff9166b9eb6c0b2bab2794f4e730ceabff0785b7b54b8015897e9551d' as const;
+export const SPEC_HASH = '1c5dcd23d461' as const;
+export const SPEC_HASH_FULL = '1c5dcd23d46109024a008dea6440892f9a1ccd0b725fc6e0ed0bb3abe28bf78d' as const;

package/src/api/generated.ts

@@ -3962,6 +3962,12 @@ export interface components {
             /** Format: uuid */
             positionId: string;
             title: string;
+        } | {
+            /** @constant */
+            kind: "reporting.setManagerBulk";
+            reportPositionIds: string[];
+            /** Format: uuid */
+            managerPositionId: string;
         };
         MoveApplyRequest: {
             mutations: ({

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

@@ -62,6 +62,24 @@ describe("EMAIL_KINDS golden snapshot", () => {
         plainTextRequired: true,
         htmlSupported: true,
       },
+      "companyMd.access_requested": {
+        kind: "companyMd.access_requested",
+        subject: "Someone requested access to a document",
+        plainTextRequired: true,
+        htmlSupported: true,
+      },
+      "companyMd.access_request_approved": {
+        kind: "companyMd.access_request_approved",
+        subject: "Your access request was approved",
+        plainTextRequired: true,
+        htmlSupported: true,
+      },
+      "companyMd.access_request_denied": {
+        kind: "companyMd.access_request_denied",
+        subject: "Your access request was reviewed",
+        plainTextRequired: true,
+        htmlSupported: true,
+      },
     });
   });
 });

package/src/org/__tests__/transformation.test.ts

@@ -106,6 +106,55 @@ describe("OrgIntentSchema", () => {
       }).success,
     ).toBe(false);
   });
+
+  it("accepts a reporting.setManagerBulk intent (N seats -> one manager)", () => {
+    const intent = {
+      kind: "reporting.setManagerBulk" as const,
+      reportPositionIds: [REPORT, POSITION],
+      managerPositionId: MANAGER,
+    };
+    expect(OrgIntentSchema.parse(intent)).toEqual(intent);
+  });
+
+  it("rejects an empty bulk reportPositionIds array", () => {
+    expect(
+      OrgIntentSchema.safeParse({
+        kind: "reporting.setManagerBulk",
+        reportPositionIds: [],
+        managerPositionId: MANAGER,
+      }).success,
+    ).toBe(false);
+  });
+
+  it("rejects a bulk array beyond the 500-seat transport cap", () => {
+    expect(
+      OrgIntentSchema.safeParse({
+        kind: "reporting.setManagerBulk",
+        reportPositionIds: Array.from({ length: 501 }, () => REPORT),
+        managerPositionId: MANAGER,
+      }).success,
+    ).toBe(false);
+  });
+
+  it("rejects a non-uuid entry in the bulk report set", () => {
+    expect(
+      OrgIntentSchema.safeParse({
+        kind: "reporting.setManagerBulk",
+        reportPositionIds: [REPORT, "x"],
+        managerPositionId: MANAGER,
+      }).success,
+    ).toBe(false);
+  });
+
+  it("rejects a null bulk managerPositionId (intents always set a manager)", () => {
+    expect(
+      OrgIntentSchema.safeParse({
+        kind: "reporting.setManagerBulk",
+        reportPositionIds: [REPORT],
+        managerPositionId: null,
+      }).success,
+    ).toBe(false);
+  });
 });
 
 describe("FactMutationSchema", () => {
@@ -436,4 +485,23 @@ describe("TransformationPreviewSchema", () => {
       false,
     );
   });
+
+  it("accepts a multi-headline preview carrying primaryMutations (bulk intent)", () => {
+    const second = { ...setManagerMutation, reportPositionId: POSITION };
+    expect(
+      TransformationPreviewSchema.safeParse({
+        ...preview,
+        primaryMutations: [setManagerMutation, second],
+      }).success,
+    ).toBe(true);
+  });
+
+  it("rejects a single-element primaryMutations (single moves omit the field)", () => {
+    expect(
+      TransformationPreviewSchema.safeParse({
+        ...preview,
+        primaryMutations: [setManagerMutation],
+      }).success,
+    ).toBe(false);
+  });
 });

package/src/org/transformation.ts

@@ -95,6 +95,25 @@ export const OrgIntentSchema = z.discriminatedUnion("kind", [
     /** The new human-facing title for the seat (non-empty, matching PositionSchema.title). */
     title: z.string().min(1),
   }),
+  // reporting.setManagerBulk — N reporting seats re-pointed at ONE manager as a
+  // single atomic intent (the org-chart cluster-pill drop). The engine expands
+  // it into N `reporting.setManager` FactMutations — the existing
+  // Intent-vs-Mutation asymmetry; no bulk mutation kind exists or is needed.
+  // Cross-field rules (manager ∉ reports, dedupe) are enforced at the route: a
+  // discriminatedUnion member cannot carry a ZodEffects refinement.
+  z.object({
+    kind: z.literal("reporting.setManagerBulk"),
+    /**
+     * The reporting seats being re-pointed together (e.g. a unit cluster's
+     * direct members; their subtrees follow implicitly). Order-insensitive;
+     * the engine treats the set as one atomic intent. The cap mirrors the
+     * bulk-reparent transport bound (ADR-BE-318).
+     */
+    reportPositionIds: z.array(z.string().uuid()).min(1).max(500),
+    /** The ONE manager seat every report re-points to. Non-null on an intent
+     * (un-setting is a mutation concern, exactly as on `reporting.setManager`). */
+    managerPositionId: z.string().uuid(),
+  }),
 ]);
 export type OrgIntent = z.infer<typeof OrgIntentSchema>;
 
@@ -336,6 +355,15 @@ export const TransformationPreviewSchema = z.object({
   intentLabel: z.string().min(1),
   /** The headline fact change the preview is centered on. */
   primary: FactMutationSchema,
+  /**
+   * Present only when the intent expands into MORE THAN ONE headline mutation
+   * (e.g. `reporting.setManagerBulk`): the full primary bundle, of which
+   * `primary` is the first element. Absent on single-mutation previews so
+   * existing consumers and goldens see byte-identical output. These are the
+   * INTENT's own edges — engine repair splices stay in the strategies'
+   * recommendations, never here.
+   */
+  primaryMutations: z.array(FactMutationSchema).min(2).optional(),
   /** The strategy the engine recommends by default. */
   defaultStrategy: TransformStrategySchema,
   /** Other viable strategies the operator may pick instead. */