@saadnvd1/agent-os 0.3.826 → 0.3.833

package/components/Chat/QuoteButton.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import { useEffect, useId, useState, type RefObject } from "react";
-import { Quote } from "lucide-react";
+import { GitFork, Quote } from "lucide-react";
 import { cn } from "@/lib/utils";
 import { useCoarsePointer } from "./composer/useCoarsePointer";
 import { useKeybindings } from "@/hooks/useKeybindings";
@@ -19,7 +19,7 @@ interface Picked {
   at: Placement | null;
 }
 
-function readSelection(root: HTMLElement): Picked | null {
+function readSelection(root: HTMLElement, half?: number): Picked | null {
   const sel = window.getSelection();
   const pick = sel && quotePick(sel, root);
   if (!pick) return null;
@@ -30,7 +30,10 @@ function readSelection(root: HTMLElement): Picked | null {
     left: Math.min(...rects.map((r) => r.left)),
     right: Math.max(...rects.map((r) => r.right)),
   };
-  return { text: pick.text, at: placeQuote(box, root.getBoundingClientRect()) };
+  return {
+    text: pick.text,
+    at: placeQuote(box, root.getBoundingClientRect(), undefined, half),
+  };
 }
 
 // "Quote" for a selection in a reply. With a mouse it floats over the
@@ -39,12 +42,16 @@ function readSelection(root: HTMLElement): Picked | null {
 export function QuoteButton({
   rootRef,
   onQuote,
+  onFork,
 }: {
   rootRef: RefObject<HTMLElement | null>;
   onQuote: (text: string) => void;
+  // Only given while forks are on: a second button beside Quote.
+  onFork?: (text: string) => void;
 }) {
   const [picked, setPicked] = useState<Picked | null>(null);
   const coarse = useCoarsePointer();
+  const wide = !!onFork;
 
   useEffect(() => {
     let frame = 0;
@@ -52,7 +59,7 @@ export function QuoteButton({
       cancelAnimationFrame(frame);
       frame = requestAnimationFrame(() => {
         const root = rootRef.current;
-        setPicked(root ? readSelection(root) : null);
+        setPicked(root ? readSelection(root, wide ? 110 : undefined) : null);
       });
     };
     document.addEventListener("selectionchange", update);
@@ -62,7 +69,7 @@ export function QuoteButton({
       document.removeEventListener("selectionchange", update);
       window.removeEventListener("scroll", update, true);
     };
-  }, [rootRef]);
+  }, [rootRef, wide]);
 
   const shown = !!picked && (coarse || !!picked.at);
   const quote = quoteAction(picked?.text, {
@@ -70,27 +77,58 @@ export function QuoteButton({
     clearSelection: () => window.getSelection()?.removeAllRanges(),
     hide: () => setPicked(null),
   });
+  const fork = quoteAction(picked?.text, {
+    onQuote: onFork ?? onQuote,
+    clearSelection: () => window.getSelection()?.removeAllRanges(),
+    hide: () => setPicked(null),
+  });
   // One source per button: each open chat pane has its own.
-  useKeybindings(`chat-quote:${useId()}`, [quoteEnter(shown, quote)]);
+  useKeybindings(`chat-quote:${useId()}`, [
+    quoteEnter(shown, quote),
+    ...(onFork
+      ? [{ ...quoteEnter(shown, fork), id: "chat.fork", keys: "f" }]
+      : []),
+  ]);
 
   if (!picked) return null;
+  const pill =
+    "bg-card popover-surface hover:bg-muted flex min-h-11 items-center gap-1.5 rounded-full px-3.5 text-sm font-medium md:min-h-8 md:px-3 pointer-coarse:min-h-11";
   const button = (
-    <button
-      type="button"
-      // Pressing it mustn't clear the selection before it's read.
-      onMouseDown={(e) => e.preventDefault()}
-      onClick={quote}
-      className="bg-card popover-surface hover:bg-muted flex min-h-11 items-center gap-1.5 rounded-full px-3.5 text-sm font-medium md:min-h-8 md:px-3 pointer-coarse:min-h-11"
-    >
-      <Quote className="h-3.5 w-3.5" />
-      Quote
-      <kbd
-        aria-hidden
-        className="text-muted-foreground bg-muted hidden rounded px-1 font-mono text-[10px] leading-4 md:inline"
+    <div className="flex items-center gap-1.5">
+      <button
+        type="button"
+        // Pressing it mustn't clear the selection before it's read.
+        onMouseDown={(e) => e.preventDefault()}
+        onClick={quote}
+        className={pill}
       >
-        ↵
-      </kbd>
-    </button>
+        <Quote className="h-3.5 w-3.5" />
+        Quote
+        <kbd
+          aria-hidden
+          className="text-muted-foreground bg-muted hidden rounded px-1 font-mono text-[10px] leading-4 md:inline"
+        >
+          ↵
+        </kbd>
+      </button>
+      {onFork && (
+        <button
+          type="button"
+          onMouseDown={(e) => e.preventDefault()}
+          onClick={fork}
+          className={pill}
+        >
+          <GitFork className="h-3.5 w-3.5" />
+          Fork
+          <kbd
+            aria-hidden
+            className="text-muted-foreground bg-muted hidden rounded px-1 font-mono text-[10px] leading-4 md:inline"
+          >
+            F
+          </kbd>
+        </button>
+      )}
+    </div>
   );
   if (coarse)
     return <div className="mb-2 flex justify-center select-none">{button}</div>;

package/components/Chat/TimelineRows.tsx

@@ -55,6 +55,7 @@ function Item({
       return (
         <UserTurn
           item={item}
+          onQuote={actions.onQuote}
           onUndo={
             item.checkpoint && actions.onUndo
               ? () => actions.onUndo?.(item.id)

package/components/Chat/composer/ComposerBody.tsx

@@ -32,6 +32,7 @@ import { offeredSuggestion } from "@/lib/chat/suggestion";
 import { historyStep } from "@/lib/chat/history";
 import { markdownParagraphs } from "@/lib/chat/quote";
 import { insertMarkdown } from "./insert";
+import { ForkHeader, type ForkComposer } from "./ForkHeader";
 import { useCoarsePointer } from "./useCoarsePointer";
 import { useMentions } from "./useMentions";
 import { Attachments } from "./Attachments";
@@ -52,6 +53,9 @@ export interface ComposerProps {
   running: boolean;
   disabled?: boolean;
   placeholder: string;
+  // The send button's label, when Enter does something else than send.
+  // Fork mode: the quote chip, pill and own-checkout choice.
+  fork?: ForkComposer;
   onSend: (text: string, images: ChatImage[], files: ChatFile[]) => void;
   // Where attached files are kept: the session's id, or "draft" before one exists.
   attachScope: string;
@@ -94,6 +98,7 @@ export function ComposerBody({
   running,
   disabled,
   placeholder,
+  fork,
   onSend,
   onStop,
   commands = [],
@@ -270,7 +275,11 @@ export function ComposerBody({
   const { dragging, dropProps, addFiles } = attach;
 
   const empty =
-    !text.trim() && !images.length && !files.length && !attach.uploads.length;
+    !fork?.quote &&
+    !text.trim() &&
+    !images.length &&
+    !files.length &&
+    !attach.uploads.length;
   const submit = () => {
     if (empty || disabled || attach.uploading) return;
     const used = leadingCommand(text)?.slice(1);
@@ -358,9 +367,10 @@ export function ComposerBody({
         {...dropProps}
         className={cn(
           "bg-card popover-surface rounded-2xl p-2 transition-shadow",
-          dragging && "ring-primary ring-2"
+          (dragging || fork) && "ring-primary ring-2"
         )}
       >
+        {fork && <ForkHeader fork={fork} />}
         <Attachments
           images={images}
           files={files}
@@ -393,6 +403,8 @@ export function ComposerBody({
           onStop={onStop}
           canSend={!disabled && !empty && !attach.uploading}
           onSend={submit}
+          sendLabel={fork ? "Start fork" : undefined}
+          fork={fork}
         />
       </div>
     </div>

package/components/Chat/composer/ForkHeader.tsx

@@ -0,0 +1,55 @@
+"use client";
+
+import { GitFork, Quote, X } from "lucide-react";
+
+export interface ForkComposer {
+  // The selection being forked; the instruction is this plus what's typed.
+  quote: string;
+  own: boolean;
+  onOwn: () => void;
+  onLeave: () => void;
+  onDropQuote: () => void;
+}
+
+// Top of the composer in Fork mode: the pill that marks it, what the keys do,
+// and the selection as a chip.
+export function ForkHeader({ fork }: { fork: ForkComposer }) {
+  return (
+    <div className="mb-1.5 space-y-1.5">
+      <div className="flex items-center gap-2">
+        <span className="bg-primary/10 text-primary flex h-8 items-center gap-1.5 rounded-lg pr-1 pl-2.5 text-xs font-medium">
+          <GitFork aria-hidden className="size-3.5" />
+          Fork
+          <button
+            type="button"
+            onMouseDown={(e) => e.preventDefault()}
+            onClick={fork.onLeave}
+            aria-label="Cancel fork"
+            className="hover:bg-primary/15 flex size-6 items-center justify-center rounded-md"
+          >
+            <X aria-hidden className="size-3.5" />
+          </button>
+        </span>
+        <span className="flex-1" />
+        <span className="text-muted-foreground hidden text-xs md:inline">
+          ↵ start · Esc cancel
+        </span>
+      </div>
+      {fork.quote && (
+        <div className="bg-muted/60 text-muted-foreground flex items-start gap-2 rounded-lg py-1.5 pr-1 pl-2.5 text-sm">
+          <Quote aria-hidden className="mt-1 size-3.5 shrink-0" />
+          <p className="line-clamp-2 min-w-0 flex-1">{fork.quote}</p>
+          <button
+            type="button"
+            onMouseDown={(e) => e.preventDefault()}
+            onClick={fork.onDropQuote}
+            aria-label="Remove quote"
+            className="hover:text-foreground flex size-8 shrink-0 items-center justify-center"
+          >
+            <X aria-hidden className="size-4" />
+          </button>
+        </div>
+      )}
+    </div>
+  );
+}

package/components/Chat/composer/Toolbar.tsx

@@ -3,6 +3,8 @@
 import { useRef, useState } from "react";
 import {
   ArrowUp,
+  Folder,
+  GitFork,
   Paperclip,
   ListChecks,
   MonitorUp,
@@ -41,6 +43,8 @@ export function Toolbar({
   onStop,
   canSend,
   onSend,
+  sendLabel = "Send",
+  fork,
 }: {
   plain: boolean;
   onTogglePlain: () => void;
@@ -65,6 +69,9 @@ export function Toolbar({
   onStop: () => void;
   canSend: boolean;
   onSend: () => void;
+  sendLabel?: string;
+  // Fork mode: the own-checkout choice, and a send button that says what it does.
+  fork?: { own: boolean; onOwn: () => void };
 }) {
   const fileRef = useRef<HTMLInputElement>(null);
   const formatting = plain ? "Formatting off" : "Formatting on";
@@ -103,7 +110,7 @@ export function Toolbar({
           e.target.value = "";
         }}
       />
-      {canCapture && (
+      {canCapture && !fork && (
         <Button
           type="button"
           variant="ghost"
@@ -135,10 +142,28 @@ export function Toolbar({
           <span className={plan ? "" : "hidden sm:inline"}>Plan</span>
         </button>
       )}
-      {onSetAccess && access && (
+      {fork && (
+        <button
+          type="button"
+          aria-pressed={fork.own}
+          title="Own checkout lets the fork edit code; off, it reads this checkout and leaves it alone"
+          onMouseDown={(e) => e.preventDefault()}
+          onClick={fork.onOwn}
+          className={cn(
+            "flex h-10 shrink-0 items-center gap-1 rounded-lg px-2 text-xs",
+            fork.own
+              ? "bg-primary/10 text-primary"
+              : "text-muted-foreground hover:text-foreground hover:bg-foreground/[0.05]"
+          )}
+        >
+          <Folder className="h-3.5 w-3.5" />
+          {fork.own ? "Own checkout" : "Reads only"}
+        </button>
+      )}
+      {!fork && onSetAccess && access && (
         <AccessPicker access={access} onPick={onSetAccess} />
       )}
-      {onSetModel && (
+      {!fork && onSetModel && (
         <ModelPicker
           models={models}
           model={model}
@@ -150,7 +175,7 @@ export function Toolbar({
         />
       )}
       <span className="flex-1" />
-      {accessory}
+      {!fork && accessory}
       <Button
         type="button"
         variant="ghost"
@@ -183,14 +208,25 @@ export function Toolbar({
         <Button
           type="button"
           size="icon"
-          aria-label="Send"
-          className="h-10 w-10 shrink-0 rounded-xl"
+          aria-label={sendLabel}
+          title={sendLabel}
+          className={cn(
+            "h-10 shrink-0 rounded-xl",
+            fork ? "w-auto gap-1.5 px-3.5" : "w-10"
+          )}
           disabled={!canSend}
           // Tapping send mustn't blur the editor and drop the keyboard.
           onMouseDown={(e) => e.preventDefault()}
           onClick={onSend}
         >
-          <ArrowUp className="h-4 w-4" />
+          {fork ? (
+            <>
+              <GitFork className="h-3.5 w-3.5" />
+              Start fork
+            </>
+          ) : (
+            <ArrowUp className="h-4 w-4" />
+          )}
         </Button>
       )}
     </div>

package/components/Chat/quote-selection.ts

@@ -103,9 +103,13 @@ export interface Placement {
 
 // Where the floating button goes, kept inside the visible chat (`view`),
 // which ends above the composer. Null when the selection is scrolled out.
-export function placeQuote(sel: Box, view: Box, size = 48): Placement | null {
+export function placeQuote(
+  sel: Box,
+  view: Box,
+  size = 48,
+  half = 60
+): Placement | null {
   if (sel.bottom < view.top || sel.top > view.bottom) return null;
-  const half = 60;
   const mid = (sel.left + sel.right) / 2;
   const x = Math.min(Math.max(mid, view.left + half), view.right - half);
   if (sel.top - size >= view.top) return { x, y: sel.top, side: "above" };

package/content/whats-new.json

@@ -1937,6 +1937,22 @@
       "area": "Chat",
       "text": "Cancelled questions from GitHub Copilot chats now clear right away instead of staying on screen.",
       "url": "https://github.com/saadnvd1/agent-os/pull/552"
+    },
+    {
+      "id": 555,
+      "date": "2026-11-02",
+      "kind": "fixed",
+      "area": "Updates",
+      "text": "Automatic updates no longer get stuck after the first one because of a file the build rewrites.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/555"
+    },
+    {
+      "id": 558,
+      "date": "2026-11-02",
+      "kind": "improved",
+      "area": "AgentOS",
+      "text": "Select text in a chat reply and tap Fork to hand it to a background copy of the session; its result comes back as a card.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/558"
     }
   ]
 }

package/data/fork/index.ts

@@ -53,7 +53,12 @@ export function useForkChildren(sessionId: string, enabled: boolean) {
 export function useStartForks(sessionId: string) {
   const queryClient = useQueryClient();
   return useMutation({
-    mutationFn: async (input: { instructions: string[]; worktree: boolean }) =>
+    mutationFn: async (input: {
+      instructions: string[];
+      worktree: boolean;
+      labels?: string[];
+      delivery?: "wake" | "next";
+    }) =>
       json<{ children: { id: string; n: number; label: string }[] }>(
         await fetch("/api/fork", {
           method: "POST",

package/lib/chat/commands.ts

@@ -83,21 +83,6 @@ export function withFresh(commands: ChatCommand[]): ChatCommand[] {
     : [FRESH_COMMAND, ...commands];
 }
 
-// AgentOS's own command when forks are on: opens the fork sheet.
-export const FORK_COMMAND: ChatCommand = {
-  name: "fork",
-  description: "Start background copies of this session",
-};
-
-export const isForkCommand = (text: string): boolean =>
-  text.trim().toLowerCase() === "/fork";
-
-export function withFork(commands: ChatCommand[]): ChatCommand[] {
-  return commands.some((c) => c.name === "fork")
-    ? commands
-    : [FORK_COMMAND, ...commands];
-}
-
 export interface MenuGroup {
   label: string;
   commands: ChatCommand[];

package/lib/chat/events.ts

@@ -106,6 +106,9 @@ export interface ChatOrigin {
   body?: string;
   // Lines of an event batch that are the reader's answers to asks.
   decided?: string[];
+  // A fork delivery: the parent and the children it carries, shown as result
+  // cards (lib/fork/deliver).
+  forks?: { parent: string; ids: string[] };
   // The tasks it is about, by name, set where the event is delivered.
   subjects?: { id: string; name: string }[];
   // Only Away mode's own lines: the turn it starts isn't anyone's activity

package/lib/fork/brief.ts

@@ -3,7 +3,7 @@
 import { FORK_LIMITS } from "./options";
 import type { ChildRow } from "./types";
 
-export const PARENT_BRIEF = `Forks: when you have independent side work, \`aos fork "<instruction>" ["<instruction>" …]\` starts that many background copies of you (up to ${FORK_LIMITS.maxPerFork}) that know what you know. It returns at once; you keep working. Their results arrive as a message when they finish, or after \`aos wait children --all|--any [--timeout 30m]\` (end your turn; you're woken with them). \`aos children\` lists them, \`aos children <n>\` shows a full result, \`aos cancel <n>|--all\` stops them. Children have your abilities and work in your checkout: tell one that has to edit code to \`--worktree\` (its own throwaway checkout). Fork only work that doesn't depend on your next step.`;
+export const PARENT_BRIEF = `Forks: when the user asks you to fork, or to do things in parallel in background copies, run \`aos fork "<instruction>" ...\` (one instruction per fork), keep working, and results arrive as a message. Also when you have independent side work, \`aos fork "<instruction>" ["<instruction>" …]\` starts that many background copies of you (up to ${FORK_LIMITS.maxPerFork}) that know what you know. It returns at once; you keep working. Their results arrive as a message when they finish, or after \`aos wait children --all|--any [--timeout 30m]\` (end your turn; you're woken with them). \`aos children\` lists them, \`aos children <n>\` shows a full result, \`aos cancel <n>|--all\` stops them. Children have your abilities and work in your checkout: tell one that has to edit code to \`--worktree\` (its own throwaway checkout). Fork only work that doesn't depend on your next step.`;
 
 export const CHILD_BRIEF = `You are a fork child: a background copy of another session, started to do one piece of work and report back. You have its abilities, not its checkout: don't change the parent's files, push, open a PR or fork. Put temp work (scripts, repros, notes) in $AOS_SCRATCH. Run builds and tests only through \`aos heavy -- <command>\`, which queues you with the other forks. To ask the parent something, \`aos send <parent> "<question>"\`; that doesn't finish you. When done, \`aos return "<result>"\` (first line: the answer in a sentence; then the detail; \`--failed\` if you couldn't do it). Your reply when you end your turn without it is used as the result, after a short wait.`;
 
@@ -41,7 +41,9 @@ const outcomeWord = (c: ChildRow) =>
     ? "failed"
     : c.outcome === "cancelled"
       ? "cancelled"
-      : "done";
+      : c.outcome === "empty"
+        ? "ended with no result"
+        : "done";
 
 // One delivery: every result in the batch, whole when short, else its
 // summary and the command that reads the rest.

package/lib/fork/deliver.ts

@@ -34,7 +34,12 @@ async function send(parentId: string, deliveryId: string, rows: ChildRow[]) {
     text,
     queue: true,
     from: "AgentOS",
-    origin: { kind: "event", label: "Forks", body },
+    origin: {
+      kind: "event",
+      label: "Forks",
+      body,
+      forks: { parent: parentId, ids: rows.map((c) => c.child_session_id) },
+    },
   });
   markDelivered(deliveryId);
 }

package/lib/fork/ledger.ts

@@ -176,6 +176,11 @@ export function summaryOf(text: string): string {
   return one.length <= max ? one : `${one.slice(0, max - 1)}…`;
 }
 
+// A result that says nothing: blank, or one bare flag (`--help`) a child took
+// for its answer. A quoted sentence that starts with dashes is still an answer.
+export const isNonAnswer = (text: string | null | undefined): boolean =>
+  !text?.trim() || /^--?[a-z][a-z-]*$/i.test(text.trim());
+
 export const capResult = (text: string): string =>
   text.length <= FORK_LIMITS.resultChars
     ? text

package/lib/fork/settle.ts

@@ -22,6 +22,7 @@ import {
   updateResult,
   childrenOf,
   findChild,
+  isNonAnswer,
   markDeliveredIds,
 } from "./ledger";
 import { FORK_LIMITS } from "./options";
@@ -120,7 +121,11 @@ export async function returnChild(
   if (!row) throw new Error("Only a fork child can return a result");
   const body = text.trim();
   if (!body) throw new Error('Give the result: aos return "<result>"');
-  const outcome: ChildOutcome = failed ? "failed" : "ok";
+  const outcome: ChildOutcome = failed
+    ? "failed"
+    : isNonAnswer(body)
+      ? "empty"
+      : "ok";
   if (
     await settleAndDeliver(childId, {
       outcome,
@@ -205,10 +210,9 @@ export async function lookAtChild(row: ChildRow, now: number): Promise<void> {
   // It asked its parent something and is waiting for the answer.
   if (openWaits().some((w) => w.waiter_id === row.child_session_id)) return;
   const reply = lastReply(row.child_session_id);
-  if (!reply) return;
   await settleAndDeliver(row.child_session_id, {
-    outcome: "ok",
-    summary: summaryOf(reply),
+    outcome: isNonAnswer(reply) ? "empty" : "ok",
+    summary: reply ? summaryOf(reply) : "ended without a result",
     result: reply,
     kind: "implicit",
   });

package/lib/fork/types.ts

@@ -1,7 +1,9 @@
 export type ChildState =
   "queued" | "starting" | "running" | "needs_input" | "settled";
 
-export type ChildOutcome = "ok" | "failed" | "cancelled";
+// `empty`: it ended, but with nothing to read (blank, or a bare flag like
+// "--help"), so it isn't shown as a finished answer.
+export type ChildOutcome = "ok" | "failed" | "cancelled" | "empty";
 
 // `implicit`: the child's turn ended without `aos return`, so its final
 // answer stands in (kept apart so stats can tell them).
@@ -59,6 +61,8 @@ export interface ChildView {
   hold: string | null;
   outcome: ChildOutcome | null;
   summary: string | null;
+  // The start of its result, for the card in the parent's chat.
+  excerpt: string | null;
   resultKind: ResultKind | null;
   worktree: boolean;
   fellBack: boolean;

package/lib/fork/view.ts

@@ -13,6 +13,7 @@ export const childView = (c: ChildRow): ChildView => ({
   hold: c.hold,
   outcome: c.outcome,
   summary: c.summary,
+  excerpt: c.result ? c.result.slice(0, 600) : null,
   resultKind: c.result_kind,
   worktree: !!c.worktree,
   fellBack: !!c.fell_back,
@@ -61,6 +62,7 @@ export interface ForkStats {
   ok: number;
   failed: number;
   cancelled: number;
+  empty: number;
   implicit: number;
   fellBack: number;
   medianSeconds: number | null;
@@ -83,6 +85,7 @@ export function statsOf(rows: ChildRow[]): ForkStats {
     ok: done.filter((c) => c.outcome === "ok").length,
     failed: done.filter((c) => c.outcome === "failed").length,
     cancelled: done.filter((c) => c.outcome === "cancelled").length,
+    empty: done.filter((c) => c.outcome === "empty").length,
     implicit: done.filter(
       (c) => c.result_kind === "implicit" && c.outcome === "ok"
     ).length,
@@ -106,7 +109,7 @@ export function statsText(s: ForkStats): string {
   const pct = (n: number) =>
     s.settled ? `${Math.round((n / s.settled) * 100)}%` : "-";
   return [
-    `${s.children} children, ${s.settled} settled (${s.ok} ok, ${s.failed} failed, ${s.cancelled} cancelled)`,
+    `${s.children} children, ${s.settled} settled (${s.ok} ok, ${s.failed} failed, ${s.cancelled} cancelled, ${s.empty} no result)`,
     `returned without aos return: ${s.implicit} (${pct(s.implicit)}); started from a brief, not a fork: ${s.fellBack}`,
     `median time to settle: ${s.medianSeconds ?? "-"}s`,
     `tokens: ${s.tokensIn} in, ${s.tokensOut} out, ${s.cacheRead} cache read`,

package/lib/updates/generated.ts

@@ -0,0 +1,29 @@
+import fs from "fs";
+import path from "path";
+
+/** Files the build rewrites in a checkout; one list for the updater and the deploy scripts. */
+export function generatedFiles(root: string): string[] {
+  try {
+    return fs
+      .readFileSync(path.join(root, "scripts/generated-files.txt"), "utf8")
+      .split("\n")
+      .map((l) => l.trim())
+      .filter((l) => l && !l.startsWith("#"));
+  } catch {
+    return [];
+  }
+}
+
+/** Splits `git status --porcelain` paths into generated files and real local changes. */
+export function splitDirty(
+  porcelain: string,
+  generated: string[]
+): { generated: string[]; blocking: string[] } {
+  const out = { generated: [] as string[], blocking: [] as string[] };
+  for (const line of porcelain.split("\n")) {
+    const file = line.slice(3).trim();
+    if (!file) continue;
+    (generated.includes(file) ? out.generated : out.blocking).push(file);
+  }
+  return out;
+}