@godv61/dsh-task-engine 0.14.0 → 0.17.0

package/lib/workflows.js

@@ -0,0 +1,122 @@
+/**
+ * Built-in engineering workflows. A workflow is a complete, engine-resolved
+ * `WorkflowConfig` a project adopts by id: the stage graph, transition guards,
+ * artifacts, commit rule, and default skill/rule bindings are all baked in
+ * here. A project overrides only its stage bindings (which skill/rule each
+ * node mounts); every other field is a fixed property of the chosen preset, so
+ * a project cannot hand-edit the gate semantics.
+ *
+ * @module dsh-task-engine/workflows
+ */
+/** The selectable preset workflows (shown in the workbench flow picker). */
+export const FLOW_OPTIONS = [
+    { id: 'standard', label: '标准研发', description: '需求评审 → 设计 → 开发 → 交付 → 代码审核，含产物门 + 确认门' },
+    { id: 'agile', label: '敏捷轻量', description: '需求 → 开发 → 交付 → 审查，四阶段、少产物' },
+    { id: 'minimal', label: '纯代码', description: '开发 → 交付，两阶段，只留提交门禁' },
+];
+/** Standard review-gated delivery: the default workflow. */
+const STANDARD = {
+    stages: ['需求评审', '设计', '开发', '交付', '代码审核', '完成'],
+    start_stage: '需求评审',
+    transitions: [
+        { from: '需求评审', to: '设计', requires: ['requirement_confirmation', 'artifacts_present'] },
+        { from: '设计', to: '开发', requires: ['solution_confirmation', 'artifacts_present'] },
+        { from: '开发', to: '交付', requires: ['todos_done'] },
+        { from: '交付', to: '代码审核', requires: ['verified'] },
+        { from: '代码审核', to: '完成', requires: ['review_passed', 'artifacts_present'] },
+    ],
+    artifacts: [
+        { stage: '需求评审', id: 'requirement', name: '需求说明', fields: ['scope', 'acceptance_criteria'] },
+        { stage: '设计', id: 'design', name: '设计文档', fields: ['approach', 'risks', 'impact'] },
+        { stage: '代码审核', id: 'review', name: '评审记录', fields: ['conclusion', 'issues'] },
+    ],
+    commit: {
+        policy: 'task',
+        message_pattern: '^【(\\S+)】【(?:TASK|T\\d+)】.+',
+        message_hint: '【<module>】【TASK/T1】说明 —— 写结果，不写空泛动作',
+        checkpoints: ['交付'],
+        file_scope: true,
+    },
+    high_risk_requires_verification: true,
+    stage_bindings: {
+        '需求评审': { skills: ['requirement-analysis'], rules: ['security-redlines'] },
+        '设计': { skills: ['solution-design'] },
+        '开发': { skills: ['code-implement'], rules: ['coding-conventions'] },
+        '交付': { skills: ['code-verify', 'code-commit'], rules: ['coding-conventions', 'commit-conventions'] },
+        '代码审核': { skills: ['code-review'], rules: ['security-redlines'] },
+    },
+};
+/** Lighter four-stage flow with few artifacts, for fast-moving projects. */
+const AGILE = {
+    stages: ['需求', '开发', '交付', '审查'],
+    start_stage: '需求',
+    transitions: [
+        { from: '需求', to: '开发', requires: ['requirement_confirmation'] },
+        { from: '开发', to: '交付', requires: ['todos_done'] },
+        { from: '交付', to: '审查', requires: [] },
+    ],
+    artifacts: [
+        { stage: '需求', id: 'requirement', name: '需求说明', fields: ['scope'] },
+    ],
+    commit: {
+        policy: 'item',
+        message_pattern: '^【(\\S+)】【T\\d+】.+',
+        message_hint: '【<module>】【T1】说明',
+        checkpoints: ['交付'],
+        file_scope: true,
+    },
+    high_risk_requires_verification: false,
+    stage_bindings: {
+        '需求': { skills: ['requirement-analysis'] },
+        '开发': { skills: ['code-implement'], rules: ['coding-conventions'] },
+        '交付': { skills: ['code-verify', 'code-commit'], rules: ['commit-conventions'] },
+        '审查': { skills: ['code-review'] },
+    },
+};
+/** Minimal two-stage flow: only a commit gate, no artifact doors. */
+const MINIMAL = {
+    stages: ['开发', '交付'],
+    start_stage: '开发',
+    transitions: [
+        { from: '开发', to: '交付', requires: ['todos_done'] },
+    ],
+    artifacts: [],
+    commit: {
+        policy: 'task',
+        message_pattern: '',
+        message_hint: '无格式要求',
+        checkpoints: ['交付'],
+        file_scope: false,
+    },
+    high_risk_requires_verification: false,
+    stage_bindings: {
+        '开发': { skills: ['code-implement'] },
+        '交付': { skills: ['code-commit'], rules: ['commit-conventions'] },
+    },
+};
+export const FLOW_CONFIGS = {
+    standard: STANDARD,
+    agile: AGILE,
+    minimal: MINIMAL,
+};
+/** Whether `flow` names a built-in workflow. */
+export function isKnownFlow(flow) {
+    return Object.prototype.hasOwnProperty.call(FLOW_CONFIGS, flow);
+}
+/**
+ * Resolve a preset workflow plus a project's stage-binding override into the
+ * complete engine config. Unknown `flow` ids fall back to `standard` when
+ * reading (a stale file must not break the gate); writes reject unknown ids
+ * before calling this.
+ * @param flow - workflow id from the project's `.dsh/eng.json`.
+ * @param override - optional whole `stage_bindings` map replacing the preset default.
+ * @returns the resolved workflow, always structurally complete.
+ */
+export function resolveFlowConfig(flow, override) {
+    const base = FLOW_CONFIGS[flow] ?? STANDARD;
+    if (override?.stage_bindings !== undefined) {
+        return { ...base, stage_bindings: { ...override.stage_bindings } };
+    }
+    return base;
+}
+//# sourceMappingURL=workflows.js.map

