feat(org-workbench, corpus-kinds): kind input becomes autocomplete — vocabulary converges without being enforced

Human-gate finding from the org-relations walk-through: the Corpus items
adder's free-text kind breeds near-duplicates (report vs reports). The
kind inputs (add AND edit) now autocomplete against the kinds already in
use across the client's orgs, while a non-match still creates exactly
what the operator typed — open vocabulary, converging by suggestion.

New read organization.corpus.kinds (resolver.ts listCorpusKinds): distinct
org_corpus kinds across the client's visible orgs, flattened in JS rather
than a version-sensitive [*].kind projection. Handler in handlers.ts, verb
+ timeout in capabilities.ts. First live fire: 19 kinds in reach-edu.

AdditiveList grows an optional kindSuggestions datalist (per-instance id,
$derived); OrgCard fetches the vocabulary per card load and feeds it to
the Corpus items list only (links/streams kinds stay auto-detected).

Verified: tsc clean both services, svelte-check 0/0, services rebuilt,
live NATS fire returns the real vocabulary.

Refs #57.

Files changed:
- services/record-surrealdb-resolver/src/resolver.ts
- services/record-surrealdb-resolver/src/handlers.ts
- services/workspace/src/capabilities.ts
- apps/org-workbench/src/AdditiveList.svelte
- apps/org-workbench/src/OrgCard.svelte
- apps/org-workbench/src/lib/org-client.ts
- changelog/2026-07-27_01_Organizations-Learn-Their-Family-Tree-Parent-Child-Peer-Relations-Plus-Org-Tags.md

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

Author: mpstaton

apps/org-workbench/src/AdditiveList.svelte

@@ -26,12 +26,17 @@
     onremove,
     removenote,
     entryaction,
+    kindSuggestions,
   }: {
     title: string;
     entries: Entry[];
     kindHint?: string;
     // Show a name input on the ➕ form (streams: "Today's Credentials").
     nameable?: boolean;
+    // Optional datalist for the kind inputs (add + edit) — autocomplete
+    // against kinds already in use; a non-match still creates whatever the
+    // operator typed (gh #57).
+    kindSuggestions?: string[];
     onadd: (url: string, kind?: string, name?: string) => Promise<void>;
     // Optional 🔍 — launches search-and-add pre-scoped to this list (Phase 3).
     onsearch?: () => void;
@@ -51,6 +56,9 @@
     entryaction?: { label: string; fn: (entry: Entry) => void };
   } = $props();
 
+  // One datalist per list instance — the id must be unique in the page.
+  const kindListId = $derived(`ow-kinds-${title.toLowerCase().replace(/[^a-z0-9]+/g, '-')}`);
+
   let adding = $state(false);
   let open = $state(false);
   let url = $state('');
@@ -205,6 +213,7 @@
         class="ow-add-kind"
         type="text"
         placeholder={kindHint}
+        list={kindSuggestions?.length ? kindListId : undefined}
         bind:value={kind}
         disabled={adding}
       />
@@ -242,6 +251,7 @@
                 class="ow-add-kind"
                 type="text"
                 placeholder="kind"
+                list={kindSuggestions?.length ? kindListId : undefined}
                 bind:value={editKind}
                 onkeydown={onEditKey}
                 disabled={editBusy}
@@ -327,6 +337,12 @@
       {/each}
     </ul>
   {/if}
