@company-semantics/contracts 44.2.0 → 44.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "44.2.0",
+  "version": "44.4.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -80,8 +80,8 @@
   },
   "scripts": {
     "build": "tsc -b --noEmit",
-    "typecheck": "tsc -b --noEmit",
-    "typecheck:ci": "tsc -p scripts/ci/tsconfig.json",
+    "typecheck": "NODE_OPTIONS='--max-old-space-size=4096' tsc -b --noEmit",
+    "typecheck:ci": "NODE_OPTIONS='--max-old-space-size=4096' tsc -p scripts/ci/tsconfig.json",
     "lint:md": "markdownlint-cli2 '**/*.md' '#node_modules' '#.ralph/worktrees' '#.claude/worktrees'",
     "format": "prettier --write src/",
     "format:check": "prettier --check src/",
@@ -99,11 +99,11 @@
     "guard:quick": "GUARD_DEPENDENCY_ROOT=../ tsx ../company-semantics-ci/run-guards.ts --config scripts/ci/guard-entries.ts --quick",
     "ci:local": "pnpm typecheck && pnpm lint:md && pnpm guard:test && GUARD_DEPENDENCY_ROOT=../ pnpm guard",
     "guard": "GUARD_DEPENDENCY_ROOT=../ tsx ../company-semantics-ci/run-guards.ts --config scripts/ci/guard-entries.ts",
-    "guard:test": "vitest run scripts/ci/__tests__",
+    "guard:test": "NODE_OPTIONS='--max-old-space-size=4096' vitest run scripts/ci/__tests__",
     "release": "npx tsx scripts/release.ts",
     "prepublishOnly": "echo 'ERROR: Publishing is CI-only via tag push. Use pnpm release instead.' && exit 1",
-    "test": "bash scripts/vitest-run.sh run",
-    "test:run": "bash scripts/vitest-run.sh run",
+    "test": "NODE_OPTIONS='--max-old-space-size=4096' bash scripts/vitest-run.sh run",
+    "test:run": "NODE_OPTIONS='--max-old-space-size=4096' bash scripts/vitest-run.sh run",
     "color": "tsx scripts/color.ts",
     "generate:spec-hash": "tsx scripts/generate-spec-hash.ts",
     "generate:spec-hash:check": "tsx scripts/generate-spec-hash.ts --check",
@@ -114,6 +114,7 @@
     "generate:openapi-routes:check": "tsx scripts/generate-openapi-routes.ts --check",
     "generate:api-types:check": "openapi-typescript openapi/backend.yaml -o /tmp/cs-api-types-check.ts && diff -q src/api/generated.ts /tmp/cs-api-types-check.ts",
     "generate:current": "tsx ../company-semantics-ci/scripts/generate-current.ts",
+    "adr:new": "tsx ../company-semantics-control/scripts/adr/adr-new-cli.ts",
     "repo-map": "tsx ../company-semantics-ci/scripts/generate-repo-map.ts --roots src --name company-semantics-contracts --write",
     "repo-map:check": "tsx ../company-semantics-ci/scripts/generate-repo-map.ts --roots src --name company-semantics-contracts --check",
     "readme-api": "tsx ../company-semantics-ci/scripts/generate-readme-api.ts --roots src --write --jsdoc",

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 = 'c4ce5a8f3e9b' as const;
-export const SPEC_HASH_FULL = 'c4ce5a8f3e9b221190fe57672f0f485d50f763f2480162cbfdedb59140ef7450' as const;
+export const SPEC_HASH = '9bcb0e0bc2cc' as const;
+export const SPEC_HASH_FULL = '9bcb0e0bc2cce27742a97dd5f7ef4cadcff268e8700f40554258301cee4e183e' as const;

package/src/api/generated.ts

@@ -2879,6 +2879,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/me/md": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get (and lazily materialize) my personal doc */
+        get: operations["getMyMd"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/me/action-items": {
         parameters: {
             query?: never;
@@ -5550,7 +5567,7 @@ export interface components {
         WorkItemDetailResponse: {
             id: string;
             /** @enum {string} */
-            kind: "meeting" | "comm" | "doc";
+            kind: "meeting" | "comm" | "doc" | "personal";
             title: string;
             content: string;
             contentRedacted?: boolean;
@@ -9634,7 +9651,9 @@ export interface operations {
     };
     listOrgUnitOwners: {
         parameters: {
-            query?: never;
+            query?: {
+                explain?: "true" | "false";
+            };
             header?: never;
             path: {
                 unitId: string;
@@ -10205,7 +10224,9 @@ export interface operations {
     };
     importOrgChart: {
         parameters: {
-            query?: never;
+            query?: {
+                dryRun?: "true" | "false";
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -10401,7 +10422,12 @@ export interface operations {
     };
     listDriveFiles: {
         parameters: {
-            query?: never;
+            query?: {
+                q?: string;
+                pageSize?: number;
+                pageToken?: string;
+                mimeTypes?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -10421,7 +10447,10 @@ export interface operations {
     };
     listRecentDriveFiles: {
         parameters: {
-            query?: never;
+            query?: {
+                pageSize?: number;
+                pageToken?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -10441,7 +10470,9 @@ export interface operations {
     };
     getDriveFileContent: {
         parameters: {
-            query?: never;
+            query: {
+                mimeType: string;
+            };
             header?: never;
             path: {
                 fileId: string;
@@ -10738,7 +10769,15 @@ export interface operations {
     };
     listMyWorkItems: {
         parameters: {
-            query?: never;
+            query: {
+                cursor?: string;
+                limit?: number;
+                kind: "meeting" | "comm" | "doc";
+                period?: "current_month" | "last_30_days" | "last_7_days" | "yesterday";
+                anchor?: string;
+                before?: number;
+                after?: number;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -10756,7 +10795,9 @@ export interface operations {
     };
     getMyWorkItemCounts: {
         parameters: {
-            query?: never;
+            query?: {
+                period?: "current_month" | "last_30_days" | "last_7_days" | "yesterday";
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -10774,7 +10815,9 @@ export interface operations {
     };
     getWorkspaceWorkItemCounts: {
         parameters: {
-            query?: never;
+            query?: {
+                period?: "current_month" | "last_30_days" | "last_7_days" | "yesterday";
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -10885,6 +10928,26 @@ export interface operations {
             };
         };
     };
+    getMyMd: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The caller-owned personal doc (kind personal), created on first access with an empty body */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkItemDetailResponse"];
+                };
+            };
+        };
+    };
     listMyActionItems: {
         parameters: {
             query?: never;
@@ -11746,7 +11809,11 @@ export interface operations {
     };
     factoryKpis: {
         parameters: {
-            query?: never;
+            query?: {
+                since?: string;
+                source?: "ralph" | "interactive";
+                limit?: number;
+            };
             header?: never;
             path?: never;
             cookie?: never;

package/src/content/schemas.ts

@@ -217,7 +217,9 @@ export const CompanyMdDocResponseSchema = z.object({
  */
 export const WorkItemDetailResponseSchema = z.object({
   id: z.string(),
-  kind: z.enum(["meeting", "comm", "doc"]),
+  // `personal` is the /me/md page (ADR-BE-487): a per-(org, user) singleton
+  // riding the work_items substrate, served by getMyMd and this detail route.
+  kind: z.enum(["meeting", "comm", "doc", "personal"]),
   title: z.string(),
   content: z.string(),
   /**

package/src/generated/openapi-routes.ts

@@ -79,6 +79,7 @@ export const openApiRoutes = {
   '/api/me/feed': ['GET'],
   '/api/me/feed/read': ['POST'],
   '/api/me/feed/read-all': ['POST'],
+  '/api/me/md': ['GET'],
   '/api/me/meetings/recordings/start': ['POST'],
   '/api/me/meetings/recordings/{id}': ['DELETE'],
   '/api/me/meetings/recordings/{id}/complete': ['POST'],

package/src/permissions/share-api.ts

@@ -113,9 +113,12 @@ export const AclListResponseSchema = z.object({
    * Who knows this entity EXISTS — a SIBLING of `visibility`, not a modifier
    * on it (ADR-CONTRACTS-093).
    *
-   * ABSENT => this entity type has no discoverability axis (work_item,
-   * meeting_recording). Deliberately not defaulted: `org|owners` has no honest
-   * cross-entity value, unlike `general_access_role`'s `viewer`.
+   * ABSENT => the share dialog has no discoverability control for this
+   * entity: meeting_recording (no axis at all) and company_md (the policy is
+   * DERIVED server-side — 'org' for structural docs, ADR-BE-482 — never
+   * share-governed). PRESENT only for work_item, the one stored,
+   * share-governed axis (ADR-BE-486). Deliberately not defaulted: `org|owners`
+   * has no honest cross-entity value, unlike `general_access_role`'s `viewer`.
    *
    * The policy's domain is NON-READERS only. When `visibility` is `org` every
    * member is a reader, so the stored value affects no one — it is not erased,