botmux 2.88.1 → 2.90.0

package/dist/dashboard/settings-write-applier.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Settings write applier — single source of truth for what
+ * `PUT /api/settings` (`dashboard.ts:460-498`) used to do inline.
+ *
+ * Lives in `src/dashboard/` so both:
+ *   - the existing browser-facing `PUT /api/settings` route
+ *   - the new HMAC-gated `PUT /__daemon/settings-write` route
+ * share the same validation + persistence path. Behaviour is byte-equivalent
+ * to the original inline implementation; the only change is that all IO is
+ * funnelled through `deps`, so tests don't touch `~/.botmux`.
+ */
+import type { DashboardGlobalConfig, GlobalConfig, MaintenanceConfig } from '../global-config.js';
+/**
+ * Snapshot returned by `resolveDashboardSettings` — mirrors the existing
+ * `ResolvedDashboardSettings` interface in `dashboard.ts:69-80`. We redeclare
+ * it locally rather than reaching across that boundary because the applier
+ * doesn't know how the host computes the snapshot (it just calls a closure).
+ */
+export interface ResolvedDashboardSettingsView {
+    publicReadOnly: boolean;
+    openTerminalInFeishu: boolean;
+    maintenance: MaintenanceConfig;
+    localDevInstall: boolean;
+}
+export type ParseMaintenanceResult = {
+    ok: true;
+    patch: MaintenanceConfig;
+} | {
+    ok: false;
+    error: string;
+};
+/** All IO this helper needs — injected so tests use mocks, production wires real impls. */
+export interface SettingsWriteApplierDeps {
+    /** Snapshot of `~/.botmux/config.json`. Used to look up the persisted autoUpdate state when the incoming patch doesn't change it. */
+    readGlobalConfig: () => GlobalConfig;
+    /** Atomic write of dashboard-level fields (publicReadOnly / openTerminalInFeishu). */
+    mergeDashboardConfig: (patch: DashboardGlobalConfig) => DashboardGlobalConfig;
+    /** Atomic write of global-level fields (repoPickerMode). */
+    mergeGlobalConfig: (patch: Partial<GlobalConfig>) => void;
+    /** Atomic write of maintenance-level fields (autoUpdate / autoRestart). */
+    mergeMaintenanceConfig: (patch: MaintenanceConfig) => MaintenanceConfig;
+    /** Set global UI locale (null = clear). Fans out to daemons via IPC. */
+    setGlobalLocale: (locale: 'zh' | 'en' | null) => void;
+    /** Type-strict body validator for the maintenance segment. */
+    parseMaintenancePatch: (body: unknown) => ParseMaintenanceResult;
+    /** True iff the current install is a source-checkout (auto-update unavailable). */
+    isLocalDevInstall: () => boolean;
+    /** Returns the post-merge view the response body echoes back to the caller. */
+    resolveDashboardSettings: () => ResolvedDashboardSettingsView;
+    /** Validate locale string. */
+    isLocale: (v: unknown) => v is 'zh' | 'en';
+    /** Fan out locale reload to all online daemons. */
+    reloadLocaleOnAllDaemons?: () => Promise<void>;
+}
+/** Production deps wiring — call once per dashboard process. */
+export declare function defaultSettingsWriteApplierDeps(resolveDashboardSettings: () => ResolvedDashboardSettingsView, reloadLocaleOnAllDaemons?: () => Promise<void>): SettingsWriteApplierDeps;
+export type ApplySettingsWriteResult = {
+    ok: true;
+    settings: ResolvedDashboardSettingsView;
+} | {
+    ok: false;
+    error: ApplySettingsWriteError;
+};
+/**
+ * Discrete error codes — every one of these MUST match the strings the old
+ * inline `PUT /api/settings` route returned, so callers (browser SPA, tests,
+ * PR2 Route B) see the same wire vocabulary they had before.
+ */
+export type ApplySettingsWriteError = 'invalid_publicReadOnly' | 'invalid_openTerminalInFeishu' | 'invalid_repoPickerMode' | 'invalid_whiteboard' | 'invalid_whiteboard_enabled' | 'invalid_lang' | 'invalid_maintenance' | 'local_dev_no_autoupdate' | 'autoupdate_required' | 'empty_patch' | string;
+/**
+ * Apply a parsed (object) settings patch. Returns success with the post-merge
+ * snapshot, or an error code string on validation failure.
+ *
+ * Behaviour mirrors `dashboard.ts:460-498` exactly:
+ *   - Validates `publicReadOnly` / `openTerminalInFeishu` are booleans.
+ *   - Validates `repoPickerMode` is 'all' | 'repos'.
+ *   - Validates `lang` is a valid locale or null.
+ *   - Defers maintenance validation to `parseMaintenancePatch` (returns its error verbatim).
+ *   - Forbids enabling `autoUpdate` on a local-dev install.
+ *   - Forbids enabling `autoRestart` unless `autoUpdate` is (or is being) enabled.
+ *   - Returns `empty_patch` when no fields changed.
+ */
+export declare function applySettingsWrite(body: unknown, deps: SettingsWriteApplierDeps): Promise<ApplySettingsWriteResult>;
+//# sourceMappingURL=settings-write-applier.d.ts.map

