dsh-task-ledger 0.0.73 → 0.0.75

package/dist/host/routes.js

@@ -1,15 +1,15 @@
-import { getHomeAggregate, getFilterOptions, queryClosed } from './board.js';
-import { getSnapshot } from './services/home.service.js';
-import { getTrend } from './services/trend.service.js';
-import { claimTask, releaseTask } from './services/ledger-write.service.js';
-import { getTask, readTasks, readWorklog } from './repositories/ledger.repository.js';
-import { invalidate } from './repositories/cache.js';
-import { HandoffError, startCloseSession, } from './services/session.service.js';
-import { resolveWorkspaces } from './workspace.js';
+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 { resolveWorkspaces } from "./workspace.js";
 /** API 前缀（唯一真源就在这一处）。 */
-const API_PREFIX = '/api/task-ledger';
+const API_PREFIX = "/api/task-ledger";
 function sendJson(res, status, body) {
-    res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' });
+    res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
     res.end(JSON.stringify(body));
 }
 /** URL query → LedgerFilter（只认白名单键；limit/months 非正数忽略）。 */
@@ -17,7 +17,7 @@ function filterFromQuery(url) {
     const filter = {};
     const str = (key) => {
         const value = url.searchParams.get(key);
-        return value !== null && value !== '' ? value : null;
+        return value !== null && value !== "" ? value : null;
     };
     const int = (key) => {
         const raw = str(key);
@@ -26,28 +26,28 @@ function filterFromQuery(url) {
         const value = Number.parseInt(raw, 10);
         return Number.isFinite(value) && value > 0 ? value : undefined;
     };
-    const status = str('status');
+    const status = str("status");
     if (status !== null)
         filter.status = status;
-    const owner = str('owner');
+    const owner = str("owner");
     if (owner !== null)
         filter.owner = owner;
-    const category = str('category');
+    const category = str("category");
     if (category !== null)
         filter.category = category;
-    const tag = str('tag');
+    const tag = str("tag");
     if (tag !== null)
         filter.tag = tag;
-    const since = str('since');
+    const since = str("since");
     if (since !== null)
         filter.since = since;
-    const until = str('until');
+    const until = str("until");
     if (until !== null)
         filter.until = until;
-    const limit = int('limit');
+    const limit = int("limit");
     if (limit !== undefined)
         filter.limit = limit;
-    const months = int('months');
+    const months = int("months");
     if (months !== undefined)
         filter.months = months;
     return filter;
@@ -63,96 +63,124 @@ export function registerRoutes(webServer, deps) {
      */
     const registerRead = (path, handler) => {
         webServer.register({
-            kind: 'exact',
+            kind: "exact",
             path: `${API_PREFIX}${path}`,
             handler: async (req, res) => {
-                if (new URL(req.url ?? '/', 'http://localhost').searchParams.get('fresh') === '1')
+                if (new URL(req.url ?? "/", "http://localhost").searchParams.get("fresh") === "1")
                     invalidate();
                 await handler(req, res);
             },
         });
     };
-    registerRead('/workspaces', (_req, res) => { sendJson(res, 200, { workspaces: workspacesOf(deps) }); });
+    registerRead("/workspaces", (_req, res) => {
+        sendJson(res, 200, { workspaces: workspacesOf(deps) });
+    });
     // 首页一次拿全：在办快照 + 近 8 周趋势 + 四个自然周期计数（host 每个工作区只读一次）。
-    registerRead('/board', async (_req, res) => {
+    registerRead("/board", 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, {
+                ...home.snapshot,
+                closed: home.closed,
+                trend: home.trend,
+                degraded: home.degraded,
+            });
         }
         catch (error) {
-            sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+            sendJson(res, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
         }
     });
     // ── 拆端点（2026-10-18 步骤 4a：纯加法，旧 /board 全量原样保留）──
     // 快路径：首屏。只读 progress.json + git 身份，**不碰 history** ⇒ 耗时与历史总量解耦
     // （20 万条量级实测 527ms vs 合并端点 4.4s）。
-    registerRead('/board/snapshot', async (_req, res) => {
+    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) });
+            sendJson(res, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
         }
     });
     // 慢路径：趋势（近 8 周 + 四个自然周期）。读 history ⇒ 异步/按需拉，首屏不等它。
-    registerRead('/board/trend', async (_req, res) => {
+    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 });
+            sendJson(res, 200, {
+                closed: result.closed,
+                trend: result.trend,
+                degraded: result.degraded,
+            });
         }
         catch (error) {
-            sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+            sendJson(res, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
         }
     });
