feat: open Calendar commitments onto Event Lineage (v2.14.0)

AGENTS.md

@@ -169,6 +169,8 @@ never a fabricated theta or a local psychometric substitute.
 Buyer Board **Weekly VOC** is an ISO-8601 week list filter (ADR 0092).
 Opening that filtered post focuses Event Lineage (ADR 0093). Do not
 invent a week, a theta, or a cutoff body.
+Opening a Calendar commitment uses the same focus path (ADR 0094). Do not
+invent a week, a theta, a cutoff body, or a CalDAV event.
 
 
 ## Tests

ARCHITECTURE.md

@@ -282,7 +282,8 @@ Keycloak issued; `src/App.tsx` renders a git-branch SVG of
 `GET /api/lineage` (click a node to open that post; `post_admin` can
 rebuild), the post list with a named Weekly VOC ISO-8601 week filter
 (ADR 0092; opening that filtered post focuses Event Lineage, ADR 0093),
-and a full detail popup: Korean
+Calendar commitments use the same Event Lineage focus path (ADR 0094), and
+the full detail popup includes Korean
 summary/key-events/R&R, VOC evidence excerpts, an Event Lineage panel
 (direct vs. indirect links; a link opens that post), the Keyman
 affiliate tree (resolved ancestors plus unresolved org roots), Keyman +

CHANGELOG.d/2.14.0-calendar-open-event-lineage.md

@@ -0,0 +1,5 @@
+# 2.14.0 Opening a Calendar commitment focuses Event Lineage
+
+Calendar names authorized commitments as current and to open one to read
+Event Lineage. That open focuses the popup Event Lineage heading. Home-list
+opens do not. No TEPP theta is invented.

CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.14.0] - 2026-08-19
+
+### Added
+
+- Opening a Calendar commitment now focuses Event Lineage and names Keyman
+  and evaluation as the next read. Calendar names authorized commitments
+  as current before that open. Home-list opens do not add that focus or
+  copy. No TEPP theta is invented. No cutoff body is invented
+  (ADR 0094 / ADR 0016).
+
 ## [2.13.0] - 2026-08-19
 
 ### Added

CLAUDE.md

@@ -78,3 +78,10 @@ ISO-8601 week stay; other VOC types and older weeks drop out. The Board
 names Event Lineage as the next read (ADR 0092). Open a remaining post:
 Event Lineage takes focus and names Keyman and evaluation next
 (ADR 0093). A home-list open does not. Do not invent a theta.
+
+## Calendar open (v2.14.0)
+
+Open Calendar. Authorized commitments are current. Open a commitment:
+Event Lineage takes focus and names Keyman and evaluation next
+(ADR 0094). A home-list open does not. Do not invent a theta or a
+CalDAV event.

docs/adr/0094-calendar-open-focuses-event-lineage.md

@@ -0,0 +1,33 @@
+# ADR 0094: Opening a Calendar commitment focuses Event Lineage
+
+- Status: Accepted
+- Date: 2026-08-19
+
+## Context
+
+Board Weekly VOC opens already focus Event Lineage (ADR 0093). Calendar is
+the other buyer destination that opens a source post from an authorized
+commitment. That open was a home-list open: the popup body appeared and
+Event Lineage did not take focus.
+
+## Decision
+
+Opening a commitment on Calendar is a `fromCalendar` open. That open reuses
+the Event Lineage focus path used by report-member and Weekly VOC opens:
+
+- Calendar names the next action: authorized commitments are current; open
+  a commitment to read Event Lineage.
+- The popup Event Lineage heading takes focus.
+- The popup names the opened post as current in Event Lineage and tells
+  the buyer to read Keyman and evaluation next.
+
+A Board home-list open does not focus Event Lineage and does not add that
+copy. A `?post=` deep link is still a home-list open.
+
+No TEPP theta is invented. No cutoff body is invented (ADR 0016). Calendar
+does not invent a CalDAV event (ADR 0038).
+
+## Consequences
+
+- Calendar, Weekly VOC, and report-member opens share one focus contract.
+- Closing the popup clears the Calendar open flag.

docs/adr/0094-internal-relation-evidence.md → docs/adr/0095-internal-relation-evidence.md

