@pushary/agent-hooks 1.7.0 → 1.7.2

package/dist/bin/pushary-setup.js

@@ -2,59 +2,62 @@
 import {
   codexTrustOutcome,
   describeCodexTrustConfirmation
-} from "../chunk-B234346F.js";
+} from "../chunk-M2JGLFFS.js";
 import {
   runBrowserLogin
-} from "../chunk-QXAK5RFU.js";
+} from "../chunk-AWZNDM3B.js";
 import {
   coworkOutput,
   coworkSelection
-} from "../chunk-D6BULEJW.js";
+} from "../chunk-3NSRL5E7.js";
 import "../chunk-PUZZELE6.js";
 import {
   detectClaudeVersion
-} from "../chunk-O2LEPIU6.js";
+} from "../chunk-U3MS6D5X.js";
 import {
   AgentConfigError,
+  afterAgentFailureNote,
   agentFailureFromError,
   agentFailureWire,
   configFailureKind,
   describeVersionManagerPin,
   describedAgentFailure,
+  failedAgentsContext,
   retryAgentCommand,
   versionManagerOf
-} from "../chunk-S3UD4V6W.js";
+} from "../chunk-INR3RVQ3.js";
 import {
   ensureCodexTrustsPusharyHooks
-} from "../chunk-7OS4IHGI.js";
+} from "../chunk-5GIBNUBD.js";
 import {
   readManagedControlEvidence,
   waitForMachineReadiness
-} from "../chunk-4F46VIEE.js";
+} from "../chunk-YU54LNC6.js";
 import {
-  HERMES_CONFIG_SCRIPT,
-  HERMES_PIP_PACKAGE,
   describeSetupSideEffects,
   installAgentSkill,
   installSkillViaSkillsCli,
-  isHermesConfigReceipt,
-  resolveHermesPython,
-  runHermesPythonScript
-} from "../chunk-DANOZVZK.js";
+  registerCursorGate
+} from "../chunk-MY3UZO5U.js";
 import {
   FX_PROFILE_REFUSALS,
   FX_PUSHARY_TOOLS_RULE,
+  FX_QUESTION_RULE_RECEIPT,
+  FX_QUESTION_TOOL,
   FX_SETTINGS_REFUSALS,
   FX_TOOL_DISCOVERY_NOTE,
+  HERMES_PIP_PACKAGE,
   describeDetection,
   detectAllAgents,
   fxIgnoresInstructionsFile,
   fxProfileText,
   fxPusharyEntry,
   fxPusharyEntryOf,
+  fxQuestionRouting,
   fxSettingsText,
   isDetected,
   isFxPusharyEntry,
+  isHermesConfigReceipt,
   pluginLocationSnippet,
   readFxFile,
   readFxProfile,
@@ -62,16 +65,20 @@ import {
   registerPluginLocation,
   renderAgentInstructions,
   renderProjectAgentInstructions,
+  resolveHermesPython,
+  runHermesConfigScript,
   shortenHome,
   vscodeSettingsTargets,
   withFxPusharyServer,
   withPusharyToolsAllowed,
+  withQuestionsRoutedToPushary,
   workspacesOverridingPusharyRule,
+  workspacesShowingQuestionTool,
   writeInstructionBlock
-} from "../chunk-L4H2Q2S4.js";
+} from "../chunk-SKMWPXGV.js";
 import {
   MCP_BRIDGE_BINARY
-} from "../chunk-YYINL576.js";
+} from "../chunk-TVJYGZXB.js";
 import {
   OPENCODE_HOOK_BINARY,
   addOpenCodeMcpServer,
@@ -82,7 +89,7 @@ import {
   openCodePluginDir,
   openCodePluginFile,
   openCodeWired
-} from "../chunk-B3YQANFN.js";
+} from "../chunk-SKEW3TQX.js";
 import {
   addCompatibleHooks,
   addCompatibleMcpServer,
@@ -93,7 +100,7 @@ import {
   compatibleMcpFile,
   compatiblePermissionRuleFile,
   hasCompatibleHooks
-} from "../chunk-WUNZAE7I.js";
+} from "../chunk-T3PRPFDY.js";
 import {
   addClaudeMcpServer,
   addPusharyHooks,
@@ -101,16 +108,16 @@ import {
   captureClaudeMcpServer,
   isClaudeMcpSnapshot,
   updateClaudeMcpSnapshot
-} from "../chunk-KYQXUGH7.js";
+} from "../chunk-KAJT6HPI.js";
 import {
   detectProviderLiveCapabilities,
   hasSpawnProvider,
   resolveControlPolicy
-} from "../chunk-JXUAXO74.js";
+} from "../chunk-YNJ2H2FD.js";
 import {
   describeAutoUpdateAnnouncement,
   takeAutoUpdateAnnouncement
-} from "../chunk-BWYJ6AAF.js";
+} from "../chunk-YU4222G2.js";
 import {
   KEEP_HINT,
   captureHookTakeover,
@@ -120,23 +127,23 @@ import {
   hookOwnerOf,
   mcpBearerKey,
   planHooks
-} from "../chunk-R2XCLT6I.js";
+} from "../chunk-E3PLF7YB.js";
 import {
   AGENT_CHOICES,
   effectiveControlMode,
   effectiveVerify,
   parseSetupOptions
-} from "../chunk-CVALVGA7.js";
+} from "../chunk-I7B2DNVU.js";
 import {
   liveBridgeProbe,
   resolveBridgeStub
-} from "../chunk-5HLTWFJ6.js";
+} from "../chunk-JMSB6CJT.js";
 import {
   claudeWired,
   codexWired,
   geminiWired,
   pusharyHookExecutable
-} from "../chunk-PQ4F64M2.js";
+} from "../chunk-L6IF4JOF.js";
 import {
   clearDaemonNeedsLogin,
   daemonHasRemoteProof,
@@ -149,25 +156,26 @@ import {
   replaceDaemonService,
   stopDaemonService,
   waitForDaemonRemoteProof
-} from "../chunk-73T6MSU5.js";
+} from "../chunk-4S7CCOXB.js";
 import {
   GEMINI_HOOK_BINARY,
   addGeminiHooks,
   addGeminiMcpServer,
   compareVersion,
   parseVersion
-} from "../chunk-ZQ7IDOKY.js";
-import "../chunk-VKVIAZQO.js";
+} from "../chunk-A6WQF7FQ.js";
+import "../chunk-KLXYMPTM.js";
 import {
   transcriptPreferenceForSetup
-} from "../chunk-B76WVEDX.js";
+} from "../chunk-Q7CDBJXU.js";
 import "../chunk-XHKBHWLX.js";
 import {
   reportEvent
-} from "../chunk-IJ6ECPA6.js";
-import "../chunk-DZURML2D.js";
-import "../chunk-EGKXSQCY.js";
-import "../chunk-V6QRSU2G.js";
+} from "../chunk-2B4XCMH6.js";
+import "../chunk-N6IOSZOE.js";
+import "../chunk-RLRDPZG4.js";
+import "../chunk-2XOHXZRC.js";
+import "../chunk-6QZK4O36.js";
 import "../chunk-POFBE6ZY.js";
 import {
   BROWSER_CONNECT_COMMAND,
@@ -179,19 +187,16 @@ import {
   printConnectInstructions,
   roundTripEvidence,
   verifyRoundTrip
-} from "../chunk-HDRNWNVP.js";
+} from "../chunk-YLCSKVQQ.js";
 import "../chunk-3EGEA4KH.js";
