flightdesk 0.6.0 → 0.6.2

package/main.js

@@ -3053,6 +3053,9 @@ function readFolderCredential() {
   return null;
 }
 var folderCredential;
+function credentialSource() {
+  return folder()?.source ?? `home (${CONFIG_FILE})`;
+}
 function folder() {
   if (folderCredential === void 0) folderCredential = readFolderCredential();
   return folderCredential;
@@ -3281,12 +3284,35 @@ var FlightDeskAPI = class _FlightDeskAPI {
           prNumber
           sessionViewUrl
           sessionTeleportId
+          sourceSystem
+          sourceRef
+          sourceUrl
         }
       }
     `;
     const result = await this.graphql(query, { taskId, input });
     return result.userUpdateTask;
   }
+  /** "Continue in FlightDesk": attach a locally-built PR and hand the work to the pipeline. */
+  async handoffPullRequest(input) {
+    const query = `
+      mutation UserHandoffPullRequest($input: UserHandoffPullRequestInput!) {
+        userHandoffPullRequest(input: $input) {
+          taskId
+          created
+          orchestrated
+          phase
+          waitingOn
+          agentUserId
+          prNumber
+          prUrl
+          message
+        }
+      }
+    `;
+    const result = await this.graphql(query, { input });
+    return result.userHandoffPullRequest;
+  }
   async registerSession(taskId, input) {
     const query = `
       mutation RegisterSession($taskId: String!, $input: RegisterSessionInput!) {
@@ -3603,7 +3629,7 @@ async function execute(query, variables) {
 }
 function registerQuestionCommands(program3) {
   const questions = program3.command("questions").description("Ask roles, poll questions, and consume answers");
-  questions.command("ask <taskId>").option("--to-role <role>", "requester, product_owner, tech_owner, client_contact, triager").option("--to-user <id>", "Address a specific human member directly").requiredOption("--key <key>", "Stable retry key").requiredOption("--body <text>", "Question").requiredOption("--context <text>", "Short answer context").option("--default <text>", "Proposed default; required for agents").option("--options <values...>", "Suggested answer choices").option("--due-at <iso>", "Optional due timestamp").option("--nonblocking", "Allow work to continue").action(
+  questions.command("ask <taskId>").option("--to-role <role>", "requester, product_owner, tech_owner, client_contact, triager").option("--to-user <id>", "Address a specific human member directly").requiredOption("--key <key>", "Stable retry key").requiredOption("--body <text>", "Question").requiredOption("--context <text>", "Short answer context").option("--default <text>", "Proposed default; required for ordinary agent questions").option("--requires-explicit-answer", "Permission decision: blocking, with no default").option("--options <values...>", "Suggested answer choices").option("--due-at <iso>", "Optional due timestamp").option("--nonblocking", "Allow work to continue").action(
     (taskId, options) => execute("mutation($input:JSON!){userAskQuestion(input:$input)}", {
       input: {
         taskId,
@@ -3613,6 +3639,7 @@ function registerQuestionCommands(program3) {
         body: options.body,
         context: options.context,
         proposedDefault: options.default,
+        requiresExplicitAnswer: options.requiresExplicitAnswer,
         blocking: !options.nonblocking,
         options: options.options,
         dueAt: options.dueAt
@@ -3645,18 +3672,29 @@ async function execute2(query, variables, attempts = 3) {
 }
 function registerPlanCommands(program3) {
   const plan = program3.command("plan").description("Task plans held in FlightDesk");
-  plan.command("submit <taskId>").description("Submit a plan revision from a markdown file (or --body)").option("-f, --file <path>", "Markdown file holding the plan").option("--body <markdown>", "Plan body inline (prefer --file)").option("--summary <text>", "One-paragraph summary").action(async (taskId, options) => {
-    const body = options.file ? (0, import_node_fs.readFileSync)(options.file, "utf8") : options.body;
-    if (!body?.trim()) {
-      console.error("Provide --file <path> or --body <markdown>");
-      process.exit(1);
+  plan.command("submit <taskId>").description("Submit a plan revision from a markdown file (or --body)").option("-f, --file <path>", "Markdown file holding the plan").option("--body <markdown>", "Plan body inline (prefer --file)").option("--summary <text>", "One-paragraph summary").option("--test-plan <path>", "Markdown file: the steps a human runs on the preview").option("--release-note <text>", "One or two sentences for staff, confirmed at closeout").action(
+    async (taskId, options) => {
+      const body = options.file ? (0, import_node_fs.readFileSync)(options.file, "utf8") : options.body;
+      if (!body?.trim()) {
+        console.error("Provide --file <path> or --body <markdown>");
+        process.exit(1);
+      }
+      const testPlan = options.testPlan ? (0, import_node_fs.readFileSync)(options.testPlan, "utf8") : void 0;
+      await execute2(
+        "mutation($input:JSON!){userSubmitPlan(input:$input)}",
+        {
+          input: {
+            taskId,
+            body,
+            summary: options.summary,
+            testPlan,
+            releaseNote: options.releaseNote
+          }
+        },
+        1
+      );
     }
-    await execute2(
-      "mutation($input:JSON!){userSubmitPlan(input:$input)}",
-      { input: { taskId, body, summary: options.summary } },
-      1
-    );
-  });
+  );
   plan.command("show <taskId>").description("Print the plan revisions and approval state").action(
     (taskId) => execute2("query($taskId:String!){userTaskPlan(taskId:$taskId)}", { taskId })
   );
@@ -3670,6 +3708,39 @@ function registerPlanCommands(program3) {
   );
 }
 
+// apps/cli/src/commands/whoami.ts
+function registerWhoamiCommand(program3) {
+  program3.command("whoami").description("Show who the resolved API key authenticates as, and where the key came from").option("--json", "Machine-readable output").action(async (options) => {
+    const config = loadConfig();
+    if (!config.apiKey) {
+      console.error("No API key configured. Run: flightdesk init");
+      process.exit(1);
+    }
+    const apiUrl = getApiUrl();
+    const source = credentialSource();
+    try {
+      const me = await fetchUserInfo(config.apiKey, apiUrl);
+      const email = me.emails?.find((e) => e.primary)?.email ?? me.emails?.[0]?.email ?? null;
+      const organizations = (me.organizations ?? []).map((o) => o.organization);
+      if (options.json) {
+        console.log(JSON.stringify({ id: me.id, email, organizations, apiUrl, source }, null, 2));
+        return;
+      }
+      console.log(`${email ?? me.id}${email ? ` (${me.id})` : ""}`);
+      console.log(`API:    ${apiUrl}`);
+      console.log(`Key:    ${source}`);
+      console.log(
+        `Orgs:   ${organizations.length ? organizations.map((o) => `${o.name} (${o.id})`).join(", ") : "none"}`
+      );
+    } catch (error) {
+      console.error(
+        `Not authenticated against ${apiUrl} (key from ${source}): ${error.message}`
+      );
+      process.exit(1);
+    }
+  });
+}
+
 // apps/cli/src/commands/dispatch.ts
 var os2 = __toESM(require("node:os"));
 async function execute3(query, variables) {
@@ -3728,6 +3799,11 @@ function registerDispatchCommands(program3) {
     });
   });
   const turn = program3.command("turn").description("Report the outcome of an agent turn");
+  turn.command("progress <line>").description("Say what this turn is doing now \u2014 one line, no outcome, safe to repeat").requiredOption("--dispatch <id>", "Dispatch id ($FLIGHTDESK_DISPATCH_ID)").action(
+    (line, options) => execute3("mutation($input: JSON!) { userReportProgress(input: $input) }", {
+      input: { dispatchId: options.dispatch, message: line }
+    })
+  );
   turn.command("end").requiredOption("--dispatch <id>", "Dispatch id ($FLIGHTDESK_DISPATCH_ID)").requiredOption("--outcome <outcome>", "done | waiting | failed | blocked").option("--waiting-on <what>", "session | ci | review | qa | merge | deploy | dependency").option("--ref <url>", "PR URL or other reference").option("--summary <text>", "One-paragraph summary").action(
     (options) => execute3("mutation($input: JSON!) { userEndTurn(input: $input) }", {
       input: {
@@ -3909,10 +3985,7 @@ async function registerCommand(taskId, options) {
   const { config, org: org2 } = requireActiveOrg();
   const api = FlightDeskAPI.fromConfig(config, org2);
   try {
-    let projectId = options.project;
-    if (!projectId) {
-      projectId = await autoDetectProject(api, org2);
-    }
+    const target = taskId ? { taskId } : { projectId: options.project || await autoDetectProject(api, org2) };
     let viewUrl = options.viewUrl;
     let teleportId = options.teleportId;
     if (options.prompt) {
@@ -3928,15 +4001,17 @@ async function registerCommand(taskId, options) {
       viewUrl = viewUrl || parsed.viewUrl;
       teleportId = teleportId || parsed.teleportId;
     }
-    let actualTaskId = taskId;
-    if (!actualTaskId) {
+    let actualTaskId;
+    if ("taskId" in target) {
+      actualTaskId = target.taskId;
+    } else {
       if (!options.title) {
         console.error('Task title required when creating a new task. Use --title "..."');
         process.exit(1);
       }
       console.log(`Creating task: ${options.title}`);
       const task2 = await api.createTask({
-        projectId,
+        projectId: target.projectId,
         title: options.title,
         // Launch-first orchestrators do not know the FlightDesk UUID when the
         // cloud prompt is sent. Persisting that same prompt on the task lets
@@ -3957,8 +4032,7 @@ async function registerCommand(taskId, options) {
       } else {
         await api.updateTask(actualTaskId, {
           sessionViewUrl: viewUrl,
-          sessionTeleportId: teleportId,
-          status: "DISPATCHED"
+          sessionTeleportId: teleportId
         });
       }
       console.log("\u2705 Session registered");
@@ -4020,30 +4094,25 @@ Output: ${output.slice(0, 500)}`));
 }
 function readStdin() {
   return new Promise((resolve) => {
+    const input = process.stdin;
     let data = "";
-    let resolved = false;
-    process.stdin.setEncoding("utf8");
-    process.stdin.on("data", (chunk) => {
+    const append = (chunk) => {
       data += chunk;
-    });
-    process.stdin.on("end", () => {
-      if (!resolved) {
-        resolved = true;
-        resolve(data);
-      }
-    });
-    process.stdin.on("close", () => {
-      if (!resolved) {
-        resolved = true;
-        resolve(data);
-      }
-    });
-    setTimeout(() => {
-      if (!resolved) {
-        resolved = true;
-        resolve(data);
-      }
-    }, 3e4);
+    };
+    const finish = () => {
+      clearTimeout(timeout);
+      input.off("data", append);
+      input.off("end", finish);
+      input.off("close", finish);
+      input.pause();
+      resolve(data);
+    };
+    const timeout = setTimeout(finish, 3e4);
+    input.setEncoding("utf8");
+    input.on("data", append);
+    input.once("end", finish);
+    input.once("close", finish);
+    if (input.readableEnded || input.destroyed) finish();
   });
 }
 function parseClaudeOutput(output) {
@@ -4112,6 +4181,32 @@ async function autoDetectProject(api, activeOrg) {
   return project2.id;
 }
 
+// apps/cli/src/lib/task-status.ts
+var TASK_STATUSES = [
+  ["PENDING", "\u2B1C"],
+  ["DISPATCHED", "\u{1F680}"],
+  ["IN_PROGRESS", "\u{1F504}"],
+  ["BRANCH_CREATED", "\u{1F33F}"],
+  ["PR_OPEN", "\u{1F4DD}"],
+  ["PREVIEW_STARTING", "\u23F3"],
+  ["PREVIEW_READY", "\u{1F310}"],
+  ["REVIEW_RUNNING", "\u{1F50D}"],
+  ["REVIEW_DONE", "\u2705"],
+  ["QA_READY", "\u{1F9EA}"],
+  ["QA_CHANGES_REQUESTED", "\u{1F527}"],
+  ["QA_APPROVED", "\u{1F44D}"],
+  ["MERGED", "\u{1F389}"],
+  ["ARCHIVED", "\u{1F4E6}"]
+];
+var TASK_STATUS_ORDER = TASK_STATUSES.map(([status]) => status);
+var EMOJI_BY_STATUS = new Map(TASK_STATUSES);
+function taskStatusLabel(status) {
+  return status ?? "No coding run";
+}
+function taskStatusEmoji(status) {
+  return status === null ? "\u2B1C" : EMOJI_BY_STATUS.get(status) ?? "\u2753";
+}
+
 // apps/cli/src/commands/status.ts
 async function statusCommand(options) {
   const { config, org: org2 } = requireActiveOrg();
@@ -4122,33 +4217,18 @@ async function statusCommand(options) {
       console.log("No tasks found.");
       return;
     }
-    const byStatus = {};
+    const byStatus = /* @__PURE__ */ new Map();
     for (const task2 of tasks) {
-      if (!byStatus[task2.status]) {
-        byStatus[task2.status] = [];
-      }
-      byStatus[task2.status].push(task2);
+      const group = byStatus.get(task2.status) ?? [];
+      group.push(task2);
+      byStatus.set(task2.status, group);
     }
-    const statusOrder = [
-      "PENDING",
-      "DISPATCHED",
-      "IN_PROGRESS",
-      "BRANCH_CREATED",
-      "PR_OPEN",
-      "PREVIEW_STARTING",
-      "PREVIEW_READY",
-      "REVIEW_RUNNING",
-      "REVIEW_DONE",
-      "QA_READY",
-      "QA_APPROVED",
-      "MERGED",
-      "ARCHIVED"
-    ];
+    const statusOrder = /* @__PURE__ */ new Set([...TASK_STATUS_ORDER, null, ...byStatus.keys()]);
     console.log("\n\u{1F4CB} FlightDesk Tasks\n");
     for (const status of statusOrder) {
-      const statusTasks = byStatus[status];
+      const statusTasks = byStatus.get(status);
       if (!statusTasks || statusTasks.length === 0) continue;
-      console.log(`${getStatusEmoji(status)} ${status} (${statusTasks.length})`);
+      console.log(`${taskStatusEmoji(status)} ${taskStatusLabel(status)} (${statusTasks.length})`);
       for (const task2 of statusTasks) {
         console.log(`   ${task2.id.slice(0, 8)} - ${task2.title}`);
         if (task2.branchName) {
@@ -4165,40 +4245,21 @@ async function statusCommand(options) {
     process.exit(1);
   }
 }
-function getStatusEmoji(status) {
-  switch (status) {
-    case "PENDING":
-      return "\u2B1C";
-    case "DISPATCHED":
-      return "\u{1F680}";
-    case "IN_PROGRESS":
-      return "\u{1F504}";
-    case "BRANCH_CREATED":
-      return "\u{1F33F}";
-    case "PR_OPEN":
-      return "\u{1F4DD}";
-    case "PREVIEW_STARTING":
-      return "\u23F3";
-    case "PREVIEW_READY":
-      return "\u{1F310}";
-    case "REVIEW_RUNNING":
-      return "\u{1F50D}";
-    case "REVIEW_DONE":
-      return "\u2705";
-    case "QA_READY":
-      return "\u{1F9EA}";
-    case "QA_APPROVED":
-      return "\u{1F44D}";
-    case "MERGED":
-      return "\u{1F389}";
-    case "ARCHIVED":
-      return "\u{1F4E6}";
-    default:
-      return "\u2753";
-  }
-}
 
 // apps/cli/src/commands/task.ts
+function sourceIdentityEdit(options) {
+  const set = {
+    ...options.sourceSystem === void 0 ? {} : { sourceSystem: options.sourceSystem },
+    ...options.sourceRef === void 0 ? {} : { sourceRef: options.sourceRef },
+    ...options.sourceUrl === void 0 ? {} : { sourceUrl: options.sourceUrl }
+  };
+  if (!options.clearSource) return set;
+  if (Object.keys(set).length > 0)
+    throw new Error(
+      "--clear-source cannot be combined with --source-system/--source-ref/--source-url"
+    );
+  return { sourceSystem: null, sourceRef: null, sourceUrl: null };
+}
 async function taskCommand(action, options) {
   const { config, org: org2 } = requireActiveOrg();
   const api = FlightDeskAPI.fromConfig(config, org2);
@@ -4234,13 +4295,15 @@ async function handleCreate(api, options) {
     subprojectId: options.subproject,
     sourceSystem: options.sourceSystem,
     sourceRef: options.sourceRef,
-    sourceUrl: options.sourceUrl
+    sourceUrl: options.sourceUrl,
+    followUpOf: options.followUpOf,
+    followUpDispatchId: options.followUpDispatch
   });
   console.log(`
 \u2705 Task created`);
   console.log(`   ID: ${task2.id}`);
   console.log(`   Title: ${task2.title}`);
-  console.log(`   Status: ${task2.status}`);
+  console.log(`   Status: ${taskStatusLabel(task2.status)}`);
 }
 async function handleList(api, options) {
   const tasks = await api.listTasks({
@@ -4253,10 +4316,10 @@ async function handleList(api, options) {
   }
   console.log("\nTasks:\n");
   for (const task2 of tasks) {
-    const statusEmoji = getStatusEmoji2(task2.status);
+    const statusEmoji = taskStatusEmoji(task2.status);
     console.log(`${statusEmoji} ${task2.id.slice(0, 8)} - ${task2.title}`);
     if (task2.project?.name) console.log(`   Project: ${task2.project.name}`);
-    console.log(`   Status: ${task2.status}`);
+    console.log(`   Status: ${taskStatusLabel(task2.status)}`);
     if (task2.branchName) console.log(`   Branch: ${task2.branchName}`);
     if (task2.prUrl) console.log(`   PR: ${task2.prUrl}`);
     console.log("");
@@ -4272,11 +4335,10 @@ async function handleStatus(api, options) {
 \u{1F4CB} Task: ${task2.title}
 `);
   console.log(`ID:       ${task2.id}`);
-  console.log(`Status:   ${getStatusEmoji2(task2.status)} ${task2.status}`);
+  console.log(`Status:   ${taskStatusEmoji(task2.status)} ${taskStatusLabel(task2.status)}`);
   if (task2.project) {
-    console.log(
-      `Project:  ${task2.project.name}${task2.project.githubRepo ? ` (${task2.project.githubRepo})` : ""}`
-    );
+    const repo = task2.project.githubRepo ? " (" + task2.project.githubRepo + ")" : "";
+    console.log(`Project:  ${task2.project.name}${repo}`);
   }
   if (task2.description) {
     console.log(`
@@ -4302,31 +4364,56 @@ function parseSessionId(value) {
   }
   return value;
 }
-async function handleUpdate(api, options) {
-  const input = {};
+var PR_NUMBER_IN_URL = /\/pull\/(\d+)/;
+var SOURCE_FIELDS = ["sourceSystem", "sourceRef", "sourceUrl"];
+function updateInput(options) {
+  const input = { ...sourceIdentityEdit(options) };
+  if (options.releaseNote !== void 0) input.releaseNote = options.releaseNote;
   if (options.status) input.status = options.status;
   if (options.branch) input.branchName = options.branch;
   if (options.prUrl) {
     input.prUrl = options.prUrl;
-    const prNumberMatch = options.prUrl.match(/\/pull\/(\d+)/);
-    if (prNumberMatch) {
-      input.prNumber = Number.parseInt(prNumberMatch[1], 10);
-    }
+    const prNumberMatch = PR_NUMBER_IN_URL.exec(options.prUrl);
+    if (prNumberMatch) input.prNumber = Number.parseInt(prNumberMatch[1], 10);
   }
-  if (options.prNumber) {
-    input.prNumber = Number.parseInt(options.prNumber, 10);
+  if (options.prNumber) input.prNumber = Number.parseInt(options.prNumber, 10);
+  return input;
+}
+async function autoTransition(api, options, input) {
+  if (!options.branch || options.status) return;
+  const current = await api.getTask(options.taskId);
+  if (current?.status !== "DISPATCHED") return;
+  input.status = "IN_PROGRESS";
+  console.log(`   Auto-transitioning DISPATCHED \u2192 IN_PROGRESS`);
+}
+function printUpdated(task2, input) {
+  console.log(`
+\u2705 Task updated`);
+  console.log(`   Status: ${taskStatusLabel(task2.status)}`);
+  if (task2.branchName) console.log(`   Branch: ${task2.branchName}`);
+  if (task2.prUrl) console.log(`   PR: ${task2.prUrl}`);
+  if (task2.prNumber) console.log(`   PR #: ${task2.prNumber}`);
+  if (task2.sessionViewUrl) console.log(`   Session: ${task2.sessionViewUrl}`);
+  if (SOURCE_FIELDS.some((field) => field in input)) console.log(`   Source: ${describeSource(task2)}`);
+}
+async function syncAfterPrUrl(api, taskId) {
+  console.log(`
+\u{1F504} Syncing PR review state...`);
+  try {
+    printSyncResult(await api.syncTaskChecks(taskId));
+  } catch (err) {
+    console.log(`   \u26A0\uFE0F  Sync failed (checks will update when webhooks arrive): ${err}`);
   }
+}
+async function handleUpdate(api, options) {
+  const input = updateInput(options);
   if (Object.keys(input).length === 0 && !options.session) {
-    console.error("No updates specified. Use --status, --branch, --pr-url, or --session");
+    console.error(
+      "No updates specified. Use --status, --branch, --pr-url, --session, --release-note, --source-system/--source-ref/--source-url or --clear-source"
+    );
     process.exit(1);
   }
-  if (options.branch && !options.status) {
-    const current = await api.getTask(options.taskId);
-    if (current?.status === "DISPATCHED") {
-      input.status = "IN_PROGRESS";
-      console.log(`   Auto-transitioning DISPATCHED \u2192 IN_PROGRESS`);
-    }
-  }
+  await autoTransition(api, options, input);
   console.log(`Updating task ${options.taskId}...`);
   let task2;
   if (options.session) {
@@ -4336,27 +4423,14 @@ async function handleUpdate(api, options) {
       teleportId: sessionId
     });
   }
-  if (Object.keys(input).length > 0) {
-    task2 = await api.updateTask(options.taskId, input);
-  }
+  if (Object.keys(input).length > 0) task2 = await api.updateTask(options.taskId, input);
   if (!task2) return;
-  console.log(`
-\u2705 Task updated`);
-  console.log(`   Status: ${task2.status}`);
-  if (task2.branchName) console.log(`   Branch: ${task2.branchName}`);
-  if (task2.prUrl) console.log(`   PR: ${task2.prUrl}`);
-  if (task2.prNumber) console.log(`   PR #: ${task2.prNumber}`);
-  if (task2.sessionViewUrl) console.log(`   Session: ${task2.sessionViewUrl}`);
-  if (options.prUrl) {
-    console.log(`
-\u{1F504} Syncing PR review state...`);
-    try {
-      const syncResult = await api.syncTaskChecks(options.taskId);
-      printSyncResult(syncResult);
-    } catch (err) {
-      console.log(`   \u26A0\uFE0F  Sync failed (checks will update when webhooks arrive): ${err}`);
-    }
-  }
+  printUpdated(task2, input);
+  if (options.prUrl) await syncAfterPrUrl(api, options.taskId);
+}
+function describeSource(task2) {
+  const parts = [task2.sourceSystem, task2.sourceRef, task2.sourceUrl].filter(Boolean);
+  return parts.length > 0 ? parts.join(" ") : "(cleared)";
 }
 async function handleSync(api, options) {
   console.log(`Syncing PR review state for task ${options.taskId}...`);
@@ -4389,36 +4463,54 @@ function getCheckIcon(status) {
       return "\u2753";
   }
 }
-function getStatusEmoji2(status) {
-  switch (status) {
-    case "PENDING":
-      return "\u2B1C";
-    case "DISPATCHED":
-      return "\u{1F680}";
-    case "IN_PROGRESS":
-      return "\u{1F504}";
-    case "BRANCH_CREATED":
-      return "\u{1F33F}";
-    case "PR_OPEN":
-      return "\u{1F4DD}";
-    case "PREVIEW_STARTING":
-      return "\u23F3";
-    case "PREVIEW_READY":
-      return "\u{1F310}";
-    case "REVIEW_RUNNING":
-      return "\u{1F50D}";
-    case "REVIEW_DONE":
-      return "\u2705";
-    case "QA_READY":
-      return "\u{1F9EA}";
-    case "QA_APPROVED":
-      return "\u{1F44D}";
-    case "MERGED":
-      return "\u{1F389}";
-    case "ARCHIVED":
-      return "\u{1F4E6}";
-    default:
-      return "\u2753";
+
+// apps/cli/src/commands/handoff.ts
+var PR_URL = /^https?:\/\/(?:www\.)?github\.com\/([^/\s]+\/[^/\s]+)\/pull\/([1-9]\d*)(?:[/?#]|$)/i;
+var PR_NUMBER = /^#?([1-9]\d*)$/;
+function parsePrArgument(value) {
+  const trimmed = value.trim();
+  const url = PR_URL.exec(trimmed);
+  if (url) return { prUrl: trimmed, prNumber: Number(url[2]), repo: url[1] };
+  const number = PR_NUMBER.exec(trimmed);
+  if (number) return { prNumber: Number(number[1]) };
+  throw new Error(`"${value}" is not a pull request: give its GitHub URL or its number`);
+}
+async function projectForRepo(api, repo) {
+  const slug = repo ?? detectGitRepo()?.remote;
+  if (!slug)
+    throw new Error(
+      "Name the task (--task) or project (--project), or run this inside the repository"
+    );
+  const matches = (await api.listProjects()).filter(
+    (project2) => project2.githubRepo?.toLowerCase() === slug.toLowerCase()
+  );
+  if (matches.length === 1) return matches[0].id;
+  if (!matches.length) throw new Error(`No FlightDesk project tracks ${slug}; pass --project`);
+  throw new Error(`Several projects track ${slug}; pass --project`);
+}
+async function handoffCommand(options) {
+  const { config, org: org2 } = requireActiveOrg();
+  const api = FlightDeskAPI.fromConfig(config, org2);
+  try {
+    const pr = parsePrArgument(options.pr);
+    const projectId = options.task ? void 0 : options.project ?? await projectForRepo(api, pr.repo);
+    const result = await api.handoffPullRequest({
+      taskId: options.task,
+      projectId,
+      prUrl: pr.prUrl,
+      prNumber: pr.prNumber,
+      title: options.title
+    });
+    const created = result.created ? " (new task)" : "";
+    const waiting = result.waitingOn ? ` (waiting on ${result.waitingOn})` : "";
+    console.log(`
+\u2705 PR #${result.prNumber} handed off${created}`);
+    console.log(`   Task:  ${result.taskId}`);
+    console.log(`   Phase: ${result.phase}${waiting}`);
+    console.log(`   ${result.message}`);
+  } catch (error) {
+    console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+    process.exit(1);
   }
 }
 
@@ -4426,7 +4518,7 @@ function getStatusEmoji2(status) {
 async function promptCommand(taskId, options) {
   const { config, org: org2 } = requireActiveOrg();
   const api = FlightDeskAPI.fromConfig(config, org2);
-  const validTypes = ["review", "test_plan", "summary", "handoff"];
+  const validTypes = ["review", "test_plan"];
   if (!validTypes.includes(options.type)) {
     console.error(`Invalid prompt type: ${options.type}`);
     console.error(`Valid types: ${validTypes.join(", ")}`);
@@ -4782,11 +4874,12 @@ async function previewCommand(action, options) {
     process.exit(1);
   }
 }
-function getStatusEmoji3(status) {
+function getStatusEmoji(status) {
   const statusEmojis = {
     STARTING: "\u{1F504}",
     READY: "\u2705",
     SUSPENDED: "\u{1F4A4}",
+    STOPPED: "\u{1F4A4}",
     RESTARTING: "\u{1F504}",
     TEARDOWN: "\u{1F5D1}\uFE0F",
     ERROR: "\u274C"
@@ -4801,7 +4894,7 @@ async function handleStatus2(api, options) {
     console.log("   or the PR may be closed.");
     return;
   }
-  const emoji = getStatusEmoji3(instance.status);
+  const emoji = getStatusEmoji(instance.status);
   console.log("\n\u{1F4E6} Preview Environment");
   console.log("\u2500".repeat(50));
   console.log(`${emoji} Status: ${instance.status}`);
@@ -4880,8 +4973,8 @@ async function handleMount(api, options) {
     console.error("No preview environment found for this task");
     process.exit(1);
   }
-  if (instance.status === "SUSPENDED") {
-    console.log("\u23F8\uFE0F  Instance is suspended. Resuming...");
+  if (instance.status === "SUSPENDED" || instance.status === "STOPPED") {
+    console.log("\u23F8\uFE0F  Instance is stopped. Starting it...");
     await api.resumeInstance(options.taskId);
     await new Promise((resolve) => setTimeout(resolve, 3e3));
   }
@@ -5012,7 +5105,8 @@ var program2 = new Command();
 registerDispatchCommands(program2);
 registerQuestionCommands(program2);
 registerPlanCommands(program2);
-program2.name("flightdesk").description("FlightDesk CLI - AI task management for Claude Code sessions").version("0.6.0").option("--dev", "Use local development API (localhost:3000)").option("--api <url>", "Use custom API URL");
+registerWhoamiCommand(program2);
+program2.name("flightdesk").description("FlightDesk CLI - AI task management for Claude Code sessions").version("0.6.2").option("--dev", "Use local development API (localhost:3000)").option("--api <url>", "Use custom API URL");
 program2.hook("preAction", () => {
   const opts = program2.opts();
   if (opts.api) {
@@ -5025,19 +5119,29 @@ program2.hook("preAction", () => {
   }
 });
 program2.command("init").description("Configure FlightDesk CLI with your API credentials").action(initCommand);
-program2.command("register [task-id]").description(
-  "Register a Claude Code session with a FlightDesk task (auto-detects project from git repo)"
-).option("-p, --project <id>", "Project ID (auto-detected from git repo if not provided)").option("--subproject <id>", "Subproject ID (required if project has subprojects configured)").option("--view-url <url>", "Claude Code session view URL").option("--teleport-id <id>", "Claude Code teleport ID").option("--title <title>", "Task title (creates new task if task-id not provided)").option("--description <description>", "Task description").option("--prompt <prompt>", "Prompt to pass to claude --remote (avoids pipe detection issues)").option("--source-system <system>", "External source system (for example notion or linear)").option("--source-ref <ref>", "External source reference or page ID").option("--source-url <url>", "External source URL used for deterministic branch binding").action(registerCommand);
+program2.command("register [task-id]").description("Register a Claude Code session with an existing task, or create a new task").option("-p, --project <id>", "Project for a new task (auto-detected from git repo if omitted)").option("--subproject <id>", "Subproject ID (required if project has subprojects configured)").option("--view-url <url>", "Claude Code session view URL").option("--teleport-id <id>", "Claude Code teleport ID").option("--title <title>", "Task title (creates new task if task-id not provided)").option("--description <description>", "Task description").option("--prompt <prompt>", "Prompt to pass to claude --remote (avoids pipe detection issues)").option("--source-system <system>", "External source system (for example notion or linear)").option("--source-ref <ref>", "External source reference or page ID").option("--source-url <url>", "External source URL used for deterministic branch binding").action(registerCommand);
 var project = program2.command("project").description("Project management commands");
 project.command("list").description("List projects in the active organization").action(() => projectCommand("list", {}));
 var task = program2.command("task").description("Task management commands");
-task.command("create").description("Create a new task").requiredOption("-p, --project <id>", "Project ID").requiredOption("-t, --title <title>", "Task title").option("-d, --description <description>", "Task description").option("--subproject <id>", "Subproject ID (required if project has subprojects configured)").option("--source-system <system>", "External source system (for example notion or linear)").option("--source-ref <ref>", "External source reference or page ID").option("--source-url <url>", "External source URL used for deterministic branch binding").action((options) => taskCommand("create", options));
+task.command("create").description("Create a new task").requiredOption("-p, --project <id>", "Project ID").requiredOption("-t, --title <title>", "Task title").option("-d, --description <description>", "Task description").option("--subproject <id>", "Subproject ID (required if project has subprojects configured)").option("--source-system <system>", "External source system (for example notion or linear)").option("--source-ref <ref>", "External source reference or page ID").option("--source-url <url>", "External source URL used for deterministic branch binding").option(
+  "--follow-up-of <taskId>",
+  "File this as a finding from another task: something real and pre-existing that is out of that task's scope. Lands in Backlog, unassigned, and never dispatches itself."
+).option("--follow-up-dispatch <id>", "Your $FLIGHTDESK_DISPATCH_ID, when filing a follow-up").action((options) => taskCommand("create", options));
 task.command("list").description("List tasks").option("-p, --project <id>", "Filter by project ID").option("--status <status>", "Filter by status").action((options) => taskCommand("list", options));
 task.command("status <task-id>").description("Get task status").action((taskId) => taskCommand("status", { taskId }));
-task.command("update <task-id>").description("Update task").option("-s, --status <status>", "New status").option("--branch <branch>", "Branch name").option("--pr-url <url>", "Pull request URL").option("--pr-number <number>", "Pull request number (use if --pr-url is not enough)").option("--session <session>", "Claude Code session (URL or session ID)").action((taskId, options) => taskCommand("update", { taskId, ...options }));
+task.command("update <task-id>").description("Update task").option("-s, --status <status>", "New status").option("--branch <branch>", "Branch name").option("--pr-url <url>", "Pull request URL").option("--release-note <text>", "Confirm or revise the staff-facing release note").option("--pr-number <number>", "Pull request number (use if --pr-url is not enough)").option("--session <session>", "Claude Code session (URL or session ID)").option("--source-system <system>", "Source system: linear, notion or qalatra (humans only)").option(
+  "--source-ref <ref>",
+  "Source issue key, e.g. PIR-256 (must use a team key the project allows)"
+).option("--source-url <url>", "Source issue URL").option("--clear-source", "Clear a wrong source identity so PRs naming it stop binding here").action((taskId, options) => taskCommand("update", { taskId, ...options }));
+task.command("handoff").description(
+  "Continue in FlightDesk: attach a PR you built locally and hand the work to the pipeline (CI, then QA; failures go to the agent as a fix turn)"
+).requiredOption("--pr <url|number>", "The pull request: its GitHub URL or its number").option("--task <id>", "The task to hand off (omit to use or create the task for the PR)").option(
+  "-p, --project <id>",
+  "Project for the task (detected from the PR URL or repo if omitted)"
+).option("--title <title>", "Title for a task the hand-off creates (defaults to the PR title)").action((options) => handoffCommand(options));
 task.command("sync <task-id>").description("Sync PR review state (Copilot feedback, Claude reviews, human reviews) from GitHub").action((taskId) => taskCommand("sync", { taskId }));
 program2.command("status").description("Show status of all active tasks").option("-p, --project <id>", "Filter by project").action(statusCommand);
-program2.command("prompt <task-id>").description("Get a prompt for a task (ready to paste into Claude)").option("--type <type>", "Prompt type: review, test_plan, summary, handoff", "review").action(promptCommand);
+program2.command("prompt <task-id>").description("Get a prompt for a task (ready to paste into Claude)").option("--type <type>", "Prompt type: review, test_plan", "review").action(promptCommand);
 var org = program2.command("org").description("Organization management");
 org.command("list").description("List your organizations").action(orgListCommand);
 org.command("switch <name>").description("Switch active organization").action(orgSwitchCommand);