@godv61/dsh-task-engine 0.27.1 → 0.29.0

package/docs/roadmap.md

@@ -2,7 +2,7 @@
 
 [← 文档导航](README.md)
 
-本页记录**讨论中的方向，不代表已发布功能**；是否实现、何时实现都在开始编码前单独确认。
+本页记录已发布能力与后续方向；任务级流程见[自适应工程任务](adaptive-workflows.md)。
 已发布的能力与版本变化见[更新日志](CHANGELOG.md)。
 
 ## 当前能力边界
@@ -10,16 +10,16 @@
 | 能力 | 状态 |
 | :--- | :--- |
 | 三个内置流程（`standard`、`agile`、`minimal`） | ✅ 已发布，开箱即用 |
-| 阶段选择技能、规则归属技能 | ✅ 已发布 |
+| 阶段选择技能、规则归属技能 | ✅ 已发布 |
 | 任务台账、验证与审核回执、提交门禁 | ✅ 已发布 |
-| 项目级与个人级资源安装、来源保留 | ✅ 已发布 |
-| **自由编辑流程阶段与条件** | ❌ **不在计划内** |
+| 项目级与个人级资源安装、来源保留 | ✅ 已发布 |
+| 四档任务级流程、元技能、项目扫描 init、可选审核期 SonarQube CI 接入 | ✅ 0.29.0 |
+| **自由编辑流程阶段与条件** | ❌ **不在计划内** |
 
 **关于自定义流程**：让使用者自行设计阶段、条件与提交流程曾被评估，结论是**不列入计划**——
-它把流程设计的负担转嫁给使用者，而三个内置流程已覆盖个人项目的常见需要。代码中不存在该能力的
-实现；相关尝试保留在非发布分支，不在 `main` 上。
+任务级四档流程覆盖常见开发复杂度，用户可挂载项目技能；自由编辑状态机仍不在当前范围。
 
-需要调整时，可修改项目根目录的 `.dsh/eng.json` 改变阶段资源绑定，或直接在三个内置流程中选择。
+旧任务继续读取 `.dsh/eng.json`；新任务用 `.dsh/meta.json` 管理元技能挂载，复杂度在任务创建时确定。
 
 ## 后续体验方向
 
@@ -30,5 +30,4 @@
 
 ## 产品范围
 
-本项目服务本机个人开发工作台。多用户服务器的会话权限架构不列为当前版本的必修项。日常改进优先
-解决工作区目标清晰、文件误操作、任务连续性和操作反馈。
+本项目服务本机与团队分支开发中的个人会话。多用户服务器的会话权限架构不列为当前版本的必修项。日常改进优先解决工作区目标清晰、文件误操作、任务连续性和操作反馈。

package/hooks/commit-msg