-import {
-  checkApiKey,
-  describeKeyCheck,
-  samePusharyAccount
-} from "../chunk-X6KDKOV5.js";
 import {
   setHumanStream
 } from "../chunk-QCGNGEGE.js";
 import {
+  ansiPainter,
+  createIo,
   useColor
-} from "../chunk-5RUIFDTP.js";
+} from "../chunk-U4TMAANR.js";
 import "../chunk-GMXKITVA.js";
 import {
   KEY_FILE_MODE,
@@ -203,18 +208,24 @@ import {
   readKeySource,
   resolveShellRc,
   writeKey
-} from "../chunk-UOAQ6QMP.js";
-import "../chunk-JNXVOU6Y.js";
-import "../chunk-KW2RRR7D.js";
-import "../chunk-XNCMT7YY.js";
+} from "../chunk-VSGKQ3HI.js";
+import "../chunk-D4OGEWLH.js";
+import {
+  checkApiKey,
+  describeKeyCheck,
+  samePusharyAccount
+} from "../chunk-VQDJ6KB3.js";
+import "../chunk-UFNBKYWT.js";
+import "../chunk-HOIGXMI7.js";
 import {
   UsageError
 } from "../chunk-7QLSKOSU.js";
 import {
   EXIT
 } from "../chunk-KZERVKTD.js";
