@startsimpli/integrations 0.1.5 → 0.2.1

package/src/__tests__/corpus-storage.test.ts

@@ -0,0 +1,301 @@
+/**
+ * THE SEAM: tenant storage -> `SourceDocument` (bd startsim-768w.38.22).
+ *
+ * WHY THIS FILE EXISTS. Every other suite in this package starts from a domain
+ * object. That is correct for a composer — it should be handed a contract — but
+ * it meant nothing in the package had ever run against the shape the pipeline
+ * really writes. The corpus delivery lands people as typed EDGES and puts only a
+ * `participant_count` on the document; the mapper read an inline
+ * `data.participants` array that `declare_canonical()` never emits. Both halves
+ * were individually correct, both were tested, and the Library shipped with an
+ * empty Parties block on every document the pipeline had ever delivered.
+ *
+ * So the assertions below start at the WIRE — raw `Entity` rows and raw
+ * `Relationship` rows, through `createCorpusApi`, out as documents — and they
+ * are the ones that go red if the two halves ever disagree again.
+ */
+import { describe, expect, it } from 'vitest';
+
+import { createCorpusApi } from '../corpus/client';
+import {
+  indexParticipants,
+  toMoneyEvent,
+  toParty,
+  toSourceDocument,
+} from '../corpus/entities';
+import type { TenantEntity, TenantRelationship } from '../corpus/entities';
+import {
+  createFixtureCorpusHttp,
+  FIXTURE_ORG,
+  FIXTURE_SOURCE_LABELS,
+  FIXTURE_TENANT_DOCUMENTS,
+  FIXTURE_TENANT_MONEY_EVENTS,
+  FIXTURE_TENANT_PARTIES,
+  FIXTURE_TENANT_RELATIONSHIPS,
+} from '../corpus/fixtures';
+import { rankDocuments } from '../corpus/retrieval';
+
+const SCOPE = { orgId: FIXTURE_ORG };
+
+function apiOver(overrides: Parameters<typeof createFixtureCorpusHttp>[0] = {}) {
+  const { http, requests } = createFixtureCorpusHttp(overrides);
+  const api = createCorpusApi({ http, scope: SCOPE, sourceLabels: FIXTURE_SOURCE_LABELS });
+  return { api, requests };
+}
+
+/** The exact row the corpus delivery writes, as read back on live tandem. */
+const DELIVERED_DOCUMENT: TenantEntity = {
+  id: '6c2f1e40-0000-4000-8000-000000000001',
+  entity_type: 'source_document',
+  external_id: 'granola:not_RHRSLnote00003',
+  name: 'Initech — security review',
+  data: {
+    url: 'https://notes.granola.ai/d/initech',
+    title: 'Initech — security review',
+    source: 'granola',
+    _origin: 'central-connector',
+    subtype: 'meeting',
+    summary: '## Blocker\n- **SAML SSO has not shipped**, and Initech will not sign without it.',
+    source_ref: 'not_RHRSLnote00003',
+    occurred_at: '2026-07-20T16:00:00Z',
+    participant_count: 2,
+  },
+  created_at: '2026-08-09T23:35:00Z',
+};
+
+const DELIVERED_PARTIES: TenantEntity[] = [
+  {
+    id: '6c2f1e40-0000-4000-8000-0000000000a1',
+    entity_type: 'party',
+    external_id: 'granola:priya@example.com',
+    name: 'Priya Nakamura',
+    data: {
+      source: 'granola', _origin: 'central-connector', subtype: 'person',
+      display_name: 'Priya Nakamura', email: 'priya@example.com', domain: 'example.com',
+      source_ref: 'priya@example.com',
+    },
+  },
+  {
+    id: '6c2f1e40-0000-4000-8000-0000000000a2',
+    entity_type: 'party',
+    external_id: 'granola:lena@example.com',
+    name: 'Lena Fischer',
+    data: {
+      source: 'granola', _origin: 'central-connector', subtype: 'person',
+      display_name: 'Lena Fischer', email: 'lena@example.com', domain: 'example.com',
+      source_ref: 'lena@example.com',
+    },
+  },
+];
+
+const DELIVERED_EDGES: TenantRelationship[] = [
+  { id: 'e1', rel_type: 'authored_by', source: DELIVERED_DOCUMENT.id, target: DELIVERED_PARTIES[0].id },
+  { id: 'e2', rel_type: 'involves', source: DELIVERED_DOCUMENT.id, target: DELIVERED_PARTIES[1].id },
+];
+
+// ---------------------------------------------------------------------------
+
+describe('the row the pipeline actually delivers', () => {
+  it('has NO inline participants — only a count', () => {
+    // If this ever stops being true the bug class has changed, and the rest of
+    // this file is testing the wrong thing.
+    const data = DELIVERED_DOCUMENT.data as Record<string, unknown>;
+    expect(data.participants).toBeUndefined();
+    expect(data.participant_count).toBe(2);
+  });
+
+  it('renders its people from the EDGES', async () => {
+    const { api } = apiOver({
+      entities: [DELIVERED_DOCUMENT, ...DELIVERED_PARTIES],
+      relationships: DELIVERED_EDGES,
+    });
+
+    const page = await api.listDocuments({ page: 1 });
+    const document = page.results[0];
+
+    expect(document.title).toBe('Initech — security review');
+    expect(document.participants.map((party) => party.name)).toEqual([
+      'Priya Nakamura',
+      'Lena Fischer',
+    ]);
+    // The AUTHOR leads, whatever order the edges paged in.
+    expect(document.participants[0].email).toBe('priya@example.com');
+  });
+
+  it('resolves people on the DETAIL fetch too, not only in the list', async () => {
+    const { api } = apiOver({
+      entities: [DELIVERED_DOCUMENT, ...DELIVERED_PARTIES],
+      relationships: DELIVERED_EDGES,
+    });
+    const document = await api.getDocument(String(DELIVERED_DOCUMENT.id));
+    expect(document.participants.map((party) => party.name)).toContain('Lena Fischer');
+  });
+
+  it('keeps a canonical party readable — `display_name`, not `name`', () => {
+    const party = toParty(DELIVERED_PARTIES[0], SCOPE);
+    expect(party.name).toBe('Priya Nakamura');
+    expect(party.kind).toBe('person');
+    expect(party.source).toBe('granola');
+  });
+});
+
+describe('both storage shapes, because both are real', () => {
+  it('still reads an inline participants array', () => {
+    const inline: TenantEntity = {
+      id: 'doc_inline',
+      entity_type: 'source_document',
+      data: {
+        source: 'upload', title: 'Hand-entered note',
+        participants: [{ id: 'p1', name: 'Ada Byron', email: 'ada@example.com' }],
+      },
+    };
+    expect(toSourceDocument(inline, SCOPE).participants.map((p) => p.name)).toEqual(['Ada Byron']);
+  });
+
+  it('unions the two without listing anyone twice', () => {
+    const both: TenantEntity = {
+      id: 'doc_both',
+      entity_type: 'source_document',
+      data: { source: 'upload', participants: [{ id: 'party_dana', name: 'Dana Reed' }] },
+    };
+    const merged = toSourceDocument(both, SCOPE, {}, [
+      { id: 'party_dana', name: 'Dana Reed', kind: 'person' },
+      { id: 'party_sam', name: 'Sam Ortiz', kind: 'person' },
+    ]);
+    expect(merged.participants.map((party) => party.name)).toEqual(['Dana Reed', 'Sam Ortiz']);
+  });
+
+  it('never puts a DOCUMENT in the parties list — `derived_from` is not a person', () => {
+    const byRecord = indexParticipants(FIXTURE_TENANT_RELATIONSHIPS, [
+      { id: 'party_dana', name: 'Dana Reed' },
+    ]);
+    // `not_7Kq2ZbVnRt4aXm` is the TARGET of a derived_from edge from doc one.
+    expect(byRecord.get('not_1d3tmYTlCICgjy')?.map((p) => p.id)).toEqual(['party_dana']);
+  });
+
+  it('drops an edge whose far end is not a party it can name', () => {
+    const byRecord = indexParticipants(
+      [{ rel_type: 'involves', source: 'doc_1', target: 'party_nobody' }],
+      [{ id: 'party_dana', name: 'Dana Reed' }],
+    );
+    expect(byRecord.size).toBe(0);
+  });
+
+  it('reads a money event’s party from its `billed_to` edge', async () => {
+    const { api } = apiOver();
+    const page = await api.listMoneyEvents!({ page: 1 });
+    const subscription = page.results.find((event) => event.id === 'sub_RedSuite01Acme')!;
+    expect(subscription.party?.name).toBe('Acme Robotics');
+    // …and the amount is still MINOR units off the canonical attribute.
+    expect(subscription.amount).toBe(400000);
+  });
+});
+
+describe('the graph read is bounded, cached and fails soft', () => {
+  it('costs ONE graph read across a list, a detail and a second page', async () => {
+    const { api, requests } = apiOver();
+    await api.listDocuments({ page: 1 });
+    await api.listDocuments({ page: 1 });
+    await api.getDocument('dbx_9812f0');
+
+    const relationshipReads = requests.filter((request) => request.path.includes('relationships'));
+    expect(relationshipReads).toHaveLength(1);
+  });
+
+  it('does not read the graph at all for an EMPTY corpus', async () => {
+    const { api, requests } = apiOver({ entities: [], relationships: [] });
+    const page = await api.listDocuments({ page: 1 });
+
+    expect(page.results).toEqual([]);
+    expect(requests.filter((request) => request.path.includes('relationships'))).toHaveLength(0);
+  });
+
+  it('still renders the corpus when the relationships endpoint is missing', async () => {
+    // A tenant one deploy behind must degrade to what it showed before this
+    // existed — not to an error where a Library used to be.
+    const { api } = apiOver({ missing: ['relationships'] });
+    const page = await api.listDocuments({ page: 1 });
+
+    expect(page.results.length).toBeGreaterThan(0);
+    expect(page.results.every((document) => document.participants.length === 0)).toBe(true);
+  });
+
+  it('walks every page of the graph, since the tenant ignores page_size', async () => {
+    // Two rows a page: the edges for the last document are only reachable by
+    // paging, which is exactly what the real PAGE_SIZE=50 does at scale.
+    const { api, requests } = apiOver({ pageSize: 2 });
+    // `pageSize: 100` is ignored by the server, exactly as the tenant ignores
+    // it — so the Dropbox row is on page THREE however wide the caller asked.
+    const page = await api.listDocuments({ page: 3, pageSize: 100 });
+    const dropbox = page.results.find((document) => document.id === 'dbx_9812f0');
+
+    expect(dropbox?.participants.map((party) => party.name)).toEqual(['Acme Robotics', 'Dana Reed']);
+    expect(requests.filter((request) => request.path.includes('relationships')).length).toBeGreaterThan(1);
+  });
+});
+
+describe('retrieval scores the people, not an empty string', () => {
+  it('finds a meeting by an attendee’s name that appears nowhere in its text', () => {
+    // `FIELD_WEIGHTS.participants` is 2 — second only to title. Before the edge
+    // join it scored an empty string on every row the pipeline delivered, so a
+    // question naming a person only landed if the prose happened to repeat it.
+    const documents = [
+      toSourceDocument(
+        DELIVERED_DOCUMENT,
+        SCOPE,
+        FIXTURE_SOURCE_LABELS,
+        indexParticipants(DELIVERED_EDGES, DELIVERED_PARTIES.map((row) => toParty(row, SCOPE))).get(
+          String(DELIVERED_DOCUMENT.id),
+        ) ?? [],
+      ),
+      toSourceDocument(FIXTURE_TENANT_DOCUMENTS[1], SCOPE, FIXTURE_SOURCE_LABELS),
+    ];
+    expect(documents[0].body).not.toContain('Lena');
+
+    const ranked = rankDocuments(documents, 'What did Lena Fischer raise?', { limit: 2 });
+    expect(ranked[0]?.document.id).toBe(String(DELIVERED_DOCUMENT.id));
+    expect(ranked[0]?.matchedTerms).toContain('lena');
+  });
+});
+
+describe('the fixtures are the pipeline’s shape, not a friendlier one', () => {
+  it('holds no inline participants anywhere in the raw rows', () => {
+    for (const entity of [...FIXTURE_TENANT_DOCUMENTS, ...FIXTURE_TENANT_MONEY_EVENTS]) {
+      const data = (entity.data ?? {}) as Record<string, unknown>;
+      expect(data.participants).toBeUndefined();
+      expect(data.attendees).toBeUndefined();
+      expect(data.party).toBeUndefined();
+    }
+  });
+
+  it('namespaces every external_id as `<connector_key>:<vendor id>`', () => {
+    for (const entity of [...FIXTURE_TENANT_DOCUMENTS, ...FIXTURE_TENANT_PARTIES]) {
+      const data = (entity.data ?? {}) as Record<string, unknown>;
+      expect(entity.external_id).toBe(`${String(data.source)}:${String(data.source_ref)}`);
+      expect(data._origin).toBe('central-connector');
+    }
+  });
+
+  it('serves them through the adapter with people on every meeting', async () => {
+    const { api } = apiOver();
+    const page = await api.listDocuments({ page: 1 });
+    const weekly = page.results.find((document) => document.sourceRef === 'not_1d3tmYTlCICgjy')!;
+
+    expect(weekly.participants.map((party) => party.name)).toEqual([
+      'Dana Reed', 'Sam Ortiz', 'Kim Li', 'Acme Robotics',
+    ]);
+    expect(weekly.sourceLabel).toBe('Granola');
+  });
+});
+
+describe('the tenant’s filters are still not honoured, and are still not faked', () => {
+  it('reports search as unapplied because the entities endpoint ignores it', async () => {
+    const { api, requests } = apiOver();
+    const page = await api.listDocuments({ search: 'SAML', page: 1 });
+
+    // The parameter IS sent — the day the API learns it, nothing here changes.
+    expect(requests[0].params.search).toBe('SAML');
+    expect(page.appliedFilters).toEqual([]);
+    expect(page.count).toBe(FIXTURE_TENANT_DOCUMENTS.length);
+  });
+});

