@neriros/ralphy 3.10.4 → 3.10.6

package/dist/shell/index.js

@@ -18928,8 +18928,8 @@ import { readFileSync } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("3.10.4")
-      return "3.10.4";
+    if ("3.10.6")
+      return "3.10.6";
   } catch {}
   const dirsToTry = [];
   try {
@@ -80505,7 +80505,21 @@ var init_zod = __esm(() => {
 });
 
 // packages/workflow/src/schema.ts
-var CURRENT_WORKFLOW_VERSION = 2, MarkerSchema, SET_INDICATOR_KEYS, GetIndicatorSchema, SetIndicatorSchema, IndicatorsSchema, ProjectSchema, CommandsSchema, DEFAULT_META_ONLY_FILES, BoundariesSchema, WorkflowConfigSchema;
+function foldLegacyAssignee(v) {
+  if (!v || typeof v !== "object" || Array.isArray(v))
+    return v;
+  const obj = v;
+  if (!("assignee" in obj))
+    return v;
+  const { assignee, ...rest2 } = obj;
+  if (rest2["filter"] === undefined) {
+    const raw = typeof assignee === "string" ? assignee.trim() : "";
+    const value = raw === "" || raw.toLowerCase() === "unassigned" ? "unassigned" : raw;
+    rest2["filter"] = `assignee = ${value}`;
+  }
+  return rest2;
+}
+var CURRENT_WORKFLOW_VERSION = 3, MarkerSchema, SET_INDICATOR_KEYS, GetIndicatorSchema, SetIndicatorSchema, IndicatorsSchema, ProjectSchema, CommandsSchema, DEFAULT_META_ONLY_FILES, BoundariesSchema, WorkflowConfigSchema;
 var init_schema = __esm(() => {
   init_zod();
   MarkerSchema = exports_external.discriminatedUnion("type", [
@@ -80635,9 +80649,9 @@ var init_schema = __esm(() => {
     ignoreCiChecks: exports_external.array(exports_external.string()).default([]),
     engine: exports_external.enum(["claude", "codex"]).default("claude"),
     model: exports_external.enum(["haiku", "sonnet", "opus"]).default("opus"),
-    linear: exports_external.object({
+    linear: exports_external.preprocess(foldLegacyAssignee, exports_external.object({
       team: exports_external.string().optional(),
-      assignee: exports_external.string().optional(),
+      filter: exports_external.string().default("assignee = me"),
       postComments: exports_external.boolean().default(true),
       updateEveryIterations: exports_external.number().int().nonnegative().default(10),
       mentionTrigger: exports_external.boolean().default(true),
@@ -80657,7 +80671,8 @@ var init_schema = __esm(() => {
         maxConfirmationRounds: 3
       }),
       indicators: IndicatorsSchema.default({})
-    }).strict().default({
+    }).strict()).default({
+      filter: "assignee = me",
       postComments: true,
       updateEveryIterations: 10,
       mentionTrigger: true,
@@ -80746,7 +80761,7 @@ var init_schema = __esm(() => {
 var FRONTMATTER_RE, DEFAULT_WORKFLOW_MD = `---
 # WORKFLOW.md schema version \u2014 managed by \`ralphy init\`. When a newer version
 # ships, re-running init migrates this file and fills in the new settings.
-version: 1
+version: 2
 
 project:
   name: ralphy
@@ -80810,6 +80825,7 @@ preExistingErrorCheck:
   outputCharLimit: 4000
 
 linear:
+  filter: assignee = me
   postComments: true
   updateEveryIterations: 10
   mentionTrigger: true
@@ -81056,7 +81072,7 @@ function modelOptionValues() {
   const field = findField("model");
   return field && field.spec.kind === "select" ? field.spec.options.map((o) => o.value) : [];
 }
-var PROMPT_BODY_FIELD_ID = "promptBody", REPO_LINK_FIELD_ID = "repo.link", yes = () => ({ kind: "confirm", defaultChoice: "confirm" }), no = () => ({ kind: "confirm", defaultChoice: "cancel" }), PROJECT_NAME, LINEAR_TEAM, REPO_LINK, LINEAR_ASSIGNEE, QUICK_FIELDS, isOn = (id) => (answers) => answers[id] === true, CUSTOMIZED_FIELDS, COMMON_CLI_OPTIONS, FIELD_DESCRIPTIONS;
+var PROMPT_BODY_FIELD_ID = "promptBody", REPO_LINK_FIELD_ID = "repo.link", yes = () => ({ kind: "confirm", defaultChoice: "confirm" }), no = () => ({ kind: "confirm", defaultChoice: "cancel" }), PROJECT_NAME, LINEAR_TEAM, REPO_LINK, LINEAR_FILTER, QUICK_FIELDS, isOn = (id) => (answers) => answers[id] === true, CUSTOMIZED_FIELDS, COMMON_CLI_OPTIONS, FIELD_DESCRIPTIONS;
 var init_fields = __esm(() => {
   PROJECT_NAME = {
     id: "project.name",
@@ -81079,15 +81095,15 @@ var init_fields = __esm(() => {
     spec: yes(),
     when: (answers) => typeof answers["repo.name"] === "string" && answers["repo.name"] !== ""
   };
-  LINEAR_ASSIGNEE = {
-    id: "linear.assignee",
-    label: "Linear assignee",
-    hint: "user id, email, 'me', 'any', or 'unassigned' \u2014 blank means unassigned",
-    description: "Which issues to pick up by assignee. Use a Linear user id, email, or 'me' for a specific person; 'any' to pick up issues regardless of who they're assigned to; 'unassigned' (or blank) to pick up only unassigned issues.",
-    emptyLabel: "unassigned",
-    spec: { kind: "text" }
+  LINEAR_FILTER = {
+    id: "linear.filter",
+    label: "Linear filter",
+    hint: "e.g. 'assignee = me', 'assignee = any', 'assignee = unassigned', or an email/user-id",
+    description: "Global filter applied to every Linear ticket fetch. The only clause today is 'assignee = <value>', where <value> is 'me' (issues assigned to you), 'any' (regardless of assignee), 'unassigned', a Linear user id, or an email. Blank defaults to 'assignee = me'.",
+    emptyLabel: "assignee = me",
+    spec: { kind: "text", placeholder: "assignee = me" }
   };
-  QUICK_FIELDS = [PROJECT_NAME, LINEAR_TEAM, REPO_LINK, LINEAR_ASSIGNEE];
+  QUICK_FIELDS = [PROJECT_NAME, LINEAR_TEAM, REPO_LINK, LINEAR_FILTER];
   CUSTOMIZED_FIELDS = [
     PROJECT_NAME,
     {
@@ -81336,7 +81352,7 @@ var init_fields = __esm(() => {
     },
     LINEAR_TEAM,
     REPO_LINK,
-    LINEAR_ASSIGNEE,
+    LINEAR_FILTER,
     {
       id: "linear.postComments",
       label: "Post progress comments on the Linear issue?",
@@ -81725,6 +81741,34 @@ function describeApprovalMarker(indicator) {
   return `${phrases.slice(0, -1).join(", ")}, or ${phrases[phrases.length - 1]}`;
 }
 
+// packages/workflow/src/linear-filter.ts
+function parseLinearFilter(filter2) {
+  const trimmed = filter2.trim();
+  if (trimmed === "")
+    return { assignee: "me" };
+  const eq = trimmed.indexOf("=");
+  if (eq < 0) {
+    throw new Error(`Invalid linear.filter "${filter2}": expected "<key> = <value>" (e.g. "assignee = me").`);
+  }
+  const key = trimmed.slice(0, eq).trim().toLowerCase();
+  const value = trimmed.slice(eq + 1).trim();
+  if (!SUPPORTED_KEYS.has(key)) {
+    throw new Error(`Unrecognized linear.filter key "${key}" in "${filter2}". Supported keys: ${[...SUPPORTED_KEYS].join(", ")}.`);
+  }
+  const lower = value.toLowerCase();
+  if (lower === "any")
+    return { anyAssignee: true };
+  if (lower === "" || lower === "unassigned")
+    return { assignee: "unassigned" };
+  if (lower === "me")
+    return { assignee: "me" };
+  return { assignee: value };
+}
+var SUPPORTED_KEYS;
+var init_linear_filter = __esm(() => {
+  SUPPORTED_KEYS = new Set(["assignee"]);
+});
+
 // packages/workflow/src/workflow.ts
 var exports_workflow = {};
 __export(exports_workflow, {
@@ -81733,6 +81777,7 @@ __export(exports_workflow, {
   renderWorkflowPrompt: () => renderWorkflowPrompt,
   renderTemplate: () => renderTemplate,
   parseWorkflow: () => parseWorkflow,
+  parseLinearFilter: () => parseLinearFilter,
   matchesIndicator: () => matchesIndicator,
   loadWorkflow: () => loadWorkflow,
   ensureWorkflow: () => ensureWorkflow,
@@ -81896,6 +81941,7 @@ var init_workflow = __esm(() => {
   init_wizard();
   init_schema();
   init_default();
+  init_linear_filter();
   import_yaml2 = __toESM(require_dist(), 1);
 });
 
@@ -83968,6 +84014,11 @@ var init_migrations = __esm(() => {
       version: 2,
       description: "Ralphy now detects the current git repo and records it in WORKFLOW.md, " + "linking it to your Linear team. Confirm the detected repo to adopt it.",
       fields: ["repo.link"]
+    },
+    {
+      version: 3,
+      description: "The per-workflow `linear.assignee` setting is replaced by a global " + "`linear.filter` expression (e.g. `assignee = me`) applied to every " + "ticket fetch. Existing `assignee` values are folded in automatically; " + "note that an empty filter now defaults to `assignee = me` (it previously " + "meant unassigned-only).",
+      fields: ["linear.filter"]
     }
   ];
   LATEST_MIGRATION_VERSION = MIGRATIONS.reduce((max2, migration) => Math.max(max2, migration.version), 0);
@@ -84055,8 +84106,8 @@ function initialValuesFromConfig(config2) {
   values2["useWorktree"] = config2.useWorktree;
   if (config2.linear.team)
     values2["linear.team"] = config2.linear.team;
-  if (config2.linear.assignee)
-    values2["linear.assignee"] = config2.linear.assignee;
+  if (config2.linear.filter)
+    values2["linear.filter"] = config2.linear.filter;
   return values2;
 }
 async function promptEditOrExit() {
@@ -101403,6 +101454,7 @@ async function parseAgentArgs(argv) {
     ...common2,
     mode: "agent",
     linearTeam: "",
+    linearFilter: "",
     linearAssignee: "",
     pollInterval: 0,
     concurrency: 0,
@@ -101419,10 +101471,12 @@ async function parseAgentArgs(argv) {
     noTmux: false,
     checks: false,
     review: false,
+    agentDebug: false,
     ticketTokens: []
   };
   const state = emptyParseState();
   let expectLinearTeam = false;
+  let expectLinearFilter = false;
   let expectLinearAssignee = false;
   let expectPollInterval = false;
   let expectConcurrency = false;
@@ -101436,6 +101490,11 @@ async function parseAgentArgs(argv) {
       expectLinearTeam = false;
       continue;
     }
+    if (expectLinearFilter) {
+      result2.linearFilter = arg;
+      expectLinearFilter = false;
+      continue;
+    }
     if (expectLinearAssignee) {
       result2.linearAssignee = arg;
       expectLinearAssignee = false;
@@ -101481,6 +101540,9 @@ async function parseAgentArgs(argv) {
       case "--linear-team":
         expectLinearTeam = true;
         break;
+      case "--linear-filter":
+        expectLinearFilter = true;
+        break;
       case "--linear-assignee":
         expectLinearAssignee = true;
         break;
@@ -101532,6 +101594,9 @@ async function parseAgentArgs(argv) {
       case "--debug":
         result2.debug = true;
         break;
+      case "--agent-debug":
+        result2.agentDebug = true;
+        break;
       case "--pre-existing-error-check":
         result2.preExistingErrorCheck = true;
         break;
@@ -101605,7 +101670,8 @@ var init_cli2 = __esm(() => {
     "  --log                   Log raw engine stream",
     "  --verbose               Verbose output",
     "  --linear-team <key>     Linear team key (e.g. ENG)",
-    "  --linear-assignee <id>  Filter by assignee (user id, email, or 'me')",
+    "  --linear-filter <expr>  Global Linear filter (e.g. 'assignee = me', 'assignee = any')",
+    "  --linear-assignee <id>  [deprecated] Filter by assignee; use --linear-filter instead",
     "  --poll-interval <s>     Seconds between Linear polls (default: 60)",
     "  --concurrency <n>       Max concurrent task loops (default: 1)",
     "  --worktree              Run each task in its own git worktree",
@@ -101630,6 +101696,7 @@ var init_cli2 = __esm(() => {
     "  --checks                List mode: show failing CI check names per PR",
     "  --review                List mode: show unresolved review comment count per PR",
     "  --debug                 List mode: explain why a Linear ticket was not picked up (use with --name)",
+    "  --agent-debug           After each ticket finishes, run a one-shot self-review and write a report to ~/.ralph/retro/",
     "  --help, -h              Show this help message",
     "",
     "Examples:",
@@ -102290,9 +102357,11 @@ async function fetchMentionScanIssues(apiKey, spec) {
   const where = branches.length === 1 ? { ...branches[0] } : { or: branches };
   if (spec.team)
     where.team = { key: { eq: spec.team } };
-  if (spec.assignee) {
+  if (spec.anyAssignee || spec.assignee === "any") {} else if (spec.assignee) {
     if (spec.assignee === "me")
       where.assignee = { isMe: { eq: true } };
+    else if (spec.assignee === "unassigned")
+      where.assignee = { null: true };
     else if (spec.assignee.includes("@"))
       where.assignee = { email: { eq: spec.assignee } };
     else
@@ -104487,6 +104556,15 @@ async function runPostTask(input, deps) {
   emit3(succeeded ? "done" : "gave-up", succeeded ? undefined : `exit ${effectiveCode}`);
   if (!succeeded)
     await recordGaveUp(stateFilePath, log3, changeName);
+  await deps.runRetrospective?.({
+    changeName,
+    cwd: cwd2,
+    changeDir,
+    stateFilePath,
+    branch,
+    issue: issue2,
+    effectiveCode
+  });
   await runWorktreeCleanupPhase({ changeName, cwd: cwd2, projectRoot, useWorktree, effectiveCode, cfg }, { git: git2, log: log3, emit: emit3 });
   await runTeardownPhase({ cwd: cwd2, teardownScript: cfg.teardownScript }, { runScript, log: log3, emit: emit3 });
   return effectiveCode;
@@ -104893,6 +104971,7 @@ class AgentCoordinator {
         ciFailed: 0,
         review: 0,
         mentions: mentions.length,
+        quarantined: 0,
         awaiting: awaitingCount
       };
       const found2 = buckets2.todo + buckets2.inProgress + buckets2.mentions + buckets2.awaiting;
@@ -104987,6 +105066,7 @@ class AgentCoordinator {
       ciFailed: prStatus.ciFailed,
       review: 0,
       mentions: mentions.length,
+      quarantined: prStatus.quarantined,
       awaiting: awaitingCount
     };
     const found = buckets.todo + buckets.inProgress + buckets.conflicted + buckets.ciFailed + buckets.mentions + buckets.awaiting;
@@ -105152,6 +105232,32 @@ class AgentCoordinator {
     if (!this.deps.syncTasks || !this.deps.getIterationCount)
       return;
     for (const w of this.workers) {
+      if (this.deps.getTasksFingerprint) {
+        let fingerprint;
+        try {
+          fingerprint = await this.deps.getTasksFingerprint(w.changeName);
+        } catch (err) {
+          this.deps.onLog(`! tasks fingerprint read failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
+          continue;
+        }
+        if (fingerprint === null || fingerprint === w.lastSyncedTasksFingerprint) {
+          continue;
+        }
+        let iteration;
+        try {
+          iteration = await this.deps.getIterationCount(w.changeName);
+        } catch (err) {
+          this.deps.onLog(`! iteration count read failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
+          continue;
+        }
+        try {
+          await this.deps.syncTasks(w, iteration);
+          w.lastSyncedTasksFingerprint = fingerprint;
+        } catch (err) {
+          this.deps.onLog(`! sync-tasks (poll) failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
+        }
+        continue;
+      }
       let count;
       try {
         count = await this.deps.getIterationCount(w.changeName);
@@ -105182,6 +105288,7 @@ class AgentCoordinator {
       return counts;
     const preQueue = this.queue.map((q) => ({ id: q.issue.id, trigger: q.trigger }));
     const preWorkers = this.workers.map((w) => ({ id: w.issueId, trigger: w.trigger }));
+    const tracker = this.opts.prTracker;
     for (const issue2 of candidates) {
       if (this.workers.some((w) => w.issueId === issue2.id))
         continue;
@@ -105189,6 +105296,13 @@ class AgentCoordinator {
         continue;
       if (this.queue.some((q) => q.issue.id === issue2.id))
         continue;
+      if (tracker?.isBailed(issue2.identifier) && this.errorMarkerCleared(issue2)) {
+        await tracker.clear(issue2.identifier).catch(() => {});
+        this.conflictNotified.delete(issue2.id);
+        this.ciFailedNotified.delete(issue2.id);
+        this.conflictPromoted.delete(issue2.id);
+        this.deps.onLog(`  ${issue2.identifier}: pr-tracker bail cleared (ticket back in Todo) \u2014 retrying recovery`, "cyan");
+      }
       let pr;
       try {
         pr = await this.deps.checkPrStatus(issue2);
@@ -105208,10 +105322,18 @@ class AgentCoordinator {
         }
       }
       if (pr.status === "conflicted") {
+        if (tracker?.isBailed(issue2.identifier)) {
+          counts.quarantined += 1;
+          continue;
+        }
+        counts.conflicted += 1;
         if (this.conflictNotified.has(issue2.id))
           continue;
-        if (await this.prTrackerBail(issue2, pr.url, "conflicting"))
+        if (await this.prTrackerBail(issue2, pr.url, "conflicting")) {
+          counts.conflicted -= 1;
+          counts.quarantined += 1;
           continue;
+        }
         emitCapture(this.bus, "agent_conflict_detected", { issue_identifier: issue2.identifier });
         this.conflictNotified.add(issue2.id);
         this.deps.onLog(`  ${issue2.identifier}: PR ${pr.url} conflicting \u2014 queued (conflict-fix)`, "yellow");
@@ -105230,14 +105352,21 @@ class AgentCoordinator {
           trigger: "conflict-fix",
           priority: defaultPriorityFor("conflict-fix")
         });
-        counts.conflicted += 1;
         continue;
       }
       if (pr.status === "ci_failed") {
+        if (tracker?.isBailed(issue2.identifier)) {
+          counts.quarantined += 1;
+          continue;
+        }
+        counts.ciFailed += 1;
         if (this.ciFailedNotified.has(issue2.id))
           continue;
-        if (await this.prTrackerBail(issue2, pr.url, "ci_failed"))
+        if (await this.prTrackerBail(issue2, pr.url, "ci_failed")) {
+          counts.ciFailed -= 1;
+          counts.quarantined += 1;
           continue;
+        }
         emitCapture(this.bus, "agent_ci_failed_detected", { issue_identifier: issue2.identifier });
         this.ciFailedNotified.add(issue2.id);
         this.deps.onLog(`  ${issue2.identifier}: PR ${pr.url} CI failing \u2014 queued (ci-fix)`, "yellow");
@@ -105256,7 +105385,6 @@ class AgentCoordinator {
           trigger: "ci-fix",
           priority: defaultPriorityFor("ci-fix")
         });
-        counts.ciFailed += 1;
       }
     }
     for (const q of preQueue) {
@@ -105273,6 +105401,16 @@ class AgentCoordinator {
     }
     return counts;
   }
+  errorMarkerCleared(issue2) {
+    const se = this.opts.setError;
+    if (!se)
+      return false;
+    const wantLabels = markersOf(se).filter((m) => m.type === "label").map((m) => m.value.toLowerCase());
+    if (wantLabels.length === 0)
+      return false;
+    const have = new Set(issue2.labels.map((l) => l.toLowerCase()));
+    return !wantLabels.some((v) => have.has(v));
+  }
   async prTrackerBail(issue2, prUrl, reason) {
     const tracker = this.opts.prTracker;
     if (!tracker)
@@ -105399,6 +105537,7 @@ class AgentCoordinator {
       kill: handle.kill,
       lastReportedIteration: 0,
       lastSyncedIteration: 0,
+      lastSyncedTasksFingerprint: null,
       restarting: false,
       reapedForAwaiting: false
     };
@@ -105562,6 +105701,7 @@ class AgentCoordinator {
         kill: () => {},
         lastReportedIteration: 0,
         lastSyncedIteration: 0,
+        lastSyncedTasksFingerprint: null,
         restarting: false,
         reapedForAwaiting: false
       };
@@ -105652,7 +105792,12 @@ function triggerToFlowId(trigger) {
     return "review-followup";
   return "implement";
 }
-var emptyPrStatus = () => ({ mergeable: 0, conflicted: 0, ciFailed: 0 }), emptyPollResult = () => ({
+var emptyPrStatus = () => ({
+  mergeable: 0,
+  conflicted: 0,
+  ciFailed: 0,
+  quarantined: 0
+}), emptyPollResult = () => ({
   found: 0,
   added: 0,
   buckets: {
@@ -105662,6 +105807,7 @@ var emptyPrStatus = () => ({ mergeable: 0, conflicted: 0, ciFailed: 0 }), emptyP
     ciFailed: 0,
     review: 0,
     mentions: 0,
+    quarantined: 0,
     awaiting: 0
   },
   prStatus: emptyPrStatus(),
@@ -105669,6 +105815,7 @@ var emptyPrStatus = () => ({ mergeable: 0, conflicted: 0, ciFailed: 0 }), emptyP
   flow: {}
 });
 var init_coordinator = __esm(() => {
+  init_types2();
   init_post_task();
   init_queue_order();
   init_src();
@@ -106550,10 +106697,10 @@ function unionMarkers(...sets) {
   }
   return out;
 }
-function describeIndicators(indicators, team, assignee) {
+function describeIndicators(indicators, team, assignee, anyAssignee) {
   const parts = [];
   parts.push(`team=${team ?? "*"}`);
-  parts.push(`assignee=${assignee ?? "*"}`);
+  parts.push(`assignee=${anyAssignee ? "any" : assignee ?? "*"}`);
   if (indicators.getTodo) {
     parts.push(`todo=[${indicators.getTodo.filter.map((m) => `${m.type}:${m.value}`).join(",")}]`);
   }
@@ -106568,7 +106715,7 @@ var init_indicators = __esm(() => {
 
 // apps/agent/src/agent/wire/linear-resolvers.ts
 function createLinearResolvers(input) {
-  const { apiKey, team, assignee, diag } = input;
+  const { apiKey, team, assignee, anyAssignee, diag } = input;
   const ticketNumbers = input.ticketNumbers ?? [];
   const stateCache = new Map;
   const labelCache = new Map;
@@ -106684,6 +106831,7 @@ function createLinearResolvers(input) {
     const spec = {
       team,
       assignee,
+      anyAssignee,
       include,
       exclude: excl,
       ...ticketNumbers.length > 0 ? { numbers: ticketNumbers } : {}
@@ -107417,6 +107565,7 @@ function createMentionScanner(input) {
     cfg,
     team,
     assignee,
+    anyAssignee,
     indicators,
     projectRoot,
     useWorktree,
@@ -107440,6 +107589,7 @@ function createMentionScanner(input) {
       candidates = await fetchMentionScanIssues(apiKey, {
         team,
         assignee,
+        anyAssignee,
         ...ticketNumbers && ticketNumbers.length > 0 ? { numbers: ticketNumbers } : {},
         indicators: {
           ...indicators.getTodo !== undefined ? { getTodo: indicators.getTodo } : {},
@@ -107659,8 +107809,190 @@ var init_default2 = __esm(() => {
   init_log();
 });
 
+// apps/agent/src/agent/state/agent-run-state.ts
+import { basename as basename3, join as join29 } from "path";
+import { homedir as homedir6 } from "os";
+import { mkdir as mkdir11, writeFile } from "fs/promises";
+function agentRunStatePath(projectRoot) {
+  return join29(homedir6(), ".ralph", basename3(projectRoot), "agent-state.json");
+}
+async function writeAgentRunState(state) {
+  const path = agentRunStatePath(state.projectRoot);
+  try {
+    await mkdir11(join29(homedir6(), ".ralph", basename3(state.projectRoot)), { recursive: true });
+    await writeFile(path, JSON.stringify(state, null, 2) + `
+`, "utf-8");
+  } catch {}
+}
+var init_agent_run_state = () => {};
+
+// packages/retro/src/disposition.ts
+function dispositionFromExitCode(code) {
+  switch (code) {
+    case 0:
+      return "done";
+    case NO_CHANGES_EXIT2:
+      return "no-changes";
+    case CI_FAILED_EXIT2:
+      return "ci-failed";
+    case PR_FAILED_EXIT2:
+      return "pr-failed";
+    default:
+      return "error";
+  }
+}
+var CI_FAILED_EXIT2 = 70, PR_FAILED_EXIT2 = 71, NO_CHANGES_EXIT2 = 72;
+
+// packages/retro/src/paths.ts
+import { homedir as homedir7 } from "os";
+import { mkdir as mkdir12 } from "fs/promises";
+import { join as join30 } from "path";
+function retroDir() {
+  return join30(homedir7(), ".ralph", "retro");
+}
+async function resolveRetroOutputPath(identifier, date5, dir = retroDir()) {
+  await mkdir12(dir, { recursive: true });
+  const base2 = join30(dir, `${identifier}-${date5}.md`);
+  if (!await Bun.file(base2).exists())
+    return base2;
+  for (let n = 2;; n++) {
+    const candidate = join30(dir, `${identifier}-${date5}-${n}.md`);
+    if (!await Bun.file(candidate).exists())
+      return candidate;
+  }
+}
+var init_paths2 = () => {};
+
+// packages/retro/src/prompt.ts
+function buildRetroPrompt(ctx, outputPath) {
+  const disposition = dispositionFromExitCode(ctx.exitCode);
+  const { paths } = ctx;
+  const line = (label, value) => value ? `- ${label}: ${value}` : `- ${label}: (unavailable \u2014 note this in the report)`;
+  return [
+    `You are a retrospective analysis agent reviewing a finished automated ticket run.`,
+    `Your job is to read the run's artifacts and write a thorough, honest self-review`,
+    `to a markdown file. You are NOT fixing anything \u2014 this is analysis only.`,
+    ``,
+    `## Ticket`,
+    ``,
+    `- Identifier: ${ctx.identifier}`,
+    `- Change name: ${ctx.changeName}`,
+    `- Terminal disposition: ${disposition} (worker exit code ${ctx.exitCode})`,
+    ctx.prUrl ? `- Pull request: ${ctx.prUrl}` : `- Pull request: none was opened`,
+    `- Date: ${ctx.date}`,
+    ``,
+    `### Ticket details`,
+    ``,
+    ctx.ticketDigest,
+    ``,
+    `## Data sources`,
+    ``,
+    `Read whatever of the following exist. If a path is missing or empty, say so`,
+    `explicitly in the report rather than guessing.`,
+    ``,
+    line("Change directory (proposal/design/tasks/specs)", paths.changeDir),
+    line("Loop state file", paths.stateFilePath),
+    line("Worker log", paths.logFile),
+    line("JSON event log", paths.jsonLogFile),
+    line("Agent run state", paths.agentStateFile),
+    ctx.prUrl ? `- You may inspect the PR read-only with \`gh pr view ${ctx.prUrl}\` and \`gh pr diff ${ctx.prUrl}\`.` : `- No PR exists; skip the PR section and note "no PR".`,
+    ``,
+    `## Required report structure`,
+    ``,
+    `Write GitHub-flavored markdown with these sections:`,
+    `1. **Summary** \u2014 what the ticket asked for and how the run ended.`,
+    `2. **What went well** \u2014 concrete things the run did right.`,
+    `3. **What went wrong / friction** \u2014 failures, retries, wasted iterations,`,
+    `   wrong turns, anything that cost time or quality.`,
+    `4. **Root-cause analysis** \u2014 for each problem, why it happened.`,
+    `5. **Recommendations** \u2014 specific, actionable improvements (to the prompt,`,
+    `   the tasks, the codebase, or the workflow).`,
+    `6. **Data gaps** \u2014 which data sources were unavailable or unread.`,
+    ``,
+    `## Output`,
+    ``,
+    `Write the complete report to this exact path using your file-write tool:`,
+    ``,
+    `    ${outputPath}`,
+    ``,
+    `## Hard rules`,
+    ``,
+    `- Do NOT run any git mutation: no commit, add, push, rebase, reset, checkout,`,
+    `  branch, merge, tag, or stash.`,
+    `- Do NOT create, edit, comment on, close, or merge any pull request or issue.`,
+    `- Do NOT modify any source file. The ONLY file you may write is the report at`,
+    `  the path above.`,
+    `- Read-only inspection commands (\`git log\`, \`git diff\`, \`gh pr view\`,`,
+    `  \`gh pr diff\`, reading files) are allowed.`
+  ].join(`
+`);
+}
+var init_prompt = () => {};
+
+// packages/retro/src/retro.ts
+async function runRetrospective(ctx, deps) {
+  const { log: log3, runEngine: runEngine2, seen } = deps;
+  const disposition = dispositionFromExitCode(ctx.exitCode);
+  const key = `${ctx.identifier}:${disposition}:${ctx.date}`;
+  if (seen.has(key)) {
+    log3(`  retrospective skipped for ${ctx.identifier} (already generated this run)`, "gray");
+    return { written: false, skipped: "duplicate", disposition };
+  }
+  seen.add(key);
+  try {
+    const outputPath = await resolveRetroOutputPath(ctx.identifier, ctx.date);
+    const prompt = buildRetroPrompt(ctx, outputPath);
+    log3(`  running retrospective for ${ctx.identifier} (${disposition}) \u2192 ${outputPath}`, "cyan");
+    await runEngine2({
+      engine: ctx.engine,
+      model: ctx.model,
+      prompt,
+      cwd: ctx.cwd,
+      onOutput: (l) => log3(l, "gray")
+    });
+    const written = await Bun.file(outputPath).exists();
+    if (written) {
+      log3(`  retrospective written: ${outputPath}`, "green");
+    } else {
+      log3(`! retrospective engine finished but no report was written at ${outputPath}`, "yellow");
+    }
+    return { written, outputPath, disposition };
+  } catch (err) {
+    log3(`! retrospective failed for ${ctx.identifier}: ${err.message}`, "yellow");
+    return { written: false, disposition };
+  }
+}
+var init_retro = __esm(() => {
+  init_paths2();
+  init_prompt();
+  init_paths2();
+  init_prompt();
+});
+
 // apps/agent/src/agent/wire/spawn/worker.ts
-import { join as join29 } from "path";
+import { join as join31 } from "path";
+function localDateStamp(d) {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+function buildTicketDigest(issue2, comments) {
+  if (!issue2)
+    return "(ticket details unavailable)";
+  const lines = [`Title: ${issue2.title}`, "", issue2.description?.trim() || "(no description)"];
+  if (comments.length > 0) {
+    lines.push("", "Comments:");
+    for (const c of comments) {
+      lines.push(`- ${c.user?.name ?? "unknown"}: ${c.body}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+function retroDepEntry(agentDebug, hook) {
+  return agentDebug ? { runRetrospective: hook } : {};
+}
 function createSpawnWorker(input) {
   const {
     args,
@@ -107739,10 +108071,52 @@ function createSpawnWorker(input) {
     c.push("--from-agent");
     return c;
   }
+  const retroSeen = new Set;
+  const runRetrospectiveHook = async (info) => {
+    try {
+      const identifier = info.issue?.identifier ?? info.changeName;
+      const prUrl = prByChange?.get(info.changeName) ?? null;
+      let digest = "(ticket details unavailable)";
+      if (info.issue) {
+        let comments = [];
+        try {
+          comments = await fetchIssueComments(apiKey, info.issue.id);
+        } catch {}
+        digest = buildTicketDigest(info.issue, comments);
+      }
+      const engine = args.engineSet ? args.engine : cfg.engine;
+      const model = args.engineSet ? args.model : cfg.model;
+      const ctx = {
+        identifier,
+        changeName: info.changeName,
+        cwd: info.cwd,
+        engine,
+        model,
+        exitCode: info.effectiveCode,
+        prUrl,
+        date: localDateStamp(new Date),
+        ticketDigest: digest,
+        paths: {
+          changeDir: info.changeDir,
+          stateFilePath: info.stateFilePath,
+          logFile: join31(logsDir, `${info.changeName}.log`),
+          jsonLogFile: args.jsonLogFile ?? null,
+          agentStateFile: agentRunStatePath(projectRoot)
+        }
+      };
+      await runRetrospective(ctx, {
+        runEngine: (opts) => runEngine(opts),
+        log: onLog,
+        seen: retroSeen
+      });
+    } catch (err) {
+      onLog(`! retrospective failed: ${err.message}`, "yellow");
+    }
+  };
   return function spawnWorker(changeName, _issue, trigger) {
     const cwd2 = cwdByChange.get(changeName) ?? projectRoot;
     const injected = runners?.spawnWorker;
-    const missionTasksPath = join29(projectLayout(cwd2).changeDir(changeName), MISSION_TASKS_FILENAME);
+    const missionTasksPath = join31(projectLayout(cwd2).changeDir(changeName), MISSION_TASKS_FILENAME);
     const prevTasksPromise = (async () => {
       const f2 = Bun.file(missionTasksPath);
       return await f2.exists() ? await f2.text() : "";
@@ -107750,7 +108124,7 @@ function createSpawnWorker(input) {
     let logFilePath;
     let handle;
     if (injected) {
-      logFilePath = join29(logsDir, `${changeName}.log`);
+      logFilePath = join31(logsDir, `${changeName}.log`);
       handle = injected(buildTaskCmdFor(changeName), cwd2);
     } else {
       const r = defaultSpawn(changeName, buildTaskCmdFor(changeName), cwd2, logsDir, onWorkerOutput, `spawn at ${new Date().toISOString()}`);
@@ -107772,7 +108146,7 @@ function createSpawnWorker(input) {
     const wantAutoMerge = issueForChange ? issueMatchesGetIndicator(issueForChange, indicators.getAutoMerge) : false;
     const wrapped = handle.exited.then(async (code) => {
       const workerLayout = projectLayout(cwd2);
-      const validateSpecPath = join29(workerLayout.changeDir(changeName), "specs", "validate.md");
+      const validateSpecPath = join31(workerLayout.changeDir(changeName), "specs", "validate.md");
       const hasValidateSpec = await Bun.file(validateSpecPath).exists();
       const wantValidateOnly = hasValidateSpec && !wantPrBase;
       if (hasValidateSpec) {
@@ -107857,6 +108231,7 @@ function createSpawnWorker(input) {
         git: gitRunner,
         log: onLog,
         runScript,
+        ...retroDepEntry(args.agentDebug, runRetrospectiveHook),
         registerPr: (cn, url2) => onPrRegistered(cn, url2),
         ...onWorkerPhase && {
           onPhase: (phase2, detail) => onWorkerPhase(changeName, phase2, detail)
@@ -107892,6 +108267,9 @@ var init_worker = __esm(() => {
   init_runners();
   init_pr_helpers();
   init_wait_for_mergeability();
+  init_agent_run_state();
+  init_retro();
+  init_engine();
 });
 
 // apps/agent/src/agent/baseline/runner.ts
@@ -108234,8 +108612,8 @@ var init_linear_sync = __esm(() => {
 });
 
 // apps/agent/src/agent/linear-sync/comment-sync.ts
-import { dirname as dirname13, join as join30 } from "path";
-import { mkdir as mkdir11, rename, unlink as unlink2 } from "fs/promises";
+import { dirname as dirname13, join as join32 } from "path";
+import { mkdir as mkdir13, rename, unlink as unlink2 } from "fs/promises";
 async function readStateJson(statePath) {
   const file2 = Bun.file(statePath);
   if (!await file2.exists())
@@ -108247,7 +108625,7 @@ async function readStateJson(statePath) {
   }
 }
 async function writeStateJson(statePath, state) {
-  await mkdir11(dirname13(statePath), { recursive: true });
+  await mkdir13(dirname13(statePath), { recursive: true });
   const tmp = `${statePath}.tmp-${process.pid}-${writeStateSeq++}`;
   try {
     await Bun.write(tmp, JSON.stringify(state, null, 2) + `
@@ -108286,7 +108664,7 @@ function isCommentNotFoundError(err) {
   return text.includes("not found") || text.includes("could not find") || text.includes("entity not found");
 }
 async function readTasksMd(changeDir, log3) {
-  const file2 = Bun.file(join30(changeDir, "tasks.md"));
+  const file2 = Bun.file(join32(changeDir, "tasks.md"));
   if (!await file2.exists()) {
     log3(`  comment-sync: tasks.md missing in ${changeDir}, skipping`, "gray");
     return null;
@@ -108394,14 +108772,14 @@ async function postPlanCommentOnce(deps) {
   const check2 = parsePlanningSection(tasksMd);
   if (!check2.allChecked)
     return null;
-  const proposalPath = join30(deps.changeDir, "proposal.md");
+  const proposalPath = join32(deps.changeDir, "proposal.md");
   const why = await readSection(proposalPath, "Why");
   const whatChanges = await readSection(proposalPath, "What Changes");
   if (!why && !whatChanges) {
     deps.log(`  comment-sync: proposal.md has no Why/What Changes, skipping plan comment`, "gray");
     return null;
   }
-  const designSummary = await readFirstParagraph(join30(deps.changeDir, "design.md"));
+  const designSummary = await readFirstParagraph(join32(deps.changeDir, "design.md"));
   const parts = [`### ${PLAN_COMMENT_TITLE} \u2014 \`${deps.changeName}\``];
   if (why) {
     parts.push("", "**Why**", "", why);
@@ -260677,7 +261055,7 @@ var init_render_pdf = __esm(() => {
 });
 
 // apps/agent/src/agent/linear-sync/spec-attachments.ts
-import { dirname as dirname14, join as join31 } from "path";
+import { dirname as dirname14, join as join33 } from "path";
 function describeLinearError(err) {
   const e = err;
   const parts = [e.message ?? String(err)];
@@ -260769,7 +261147,7 @@ async function syncSlot(deps, slot) {
   const [primaryName, ...trailingNames] = spec.sourceFiles;
   if (!primaryName)
     return;
-  const primary = Bun.file(join31(deps.changeDir, primaryName));
+  const primary = Bun.file(join33(deps.changeDir, primaryName));
   if (!await primary.exists()) {
     deps.log(`  spec-attachments: ${primaryName} missing, skipping`, "gray");
     return;
@@ -260788,7 +261166,7 @@ async function syncSlot(deps, slot) {
   const parts = [primaryBytes];
   const enc = new TextEncoder;
   for (const name of trailingNames) {
-    const f2 = Bun.file(join31(deps.changeDir, name));
+    const f2 = Bun.file(join33(deps.changeDir, name));
     if (!await f2.exists())
       continue;
     try {
@@ -261053,9 +261431,9 @@ var init_comment_sync2 = __esm(() => {
 });
 
 // apps/agent/src/features/pr-tracker/state.ts
-import { join as join32 } from "path";
+import { join as join34 } from "path";
 async function readState2(projectRoot) {
-  const path = join32(projectRoot, PR_TRACKER_STATE_RELPATH);
+  const path = join34(projectRoot, PR_TRACKER_STATE_RELPATH);
   const file2 = Bun.file(path);
   if (!await file2.exists())
     return {};
@@ -261071,7 +261449,7 @@ async function readState2(projectRoot) {
   }
 }
 async function writeState2(projectRoot, state) {
-  const path = join32(projectRoot, PR_TRACKER_STATE_RELPATH);
+  const path = join34(projectRoot, PR_TRACKER_STATE_RELPATH);
   await Bun.write(path, JSON.stringify(state, null, 2));
 }
 var PR_TRACKER_STATE_RELPATH = ".ralph/pr-tracker-state.json";
@@ -261150,7 +261528,7 @@ var init_pr_tracker = __esm(() => {
 });
 
 // apps/agent/src/agent/wire.ts
-import { join as join33 } from "path";
+import { join as join35 } from "path";
 function buildAgentCoordinator(input) {
   const {
     args,
@@ -261169,7 +261547,7 @@ function buildAgentCoordinator(input) {
     onWorkerCmd,
     onAwaitingTicket
   } = input;
-  const logsDir = join33(projectRoot, ".ralph", "logs");
+  const logsDir = join35(projectRoot, ".ralph", "logs");
   const bus = createBus();
   subscribeAgentDiag(bus, onLog);
   const diag = (area, message, color) => {
@@ -261179,7 +261557,8 @@ function buildAgentCoordinator(input) {
   const pollInterval = args.pollInterval || cfg.pollIntervalSeconds;
   const indicators = mergeIndicators(cfg.linear.indicators, args.indicators);
   const team = args.linearTeam || cfg.linear.team;
-  const assignee = args.linearAssignee || cfg.linear.assignee;
+  const effectiveFilter = args.linearFilter || (args.linearAssignee ? `assignee = ${args.linearAssignee}` : "") || cfg.linear.filter;
+  const { assignee, anyAssignee } = parseLinearFilter(effectiveFilter);
   const ticketNumbers = resolveTicketNumbers(args.ticketTokens, team);
   const excludeFromTodo = unionMarkers(indicators.setDone, indicators.setError);
   const gitRunner = input.runners?.git ?? bunGitRunner;
@@ -261216,6 +261595,7 @@ function buildAgentCoordinator(input) {
     apiKey,
     team,
     assignee,
+    anyAssignee,
     diag,
     ...ticketNumbers.length > 0 ? { ticketNumbers } : {}
   });
@@ -261253,6 +261633,7 @@ function buildAgentCoordinator(input) {
     cfg,
     team,
     assignee,
+    anyAssignee,
     indicators,
     projectRoot,
     useWorktree,
@@ -261382,6 +261763,18 @@ function buildAgentCoordinator(input) {
       const json2 = await file2.json();
       return json2.iteration ?? 0;
     },
+    getTasksFingerprint: async (changeName) => {
+      const root = cwdByChange.get(changeName) ?? projectRoot;
+      const changeDir = projectLayout(root).changeDir(changeName);
+      const parts = [];
+      for (const name of ["tasks.md", "proposal.md", "design.md"]) {
+        const file2 = Bun.file(join35(changeDir, name));
+        if (!await file2.exists())
+          continue;
+        parts.push(`${name}:${file2.lastModified}:${file2.size}`);
+      }
+      return parts.length > 0 ? parts.join("|") : null;
+    },
     ...commentSync.enabled && commentSync.syncTasks ? { syncTasks: commentSync.syncTasks } : {},
     ...commentSync.enabled && commentSync.onSteeringAppended ? { onSteeringAppended: commentSync.onSteeringAppended } : {}
   }, {
@@ -261396,7 +261789,7 @@ function buildAgentCoordinator(input) {
     ...prTracker ? { prTracker } : {}
   });
   coordRef.current = coord;
-  const filterDesc = describeIndicators(indicators, team, assignee);
+  const filterDesc = describeIndicators(indicators, team, assignee, anyAssignee);
   const runBaselineGateOnce = createBaselineGateRunner({
     args,
     cfg,
@@ -261420,7 +261813,7 @@ function buildAgentCoordinator(input) {
     getGaveUpTotal: async () => {
       let total = 0;
       for (const [changeName, root] of cwdByChange) {
-        const file2 = Bun.file(join33(projectLayout(root).taskStateDir(changeName), GAVEUP_COUNT_FILE));
+        const file2 = Bun.file(join35(projectLayout(root).taskStateDir(changeName), GAVEUP_COUNT_FILE));
         if (!await file2.exists())
           continue;
         try {
@@ -261432,6 +261825,7 @@ function buildAgentCoordinator(input) {
   };
 }
 var init_wire = __esm(() => {
+  init_workflow();
   init_src2();
   init_coordinator2();
   init_linear();
@@ -261454,14 +261848,14 @@ var init_wire = __esm(() => {
 });
 
 // apps/agent/src/agent/json-log/json-log-file.ts
-import { mkdir as mkdir12, appendFile as appendFile2 } from "fs/promises";
+import { mkdir as mkdir14, appendFile as appendFile2 } from "fs/promises";
 import { dirname as dirname15 } from "path";
 function createJsonLogFileSink(path) {
   if (!path)
     return { emit: () => {} };
   let chain = (async () => {
     try {
-      await mkdir12(dirname15(path), { recursive: true });
+      await mkdir14(dirname15(path), { recursive: true });
       await Bun.write(path, "");
     } catch {}
   })();
@@ -261707,7 +262101,7 @@ var init_output_utils = __esm(() => {
 });
 
 // apps/agent/src/agent/state/worker-state-poll.ts
-import { join as join34 } from "path";
+import { join as join36 } from "path";
 function parseSubtasks(tasksMd) {
   const out = [];
   let skipSection = false;
@@ -261740,7 +262134,7 @@ function initialWorkerSnapshot() {
 async function readWorkerSnapshot(input) {
   const next = { ...input.prev };
   try {
-    const file2 = Bun.file(join34(input.statesDir, input.changeName, ".ralph-state.json"));
+    const file2 = Bun.file(join36(input.statesDir, input.changeName, ".ralph-state.json"));
     if (await file2.exists()) {
       const json2 = await file2.json();
       next.iter = json2.iteration ?? next.iter;
@@ -261749,10 +262143,10 @@ async function readWorkerSnapshot(input) {
   } catch {}
   if (input.changeDir) {
     try {
-      const tasksFile = Bun.file(join34(input.changeDir, "tasks.md"));
-      const proposalFile = Bun.file(join34(input.changeDir, "proposal.md"));
-      const designFile = Bun.file(join34(input.changeDir, "design.md"));
-      const reviewFindingsFile = Bun.file(join34(input.changeDir, "review-findings.md"));
+      const tasksFile = Bun.file(join36(input.changeDir, "tasks.md"));
+      const proposalFile = Bun.file(join36(input.changeDir, "proposal.md"));
+      const designFile = Bun.file(join36(input.changeDir, "design.md"));
+      const reviewFindingsFile = Bun.file(join36(input.changeDir, "review-findings.md"));
       const [tasksText, proposalText, designText, reviewFindingsText] = await Promise.all([
         tasksFile.exists().then((ok) => ok ? tasksFile.text() : null),
         proposalFile.exists().then((ok) => ok ? proposalFile.text() : null),
@@ -261815,7 +262209,7 @@ var init_worker_state_poll = __esm(() => {
 });
 
 // apps/agent/src/components/AgentMode.tsx
-import { join as join35 } from "path";
+import { join as join37 } from "path";
 async function appendSteeringImpl(changeDir, message) {
   await runWithContext(createDefaultContext(), async () => {
     appendSteeringMessage(changeDir, message);
@@ -262753,6 +263147,19 @@ function AgentMode({
                       /* @__PURE__ */ jsx_dev_runtime11.jsxDEV(Text, {
                         color: pollStatus.lastPrStatus.ciFailed > 0 ? "red" : "white",
                         children: pollStatus.lastPrStatus.ciFailed
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime11.jsxDEV(Text, {
+                        dimColor: true,
+                        children: "\xB7"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime11.jsxDEV(Text, {
+                        dimColor: true,
+                        children: "quarantined"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime11.jsxDEV(Text, {
+                        color: pollStatus.lastPrStatus.quarantined > 0 ? "magenta" : "white",
+                        bold: true,
+                        children: pollStatus.lastPrStatus.quarantined
                       }, undefined, false, undefined, this)
                     ]
                   }, undefined, true, undefined, this)
@@ -263375,7 +263782,7 @@ function AgentMode({
                     },
                     onSubmit: async (message) => {
                       try {
-                        await appendSteering2(join35(tasksDir, w2.changeName), message);
+                        await appendSteering2(join37(tasksDir, w2.changeName), message);
                         fileEmit({ type: "steering_submitted", changeName: w2.changeName, message });
                       } catch (err) {
                         const text = err.message;
@@ -263489,7 +263896,7 @@ function shouldFallbackToJsonOutput(args, stdinIsTty) {
 }
 
 // apps/agent/src/runtime/tmux.ts
-import { basename as basename3 } from "path";
+import { basename as basename4 } from "path";
 function tmuxAvailable() {
   const result2 = Bun.spawnSync({ cmd: ["tmux", "-V"], stderr: "pipe" });
   return result2.exitCode === 0;
@@ -263498,7 +263905,7 @@ function sessionName(projectRoot) {
   const override = process.env["RALPH_SESSION_NAME"];
   if (override)
     return override;
-  return `ralphy-agent-${basename3(projectRoot)}`;
+  return `ralphy-agent-${basename4(projectRoot)}`;
 }
 function sessionExists(name) {
   const result2 = Bun.spawnSync({ cmd: ["tmux", "has-session", "-t", name], stderr: "pipe" });
@@ -263679,7 +264086,7 @@ __export(exports_list, {
   buildBuckets: () => buildBuckets,
   backlogRankByIssueId: () => backlogRankByIssueId
 });
-import { join as join36 } from "path";
+import { join as join38 } from "path";
 function countTaskItems(content) {
   const checked = (content.match(/^- \[x\]/gm) ?? []).length;
   const unchecked = (content.match(/^- \[ \]/gm) ?? []).length;
@@ -263695,13 +264102,13 @@ function buildLocalRows() {
   const sources = [{ dir: statesDir, label: "main" }];
   const worktreesRoot = worktreesDir2(projectRoot);
   for (const wt of storage.list(worktreesRoot)) {
-    sources.push({ dir: join36(worktreesRoot, wt, ".ralph", "tasks"), label: `wt:${wt}` });
+    sources.push({ dir: join38(worktreesRoot, wt, ".ralph", "tasks"), label: `wt:${wt}` });
   }
   for (const { dir, label } of sources) {
     for (const entry of storage.list(dir)) {
       if (seen.has(entry))
         continue;
-      const raw = storage.read(join36(dir, entry, ".ralph-state.json"));
+      const raw = storage.read(join38(dir, entry, ".ralph-state.json"));
       if (raw === null)
         continue;
       let state;
@@ -263716,7 +264123,7 @@ function buildLocalRows() {
       const firstLine = promptRaw.split(`
 `).find((l3) => l3.trim() !== "") ?? "";
       let progress = "\u2014";
-      const tasksContent = storage.read(join36(dir, entry, "tasks.md"));
+      const tasksContent = storage.read(join38(dir, entry, "tasks.md"));
       if (tasksContent !== null) {
         const { checked, unchecked } = countTaskItems(tasksContent);
         const total = checked + unchecked;
@@ -263779,18 +264186,23 @@ function buildBuckets(indicators) {
     { label: "auto-merge", indicator: indicators.getAutoMerge, exclude: [] }
   ];
 }
-async function fetchBucketIssues(apiKey, bucket, team, assignee, ticketNumbers) {
+async function fetchBucketIssues(apiKey, bucket, team, assignee, anyAssignee, ticketNumbers) {
   if (!bucket.indicator || bucket.indicator.filter.length === 0)
     return [];
   const spec = {
     team,
     assignee,
+    anyAssignee,
     include: bucket.indicator.filter,
     exclude: bucket.exclude,
     ...ticketNumbers.length > 0 ? { numbers: ticketNumbers } : {}
   };
   return fetchOpenIssues(apiKey, spec);
 }
+function resolveLinearFilter(filterOverride, assigneeOverride, configFilter) {
+  const effective = filterOverride || (assigneeOverride ? `assignee = ${assigneeOverride}` : "") || configFilter;
+  return parseLinearFilter(effective);
+}
 function formatReviewCell(prUrl, count) {
   if (!prUrl)
     return "-";
@@ -263837,13 +264249,13 @@ function backlogRankByIssueId(issues) {
   ordered.forEach((o, i) => rankById.set(o.id, i));
   return rankById;
 }
-async function fetchAndPrintLinear(apiKey, buckets, team, assignee, cwd2, runner, ignoreCiChecks = [], checks3 = false, review = false, ticketNumbers = []) {
+async function fetchAndPrintLinear(apiKey, buckets, team, assignee, anyAssignee, cwd2, runner, ignoreCiChecks = [], checks3 = false, review = false, ticketNumbers = []) {
   const bucketResults = await Promise.all(buckets.map(async (bucket) => {
     if (!bucket.indicator || bucket.indicator.filter.length === 0) {
       return { bucket, issues: [], error: null };
     }
     try {
-      const issues = await fetchBucketIssues(apiKey, bucket, team, assignee, ticketNumbers);
+      const issues = await fetchBucketIssues(apiKey, bucket, team, assignee, anyAssignee, ticketNumbers);
       return { bucket, issues, error: null };
     } catch (err) {
       return {
@@ -263969,6 +264381,7 @@ async function runList(input) {
       identifier: name,
       projectRoot,
       linearTeamOverride: input.linearTeamOverride,
+      linearFilterOverride: input.linearFilterOverride,
       linearAssigneeOverride: input.linearAssigneeOverride
     });
     return;
@@ -263979,7 +264392,7 @@ async function runList(input) {
   const apiKey = process.env["LINEAR_API_KEY"];
   const indicators = cfg.linear.indicators;
   const team = input.linearTeamOverride || cfg.linear.team;
-  const assignee = input.linearAssigneeOverride || cfg.linear.assignee;
+  const { assignee, anyAssignee } = resolveLinearFilter(input.linearFilterOverride, input.linearAssigneeOverride, cfg.linear.filter);
   const buckets = buildBuckets(indicators);
   const anyConfigured = buckets.some((b2) => b2.indicator && b2.indicator.filter.length > 0);
   if (!anyConfigured) {
@@ -264014,13 +264427,12 @@ Linear: LINEAR_API_KEY not set \u2014 cannot fetch tickets. Configured buckets:
     process.stdout.write(`
 team: ${team}
 `);
-  if (assignee)
-    process.stdout.write(`assignee: ${assignee}
+  process.stdout.write(`assignee: ${anyAssignee ? "any" : assignee ?? "*"}
 `);
   if (ticketNumbers.length > 0)
     process.stdout.write(`ticket: ${ticketNumbers.join(", ")}
 `);
-  await fetchAndPrintLinear(apiKey, buckets, team, assignee, projectRoot, localCmdRunner, cfg.ignoreCiChecks, input.checks, input.review, ticketNumbers);
+  await fetchAndPrintLinear(apiKey, buckets, team, assignee, anyAssignee, projectRoot, localCmdRunner, cfg.ignoreCiChecks, input.checks, input.review, ticketNumbers);
 }
 function normalizeIdentifier(input) {
   let parsed;
@@ -264077,8 +264489,10 @@ function markerMatches(issue2, marker) {
   }
   return false;
 }
-function assigneeMatches(issue2, assignee) {
-  if (!assignee)
+function assigneeMatches(issue2, assignee, anyAssignee) {
+  if (anyAssignee)
+    return true;
+  if (!assignee || assignee === "unassigned")
     return issue2.assignee === null;
   const a = issue2.assignee;
   if (!a)
@@ -264101,7 +264515,8 @@ async function runListDebug(input) {
   const cfg = await loadRalphyConfig(projectRoot);
   const indicators = cfg.linear.indicators;
   const team = input.linearTeamOverride || cfg.linear.team;
-  const assignee = input.linearAssigneeOverride || cfg.linear.assignee;
+  const { assignee, anyAssignee } = resolveLinearFilter(input.linearFilterOverride, input.linearAssigneeOverride, cfg.linear.filter);
+  const assigneeLabel = anyAssignee ? "any" : assignee ?? "*";
   const normalized = normalizeIdentifier(identifier);
   if (!normalized) {
     process.stdout.write(`Error: '${identifier}' does not look like a Linear identifier (expected e.g. DOO-6, or a local change name beginning with one).
@@ -264141,8 +264556,8 @@ Per-bucket diagnostics:
     if (team && issue2.team?.key && issue2.team.key !== team) {
       reasons.push(`team mismatch: issue=${issue2.team.key}, config=${team}`);
     }
-    if (!assigneeMatches(issue2, assignee)) {
-      reasons.push(`assignee mismatch: issue=${issue2.assignee ? issue2.assignee.email ?? issue2.assignee.id : "unassigned"}, config=${assignee}`);
+    if (!assigneeMatches(issue2, assignee, anyAssignee)) {
+      reasons.push(`assignee mismatch: issue=${issue2.assignee ? issue2.assignee.email ?? issue2.assignee.id : "unassigned"}, config=${assigneeLabel}`);
     }
     const includeMatches = bucket.indicator.filter.some((m2) => markerMatches(issue2, m2));
     if (!includeMatches) {
@@ -264175,6 +264590,7 @@ Per-bucket diagnostics:
 var localCmdRunner;
 var init_list = __esm(() => {
   init_context();
+  init_workflow();
   init_worktree();
   init_config();
   init_linear();
@@ -264202,31 +264618,14 @@ var init_list = __esm(() => {
   };
 });
 
-// apps/agent/src/agent/state/agent-run-state.ts
-import { basename as basename4, join as join37 } from "path";
-import { homedir as homedir6 } from "os";
-import { mkdir as mkdir13, writeFile } from "fs/promises";
-function agentRunStatePath(projectRoot) {
-  return join37(homedir6(), ".ralph", basename4(projectRoot), "agent-state.json");
-}
-async function writeAgentRunState(state) {
-  const path = agentRunStatePath(state.projectRoot);
-  try {
-    await mkdir13(join37(homedir6(), ".ralph", basename4(state.projectRoot)), { recursive: true });
-    await writeFile(path, JSON.stringify(state, null, 2) + `
-`, "utf-8");
-  } catch {}
-}
-var init_agent_run_state = () => {};
-
 // apps/agent/src/agent/json-runner.ts
 var exports_json_runner = {};
 __export(exports_json_runner, {
   runAgentJson: () => runAgentJson
 });
-import { join as join38 } from "path";
-import { mkdir as mkdir14 } from "fs/promises";
-import { homedir as homedir7 } from "os";
+import { join as join39 } from "path";
+import { mkdir as mkdir15 } from "fs/promises";
+import { homedir as homedir8 } from "os";
 function makeEmit(fileSink) {
   return (event) => {
     const payload = { ts: Date.now(), ...event };
@@ -264246,7 +264645,7 @@ async function runAgentJson({
   tasksDir,
   runPreflight: runPreflight2 = runPreflight
 }) {
-  await mkdir14(join38(homedir7(), ".ralph"), { recursive: true }).catch(() => {
+  await mkdir15(join39(homedir8(), ".ralph"), { recursive: true }).catch(() => {
     return;
   });
   const fileSink = createJsonLogFileSink(args.jsonLogFile);
@@ -264462,8 +264861,8 @@ var exports_src3 = {};
 __export(exports_src3, {
   main: () => main3
 });
-import { mkdir as mkdir15 } from "fs/promises";
-import { join as join39 } from "path";
+import { mkdir as mkdir16 } from "fs/promises";
+import { join as join40 } from "path";
 async function main3(argv) {
   if (argv.includes("--help") || argv.includes("-h")) {
     printAgentHelp();
@@ -264488,6 +264887,7 @@ async function main3(argv) {
     await runWithContext(createDefaultContext({ layout, args }), async () => {
       await runList2({
         linearTeamOverride: args.linearTeam,
+        linearFilterOverride: args.linearFilter,
         linearAssigneeOverride: args.linearAssignee,
         debug: args.debug,
         name: args.name,
@@ -264526,9 +264926,9 @@ async function main3(argv) {
       return 1;
     }
   }
-  await mkdir15(statesDir, { recursive: true });
-  await mkdir15(tasksDir, { recursive: true });
-  await mkdir15(join39(projectRoot, ".ralph"), { recursive: true });
+  await mkdir16(statesDir, { recursive: true });
+  await mkdir16(tasksDir, { recursive: true });
+  await mkdir16(join40(projectRoot, ".ralph"), { recursive: true });
   if (shouldFallbackToJsonOutput(args, process.stdin.isTTY)) {
     process.stderr.write(`agent: stdin is not a TTY \u2014 falling back to --json-output mode.
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neriros/ralphy",
-  "version": "3.10.4",
+  "version": "3.10.6",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   "keywords": [
     "agent",