@company-semantics/contracts 0.99.0 → 0.100.0

package/package.json

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

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

@@ -31,35 +31,32 @@ export interface GoalDependency {
   readonly description: string;
 }
 
-export interface GoalTreeNode {
+export interface GoalNodeIdentity {
   readonly id: string;
   readonly slug: string;
   readonly title: string;
-  readonly type: GoalNodeType;
   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;
+  /** 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;
   readonly canEdit: boolean;
   readonly memberCount: number;
   readonly description?: string;
-  /** Owning team. Null for root docs or when the owning team has been deleted. */
-  readonly owningTeam: { readonly id: string; readonly name: string } | null;
   /** Department IDs this node is associated with (for cross-team projections). */
   readonly departmentIds?: readonly string[];
 }
 
-export interface GoalDocCore {
-  readonly id: string;
-  readonly slug: string;
-  readonly title: string;
-  readonly level: GoalDocLevel;
-  readonly department: string | null;
+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

@@ -87,6 +87,7 @@ export type {
   GoalNodeType,
   GoalSource,
   GoalDependency,
+  GoalNodeIdentity,
   GoalTreeNode,
   GoalDocCore,
   GoalDocCollaborators,
@@ -100,11 +101,22 @@ export type {
 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;
 }
 
 /**