@company-semantics/contracts 27.9.0 → 27.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "27.9.0",
+  "version": "27.11.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 = '3974d23a4348' as const;
-export const SPEC_HASH_FULL = '3974d23a434834c5a1f81d93ef082b993014143e7b95e97dd775293045809af8' as const;
+export const SPEC_HASH = '82dd95d10a7a' as const;
+export const SPEC_HASH_FULL = '82dd95d10a7ab91ce536889a823b6fb149634142227bedc4a68e012e1a48256d' as const;

package/src/api/generated.ts

@@ -1542,6 +1542,40 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/company-md/context-bank/{contextDocId}/attachments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List parent docs a context doc is attached to, with per-parent detach capability */
+        get: operations["getCompanyMdContextDocAttachments"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/company-md/context-bank/{contextDocId}/detach": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Detach a context doc from parent docs; deletes the doc when orphaned */
+        post: operations["detachCompanyMdContextDoc"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/company-md/docs/{id}/context-bank/{contextDocId}/order": {
         parameters: {
             query?: never;
@@ -3942,6 +3976,7 @@ export interface components {
                 title: string;
             })[];
             reason: string | null;
+            /** Format: uuid */
             idempotencyKey: string;
         };
         SubmitInteractiveTaskResponse: {
@@ -4557,6 +4592,9 @@ export interface components {
         AssociateContextDocRequest: {
             contextDocId: string;
         };
+        DetachContextDocRequest: {
+            parentDocIds: string[];
+        };
         TransferCompanyMdDocOwnerRequest: {
             /** Format: uuid */
             newOwnerUserId: string;
@@ -5589,6 +5627,8 @@ export interface components {
         VisibilityPatchRequest: {
             /** @enum {string} */
             tier: "private" | "unit" | "org";
+            /** @enum {string} */
+            role?: "editor" | "commenter" | "viewer";
         };
         OwnerTransferRequest: {
             /** Format: uuid */
@@ -8191,6 +8231,50 @@ export interface operations {
             };
         };
     };
+    getCompanyMdContextDocAttachments: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                contextDocId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Attachments with canDetach flags */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    detachCompanyMdContextDoc: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                contextDocId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DetachContextDocRequest"];
+            };
+        };
+        responses: {
+            /** @description Associations removed; deleted=true when the doc was orphaned */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     reorderCompanyMdContextBankItem: {
         parameters: {
             query?: never;

package/src/generated/openapi-routes.ts

@@ -25,6 +25,8 @@ export const openApiRoutes = {
   '/api/company-md/access-requests/{id}/deny': ['POST'],
   '/api/company-md/context-bank': ['POST'],
   '/api/company-md/context-bank/search': ['GET'],
+  '/api/company-md/context-bank/{contextDocId}/attachments': ['GET'],
+  '/api/company-md/context-bank/{contextDocId}/detach': ['POST'],
   '/api/company-md/docs/:id/context-bank/suggestions': ['GET'],
   '/api/company-md/docs/{id}': ['GET'],
   '/api/company-md/docs/{id}/access-requests': ['GET', 'POST'],

package/src/permissions/share-api.ts

@@ -66,7 +66,7 @@ export const AclListResponseSchema = z.object({
   visibility: EntityVisibilitySchema,
   /**
    * The ROLE the general-access scope grants its audience: WHAT they may do (the
-   * capability axis, ADR-BE-375). Orthogonal to `visibility` — e.g. "Everyone in
+   * capability axis, ADR-BE-378). Orthogonal to `visibility` — e.g. "Everyone in
    * Product · Commenter". Defaults to `viewer` (the historical view-only band);
    * ignored when `visibility` is `private` (no general grant).
    */
@@ -80,7 +80,7 @@ export const VisibilityPatchRequestSchema = z.object({
   /** The general-access scope (WHO is eligible). */
   tier: EntityVisibilitySchema,
   /**
-   * The role granted to that scope (WHAT they may do, ADR-BE-375). Optional and
+   * The role granted to that scope (WHAT they may do, ADR-BE-378). Optional and
    * backward-compatible: omitted preserves the current role (or `viewer` on first
    * set); ignored when `tier` is `private`.
    */