dsh-card-dispatch 0.0.0-stage → 0.1.1

package/src/prompts-llm.js

@@ -0,0 +1,104 @@
+/**
+ * prompts-llm.js：让模型按需求给每张卡写「提示词开头」。
+ *
+ * 结构不由模型决定（拆几张、哪几条判据一组仍由 split.js 的规则算），模型只写
+ * 每张卡开头那段「目标 / 范围 / 明确不要做什么」。这样账单可预期，
+ * 而且「完成要交证据」这类硬要求仍由我们确定性地拼在后面，不会被模型写丢。
+ */
+
+import { callModel, extractJsonObject, MODEL_TIMEOUT_MS } from './model-call.js'
+
+/** 一段开头最少多少字（太短就是没写）。 */
+const MIN_INTRO = 12
+
+/** 一段开头最多多少字（长了会挤掉判据与交付要求）。 */
+const MAX_INTRO = 900
+
+export const PROMPTS_SYSTEM = [
+  '你给任务卡写「提示词」的开头段：执行者会在一张新会话里读这段话干活，它看不到任何其它上下文。',
+  '只输出一个 JSON 对象，不要解释：{"cards":[{"key":"root","intro":"..."}]}',
+  '',
+  '每段 intro 写 3 到 6 行，依次说清：',
+  '- 目标：这一步要交付什么；',
+  '- 范围：只碰哪些文件 / 模块 / 场景；',
+  '- 不要做什么：最容易顺手做错的那一两件事。',
+  '',
+  '规则：',
+  '- key 必须原样使用给你的那一个，不要自己新增卡、不要合并卡。',
+  '- 每段都要自包含：不写「同上」「参见前面」，不引用别张卡才能看懂的话。',
+  '- 保留需求里出现的具体数字、型号、接口名；不要补需求没提的功能。',
+  '- 只写开头段，不要重复判据列表、不要写交付证据的要求（那些会由系统拼在后面）。',
+  '- 用需求本来使用的语言写。',
+].join('\n')
+
+/**
+ * 把「需求原文 + 这张卡负责什么」整理成给模型的一次提问。
+ *
+ * @param {object} input
+ * @param {string} input.requirement 需求原文（标题 + 描述）
+ * @param {Array<{key:string,title:string,criteriaIds?:Array<string>,scope?:string}>} input.cards
+ * @returns {string}
+ */
+export function buildBriefing({ requirement = '', cards = [] }) {
+  const cardLines = cards.map((card) => {
+    const ids = (card.criteriaIds ?? []).join('、')
+    return [
+      `- key: ${card.key}`,
+      `  卡片标题：${card.title}`,
+      ids === '' ? '  负责判据：无（这是协调 / 验卡）' : `  负责判据：${ids}`,
+      card.scope === undefined ? '' : `  说的范围：${card.scope}`,
+    ].filter((line) => line !== '').join('\n')
+  })
+  return [`需求原文：\n${requirement.trim()}`, '要写开头段的卡：', cardLines.join('\n')].join('\n\n')
+}
+
+/**
+ * 解析模型回复：只要 key 认得、字数够的段落。
+ *
+ * @param {string} reply
+ * @param {Array<string>} [allowedKeys]
+ * @returns {Record<string,string>}
+ */
+export function parsePromptsReply(reply, allowedKeys) {
+  const payload = extractJsonObject(reply)
+  const raw = Array.isArray(payload?.cards) ? payload.cards : []
+  const allowed = Array.isArray(allowedKeys) && allowedKeys.length > 0 ? new Set(allowedKeys) : undefined
+  const out = {}
+  for (const item of raw) {
+    const key = String(item?.key ?? '').trim()
+    if (key === '') continue
+    if (allowed !== undefined && !allowed.has(key)) continue
+    if (Object.prototype.hasOwnProperty.call(out, key)) continue
+    const intro = String(item?.intro ?? '').replace(/\r/g, '').trim().slice(0, MAX_INTRO)
+    if (intro.length < MIN_INTRO) continue
+    out[key] = intro
+  }
+  return out
+}
+
+/**
+ * 给这些卡写开头段。
+ *
+ * @param {object} input
+ * @param {any} input.llm
+ * @param {{provider:string, model:string}} input.route
+ * @param {string} input.requirement
+ * @param {Array<{key:string,title:string,criteriaIds?:Array<string>,scope?:string}>} input.cards
+ * @param {number} [input.timeoutMs]
+ * @returns {Promise<{ok:boolean, intros:Record<string,string>, error:string|null}>}
+ */
+export async function writeCardIntros({ llm, route, requirement = '', cards = [], timeoutMs = MODEL_TIMEOUT_MS } = {}) {
+  if (cards.length === 0) return { ok: false, intros: {}, error: '没有要写提示词的卡' }
+  const reply = await callModel({
+    llm,
+    route,
+    system: PROMPTS_SYSTEM,
+    text: buildBriefing({ requirement, cards }),
+    timeoutMs,
+  })
+  if (!reply.ok) return { ok: false, intros: {}, error: reply.error }
+  const intros = parsePromptsReply(reply.reply, cards.map((card) => card.key))
+  const written = Object.keys(intros).length
+  if (written === 0) return { ok: false, intros: {}, error: '模型没写出可用的提示词（回复不是约定的 JSON 或太短）' }
+  return { ok: true, intros, error: written < cards.length ? `有 ${cards.length - written} 张卡的提示词没写成，按模板补` : null }
+}