package/dist/dashboard/settings-write-applier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-write-applier.d.ts","sourceRoot":"","sources":["../../src/dashboard/settings-write-applier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAY7B;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC5C,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,2FAA2F;AAC3F,MAAM,WAAW,wBAAwB;IACvC,qIAAqI;IACrI,gBAAgB,EAAE,MAAM,YAAY,CAAC;IACrC,sFAAsF;IACtF,oBAAoB,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,qBAAqB,CAAC;IAC9E,4DAA4D;IAC5D,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAC1D,2EAA2E;IAC3E,sBAAsB,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,iBAAiB,CAAC;IACxE,wEAAwE;IACxE,eAAe,EAAE,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,8DAA8D;IAC9D,qBAAqB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,sBAAsB,CAAC;IACjE,mFAAmF;IACnF,iBAAiB,EAAE,MAAM,OAAO,CAAC;IACjC,+EAA+E;IAC/E,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;IAC9D,8BAA8B;IAC9B,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,IAAI,IAAI,GAAG,IAAI,CAAC;IAC3C,mDAAmD;IACnD,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,gEAAgE;AAChE,wBAAgB,+BAA+B,CAC7C,wBAAwB,EAAE,MAAM,6BAA6B,EAC7D,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC7C,wBAAwB,CAa1B;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,6BAA6B,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC/B,wBAAwB,GACxB,8BAA8B,GAC9B,wBAAwB,GACxB,oBAAoB,GACpB,4BAA4B,GAC5B,cAAc,GACd,qBAAqB,GACrB,yBAAyB,GACzB,qBAAqB,GACrB,aAAa,GACb,MAAM,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAgFnC"}

package/dist/dashboard/settings-write-applier.js

