dsh-task-ledger 0.0.112 → 0.0.114

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

@@ -1,162 +0,0 @@
-/**
- * 首页**慢路径**用例：近 8 周趋势 + 四个自然周期。
- * 读 history（months=RECENT_MONTHS）+ 在办 + 本机身份——首屏不等它（异步/按需拉）。
- *
- * ⚠️ 窗口必须是 13 个月而不是 2：8 周桶在月初会横跨 3 个自然月（如 10 月第 1 周回溯到 8 月），
- * `--months` 是**文件级**过滤，缩到 2 会静默漏掉 8 月结案记录、趋势少算（2026-10-18 架构评审结论）。
- */
-import { settleWorkspaces } from "../errors.js";
-import { sameUuid } from "./uuid.js";
-import { getCurrentIdentity } from "../repositories/identity.repository.js";
-import { readHistory, readTasks } from "../repositories/ledger.repository.js";
-import { buildWeeks, dayOf, inWindow, mondayOf, monthWindow, weekWindow, ymd, } from "./dates.js";
-/** 历史窗口：只读最近 13 个月的文件（2026-10-17 拍板；脚本默认读全部，窗口由插件显式传）。 */
-export const RECENT_MONTHS = 13;
-/** 趋势图桶数：近 8 周（2026-10-17 定稿）。 */
-export const WEEKLY_WEEKS = 8;
-/** 慢路径读法：单工作区 readTasks + readHistory(months) + 本机身份（并行；供 settle 逐工作区调）。 */
-export async function readTrendScope(workspace) {
-    const [tasks, history, identity] = await Promise.all([
-        readTasks(workspace),
-        readHistory(workspace, { months: RECENT_MONTHS }),
-        getCurrentIdentity(workspace),
-    ]);
-    return {
-        workspace,
-        tasks,
-        history: history.records,
-        identity,
-        warnings: history.warnings,
-    };
-}
-/**
- * 近 N 周分组桶（完成按结案时间、新增按创建时间）× 所有 / 我的（纯函数）。
- *
- * 新增必须**合并两个来源**：已结案的任务被 close 移出 progress.json，只在 history 里；
- * 在办的只在 progress.json 里。两者不相交（close 是移动），合并即全集、不会重复计。
- * remaining：某任务在「第 i 周截止时」仍未完成 ⇔ 创建 ≤ weekEnd_i 且（未结案 或 结案 > weekEnd_i）。
- */
-export function computeClosedSummary(scopes, now) {
-    const weeks = buildWeeks(WEEKLY_WEEKS, now);
-    const weekEnds = weeks.map((slot) => slot.end);
-    const make = () => new Map(weeks.map((slot) => [slot.week, { done: 0, created: 0, remaining: 0 }]));
-    const bucketsAll = make();
-    const bucketsMine = make();
-    const bump = (map, week, field) => {
-        const bucket = map.get(week);
-        if (bucket !== undefined)
-            map.set(week, { ...bucket, [field]: bucket[field] + 1 });
-    };
-    const bumpRemaining = (map, createdDay, closeDay) => {
-        if (createdDay === null)
-            return;
-        for (let i = 0; i < weeks.length; i += 1) {
-            if (createdDay <= weekEnds[i] &&
-                (closeDay === null || closeDay > weekEnds[i])) {
-                const bucket = map.get(weeks[i].week);
-                if (bucket !== undefined)
-                    bucket.remaining += 1;
-            }
-        }
-    };
-    for (const scope of scopes) {
-        const identity = scope.identity;
-        for (const task of scope.tasks) {
-            const created = dayOf(task.created);
-            if (created === null)
-                continue;
-            const week = ymd(mondayOf(created));
-            const createdMine = sameUuid(task.creator, identity);
-            bump(bucketsAll, week, "created");
-            if (createdMine)
-                bump(bucketsMine, week, "created");
-            const ownedMine = sameUuid(task.owner, identity);
-            bumpRemaining(bucketsAll, created, null);
-            if (ownedMine)
-                bumpRemaining(bucketsMine, created, null);
-        }
-        for (const record of scope.history) {
-            const closed = dayOf(record.time);
-            if (closed !== null) {
-                const week = ymd(mondayOf(closed));
-                bump(bucketsAll, week, "done");
-                if (sameUuid(record.owner, identity))
-                    bump(bucketsMine, week, "done");
-            }
-            const created = dayOf(record.created);
-            if (created !== null) {
-                const week = ymd(mondayOf(created));
-                bump(bucketsAll, week, "created");
-                // 新增（我的）= 我创建的（creator）；旧 8 列历史无 creator 列 ⇒ 兜底 owner
-                const createdMine = sameUuid(record.creator, identity) ||
-                    ((record.creator ?? null) === null && sameUuid(record.owner, identity));
-                if (createdMine)
-                    bump(bucketsMine, week, "created");
-            }
-            const ownedMine = sameUuid(record.owner, identity);
-            bumpRemaining(bucketsAll, created, closed);
-            if (ownedMine)
-                bumpRemaining(bucketsMine, created, closed);
-        }
-    }
-    const toBuckets = (map) => weeks.map((slot, i) => ({
-        week: slot.week,
-        end: weekEnds[i],
-        ...(map.get(slot.week) ?? { done: 0, created: 0, remaining: 0 }),
-    }));
-    return {
-        weekly: { all: toBuckets(bucketsAll), mine: toBuckets(bucketsMine) },
-    };
-}
-/** 四个自然周期（只算「全部工作区」范围；图表切换不带动卡片）——纯函数。 */
-export function computeTrendPeriods(scopes, now) {
-    const windows = {
-        thisWeek: weekWindow(0, now),
-        lastWeek: weekWindow(-1, now),
-        thisMonth: monthWindow(0, now),
-        lastMonth: monthWindow(-1, now),
-    };
-    const doneEntries = scopes.flatMap((scope) => scope.history.map((record) => ({
-        day: dayOf(record.time),
-        owner: record.owner ?? null,
-    })));
-    const createdEntries = scopes.flatMap((scope) => [
-        ...scope.tasks.map((task) => ({
-            day: dayOf(task.created),
-            owner: task.owner ?? null,
-        })),
-        ...scope.history.map((record) => ({
-            day: dayOf(record.created),
-            owner: record.owner ?? null,
-        })),
-    ]);
-    const period = (window) => ({
-        done: doneEntries.filter((entry) => inWindow(entry.day, window)).length,
-        created: createdEntries.filter((entry) => inWindow(entry.day, window))
-            .length,
-        from: window.from,
-        to: window.to,
-    });
-    return {
-        thisWeek: period(windows.thisWeek),
-        lastWeek: period(windows.lastWeek),
-        thisMonth: period(windows.thisMonth),
-        lastMonth: period(windows.lastMonth),
-    };
-}
-/** 慢路径端点：趋势 + 周期（读 history）。异步加载，首屏不等。单工作区坏 ⇒ 进 degraded。 */
-export async function getTrend(workspaces) {
-    const now = new Date();
-    const { data: scopes, degraded } = await settleWorkspaces(workspaces, "history", readTrendScope, (rows) => rows);
-    return {
-        closed: computeClosedSummary(scopes, now),
-        trend: computeTrendPeriods(scopes, now),
-        degraded,
-        // 被脚本跳过的历史行（列数不对 / 时间不合法）：数字已经少算了，必须让界面说出口
-        warnings: scopes.flatMap((scope) => scope.warnings),
-    };
-}
-/** 趋势端点用的历史 filter（窗口由本模块策略决定，repository 零默认值注入）。 */
-export function trendHistoryFilter(extra = {}) {
-    return { months: RECENT_MONTHS, ...extra };
-}

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

