@company-semantics/contracts 0.109.0 → 0.112.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.109.0",
+  "version": "0.112.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -77,6 +77,7 @@
     "guard:decisions-deprecation": "npx tsx scripts/ci/decisions-deprecation-guard.ts",
     "guard:decisions-deprecation:json": "npx tsx scripts/ci/decisions-deprecation-guard.ts --json",
     "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": "GUARD_DEPENDENCY_ROOT=../ tsx ../company-semantics-ci/run-guards.ts --config scripts/ci/guard-entries.ts",
     "guard:test": "vitest run scripts/ci/__tests__",
     "release": "npx tsx scripts/release.ts",
@@ -95,14 +96,14 @@
     "zod": "^4.2.1"
   },
   "devDependencies": {
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.5.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.2.7",
-    "markdownlint-cli2": "^0.20.0",
+    "lint-staged": "^16.4.0",
+    "markdownlint-cli2": "^0.22.0",
     "openapi-typescript": "^7.13.0",
     "tsx": "^4.21.0",
     "typescript": "^5",
-    "vitest": "^4.0.16",
+    "vitest": "^4.1.2",
     "yaml": "^2.8.3"
   },
   "pnpm": {

package/src/api/generated.ts

@@ -935,6 +935,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/workspace/name": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Rename the workspace
+         * @description PATCH the workspace name. Requires org.manage_users capability (owner or admin).
+         */
+        patch: operations["renameWorkspace"];
+        trace?: never;
+    };
     "/api/workspace/members": {
         parameters: {
             query?: never;
@@ -2081,6 +2101,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/scope/check-batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Batch check authorization scopes for current user
+         * @description Checks whether the current user has access to each of the given scopes. Scope strings are implementation-defined and not part of the public API vocabulary. Accepts 1-20 scope strings per request.
+         */
+        post: operations["checkScopeBatch"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -2455,6 +2495,16 @@ export interface components {
             estimatedCostUsd: string;
             requestCount: number;
         };
+        ScopeCheckBatchRequest: {
+            scopes: string[];
+        };
+        ScopeCheckBatchResponse: {
+            results: {
+                [key: string]: {
+                    hasAccess: boolean;
+                };
+            };
+        };
         ErrorResponse: {
             error: string;
             message: string;
@@ -2758,6 +2808,9 @@ export interface components {
         OrgType: "personal" | "shared";
         /** @enum {string} */
         WorkspaceRole: "owner" | "admin" | "member";
+        RenameWorkspaceRequest: {
+            name: string;
+        };
         WorkspaceOverview: {
             /** Format: uuid */
             id: string;
@@ -4985,6 +5038,57 @@ export interface operations {
             };
         };
     };
+    renameWorkspace: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RenameWorkspaceRequest"];
+            };
+        };
+        responses: {
+            /** @description Updated workspace overview */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceOverview"];
+                };
+            };
+            /** @description Invalid name */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Missing org.manage_users capability */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     getWorkspaceMembers: {
         parameters: {
             query?: never;
@@ -6166,6 +6270,8 @@ export interface operations {
             query?: {
                 /** @description Time period for usage aggregation */
                 period?: "current_month" | "last_30_days" | "last_7_days";
+                /** @description IANA timezone identifier for date bucketing */
+                tz?: string;
             };
             header?: never;
             path: {
@@ -8043,4 +8149,46 @@ export interface operations {
             };
         };
     };
+    checkScopeBatch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ScopeCheckBatchRequest"];
+            };
+        };
+        responses: {
+            /** @description Authorization results for each scope */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ScopeCheckBatchResponse"];
+                };
+            };
+            /** @description Invalid input (empty array, >20 items, invalid scope format) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not authenticated */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
 }

package/src/generated/openapi-routes.ts

