dsh-task-dispatch-table 0.1.1 → 0.1.2

package/dist/dispatch.d.ts

@@ -78,6 +78,11 @@ export interface DispatchAttachment {
     /** link 型的工作区相对路径原文（基准未知时如实展示）。 */
     ref: string;
     path: string | null;
+    /**
+     * 该项是否为一整个**目录**（用户 2026-10-09：文件夹本身也能当附件）。
+     * 派发前 stat 得出，**不落库、不进快照**——服务侧刻意不区分目录与文件；测不出即缺位，按文件处理。
+     */
+    isDir?: boolean;
 }
 /**
  * 随附文件 → 官方 `file` 内容块（2026-10-03 拍板「附加文件走 A」）。

package/dist/dispatch.js

@@ -301,16 +301,27 @@ times) {
     lines.push(receiptInstruction(snapshot.validStatuses));
     return userNotice(lines.join('\n'), `[TASK] ${snapshot.title} · ${logicalDate}`, fileBlocks);
 }
-/** 随附文件段（用户 2026-09-30：必须让模型明确知道文件在哪一层、在什么地方）。 */
+/**
+ * 随附文件段（用户 2026-09-30：必须让模型明确知道文件在哪一层、在什么地方）。
+ *
+ * 段头那句「任务提示词里说的『附件 / 随附文件』就是指下面这些」是**用户称呼 → 绝对路径**的接缝
+ * （用户 2026-10-09：要在提示词里写「用附件里的 XX 执行」还能被找到）⇒ 没有它，模型只能靠文件名猜。
+ */
 function attachmentLines(list) {
     if (list.length === 0)
         return [];
-    const lines = ['', '本次随附文件（只读输入，请勿修改；以下均为可直接读取的绝对路径）：'];
+    const lines = ['', '本次随附文件（只读输入，请勿修改；以下均为可直接读取的绝对路径。任务提示词里说的「附件 / 随附文件」就是指下面这些）：'];
     for (const item of list) {
-        const tag = item.kind === 'upload' ? '上传' : '工作区';
-        lines.push(item.path === null
-            ? `  - ${item.name}（${tag}）：${item.ref}（基准工作区未知，为工作区相对路径）`
-            : `  - ${item.name}（${tag}）：${item.path}`);
+        const tag = item.isDir === true ? '目录' : (item.kind === 'upload' ? '上传' : '工作区');
+        if (item.path === null) {
+            lines.push(`  - ${item.name}（${tag}）：${item.ref}（基准工作区未知，为工作区相对路径）`);
+            continue;
+        }
+        // 目录路径尾补 '/'：与普通文件在字面上一眼分开，模型不会拿它当单文件去读。
+        lines.push(`  - ${item.name}（${tag}）：${item.path}${item.isDir === true ? '/' : ''}`);
+    }
+    if (list.some(item => item.isDir === true)) {
+        lines.push('标注「目录」的是一整个文件夹：需要里面某个文件时，按 <该项路径>/<相对路径> 拼出完整路径后再读取。');
     }
     return lines;
 }

package/dist/reconcile.js

@@ -6,6 +6,7 @@
 // 不读文件；跑完信号后无回执 → 宽限 → 追问×2 → 按失败收敛。
 // 唯一例外（决策 41 兼容口）：旧库实例无快照列值时，按 legacyTask 当场合成快照并固化（一次性
 // 兼容、带 warn）——兜底也不落库 ⇒ 无法发动 / 无法校验，如实按失败收敛，绝不静默。
+import { stat } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { displayNameOf, durationMs, sessionTitleOf } from './tasks.js';
@@ -382,7 +383,11 @@ export function createReconciler({ ctx, logger, store, options, runtime, emit })
             // 随附文件段（2026-09-30）：把快照里的附件 ref 解析成**绝对路径**随派发消息注入
             // （用户要求：必须让模型明确知道文件在哪一层、在什么地方）。与上面存在性校验同款口径——
             // link 按附件来源工作区、upload 按任务目录；解析不出 ⇒ path=null（如实标注，绝不猜）。
-            const attachments = (snap.attachments ?? []).map(item => {
+            // 同上口径 + **是否目录**（用户 2026-10-09：文件夹本身也能当附件）。
+            // ref 指的是目录还是文件，只有这一刻 stat 才知道——服务侧刻意不区分两者，schema / 快照零改动。
+            // stat 失败 ⇒ 按文件处理：缺失项已被上面的 missingSnapshotAttachments 拦掉，这里不该失败，
+            // 标错也只退化成旧文案，绝不阻断派发。
+            const attachments = await Promise.all((snap.attachments ?? []).map(async (item) => {
                 let path = null;
                 if (item.kind === 'upload') {
                     path = assets === null ? null : attachmentAbsPath(assets, instance.task_id, item.ref);
@@ -398,8 +403,9 @@ export function createReconciler({ ctx, logger, store, options, runtime, emit })
                 }
                 if (path !== null && path.includes('..'))
                     path = null;
-                return { name: item.name, kind: item.kind, ref: item.ref, path };
-            });
+                const isDir = path === null ? undefined : await stat(path).then(info => info.isDirectory()).catch(() => undefined);
+                return { name: item.name, kind: item.kind, ref: item.ref, path, isDir };
+            }));
             const { sessionId, handle } = await dispatchTask({
                 ctx, logger, store,
                 instanceId: instance.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-task-dispatch-table",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Scheduled task dispatcher: a dsh host plugin that drives recurring agent tasks from a single task table, dispatching each run as an independent dsh session (scheduling itself uses zero model calls)",
   "icon": "./assets/icon-scheduler.svg",
   "keywords": [