@saadnvd1/agent-os 0.3.606 → 0.3.609

package/components/Stacks/StatusChip.tsx

@@ -1,52 +1,28 @@
-import type { StackItemView, StackStatus } from "@/lib/stacks/types";
+import { GitPullRequest, Loader2 } from "lucide-react";
 import { cn } from "@/lib/utils";
-
-type Status = StackItemView["status"] | StackStatus;
-
-const amber = "bg-amber-500/15 text-amber-700 dark:text-amber-300";
-const green = "bg-emerald-500/15 text-emerald-700 dark:text-emerald-300";
-const muted = "bg-foreground/[0.06] text-muted-foreground";
-const purple = "bg-primary/15 text-primary";
-const red = "bg-destructive/15 text-destructive";
-
-const CHIP: Record<Status, { label: string; tone: string }> = {
-  planned: { label: "Planned", tone: muted },
-  held: { label: "Held", tone: amber },
-  starting: { label: "Starting", tone: purple },
-  running: { label: "Working", tone: purple },
-  pr: { label: "PR open", tone: purple },
-  merged: { label: "Merged", tone: green },
-  failed: { label: "Failed", tone: red },
-  dropped: { label: "Dropped", tone: muted },
-  done: { label: "Done", tone: green },
-  excluded: { label: "Left out", tone: muted },
-  paused: { label: "Paused", tone: amber },
-  landing: { label: "Landing", tone: purple },
-  landed: { label: "Landed", tone: green },
-};
+import { chipFor, type ChipStatus } from "./status-chip";
 
 export function StatusChip({
   status,
   attention,
   stack,
 }: {
-  status: Status;
+  status: ChipStatus;
   attention?: boolean;
-  // A whole stack: "running" reads as Running, not Working.
   stack?: boolean;
 }) {
-  const chip = attention
-    ? { label: "Needs you", tone: amber }
-    : stack && status === "running"
-      ? { label: "Running", tone: purple }
-      : CHIP[status];
+  const chip = chipFor(status, { attention, stack });
   return (
     <span
       className={cn(
-        "inline-flex shrink-0 items-center rounded-full px-2 py-0.5 text-[11px] font-medium",
+        "inline-flex shrink-0 items-center gap-1 rounded-full px-2 py-0.5 text-[11px] font-medium",
         chip.tone
       )}
     >
+      {chip.icon === "spinner" && (
+        <Loader2 className="h-3 w-3 animate-spin" aria-hidden />
+      )}
+      {chip.icon === "pr" && <GitPullRequest className="h-3 w-3" aria-hidden />}
       {chip.label}
     </span>
   );

package/components/Stacks/status-chip.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import { CHIP, chipFor, type ChipStatus } from "./status-chip";
+
+const coloured = (tone: string) => /amber|emerald|destructive/.test(tone);
+
+describe("status chip colour", () => {
+  it.each(["starting", "running", "pr", "landing"] as ChipStatus[])(
+    "%s is neutral with an icon",
+    (s) => {
+      expect(coloured(CHIP[s].tone)).toBe(false);
+      expect(CHIP[s].tone).not.toContain("primary");
+      expect(CHIP[s].icon).not.toBeNull();
+    }
+  );
+
+  it.each(["merged", "done", "landed"] as ChipStatus[])("%s is green", (s) =>
+    expect(CHIP[s].tone).toContain("emerald")
+  );
+  it("failed is red", () => expect(CHIP.failed.tone).toContain("destructive"));
+  it.each(["held", "paused"] as ChipStatus[])("%s is amber", (s) =>
+    expect(CHIP[s].tone).toContain("amber")
+  );
+
+  it("needs-you overrides status with amber", () => {
+    const c = chipFor("running", { attention: true });
+    expect(c.label).toBe("Needs you");
+    expect(c.tone).toContain("amber");
+  });
+
+  it("a running stack reads Running, neutral", () => {
+    const c = chipFor("running", { stack: true });
+    expect(c.label).toBe("Running");
+    expect(coloured(c.tone)).toBe(false);
+  });
+
+  it("no status uses the accent", () => {
+    for (const c of Object.values(CHIP))
+      expect(c.tone).not.toContain("primary");
+  });
+});

package/components/Stacks/status-chip.ts

@@ -0,0 +1,44 @@
+import type { StackItemView, StackStatus } from "@/lib/stacks/types";
+
+export type ChipStatus = StackItemView["status"] | StackStatus;
+export type ChipIcon = "spinner" | "pr" | null;
+
+// Colour means "look at this": amber needs you, red failed, green final.
+// Everything still moving on its own is neutral, and an icon carries the meaning.
+const amber = "bg-amber-500/15 text-amber-700 dark:text-amber-300";
+const green = "bg-emerald-500/15 text-emerald-700 dark:text-emerald-300";
+const muted = "bg-foreground/[0.06] text-muted-foreground";
+const red = "bg-destructive/15 text-destructive";
+
+interface Chip {
+  label: string;
+  tone: string;
+  icon: ChipIcon;
+}
+
+export const CHIP: Record<ChipStatus, Chip> = {
+  planned: { label: "Planned", tone: muted, icon: null },
+  held: { label: "Held", tone: amber, icon: null },
+  starting: { label: "Starting", tone: muted, icon: "spinner" },
+  running: { label: "Working", tone: muted, icon: "spinner" },
+  pr: { label: "PR open", tone: muted, icon: "pr" },
+  merged: { label: "Merged", tone: green, icon: null },
+  failed: { label: "Failed", tone: red, icon: null },
+  dropped: { label: "Dropped", tone: muted, icon: null },
+  done: { label: "Done", tone: green, icon: null },
+  excluded: { label: "Left out", tone: muted, icon: null },
+  paused: { label: "Paused", tone: amber, icon: null },
+  landing: { label: "Landing", tone: muted, icon: "spinner" },
+  landed: { label: "Landed", tone: green, icon: null },
+};
+
+export function chipFor(
+  status: ChipStatus,
+  opts: { attention?: boolean; stack?: boolean } = {}
+): Chip {
+  if (opts.attention) return { label: "Needs you", tone: amber, icon: null };
+  // A whole stack: "running" reads as Running, not Working.
+  if (opts.stack && status === "running")
+    return { label: "Running", tone: muted, icon: "spinner" };
+  return CHIP[status];
+}

package/components/ui/context-menu.tsx

@@ -45,8 +45,9 @@ const ContextMenuSubContent = React.forwardRef<
 >(({ className, ...props }, ref) => (
   <ContextMenuPrimitive.SubContent
     ref={ref}
+    collisionPadding={8}
     className={cn(
-      "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 popover-surface text-popover-foreground z-50 min-w-[8rem] overflow-hidden rounded-xl p-1.5",
+      "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 popover-surface text-popover-foreground z-50 max-h-(--radix-context-menu-content-available-height) min-w-[8rem] overflow-x-hidden overflow-y-auto overscroll-contain rounded-xl p-1.5",
       className
     )}
     {...props}
@@ -61,8 +62,9 @@ const ContextMenuContent = React.forwardRef<
   <ContextMenuPrimitive.Portal>
     <ContextMenuPrimitive.Content
       ref={ref}
+      collisionPadding={8}
       className={cn(
-        "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 popover-surface text-popover-foreground z-50 min-w-[8rem] overflow-hidden rounded-xl p-1.5",
+        "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 popover-surface text-popover-foreground z-50 max-h-(--radix-context-menu-content-available-height) min-w-[8rem] overflow-x-hidden overflow-y-auto overscroll-contain rounded-xl p-1.5",
         className
       )}
       {...props}

package/components/ui/dropdown-menu.tsx

@@ -34,6 +34,7 @@ function DropdownMenuTrigger({
 function DropdownMenuContent({
   className,
   sideOffset = 4,
+  collisionPadding = 8,
   ...props
 }: React.ComponentProps<typeof DropdownMenuPrimitive.Content>) {
   return (
@@ -41,8 +42,9 @@ function DropdownMenuContent({
       <DropdownMenuPrimitive.Content
         data-slot="dropdown-menu-content"
         sideOffset={sideOffset}
+        collisionPadding={collisionPadding}
         className={cn(
-          "popover-surface text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-xl p-1.5",
+          "popover-surface text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-x-hidden overflow-y-auto overscroll-contain rounded-xl p-1.5",
           className
         )}
         {...props}
@@ -229,8 +231,9 @@ function DropdownMenuSubContent({
   return (
     <DropdownMenuPrimitive.SubContent
       data-slot="dropdown-menu-sub-content"
+      collisionPadding={8}
       className={cn(
-        "popover-surface text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-hidden rounded-xl p-1.5",
+        "popover-surface text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-x-hidden overflow-y-auto overscroll-contain rounded-xl p-1.5",
         className
       )}
       {...props}

package/components/ui/menu-fit.test.ts

@@ -0,0 +1,36 @@
+import { readFileSync } from "node:fs";
+import { describe, expect, it } from "vitest";
+
+// Where a menu opens (flip, shift, the 8px gap) is floating-ui's job inside
+// Radix, and Radix can't mount in the suite's fake DOM. What is ours is that
+// every menu surface hands its height to the room left on screen and scrolls
+// past it instead of clipping, so that is what this pins. The geometry itself
+// is checked in a browser.
+const surfaces = (file: string) =>
+  readFileSync(new URL(file, import.meta.url), "utf8")
+    .split("\n")
+    .filter((l) => l.includes("popover-surface"));
+
+describe.each([
+  ["./dropdown-menu.tsx", "dropdown-menu"],
+  ["./context-menu.tsx", "context-menu"],
+])("%s", (file, name) => {
+  const lines = surfaces(file);
+
+  it("has a menu and a submenu surface", () => {
+    expect(lines).toHaveLength(2);
+  });
+
+  it.each([0, 1])("caps surface %i to the space available and scrolls", (i) => {
+    expect(lines[i]).toContain(
+      `max-h-(--radix-${name}-content-available-height)`
+    );
+    expect(lines[i]).toContain("overflow-y-auto");
+    expect(lines[i]).not.toContain("overflow-hidden");
+  });
+
+  it("keeps menus off the window edge", () => {
+    const src = readFileSync(new URL(file, import.meta.url), "utf8");
+    expect(src.match(/collisionPadding/g)?.length).toBeGreaterThanOrEqual(2);
+  });
+});

package/hooks/useCompactMenu.ts

@@ -0,0 +1,9 @@
+"use client";
+
+import { useMediaQuery } from "./useMediaQuery";
+
+// A phone or a touch screen: menus use one scrolling list with sections that
+// open in place, not flyouts a finger can't hold open.
+export function useCompactMenu(): boolean {
+  return useMediaQuery("(max-width: 767px), (pointer: coarse)");
+}

package/hooks/useMediaQuery.ts

@@ -0,0 +1,20 @@
+"use client";
+
+import { useSyncExternalStore } from "react";
+
+const supported = () =>
+  typeof window !== "undefined" && typeof window.matchMedia === "function";
+
+// Whether a CSS media query matches now, and stays in step as it changes.
+export function useMediaQuery(query: string): boolean {
+  return useSyncExternalStore(
+    (listener) => {
+      if (!supported()) return () => {};
+      const mq = window.matchMedia(query);
+      mq.addEventListener("change", listener);
+      return () => mq.removeEventListener("change", listener);
+    },
+    () => supported() && window.matchMedia(query).matches,
+    () => false
+  );
+}

package/lib/busy.ts

@@ -1,9 +1,14 @@
 import { db } from "./db";
+import { runningStarts } from "./simulator";
 
-// What a restart would cut off and have to start over: reviews and task
-// setups run in the server. (Chat turns run in their own workers and
+// What a restart would cut off and have to start over: reviews, task
+// setups and simulator starts run in the server. (Chat turns run in their own workers and
 // outlive it.) Older than half an hour is stuck, not in flight.
-export function inFlight(): { reviews: number; setups: number } {
+export function inFlight(): {
+  reviews: number;
+  setups: number;
+  simulatorStarts: number;
+} {
   const count = (sql: string) => (db.prepare(sql).get() as { n: number }).n;
   return {
     reviews: count(
@@ -16,5 +21,6 @@ export function inFlight(): { reviews: number; setups: number } {
        WHERE setup_status = 'running' AND archived_at IS NULL
          AND created_at > datetime('now', '-30 minutes')`
     ),
+    simulatorStarts: runningStarts(),
   };
 }

package/lib/hosts/remote-menu.ts

@@ -13,6 +13,10 @@ export const REMOTE_UNSUPPORTED = {
   schedule: (host: string) => `Check-ins can't message ${host} yet`,
 };
 
+// The one line that replaces the hidden items.
+export const remoteNote = (host: string) =>
+  `Runs on ${host}: fork, fresh start, project moves and check-ins happen there`;
+
 export type RemoteAction = keyof typeof REMOTE_UNSUPPORTED;
 
 /**

package/lib/recipes/status-labels.ts

@@ -8,8 +8,8 @@ export const RUN_STATUS_LABELS: Record<
   { label: string; tone: Tone }
 > = {
   queued: { label: "Queued", tone: "muted" },
-  starting: { label: "Starting", tone: "primary" },
-  running: { label: "Running", tone: "primary" },
+  starting: { label: "Starting", tone: "muted" },
+  running: { label: "Running", tone: "muted" },
   succeeded: { label: "Succeeded", tone: "success" },
   failed: { label: "Failed", tone: "destructive" },
   blocked: { label: "Needs you", tone: "warning" },

package/lib/resurrect/index.ts

@@ -29,7 +29,7 @@ import {
   transcriptPath,
   writeTranscript,
 } from "../tasks/transcript";
-import { buildTaskBrief } from "../tasks/brief";
+import { buildTaskBrief, declaredTest } from "../tasks/brief";
 import { syncTaskCardInBackground } from "../lumifyhub/task-cards";
 import { allocatePorts } from "../ports";
 import { loadProjectConfig, portBases } from "../project-config";
@@ -416,6 +416,7 @@ async function relaunch(s: Session, cwd: string): Promise<void> {
       ? buildTaskBrief({
           branch: s.branch_name,
           baseBranch: s.base_branch ?? "main",
+          test: declaredTest(cwd),
         })
       : undefined,
   });

package/lib/sidebar/live-status.ts

@@ -6,14 +6,7 @@ import {
 } from "../tasks/pr-stage";
 import type { StatusBadge } from "./row-badge";
 
-export type LiveTone =
-  | "blue"
-  | "amber"
-  | "red"
-  | "green"
-  | "purple"
-  | "primary"
-  | "muted";
+export type LiveTone = "amber" | "red" | "green" | "primary" | "muted";
 
 export interface LivePart {
   text: string;
@@ -31,17 +24,17 @@ export const BADGE_TONE: Record<StatusBadge["kind"], LiveTone> = {
   failed: "red",
   stalled: "amber",
   starting: "muted",
-  planning: "blue",
+  planning: "muted",
   "plan-ready": "primary",
 };
 
 export const PR_STAGE_TONE: Record<PrStageName, LiveTone> = {
-  merged: "purple",
+  merged: "green",
   conflicts: "amber",
   "ci-failed": "red",
-  "ci-running": "blue",
-  "ci-settling": "blue",
-  "review-running": "blue",
+  "ci-running": "muted",
+  "ci-settling": "muted",
+  "review-running": "muted",
   "review-blocked": "red",
   waiting: "amber",
   armed: "green",
@@ -58,7 +51,7 @@ export function liveParts(input: {
 }): LivePart[] {
   const parts: LivePart[] = [];
   if (input.compacting)
-    parts.push({ text: "Compacting", tone: "blue", busy: true });
+    parts.push({ text: "Compacting", tone: "muted", busy: true });
   const b = input.badge;
   if (b)
     parts.push({

package/lib/sidebar/row-menu.ts

@@ -0,0 +1,168 @@
+import type { Session } from "@/lib/db/types";
+import type { SidebarRow } from "./shelves";
+import { finishActions } from "./row-actions";
+
+// What a session row's ⋯ / right-click menu offers, as data: which items,
+// in which sections, and which sit together in a submenu. The component only
+// draws it. An item that doesn't apply is absent, never shown disabled.
+export type RowMenuItem =
+  | "rename"
+  | "pin"
+  | "unpin"
+  | "select"
+  | "open-tab"
+  | "open-pr"
+  | "card"
+  | "open-recipe"
+  | "copy-link"
+  | "share"
+  | "fork"
+  | "fresh-start"
+  | "new-conversation"
+  | "move-machine"
+  | "move-project"
+  | "check-ins"
+  | "save-recipe"
+  | "run-again"
+  | "snooze"
+  | "unsnooze"
+  | "pause"
+  | "resume"
+  | "settle"
+  | "reopen"
+  | "done"
+  | "restore"
+  | "archive"
+  | "delete";
+
+export type RowMenuGroup = "open" | "share" | "restart" | "move" | "automate";
+
+export type RowMenuEntry =
+  | RowMenuItem
+  | { group: RowMenuGroup; items: RowMenuItem[] };
+
+export interface RowMenuInput {
+  session: Pick<
+    Session,
+    | "role"
+    | "quick_of"
+    | "pinned"
+    | "view"
+    | "agent_type"
+    | "task_status"
+    | "pr_url"
+    | "has_brief"
+    | "archived_at"
+    | "pause_state"
+  >;
+  row?: Pick<SidebarRow, "task" | "wakesAt" | "settled">;
+  // A linked machine runs it: what can't reach it yet is left out.
+  remote: boolean;
+  canOpenInTab: boolean;
+  hasCard: boolean;
+  recipeRun: boolean;
+  hasWorkspace: boolean;
+  machineTargets: number;
+  otherProjects: number;
+}
+
+export interface RowMenuPlan {
+  sections: RowMenuEntry[][];
+  // Say once why Fork, Fresh start, project moves and check-ins are missing.
+  remoteNote: boolean;
+}
+
+const GROUP_LABEL: Record<RowMenuGroup, string> = {
+  open: "Open",
+  share: "Share",
+  restart: "Fork or restart",
+  move: "Move",
+  automate: "Automate",
+};
+export const groupLabel = (g: RowMenuGroup) => GROUP_LABEL[g];
+
+// A group of one is just that item; an empty one is nothing.
+function group(
+  g: RowMenuGroup,
+  items: (RowMenuItem | false)[]
+): RowMenuEntry[] {
+  const kept = items.filter((i): i is RowMenuItem => !!i);
+  if (kept.length === 0) return [];
+  return kept.length === 1 ? kept : [{ group: g, items: kept }];
+}
+
+export function rowMenu(input: RowMenuInput): RowMenuPlan {
+  const { session: s, row, remote } = input;
+  const plain = !!row && !row.task && !s.task_status;
+  const finish = finishActions(s, plain);
+  const sections: RowMenuEntry[][] = [];
+
+  // A quick change has no agent: its PR and the ways to finish it.
+  if (s.quick_of) {
+    sections.push(s.pr_url ? ["open-pr"] : []);
+    sections.push(finish.filter((a) => a !== "archive"));
+    sections.push(["archive", "delete"]);
+    return {
+      sections: sections.filter((x) => x.length),
+      remoteNote: false,
+    };
+  }
+
+  const orchestrator = s.role === "orchestrator";
+  const agentRow = !s.role;
+  const live = !remote;
+
+  sections.push(["rename", s.pinned ? "unpin" : "pin", "select"]);
+
+  sections.push([
+    ...group("open", [
+      input.canOpenInTab && "open-tab",
+      !!s.pr_url && "open-pr",
+      input.hasCard && "card",
+      input.recipeRun && "open-recipe",
+    ]),
+    ...group("share", ["copy-link", s.view === "chat" && "share"]),
+    ...group("restart", [
+      s.agent_type === "claude" && agentRow && live && "fork",
+      agentRow && live && "fresh-start",
+      (orchestrator || !!s.has_brief) &&
+        s.view === "chat" &&
+        !s.archived_at &&
+        live &&
+        "new-conversation",
+    ]),
+    ...group("move", [
+      input.machineTargets > 0 && "move-machine",
+      agentRow && input.otherProjects > 0 && live && "move-project",
+    ]),
+    ...group("automate", [
+      input.hasWorkspace &&
+        !orchestrator &&
+        (!s.task_status || s.task_status === "running") &&
+        live &&
+        "check-ins",
+      input.recipeRun ? "run-again" : agentRow && "save-recipe",
+    ]),
+  ]);
+
+  if (agentRow) {
+    const state: RowMenuEntry[] = [];
+    if (row?.wakesAt) state.push("unsnooze");
+    else if (!s.pinned && row) state.push("snooze");
+    const finished = !!s.task_status && s.task_status !== "running";
+    if ((s.task_status || s.view === "chat") && !finished) {
+      if (s.pause_state === "paused" || s.pause_state === "pausing")
+        state.push("resume");
+      else if (!s.pause_state) state.push("pause");
+    }
+    if (plain) state.push(row.settled ? "reopen" : "settle");
+    state.push(...finish.filter((a) => a !== "archive"));
+    sections.push(state);
+    sections.push(["archive", "delete"]);
+  }
+
+  return {
+    sections: sections.filter((x) => x.length),
+    remoteNote: remote && agentRow,
+  };
+}

package/lib/simulator/index.ts

@@ -144,6 +144,11 @@ const tail = (file: string, lines = 15) => {
 // simulator can stop it.
 const starts = new Map<string, ChildProcess>();
 
+// Simulator starts running now, for lib/busy: a restart kills them.
+export function runningStarts(): number {
+  return starts.size;
+}
+
 // The whole group: the project's build and Metro are children of the shell.
 export function killGroup(child: ChildProcess, signal: NodeJS.Signals) {
   try {
@@ -153,7 +158,7 @@ export function killGroup(child: ChildProcess, signal: NodeJS.Signals) {
   }
 }
 
-function runStart(
+export function runStart(
   sessionId: string,
   command: string,
   cwd: string,

package/lib/tasks/brief.ts

@@ -1,3 +1,5 @@
+import { loadProjectConfig } from "../project-config";
+
 // A task stacked on another task's unmerged branch.
 export interface StackedOn {
   // The parent's PR number, when it has one.
@@ -19,17 +21,30 @@ function stackedLines(baseBranch: string, stack: StackedOn): string {
 - Never merge or rebase onto the default branch yourself. When the parent merges, AgentOS rebases your branch and retargets your PR, then tells you; re-run your checks when it does. AgentOS reviews your PR itself; a review of your head still counts for the head its restack left, and a push after that gets a new one.${also}`;
 }
 
+// The project's declared test command, read from the checkout the task runs in.
+export function declaredTest(cwd: string): string | undefined {
+  return loadProjectConfig(cwd).config.test || undefined;
+}
+
+function checksLine(test?: string): string {
+  return test
+    ? `Run exactly this to check your work: \`${test}\`. CI runs the full suite on your pull request, so don't run it locally.`
+    : "Run the project's own checks (typecheck, tests, lint) when they exist and keep them passing.";
+}
+
 // The system brief every task agent runs under. It finishes by opening a PR
 // and stopping: merging is the human's sign-off, never the agent's.
 export function buildTaskBrief(opts: {
   branch: string;
   baseBranch: string;
   stack?: StackedOn;
+  // The project's `test` from agentos.json, when it declares one.
+  test?: string;
 }): string {
   return `You are running as an AgentOS background task, alone, in an isolated git worktree.
 
 - Branch: ${opts.branch} (based on ${opts.baseBranch}). Stay in this directory and on this branch.
-- Do the task fully. Run the project's own checks (typecheck, tests, lint) when they exist and keep them passing.
+- Do the task fully. ${checksLine(opts.test)}
 - When the work is done, commit with a conventional commit message, run \`git push -u origin ${opts.branch}\` and open a pull request against ${opts.baseBranch} with \`gh pr create\`, using a clear title and a short body that says what changed and how you verified it. Then stop and wait.
 - You don't need to review it yourself: AgentOS runs an independent review of the PR's exact head commit before it can merge, and the orchestrator sends you any blocking findings to fix. For a risky change you may still run \`/do-code-review\` (or \`/code-review\`) before the PR.
 - Never merge the pull request, never push to ${opts.baseBranch}, and never delete branches or worktrees. A human reviews and merges.${opts.stack ? stackedLines(opts.baseBranch, opts.stack) : ""}

package/lib/tasks/import.ts

@@ -23,7 +23,7 @@ import { resolveModelForAgent } from "../model-catalog";
 import { providerFor } from "../models/resolve";
 import { preparePlanDir, PLAN_FILE } from "../models/plan-step";
 import { carryTaskState } from "./move-carry";
-import { buildTaskBrief } from "./brief";
+import { buildTaskBrief, declaredTest } from "./brief";
 import { expandHome } from "./session";
 import { ensureProject } from "./project-ref";
 import { checkoutBranchWorktree } from "./branch-worktree";
@@ -136,7 +136,11 @@ async function arrive(
     ? bundle.model
     : resolveModelForAgent("claude", bundle.model || project.default_model);
   const baseBranch = bundle.baseBranch ?? "main";
-  const brief = buildTaskBrief({ branch: bundle.branch, baseBranch });
+  const brief = buildTaskBrief({
+    branch: bundle.branch,
+    baseBranch,
+    test: declaredTest(worktreePath),
+  });
   // Checked and written with no await between, so two can't both pass.
   db.transaction(() => {
     refuseBusyBranch(project.id, bundle.branch);

package/lib/tasks/index.ts

@@ -33,7 +33,7 @@ import { agentLabel } from "../agent-options";
 import { supportsChat } from "../chat/capabilities";
 import { AGENT_DEFAULT_MODEL } from "../providers/registry";
 import { statusDetector } from "../status-detector";
-import { buildTaskBrief, type StackedOn } from "./brief";
+import { buildTaskBrief, declaredTest, type StackedOn } from "./brief";
 import {
   attachTaskCard,
   inBackground,
@@ -354,6 +354,7 @@ async function startTask(
         branch: wt.branchName,
         baseBranch,
         stack: opts.base?.stack,
+        test: declaredTest(wt.worktreePath),
       }),
       naming.source,
       view,