dsh-task-ledger 0.0.45 → 0.0.47

package/dist/host/types.d.ts

@@ -66,3 +66,97 @@ export interface LedgerFilter {
     /** 只读最近 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。 */
+    readonly myActive: number;
+    /** 我的 blocked。 */
+    readonly myBlocked: number;
+    /** 待认领（open）。 */
+    readonly open: number;
+    /** 全部 doing。 */
+    readonly doing: number;
+    /** 全部 blocked。 */
+    readonly blocked: number;
+    /** 停滞 = doing|blocked 且 ageDays > STALE_DAYS。 */
+    readonly stale: number;
+    /** 停滞阈值（天）——随响应下发，界面文案不硬编码（单一真源）。 */
+    readonly staleDays: number;
+    /** 最老一条待认领躺了多少天（没有待认领 = null）。 */
+    readonly oldestOpenDays: number | null;
+}
+/** 列表行附加工资字段（host 算，前端不判阈值）。 */
+export interface BoardTask extends TaskRow {
+    /** 认领后未动天数（doing / blocked；open 与解析不了的时间为 null）。 */
+    readonly ageDays: number | null;
+    /** 停滞标记。 */
+    readonly stale: boolean;
+}
+export interface BoardSnapshot {
+    readonly at: string;
+    readonly workspaces: readonly LedgerWorkspace[];
+    /** 全部在办任务（UI 自己筛「我的 / 待认领」——筛选是前端的事）。 */
+    readonly tasks: readonly BoardTask[];
+    readonly stats: BoardStats;
+    /**
+     * 工作区 id → 该工作区的当前 git 身份（取不到为 null）。
+     * 「我的待办」在前端按 `owner === identities[workspace.id]` 筛——身份只在 host 侧取得到
+     * （cwd = 该工作区跑 `git config user.name`），UI 不摸 git。
+     */
+    readonly identities: Readonly<Record<string, string | null>>;
+}
+/** 首页一次 `/board` 的全部聚合（**每个工作区只读一次** list + history + git 身份）。 */
+export interface HomeAggregate {
+    readonly snapshot: BoardSnapshot;
+    readonly closed: ClosedSummary;
+    readonly trend: TrendPeriods;
+}
+/** 快路径作用域：在办 + 身份。**没有 history 字段**——想从它算趋势，编译器直接拦住。 */
+export interface TaskScope {
+    readonly workspace: 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[];
+}

package/dist/host/workspace.d.ts

@@ -4,10 +4,18 @@ export interface RegistryWorkspace {
     readonly id: string;
     readonly title: string;
     readonly path: string;
+    /**
+     * 把会话登记进本工作区的 `sessionIds`（会话归组的唯一途径）。
+     * ⚠️ 只设 `meta.cwd` **不会**自动归组（reference: dsh-task-dispatch-table 决策 22 真机结论）；
+     * 宿主旧版本可能没有该面 ⇒ optional，调用方按缺失降级并如实回报。
+     */
+    readonly attachSession?: (sessionId: string) => Promise<void>;
 }
 /**
  * 工作区发现：宿主 registry 全量 → 逐个查 <path>/ledger/progress.json，只返回有的。
  * 未初始化（有 ledger/ 无 progress.json）= 隐藏，后端无此概念（2026-10-17 拍板）。
  * 补充源（registry 未收录目录）暂不做——形态待拍板，见 architecture §五。
+ *
+ * 探测走 repository 的 hasLedger()——本文件不碰 node:fs（IO 唯一出口纪律）。
  */
 export declare function resolveWorkspaces(registryList: readonly RegistryWorkspace[]): LedgerWorkspace[];

package/dist/host/workspace.js

@@ -1,16 +1,13 @@
-import { existsSync } from 'node:fs';
-import path from 'node:path';
+import { hasLedger } from './repositories/ledger.repository.js';
 /**
  * 工作区发现：宿主 registry 全量 → 逐个查 <path>/ledger/progress.json，只返回有的。
  * 未初始化（有 ledger/ 无 progress.json）= 隐藏，后端无此概念（2026-10-17 拍板）。
  * 补充源（registry 未收录目录）暂不做——形态待拍板，见 architecture §五。
+ *
+ * 探测走 repository 的 hasLedger()——本文件不碰 node:fs（IO 唯一出口纪律）。
  */
 export function resolveWorkspaces(registryList) {
-    const found = [];
-    for (const workspace of registryList) {
-        if (existsSync(path.join(workspace.path, 'ledger', 'progress.json'))) {
-            found.push({ id: workspace.id, title: workspace.title, path: workspace.path });
-        }
-    }
-    return found;
+    return registryList
+        .filter((workspace) => hasLedger(workspace.path))
+        .map((workspace) => ({ id: workspace.id, title: workspace.title, path: workspace.path }));
 }

