@company-semantics/contracts 27.10.0 → 27.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "27.10.0",
+  "version": "27.12.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 = '3959df952d48' as const;
-export const SPEC_HASH_FULL = '3959df952d4880e34660edefd2cf9cab597ed8ac54ce74bc60bcb16dc6c18652' as const;
+export const SPEC_HASH = '43cd15935d12' as const;
+export const SPEC_HASH_FULL = '43cd15935d1232049463ee9ed6c4e833b6e012906cfc46644157aaaa310b895b' 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;
@@ -4511,6 +4545,7 @@ export interface components {
                 name: string;
             } | null;
             canEdit: boolean;
+            canUploadContext?: boolean;
             inheritsFromId: string | null;
             inheritsFrom: string | null;
             sources: {
@@ -4558,6 +4593,9 @@ export interface components {
         AssociateContextDocRequest: {
             contextDocId: string;
         };
+        DetachContextDocRequest: {
+            parentDocIds: string[];
+        };
         TransferCompanyMdDocOwnerRequest: {
             /** Format: uuid */
             newOwnerUserId: string;
@@ -8194,6 +8232,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/content/schemas.ts

@@ -126,6 +126,15 @@ export const CompanyMdDocResponseSchema = z.object({
   owningUnitId: z.string().nullable(),
   owner: CompanyMdPersonSchema.nullable(),
   canEdit: z.boolean(),
+  /**
+   * UI capability signal (ADR-BE-382): whether the requesting actor holds
+   * `CompanyMd.CanUploadContext` on this doc — the SAME binding every
+   * context-bank mutation (upload/attach/remove/reorder/detach) enforces.
+   * The app hides bank-mutation affordances when false. Signal only;
+   * admittance and enforcement are unchanged. Optional for back-compat with
+   * doc shapes returned outside the single-doc read.
+   */
+  canUploadContext: z.boolean().optional(),
   // Stable id of the inherited-from doc — the resolution key (mirrors the
   // resolved parentId). `inheritsFrom` is presentation only (ADR-BE-315).
   inheritsFromId: z.string().nullable(),

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'],