-import "../chunk-ROQK7IN3.js";
+import "../chunk-LI3C2IQY.js";
 import {
+  NpmMissingError,
   addCodexHookTrust,
   addCodexHooks,
   addCodexMcpServer,
@@ -238,6 +249,7 @@ import {
   fxAgentsMd,
   fxConfigDir,
   fxMcpProfile,
+  fxQuestionRuleReceipt,
   fxSettings,
   geminiMd,
   geminiSettings,
@@ -251,23 +263,22 @@ import {
   pusharyConfigFile,
   pusharyDir,
   readCodexMcpAuth,
-  registerHookEntry,
   resolveGlobalBinDir,
   resolveGlobalBinary,
   vscodePluginDir,
   vscodePluginMcp
-} from "../chunk-DNJUSFBL.js";
+} from "../chunk-NYBZJ44G.js";
 import {
   backupFile,
   readJsonSafe,
   writeFileAtomic,
   writeJsonAtomic
 } from "../chunk-T7E75EKA.js";
-import "../chunk-V4AQBAVG.js";
+import "../chunk-SJN64NJX.js";
 import {
   NPX_LATEST_COMMAND,
   renderCommandHelp
-} from "../chunk-B3UXMSMW.js";
+} from "../chunk-65RN6ZCO.js";
 import {
   HOOK_COMPATIBLE_PROFILES,
   HOOK_LOCATOR_BINARY,
@@ -278,7 +289,7 @@ import {
   hookCompatibleProfile,
   isNewerVersion,
   isValidApiKey
-} from "../chunk-YROGUPOZ.js";
+} from "../chunk-WWTLAZQA.js";
 
 // bin/pushary-setup.ts
 import { existsSync, readFileSync, writeFileSync, mkdirSync, cpSync, rmSync, renameSync, realpathSync, readdirSync, statSync, openSync, readSync, closeSync } from "fs";
@@ -292,10 +303,6 @@ import { parse as parseTOML, stringify as stringifyTOML } from "smol-toml";
 // src/cli/exit.ts
 var isExitPromptError = (err) => err instanceof Error && (err.name === "ExitPromptError" || err.message.includes("User force closed") || /force closed the prompt/i.test(err.message));
 
-// src/cursor-config.ts
-var isPusharyCursorEntry = (entry) => pusharyHookExecutable(String(entry?.command ?? "")) !== null;
-var registerCursorGate = (existing, entry) => registerHookEntry(existing, isPusharyCursorEntry, entry);
-
 // src/setup/phone-check.ts
 var planPhoneCheck = (context) => {
   if (context.locked) return "locked";
@@ -447,10 +454,16 @@ var describeClosing = (facts) => {
   };
 };
 var RETRY_AGENT_LABEL = "Retry just this agent:";
+var INSTALL_NODE_STEP = "Install the current Node.js LTS, which includes npm, then run setup again.";
+var nextStepFor = (failure) => failure.remedy === "install-node" ? { kind: "install-node", instruction: INSTALL_NODE_STEP } : { kind: "retry-agent", command: retryAgentCommand(failure.agent) };
 var describeAgentFailures = (failures, agentName) => failures.map((failure) => ({
   summary: `${agentName(failure.agent)}: ${failure.detail}`,
-  retryCommand: retryAgentCommand(failure.agent)
+  next: nextStepFor(failure)
 }));
