@company-semantics/contracts 0.98.0 → 0.100.0

package/package.json

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

package/src/index.ts

@@ -246,10 +246,13 @@ export type {
   // Goals domain types (PRD-00173)
   GoalVisibility,
   GoalDocLevel,
+  GoalNodeType,
   GoalSource,
   GoalDependency,
   GoalTreeNode,
   GoalDoc,
+  TeamDepartmentRole,
+  TeamDepartmentMembership,
   // Team types (PRD-00306)
   TeamMembershipRole,
   TeamSyncMode,

package/src/org/departments.ts

@@ -0,0 +1,46 @@
+/**
+ * Department Domain Types
+ *
+ * Vocabulary types for the org hierarchy: Company > Departments > Teams > Members.
+ * Shared between backend (persistence/service) and app (UI rendering).
+ */
+
+export type DepartmentMembershipRole = 'member' | 'manager' | 'owner';
+
+export type DepartmentSyncMode = 'manual_only' | 'scim' | 'hris';
+
+export type TeamScope = 'department' | 'cross_department' | 'org';
+
+export type UserScope = 'department' | 'org';
+
+/**
+ * Department read model for list views.
+ */
+export interface Department {
+  readonly id: string;
+  readonly name: string;
+  readonly slug: string;
+  readonly description: string | null;
+  readonly memberCount: number;
+  readonly position: number;
+}
+
+/**
+ * Department member within a department detail view.
+ */
+export interface DepartmentMember {
+  readonly userId: string;
+  readonly name: string;
+  readonly email: string;
+  readonly role: DepartmentMembershipRole;
+  readonly joinedAt: string;
+}
+
+/**
+ * Full department detail view including members.
+ * Returned by GET /api/departments/:id.
+ */
+export interface DepartmentDetail extends Department {
+  readonly members: ReadonlyArray<DepartmentMember>;
+  readonly syncMode: DepartmentSyncMode;
+}

package/src/org/goals.ts

@@ -10,6 +10,16 @@ export type GoalVisibility = 'public' | 'private';
 
 export type GoalDocLevel = 'root' | 'department' | 'team';
 
+export type GoalNodeType = 'company' | 'department' | 'team' | 'cross_team' | 'doc' | 'goal' | 'source' | 'map';
+
+export type TeamDepartmentRole = 'owner' | 'participant' | 'supporting';
+
+export interface TeamDepartmentMembership {
+  readonly teamId: string;
+  readonly departmentId: string;
+  readonly role: TeamDepartmentRole;
+}
+
 export interface GoalSource {
   readonly label: string;
   readonly sourceType: 'meeting' | 'document' | 'conversation' | 'manual';
@@ -21,30 +31,32 @@ export interface GoalDependency {
   readonly description: string;
 }
 
-export interface GoalTreeNode {
+export interface GoalNodeIdentity {
   readonly id: string;
   readonly slug: string;
   readonly title: string;
   readonly level: GoalDocLevel;
+  readonly parentId: string | null;
+  /** Department name (backwards-compat) */
   readonly department: string | null;
+  /** Structured department reference */
+  readonly departmentId: string | null;
   readonly visibility: GoalVisibility;
-  readonly canEdit: boolean;
-  readonly memberCount: number;
   /** 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 GoalDocCore {
-  readonly id: string;
-  readonly slug: string;
-  readonly title: string;
-  readonly level: GoalDocLevel;
-  readonly department: string | null;
+export interface GoalTreeNode extends GoalNodeIdentity {
+  readonly type: GoalNodeType;
+  readonly canEdit: boolean;
+  readonly memberCount: number;
+  readonly description?: string;
+  /** Department IDs this node is associated with (for cross-team projections). */
+  readonly departmentIds?: readonly string[];
+}
+
+export interface GoalDocCore extends GoalNodeIdentity {
   readonly content: string;
-  readonly visibility: GoalVisibility;
-  readonly parentId: string | null;
-  /** 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 GoalDocCollaborators {

package/src/org/index.ts

@@ -84,24 +84,39 @@ export { VIEW_SCOPE_MAP, getViewScope } from './view-scopes';
 export type {
   GoalVisibility,
   GoalDocLevel,
+  GoalNodeType,
   GoalSource,
   GoalDependency,
+  GoalNodeIdentity,
   GoalTreeNode,
   GoalDocCore,
   GoalDocCollaborators,
   GoalDocRelations,
   GoalDoc,
+  TeamDepartmentRole,
+  TeamDepartmentMembership,
 } from './goals';
 
 // Team types (PRD-00306)
 export type {
   TeamMembershipRole,
   TeamSyncMode,
+  TeamScope,
   Team,
   TeamMember,
   TeamDetail,
 } from './teams';
 
+// Department types (org hierarchy rationalization)
+export type {
+  DepartmentMembershipRole,
+  DepartmentSyncMode,
+  UserScope,
+  Department,
+  DepartmentMember,
+  DepartmentDetail,
+} from './departments';
+
 // Sharing and ACL types (PRD-00306)
 export type {
   AccessLevel,

package/src/org/teams.ts

@@ -14,6 +14,11 @@ export type TeamMembershipRole = 'member' | 'manager' | 'owner';
  */
 export type TeamSyncMode = 'manual_only' | 'synced_readonly' | 'synced_with_overrides';
 
+/**
+ * Team scope — discriminates the organizational scope of a team.
+ */
+export type { TeamScope } from './departments';
+
 /**
  * Team read model for list views.
  */
@@ -23,6 +28,9 @@ export interface Team {
   readonly slug: string;
   readonly description: string | null;
   readonly memberCount: number;
+  readonly scope: import('./departments').TeamScope;
+  readonly department: { readonly id: string; readonly name: string; readonly slug: string } | null;
+  readonly homeDepartment: { readonly id: string; readonly name: string; readonly slug: string } | null;
 }
 
 /**