dsh-task-ledger 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
2
2
  * 数据面路由薄壳:只做协议(参数解析 + JSON 响应 + 错误转 500),
3
3
  * 一行业务逻辑都不多写——全部调 service(2026-10-17 定稿)。
4
4
  * 宿主事实(handler = 原始 Node req/res、发头后不抛错、重复 path 注册直接 throw)
5
- * 见 external/host-webserver.md。
5
+ * 见 docs/dependencies/host-webserver.md。
6
6
  *
7
7
  * 2026-10-28 收敛:界面只有 8 个统计卡 + 在办列表 ⇒ 只注册 `/workspaces` 与 `/board/snapshot`。
8
8
  * 详情 / 历史 / 筛选项 / 趋势 / 写动作的端点与实现已删除(要接回按 skill 方法重写,不复用旧直读逻辑)。
@@ -10,7 +10,7 @@
10
10
  import type { IncomingMessage, ServerResponse } from "node:http";
11
11
  import { type AgentDefaultModelLike, type AgentPresetsLike, type AgentsLike, type SessionTitleLike } from "./services/continue.service.js";
12
12
  import type { RegistryWorkspace } from "./types.js";
13
- /** 宿主 webServer.register 的最小面(WebRoute 形状见 external/host-webserver.md)。 */
13
+ /** 宿主 webServer.register 的最小面(WebRoute 形状见 docs/dependencies/host-webserver.md)。 */
14
14
  export interface WebServerLike {
15
15
  register(route: {
16
16
  kind: "exact" | "prefix";
@@ -18,7 +18,7 @@ export interface WebServerLike {
18
18
  handler: (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
19
19
  }): unknown;
20
20
  }
21
- /** 宿主 workspaceRegistry 的最小面(事实见 external/dsh-workspace-registry.md)。 */
21
+ /** 宿主 workspaceRegistry 的最小面(事实见 docs/dependencies/dsh-workspace-registry.md)。 */
22
22
  export interface WorkspaceRegistryLike {
23
23
  list(): readonly RegistryWorkspace[];
24
24
  }
@@ -5,7 +5,7 @@
5
5
  * (`dsh-client-ui-conversation` `contract/input.d.ts:165`,经 `SessionInputResolver.for(actx)` 取),
6
6
  * 根级 client 插件拿不到某个会话的 `actx`;按 id 取的 `input.shell()` 是包内部件。
7
7
  * 且任务↔会话之间没有绑定字段 ⇒「往哪个会话塞」本身没有答案。链路事实见
8
- * `docs/design/external/dsh-session-handoff.md`,兄弟插件实证 `dsh-task-dispatch-table/src/dispatch.ts:519/562/627`。
8
+ * `docs/dependencies/dsh-session-handoff.md`,兄弟插件实证 `dsh-task-dispatch-table/src/dispatch.ts:519/562/627`。
9
9
  *
10
10
  * 三条硬约束(宿主 rc 线的坑,缺一条就是"会话建了但没法干活"):
11
11
  * 1. `setup` 里必须 `agentPresets.mount()` —— 不挂 preset 的 agent 落到空的全局层,fs / bash 全无;
@@ -5,7 +5,7 @@
5
5
  * (`dsh-client-ui-conversation` `contract/input.d.ts:165`,经 `SessionInputResolver.for(actx)` 取),
6
6
  * 根级 client 插件拿不到某个会话的 `actx`;按 id 取的 `input.shell()` 是包内部件。
7
7
  * 且任务↔会话之间没有绑定字段 ⇒「往哪个会话塞」本身没有答案。链路事实见
8
- * `docs/design/external/dsh-session-handoff.md`,兄弟插件实证 `dsh-task-dispatch-table/src/dispatch.ts:519/562/627`。
8
+ * `docs/dependencies/dsh-session-handoff.md`,兄弟插件实证 `dsh-task-dispatch-table/src/dispatch.ts:519/562/627`。
9
9
  *
10
10
  * 三条硬约束(宿主 rc 线的坑,缺一条就是"会话建了但没法干活"):
11
11
  * 1. `setup` 里必须 `agentPresets.mount()` —— 不挂 preset 的 agent 落到空的全局层,fs / bash 全无;
@@ -20,8 +20,7 @@ export interface SkillsRegistry {
20
20
  * 组装注册体:读内嵌 SKILL.md → 取 name / description → 正文里的脚本路径占位符
21
21
  * 替换为绝对路径。
22
22
  *
23
- * 相对资源解析的二选一(external/dsh-skill-registration.md §三)**未拍板**;
24
- * 最小闭环选「插值绝对路径」——resourceBase 的消费者呈现未验证,不押注。
25
- * 拍板后如改走 resourceBase,只动本函数,调用方无感。
23
+ * 相对资源解析见 docs/dependencies/dsh-skill-registration.md:本实现选「插值绝对路径」,
24
+ * resourceBase 的消费者呈现未验证,不押注。若改走 resourceBase,只动本函数,调用方无感。
26
25
  */
27
26
  export declare function buildSkillRegistration(skillDir?: string): SkillRegistration;
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * 内嵌 skill 的注册体组装(任务 2「skill 注册最小闭环」)。
3
- * 宿主事实(0.2.0-rc.2 npm pack 亲验):external/dsh-skill-registration.md。
3
+ * 宿主事实(0.2.0-rc.2 npm pack 亲验):docs/dependencies/dsh-skill-registration.md。
4
4
  */
5
5
  import { readFileSync } from "node:fs";
6
6
  import { fileURLToPath } from "node:url";
@@ -31,9 +31,8 @@ function parseFrontmatter(text) {
31
31
  * 组装注册体:读内嵌 SKILL.md → 取 name / description → 正文里的脚本路径占位符
32
32
  * 替换为绝对路径。
33
33
  *
34
- * 相对资源解析的二选一(external/dsh-skill-registration.md §三)**未拍板**;
35
- * 最小闭环选「插值绝对路径」——resourceBase 的消费者呈现未验证,不押注。
36
- * 拍板后如改走 resourceBase,只动本函数,调用方无感。
34
+ * 相对资源解析见 docs/dependencies/dsh-skill-registration.md:本实现选「插值绝对路径」,
35
+ * resourceBase 的消费者呈现未验证,不押注。若改走 resourceBase,只动本函数,调用方无感。
37
36
  */
38
37
  export function buildSkillRegistration(skillDir = SKILL_DIR) {
39
38
  const text = readFileSync(`${skillDir}/SKILL.md`, "utf-8");
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * 后端方法共享类型。
3
3
  * 宿主能力(workspaceRegistry / webServer 等)的结构面在 index.ts 与 routes.ts 本地声明——
4
- * 不 import 官方包(参考插件同款纪律:宿主 rc 接口会无声变,结构化声明 + external/ 文档坐标
5
- * 比绑死官方类型更稳)。
4
+ * 不 import 官方包(参考插件同款纪律:宿主 rc 接口会无声变,结构化声明 + `docs/dependencies/`
5
+ * 下的已核实事实比绑死官方类型更稳)。
6
6
  */
7
7
  import type { DegradedInfo } from "./errors.js";
8
8
  /** 一个可看的台账:机器级清单里的一条(已去掉隐藏)。 */
@@ -16,7 +16,7 @@ export interface LedgerWorkspace {
16
16
  }
17
17
  /**
18
18
  * 宿主 `workspaceRegistry.list()` 条目的最小面(结构声明;事实与坐标见
19
- * external/dsh-workspace-registry.md)。它现在只承担「替台账清单补登记」一件事。
19
+ * docs/dependencies/dsh-workspace-registry.md)。它现在只承担「替台账清单补登记」一件事。
20
20
  */
21
21
  export interface RegistryWorkspace {
22
22
  readonly id: string;
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 后端方法共享类型。
3
3
  * 宿主能力(workspaceRegistry / webServer 等)的结构面在 index.ts 与 routes.ts 本地声明——
4
- * 不 import 官方包(参考插件同款纪律:宿主 rc 接口会无声变,结构化声明 + external/ 文档坐标
5
- * 比绑死官方类型更稳)。
4
+ * 不 import 官方包(参考插件同款纪律:宿主 rc 接口会无声变,结构化声明 + `docs/dependencies/`
5
+ * 下的已核实事实比绑死官方类型更稳)。
6
6
  */
7
7
  export {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-task-ledger",
3
- "version": "0.1.5",
3
+ "version": "0.1.7",
4
4
  "description": "Tasks are created, claimed, advanced and closed by the agent and written straight into a plain-text ledger in the workspace, so the owner, the current state and the next step are always on record. It is not limited to development work — research, documentation, presentations and video production all fit. No cloud service is involved: everything is managed locally. Single-user and multi-user both work, with Git synchronisation, and every action is on record. The control panel summarises in-flight, overdue and stalled work with weekly trends.",
5
5
  "icon": "./assets/icon.svg",
6
6
  "keywords": [
@@ -65,6 +65,6 @@
65
65
  },
66
66
  "dependencies": {
67
67
  "@deepseek-ai/schemastery": "^3.18.5",
68
- "dsh-plugin-core": "^0.35.3"
68
+ "dsh-plugin-core": "^0.35.7"
69
69
  }
70
70
  }