package/src/rework-store.js

@@ -0,0 +1,69 @@
+/**
+ * rework-store.js：把「这一批已经打回了几次」**落到磁盘**。
+ *
+ * 为什么不能只放页面内存：R3 要求「第三次打回必须升级给人」。以前计数只活在一个
+ * JS 变量里，刷新页面/重开面板就归零，等于这条上限可以被无限绕过。
+ *
+ * 存哪儿：`<dataDir>/rework.json`，按 `rootId` 记一个很小的对象。
+ * 和 config.json 一样：读失败当空、写失败要报错（写不进去就不能假装限流生效）。
+ *
+ * @module dsh-card-dispatch/rework-store
+ */
+
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+
+/**
+ * @param {object} options
+ * @param {string} options.dir dataDir（相对宿主 cwd，和 config.json 同一个目录）
+ */
+export function createReworkStore({ dir }) {
+  const root = resolve(dir)
+  const file = join(root, 'rework.json')
+
+  /** @returns {Record<string, {count:number, updatedAt:string}>} */
+  function loadAll() {
+    try {
+      const parsed = JSON.parse(readFileSync(file, 'utf8'))
+      if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) return {}
+      return parsed
+    } catch {
+      // 文件不存在 / 被手改成半截 JSON：都当「没有记录」，不能因此让面板挂掉
+      return {}
+    }
+  }
+
+  /**
+   * 这一批已经打回了几次。
+   *
+   * @param {string} rootId
+   * @returns {number}
+   */
+  function get(rootId) {
+    const entry = loadAll()[rootId]
+    const count = Number(entry?.count)
+    return Number.isFinite(count) && count > 0 ? Math.trunc(count) : 0
+  }
+
+  /**
+   * 写回计数；0 表示清掉记录（验收通过）。
+   *
+   * @param {string} rootId
+   * @param {number} count
+   * @returns {number}
+   */
+  function set(rootId, count) {
+    const value = Math.max(0, Math.trunc(Number(count) || 0))
+    const all = loadAll()
+    if (value === 0) {
+      delete all[rootId]
+    } else {
+      all[rootId] = { count: value, updatedAt: new Date().toISOString() }
+    }
+    mkdirSync(root, { recursive: true })
+    writeFileSync(file, `${JSON.stringify(all, null, 2)}\n`, 'utf8')
+    return value
+  }
+
+  return { file, get, set }
+}

package/src/selfcheck.js