@@ -1,4 +1,4 @@
-# ADR 0094: Preserve authorized internal evidence for relation verification
+# ADR 0095: Preserve authorized internal evidence for relation verification
 
 - Status: Accepted
 - Date: 2026-08-18

frontend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "frontend",
   "private": true,
-  "version": "2.13.0",
+  "version": "2.14.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

frontend/src/App.test.tsx

@@ -1955,6 +1955,57 @@ describe("App, authenticated", () => {
     expect(screen.queryByRole("status", { name: "Event Lineage next action" })).not.toBeInTheDocument();
   });
 
+  it("does not scroll Calendar users away from Event Lineage when related evidence lands", async () => {
+    const scrolledIds: string[] = [];
+    const originalScrollIntoView = HTMLElement.prototype.scrollIntoView;
+    HTMLElement.prototype.scrollIntoView = function () {
+      scrolledIds.push(this.id);
+    };
+    try {
+      stubBackend();
+      render(<App />);
+
+      await userEvent.click(await screen.findByRole("button", { name: "Calendar" }));
+      const calendar = await screen.findByRole("region", { name: "Calendar" });
+      await userEvent.click(
+        within(calendar).getByRole("button", { name: "Open commitment for: Public post" }),
+      );
+
+      await screen.findByRole("status", { name: "Ask next action" });
+      expect(document.getElementById("post-event-lineage")).toHaveFocus();
+      expect(scrolledIds).not.toContain("post-ask");
+    } finally {
+      HTMLElement.prototype.scrollIntoView = originalScrollIntoView;
+    }
+  });
+
+  it("opening a Calendar commitment focuses Event Lineage; a home list open does not", async () => {
+    stubBackend();
+    render(<App />);
+
+    await userEvent.click(await screen.findByRole("button", { name: "Calendar" }));
+    const calendar = await screen.findByRole("region", { name: "Calendar" });
+    expect(within(calendar).getByLabelText("Next action")).toHaveTextContent(
+      "Authorized commitments are current. Open a commitment to read Event Lineage.",
+    );
+    await userEvent.click(
+      within(calendar).getByRole("button", { name: "Open commitment for: Public post" }),
+    );
+
+    await waitFor(() => expect(screen.getByText("The full body text.")).toBeInTheDocument());
+    expect(document.getElementById("post-event-lineage")).toHaveFocus();
+    expect(screen.getByRole("status", { name: "Event Lineage next action" })).toHaveTextContent(
+      "Public post is current in Event Lineage. Read Keyman and evaluation next.",
+    );
+
+    await userEvent.click(screen.getByRole("button", { name: "Close" }));
+    const board = screen.getByRole("region", { name: "Board" });
+    await userEvent.click(within(board).getByRole("button", { name: "View post: Public post" }));
+    await waitFor(() => expect(screen.getByText("The full body text.")).toBeInTheDocument());
+    expect(document.getElementById("post-event-lineage")).not.toHaveFocus();
+    expect(screen.queryByRole("status", { name: "Event Lineage next action" })).not.toBeInTheDocument();
+  });
+
   it("renders the A-100 fork as a git-style DAG, not a flat edge list", async () => {
     stubBackend();
     render(<App showLabPanels />);
@@ -2751,6 +2802,8 @@ describe("App, authenticated", () => {
     await userEvent.click(calendarButton);
 
     await waitFor(() => expect(screen.getByText("The full body text.")).toBeInTheDocument());
+    expect(document.getElementById("post-event-lineage")).not.toHaveFocus();
+    expect(screen.queryByRole("status", { name: "Event Lineage next action" })).not.toBeInTheDocument();
   });
 
   it("shows the seeded analysis run on the home page", async () => {

frontend/src/App.tsx

@@ -844,6 +844,7 @@ function KeymanPanel({
   focusTeam,
   landFirstKeyman,
   landFirstRelated,
+  landOnAsk,
   afterList,
 }: {
   postId: string;
@@ -858,6 +859,7 @@ function KeymanPanel({
   focusTeam?: { teamId: string; teamName: string } | null;
   landFirstKeyman?: boolean;
   landFirstRelated?: boolean;
+  landOnAsk?: boolean;
   afterList?: ReactNode;
 }) {
   const [related, setRelated] = useState<RelatedNode[] | null>(null);
@@ -965,13 +967,13 @@ function KeymanPanel({
   }, [accessToken, landFirstRelated, related]);
 
   useEffect(() => {
-    if (!landFirstRelated || !landedRelatedName || landedRelated === null) {
+    if (!landFirstRelated || !landOnAsk || !landedRelatedName || landedRelated === null) {
       return;
     }
     const heading = document.getElementById("post-ask");
     heading?.focus();
     heading?.scrollIntoView?.({ block: "nearest" });
-  }, [landFirstRelated, landedRelatedName, landedRelated]);
+  }, [landFirstRelated, landedRelatedName, landedRelated, landOnAsk]);
 
   useEffect(() => {
     if (!focusPerson) return;
@@ -1669,6 +1671,7 @@ function PostDetailPopup({
   liveBodyWarning,
   knowledgeCutoff,
   focusEventLineage,
+  focusAskOnLand,
   onClose,
   onSelectPost,
   onSearch,
@@ -1680,6 +1683,7 @@ function PostDetailPopup({
   liveBodyWarning?: string | null;
   knowledgeCutoff?: string | null;
   focusEventLineage?: boolean;
+  focusAskOnLand?: boolean;
   onClose: () => void;
   onSelectPost?: (postId: string) => void;
   onSearch?: (query: string) => void;
@@ -2286,6 +2290,7 @@ function PostDetailPopup({
                 focusTeam={focusTeam}
                 landFirstKeyman
                 landFirstRelated
+                landOnAsk={focusAskOnLand}
                 afterList={
                   <>
                     <EvaluationPanel
@@ -2505,6 +2510,7 @@ type SelectPostOptions = {
   knowledgeCutoff?: string;
   fromReportMember?: boolean;
   fromWeeklyVoc?: boolean;
+  fromCalendar?: boolean;
 };
 
 /**
@@ -3085,9 +3091,13 @@ function RankingsPanel({
 function CalendarPanel({
   accessToken,
   onSelectPost,
+  namedNextAction = false,
+  focusEventLineageOnSelect = false,
 }: {
   accessToken: string;
-  onSelectPost: (postId: string) => void;
+  onSelectPost: (postId: string, options?: SelectPostOptions) => void;
+  namedNextAction?: boolean;
+  focusEventLineageOnSelect?: boolean;
 }) {
   const [calendar, setCalendar] = useState<CalendarResponse | null>(null);
   const [error, setError] = useState<string | null>(null);
@@ -3107,8 +3117,13 @@ function CalendarPanel({
   const caldavNextAction = calendar.calendar_sources?.caldav_next_action;
 
   return (
-    <section className="popup-section lineage-home">
-      <h2>{t("Calendar")}</h2>
+    <section className="popup-section lineage-home" aria-labelledby="calendar-title">
+      <h2 id="calendar-title">{t("Calendar")}</h2>
+      {namedNextAction && commitments.length > 0 ? (
+        <p className="board-next-action" role="status" aria-label={t("Next action")}>
+          {t("Authorized commitments are current. Open a commitment to read Event Lineage.")}
+        </p>
+      ) : null}
       <section className="popup-section">
         <h3>{t("CalDAV events")}</h3>
         {events.length === 0 ? (
@@ -3143,7 +3158,12 @@ function CalendarPanel({
                 <button
                   className="post-list-item"
                   aria-label={`${t("Open commitment for:")} ${entry.post_title}`}
-                  onClick={() => onSelectPost(entry.post_id)}
+                  onClick={() =>
+                    onSelectPost(
+                      entry.post_id,
+                      focusEventLineageOnSelect ? { fromCalendar: true } : undefined,
+                    )
+                  }
                 >
                   <span className="ticket-title">
                     {entry.commitment_summary ?? entry.ticket_title}
@@ -3540,11 +3560,13 @@ function PostList({
   accessToken,
   showLabPanels = false,
   postIdToOpen = null,
+  postOpenFromCalendar = false,
   onPostOpened,
 }: {
   accessToken: string;
   showLabPanels?: boolean;
   postIdToOpen?: string | null;
+  postOpenFromCalendar?: boolean;
   onPostOpened?: () => void;
 }) {
   const [posts, setPosts] = useState<PostSummary[] | null>(null);
@@ -3564,6 +3586,7 @@ function PostList({
   const [landOnComparison, setLandOnComparison] = useState(false);
   const [openedFromReportMember, setOpenedFromReportMember] = useState(false);
   const [openedFromWeeklyVoc, setOpenedFromWeeklyVoc] = useState(false);
+  const [openedFromCalendar, setOpenedFromCalendar] = useState(false);
   const [corporateEntities, setCorporateEntities] = useState<CorporateEntityRef[] | null>(null);
   const [entitiesLoadError, setEntitiesLoadError] = useState<string | null>(null);
   const [totalPosts, setTotalPosts] = useState(0);
@@ -3619,20 +3642,22 @@ function PostList({
     setOpenedCutoffIso(options?.knowledgeCutoff ?? null);
     setOpenedFromReportMember(Boolean(options?.fromReportMember));
     setOpenedFromWeeklyVoc(Boolean(options?.fromWeeklyVoc));
+    setOpenedFromCalendar(Boolean(options?.fromCalendar));
   }
 
   useEffect(() => {
     if (!postIdToOpen) return;
-    selectPost(postIdToOpen);
+    selectPost(postIdToOpen, postOpenFromCalendar ? { fromCalendar: true } : undefined);
     onPostOpened?.();
-  }, [onPostOpened, postIdToOpen]);
+  }, [onPostOpened, postIdToOpen, postOpenFromCalendar]);
 
   function closeSelectedPost() {
     setSelectedPostId(null);
     setOpenedAfterCutoff(false);
     setOpenedCutoffIso(null);
     setOpenedFromReportMember(false);
     setOpenedFromWeeklyVoc(false);
+    setOpenedFromCalendar(false);
     const url = new URL(window.location.href);
     if (url.searchParams.has("post")) {
       url.searchParams.delete("post");
@@ -4116,7 +4141,8 @@ function PostList({
             openedAfterCutoff ? analysisRunOpenedBodyWarning(openedCutoffIso) : null
           }
           knowledgeCutoff={openedAfterCutoff ? openedCutoffIso : null}
-          focusEventLineage={openedFromReportMember || openedFromWeeklyVoc}
+          focusEventLineage={openedFromReportMember || openedFromWeeklyVoc || openedFromCalendar}
+          focusAskOnLand={openedFromReportMember}
           onClose={closeSelectedPost}
           onSelectPost={selectPost}
           onSearch={searchBoard}
@@ -4608,6 +4634,7 @@ export default function App({ showLabPanels = false }: { showLabPanels?: boolean
     if (typeof window === "undefined") return null;
     return new URLSearchParams(window.location.search).get("post");
   });
+  const [postOpenFromCalendar, setPostOpenFromCalendar] = useState(false);
   // Test-only compatibility for legacy analysis-panel coverage; this prop
   // never forces the panels open outside Vitest. In a real build the
   // advanced-review section (ADR 0037) is gated on PostList's own
@@ -4683,7 +4710,11 @@ export default function App({ showLabPanels = false }: { showLabPanels?: boolean
           accessToken={accessToken}
           showLabPanels={testOnlyLabPanels}
           postIdToOpen={postToOpen}
-          onPostOpened={() => setPostToOpen(null)}
+          postOpenFromCalendar={postOpenFromCalendar}
+          onPostOpened={() => {
+            setPostToOpen(null);
+            setPostOpenFromCalendar(false);
+          }}
         />
       ) : null}
       {destination === "customers" ? (
@@ -4698,8 +4729,11 @@ export default function App({ showLabPanels = false }: { showLabPanels?: boolean
       {destination === "calendar" ? (
         <CalendarPanel
           accessToken={accessToken}
+          namedNextAction
+          focusEventLineageOnSelect
           onSelectPost={(postId) => {
             setPostToOpen(postId);
+            setPostOpenFromCalendar(true);
             setDestination("board");
           }}
         />

frontend/src/i18n.test.ts

@@ -38,6 +38,7 @@ describe("i18n", () => {
     "Weekly VOC",
     "Filter by ISO week",
     "All weeks",
+    "Authorized commitments are current. Open a commitment to read Event Lineage.",
   ] as const;
 
   it("supports the five product locales", () => {