dsh-worktodo 0.1.0 → 0.2.0

package/src/tools.mjs

@@ -1,3 +1,5 @@
+import { parseNaturalDue } from './parse-due.mjs';
+
 /**
  * 面向模型的 worktodo_* 工具。
  *
@@ -22,6 +24,7 @@
  */
 export const TOOL_NAMES = Object.freeze([
   'worktodo_add',
+  'worktodo_add_many',
   'worktodo_list',
   'worktodo_update',
   'worktodo_done',
@@ -89,6 +92,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
     parameters: {
       title: { type: 'string', required: true, description: '待办内容，一句简短的祈使句，例如「把 v0.1.0 发到 npm」。' },
       due: { type: 'string', description: '截止日期：YYYY-MM-DD / today / tomorrow / +3d。省略表示没有截止日期。' },
+      dueTime: { type: 'string', description: '截止时间 HH:MM（可选，只有给了 due 才有意义；例如 14:30）。' },
       priority: { type: 'string', enum: ['high', 'normal', 'low'], description: '优先级，默认 normal。真正卡住别人的事才给 high。' },
       project: { type: 'string', description: '项目或领域标签，例如 dsh-worktodo。省略表示不归类。' },
       notes: { type: 'string', description: '补充说明：背景、链接、验收标准。默认空。' },
@@ -102,6 +106,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
           id: { type: 'string', required: true },
           title: { type: 'string', required: true },
           due: { type: 'string' },
+          dueTime: { type: 'string' },
           priority: { type: 'string', required: true },
           project: { type: 'string' },
           status: { type: 'string', required: true },
@@ -110,15 +115,16 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
       },
       render: (_args, value) => [{
         type: 'text',
-        text: `已记入工作待办：${value.title}（${value.id}${value.due ? `，截止 ${value.due}` : ''}）`
+        text: `已记入工作待办：${value.title}（${value.id}${value.due ? `，截止 ${value.due}${value.dueTime ? ` ${value.dueTime}` : ''}` : ''}）`
           + (value.stats ? `｜当前未完成 ${value.stats.open} 条，逾期 ${value.stats.overdue} 条` : ''),
       }],
     },
     execute(args) {
-      return service.create(args, { source: 'agent' }).then(unwrap).then((result) => withStats(compact({
+      return service.create(withParsedDue(args), { source: 'agent' }).then(unwrap).then((result) => withStats(compact({
         id: result.todo.id,
         title: result.todo.title,
         due: result.todo.due ?? undefined,
+        dueTime: result.todo.dueTime ?? undefined,
         priority: result.todo.priority,
         project: result.todo.project ?? undefined,
         status: result.todo.status,
@@ -127,6 +133,112 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
     presentCall: (args) => ({ card: 'generic', title: '登记工作待办', kind: 'other', rawInput: args.title }),
   })));
 
+  // ---- 批量新增（AI 友好：一口气登记多条）----
+  disposers.push(ctx.tools.register(defineTool({
+    name: 'worktodo_add_many',
+    description:
+      '一次登记多条工作待办（用户一口气说了好几件事、或你整理出一串要跟进的活时用它；分开一条条调 worktodo_add 也行，但这样更省调用）。'
+      + '某条不合法只跳过那一条并把原因回传，不影响其余条目。',
+    parameters: {
+      items: {
+        type: 'array',
+        required: true,
+        description: '要登记的事；每项至少给 title。',
+        items: {
+          type: 'object',
+          additionalProperties: false,
+          properties: {
+            title: { type: 'string', required: true, description: '待办内容（一句简短的祈使句）。' },
+            due: { type: 'string', description: '截止日期：YYYY-MM-DD / today / tomorrow / +3d。' },
+            dueTime: { type: 'string', description: '截止时间 HH:MM（可选）。' },
+            priority: { type: 'string', enum: ['high', 'normal', 'low'], description: '默认 normal。' },
+            project: { type: 'string', description: '项目或领域标签。' },
+            notes: { type: 'string', description: '背景、链接、验收标准。' },
+            status: { type: 'string', enum: ['pending', 'in_progress', 'completed'], description: '默认 pending。' },
+          },
+        },
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          count: { type: 'number', required: true },
+          created: {
+            type: 'array',
+            required: true,
+            items: {
+              type: 'object',
+              additionalProperties: false,
+              properties: {
+                id: { type: 'string', required: true },
+                title: { type: 'string', required: true },
+                due: { type: 'string' },
+                dueTime: { type: 'string' },
+                priority: { type: 'string', required: true },
+                project: { type: 'string' },
+                status: { type: 'string', required: true },
+              },
+            },
+          },
+          skipped: {
+            type: 'array',
+            required: true,
+            items: {
+              type: 'object',
+              additionalProperties: false,
+              properties: {
+                index: { type: 'number', required: true },
+                title: { type: 'string', required: true },
+                reason: { type: 'string', required: true },
+              },
+            },
+          },
+          stats: { type: 'object', additionalProperties: true },
+        },
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: `已记入工作待办 ${value.count} 条`
+          + (value.skipped.length ? `，跳过 ${value.skipped.length} 条（${value.skipped.map((entry) => `#${entry.index} ${entry.reason}`).join('；')}）` : '')
+          + (value.stats ? `｜当前未完成 ${value.stats.open} 条，逾期 ${value.stats.overdue} 条` : ''),
+      }],
+    },
+    async execute(args) {
+      const created = [];
+      const skipped = [];
+      const items = Array.isArray(args.items) ? args.items : [];
+      for (const [index, item] of items.entries()) {
+        try {
+          const result = unwrap(await service.create(withParsedDue(item ?? {}), { source: 'agent' }));
+          created.push(compact({
+            id: result.todo.id,
+            title: result.todo.title,
+            due: result.todo.due ?? undefined,
+            dueTime: result.todo.dueTime ?? undefined,
+            priority: result.todo.priority,
+            project: result.todo.project ?? undefined,
+            status: result.todo.status,
+          }));
+        } catch (error) {
+          skipped.push({
+            index,
+            title: typeof item?.title === 'string' ? item.title : '',
+            reason: String(error?.message ?? error),
+          });
+        }
+      }
+      return withStats(compact({ count: created.length, created, skipped }));
+    },
+    presentCall: (args) => ({
+      card: 'generic',
+      title: `登记 ${Array.isArray(args.items) ? args.items.length : 0} 条工作待办`,
+      kind: 'other',
+      rawInput: '',
+    }),
+  })));
+
   // ---- 查询 ----
   disposers.push(ctx.tools.register(defineTool({
     name: 'worktodo_list',
@@ -138,6 +250,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
       filter: { type: 'string', enum: ['open', 'today', 'overdue', 'week', 'doing', 'completed', 'all'], description: '默认 open（未完成）。' },
       project: { type: 'string', description: '只看某个项目标签。' },
       query: { type: 'string', description: '按标题或备注里的关键词过滤。' },
+      sort: { type: 'string', enum: ['manual', 'priority', 'created'], description: '排序：manual=尊重用户拖动过的顺序（默认，用户看到的顺序）；priority=高优先级在前；created=最近添加的在前。' },
     },
     output: {
       schema: {
@@ -156,7 +269,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
         lines: result.todos.length
           ? result.todos.map((t) => {
             const box = t.status === 'completed' ? '[x]' : t.status === 'in_progress' ? '[~]' : '[ ]';
-            const bits = [t.priority === 'high' ? '高' : t.priority === 'low' ? '低' : null, t.due ? `${t.due}${t.due < result.today && t.status !== 'completed' ? '(逾期)' : ''}` : null, t.project ? `#${t.project}` : null].filter(Boolean);
+            const bits = [t.priority === 'high' ? '高' : t.priority === 'low' ? '低' : null, t.due ? `${t.due}${t.dueTime ? ` ${t.dueTime}` : ''}${t.due < result.today && t.status !== 'completed' ? '(逾期)' : ''}` : null, t.project ? `#${t.project}` : null].filter(Boolean);
             return `${box} ${t.id}  ${t.title}${bits.length ? `  (${bits.join(', ')})` : ''}`;
           }).join('\n')
           : '（没有符合条件的待办）',
@@ -177,7 +290,8 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
     parameters: {
       ref: { type: 'string', required: true, description: '待办的 id（推荐）或标题。' },
       title: { type: 'string', description: '新标题。' },
-      due: { type: 'string', description: '新截止日期；传 none 清空。' },
+      due: { type: 'string', description: '新截止日期；传 none 清空（清空日期会一并清掉时间）。' },
+      dueTime: { type: 'string', description: '新截止时间 HH:MM；传 none 清空。' },
       priority: { type: 'string', enum: ['high', 'normal', 'low'] },
       project: { type: 'string', description: '新项目标签；传 none 清空。' },
       notes: { type: 'string', description: '新备注。' },
@@ -342,4 +456,23 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
       }
     },
   };
+}/**
+ * 让工具也能"说人话"：标题里写了「明天下午三点」这类说法时，交给与面板**同一份**解析器
+ * （`src/parse-due.mjs`）。显式传了 `due` 就以显式为准，绝不被标题覆盖。
+ * @param {object} input
+ * @returns {object} 落库用的参数（标题里的日期词会被摘掉）
+ */
+export function withParsedDue(input = {}) {
+  const explicit = input.due !== undefined && input.due !== null && input.due !== '';
+  if (explicit) return input;
+  const parsed = parseNaturalDue(String(input.title ?? ''), Date.now());
+  if (!parsed.matched.length) return input;
+  return {
+    ...input,
+    title: parsed.title,
+    due: parsed.due ?? undefined,
+    dueTime: input.dueTime ?? parsed.dueTime ?? undefined,
+  };
 }
+
+