@cueloop/client 0.1.0-alpha.59 → 0.1.0-alpha.60

package/src/App.submit-confirm.test.tsx

@@ -56,13 +56,16 @@ async function renderApp(options: { readOnly?: boolean } = {}) {
       height: 32,
     },
   );
+
   await waitForText(setup, "cueloop");
+
   return setup;
 }
 
 /** Seed annotations directly through the daemon core (all on one block). */
 function seedAnnotations(count: number): void {
   const blocks = parseBlocks(PLAN);
+
   for (let index = 1; index <= count; index++) {
     server.core.sessionAnnotate(session.id, {
       id: `a_confirm_${index}`,
@@ -87,6 +90,7 @@ describe("rail submit confirm", () => {
     // Assert
     await waitForText(setup, "submit review");
     const frame = setup.captureCharFrame();
+
     // the card: title, verdict selector, word-buttons
     expect(frame).toContain("submit review");
     expect(frame).toContain("[Approve]"); // nothing pending: approve default
@@ -97,6 +101,7 @@ describe("rail submit confirm", () => {
   test("left/right cycles the verdict selector in the card", async () => {
     // Arrange
     const setup = await renderApp();
+
     await press(setup, "enter");
 
     // Assert
@@ -124,6 +129,7 @@ describe("rail submit confirm", () => {
   test("esc cancels the card and restores the plain Submit button", async () => {
     // Arrange
     const setup = await renderApp();
+
     await press(setup, "enter");
 
     // Assert
@@ -135,6 +141,7 @@ describe("rail submit confirm", () => {
     // Assert
     // a bare ESC settles after the parser's escape-sequence window
     const frame = await waitForTextGone(setup, "[Approve]");
+
     expect(frame).not.toContain("submit review");
     expect(frame).toContain("Submit review");
   });
@@ -150,6 +157,7 @@ describe("rail submit confirm", () => {
     // Assert
     await waitForText(setup, "[Changes]"); // pending items: request changes default
     const frame = setup.captureCharFrame();
+
     expect(frame).toContain("submit review");
 
     // Act
@@ -160,6 +168,7 @@ describe("rail submit confirm", () => {
     // the completion flow after submit is unchanged
     await waitForText(setup, "feedback sent");
     const stored = server.core.sessionGet(session.id);
+
     expect(stored.status).toBe("resolved");
     expect(stored.verdict!.kind).toBe("request_changes");
   });
@@ -194,6 +203,7 @@ describe("rail submit confirm", () => {
     // Assert
     await waitForText(setup, "note 12");
     const scrolledWithCard = setup.captureCharFrame();
+
     expect(scrolledWithCard).toContain("submit review");
     expect(scrolledWithCard).not.toContain("note 01");
   });
@@ -209,6 +219,7 @@ describe("rail submit confirm", () => {
     // Assert
     await waitForText(setup, "observer - read-only");
     const frame = setup.captureCharFrame();
+
     expect(frame).toContain("observer - read-only");
     expect(frame).not.toContain("1 annotations");
     expect(frame).not.toContain("[Changes]");

package/src/App.test.tsx

@@ -59,8 +59,10 @@ async function renderApp(sessionId?: string) {
     width: 120,
     height: 32,
   });
+
   // the async daemon connect + first fetch land within the frame wait
   await waitForText(setup, "cueloop");
+
   return setup;
 }
 
@@ -71,6 +73,7 @@ describe("plan rendering", () => {
 
     // Assert
     const frame = setup.captureCharFrame();
+
     expect(frame).toContain("Migration Plan");
     expect(frame).toContain("Context");
     expect(frame).toContain("persists sessions to disk atomically");
@@ -93,6 +96,7 @@ describe("keyboard grammar", () => {
     // Assert
     const lines = setup.captureCharFrame().split("\n");
     const cursorLine = lines.find((line) => line.includes("▎"))!;
+
     expect(cursorLine).toContain("persists sessions");
   });
 
@@ -116,6 +120,7 @@ describe("keyboard grammar", () => {
     // Assert
     await waitForText(setup, "COMMENT");
     const stored = server.core.sessionGet(session.id);
+
     expect(stored.annotations.length).toBe(1);
     expect(stored.annotations[0]!.body).toBe("Define atomically.");
   });
@@ -136,12 +141,14 @@ describe("keyboard grammar", () => {
     // Assert
     await waitForState(setup, () => server.core.sessionGet(session.id).annotations.length === 1);
     const stored = server.core.sessionGet(session.id);
+
     expect(stored.annotations[0]!.anchor.quote).toBe("The daemon");
   });
 
   test("x cuts a block into the working copy; x restores it", async () => {
     // Arrange
     const setup = await renderApp();
+
     // move to "- move the store" (h1, h2, p, h2 = 4 steps in)
     for (let i = 0; i < 4; i++) await press(setup, "j");
 
@@ -161,6 +168,7 @@ describe("keyboard grammar", () => {
 
   test("e runs $EDITOR on the working copy and tracks the diff", async () => {
     const script = join(home, "fake-editor.sh");
+
     await Bun.write(script, `#!/bin/sh\nsed -i '' 's/atomically/very atomically/' "$1"\n`);
     Bun.spawnSync(["chmod", "+x", script]);
     process.env.CUELOOP_EDITOR = script;
@@ -184,6 +192,7 @@ describe("submit", () => {
   test("⏎ opens the rail confirm card; verdict + summary resolve the session", async () => {
     // Arrange
     const setup = await renderApp();
+
     await press(setup, "j");
     await press(setup, "j");
     await press(setup, "c");
@@ -204,6 +213,7 @@ describe("submit", () => {
     // Assert
     await waitForText(setup, "feedback sent");
     const stored = server.core.sessionGet(session.id);
+
     expect(stored.status).toBe("resolved");
     expect(stored.verdict!.kind).toBe("request_changes");
     expect(stored.verdict!.feedback).toContain("Needs a phase list.");
@@ -234,10 +244,12 @@ describe("inbox", () => {
   test("inbox mode wears the review chrome (header + menu bar) and opens a session", async () => {
     // Arrange
     const setup = await testRender(<App home={home} />, { width: 120, height: 32 });
+
     await waitForText(setup, "cueloop");
 
     // Assert - the same header/menu chrome as review, plus the session row
     const frame = setup.captureCharFrame();
+
     expect(frame).toContain("cueloop · resume");
     expect(frame).toContain("Migration Plan");
     expect(frame).toContain("menu"); // the shared MenuBar sits at the bottom
@@ -253,6 +265,7 @@ describe("inbox", () => {
   test("the menu opens from the inbox and escape is not a trap", async () => {
     // Arrange
     const setup = await testRender(<App home={home} />, { width: 120, height: 32 });
+
     await waitForText(setup, "cueloop · resume");
     const lines = setup.captureCharFrame().split("\n");
     const menuRow = lines.findIndex((line) => line.includes("menu"));

package/src/App.toast.test.tsx

@@ -11,6 +11,7 @@ import type { ReviewSession } from "@cueloop/schema";
 
 // the controller reaches the gateway through "./share"; stub it so `S` yields a toast
 const publishShare = mock(async () => ({ line: "ssh p_share01@cueloop.dev", copied: true }));
+
 mock.module("./share", () => ({
   publishShare,
   pullShare: mock(async () => null),
@@ -56,6 +57,7 @@ describe("share toast", () => {
       width: 120,
       height: 32,
     });
+
     await waitForText(setup, "cueloop");
 
     // Act: share raises the toast, then open a composer under it

package/src/App.tsx

@@ -142,8 +142,10 @@ export function App({
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [home, sessionId],
   );
+
   useEffect(() => {
     controller.connect();
+
     return () => controller.close();
   }, [controller]);
   // stable across renders so the memoized PrototypeSheet is not re-rendered by
@@ -155,10 +157,12 @@ export function App({
   );
   const { session, inbox, status, toast, error, completion, editOrphanCount, walk } =
     useSyncExternalStore(controller.subscribe, controller.getSnapshot, controller.getSnapshot);
+
   // A shared plan you own polls for collaborator notes while it is open; the
   // merge refreshes through the normal event path. Stops on leave.
   useEffect(() => {
     if (!isOwner || !session?.shareId) return;
+
     return controller.startSharePoll();
   }, [isOwner, session?.id, session?.shareId, controller]);
   const renderer = useRenderer();
@@ -200,8 +204,10 @@ export function App({
   const [themeOverrides, setThemeOverrides] = useState<Partial<Theme>>({});
   const [authorNames, setAuthorNames] = useState<Record<string, string>>({});
   const [quickActions, setQuickActions] = useState<QuickAction[]>(DEFAULT_QUICK_ACTIONS);
+
   useEffect(() => {
     const config = loadConfig({ repoRoot: session?.workspace.repoRoot });
+
     keysRef.current = config.keys;
     keyBindings.setKeys(config.keys);
     setTheme(composeTheme(config.ui.theme, config.themeOverrides, appearance));
@@ -225,16 +231,19 @@ export function App({
   useEffect(() => {
     if (!toast) return;
     const timer = setTimeout(() => controller.dismissToast(), TOAST_DISMISS_MS);
+
     return () => clearTimeout(timer);
   }, [toast, controller]);
 
   // First open of a share: ask the collaborator for a display name once, unless
   // a past visit already recorded one. esc skips and their notes read anonymous.
   const promptedSelfRef = useRef(false);
+
   useEffect(() => {
     if (promptedSelfRef.current || role !== "collaborator" || !selfAuthor || !session) return;
     promptedSelfRef.current = true;
     const known = session.participants?.find((participant) => participant.id === selfAuthor)?.name;
+
     if (!known) setMode({ type: "nameSelf", text: "" });
   }, [role, selfAuthor, session]);
 
@@ -278,9 +287,11 @@ export function App({
   /** Annotation ids whose anchor resolved against the working copy. */
   const resolvedIds = useMemo(() => {
     const ids = new Set<string>();
+
     for (const blockMarks of marks.values()) {
       for (const mark of blockMarks) if (mark.annotationId) ids.add(mark.annotationId);
     }
+
     return ids;
   }, [marks]);
   const { isDiff, isPrototype, resolved } = deriveReviewFlags(session);
@@ -290,10 +301,12 @@ export function App({
   // annotation resolves to the display index it marked
   const annotationPositions = useMemo(() => {
     const positions = new Map<string, number>();
+
     if (!session) return positions;
     if (isDiff) {
       for (const annotation of session.annotations) {
         const blockIndex = (annotation.anchor as { blockIndex?: number }).blockIndex;
+
         if (blockIndex !== undefined) positions.set(annotation.id, blockIndex);
       }
     } else {
@@ -302,6 +315,7 @@ export function App({
           if (mark.annotationId) positions.set(mark.annotationId, displayIndex);
       }
     }
+
     return positions;
   }, [session, isDiff, marks]);
 
@@ -317,6 +331,7 @@ export function App({
     // one marker at a time: clear any prior selection, then paint the current
     // span (span and its quick-actions sub-mode both keep it painted)
     const span = activeSpanState(mode);
+
     planSheetRef.current?.clearSelection();
     if (span) planSheetRef.current?.driveSpanSelection(span);
   }, [mode]);
@@ -334,6 +349,7 @@ export function App({
       if (!blockMarks.some((mark) => mark.annotationId === annotationId)) continue;
       setCursor(displayIndex);
       planSheetRef.current?.revealBlock(displayIndex);
+
       return;
     }
   };
@@ -355,6 +371,7 @@ export function App({
   const selectCurationFromRail = (curationId: string): void => {
     setSelectedCurationId(curationId);
     const item = curationItems.find((candidate) => candidate.id === curationId);
+
     if (!item) return;
     setCursor(item.revealIndex);
     if (item.source === "plan") planSheetRef.current?.revealBlock(item.revealIndex);
@@ -371,11 +388,13 @@ export function App({
   const openCardEdit = (annotationId: string): void => {
     if (observer) return controller.setStatus("observer - read-only");
     const annotation = session?.annotations.find((candidate) => candidate.id === annotationId);
+
     if (!annotation) return;
     // a collaborator's note is theirs to word: activating it (click or e) renames
     // the author rather than editing the body the planner does not own
     if (annotation.author) {
       setFocusedAnnotationId(annotationId);
+
       return void setMode({
         type: "rename",
         authorId: annotation.author,
@@ -447,6 +466,7 @@ export function App({
     // with ctrl+] as the detach chord back to the review.
     if (agentTerminal) {
       if (key.ctrl && key.name === "]") return void agentTerminal.detach();
+
       return void agentTerminal.write(key.sequence);
     }
     if (menuDialog === "settings") return void handleSettingsKey(key.name);
@@ -473,8 +493,10 @@ export function App({
       cursor,
       display,
     });
+
     keyBindings.setContext({ overlay: state.overlay, spanMode: state.spanMode });
     const action = keyBindings.resolveAction({ name: key.name, shift: !!key.shift });
+
     for (const intent of reduceKey(
       state,
       { name: key.name, shift: !!key.shift, meta: !!key.meta },
@@ -590,7 +612,9 @@ export function App({
       selection && block
         ? spanFromRange(selection.displayIndex, displayText(block), selection.start, selection.end)
         : null;
+
     if (span) setMode({ type: "span", span });
+
     return true;
   };
 
@@ -598,6 +622,7 @@ export function App({
     if (activateSpanFromSelection(displayIndex)) return;
     setCursor(displayIndex);
     const annotationId = marks.get(displayIndex)?.[0]?.annotationId;
+
     if (annotationId) selectCardFromDocument(annotationId);
   };
 
@@ -634,6 +659,7 @@ export function App({
   // cycles all three including hidden
   const onToggleReviewPanel = (): void => {
     const next = toggleReviewPanelMode(reviewMode);
+
     setReviewMode(next);
     controller.saveReviewPanel({ mode: next });
   };
@@ -654,6 +680,7 @@ export function App({
         onMouseDrag={(event: MouseEvent) => {
           if (!dividerDragging || reviewMode !== "expanded") return;
           const next = widthFromMouseColumn(event.x, terminalWidth);
+
           // many raw mouse-moves land in the same column: only re-render when the
           // width actually changes, so the drag does not reconcile per pixel
           if (next === reviewWidthRef.current) return;

package/src/App.walk.test.tsx

@@ -69,9 +69,11 @@ async function renderApp() {
     width: 120,
     height: 34,
   });
+
   // Wait for session content, not just the chrome: pressing w before the diff
   // loads drops the walk intent (no session, no diff view) and hangs the test.
   await waitForText(setup, "src/a.ts");
+
   return setup;
 }
 
@@ -80,15 +82,18 @@ type Setup = Awaited<ReturnType<typeof renderApp>>;
 /** Foreground colors (hex) of every styled span containing the needle. */
 function foregroundsOf(setup: Setup, needle: string): string[] {
   const foregrounds: string[] = [];
+
   for (const line of setup.captureSpans().lines) {
     for (const span of line.spans) {
       if (!span.text.includes(needle)) continue;
       const [red, green, blue] = span.fg.toInts();
+
       foregrounds.push(
         "#" + [red, green, blue].map((part) => part.toString(16).padStart(2, "0")).join(""),
       );
     }
   }
+
   return foregrounds;
 }
 
@@ -165,6 +170,7 @@ describe("the guided walk", () => {
   test("esc keeps progress and w resumes at the first unviewed file", async () => {
     // Arrange
     const setup = await renderApp();
+
     await press(setup, "w");
     await waitForText(setup, "file 1 of 3 · 0 viewed");
     await press(setup, "]");
@@ -188,6 +194,7 @@ describe("the guided walk", () => {
   test("a half-walked review resumes across App instances via the daemon", async () => {
     // Arrange
     const first = await renderApp();
+
     await press(first, "w");
     await waitForText(first, "file 1 of 3 · 0 viewed");
     await press(first, "]");
@@ -202,6 +209,7 @@ describe("the guided walk", () => {
     // Act
     // a fresh client reads the viewed set back from the session record
     const second = await renderApp();
+
     await press(second, "w");
 
     // Assert
@@ -249,6 +257,7 @@ describe("the guided walk", () => {
     // Assert
     await waitForState(setup, () => server.core.sessionGet(session.id).status === "resolved");
     const resolved = server.core.sessionGet(session.id);
+
     expect(resolved.verdict!.kind).toBe("approve");
     expect(resolved.verdict!.feedback).not.toContain("Swaps the stale line");
   });
@@ -277,6 +286,7 @@ describe("the guided walk", () => {
     // Arrange
     server.core.sessionResolve(session.id, "approve", "");
     const setup = await renderApp();
+
     await waitForText(setup, "resolved");
 
     // Act

package/src/app-key-state.ts

@@ -39,6 +39,7 @@ export function buildKeyState(params: {
     cursor,
     display,
   } = params;
+
   return {
     keys,
     readOnly: observer,

package/src/app-screens.tsx

@@ -66,6 +66,7 @@ export function MenuChrome(props: {
     onCategorySelect,
     cycleSetting,
   } = props;
+
   return (
     <>
       <MenuBar
@@ -114,6 +115,7 @@ export function InboxScreen(props: {
 }): React.ReactNode {
   const { inbox, inboxCursor, mode, theme, controller, setMode, menuChrome } = props;
   const confirming = mode.type === "confirmDelete" ? mode : null;
+
   return (
     <ThemeProvider theme={theme}>
       <box
@@ -176,6 +178,7 @@ export function CompletionScreen(props: {
   status: string;
 }): React.ReactNode {
   const { theme, session, verdict, completion, status } = props;
+
   return (
     <ThemeProvider theme={theme}>
       <CompletionOverlay
@@ -218,6 +221,7 @@ export function TrailingOverlays(props: {
     setMode,
     dispatch,
   } = props;
+
   return (
     <>
       {walking && walk !== null ? (

package/src/app-view-model.ts

@@ -20,6 +20,7 @@ export function computeRoleCapabilities(
   role: "owner" | "observer" | "collaborator",
 ): { observer: boolean; isOwner: boolean } {
   const observer = readOnly || role === "observer";
+
   return { observer, isOwner: !observer && role === "owner" };
 }
 
@@ -52,6 +53,7 @@ export function resolveOverlay(
   if (completionPhase === "prompt") return "completion-prompt";
   if (completionPhase === "counting") return "completion-counting";
   if (walking) return "walk";
+
   return "none";
 }
 
@@ -71,6 +73,7 @@ export function computeRailFootprint(
   terminalWidth: number,
 ): number {
   if (reviewMode === "hidden") return 0;
+
   return (
     1 +
     (reviewMode === "compact"
@@ -86,6 +89,7 @@ export function buildHeaderItems(params: {
   role: "owner" | "observer" | "collaborator";
 }): BreadcrumbItem[] {
   const { session, resolved, observer, role } = params;
+
   return [
     { label: "cueloop", tone: "accent" },
     ...(resolved
@@ -126,6 +130,7 @@ export function buildRenderFlags(params: {
 } {
   const { session, isOwner, isDiff, isPrototype, resolved, menuOpen, menuDialog, resolvedIds } =
     params;
+
   return {
     showOwnerActions: isOwner && !isDiff && !resolved,
     prototypeCanComment: isOwner && !resolved,
@@ -140,10 +145,12 @@ export function buildActiveSpan(
   isDiff: boolean,
 ): { displayIndex: number; start: number; end: number } | null {
   const markedSpan = activeSpanState(mode);
+
   if (markedSpan)
     return { displayIndex: markedSpan.displayIndex, start: markedSpan.start, end: markedSpan.end };
   if (mode.type === "compose" && !isDiff)
     return { displayIndex: mode.displayIndex, start: mode.start, end: mode.end };
+
   return null;
 }
 
@@ -157,7 +164,9 @@ export function buildComposeState(
   deps: DraftHandlerDeps & { mode: Mode; isDiff: boolean; display: DisplayBlock[] },
 ): PlanComposeState | null {
   const { mode, isDiff, display, liveInput, setMode, dispatch } = deps;
+
   if (mode.type !== "compose" || isDiff) return null;
+
   return {
     kind: mode.kind,
     displayIndex: mode.displayIndex,
@@ -178,7 +187,9 @@ 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,
@@ -207,9 +218,11 @@ export function buildPopoverState(deps: {
 }): PlanPopoverState | null {
   const { mode, isDiff, quickActions, isOwner, observer, resolved, controller, dispatch } = deps;
   const markedSpan = activeSpanState(mode);
+
   if (!markedSpan || isDiff) return null;
   const spanMutationBlock = (): string | null =>
     observer ? "observer - read-only" : resolved ? "review submitted - read-only" : null;
+
   return {
     displayIndex: markedSpan.displayIndex,
     view: mode.type === "spanActions" ? ("actions" as const) : ("toolbar" as const),
@@ -218,23 +231,27 @@ export function buildPopoverState(deps: {
     canCut: isOwner,
     onComment: () => {
       const blocked = spanMutationBlock();
+
       if (blocked) return controller.setStatus(blocked);
       dispatch({ type: "openCompose", kind: "comment", from: "span" });
     },
     onCut: () => {
       const blocked = spanMutationBlock();
+
       if (blocked) return controller.setStatus(blocked);
       if (!isOwner) return;
       dispatch({ type: "spanCut" });
     },
     onOpenActions: () => {
       const blocked = spanMutationBlock();
+
       if (blocked) return controller.setStatus(blocked);
       dispatch({ type: "openSpanActions" });
     },
     onClose: () => dispatch({ type: "closeOverlay" }),
     onPickAction: (index: number) => {
       const blocked = spanMutationBlock();
+
       if (blocked) return controller.setStatus(blocked);
       dispatch({ type: "pickSpanAction", index });
     },
@@ -252,7 +269,9 @@ export function buildSubmitConfirmState(
   },
 ): Omit<ConfirmCardProps, "theme"> | null {
   const { mode, isDiff, session, walkFileList, viewedPaths, liveInput, setMode, dispatch } = deps;
+
   if (mode.type !== "submit") return null;
+
   return {
     verdict: mode.verdict,
     summary: mode.summary,
@@ -272,7 +291,9 @@ export function buildSubmitConfirmState(
 
 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,

package/src/attribution.ts

@@ -16,6 +16,7 @@ export function shortHandle(authorId: string): string {
   const base = authorId.startsWith(FINGERPRINT_PREFIX)
     ? authorId.slice(FINGERPRINT_PREFIX.length)
     : authorId;
+
   return base.slice(0, 8) || authorId;
 }
 
@@ -30,9 +31,12 @@ export function resolveDisplayName(
   overrides: Record<string, string>,
 ): string {
   const override = overrides[authorId];
+
   if (override) return override;
   const identity = participants?.find((participant) => participant.id === authorId);
+
   if (identity?.name) return identity.name;
   if (identity) return ANONYMOUS_LABEL;
+
   return shortHandle(authorId);
 }

package/src/clipboard.ts

@@ -9,6 +9,7 @@
 export function clipboardCommands(platform: NodeJS.Platform = process.platform): string[][] {
   if (platform === "darwin") return [["pbcopy"]];
   if (platform === "win32") return [["clip.exe"]];
+
   return [["wl-copy"], ["xclip", "-selection", "clipboard"], ["xsel", "--clipboard", "--input"]];
 }
 
@@ -21,10 +22,12 @@ export async function copyToClipboard(text: string): Promise<boolean> {
         stdout: "ignore",
         stderr: "ignore",
       });
+
       if ((await proc.exited) === 0) return true;
     } catch {
       // tool not installed - try the next one
     }
   }
+
   return false;
 }