very-happy-cli 0.2.164 → 0.2.166

package/dist/{connect-XHdi6Vtc.mjs → connect-CnNNyM9I.mjs}

@@ -1,12 +1,12 @@
 import chalk from 'chalk';
 import { homedir } from 'os';
 import { join } from 'path';
-import { readCredentialsForConfiguredRelay } from './persistence-C_xFQLsD.mjs';
-import { A as ApiClient } from './api-Yoh_zKdR.mjs';
-import { f as ensurePrivateDirectorySync, w as writePrivateFileSync } from './configuration-CiBUH72C.mjs';
+import { readCredentialsForConfiguredRelay } from './persistence-B9LmhAE2.mjs';
+import { A as ApiClient } from './api-Cmz3XS4P.mjs';
+import { f as ensurePrivateDirectorySync, w as writePrivateFileSync } from './configuration-D2v3puap.mjs';
 import { createServer } from 'http';
 import { randomBytes, createHash } from 'crypto';
-import { o as openBrowser } from './browser-DydXWySF.mjs';
+import { o as openBrowser } from './browser-DDFi1T8C.mjs';
 import { exec } from 'child_process';
 import { promisify } from 'util';
 import 'node:fs/promises';
@@ -15,28 +15,28 @@ import 'zod';
 import './authRelay-DSAvg1uv.mjs';
 import 'node:crypto';
 import 'tweetnacl';
-import './logger-8dtZPn3n.mjs';
+import './logger-BpQcwNnt.mjs';
 import 'node:util';
 import 'node:path';
 import 'node:os';
-import './package-tVYgFJoK.mjs';
+import './package-BqwrPxL0.mjs';
 import 'axios';
-import './lidState-BbR6y9rq.mjs';
+import './lidState-BfximpjX.mjs';
 import 'node:events';
 import 'socket.io-client';
-import './attachmentLimits-B8nzhw-i.mjs';
-import './index-vVWpCoTr.mjs';
+import './attachmentLimits-C1PCCM79.mjs';
+import './index-B0HEEYGh.mjs';
 import '@paralleldrive/cuid2';
 import './limits-DIo7rEBR.mjs';
-import './time-CRvAaC5H.mjs';
-import './registerCommonHandlers-bSskMveZ.mjs';
+import './time-CfDKj6Bx.mjs';
+import './registerCommonHandlers-DdfGsFbM.mjs';
 import 'fs/promises';
 import 'cross-spawn';
 import './projectPath-BTBIMB57.mjs';
 import 'url';
-import './sync-SCvDzRy6.mjs';
+import './sync-BLpH13Kb.mjs';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
-import './controlClient-DzmCQrY_.mjs';
+import './controlClient-BMUJfUeF.mjs';
 import './contentLogMetadata-BlWI0egu.mjs';
 import 'open';
 

package/dist/{context-DhvXl1oC.cjs → context-BFUpYT39.cjs}

@@ -5,7 +5,7 @@ var node_fs = require('node:fs');
 var path = require('node:path');
 var node_crypto = require('node:crypto');
 var z = require('zod');
