dsh-task-ledger 0.0.113 → 0.0.114

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

@@ -0,0 +1,134 @@
+/**
+ * 8 个统计卡的用例（首屏唯一端点 `/board/stats`）。
+ *
+ * 数字真源全在 skill：每工作区跑 `stats --json`（在办各面）与两次
+ * `history --count-only`（本周 / 上周完成），本文件只做跨工作区求和与降级归集。
+ * 趋势图（近 8 周）没有 skill 方法，本轮不提供数据。
+ */
+import { codeOf, messageOf, settleWorkspaces, } from "../errors.js";
+import { getCurrentIdentity } from "../repositories/identity.repository.js";
+import { readOwners, readTasks } from "../repositories/ledger.repository.js";
+import { countClosed, readStats, } from "../repositories/stats.repository.js";
+import { weekWindow } from "./dates.js";
+/**
+ * 一个自然周的结案数（跨工作区求和）。
+ * 部分工作区失败 ⇒ 数字偏小，degraded 会带出去（界面标红，不装没看见）。
+ */
+async function countWeek(workspaces, window) {
+    const settled = await Promise.allSettled(workspaces.map((workspace) => countClosed(workspace, window)));
+    let done = 0;
+    let ok = 0;
+    const degraded = [];
+    settled.forEach((result, i) => {
+        if (result.status === "fulfilled") {
+            done += result.value.count;
+            ok += 1;
+            return;
+        }
+        const workspace = workspaces[i];
+        degraded.push({
+            workspaceId: workspace.id,
+            workspaceTitle: workspace.title,
+            op: "history",
+            code: codeOf(result.reason),
+            message: messageOf(result.reason),
+        });
+    });
+    return { done: ok === 0 && workspaces.length > 0 ? null : done, degraded };
+}
+/** 单工作区在办列表 + 本机身份（都经 skill：`list --json` / `whoami --json`）。 */
+async function readTaskScope(workspace) {
+    const [tasks, identity] = await Promise.all([
+        readTasks(workspace),
+        getCurrentIdentity(workspace),
+    ]);
+    return { workspace, tasks, identity };
+}
+/** 降级条目去重：stats 与 list 都挂时同一个工作区会报两遍。 */
+function dedupe(rows) {
+    const seen = new Set();
+    return rows.filter((row) => {
+        const key = `${row.workspaceId}\u0001${row.code}\u0001${row.message}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * 首屏一次拿全：8 卡 + 在办列表 + 工作区 + 身份 + 各工作区花名册。
+ * 三条读并行（`stats` / `list` / `owners`），各自缓存；一个工作区坏只进 degraded，其余照常。
+ */
+export async function getBoardHome(workspaces, now = new Date()) {
+    const [statsPayload, taskScope, ownerScope] = await Promise.all([
+        getBoardStats(workspaces, now),
+        settleWorkspaces(workspaces, "list", readTaskScope, (rows) => rows),
+        settleWorkspaces(workspaces, "owners", readOwners, (rows) => rows),
+    ]);
+    const identities = {};
+    const tasks = [];
+    for (const scope of taskScope.data) {
+        identities[scope.workspace.id] = scope.identity;
+        tasks.push(...scope.tasks);
+    }
+    return {
+        ...statsPayload,
+        workspaces,
+        tasks,
+        identities,
+        workspaceOwners: ownerScope.data,
+        degraded: dedupe([
+            ...statsPayload.degraded,
+            ...taskScope.degraded,
+            ...ownerScope.degraded,
+        ]),
+    };
+}
+export async function getBoardStats(workspaces, now = new Date()) {
+    const thisWeek = weekWindow(0, now);
+    const lastWeek = weekWindow(-1, now);
+    const [perWorkspace, thisWeekCounts, lastWeekCounts] = await Promise.all([
+        settleWorkspaces(workspaces, "list", readStats, (rows) => rows),
+        countWeek(workspaces, thisWeek),
+        countWeek(workspaces, lastWeek),
+    ]);
+    const sum = (pick) => perWorkspace.data.reduce((total, stats) => total + pick(stats), 0);
+    // 阈值由 skill 回显；没传过覆盖值 ⇒ 各工作区一致，取首个即可。
+    // 一个工作区都没有时给 0——那时所有计数也是 0，阈值文案没有实际含义。
+    const first = perWorkspace.data[0];
+    const stats = {
+        myActive: sum((item) => item.myDoing),
+        myOverdue: sum((item) => item.myOverdue),
+        myStale: sum((item) => item.myStale),
+        open: sum((item) => item.open),
+        doing: sum((item) => item.doing),
+        overdue: sum((item) => item.overdue),
+        stale: sum((item) => item.stale),
+        backlog: sum((item) => item.backlog),
+        staleDays: first?.staleDays ?? 0,
+        overdueDays: first?.overdueDays ?? 0,
+        backlogDays: first?.backlogDays ?? 0,
+        oldestOpenDays: perWorkspace.data.length === 0
+            ? null
+            : perWorkspace.data.reduce((max, item) => item.oldestOpenDays === null
+                ? max
+                : max === null
+                    ? item.oldestOpenDays
+                    : Math.max(max, item.oldestOpenDays), null),
+        weekDone: thisWeekCounts.done,
+        lastWeekDone: lastWeekCounts.done,
+        weekFrom: thisWeek.from,
+        weekTo: thisWeek.to,
+        lastWeekFrom: lastWeek.from,
+        lastWeekTo: lastWeek.to,
+    };
+    return {
+        at: now.toISOString(),
+        stats,
+        degraded: [
+            ...perWorkspace.degraded,
+            ...thisWeekCounts.degraded,
+            ...lastWeekCounts.degraded,
+        ],
+    };
+}

package/dist/host/skill/registration.d.ts

@@ -1,6 +1,3 @@
-/** 台账入口绝对路径（提示词里直接给「原样执行这一条」的命令用；与注册共用同一份目录知识）。
- *  它是按平台选二进制的薄包装，不需要系统装任何运行时。 */
-export declare const SKILL_SCRIPT: string;
 /** 宿主 ctx.skills.register 的最小面（外部事实文档的结构面）。 */
 export interface SkillRegistration {
     name: string;

package/dist/host/skill/registration.js

@@ -9,9 +9,6 @@ import { fileURLToPath } from "node:url";
 const SKILL_DIR = fileURLToPath(new URL("../../../skill", import.meta.url));
 /** SKILL.md 里指示脚本位置的占位符（注册时替换为绝对路径，模型据此找到脚本）。 */
 const SKILL_DIR_TOKEN = "<本 SKILL.md 所在目录>";
-/** 台账入口绝对路径（提示词里直接给「原样执行这一条」的命令用；与注册共用同一份目录知识）。
- *  它是按平台选二进制的薄包装，不需要系统装任何运行时。 */
-export const SKILL_SCRIPT = `${SKILL_DIR}/scripts/progress`;
 /** frontmatter 最小解析：只取 name / description（不引 YAML 库；值去首尾引号）。 */
 function parseFrontmatter(text) {
     const match = /^---\n([\s\S]*?)\n---/.exec(text);

package/dist/host/types.d.ts

@@ -4,7 +4,8 @@
  * 不 import 官方包（参考插件同款纪律：宿主 rc 接口会无声变，结构化声明 + external/ 文档坐标
  * 比绑死官方类型更稳）。
  */
-/** 一个活跃台账工作区：宿主 registry 条目 + 本地探测（ledger/progress.json 存在）。 */
+import type { DegradedInfo } from "./errors.js";
+/** 一个活跃台账工作区：宿主 registry 条目 + 本地探测（含 `ledger/`）。 */
 export interface LedgerWorkspace {
     /** 宿主工作区 id。 */
     readonly id: string;
@@ -13,7 +14,7 @@ export interface LedgerWorkspace {
     /** canonical 绝对路径（宿主已 realpath 归一；skill 脚本 --repo 直传它）。 */
     readonly path: string;
 }
-/** progress.json 任务对象的原始字段（skill 脚本 list --json 的值形状；缺字段按可选处理）。 */
+/** 任务对象的原始字段（skill 脚本 list --json 的值形状；缺字段按可选处理）。 */
 export interface TaskRecord {
     title?: string;
     status?: string;
@@ -33,40 +34,31 @@ export interface TaskRecord {
     category?: string | null;
     tags?: string[] | null;
     worklog?: string | null;
+    age_days?: number | null;
+    idle_days?: number | null;
+    waiting_days?: number | null;
+    stale?: boolean;
+    overdue?: boolean;
+    backlog?: boolean;
+    /** 是不是本机身份名下的（skill 比 uuid 得出来的）。 */
+    mine?: boolean;
 }
-/** 一条在办任务 = 原始字段 + 任务号 + 归属工作区（读取时打上）。 */
+/**
+ * 一条在办任务 = 原始字段 + 任务号 + 归属工作区（读取时打上）
+ * + skill 算好的派生面（插件只搬字段，不重算）。
+ */
 export interface TaskRow extends TaskRecord {
     readonly id: string;
     readonly workspace: LedgerWorkspace;
+    readonly ageDays: number | null;
+    readonly idleDays: number | null;
+    readonly waitingDays: number | null;
+    readonly stale: boolean;
+    readonly overdue: boolean;
+    readonly backlog: boolean;
+    readonly mine: boolean;
 }
-/** history 一条已结案记录（脚本 history --json 的 record 形状；字段名以脚本为准）。 */
-export interface HistoryRecord {
-    /** 结案时间（首列）。 */
-    time?: string;
-    created?: string | null;
-    workpackage?: string;
-    category?: string | null;
-    tags?: string[] | null;
-    /** 负责人 uuid（身份唯一键；`history --owner` 就比这个）。 */
-    owner?: string;
-    /** 发起人（creator）：任务的「创建者」，与 owner 区分（owner 可被 claim 改走）。历史 11 列新增。 */
-    creator?: string | null;
-    /** 负责人 / 发起人的显示名：**落盘在历史行里**（结案那一刻的快照，改名不回写旧行），只用于显示 / 搜索；老行没有时才按名册兜底补。 */
-    owner_name?: string | null;
-    creator_name?: string | null;
-    /** 「完成了什么」列。 */
-    summary?: string;
-    /** 过程文档链接列。 */
-    log?: string | null;
-    /** 行所在历史文件（相对工作区，脚本打上）。 */
-    src?: string;
-    /** 行格式（脚本 `fmt`）与行号（脚本 `line`）：排查坏历史行时用来定位。 */
-    fmt?: string;
-    line?: number;
-    /** 归属工作区（读取时打上）。 */
-    readonly workspace?: LedgerWorkspace;
-}
-/** list / history 共用的过滤面（与 skill 脚本参数一一对应）。 */
+/** `list` 的过滤面（与 skill 脚本 `list` 参数一一对应）。 */
 export interface LedgerFilter {
     /** 状态（open/doing；旧数据可能残留 blocked，读侧当进行中处理）。 */
     status?: string;
@@ -79,116 +71,68 @@ export interface LedgerFilter {
     /** 创建时间起 / 止（YYYY-MM-DD [HH:mm[:ss]]，脚本会补全）。 */
     since?: string;
     until?: string;
-    /** 列表分页大小（history 侧；script 的 --limit 在过滤 + 倒序后取前 N）。 */
-    limit?: number;
-    /** 只读最近 N 个月的历史文件（插件传 13；不传 = 脚本默认读全部）。 */
-    months?: number;
-}
-/** 一个自然周期内的两个计数（核心永远是「完成」，新增只作对照）。 */
-export interface PeriodCounts {
-    readonly done: number;
-    readonly created: number;
-    /** 周期起（YYYY-MM-DD，含）。 */
-    readonly from: string;
-    /** 周期止（YYYY-MM-DD，含）。 */
-    readonly to: string;
-}
-/** 统计台四个自然周期（用户 2026-10-17 定稿：本周 / 上周 / 本月 / 上月，不用 7/30 天）。 */
-export interface TrendPeriods {
-    readonly thisWeek: PeriodCounts;
-    readonly lastWeek: PeriodCounts;
-    readonly thisMonth: PeriodCounts;
-    readonly lastMonth: PeriodCounts;
-}
-/** 趋势图一桶（一周）：完成 + 新增 + 截止时仍未完成。 */
-export interface WeeklyBucket {
-    /** 该周周一（YYYY-MM-DD）。 */
-    readonly week: string;
-    /** 该周截止日（YYYY-MM-DD）：历史周=当周周日，当前周=今天——图表 x 轴标它，因为数据是按截止日判的。 */
-    readonly end: string;
-    readonly done: number;
-    readonly created: number;
-    /** 该周截止时仍未完成（在办）的任务数：cumulative(创建 - 完成) 到该周末，含窗口前遗留。 */
-    readonly remaining: number;
-}
-/** 趋势图数据按范围各一份（切换零请求）。 */
-export interface ClosedSummary {
-    readonly weekly: {
-        readonly all: readonly WeeklyBucket[];
-        readonly mine: readonly WeeklyBucket[];
-    };
 }
-/** 首页统计卡的六个面（阈值 / 天数全在 host 算，前端只渲染——单一真源）。 */
-export interface BoardStats {
-    /** 我的 doing（旧数据里的 blocked 也算进行中）。 */
+/**
+ * 8 个统计卡的面。**数字全部来自 skill**（`stats --json` + `history --count-only`），
+ * 插件只做跨工作区求和与阈值透传——不自己判停滞 / 逾期 / 积压。
+ */
+export interface BoardStatsView {
+    /** 我的进行中（skill `my_doing`）。 */
     readonly myActive: number;
-    /** 我的逾期（接任务至今满 OVERDUE_DAYS 天未结案）。 */
+    /** 我的逾期（skill `my_overdue`）。 */
     readonly myOverdue: number;
-    /** 我的停滞（我的进行中里 updated 满 STALE_DAYS 天没更新的）。 */
+    /** 我的停滞（skill `my_stale`）。 */
     readonly myStale: number;
-    /** 待认领（open）。 */
+    /** 待认领（skill `open`）。 */
     readonly open: number;
-    /** 全部 doing（旧数据里的 blocked 也算进行中）。 */
+    /** 进行中（skill `doing`，含旧数据的 blocked）。 */
     readonly doing: number;
-    /** 全部逾期——按时间判定，不是状态。 */
+    /** 逾期（skill `overdue`，按时间判定不是状态）。 */
     readonly overdue: number;
-    /** 停滞 = 进行中且 updated 至今满 STALE_DAYS 天没更新。 */
+    /** 停滞（skill `stale`）。 */
     readonly stale: number;
-    /** 积压 = 待认领且 created 至今满 BACKLOG_DAYS 天没人接。 */
+    /** 积压（skill `backlog`）。 */
     readonly backlog: number;
-    /** 停滞 / 逾期 / 积压阈值（天）——随响应下发，界面文案不硬编码（单一真源）。 */
+    /** 停滞 / 逾期 / 积压阈值（天）——skill 回显，界面文案不硬编码。 */
     readonly staleDays: number;
     readonly overdueDays: number;
     readonly backlogDays: number;
     /** 最老一条待认领躺了多少天（没有待认领 = null）。 */
     readonly oldestOpenDays: number | null;
-}
-/** 列表行附加工资字段（host 算，前端不判阈值）。 */
-export interface BoardTask extends TaskRow {
-    /** 认领后未动天数（进行中；open 与解析不了的时间为 null）。 */
-    readonly ageDays: number | null;
-    /** 最后更新至今的天数（进行中；open 与解析不了的时间为 null）——停滞提示用。 */
-    readonly idleDays: number | null;
-    /** 创建至今的天数（**只对待认领**有值；其余为 null）——积压提示用。 */
-    readonly waitingDays: number | null;
-    /** 停滞标记：updated 至今满 STALE_DAYS 天没更新（与 ageDays 无关）。 */
-    readonly stale: boolean;
-    /** 逾期标记：接任务至今满 OVERDUE_DAYS 天还没做完（不看中途更新）。 */
-    readonly overdue: boolean;
-    /** 积压标记：待认领且创建至今满 BACKLOG_DAYS 天没人接。 */
-    readonly backlog: boolean;
-}
-export interface BoardSnapshot {
+    /** 本周 / 上周完成数；history 全读不到时为 null（界面留 —，不拿 0 充数）。 */
+    readonly weekDone: number | null;
+    readonly lastWeekDone: number | null;
+    /** 两周的区间（界面悬停用，含边界）。 */
+    readonly weekFrom: string;
+    readonly weekTo: string;
+    readonly lastWeekFrom: string;
+    readonly lastWeekTo: string;
+}
+/** 8 卡的全部数字 + 降级信息。 */
+export interface StatsPayload {
     readonly at: string;
-    readonly workspaces: readonly LedgerWorkspace[];
-    /** 全部在办任务（UI 自己筛「我的 / 待认领」——筛选是前端的事）。 */
-    readonly tasks: readonly BoardTask[];
-    readonly stats: BoardStats;
-    /**
-     * 工作区 id → 本机身份 uuid（取不到为 null）。
-     * 「我的待办」在前端按 `owner === identities[workspace.id]` 筛——身份只在 host 侧读
-     * （`~/.taskledger/identity.json` 的 `uuid`，机器级，与工作区 / git 配置无关），UI 不碰文件。
-     */
-    readonly identities: Readonly<Record<string, string | null>>;
-}
-/** 首页一次 `/board` 的全部聚合（**每个工作区只读一次** list + history + 本机身份）。 */
-export interface HomeAggregate {
-    readonly snapshot: BoardSnapshot;
-    readonly closed: ClosedSummary;
-    readonly trend: TrendPeriods;
+    readonly stats: BoardStatsView;
+    readonly degraded: readonly DegradedInfo[];
+}
+/** 一个工作区的花名册（skill `owners --json`：含当前没任务的人）。 */
+export interface WorkspaceOwners {
+    readonly workspaceId: string;
+    readonly workspaceTitle: string;
+    readonly owners: readonly {
+        readonly uuid: string;
+        readonly name: string;
+        readonly mine: boolean;
+    }[];
 }
-/** 快路径作用域：在办 + 身份。**没有 history 字段**——想从它算趋势，编译器直接拦住。 */
-export interface TaskScope {
-    readonly workspace: LedgerWorkspace;
+/**
+ * `/board/snapshot` 响应：首屏一次拿全 —— 8 卡 + 在办列表 + 工作区 + 身份 + 各工作区花名册。
+ * 列表行直接就是 skill `list --json` 的形状（含 `mine` / 三个标记 / 三个天数），
+ * 前端只筛不判。
+ */
+export interface BoardHomePayload extends StatsPayload {
+    readonly workspaces: readonly LedgerWorkspace[];
     readonly tasks: readonly TaskRow[];
-    readonly identity: string | null;
-}
-/** 慢路径作用域：快路径 + history。趋势 / 筛选候选的原料。 */
-export interface TrendScope extends TaskScope {
-    readonly history: readonly HistoryRecord[];
-}
-export interface FilterOptions {
-    readonly owners: string[];
-    readonly categories: string[];
-    readonly tags: string[];
+    readonly identities: Readonly<Record<string, string | null>>;
+    /** 每个工作区的成员名单（跨工作区去重 / 分组由前端做，见 client 的 ownerGroups）。 */
+    readonly workspaceOwners: readonly WorkspaceOwners[];
 }

package/dist/host/workspace.d.ts

@@ -12,10 +12,9 @@ export interface RegistryWorkspace {
     readonly attachSession?: (sessionId: string) => Promise<void>;
 }
 /**
- * 工作区发现：宿主 registry 全量 → 逐个查 <path>/ledger/progress.json，只返回有的。
- * 未初始化（有 ledger/ 无 progress.json）= 隐藏，后端无此概念（2026-10-17 拍板）。
- * 补充源（registry 未收录目录）暂不做——形态待拍板，见 architecture §五。
+ * 工作区发现：宿主 registry 全量 → 逐个问 skill `root`（这个目录是不是台账根），
+ * 只留是的。没有 `ledger/` 的目录后端不可见（2026-10-17 拍板）。
  *
  * 探测走 repository 的 hasLedger()——本文件不碰 node:fs（IO 唯一出口纪律）。
  */
-export declare function resolveWorkspaces(registryList: readonly RegistryWorkspace[]): LedgerWorkspace[];
+export declare function resolveWorkspaces(registryList: readonly RegistryWorkspace[]): Promise<LedgerWorkspace[]>;

package/dist/host/workspace.js

@@ -1,14 +1,14 @@
 import { hasLedger } from "./repositories/ledger.repository.js";
 /**
- * 工作区发现：宿主 registry 全量 → 逐个查 <path>/ledger/progress.json，只返回有的。
- * 未初始化（有 ledger/ 无 progress.json）= 隐藏，后端无此概念（2026-10-17 拍板）。
- * 补充源（registry 未收录目录）暂不做——形态待拍板，见 architecture §五。
+ * 工作区发现：宿主 registry 全量 → 逐个问 skill `root`（这个目录是不是台账根），
+ * 只留是的。没有 `ledger/` 的目录后端不可见（2026-10-17 拍板）。
  *
  * 探测走 repository 的 hasLedger()——本文件不碰 node:fs（IO 唯一出口纪律）。
  */
-export function resolveWorkspaces(registryList) {
+export async function resolveWorkspaces(registryList) {
+    const flags = await Promise.all(registryList.map((workspace) => hasLedger(workspace.path)));
     return registryList
-        .filter((workspace) => hasLedger(workspace.path))
+        .filter((_, index) => flags[index])
         .map((workspace) => ({
         id: workspace.id,
         title: workspace.title,

package/dist/index.js

@@ -9,22 +9,9 @@
  * 满足不了的依赖会令 entry 一直 pending、卡死整个 dsh 启动）；两条注入线
  * 互相独立——skills 缺席不挡数据面，反之亦然。
  */
-import { registerRoutes, registerSessionRoutes, registerWriteRoutes, } from "./host/routes.js";
+import { registerRoutes, } from "./host/routes.js";
 import { buildSkillRegistration, } from "./host/skill/registration.js";
 export const name = "dsh-task-ledger";
-/**
- * 惰性服务读取：cordis ctx 的属性是 getter，**没 inject 的服务读一下就 throw**
- * （参考插件真机实证：`cannot get property "agentTeams" without inject`）。
- * 探测语义是「有就用、没有就降级」，所以把 throw 归一成 undefined。
- */
-function readService(services, name) {
-    try {
-        return services[name];
-    }
-    catch {
-        return undefined;
-    }
-}
 export function apply(ctx) {
     // ── 数据面（任务 3） ──
     ctx.inject(["workspaceRegistry", "webServer"], (services) => {
@@ -35,25 +22,7 @@ export function apply(ctx) {
             return;
         }
         registerRoutes(webServer, { registry });
-        // 写端点（认领 / 释放）：B 混合制下由 host 直跑脚本，不依赖 agents ⇒ 与数据面同一条注入线。
-        registerWriteRoutes(webServer, { registry });
-        console.info("[task-ledger] 数据面路由已注册（读 /api/task-ledger/* + 写 /claim /release）");
-    });
-    // ── 会话交接（按钮侧「结束任务」，2026-10-18 拍板 B 案：只有结束走会话） ──
-    // 单独一条注入线：agents 缺席只影响这一个端点，不该拖累数据面（上一条线只等 registry + webServer）。
-    ctx.inject(["agents", "workspaceRegistry", "webServer"], (services) => {
-        const registry = services.workspaceRegistry;
-        const webServer = services.webServer;
-        if (registry === undefined || webServer === undefined) {
-            console.warn("[task-ledger] workspaceRegistry / webServer 未就位，「结束任务」端点不注册");
-            return;
-        }
-        registerSessionRoutes(webServer, {
-            registry,
-            agents: services.agents,
-            getService: (name) => readService(services, name),
-        });
-        console.info("[task-ledger] 「结束任务」端点已注册（POST /api/task-ledger/close）");
+        console.info("[task-ledger] 数据面路由已注册（读 /api/task-ledger/workspaces、/board/snapshot）");
     });
     // ── skill 全局注册（任务 2） ──
     // unscoped 注册落全局层，模型可 load；disposer 随插件 dispose 自动注销。

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-task-ledger",
-	"version": "0.0.113",
+	"version": "0.0.114",
 	"description": "Task ledger board for dsh (DeepSeek Harness): read-only board over task-ledger skill workspaces. The task-ledger skill is bundled — install the plugin, get the skill globally.",
 	"keywords": [
 		"deepseek",
@@ -57,6 +57,6 @@
 		}
 	},
 	"dependencies": {
-		"dsh-plugin-core": "^0.5.0"
+		"dsh-plugin-core": "^0.8.3"
 	}
 }

package/skill/SKILL.md

@@ -16,6 +16,7 @@ allowed-tools: Read,Edit,Bash,Grep
 ## 手写边界
 
 - **唯一能手写的是任务的过程文档（worklog）前五节**（怎么写见「过程文档」节）；末节「执行记录」由脚本维护，**禁止手写、禁止手工添加**。
+- **改正文前先确认任务在当前用户名下、状态 doing**：open 的先问用户，同意再 `claim`；别人名下的不动。
 - **其他所有文件一律不许手改**：修改 / 删除 / 任何操作都走命令；手改台账文件即数据损坏。
 - 台账看着不对劲（任务凭空少了、状态怪、分片对不上）⇒ **不要动手修**：让用户跑 `validate`（老月份的历史也要查就跑 `validate --deep`），把清单交给用户。
 

package/dist/host/board.d.ts

@@ -1,20 +0,0 @@
-/**
- * 首页**组合入口**（`/board` 兼容全量端点用）：一次读全（tasks + history + 本机身份），
- * 喂快 / 慢两条纯计算——**读一次算两样，不重复 IO**。
- *
- * 拆端点后（host-data-plane §五 A）首屏走 `services/home.service.ts::getSnapshot()`（不碰 history），
- * 本组合归「兼容期全量 `/board`」；新端点在 routes 层直接调 service，不过本文件。
- */
-import { type DegradedInfo } from "./errors.js";
-import type { HomeAggregate, LedgerWorkspace } from "./types.js";
-/**
- * 首页一次拿全：在办快照（含停滞 / 天数 / 身份）+ 近 8 周趋势（完成 / 新增 × 所有 / 我的）
- * + 四个自然周期计数。**每个工作区只读一次**（list + history + 本机身份），
- * 避免「快照读一遍、统计再读一遍」把 5 万行级工作区的 history 解析翻倍。
- * 单工作区坏 ⇒ 进 degraded（其余照常）；全坏 ⇒ 抛（路由转 500 + 人话）。
- */
-export declare function getHomeAggregate(workspaces: readonly LedgerWorkspace[]): Promise<HomeAggregate & {
-    degraded: readonly DegradedInfo[];
-}>;
-export { getFilterOptions, queryClosed } from "./services/history.service.js";
-export { getSnapshot as getBoardSnapshot } from "./services/home.service.js";

package/dist/host/board.js

@@ -1,29 +0,0 @@
-/**
- * 首页**组合入口**（`/board` 兼容全量端点用）：一次读全（tasks + history + 本机身份），
- * 喂快 / 慢两条纯计算——**读一次算两样，不重复 IO**。
- *
- * 拆端点后（host-data-plane §五 A）首屏走 `services/home.service.ts::getSnapshot()`（不碰 history），
- * 本组合归「兼容期全量 `/board`」；新端点在 routes 层直接调 service，不过本文件。
- */
-import { settleWorkspaces } from "./errors.js";
-import { computeSnapshot } from "./services/home.service.js";
-import { computeClosedSummary, computeTrendPeriods, readTrendScope, } from "./services/trend.service.js";
-/**
- * 首页一次拿全：在办快照（含停滞 / 天数 / 身份）+ 近 8 周趋势（完成 / 新增 × 所有 / 我的）
- * + 四个自然周期计数。**每个工作区只读一次**（list + history + 本机身份），
- * 避免「快照读一遍、统计再读一遍」把 5 万行级工作区的 history 解析翻倍。
- * 单工作区坏 ⇒ 进 degraded（其余照常）；全坏 ⇒ 抛（路由转 500 + 人话）。
- */
-export async function getHomeAggregate(workspaces) {
-    const now = new Date();
-    const { data: scopes, degraded } = await settleWorkspaces(workspaces, "history", readTrendScope, (rows) => rows);
-    return {
-        snapshot: computeSnapshot(scopes, now),
-        closed: computeClosedSummary(scopes, now),
-        trend: computeTrendPeriods(scopes, now),
-        degraded,
-    };
-}
-export { getFilterOptions, queryClosed } from "./services/history.service.js";
-// 单路径用例直接透传 service（调用方按快 / 慢自己选，不必经过组合）：
-export { getSnapshot as getBoardSnapshot } from "./services/home.service.js";

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

@@ -1,27 +0,0 @@
-/**
- * 已结案列表 / 筛选项候选用例（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;
-/**
- * 已结案列表：默认近 13 个月 + limit 500，跨工作区合并后按创建时间倒序。
- * shortcut: 分页用「加大 limit 重取」的笨办法（skill 脚本无 offset）；
- * 单工作区内 limit 已生效，合并边界的全局精确排序暂不保证（500 条一页无感）。
- * 要全量老数据：调用方显式传 months: undefined（不拼 --months，脚本读全部，按秒计）。
- */
-export declare function queryClosed(workspaces: readonly LedgerWorkspace[], filter?: LedgerFilter): Promise<{
-    records: HistoryRecord[];
-    degraded: readonly DegradedInfo[];
-}>;
-/** 候选值收集（纯函数）：owner/category/tag 去重 + 排序。 */
-export declare function collectFilterOptions(scopes: readonly TrendScope[]): FilterOptions;
-/**
- * 筛选项候选：在办（全量）+ 近 13 个月历史的去重值（owner / category / tag）。
- * 按需调用（/filters 路由），非首屏——历史侧在极端量级下是百毫秒级。单工作区坏 ⇒ 进 degraded。
- */
-export declare function getFilterOptions(workspaces: readonly LedgerWorkspace[]): Promise<{
-    options: FilterOptions;
-    degraded: readonly DegradedInfo[];
-}>;