@@ -0,0 +1,119 @@
+/**
+ * Settings write applier — single source of truth for what
+ * `PUT /api/settings` (`dashboard.ts:460-498`) used to do inline.
+ *
+ * Lives in `src/dashboard/` so both:
+ *   - the existing browser-facing `PUT /api/settings` route
+ *   - the new HMAC-gated `PUT /__daemon/settings-write` route
+ * share the same validation + persistence path. Behaviour is byte-equivalent
+ * to the original inline implementation; the only change is that all IO is
+ * funnelled through `deps`, so tests don't touch `~/.botmux`.
+ */
+import { mergeDashboardConfig, mergeGlobalConfig, mergeMaintenanceConfig, parseMaintenancePatch, readGlobalConfig, setGlobalLocale, } from '../global-config.js';
+import { isLocale } from '../i18n/types.js';
+import { isLocalDevInstall } from '../utils/install-info.js';
+/** Production deps wiring — call once per dashboard process. */
+export function defaultSettingsWriteApplierDeps(resolveDashboardSettings, reloadLocaleOnAllDaemons) {
+    return {
+        readGlobalConfig,
+        mergeDashboardConfig,
+        mergeGlobalConfig,
+        mergeMaintenanceConfig,
+        setGlobalLocale,
+        parseMaintenancePatch,
+        isLocalDevInstall,
+        resolveDashboardSettings,
+        isLocale,
+        reloadLocaleOnAllDaemons,
+    };
+}
+/**
+ * Apply a parsed (object) settings patch. Returns success with the post-merge
+ * snapshot, or an error code string on validation failure.
+ *
+ * Behaviour mirrors `dashboard.ts:460-498` exactly:
+ *   - Validates `publicReadOnly` / `openTerminalInFeishu` are booleans.
+ *   - Validates `repoPickerMode` is 'all' | 'repos'.
+ *   - Validates `lang` is a valid locale or null.
+ *   - Defers maintenance validation to `parseMaintenancePatch` (returns its error verbatim).
+ *   - Forbids enabling `autoUpdate` on a local-dev install.
+ *   - Forbids enabling `autoRestart` unless `autoUpdate` is (or is being) enabled.
+ *   - Returns `empty_patch` when no fields changed.
+ */
+export async function applySettingsWrite(body, deps) {
+    const obj = body && typeof body === 'object' && !Array.isArray(body)
+        ? body
+        : {};
+    const patch = {};
+    if ('publicReadOnly' in obj) {
+        if (typeof obj.publicReadOnly !== 'boolean') {
+            return { ok: false, error: 'invalid_publicReadOnly' };
+        }
+        patch.publicReadOnly = obj.publicReadOnly;
+    }
+    if ('openTerminalInFeishu' in obj) {
+        if (typeof obj.openTerminalInFeishu !== 'boolean') {
+            return { ok: false, error: 'invalid_openTerminalInFeishu' };
+        }
+        patch.openTerminalInFeishu = obj.openTerminalInFeishu;
+    }
+    let touched = false;
+    if (Object.keys(patch).length > 0) {
+        deps.mergeDashboardConfig(patch);
+        touched = true;
+    }
+    if ('repoPickerMode' in obj) {
+        const v = obj.repoPickerMode;
+        if (v !== 'all' && v !== 'repos') {
+            return { ok: false, error: 'invalid_repoPickerMode' };
+        }
+        deps.mergeGlobalConfig({ repoPickerMode: v });
+        touched = true;
+    }
+    if ('whiteboard' in obj) {
+        const raw = obj.whiteboard;
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            return { ok: false, error: 'invalid_whiteboard' };
+        }
+        const wb = raw;
+        if (typeof wb.enabled !== 'boolean') {
+            return { ok: false, error: 'invalid_whiteboard_enabled' };
+        }
+        deps.mergeGlobalConfig({ whiteboard: { enabled: wb.enabled } });
+        touched = true;
+    }
+    if ('maintenance' in obj) {
+        const r = deps.parseMaintenancePatch(obj.maintenance);
+        if (!r.ok)
+            return { ok: false, error: r.error };
+        // Auto-update is npm-global only; refuse enabling it on a source checkout.
+        if (r.patch.autoUpdate?.enabled && deps.isLocalDevInstall()) {
+            return { ok: false, error: 'local_dev_no_autoupdate' };
+        }
+        // Auto-restart only applies an auto-update — it's meaningless without it.
+        if (r.patch.autoRestart?.enabled) {
+            const autoUpdateOn = r.patch.autoUpdate?.enabled
+                ?? deps.readGlobalConfig().maintenance?.autoUpdate?.enabled
+                ?? false;
+            if (!autoUpdateOn)
+                return { ok: false, error: 'autoupdate_required' };
+        }
+        deps.mergeMaintenanceConfig(r.patch);
+        touched = true;
+    }
+    if ('lang' in obj) {
+        const v = obj.lang;
+        if (v !== null && !deps.isLocale(v)) {
+            return { ok: false, error: 'invalid_lang' };
+        }
+        deps.setGlobalLocale(v === null ? null : v);
+        if (deps.reloadLocaleOnAllDaemons) {
+            await deps.reloadLocaleOnAllDaemons();
+        }
+        touched = true;
+    }
+    if (!touched)
+        return { ok: false, error: 'empty_patch' };
+    return { ok: true, settings: deps.resolveDashboardSettings() };
+}
+//# sourceMappingURL=settings-write-applier.js.map

