very-happy-cli 0.2.199 → 0.2.200

package/dist/{index-BAjoMeJi.mjs → index-XP-qcJQ3.mjs}

@@ -1,14 +1,14 @@
 import { statSync, readdirSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { l as logger } from './logger-n9NOzHhK.mjs';
-import { r as readSettings } from './persistence-B5U9rC15.mjs';
+import { l as logger } from './logger-BLMi8oJK.mjs';
+import { r as readSettings } from './persistence-DbOKjdUD.mjs';
 import { d as describeAgentHome, C as CLAUDE_CONFIG_DIR_ENV, a as CODEX_HOME_ENV, f as findClaudeConversation, b as agentHomeCandidates, c as findCodexThread, r as resolveAgentHomes, A as AGENT_HOME_ENV_NAMES, g as agentHomeEnv, p as probeLoginShellEnv } from './loginShellEnv-Dw8M7tkI.mjs';
 export { h as claudeConversationPath, i as claudeProjectDirName, j as codexRolloutFileMatches, e as expandHomePath } from './loginShellEnv-Dw8M7tkI.mjs';
 import 'chalk';
 import 'node:util';
-import './configuration-D9k5yIzV.mjs';
+import './configuration-4pG95tsq.mjs';
 import 'node:path';
-import './package-CCF6FHr2.mjs';
+import './package-DbGqY8Ej.mjs';
 import 'node:fs/promises';
 import 'zod';
 import './authRelay-DhQhkBvX.mjs';

package/dist/{index-BQvPYTNM.mjs → index-kwsivEs-.mjs}

@@ -1233,9 +1233,13 @@ For add, retry with the same UUID and identical title/note after a timeout; do n
 
 For edit/status/delete, a conflict means the version changed. Read the task and compare the new state with the user's request before deciding what to do; never automatically overwrite with a freshly fetched version. A timeout may have committed: read to reconcile, then report the confirmed result. Do not claim a delete succeeded merely because a request was sent.
 
+## Issues
+
+On a server with Issues, My todos are issues without an assignee: the todo commands keep working on them (list shows open ones, \`--all\` adds completed; an ID may also be an issue key such as VH-12). Run \`very-happy issue --help\` for the full Issues interface (assign to an agent, comments). Without Issues the todo commands use the classic store; their output is the same.
+
 Restricted team workers cannot use account-wide Todo credentials. Ask the user or supervising session to perform the account operation; do not clear scope variables or seek another credential to bypass that boundary.
 `;
-const BUILTIN_TODO_DISCOVERY = "For the user\u2019s Very Happy My todos, run `very-happy todo skill` to read the official skill, then use its CLI commands. Do not confuse account todos with your execution plan; restricted team workers must not bypass their scope.";
+const BUILTIN_TODO_DISCOVERY = "For the user\u2019s Very Happy My todos (and Issues: `very-happy issue --help`), run `very-happy todo skill` to read the official skill, then use its CLI commands. Do not confuse account todos with your execution plan; restricted team workers must not bypass their scope.";
 z$1.object({
   source: z$1.literal("pi"),
   tokens: z$1.number().finite().nonnegative().nullable(),
@@ -1802,6 +1806,12 @@ function ownerBoardPostToRest(sessionId, input, anchor) {
     inferred: false
   };
 }
+const ISSUE_SESSION_CAPABILITY = "issue-v1";
+const ISSUES_DISABLED_ERROR = "issues_disabled";
+const ISSUE_WORKER_VERSION = 1;
+const ISSUE_KEY_PREFIX = "VH";
+const ISSUE_DISPATCH_LOCAL_ID_PREFIX = "issue-";
+const ISSUE_SENT_FROM = "issue";
 const ISSUE_LIMITS = {
   titleChars: 300,
   descriptionBytes: 32 * 1024,
@@ -1814,8 +1824,23 @@ const ISSUE_LIMITS = {
 const ISSUE_STATUSES = ["backlog", "todo", "in_progress", "in_review", "blocked", "done", "cancelled"];
 const ISSUE_PRIORITIES = ["urgent", "high", "medium", "low", "none"];
 const ISSUE_AGENT_STATUSES = ["in_progress", "in_review", "blocked"];
+const ISSUE_CLOSED_STATUSES = ["done", "cancelled"];
 const ISSUE_ASSIGNABLE_AGENTS = ["claude", "codex", "pi"];
 const ISSUE_ASSIGNEE_KINDS = ["none", "self", "agent", "team"];
+function isIssueClosed(status) {
+  return ISSUE_CLOSED_STATUSES.includes(status);
+}
+const ISSUE_KEY_PATTERN = new RegExp(`^${ISSUE_KEY_PREFIX}-(\\d{1,9})$`, "i");
+const UUIDISH = /^[A-Za-z0-9_-]{8,128}$/;
+function parseIssueRef(input) {
+  const value = input.trim();
+  const key2 = ISSUE_KEY_PATTERN.exec(value) ?? /^#?(\d{1,9})$/.exec(value);
+  if (key2) {
+    const n = Number(key2[1]);
+    return n > 0 ? { number: n } : null;
+  }
+  return UUIDISH.test(value) ? { id: value } : null;
+}
 const id = z$1.string().min(1).max(128);
 const requestId = z$1.string().min(1).max(128);
 const utf8Bytes = (value) => new TextEncoder().encode(value).length;
@@ -1969,6 +1994,27 @@ z$1.object({
   t: z$1.literal("issue-run"),
   run: z$1.object({ id: z$1.string(), issueId: z$1.string(), status: z$1.string() }).passthrough()
 });
+const ISSUE_ERROR_CODES = [
+  "issues_disabled",
+  "issue_not_found",
+  "issue_version_conflict",
+  "issue_count_quota_exceeded",
+  "issue_status_forbidden",
+  "issue_closed",
+  "issue_comment_required",
+  "issue_not_bound",
+  "issue_run_not_current",
+  "issue_assignee_unsupported",
+  "issue_agent_unsupported",
+  "issue_no_directory",
+  "issue_machine_not_found",
+  "issue_parent_cycle",
+  "issue_project_not_found",
+  "issue_comment_quota_exceeded",
+  "issue_run_not_found",
+  "issue_dispatch_claim_mismatch",
+  "transaction_conflict"
+];
 const SYNC_HELLO_MAX_REQUEST_SUBS = 64;
 const sessionIdSchema = z.string().min(1).max(128);
 const afterSeqSchema = z.number().int().min(0).nullable();
@@ -2066,4 +2112,4 @@ z.object({
   reason: z.string()
 });
 
-export { OwnerBoardResolveInputSchema as $, AGENT_PROFILE_SESSION_CAPABILITY as A, BUILTIN_TODO_SKILL as B, CLAUDE_CONFIG_MODEL_CAPABILITY as C, AutomationTriggerSchema as D, AGENT_PROFILE_FEATURE_LAUNCH as E, AgentProfileAddRequestSchema as F, AgentProfileLoginStartRequestSchema as G, AgentProfileLoginSubmitRequestSchema as H, AgentProfileBindRequestSchema as I, getAgentCodeDefaults as J, isLatestModelMode as K, resolveLatestModel as L, LATEST_MODEL_MODE as M, EFFORT_INTENT_AUTO as N, normalizeAgentKey as O, PROMPT_QUEUE_CAPABILITY as P, AgentProfilesStateSchema as Q, RUN_INTENT_CAPABILITY as R, STREAM_DELTA_MAX_CHARS as S, AgentVersionsSchema as T, AGENT_VERSION_SOURCES as U, ATTENTION_DISABLED_ERROR as V, ATTENTION_LIMITS as W, ownerBoardPostToRest as X, isAttentionBoardLocalId as Y, OwnerBoardPostInputSchema as Z, OwnerBoardUpdateInputSchema as _, PROJECT_SESSION_CAPABILITY as a, OwnerBoardListInputSchema as a0, ATTENTION_SESSION_CAPABILITY as a1, PI_STEER_CAPABILITY as a2, ReleaseDrainNoticeSchema as a3, RelayAssignmentResponseSchema as a4, CODEX_STEER_CAPABILITY as a5, CODEX_COMPACT_CAPABILITY as a6, CODEX_BTW_CAPABILITY as a7, CODEX_LIVE_PERMISSION_CAPABILITY as a8, AGENT_PROFILE_RPC as a9, RelayCandidatesResponseSchema as aa, ServerMigrateNoticeSchema as ab, isHarnessInstallId as ac, agentProfileUnavailableReason as ad, MODEL_INTENT_CONFIG as ae, AUTOMATION_PRECHECK_OUTPUT_MAX_CHARS as af, AUTOMATION_PRECHECK_DEFAULT_TIMEOUT_MS as ag, AUTOMATION_CLAIM_MAX_RUNS as ah, AUTOMATION_DAEMON_CAPABILITY_PRECHECK as ai, AUTOMATION_DEFAULT_LEASE_MS as aj, HARNESS_INSTALL_CAPABILITY_VERSION as ak, restoredModel as b, AUTOMATION_NAME_PATTERN as c, AUTOMATION_PRECHECK_MAX_TIMEOUT_MS as d, AutomationPrecheckSchema as e, isInsideTeamWorktree as f, rebaseTeamWorktreePath as g, AUTOMATION_ATTENTION_REASON_MAX_CHARS as h, isAutomationRunTerminal as i, AUTOMATION_SUMMARY_MAX_CHARS as j, createEnvelope as k, RUN_INTENT_RPC as l, RunIntentRequestSchema as m, nextRunIntents as n, readEffortIntent as o, readModelIntent as p, createBuiltinTodoClient as q, restoredEffort as r, streamKeyOf as s, AGENT_PROFILE_KINDS as t, parseLatestModelTable as u, resolveLaunchAgentProfile as v, BUILTIN_TODO_DISCOVERY as w, AutomationNameSchema as x, AutomationConcurrencySchema as y, AutomationActionSchema as z };
+export { AutomationTriggerSchema as $, AGENT_PROFILE_SESSION_CAPABILITY as A, parseLatestModelTable as B, CLAUDE_CONFIG_MODEL_CAPABILITY as C, resolveLaunchAgentProfile as D, createBuiltinTodoClient as E, ISSUE_LIMITS as F, isIssueClosed as G, BUILTIN_TODO_SKILL as H, ISSUE_SESSION_CAPABILITY as I, BUILTIN_TODO_DISCOVERY as J, AGENT_PROFILE_FEATURE_LAUNCH as K, AgentProfileAddRequestSchema as L, AgentProfileLoginStartRequestSchema as M, AgentProfileLoginSubmitRequestSchema as N, AgentProfileBindRequestSchema as O, PROMPT_QUEUE_CAPABILITY as P, getAgentCodeDefaults as Q, RUN_INTENT_CAPABILITY as R, STREAM_DELTA_MAX_CHARS as S, isLatestModelMode as T, resolveLatestModel as U, LATEST_MODEL_MODE as V, EFFORT_INTENT_AUTO as W, normalizeAgentKey as X, AutomationNameSchema as Y, AutomationConcurrencySchema as Z, AutomationActionSchema as _, PROJECT_SESSION_CAPABILITY as a, ISSUE_AGENT_STATUSES as a0, AgentProfilesStateSchema as a1, AgentVersionsSchema as a2, AGENT_VERSION_SOURCES as a3, PI_STEER_CAPABILITY as a4, ATTENTION_DISABLED_ERROR as a5, ATTENTION_LIMITS as a6, ownerBoardPostToRest as a7, isAttentionBoardLocalId as a8, OwnerBoardPostInputSchema as a9, OwnerBoardUpdateInputSchema as aa, OwnerBoardResolveInputSchema as ab, OwnerBoardListInputSchema as ac, ATTENTION_SESSION_CAPABILITY as ad, ReleaseDrainNoticeSchema as ae, RelayAssignmentResponseSchema as af, CODEX_STEER_CAPABILITY as ag, CODEX_COMPACT_CAPABILITY as ah, CODEX_BTW_CAPABILITY as ai, CODEX_LIVE_PERMISSION_CAPABILITY as aj, AGENT_PROFILE_RPC as ak, RelayCandidatesResponseSchema as al, ServerMigrateNoticeSchema as am, isHarnessInstallId as an, agentProfileUnavailableReason as ao, MODEL_INTENT_CONFIG as ap, AUTOMATION_PRECHECK_OUTPUT_MAX_CHARS as aq, AUTOMATION_PRECHECK_DEFAULT_TIMEOUT_MS as ar, AUTOMATION_CLAIM_MAX_RUNS as as, AUTOMATION_DAEMON_CAPABILITY_PRECHECK as at, AUTOMATION_DEFAULT_LEASE_MS as au, ISSUE_SENT_FROM as av, ISSUE_DISPATCH_LOCAL_ID_PREFIX as aw, HARNESS_INSTALL_CAPABILITY_VERSION as ax, restoredModel as b, AUTOMATION_NAME_PATTERN as c, AUTOMATION_PRECHECK_MAX_TIMEOUT_MS as d, AutomationPrecheckSchema as e, ISSUE_ASSIGNABLE_AGENTS as f, ISSUE_STATUSES as g, ISSUE_PRIORITIES as h, isAutomationRunTerminal as i, isInsideTeamWorktree as j, rebaseTeamWorktreePath as k, ISSUE_ERROR_CODES as l, ISSUES_DISABLED_ERROR as m, ISSUE_WORKER_VERSION as n, AUTOMATION_ATTENTION_REASON_MAX_CHARS as o, parseIssueRef as p, AUTOMATION_SUMMARY_MAX_CHARS as q, restoredEffort as r, streamKeyOf as s, createEnvelope as t, RUN_INTENT_RPC as u, RunIntentRequestSchema as v, nextRunIntents as w, readEffortIntent as x, readModelIntent as y, AGENT_PROFILE_KINDS as z };

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-require('./package-D7V1BX2I.cjs');
-require('./index-DL6ONx6v.cjs');
+require('./package-BFSsS_dl.cjs');
+require('./index-DUwOmhnq.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import './package-CCF6FHr2.mjs';
-import './index-DcfbjaVL.mjs';
+import './package-DbGqY8Ej.mjs';
+import './index-Sdvy1Lsf.mjs';
 import 'node:module';
 import 'node:fs';
 import 'node:fs/promises';

package/dist/{install-5nblS8vW.cjs → install-C4dKrmxR.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
-var logger = require('./logger-LsJ3Cl5o.cjs');
+var logger = require('./logger-D28MY1Bv.cjs');
 var require$$0 = require('fs');
 var child_process = require('child_process');
 var trimIdent = require('./trimIdent-4gvk9Wk6.cjs');
 var os = require('os');
 require('chalk');
 require('node:util');
-require('./configuration-CAzuk0Xs.cjs');
+require('./configuration-ClUt7pqs.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('./package-D7V1BX2I.cjs');
+require('./package-BFSsS_dl.cjs');
 require('node:fs/promises');
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/{install-CJcRTQVK.mjs → install-DMXd8Z4c.mjs}

@@ -1,15 +1,15 @@
-import { l as logger } from './logger-n9NOzHhK.mjs';
+import { l as logger } from './logger-BLMi8oJK.mjs';
 import { existsSync, writeFileSync, chmodSync } from 'fs';
 import { execSync } from 'child_process';
 import { t as trimIdent } from './trimIdent-BAjmv_TG.mjs';
 import os from 'os';
 import 'chalk';
 import 'node:util';
-import './configuration-D9k5yIzV.mjs';
+import './configuration-4pG95tsq.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import './package-CCF6FHr2.mjs';
+import './package-DbGqY8Ej.mjs';
 import 'node:fs/promises';
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/issue-BijeNKIT.cjs

@@ -0,0 +1,237 @@
+'use strict';
+
+var node_crypto = require('node:crypto');
+var index = require('./index-BiutHOAO.cjs');
+var configuration = require('./configuration-ClUt7pqs.cjs');
+var persistence = require('./persistence-TpVFA5-I.cjs');
+var context = require('./context-wMsIGwBw.cjs');
+var client = require('./client-1zIbVVX5.cjs');
+var format = require('./format-P9_M_7ga.cjs');
+require('zod');
+require('@paralleldrive/cuid2');
+require('node:fs');
+require('node:os');
+require('node:path');
+require('./package-BFSsS_dl.cjs');
+require('node:fs/promises');
+require('./authRelay-Dy1qU9td.cjs');
+require('tweetnacl');
+require('./logger-D28MY1Bv.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/issue-COytLvGE.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-kwsivEs-.mjs';
+import { c as configuration } from './configuration-4pG95tsq.mjs';
+import { r as readSettings } from './persistence-DbOKjdUD.mjs';
+import { r as readTeamScope, t as teamScopePath } from './context-Cf05DtNM.mjs';
+import { s as sharedIssuesClient, i as importLegacyTodosOnce } from './client-BgxQ9aej.mjs';
+import { d as describeIssueError, f as formatIssueLine, a as formatIssueDetail } from './format-CbliQN8V.mjs';
+import 'zod';
+import '@paralleldrive/cuid2';
+import 'node:fs';
+import 'node:os';
+import 'node:path';
+import './package-DbGqY8Ej.mjs';
+import 'node:fs/promises';
+import './authRelay-DhQhkBvX.mjs';
+import 'tweetnacl';
+import './logger-BLMi8oJK.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 };