@@ -0,0 +1,117 @@
+/**
+ * selfcheck.js：开机体检，纯函数。
+ *
+ * 为什么要体检而不是「自动纠正」：插件改不了部署设置（委派深度、权限预设、计费），
+ * 偷偷改配置只会让人以为组织图能跑、实际跑到一半才炸。所以这里的产出是**结论 + 一句
+ * 该怎么办**，由面板和启动日志展示。
+ *
+ * 判据只有一条：**fatal 必须为零**。warn 是「能跑但会难受」，info 是「知道了就行」。
+ *
+ * facts 全部由调用方注入（不在这里读盘/读宿主），这样每条分支都能被单测锁住。
+ */
+
+/**
+ * @typedef {object} Facts
+ * @property {number|null} [subagentDepthMax] 部署允许的最大子智能体递归深度；未知传 null
+ * @property {boolean|null} [boardReachable] 任务看板 HTTP 是否可达；未知传 null
+ * @property {boolean|null} [boardTeamRun] 看板是否支持 teamRun 卡片（父卡起 Lead）
+ * @property {number|null} [workspaceCount] 已知工作区数量
+ */
+
+const FINDINGS = Object.freeze({
+  'ORG-DEPTH': {
+    severity: 'fatal',
+    title: '委派深度不足，主管带不了人',
+    hint: '设置 → 子智能体 → 最大递归深度 改成 2（0 = 禁用、1 = 只有主 Agent 能派生）',
+  },
+  'ORG-DEPTH-UNKNOWN': {
+    severity: 'warn',
+    title: '委派深度未知',
+    hint: '到 设置 → 子智能体 确认「最大递归深度」是否为 2；插件读不到这个部署设置，只能提示',
+  },
+  'BOARD-UNREACHABLE': {
+    severity: 'warn',
+    title: '执行层（任务看板）不可达',
+    hint: '插件只产出计划与卡片；看板不可达时卡片发不出去，确认 @linxin666/dsh-client-ui-task-board 已启用',
+  },
+  'BOARD-UNKNOWN': {
+    severity: 'info',
+    title: '执行层可达性未检测',
+    hint: '在面板点一次「体检」即可拿到结果（会发一个只读请求，不花钱）',
+  },
+  'TEAMRUN-UNSUPPORTED': {
+    severity: 'warn',
+    title: '看板不支持 teamRun',
+    hint: '关闭 execution.teamRun，退化为普通级联；否则父卡不会起 Lead，主管层不存在',
+  },
+  'NO-WORKSPACE': {
+    severity: 'warn',
+    title: '没有指定工作区',
+    hint: '卡片不钉工作区时会回退到「最近改动的那个」，对自动跑卡是隐患；在面板里显式选一个',
+  },
+  'PLAN-GATE-OFF': {
+    severity: 'warn',
+    title: '计划闸关着但总开关开着',
+    hint: '还没批准的计划也会直接开跑 = 直接花钱；建议保持 gates.requirePlanApproval = true',
+  },
+  'EVIDENCE-OFF': {
+    severity: 'warn',
+    title: '交付门槛关着',
+    hint: '没有 commit / 报告也算完成，自动跑卡时无法复核；建议保持 gates.requireEvidence = true',
+  },
+  DISABLED: {
+    severity: 'info',
+    title: '总开关关闭',
+    hint: '当前只做拆分与填卡，不会开任何会话、不产生费用',
+  },
+})
+
+/**
+ * 跑一遍体检。
+ *
+ * @param {object} input
+ * @param {object} input.config 归一化配置（决定「应该是什么样」）
+ * @param {Facts} [input.facts] 外部注入的事实（决定「实际是什么样」）
+ * @returns {{ok:boolean, findings:Array<object>}}
+ */
+export function runSelfCheck({ config, facts = {} } = {}) {
+  const findings = []
+  const add = (id, detail) => {
+    const base = FINDINGS[id]
+    if (!base) return
+    findings.push({ id, severity: base.severity, title: base.title, detail, hint: base.hint })
+  }
+
+  const requiredDepth = config.org?.depthRequired ?? 2
+  const depth = facts.subagentDepthMax
+  if (depth === null || depth === undefined) {
+    add('ORG-DEPTH-UNKNOWN', `插件读不到部署的子智能体深度，按需要 ${requiredDepth} 层处理`)
+  } else if (Number(depth) < requiredDepth) {
+    add('ORG-DEPTH', `当前最大递归深度 ${depth}，低于所需的 ${requiredDepth}：成员（主管）无法再派生部门人员`)
+  }
+
+  const board = facts.boardReachable
+  if (board === false) add('BOARD-UNREACHABLE', '调用 /api/task-board 失败')
+  else if (board === null || board === undefined) add('BOARD-UNKNOWN', '尚未探测')
+
+  if (facts.boardTeamRun === false && config.execution?.teamRun === true) {
+    add('TEAMRUN-UNSUPPORTED', '已要求 teamRun 卡片，但看板侧没有这个能力')
+  }
+
+  if (facts.workspaceCount === 0) {
+    add('NO-WORKSPACE', '工作区列表为空')
+  }
+
+  if (config.enabled === true && config.gates?.requirePlanApproval !== true) {
+    add('PLAN-GATE-OFF', 'enabled=true 且 requirePlanApproval=false')
+  }
+  if (config.enabled === true && config.gates?.requireEvidence !== true) {
+    add('EVIDENCE-OFF', 'enabled=true 且 requireEvidence=false')
+  }
+  if (config.enabled !== true) {
+    add('DISABLED', 'enabled=false')
+  }
+
+  const ok = findings.every((item) => item.severity !== 'fatal')
+  return { ok, findings }
+}