package/dist/dashboard/settings-write-applier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-write-applier.js","sourceRoot":"","sources":["../../src/dashboard/settings-write-applier.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/web/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/dashboard/web/i18n.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAI1C,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAkiFtE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAM/E;AAED,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,SAAS,MAAM,EAAO,GAAG,eAAe,CAMxF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CASpI;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAGrH"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/dashboard/web/i18n.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAI1C,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AA4lFtE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAM/E;AAED,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,SAAS,MAAM,EAAO,GAAG,eAAe,CAMxF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CASpI;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAGrH"}

package/dist/dashboard/web/i18n.js

@@ -189,7 +189,7 @@ const zh = {
     'insights.filterFailed': '有失败',
     'insights.filterSlow': '有慢 span',
     'insights.loading': '分析中…',
-    'insights.loaded': '已分析 {count} 个会话',
+    'insights.loaded': '已加载 {count} 个会话',
     'insights.unavailable': '加载失败',
     'insights.listCount': '显示 {shown}/{total}',
     'insights.tabOverview': '总览',
@@ -210,12 +210,21 @@ const zh = {
     'insights.distSlow': '每会话慢 span',
     'insights.distAgentTime': 'agent 工作时长',
     'insights.distRw': '读改比',
+    'insights.distChurn': '代码改动行数',
+    'insights.distTrend': '按天趋势（近 4 周）',
+    'insights.distTrendSub': '每日会话数',
     'insights.distMedian': '中位 {v}',
     'insights.distEmpty': '当前筛选下没有可分析的会话。',
+    'insights.disclosure': '口径：耗时只算工具执行时间，已剔除等用户回复（问答/计划确认）的挂机时长，故不反映墙钟时长；Codex 会话的「读」多走 shell（exec_command），不计入「读」相，故其读改比会偏低甚至为 0；代码改动按 patch 解析，仅取每会话最活跃的若干文件，与 Claude 的结构化统计口径不同。跨工具的分布与比值仅供参考，不宜直接对比。',
+    'insights.rwNote': 'Codex 读多走 shell，未计入读相',
+    'insights.viewSessions': '按会话查看',
     'insights.hotHint': '跨会话复发信号——最该收敛的地方。',
     'insights.hotToolFailures': '工具报错热点',
     'insights.hotSlowSessions': '最慢的会话',
     'insights.hotProjects': '项目分布',
+    'insights.hotFiles': '文件复发热点',
+    'insights.hotCommands': '命令复发热点',
+    'insights.hotErrors': '报错复发热点',
     'insights.hotComingSoon': '文件 / 命令复发热点即将上线（需给引擎加跨会话聚合）。',
     'insights.hotSessionsCol': '会话',
     'insights.hotFailsCol': '失败',
@@ -228,6 +237,26 @@ const zh = {
     'insights.sortFails': '失败',
     'insights.sortSlow': '慢',
     'insights.sortAgent': '时长',
+    'insights.layoutCard': '卡片',
+    'insights.layoutTable': '表格',
+    'insights.colTitle': '会话',
+    'insights.colProject': '项目',
+    'insights.colTime': '时间',
+    'insights.paletteOpen': '跳转 ⌘K',
+    'insights.palettePlaceholder': '跳转到 tab 或搜索会话…',
+    'insights.paletteTabs': '视图',
+    'insights.paletteSessions': '会话',
+    'insights.paletteEmpty': '没有匹配项',
+    'insights.tabFlow': '行为流',
+    'insights.flowHint': '智能体把动作与时间花在哪些活动阶段，以及各会话的节奏分布。',
+    'insights.flowPipeline': '活动阶段流水线',
+    'insights.flowPipeSub': '研究 → 修改 → 运行 → 委派 → 讨论；上=动作数，下=耗时',
+    'insights.flowShares': '动作占比 vs 时间占比',
+    'insights.flowActShare': '动作占比',
+    'insights.flowTimeShare': '时间占比',
+    'insights.flowRhythm': '各会话节奏（按时长）',
+    'insights.subagents': '子代理',
+    'insights.subagentsHint': '本会话委派出去的子代理（Task/Agent），各自做了什么、跑了多久。',
     'insights.readsShort': '读',
     'insights.editsShort': '改',
     'insights.durShort': '时长',
@@ -1483,7 +1512,7 @@ const en = {
     'insights.filterFailed': 'Has failures',
     'insights.filterSlow': 'Has slow spans',
     'insights.loading': 'Analyzing…',
-    'insights.loaded': 'Analyzed {count} sessions',
+    'insights.loaded': 'Loaded {count} sessions',
     'insights.unavailable': 'Load failed',
     'insights.listCount': 'showing {shown}/{total}',
     'insights.tabOverview': 'Overview',
@@ -1504,12 +1533,21 @@ const en = {
     'insights.distSlow': 'Slow spans per session',
     'insights.distAgentTime': 'Agent working time',
     'insights.distRw': 'Read/write ratio',
+    'insights.distChurn': 'Code churn (lines)',
+    'insights.distTrend': 'Trend by day (last 4 weeks)',
+    'insights.distTrendSub': 'sessions / day',
     'insights.distMedian': 'median {v}',
     'insights.distEmpty': 'No analyzable sessions under the current filter.',
+    'insights.disclosure': 'Measurement note: durations count tool-execution time only and exclude time spent waiting for a user reply (question / plan approval), so they do not reflect wall-clock; Codex reads files mostly via shell (exec_command), not counted as "read", so its read/write ratio runs low or 0; code churn is parsed from patches and covers only each session\'s most active files. Cross-tool distributions and ratios are indicative only, not directly comparable.',
+    'insights.rwNote': 'Codex reads mostly via shell, not counted as reads',
+    'insights.viewSessions': 'View sessions',
     'insights.hotHint': 'Cross-session recurrence — where it pays to converge.',
     'insights.hotToolFailures': 'Tool failure hotspots',
     'insights.hotSlowSessions': 'Slowest sessions',
     'insights.hotProjects': 'Projects',
+    'insights.hotFiles': 'File recurrence',
+    'insights.hotCommands': 'Command recurrence',
+    'insights.hotErrors': 'Error recurrence',
     'insights.hotComingSoon': 'File / command recurrence hotspots coming soon (needs cross-session engine aggregation).',
     'insights.hotSessionsCol': 'sessions',
     'insights.hotFailsCol': 'fails',
@@ -1522,6 +1560,26 @@ const en = {
     'insights.sortFails': 'Failures',
     'insights.sortSlow': 'Slow',
     'insights.sortAgent': 'Duration',
+    'insights.layoutCard': 'Cards',
+    'insights.layoutTable': 'Table',
+    'insights.colTitle': 'Session',
+    'insights.colProject': 'Project',
+    'insights.colTime': 'Time',
+    'insights.paletteOpen': 'Jump ⌘K',
+    'insights.palettePlaceholder': 'Jump to a tab or search sessions…',
+    'insights.paletteTabs': 'Views',
+    'insights.paletteSessions': 'Sessions',
+    'insights.paletteEmpty': 'No matches',
+    'insights.tabFlow': 'Flow',
+    'insights.flowHint': 'Where the agent spends its actions and time across activity phases, and each session’s rhythm.',
+    'insights.flowPipeline': 'Activity-phase pipeline',
+    'insights.flowPipeSub': 'research → edit → run → delegate → discuss; top = actions, bottom = time',
+    'insights.flowShares': 'Action share vs time share',
+    'insights.flowActShare': 'Action share',
+    'insights.flowTimeShare': 'Time share',
+    'insights.flowRhythm': 'Per-session rhythm (by duration)',
+    'insights.subagents': 'Sub-agents',
+    'insights.subagentsHint': 'Sub-agents this session delegated to (Task/Agent) — what each did and how long it ran.',
     'insights.readsShort': 'read',
     'insights.editsShort': 'edit',
     'insights.durShort': 'dur',