@cueloop/client 0.1.0-alpha.66 → 0.1.0-alpha.67

package/src/app-screens.tsx

@@ -1,5 +1,5 @@
-import React, { type Dispatch, type SetStateAction } from "react";
-import type { ReviewSession, VerdictKind } from "@cueloop/schema";
+import React, { useEffect, useState, type Dispatch, type SetStateAction } from "react";
+import type { DiffFileContents, ReviewSession, VerdictKind } from "@cueloop/schema";
 import { returnPaneFor } from "@cueloop/schema";
 import type { Theme } from "./theme";
 import type { Mode, TreeAsk } from "./intent-dispatch";
@@ -12,11 +12,17 @@ import type { SettingsCategory, SettingsValues } from "./components/SettingsDial
 import type { SettingsNav } from "./use-settings-dialog";
 import { CLIENT_VERSION } from "./version";
 import { ThemeProvider } from "./components/theme-context";
-import { NERD } from "./components/primitives/icons";
 import type { InboxRow } from "./components/session-tree";
 import { SettingsDialog } from "./components/SettingsDialog";
 import { CompletionOverlay } from "./components/CompletionOverlay";
-import { ThreadsSidebar } from "./components/ThreadsSidebar";
+import { InboxList } from "./components/InboxList";
+import { WelcomeSurface } from "./components/WelcomeSurface";
+import { AppShell, type ProjectPanelMode } from "./components/AppShell";
+import { EditorGrid } from "./components/EditorGrid";
+import { ProjectTreeView } from "./components/ProjectTreeView";
+import { ChangesFileTree } from "./components/ChangesColumn";
+import { FileContentsView } from "./components/FileContentsView";
+import { useChangesWorkbench } from "./use-changes-workbench";
 import { ConfirmDialog } from "./components/ConfirmDialog";
 import { PromptDialog } from "./components/PromptDialog";
 import { WalkWizard } from "./components/WalkWizard";
@@ -79,7 +85,57 @@ export function MenuChrome(props: {
   );
 }
 
