@company-semantics/contracts 0.110.0 → 0.112.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.110.0",
+  "version": "0.112.1",
   "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

@@ -1722,7 +1722,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/tree": {
+    "/api/company-md/tree": {
         parameters: {
             query?: never;
             header?: never;
@@ -1744,7 +1744,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/docs/{slug}": {
+    "/api/company-md/docs/{slug}": {
         parameters: {
             query?: never;
             header?: never;
@@ -1766,7 +1766,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/docs/{slug}/content": {
+    "/api/company-md/docs/{slug}/content": {
         parameters: {
             query?: never;
             header?: never;
@@ -1787,7 +1787,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/docs/{slug}/title": {
+    "/api/company-md/docs/{slug}/title": {
         parameters: {
             query?: never;
             header?: never;
@@ -1808,7 +1808,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/docs/{slug}/sharing": {
+    "/api/company-md/docs/{slug}/sharing": {
         parameters: {
             query?: never;
             header?: never;
@@ -1830,7 +1830,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/docs/{slug}/sharing/policy": {
+    "/api/company-md/docs/{slug}/sharing/policy": {
         parameters: {
             query?: never;
             header?: never;
@@ -1851,7 +1851,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/docs/{slug}/sharing/acl": {
+    "/api/company-md/docs/{slug}/sharing/acl": {
         parameters: {
             query?: never;
             header?: never;
@@ -1872,7 +1872,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/docs/{slug}/sharing/acl/{aclId}": {
+    "/api/company-md/docs/{slug}/sharing/acl/{aclId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -1897,7 +1897,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/goals/extract": {
+    "/api/company-md/extract": {
         parameters: {
             query?: never;
             header?: never;

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

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;