Make the buddy the tutor along the onboarding path

src/App.tsx

@@ -22,13 +22,15 @@ import { EggEffectsLayer } from "./features/easter-eggs/components/EggEffectsLay
 import { MyKnowledgeGapsProvider } from "./features/knowledge-gaps/MyKnowledgeGapsProvider";
 import { KnowledgeGapOwnerAnnouncement } from "./features/knowledge-gaps/components/KnowledgeGapOwnerAnnouncement";
 import { useScrollRestoration } from "./hooks/useScrollRestoration";
+import { useBuddyPathSync } from "./features/buddy/hooks/useBuddyPathSync";
 import { GlobalShortcuts } from "./features/shortcuts";
 
 function AppContent() {
   const { status } = useAuth();
   const { showRocketPet } = useMoments();
   const { isFocused } = useFocusMode();
   useScrollRestoration();
+  useBuddyPathSync();
 
   // Signed in at all — the shell is drawn for anyone past the login screen, onboarding included.
   // `signingOut` stays out on purpose: it is the boot script's "this load is a logout return"

src/features/attestation/types.ts

@@ -5,7 +5,7 @@ export type AttestationState = "REQUESTED" | "ACCEPTED" | "WITHDRAWN";
  * One request for a named colleague to confirm a hire's work.
  *
  * `returnedCount` is shown rather than hidden: work that took three passes is not the same as work
- * that took none, and the autonomy milestone reads exactly this number.
+ * that took none.
  */
 export interface Attestation {
   id: string;

src/features/board/components/BoardGrid.tsx

@@ -28,7 +28,6 @@ import { NoteCard } from "./NoteCard";
 import { ArrivalStepsCard } from "./ArrivalStepsCard";
 import { OpenPullRequestsCard } from "./OpenPullRequestsCard";
 import { PathStepCard } from "./PathStepCard";
-import { PathToFirstContributionCard } from "./PathToFirstContributionCard";
 import { SuggestedTasksCard } from "./SuggestedTasksCard";
 import { TaskPoolCard } from "./TaskPoolCard";
 import { BoardCardContext } from "./boardCardControls";
@@ -494,8 +493,6 @@ function BoardCardView({
   // somebody to wire one up later and wonder why nothing shows.
   const props = { card, ...shared };
   switch (card.content.kind) {
-    case "PATH_TO_FIRST_CONTRIBUTION":
-      return <PathToFirstContributionCard content={card.content} {...props} />;
     case "ARRIVAL_STEPS":
       return <ArrivalStepsCard content={card.content} {...props} />;
     case "OPEN_PULL_REQUESTS":

src/features/board/components/BoardPathWindow.tsx

@@ -15,6 +15,7 @@ import {
   type PathWindowState,
 } from "../../onboarding/pathWindow.ts";
 import { onboardingService } from "../../../services/onboardingService.ts";
+import { onBuddyPathChanged } from "../../buddy/aiBuddyBus.ts";
 
 /** What each state is called and wears. Never colour alone — every one carries a word and a glyph. */
 const STATES: Record<
@@ -78,17 +79,24 @@ export function BoardPathWindow({
   useEffect(() => {
     let cancelled = false;
 
-    void onboardingService
-      .fetchPath()
-      .then((path) => {
-        if (!cancelled) setWhere(pathWindow(path));
-      })
-      // No path, or no reaching it: the board has plenty else to show, and a strip that cannot
-      // say where somebody is should not say anything at all.
-      .catch(() => undefined);
+    const read = () =>
+      void onboardingService
+        .fetchPath()
+        .then((path) => {
+          if (!cancelled) setWhere(pathWindow(path));
+        })
+        // No path, or no reaching it: the board has plenty else to show, and a strip that cannot
+        // say where somebody is should not say anything at all.
+        .catch(() => undefined);
+
+    read();
+    // Read again when the buddy moved the path on, so the strip under the dock says where the
+    // hire now stands.
+    const unsubscribe = onBuddyPathChanged(read);
 
     return () => {
       cancelled = true;
+      unsubscribe();
     };
   }, []);
 

src/features/board/components/CardEditHistory.tsx

@@ -1,7 +1,7 @@
 import { useState } from "react";
 import { Check, ListChecks, Pencil, Undo2 } from "lucide-react";
 import { Button } from "../../../components/ui/Button";
-import { readableTitle } from "../generation/pathToCards";
+import { readableTitle } from "../layout/cardNames";
 import { useCardMarks } from "../marks/useCardMarks";
 import { Marked } from "./Marked";
 import type {

src/features/board/components/ChecklistCard.tsx

@@ -4,7 +4,7 @@ import { Button } from "../../../components/ui/Button";
 import { EmptyState } from "../../../components/ui/EmptyState";
 import { Input } from "../../../components/ui/Input";
 import { SelectionCheckbox } from "../../admin/components/SelectionCheckbox";
-import { readableTitle } from "../generation/pathToCards";
+import { readableTitle } from "../layout/cardNames";
 import { useBoardCardControls } from "./boardCardControls";
 import { BoardCardFrame } from "./BoardCardFrame";
 import { CardOriginLink } from "./CardOriginLink";
@@ -152,8 +152,8 @@ export function ChecklistCard({
   return (
     <BoardCardFrame
       icon={CheckSquare}
-      // Stripped of the marker a generated card carries: it exists so a second generation run can
-      // recognise its own work, and it is never something the hire should read.
+      // Stripped of the invisible marker a card from the retired generator still carries -- see
+      // `layout/cardNames.ts`. It is never something the hire should read.
       title={
         content.title ? (
           // A checklist's name is written by whoever made the list — the generator, or the hire
@@ -278,9 +278,8 @@ export function ChecklistCard({
           highlighted two lines has already said which part they are stuck on. */}
       <AskTheBuddy
         question={questionAboutChecklist(
-          // The readable title, for the same reason the header shows it: the marker is there so a
-          // generation run can recognise its own work, and it has no business in a sentence the
-          // hire is about to send.
+          // The readable title, for the same reason the header shows it: the marker has no
+          // business in a sentence the hire is about to send.
           content.title === null ? null : readableTitle(content.title),
           content.items.filter((item) => !item.done).length,
           marks.map((mark) => mark.text),

src/features/board/components/CurrentTaskCard.tsx

@@ -54,15 +54,7 @@ export function CurrentTaskCard({
       icon={Target}
       title="What you're working on"
       card={card}
-      subtitle={
-        hasTask
-          ? closed
-            ? "Closed where it lives"
-            : content.chosen
-              ? "You picked this one"
-              : "Handed to you as a first task"
-          : undefined
-      }
+      subtitle={hasTask ? (closed ? "Closed where it lives" : "You picked this one") : undefined}
       onDismiss={onDismiss}
       dismissing={dismissing}
     >