+
+  {#if kindSuggestions?.length}
+    <datalist id={kindListId}>
+      {#each kindSuggestions as k (k)}<option value={k}></option>{/each}
+    </datalist>
+  {/if}
 </section>
 
 <style>

apps/org-workbench/src/OrgCard.svelte

@@ -22,6 +22,7 @@
     addOrgTag,
     removeOrgTag,
     suggestTags,
+    fetchCorpusKinds,
   } from './lib/org-client';
   import { requestSearch } from './lib/search-request';
   import { submitCrawl } from './lib/search-queue';
@@ -107,6 +108,18 @@
   // Tags — has_tag observations per client (Initiative / Program / Funder…).
   // Datalist rides the shared per-client tag_vocab via tag.suggest; fetched
   // lazily when the add input opens.
+  // Corpus-kind vocabulary for the datalist (gh #57) — client-wide, refreshed
+  // per card load so a kind minted on one org suggests on the next.
+  let corpusKinds = $state<string[]>([]);
+  $effect(() => {
+    void org.slug;
+    fetchCorpusKinds(client)
+      .then((k) => (corpusKinds = k))
+      .catch(() => {
+        /* datalist is a convenience — the input works without it */
+      });
+  });
+
   let addingTag = $state(false);
   let tagDraft = $state('');
   let tagVocab = $state<string[]>([]);
@@ -360,6 +373,7 @@
       title="Corpus items"
       entries={org.org_corpus}
       kindHint="kind (optional)"
+      kindSuggestions={corpusKinds}
       onadd={makeAdd(addOrgCorpus)}
       onedit={makeEdit(updateOrgCorpus)}
       onremove={makeRemove(removeOrgCorpus)}

apps/org-workbench/src/lib/org-client.ts

@@ -199,6 +199,18 @@ export async function updateOrgIdentity(args: {
   if (!r.ok) throw new Error(r.error || 'resolver.update_org failed');
 }
 
+// Distinct corpus kinds across the client's orgs — feeds the kind input's
+// datalist so vocabulary converges without being enforced (gh #57).
+export async function fetchCorpusKinds(client: string): Promise<string[]> {
+  const r = (await workspace.invoke('organization.corpus.kinds', { client })) as {
+    ok: boolean;
+    kinds?: string[];
+    error?: string;
+  };
+  if (!r.ok) throw new Error(r.error || 'organization.corpus.kinds failed');
+  return r.kinds ?? [];
+}
+
 export async function addOrgCorpus(args: AddArgs): Promise<ShapedLink> {
   const r = (await workspace.invoke('organization.corpus.add', args)) as {
     ok: boolean;

changelog/2026-07-27_01_Organizations-Learn-Their-Family-Tree-Parent-Child-Peer-Relations-Plus-Org-Tags.md

@@ -179,3 +179,15 @@ triage SKILL.md's parent-child open decision flips to **MODEL LANDED**,
 and the `initiative_hub` stream kind sheds its "while parent/child
 modeling is unresolved" caveat — it's now only for initiatives that don't
 merit their own org row.
+
+### Human-gate finding: corpus kinds stop drifting (#57)
+
+The operator's walk-through surfaced it in minutes: the Corpus items
+adder's free-text `kind` breeds near-duplicates (`report` vs `reports`).
+Fix: `organization.corpus.kinds` returns the distinct kinds already in use
+across the client's orgs — 19 in reach-edu on first fire (`annual_report`,
+`article`, `blog_post`, …) — and `AdditiveList` grew an optional
+`kindSuggestions` datalist on both the add and edit kind inputs.
+Autocomplete, never enforcement: a non-match creates exactly what the
+operator typed, the same open-vocabulary philosophy as relation kinds.
+Refreshed per card load, so a kind minted on one org suggests on the next.

services/record-surrealdb-resolver/src/handlers.ts

@@ -31,6 +31,7 @@ import {
   setClientBrief,
   type BriefSetInput,
   getOrgDetail,
+  listCorpusKinds,
   checkContentUrls,
   type NormRecord,
   type ApplyInput,
@@ -320,4 +321,21 @@ export function registerHandlers(nc: NatsConnection): void {
       }
     }
   })();
+
+  // organization.corpus.kinds — distinct corpus kinds for the client's
+  // datalist (gh #57, the org-relations human-gate finding).
+  (async () => {
+    const sub = nc.subscribe('organization.corpus.kinds.requested');
+    for await (const msg of sub) {
+      const args = msg.json() as { client: string };
+      try {
+        const db = await getDb();
+        const result = await listCorpusKinds(db, args.client);
+        if (msg.reply) msg.respond(JSON.stringify(result));
+      } catch (err: unknown) {
+        const error = err instanceof Error ? err.message : String(err);
+        if (msg.reply) msg.respond(JSON.stringify({ ok: false, error }));
+      }
+    }
+  })();
 }

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

@@ -1213,3 +1213,29 @@ export async function getOrgDetail(
     },
   };
 }
+
+// organization.corpus.kinds — the distinct corpus-item kinds already in use
+// across every org this client can see. Feeds the kind input's datalist so
+// vocabulary converges (report vs reports) without ever being enforced —
+// a non-match creates whatever the operator typed. Flattened in JS rather
+// than a [*].kind projection (version-sensitive SurrealQL, same caution as
+// D4's domains clause).
+export async function listCorpusKinds(
+  db: Surreal,
+  client: string,
+): Promise<{ ok: true; kinds: string[] }> {
+  const r = await db.query(
+    `SELECT VALUE org_corpus FROM organizations WHERE client_access CONTAINS $client;`,
+    { client },
+  );
+  const lists = (r?.[0] as { kind?: unknown }[][]) ?? [];
+  const kinds = Array.from(
+    new Set(
+      lists
+        .flat()
+        .map((e) => (typeof e?.kind === 'string' ? e.kind.trim() : ''))
+        .filter(Boolean),
+    ),
+  ).sort((a, b) => a.localeCompare(b));
+  return { ok: true, kinds };
+}

services/workspace/src/capabilities.ts

@@ -226,6 +226,8 @@ const CAPABILITY_TO_SUBJECT: Record<string, string> = {
   'organization.relation.update': 'organization.relation.update.requested',
   'organization.tag.add': 'organization.tag.add.requested',
   'organization.tag.remove': 'organization.tag.remove.requested',
+  // Distinct corpus kinds for the kind-input datalist (gh #57).
+  'organization.corpus.kinds': 'organization.corpus.kinds.requested',
 
   // Domain catalog — the canonical typed-grouping graph behind apps/strategy-curator
   // (which is the type='strategy' view). Served by record-surrealdb-resolver
@@ -353,6 +355,7 @@ const CAPABILITY_TIMEOUTS_MS: Record<string, number> = {
   'organization.relation.update': 30_000,
   'organization.tag.add': 30_000,
   'organization.tag.remove': 30_000,
+  'organization.corpus.kinds': 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