-export function InboxScreen(props: {
+/** The welcome shell's Project pane: the launch repo's changed files in changes mode, its full tree otherwise. */
+function WelcomeProjectPanel({
+  mode,
+  controller,
+  onOpenFile,
+  theme,
+}: {
+  mode: ProjectPanelMode;
+  controller: ReviewController;
+  onOpenFile: (path: string) => void;
+  theme: Theme;
+}): React.ReactNode {
+  const [changes, setChanges] = useState<readonly DiffFileContents[]>([]);
+
+  useEffect(() => {
+    let alive = true;
+
+    void controller.repoChanges().then(
+      (files) => {
+        if (alive) setChanges(files);
+      },
+      () => {
+        if (alive) setChanges([]);
+      },
+    );
+
+    return () => {
+      alive = false;
+    };
+  }, [controller]);
+
+  if (mode === "changes") {
+    return <ChangesFileTree files={changes} onSelectFile={onOpenFile} theme={theme} />;
+  }
+
+  return (
+    <ProjectTreeView
+      loadFiles={() => controller.repoFiles()}
+      onSelectFile={onOpenFile}
+      theme={theme}
+    />
+  );
+}
+
+/**
+ * The shell with no thread open: the same header and Projects/Threads sidebar as
+ * the thread view, and a disposable Welcome tab in the center. There is no
+ * separate inbox screen - opening the app lands here, and picking a thread swaps
+ * the center for it. Closing the Welcome tab leaves a bare "select a thread" hint.
+ */
+export function NoThreadShell(props: {
   rows: InboxRow[];
   inboxCursor: number;
   mode: Mode;
@@ -88,58 +144,111 @@ export function InboxScreen(props: {
   setMode: Dispatch<SetStateAction<Mode>>;
   menuChrome: React.ReactNode;
   onOpenMenu: () => void;
+  /** Shared with the thread view, so picking a thread preserves the sidebar. */
+  sidebarOpen: boolean;
+  onToggleSidebar: () => void;
+  pinnedIds: ReadonlySet<string>;
+  onPin: (id: string) => void;
+  onRename: (id: string, title: string) => void;
 }): React.ReactNode {
-  const { rows, inboxCursor, mode, theme, controller, setMode, menuChrome, onOpenMenu } = props;
+  const {
+    rows,
+    inboxCursor,
+    mode,
+    theme,
+    controller,
+    setMode,
+    menuChrome,
+    onOpenMenu,
+    sidebarOpen,
+    onToggleSidebar,
+    pinnedIds,
+    onPin,
+    onRename,
+  } = props;
   const confirming = mode.type === "confirmDelete" ? mode : null;
+  // The bare-launch shell is the same four panes as a thread: the Thread pane waits in its empty state
+  // and a disposable Welcome tab rides in the Changes editor until a thread or diff is opened.
+  const workbench = useChangesWorkbench({ seed: "welcome" });
+  const openRepoFile = (path: string): void => workbench.openFile(path, "contents");
 
   return (
     <ThemeProvider theme={theme}>
-      <box
-        style={{
-          flexDirection: "column",
-          width: "100%",
-          height: "100%",
-          backgroundColor: theme.background,
-        }}
-      >
-        {/* mirrors the review header row: same box, position, and accent product
-            word, with a " · resume" separator and no Edit/Share toolbar */}
-        <box
-          style={{ flexDirection: "row", height: 2, paddingTop: 1, backgroundColor: theme.panel }}
-        >
+      <AppShell
+        sidebarOpen={sidebarOpen}
+        onToggleSidebar={onToggleSidebar}
+        onOpenMenu={onOpenMenu}
+        threadsPanel={
+          <scrollbox style={{ flexGrow: 1 }} focused={false}>
+            <InboxList
+              rows={rows}
+              cursor={inboxCursor}
+              pinnedIds={pinnedIds}
+              width={30}
+              onSelect={(id) => controller.open(id)}
+              onRequestDelete={(id, title) =>
+                setMode({ type: "confirmDelete", sessionId: id, title })
+              }
+              onPin={onPin}
+              onRename={onRename}
+              theme={theme}
+            />
+          </scrollbox>
+        }
+        threadTitle=""
+        threadPanel={
           <box
             style={{
-              height: 1,
-              backgroundColor: theme.panel,
-              paddingLeft: 1,
-              flexDirection: "row",
+              flexGrow: 1,
+              flexDirection: "column",
+              alignItems: "center",
+              justifyContent: "center",
             }}
           >
-            <box onMouseUp={onOpenMenu} style={{ paddingRight: 2 }}>
-              <text fg={theme.textMuted}>{NERD.settings}</text>
-            </box>
-            <text>
-              <span fg={theme.accent}>cueloop</span>
-              <span fg={theme.textDim}> · resume</span>
-            </text>
+            <text fg={theme.textDim}>Select a thread</text>
           </box>
-          <box style={{ flexGrow: 1 }} />
-        </box>
-        <box style={{ flexGrow: 1, flexDirection: "row" }}>
-          <ThreadsSidebar
-            open
-            rows={rows}
-            cursor={inboxCursor}
-            onSelect={(id) => controller.open(id)}
-            onRequestDelete={(id, title) =>
-              setMode({ type: "confirmDelete", sessionId: id, title })
+        }
+        changesOpen={workbench.changesOpen}
+        projectOpen={workbench.projectOpen}
+        onToggleChanges={workbench.toggleChanges}
+        onToggleProject={workbench.toggleProject}
+        onToggleRight={workbench.toggleRight}
+        projectMode={workbench.projectMode}
+        zoomHideThread={workbench.zoomed}
+        changesPanel={
+          <EditorGrid
+            tree={workbench.grid}
+            focusedGroupId={workbench.activeGroup}
+            onFocusGroup={workbench.focusGroup}
+            onActivateTab={workbench.activate}
+            onCloseTab={workbench.close}
+            onSplit={workbench.split}
+            onZoom={workbench.toggleZoom}
+            zoomed={workbench.zoomed}
+            renderTab={(tab) =>
+              tab.kind === "welcome" ? (
+                <WelcomeSurface version={CLIENT_VERSION} theme={theme} />
+              ) : (
+                <FileContentsView
+                  path={tab.path ?? ""}
+                  loadContents={(path) => controller.repoReadFile(path)}
+                  theme={theme}
+                />
+              )
             }
             theme={theme}
           />
-          <box style={{ flexGrow: 1, paddingLeft: 2, paddingTop: 1 }}>
-            <text fg={theme.textDim}>Select a thread</text>
-          </box>
-        </box>
+        }
+        projectPanel={
+          <WelcomeProjectPanel
+            mode={workbench.projectMode}
+            controller={controller}
+            onOpenFile={openRepoFile}
+            theme={theme}
+          />
+        }
+        theme={theme}
+      >
         {menuChrome}
         <ConfirmDialog
           isOpen={confirming !== null}
@@ -154,7 +263,18 @@ export function InboxScreen(props: {
           onCancel={() => setMode({ type: "normal" })}
           theme={theme}
         />
-      </box>
+        {mode.type === "renameThread" ? (
+          <PromptDialog
+            isOpen
+            title=" rename thread "
+            label="new title for this thread:"
+            value={mode.text}
+            placeholder="a short title"
+            onInput={(text) => setMode({ ...mode, text })}
+            theme={theme}
+          />
+        ) : null}
+      </AppShell>
     </ThemeProvider>
   );
 }
@@ -257,6 +377,17 @@ export function TrailingOverlays(props: {
           theme={theme}
         />
       ) : null}
+      {mode.type === "renameThread" ? (
+        <PromptDialog
+          isOpen
+          title=" rename thread "
+          label="new title for this thread:"
+          value={mode.text}
+          placeholder="a short title"
+          onInput={(text) => setMode({ ...mode, text })}
+          theme={theme}
+        />
+      ) : null}
       {mode.type === "nameSelf" ? (
         <PromptDialog
           isOpen

package/src/app-view-model.ts

@@ -1,16 +1,12 @@
 import type { Dispatch, MutableRefObject, SetStateAction } from "react";
 import type { ReviewSession, VerdictKind } from "@cueloop/schema";
-import { reviewerAnnotations, type Mode } from "./intent-dispatch";
-import type { DiffRow } from "./view-diff";
+import type { Mode } from "./intent-dispatch";
 import type { Intent, KeyState } from "./keymap";
 import type { Completion } from "./session-controller";
 import type { WalkFile } from "./walk";
 import { viewedCount } from "./walk";
-import type { DiffComposeState } from "./components/DiffSheet";
 import type { ConfirmCardProps } from "./components/ConfirmCard";
-import type { RailCardEdit } from "./components/ReviewRail";
 import type { BreadcrumbItem } from "./components/Breadcrumb";
-import { REVIEW_COMPACT_WIDTH, resolveReviewWidth, type ReviewPanelMode } from "./review-panel";
 
 export function computeRoleCapabilities(
   readOnly: boolean,
@@ -41,7 +37,12 @@ export function resolveOverlay(
   if (mode.type === "compose" || mode.type === "railEdit") return "compose";
   if (mode.type === "submit") return "submit";
   if (mode.type === "confirmDelete") return "confirm";
-  if (mode.type === "rename" || mode.type === "nameSelf" || mode.type === "treePrompt")
+  if (
+    mode.type === "rename" ||
+    mode.type === "renameThread" ||
+    mode.type === "nameSelf" ||
+    mode.type === "treePrompt"
+  )
     return "prompt";
   if (mode.type === "spanActions") return "spanActions";
   if (completionPhase === "prompt") return "completion-prompt";
@@ -57,25 +58,6 @@ export function isCompletionOverlayPhase(
   return completion.phase === "prompt" || completion.phase === "counting";
 }
 
-export function computePendingCount(session: ReviewSession): number {
-  return reviewerAnnotations(session).length + (session.workingCopy !== undefined ? 1 : 0);
-}
-
-export function computeRailFootprint(
-  reviewMode: ReviewPanelMode,
-  reviewWidth: number,
-  terminalWidth: number,
-): number {
-  if (reviewMode === "hidden") return 0;
-
-  return (
-    1 +
-    (reviewMode === "compact"
-      ? REVIEW_COMPACT_WIDTH
-      : resolveReviewWidth(reviewWidth, terminalWidth))
-  );
-}
-
 export function buildHeaderItems(params: {
   session: ReviewSession;
   resolved: boolean;
@@ -132,29 +114,6 @@ interface DraftHandlerDeps {
   dispatch: (intent: Intent) => void;
 }
 
-export function buildDiffComposeState(
-  deps: DraftHandlerDeps & { mode: Mode; isDiff: boolean; rows: DiffRow[] },
-): DiffComposeState | null {
-  const { mode, isDiff, rows, liveInput, setMode, dispatch } = deps;
-
-  if (mode.type !== "compose" || !isDiff) return null;
-
-  return {
-    kind: mode.kind,
-    rowIndex: mode.displayIndex,
-    quote: rows[mode.displayIndex]?.text.replace(/\n$/, "") ?? "",
-    draft: {
-      text: mode.text,
-      onInput: (text: string) => {
-        liveInput.current = text;
-        setMode({ ...mode, text });
-      },
-      onSave: () => dispatch({ type: "saveCompose" }),
-      onCancel: () => dispatch({ type: "closeOverlay" }),
-    },
-  };
-}
-
 export function buildSubmitConfirmState(
   deps: DraftHandlerDeps & {
     mode: Mode;
@@ -184,20 +143,3 @@ export function buildSubmitConfirmState(
     onCancel: () => dispatch({ type: "closeOverlay" }),
   };
 }
-
-export function buildCardEditState(deps: DraftHandlerDeps & { mode: Mode }): RailCardEdit | null {
-  const { mode, liveInput, setMode, dispatch } = deps;
-
-  if (mode.type !== "railEdit") return null;
-
-  return {
-    id: mode.id,
-    text: mode.text,
-    onInput: (text: string) => {
-      liveInput.current = text;
-      setMode({ type: "railEdit", id: mode.id, text });
-    },
-    onSave: () => dispatch({ type: "saveCompose" }),
-    onCancel: () => dispatch({ type: "closeOverlay" }),
-  };
-}

package/src/components/AnnotationCard.tsx

@@ -185,7 +185,7 @@ export function AnnotationCard({
 
     return (
       <Card
-        title={` ${primitive} "${truncateToSingleLine(quote, 40)}" `}
+        title={` ${primitive} "${truncateToSingleLine(quote, 20)}" `}
         contentRows={editorRowCount + 1}
         borderColor={kindColor}
         backgroundColor="transparent"

package/src/components/AnnotationCards.stories.tsx

@@ -0,0 +1,87 @@
+import React from "react";
+import type { Annotation } from "@cueloop/schema";
+import { DARK } from "../theme";
+import { annotationPaletteFor } from "../annotation-palette";
+import { slashItemsFrom } from "../slash-palette";
+import { DEFAULT_QUICK_ACTIONS } from "../config";
+import type { Story, StoryMeta } from "./story";
+import { CommentRow, ComposerPalette, DiscussionCard } from "./AnnotationCards";
+
+export const meta: StoryMeta = { title: "Chrome/AnnotationCards" };
+
+const palette = annotationPaletteFor(DARK);
+
+function annotation(id: string, body: string, author?: string): Annotation {
+  const comment: Annotation = {
+    id,
+    kind: "comment",
+    anchor: { quote: "the daemon", prefix: "", suffix: "" },
+    body,
+    createdAt: "2026-09-07T10:00:00.000Z",
+  };
+
+  if (author !== undefined) comment.author = author;
+
+  return comment;
+}
+
+// A two-voice discussion: the owner's comment then a collaborator's reply, each
+// segment wearing its own accent edge.
+export const TwoVoices: Story = {
+  render: () => (
+    <DiscussionCard
+      tokens={DARK}
+      segments={[
+        {
+          color: palette.cardEdge,
+          node: <CommentRow annotation={annotation("a", "Which daemon?")} tokens={DARK} />,
+        },
+        {
+          color: DARK.text,
+          node: (
+            <CommentRow
+              annotation={annotation("b", "The one the CLI spawns.", "fp:collab")}
+              tokens={DARK}
+            />
+          ),
+        },
+      ]}
+    />
+  ),
+  expectedColors: [palette.cardEdge, DARK.text],
+  size: { width: 60, height: 8 },
+};
+
+export const FocusedCard: Story = {
+  render: () => (
+    <DiscussionCard
+      focused
+      tokens={DARK}
+      segments={[
+        {
+          color: palette.cardEdge,
+          node: (
+            <CommentRow annotation={annotation("a", "Needs an eviction story.")} tokens={DARK} />
+          ),
+        },
+      ]}
+    />
+  ),
+  expectedColors: [DARK.text],
+  size: { width: 60, height: 6 },
+};
+
+// The palette a leading "/" opens under the composer, with the second item selected.
+export const SlashPaletteOpen: Story = {
+  render: () => (
+    <ComposerPalette
+      slashActive
+      slashItems={slashItemsFrom(DEFAULT_QUICK_ACTIONS)}
+      slashIndex={1}
+      inline={null}
+      tokens={DARK}
+    />
+  ),
+  expectedColors: [DARK.accent, DARK.textDim],
+  size: { width: 90, height: 8 },
+};