@@ -15,6 +15,15 @@ export const openApiRoutes = {
   '/api/chats/{id}/generate-title': ['POST'],
   '/api/chats/{id}/messages': ['POST'],
   '/api/chats/{id}/pin': ['DELETE', 'POST'],
+  '/api/company-md/docs/{slug}': ['GET'],
+  '/api/company-md/docs/{slug}/content': ['PUT'],
+  '/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/extract': ['POST'],
+  '/api/company-md/tree': ['GET'],
   '/api/departments': ['GET', 'POST'],
   '/api/departments/{id}': ['DELETE', 'GET', 'PATCH'],
   '/api/departments/{id}/members': ['POST'],
@@ -29,15 +38,6 @@ export const openApiRoutes = {
   '/api/executions/{executionId}/summary': ['GET'],
   '/api/executions/{executionId}/timeline': ['GET'],
   '/api/executions/{executionId}/undo': ['POST'],
-  '/api/goals/docs/{slug}': ['GET'],
-  '/api/goals/docs/{slug}/content': ['PUT'],
-  '/api/goals/docs/{slug}/sharing': ['GET'],
-  '/api/goals/docs/{slug}/sharing/acl': ['POST'],
-  '/api/goals/docs/{slug}/sharing/acl/{aclId}': ['DELETE', 'PUT'],
-  '/api/goals/docs/{slug}/sharing/policy': ['PUT'],
-  '/api/goals/docs/{slug}/title': ['PUT'],
-  '/api/goals/extract': ['POST'],
-  '/api/goals/tree': ['GET'],
   '/api/integrations/status': ['GET'],
   '/api/me': ['GET'],
   '/api/org/cancel-deletion': ['POST'],
@@ -53,6 +53,7 @@ export const openApiRoutes = {
   '/api/orgs/{orgId}/ai-usage': ['GET'],
   '/api/orgs/{orgId}/billing': ['GET'],
   '/api/orgs/{orgId}/budget-config': ['GET', 'PUT'],
+  '/api/scope/check-batch': ['POST'],
   '/api/shared/{token}': ['GET'],
   '/api/shares/{shareId}': ['DELETE', 'PATCH'],
   '/api/teams': ['GET', 'POST'],
@@ -85,6 +86,7 @@ export const openApiRoutes = {
   '/api/workspace/members': ['GET'],
   '/api/workspace/members/{id}': ['DELETE'],
   '/api/workspace/members/{id}/role': ['PATCH'],
+  '/api/workspace/name': ['PATCH'],
   '/api/workspace/resolve-path': ['POST'],
   '/api/workspace/resync-slack-logo': ['POST'],
   '/auth/logout': ['POST'],

package/src/index.ts

@@ -243,14 +243,14 @@ export type {
   IdentityTrustLevel,
   TransferEligibilityResult,
   TransferMemberEligibility,
-  // Goals domain types (PRD-00173)
-  GoalVisibility,
-  GoalDocLevel,
-  GoalNodeType,
-  GoalSource,
-  GoalDependency,
-  GoalTreeNode,
-  GoalDoc,
+  // Company.md domain types (PRD-00173)
+  CompanyMdVisibility,
+  CompanyMdDocLevel,
+  CompanyMdNodeType,
+  CompanyMdSource,
+  CompanyMdDependency,
+  CompanyMdTreeNode,
+  CompanyMdDoc,
   TeamDepartmentRole,
   TeamDepartmentMembership,
   // Team types (PRD-00306)

package/src/org/__tests__/view-scopes.test.ts

@@ -7,7 +7,7 @@ describe('VIEW_SCOPE_MAP golden snapshot', () => {
       workspace: 'org.view_workspace',
       timeline: 'org.view_timeline',
       teamwork: 'org.view_teamwork',
-      goals: 'org.view_goals',
+      'company-md': 'org.view_company_md',
       teams: 'org.view_teams',
       'internal-admin': 'internal.view_admin',
       chat: null,
@@ -24,7 +24,7 @@ describe('getViewScope', () => {
     expect(getViewScope('workspace')).toBe('org.view_workspace')
     expect(getViewScope('timeline')).toBe('org.view_timeline')
     expect(getViewScope('teamwork')).toBe('org.view_teamwork')
-    expect(getViewScope('goals')).toBe('org.view_goals')
+    expect(getViewScope('company-md')).toBe('org.view_company_md')
     expect(getViewScope('internal-admin')).toBe('internal.view_admin')
   })
 

package/src/org/{goals.ts → company-md.ts}

@@ -1,16 +1,16 @@
 /**
- * Goals Domain Types
+ * Company.md Domain Types
  *
- * Vocabulary types for the Company.md goals feature.
+ * Vocabulary types for the Company.md feature.
  * Shared between backend (persistence/service) and app (UI rendering).
  * @see PRD-00173 for design rationale
  */
 
-export type GoalVisibility = 'public' | 'private';
+export type CompanyMdVisibility = 'public' | 'private';
 
-export type GoalDocLevel = 'root' | 'department' | 'team';
+export type CompanyMdDocLevel = 'root' | 'department' | 'team';
 
-export type GoalNodeType = 'company' | 'department' | 'team' | 'cross_team' | 'doc' | 'goal' | 'source' | 'map';
+export type CompanyMdNodeType = 'company' | 'department' | 'team' | 'cross_team' | 'doc' | 'goal' | 'source' | 'map';
 
 export type TeamDepartmentRole = 'owner' | 'participant' | 'supporting';
 
@@ -20,34 +20,34 @@ export interface TeamDepartmentMembership {
   readonly role: TeamDepartmentRole;
 }
 
-export interface GoalSource {
+export interface CompanyMdSource {
   readonly label: string;
   readonly sourceType: 'meeting' | 'document' | 'conversation' | 'manual';
   readonly referencedAt: string;
 }
 
-export interface GoalDependency {
+export interface CompanyMdDependency {
   readonly targetSlug: string;
   readonly description: string;
 }
 
-export interface GoalNodeIdentity {
+export interface CompanyMdNodeIdentity {
   readonly id: string;
   readonly slug: string;
   readonly title: string;
-  readonly level: GoalDocLevel;
+  readonly level: CompanyMdDocLevel;
   readonly parentId: string | null;
   /** Department name (backwards-compat) */
   readonly department: string | null;
   /** Structured department reference */
   readonly departmentId: string | null;
-  readonly visibility: GoalVisibility;
+  readonly visibility: CompanyMdVisibility;
   /** Owning team. Null for root docs or when the owning team has been deleted. */
   readonly owningTeam: { readonly id: string; readonly name: string } | null;
 }
 
-export interface GoalTreeNode extends GoalNodeIdentity {
-  readonly type: GoalNodeType;
+export interface CompanyMdTreeNode extends CompanyMdNodeIdentity {
+  readonly type: CompanyMdNodeType;
   readonly canEdit: boolean;
   readonly memberCount: number;
   readonly description?: string;
@@ -55,23 +55,23 @@ export interface GoalTreeNode extends GoalNodeIdentity {
   readonly departmentIds?: readonly string[];
 }
 
-export interface GoalDocCore extends GoalNodeIdentity {
+export interface CompanyMdDocCore extends CompanyMdNodeIdentity {
   readonly content: string;
 }
 
-export interface GoalDocCollaborators {
+export interface CompanyMdDocCollaborators {
   readonly owner: { readonly id: string; readonly name: string } | null;
   readonly coOwners: ReadonlyArray<{ readonly id: string; readonly name: string }>;
   readonly canEdit: boolean;
   readonly members: ReadonlyArray<{ readonly id: string; readonly name: string }>;
 }
 
-export interface GoalDocRelations {
+export interface CompanyMdDocRelations {
   readonly inheritsFrom: string | null;
-  readonly sources: readonly GoalSource[];
-  readonly dependencies: readonly GoalDependency[];
+  readonly sources: readonly CompanyMdSource[];
+  readonly dependencies: readonly CompanyMdDependency[];
   readonly createdAt: string;
   readonly updatedAt: string;
 }
 
-export type GoalDoc = GoalDocCore & GoalDocCollaborators & GoalDocRelations;
+export type CompanyMdDoc = CompanyMdDocCore & CompanyMdDocCollaborators & CompanyMdDocRelations;

package/src/org/index.ts

@@ -80,22 +80,22 @@ export type {
 export type { AuthorizableView } from './view-scopes';
 export { VIEW_SCOPE_MAP, getViewScope } from './view-scopes';
 
-// Goals domain types (PRD-00173)
+// Company.md domain types (PRD-00173)
 export type {
-  GoalVisibility,
-  GoalDocLevel,
-  GoalNodeType,
-  GoalSource,
-  GoalDependency,
-  GoalNodeIdentity,
-  GoalTreeNode,
-  GoalDocCore,
-  GoalDocCollaborators,
-  GoalDocRelations,
-  GoalDoc,
+  CompanyMdVisibility,
+  CompanyMdDocLevel,
+  CompanyMdNodeType,
+  CompanyMdSource,
+  CompanyMdDependency,
+  CompanyMdNodeIdentity,
+  CompanyMdTreeNode,
+  CompanyMdDocCore,
+  CompanyMdDocCollaborators,
+  CompanyMdDocRelations,
+  CompanyMdDoc,
   TeamDepartmentRole,
   TeamDepartmentMembership,
-} from './goals';
+} from './company-md';
 
 // Team types (PRD-00306)
 export type {

package/src/org/view-scopes.ts

@@ -20,7 +20,7 @@ export const VIEW_SCOPE_MAP = {
   workspace: 'org.view_workspace',
   timeline: 'org.view_timeline',
   teamwork: 'org.view_teamwork',
-  goals: 'org.view_goals',
+  'company-md': 'org.view_company_md',
   teams: 'org.view_teams',
   'internal-admin': 'internal.view_admin',
   // Public views (require only authentication)

package/src/usage/types.ts

@@ -4,7 +4,7 @@
  * See PRD-00166 for design rationale and invariants.
  */
 
-export type AiFeature = 'chat' | 'chat_title' | 'ingest_summarize' | 'ingest_embedding' | 'goal_extraction';
+export type AiFeature = 'chat' | 'chat_title' | 'ingest_summarize' | 'ingest_embedding' | 'company_md_extraction';
 
 export interface UsageSummary {
   totalTokens: number;