package/src/__tests__/corpus-tracker.test.tsx

@@ -0,0 +1,250 @@
+/**
+ * THE TRACKING SURFACE, rendered (bd startsim-768w.38.25).
+ *
+ * The screen makes one claim — "this is what is still owed" — and every case
+ * below is a way that claim could be false on screen while the data underneath
+ * is fine: a closed item shown as outstanding, an item with no owner rendered
+ * as though it had one, a filter that did nothing, a row with no traceable
+ * source, a run that closed something and did not say why.
+ */
+import { render, screen, within } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { describe, expect, it, vi } from 'vitest';
+
+import { TrackerPage } from '../components/pages/TrackerPage';
+import type {
+  Commitment,
+  CommitmentQuery,
+  CommitmentTrackerApi,
+  CorpusPage,
+} from '../corpus/types';
+
+const NOW = Date.parse('2026-08-10T12:00:00Z');
+const SCOPE = { orgId: 'tandem' };
+
+function commitment(overrides: Partial<Commitment> & { externalId: string; title: string }): Commitment {
+  return {
+    id: overrides.externalId,
+    dedupeKey: overrides.externalId.replace('commit:', ''),
+    subtype: 'action',
+    detail: '',
+    status: 'open',
+    subjectKey: '',
+    actionKey: '',
+    mentions: [
+      {
+        documentId: 'doc_1',
+        originKey: 'rules:x',
+        occurredAt: '2026-08-01T15:00:00Z',
+        quote: 'Status in the system reads "comments received", which is misleading.',
+        extractor: 'rules',
+      },
+    ],
+    firstSeenAt: '2026-08-01T15:00:00Z',
+    lastSeenAt: '2026-08-01T15:00:00Z',
+    extractorVersion: 'rules+model@1',
+    source: 'granola',
+    sourceLabel: 'Granola',
+    scope: SCOPE,
+    ...overrides,
+  };
+}
+
+const ROWS: Commitment[] = [
+  commitment({ externalId: 'commit:open1', title: 'Chase the inventor for comments on 2148', ownerName: 'Rae' }),
+  commitment({
+    externalId: 'commit:overdue1',
+    title: 'Send the equity sheet to Harry Holcomb',
+    dueAt: '2026-08-05T00:00:00Z',
+  }),
+  commitment({
+    externalId: 'commit:done1',
+    title: 'File the PCT for 2205',
+    status: 'done',
+    statusReason: '2205: filed as first PCT on June 25; already complete',
+    resolvedBy: 'doc_9',
+    resolvedAt: '2026-08-08T00:00:00Z',
+    lastSeenAt: '2026-08-08T00:00:00Z',
+  }),
+];
+
+function makeApi(options: {
+  rows?: Commitment[];
+  appliedFilters?: string[];
+  onQuery?: (query: CommitmentQuery) => void;
+  extract?: CommitmentTrackerApi['extract'];
+} = {}): CommitmentTrackerApi {
+  const rows = options.rows ?? ROWS;
+  return {
+    async listCommitments(query: CommitmentQuery = {}): Promise<CorpusPage<Commitment>> {
+      options.onQuery?.(query);
+      // Deliberately returns EVERYTHING, like the tenant API does today: the
+      // screen has to be correct against a server that ignores the filters.
+      return {
+        count: rows.length,
+        next: null,
+        previous: null,
+        results: rows,
+        appliedFilters: options.appliedFilters ?? [],
+      };
+    },
+    ...(options.extract ? { extract: options.extract } : {}),
+  };
+}
+
+describe('TrackerPage — what is outstanding', () => {
+  it('shows open items and hides closed ones', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+
+    expect(await screen.findByText('Chase the inventor for comments on 2148')).toBeInTheDocument();
+    expect(screen.getByText('Send the equity sheet to Harry Holcomb')).toBeInTheDocument();
+    // The one thing this screen must never do: present finished work as owed.
+    expect(screen.queryByText('File the PCT for 2205')).not.toBeInTheDocument();
+  });
+
+  it('sends the status and window as SERVER parameters', async () => {
+    const queries: CommitmentQuery[] = [];
+    render(<TrackerPage api={makeApi({ onQuery: (query) => queries.push(query) })} scope={SCOPE} now={NOW} />);
+    await screen.findByText('Chase the inventor for comments on 2148');
+
+    expect(queries[0].status).toEqual(['open', 'blocked']);
+    expect(queries[0].pageSize).toBe(200);
+  });
+
+  it('says so when the data API does not honour the filters', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    // The Library's `appliedFilters` contract, owed here about status — a
+    // status filter that silently does nothing breaks the screen's only claim.
+    expect(
+      await screen.findByText(/does not filter by .*status/i),
+    ).toBeInTheDocument();
+  });
+
+  it('does NOT nag when the API reports it applied them', async () => {
+    render(
+      <TrackerPage
+        api={makeApi({ appliedFilters: ['status', 'owner', 'dueBefore', 'changedAfter'] })}
+        scope={SCOPE}
+        now={NOW}
+      />,
+    );
+    await screen.findByText('Chase the inventor for comments on 2148');
+    expect(screen.queryByText(/does not filter by/i)).not.toBeInTheDocument();
+  });
+
+  it('puts an overdue item above one with no due date', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    await screen.findByText('Chase the inventor for comments on 2148');
+    const titles = screen.getAllByRole('article').map((node) => within(node).getByRole('heading').textContent);
+    expect(titles[0]).toBe('Send the equity sheet to Harry Holcomb');
+  });
+
+  it('says an item is overdue, with the date', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    expect(await screen.findByText(/Overdue/)).toBeInTheDocument();
+  });
+
+  it('says how long something has been open, which is the point of the screen', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    // Raised 2026-08-01, read 2026-08-10 — nine calendar days, eight elapsed.
+    expect(await screen.findAllByText(/open for 8 days/)).not.toHaveLength(0);
+  });
+
+  it('states that nobody was named rather than rendering a blank', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    // "Nobody said who owns this" is a fact about the meeting, and it is the
+    // most actionable thing on the screen. A blank cell hides it.
+    expect(await screen.findByText('No owner named')).toBeInTheDocument();
+    expect(screen.getByText('Rae')).toBeInTheDocument();
+  });
+
+  it('renders every row with the meeting it came from and a verbatim quote', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    await screen.findByText('Chase the inventor for comments on 2148');
+    for (const article of screen.getAllByRole('article')) {
+      expect(within(article).getByText(/From 1 meeting/)).toBeInTheDocument();
+      expect(within(article).getByText(/Status in the system reads/)).toBeInTheDocument();
+    }
+  });
+
+  it('shows the closed tab with the sentence that closed it', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    await screen.findByText('Chase the inventor for comments on 2148');
+    await userEvent.click(screen.getByRole('tab', { name: 'Closed' }));
+
+    expect(await screen.findByText('File the PCT for 2205')).toBeInTheDocument();
+    // "Why does it say this is done" has to be answerable without opening the
+    // meeting, or nobody trusts a single closed row.
+    expect(screen.getByText(/Closed by: .*filed as first PCT/)).toBeInTheDocument();
+  });
+
+  it('filters by owner', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    await screen.findByText('Chase the inventor for comments on 2148');
+    await userEvent.type(screen.getByPlaceholderText('Owner'), 'Rae');
+
+    expect(screen.getByText('Chase the inventor for comments on 2148')).toBeInTheDocument();
+    expect(screen.queryByText('Send the equity sheet to Harry Holcomb')).not.toBeInTheDocument();
+  });
+
+  it('tells a fresh workspace what to do instead of showing an empty page', async () => {
+    render(<TrackerPage api={makeApi({ rows: [] })} scope={SCOPE} now={NOW} />);
+    expect(await screen.findByText(/Nothing has been pulled out of your meetings yet/)).toBeInTheDocument();
+  });
+});
+
+describe('TrackerPage — running the extraction', () => {
+  const RESULT = {
+    documentsProcessed: 16,
+    fromRules: 24,
+    fromModel: 11,
+    created: 30,
+    merged: 5,
+    resolved: 2,
+    needsReview: [{ commitmentId: 'commit:open1', documentId: 'doc_4', quote: '2148 came back from the inventor' }],
+    droppedOutOfScope: 0,
+    provider: { provider: 'anthropic', model: 'claude-sonnet-4-6', live: true },
+  };
+
+  it('reports what the run did, and what the MODEL added over the rules', async () => {
+    const extract = vi.fn(async () => RESULT);
+    render(<TrackerPage api={makeApi({ extract })} scope={SCOPE} now={NOW} />);
+    await screen.findByText('Chase the inventor for comments on 2148');
+    await userEvent.click(screen.getByRole('button', { name: 'Pull from meetings' }));
+
+    expect(extract).toHaveBeenCalledWith({ scope: SCOPE });
+    expect(await screen.findByText(/Read 16 meetings/)).toBeInTheDocument();
+    // The measurement of whether the model call is worth paying for, on screen.
+    expect(screen.getByText(/24 came from the meetings’ own next-step lists, 11 were read/)).toBeInTheDocument();
+    expect(screen.getByText(/anthropic · claude-sonnet-4-6/)).toBeInTheDocument();
+  });
+
+  it('surfaces weak resolution matches instead of quietly closing things', async () => {
+    render(<TrackerPage api={makeApi({ extract: async () => RESULT })} scope={SCOPE} now={NOW} />);
+    await screen.findByText('Chase the inventor for comments on 2148');
+    await userEvent.click(screen.getByRole('button', { name: 'Pull from meetings' }));
+
+    expect(await screen.findByText(/Nothing was closed automatically/)).toBeInTheDocument();
+    expect(screen.getByText(/2148 came back from the inventor/)).toBeInTheDocument();
+  });
+
+  it('reports a leaking data API rather than absorbing it', async () => {
+    render(
+      <TrackerPage
+        api={makeApi({ extract: async () => ({ ...RESULT, droppedOutOfScope: 3 }) })}
+        scope={SCOPE}
+        now={NOW}
+      />,
+    );
+    await screen.findByText('Chase the inventor for comments on 2148');
+    await userEvent.click(screen.getByRole('button', { name: 'Pull from meetings' }));
+
+    expect(await screen.findByText(/3 records from another\s+workspace were returned/)).toBeInTheDocument();
+  });
+
+  it('hides the control entirely on a read-only deployment', async () => {
+    render(<TrackerPage api={makeApi()} scope={SCOPE} now={NOW} />);
+    await screen.findByText('Chase the inventor for comments on 2148');
+    expect(screen.queryByRole('button', { name: 'Pull from meetings' })).not.toBeInTheDocument();
+  });
+});