@@ -1,11 +0,0 @@
-/**
- * 身份比较的唯一口径：**两边都 trim + 小写再比**。
- *
- * 台账里的 owner / creator 存的是 uuid，本机身份也取 uuid；但两边来源不同
- * （identity.json 可能是手写的、台账里可能是旧版本写的），大小写不一定一致。
- * 脚本侧 `core/identity.normalize` 就是这么比的，这里必须同口径，
- * 否则脚本说「是你的」，界面说「不是你的」。
- *
- * 空值一律不算相等（`"" === ""` 会让「没 init」被误判成「是我的」）。
- */
-export declare function sameUuid(a: string | null | undefined, b: string | null | undefined): boolean;

package/dist/host/services/uuid.js

@@ -1,15 +0,0 @@
-/**
- * 身份比较的唯一口径：**两边都 trim + 小写再比**。
- *
- * 台账里的 owner / creator 存的是 uuid，本机身份也取 uuid；但两边来源不同
- * （identity.json 可能是手写的、台账里可能是旧版本写的），大小写不一定一致。
- * 脚本侧 `core/identity.normalize` 就是这么比的，这里必须同口径，
- * 否则脚本说「是你的」，界面说「不是你的」。
- *
- * 空值一律不算相等（`"" === ""` 会让「没 init」被误判成「是我的」）。
- */
-export function sameUuid(a, b) {
-    const left = (a ?? "").trim().toLowerCase();
-    const right = (b ?? "").trim().toLowerCase();
-    return left !== "" && left === right;
-}