package/dist/index.js

@@ -9,9 +9,22 @@
  * 满足不了的依赖会令 entry 一直 pending、卡死整个 dsh 启动）；两条注入线
  * 互相独立——skills 缺席不挡数据面，反之亦然。
  */
-import { registerRoutes } from './host/routes.js';
-import { buildSkillRegistration } from './host/skill-registration.js';
+import { registerRoutes, registerSessionRoutes } 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) => {
@@ -24,6 +37,22 @@ export function apply(ctx) {
         registerRoutes(webServer, { registry });
         console.info('[task-ledger] 数据面路由已注册（/api/task-ledger/*）');
     });
+    // ── 会话交接（按钮侧「结束任务」，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）');
+    });
     // ── skill 全局注册（任务 2） ──
     // unscoped 注册落全局层，模型可 load；disposer 随插件 dispose 自动注销。
     ctx.inject(['skills'], (services) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-task-ledger",
-  "version": "0.0.45",
+  "version": "0.0.47",
   "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",
@@ -25,10 +25,11 @@
   ],
   "scripts": {
     "build": "npm run build:host && npm run build:client",
-    "build:host": "tsc && node scripts/copy-skill.mjs",
+    "build:host": "node scripts/clean-dist.mjs && tsc && node scripts/copy-skill.mjs",
     "build:client": "tsc --noEmit -p tsconfig.client.json && tsdown --config tsdown.client.config.ts",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.client.json",
-    "smoke": "node scripts/smoke.mjs"
+    "smoke": "node scripts/smoke.mjs",
+    "verify": "npm run build && npm run typecheck && npm run smoke"
   },
   "engines": {
     "node": ">=22.5"

package/dist/host/ledger-read.js

@@ -1,64 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import path from 'node:path';
-import { runLedgerScript } from './script.js';
-/**
- * LedgerFilter → skill 脚本参数（只拼调用方给了的；undefined 一律不拼，
- * 让脚本走自己的默认——插件不替脚本决定默认值）。
- */
-export function filterArgs(filter) {
-    const args = [];
-    if (filter.status !== undefined)
-        args.push('--status', filter.status);
-    if (filter.owner !== undefined)
-        args.push('--owner', filter.owner);
-    if (filter.category !== undefined)
-        args.push('--category', filter.category);
-    if (filter.tag !== undefined)
-        args.push('--tag', filter.tag);
-    if (filter.since !== undefined)
-        args.push('--since', filter.since);
-    if (filter.until !== undefined)
-        args.push('--until', filter.until);
-    if (filter.limit !== undefined)
-        args.push('--limit', String(filter.limit));
-    if (filter.months !== undefined)
-        args.push('--months', String(filter.months));
-    return args;
-}
-/**
- * 在办任务（包 `list --json`；结果打上 workspace）。
- * 脚本失败抛错——路由层转 500 + 人话，不静默返空（空 = 撒谎）。
- */
-export async function readTasks(workspace, filter = {}) {
-    const result = await runLedgerScript('list', ['--repo', workspace.path, '--json', ...filterArgs(filter)]);
-    if (!result.ok)
-        throw new Error(`${workspace.title}: ${result.error}`);
-    return Object.entries(result.data).map(([id, task]) => ({ ...task, id, workspace }));
-}
-/** 已结案记录（包 `history --json`；结果打上 workspace）。 */
-export async function readHistory(workspace, filter = {}) {
-    const result = await runLedgerScript('history', ['--repo', workspace.path, '--json', ...filterArgs(filter)]);
-    if (!result.ok)
-        throw new Error(`${workspace.title}: ${result.error}`);
-    return (result.data.records ?? []).map((record) => ({ ...record, workspace }));
-}
-/** 单条在办（展开行 / 详情用）。取不到回 null，不抛。 */
-export async function getTask(workspace, taskId) {
-    const rows = await readTasks(workspace);
-    return rows.find((row) => row.id === taskId) ?? null;
-}
-/**
- * 过程文档正文（`task.worklog` 相对 `ledger/` 的路径）。
- * 读不到回 null（文件被清 / 路径坏都不炸——由调用方展示「过程文档缺失」）。
- */
-export async function readWorklog(workspace, task) {
-    const relative = task.worklog;
-    if (relative === undefined || relative === null || relative === '')
-        return null;
-    try {
-        return await readFile(path.join(workspace.path, 'ledger', relative), 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}