Context Vigilance
Search/

← Corpus / augment-it / plan

augment-it 0.0.1.0 Shipped

Augment from DB · Phase 2 — the org-workbench remote: flow registration, org search, org card

Autocomplete to a canonical org and work its card with a live ➕ on every list — plus the verb the spec missed, `organization.streams.add`.

Path
plans/Augment-From-DB-Phase-2-Org-Workbench-Remote.md
Authors
Michael Staton
Augmented with
Claude Code on Claude Fable 5
Tags
Plan · Augment-It · Augment-From-DB · Phase-2 · Org-Workbench · Microfrontend · Module-Federation

Augment from DB · Phase 2 — org-workbench remote

Spec reference

Implements Phase 2 of [[../specs/Augment-From-DB-Flow]] (Implementing). Scaffold template: apps/person-db-resolver (package.json, tsconfig, rsbuild config, mount contract, workspace.connect + workspace.active client-derivation idiom, augment-it:workspace-changed listener). Branch: rebuild/turbo-rsbuild.

One spec gap discovered and closed here: the spec’s Phase 2 assumed “existing add verbs” cover all three lists, but only organization.links.add / organization.corpus.add exist — there is no single-entry verb for media_streams[] (streams only ever arrived via resolver.apply’s batch path). This plan adds organization.streams.add (mirrors addOrgLink, reuses the module-private shapeStream → kind auto-inferred, party: 'first_party'), plus its handler, capability-map entry, and 30s timeout.

Steps

  1. Service verb — addOrgStream in services/record-surrealdb-resolver/src/resolver.ts ({org_slug, url, kind?, client} → {ok, org_id, stream}); handler block in handlers.ts (organization.streams.add.requested); capabilities.ts map + timeout entries.
  2. Scaffold apps/org-workbench/ (:3014) — package.json (@augment-it/org-workbench), tsconfig, rsbuild config (federation name orgWorkbench, exposes ./mount, cors origin :3100, assetPrefix :3014), src/{index.ts, mount.ts (mountOrgWorkbench), css.d.ts, app.css (ow-* prefix)}.
  3. Client lib — src/lib/types.ts (OrgSuggestion, OrgDetail, SearchRequestDetail for Phase 3); src/lib/org-client.ts — typed wrappers over workspace.invoke for resolver.search, organization.detail, organization.links.add, organization.streams.add, organization.corpus.add.
  4. Components — OrgSearch.svelte (debounced ≥250ms autocomplete over resolver.search, keyboard-free v1: click to pick); AdditiveList.svelte (generic: entries with kind badge + host + added-date, inline ➕ form → caller-supplied add fn, busy/error localized per list); OrgCard.svelte (identity block: names, slug, aliases, domains; three AdditiveLists); App.svelte (header strip “SurrealDB · main/main · Organizations”, client badge, ws status; search → card; refetch on augment-it:entity-updated and on every successful add).
  5. Shell registration — AUGMENT_FROM_DB_ROTATION = ['orgWorkbench'] + REMOTES entry in remotes.ts; augmentFromDb FLOWS entry in flows.svelte.ts; orgWorkbench@http://localhost:3014/remoteEntry.js in rsbuild.config.ts.
  6. Verify (see below), changelog, commit + push as attempt(augment-from-db, org-workbench, step2):.

Verification

  • pnpm install links the new workspace package; pnpm check (svelte-check) green in apps/org-workbench; pnpm build green in apps/org-workbench and shell; pnpm typecheck green in the two touched services.
  • organization.streams.add proven over raw NATS (rebuild record-surrealdb-resolver + workspace-service containers): add a stream URL to a known org → organization.detail re-read shows it with inferred kind + party: 'first_party'.
  • Dev-server smoke: pnpm dev in org-workbench, curl -sf localhost:3014/remoteEntry.js returns the federation manifest.
  • Browser walk-through (operator): Flows popdown → “Augment from DB” → search → card → ➕ on each list. Deferred to the operator; everything scriptable is scripted.

Out of scope

People reveal / add-person (Phase 4), the 🔍 search-launch buttons and search-and-add remote (Phase 3), stream scanning (Phase 5).