synomem 0.9.6 → 0.10.0

package/src/projections.ts

@@ -21,7 +21,6 @@ import type {
   TaskRecord,
   TodoRecord,
 } from './types.js';
-
 /**
  * The instant a deadline has passed.
  *
@@ -34,13 +33,10 @@ export function dueInstant(due: TaskDue | undefined): string | undefined {
   if (!due) return undefined;
   return due.kind === 'date' ? `${due.date}T23:59:59.999Z` : due.datetime;
 }
-
 const generatedMarker = '<!-- Generated by Synomem. Rebuild with `synomem rebuild`. -->';
-
 function manifestPath(home: string, path: string): string {
   return relative(home, path).split(sep).join('/');
 }
-
 export function escapeMarkdown(value: string): string {
   return value
     .replaceAll('&', '&amp;')
@@ -49,13 +45,11 @@ export function escapeMarkdown(value: string): string {
     .replace(/([\\`*_{}[\]()#+!|])/g, '\\$1')
     .replace(/^(\s*)(-|\d+\.)\s/gm, '$1\\$2 ');
 }
-
 function evidenceLine(evidence: EvidenceReference): string {
   const kind = evidence.kind.replace('-', ' ');
   const label = evidence.label ? `${escapeMarkdown(evidence.label)} — ` : '';
   return `- **${escapeMarkdown(kind[0]?.toUpperCase() + kind.slice(1))}:** ${label}${escapeMarkdown(evidence.value)}`;
 }
-
 function recordMarkdown(record: KudosRecord, includeTitle = true): string {
   const event = record.event;
   const lines = [
@@ -75,7 +69,6 @@ function recordMarkdown(record: KudosRecord, includeTitle = true): string {
   lines.push(`**Kudos ID:** \`${event.id}\``, '');
   return lines.join('\n');
 }
-
 function winsMarkdown(profile: AgentProfile, records: KudosRecord[], rebuiltAt: string): string {
   const active = records.filter((record) => !record.revocation);
   const lines = [
@@ -101,7 +94,6 @@ function winsMarkdown(profile: AgentProfile, records: KudosRecord[], rebuiltAt:
   }
   return `${lines.join('\n')}\n`;
 }
-
 function inboxMarkdown(record: KudosRecord): string {
   return `${[
     generatedMarker,
@@ -111,7 +103,6 @@ function inboxMarkdown(record: KudosRecord): string {
     recordMarkdown(record, false),
   ].join('\n')}\n`;
 }
-
 function memoInboxMarkdown(record: MemoRecord): string {
   return `${[
     generatedMarker,
@@ -126,7 +117,6 @@ function memoInboxMarkdown(record: MemoRecord): string {
     '',
   ].join('\n')}\n`;
 }
-
 function taskInboxMarkdown(record: TaskRecord): string {
   const due =
     record.current.due?.kind === 'date'
@@ -147,7 +137,6 @@ function taskInboxMarkdown(record: TaskRecord): string {
     ...(record.current.description ? [escapeMarkdown(record.current.description), ''] : []),
   ].join('\n')}\n`;
 }
-
 function memoryMarkdown(profile: AgentProfile, records: NoteRecord[], rebuiltAt: string): string {
   const active = records.filter((record) => record.status === 'active');
   const lines = [
@@ -172,7 +161,6 @@ function memoryMarkdown(profile: AgentProfile, records: NoteRecord[], rebuiltAt:
   }
   return `${lines.join('\n')}\n`;
 }
-
 function tasksMarkdown(profile: AgentProfile, records: TaskRecord[], rebuiltAt: string): string {
   const lines = [
     generatedMarker,
@@ -202,7 +190,6 @@ function tasksMarkdown(profile: AgentProfile, records: TaskRecord[], rebuiltAt:
   }
   return `${lines.join('\n')}\n`;
 }
-
 export function recordsFromEvents(events: SynomemEvent[]): KudosRecord[] {
   const acknowledgments = new Map<string, KudosRecord['acknowledgment']>();
   const revocations = new Map<string, KudosRecord['revocation']>();
@@ -232,7 +219,6 @@ export function recordsFromEvents(events: SynomemEvent[]): KudosRecord[] {
         b.event.createdAt.localeCompare(a.event.createdAt) || b.event.id.localeCompare(a.event.id),
     );
 }
-
 export function memoRecordsFromEvents(events: SynomemEvent[]): MemoRecord[] {
   const records = new Map<string, MemoRecord>();
   for (const event of events) {
@@ -254,7 +240,6 @@ export function memoRecordsFromEvents(events: SynomemEvent[]): MemoRecord[] {
   }
   return [...records.values()].sort((a, b) => b.event.createdAt.localeCompare(a.event.createdAt));
 }
-
 /**
  * Rebuilds posts from their events, acknowledgements included.
  *
@@ -269,6 +254,7 @@ export function postRecordsFromEvents(events: SynomemEvent[]): PostRecord[] {
       records.set(event.id, {
         event,
         edits: [],
+        mentions: event.mentions ?? [],
         acknowledgments: [],
         status: 'active',
         title: event.title,
@@ -286,6 +272,7 @@ export function postRecordsFromEvents(events: SynomemEvent[]): PostRecord[] {
       const record = records.get(event.postId);
       if (record) {
         record.edits.push(event);
+        record.mentions = event.mentions ?? [];
         record.title = event.title;
         record.body = event.body;
         if (event.tags) record.tags = event.tags;
@@ -323,7 +310,6 @@ export function postRecordsFromEvents(events: SynomemEvent[]): PostRecord[] {
   }
   return [...records.values()];
 }
-
 export function noteRecordsFromEvents(events: SynomemEvent[]): NoteRecord[] {
   const records = new Map<string, NoteRecord>();
   for (const event of events) {
@@ -364,7 +350,6 @@ export function noteRecordsFromEvents(events: SynomemEvent[]): NoteRecord[] {
   }
   return [...records.values()].sort((a, b) => b.event.createdAt.localeCompare(a.event.createdAt));
 }
-
 /**
  * Builds private Todo records.
  *
@@ -431,7 +416,6 @@ export function todoRecordsFromEvents(events: SynomemEvent[]): TodoRecord[] {
   }
   return [...records.values()];
 }
-
 export function taskRecordsFromEvents(events: SynomemEvent[]): TaskRecord[] {
   const records = new Map<string, TaskRecord>();
   for (const event of events) {
@@ -466,6 +450,14 @@ export function taskRecordsFromEvents(events: SynomemEvent[]): TaskRecord[] {
           version: event.aggregateVersion,
         };
       }
+    } else if (event.type === 'task.decision_overridden') {
+      const record = records.get(event.taskId);
+      if (record) {
+        record.status = event.nextStatus;
+        record.current.version = event.aggregateVersion;
+        record.overrides = [...(record.overrides ?? []), event];
+        delete record.terminal;
+      }
     } else if (event.type === 'task.accepted') {
       const record = records.get(event.taskId);
       if (record) {
@@ -513,7 +505,6 @@ export function taskRecordsFromEvents(events: SynomemEvent[]): TaskRecord[] {
   }
   return [...records.values()].sort((a, b) => b.event.createdAt.localeCompare(a.event.createdAt));
 }
-
 /** Render a portable human-readable export without reading generated projections. */
 export function renderMarkdownExport(events: SynomemEvent[]): string {
   const sections = [
@@ -536,16 +527,18 @@ export function renderMarkdownExport(events: SynomemEvent[]): string {
   ];
   return `${sections.join('\n\n')}\n`;
 }
-
 export class ProjectionManager implements ProjectionWriter {
   constructor(private readonly storage: SynomemStorage) {}
-
-  rebuild(): { generated: string[]; removed: string[] } {
+  rebuild(): {
+    generated: string[];
+    removed: string[];
+  } {
     this.storage.assertWritable();
     const events = this.storage.getEvents();
     this.storage.transactionSync(() => {
       this.storage.rebuildKudosCurrentIndex();
       this.storage.rebuildItemsCurrentIndex();
+      this.storage.rebuildParticipationCurrentIndex();
     });
     const profiles = this.storage.listAgents();
     const records = recordsFromEvents(events);
@@ -554,7 +547,6 @@ export class ProjectionManager implements ProjectionWriter {
     const tasks = taskRecordsFromEvents(events);
     const rebuiltAt = events.at(-1)?.createdAt ?? new Date(0).toISOString();
     const generated: string[] = [];
-
     for (const profile of profiles) {
       const agentDirectory = join(this.storage.home, profile.handle);
       assertNoSymlinkEscape(this.storage.home, agentDirectory);
@@ -571,7 +563,6 @@ export class ProjectionManager implements ProjectionWriter {
       ensureDirectory(kudosInboxDirectory);
       ensureDirectory(memoInboxDirectory);
       ensureDirectory(taskInboxDirectory);
-
       atomicWriteDerivedFile(
         profilePath,
         `${JSON.stringify({ _generatedBy: 'synomem', ...profile }, null, 2)}\n`,
@@ -583,19 +574,26 @@ export class ProjectionManager implements ProjectionWriter {
           `# Notes — ${profile.displayName}\n\n<!-- Human-owned. Synomem will never overwrite this file. -->\n`,
         );
       }
-
-      const agentRecords = records.filter((record) => record.event.recipientAgentId === profile.id);
+      const agentRecords = records.filter(
+        (record) =>
+          record.event.recipient?.kind === 'agent' && record.event.recipient.id === profile.id,
+      );
       if (this.storage.config.projection.writeWinsMarkdown) {
         atomicWriteDerivedFile(winsPath, winsMarkdown(profile, agentRecords, rebuiltAt));
         generated.push(manifestPath(this.storage.home, winsPath));
       }
-      const agentNotes = notes.filter((record) => record.event.ownerAgentId === profile.id);
+      const agentNotes = notes.filter(
+        (record) => record.event.owner?.kind === 'agent' && record.event.owner.id === profile.id,
+      );
       if (this.storage.config.projection.writeMemoryMarkdown) {
         const memoryPath = join(agentDirectory, 'MEMORY.md');
         atomicWriteDerivedFile(memoryPath, memoryMarkdown(profile, agentNotes, rebuiltAt));
         generated.push(manifestPath(this.storage.home, memoryPath));
       }
-      const agentTasks = tasks.filter((record) => record.event.assigneeAgentId === profile.id);
+      const agentTasks = tasks.filter(
+        (record) =>
+          record.event.assignee?.kind === 'agent' && record.event.assignee.id === profile.id,
+      );
       if (this.storage.config.projection.writeTasksMarkdown) {
         const tasksPath = join(agentDirectory, 'TASKS.md');
         atomicWriteDerivedFile(tasksPath, tasksMarkdown(profile, agentTasks, rebuiltAt));
@@ -610,7 +608,10 @@ export class ProjectionManager implements ProjectionWriter {
           generated.push(manifestPath(this.storage.home, inboxPath));
         }
         for (const record of memos.filter(
-          (item) => item.event.recipientAgentId === profile.id && item.status === 'unread',
+          (item) =>
+            item.event.recipient?.kind === 'agent' &&
+            item.event.recipient.id === profile.id &&
+            item.status === 'unread',
         )) {
           const inboxPath = join(memoInboxDirectory, `${record.event.id}.md`);
           atomicWriteDerivedFile(inboxPath, memoInboxMarkdown(record));
@@ -625,7 +626,6 @@ export class ProjectionManager implements ProjectionWriter {
         }
       }
     }
-
     const keep = new Set(generated);
     const removed: string[] = [];
     for (const stale of this.storage.projectionManifest()) {
@@ -643,7 +643,6 @@ export class ProjectionManager implements ProjectionWriter {
     this.storage.replaceProjectionManifest(generated, rebuiltAt);
     return { generated: generated.sort(), removed: removed.sort() };
   }
-
   /**
    * Move an agent's directory when its handle changes.
    *
@@ -680,23 +679,28 @@ export class ProjectionManager implements ProjectionWriter {
     renameSync(from, to);
     this.storage.renameProjectionManifestPrefix(previousHandle, nextHandle);
   }
-
-  syncAgent(agentId: string): { generated: string[]; removed: string[] } {
+  syncAgent(agentId: string): {
+    generated: string[];
+    removed: string[];
+  } {
     this.storage.assertWritable();
     const profile = this.storage.getAgent(agentId);
     if (!profile) throw new SynomemError('AGENT_NOT_FOUND', `Unknown agent: ${agentId}`);
     const events = this.storage.getEvents();
     const records = recordsFromEvents(events).filter(
-      (record) => record.event.recipientAgentId === profile.id,
+      (record) =>
+        record.event.recipient?.kind === 'agent' && record.event.recipient.id === profile.id,
     );
     const memos = memoRecordsFromEvents(events).filter(
-      (record) => record.event.recipientAgentId === profile.id,
+      (record) =>
+        record.event.recipient?.kind === 'agent' && record.event.recipient.id === profile.id,
     );
     const notes = noteRecordsFromEvents(events).filter(
-      (record) => record.event.ownerAgentId === profile.id,
+      (record) => record.event.owner?.kind === 'agent' && record.event.owner.id === profile.id,
     );
     const tasks = taskRecordsFromEvents(events).filter(
-      (record) => record.event.assigneeAgentId === profile.id,
+      (record) =>
+        record.event.assignee?.kind === 'agent' && record.event.assignee.id === profile.id,
     );
     const rebuiltAt = events.at(-1)?.createdAt ?? new Date(0).toISOString();
     const agentDirectory = join(this.storage.home, profile.handle);
@@ -711,7 +715,6 @@ export class ProjectionManager implements ProjectionWriter {
     ensureDirectory(kudosInboxDirectory);
     ensureDirectory(memoInboxDirectory);
     ensureDirectory(taskInboxDirectory);
-
     const generated: string[] = [];
     const profilePath = join(agentDirectory, 'profile.json');
     atomicWriteDerivedFile(
@@ -719,7 +722,6 @@ export class ProjectionManager implements ProjectionWriter {
       `${JSON.stringify({ _generatedBy: 'synomem', ...profile }, null, 2)}\n`,
     );
     generated.push(manifestPath(this.storage.home, profilePath));
-
     const notesPath = join(agentDirectory, 'NOTES.md');
     if (!existsSync(notesPath)) {
       atomicWriteFile(
@@ -727,25 +729,21 @@ export class ProjectionManager implements ProjectionWriter {
         `# Notes — ${profile.displayName}\n\n<!-- Human-owned. Synomem will never overwrite this file. -->\n`,
       );
     }
-
     if (this.storage.config.projection.writeWinsMarkdown) {
       const winsPath = join(agentDirectory, 'WINS.md');
       atomicWriteDerivedFile(winsPath, winsMarkdown(profile, records, rebuiltAt));
       generated.push(manifestPath(this.storage.home, winsPath));
     }
-
     if (this.storage.config.projection.writeMemoryMarkdown) {
       const memoryPath = join(agentDirectory, 'MEMORY.md');
       atomicWriteDerivedFile(memoryPath, memoryMarkdown(profile, notes, rebuiltAt));
       generated.push(manifestPath(this.storage.home, memoryPath));
     }
-
     if (this.storage.config.projection.writeTasksMarkdown) {
       const tasksPath = join(agentDirectory, 'TASKS.md');
       atomicWriteDerivedFile(tasksPath, tasksMarkdown(profile, tasks, rebuiltAt));
       generated.push(manifestPath(this.storage.home, tasksPath));
     }
-
     if (this.storage.config.projection.writeInboxEntries) {
       for (const record of records.filter(
         (item) => item.status === 'unacknowledged' && item.revocationStatus === 'active',
@@ -770,7 +768,6 @@ export class ProjectionManager implements ProjectionWriter {
         generated.push(relativePath);
       }
     }
-
     const keep = new Set(generated);
     const prefixes = [`${profile.handle}/`, `${profile.handle}\\`];
     const removed: string[] = [];
@@ -791,7 +788,6 @@ export class ProjectionManager implements ProjectionWriter {
     this.storage.replaceAgentProjectionManifest(profile.handle, generated, rebuiltAt);
     return { generated: generated.sort(), removed: removed.sort() };
   }
-
   /*
    * The paths a rebuild would produce, for comparison against the manifest.
    *
@@ -817,20 +813,25 @@ export class ProjectionManager implements ProjectionWriter {
       if (this.storage.config.projection.writeInboxEntries) {
         for (const record of records.filter(
           (item) =>
-            item.event.recipientAgentId === profile.id &&
+            item.event.recipient?.kind === 'agent' &&
+            item.event.recipient.id === profile.id &&
             item.status === 'unacknowledged' &&
             item.revocationStatus === 'active',
         )) {
           paths.push(`${profile.handle}/inbox/kudos/${record.event.id}.md`);
         }
         for (const record of memos.filter(
-          (item) => item.event.recipientAgentId === profile.id && item.status === 'unread',
+          (item) =>
+            item.event.recipient?.kind === 'agent' &&
+            item.event.recipient.id === profile.id &&
+            item.status === 'unread',
         )) {
           paths.push(`${profile.handle}/inbox/memos/${record.event.id}.md`);
         }
         for (const record of tasks.filter(
           (item) =>
-            item.event.assigneeAgentId === profile.id &&
+            item.event.assignee?.kind === 'agent' &&
+            item.event.assignee.id === profile.id &&
             (item.status === 'open' || item.status === 'assigned'),
         )) {
           paths.push(`${profile.handle}/inbox/tasks/${record.event.id}.md`);