dsh-task-ledger 0.0.113 → 0.0.114

package/dist/host/routes.d.ts

@@ -1,11 +1,13 @@
 /**
  * 数据面路由薄壳：只做协议（参数解析 + JSON 响应 + 错误转 500），
- * 一行业务逻辑都不多写——全部调 board / ledger-read 的方法（2026-10-17 定稿）。
+ * 一行业务逻辑都不多写——全部调 service（2026-10-17 定稿）。
  * 宿主事实（handler = 原始 Node req/res、发头后不抛错、重复 path 注册直接 throw）
  * 见 external/host-webserver.md。
+ *
+ * 2026-10-28 收敛：界面只有 8 个统计卡 + 在办列表 ⇒ 只注册 `/workspaces` 与 `/board/snapshot`。
+ * 详情 / 历史 / 筛选项 / 趋势 / 写动作的端点与实现已删除（要接回按 skill 方法重写，不复用旧直读逻辑）。
  */
 import type { IncomingMessage, ServerResponse } from "node:http";
-import { type AgentsLike } from "./services/session.service.js";
 import { type RegistryWorkspace } from "./workspace.js";
 /** 宿主 webServer.register 的最小面（WebRoute 形状见 external/host-webserver.md）。 */
 export interface WebServerLike {
@@ -23,26 +25,3 @@ export interface RouteDeps {
     readonly registry: WorkspaceRegistryLike;
 }
 export declare function registerRoutes(webServer: WebServerLike, deps: RouteDeps): void;
-/**
- * 注册认领 / 释放端点（2026-10-18 B 混合制：没有判断量的动作由 host 直跑脚本）。
- *
- * 这两条**会改磁盘上的台账文件**，所以和 `/close` 一样必须过同源守卫；
- * 成功后就地清该工作区读缓存，避免按钮点完还看到上一屏的 owner。
- */
-export declare function registerWriteRoutes(webServer: WebServerLike, deps: RouteDeps): void;
-export interface SessionRouteDeps {
-    readonly registry: WorkspaceRegistryLike;
-    /** 起会话的服务面；宿主缺就回 503 人话（端点照常注册，前端不用按版本分支）。 */
-    readonly agents: AgentsLike | undefined;
-    /** 惰性服务读取：`agentPresets` / `agentDefaultModel` 可能整条不存在，或被 ctx 的 inject 门挡住。 */
-    readonly getService: (name: string) => unknown;
-}
-/**
- * 注册「结束任务」端点：`POST /close`。
- *
- * 为什么只有这一条走会话（2026-10-18 用户拍板）：认领 / 释放没有判断量，host 直写即可；
- * **结束**要带用户留言、要模型读过程文档后写真摘要 —— 只能交给会话里的 Agent 做。
- *
- * 请求体：`{ ws, id, message?, provider?, model? }`；响应：`{ sessionId, warning? }`。
- */
-export declare function registerSessionRoutes(webServer: WebServerLike, deps: SessionRouteDeps): void;

package/dist/host/routes.js

@@ -1,10 +1,5 @@
-import { getFilterOptions, getHomeAggregate, queryClosed } from "./board.js";
 import { invalidate } from "./repositories/cache.js";
-import { getTask, readTasks, readWorklog, } from "./repositories/ledger.repository.js";
-import { getSnapshot } from "./services/home.service.js";
-import { claimTask, releaseTask } from "./services/ledger-write.service.js";
-import { HandoffError, startCloseSession, } from "./services/session.service.js";
-import { getTrend } from "./services/trend.service.js";
+import { getBoardHome } from "./services/stats.service.js";
 import { resolveWorkspaces } from "./workspace.js";
 /** API 前缀（唯一真源就在这一处）。 */
 const API_PREFIX = "/api/task-ledger";
@@ -12,75 +7,14 @@ function sendJson(res, status, body) {
     res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
     res.end(JSON.stringify(body));
 }
-/** 参数用错（不是台账坏）：回 400，不落到 500，也不下发给脚本去撞。 */
-class UsageError extends Error {
-}
-/** 身份形态（与脚本 `core/identity.UUID_RE` 同一口径）。 */
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-/**
- * URL query → LedgerFilter（只认白名单键；limit/months 非正数忽略）。
- *
- * 两条硬口径：
- * - `owner` **只收 uuid**，传名字直接 400 —— 名字筛走 `owner_name=<片段>`（脚本同一条规则）；
- * - `months` 与 `since/until` 互斥：给了 `months` 就忽略后两者（脚本会 Fail，别让 UI 一次踩两个）。
- */
-function filterFromQuery(url) {
-    const filter = {};
-    const str = (key) => {
-        const value = url.searchParams.get(key);
-        return value !== null && value !== "" ? value : null;
-    };
-    const int = (key) => {
-        const raw = str(key);
-        if (raw === null)
-            return undefined;
-        const value = Number.parseInt(raw, 10);
-        return Number.isFinite(value) && value > 0 ? value : undefined;
-    };
-    const status = str("status");
-    if (status !== null)
-        filter.status = status;
-    const owner = str("owner");
-    if (owner !== null) {
-        const key = owner.trim();
-        if (!UUID_RE.test(key))
-            throw new UsageError("owner 只收身份 uuid；按显示名模糊筛请用 owner_name=<片段>");
-        filter.owner = key;
-    }
-    const ownerName = str("owner_name");
-    if (ownerName !== null)
-        filter.ownerName = ownerName;
-    const category = str("category");
-    if (category !== null)
-        filter.category = category;
-    const tag = str("tag");
-    if (tag !== null)
-        filter.tag = tag;
-    const limit = int("limit");
-    if (limit !== undefined)
-        filter.limit = limit;
-    const months = int("months");
-    if (months !== undefined) {
-        filter.months = months;
-    }
-    else {
-        const since = str("since");
-        if (since !== null)
-            filter.since = since;
-        const until = str("until");
-        if (until !== null)
-            filter.until = until;
-    }
-    return filter;
-}
-/** 每请求重新解析工作区（registry 可能刚变；探测走 hasLedger()，微秒级，不缓存）。 */
+/** 每请求重新解析工作区（registry 可能刚变；`root` 探测是本地结构判定，微秒级）。 */
 function workspacesOf(deps) {
     return resolveWorkspaces(deps.registry.list());
 }
 export function registerRoutes(webServer, deps) {
     /**
      * 注册一个**读**端点：统一先看 `?fresh=1`（手动刷新 = 清缓存再算，别让用户按了刷新还看旧数）。
-     * 缓存 TTL 只有 1.5s，正常浏览照样吃缓存；写端点将来自己走写路径 + `invalidate()`，不走这里。
+     * 缓存 TTL 只有 1.5s，正常浏览照样吃缓存。
      */
     const registerRead = (path, handler) => {
         webServer.register({
@@ -93,19 +27,9 @@ export function registerRoutes(webServer, deps) {
             },
         });
     };
-    registerRead("/workspaces", (_req, res) => {
-        sendJson(res, 200, { workspaces: workspacesOf(deps) });
-    });
-    // 首页一次拿全：在办快照 + 近 8 周趋势 + 四个自然周期计数（host 每个工作区只读一次）。
-    registerRead("/board", async (_req, res) => {
+    registerRead("/workspaces", async (_req, res) => {
         try {
-            const home = await getHomeAggregate(workspacesOf(deps));
-            sendJson(res, 200, {
-                ...home.snapshot,
-                closed: home.closed,
-                trend: home.trend,
-                degraded: home.degraded,
-            });
+            sendJson(res, 200, { workspaces: await workspacesOf(deps) });
         }
         catch (error) {
             sendJson(res, 500, {
@@ -113,69 +37,10 @@ export function registerRoutes(webServer, deps) {
             });
         }
     });
-    // ── 拆端点（2026-10-18 步骤 4a：纯加法，旧 /board 全量原样保留）──
-    // 快路径：首屏。只读 progress.json + 本机身份，**不碰 history** ⇒ 耗时与历史总量解耦
-    // （20 万条量级实测 527ms vs 合并端点 4.4s）。
+    // 首屏一次拿全：8 卡（skill `stats` + 两次 `history --count-only`）+ 在办列表（`list --json`）。
     registerRead("/board/snapshot", async (_req, res) => {
         try {
-            const result = await getSnapshot(workspacesOf(deps));
-            sendJson(res, 200, { ...result.snapshot, degraded: result.degraded });
-        }
-        catch (error) {
-            sendJson(res, 500, {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    });
-    // 慢路径：趋势（近 8 周 + 四个自然周期）。读 history ⇒ 异步/按需拉，首屏不等它。
-    registerRead("/board/trend", async (_req, res) => {
-        try {
-            const result = await getTrend(workspacesOf(deps));
-            sendJson(res, 200, {
-                closed: result.closed,
-                trend: result.trend,
-                degraded: result.degraded,
-                warnings: result.warnings,
-            });
-        }
-        catch (error) {
-            sendJson(res, 500, {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    });
-    registerRead("/tasks", async (req, res) => {
-        try {
-            const filter = filterFromQuery(new URL(req.url ?? "/", "http://localhost"));
-            const perWorkspace = await Promise.all(workspacesOf(deps).map((workspace) => readTasks(workspace, filter)));
-            sendJson(res, 200, { tasks: perWorkspace.flat() });
-        }
-        catch (error) {
-            if (error instanceof UsageError) {
-                sendJson(res, 400, { error: error.message });
-                return;
-            }
-            sendJson(res, 500, {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    });
-    // 任务详情 + 过程文档正文（query 传 ws/id，不做路径段解析——任务号含中文和连字符）。
-    registerRead("/task", async (req, res) => {
-        try {
-            const url = new URL(req.url ?? "/", "http://localhost");
-            const workspace = workspacesOf(deps).find((item) => item.id === url.searchParams.get("ws"));
-            const taskId = url.searchParams.get("id");
-            if (workspace === undefined || taskId === null) {
-                sendJson(res, 400, { error: "缺少 ws / id 参数" });
-                return;
-            }
-            const task = await getTask(workspace, taskId);
-            if (task === null) {
-                sendJson(res, 404, { error: "任务不存在" });
-                return;
-            }
-            sendJson(res, 200, { task, worklog: await readWorklog(workspace, task) });
+            sendJson(res, 200, await getBoardHome(await workspacesOf(deps)));
         }
         catch (error) {
             sendJson(res, 500, {
@@ -183,246 +48,4 @@ export function registerRoutes(webServer, deps) {
             });
         }
     });
-    registerRead("/history", async (req, res) => {
-        try {
-            const filter = filterFromQuery(new URL(req.url ?? "/", "http://localhost"));
-            const result = await queryClosed(workspacesOf(deps), filter);
-            sendJson(res, 200, {
-                records: result.records,
-                degraded: result.degraded,
-            });
-        }
-        catch (error) {
-            if (error instanceof UsageError) {
-                sendJson(res, 400, { error: error.message });
-                return;
-            }
-            sendJson(res, 500, {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    });
-    registerRead("/filters", async (_req, res) => {
-        try {
-            const result = await getFilterOptions(workspacesOf(deps));
-            sendJson(res, 200, { ...result.options, degraded: result.degraded });
-        }
-        catch (error) {
-            sendJson(res, 500, {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    });
-}
-// ───────────────────────── 台账写端点（host 直写 · 不开会话） ─────────────────────────
-/**
- * 注册认领 / 释放端点（2026-10-18 B 混合制：没有判断量的动作由 host 直跑脚本）。
- *
- * 这两条**会改磁盘上的台账文件**，所以和 `/close` 一样必须过同源守卫；
- * 成功后就地清该工作区读缓存，避免按钮点完还看到上一屏的 owner。
- */
-export function registerWriteRoutes(webServer, deps) {
-    const registerWrite = (path, action) => {
-        webServer.register({
-            kind: "exact",
-            path: `${API_PREFIX}${path}`,
-            handler: async (req, res) => {
-                if (req.method !== "POST") {
-                    sendJson(res, 405, { error: "只支持 POST" });
-                    return;
-                }
-                if (!isTrustedRequest(req)) {
-                    sendJson(res, 403, { error: "只接受同源请求" });
-                    return;
-                }
-                let body;
-                try {
-                    body = await readJsonBody(req);
-                }
-                catch (error) {
-                    const tooLarge = error instanceof Error && error.message === "body-too-large";
-                    sendJson(res, tooLarge ? 413 : 400, {
-                        error: tooLarge ? "请求体过大" : "请求体不是合法 JSON",
-                    });
-                    return;
-                }
-                const fields = typeof body === "object" && body !== null
-                    ? body
-                    : {};
-                const str = (key) => typeof fields[key] === "string" ? fields[key] : "";
-                const workspaceId = str("ws");
-                const taskId = str("id");
-                if (workspaceId === "" || taskId === "") {
-                    sendJson(res, 400, { error: "缺少 ws / id 参数" });
-                    return;
-                }
-                const workspace = workspacesOf(deps).find((item) => item.id === workspaceId);
-                if (workspace === undefined) {
-                    sendJson(res, 404, { error: "工作区不存在或不含台账" });
-                    return;
-                }
-                try {
-                    const notice = await action(workspace, taskId);
-                    invalidate(workspace.id);
-                    // notice = 写成功但同步失败的人话：必须让界面看见，不能当成功静默吞掉
-                    sendJson(res, 200, notice ? { ok: true, notice } : { ok: true });
-                }
-                catch (error) {
-                    sendJson(res, 500, {
-                        error: error instanceof Error ? error.message : String(error),
-                    });
-                }
-            },
-        });
-    };
-    registerWrite("/claim", claimTask);
-    registerWrite("/release", releaseTask);
-}
-// ───────────────────────── 会话交接（按钮侧 · 写类端点） ─────────────────────────
-/** 写端点请求体上限：只收一小段用户留言，别让人往这塞文件。 */
-const BODY_LIMIT = 64 * 1024;
-/** 读请求体（宿主 handler 收原始 req，没有 body parser；超上限直接拒，不缓冲垃圾）。 */
-async function readJsonBody(req) {
-    const chunks = [];
-    let size = 0;
-    for await (const chunk of req) {
-        const buffer = chunk;
-        size += buffer.length;
-        if (size > BODY_LIMIT)
-            throw new Error("body-too-large");
-        chunks.push(buffer);
-    }
-    const text = Buffer.concat(chunks).toString("utf8");
-    if (text.trim() === "")
-        return {};
-    return JSON.parse(text);
-}
-/**
- * 同源守卫（architecture 不变量 6 的落地）：浏览器 fetch 必带与 Host 同源的 `Origin`；
- * 没有 `Origin` 的（本机脚本 / Desktop IPC）只放行回环地址。
- * 读端点保持现状（只读无副作用）；**会起会话的写端点必须过这道**。
- */
-function isTrustedRequest(req) {
-    const origin = typeof req.headers.origin === "string" ? req.headers.origin : undefined;
-    const host = typeof req.headers.host === "string" ? req.headers.host : undefined;
-    if (origin === undefined) {
-        const address = req.socket.remoteAddress;
-        return (address === "127.0.0.1" ||
-            address === "::1" ||
-            address === "::ffff:127.0.0.1");
-    }
-    if (host === undefined)
-        return false;
-    try {
-        return new URL(origin).host === host;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * 注册「结束任务」端点：`POST /close`。
- *
- * 为什么只有这一条走会话（2026-10-18 用户拍板）：认领 / 释放没有判断量，host 直写即可；
- * **结束**要带用户留言、要模型读过程文档后写真摘要 —— 只能交给会话里的 Agent 做。
- *
- * 请求体：`{ ws, id, message?, provider?, model? }`；响应：`{ sessionId, warning? }`。
- */
-export function registerSessionRoutes(webServer, deps) {
-    webServer.register({
-        kind: "exact",
-        path: `${API_PREFIX}/close`,
-        handler: async (req, res) => {
-            if (req.method !== "POST") {
-                sendJson(res, 405, { error: "「结束任务」只支持 POST" });
-                return;
-            }
-            if (!isTrustedRequest(req)) {
-                sendJson(res, 403, { error: "只接受同源请求" });
-                return;
-            }
-            let body;
-            try {
-                body = await readJsonBody(req);
-            }
-            catch (error) {
-                const tooLarge = error instanceof Error && error.message === "body-too-large";
-                sendJson(res, tooLarge ? 413 : 400, {
-                    error: tooLarge ? "请求体过大" : "请求体不是合法 JSON",
-                });
-                return;
-            }
-            const fields = typeof body === "object" && body !== null
-                ? body
-                : {};
-            const str = (key) => typeof fields[key] === "string" ? fields[key] : "";
-            const workspaceId = str("ws");
-            const taskId = str("id");
-            if (workspaceId === "" || taskId === "") {
-                sendJson(res, 400, { error: "缺少 ws / id 参数" });
-                return;
-            }
-            const provider = str("provider");
-            const model = str("model");
-            if ((provider === "") !== (model === "")) {
-                sendJson(res, 400, { error: "provider 与 model 必须成对给出" });
-                return;
-            }
-            const workspace = workspacesOf(deps).find((item) => item.id === workspaceId);
-            if (workspace === undefined) {
-                sendJson(res, 404, { error: "工作区不存在或不含台账" });
-                return;
-            }
-            try {
-                const result = await startCloseSession({
-                    agents: deps.agents,
-                    presets: deps.getService("agentPresets"),
-                    defaultModel: deps.getService("agentDefaultModel"),
-                }, {
-                    workspace,
-                    taskId,
-                    message: str("message"),
-                    model: provider === "" ? undefined : { provider, model },
-                });
-                const warning = (await attachSession(deps, workspaceId, result.sessionId)) ??
-                    result.warning;
-                sendJson(res, 200, warning === undefined
-                    ? { sessionId: result.sessionId }
-                    : { sessionId: result.sessionId, warning });
-            }
-            catch (error) {
-                if (error instanceof HandoffError) {
-                    const status = error.code === "task-missing"
-                        ? 404
-                        : error.code === "no-agents" ||
-                            error.code === "no-preset" ||
-                            error.code === "no-model"
-                            ? 503
-                            : 500;
-                    sendJson(res, status, { error: error.message, code: error.code });
-                    return;
-                }
-                sendJson(res, 500, {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-        },
-    });
-}
-/**
- * 会话归组（best effort）：登记进工作区 `sessionIds`，否则侧栏里找不到这个会话。
- * 缺失 / 失败都不算致命——会话本身已经建好、跳转可用，只如实回一条 warning。
- */
-async function attachSession(deps, workspaceId, sessionId) {
-    const entity = deps.registry.list().find((item) => item.id === workspaceId);
-    if (entity === undefined || typeof entity.attachSession !== "function") {
-        return "会话已建，但宿主该工作区没有 attachSession 面：会话不会出现在工作区列表里";
-    }
-    try {
-        await entity.attachSession(sessionId);
-        return undefined;
-    }
-    catch (error) {
-        return `会话已建，但没能挂进工作区列表：${error instanceof Error ? error.message : String(error)}`;
-    }
 }

package/dist/host/services/dates.d.ts

@@ -2,15 +2,12 @@
  * 日期口径（纯函数层，零 IO）：本机时区、周一为一周之始（与 skill 脚本同口径）。
  * 所有函数显式收 `now`——不自己读时钟，便于单测与跨时区复现。
  *
- * ⚠️ **台账存盘时间是 UTC**（skill `core/time.py::now`），`--json` 原样吐 UTC，
- * 只有人话输出才转查看者本地（`fmt_local`）。看板是给人看的 ⇒ 一律先按 UTC 解析出
- * 真实时刻，再按本机时区取日期（等价于脚本的 `fmt_local`）。否则会出现
- * 「脚本表格里是 10-17、看板却算进 10-16 那周」—— 两个界面同一条记录差一天。
+ * 现在只有「本周 / 上周结案数」用得到（`history --count-only` 的时间窗）。
+ * 台账时刻的解析与天数派生**已全部删除**：那些是 skill 算好的（`age_days` / `idle_days` /
+ * `waiting_days` 随 `list --json` 每行下发），插件不再保留第二套算法。
  */
 /** Date → `YYYY-MM-DD`（本机时区）。 */
 export declare function ymd(date: Date): string;
-/** 时刻串（`YYYY-MM-DD HH:mm:ss` / `YYYY-MM-DD`）→ 本机时区的日期；解析不了回 null。 */
-export declare function dayOf(stamp: string | null | undefined): string | null;
 /** 某日期所在周的周一（00:00）。 */
 export declare function mondayOf(day: string): Date;
 /**
@@ -22,21 +19,3 @@ export declare function weekWindow(offset: number, now: Date): {
     from: string;
     to: string;
 };
-/** 第 offset 月的起止（offset 0 = 本月，-1 = 上月；含边界）。
- *  同 {@link weekWindow}：本月只到今天，上月才是完整自然月。 */
-export declare function monthWindow(offset: number, now: Date): {
-    from: string;
-    to: string;
-};
-/** 日期是否落在 [from, to]（含边界，字符串比较即可——ISO 字典序即时间序）。 */
-export declare function inWindow(day: string | null, window: {
-    from: string;
-    to: string;
-}): boolean;
-/** 「YYYY-MM-DD HH:mm:ss」→ 距今天数（解析不了 / 未来都按 0；不编造）。 */
-export declare function daysSince(stamp: string | null | undefined, now: Date): number | null;
-/** 近 N 周的桶骨架（`{week, end}`，历史周 end=周日、当前周 end=今天）。 */
-export declare function buildWeeks(count: number, now: Date): readonly {
-    week: string;
-    end: string;
-}[];

package/dist/host/services/dates.js

@@ -2,10 +2,9 @@
  * 日期口径（纯函数层，零 IO）：本机时区、周一为一周之始（与 skill 脚本同口径）。
  * 所有函数显式收 `now`——不自己读时钟，便于单测与跨时区复现。
  *
- * ⚠️ **台账存盘时间是 UTC**（skill `core/time.py::now`），`--json` 原样吐 UTC，
- * 只有人话输出才转查看者本地（`fmt_local`）。看板是给人看的 ⇒ 一律先按 UTC 解析出
- * 真实时刻，再按本机时区取日期（等价于脚本的 `fmt_local`）。否则会出现
- * 「脚本表格里是 10-17、看板却算进 10-16 那周」—— 两个界面同一条记录差一天。
+ * 现在只有「本周 / 上周结案数」用得到（`history --count-only` 的时间窗）。
+ * 台账时刻的解析与天数派生**已全部删除**：那些是 skill 算好的（`age_days` / `idle_days` /
+ * `waiting_days` 随 `list --json` 每行下发），插件不再保留第二套算法。
  */
 function pad(value) {
     return String(value).padStart(2, "0");
@@ -14,31 +13,6 @@ function pad(value) {
 export function ymd(date) {
     return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
 }
-/**
- * 台账时刻串 → Date（带时刻的按 **UTC** 解析；纯日期串按本地日历，不涉及时区）。
- * 解析不了回 null，不猜。
- */
-function parseStamp(stamp) {
-    const text = stamp.trim().replace(" ", "T");
-    // 已带时区后缀（`Z` / `+08:00`）的不重复加，加了会二次偏移
-    const iso = /\d{1,2}:\d{2}/.test(text)
-        ? /(?:[zZ]|[+-]\d{2}:?\d{2})$/.test(text)
-            ? text
-            : `${text}Z`
-        : text;
-    const parsed = new Date(iso);
-    return Number.isNaN(parsed.getTime()) ? null : parsed;
-}
-/** 时刻串（`YYYY-MM-DD HH:mm:ss` / `YYYY-MM-DD`）→ 本机时区的日期；解析不了回 null。 */
-export function dayOf(stamp) {
-    if (stamp === null || stamp === undefined || stamp === "")
-        return null;
-    const text = String(stamp);
-    if (/^\d{4}-\d{2}-\d{2}$/.test(text.trim()))
-        return text.trim();
-    const parsed = parseStamp(text);
-    return parsed === null ? null : ymd(parsed);
-}
 /** 某日期所在周的周一（00:00）。 */
 export function mondayOf(day) {
     const date = new Date(`${day}T00:00:00`);
@@ -58,37 +32,3 @@ export function weekWindow(offset, now) {
     const last = offset === 0 ? now : sunday;
     return { from: ymd(monday), to: ymd(last < sunday ? last : sunday) };
 }
-/** 第 offset 月的起止（offset 0 = 本月，-1 = 上月；含边界）。
- *  同 {@link weekWindow}：本月只到今天，上月才是完整自然月。 */
-export function monthWindow(offset, now) {
-    const first = new Date(now.getFullYear(), now.getMonth() + offset, 1);
-    const last = new Date(now.getFullYear(), now.getMonth() + offset + 1, 0);
-    const end = offset === 0 ? now : last;
-    return { from: ymd(first), to: ymd(end < last ? end : last) };
-}
-/** 日期是否落在 [from, to]（含边界，字符串比较即可——ISO 字典序即时间序）。 */
-export function inWindow(day, window) {
-    return day !== null && day >= window.from && day <= window.to;
-}
-/** 「YYYY-MM-DD HH:mm:ss」→ 距今天数（解析不了 / 未来都按 0；不编造）。 */
-export function daysSince(stamp, now) {
-    if (stamp === null || stamp === undefined || stamp === "")
-        return null;
-    const parsed = parseStamp(String(stamp));
-    if (parsed === null)
-        return null;
-    const days = Math.floor((now.getTime() - parsed.getTime()) / 86_400_000);
-    return days > 0 ? days : 0;
-}
-/** 近 N 周的桶骨架（`{week, end}`，历史周 end=周日、当前周 end=今天）。 */
-export function buildWeeks(count, now) {
-    const weeks = [];
-    for (let offset = count - 1; offset >= 0; offset -= 1)
-        weeks.push(weekWindow(-offset, now).from);
-    return weeks.map((week, i) => {
-        const monday = new Date(`${week}T00:00:00`);
-        const sunday = new Date(monday);
-        sunday.setDate(sunday.getDate() + 6);
-        return { week, end: i === weeks.length - 1 ? ymd(now) : ymd(sunday) };
-    });
-}

package/dist/host/services/stats.service.d.ts

@@ -0,0 +1,7 @@
+import type { BoardHomePayload, LedgerWorkspace, StatsPayload } from "../types.js";
+/**
+ * 首屏一次拿全：8 卡 + 在办列表 + 工作区 + 身份 + 各工作区花名册。
+ * 三条读并行（`stats` / `list` / `owners`），各自缓存；一个工作区坏只进 degraded，其余照常。
+ */
+export declare function getBoardHome(workspaces: readonly LedgerWorkspace[], now?: Date): Promise<BoardHomePayload>;
+export declare function getBoardStats(workspaces: readonly LedgerWorkspace[], now?: Date): Promise<StatsPayload>;