feat(documents): reframe indexing as automatic and make Read with AI prominent

Auto-index on upload means content search is silent-by-default, so the old
per-document index chore no longer reads as a task. Consolidate every AI
reading action into one inviting block on the detail sheet, led by a
prominent Read with AI action, and show each document's searchable status as
a pill that distinguishes an AI-read document from a locally-indexed one.

- New Read-with-AI block: prominent read/re-read action plus suggest and
  session-only summary, gated on provider availability; the calm settings
  pointer replaces the actions (never an error) when no provider is set up.
- Searchable status pill reflects the auto-index: Read by AI (provider read
  the original, highlighted), Searchable (local), or a quiet not-yet state.
- Card searchable marker distinguishes an AI-read document with a Sparkles
  glyph from a locally-indexed one; both carry an accessible label.
- Drop the manual index/re-index chore copy; keep the corpus baseline
  affordance in the filter bar for older un-indexed documents.
This commit is contained in:
Marc-André Bombeck committed 2026-07-08 21:25:15 +02:00
1 parent bb0ebb1dce
commit 11fd48cc0e
13 files changed
+431 -205

No files matched your search

@@ -6,7 +6,7 @@ import type { DocumentSuggestionDto } from "@/lib/validations/inbound-documents"
import {
AiUnavailableHint,
AssistSuggestionReview,
ContentIndexStatus,
ContentSearchStatus,
DocumentSummaryPanel,
} from "../document-ai-panels";
@@ -175,25 +175,47 @@ describe("<DocumentSummaryPanel>", () => {
});
});
describe("<ContentIndexStatus>", () => {
it("offers indexing when the document is not yet searchable", () => {
describe("<ContentSearchStatus>", () => {
it("shows a calm not-searchable-yet pill before the auto-index lands", () => {
const html = render(
<ContentIndexStatus
<ContentSearchStatus
hasContentIndex={false}
source={null}
isPending={false}
onIndex={noop}
/>,
);
expect(html).toContain('data-slot="content-index-status"');
expect(html).toContain("Contents not searchable yet");
expect(html).toContain("Index for search");
expect(html).toContain('data-slot="content-search-status"');
expect(html).toContain('data-state="none"');
expect(html).toContain("Not searchable yet");
// A status, never a chore button.
expect(html).not.toContain("<button");
});
it("offers a re-index when the document is already searchable", () => {
const html = render(
<ContentIndexStatus hasContentIndex isPending={false} onIndex={noop} />,
it("highlights an AI-read document distinctly from a locally-indexed one", () => {
const aiRead = render(
<ContentSearchStatus hasContentIndex source="vision" isPending={false} />,
);
expect(html).toContain("Contents searchable");
expect(html).toContain("Re-index");
expect(aiRead).toContain('data-state="ai-read"');
expect(aiRead).toContain("Read by AI");
expect(aiRead).toContain("text-primary");
const local = render(
<ContentSearchStatus
hasContentIndex
source="local-pdf"
isPending={false}
/>,
);
expect(local).toContain('data-state="searchable"');
expect(local).toContain("Searchable");
expect(local).not.toContain("Read by AI");
});
it("reflects a running read as an indexing state", () => {
const html = render(
<ContentSearchStatus hasContentIndex={false} source={null} isPending />,
);
expect(html).toContain('data-state="indexing"');
expect(html).toContain("Making searchable…");
});
});
@@ -6,10 +6,11 @@ import type { DocumentSuggestionDto } from "@/lib/validations/inbound-documents"
import { DocumentAiSection } from "../document-ai-section";
/**
* The detail sheet's AI area is availability-gated: with a provider it shows the
* assist / summary toolbar; without one it shows ONLY the calm settings pointer
* (never an action the endpoint would 422). The summary panel, when open, keeps
* the session-only note visible.
* The detail sheet's "Read with AI" block is availability-gated: with a provider
* it offers the prominent "Read with AI" action alongside suggest / summary;
* without one the actions collapse to the calm settings pointer (never an action
* the endpoint would 422). The searchable status pill reflects the auto-index in
* both states. The summary panel, when open, keeps the session-only note visible.
*/
function render(node: React.ReactNode) {
@@ -52,6 +53,7 @@ function base(
summaryErrorKey: null,
onCloseSummary: noop,
hasContentIndex: false,
contentIndexSource: null,
indexPending: false,
onIndex: noop,
...overrides,
@@ -60,25 +62,59 @@ function base(
}
describe("<DocumentAiSection>", () => {
it("offers the assist + summary toolbar when a provider is available", () => {
it("leads with the prominent Read-with-AI action when a provider is available", () => {
const html = render(base({ aiEnabled: true }));
expect(html).toContain('data-slot="document-read-ai"');
expect(html).toContain("Read with AI");
expect(html).toContain('data-slot="assist-suggest"');
expect(html).toContain("Suggest details");
expect(html).toContain("Summarise");
expect(html).toContain("Show extracted text");
// No unavailable pointer when the affordance is offered.
// No unavailable pointer when the actions are offered.
expect(html).not.toContain('data-slot="assist-unavailable"');
});
it("shows ONLY the calm settings pointer when no provider is available", () => {
it("labels the action as a re-read once a provider has already read it", () => {
const html = render(
base({ aiEnabled: false, unavailableReason: "no-provider" }),
base({ hasContentIndex: true, contentIndexSource: "vision" }),
);
expect(html).toContain('data-slot="document-read-ai"');
expect(html).toContain("Read again");
// The status pill reflects the AI-read provenance.
expect(html).toContain('data-state="ai-read"');
expect(html).toContain("Read by AI");
});
it("shows the calm settings pointer (no 422 actions) when no provider is available", () => {
const html = render(
base({
aiEnabled: false,
indexEnabled: false,
unavailableReason: "no-provider",
}),
);
expect(html).toContain('data-slot="assist-unavailable"');
expect(html).toContain('href="/settings/ai"');
// The assist / index actions must be absent — never a 422-guaranteed tap.
// Every AI action must be absent — never a 422-guaranteed tap.
expect(html).not.toContain('data-slot="assist-suggest"');
expect(html).not.toContain('data-slot="content-index-status"');
expect(html).not.toContain('data-slot="document-read-ai"');
// But the searchable status pill still renders — auto-index is honest here.
expect(html).toContain('data-slot="content-search-status"');
});
it("keeps a locally-indexed document honestly searchable without a provider", () => {
const html = render(
base({
aiEnabled: false,
indexEnabled: false,
unavailableReason: "no-provider",
hasContentIndex: true,
contentIndexSource: "local-pdf",
}),
);
expect(html).toContain('data-state="searchable"');
expect(html).toContain("Searchable");
expect(html).not.toContain("Read by AI");
});
it("renders the reviewed suggestion drafts when present", () => {
@@ -106,9 +142,9 @@ describe("<DocumentAiSection>", () => {
expect(html).toContain("Not saved");
});
it("hides the content-index row when indexing is unavailable", () => {
it("hides the Read-with-AI action when indexing is unavailable but keeps suggest", () => {
const html = render(base({ aiEnabled: true, indexEnabled: false }));
expect(html).toContain('data-slot="assist-suggest"');
expect(html).not.toContain('data-slot="content-index-status"');
expect(html).not.toContain('data-slot="document-read-ai"');
});
});
@@ -96,9 +96,25 @@ describe("<DocumentCard>", () => {
/>,
);
expect(html).toContain('data-slot="document-searchable"');
expect(html).toContain('data-source="local"');
expect(html).toContain("Contents searchable");
});
it("marks an AI-read document with the highlighted read-by-AI badge", () => {
const html = render(
<DocumentCard
document={doc({ hasContentIndex: true, contentIndexSource: "vision" })}
selected={false}
onToggleSelected={noop}
onOpen={noop}
highlighted={false}
/>,
);
expect(html).toContain('data-source="ai-read"');
expect(html).toContain("Read by AI");
expect(html).toContain("text-primary");
});
it("shows no searchable marker when the document is not indexed", () => {
const html = render(
<DocumentCard