-    registerRead('/tasks', async (req, res) => {
+    registerRead("/tasks", async (req, res) => {
         try {
-            const filter = filterFromQuery(new URL(req.url ?? '/', 'http://localhost'));
+            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) {
-            sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+            sendJson(res, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
         }
     });
     // 任务详情 + 过程文档正文（query 传 ws/id，不做路径段解析——任务号含中文和连字符）。
-    registerRead('/task', async (req, res) => {
+    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');
+            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 参数' });
+                sendJson(res, 400, { error: "缺少 ws / id 参数" });
                 return;
             }
             const task = await getTask(workspace, taskId);
             if (task === null) {
-                sendJson(res, 404, { error: '任务不存在' });
+                sendJson(res, 404, { error: "任务不存在" });
                 return;
             }
             sendJson(res, 200, { task, worklog: await readWorklog(workspace, task) });
         }
         catch (error) {
-            sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+            sendJson(res, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
         }
     });
-    registerRead('/history', async (req, res) => {
+    registerRead("/history", async (req, res) => {
         try {
-            const filter = filterFromQuery(new URL(req.url ?? '/', 'http://localhost'));
+            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 });
+            sendJson(res, 200, {
+                records: result.records,
+                degraded: result.degraded,
+            });
         }
         catch (error) {
-            sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+            sendJson(res, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
         }
     });
-    registerRead('/filters', async (_req, res) => {
+    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) });
+            sendJson(res, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
         }
     });
 }
@@ -166,15 +194,15 @@ export function registerRoutes(webServer, deps) {
 export function registerWriteRoutes(webServer, deps) {
     const registerWrite = (path, action) => {
         webServer.register({
-            kind: 'exact',
+            kind: "exact",
             path: `${API_PREFIX}${path}`,
             handler: async (req, res) => {
-                if (req.method !== 'POST') {
-                    sendJson(res, 405, { error: '只支持 POST' });
+                if (req.method !== "POST") {
+                    sendJson(res, 405, { error: "只支持 POST" });
                     return;
                 }
                 if (!isTrustedRequest(req)) {
-                    sendJson(res, 403, { error: '只接受同源请求' });
+                    sendJson(res, 403, { error: "只接受同源请求" });
                     return;
                 }
                 let body;
@@ -182,21 +210,25 @@ export function registerWriteRoutes(webServer, deps) {
                     body = await readJsonBody(req);
                 }
                 catch (error) {
-                    const tooLarge = error instanceof Error && error.message === 'body-too-large';
-                    sendJson(res, tooLarge ? 413 : 400, { error: tooLarge ? '请求体过大' : '请求体不是合法 JSON' });
+                    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 参数' });
+                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: '工作区不存在或不含台账' });
+                    sendJson(res, 404, { error: "工作区不存在或不含台账" });
                     return;
                 }
                 try {
@@ -206,13 +238,15 @@ export function registerWriteRoutes(webServer, deps) {
                     sendJson(res, 200, notice ? { ok: true, notice } : { ok: true });
                 }
                 catch (error) {
-                    sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+                    sendJson(res, 500, {
+                        error: error instanceof Error ? error.message : String(error),
+                    });
                 }
             },
         });
     };
-    registerWrite('/claim', claimTask);
-    registerWrite('/release', releaseTask);
+    registerWrite("/claim", claimTask);
+    registerWrite("/release", releaseTask);
 }
 // ───────────────────────── 会话交接（按钮侧 · 写类端点） ─────────────────────────
 /** 写端点请求体上限：只收一小段用户留言，别让人往这塞文件。 */
@@ -225,11 +259,11 @@ async function readJsonBody(req) {
         const buffer = chunk;
         size += buffer.length;
         if (size > BODY_LIMIT)
-            throw new Error('body-too-large');
+            throw new Error("body-too-large");
         chunks.push(buffer);
     }
-    const text = Buffer.concat(chunks).toString('utf8');
-    if (text.trim() === '')
+    const text = Buffer.concat(chunks).toString("utf8");
+    if (text.trim() === "")
         return {};
     return JSON.parse(text);
 }
@@ -239,11 +273,13 @@ async function readJsonBody(req) {
  * 读端点保持现状（只读无副作用）；**会起会话的写端点必须过这道**。
  */
 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;
+    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';
+        return (address === "127.0.0.1" ||
+            address === "::1" ||
+            address === "::ffff:127.0.0.1");
     }
     if (host === undefined)
         return false;
