Q26: knowledge has scope, expiry, and supersession

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

src/shared/commands/collaboration.ts

@@ -23,6 +23,8 @@ export interface DeleteDocumentInput {
   documentId: string;
 }
 
+export type KnowledgeScopeType = "organization" | "project" | "goal" | "task" | "agent";
+
 export interface CreateKnowledgeEntryInput {
   orgId: string;
   topic: string;
@@ -31,6 +33,13 @@ export interface CreateKnowledgeEntryInput {
   importance: string;
   sourceType: string;
   sourceId: string | null;
+  scopeType: KnowledgeScopeType;
+  /** Required unless the scope is organization. */
+  scopeId: string | null;
+  /** UTC ISO time the entry stops applying, or null. */
+  validUntil: string | null;
+  /** An older entry this one replaces. */
+  supersedesId: string | null;
 }
 
 export interface DeleteKnowledgeEntryInput {

src/shared/domain.ts

@@ -419,6 +419,10 @@ export interface KnowledgeEntryRecord {
   importance: string;
   sourceType: string;
   sourceId: string | null;
+  scopeType: string;
+  scopeId: string | null;
+  validUntil: string | null;
+  supersededBy: string | null;
   createdAt: string;
   updatedAt: string;
 }