@@ -148,7 +148,7 @@ function commitCheckpoint(state2, config2) {
   return { allowed: false, reason: "no commit is due at this stage under the current policy" };
 }
 function isEngineMeta(file) {
-  return /^\.dsh\/(task-[^/]+\.json|eng\.json)$/.test(file);
+  return /^\.dsh\/(task-[^/]+\.json|eng\.json|meta\.json)$/.test(file);
 }
 function checkFileScope(state2, committing, config2) {
   if (!config2.commit.file_scope) return { ok: true, outside: [], noScope: false };
@@ -419,6 +419,9 @@ function normalizeTask(task) {
     branch: String(task.branch ?? ""),
     work_size: task.work_size ?? "standard",
     risk_level: task.risk_level ?? "standard",
+    ...task.complexity !== void 0 ? { complexity: task.complexity } : {},
+    ...task.sonar_policy !== void 0 ? { sonar_policy: task.sonar_policy } : {},
+    ...task.sonar_audit !== void 0 ? { sonar_audit: task.sonar_audit } : {},
     stage: String(task.stage ?? ""),
     requirement_confirmed: task.requirement_confirmed === true,
     solution_confirmed: task.solution_confirmed === true,
@@ -501,7 +504,21 @@ function extractTaskId(message2) {
   return match ? match[1] : void 0;
 }
 function isEngineMeta2(file) {
-  return /^\.dsh\/(task-[^/]+\.json|eng\.json)$/.test(file);
+  return /^\.dsh\/(task-[^/]+\.json|eng\.json|meta\.json)$/.test(file);
+}
+function scopeHash(state2, root) {
+  const entries2 = [...new Set(state2.files)].filter((file) => !isEngineMeta2(file)).sort().map((file) => {
+    const target = import_node_path.default.resolve(root, file);
+    const inside = import_node_path.default.relative(root, target);
+    if (inside.startsWith("..") || import_node_path.default.isAbsolute(inside)) refuse(`\u4EFB\u52A1\u8303\u56F4\u8DEF\u5F84\u8D8A\u754C: ${file}`);
+    try {
+      return [file, hashText(import_node_fs.default.readFileSync(target, "utf8"))];
+    } catch (error) {
+      if (error.code === "ENOENT") return [file, null];
+      refuse(`\u65E0\u6CD5\u8BFB\u53D6\u4EFB\u52A1\u6587\u4EF6 ${file}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  });
+  return hashText(JSON.stringify(entries2));
 }
 function riskyPaths(entries2) {
   return entries2.filter((entry) => !isEngineMeta2(entry.path)).filter((entry) => DEFAULT_RISK_POLICY.sensitive_paths.some((prefix) => entry.path === prefix || entry.path.startsWith(`${prefix}/`))).map((entry) => entry.path);
@@ -536,30 +553,11 @@ function loadWorkflow(parsed) {
   }
   return resolved.config;
 }
-var cwd = process.cwd();
-var configPath = import_node_path.default.join(cwd, ".dsh", "eng.json");
-var config;
-if (import_node_fs.default.existsSync(configPath)) {
-  let raw = "";
-  try {
-    raw = import_node_fs.default.readFileSync(configPath, "utf8");
-  } catch {
-    raw = "";
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch (error) {
-    refuse("invalid JSON in .dsh/eng.json: " + (error instanceof Error ? error.message : String(error)));
-  }
-  config = loadWorkflow(parsed);
-} else {
-  config = loadWorkflow(void 0);
-}
 if (!messageFile) {
   process.exit(0);
 }
 var message = readCommitMessage(messageFile);
+var cwd = process.cwd();
 var tasks = loadTasks();
 var taskId = extractTaskId(message);
 var state;
@@ -578,8 +576,20 @@ if (!state) {
 if (state.flow?.hash !== void 0 && hashConfig(state.flow.config) !== state.flow.hash) {
   refuse(`\u4EFB\u52A1 ${state.id} \u7684\u6D41\u7A0B\u5FEB\u7167 hash \u4E0D\u5339\u914D\u2014\u2014task \u8BB0\u5F55\u5728\u521B\u5EFA\u540E\u88AB\u6539\u52A8\u8FC7\uFF0C\u4FEE\u590D\u6216\u91CD\u5EFA\u4EFB\u52A1\u540E\u518D\u63D0\u4EA4`);
 }
+var config;
 if (state.flow !== void 0 && state.flow.config !== void 0) {
   config = state.flow.config;
+} else {
+  const configPath = import_node_path.default.join(cwd, ".dsh", "eng.json");
+  if (import_node_fs.default.existsSync(configPath)) {
+    let parsed;
+    try {
+      parsed = JSON.parse(import_node_fs.default.readFileSync(configPath, "utf8"));
+    } catch (error) {
+      refuse("invalid JSON in .dsh/eng.json: " + (error instanceof Error ? error.message : String(error)));
+    }
+    config = loadWorkflow(parsed);
+  } else config = loadWorkflow(void 0);
 }
 var verdict = validateCommitMessage(message, config);
 if (!verdict.ok) {
@@ -589,6 +599,13 @@ var checkpoint = commitCheckpoint(state, config);
 if (!checkpoint.allowed) {
   refuse((checkpoint.reason ?? "commit checkpoint rejected") + "\uFF08\u5F53\u524D\u9636\u6BB5: " + state.stage + "\uFF09");
 }
+if (state.sonar_policy?.enabled && ["\u4EE3\u7801\u5BA1\u6838", "\u5B8C\u6210"].includes(state.stage)) {
+  const audit = state.sonar_audit;
+  const lastCommit = state.commits.findLast((entry) => entry.hash !== void 0)?.hash;
+  if (!audit || audit.gate !== "OK" || audit.blocking.length > 0 || audit.scope_hash !== scopeHash(state, cwd) || !lastCommit || audit.commit_hash !== lastCommit) {
+    refuse("SonarQube \u5BA1\u6838\u672A\u901A\u8FC7\u6216\u5DF2\u8FC7\u671F\u2014\u2014\u5728\u4EE3\u7801\u5BA1\u6838\u9636\u6BB5\u5B8C\u6210\u65B0\u4E00\u6B21 CI \u626B\u63CF\u5E76\u8C03\u7528 dev_task operation=sonar_check");
+  }
+}
 var entries = stagedEntries();
 var scope = checkFileScope(state, entries.map((entry) => entry.path), config);
 if (!scope.ok) {

package/lib/adaptive.d.ts

@@ -0,0 +1,15 @@
+/** Task-scoped engineering flows. The grade selects gates; risk remains separate. */
+import type { WorkflowConfig } from './engine.ts';
+export type Complexity = 'low' | 'medium' | 'high' | 'ultra';
+export type MetaSkill = 'requirements-analysis' | 'architecture-design' | 'task-orchestration' | 'code-development' | 'test-validation' | 'code-review';
+export declare const COMPLEXITY_OPTIONS: readonly {
+    id: Complexity;
+    label: string;
+    guidance: string;
+}[];
+export declare const META_STAGES: Readonly<Record<MetaSkill, string>>;
+export declare const ADAPTIVE_VERSION = 1;
+/** A grade is a per-task snapshot, never a project-wide forced flow. */
+export declare function adaptiveWorkflow(grade: Complexity): WorkflowConfig;
+export declare function isComplexity(value: unknown): value is Complexity;
+export declare function metaForStage(stage: string): MetaSkill | undefined;

package/lib/adaptive.js

@@ -0,0 +1,54 @@
+export const COMPLEXITY_OPTIONS = [
+    { id: 'low', label: '低', guidance: '边界明确的局部修改；一个实施项即可说明改动。' },
+    { id: 'medium', label: '中', guidance: '常规功能或缺陷修复；先写清需求与验收条件。' },
+    { id: 'high', label: '高', guidance: '跨模块或有先后依赖的需求；按实现顺序编排任务与交接产物。' },
+    { id: 'ultra', label: '超高', guidance: '完整新模块或大范围重构；先明确架构边界，再按依赖顺序实施。' },
+];
+export const META_STAGES = {
+    'requirements-analysis': '需求分析',
+    'architecture-design': '架构设计',
+    'task-orchestration': '任务编排',
+    'code-development': '代码开发',
+    'test-validation': '测试',
+    'code-review': '代码审核',
+};
+export const ADAPTIVE_VERSION = 1;
+const COMMON_ARTIFACTS = [
+    { stage: '需求分析', id: 'requirement', name: '需求与验收条件', fields: ['goal', 'scope', 'acceptance'] },
+    { stage: '架构设计', id: 'architecture', name: '架构边界', fields: ['approach', 'impact', 'tradeoffs'] },
+    { stage: '任务编排', id: 'task-plan', name: '按实现顺序排列的任务', fields: ['steps', 'dependencies', 'handoffs'] },
+];
+/** A grade is a per-task snapshot, never a project-wide forced flow. */
+export function adaptiveWorkflow(grade) {
+    const prefix = grade === 'low' ? []
+        : grade === 'medium' ? ['需求分析']
+            : grade === 'high' ? ['需求分析', '任务编排']
+                : ['需求分析', '架构设计', '任务编排'];
+    const stages = [...prefix, '代码开发', '测试', '代码审核', '完成'];
+    const transitions = stages.slice(0, -1).map((from, index) => {
+        const to = stages[index + 1];
+        const requires = from === '需求分析' || from === '架构设计' || from === '任务编排'
+            ? ['artifacts_present']
+            : from === '代码开发' ? ['todos_done']
+                : from === '测试' ? ['verified']
+                    : from === '代码审核' ? ['review_passed'] : [];
+        return { from, to, requires };
+    });
+    return {
+        stages,
+        start_stage: stages[0],
+        transitions,
+        artifacts: COMMON_ARTIFACTS.filter(artifact => stages.includes(artifact.stage)),
+        // The branch must be committed/pushed before its CI Sonar scan can run.
+        commit: { policy: 'task', message_pattern: '', message_hint: '无格式要求', checkpoints: ['测试'], file_scope: true },
+        high_risk_requires_verification: true,
+        review_depth: grade === 'low' ? 'single' : 'two-stage',
+    };
+}
+export function isComplexity(value) {
+    return value === 'low' || value === 'medium' || value === 'high' || value === 'ultra';
+}
+export function metaForStage(stage) {
+    return Object.entries(META_STAGES).find(([, label]) => label === stage)?.[0];
+}
+//# sourceMappingURL=adaptive.js.map

package/lib/adaptive.js.map

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