@company-semantics/contracts 20.1.0 → 20.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "20.1.0",
+  "version": "20.2.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 = '79972d6725ff' as const;
-export const SPEC_HASH_FULL = '79972d6725ff3dfd29ee68945c8006039eddc196eadaeb0bcd77abeeebf2b066' as const;
+export const SPEC_HASH = '325ec2565e49' as const;
+export const SPEC_HASH_FULL = '325ec2565e49e75abbf3b93a918e328dbe47a74586212e390cd0dff381a9913f' as const;

package/src/api/generated.ts

@@ -4147,6 +4147,7 @@ export interface components {
                 name: string;
             } | null;
             canEdit: boolean;
+            inheritsFromId: string | null;
             inheritsFrom: string | null;
             sources: {
                 label: string;
@@ -4155,6 +4156,7 @@ export interface components {
                 referencedAt: string;
             }[];
             dependencies: {
+                targetId: string;
                 targetSlug: string;
                 description: string;
             }[];

package/src/content/schemas.ts

@@ -28,6 +28,9 @@ const CompanyMdSourceSchema = z.object({
 });
 
 const CompanyMdDependencySchema = z.object({
+  // Stable id of the target doc — the resolution key (ADR-BE-315). `targetSlug`
+  // is presentation only; slugs are only parent-scoped unique post-ADR-BE-315.
+  targetId: z.string(),
   targetSlug: z.string(),
   description: z.string(),
 });
@@ -85,6 +88,9 @@ export const CompanyMdDocResponseSchema = z.object({
   owningUnitId: z.string().nullable(),
   owner: CompanyMdPersonSchema.nullable(),
   canEdit: z.boolean(),
+  // 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(),
   inheritsFrom: z.string().nullable(),
   sources: z.array(CompanyMdSourceSchema),
   dependencies: z.array(CompanyMdDependencySchema),

package/src/generated/openapi-routes.ts

@@ -22,20 +22,20 @@ export const openApiRoutes = {
   '/api/chats/{id}/messages/{messageId}': ['DELETE'],
   '/api/chats/{id}/pin': ['DELETE', 'POST'],
   '/api/company-md/context-bank': ['POST'],
-  '/api/company-md/docs/{parentSlug}/context-bank/upload': ['POST'],
-  '/api/company-md/docs/{slug}': ['GET'],
-  '/api/company-md/docs/{slug}/content': ['PUT'],
-  '/api/company-md/docs/{slug}/context-bank': ['GET'],
-  '/api/company-md/docs/{slug}/context-bank/associate': ['POST'],
-  '/api/company-md/docs/{slug}/context-bank/retry': ['POST'],
-  '/api/company-md/docs/{slug}/context-bank/{contextDocSlug}': ['DELETE'],
-  '/api/company-md/docs/{slug}/context-bank/{id}/order': ['PATCH'],
-  '/api/company-md/docs/{slug}/sharing': ['GET'],
-  '/api/company-md/docs/{slug}/sharing/acl': ['POST'],
-  '/api/company-md/docs/{slug}/sharing/acl/{aclId}': ['DELETE', 'PUT'],
-  '/api/company-md/docs/{slug}/sharing/policy': ['PUT'],
-  '/api/company-md/docs/{slug}/title': ['PUT'],
-  '/api/company-md/docs/{slug}/transfer-owner': ['POST'],
+  '/api/company-md/docs/{id}': ['GET'],
+  '/api/company-md/docs/{id}/content': ['PUT'],
+  '/api/company-md/docs/{id}/context-bank': ['GET'],
+  '/api/company-md/docs/{id}/context-bank/associate': ['POST'],
+  '/api/company-md/docs/{id}/context-bank/retry': ['POST'],
+  '/api/company-md/docs/{id}/context-bank/upload': ['POST'],
+  '/api/company-md/docs/{id}/context-bank/{contextDocId}': ['DELETE'],
+  '/api/company-md/docs/{id}/context-bank/{contextDocId}/order': ['PATCH'],
+  '/api/company-md/docs/{id}/sharing': ['GET'],
+  '/api/company-md/docs/{id}/sharing/acl': ['POST'],
+  '/api/company-md/docs/{id}/sharing/acl/{aclId}': ['DELETE', 'PUT'],
+  '/api/company-md/docs/{id}/sharing/policy': ['PUT'],
+  '/api/company-md/docs/{id}/title': ['PUT'],
+  '/api/company-md/docs/{id}/transfer-owner': ['POST'],
   '/api/company-md/extract': ['POST'],
   '/api/company-md/ownership/reassign': ['POST'],
   '/api/company-md/ownership/reassign/suggestion': ['GET'],

package/src/org/company-md.ts

@@ -80,6 +80,13 @@ export interface CompanyMdSource {
 }
 
 export interface CompanyMdDependency {
+  /**
+   * Stable id of the target doc — the identity used to resolve the reference.
+   * Post-ADR-BE-315 slugs are only parent-scoped unique, so `targetSlug` cannot
+   * identify a doc unambiguously; resolve by `targetId`, display `targetSlug`.
+   */
+  readonly targetId: string;
+  /** Human-readable slug of the target doc — presentation/label only. */
   readonly targetSlug: string;
   readonly description: string;
 }
@@ -137,6 +144,13 @@ export interface CompanyMdDocCollaborators {
 }
 
 export interface CompanyMdDocRelations {
+  /**
+   * Stable id of the doc this one inherits from — the identity used to resolve
+   * the reference (mirrors the resolved `parentId`). Resolve by `inheritsFromId`,
+   * display `inheritsFrom`. See ADR-BE-315: slugs are only parent-scoped unique.
+   */
+  readonly inheritsFromId: string | null;
+  /** Human-readable slug of the inherited-from doc — presentation/label only. */
   readonly inheritsFrom: string | null;
   readonly sources: readonly CompanyMdSource[];
   readonly dependencies: readonly CompanyMdDependency[];