@@ -264,15 +300,15 @@ function isTrustedRequest(req) {
  */
 export function registerSessionRoutes(webServer, deps) {
     webServer.register({
-        kind: 'exact',
+        kind: "exact",
         path: `${API_PREFIX}/close`,
         handler: async (req, res) => {
-            if (req.method !== 'POST') {
-                sendJson(res, 405, { error: '「结束任务」只支持 POST' });
+            if (req.method !== "POST") {
+                sendJson(res, 405, { error: "「结束任务」只支持 POST" });
                 return;
             }
             if (!isTrustedRequest(req)) {
-                sendJson(res, 403, { error: '只接受同源请求' });
+                sendJson(res, 403, { error: "只接受同源请求" });
                 return;
             }
             let body;
@@ -280,52 +316,65 @@ export function registerSessionRoutes(webServer, deps) {
                 body = await readJsonBody(req);
             }
             catch (error) {
-                const tooLarge = error instanceof Error && error.message === 'body-too-large';
-                sendJson(res, tooLarge ? 413 : 400, { error: tooLarge ? '请求体过大' : '请求体不是合法 JSON' });
+                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 参数' });
+            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 必须成对给出' });
+            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: '工作区不存在或不含台账' });
+                sendJson(res, 404, { error: "工作区不存在或不含台账" });
                 return;
             }
             try {
                 const result = await startCloseSession({
                     agents: deps.agents,
-                    presets: deps.getService('agentPresets'),
-                    defaultModel: deps.getService('agentDefaultModel'),
+                    presets: deps.getService("agentPresets"),
+                    defaultModel: deps.getService("agentDefaultModel"),
                 }, {
                     workspace,
                     taskId,
-                    message: str('message'),
-                    model: provider === '' ? undefined : { provider, model },
+                    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 });
+                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'
+                    const status = error.code === "task-missing"
                         ? 404
-                        : error.code === 'no-agents' || error.code === 'no-preset' || error.code === 'no-model' ? 503 : 500;
+                        : 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) });
+                sendJson(res, 500, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
             }
         },
     });
