feat(org-relations, search-results): team-crawl synopsis persists — organization.add_observation lands as person.add_observation's twin

The team card's synopsis (didi's account of who the selection policy
excluded: "~10+ others on the page excluded by policy: Robin Gilbert (VP
People & Culture), …") died with the queue card. It now persists as a
search_synopsis observation on the ORGANIZATION, written once when the
operator first accepts from the card — the crawl itself still never
writes, and a failed synopsis write soft-fails and retries on the next
accept, never blocking the person.

The enabling verb is generic: organization.add_observation (org_slug,
predicate, value, source, client) — the org-side twin of
person.add_observation, available to didi and future surfaces too.

Sibling of #59 (agent_search_rationale on the edge): between them, both
layers of the crawl's judgment — per-candidate and per-crawl — survive
the queue.

Verified: tsc clean both services, svelte-check 0/0, live NATS
write + read-back on a throwaway org, zero residue.

Closes #60.

Files changed:
- services/record-surrealdb-resolver/src/org-relations.ts
- services/workspace/src/capabilities.ts
- apps/search-results/src/SearchCard.svelte
- apps/search-results/src/TeamAccept.svelte
- apps/search-results/src/lib/search-client.ts

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RW28dw3kQAKXr2ZNefCukE

Author: mpstaton

apps/search-results/src/SearchCard.svelte

@@ -169,6 +169,7 @@
           <TeamAccept
             people={results.people ?? []}
             source_urls={results.source_urls ?? []}
+            filtered_note={results.filtered_note ?? ''}
             org_slug={card.entity.org_slug}
             orgName={orgLabel}
             {client}

apps/search-results/src/TeamAccept.svelte

@@ -9,6 +9,7 @@
   // broadcast refreshes the org card's People list. Skip discards a row.
 
   import {
+    addOrgObservation,
     addPersonLink,
     affiliatePerson,
     applyPerson,
@@ -19,13 +20,18 @@
   let {
     people,
     source_urls,
+    filtered_note = '',
     org_slug,
     orgName,
     client,
     onremaining,
   }: {
     people: CrawledPerson[];
     source_urls: string[];
+    // didi's crawl synopsis (who the policy excluded and why) — persisted
+    // as a search_synopsis observation on the ORG the first time the
+    // operator accepts from this card (gh #60).
+    filtered_note?: string;
     org_slug: string;
     orgName: string;
     client: string;
@@ -55,6 +61,26 @@
     return row.person.bio_url ?? source_urls[0] ?? 'didi-crawl';
   }
 
+  // Write-once: the first successful accept from this card also persists
+  // didi's synopsis on the org. Soft-fail — the synopsis is context, never
+  // a reason to fail the accept.
+  let synopsisWritten = $state(false);
+  async function persistSynopsis() {
+    if (synopsisWritten || !filtered_note) return;
+    synopsisWritten = true;
+    try {
+      await addOrgObservation({
+        org_slug,
+        predicate: 'search_synopsis',
+        value: filtered_note,
+        source: source_urls[0] ?? 'didi-crawl',
+        client,
+      });
+    } catch {
+      synopsisWritten = false; // retry on the next accept
+    }
+  }
+
   async function accept(row: Row) {
     row.error = null;
     row.phase = 'writing';
@@ -115,6 +141,7 @@
         }
       }
       row.consumed = true;
+      void persistSynopsis();
       window.dispatchEvent(
         new CustomEvent('augment-it:entity-updated', { detail: { org_slug } }),
       );

apps/search-results/src/lib/search-client.ts

@@ -138,6 +138,22 @@ export async function affiliatePerson(args: {
   if (!r.ok) throw new Error(r.error || 'person.affiliate failed');
 }
 
+// Free-form org observation — first consumer: the team-crawl
+// search_synopsis, written once per card on first accept (gh #60).
+export async function addOrgObservation(args: {
+  org_slug: string;
+  predicate: string;
+  value: string;
+  source?: string;
+  client: string;
+}): Promise<void> {
+  const r = (await workspace.invoke('organization.add_observation', args)) as {
+    ok: boolean;
+    error?: string;
+  };
+  if (!r.ok) throw new Error(r.error || 'organization.add_observation failed');
+}
+
 export async function addPersonLink(args: {
   person_uuid: string;
   url: string;

services/record-surrealdb-resolver/src/org-relations.ts

@@ -361,6 +361,40 @@ export async function removeOrgTag(
   return { ok: true, removed: ids.length > 0 };
 }
 
+// --- organization.add_observation ------------------------------------------
+// person.add_observation's twin (gh #60): a free-form observation with an
+// ORG as subject. First consumer: the team-crawl search_synopsis (didi's
+// account of who the policy excluded), written once when the operator
+// first accepts from a card — the crawl itself still never writes.
+
+export type OrgAddObservationInput = {
+  org_slug: string;
+  predicate: string;
+  value: string;
+  client: string;
+  source?: string;
+};
+
+export async function addOrgObservation(
+  db: Surreal,
+  input: OrgAddObservationInput,
+): Promise<{ ok: true }> {
+  const org = await resolveOrgId(db, input.org_slug, input.client);
+  const predicate = input.predicate.trim();
+  const value = input.value.trim();
+  if (!predicate || !value) {
+    throw new Error('organization.add_observation requires both predicate and value');
+  }
+  await observe(db, {
+    subject: org,
+    predicate,
+    object: value,
+    source: input.source || 'org-workbench',
+    client: input.client,
+  });
+  return { ok: true };
+}
+
 // Read helper for getOrgDetail's tags extension — takes the already-resolved
 // org RecordId so detail doesn't resolve the slug twice.
 export async function listOrgTagsById(
@@ -408,4 +442,5 @@ export function registerOrgRelationHandlers(nc: NatsConnection): void {
   handle<OrgRelationUpdateInput>('organization.relation.update.requested', updateOrgRelation);
   handle<OrgTagInput>('organization.tag.add.requested', addOrgTag);
   handle<OrgTagInput>('organization.tag.remove.requested', removeOrgTag);
+  handle<OrgAddObservationInput>('organization.add_observation.requested', addOrgObservation);
 }

services/workspace/src/capabilities.ts

@@ -228,6 +228,8 @@ const CAPABILITY_TO_SUBJECT: Record<string, string> = {
   'organization.tag.remove': 'organization.tag.remove.requested',
   // Distinct corpus kinds for the kind-input datalist (gh #57).
   'organization.corpus.kinds': 'organization.corpus.kinds.requested',
+  // Free-form org observation — person.add_observation's twin (gh #60).
+  'organization.add_observation': 'organization.add_observation.requested',
 
   // Domain catalog — the canonical typed-grouping graph behind apps/strategy-curator
   // (which is the type='strategy' view). Served by record-surrealdb-resolver
@@ -356,6 +358,7 @@ const CAPABILITY_TIMEOUTS_MS: Record<string, number> = {
   'organization.tag.add': 30_000,
   'organization.tag.remove': 30_000,
   'organization.corpus.kinds': 30_000,
+  'organization.add_observation': 30_000,
   'client.brief.get': 30_000,
   'client.brief.set': 30_000,
   // A crawl is one model turn with multiple server-side web searches (plus