dsh-task-ledger 0.0.124 → 0.0.126

package/dist/host/errors.d.ts

@@ -20,7 +20,7 @@ export interface DegradedInfo {
     readonly workspaceId: string;
     readonly workspaceTitle: string;
     /** 哪个读挂了（skill 子命令；趋势走 `stats --trend`，单独一档便于区分）。 */
-    readonly op: "list" | "owners" | "trend";
+    readonly op: "list" | "owners" | "trend" | "history";
     readonly code: LedgerErrorCode;
     /** 人话，可直接上界面（真源：脚本 stderr / records 校验文案）。 */
     readonly message: string;
@@ -36,7 +36,7 @@ export declare function messageOf(error: unknown): string;
 export declare function settleWorkspaces<W extends {
     id: string;
     title: string;
-}, T, R>(workspaces: readonly W[], op: "list" | "owners", read: (workspace: W) => Promise<T>, merge: (rows: readonly T[]) => R): Promise<{
+}, T, R>(workspaces: readonly W[], op: "list" | "owners" | "history", read: (workspace: W) => Promise<T>, merge: (rows: readonly T[]) => R): Promise<{
     data: R;
     degraded: readonly DegradedInfo[];
 }>;

package/dist/host/repositories/cache.d.ts

@@ -11,8 +11,8 @@
 /** 缓存有效期（2026-10-18 拍板 1.5s：够挡同一屏的重复读，短到不会让人看到旧数据）。 */
 export declare const CACHE_TTL_MS = 1500;
 /** 缓存的操作种类（= skill 脚本子命令；worklog 不进缓存故不在此列）。
- *  `history` 已从插件侧消失（2026-10-29：本周 / 上周完成改取 `stats --trend` 的桶），不再单列。 */
-export type CacheOp = "list" | "stats" | "owners";
+ *  `history` 供历史页顶部日趋势使用（2026-10-29 重新接入）。 */
+export type CacheOp = "history" | "list" | "stats" | "owners";
 /** 缓存键：`op:workspace:filter` 三条信息都要，否则不同筛选 / 不同工作区会串味。 */
 export declare function cacheKey(workspaceId: string, op: CacheOp, detail: string): string;
 /**

package/dist/host/repositories/trend.repository.d.ts

@@ -1,6 +1,10 @@
 import type { LedgerWorkspace } from "../types.js";
-/** 趋势图的窗口（周数）：与首页右侧卡位一致（2026-10-17 定稿「近 8 周」）。 */
-export declare const TREND_WEEKS = 8;
+/**
+ * 趋势图的窗口（周数）：近半年。
+ * 2026-10-30 由 8 周放宽 —— 卡片按宽度能放几周就放几周（宽屏 12~14 周），
+ * 8 周不够铺满，也没得翻页；26 周 ≈ 4 屏，左右箭头一次翻 4 周。
+ */
+export declare const TREND_WEEKS = 26;
 /** 一个人在一个周桶里的三个数（skill 口径：新增按 creator、完成 / 未结按 owner）。 */
 export interface OwnerCounts {
     readonly added: number;
@@ -30,7 +34,13 @@ export interface WorkspaceTrend {
     readonly coverageFrom: string;
     readonly coverageTo: string;
 }
-/** 单工作区趋势（skill `stats --trend week --last 8w --by-owner`；过 1.5s 读缓存）。 */
+/** 单工作区趋势（skill `stats --trend week --last 26w --by-owner`；过 1.5s 读缓存）。 */
 export declare function readTrend(workspace: LedgerWorkspace): Promise<WorkspaceTrend>;
+/**
+ * 历史页趋势的取数：`stats --trend <gran> --since --until`（明确窗口 ⇒ 不受
+ * day 粒度 365 桶上限的 --last 换算影响）。桶的切分 / 新增口径 / 补空桶全在 skill
+ * （用户 2026-10-30 定：聚合算法不自己写，host 只做跨工作区求和）。
+ */
+export declare function readTrendGran(workspace: LedgerWorkspace, gran: "day" | "week" | "month", since: string, until: string): Promise<WorkspaceTrend>;
 /** `stats --trend` → {@link WorkspaceTrend}（容器级严格：缺字段即坏，不当 0）。 */
 export declare function parseTrend(raw: unknown, where: string): WorkspaceTrend;

package/dist/host/repositories/trend.repository.js

@@ -1,5 +1,5 @@
 /**
- * 趋势面取数：近 8 周的「完成 / 未结 / 新增」，**整段桶序列一次拿回**（skill `stats --trend`）。
+ * 趋势面取数：近 26 周的「完成 / 未结 / 新增」，**整段桶序列一次拿回**（skill `stats --trend`）。
  *
  * 为什么不再拼现有方法：`history` 只给明细、且按**结案时间**过滤（新增取不到）；
  * 插件侧拉全量明细再聚合已被实测否决（20 万条 3s+、30MB 过进程边界）。
@@ -11,8 +11,12 @@
 import { LedgerDataError } from "../errors.js";
 import { cached, cacheKey } from "./cache.js";
 import { runLedgerScript } from "./runner.js";
-/** 趋势图的窗口（周数）：与首页右侧卡位一致（2026-10-17 定稿「近 8 周」）。 */
-export const TREND_WEEKS = 8;
+/**
+ * 趋势图的窗口（周数）：近半年。
+ * 2026-10-30 由 8 周放宽 —— 卡片按宽度能放几周就放几周（宽屏 12~14 周），
+ * 8 周不够铺满，也没得翻页；26 周 ≈ 4 屏，左右箭头一次翻 4 周。
+ */
+export const TREND_WEEKS = 26;
 const TREND_LAST = `${String(TREND_WEEKS)}w`;
 function isPlainObject(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -48,7 +52,7 @@ function parseOwners(raw, where) {
     }
     return out;
 }
-/** 单工作区趋势（skill `stats --trend week --last 8w --by-owner`；过 1.5s 读缓存）。 */
+/** 单工作区趋势（skill `stats --trend week --last 26w --by-owner`；过 1.5s 读缓存）。 */
 export async function readTrend(workspace) {
     // 缓存 op 仍记 "stats"（脚本子命令就是 stats），detail 里写清是哪个窗口的趋势
     return await cached(cacheKey(workspace.id, "stats", `trend:${TREND_LAST}`), async () => {
@@ -56,7 +60,22 @@ export async function readTrend(workspace) {
         const result = await runLedgerScript("stats", 
         // --by-owner：一次就把「全部」与「按人」两套数都拿回来 ⇒ 勾「只看我的」零请求
         ["--repo", workspace.path, "--trend", "week", "--last", TREND_LAST, "--by-owner"], 
-        // 8 周窗口最坏要读 3 个历史文件，比单月读重：给到 20s 再判超时
+        // 半年窗口最坏要读 7 个历史文件（skill 有月度缓存），比单月读重：给到 20s 再判超时
+        { timeoutMs: 20_000 });
+        if (!result.ok)
+            throw new Error(`${workspace.title}: ${result.error}`);
+        return parseTrend(result.data, workspace.title);
+    });
+}
+/**
+ * 历史页趋势的取数：`stats --trend <gran> --since --until`（明确窗口 ⇒ 不受
+ * day 粒度 365 桶上限的 --last 换算影响）。桶的切分 / 新增口径 / 补空桶全在 skill
+ * （用户 2026-10-30 定：聚合算法不自己写，host 只做跨工作区求和）。
+ */
+export async function readTrendGran(workspace, gran, since, until) {
+    return await cached(cacheKey(workspace.id, "stats", `trend:${gran}:${since}:${until}`), async () => {
+        const result = await runLedgerScript("stats", ["--repo", workspace.path, "--trend", gran, "--since", since, "--until", until], 
+        // 与周趋势同档：整年窗口最坏要读十几个历史文件
         { timeoutMs: 20_000 });
         if (!result.ok)
             throw new Error(`${workspace.title}: ${result.error}`);

package/dist/host/routes.js

@@ -1,5 +1,6 @@
 import { invalidate } from "./repositories/cache.js";
 import { getBoardHome } from "./services/stats.service.js";
+import { getHistoryTrend } from "./services/history.service.js";
 import { resolveWorkspaces } from "./workspace.js";
 /** API 前缀（唯一真源就在这一处）。 */
 const API_PREFIX = "/api/task-ledger";
@@ -48,4 +49,17 @@ export function registerRoutes(webServer, deps) {
             });
         }
     });
+    // 历史页顶部趋势（粒度 day/week/month，桶全在 skill）：切粒度 = 重新请求，host 有读缓存。
+    registerRead("/history/trend", async (req, res) => {
+        try {
+            const raw = new URL(req.url ?? "/", "http://localhost").searchParams.get("gran");
+            const gran = raw === "week" || raw === "month" ? raw : "day";
+            sendJson(res, 200, await getHistoryTrend(await workspacesOf(deps), gran));
+        }
+        catch (error) {
+            sendJson(res, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
 }

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

@@ -0,0 +1,2 @@
+import type { HistoryGran, HistoryTrendPayload, LedgerWorkspace } from "../types.js";
+export declare function getHistoryTrend(workspaces: readonly LedgerWorkspace[], gran?: HistoryGran): Promise<HistoryTrendPayload>;

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

@@ -0,0 +1,130 @@
+/**
+ * 历史页顶部趋势：**数字真源是 skill `stats --trend <gran>`**，本文件只做两件事 ——
+ * ① 每工作区拉「当前粒度 + day」两套桶（day 服务 4 数显与窗口锚点）；
+ * ② 跨工作区**求和**。周期切分、新增口径、补空桶全在 skill
+ * （用户 2026-10-30 定：聚合算法不自己写，本地只加总，免得与核心口径漂移）。
+ */
+import { settleWorkspaces } from "../errors.js";
+import { readTrendGran } from "../repositories/trend.repository.js";
+function pad2(n) {
+    return String(n).padStart(2, "0");
+}
+function ymdOf(date) {
+    return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
+}
+function addDays(value, delta) {
+    const date = new Date(`${value}T00:00:00`);
+    date.setDate(date.getDate() + delta);
+    return ymdOf(date);
+}
+/** 本周一（周一为一周之始，与 skill 同口径）。 */
+function mondayOf(value) {
+    const date = new Date(`${value}T00:00:00`);
+    date.setDate(date.getDate() - ((date.getDay() + 6) % 7));
+    return ymdOf(date);
+}
+function monthStart(value) {
+    return `${value.slice(0, 7)}-01`;
+}
+function prevMonthStart(value) {
+    const date = new Date(`${monthStart(value)}T00:00:00`);
+    date.setMonth(date.getMonth() - 1);
+    return ymdOf(date);
+}
+/** 所在季度首日（自然季度：1 / 4 / 7 / 10 月）。 */
+function quarterStart(value) {
+    const date = new Date(`${monthStart(value)}T00:00:00`);
+    date.setMonth(date.getMonth() - (date.getMonth() % 3));
+    return ymdOf(date);
+}
+export async function getHistoryTrend(workspaces, gran = "day") {
+    const today = ymdOf(new Date());
+    // 窗口 = 最近 365 个自然日：day 粒度恰好顶满 skill 的 365 桶上限又不越线；周 / 月桶更少
+    const since = addDays(today, -364);
+    const settled = await settleWorkspaces(workspaces, "history", async (workspace) => {
+        // gran = day 时两套是同一份（同 cacheKey）⇒ 共用一个 Promise，不跑两遍脚本
+        const granRun = readTrendGran(workspace, gran, since, today);
+        const dayRun = gran === "day" ? granRun : readTrendGran(workspace, "day", since, today);
+        const [granTrend, dayTrend] = await Promise.all([granRun, dayRun]);
+        return { workspace, granTrend, dayTrend };
+    }, (rows) => rows);
+    // ① 柱 / 曲线：当前粒度，按桶起始日跨工作区求和 —— 本地唯一的「算法」就是加法
+    const merged = new Map();
+    for (const { workspace, granTrend } of settled.data) {
+        for (const bucket of granTrend.buckets) {
+            const acc = merged.get(bucket.from) ?? {
+                to: bucket.to,
+                done: 0,
+                cancelled: 0,
+                added: 0,
+                byWorkspace: {},
+            };
+            acc.to = bucket.to;
+            acc.done += bucket.done;
+            acc.cancelled += bucket.cancelled;
+            acc.added += bucket.added;
+            const ws = acc.byWorkspace[workspace.id] ?? { done: 0, cancelled: 0 };
+            ws.done += bucket.done;
+            ws.cancelled += bucket.cancelled;
+            acc.byWorkspace[workspace.id] = ws;
+            merged.set(bucket.from, acc);
+        }
+    }
+    // ② day 桶：4 数显求和
+    const dayMap = new Map();
+    for (const { dayTrend } of settled.data) {
+        for (const bucket of dayTrend.buckets) {
+            const acc = dayMap.get(bucket.from) ?? { done: 0, cancelled: 0, added: 0 };
+            acc.done += bucket.done;
+            acc.cancelled += bucket.cancelled;
+            acc.added += bucket.added;
+            dayMap.set(bucket.from, acc);
+        }
+    }
+    const sumIn = (rangeFrom, rangeTo) => {
+        let done = 0;
+        let cancelled = 0;
+        for (const [key, cell] of dayMap) {
+            if (key < rangeFrom || key > rangeTo)
+                continue;
+            done += cell.done;
+            cancelled += cell.cancelled;
+        }
+        return { done, cancelled };
+    };
+    const yesterday = addDays(today, -1);
+    const lastWeekEnd = addDays(mondayOf(today), -1);
+    const quarterFrom = quarterStart(today);
+    const lastQuarterEnd = addDays(quarterFrom, -1);
+    const totals = {
+        today: sumIn(today, today),
+        yesterday: sumIn(yesterday, yesterday),
+        week: sumIn(mondayOf(today), today),
+        lastWeek: sumIn(addDays(mondayOf(today), -7), lastWeekEnd),
+        month: sumIn(monthStart(today), today),
+        lastMonth: sumIn(prevMonthStart(today), addDays(monthStart(today), -1)),
+        quarter: sumIn(quarterFrom, today),
+        lastQuarter: sumIn(quarterStart(lastQuarterEnd), lastQuarterEnd),
+    };
+    // 整段窗口直接下发（不按有数据范围裁剪）：翻页边界交给前端按 key 补空槽，
+    // 免得「正好显示完就不能翻、中间空一大段反而能翻」这种判断（用户 2026-10-30）
+    const buckets = [...merged.entries()]
+        .sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0))
+        .map(([key, cell]) => ({
+        key,
+        to: cell.to,
+        done: cell.done,
+        cancelled: cell.cancelled,
+        added: cell.added,
+        byWorkspace: cell.byWorkspace,
+    }));
+    return {
+        workspaces: workspaces.map((workspace) => ({
+            id: workspace.id,
+            title: workspace.title,
+        })),
+        buckets,
+        totals,
+        degraded: settled.degraded,
+    };
+}

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

@@ -1,7 +1,7 @@
 /**
- * 首页趋势图的用例：跨工作区把「近 8 周」的桶**按周求和**。
+ * 首页趋势图的用例：跨工作区把「近 26 周」的桶**按周求和**。
  *
- * 数字真源全在 skill（每工作区 `stats --trend week --last 8w`），本文件只做两件事：
+ * 数字真源全在 skill（每工作区 `stats --trend week --last 26w`），本文件只做两件事：
  * 按 `from` 把各工作区同周的数加在一起、把读挂的工作区归进 `degraded`。
  *
  * ⚠️ 这里**不抛**「全部失败」：趋势只是首页的一块图，不能因为它把 8 张卡和列表一起打成 500。

package/dist/host/types.d.ts

@@ -145,6 +145,60 @@ export interface TrendView {
 export interface TrendPayload extends TrendView {
     readonly degraded: readonly DegradedInfo[];
 }
+/** 历史趋势的周期粒度（一根柱 = 一个周期；桶的切分与口径全在 skill）。 */
+export type HistoryGran = "day" | "week" | "month";
+/** 历史趋势里某工作区一个周期内的结案数。 */
+export interface HistoryWorkspaceCell {
+    readonly done: number;
+    readonly cancelled: number;
+}
+/**
+ * 历史页顶部的一个周期桶：**数字真源是 skill `stats --trend <gran>`**，
+ * host 只做跨工作区求和（用户 2026-10-30 定：不自己写聚合算法）。
+ */
+export interface HistoryBucket {
+    /** 周期起始日（日 = 当天、周 = 周一、月 = 1 号；skill 口径）。 */
+    readonly key: string;
+    /** 周期结束日（含边界；skill 口径，浮卡的区间标题用）。 */
+    readonly to: string;
+    readonly done: number;
+    readonly cancelled: number;
+    /** 该周期新建（含在办 / 待认领）。 */
+    readonly added: number;
+    /** 工作区 id → 该区该周期的 done / cancelled（分色用）。 */
+    readonly byWorkspace: Readonly<Record<string, HistoryWorkspaceCell>>;
+}
+/** 一个周期的结案拆分（合计 = done + cancelled）—— 小字要分别显示「完成 / 取消」。 */
+export interface PeriodCount {
+    readonly done: number;
+    readonly cancelled: number;
+}
+/** 历史页顶部数显（host 从 day 桶求和：今日 / 昨日 / 本周 / 上周 / 本月 / 上月 / 本季度 / 上季度）。 */
+export interface HistoryTotals {
+    readonly today: PeriodCount;
+    readonly yesterday: PeriodCount;
+    readonly week: PeriodCount;
+    readonly lastWeek: PeriodCount;
+    readonly month: PeriodCount;
+    readonly lastMonth: PeriodCount;
+    readonly quarter: PeriodCount;
+    readonly lastQuarter: PeriodCount;
+}
+/** 历史页顶部数据：当前粒度的桶序列 + 4 数显。
+ *  桶只覆盖最近 365 天（skill 的 day 粒度上限）；更早的窗口由前端按 key 补空槽。 */
+export interface HistoryTrendView {
+    readonly workspaces: readonly {
+        readonly id: string;
+        readonly title: string;
+    }[];
+    /** 桶序列（升序；空桶 = 该周期无结案）。 */
+    readonly buckets: readonly HistoryBucket[];
+    readonly totals: HistoryTotals;
+}
+/** 历史日趋势 + 降级。 */
+export interface HistoryTrendPayload extends HistoryTrendView {
+    readonly degraded: readonly DegradedInfo[];
+}
 /** 一个工作区的花名册（skill `owners --json`：含当前没任务的人）。 */
 export interface WorkspaceOwners {
     readonly workspaceId: string;
@@ -161,7 +215,7 @@ export interface WorkspaceOwners {
  * 前端只筛不判。
  */
 export interface BoardHomePayload extends StatsPayload {
-    /** 首页右侧趋势图（近 8 周）。 */
+    /** 首页右侧趋势图（近 26 周）。 */
     readonly trend: TrendView;
     readonly workspaces: readonly LedgerWorkspace[];
     readonly tasks: readonly TaskRow[];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-task-ledger",
-	"version": "0.0.124",
+	"version": "0.0.126",
 	"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.10.0"
+		"dsh-plugin-core": "^0.12.0"
 	}
 }

package/skill/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-ledger",
-	"version": "1.3.46",
+	"version": "1.3.47",
 	"description": "Task-ledger skill for coding agents: per-workspace progress tracking (ledger/pool.json + owners/<hash>.json shards + owners.json index, history, worklog) driven by a CLI script. Standalone install for CodeBuddy and other agents; also bundled inside the dsh-task-ledger DSH plugin.",
 	"keywords": [
 		"skill",