@neriros/ralphy 3.10.2 → 3.10.4

package/dist/shell/index.js

@@ -18928,8 +18928,8 @@ import { readFileSync } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("3.10.2")
-      return "3.10.2";
+    if ("3.10.4")
+      return "3.10.4";
   } catch {}
   const dirsToTry = [];
   try {
@@ -80505,7 +80505,7 @@ var init_zod = __esm(() => {
 });
 
 // packages/workflow/src/schema.ts
-var CURRENT_WORKFLOW_VERSION = 1, MarkerSchema, SET_INDICATOR_KEYS, GetIndicatorSchema, SetIndicatorSchema, IndicatorsSchema, ProjectSchema, CommandsSchema, DEFAULT_META_ONLY_FILES, BoundariesSchema, WorkflowConfigSchema;
+var CURRENT_WORKFLOW_VERSION = 2, 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", [
@@ -80598,6 +80598,12 @@ var init_schema = __esm(() => {
   WorkflowConfigSchema = exports_external.object({
     version: exports_external.number().int().nonnegative().default(0),
     project: ProjectSchema,
+    repo: exports_external.object({
+      remote: exports_external.string().optional(),
+      host: exports_external.string().optional(),
+      owner: exports_external.string().optional(),
+      name: exports_external.string().optional()
+    }).strict().optional(),
     commands: CommandsSchema,
     rules: exports_external.array(exports_external.string()).default([]),
     boundaries: BoundariesSchema,
@@ -80712,8 +80718,9 @@ var init_schema = __esm(() => {
       advanceMergedToDone: false
     }),
     metaPrompt: exports_external.object({
-      enabled: exports_external.boolean().default(true)
-    }).strict().default({ enabled: true }),
+      enabled: exports_external.boolean().default(true),
+      effort: exports_external.enum(["auto", "light", "standard", "heavy"]).default("auto")
+    }).strict().default({ enabled: true, effort: "auto" }),
     openspec: exports_external.object({
       reviewPhase: exports_external.object({
         enabled: exports_external.boolean().default(false),
@@ -81049,7 +81056,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", yes = () => ({ kind: "confirm", defaultChoice: "confirm" }), no = () => ({ kind: "confirm", defaultChoice: "cancel" }), PROJECT_NAME, LINEAR_TEAM, 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_ASSIGNEE, QUICK_FIELDS, isOn = (id) => (answers) => answers[id] === true, CUSTOMIZED_FIELDS, COMMON_CLI_OPTIONS, FIELD_DESCRIPTIONS;
 var init_fields = __esm(() => {
   PROJECT_NAME = {
     id: "project.name",
@@ -81061,10 +81068,17 @@ var init_fields = __esm(() => {
     id: "linear.team",
     label: "Linear team key",
     hint: "e.g. ENG \u2014 leave blank to match all teams",
-    description: "Only pick up issues from this Linear team, given by its key (e.g. ENG). Leave blank to watch every team.",
+    description: "The Linear team this repository is linked to, given by its key (e.g. ENG). Ralphy only picks up issues from this team. Leave blank to watch every team.",
     emptyLabel: "all teams",
     spec: { kind: "text" }
   };
+  REPO_LINK = {
+    id: "repo.link",
+    label: "Link this repository to the team?",
+    description: "Record the detected git repository in WORKFLOW.md and link it to the Linear team above. Confirm to adopt the detected repo; decline to leave it out.",
+    spec: yes(),
+    when: (answers) => typeof answers["repo.name"] === "string" && answers["repo.name"] !== ""
+  };
   LINEAR_ASSIGNEE = {
     id: "linear.assignee",
     label: "Linear assignee",
@@ -81073,7 +81087,7 @@ var init_fields = __esm(() => {
     emptyLabel: "unassigned",
     spec: { kind: "text" }
   };
-  QUICK_FIELDS = [PROJECT_NAME, LINEAR_TEAM, LINEAR_ASSIGNEE];
+  QUICK_FIELDS = [PROJECT_NAME, LINEAR_TEAM, REPO_LINK, LINEAR_ASSIGNEE];
   CUSTOMIZED_FIELDS = [
     PROJECT_NAME,
     {
@@ -81321,6 +81335,7 @@ var init_fields = __esm(() => {
       spec: { kind: "list", placeholder: "dist/**" }
     },
     LINEAR_TEAM,
+    REPO_LINK,
     LINEAR_ASSIGNEE,
     {
       id: "linear.postComments",
@@ -81464,6 +81479,21 @@ var init_fields = __esm(() => {
       description: "Add Ralphy's task-level 'meta-prompt' layer (extra framing instructions) to each phase. Leave on unless you want raw prompts.",
       spec: yes()
     },
+    {
+      id: "metaPrompt.effort",
+      label: "Per-ticket effort tier",
+      description: "How much effort the meta-prompt nudges the agent toward per ticket. 'auto' detects it from the ticket; 'light'/'standard'/'heavy' pin every ticket to that tier.",
+      spec: {
+        kind: "select",
+        options: [
+          { label: "auto", value: "auto" },
+          { label: "light", value: "light" },
+          { label: "standard", value: "standard" },
+          { label: "heavy", value: "heavy" }
+        ]
+      },
+      when: isOn("metaPrompt.enabled")
+    },
     {
       id: "openspec.reviewPhase.enabled",
       label: "Enable the OpenSpec review phase?",
@@ -81869,6 +81899,51 @@ var init_workflow = __esm(() => {
   import_yaml2 = __toESM(require_dist(), 1);
 });
 
+// packages/core/src/repo/index.ts
+function parseRepoIdentity(remoteUrl) {
+  const remote = remoteUrl.trim();
+  if (!remote)
+    return null;
+  const match = remote.includes("://") ? URL_RE.exec(remote) : SCP_RE.exec(remote);
+  if (!match)
+    return null;
+  const host = match[1];
+  let path = match[2];
+  if (!host || !path)
+    return null;
+  path = path.replace(/\/+$/, "").replace(/\.git$/i, "").replace(/\/+$/, "");
+  const segments = path.split("/").filter((segment) => segment.length > 0);
+  if (segments.length < 2)
+    return null;
+  const name = segments[segments.length - 1];
+  const owner = segments.slice(0, -1).join("/");
+  if (!owner || !name)
+    return null;
+  return { remote, host, owner, name };
+}
+async function detectRepoIdentity(cwd2) {
+  try {
+    const proc = Bun.spawn({
+      cmd: ["git", "remote", "get-url", "origin"],
+      ...cwd2 ? { cwd: cwd2 } : {},
+      stdout: "pipe",
+      stderr: "ignore",
+      timeout: GIT_DETECT_TIMEOUT_MS
+    });
+    const [stdout, exitCode] = await Promise.all([new Response(proc.stdout).text(), proc.exited]);
+    if (exitCode !== 0)
+      return null;
+    return parseRepoIdentity(stdout.trim());
+  } catch {
+    return null;
+  }
+}
+var GIT_DETECT_TIMEOUT_MS = 5000, SCP_RE, URL_RE;
+var init_repo = __esm(() => {
+  SCP_RE = /^(?:[^@/]+@)?([^/:]+):(.+)$/;
+  URL_RE = /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\/(?:[^@/]+@)?([^/:]+)(?::\d+)?\/(.+)$/;
+});
+
 // node_modules/.bun/react@18.3.1/node_modules/react/cjs/react-jsx-dev-runtime.development.js
 var require_react_jsx_dev_runtime_development = __commonJS((exports) => {
   var React10 = __toESM(require_react());
@@ -82787,6 +82862,12 @@ function buildFromAnswers(mode, answers, build = buildWorkflowMarkdown) {
       values2["linear.indicators"] = map3;
     }
   }
+  const linkRepo = values2[REPO_LINK_FIELD_ID] === true;
+  delete values2[REPO_LINK_FIELD_ID];
+  if (!linkRepo) {
+    for (const id of REPO_ANSWER_IDS)
+      delete values2[id];
+  }
   let bodyOverride;
   if (PROMPT_BODY_FIELD_ID in values2) {
     const body = values2[PROMPT_BODY_FIELD_ID];
@@ -82868,7 +82949,8 @@ function SetupWizard({
   initialValues,
   buildMarkdown,
   onlyFields,
-  initialBody
+  initialBody,
+  detectedRepo
 }) {
   const { exit } = use_app_default();
   const startValues = initialValues ?? {};
@@ -82944,7 +83026,15 @@ function SetupWizard({
     setIndex(target);
     initEditing(fieldsFor(mode, source)[target], source);
   };
-  const valuesToWrite = (source) => onlyFields ? Object.fromEntries(Object.entries(source).filter(([id]) => onlyFields.includes(id))) : source;
+  const valuesToWrite = (source) => {
+    if (!onlyFields)
+      return source;
+    const allowed = new Set(onlyFields);
+    if (allowed.has(REPO_LINK_FIELD_ID))
+      for (const id of REPO_ANSWER_IDS)
+        allowed.add(id);
+    return Object.fromEntries(Object.entries(source).filter(([id]) => allowed.has(id)));
+  };
   const advance = (source) => {
     const nextFields = fieldsFor(mode, source);
     if (index >= nextFields.length - 1) {
@@ -83152,6 +83242,22 @@ ${draft.slice(at2)}`, at2 + 1);
         marginTop: 1,
         flexDirection: "column",
         children: [
+          field.id === REPO_LINK_FIELD_ID && detectedRepo ? /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            children: [
+              /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+                dimColor: true,
+                children: "Detected repo: "
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+                color: "cyan",
+                children: [
+                  detectedRepo.owner,
+                  "/",
+                  detectedRepo.name
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this) : null,
           /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
             children: [
               /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
@@ -83724,13 +83830,14 @@ function IndicatorBuilder({
     ]
   }, undefined, true, undefined, this);
 }
-var import_react22, jsx_dev_runtime, MODE_OPTIONS, INDICATOR_OPTIONS, CONFIRM_OPTIONS, EDIT_EXIT_OPTIONS, RECREATE_EXIT_OPTIONS, MIGRATE_OPTIONS, CORE_STATES, CONFIRMATION_STATES, ALL_TYPES;
+var import_react22, jsx_dev_runtime, REPO_ANSWER_IDS, MODE_OPTIONS, INDICATOR_OPTIONS, CONFIRM_OPTIONS, EDIT_EXIT_OPTIONS, RECREATE_EXIT_OPTIONS, MIGRATE_OPTIONS, CORE_STATES, CONFIRMATION_STATES, ALL_TYPES;
 var init_SetupWizard = __esm(async () => {
   init_wizard();
   init_fields();
   await init_build2();
   import_react22 = __toESM(require_react(), 1);
   jsx_dev_runtime = __toESM(require_jsx_dev_runtime(), 1);
+  REPO_ANSWER_IDS = ["repo.remote", "repo.host", "repo.owner", "repo.name"];
   MODE_OPTIONS = [
     { label: "Quick \u2014 sensible defaults, only a few questions", value: "quick" },
     { label: "Permissive \u2014 defaults + auto-PR / auto-merge / CI auto-fix", value: "permissive" },
@@ -83856,6 +83963,11 @@ var init_migrations = __esm(() => {
         "openspec.reviewPhase.reviewerModel",
         "openspec.reviewPhase.reviewerContextStrategy"
       ]
+    },
+    {
+      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"]
     }
   ];
   LATEST_MIGRATION_VERSION = MIGRATIONS.reduce((max2, migration) => Math.max(max2, migration.version), 0);
@@ -83868,6 +83980,18 @@ __export(exports_src, {
   maybeRunSetupWizard: () => maybeRunSetupWizard,
   main: () => main
 });
+function withDetectedRepo(initial2, repo) {
+  if (!repo)
+    return initial2;
+  const values2 = { ...initial2 };
+  values2["repo.remote"] = repo.remote;
+  values2["repo.host"] = repo.host;
+  values2["repo.owner"] = repo.owner;
+  values2["repo.name"] = repo.name;
+  if (!values2["project.name"])
+    values2["project.name"] = repo.name;
+  return values2;
+}
 function clearScreen2() {
   if (process.stdout.isTTY)
     process.stdout.write("\x1B[2J\x1B[3J\x1B[H");
@@ -83876,6 +84000,7 @@ async function runSetupWizard(projectRoot, options = {}) {
   let markdown = null;
   const buildMarkdown = options.existing ? (answers, bodyOverride) => applyAnswersToWorkflow(options.existing, answers, bodyOverride) : undefined;
   const initialBody = workflowBody(options.existing ?? DEFAULT_WORKFLOW_MD);
+  const initialValues = withDetectedRepo(options.initialValues, options.detectedRepo);
   clearScreen2();
   const { waitUntilExit } = render_default(import_react23.createElement(SetupWizard, {
     onComplete: (md) => {
@@ -83886,8 +84011,9 @@ async function runSetupWizard(projectRoot, options = {}) {
     },
     initialBody,
     ...options.initialMode ? { initialMode: options.initialMode } : {},
-    ...options.initialValues ? { initialValues: options.initialValues } : {},
+    ...initialValues ? { initialValues } : {},
     ...options.onlyFields ? { onlyFields: options.onlyFields } : {},
+    ...options.detectedRepo ? { detectedRepo: { owner: options.detectedRepo.owner, name: options.detectedRepo.name } } : {},
     ...buildMarkdown ? { buildMarkdown } : {}
   }));
   await waitUntilExit();
@@ -83971,10 +84097,12 @@ async function promptMigrate(fromVersion) {
 }
 async function editExisting(projectRoot, path, config2, onlyFields) {
   const existing = await Bun.file(path).text();
+  const detectedRepo = await detectRepoIdentity(projectRoot);
   const wrote = await runSetupWizard(projectRoot, {
     existing,
     initialMode: "customized",
     initialValues: initialValuesFromConfig(config2),
+    ...detectedRepo ? { detectedRepo } : {},
     ...onlyFields ? { onlyFields } : {}
   });
   process.stdout.write(wrote ? `
@@ -84010,7 +84138,8 @@ async function main(argv) {
 `);
         return 0;
       }
-      const wrote2 = await runSetupWizard(projectRoot);
+      const detectedRepo2 = await detectRepoIdentity(projectRoot);
+      const wrote2 = await runSetupWizard(projectRoot, detectedRepo2 ? { detectedRepo: detectedRepo2 } : {});
       process.stdout.write(wrote2 ? `
 \u2713 Recreated ${path}
 ` : `
@@ -84043,7 +84172,8 @@ Setup cancelled \u2014 no file written.
 `);
     return 0;
   }
-  const wrote = await runSetupWizard(projectRoot);
+  const detectedRepo = await detectRepoIdentity(projectRoot);
+  const wrote = await runSetupWizard(projectRoot, detectedRepo ? { detectedRepo } : {});
   process.stdout.write(wrote ? `
 \u2713 Created ${path}
 ` : `
@@ -84056,6 +84186,7 @@ var init_src4 = __esm(async () => {
   init_paths();
   init_workflow();
   init_wizard();
+  init_repo();
   init_migrations();
   await __promiseAll([
     init_build2(),
@@ -99057,12 +99188,20 @@ var init_loop_machine = __esm(() => {
   });
 });
 
+// packages/core/src/machines/mcp-registry.ts
+var init_mcp_registry = __esm(() => {
+  init_example_machine();
+  init_flow_machine();
+  init_loop_machine();
+});
+
 // packages/core/src/machines/index.ts
 var init_machines = __esm(() => {
   init_example_machine();
   init_flow_machine();
   init_flow_actor_store();
   init_loop_machine();
+  init_mcp_registry();
 });
 
 // packages/core/src/tasks-md.ts
@@ -99156,10 +99295,112 @@ var init_tasks_md = __esm(() => {
   ];
 });
 
+// packages/core/src/prompt/effort.ts
+function countUnchecked2(tasksContent) {
+  const matches2 = tasksContent.match(/^\s*[-*]\s+\[ \]/gm);
+  return matches2 ? matches2.length : 0;
+}
+function clamp2(value, min2, max2) {
+  return Math.max(min2, Math.min(max2, value));
+}
+function detectEffort(state, options = {}) {
+  if (options.override)
+    return options.override;
+  const prompt = (state.prompt ?? "").toLowerCase();
+  let keywordScore = 0;
+  for (const kw of HEAVY_KEYWORDS) {
+    if (prompt.includes(kw))
+      keywordScore += HEAVY_WEIGHT;
+  }
+  for (const kw of LIGHT_KEYWORDS) {
+    if (prompt.includes(kw))
+      keywordScore += LIGHT_WEIGHT;
+  }
+  keywordScore = clamp2(keywordScore, -KEYWORD_HIT_CAP, KEYWORD_HIT_CAP);
+  let score = keywordScore;
+  const hasHeavyKeyword = keywordScore > 0;
+  if (prompt.length > 0 && prompt.length < SHORT_PROMPT_CHARS && !hasHeavyKeyword) {
+    score -= 1;
+  } else if (prompt.length > LONG_PROMPT_CHARS) {
+    score += 1;
+  }
+  if (options.tasksContent) {
+    const unchecked = countUnchecked2(options.tasksContent);
+    if (unchecked > 0 && unchecked <= FEW_TASKS) {
+      score -= 2;
+    } else if (unchecked >= MANY_TASKS) {
+      score += 2;
+    }
+  }
+  if (score <= LIGHT_THRESHOLD)
+    return "light";
+  if (score >= HEAVY_THRESHOLD)
+    return "heavy";
+  return "standard";
+}
+var HEAVY_KEYWORDS, LIGHT_KEYWORDS, HEAVY_WEIGHT = 2, LIGHT_WEIGHT = -2, KEYWORD_HIT_CAP = 4, SHORT_PROMPT_CHARS = 120, LONG_PROMPT_CHARS = 600, FEW_TASKS = 2, MANY_TASKS = 8, LIGHT_THRESHOLD = -2, HEAVY_THRESHOLD = 2, EFFORT_GUIDANCE;
+var init_effort = __esm(() => {
+  HEAVY_KEYWORDS = [
+    "migrate",
+    "refactor",
+    "redesign",
+    "re-architect",
+    "architecture",
+    "rewrite",
+    "overhaul",
+    "breaking change",
+    "investigate",
+    "spike",
+    "cross-cutting",
+    "end-to-end"
+  ];
+  LIGHT_KEYWORDS = [
+    "typo",
+    "rename",
+    "bump",
+    "tweak",
+    "wording",
+    "copy",
+    "comment",
+    "lint",
+    "docs",
+    "one-liner",
+    "revert",
+    "whitespace"
+  ];
+  EFFORT_GUIDANCE = {
+    light: [
+      "This ticket looks **light**. Make the smallest correct change.",
+      "- Skip research/design ceremony \u2014 go straight to the fix",
+      "- Avoid speculative abstraction; do not expand scope",
+      "- Aim to finish in as few iterations as possible"
+    ].join(`
+`),
+    standard: [
+      "This ticket looks **standard**. Balance thoroughness with momentum.",
+      "- Do enough investigation to be confident, but don't over-engineer",
+      "- Keep changes focused on the stated scope",
+      "- Verify with the project's lint and test gates before finishing"
+    ].join(`
+`),
+    heavy: [
+      "This ticket looks **heavy**. Invest up front before changing code.",
+      "- Research the affected areas and write a real design",
+      "- Break the work into small, independently-verifiable tasks",
+      "- Watch for cross-cutting impact and regressions as you go"
+    ].join(`
+`)
+  };
+});
+
 // packages/core/src/prompt/meta-prompt.ts
 function buildMetaPrompt(state, phase, options = {}) {
   if (options.enabled === false)
     return "";
+  const effort = detectEffort(state, {
+    ...options.effort !== undefined ? { override: options.effort } : {},
+    ...options.tasksContent !== undefined ? { tasksContent: options.tasksContent } : {}
+  });
   let out = `---
 
 ## Task Context
@@ -99170,6 +99411,8 @@ function buildMetaPrompt(state, phase, options = {}) {
   out += `**Engine/Model:** ${state.engine} / ${state.model}
 `;
   out += `**Phase:** ${phase}
+`;
+  out += `**Effort:** ${effort}
 `;
   out += `**Iteration:** ${state.iteration + 1}`;
   if (options.maxIterations && options.maxIterations > 0) {
@@ -99193,6 +99436,12 @@ function buildMetaPrompt(state, phase, options = {}) {
 `;
   out += PHASE_GUIDANCE[phase] + `
 
+`;
+  out += `### Effort Guidance
+
+`;
+  out += EFFORT_GUIDANCE[effort] + `
+
 `;
   const flags = [];
   if (options.useWorktree) {
@@ -99225,6 +99474,7 @@ function buildMetaPrompt(state, phase, options = {}) {
 }
 var PHASE_GUIDANCE;
 var init_meta_prompt = __esm(() => {
+  init_effort();
   PHASE_GUIDANCE = {
     research: [
       "You are in the **research** phase. Your goal is to understand, not to implement.",
@@ -99698,6 +99948,7 @@ var init_loop = __esm(() => {
   init_tasks_md();
   init_phase();
   init_meta_prompt();
+  init_effort();
   init_tasks_md();
 });
 
@@ -99978,7 +100229,10 @@ function useLoop(opts) {
           design: designContent,
           tasks: tasksContent
         });
-        const prompt = buildPhasePrompt(routedPhase, currentState, tasksDir, opts.reviewPhase, opts.metaPrompt);
+        const prompt = buildPhasePrompt(routedPhase, currentState, tasksDir, opts.reviewPhase, {
+          ...opts.metaPrompt,
+          ...tasksContent !== null ? { tasksContent } : {}
+        });
         const iterStart = new Date().toISOString();
         try {
           const controller = new AbortController;
@@ -101164,7 +101418,8 @@ async function parseAgentArgs(argv) {
     debug: false,
     noTmux: false,
     checks: false,
-    review: false
+    review: false,
+    ticketTokens: []
   };
   const state = emptyParseState();
   let expectLinearTeam = false;
@@ -101174,6 +101429,7 @@ async function parseAgentArgs(argv) {
   let expectMaxTickets = false;
   let expectIndicator = false;
   let expectJsonLogFile = false;
+  let expectTicket = false;
   for (const arg of argv) {
     if (expectLinearTeam) {
       result2.linearTeam = arg;
@@ -101211,6 +101467,14 @@ async function parseAgentArgs(argv) {
       expectJsonLogFile = false;
       continue;
     }
+    if (expectTicket) {
+      for (const token of arg.split(",").map((t) => t.trim())) {
+        if (token)
+          result2.ticketTokens.push(token);
+      }
+      expectTicket = false;
+      continue;
+    }
     if (parseCommonArg(arg, result2, state))
       continue;
     switch (arg) {
@@ -101229,6 +101493,9 @@ async function parseAgentArgs(argv) {
       case "--max-tickets":
         expectMaxTickets = true;
         break;
+      case "--ticket":
+        expectTicket = true;
+        break;
       case "--worktree":
         result2.worktree = true;
         break;
@@ -101353,6 +101620,7 @@ var init_cli2 = __esm(() => {
     "  --stack-prs             Base the PR on a blocker issue's open-PR head branch when present (needs --create-pr)",
     "  --code-review           Watch open tracked PRs for unresolved review comments",
     "  --max-tickets <n>       Stop picking up new issues after N have been started (0 = unlimited)",
+    "  --ticket <id>           Restrict issue discovery to specific ticket(s); repeatable or comma-separated (e.g. RLF-208 or 208)",
     "  --no-tmux               Disable tmux session management; run agent in the foreground directly",
     "  --no-pr-tracker         Disable RLF-173 pr-tracker bail / recovery counter for this run",
     "  --json-output           Emit JSONL to stdout instead of the Ink dashboard (for scripting/CI)",
@@ -101374,6 +101642,11 @@ var init_cli2 = __esm(() => {
 });
 
 // apps/agent/src/agent/config.ts
+var exports_config = {};
+__export(exports_config, {
+  loadRalphyConfig: () => loadRalphyConfig,
+  ensureRalphyConfig: () => ensureRalphyConfig
+});
 async function loadRalphyConfig(projectRoot) {
   const { config: config2 } = await loadWorkflow(projectRoot);
   return config2;
@@ -101734,10 +102007,107 @@ function findBoundaryViolations(changedFiles, patterns) {
 // apps/agent/src/shared/utils/ralph-comment.ts
 function isRalphComment(body) {
   const trimmed = body.trimStart();
-  return /^(\uD83E\uDD16|\uD83D\uDD04|\u2705|\u2717|\u26A0|\uD83D\uDD01|\uD83D\uDCCB)\s*Ralphy?\b/.test(trimmed);
+  return /^(\uD83E\uDD16|\uD83D\uDD04|\u2705|\u2717|\u274C|\u26A0|\uD83D\uDD01|\uD83D\uDCCB|\u23F0)\s*Ralphy?\b/.test(trimmed);
 }
 
 // apps/agent/src/shared/capabilities/linear-client.ts
+var exports_linear_client = {};
+__export(exports_linear_client, {
+  upsertRalphyAttachment: () => upsertRalphyAttachment,
+  uploadFileToLinear: () => uploadFileToLinear,
+  updateIssueState: () => updateIssueState,
+  updateIssueDescription: () => updateIssueDescription,
+  updateIssueComment: () => updateIssueComment,
+  updateAttachmentSubtitle: () => updateAttachmentSubtitle,
+  setIssueProject: () => setIssueProject,
+  resolveTicketNumbers: () => resolveTicketNumbers,
+  removeLabelFromIssue: () => removeLabelFromIssue,
+  parseTicketIdentifier: () => parseTicketIdentifier,
+  linearRequestInternals: () => linearRequestInternals,
+  issueMatchesGetIndicator: () => issueMatchesGetIndicator,
+  isRateLimitedError: () => isRateLimitedError,
+  formatTicketError: () => formatTicketError,
+  formatLinearError: () => formatLinearError,
+  findOpenIssueByLabel: () => findOpenIssueByLabel,
+  findIssueAttachmentByTitle: () => findIssueAttachmentByTitle,
+  fetchWorkflowStates: () => fetchWorkflowStates,
+  fetchTeamIdByKey: () => fetchTeamIdByKey,
+  fetchProjectIdByName: () => fetchProjectIdByName,
+  fetchOpenIssues: () => fetchOpenIssues,
+  fetchMentionScanIssues: () => fetchMentionScanIssues,
+  fetchIssueLabels: () => fetchIssueLabels,
+  fetchIssueComments: () => fetchIssueComments,
+  fetchIssueAttachments: () => fetchIssueAttachments,
+  fetchAttachmentsForIssues: () => fetchAttachmentsForIssues,
+  deleteIssueComment: () => deleteIssueComment,
+  deleteAttachment: () => deleteAttachment,
+  createRalphyAttachment: () => createRalphyAttachment,
+  createIssueLabel: () => createIssueLabel,
+  createIssueComment: () => createIssueComment,
+  createIssue: () => createIssue,
+  createAttachmentForUrl: () => createAttachmentForUrl,
+  clauseFromMarkers: () => clauseFromMarkers,
+  buildIssueFilter: () => buildIssueFilter,
+  baseBranchFromLabels: () => baseBranchFromLabels,
+  addReactionToComment: () => addReactionToComment,
+  addLabelToIssue: () => addLabelToIssue,
+  addIssueComment: () => addIssueComment,
+  RALPHY_ATTACHMENT_TITLE: () => RALPHY_ATTACHMENT_TITLE
+});
+function parseTicketIdentifier(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    throw new Error("--ticket value cannot be empty");
+  }
+  const bare = TICKET_BARE_NUMBER_RE.exec(trimmed);
+  if (bare) {
+    return { teamKey: null, number: Number(bare[1]) };
+  }
+  const match = TICKET_IDENTIFIER_RE.exec(trimmed);
+  if (!match) {
+    const err = new Error("--ticket value is not a Linear ticket (expected e.g. RLF-208 or 208)");
+    err.value = raw;
+    throw err;
+  }
+  return { teamKey: match[1].toUpperCase(), number: Number(match[2]) };
+}
+function resolveTicketNumbers(tokens, team) {
+  const teamKey = team?.trim() ? team.trim().toUpperCase() : null;
+  const seen = new Set;
+  const out = [];
+  for (const token of tokens) {
+    const { teamKey: parsedTeam, number: number4 } = parseTicketIdentifier(token);
+    if (parsedTeam !== null) {
+      if (teamKey !== null && parsedTeam !== teamKey) {
+        const err = new Error("--ticket identifier is not in the configured team");
+        err.ticket = token;
+        err.team = team;
+        throw err;
+      }
+    } else if (teamKey === null) {
+      const err = new Error("--ticket bare number needs a configured team; pass --linear-team or set linear.team in config");
+      err.ticket = token;
+      throw err;
+    }
+    if (!seen.has(number4)) {
+      seen.add(number4);
+      out.push(number4);
+    }
+  }
+  return out;
+}
+function formatTicketError(err) {
+  if (!(err instanceof Error))
+    return String(err);
+  const e = err;
+  const detail = e.ticket ?? e.value;
+  const parts = [];
+  if (detail)
+    parts.push(`ticket: ${detail}`);
+  if (e.team)
+    parts.push(`configured team: ${e.team}`);
+  return parts.length > 0 ? `${e.message} (${parts.join(", ")})` : e.message;
+}
 function partition2(markers) {
   const statuses = [];
   const labels = [];
@@ -101770,6 +102140,9 @@ function buildIssueFilter(spec) {
   } else {
     where.assignee = { null: true };
   }
+  if (spec.numbers && spec.numbers.length > 0) {
+    where.number = { in: spec.numbers };
+  }
   const inc = spec.include ?? [];
   if (inc.length > 0) {
     const { statuses, labels, attachmentSubtitles, projects } = partition2(inc);
@@ -101873,6 +102246,30 @@ function clauseFromMarkers(markers) {
     parts.project = { name: { in: projects } };
   return Object.keys(parts).length > 0 ? parts : null;
 }
+function mapNodeProject(node2) {
+  if (!node2.project)
+    return null;
+  return {
+    id: node2.project.id,
+    name: node2.project.name,
+    ...node2.project.priority !== undefined && node2.project.priority !== null ? { priority: node2.project.priority } : {}
+  };
+}
+function mapNodeMilestone(node2) {
+  const m = node2.projectMilestone;
+  if (!m)
+    return;
+  return {
+    id: m.id,
+    name: m.name,
+    sortOrder: m.sortOrder,
+    ...m.targetDate != null ? { targetDate: m.targetDate } : {}
+  };
+}
+function milestoneSpread(node2) {
+  const m = mapNodeMilestone(node2);
+  return m ? { milestone: m } : {};
+}
 async function fetchMentionScanIssues(apiKey, spec) {
   const branches = [];
   const { getTodo, getInProgress, setDone } = spec.indicators;
@@ -101901,13 +102298,17 @@ async function fetchMentionScanIssues(apiKey, spec) {
     else
       where.assignee = { id: { eq: spec.assignee } };
   }
+  if (spec.numbers && spec.numbers.length > 0) {
+    where.number = { in: spec.numbers };
+  }
   const query = `query MentionScanIssues($filter: IssueFilter) {
     issues(filter: $filter, first: 50) {
       nodes {
         id identifier title description url priority createdAt
         state { name type }
         assignee { id email name }
-        project { id name }
+        project { id name priority }
+        projectMilestone { id name sortOrder targetDate }
         labels { nodes { name } }
         relations(first: 50) {
           nodes { type relatedIssue { id identifier state { type } } }
@@ -101930,7 +102331,8 @@ async function fetchMentionScanIssues(apiKey, spec) {
     url: n.url,
     state: n.state,
     assignee: n.assignee,
-    project: n.project ?? null,
+    project: mapNodeProject(n),
+    ...milestoneSpread(n),
     labels: n.labels.nodes.map((l) => l.name),
     priority: n.priority,
     createdAt: n.createdAt ?? "",
@@ -101951,7 +102353,8 @@ async function fetchOpenIssues(apiKey, spec, options) {
         id identifier title description url priority createdAt
         state { name type }
         assignee { id email name }
-        project { id name }
+        project { id name priority }
+        projectMilestone { id name sortOrder targetDate }
         labels { nodes { name } }
         relations(first: 50) {
           nodes {
@@ -101975,7 +102378,8 @@ async function fetchOpenIssues(apiKey, spec, options) {
     url: n.url,
     state: n.state,
     assignee: n.assignee,
-    project: n.project ?? null,
+    project: mapNodeProject(n),
+    ...milestoneSpread(n),
     labels: n.labels.nodes.map((l) => l.name),
     priority: n.priority,
     createdAt: n.createdAt ?? "",
@@ -102488,9 +102892,11 @@ async function removeLabelFromIssue(apiKey, issueId, labelId) {
     labelId
   });
 }
-var LINEAR_API = "https://api.linear.app/graphql", RALPHY_ATTACHMENT_TITLE_FILTER = "Ralphy", linearRequestInternals, MAX_LINEAR_ATTEMPTS = 3, MAX_RETRY_AFTER_MS = 2000, BODY_TRUNCATE_CHARS = 512, RALPHY_ATTACHMENT_TITLE = "Ralphy", BRANCH_LABEL_PREFIX = "ralph:branch:";
+var LINEAR_API = "https://api.linear.app/graphql", TICKET_IDENTIFIER_RE, TICKET_BARE_NUMBER_RE, RALPHY_ATTACHMENT_TITLE_FILTER = "Ralphy", linearRequestInternals, MAX_LINEAR_ATTEMPTS = 3, MAX_RETRY_AFTER_MS = 2000, BODY_TRUNCATE_CHARS = 512, RALPHY_ATTACHMENT_TITLE = "Ralphy", BRANCH_LABEL_PREFIX = "ralph:branch:";
 var init_linear_client = __esm(() => {
   init_types2();
+  TICKET_IDENTIFIER_RE = /^([A-Za-z]+)-(\d+)(?:-.*)?$/;
+  TICKET_BARE_NUMBER_RE = /^(\d+)$/;
   linearRequestInternals = {
     sleep: (ms) => Bun.sleep(ms)
   };
@@ -104113,17 +104519,183 @@ var init_post_task = __esm(() => {
   repoAutoMergeCache = new Map;
 });
 
-// apps/agent/src/sort/compare.ts
-function chain(...comparators) {
-  return (a, b) => {
-    for (const c of comparators) {
-      const r = c(a, b);
-      if (r !== 0)
-        return r;
-    }
+// packages/core/src/ordering/hierarchical-order.ts
+function rank(priority) {
+  return !priority ? Number.POSITIVE_INFINITY : priority;
+}
+function cmpMaybe(a, b, cmp) {
+  if (a === undefined && b === undefined)
     return 0;
-  };
+  if (a === undefined)
+    return 1;
+  if (b === undefined)
+    return -1;
+  return cmp(a, b);
 }
+function cmpString(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+function cmpNumber(a, b) {
+  return a - b;
+}
+function cmpRank(a, b) {
+  return a === b ? 0 : a < b ? -1 : 1;
+}
+function orderIssuesHierarchically(issues, opts = {}) {
+  const log3 = opts.log ?? ((message) => console.warn(message));
+  if (issues.length <= 1)
+    return issues.slice();
+  const projectBuckets = new Map;
+  for (const issue2 of issues) {
+    const key = issue2.project?.id ?? NO_PROJECT;
+    const bucket = projectBuckets.get(key);
+    if (bucket)
+      bucket.push(issue2);
+    else
+      projectBuckets.set(key, [issue2]);
+  }
+  const projectKeys = [...projectBuckets.keys()].sort((a, b) => {
+    if (a === NO_PROJECT)
+      return b === NO_PROJECT ? 0 : 1;
+    if (b === NO_PROJECT)
+      return -1;
+    const ba = projectBuckets.get(a);
+    const bb = projectBuckets.get(b);
+    const ra = rank(ba[0]?.project?.priority);
+    const rb = rank(bb[0]?.project?.priority);
+    if (ra !== rb)
+      return cmpRank(ra, rb);
+    if (a !== b)
+      return cmpString(a, b);
+    return cmpString(earliestCreatedAt(ba), earliestCreatedAt(bb));
+  });
+  const ordered = [];
+  for (const projectKey of projectKeys) {
+    orderProjectBucket(projectBuckets.get(projectKey), ordered, log3);
+  }
+  return ordered;
+}
+function earliestCreatedAt(bucket) {
+  let earliest = bucket[0].createdAt;
+  for (const issue2 of bucket) {
+    if (issue2.createdAt < earliest)
+      earliest = issue2.createdAt;
+  }
+  return earliest;
+}
+function orderProjectBucket(bucket, ordered, log3) {
+  const milestoneBuckets = new Map;
+  for (const issue2 of bucket) {
+    const key = issue2.milestone?.id ?? NO_MILESTONE;
+    const b = milestoneBuckets.get(key);
+    if (b)
+      b.push(issue2);
+    else
+      milestoneBuckets.set(key, [issue2]);
+  }
+  const milestoneOf = new Map;
+  for (const [key, b] of milestoneBuckets) {
+    for (const issue2 of b)
+      milestoneOf.set(issue2.id, key);
+  }
+  const milestonePrereqs = new Map;
+  for (const key of milestoneBuckets.keys())
+    milestonePrereqs.set(key, new Set);
+  for (const issue2 of bucket) {
+    const from = milestoneOf.get(issue2.id);
+    for (const blockerId of issue2.blockedByIds) {
+      const blockerMilestone = milestoneOf.get(blockerId);
+      if (blockerMilestone === undefined)
+        continue;
+      if (blockerMilestone === from)
+        continue;
+      milestonePrereqs.get(from).add(blockerMilestone);
+    }
+  }
+  const milestoneMeta = new Map;
+  for (const [key, b] of milestoneBuckets) {
+    milestoneMeta.set(key, key === NO_MILESTONE ? undefined : b[0].milestone);
+  }
+  const milestoneOrder = topoOrder([...milestoneBuckets.keys()], (key) => milestonePrereqs.get(key), (a, b) => {
+    if (a === NO_MILESTONE)
+      return b === NO_MILESTONE ? 0 : 1;
+    if (b === NO_MILESTONE)
+      return -1;
+    const ma = milestoneMeta.get(a);
+    const mb = milestoneMeta.get(b);
+    const so = cmpNumber(ma?.sortOrder ?? 0, mb?.sortOrder ?? 0);
+    if (so !== 0)
+      return so;
+    const td = cmpMaybe(ma?.targetDate, mb?.targetDate, cmpString);
+    if (td !== 0)
+      return td;
+    return cmpString(a, b);
+  }, (key) => log3(`hierarchical-order: milestone dependency cycle involving "${key}"; breaking by selection key`));
+  for (const milestoneKey of milestoneOrder) {
+    orderMilestoneBucket(milestoneBuckets.get(milestoneKey), ordered, log3);
+  }
+}
+function orderMilestoneBucket(bucket, ordered, log3) {
+  const inBucket = new Set(bucket.map((i) => i.id));
+  const byId = new Map(bucket.map((i) => [i.id, i]));
+  const order = topoOrder(bucket.map((i) => i.id), (id) => {
+    const prereqs = new Set;
+    for (const blockerId of byId.get(id).blockedByIds) {
+      if (inBucket.has(blockerId))
+        prereqs.add(blockerId);
+    }
+    return prereqs;
+  }, (a, b) => {
+    const ia = byId.get(a);
+    const ib = byId.get(b);
+    const rp = cmpRank(rank(ia.priority), rank(ib.priority));
+    if (rp !== 0)
+      return rp;
+    const tb = cmpNumber(ia.tiebreak ?? 0, ib.tiebreak ?? 0);
+    if (tb !== 0)
+      return tb;
+    const cc = cmpString(ia.createdAt, ib.createdAt);
+    if (cc !== 0)
+      return cc;
+    return cmpString(a, b);
+  }, (id) => log3(`hierarchical-order: item dependency cycle involving "${id}"; breaking by selection key`));
+  for (const id of order)
+    ordered.push(byId.get(id));
+}
+function topoOrder(nodes, prereqsOf, select2, onCycle) {
+  const remaining = new Set(nodes);
+  const placed = new Set;
+  const result2 = [];
+  while (remaining.size > 0) {
+    const eligible = [];
+    for (const node2 of remaining) {
+      let ready = true;
+      for (const prereq of prereqsOf(node2)) {
+        if (remaining.has(prereq) && !placed.has(prereq)) {
+          ready = false;
+          break;
+        }
+      }
+      if (ready)
+        eligible.push(node2);
+    }
+    let pick3;
+    if (eligible.length > 0) {
+      pick3 = eligible.sort(select2)[0];
+    } else {
+      pick3 = [...remaining].sort(select2)[0];
+      onCycle(pick3);
+    }
+    result2.push(pick3);
+    placed.add(pick3);
+    remaining.delete(pick3);
+  }
+  return result2;
+}
+var NO_PROJECT = "\x00no-project", NO_MILESTONE = "\x00no-milestone";
+
+// packages/core/src/ordering/index.ts
+var init_ordering = () => {};
 
 // apps/agent/src/queue/queue-order.ts
 function defaultPriorityFor(trigger) {
@@ -104140,21 +104712,70 @@ function defaultPriorityFor(trigger) {
       return 4;
   }
 }
-function compareQueueEntries(getAutoMerge) {
-  const isAutoMergeBoost = (e) => e.trigger === "conflict-fix" && issueMatchesGetIndicator(e.issue, getAutoMerge);
-  return chain((a, b) => Number(!isAutoMergeBoost(a)) - Number(!isAutoMergeBoost(b)), (a, b) => {
-    const pa = a.issue.priority === 0 ? Infinity : a.issue.priority;
-    const pb = b.issue.priority === 0 ? Infinity : b.issue.priority;
-    return pa - pb;
-  }, (a, b) => a.priority - b.priority, (a, b) => {
-    const ca = a.issue.createdAt;
-    const cb = b.issue.createdAt;
-    if (ca === cb)
-      return 0;
-    return ca < cb ? -1 : 1;
-  });
+function isAutoMergeBoost(e, getAutoMerge) {
+  return e.trigger === "conflict-fix" && issueMatchesGetIndicator(e.issue, getAutoMerge);
+}
+function linearIssueToOrderable(issue2, tiebreak) {
+  return {
+    id: issue2.id,
+    ...issue2.project ? {
+      project: {
+        id: issue2.project.id,
+        ...issue2.project.priority !== undefined ? { priority: issue2.project.priority } : {}
+      }
+    } : {},
+    ...issue2.milestone ? {
+      milestone: {
+        id: issue2.milestone.id,
+        sortOrder: issue2.milestone.sortOrder,
+        ...issue2.milestone.targetDate ? { targetDate: issue2.milestone.targetDate } : {}
+      }
+    } : {},
+    priority: issue2.priority,
+    ...tiebreak !== undefined ? { tiebreak } : {},
+    blockedByIds: issue2.blockedByIds,
+    createdAt: issue2.createdAt
+  };
+}
+function toOrderable(entry) {
+  return { ...linearIssueToOrderable(entry.issue, entry.priority), entry };
+}
+function orderEntries(entries) {
+  if (entries.length <= 1)
+    return entries.slice();
+  const repByIssue = new Map;
+  for (const entry of entries) {
+    const orderable = toOrderable(entry);
+    const existing = repByIssue.get(orderable.id);
+    if (!existing || orderable.tiebreak < existing.tiebreak) {
+      repByIssue.set(orderable.id, orderable);
+    }
+  }
+  const rankOf = new Map;
+  orderIssuesHierarchically([...repByIssue.values()]).forEach((o, i) => rankOf.set(o.id, i));
+  return entries.map((entry, index) => ({ entry, index })).sort((a, b) => {
+    const ra = rankOf.get(a.entry.issue.id);
+    const rb = rankOf.get(b.entry.issue.id);
+    if (ra !== rb)
+      return ra - rb;
+    if (a.entry.priority !== b.entry.priority)
+      return a.entry.priority - b.entry.priority;
+    return a.index - b.index;
+  }).map((x) => x.entry);
+}
+function orderQueueEntries(entries, getAutoMerge) {
+  const boosted = [];
+  const rest2 = [];
+  for (const e of entries) {
+    if (isAutoMergeBoost(e, getAutoMerge))
+      boosted.push(e);
+    else
+      rest2.push(e);
+  }
+  return [...orderEntries(boosted), ...orderEntries(rest2)];
 }
 var init_queue_order = __esm(() => {
+  init_ordering();
   init_linear();
 });
 
@@ -104354,7 +104975,7 @@ class AgentCoordinator {
     }
     const prStatus = await this.scanPrMergeStates();
     if (this.queue.length > 0) {
-      this.queue.sort(compareQueueEntries(this.opts.getAutoMerge));
+      this.queue = orderQueueEntries(this.queue, this.opts.getAutoMerge);
     }
     this.spawnNext();
     await this.reportProgress();
@@ -105580,6 +106201,10 @@ async function releaseAwaitingMarker(issue2, statePath, deps) {
     deps.onLog(`! persist cleared awaitingMarkerAppliedAt for ${issue2.identifier}: ${err.message}`, "yellow");
   }
 }
+function confirmationUsesCommentIndicator(cfg) {
+  const { getApproved, getAutoApprove, getConfirmGate } = cfg.linear.indicators;
+  return [getApproved, getAutoApprove, getConfirmGate].some((g) => g?.filter.some((m) => m.type === "comment"));
+}
 async function processAwaitingForIssue(issue2, deps) {
   try {
     const { cfg, apiKey, indicators } = deps;
@@ -105600,10 +106225,26 @@ async function processAwaitingForIssue(issue2, deps) {
     const tasks2 = await readTextOrNull(join24(changeDir, "tasks.md"));
     const proposal = await readTextOrNull(join24(changeDir, "proposal.md"));
     const design = await readTextOrNull(join24(changeDir, "design.md"));
+    let commentsCache = null;
+    const getComments = async () => {
+      if (commentsCache)
+        return commentsCache;
+      if (!apiKey)
+        return commentsCache = [];
+      try {
+        const cs = await fetchIssueComments(apiKey, issue2.id);
+        commentsCache = cs.map((c) => ({ id: c.id, body: c.body, createdAt: c.createdAt }));
+      } catch {
+        commentsCache = [];
+      }
+      return commentsCache;
+    };
+    const commentBodies = confirmationUsesCommentIndicator(cfg) ? (await getComments()).filter((c) => !isRalphComment(c.body)).map((c) => c.body) : undefined;
     const ticketView = {
       labels: issue2.labels,
       state: issue2.state,
-      project: issue2.project
+      project: issue2.project,
+      ...commentBodies ? { commentBodies } : {}
     };
     const { approved: approvalMatches, confirmationGated } = computeConfirmationFlags(cfg, ticketView);
     const { stateObj, confirmation } = await readConfirmationState(statePath);
@@ -105675,16 +106316,7 @@ async function processAwaitingForIssue(issue2, deps) {
       postComments: cfg.linear.postComments !== false && Boolean(apiKey)
     }, {
       approvalMatches,
-      fetchComments: async () => {
-        if (!apiKey)
-          return [];
-        try {
-          const cs = await fetchIssueComments(apiKey, issue2.id);
-          return cs.map((c) => ({ id: c.id, body: c.body, createdAt: c.createdAt }));
-        } catch {
-          return [];
-        }
-      },
+      fetchComments: getComments,
       ...indicators.clearApproved ? { clearApproved: indicators.clearApproved } : {},
       applyIndicator: (ind) => deps.applyIndicator(issue2, ind),
       postComment: async (body) => {
@@ -105937,6 +106569,7 @@ var init_indicators = __esm(() => {
 // apps/agent/src/agent/wire/linear-resolvers.ts
 function createLinearResolvers(input) {
   const { apiKey, team, assignee, diag } = input;
+  const ticketNumbers = input.ticketNumbers ?? [];
   const stateCache = new Map;
   const labelCache = new Map;
   const teamIdCache = new Map;
@@ -106048,7 +106681,13 @@ function createLinearResolvers(input) {
     if (include.length === 0)
       return [];
     const hasCommentMarker = include.some((m) => m.type === "comment");
-    const spec = { team, assignee, include, exclude: excl };
+    const spec = {
+      team,
+      assignee,
+      include,
+      exclude: excl,
+      ...ticketNumbers.length > 0 ? { numbers: ticketNumbers } : {}
+    };
     const fetched = await fetchOpenIssues(apiKey, spec, hasCommentMarker ? { includeComments: true } : undefined);
     if (!hasCommentMarker)
       return fetched;
@@ -106067,7 +106706,7 @@ function createLinearResolvers(input) {
     resolveLabelIdForTeam
   };
 }
-async function fetchDoneCandidatesWith(apiKey, team, _assignee, indicators) {
+async function fetchDoneCandidatesWith(apiKey, team, _assignee, indicators, ticketNumbers) {
   const getIndicators = [
     indicators.getTodo,
     indicators.getInProgress,
@@ -106090,7 +106729,8 @@ async function fetchDoneCandidatesWith(apiKey, team, _assignee, indicators) {
       team,
       anyAssignee: true,
       include,
-      exclude: []
+      exclude: [],
+      ...ticketNumbers && ticketNumbers.length > 0 ? { numbers: ticketNumbers } : {}
     });
     for (const issue2 of issues) {
       if (!seen.has(issue2.id)) {
@@ -106579,7 +107219,7 @@ async function fetchPrReviewState(prUrl, cmdRunner, projectRoot, onLog) {
         reviewRequests(first:5){nodes{requestedReviewer{... on User{login}}}}
         latestReviews(first:5){nodes{author{login} state submittedAt}}
         reviewThreads(first:50){nodes{
-          isResolved path line
+          isResolved subjectType path line
           comments(first:20){nodes{body author{login} createdAt url}}
         }}
       }
@@ -106612,6 +107252,7 @@ async function fetchPrReviewState(prUrl, cmdRunner, projectRoot, onLog) {
       approved: pr2.reviewDecision === "APPROVED",
       threads: (pr2.reviewThreads?.nodes ?? []).map((t) => ({
         isResolved: t.isResolved,
+        isFileLevel: t.subjectType === "FILE",
         ...t.path ? { path: t.path } : {},
         ...t.line != null ? { line: t.line } : {},
         comments: t.comments.nodes.map((c) => ({
@@ -106678,7 +107319,7 @@ async function scanCodeReview(issue2, prUrl, lastRalphPickup, deps) {
   const effectiveLastHandled = lastRalphPickup && lastHandled ? lastRalphPickup > lastHandled ? lastRalphPickup : lastHandled : lastRalphPickup ?? lastHandled;
   if (!effectiveLastHandled || newestReviewerActivity > effectiveLastHandled) {
     const body = unresolved.map((t) => {
-      const head3 = t.path ? `_${t.path}${t.line ? `:${t.line}` : ""}_` : "_(general)_";
+      const head3 = t.path ? t.isFileLevel ? `_${t.path} (whole file)_` : `_${t.path}${t.line ? `:${t.line}` : ""}_` : "_(general)_";
       const lines = t.comments.map((c) => `> **${c.author ?? "reviewer"}** (${c.createdAt})
 >
 > ${c.body.trim().replace(/\n/g, `
@@ -106783,6 +107424,7 @@ function createMentionScanner(input) {
     onLog,
     diag,
     cwdByChange,
+    ticketNumbers,
     stalePingedAt,
     lastHandledReviewActivity,
     resolvePrUrlForIssue
@@ -106798,6 +107440,7 @@ function createMentionScanner(input) {
       candidates = await fetchMentionScanIssues(apiKey, {
         team,
         assignee,
+        ...ticketNumbers && ticketNumbers.length > 0 ? { numbers: ticketNumbers } : {},
         indicators: {
           ...indicators.getTodo !== undefined ? { getTodo: indicators.getTodo } : {},
           ...indicators.getInProgress !== undefined ? { getInProgress: indicators.getInProgress } : {},
@@ -239276,9 +239919,9 @@ class $50c7aac9316f2948$export$2e2bcd8739ae039 {
 
 class $55f71433a605c87d$export$2e2bcd8739ae039 {
   process(glyphs, features = {}) {
-    for (let chain2 of this.morx.chains) {
-      let flags = chain2.defaultFlags;
-      for (let feature of chain2.features) {
+    for (let chain of this.morx.chains) {
+      let flags = chain.defaultFlags;
+      for (let feature of chain.features) {
         let f2;
         if (f2 = features[feature.featureType]) {
           if (f2[feature.featureSetting]) {
@@ -239290,7 +239933,7 @@ class $55f71433a605c87d$export$2e2bcd8739ae039 {
           }
         }
       }
-      for (let subtable of chain2.subtables)
+      for (let subtable of chain.subtables)
         if (subtable.subFeatureFlags & flags)
           this.processSubtable(subtable, glyphs);
     }
@@ -239437,8 +240080,8 @@ class $55f71433a605c87d$export$2e2bcd8739ae039 {
   }
   getSupportedFeatures() {
     let features = [];
-    for (let chain2 of this.morx.chains)
-      for (let feature of chain2.features)
+    for (let chain of this.morx.chains)
+      for (let feature of chain.features)
         features.push([
           feature.featureType,
           feature.featureSetting
@@ -239452,9 +240095,9 @@ class $55f71433a605c87d$export$2e2bcd8739ae039 {
   }
   generateInputCache() {
     this.inputCache = {};
-    for (let chain2 of this.morx.chains) {
-      let flags = chain2.defaultFlags;
-      for (let subtable of chain2.subtables)
+    for (let chain of this.morx.chains) {
+      let flags = chain.defaultFlags;
+      for (let subtable of chain.subtables)
         if (subtable.subFeatureFlags & flags)
           this.generateInputsForSubtable(subtable);
     }
@@ -260537,6 +261180,7 @@ function buildAgentCoordinator(input) {
   const indicators = mergeIndicators(cfg.linear.indicators, args.indicators);
   const team = args.linearTeam || cfg.linear.team;
   const assignee = args.linearAssignee || cfg.linear.assignee;
+  const ticketNumbers = resolveTicketNumbers(args.ticketTokens, team);
   const excludeFromTodo = unionMarkers(indicators.setDone, indicators.setError);
   const gitRunner = input.runners?.git ?? bunGitRunner;
   const cmdRunner = input.runners?.cmd ?? bunCmdRunner;
@@ -260568,7 +261212,19 @@ function buildAgentCoordinator(input) {
     }
     return code;
   });
-  const resolvers = createLinearResolvers({ apiKey, team, assignee, diag });
+  const resolvers = createLinearResolvers({
+    apiKey,
+    team,
+    assignee,
+    diag,
+    ...ticketNumbers.length > 0 ? { ticketNumbers } : {}
+  });
+  if (ticketNumbers.length > 0) {
+    const hasGetIndicator = [indicators.getTodo, indicators.getInProgress].some((ind) => ind && ind.filter.length > 0);
+    if (!hasGetIndicator) {
+      diag("ticket", `! --ticket set (${ticketNumbers.join(", ")}) but no getTodo/getInProgress indicator is configured \u2014 nothing will be picked up`, "yellow");
+    }
+  }
   const prDiscovery = createPrDiscovery({
     apiKey,
     projectRoot,
@@ -260604,6 +261260,7 @@ function buildAgentCoordinator(input) {
     onLog,
     diag,
     cwdByChange,
+    ...ticketNumbers.length > 0 ? { ticketNumbers } : {},
     stalePingedAt,
     lastHandledReviewActivity,
     resolvePrUrlForIssue: prDiscovery.resolvePrUrlForIssue
@@ -260700,7 +261357,7 @@ function buildAgentCoordinator(input) {
     fetchTodo: () => resolvers.fetchByGet(indicators.getTodo, excludeFromTodo),
     fetchInProgress: () => resolvers.fetchByGet(indicators.getInProgress, unionMarkers(indicators.setError)),
     fetchMentions,
-    fetchDoneCandidates: () => fetchDoneCandidatesWith(apiKey, team, assignee, indicators),
+    fetchDoneCandidates: () => fetchDoneCandidatesWith(apiKey, team, assignee, indicators, ticketNumbers.length > 0 ? ticketNumbers : undefined),
     prepare: prep.prepare,
     prepareTaskForTrigger: prep.prepareTaskForTrigger,
     spawnWorker,
@@ -260786,6 +261443,7 @@ var init_wire = __esm(() => {
   init_indicators();
   init_task_bodies();
   init_linear_resolvers();
+  init_linear_client();
   init_prepare();
   init_pr_discovery();
   init_mention_scan();
@@ -260801,7 +261459,7 @@ import { dirname as dirname15 } from "path";
 function createJsonLogFileSink(path) {
   if (!path)
     return { emit: () => {} };
-  let chain2 = (async () => {
+  let chain = (async () => {
     try {
       await mkdir12(dirname15(path), { recursive: true });
       await Bun.write(path, "");
@@ -260811,7 +261469,7 @@ function createJsonLogFileSink(path) {
     emit(event) {
       const line = JSON.stringify({ ts: Date.now(), v: VERSION, ...event }) + `
 `;
-      chain2 = chain2.then(async () => {
+      chain = chain.then(async () => {
         try {
           await appendFile2(path, line);
         } catch {}
@@ -262919,6 +263577,18 @@ var init_tmux = __esm(() => {
   decoder = new TextDecoder;
 });
 
+// apps/agent/src/sort/compare.ts
+function chain(...comparators) {
+  return (a, b2) => {
+    for (const c of comparators) {
+      const r = c(a, b2);
+      if (r !== 0)
+        return r;
+    }
+    return 0;
+  };
+}
+
 // apps/agent/src/list-sort.ts
 function assignTier(status) {
   if (status === null || status.kind === "error")
@@ -262941,7 +263611,7 @@ function createdAtOf(status) {
   return "";
 }
 function sortRows(rows) {
-  const cmp = chain((a, b2) => assignTier(a.status) - assignTier(b2.status), (a, b2) => {
+  const cmp = chain((a, b2) => assignTier(a.status) - assignTier(b2.status), (a, b2) => a.bucketOrder - b2.bucketOrder, (a, b2) => {
     const ia = a.issueCreatedAt;
     const ib = b2.issueCreatedAt;
     if (ia === ib)
@@ -262957,7 +263627,7 @@ function sortRows(rows) {
     if (ca === cb)
       return 0;
     return ca < cb ? -1 : 1;
-  }, (a, b2) => a.bucketOrder - b2.bucketOrder, (a, b2) => a.identifier.localeCompare(b2.identifier));
+  }, (a, b2) => a.identifier.localeCompare(b2.identifier));
   return [...rows].sort(cmp);
 }
 var init_list_sort = () => {};
@@ -263006,7 +263676,8 @@ __export(exports_list, {
   formatReviewCell: () => formatReviewCell,
   formatPrStatusMarker: () => formatPrStatusMarker,
   formatBlockedCell: () => formatBlockedCell,
-  buildBuckets: () => buildBuckets
+  buildBuckets: () => buildBuckets,
+  backlogRankByIssueId: () => backlogRankByIssueId
 });
 import { join as join36 } from "path";
 function countTaskItems(content) {
@@ -263108,14 +263779,15 @@ function buildBuckets(indicators) {
     { label: "auto-merge", indicator: indicators.getAutoMerge, exclude: [] }
   ];
 }
-async function fetchBucketIssues(apiKey, bucket, team, assignee) {
+async function fetchBucketIssues(apiKey, bucket, team, assignee, ticketNumbers) {
   if (!bucket.indicator || bucket.indicator.filter.length === 0)
     return [];
   const spec = {
     team,
     assignee,
     include: bucket.indicator.filter,
-    exclude: bucket.exclude
+    exclude: bucket.exclude,
+    ...ticketNumbers.length > 0 ? { numbers: ticketNumbers } : {}
   };
   return fetchOpenIssues(apiKey, spec);
 }
@@ -263159,13 +263831,19 @@ function formatPrStatusMarker(status, failedCheckNames) {
     return "ok";
   return parts.join(" ");
 }
-async function fetchAndPrintLinear(apiKey, buckets, team, assignee, cwd2, runner, ignoreCiChecks = [], checks3 = false, review = false) {
+function backlogRankByIssueId(issues) {
+  const ordered = orderIssuesHierarchically(issues.map((issue2) => linearIssueToOrderable(issue2)));
+  const rankById = new Map;
+  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 = []) {
   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);
+      const issues = await fetchBucketIssues(apiKey, bucket, team, assignee, ticketNumbers);
       return { bucket, issues, error: null };
     } catch (err) {
       return {
@@ -263183,16 +263861,17 @@ ${bucket.label}: error fetching from Linear \u2014 ${error48}
     }
   }
   const seen = new Map;
-  let order = 0;
+  const issueById = new Map;
   for (const { bucket, issues } of bucketResults) {
     for (const issue2 of issues) {
       if (seen.has(issue2.id))
         continue;
+      issueById.set(issue2.id, issue2);
       seen.set(issue2.id, {
         issueId: issue2.id,
         identifier: issue2.identifier,
         status: null,
-        bucketOrder: order++,
+        bucketOrder: 0,
         issueCreatedAt: issue2.createdAt,
         bucketLabel: bucket.label,
         stateName: issue2.state.name,
@@ -263203,6 +263882,9 @@ ${bucket.label}: error fetching from Linear \u2014 ${error48}
     }
   }
   const rows = [...seen.values()];
+  const rankById = backlogRankByIssueId([...issueById.values()]);
+  for (const row of rows)
+    row.bucketOrder = rankById.get(row.issueId) ?? 0;
   try {
     const attachmentsByIssue = await fetchAttachmentsForIssues(apiKey, rows.map((r) => r.issueId));
     for (const row of rows) {
@@ -263319,6 +264001,15 @@ Linear: LINEAR_API_KEY not set \u2014 cannot fetch tickets. Configured buckets:
     }
     return;
   }
+  let ticketNumbers = [];
+  try {
+    ticketNumbers = resolveTicketNumbers(input.ticketTokens ?? [], team);
+  } catch (err) {
+    process.stderr.write(`Error: ${formatTicketError(err)}
+`);
+    process.exitCode = 1;
+    return;
+  }
   if (team)
     process.stdout.write(`
 team: ${team}
@@ -263326,13 +264017,21 @@ team: ${team}
   if (assignee)
     process.stdout.write(`assignee: ${assignee}
 `);
-  await fetchAndPrintLinear(apiKey, buckets, team, assignee, projectRoot, localCmdRunner, cfg.ignoreCiChecks, input.checks, input.review);
+  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);
 }
 function normalizeIdentifier(input) {
-  const match = input.match(/^([A-Za-z]+)-(\d+)(?:-.*)?$/);
-  if (!match)
+  let parsed;
+  try {
+    parsed = parseTicketIdentifier(input);
+  } catch {
     return null;
-  return `${match[1].toUpperCase()}-${match[2]}`;
+  }
+  if (parsed.teamKey === null)
+    return null;
+  return `${parsed.teamKey}-${parsed.number}`;
 }
 async function fetchIssueByIdentifier(apiKey, identifier) {
   const match = identifier.match(/^([A-Z]+)-(\d+)$/);
@@ -263482,6 +264181,8 @@ var init_list = __esm(() => {
   init_pr_status();
   init_pr_url();
   init_list_sort();
+  init_ordering();
+  init_queue_order();
   init_ci();
   init_linear_client();
   init_indicators();
@@ -263791,7 +264492,8 @@ async function main3(argv) {
         debug: args.debug,
         name: args.name,
         checks: args.checks,
-        review: args.review
+        review: args.review,
+        ticketTokens: args.ticketTokens
       });
     });
     return typeof process.exitCode === "number" ? process.exitCode : 0;
@@ -263811,6 +264513,19 @@ async function main3(argv) {
 `);
     return 0;
   }
+  if (args.ticketTokens.length > 0) {
+    const { loadRalphyConfig: loadRalphyConfig2 } = await Promise.resolve().then(() => (init_config(), exports_config));
+    const { resolveTicketNumbers: resolveTicketNumbers2, formatTicketError: formatTicketError2 } = await Promise.resolve().then(() => (init_linear_client(), exports_linear_client));
+    const cfg = await loadRalphyConfig2(projectRoot);
+    const team = args.linearTeam || cfg.linear.team;
+    try {
+      resolveTicketNumbers2(args.ticketTokens, team);
+    } catch (err) {
+      process.stderr.write(formatTicketError2(err) + `
+`);
+      return 1;
+    }
+  }
   await mkdir15(statesDir, { recursive: true });
   await mkdir15(tasksDir, { recursive: true });
   await mkdir15(join39(projectRoot, ".ralph"), { recursive: true });