@company-semantics/contracts 0.112.0 → 0.113.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.112.0",
+  "version": "0.113.0",
   "private": false,
   "repository": {
     "type": "git",

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;
@@ -1735,7 +1735,7 @@ export interface paths {
          *     Auto-materializes docs on first access.
          *     Requires org.view_goals capability.
          */
-        get: operations["getGoalTree"];
+        get: operations["getCompanyMdTree"];
         put?: never;
         post?: never;
         delete?: 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;
@@ -1757,7 +1757,7 @@ export interface paths {
          *     Enforces visibility (returns 404 if user cannot see the doc).
          *     Requires org.view_goals capability.
          */
-        get: operations["getGoalDoc"];
+        get: operations["getCompanyMdDoc"];
         put?: never;
         post?: never;
         delete?: 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;
@@ -1779,7 +1779,7 @@ export interface paths {
          * @description Updates the content of a goal doc.
          *     canEdit checked in service (owner/co-owner/manage_goals).
          */
-        put: operations["updateGoalDocContent"];
+        put: operations["updateCompanyMdDocContent"];
         post?: never;
         delete?: never;
         options?: 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;
@@ -1800,7 +1800,7 @@ export interface paths {
          * @description Updates the title of a goal doc.
          *     canEdit checked in service (owner/co-owner/manage_goals).
          */
-        put: operations["updateGoalDocTitle"];
+        put: operations["updateCompanyMdDocTitle"];
         post?: never;
         delete?: never;
         options?: 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;
@@ -1821,7 +1821,7 @@ export interface paths {
          *     for the current user on a goal doc.
          *     Requires at least viewer access to the doc.
          */
-        get: operations["getGoalDocSharing"];
+        get: operations["getCompanyMdDocSharing"];
         put?: never;
         post?: never;
         delete?: 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;
@@ -1843,7 +1843,7 @@ export interface paths {
          * @description Sets the org-wide sharing policy for a goal doc.
          *     Requires canShare permission (doc ownership, team ownership, or org admin).
          */
-        put: operations["updateGoalDocSharingPolicy"];
+        put: operations["updateCompanyMdDocSharingPolicy"];
         post?: never;
         delete?: never;
         options?: 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;
@@ -1865,14 +1865,14 @@ export interface paths {
          * @description Grants a user or team access to a goal doc at a specified level.
          *     Requires canShare permission. Unique constraint on (doc, principalType, principalId).
          */
-        post: operations["addGoalDocAclEntry"];
+        post: operations["addCompanyMdDocAclEntry"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/api/goals/docs/{slug}/sharing/acl/{aclId}": {
+    "/api/company-md/docs/{slug}/sharing/acl/{aclId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -1885,19 +1885,19 @@ export interface paths {
          * @description Changes the access level of an existing ACL entry.
          *     Requires canShare permission.
          */
-        put: operations["updateGoalDocAclEntry"];
+        put: operations["updateCompanyMdDocAclEntry"];
         post?: never;
         /**
          * Remove an ACL entry from a goal doc
          * @description Revokes a specific ACL entry. Requires canShare permission.
          */
-        delete: operations["deleteGoalDocAclEntry"];
+        delete: operations["deleteCompanyMdDocAclEntry"];
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/api/goals/extract": {
+    "/api/company-md/extract": {
         parameters: {
             query?: never;
             header?: never;
@@ -1914,7 +1914,7 @@ export interface paths {
          *     Requires org.manage_goals capability.
          *     Max 10 concurrent extractions per server instance.
          */
-        post: operations["extractGoals"];
+        post: operations["extractCompanyMd"];
         delete?: never;
         options?: never;
         head?: never;
@@ -6954,7 +6954,7 @@ export interface operations {
             };
         };
     };
-    getGoalTree: {
+    getCompanyMdTree: {
         parameters: {
             query?: never;
             header?: never;
@@ -6983,7 +6983,7 @@ export interface operations {
             };
         };
     };
-    getGoalDoc: {
+    getCompanyMdDoc: {
         parameters: {
             query?: never;
             header?: never;
@@ -7024,7 +7024,7 @@ export interface operations {
             };
         };
     };
-    updateGoalDocContent: {
+    updateCompanyMdDocContent: {
         parameters: {
             query?: never;
             header?: never;
@@ -7078,7 +7078,7 @@ export interface operations {
             };
         };
     };
-    updateGoalDocTitle: {
+    updateCompanyMdDocTitle: {
         parameters: {
             query?: never;
             header?: never;
@@ -7132,7 +7132,7 @@ export interface operations {
             };
         };
     };
-    getGoalDocSharing: {
+    getCompanyMdDocSharing: {
         parameters: {
             query?: never;
             header?: never;
@@ -7169,7 +7169,7 @@ export interface operations {
             };
         };
     };
-    updateGoalDocSharingPolicy: {
+    updateCompanyMdDocSharingPolicy: {
         parameters: {
             query?: never;
             header?: never;
@@ -7224,7 +7224,7 @@ export interface operations {
             };
         };
     };
-    addGoalDocAclEntry: {
+    addCompanyMdDocAclEntry: {
         parameters: {
             query?: never;
             header?: never;
@@ -7297,7 +7297,7 @@ export interface operations {
             };
         };
     };
-    updateGoalDocAclEntry: {
+    updateCompanyMdDocAclEntry: {
         parameters: {
             query?: never;
             header?: never;
@@ -7354,7 +7354,7 @@ export interface operations {
             };
         };
     };
-    deleteGoalDocAclEntry: {
+    deleteCompanyMdDocAclEntry: {
         parameters: {
             query?: never;
             header?: never;
@@ -7395,7 +7395,7 @@ export interface operations {
             };
         };
     };
-    extractGoals: {
+    extractCompanyMd: {
         parameters: {
             query?: never;
             header?: never;

package/src/org/company-md.ts

@@ -8,9 +8,9 @@
 
 export type CompanyMdVisibility = 'public' | 'private';
 
-export type CompanyMdDocLevel = 'root' | 'department' | 'team';
+export type CompanyMdDocLevel = 'root' | 'department' | 'team' | 'context';
 
-export type CompanyMdNodeType = 'company' | 'department' | 'team' | 'cross_team' | 'doc' | 'goal' | 'source' | 'map';
+export type CompanyMdNodeType = 'company' | 'department' | 'team' | 'cross_team' | 'doc' | 'goal' | 'source' | 'map' | 'context_bank';
 
 export type TeamDepartmentRole = 'owner' | 'participant' | 'supporting';
 
@@ -75,3 +75,15 @@ export interface CompanyMdDocRelations {
 }
 
 export type CompanyMdDoc = CompanyMdDocCore & CompanyMdDocCollaborators & CompanyMdDocRelations;
+
+/**
+ * A context bank item — a company.md doc associated with one or more parent nodes.
+ * Context bank files can belong to company, department, or team levels.
+ */
+export interface CompanyMdContextBankItem {
+  readonly id: string;
+  readonly slug: string;
+  readonly title: string;
+  readonly visibility: CompanyMdVisibility;
+  readonly updatedAt: string;
+}