-var configuration = require('./configuration-PXAE4-FP.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
 
 const TeamScopeSchema = z.z.object({
   serverUrl: z.z.string(),

package/dist/{context-BpEYcuLv.mjs → context-DjfqLWzE.mjs}

@@ -3,7 +3,7 @@ import { constants } from 'node:fs';
 import { isAbsolute, join, dirname } from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
-import { n as normalizeHttpEndpoint, c as configuration } from './configuration-CiBUH72C.mjs';
+import { n as normalizeHttpEndpoint, c as configuration } from './configuration-D2v3puap.mjs';
 
 const TeamScopeSchema = z.object({
   serverUrl: z.string(),

package/dist/{controlClient-DzmCQrY_.mjs → controlClient-BMUJfUeF.mjs}

@@ -1,6 +1,6 @@
-import { l as logger } from './logger-8dtZPn3n.mjs';
-import { readDaemonState, clearDaemonState } from './persistence-C_xFQLsD.mjs';
-import { c as configuration } from './configuration-CiBUH72C.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
+import { readDaemonState, clearDaemonState } from './persistence-B9LmhAE2.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
 
 function daemonControlHeaders(controlToken) {
   return {
@@ -123,6 +123,13 @@ async function notifyDaemonTurnEvent(sessionId, event) {
 async function notifyDaemonBackgroundTasks(sessionId, backgroundTasks) {
   return daemonPost("/session-event", { sessionId, event: "background_tasks", backgroundTasks });
 }
+function reportRateLimitsToDaemon(report) {
+  void daemonPost("/rate-limits", report).then((result) => {
+    if (result?.error) logger.debug(`[CONTROL CLIENT] rate-limits not recorded: ${result.error}`);
+  }).catch((error) => {
+    logger.debug("[CONTROL CLIENT] rate-limits failed:", error);
+  });
+}
 function reportSessionEditToDaemon(edit) {
   void daemonPost("/session-edit", edit).then((result) => {
     if (result?.error) logger.debug(`[CONTROL CLIENT] session-edit not recorded: ${result.error}`);
@@ -151,8 +158,8 @@ async function pushClipboardViaDaemon(text, terminalId) {
   }
   return result;
 }
-async function pushFilePreviewViaDaemon(terminalId, path, mode = "file") {
-  const result = await daemonPost("/file-preview", { terminalId, path, mode });
+async function pushFilePreviewViaDaemon(terminalId, path, mode = "file", intent) {
+  const result = await daemonPost("/file-preview", { terminalId, path, mode, ...intent ? { intent } : {} });
   if (result?.error) return { delivered: false, error: result.error };
   return { delivered: result?.delivered === true, ...result?.delivered === true ? {} : { error: "preview was not delivered" } };
 }
@@ -257,4 +264,4 @@ async function waitForProcessDeath(pid, timeout) {
   throw new Error("Process did not die within timeout");
 }
 
-export { stopDaemon as a, pushFilePreviewViaDaemon as b, checkIfDaemonRunningAndCleanupStaleState as c, setTerminalTitleViaDaemon as d, spawnDaemonSession as e, listDaemonPeers as f, reportSessionEditToDaemon as g, notifyDaemonTurnEvent as h, isDaemonRunningCurrentlyInstalledHappyVersion as i, notifyDaemonBackgroundTasks as j, notifyDaemonSessionEvent as k, listDaemonSessions as l, notifyDaemonClaudeAuthFailed as m, notifyDaemonSessionStarted as n, cleanupDaemonState as o, pushClipboardViaDaemon as p, resumeDaemonSession as r, stopDaemonSession as s };
+export { stopDaemon as a, pushFilePreviewViaDaemon as b, checkIfDaemonRunningAndCleanupStaleState as c, setTerminalTitleViaDaemon as d, spawnDaemonSession as e, listDaemonPeers as f, resumeDaemonSession as g, reportSessionEditToDaemon as h, isDaemonRunningCurrentlyInstalledHappyVersion as i, notifyDaemonTurnEvent as j, notifyDaemonBackgroundTasks as k, listDaemonSessions as l, notifyDaemonSessionEvent as m, notifyDaemonSessionStarted as n, notifyDaemonClaudeAuthFailed as o, pushClipboardViaDaemon as p, cleanupDaemonState as q, reportRateLimitsToDaemon as r, stopDaemonSession as s };

package/dist/{controlClient-DI-Er-Ww.cjs → controlClient-CmnHGcyl.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var logger = require('./logger-B1k7eZnq.cjs');
-var persistence = require('./persistence-d3ZyER6o.cjs');
-var configuration = require('./configuration-PXAE4-FP.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
+var persistence = require('./persistence-2Xp_o6x6.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
 
 function daemonControlHeaders(controlToken) {
   return {
@@ -125,6 +125,13 @@ async function notifyDaemonTurnEvent(sessionId, event) {
 async function notifyDaemonBackgroundTasks(sessionId, backgroundTasks) {
   return daemonPost("/session-event", { sessionId, event: "background_tasks", backgroundTasks });
 }
+function reportRateLimitsToDaemon(report) {
+  void daemonPost("/rate-limits", report).then((result) => {
+    if (result?.error) logger.logger.debug(`[CONTROL CLIENT] rate-limits not recorded: ${result.error}`);
+  }).catch((error) => {
+    logger.logger.debug("[CONTROL CLIENT] rate-limits failed:", error);
+  });
+}
 function reportSessionEditToDaemon(edit) {
   void daemonPost("/session-edit", edit).then((result) => {
     if (result?.error) logger.logger.debug(`[CONTROL CLIENT] session-edit not recorded: ${result.error}`);
@@ -153,8 +160,8 @@ async function pushClipboardViaDaemon(text, terminalId) {
   }
   return result;
 }
-async function pushFilePreviewViaDaemon(terminalId, path, mode = "file") {
-  const result = await daemonPost("/file-preview", { terminalId, path, mode });
+async function pushFilePreviewViaDaemon(terminalId, path, mode = "file", intent) {
+  const result = await daemonPost("/file-preview", { terminalId, path, mode, ...intent ? { intent } : {} });
   if (result?.error) return { delivered: false, error: result.error };
   return { delivered: result?.delivered === true, ...result?.delivered === true ? {} : { error: "preview was not delivered" } };
 }
@@ -271,6 +278,7 @@ exports.notifyDaemonSessionStarted = notifyDaemonSessionStarted;
 exports.notifyDaemonTurnEvent = notifyDaemonTurnEvent;
 exports.pushClipboardViaDaemon = pushClipboardViaDaemon;
 exports.pushFilePreviewViaDaemon = pushFilePreviewViaDaemon;
+exports.reportRateLimitsToDaemon = reportRateLimitsToDaemon;
 exports.reportSessionEditToDaemon = reportSessionEditToDaemon;
 exports.resumeDaemonSession = resumeDaemonSession;
 exports.setTerminalTitleViaDaemon = setTerminalTitleViaDaemon;

package/dist/{createSessionMetadata-B47GrTX6.mjs → createSessionMetadata-DU0bCg2m.mjs}

@@ -1,8 +1,8 @@
 import os from 'node:os';
 import { resolve } from 'node:path';
-import { c as configuration } from './configuration-CiBUH72C.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
-import { p as packageJson } from './package-tVYgFJoK.mjs';
+import { p as packageJson } from './package-BqwrPxL0.mjs';
 
 const SPAWN_ORIGIN_TAG_MAX = 24;
 function spawnOriginTags(env = process.env, flavor = void 0) {

package/dist/{createSessionMetadata-D04x6OMW.cjs → createSessionMetadata-DbfRBhRu.cjs}

@@ -2,9 +2,9 @@
 
 var os = require('node:os');
 var path = require('node:path');
-var configuration = require('./configuration-PXAE4-FP.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
 var projectPath = require('./projectPath-ChLhdOyt.cjs');
-var _package = require('./package-CC_txQ31.cjs');
+var _package = require('./package-C1XvUQFy.cjs');
 
 const SPAWN_ORIGIN_TAG_MAX = 24;
 function spawnOriginTags(env = process.env, flavor = void 0) {

package/dist/{deterministicJson-CKqT3awl.mjs → deterministicJson-D-WPUrZb.mjs}

@@ -1,23 +1,23 @@
-import { C as ContextUsageSchema } from './index-vVWpCoTr.mjs';
+import { C as ContextUsageSchema } from './index-B0HEEYGh.mjs';
 import { unlink, mkdir, open, rename } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
 import { constants } from 'node:fs';
 import { dirname } from 'node:path';
 import { z } from 'zod';
-import { T as TeamConnectionPreflightError, c as createTeamsClient } from './client-Do5CHQnZ.mjs';
-import { t as teamScopePath } from './context-BpEYcuLv.mjs';
-import { g as waitForSessionKey, e as sendUserMessage } from './sessionOps-BlMg1uAa.mjs';
+import { T as TeamConnectionPreflightError, c as createTeamsClient } from './client-CbK33y_s.mjs';
+import { t as teamScopePath } from './context-DjfqLWzE.mjs';
+import { g as waitForSessionKey, e as sendUserMessage } from './sessionOps-BnaEaOKs.mjs';
 import { T as TEAM_SKILL } from './resources-BdFBQi8r.mjs';
-import { T as TEAM_TOOL_NAMES, r as registerTeamsTools } from './tools-RvMKw7yx.mjs';
-import { A as AUTOMATION_TOOL_NAMES, r as registerAutomationTools } from './tools-gUjkPpCw.mjs';
-import { S as SESSION_PEER_TOOL_NAMES, r as registerSessionPeerTools, a as createSessionPeerToolExecutor } from './peerTools-C1cduHh1.mjs';
+import { T as TEAM_TOOL_NAMES, r as registerTeamsTools } from './tools-3X2z3YDe.mjs';
+import { c as createSelfReportState, A as AUTOMATION_TOOL_NAMES, r as registerAutomationTools, a as registerReportProgressTool, n as normalizeAttention, b as normalizePhase, d as normalizeProgress, s as shouldAcceptSelfReport } from './reportProgressTool-DnAD8wOa.mjs';
+import { S as SESSION_PEER_TOOL_NAMES, r as registerSessionPeerTools, a as createSessionPeerToolExecutor } from './peerTools-CeCe-3lk.mjs';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { createServer } from 'node:http';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import { l as logger } from './logger-8dtZPn3n.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
 import { C as CLIPBOARD_TOOL_NAME, a as CLIPBOARD_TOOL_TITLE, b as CLIPBOARD_TOOL_DESCRIPTION, c as CLIPBOARD_MAX_BYTES } from './limits-DIo7rEBR.mjs';
-import { A as ASSISTANT_TOOL_NAMES, a as registerAssistantTools } from './assistantTools-BWfAV349.mjs';
-import { P as PREVIEW_TOOL_NAME, R as REPORT_PROGRESS_TOOL_NAME, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION, c as REPORT_PROGRESS_TOOL_TITLE, d as REPORT_PROGRESS_TOOL_DESCRIPTION } from './agentGuidance-CQuNlNx8.mjs';
+import { A as ASSISTANT_TOOL_NAMES, a as registerAssistantTools, c as checkDownloadTarget } from './downloadTarget-DjSwMHun.mjs';
+import { P as PREVIEW_TOOL_NAME, R as REPORT_PROGRESS_TOOL_NAME, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION, c as PREVIEW_DOWNLOAD_PARAM_DESCRIPTION } from './agentGuidance-BDYt2Qy2.mjs';
 import { c as checkPreviewPath } from './previewPath-CXN4Vag0.mjs';
 import { createHash } from 'crypto';
 
@@ -128,29 +128,6 @@ This session is now connected as the team lead. Call team_inspect to read the au
   };
 }
 
-const SELF_REPORT_MIN_INTERVAL_MS = 30 * 1e3;
-const SELF_REPORT_FRESH_MS = 15 * 60 * 1e3;
-const PROGRESS_MAX_CHARS = 200;
-function createSelfReportState() {
-  return { lastAcceptedAt: 0 };
-}
-function shouldAcceptSelfReport(state, now, attention) {
-  if (state.lastAcceptedAt === 0) return true;
-  if (attention !== void 0 && attention !== state.lastAttention) return true;
-  return now - state.lastAcceptedAt >= SELF_REPORT_MIN_INTERVAL_MS;
-}
-function isSelfReportFresh(state, now) {
-  if (state.lastAcceptedAt === 0) return false;
-  const age = now - state.lastAcceptedAt;
-  return age >= 0 && age < SELF_REPORT_FRESH_MS;
-}
-function normalizeProgress(value) {
-  if (typeof value !== "string") return null;
-  const flat = value.replace(/\s+/g, " ").trim();
-  if (!flat) return null;
-  return flat.length > PROGRESS_MAX_CHARS ? flat.slice(0, PROGRESS_MAX_CHARS) : flat;
-}
-
 function createMcpServer(handlers, options, sessionId, client) {
   const mcp = new McpServer({
     name: "Very Happy Tools",
@@ -222,17 +199,20 @@ function createMcpServer(handlers, options, sessionId, client) {
     title: PREVIEW_TOOL_TITLE,
     inputSchema: {
       path: z.string().describe("Absolute path (or ~/\u2026) of the file to show the user"),
-      mode: z.enum(["file", "diff"]).optional().describe("'file' (default) renders the file; 'diff' is reserved and currently falls back to 'file'")
+      mode: z.enum(["file", "diff"]).optional().describe("'file' (default) renders the file; 'diff' is reserved and currently falls back to 'file'"),
+      // B-562: optional; old web clients ignore the resulting intent and just preview.
+      download: z.boolean().optional().describe(PREVIEW_DOWNLOAD_PARAM_DESCRIPTION)
     }
   }, async (args) => {
-    const response = await handlers.openPreview(args.path, args.mode ?? "file");
+    const response = await handlers.openPreview(args.path, args.mode ?? "file", args.download === true);
     logger.debug("[happyMCP] open_preview response:", response);
     if (response.delivered) {
+      const target = response.resolved ?? args.path;
       return {
         content: [{
           type: "text",
           // 明说不保证用户看到了——否则 claude 会基于「已预览」做后续推断（spec 风险 8）
-          text: `Asked the user's open web client(s) to preview ${response.resolved ?? args.path}. This does not confirm they looked at it.`
+          text: (args.download === true ? `Asked the user's open web client(s) to offer ${target} for download. This does not confirm they downloaded it.` : `Asked the user's open web client(s) to preview ${target}. This does not confirm they looked at it.`) + (response.note ? ` ${response.note}` : "")
         }],
         isError: false
       };
@@ -242,15 +222,8 @@ function createMcpServer(handlers, options, sessionId, client) {
       isError: true
     };
   });
-  mcp.registerTool(REPORT_PROGRESS_TOOL_NAME, {
-    description: REPORT_PROGRESS_TOOL_DESCRIPTION,
-    title: REPORT_PROGRESS_TOOL_TITLE,
-    inputSchema: {
-      progress: z.string().describe("One short line describing the current state of this task"),
-      attention: z.enum(["none", "review", "blocked"]).optional().describe("'blocked' = cannot proceed without the user; 'review' = wants their eyes; 'none' = ordinary progress")
-    }
-  }, async (args) => {
-    const response = await handlers.reportProgress(args.progress, args.attention ?? "none");
+  registerReportProgressTool(mcp, async (args) => {
+    const response = await handlers.reportProgress(String(args.progress ?? ""), normalizeAttention(args.attention), normalizePhase(args.phase));
     logger.debug("[happyMCP] report_progress response:", response);
     if (response.accepted) {
       return { content: [{ type: "text", text: "Board updated." }], isError: false };
@@ -265,39 +238,50 @@ function createMcpServer(handlers, options, sessionId, client) {
   }
   return mcp;
 }
+function withoutPhase(board) {
+  if (!board) return {};
+  const { phase: _phase, ...rest } = board;
+  return rest;
+}
 async function startHappyServer(client, options) {
   logger.debug(`[happyMCP] server:start sessionId=${client.sessionId} assistant=${!!options?.assistant}`);
   const selfReportState = options?.selfReportState ?? createSelfReportState();
   const handlers = {
-    openPreview: async (path, mode) => {
+    openPreview: async (path, mode, download = false) => {
       const verdict = checkPreviewPath(path);
       if (verdict.deniedReason) {
         logger.debug(`[happyMCP] open_preview denied: ${verdict.deniedReason}`);
         return { delivered: false, error: verdict.deniedReason };
       }
+      const target = download ? await checkDownloadTarget(verdict.resolved) : null;
+      if (target?.error) return { delivered: false, error: target.error };
       try {
-        const result = client.pushFilePreview(verdict.resolved, mode);
-        return { delivered: result.delivered, resolved: verdict.resolved, error: result.error };
+        const result = client.pushFilePreview(verdict.resolved, mode, download ? "download" : void 0);
+        return { delivered: result.delivered, resolved: verdict.resolved, error: result.error, note: target?.note ?? void 0 };
       } catch (error) {
         return { delivered: false, error: String(error) };
       }
     },
-    reportProgress: async (progress, attention) => {
+    reportProgress: async (progress, attention, phase) => {
       const text = normalizeProgress(progress);
       if (!text) {
         return { accepted: false, error: "progress must be a non-empty one-line string" };
       }
       const now = Date.now();
-      if (!shouldAcceptSelfReport(selfReportState, now, attention)) {
+      if (!shouldAcceptSelfReport(selfReportState, now, attention, phase)) {
         return { accepted: false };
       }
       selfReportState.lastAcceptedAt = now;
       selfReportState.lastAttention = attention;
+      selfReportState.lastPhase = phase;
       try {
         client.updateMetadata((metadata) => ({
           ...metadata,
           board: {
-            ...metadata?.board,
+            // B-556: a report without phase must not keep the previous one
+            // (a stale label next to fresh text); taskId etc. are kept.
+            ...withoutPhase(metadata?.board),
+            ...phase ? { phase } : {},
             attention,
             progress: text,
             analyzedAt: now,
@@ -499,4 +483,4 @@ function hashObject(obj, options, encoding = "hex") {
   return createHash("sha256").update(jsonString).digest(encoding);
 }
 
-export { createSelfReportState as c, hashObject as h, isSelfReportFresh as i, startHappyServer as s };
+export { hashObject as h, startHappyServer as s };

package/dist/{deterministicJson-BM8e8QwP.cjs → deterministicJson-Dp3TVyap.cjs}

@@ -1,25 +1,25 @@
 'use strict';
 
-var index = require('./index-DqlyNgt4.cjs');
+var index = require('./index-C9hI8a10.cjs');
 var promises = require('node:fs/promises');
 var node_crypto = require('node:crypto');
 var node_fs = require('node:fs');
 var path = require('node:path');
 var z = require('zod');
-var client = require('./client-C1GAIJ04.cjs');
-var context = require('./context-DhvXl1oC.cjs');
-var sessionOps = require('./sessionOps-HuoMXcIZ.cjs');
+var client = require('./client-JISJx2f-.cjs');
+var context = require('./context-BFUpYT39.cjs');
+var sessionOps = require('./sessionOps-DOyy4gkY.cjs');
 var resources = require('./resources-JDPugcDq.cjs');
-var tools = require('./tools-D7UeLMZ7.cjs');
-var tools$1 = require('./tools-BTBgpiRc.cjs');
-var peerTools = require('./peerTools-CqIcCEIg.cjs');
+var tools = require('./tools-IJ0TAcJs.cjs');
+var reportProgressTool = require('./reportProgressTool-B-Rcy0s3.cjs');
+var peerTools = require('./peerTools-DPvbcs8V.cjs');
 var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
 var node_http = require('node:http');
 var streamableHttp_js = require('@modelcontextprotocol/sdk/server/streamableHttp.js');
-var logger = require('./logger-B1k7eZnq.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 var limits = require('./limits-C-a7gr04.cjs');
-var assistantTools = require('./assistantTools-D3cZvgUX.cjs');
-var agentGuidance = require('./agentGuidance-B5NATuFa.cjs');
+var downloadTarget = require('./downloadTarget-CiQqRIc-.cjs');
+var agentGuidance = require('./agentGuidance-BtBx2xxE.cjs');
 var previewPath = require('./previewPath-B0rBdhy1.cjs');
 var crypto = require('crypto');
 
@@ -130,36 +130,13 @@ This session is now connected as the team lead. Call team_inspect to read the au
   };
 }
 
-const SELF_REPORT_MIN_INTERVAL_MS = 30 * 1e3;
-const SELF_REPORT_FRESH_MS = 15 * 60 * 1e3;
-const PROGRESS_MAX_CHARS = 200;
-function createSelfReportState() {
-  return { lastAcceptedAt: 0 };
-}
-function shouldAcceptSelfReport(state, now, attention) {
-  if (state.lastAcceptedAt === 0) return true;
-  if (attention !== void 0 && attention !== state.lastAttention) return true;
-  return now - state.lastAcceptedAt >= SELF_REPORT_MIN_INTERVAL_MS;
-}
-function isSelfReportFresh(state, now) {
-  if (state.lastAcceptedAt === 0) return false;
-  const age = now - state.lastAcceptedAt;
-  return age >= 0 && age < SELF_REPORT_FRESH_MS;
-}
-function normalizeProgress(value) {
-  if (typeof value !== "string") return null;
-  const flat = value.replace(/\s+/g, " ").trim();
-  if (!flat) return null;
-  return flat.length > PROGRESS_MAX_CHARS ? flat.slice(0, PROGRESS_MAX_CHARS) : flat;
-}
-
 function createMcpServer(handlers, options, sessionId, client) {
   const mcp = new mcp_js.McpServer({
     name: "Very Happy Tools",
     version: "1.0.0"
   });
   tools.registerTeamsTools(mcp, sessionId);
-  tools$1.registerAutomationTools(mcp);
+  reportProgressTool.registerAutomationTools(mcp);
   if (client) peerTools.registerSessionPeerTools(mcp, peerTools.createSessionPeerToolExecutor(client));
   mcp.registerTool("change_title", {
     description: "Change the title of the current chat session",
@@ -224,17 +201,20 @@ function createMcpServer(handlers, options, sessionId, client) {
     title: agentGuidance.PREVIEW_TOOL_TITLE,
     inputSchema: {
       path: z.z.string().describe("Absolute path (or ~/\u2026) of the file to show the user"),
-      mode: z.z.enum(["file", "diff"]).optional().describe("'file' (default) renders the file; 'diff' is reserved and currently falls back to 'file'")
+      mode: z.z.enum(["file", "diff"]).optional().describe("'file' (default) renders the file; 'diff' is reserved and currently falls back to 'file'"),
+      // B-562: optional; old web clients ignore the resulting intent and just preview.
+      download: z.z.boolean().optional().describe(agentGuidance.PREVIEW_DOWNLOAD_PARAM_DESCRIPTION)
     }
   }, async (args) => {
-    const response = await handlers.openPreview(args.path, args.mode ?? "file");
+    const response = await handlers.openPreview(args.path, args.mode ?? "file", args.download === true);
     logger.logger.debug("[happyMCP] open_preview response:", response);
     if (response.delivered) {
+      const target = response.resolved ?? args.path;
       return {
         content: [{
           type: "text",
           // 明说不保证用户看到了——否则 claude 会基于「已预览」做后续推断（spec 风险 8）
-          text: `Asked the user's open web client(s) to preview ${response.resolved ?? args.path}. This does not confirm they looked at it.`
+          text: (args.download === true ? `Asked the user's open web client(s) to offer ${target} for download. This does not confirm they downloaded it.` : `Asked the user's open web client(s) to preview ${target}. This does not confirm they looked at it.`) + (response.note ? ` ${response.note}` : "")
         }],
         isError: false
       };
@@ -244,15 +224,8 @@ function createMcpServer(handlers, options, sessionId, client) {
       isError: true
     };
   });
-  mcp.registerTool(agentGuidance.REPORT_PROGRESS_TOOL_NAME, {
-    description: agentGuidance.REPORT_PROGRESS_TOOL_DESCRIPTION,
-    title: agentGuidance.REPORT_PROGRESS_TOOL_TITLE,
-    inputSchema: {
-      progress: z.z.string().describe("One short line describing the current state of this task"),
-      attention: z.z.enum(["none", "review", "blocked"]).optional().describe("'blocked' = cannot proceed without the user; 'review' = wants their eyes; 'none' = ordinary progress")
-    }
-  }, async (args) => {
-    const response = await handlers.reportProgress(args.progress, args.attention ?? "none");
+  reportProgressTool.registerReportProgressTool(mcp, async (args) => {
+    const response = await handlers.reportProgress(String(args.progress ?? ""), reportProgressTool.normalizeAttention(args.attention), reportProgressTool.normalizePhase(args.phase));
     logger.logger.debug("[happyMCP] report_progress response:", response);
     if (response.accepted) {
       return { content: [{ type: "text", text: "Board updated." }], isError: false };
@@ -263,43 +236,54 @@ function createMcpServer(handlers, options, sessionId, client) {
     };
   });
   if (options?.assistant && !process.env.VH_TEAM_SCOPE_FILE) {
-    assistantTools.registerAssistantTools(mcp);
+    downloadTarget.registerAssistantTools(mcp);
   }
   return mcp;
 }
+function withoutPhase(board) {
+  if (!board) return {};
+  const { phase: _phase, ...rest } = board;
+  return rest;
+}
 async function startHappyServer(client, options) {
   logger.logger.debug(`[happyMCP] server:start sessionId=${client.sessionId} assistant=${!!options?.assistant}`);
-  const selfReportState = options?.selfReportState ?? createSelfReportState();
+  const selfReportState = options?.selfReportState ?? reportProgressTool.createSelfReportState();
   const handlers = {
-    openPreview: async (path, mode) => {
+    openPreview: async (path, mode, download = false) => {
       const verdict = previewPath.checkPreviewPath(path);
       if (verdict.deniedReason) {
         logger.logger.debug(`[happyMCP] open_preview denied: ${verdict.deniedReason}`);
         return { delivered: false, error: verdict.deniedReason };
       }
+      const target = download ? await downloadTarget.checkDownloadTarget(verdict.resolved) : null;
+      if (target?.error) return { delivered: false, error: target.error };
       try {
-        const result = client.pushFilePreview(verdict.resolved, mode);
-        return { delivered: result.delivered, resolved: verdict.resolved, error: result.error };
+        const result = client.pushFilePreview(verdict.resolved, mode, download ? "download" : void 0);
+        return { delivered: result.delivered, resolved: verdict.resolved, error: result.error, note: target?.note ?? void 0 };
       } catch (error) {
         return { delivered: false, error: String(error) };
       }
     },
-    reportProgress: async (progress, attention) => {
-      const text = normalizeProgress(progress);
+    reportProgress: async (progress, attention, phase) => {
+      const text = reportProgressTool.normalizeProgress(progress);
       if (!text) {
         return { accepted: false, error: "progress must be a non-empty one-line string" };
       }
       const now = Date.now();
-      if (!shouldAcceptSelfReport(selfReportState, now, attention)) {
+      if (!reportProgressTool.shouldAcceptSelfReport(selfReportState, now, attention, phase)) {
         return { accepted: false };
       }
       selfReportState.lastAcceptedAt = now;
       selfReportState.lastAttention = attention;
+      selfReportState.lastPhase = phase;
       try {
         client.updateMetadata((metadata) => ({
           ...metadata,
           board: {
-            ...metadata?.board,
+            // B-556: a report without phase must not keep the previous one
+            // (a stale label next to fresh text); taskId etc. are kept.
+            ...withoutPhase(metadata?.board),
+            ...phase ? { phase } : {},
             attention,
             progress: text,
             analyzedAt: now,
@@ -403,9 +387,9 @@ async function startHappyServer(client, options) {
       agentGuidance.PREVIEW_TOOL_NAME,
       agentGuidance.REPORT_PROGRESS_TOOL_NAME,
       ...tools.TEAM_TOOL_NAMES,
-      ...tools$1.AUTOMATION_TOOL_NAMES,
+      ...reportProgressTool.AUTOMATION_TOOL_NAMES,
       ...peerTools.SESSION_PEER_TOOL_NAMES,
-      ...options?.assistant && !process.env.VH_TEAM_SCOPE_FILE ? assistantTools.ASSISTANT_TOOL_NAMES : []
+      ...options?.assistant && !process.env.VH_TEAM_SCOPE_FILE ? downloadTarget.ASSISTANT_TOOL_NAMES : []
     ],
     stop: () => {
       logger.logger.debug(`[happyMCP] server:stop sessionId=${client.sessionId}`);
@@ -501,7 +485,5 @@ function hashObject(obj, options, encoding = "hex") {
   return crypto.createHash("sha256").update(jsonString).digest(encoding);
 }
 
-exports.createSelfReportState = createSelfReportState;
 exports.hashObject = hashObject;
-exports.isSelfReportFresh = isSelfReportFresh;
 exports.startHappyServer = startHappyServer;

package/dist/{doctor-CSgzbG5L.mjs → doctor-BlXXyQ1L.mjs}

@@ -1,12 +1,12 @@
 import chalk from 'chalk';
-import { c as configuration } from './configuration-CiBUH72C.mjs';
-import { readSettings, readCredentials, readDaemonState } from './persistence-C_xFQLsD.mjs';
-import { c as checkIfDaemonRunningAndCleanupStaleState } from './controlClient-DzmCQrY_.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
+import { readSettings, readCredentials, readDaemonState } from './persistence-B9LmhAE2.mjs';
+import { c as checkIfDaemonRunningAndCleanupStaleState } from './controlClient-BMUJfUeF.mjs';
 import { findAllHappyProcesses } from './doctor-BPkYWSuq.mjs';
 import { statSync, realpathSync, existsSync, readdirSync } from 'node:fs';
 import { isAbsolute, resolve, dirname, basename, delimiter, join } from 'node:path';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
-import { p as packageJson } from './package-tVYgFJoK.mjs';
+import { p as packageJson } from './package-BqwrPxL0.mjs';
 import { s as shareableSettingsSummary, c as collectRuntimeReadiness, S as SUPPORTED_NODE_LABEL, r as resolveClaudeCredentialReadiness, a as toolProbeLabel, b as daemonReadiness, d as daemonEndpointsMatch } from './doctorReadiness-C208SMN9.mjs';
 import { c as credentialRelayProblem } from './authRelay-DSAvg1uv.mjs';
 import { d as deriveLocalCliUpdateSummary } from './cliUpdate-Y34VGe9Y.mjs';
@@ -310,8 +310,8 @@ ${typeLabels[type] || type}:`));
   }
   console.log(chalk.gray("  An external claude command is only needed for native terminal/mirror use."));
   try {
-    const { resolveAgentHomesForCli } = await import('./agentHome-DM0urHEI.mjs');
-    const { describeAgentHome } = await import('./index-OEGj3BxE.mjs');
+    const { resolveAgentHomesForCli } = await import('./agentHome-2IbIjKCa.mjs');
+    const { describeAgentHome } = await import('./index-DQplgo0W.mjs');
     const homes = await resolveAgentHomesForCli();
     console.log(chalk.green(`\u2713 Claude config dir: ${describeAgentHome(homes.claudeConfigDir)}`));
     console.log(chalk.green(`\u2713 Codex home: ${describeAgentHome(homes.codexHome)}`));

package/dist/{doctor-Cl6cqvok.cjs → doctor-CkJmdPbi.cjs}

@@ -1,14 +1,14 @@
 'use strict';
 
 var chalk = require('chalk');
-var configuration = require('./configuration-PXAE4-FP.cjs');
-var persistence = require('./persistence-d3ZyER6o.cjs');
-var controlClient = require('./controlClient-DI-Er-Ww.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
+var persistence = require('./persistence-2Xp_o6x6.cjs');
+var controlClient = require('./controlClient-CmnHGcyl.cjs');
 var doctor$1 = require('./doctor-u46qYYKX.cjs');
 var node_fs = require('node:fs');
 var path = require('node:path');
 var projectPath = require('./projectPath-ChLhdOyt.cjs');
-var _package = require('./package-CC_txQ31.cjs');
+var _package = require('./package-C1XvUQFy.cjs');
 var doctorReadiness = require('./doctorReadiness-BCZGcN0a.cjs');
 var authRelay = require('./authRelay-BdYkC1Po.cjs');
 var cliUpdate = require('./cliUpdate-DsKXPFYp.cjs');
@@ -312,8 +312,8 @@ ${typeLabels[type] || type}:`));
   }
   console.log(chalk.gray("  An external claude command is only needed for native terminal/mirror use."));
   try {
-    const { resolveAgentHomesForCli } = await Promise.resolve().then(function () { return require('./agentHome-DtsPKfTS.cjs'); });
-    const { describeAgentHome } = await Promise.resolve().then(function () { return require('./index-DaTxsAC3.cjs'); });
+    const { resolveAgentHomesForCli } = await Promise.resolve().then(function () { return require('./agentHome-KVWj6nCl.cjs'); });
+    const { describeAgentHome } = await Promise.resolve().then(function () { return require('./index-DEKIgZUo.cjs'); });
     const homes = await resolveAgentHomesForCli();
     console.log(chalk.green(`\u2713 Claude config dir: ${describeAgentHome(homes.claudeConfigDir)}`));
     console.log(chalk.green(`\u2713 Codex home: ${describeAgentHome(homes.codexHome)}`));