package/lib/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@godv61/dsh-task-engine",
-  "version": "0.14.0",
-  "description": "Config-driven engineering delivery engine for DeepSeek Harness: a `dev_task` tool that hard-gates workflow stage transitions and commit scope/message, stage-level skill/rule bindings with progressive disclosure, a full-screen workbench to edit each workspace's flow, and preset-scoped activation — the tool and skills activate only for sessions on a preset that names the agent row.",
+  "version": "0.17.0",
+  "description": "Preset-workflow engineering delivery engine for DeepSeek Harness: a `dev_task` tool that hard-gates stage transitions and commit scope/message, per-node skill/rule bindings with progressive disclosure, a workbench to pick a flow preset and mount skills/rules, and preset-scoped activation — the tool and skills activate only for sessions on a preset that names the agent row.",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -30,6 +30,7 @@
     "skills/**",
     "rules/**",
     "preset/**",
+    "docs/**",
     "README.md"
   ],
   "license": "MIT",

package/rules/coding-conventions.md

@@ -1,6 +1,6 @@
 # 通用编码规范
 
-- 复用相邻实现与现有类；单一调用方不为形式统一新增接口、Impl、DTO/VO、异常包装。
+- 复用相邻实现与现有代码；单一调用方不为形式统一新增抽象层、包装层或额外分层。
 - 禁止空 catch、printStackTrace、调试输出；吞错必须写清原因。
 - 禁止无条件全表更新、删除或无边界查询。
 - 命名清晰表达意图；不引入超过当前技术基线的语法、框架或 API。

package/rules/security-redlines.md

@@ -3,4 +3,4 @@
 - 禁止读取、展示或修改密码、Token、私钥和生产凭据。
 - 禁止把敏感请求体、文件正文或凭据写入日志。
 - 禁止用户输入直接拼接 SQL、表名、列名、排序、路径或命令。
-- 禁止 Controller 直接调用 Mapper；权限与核心业务校验不能只放在前端。
+- 权限与关键业务校验必须在服务端执行，前端校验不是安全边界。

package/skills/eng-delivery/SKILL.md

@@ -6,7 +6,11 @@ whenToUse: 开始任何开发、改 bug、加功能、代码评审或提交任
 
 # 工程化交付
 
-`dev_task` 工具是流程的唯一事实来源与硬约束。阶段、流转门槛、提交格式来自项目根 `.dsh/eng.json`（没有该文件则用 bundle 内置默认，见 `defaults/eng.json`）。
+`dev_task` 工具是流程的唯一事实来源与硬约束。阶段顺序、流转门槛、提交格式来自所选流程预设（standard / agile / minimal）；项目根 `.dsh/eng.json` 只声明 `flow`（选哪套预设）和 `stage_bindings`（每个节点挂哪些 skill / rule）。
+
+## 项目认知（可选前置）
+
+接手一个还不熟悉（尤其二开 / 遗留）的项目、且项目根没有 `AGENTS.md` 时，先 `dev_task`（operation=init）扫描项目并生成项目根的 `AGENTS.md` 描述文件——DSH 会把它自动注入到每个会话，之后每个任务开工自带项目认知。生成落盘前硬校验 200 行上限，只写「项目是什么 → 怎么跑 → 结构 → 约定 → 坑」，超限即精简；已有 `AGENTS.md` 时先读回、合并后再带 overwrite 重写，不裸覆盖。
 
 ## 入口
 

package/skills/solution-design/SKILL.md

@@ -9,7 +9,7 @@ description: 设计节点：产出最小方案、改动点与技术选择，落
 
 1. `dev_task`（operation=status）读当前节点与待办。
 2. 产出最小方案：技术基线、修改位置与做法、明确保持不变的部分。
-3. 单一调用方不为"以后可能复用"新增接口、Impl、DTO/VO 或异常包装；优先复用相邻实现。
+3. 不做投机性抽象：单一调用方不为"以后可能复用"新增抽象层或包装层，优先复用相邻实现；语言特定的分层与命名约定由项目挂载的 rule 约束，不在这里预设。
 4. 用 `dev_task`（operation=record, artifact=design, fields={approach, risks, impact}）落设计文档。
 5. 完成后用 `dev_task`（operation=advance）流转；系统会向人发起「方案确认」审批，批准才放行。