@@ -336,8 +385,8 @@ export function registerSessionRoutes(webServer, deps) {
  */
 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 面：会话不会出现在工作区列表里';
+    if (entity === undefined || typeof entity.attachSession !== "function") {
+        return "会话已建，但宿主该工作区没有 attachSession 面：会话不会出现在工作区列表里";
     }
     try {
         await entity.attachSession(sessionId);

package/dist/host/services/dates.js

@@ -3,7 +3,7 @@
  * 所有函数显式收 `now`——不自己读时钟，便于单测与跨时区复现。
  */
 function pad(value) {
-    return String(value).padStart(2, '0');
+    return String(value).padStart(2, "0");
 }
 /** Date → `YYYY-MM-DD`。 */
 export function ymd(date) {
@@ -11,7 +11,7 @@ export function ymd(date) {
 }
 /** 时刻串（`YYYY-MM-DD HH:mm:ss` / `YYYY-MM-DD`）→ 日期部分；解析不了回 null。 */
 export function dayOf(stamp) {
-    if (stamp === null || stamp === undefined || stamp === '')
+    if (stamp === null || stamp === undefined || stamp === "")
         return null;
     const day = String(stamp).slice(0, 10);
     return /^\d{4}-\d{2}-\d{2}$/.test(day) ? day : null;
@@ -49,9 +49,9 @@ export function inWindow(day, window) {
 }
 /** 「YYYY-MM-DD HH:mm:ss」→ 距今天数（解析不了 / 未来都按 0；不编造）。 */
 export function daysSince(stamp, now) {
-    if (stamp === null || stamp === undefined || stamp === '')
+    if (stamp === null || stamp === undefined || stamp === "")
         return null;
-    const parsed = new Date(String(stamp).replace(' ', 'T'));
+    const parsed = new Date(String(stamp).replace(" ", "T"));
     if (Number.isNaN(parsed.getTime()))
         return null;
     const days = Math.floor((now.getTime() - parsed.getTime()) / 86_400_000);

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

@@ -1,5 +1,8 @@
-import { type DegradedInfo } from '../errors.js';
-import type { FilterOptions, HistoryRecord, LedgerFilter, LedgerWorkspace, TrendScope } from '../types.js';
+/**
+ * 已结案列表 / 筛选项候选用例（history tab 与筛选控件用；非首屏，按需调用）。
+ */
+import { type DegradedInfo } from "../errors.js";
+import type { FilterOptions, HistoryRecord, LedgerFilter, LedgerWorkspace, TrendScope } from "../types.js";
 /** 已结案列表默认分页大小（「加载更多」= 调用方加大 limit 重取）。 */
 export declare const DEFAULT_HISTORY_LIMIT = 500;
 /**

package/dist/host/services/history.service.js

@@ -1,9 +1,9 @@
 /**
  * 已结案列表 / 筛选项候选用例（history tab 与筛选控件用；非首屏，按需调用）。
  */
-import { readHistory } from '../repositories/ledger.repository.js';
-import { settleWorkspaces } from '../errors.js';
-import { RECENT_MONTHS, readTrendScope } from './trend.service.js';
+import { settleWorkspaces } from "../errors.js";
+import { readHistory } from "../repositories/ledger.repository.js";
+import { RECENT_MONTHS, readTrendScope } from "./trend.service.js";
 /** 已结案列表默认分页大小（「加载更多」= 调用方加大 limit 重取）。 */
 export const DEFAULT_HISTORY_LIMIT = 500;
 /**
@@ -14,8 +14,9 @@ export const DEFAULT_HISTORY_LIMIT = 500;
  */
 export async function queryClosed(workspaces, filter = {}) {
     const windowed = { months: RECENT_MONTHS, ...filter };
-    const { data, degraded } = await settleWorkspaces(workspaces, 'history', (workspace) => readHistory(workspace, windowed), (rows) => rows.flat()
-        .sort((a, b) => String(b.created ?? b.time ?? '').localeCompare(String(a.created ?? a.time ?? '')))
+    const { data, degraded } = await settleWorkspaces(workspaces, "history", (workspace) => readHistory(workspace, windowed), (rows) => rows
+        .flat()
+        .sort((a, b) => String(b.created ?? b.time ?? "").localeCompare(String(a.created ?? a.time ?? "")))
         .slice(0, filter.limit ?? DEFAULT_HISTORY_LIMIT));
     return { records: data, degraded };
 }
@@ -25,19 +26,25 @@ export function collectFilterOptions(scopes) {
     const categories = new Set();
     const tags = new Set();
     const addTask = (task) => {
-        if (task.owner !== undefined && task.owner !== null && task.owner !== '')
+        if (task.owner !== undefined && task.owner !== null && task.owner !== "")
             owners.add(task.owner);
-        if (task.creator !== undefined && task.creator !== null && task.creator !== '')
+        if (task.creator !== undefined &&
+            task.creator !== null &&
+            task.creator !== "")
             owners.add(task.creator);
-        if (task.category !== undefined && task.category !== null && task.category !== '')
+        if (task.category !== undefined &&
+            task.category !== null &&
+            task.category !== "")
             categories.add(task.category);
         for (const tag of task.tags ?? [])
             tags.add(tag);
     };
     const addRecord = (record) => {
-        if (record.owner !== undefined && record.owner !== '')
+        if (record.owner !== undefined && record.owner !== "")
             owners.add(record.owner);
-        if (record.category !== undefined && record.category !== null && record.category !== '')
+        if (record.category !== undefined &&
+            record.category !== null &&
+            record.category !== "")
             categories.add(record.category);
         for (const tag of record.tags ?? [])
             tags.add(tag);
@@ -48,14 +55,18 @@ export function collectFilterOptions(scopes) {
         for (const record of scope.history)
             addRecord(record);
     }
-    const sorted = (values) => [...values].sort((a, b) => a.localeCompare(b, 'zh-Hans-CN'));
-    return { owners: sorted(owners), categories: sorted(categories), tags: sorted(tags) };
+    const sorted = (values) => [...values].sort((a, b) => a.localeCompare(b, "zh-Hans-CN"));
+    return {
+        owners: sorted(owners),
+        categories: sorted(categories),
+        tags: sorted(tags),
+    };
 }
 /**
  * 筛选项候选：在办（全量）+ 近 13 个月历史的去重值（owner / category / tag）。
  * 按需调用（/filters 路由），非首屏——历史侧在极端量级下是百毫秒级。单工作区坏 ⇒ 进 degraded。
  */
 export async function getFilterOptions(workspaces) {
-    const { data, degraded } = await settleWorkspaces(workspaces, 'history', readTrendScope, collectFilterOptions);
+    const { data, degraded } = await settleWorkspaces(workspaces, "history", readTrendScope, collectFilterOptions);
     return { options: data, degraded };
 }

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

@@ -1,5 +1,11 @@
-import { type DegradedInfo } from '../errors.js';
-import type { BoardSnapshot, LedgerWorkspace, TaskScope } from '../types.js';
+/**
+ * 首页**快路径**用例：在办快照 + 统计卡。
+ * 只读 progress.json（list）+ git 身份，**不碰 history**——首屏耗时与历史总量解耦
+ * （20 万条量级实测：527ms vs 合并端点 4.4s，见 docs/design/host-data-plane.md §四）。
+ * 慢路径（趋势）在 ./trend.service.ts；组合入口（/board 兼容全量）在 ../board.ts。
+ */
+import { type DegradedInfo } from "../errors.js";
+import type { BoardSnapshot, LedgerWorkspace, TaskScope } from "../types.js";
 /** 停滞阈值：进行中且 updated 至今满这么多天没更新（2026-10-19 拍板，显示级）。 */
 export declare const STALE_DAYS = 3;
 /** 逾期阈值：进行中且 started 至今满这么多天还没做完——中途更新不影响（2026-10-19 拍板 7 → 14 天）。 */