very-happy-cli 0.2.199 → 0.2.201

package/dist/issue-DpMsnOFm.mjs

@@ -0,0 +1,229 @@
+import { randomUUID } from 'node:crypto';
+import { f as ISSUE_ASSIGNABLE_AGENTS, p as parseIssueRef, g as ISSUE_STATUSES, h as ISSUE_PRIORITIES } from './index-CiRMvS73.mjs';
+import { c as configuration } from './configuration-DhEqAYzz.mjs';
+import { r as readSettings } from './persistence-CF7oV1oH.mjs';
+import { r as readTeamScope, t as teamScopePath } from './context-UzqWaA7f.mjs';
+import { s as sharedIssuesClient, i as importLegacyTodosOnce } from './client-CMUlpYcy.mjs';
+import { d as describeIssueError, f as formatIssueLine, a as formatIssueDetail } from './format-BxGkJUki.mjs';
+import 'zod';
+import '@paralleldrive/cuid2';
+import 'node:fs';
+import 'node:os';
+import 'node:path';
+import './package-DxE8PttX.mjs';
+import 'node:fs/promises';
+import './authRelay-DhQhkBvX.mjs';
+import 'tweetnacl';
+import './logger-CFrzcRHD.mjs';
+import 'chalk';
+import 'node:util';
+
+const ISSUE_HELP = `very-happy issue \u2014 account Issues (spec 2026-11-issues)
+  very-happy issue list [--status todo,in_progress] [--project ID] [--mine] [--unassigned] [--all] [--limit N] [--json]
+  very-happy issue show VH-N [--json]
+  very-happy issue create --title TEXT [--desc TEXT] [--assign AGENT[@MACHINE_ID]|self|none] [--dir PATH] [--mode M] [--model ID]
+                          [--project ID] [--priority P] [--label L]... [--status S] [--json]
+  very-happy issue update VH-N [--status S] [--assign \u2026] [--dir PATH] [--mode M] [--model ID] [--title TEXT] [--desc TEXT]
+                          [--priority P] [--label L]... [--project ID|none] [--comment TEXT] [--json]
+  very-happy issue comment VH-N TEXT [--mention AGENT[@MACHINE_ID]]... [--json]
+
+AGENT is ${ISSUE_ASSIGNABLE_AGENTS.join(" | ")}; without @MACHINE_ID it runs on this machine.
+Assigning an agent on a runnable status (todo / in_progress / in_review / blocked)
+starts a run; backlog only records the assignee. A comment starting with /note
+never wakes an agent.
+
+Inside a Very Happy session (HAPPY_SESSION_ID set) update and comment act as the
+agent on the issue this session works on: status only in_progress / in_review /
+blocked (in_review and blocked need --comment), never done or cancelled; create
+is not available. Use --title=TEXT for values starting with --.`;
+const MULTI = /* @__PURE__ */ new Set(["--label", "--mention"]);
+const BOOL = /* @__PURE__ */ new Set(["--json", "--mine", "--unassigned", "--all"]);
+const ALLOWED = {
+  list: ["--status", "--project", "--mine", "--unassigned", "--all", "--limit", "--json"],
+  show: ["--json"],
+  create: ["--title", "--desc", "--assign", "--dir", "--mode", "--model", "--project", "--priority", "--label", "--status", "--json"],
+  update: ["--status", "--assign", "--dir", "--mode", "--model", "--title", "--desc", "--priority", "--label", "--project", "--comment", "--json"],
+  comment: ["--mention", "--json"]
+};
+function parseIssueArgs(args) {
+  if (args.length === 0 || args[0] === "--help" || args[0] === "help") return { action: "help", positional: [], flags: {}, multi: {}, bools: /* @__PURE__ */ new Set() };
+  const action = args[0];
+  if (!(action in ALLOWED)) throw new Error("Unknown issue command; use issue --help");
+  const cmd = { action, positional: [], flags: {}, multi: {}, bools: /* @__PURE__ */ new Set() };
+  if (args.includes("--help")) return { ...cmd, action: "help" };
+  for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+    if (!arg.startsWith("--")) {
+      cmd.positional.push(arg);
+      continue;
+    }
+    const eq = arg.indexOf("=");
+    const flag = eq === -1 ? arg : arg.slice(0, eq);
+    if (!ALLOWED[action].includes(flag)) throw new Error(`${flag} is not supported for issue ${action}`);
+    if (BOOL.has(flag)) {
+      if (eq !== -1) throw new Error(`${flag} takes no value`);
+      cmd.bools.add(flag);
+      continue;
+    }
+    const value = eq === -1 ? args[++i] : arg.slice(eq + 1);
+    if (value === void 0 || eq === -1 && value.startsWith("--")) throw new Error(`Missing value for ${flag}`);
+    if (MULTI.has(flag)) (cmd.multi[flag] ??= []).push(value);
+    else {
+      if (Object.hasOwn(cmd.flags, flag)) throw new Error(`Duplicate option: ${flag}`);
+      cmd.flags[flag] = value;
+    }
+  }
+  const wantRef = action === "show" || action === "update" || action === "comment";
+  if (wantRef && !cmd.positional[0]) throw new Error(`issue ${action} needs an issue (VH-N)`);
+  if (wantRef && !parseIssueRef(cmd.positional[0])) throw new Error(`Not an issue reference: ${cmd.positional[0]}`);
+  if (action === "comment" && cmd.positional.length !== 2) throw new Error("issue comment needs VH-N and one TEXT argument (quote it)");
+  if ((action === "show" || action === "update") && cmd.positional.length !== 1) throw new Error("Unexpected argument");
+  if ((action === "list" || action === "create") && cmd.positional.length) throw new Error("Unexpected argument");
+  if (action === "create" && !cmd.flags["--title"]?.trim()) throw new Error("create needs --title");
+  for (const f of ["--dir", "--mode", "--model"]) if (cmd.flags[f] !== void 0 && !cmd.flags["--assign"]) throw new Error(`${f} goes with --assign AGENT`);
+  for (const key of ["--status"]) if (cmd.flags[key] !== void 0 && action !== "list" && !ISSUE_STATUSES.includes(cmd.flags[key])) throw new Error(`Unknown status "${cmd.flags[key]}" (${ISSUE_STATUSES.join(", ")})`);
+  if (cmd.flags["--priority"] !== void 0 && !ISSUE_PRIORITIES.includes(cmd.flags["--priority"])) throw new Error(`Unknown priority (${ISSUE_PRIORITIES.join(", ")})`);
+  if (cmd.flags["--limit"] !== void 0 && !/^[1-9][0-9]{0,2}$/.test(cmd.flags["--limit"])) throw new Error("--limit must be 1\u2013500");
+  return cmd;
+}
+function parseAssign(value, localMachineId2, directory, run = {}) {
+  if (value === "self" || value === "none") return { kind: value };
+  const [agent, machine] = value.split("@", 2);
+  if (!ISSUE_ASSIGNABLE_AGENTS.includes(agent)) throw new Error(`Unknown agent "${agent}" (${ISSUE_ASSIGNABLE_AGENTS.join(", ")}, self, none)`);
+  const machineId = machine || localMachineId2;
+  if (!machineId) throw new Error("This machine has no id yet (start the daemon once), or pass AGENT@MACHINE_ID");
+  return {
+    kind: "agent",
+    agent,
+    machineId,
+    ...directory ? { directory } : {},
+    ...run.permissionMode ? { permissionMode: run.permissionMode } : {},
+    ...run.model ? { model: run.model } : {}
+  };
+}
+function parseMention(value, localMachineId2) {
+  const [agent, machine] = value.split("@", 2);
+  if (!ISSUE_ASSIGNABLE_AGENTS.includes(agent)) throw new Error(`Unknown agent "${agent}" for --mention`);
+  return { kind: "agent", agent, ...machine ? { machineId: machine } : {} };
+}
+async function localMachineId() {
+  try {
+    return (await readSettings())?.machineId ?? null;
+  } catch {
+    return null;
+  }
+}
+function agentSessionId(env = process.env) {
+  const sid = env.HAPPY_SESSION_ID;
+  return sid && /^[A-Za-z0-9_-]{1,128}$/.test(sid) ? sid : null;
+}
+async function scoped(sessionId) {
+  if (process.env.VH_TEAM_SCOPE_FILE !== void 0) return true;
+  return !!sessionId && !!await readTeamScope(teamScopePath(sessionId));
+}
+function print(json, value, text) {
+  console.log(json ? JSON.stringify({ serverUrl: configuration.serverUrl, result: value }) : text);
+}
+async function runIssueCommand(cmd, deps = {}) {
+  if (cmd.action === "help") {
+    console.log(ISSUE_HELP);
+    return;
+  }
+  const client = deps.client ?? sharedIssuesClient();
+  const json = cmd.bools.has("--json");
+  const sessionId = agentSessionId(deps.env ?? process.env);
+  const isScoped = await scoped(sessionId);
+  if (cmd.action === "update" || cmd.action === "comment") {
+    if (sessionId) {
+      const ctx = await client.session(sessionId);
+      const ref = parseIssueRef(cmd.positional[0]);
+      if (!ctx.issue || ("number" in ref ? ref.number !== ctx.issue.number : ref.id !== ctx.issue.id)) {
+        throw new Error("issue_not_bound: Inside a session you can only update or comment on the issue this session works on.");
+      }
+      if (cmd.action === "comment") {
+        if (cmd.multi["--mention"]?.length) throw new Error("--mention is for the owner; an agent comment never wakes another agent");
+        const result2 = await client.agentComment({ sessionId, body: cmd.positional[1], requestId: randomUUID() });
+        print(json, result2, `commented on ${result2.issue.key}`);
+        return;
+      }
+      const extra = Object.keys(cmd.flags).filter((f) => f !== "--status" && f !== "--comment");
+      if (extra.length || cmd.multi["--label"]?.length) throw new Error(`Inside a session only --status and --comment can be changed (not ${[...extra, ...cmd.multi["--label"]?.length ? ["--label"] : []].join(", ")})`);
+      const result = await client.agentUpdate({ sessionId, requestId: randomUUID(), ...cmd.flags["--status"] ? { status: cmd.flags["--status"] } : {}, ...cmd.flags["--comment"] ? { comment: cmd.flags["--comment"] } : {} });
+      print(json, result, `${result.issue.key} is ${result.issue.status}`);
+      return;
+    }
+  }
+  if (isScoped && cmd.action !== "show") throw new Error("Scoped Teams sessions cannot access account Issues; ask the owner session.");
+  if (sessionId && cmd.action === "create") throw new Error("Agents cannot create issues; ask the owner.");
+  if (cmd.action === "list") {
+    if (!sessionId) await importLegacyTodosOnce(client);
+    const status = cmd.flags["--status"] ?? (cmd.bools.has("--all") ? void 0 : ISSUE_STATUSES.filter((s) => s !== "done" && s !== "cancelled").join(","));
+    const list = await client.list({
+      ...status ? { status } : {},
+      ...cmd.flags["--project"] ? { projectId: cmd.flags["--project"] } : {},
+      ...cmd.bools.has("--mine") ? { assigneeKind: "self" } : cmd.bools.has("--unassigned") ? { assigneeKind: "none" } : {},
+      limit: cmd.flags["--limit"] ? Number(cmd.flags["--limit"]) : 100
+    });
+    print(json, list, list.issues.length ? list.issues.map(formatIssueLine).join("\n") : "no issues");
+    return;
+  }
+  if (cmd.action === "show") {
+    if (isScoped) {
+      const ctx = sessionId ? await client.session(sessionId) : null;
+      const ref = parseIssueRef(cmd.positional[0]);
+      if (!ctx?.issue || ("number" in ref ? ref.number !== ctx.issue.number : ref.id !== ctx.issue.id)) throw new Error("Scoped Teams sessions can read only the issue they are working on.");
+    }
+    if (!sessionId) await importLegacyTodosOnce(client);
+    const detail = await client.get(cmd.positional[0]);
+    print(json, detail, formatIssueDetail({ issue: detail.issue, comments: detail.comments, runs: detail.runs }));
+    return;
+  }
+  const machine = await localMachineId();
+  if (cmd.action === "create") {
+    const input = {
+      title: cmd.flags["--title"].trim(),
+      requestId: randomUUID(),
+      ...cmd.flags["--desc"] !== void 0 ? { description: cmd.flags["--desc"] } : {},
+      ...cmd.flags["--assign"] ? { assignee: parseAssign(cmd.flags["--assign"], machine, cmd.flags["--dir"], { permissionMode: cmd.flags["--mode"], model: cmd.flags["--model"] }) } : {},
+      ...cmd.flags["--project"] ? { projectId: cmd.flags["--project"] } : {},
+      ...cmd.flags["--priority"] ? { priority: cmd.flags["--priority"] } : {},
+      ...cmd.multi["--label"]?.length ? { labels: cmd.multi["--label"] } : {},
+      ...cmd.flags["--status"] ? { status: cmd.flags["--status"] } : {}
+    };
+    const result = await client.create(input);
+    print(json, result, `created ${formatIssueLine(result.issue)}${result.runs?.length ? `
+run #${result.runs[0].seq} queued on ${result.runs[0].agent}` : ""}`);
+    return;
+  }
+  const target = (await client.get(cmd.positional[0])).issue;
+  if (cmd.action === "comment") {
+    const mentions = (cmd.multi["--mention"] ?? []).map((m) => parseMention(m));
+    const result = await client.comment(target.id, { body: cmd.positional[1], requestId: randomUUID(), ...mentions.length ? { mentions } : {} });
+    print(json, result, `commented on ${result.issue.key}${result.comment?.routedRunIds.length ? " (delivered to the agent)" : ""}`);
+    return;
+  }
+  const patch = {
+    ...cmd.flags["--status"] ? { status: cmd.flags["--status"] } : {},
+    ...cmd.flags["--assign"] ? { assignee: parseAssign(cmd.flags["--assign"], machine, cmd.flags["--dir"], { permissionMode: cmd.flags["--mode"], model: cmd.flags["--model"] }) } : {},
+    ...cmd.flags["--title"] !== void 0 ? { title: cmd.flags["--title"].trim() } : {},
+    ...cmd.flags["--desc"] !== void 0 ? { description: cmd.flags["--desc"] } : {},
+    ...cmd.flags["--priority"] ? { priority: cmd.flags["--priority"] } : {},
+    ...cmd.multi["--label"] ? { labels: cmd.multi["--label"] } : {},
+    ...cmd.flags["--project"] ? { projectId: cmd.flags["--project"] === "none" ? null : cmd.flags["--project"] } : {}
+  };
+  let issue = target;
+  if (Object.keys(patch).length) issue = (await client.update(target.id, patch)).issue;
+  if (cmd.flags["--comment"]) await client.comment(target.id, { body: cmd.flags["--comment"], requestId: randomUUID() });
+  if (!Object.keys(patch).length && !cmd.flags["--comment"]) throw new Error("Nothing to update");
+  print(json, issue, `updated ${formatIssueLine(issue)}`);
+}
+async function handleIssueCommand(args) {
+  const cmd = parseIssueArgs(args);
+  try {
+    await runIssueCommand(cmd);
+  } catch (error) {
+    throw new Error(describeIssueError(error));
+  }
+}
+
+export { ISSUE_HELP, agentSessionId, handleIssueCommand, parseAssign, parseIssueArgs, parseMention, runIssueCommand };

package/dist/issue-feEUrjV0.cjs

@@ -0,0 +1,237 @@
+'use strict';
+
+var node_crypto = require('node:crypto');
+var index = require('./index-44o_qMvE.cjs');
+var configuration = require('./configuration-LWFmTxty.cjs');
+var persistence = require('./persistence-_W9tE-bW.cjs');
+var context = require('./context-BbZ18lX0.cjs');
+var client = require('./client-DI8Rxsbw.cjs');
+var format = require('./format-CgiY6uup.cjs');
+require('zod');
+require('@paralleldrive/cuid2');
+require('node:fs');
+require('node:os');
+require('node:path');
+require('./package-06cGlmeD.cjs');
+require('node:fs/promises');
+require('./authRelay-Dy1qU9td.cjs');
+require('tweetnacl');
+require('./logger-Hyhy2boA.cjs');
+require('chalk');
+require('node:util');
+
+const ISSUE_HELP = `very-happy issue \u2014 account Issues (spec 2026-11-issues)
+  very-happy issue list [--status todo,in_progress] [--project ID] [--mine] [--unassigned] [--all] [--limit N] [--json]
+  very-happy issue show VH-N [--json]
+  very-happy issue create --title TEXT [--desc TEXT] [--assign AGENT[@MACHINE_ID]|self|none] [--dir PATH] [--mode M] [--model ID]
+                          [--project ID] [--priority P] [--label L]... [--status S] [--json]
+  very-happy issue update VH-N [--status S] [--assign \u2026] [--dir PATH] [--mode M] [--model ID] [--title TEXT] [--desc TEXT]
+                          [--priority P] [--label L]... [--project ID|none] [--comment TEXT] [--json]
+  very-happy issue comment VH-N TEXT [--mention AGENT[@MACHINE_ID]]... [--json]
+
+AGENT is ${index.ISSUE_ASSIGNABLE_AGENTS.join(" | ")}; without @MACHINE_ID it runs on this machine.
+Assigning an agent on a runnable status (todo / in_progress / in_review / blocked)
+starts a run; backlog only records the assignee. A comment starting with /note
+never wakes an agent.
+
+Inside a Very Happy session (HAPPY_SESSION_ID set) update and comment act as the
+agent on the issue this session works on: status only in_progress / in_review /
+blocked (in_review and blocked need --comment), never done or cancelled; create
+is not available. Use --title=TEXT for values starting with --.`;
+const MULTI = /* @__PURE__ */ new Set(["--label", "--mention"]);
+const BOOL = /* @__PURE__ */ new Set(["--json", "--mine", "--unassigned", "--all"]);
+const ALLOWED = {
+  list: ["--status", "--project", "--mine", "--unassigned", "--all", "--limit", "--json"],
+  show: ["--json"],
+  create: ["--title", "--desc", "--assign", "--dir", "--mode", "--model", "--project", "--priority", "--label", "--status", "--json"],
+  update: ["--status", "--assign", "--dir", "--mode", "--model", "--title", "--desc", "--priority", "--label", "--project", "--comment", "--json"],
+  comment: ["--mention", "--json"]
+};
+function parseIssueArgs(args) {
+  if (args.length === 0 || args[0] === "--help" || args[0] === "help") return { action: "help", positional: [], flags: {}, multi: {}, bools: /* @__PURE__ */ new Set() };
+  const action = args[0];
+  if (!(action in ALLOWED)) throw new Error("Unknown issue command; use issue --help");
+  const cmd = { action, positional: [], flags: {}, multi: {}, bools: /* @__PURE__ */ new Set() };
+  if (args.includes("--help")) return { ...cmd, action: "help" };
+  for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+    if (!arg.startsWith("--")) {
+      cmd.positional.push(arg);
+      continue;
+    }
+    const eq = arg.indexOf("=");
+    const flag = eq === -1 ? arg : arg.slice(0, eq);
+    if (!ALLOWED[action].includes(flag)) throw new Error(`${flag} is not supported for issue ${action}`);
+    if (BOOL.has(flag)) {
+      if (eq !== -1) throw new Error(`${flag} takes no value`);
+      cmd.bools.add(flag);
+      continue;
+    }
+    const value = eq === -1 ? args[++i] : arg.slice(eq + 1);
+    if (value === void 0 || eq === -1 && value.startsWith("--")) throw new Error(`Missing value for ${flag}`);
+    if (MULTI.has(flag)) (cmd.multi[flag] ??= []).push(value);
+    else {
+      if (Object.hasOwn(cmd.flags, flag)) throw new Error(`Duplicate option: ${flag}`);
+      cmd.flags[flag] = value;
+    }
+  }
+  const wantRef = action === "show" || action === "update" || action === "comment";
+  if (wantRef && !cmd.positional[0]) throw new Error(`issue ${action} needs an issue (VH-N)`);
+  if (wantRef && !index.parseIssueRef(cmd.positional[0])) throw new Error(`Not an issue reference: ${cmd.positional[0]}`);
+  if (action === "comment" && cmd.positional.length !== 2) throw new Error("issue comment needs VH-N and one TEXT argument (quote it)");
+  if ((action === "show" || action === "update") && cmd.positional.length !== 1) throw new Error("Unexpected argument");
+  if ((action === "list" || action === "create") && cmd.positional.length) throw new Error("Unexpected argument");
+  if (action === "create" && !cmd.flags["--title"]?.trim()) throw new Error("create needs --title");
+  for (const f of ["--dir", "--mode", "--model"]) if (cmd.flags[f] !== void 0 && !cmd.flags["--assign"]) throw new Error(`${f} goes with --assign AGENT`);
+  for (const key of ["--status"]) if (cmd.flags[key] !== void 0 && action !== "list" && !index.ISSUE_STATUSES.includes(cmd.flags[key])) throw new Error(`Unknown status "${cmd.flags[key]}" (${index.ISSUE_STATUSES.join(", ")})`);
+  if (cmd.flags["--priority"] !== void 0 && !index.ISSUE_PRIORITIES.includes(cmd.flags["--priority"])) throw new Error(`Unknown priority (${index.ISSUE_PRIORITIES.join(", ")})`);
+  if (cmd.flags["--limit"] !== void 0 && !/^[1-9][0-9]{0,2}$/.test(cmd.flags["--limit"])) throw new Error("--limit must be 1\u2013500");
+  return cmd;
+}
+function parseAssign(value, localMachineId2, directory, run = {}) {
+  if (value === "self" || value === "none") return { kind: value };
+  const [agent, machine] = value.split("@", 2);
+  if (!index.ISSUE_ASSIGNABLE_AGENTS.includes(agent)) throw new Error(`Unknown agent "${agent}" (${index.ISSUE_ASSIGNABLE_AGENTS.join(", ")}, self, none)`);
+  const machineId = machine || localMachineId2;
+  if (!machineId) throw new Error("This machine has no id yet (start the daemon once), or pass AGENT@MACHINE_ID");
+  return {
+    kind: "agent",
+    agent,
+    machineId,
+    ...directory ? { directory } : {},
+    ...run.permissionMode ? { permissionMode: run.permissionMode } : {},
+    ...run.model ? { model: run.model } : {}
+  };
+}
+function parseMention(value, localMachineId2) {
+  const [agent, machine] = value.split("@", 2);
+  if (!index.ISSUE_ASSIGNABLE_AGENTS.includes(agent)) throw new Error(`Unknown agent "${agent}" for --mention`);
+  return { kind: "agent", agent, ...machine ? { machineId: machine } : {} };
+}
+async function localMachineId() {
+  try {
+    return (await persistence.readSettings())?.machineId ?? null;
+  } catch {
+    return null;
+  }
+}
+function agentSessionId(env = process.env) {
+  const sid = env.HAPPY_SESSION_ID;
+  return sid && /^[A-Za-z0-9_-]{1,128}$/.test(sid) ? sid : null;
+}
+async function scoped(sessionId) {
+  if (process.env.VH_TEAM_SCOPE_FILE !== void 0) return true;
+  return !!sessionId && !!await context.readTeamScope(context.teamScopePath(sessionId));
+}
+function print(json, value, text) {
+  console.log(json ? JSON.stringify({ serverUrl: configuration.configuration.serverUrl, result: value }) : text);
+}
+async function runIssueCommand(cmd, deps = {}) {
+  if (cmd.action === "help") {
+    console.log(ISSUE_HELP);
+    return;
+  }
+  const client$1 = deps.client ?? client.sharedIssuesClient();
+  const json = cmd.bools.has("--json");
+  const sessionId = agentSessionId(deps.env ?? process.env);
+  const isScoped = await scoped(sessionId);
+  if (cmd.action === "update" || cmd.action === "comment") {
+    if (sessionId) {
+      const ctx = await client$1.session(sessionId);
+      const ref = index.parseIssueRef(cmd.positional[0]);
+      if (!ctx.issue || ("number" in ref ? ref.number !== ctx.issue.number : ref.id !== ctx.issue.id)) {
+        throw new Error("issue_not_bound: Inside a session you can only update or comment on the issue this session works on.");
+      }
+      if (cmd.action === "comment") {
+        if (cmd.multi["--mention"]?.length) throw new Error("--mention is for the owner; an agent comment never wakes another agent");
+        const result2 = await client$1.agentComment({ sessionId, body: cmd.positional[1], requestId: node_crypto.randomUUID() });
+        print(json, result2, `commented on ${result2.issue.key}`);
+        return;
+      }
+      const extra = Object.keys(cmd.flags).filter((f) => f !== "--status" && f !== "--comment");
+      if (extra.length || cmd.multi["--label"]?.length) throw new Error(`Inside a session only --status and --comment can be changed (not ${[...extra, ...cmd.multi["--label"]?.length ? ["--label"] : []].join(", ")})`);
+      const result = await client$1.agentUpdate({ sessionId, requestId: node_crypto.randomUUID(), ...cmd.flags["--status"] ? { status: cmd.flags["--status"] } : {}, ...cmd.flags["--comment"] ? { comment: cmd.flags["--comment"] } : {} });
+      print(json, result, `${result.issue.key} is ${result.issue.status}`);
+      return;
+    }
+  }
+  if (isScoped && cmd.action !== "show") throw new Error("Scoped Teams sessions cannot access account Issues; ask the owner session.");
+  if (sessionId && cmd.action === "create") throw new Error("Agents cannot create issues; ask the owner.");
+  if (cmd.action === "list") {
+    if (!sessionId) await client.importLegacyTodosOnce(client$1);
+    const status = cmd.flags["--status"] ?? (cmd.bools.has("--all") ? void 0 : index.ISSUE_STATUSES.filter((s) => s !== "done" && s !== "cancelled").join(","));
+    const list = await client$1.list({
+      ...status ? { status } : {},
+      ...cmd.flags["--project"] ? { projectId: cmd.flags["--project"] } : {},
+      ...cmd.bools.has("--mine") ? { assigneeKind: "self" } : cmd.bools.has("--unassigned") ? { assigneeKind: "none" } : {},
+      limit: cmd.flags["--limit"] ? Number(cmd.flags["--limit"]) : 100
+    });
+    print(json, list, list.issues.length ? list.issues.map(format.formatIssueLine).join("\n") : "no issues");
+    return;
+  }
+  if (cmd.action === "show") {
+    if (isScoped) {
+      const ctx = sessionId ? await client$1.session(sessionId) : null;
+      const ref = index.parseIssueRef(cmd.positional[0]);
+      if (!ctx?.issue || ("number" in ref ? ref.number !== ctx.issue.number : ref.id !== ctx.issue.id)) throw new Error("Scoped Teams sessions can read only the issue they are working on.");
+    }
+    if (!sessionId) await client.importLegacyTodosOnce(client$1);
+    const detail = await client$1.get(cmd.positional[0]);
+    print(json, detail, format.formatIssueDetail({ issue: detail.issue, comments: detail.comments, runs: detail.runs }));
+    return;
+  }
+  const machine = await localMachineId();
+  if (cmd.action === "create") {
+    const input = {
+      title: cmd.flags["--title"].trim(),
+      requestId: node_crypto.randomUUID(),
+      ...cmd.flags["--desc"] !== void 0 ? { description: cmd.flags["--desc"] } : {},
+      ...cmd.flags["--assign"] ? { assignee: parseAssign(cmd.flags["--assign"], machine, cmd.flags["--dir"], { permissionMode: cmd.flags["--mode"], model: cmd.flags["--model"] }) } : {},
+      ...cmd.flags["--project"] ? { projectId: cmd.flags["--project"] } : {},
+      ...cmd.flags["--priority"] ? { priority: cmd.flags["--priority"] } : {},
+      ...cmd.multi["--label"]?.length ? { labels: cmd.multi["--label"] } : {},
+      ...cmd.flags["--status"] ? { status: cmd.flags["--status"] } : {}
+    };
+    const result = await client$1.create(input);
+    print(json, result, `created ${format.formatIssueLine(result.issue)}${result.runs?.length ? `
+run #${result.runs[0].seq} queued on ${result.runs[0].agent}` : ""}`);
+    return;
+  }
+  const target = (await client$1.get(cmd.positional[0])).issue;
+  if (cmd.action === "comment") {
+    const mentions = (cmd.multi["--mention"] ?? []).map((m) => parseMention(m));
+    const result = await client$1.comment(target.id, { body: cmd.positional[1], requestId: node_crypto.randomUUID(), ...mentions.length ? { mentions } : {} });
+    print(json, result, `commented on ${result.issue.key}${result.comment?.routedRunIds.length ? " (delivered to the agent)" : ""}`);
+    return;
+  }
+  const patch = {
+    ...cmd.flags["--status"] ? { status: cmd.flags["--status"] } : {},
+    ...cmd.flags["--assign"] ? { assignee: parseAssign(cmd.flags["--assign"], machine, cmd.flags["--dir"], { permissionMode: cmd.flags["--mode"], model: cmd.flags["--model"] }) } : {},
+    ...cmd.flags["--title"] !== void 0 ? { title: cmd.flags["--title"].trim() } : {},
+    ...cmd.flags["--desc"] !== void 0 ? { description: cmd.flags["--desc"] } : {},
+    ...cmd.flags["--priority"] ? { priority: cmd.flags["--priority"] } : {},
+    ...cmd.multi["--label"] ? { labels: cmd.multi["--label"] } : {},
+    ...cmd.flags["--project"] ? { projectId: cmd.flags["--project"] === "none" ? null : cmd.flags["--project"] } : {}
+  };
+  let issue = target;
+  if (Object.keys(patch).length) issue = (await client$1.update(target.id, patch)).issue;
+  if (cmd.flags["--comment"]) await client$1.comment(target.id, { body: cmd.flags["--comment"], requestId: node_crypto.randomUUID() });
+  if (!Object.keys(patch).length && !cmd.flags["--comment"]) throw new Error("Nothing to update");
+  print(json, issue, `updated ${format.formatIssueLine(issue)}`);
+}
+async function handleIssueCommand(args) {
+  const cmd = parseIssueArgs(args);
+  try {
+    await runIssueCommand(cmd);
+  } catch (error) {
+    throw new Error(format.describeIssueError(error));
+  }
+}
+
+exports.ISSUE_HELP = ISSUE_HELP;
+exports.agentSessionId = agentSessionId;
+exports.handleIssueCommand = handleIssueCommand;
+exports.parseAssign = parseAssign;
+exports.parseIssueArgs = parseIssueArgs;
+exports.parseMention = parseMention;
+exports.runIssueCommand = runIssueCommand;

package/dist/lib.cjs

@@ -1,17 +1,17 @@
 'use strict';
 
-var api = require('./api-CgzfmyYS.cjs');
-var logger = require('./logger-LsJ3Cl5o.cjs');
-var configuration = require('./configuration-CAzuk0Xs.cjs');
+var api = require('./api-KVVs-GkM.cjs');
+var logger = require('./logger-Hyhy2boA.cjs');
+var configuration = require('./configuration-LWFmTxty.cjs');
 var types = require('./types-CRS-srZK.cjs');
 require('axios');
-require('./pushNotifications-IZaTtVDG.cjs');
+require('./pushNotifications-DdzTbrA3.cjs');
 require('node:crypto');
 require('zod');
-require('./index-BnT8yvlF.cjs');
+require('./index-44o_qMvE.cjs');
 require('@paralleldrive/cuid2');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
-require('./reconnectGate-CHI12y0Y.cjs');
+require('./reconnectGate-DeDhtQJW.cjs');
 require('./authRelay-Dy1qU9td.cjs');
 require('tweetnacl');
 require('os');
@@ -19,8 +19,8 @@ require('child_process');
 require('node:events');
 require('socket.io-client');
 require('./limits-C-a7gr04.cjs');
-require('./time-DTaj0RVK.cjs');
-require('./registerCommonHandlers-CUCw-rad.cjs');
+require('./time-CDBZWYDb.cjs');
+require('./registerCommonHandlers-BrEtSwNk.cjs');
 require('util');
 require('fs/promises');
 require('crypto');
@@ -28,17 +28,17 @@ require('path');
 require('cross-spawn');
 require('./projectPath-C3ioB4Bu.cjs');
 require('url');
-require('./sync-B-B5mc8Z.cjs');
+require('./sync-C764ZzE6.cjs');
 require('./backgroundTaskActivity-CBvUdj39.cjs');
-require('./controlClient-Bb188cU0.cjs');
-require('./persistence-Dl3sBrCF.cjs');
+require('./controlClient-TVMpETsR.cjs');
+require('./persistence-_W9tE-bW.cjs');
 require('node:fs/promises');
 require('node:fs');
 require('chalk');
 require('node:util');
 require('node:path');
 require('node:os');
-require('./package-D7V1BX2I.cjs');
+require('./package-06cGlmeD.cjs');
 
 
 

package/dist/lib.d.cts

@@ -881,6 +881,12 @@ type FileEventMessage = z$1.infer<typeof FileEventMessageSchema>;
 type Metadata = {
     /** Durable Teams spawn correlation; never contains credentials. */
     teamOperationId?: string;
+    /** B-874: the issue run this session executes (display only; the server's run table is authoritative). */
+    issue?: {
+        id: string;
+        runId?: string;
+        key?: string;
+    };
     /**
      * ACP session config option value (normalized for UI metadata consumers).
      */
@@ -1900,6 +1906,7 @@ type SpawnSessionResult = {
     type: 'error';
     errorMessage: string;
     startupExit?: StartupExit;
+    notStarted?: true;
 };
 
 /**

package/dist/lib.d.mts

@@ -881,6 +881,12 @@ type FileEventMessage = z$1.infer<typeof FileEventMessageSchema>;
 type Metadata = {
     /** Durable Teams spawn correlation; never contains credentials. */
     teamOperationId?: string;
+    /** B-874: the issue run this session executes (display only; the server's run table is authoritative). */
+    issue?: {
+        id: string;
+        runId?: string;
+        key?: string;
+    };
     /**
      * ACP session config option value (normalized for UI metadata consumers).
      */
@@ -1900,6 +1906,7 @@ type SpawnSessionResult = {
     type: 'error';
     errorMessage: string;
     startupExit?: StartupExit;
+    notStarted?: true;
 };
 
 /**

package/dist/lib.mjs

@@ -1,15 +1,15 @@
-export { A as ApiClient, a as ApiSessionClient } from './api-DibgCucH.mjs';
-export { l as logger } from './logger-n9NOzHhK.mjs';
-export { c as configuration } from './configuration-D9k5yIzV.mjs';
+export { A as ApiClient, a as ApiSessionClient } from './api-1CD4oRSW.mjs';
+export { l as logger } from './logger-CFrzcRHD.mjs';
+export { c as configuration } from './configuration-DhEqAYzz.mjs';
 export { R as RawJSONLinesSchema } from './types-CkqAACXx.mjs';
 import 'axios';
-import './pushNotifications-pHkbUkqT.mjs';
+import './pushNotifications-CxX10K6n.mjs';
 import 'node:crypto';
 import 'zod';
-import './index-BQvPYTNM.mjs';
+import './index-CiRMvS73.mjs';
 import '@paralleldrive/cuid2';
 import './contentLogMetadata-BlWI0egu.mjs';
-import './reconnectGate-DPDXEkOX.mjs';
+import './reconnectGate-uTLj82tS.mjs';
 import './authRelay-DhQhkBvX.mjs';
 import 'tweetnacl';
 import 'os';
@@ -17,8 +17,8 @@ import 'child_process';
 import 'node:events';
 import 'socket.io-client';
 import './limits-DIo7rEBR.mjs';
-import './time-PqfO1O58.mjs';
-import './registerCommonHandlers-BrTglZnC.mjs';
+import './time-DJF2csbV.mjs';
+import './registerCommonHandlers-BYrmi-A4.mjs';
 import 'util';
 import 'fs/promises';
 import 'crypto';
@@ -26,14 +26,14 @@ import 'path';
 import 'cross-spawn';
 import './projectPath-BTBIMB57.mjs';
 import 'url';
-import './sync-Dfr1zgLx.mjs';
+import './sync-CcBrziWp.mjs';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
-import './controlClient-DhFAPGHz.mjs';
-import './persistence-B5U9rC15.mjs';
+import './controlClient-PaIiDxM6.mjs';
+import './persistence-CF7oV1oH.mjs';
 import 'node:fs/promises';
 import 'node:fs';
 import 'chalk';
 import 'node:util';
 import 'node:path';
 import 'node:os';
-import './package-CCF6FHr2.mjs';
+import './package-DxE8PttX.mjs';

package/dist/{localHappyAgentAuth-Bsk_VyUN.cjs → localHappyAgentAuth-DxlQgaer.cjs}

@@ -6,7 +6,7 @@ var path = require('node:path');
 var tweetnacl = require('tweetnacl');
 var z = require('zod');
 var authRelay = require('./authRelay-Dy1qU9td.cjs');
-var configuration = require('./configuration-CAzuk0Xs.cjs');
+var configuration = require('./configuration-LWFmTxty.cjs');
 
 const AgentCredentialsSchema = z.z.object({
   token: z.z.string().min(1),

package/dist/{localHappyAgentAuth-CD896cy4.mjs → localHappyAgentAuth-kg2RFvOy.mjs}

@@ -4,7 +4,7 @@ import { join } from 'node:path';
 import tweetnacl from 'tweetnacl';
 import { z } from 'zod';
 import { c as credentialRelayProblem, d as decodeBase64 } from './authRelay-DhQhkBvX.mjs';
-import { c as configuration } from './configuration-D9k5yIzV.mjs';
+import { c as configuration } from './configuration-DhEqAYzz.mjs';
 
 const AgentCredentialsSchema = z.object({
   token: z.string().min(1),