+var agentFailureFollowUps = (failures) => [
+  ...failures.some((failure) => failure.remedy === "install-node") ? ["install-node"] : [],
+  ...failures.some((failure) => failure.remedy === "retry-agent") ? ["run-doctor"] : []
+];
 var unverifiedKeyClosingReason = (facts) => {
   if (facts.failedCount > 0) return "agents-failed";
   if (facts.controlLifecycleFailed) return "control-unready";
@@ -679,7 +692,7 @@ var writeHuman = (text) => {
   humanStream.write(text);
 };
 var jsonMode = false;
-var paint = (open) => (s) => useColor({ json: jsonMode }) ? `${open}${s}\x1B[0m` : s;
+var paint = ansiPainter(() => useColor({ json: jsonMode }));
 var dim = paint("\x1B[2m");
 var bold = paint("\x1B[1m");
 var green = paint("\x1B[32m");
@@ -776,24 +789,7 @@ var formatError = (err) => {
   }
   return String(err);
 };
-var spinner = async (label, fn, options = {}) => {
-  const frames = ["   ", ".  ", ".. ", "..."];
-  let i = 0;
-  const interval = setInterval(() => {
-    writeHuman(`\r  ${dim(frames[i++ % frames.length])} ${label}`);
-  }, 200);
-  try {
-    await fn();
-    clearInterval(interval);
-    writeHuman(`\r  ${check} ${label}
-`);
-  } catch (err) {
-    clearInterval(interval);
-    writeHuman(`\r  ${yellow("!")} ${label} ${dim(`(${formatError(err)})`)}
-`);
-    if (!options.optional) throw err;
-  }
-};
+var spinner = (label, fn, options = {}) => createIo(humanStream, { json: jsonMode }).spinner(label, fn, options);
 var checkForUpdates = async (current, markAnnounced) => {
   const announcement = takeAutoUpdateAnnouncement(autoUpdateState(), markAnnounced);
   if (announcement) {
@@ -819,7 +815,7 @@ var installGlobally2 = async () => {
     try {
       await installGlobally({ version });
     } catch (err) {
-      throw new Error(npmErrorMessage(err));
+      throw err instanceof NpmMissingError ? err : new Error(npmErrorMessage(err));
     }
   });
   globalInstallReady = true;
@@ -908,7 +904,7 @@ var ensurePip = (python) => {
   }
 };
 var enablePusharyPlugin = (python) => {
-  return runHermesPythonScript(python, HERMES_CONFIG_SCRIPT, "setup", HERMES_CONFIG_RECEIPT);
+  return runHermesConfigScript(python, "setup", HERMES_CONFIG_RECEIPT) !== "failed";
 };
 var setupHermes = async (_apiKey) => {
   console.log(`
@@ -1505,40 +1501,76 @@ var writeFxProfile = (filePath, profile) => {
   }
   writeFileAtomic(filePath, rendered.text, KEY_FILE_MODE);
 };
-var FX_ALLOW_RULE_SNIPPET = `"permission": { "${FX_PUSHARY_TOOLS_RULE}": "allow" }`;
+var FX_SETTINGS_RULES_SNIPPET = `"permission": { "${FX_PUSHARY_TOOLS_RULE}": "allow", "${FX_QUESTION_TOOL}": "deny" }`;
 var fxSettingsReadRefusal = (filePath, read) => {
   if (read.kind === "unreadable") return `${filePath} could not be read`;
   if (read.kind === "refused") return `${filePath} ${FX_SETTINGS_REFUSALS[read.reason]}`;
   return null;
 };
-var allowPusharyToolsInFx = (filePath) => {
+var recordFxQuestionRule = () => {
+  try {
+    if (!existsSync(fxQuestionRuleReceipt())) writeJsonAtomic(fxQuestionRuleReceipt(), FX_QUESTION_RULE_RECEIPT, 384);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var configureFxSettings = (filePath) => {
   const read = readFxFile(filePath, readFxSettings);
   const refusal = fxSettingsReadRefusal(filePath, read);
   if (refusal) return { kind: "refused", detail: refusal };
-  const { settings, change } = withPusharyToolsAllowed(read.kind === "settings" ? read.settings : {});
-  if (change !== "added") return { kind: "written", change, overridingWorkspaces: workspacesOverridingPusharyRule(settings) };
-  const rendered = fxSettingsText(settings);
+  const allowed = withPusharyToolsAllowed(read.kind === "settings" ? read.settings : {});
+  const routed = withQuestionsRoutedToPushary(allowed.settings);
+  const written = {
+    kind: "written",
+    toolsChange: allowed.change,
+    questionChange: routed.change,
+    questionRouting: fxQuestionRouting(routed.settings, process.env),
+    workspacesWithOwnRules: [.../* @__PURE__ */ new Set([...workspacesOverridingPusharyRule(routed.settings), ...workspacesShowingQuestionTool(routed.settings)])],
+    ruleRecorded: true
+  };
+  if (allowed.change !== "added" && routed.change !== "added") return written;
+  const rendered = fxSettingsText(routed.settings);
   if (rendered.kind === "refused") return { kind: "refused", detail: `${filePath} would grow past the 64 KiB fx reads` };
   try {
     writeFileAtomic(filePath, rendered.text, KEY_FILE_MODE);
   } catch (err) {
     return { kind: "refused", detail: `${filePath} could not be written (${formatError(err)})` };
   }
-  return { kind: "written", change, overridingWorkspaces: workspacesOverridingPusharyRule(settings) };
+  return { ...written, ruleRecorded: routed.change !== "added" || recordFxQuestionRule() };
+};
+var FX_QUESTION_ROUTING_REPORTS = {
+  "full-access": "fx runs in full-access mode, which ignores permission rules, so its terminal question tool stays on. Its instructions tell it to ask through Pushary instead; leave full-access mode with /permissions to turn the tool off for certain.",
+  overridden: `A rule in ${fxSettings()} keeps fx's terminal question tool on, so fx can still ask there instead of through Pushary.`
 };
-var reportFxToolsRule = (outcome) => {
+var FX_QUESTION_SUMMARIES = {
+  routed: "fx's agent asks through Pushary, which reaches your phone, or the Mac notch while the Pushary Mac app runs",
+  "full-access": "fx's agent is told to ask through Pushary, but full-access mode keeps fx's terminal prompt available to it",
+  overridden: "fx's terminal prompt stays available, so fx's agent is only told to ask through Pushary"
+};
+var reportFxSettings = (outcome) => {
   if (outcome.kind === "refused") {
-    console.log(`  ${yellow("!")} ${outcome.detail}, so Pushary tools were not auto-allowed. fx will review or prompt for each Pushary call.`);
-    noteManual(`Add ${FX_ALLOW_RULE_SNIPPET} to ${fxSettings()} so fx runs Pushary tools without a prompt.`);
+    console.log(`  ${yellow("!")} ${outcome.detail}, so Pushary tools were not auto-allowed and fx's terminal question tool stays on.`);
+    noteManual(`Add ${FX_SETTINGS_RULES_SNIPPET} to ${fxSettings()} so fx runs Pushary tools without a prompt and asks through Pushary.`);
     return;
   }
-  if (outcome.change === "user-rule-kept") {
+  if (outcome.toolsChange === "user-rule-kept") {
     console.log(`  ${yellow("!")} ${fxSettings()} already has a ${FX_PUSHARY_TOOLS_RULE} rule, so it was left as you set it.`);
   } else {
-    console.log(`  ${dim("\u2022")} Auto-allowed tools: ${FX_PUSHARY_TOOLS_RULE} in ${fxSettings()}, so Pushary calls run without an fx prompt or review`);
+    console.log(`  ${check} Auto-allowing Pushary tools (${fxSettings()})`);
+  }
+  if (outcome.questionRouting === "routed") {
+    console.log(`  ${check} Turning off fx's terminal question tool, so its questions go through Pushary`);
+  } else if (outcome.questionChange === "user-rule-kept") {
+    console.log(`  ${yellow("!")} ${fxSettings()} already has a ${FX_QUESTION_TOOL} rule, so it was left as you set it and fx can still ask in the terminal.`);
+  } else {
+    console.log(`  ${yellow("!")} ${FX_QUESTION_ROUTING_REPORTS[outcome.questionRouting]}`);
   }
-  if (outcome.overridingWorkspaces.length > 0) {
-    console.log(`  ${yellow("!")} ${outcome.overridingWorkspaces.length} fx workspace(s) set their own permission rules, which replace the global ones there. Add ${FX_PUSHARY_TOOLS_RULE} to each to auto-allow Pushary tools.`);
+  if (!outcome.ruleRecorded) {
+    console.log(`  ${yellow("!")} ${fxQuestionRuleReceipt()} could not be written, so pushary clean will treat the ${FX_QUESTION_TOOL} rule as yours and leave it.`);
+  }
+  if (outcome.workspacesWithOwnRules.length > 0) {
+    console.log(`  ${yellow("!")} ${outcome.workspacesWithOwnRules.length} fx workspace(s) set their own permission rules, which replace the global ones there. Add "${FX_PUSHARY_TOOLS_RULE}": "allow" and "${FX_QUESTION_TOOL}": "deny" to each to route them through Pushary.`);
   }
 };
 var teachFxToAskViaPush = () => {
@@ -1572,20 +1604,19 @@ var setupFx = async () => {
     const entry = fxPusharyEntry(guardedArgv({ kind: "binary", path: bridge, runtime: "node" }));
     writeFxProfile(fxMcpProfile(), withFxPusharyServer(profile, entry));
   });
-  const toolsRule = allowPusharyToolsInFx(fxSettings());
-  const instructionsWritten = teachFxToAskViaPush();
-  console.log();
-  console.log(`  ${dim("What this configured:")}`);
-  console.log(`  ${dim("\u2022")} MCP server ${bold("pushary")} in ${fxMcpProfile()}`);
-  console.log(`  ${dim("\u2022")} It runs ${MCP_BRIDGE_BINARY}, which signs in with the key saved in ~/.pushary, so no key is written to fx's config`);
-  reportFxToolsRule(toolsRule);
-  if (instructionsWritten) {
-    console.log(`  ${dim("\u2022")} Instructions: ${fxAgentsMd()}`);
+  const settingsOutcome = configureFxSettings(fxSettings());
+  reportFxSettings(settingsOutcome);
+  if (teachFxToAskViaPush()) {
+    console.log(`  ${check} Teaching fx to ask via push (${fxAgentsMd()})`);
   } else {
     console.log(`  ${yellow("!")} ${fxAgentsMd()} links outside ${fxConfigDir()}, and fx ignores such a file, so no instructions were written.`);
     noteManual(`Replace the ${fxAgentsMd()} symlink with a file so fx loads Pushary's instructions, then run ${retryAgentCommand("fx")}.`);
   }
-  console.log(`  ${dim("\u2022")} fx cannot hand its own approval prompts to Pushary; its agent asks through Pushary when it chooses to`);
+  console.log();
+  console.log(`  ${dim("What this configured:")}`);
+  console.log(`  ${dim("\u2022")} MCP server ${bold("pushary")} in ${fxMcpProfile()}, which runs ${MCP_BRIDGE_BINARY} and signs in with the key saved in ~/.pushary, so no key is written to fx's config`);
+  console.log(`  ${dim("\u2022")} Questions: ${FX_QUESTION_SUMMARIES[settingsOutcome.kind === "written" ? settingsOutcome.questionRouting : "overridden"]}`);
+  console.log(`  ${dim("\u2022")} fx cannot hand its own approval prompts to Pushary, so those still wait in the terminal`);
   console.log(`  ${dim("Restart fx, or run /mcp reload in a running session.")}`);
   noteManual("Restart fx, or run /mcp reload in a running session.");
   return "configured";
@@ -1982,15 +2013,16 @@ var AGENT_CAPABILITIES = {
   cursor: "plugin + permission gate",
   vscode: "agent plugin + permission gate",
   opencode: "generated plugin + permission gate",
-  fx: "MCP through a local bridge",
+  fx: "MCP through a local bridge + questions via push",
   ...compatibleRecord((profile) => profile.mcp ? "MCP + native hooks" : "native hooks"),
   custom: "any MCP or HTTP agent (Windsurf, n8n, custom)"
 };
 var failedAgentNames = (failures) => failures.map((failure) => AGENT_NAMES[failure.agent]);
+var agentFailureNextLine = (next) => next.kind === "retry-agent" ? `${dim(RETRY_AGENT_LABEL)} ${cyan(next.command)}` : next.instruction;
 var printAgentFailures = (failures) => {
   for (const failure of describeAgentFailures(failures, (agent) => AGENT_NAMES[agent])) {
     console.log(`  ${yellow("!")} ${failure.summary}`);
-    console.log(`    ${dim(RETRY_AGENT_LABEL)} ${cyan(failure.retryCommand)}`);
+    console.log(`    ${agentFailureNextLine(failure.next)}`);
   }
 };
 var NAME_COLUMN = Math.max(...Object.values(AGENT_NAMES).map((name) => name.length)) + 2;
@@ -2042,6 +2074,7 @@ var resolveAgents = async (options) => {
       // visible and correctable, rather than an unexplained pre-tick.
       name: detected[agent].evidence ? `${AGENT_LABELS[agent]} ${dim(`[${detected[agent].evidence}]`)}` : AGENT_LABELS[agent],
       value: agent,
+      short: AGENT_NAMES[agent],
       checked: detected[agent].found
     })),
     // Today an empty selection skips the loop and still prints "Setup complete."
@@ -2288,7 +2321,7 @@ var main = async () => {
   const transcriptSync = transcriptPreferenceForSetup(options.transcripts);
   if (transcriptSync) {
     console.log();
-    console.log("Transcript sync: enabling locally redacted, encrypted sync for Pushary-launched sessions. Your phone can decrypt it; authorized Pushary compliance admins can recover it for documented legal obligations. Disable with pushary setup --transcripts off.");
+    console.log("  Transcript sync: enabling locally redacted, encrypted sync for Pushary-launched sessions. Your phone can decrypt it; authorized Pushary compliance admins can recover it for documented legal obligations. Disable with pushary setup --transcripts off.");
   }
   const rc = await saveApiKey(trimmedKey, controlMode, transcriptSync);
   if (keyCheck.kind === "ok") clearDaemonNeedsLogin();
@@ -2332,7 +2365,7 @@ var main = async () => {
   ${check} API key saved. No agents configured.`);
     console.log(`  ${dim("Run setup again with --agents <id> when you want one wired up.")}`);
   } else {
-    for (const agent of agents) {
+    for (const [index, agent] of agents.entries()) {
       markStep(`configure:${agent}`);
       try {
         const ownerBefore = hookOwnerFor(agent, appBridgeAvailable);
@@ -2372,7 +2405,8 @@ var main = async () => {
         const failure = agentFailureFromError(agent, err, formatError);
         failures.push(failure);
         console.log(`  ${yellow("!")} ${AGENT_NAMES[agent]} setup failed: ${failure.detail}`);
-        console.log(`  ${dim("Other agents will continue. Re-run setup to retry.")}`);
+        const continuation = afterAgentFailureNote(agents.length - index - 1);
+        if (continuation) console.log(`  ${dim(continuation)}`);
       }
     }
     if (skipped.length > 0) {
@@ -2381,8 +2415,12 @@ var main = async () => {
     }
     if (failures.length > 0) {
       console.log();
-      console.log(`  ${yellow("!")} Failed: ${failedAgentNames(failures).join(", ")} ${dim("(others completed successfully)")}`);
-      console.log(`  ${dim("Run")} npx @pushary/agent-hooks@latest doctor ${dim("for the reason, or send it to")} ${SUPPORT_EMAIL}`);
+      const configured = failedAgentsContext(completed.map((agent) => AGENT_NAMES[agent]));
+      console.log(`  ${yellow("!")} Failed: ${failedAgentNames(failures).join(", ")}${configured ? ` ${dim(configured)}` : ""}`);
+      for (const followUp of agentFailureFollowUps(failures)) {
+        if (followUp === "install-node") console.log(`  ${INSTALL_NODE_STEP}`);
+        else console.log(`  ${dim("Run")} npx @pushary/agent-hooks@latest doctor ${dim("for the reason, or send it to")} ${SUPPORT_EMAIL}`);
+      }
     }
     markStep("project-instructions");
     await offerProjectInstructions(agents, options);

package/dist/bin/pushary-stats.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 import {
   readLedgerSummary
-} from "../chunk-2C7CCWVX.js";
+} from "../chunk-F6BMJOSW.js";
 import {
   exitOnHelpFlag
-} from "../chunk-2PS6QWDW.js";
+} from "../chunk-6NHXKTQU.js";
 import "../chunk-KZERVKTD.js";
 import {
   getApiKey
-} from "../chunk-V4AQBAVG.js";
-import "../chunk-B3UXMSMW.js";
-import "../chunk-YROGUPOZ.js";
+} from "../chunk-SJN64NJX.js";
+import "../chunk-65RN6ZCO.js";
+import "../chunk-WWTLAZQA.js";
 
 // bin/pushary-stats.ts
 exitOnHelpFlag("stats");

package/dist/bin/pushary-status.js

@@ -2,48 +2,48 @@
 import {
   describeLastSeen,
   listMachines
-} from "../chunk-4F46VIEE.js";
-import "../chunk-JXUAXO74.js";
-import "../chunk-73T6MSU5.js";
+} from "../chunk-YU54LNC6.js";
+import "../chunk-YNJ2H2FD.js";
+import "../chunk-4S7CCOXB.js";
 import "../chunk-XHKBHWLX.js";
 import {
   describeReach,
   fetchChannels,
   reachVerdict
-} from "../chunk-HDRNWNVP.js";
+} from "../chunk-YLCSKVQQ.js";
 import "../chunk-3EGEA4KH.js";
-import {
-  checkApiKey,
-  describeKeyCheck
-} from "../chunk-X6KDKOV5.js";
 import "../chunk-QCGNGEGE.js";
 import {
   createIo
-} from "../chunk-5RUIFDTP.js";
+} from "../chunk-U4TMAANR.js";
 import {
   exitOnHelpFlag
-} from "../chunk-2PS6QWDW.js";
+} from "../chunk-6NHXKTQU.js";
 import {
   rejectUnknownFlags
 } from "../chunk-GMXKITVA.js";
 import {
   readKeySource
-} from "../chunk-UOAQ6QMP.js";
-import "../chunk-JNXVOU6Y.js";
-import "../chunk-KW2RRR7D.js";
-import "../chunk-XNCMT7YY.js";
+} from "../chunk-VSGKQ3HI.js";
+import "../chunk-D4OGEWLH.js";
+import {
+  checkApiKey,
+  describeKeyCheck
+} from "../chunk-VQDJ6KB3.js";
+import "../chunk-UFNBKYWT.js";
+import "../chunk-HOIGXMI7.js";
 import {
   UsageError
 } from "../chunk-7QLSKOSU.js";
 import {
   EXIT
 } from "../chunk-KZERVKTD.js";
-import "../chunk-ROQK7IN3.js";
-import "../chunk-DNJUSFBL.js";
+import "../chunk-LI3C2IQY.js";
+import "../chunk-NYBZJ44G.js";
 import "../chunk-T7E75EKA.js";
-import "../chunk-V4AQBAVG.js";
-import "../chunk-B3UXMSMW.js";
-import "../chunk-YROGUPOZ.js";
+import "../chunk-SJN64NJX.js";
+import "../chunk-65RN6ZCO.js";
+import "../chunk-WWTLAZQA.js";
 
 // src/status.ts
 var keySourceLine = (source) => {