@anchrd/intel-ui 0.46.0 → 0.48.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anchrd/intel-ui",
-  "version": "0.46.0",
+  "version": "0.48.0",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {
@@ -33,7 +33,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@anchrd/intel-contract": "^0.25.0",
+    "@anchrd/intel-contract": "^0.27.0",
     "@blocknote/core": "^0.52.1",
     "@blocknote/react": "^0.52.1",
     "@blocknote/shadcn": "^0.52.1",

package/src/app/user-footer/user-footer.tsx

@@ -3,6 +3,7 @@ import { useNavigate, useRouterState } from "@tanstack/react-router";
 import {
   Archive as ArchiveIcon,
   ChevronsUpDown,
+  List,
   LogOut,
   RefreshCw,
   Settings,
@@ -113,6 +114,14 @@ export function UserFooter() {
               <Wrench aria-hidden="true" />
               {i18n.t("nav.tools")}
             </DropdownMenuItem>
+            {/* ⚠️ The feed lives here and NOT in the tree, and the placement is the decision
+                (#742): it is not a place things are in, and it is not something anybody needs
+                twice a day. No counter and no dot on the icon either — a badge is a request for
+                attention, and this surface is deliberately not making one. */}
+            <DropdownMenuItem onSelect={() => void navigate({ to: "/feed" })}>
+              <List aria-hidden="true" />
+              {i18n.t("feed.title")}
+            </DropdownMenuItem>
             {/* The archive lives here rather than in the tree: it is not a place things are IN,
                 it is where they went when they left the tree (#113). */}
             <DropdownMenuItem onSelect={() => void navigate({ to: "/archive" })}>

package/src/archive/archive.tsx

@@ -26,7 +26,11 @@ interface ArchivedEntry {
   // Both sides of the tree can be purged (#457) — each through its own door, because node and flow
   // stay separate everywhere else (ADR-0004).
   purge(): Promise<{ purged: true; title: string }>;
-  previewPurge?(): Promise<{ inboundLinks: number; totalItems: number }>;
+  previewPurge?(): Promise<{
+    inboundLinks: number;
+    totalItems: number;
+    items: Array<{ id: string; title: string }>;
+  }>;
 }
 
 /**
@@ -179,6 +183,8 @@ export function Archive() {
   // that it does not come back. The state lives here because the row underneath disappears the
   // moment the purge goes through.
   const [confirming, setConfirming] = useState<ArchivedEntry | null>(null);
+  // Whether anything has scrolled away under the header. See the header markup for why.
+  const [scrolled, setScrolled] = useState(false);
   const preview = useQuery({
     queryKey: ["purge-preview", confirming?.id],
     queryFn: async () => await confirming?.previewPurge?.(),
@@ -202,13 +208,37 @@ export function Archive() {
 
   return (
     <div className="flex min-h-0 flex-1 flex-col">
-      <div className="border-b px-6 py-4">
+      {/* ⚠️ The rule below the header belongs to the SCROLL STATE, not to the header. While nothing
+          has scrolled away, it separates a heading from the content that heading is about, which is
+          a line drawn for no reason. It earns its place the moment content slides underneath.
+
+          The width is set from the start and only the COLOUR changes. Adding the border on scroll
+          would grow the header by one pixel at that moment and shove the whole list down — visible,
+          and exactly at the point where the eye is already following movement (#741).
+
+          ⚠️ `motion-reduce:transition-none` is not decoration. Nothing in this repository disarms a
+          colour transition for a reader who asked for less movement — there is no global
+          `prefers-reduced-motion` rule in the stylesheets — so a fade added here would run for them
+          too unless it says otherwise. The line still appears either way; only the fade is dropped. */}
+      <div
+        data-slot="pane-header"
+        className={cn(
+          "border-b border-transparent px-6 py-4 transition-colors motion-reduce:transition-none",
+          scrolled && "border-border",
+        )}
+      >
         <h1 className="text-lg font-medium text-foreground">{i18n.t("archive.title")}</h1>
         <p className="mt-1 max-w-prose text-sm text-muted-foreground">
           {i18n.t("archive.description")}
         </p>
       </div>
-      <div className="min-h-0 flex-1 overflow-y-auto px-6 py-4">
+      <div
+        data-slot="pane-body"
+        // Reading the position off the event rather than holding a ref: React skips the re-render
+        // when the boolean has not changed, so a scroll of 400 pixels still costs one render.
+        onScroll={(event) => setScrolled(event.currentTarget.scrollTop > 0)}
+        className="min-h-0 flex-1 overflow-y-auto px-6 py-4"
+      >
         {archived.isError ? (
           <p role="alert" className="text-sm text-destructive">
             {i18n.t("archive.failed")}
@@ -315,6 +345,23 @@ export function Archive() {
           {confirming.previewPurge && preview.data ? (
             <div className="mt-2 space-y-2 text-sm text-muted-foreground">
               <p>{i18n.t("archive.purge.items", { count: preview.data.totalItems })}</p>
+              {/* ⚠️ The names, not only the number (D71, #733): what is confirmed here cannot be
+                  undone, and "82 items" is not something a person can decide about. The list the
+                  API sends is capped, so whatever it does not carry is counted out loud. */}
+              {preview.data.items.length > 0 ? (
+                <ul className="max-h-40 list-disc overflow-y-auto pl-5">
+                  {preview.data.items.map((entry) => (
+                    <li key={entry.id}>{entry.title}</li>
+                  ))}
+                </ul>
+              ) : null}
+              {preview.data.totalItems > preview.data.items.length ? (
+                <p>
+                  {i18n.t("archive.purge.items.more", {
+                    count: preview.data.totalItems - preview.data.items.length,
+                  })}
+                </p>
+              ) : null}
               <p>
                 {preview.data.inboundLinks === 0
                   ? i18n.t("archive.purge.links.none")

package/src/board/board-kanban/board-kanban.tsx

@@ -77,7 +77,14 @@ function Card({
         onClick={() => onOpen(card.id)}
         // `relative` and `overflow-hidden` are for the depth pattern: it is positioned against this
         // card, and nothing of it may spill past the rounded edge.
-        className="relative w-full cursor-grab overflow-hidden rounded-md border border-border bg-card p-2 text-left text-sm shadow-xs focus-visible:outline-2 focus-visible:outline-ring"
+        /* ⚠️ A quiet grey FIELD, not a box (#748). It carried `bg-card` plus `border-border` plus
+             `shadow-xs` — three means saying the same thing ("this is a card"), and on a white board
+             the three together read as a container rather than a surface. `bg-muted` is 0.97 against
+             a 1.0 ground in light and 0.269 against 0.145 in dark, so the card stands off its column
+             in both without a line around it.
+             ⚠️ The hover is what replaces the border: a surface still has to answer the pointer, and
+             without a line there is nothing else left to do it. */
+        className="relative w-full cursor-grab overflow-hidden rounded-md bg-muted p-2 text-left text-sm transition-colors hover:bg-muted/70 focus-visible:outline-2 focus-visible:outline-ring"
         onKeyDown={(event) => {
           // ⚠️ Not while a write is in flight. Two moves in quick succession both read the same
           // not-yet-updated `board.columns`, compute a position independently and both write — the
@@ -585,7 +592,11 @@ export function BoardKanban({
           cursor moves, and there is nothing on screen saying the gesture was picked up at all. */}
       <DragOverlay>
         {carriedCard === undefined ? null : (
-          <div className="w-64 rounded-md border border-border bg-card p-2 text-left text-sm shadow-lg">
+          <div /* ⚠️ The same surface as the card it stands for (#748), plus the shadow that is the ONE
+              thing this element says beyond it: this one is lifted. A card that changed colour on
+              being picked up would read as a different card. */
+            className="w-64 rounded-md bg-muted p-2 text-left text-sm shadow-lg"
+          >
             {carriedCard.title}
           </div>
         )}

package/src/board/board-task/board-task.tsx

@@ -2,7 +2,6 @@ import type { BoardTask } from "@anchrd/intel-contract/board";
 import { Lock, Plus, Square, SquareCheck } from "lucide-react";
 import { useState } from "react";
 import { AssigneeChip } from "@/board/board-assignee/board-assignee.tsx";
-import { AssigneePicker } from "@/board/board-assignee/board-assignee-picker.tsx";
 import { BoardChip } from "@/board/board-chip/board-chip.tsx";
 import type { BoardHandle } from "@/board/board-data/board-data.types.ts";
 import { DatesChip } from "@/board/board-dates/board-dates.tsx";
@@ -122,17 +121,21 @@ export function BoardTaskDocument({
           />
         ))}
 
-        <Adder task={task} board={board} write={write} />
+        {/* ⚠️ **The last VALUE, and the plus comes after it** (#750, Jack's decision 2026-08-22). It
+            is the only round element in the row; standing between the chips it breaks the line. But
+            the plus is not a value, it is the control that adds one, and a control belongs behind
+            everything it can add to.
 
-        {/* ⚠️ **Last, always, and after the plus** (#724). It is the only round element in the row;
-            standing between the chips it breaks the line. And it is drawn even when nobody has the
-            card: an empty circle is the one control on a row that says the card COULD be given to
-            somebody, which is precisely what an unowned card needs. */}
+            ⚠️ Drawn even when nobody has the card: an empty circle is the one control on the row
+            that says the card COULD be given to somebody, which is precisely what an unowned card
+            needs (#724). */}
         <AssigneeChip
           id={task.assigneeId}
           boardId={board.boardId}
           onPick={(assigneeId) => write({ assigneeId })}
         />
+
+        <Adder task={task} board={board} write={write} />
       </div>
 
       {/* ⚠️ ONE list, not three blocks: the icon carries the kind. And it exists only when there is
@@ -178,10 +181,11 @@ export function BoardTaskDocument({
  * is no list to choose from anywhere in the data provider. An entry that opens nothing is worse than
  * a missing one, because it looks like the feature is there (`#700`).
  */
-// ⚠️ `assignee` is first, and that is Jacks Vorgabe 2026-08-21 read back into the menu: on a card
-// the assignee chip stands LAST so the round element does not break the row, while in the menu the
-// most-used entry stands first. The two orders answer different questions and are not a mismatch.
-const addable = ["assignee", "label", "start", "due"] as const;
+// ⚠️ **No `assignee` here** (#750). It stood first once, back when the circle was drawn only for
+// somebody and an unowned card had nothing to press. Since #724 the circle is always there and opens
+// the same picker, so an entry here would be a second way to the same thing, two lines apart — and
+// the one somebody finds first would depend on where they happened to look.
+const addable = ["label", "start", "due"] as const;
 const linkable = ["subtask", "blocker"] as const;
 type Addable = (typeof addable)[number] | (typeof linkable)[number];
 
@@ -271,27 +275,7 @@ function Adder({
         </DropdownMenuContent>
       </DropdownMenu>
 
-      {kind !== "assignee" ? null : (
-        <AssigneePicker
-          boardId={board.boardId}
-          current={task.assigneeId}
-          onPick={(assigneeId) => write({ assigneeId })}
-          open
-          onOpenChange={(next) => !next && close()}
-        >
-          {/* ⚠️ The anchor. Opened from the plus menu there is nothing on screen to hang the menu
-              on, so the picker brings its own pill — the same shape the blocker branch below uses,
-              and for the same reason. */}
-          <button
-            type="button"
-            className="rounded-full border px-2.5 py-0.5 text-xs outline-none focus-visible:ring-2 focus-visible:ring-ring"
-          >
-            {i18n.t("board.add.assignee")}
-          </button>
-        </AssigneePicker>
-      )}
-
-      {kind === null || kind === "blocker" || kind === "assignee" ? null : (
+      {kind === null || kind === "blocker" ? null : (
         <input
           // biome-ignore lint/a11y/noAutofocus: it opens on a deliberate click, never on load
           autoFocus

package/src/data/intel-data-provider/intel-data-provider.ts

@@ -8,6 +8,7 @@ import {
   BoardView,
 } from "@anchrd/intel-contract/board";
 import { BundleImportResult } from "@anchrd/intel-contract/bundle";
+import { FeedListResponse } from "@anchrd/intel-contract/feed";
 import {
   ArchiveFlowInput,
   CreateFlowInput,
@@ -580,6 +581,14 @@ export function createIntelDataProvider(
         body: JSON.stringify(parsed),
       });
     },
+    async listFeed(input) {
+      // Only what was asked for travels: an empty `actor` or `before` in the query string is not
+      // the same as leaving it out, and the contract refuses the empty string.
+      const params = new URLSearchParams({ limit: String(input.limit) });
+      if (input.actor) params.set("actor", input.actor);
+      if (input.before) params.set("before", input.before);
+      return await request(`/feed?${params}`, FeedListResponse);
+    },
     async listFlowRuns(input) {
       const parsed = ListFlowRunsInput.parse(input);
       // Only what was actually asked for travels. `failedOnly` is the parameter's presence rather

package/src/data/intel-data-provider/intel-data-provider.types.ts

@@ -8,6 +8,7 @@ import type {
   BoardView,
 } from "@anchrd/intel-contract/board";
 import type { BundleImportResult } from "@anchrd/intel-contract/bundle";
+import type { FeedListResponse } from "@anchrd/intel-contract/feed";
 import type {
   ArchiveFlowInput,
   CreateFlowInput,
@@ -235,6 +236,13 @@ export interface IntelDataProvider {
   // What this flow has done, newest first, one page at a time. ⚠️ It carries what a run did and
   // never what it produced: a run reads nodes with the rights of whoever started it, so its
   // result is not automatically readable for everyone who may read the flow.
+  // The activity feed, newest first (#742). `before` is the previous answer's `nextCursor`,
+  // handed back unchanged; `actor` narrows it to one person or one agent.
+  listFeed(input: {
+    limit: number;
+    before?: string | undefined;
+    actor?: string | undefined;
+  }): Promise<FeedListResponse>;
   listFlowRuns(input: ListFlowRunsInput): Promise<FlowRunList>;
   getFlowRun(runId: string): Promise<FlowRunStep>;
   // The drill-down behind one run: every step it took, and the call chain it belongs to.

package/src/feed/feed.tsx

@@ -0,0 +1,312 @@
+import type { FeedEvent } from "@anchrd/intel-contract/feed";
+import { useInfiniteQuery, useQueries } from "@tanstack/react-query";
+import { useNavigate } from "@tanstack/react-router";
+import { Check, Filter } from "lucide-react";
+import { useEffect, useMemo, useRef, useState } from "react";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import { useI18n } from "@/i18n/i18n-context.tsx";
+import { cn } from "@/lib/utils.ts";
+import { useIntelRouterContext } from "@/router/router-context.ts";
+import { RelativeTime } from "@/time/relative-time.tsx";
+import { initials, useSessionUser } from "@/user-name/user-name.ts";
+
+const PageSize = 30;
+
+// Who to show. Only the first two reach the server; `people` is applied here because whether an
+// actor is a machine is Gate's answer and arrives with the names, not with the events.
+type Audience = "all" | "mine" | "people";
+
+/**
+ * What happened, newest first, one card per event.
+ *
+ * ⚠️ **The shape is the archive's** — a header with a rule that appears on scroll, then the
+ * scrolling area — because this is a page of the same kind and a second layout for it would be a
+ * second set of answers to "where does the title go". What differs is inside: the list is capped
+ * and centred rather than full width.
+ */
+export function Feed() {
+  const { data } = useIntelRouterContext();
+  const i18n = useI18n();
+  const me = useSessionUser();
+  const navigate = useNavigate();
+  const [audience, setAudience] = useState<Audience>("all");
+  const [scrolled, setScrolled] = useState(false);
+
+  // ⚠️ The audience belongs in the key. "Only mine" is a different question with a different
+  // answer, and sharing one cache entry would show the wrong list for a frame after the switch.
+  //
+  // ⚠️ `mine` reaches the server, `people` does not: the server has no idea which actor is a
+  // machine. Putting `people` in the key anyway would split the cache for a filter that changes
+  // nothing about the request — so it is deliberately absent from what travels.
+  const actor = audience === "mine" ? (me?.id ?? null) : null;
+  const feed = useInfiniteQuery({
+    queryKey: ["feed", actor],
+    queryFn: ({ pageParam }) =>
+      data.listFeed({
+        limit: PageSize,
+        ...(pageParam ? { before: pageParam } : {}),
+        ...(actor ? { actor } : {}),
+      }),
+    initialPageParam: null as string | null,
+    getNextPageParam: (last) => last.nextCursor,
+    // Asking with `actor: null` for "only mine" would be the whole feed, which is the opposite of
+    // what was asked for. Better to render nothing for the instant before the session arrives.
+    enabled: audience !== "mine" || me !== null,
+  });
+
+  const events = useMemo(() => feed.data?.pages.flatMap((page) => page.events) ?? [], [feed.data]);
+
+  // ⚠️ One resolve per PAGE, and PER page rather than over everything loaded so far. A page is
+  // thirty cards and often three people, so resolving a single id per card would open thirty
+  // requests for three names — that much is obvious. The half that is not: asking again for the
+  // GROWING union on every page walks straight into the contract's `max(100)` and takes the endless
+  // scroll down with a Zod error, on exactly the busy folder the feed is for.
+  //
+  // One query per page keeps every ask at most a page wide, and TanStack keeps the earlier answers
+  // rather than re-fetching them.
+  const nameQueries = useQueries({
+    queries: (feed.data?.pages ?? []).map((page) => {
+      const ids = [...new Set(page.events.map((entry) => entry.actorId))].sort();
+      return {
+        queryKey: ["feed-actor-names", ids],
+        // ⚠️ Never reached with an empty list: the contract refuses it (`min(1)`), and the refusal
+        // would surface as a broken page rather than as the empty answer it means.
+        enabled: ids.length > 0,
+        queryFn: () => data.resolveBoardAssignees(ids),
+        staleTime: 5 * 60 * 1000,
+      };
+    }),
+  });
+  // ⚠️ Built on every render rather than memoised, and the first attempt at this is why it says
+  // so: keyed on `feed.data` the map was never rebuilt when the NAMES arrived, because the pages
+  // had not changed — every card showed "a user account" for good. A few dozen entries cost
+  // nothing to rebuild, and a dependency that has to be exactly right to be correct is a worse
+  // trade than the work it saves.
+  const people = new Map<string, { name: string; isMachine: boolean }>();
+  for (const query of nameQueries) {
+    for (const person of query.data?.items ?? []) {
+      people.set(person.id, { name: person.name, isMachine: person.isMachine });
+    }
+  }
+
+  // ⚠️ Filtering people out here can empty a whole page while older ones still hold cards, so the
+  // sentinel below has to keep asking rather than stopping at the first empty result.
+  const shown =
+    audience === "people"
+      ? events.filter((event) => people.get(event.actorId)?.isMachine !== true)
+      : events;
+
+  const sentinel = useRef<HTMLDivElement | null>(null);
+  useEffect(() => {
+    const element = sentinel.current;
+    if (!element) return;
+    const observer = new IntersectionObserver((entries) => {
+      // `hasNextPage` and `isFetchingNextPage` are read inside the callback rather than closed over
+      // at setup: the observer outlives several renders, and a stale `false` would end the scroll
+      // silently at whatever page happened to be loaded when it was created.
+      if (entries.some((entry) => entry.isIntersecting)) void feed.fetchNextPage();
+    });
+    observer.observe(element);
+    return () => observer.disconnect();
+  }, [feed.fetchNextPage]);
+
+  return (
+    <div className="flex min-h-0 flex-1 flex-col">
+      {/* The rule belongs to the scroll state, and the width is set from the start so that showing
+          it moves nothing (#741). */}
+      <div
+        data-slot="pane-header"
+        className={cn(
+          "flex items-start justify-between gap-4 border-b border-transparent px-6 py-4 transition-colors motion-reduce:transition-none",
+          scrolled && "border-border",
+        )}
+      >
+        <div>
+          <h1 className="text-lg font-medium text-foreground">{i18n.t("feed.title")}</h1>
+          <p className="mt-1 max-w-prose text-sm text-muted-foreground">
+            {i18n.t("feed.description")}
+          </p>
+        </div>
+        <DropdownMenu>
+          <DropdownMenuTrigger
+            aria-label={i18n.t("feed.filter")}
+            className="rounded-md p-1 text-muted-foreground outline-none hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring"
+          >
+            <Filter aria-hidden="true" className="size-4" />
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end">
+            <DropdownMenuLabel>{i18n.t("feed.filter")}</DropdownMenuLabel>
+            {(["all", "mine", "people"] as const).map((option) => (
+              <DropdownMenuItem
+                key={option}
+                onSelect={() => setAudience(option)}
+                className="gap-2"
+                data-slot={`feed-audience-${option}`}
+                aria-current={audience === option}
+              >
+                <Check
+                  aria-hidden="true"
+                  className={cn("size-4", audience !== option && "invisible")}
+                />
+                {i18n.t(`feed.audience.${option}`)}
+              </DropdownMenuItem>
+            ))}
+          </DropdownMenuContent>
+        </DropdownMenu>
+      </div>
+
+      <div
+        data-slot="pane-body"
+        onScroll={(event) => setScrolled(event.currentTarget.scrollTop > 0)}
+        className="min-h-0 flex-1 overflow-y-auto px-6 py-4"
+      >
+        <div className="mx-auto max-w-3xl">
+          {feed.isPending && (
+            <p className="text-sm text-muted-foreground">{i18n.t("common.loading")}</p>
+          )}
+          {feed.isError && (
+            <div role="alert" className="space-y-3 text-sm">
+              <p className="text-destructive">{i18n.t("feed.failed")}</p>
+              <button
+                type="button"
+                onClick={() => void feed.refetch()}
+                className="rounded-md border px-3 py-2 outline-none hover:bg-muted focus-visible:ring-2 focus-visible:ring-ring"
+              >
+                {i18n.t("common.retry")}
+              </button>
+            </div>
+          )}
+          {feed.data && shown.length === 0 && (
+            <div className="space-y-2 text-sm text-muted-foreground">
+              <p>{i18n.t("feed.empty")}</p>
+              {/* ⚠️ Two states look identical and are not, so the second one is said out loud. A
+                  feed showing only yourself is what sharing nothing with anybody looks like, and a
+                  reader who takes it for a fault will go looking for one that is not there. */}
+              <p>{i18n.t("feed.emptyWhy")}</p>
+              {/* ⚠️ The SECOND state the ticket names, and it is not an empty list: it is a gap
+                  inside a list that looks complete. Somebody whose read access to a folder was
+                  withdrawn loses their OWN older entries from it, and without this sentence the
+                  next reader goes looking for a fault that is not there — or loosens the filter
+                  and opens the authorization while "repairing" it. */}
+              <p>{i18n.t("feed.gapWhy")}</p>
+            </div>
+          )}
+          {shown.length > 0 && (
+            <ul className="flex flex-col gap-2">
+              {shown.map((event) => (
+                <FeedCard
+                  key={event.id}
+                  event={event}
+                  person={people.get(event.actorId) ?? null}
+                  isMe={event.actorId === me?.id}
+                  open={(nodeId) => void navigate({ to: "/nodes", search: { select: nodeId } })}
+                />
+              ))}
+            </ul>
+          )}
+          {/* The end of the list, and what keeps it going. There is no button: the answer to "is
+              there more" is the cursor, and the observer above asks for it. */}
+          <div ref={sentinel} aria-hidden="true" className="h-8" />
+          {feed.isFetchingNextPage && (
+            <p className="py-2 text-center text-xs text-muted-foreground">
+              {i18n.t("common.loading")}
+            </p>
+          )}
+          {feed.data && !feed.hasNextPage && shown.length > 0 && (
+            <div className="space-y-1 py-2 text-center text-xs text-muted-foreground">
+              <p>{i18n.t("feed.end")}</p>
+              {/* The same sentence at the other end: this is where somebody notices that an older
+                  entry of their own is missing, and where the reason belongs. */}
+              <p>{i18n.t("feed.gapWhy")}</p>
+            </div>
+          )}
+        </div>
+      </div>
+    </div>
+  );
+}
+
+function FeedCard({
+  event,
+  person,
+  isMe,
+  open,
+}: {
+  event: FeedEvent;
+  person: { name: string; isMachine: boolean } | null;
+  isMe: boolean;
+  open(nodeId: string): void;
+}) {
+  const i18n = useI18n();
+  // ⚠️ Never the raw id. A person we cannot name is "a user account", which is the wording every
+  // other surface uses for the same gap (#258) — an id under a name is the question again in
+  // smaller type.
+  const who = isMe ? i18n.t("feed.you") : (person?.name ?? i18n.t("node.someUser"));
+  // What the button on this card says, and it is not always a version. A `node.save` records
+  // `{versionId, sequence}`, a `node.share` records `{principalType, verb}` — so a sharing card
+  // names the RIGHT that was granted. Both lead to the node: there is no route to a single version
+  // in this interface, and the access summary lives on the node itself (#742).
+  const sequence = typeof event.metadata.sequence === "number" ? event.metadata.sequence : null;
+  const verb = typeof event.metadata.verb === "string" ? event.metadata.verb : null;
+  const mark =
+    sequence !== null
+      ? i18n.t("feed.version", { sequence: String(sequence) })
+      : verb !== null
+        ? i18n.t(`node.verb.${verb}`)
+        : null;
+
+  return (
+    <li className="flex items-start gap-3 rounded-lg bg-muted/40 px-4 py-3">
+      <span
+        aria-hidden="true"
+        className={cn(
+          "grid size-8 shrink-0 place-items-center text-xs font-medium",
+          // A square for an agent, a circle for a person: the two are told apart before either
+          // name is read.
+          person?.isMachine
+            ? "rounded-md bg-accent text-accent-foreground"
+            : "rounded-full bg-secondary text-secondary-foreground",
+        )}
+      >
+        {initials(person?.name ?? who)}
+      </span>
+      <span className="grid min-w-0 flex-1 gap-1">
+        <span className="text-sm leading-snug">
+          {i18n.t(`feed.action.${event.action}`, { who, title: event.nodeTitle })}
+        </span>
+        <span className="flex items-center justify-between gap-3">
+          <span className="truncate text-xs text-muted-foreground">
+            {event.path.map((step) => step.title).join(" / ")}
+          </span>
+          {/* ⚠️ A button, not a label. The whole point of the mark is getting there, and a span
+              carries no focus — so the keyboard requirement could not be met by a surface that had
+              nothing to focus at all.
+
+              ⚠️ It opens the NODE in both cases. There is no route to a single version here, and
+              the access summary lives on the node; the mark still says WHICH version or WHICH
+              right the card was about, which is the part the reader came for. */}
+          {mark !== null && (
+            <button
+              type="button"
+              onClick={() => open(event.nodeId)}
+              aria-label={i18n.t("feed.open", { title: event.nodeTitle, mark })}
+              className="shrink-0 rounded bg-muted px-2 py-0.5 font-mono text-[11px] text-muted-foreground outline-none hover:bg-accent hover:text-accent-foreground focus-visible:ring-2 focus-visible:ring-ring"
+            >
+              {mark}
+            </button>
+          )}
+        </span>
+        {/* The shared component, not a second way of saying the same thing: it carries the exact
+            moment in a tooltip that is reachable by keyboard, and "19 hours ago" is not something
+            anybody translates back into a time of day. */}
+        <RelativeTime value={event.occurredAt} className="text-xs text-muted-foreground" />
+      </span>
+    </li>
+  );
+}

package/src/i18n/de.json

@@ -11,6 +11,7 @@
   "archive.purge.confirm": "Endgültig löschen",
   "archive.purge.grants": "Die Freigaben werden ebenfalls gelöscht.",
   "archive.purge.items": "Insgesamt endgültig gelöscht: {count}.",
+  "archive.purge.items.more": "Hier nicht aufgeführt: {count}.",
   "archive.purge.links.many": "{count} andere Dokumente verweisen darauf; diese Verweise werden brechen.",
   "archive.purge.links.none": "Keine anderen Dokumente verweisen darauf.",
   "archive.purge.links.one": "Ein anderes Dokument verweist darauf; dieser Verweis wird brechen.",
@@ -76,7 +77,6 @@
   "auth.signOut": "Abmelden",
   "auth.signOutFailed": "Das Abmelden ist fehlgeschlagen. Prüfe deine Verbindung und versuche es erneut.",
   "board.add": "Etwas hinzufügen",
-  "board.add.assignee": "Zuständigkeit",
   "board.add.due": "Fällig",
   "board.add.label": "Label",
   "board.add.start": "Start",
@@ -180,6 +180,27 @@
   "common.unsavedLeave": "Ohne Speichern verlassen",
   "common.unsavedStay": "Bleiben und speichern",
   "common.unsavedTitle": "Ungespeicherte Änderungen",
+  "feed.action.node.append": "{who} hat etwas an {title} angehängt",
+  "feed.action.node.archive": "{who} hat {title} archiviert",
+  "feed.action.node.create": "{who} hat {title} angelegt",
+  "feed.action.node.revoke": "{who} hat eine Freigabe für {title} entzogen",
+  "feed.action.node.save": "{who} hat {title} geändert",
+  "feed.action.node.share": "{who} hat {title} freigegeben",
+  "feed.action.node.update": "{who} hat {title} umbenannt",
+  "feed.audience.all": "Alle",
+  "feed.audience.mine": "Nur ich",
+  "feed.audience.people": "Ohne Agenten",
+  "feed.description": "Was zuletzt passiert ist, im Umfang deiner Freigaben.",
+  "feed.empty": "Hier ist noch nichts.",
+  "feed.emptyWhy": "Der Feed zeigt nur, was an Knoten passiert, die du lesen darfst. Teilst du mit niemandem eine Freigabe, stehst nur du selbst darin.",
+  "feed.end": "Das war alles.",
+  "feed.failed": "Der Feed konnte nicht geladen werden.",
+  "feed.filter": "Wen zeigen",
+  "feed.gapWhy": "Wurde dir das Leserecht auf einen Ordner entzogen, fehlen von dort auch deine eigenen älteren Einträge.",
+  "feed.open": "{title} öffnen ({mark})",
+  "feed.title": "Feed",
+  "feed.version": "v{sequence}",
+  "feed.you": "Du",
   "flow.shareUnreadable": "Diese Freigabe deckt nicht ab, was dieser Flow liest: {titles}.",
   "flow.shareUnreadableHidden": "Diese Freigabe deckt nicht alles ab, was dieser Flow liest: {count} davon kannst du nicht sehen.",
   "flow.shareUnreadableHint": "Nichts ist blockiert. Ein Lauf hält für sie schlicht an dieser Stelle an.",

package/src/i18n/en.json

@@ -11,6 +11,7 @@
   "archive.purge.confirm": "Delete for good",
   "archive.purge.grants": "Its shares will also be deleted.",
   "archive.purge.items": "Deleted for good in total: {count}.",
+  "archive.purge.items.more": "Not listed here: {count}.",
   "archive.purge.links.many": "{count} other documents link to it and those links will break.",
   "archive.purge.links.none": "No other documents link to it.",
   "archive.purge.links.one": "One other document links to it and that link will break.",
@@ -76,7 +77,6 @@
   "auth.signOut": "Sign out",
   "auth.signOutFailed": "Signing out failed. Check your connection and try again.",
   "board.add": "Add something",
-  "board.add.assignee": "Assignee",
   "board.add.due": "Due",
   "board.add.label": "Label",
   "board.add.start": "Start",
@@ -180,6 +180,27 @@
   "common.unsavedLeave": "Leave without saving",
   "common.unsavedStay": "Stay and save",
   "common.unsavedTitle": "Unsaved changes",
+  "feed.action.node.append": "{who} appended to {title}",
+  "feed.action.node.archive": "{who} archived {title}",
+  "feed.action.node.create": "{who} created {title}",
+  "feed.action.node.revoke": "{who} withdrew access to {title}",
+  "feed.action.node.save": "{who} changed {title}",
+  "feed.action.node.share": "{who} shared {title}",
+  "feed.action.node.update": "{who} renamed {title}",
+  "feed.audience.all": "Everyone",
+  "feed.audience.mine": "Only me",
+  "feed.audience.people": "Without agents",
+  "feed.description": "What happened recently, as far as your access reaches.",
+  "feed.empty": "Nothing here yet.",
+  "feed.emptyWhy": "The feed only shows what happens to nodes you may read. If you share access with nobody, only your own work appears.",
+  "feed.end": "That is everything.",
+  "feed.failed": "The feed could not be loaded.",
+  "feed.filter": "Who to show",
+  "feed.gapWhy": "If your read access to a folder was withdrawn, your own older entries from it are missing too.",
+  "feed.open": "Open {title} ({mark})",
+  "feed.title": "Feed",
+  "feed.version": "v{sequence}",
+  "feed.you": "You",
   "flow.shareUnreadable": "This grant does not cover what this flow reads: {titles}.",
   "flow.shareUnreadableHidden": "This grant does not cover everything this flow reads: {count} you cannot see.",
   "flow.shareUnreadableHint": "Nothing is blocked. A run will simply stop at that step for them.",

package/src/i18n/es.json

@@ -11,6 +11,7 @@
   "archive.purge.confirm": "Eliminar definitivamente",
   "archive.purge.grants": "Sus permisos compartidos también se eliminarán.",
   "archive.purge.items": "Eliminado definitivamente en total: {count}.",
+  "archive.purge.items.more": "No se enumeran aquí: {count}.",
   "archive.purge.links.many": "Otros {count} documentos contienen enlaces a este elemento y dejarán de funcionar.",
   "archive.purge.links.none": "Ningún otro documento contiene un enlace a este elemento.",
   "archive.purge.links.one": "Otro documento contiene un enlace a este elemento y ese enlace dejará de funcionar.",
@@ -76,7 +77,6 @@
   "auth.signOut": "Cerrar sesión",
   "auth.signOutFailed": "El cierre de sesión ha fallado. Comprueba tu conexión e inténtalo de nuevo.",
   "board.add": "Añadir algo",
-  "board.add.assignee": "Responsable",
   "board.add.due": "Vencimiento",
   "board.add.label": "Etiqueta",
   "board.add.start": "Inicio",
@@ -180,6 +180,27 @@
   "common.unsavedLeave": "Salir sin guardar",
   "common.unsavedStay": "Quedarse y guardar",
   "common.unsavedTitle": "Cambios sin guardar",
+  "feed.action.node.append": "{who} añadió algo a {title}",
+  "feed.action.node.archive": "{who} archivó {title}",
+  "feed.action.node.create": "{who} creó {title}",
+  "feed.action.node.revoke": "{who} retiró el acceso a {title}",
+  "feed.action.node.save": "{who} cambió {title}",
+  "feed.action.node.share": "{who} compartió {title}",
+  "feed.action.node.update": "{who} renombró {title}",
+  "feed.audience.all": "Todos",
+  "feed.audience.mine": "Solo yo",
+  "feed.audience.people": "Sin agentes",
+  "feed.description": "Lo que ha pasado, hasta donde llega tu acceso.",
+  "feed.empty": "Aquí todavía no hay nada.",
+  "feed.emptyWhy": "La actividad solo muestra lo que ocurre en nodos que puedes leer. Si no compartes acceso con nadie, solo aparece tu propio trabajo.",
+  "feed.end": "Eso es todo.",
+  "feed.failed": "No se pudo cargar la actividad.",
+  "feed.filter": "A quién mostrar",
+  "feed.gapWhy": "Si te retiraron el acceso de lectura a una carpeta, tus propias entradas antiguas de allí también faltan.",
+  "feed.open": "Abrir {title} ({mark})",
+  "feed.title": "Actividad",
+  "feed.version": "v{sequence}",
+  "feed.you": "Tú",
   "flow.shareUnreadable": "Este acceso no cubre lo que lee este flujo: {titles}.",
   "flow.shareUnreadableHidden": "Este acceso no cubre todo lo que lee este flujo: {count} que no puedes ver.",
   "flow.shareUnreadableHint": "No se bloquea nada. Una ejecución simplemente se detendrá en ese paso para esa persona.",

package/src/router/router.tsx

@@ -27,6 +27,12 @@ const flowsRoute = createRoute({
   validateSearch: selectionSearch,
   component: lazyRouteComponent(() => import("@/flows/flows.tsx"), "Flows"),
 });
+const feedRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/feed",
+  component: lazyRouteComponent(() => import("@/feed/feed.tsx"), "Feed"),
+});
+
 const archiveRoute = createRoute({
   getParentRoute: () => rootRoute,
   path: "/archive",
@@ -44,6 +50,7 @@ const routeTree = rootRoute.addChildren([
   nodesRoute,
   flowsRoute,
   toolsRoute,
+  feedRoute,
   archiveRoute,
 ]);