@godv61/dsh-task-engine 0.7.0 → 0.9.0

package/README.md

@@ -1,6 +1,6 @@
 # dsh-task-engine
 
-一个**可安装、项目无关、硬约束**的工程化交付引擎，把「需求评审 → 设计 → 开发 → 交付 → 代码审核」这套流程做成 DeepSeek Harness 的一个 bundle。同事 `dsh plugin add` 装一下就能在自己项目里用——**不需要**每个项目手写 `.agents` / `.claude` / `.harness`，也**不需要**建预设（`eng-delivery` 技能带 `whenToUse`，模型遇到开发类请求会自己加载并走 `dev_task`）。
+一个**可安装、项目无关、硬约束**的工程化交付引擎，把「需求评审 → 设计 → 开发 → 交付 → 代码审核」这套流程做成 DeepSeek Harness 的一个 bundle。**按预设激活**：装 bundle 后在目标预设的 `agent.cordis.yml` 加一行，该预设的会话才挂上 `dev_task` 工具、内置技能和人设；换到别的预设（不加那行）就完全不激活——不需要每个项目手写 `.agents` / `.claude` / `.harness`。
 
 核心是一个 `dev_task` 工具 + 内置技能。工具的硬约束在代码里执行，不是"提醒模型"：
 
@@ -14,17 +14,23 @@
 ## 目录
 
 ```
-cordis.patch.yml        bundle 声明 + host 组合 patch（一行，注册本插件，双端）
+cordis.patch.yml        bundle 声明 + host 组合 patch（一行，只挂 host 半：Remote 控制器 + 工作台 UI）
 defaults/eng.json       内置默认工作流（可被项目 .dsh/eng.json 覆盖）
 hooks/commit-msg        git 提交门禁钩子（install_hook 装进 .git/hooks/）
 src/engine.ts           纯函数状态机 + 配置校验（无 harness 依赖，双端复用）
-src/index.ts            插件（host）：注册 dev_task 工具 + 技能 + 挂 task-engine Remote 控制器
-src/controller.ts       Host 端 Remote 控制器：网页读写 .dsh/eng.json
-src/client/             浏览器半：设置页「工程流程配置」（表单 + 实时校验 + 保存 + 挂载/新建）
+src/index.ts            host 入口：挂 task-engine Remote 控制器 + 首次启动自动 seed「工程化开发引擎」预设
+src/seed-preset.ts      对齐当前 standard 复制出 eng 预设（换人设 + 加 agent 行，幂等）
+src/agent.ts            agent 入口（./agent 出品）：在调用它的预设 scope 里注册 dev_task + 内置技能
+src/dev-task.ts         dev_task 工具定义 + 全部文件系统辅助（模型门禁，随 agent 入口激活）
+src/shipped-skills.ts   内置技能扫描 + 注册（随 agent 入口激活）
+src/controller.ts       Host 端 Remote 控制器：网页读写 .dsh/eng.json + skill/rule
+src/client/             浏览器半：全屏工作台（流程配置 / 技能 skill / 规则 rule 三个标签页）
 skills/                 内置技能库（需求分析/方案设计/实现/验证/审核/提交/交付编排）
 rules/                  内置规则库（编码规范/提交规范/安全红线）
+preset/agent.cordis.yml 预设接入片段（persona 行 + agent 行，供自定义预设照抄）
+preset/enable.mjs       手动重建 eng 预设的命令行兜底（bin: dsh-task-engine-enable）
 preset/preset.yml       预设元数据
-preset/persona.md       预设 persona 文案（复制粘贴用）
+preset/persona.md       预设 persona 文案
 ```
 
 ## 构建
@@ -48,17 +54,26 @@ dsh plugin --profile <name> add github:<你的org>/dsh-task-engine
 dsh plugin --profile <name> add .
 ```
 
-## 启用
+## 启用（点选即用）
 
-装完即用：`eng-delivery` 技能带 `whenToUse`，模型遇到开发、改 bug、加功能、评审、提交类请求会先加载它，再按技能铁律走 `dev_task`——不需要预设。
+装完 bundle、重启 web，预设列表里会**自动多出一个「工程化开发引擎」**——host 半在首次启动时把它对齐当前 `standard` 生成（换好工程人设 + 加好 agent 行），落在 `~/.dsh/.agent-presets/eng/`。
 
-### 可选：专用「工程化开发引擎」预设
+- **用**：新建会话（或设置 → agent 预设）选「工程化开发引擎」，这个会话就挂上 `dev_task` + 内置技能 + 工程人设，按流程走。
+- **不用**：选 `standard` / `minimal` / 其它预设，就没有 `dev_task`、没有内置技能、没有工程人设，流程完全不介入。
+- 侧边栏「工程流程」工作台不受影响，随时供人配置 `.dsh/eng.json` 和 skill/rule。
 
-想要团队有个固定人设（新会话选它即进入工程化流程），才需要建预设：
+这一层对称由 DSH 的工具/技能 scope 机制保证：host 半从不把 `dev_task` 注册进全局工具层，agent 半（`@godv61/dsh-task-engine/agent` 行）只在命名它的预设里注册——所以切换预设本身就是开关。
 
-1. 复制 `standard` 预设为 `eng`（GUI 预设管理里的「复制」，或手动建 `~/.dsh/.agent-presets/eng/` 目录）。
-2. 把该预设的 persona 换成 `preset/persona.md` 内容。
-3. 新会话选「工程化开发引擎」。`dev_task` 工具与 `eng-delivery` 技能由 bundle 提供。
+### 兜底 / 自定义
+
+自动生成只在 `eng` 不存在时发生，绝不覆盖你手改过的预设；删掉 `eng` 后下次启动会重新生成。想**手动**造一个（不同名字、或改人设）才需要：复制 `standard` → 在 `agent.cordis.yml` 末尾加一行：
+
+```yaml
+- id: task-engine-agent
+  name: '@godv61/dsh-task-engine/agent'
+```
+
+也可重跑 `dsh-task-engine-enable` 强制重建默认的 `eng`。
 
 ## 项目配置（让流程贴合你的项目）
 
@@ -122,4 +137,7 @@ dsh plugin --profile <name> add .
 - **网页图形化配置界面（0.5.0）**：新增 `src/client/` 设置页「工程流程配置」+ Host 端 `task-engine` Remote 控制器；`@godv61/dsh-task-engine` 升级为双端包（`dsh.client` manifest + `./client` 出品，`exports` 暴露）。已实机验证：`dsh web` 起服务后 boot 数据里 `@godv61/dsh-task-engine` 以 `inject:["@deepseek-ai/dsh-api-gateway"]` 进入 application batch、`/plugins/…/client.js` 正常服务；headless 冒烟确认 boot + `dev_task` 未被新控制器破坏。浏览器点击级 e2e 留到发布后用真浏览器收尾。
 - **skill/rule 挂载与渐进披露（0.6.0）**：`WorkflowConfig` 新增 `stage_bindings`（每阶段挂 skills/rules，可选字段），`dev_task` 的 `status`/`advance` 按当前阶段披露挂载的 skill 名 + rule 正文；内置 6 技能 + 3 规则库；Host 控制器新增 `listSkills`/`listRules`/`writeSkill`/`writeRule`；设置页新增「节点挂载」和「新建 skill / rule」两块，同时补上 `dev_task` 缺失的 `items` 操作（更新实施项状态）。引擎层 `stage_bindings` 校验（未知阶段/空名）与合并已单测通过。
 - **配置页精简 + 自建 skill 可观测（0.6.1）**：设置页的流转/产物/提交规则/新建默认折叠，「节点挂载」从六阶段全平铺改成「选一个阶段再看它挂了什么」；新建成功提示带回显路径（`.dsh/skills/<name>/SKILL.md` 或 `$DSH_HOME/…`），挂载清单给非内置的 skill/rule 标「（项目）/（用户）」来源。修复 `listSkills` 依赖 host skill registry 导致项目 `.dsh/skills` 自建技能不显示的问题——改为与 `listRules` 一致，直接扫「内置 + 项目 + 用户」三层目录。浏览器 e2e 全绿。
-- **全屏工作台 + 在线编辑（0.7.0）**：配置页从设置弹窗迁出，改为侧边栏 `sidebar.footer.action`「工程流程」按钮，点开 `shell.overlay` 全屏工作台（触发按钮与覆盖层共享一个 store 控制开关）。工作台分「流程配置 / 技能 skill / 规则 rule」三个标签页；技能和规则列表支持在线编辑——`readSkill`/`readRule` 读回正文、改 description/whenToUse/正文、`writeSkill`/`writeRule` 写回；内置项只读，项目/用户项可原地编辑，新建同时支持项目级/用户级。旧的 `settings.section` 入口移除，统一走侧边栏按钮。浏览器 e2e 全绿。
+- **全屏工作台 + 在线编辑（0.7.0）**：配置页从设置弹窗迁出，改为侧边栏 `sidebar.footer.action`「工程流程」按钮，点开 `shell.overlay` 全屏工作台（触发按钮与覆盖层共享一个 store 控制开关）。工作台分「流程配置 / 技能 skill / 规则 rule」三个标签页；技能和规则列表支持在线编辑——`readSkill`/`readRule` 读回正文、改 description/whenToUse/正文、`writeSkill`/`writeRule` 写回；内置项只读，项目/用户项可原地编辑，新建同时支持项目级/用户级。旧的 `settings.section` 入口移除，统一走侧边栏按钮。浏览器 e2e 全绿。
+- **按预设激活（0.8.0）**：`dev_task` 工具与内置技能从 host 全局层拆到 agent 层。host 入口只挂 `task-engine` Remote 控制器 + 工作台 UI（`src/index.ts`）；新增 `src/agent.ts`（`./agent` 出品）、`src/dev-task.ts`、`src/shipped-skills.ts`，由预设的 `agent.cordis.yml` 命名后，在**该预设的 scope** 里注册工具与技能。实机 boot 验证：`standard` 会话工具目录不含 `dev_task`（26 个工具），加了 `@godv61/dsh-task-engine/agent` 行的 `eng` 会话含 `dev_task`（27 个工具）且描述正确，换回 `standard` 再次不含——切换预设即切换流程激活状态。
+- **一键激活（0.8.1）**：新增 `preset/enable.mjs`（bin: `dsh-task-engine-enable`），一条命令自动复制 `standard` → `eng`、把 persona 换成工程人设、追加 agent 行、写 `preset.yml`。persona 从「必须换」降级为「可选」——`eng-delivery` 技能自带 `whenToUse`，即使不加人设，模型遇到开发请求也自己加载技能走 `dev_task`；最简激活只剩「复制预设 + 追加一行 agent 行」。实机验证：脚本生成的 `eng` 预设挂载后 `dev_task` 可见、persona 以工程人设（含「铁律」）渲染、`standard` 仍无 `dev_task`。
+- **点选即用（0.9.0）**：host 入口新增 `src/seed-preset.ts`——首次启动自动把当前 `standard` 复制成 `eng` 预设（换工程人设 + 追加 agent 行，幂等、不覆盖手改）。装 bundle 重启后预设列表直接出现「工程化开发引擎」，点选即激活、切走即不激活，零复制/零编辑/零脚本。实机 boot 验证：boot 后 `.agent-presets/eng` 自动生成（agent 行 + 工程人设齐全）、roster 列出 `eng`（user）、`eng` 会话有 `dev_task` 且 persona 含「铁律」、`standard` 会话无 `dev_task`。

package/cordis.patch.yml

@@ -1,10 +1,11 @@
-# dsh-task-engine bundle: one host-plane row that registers the `dev_task` tool
-# and the shipped engineering skills. The agent-plane opt-in (persona + routing)
-# lives in `preset/` and is copied into a preset by whoever enables the engine.
-#
-# Host row + global tools/skills registries means: install the bundle once and the
-# capability is dormant-available to every agent; the preset decides whether an
-# agent actually routes its work through it.
+# dsh-task-engine bundle: one host-plane row that mounts the `task-engine`
+# Remote namespace (what the browser workbench reads/writes) plus, via
+# `dsh.client`, the workbench UI. This host row registers NO model-facing tool
+# and NO skill — `dev_task` and the shipped skills live on the AGENT plane,
+# behind the `@godv61/dsh-task-engine/agent` entry. A preset's
+# `agent.cordis.yml` names that agent row to activate the flow for its
+# sessions; presets that never name it get neither the tool nor the skills
+# (the workbench stays available so a human can still configure the flow).
 - insert:
     - id: task-engine
       name: '@godv61/dsh-task-engine'

package/lib/agent.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent half of dsh-task-engine: registers the model-facing `dev_task` tool and
+ * the shipped engineering skills onto the calling (preset) scope. Name this row
+ * from a preset's `agent.cordis.yml` to activate the delivery flow for that
+ * preset's sessions; presets that never name it see neither the tool nor the
+ * skills.
+ *
+ * @module dsh-task-engine/agent
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "task-engine-agent";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/agent.js

@@ -0,0 +1,18 @@
+/**
+ * Agent half of dsh-task-engine: registers the model-facing `dev_task` tool and
+ * the shipped engineering skills onto the calling (preset) scope. Name this row
+ * from a preset's `agent.cordis.yml` to activate the delivery flow for that
+ * preset's sessions; presets that never name it see neither the tool nor the
+ * skills.
+ *
+ * @module dsh-task-engine/agent
+ */
+import { registerDevTask } from "./dev-task.js";
+import { registerShippedSkills } from "./shipped-skills.js";
+export const name = 'task-engine-agent';
+export const inject = ['tools', 'fs'];
+export function apply(ctx) {
+    registerDevTask(ctx);
+    registerShippedSkills(ctx);
+}
+//# sourceMappingURL=agent.js.map

package/lib/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAA;AACvC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AAErC,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,eAAe,CAAC,GAAG,CAAC,CAAA;IACpB,qBAAqB,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC"}

package/lib/dev-task.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The model-facing `dev_task` tool: the hard engineering-delivery gate.
+ *
+ * This module owns the tool definition and every filesystem-adjacent helper it
+ * needs, so the registration can run on the AGENT plane (inside a preset's
+ * scope) rather than the host plane. Registering through a scoped context files
+ * the tool in that scope's layer — a session on another preset never sees it —
+ * while the pure state machine in {@link ../engine} and the config-facing
+ * `task-engine` Remote stay shared.
+ *
+ * @module dsh-task-engine/dev-task
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Register the `dev_task` tool on the calling scope. Call from an agent-plane
+ * plugin (a row in `agent.cordis.yml`) so the tool is filed in that preset's
+ * scope layer and only sessions on that preset see it.
+ * @param ctx - a scoped context whose `tools` and `fs` resolve to the host registries.
+ */
+export declare function registerDevTask(ctx: Context): void;

package/lib/dev-task.js

@@ -0,0 +1,370 @@
+/**
+ * The model-facing `dev_task` tool: the hard engineering-delivery gate.
+ *
+ * This module owns the tool definition and every filesystem-adjacent helper it
+ * needs, so the registration can run on the AGENT plane (inside a preset's
+ * scope) rather than the host plane. Registering through a scoped context files
+ * the tool in that scope's layer — a session on another preset never sees it —
+ * while the pure state machine in {@link ../engine} and the config-facing
+ * `task-engine` Remote stay shared.
+ *
+ * @module dsh-task-engine/dev-task
+ */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { assertAdvance, bindingsForStage, checkFileScope, commitCheckpoint, legalTargets, loadWorkflow, newTask, validateCommitMessage, validateWorkflow, } from "./engine.js";
+const DEFAULTS = JSON.parse(readFileSync(fileURLToPath(new URL('../defaults/eng.json', import.meta.url)), 'utf8'));
+/** Bundled commit-msg hook, copied into `.git/hooks/` by the `install_hook` operation. */
+const HOOK_TEMPLATE = readFileSync(fileURLToPath(new URL('../hooks/commit-msg', import.meta.url)), 'utf8');
+/** Pins the hook directory to CommonJS so the extensionless hook runs under any repo `type`. */
+const HOOK_PACKAGE_JSON = '{\n  "type": "commonjs"\n}\n';
+async function readText(fs, relPath) {
+    try {
+        const target = await fs.resolve(relPath);
+        return await fs.readText(target);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeText(fs, relPath, content) {
+    const target = await fs.resolve(relPath);
+    await fs.writeText(target, content);
+}
+function sanitize(id) {
+    return id.replace(/[^0-9a-zA-Z_-]/g, '-');
+}
+const taskPath = (id) => `.dsh/task-${sanitize(id)}.json`;
+/**
+ * Resolve the effective workflow, distinguishing a missing config from a bad one.
+ *
+ * `default` means no `.dsh/eng.json` (bundled defaults). `project` means the
+ * project config is present and structurally sound. `invalid` means the project
+ * config exists but is unparsable or fails {@link validateWorkflow}; its
+ * problems are surfaced so a misconfigured gate fails loudly instead of
+ * silently degrading to the default.
+ */
+async function resolveWorkflow(fs) {
+    const raw = await readText(fs, '.dsh/eng.json');
+    if (raw === undefined)
+        return { config: DEFAULTS, problems: [], source: 'default' };
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        return {
+            config: DEFAULTS,
+            problems: [`invalid JSON: ${error instanceof Error ? error.message : String(error)}`],
+            source: 'invalid',
+        };
+    }
+    const config = loadWorkflow(DEFAULTS, parsed);
+    const problems = validateWorkflow(config);
+    return { config, problems, source: problems.length === 0 ? 'project' : 'invalid' };
+}
+/** Write the bundled notch gate into `.git/hooks/` so `git commit` is mechanically gated. */
+async function installCommitHook(fs) {
+    await writeText(fs, '.git/hooks/commit-msg', HOOK_TEMPLATE);
+    await writeText(fs, '.git/hooks/package.json', HOOK_PACKAGE_JSON);
+}
+async function loadTask(fs, id) {
+    const raw = await readText(fs, taskPath(id));
+    if (raw === undefined)
+        throw new Error(`no task "${id}" under ${taskPath(id)}`);
+    const state = JSON.parse(raw);
+    // Tasks recorded before these features lack the fields; treat them as empty.
+    state.artifacts = state.artifacts ?? {};
+    state.files = state.files ?? [];
+    return state;
+}
+async function writeTask(fs, state) {
+    await writeText(fs, taskPath(state.id), JSON.stringify(state, null, 2));
+}
+function dshHome() {
+    return process.env.DSH_HOME ?? join(homedir(), '.dsh');
+}
+/** Read a rule file with a hard path, or undefined. */
+function readAbsRule(file) {
+    try {
+        return readFileSync(file, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve rule contents by name, project first, then user home, then bundled.
+ * @param names - rule names from the current stage binding.
+ * @param fs - sandboxed filesystem for the project-level lookup.
+ * @returns the rules that resolved, in name order, with their bodies.
+ */
+async function resolveRules(names, fs) {
+    const result = [];
+    for (const rawName of names) {
+        const name = sanitize(rawName);
+        if (name === '')
+            continue;
+        const project = await readText(fs, `.dsh/rules/${name}.md`);
+        if (project !== undefined) {
+            result.push({ name: rawName, content: project });
+            continue;
+        }
+        const user = readAbsRule(join(dshHome(), 'rules', `${name}.md`));
+        if (user !== undefined) {
+            result.push({ name: rawName, content: user });
+            continue;
+        }
+        const bundled = readAbsRule(fileURLToPath(new URL(`../rules/${name}.md`, import.meta.url)));
+        if (bundled !== undefined)
+            result.push({ name: rawName, content: bundled });
+    }
+    return result;
+}
+/**
+ * Render a stage's progressive-disclosure payload: skill names to load via the
+ * `skill` tool, plus the resolved rule bodies to follow. Empty text means the
+ * stage declares no bindings.
+ * @param stage - current stage.
+ * @param workflow - effective workflow.
+ * @param fs - host filesystem for project-rule resolution.
+ * @returns the disclosure text, or an empty string.
+ */
+async function renderBindings(stage, workflow, fs) {
+    const binding = bindingsForStage(stage, workflow);
+    const skills = binding?.skills ?? [];
+    const ruleNames = binding?.rules ?? [];
+    if (binding === undefined || (skills.length === 0 && ruleNames.length === 0))
+        return '';
+    const rules = await resolveRules(ruleNames, fs);
+    const skillPart = skills.length > 0
+        ? `skills to load: ${skills.join(', ')}  (use the skill tool by name)`
+        : 'skills to load: none';
+    const rulePart = rules.length > 0
+        ? `rules for this stage:\n${rules.map(r => `### ${r.name}\n${r.content}`).join('\n\n')}`
+        : '';
+    return [skillPart, rulePart].filter(Boolean).join('\n');
+}
+/** Normalize the tool's `items` argument into complete TaskItem records. */
+function normalizeItems(items) {
+    return (items ?? []).map(item => ({
+        id: String(item.id ?? ''),
+        title: String(item.title ?? ''),
+        status: item.status ?? 'todo',
+    }));
+}
+const OPERATIONS = ['status', 'create', 'confirm', 'record', 'items', 'scope', 'advance', 'verify', 'review', 'commit', 'config', 'install_hook'];
+const TOOL_DESCRIPTION = 'Own the engineering delivery workflow as hard state. Read or create the task record, record a ' +
+    'confirmation or a stage artifact, advance one stage (rejected unless every configured guard already ' +
+    'holds, including the stage artifacts), record verification or review, and gate a commit on ' +
+    'stage/scope/message. The tool refuses illegal moves instead of degrading — treat a rejection as a ' +
+    'fact to fix, not a prompt to retry another way.';
+/**
+ * Register the `dev_task` tool on the calling scope. Call from an agent-plane
+ * plugin (a row in `agent.cordis.yml`) so the tool is filed in that preset's
+ * scope layer and only sessions on that preset see it.
+ * @param ctx - a scoped context whose `tools` and `fs` resolve to the host registries.
+ */
+export function registerDevTask(ctx) {
+    ctx.tools.register(defineTool({
+        name: 'dev_task',
+        description: TOOL_DESCRIPTION,
+        parameters: {
+            operation: { type: 'string', enum: [...OPERATIONS], required: true, description: 'Which task-record action to perform.' },
+            task_id: { type: 'string', description: 'Task id (short stable id like GREET-001); required on create and every other operation.' },
+            branch: { type: 'string', description: 'Current git branch (recorded on create).' },
+            title: { type: 'string', description: 'Task title (create).' },
+            work_size: { type: 'string', enum: ['tiny', 'standard', 'complex'], description: 'Workload tier (create).' },
+            risk_level: { type: 'string', enum: ['standard', 'high_risk'], description: 'Risk tier (create).' },
+            items: {
+                type: 'array',
+                description: 'Implementation items (create/update).',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        id: { type: 'string' },
+                        title: { type: 'string' },
+                        status: { type: 'string', enum: ['todo', 'doing', 'done'] },
+                    },
+                },
+            },
+            field: { type: 'string', enum: ['requirement', 'solution'], description: 'Which confirmation (confirm).' },
+            target_stage: { type: 'string', description: 'Stage to advance to (advance).' },
+            passed: { type: 'boolean', description: 'Verification passed (verify).' },
+            evidence: { type: 'array', items: { type: 'string' }, description: 'Verification evidence (verify).' },
+            outcome: { type: 'string', enum: ['pass', 'blocked'], description: 'Review outcome (review).' },
+            artifact: { type: 'string', description: 'Artifact id to record fields for (record).' },
+            fields: {
+                type: 'object',
+                description: 'Field values for the artifact (record).',
+                additionalProperties: true,
+            },
+            files: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Repo-relative paths in scope (create/scope) or being committed (commit).',
+            },
+            message: { type: 'string', description: 'Commit summary to validate (commit).' },
+            hash: { type: 'string', description: 'Commit hash to record after the git commit (commit).' },
+        },
+        output: {
+            schema: { type: 'string' },
+            render(_args, value) {
+                return [{ type: 'text', text: value }];
+            },
+        },
+        async execute(args) {
+            const a = args;
+            const fs = ctx.fs;
+            if (a.operation === 'config') {
+                const resolved = await resolveWorkflow(fs);
+                return JSON.stringify({
+                    source: resolved.source,
+                    valid: resolved.problems.length === 0,
+                    problems: resolved.problems,
+                    workflow: resolved.config,
+                }, null, 2);
+            }
+            if (a.operation === 'install_hook') {
+                await installCommitHook(fs);
+                return 'installed commit-msg hook at .git/hooks/commit-msg — git commit is now gated by the task state';
+            }
+            const resolved = await resolveWorkflow(fs);
+            if (resolved.problems.length > 0) {
+                throw new Error(`invalid .dsh/eng.json — fix the project config first:\n- ${resolved.problems.join('\n- ')}`);
+            }
+            const workflow = resolved.config;
+            if (a.operation === 'create') {
+                if (!a.task_id || !a.title || !a.branch) {
+                    throw new Error('create requires task_id, title, and branch');
+                }
+                const state = newTask({
+                    id: a.task_id,
+                    title: a.title,
+                    branch: a.branch,
+                    work_size: a.work_size ?? 'standard',
+                    risk_level: a.risk_level ?? 'standard',
+                }, workflow);
+                state.items = normalizeItems(a.items);
+                state.files = a.files ?? [];
+                await writeTask(fs, state);
+                return `created ${state.id} at stage ${state.stage}; legal next: ${legalTargets(state.stage, workflow).join(', ') || 'none'}`;
+            }
+            if (!a.task_id)
+                throw new Error('task_id is required for this operation');
+            const state = await loadTask(fs, a.task_id);
+            if (a.operation === 'status') {
+                const binding = bindingsForStage(state.stage, workflow);
+                const rules = await resolveRules(binding?.rules ?? [], fs);
+                return JSON.stringify({
+                    id: state.id,
+                    stage: state.stage,
+                    risk_level: state.risk_level,
+                    work_size: state.work_size,
+                    requirement_confirmed: state.requirement_confirmed,
+                    solution_confirmed: state.solution_confirmed,
+                    items_done: `${state.items.filter(i => i.status === 'done').length}/${state.items.length}`,
+                    verification: state.verification,
+                    review: state.review,
+                    artifacts: state.artifacts,
+                    files: state.files,
+                    legal_next: legalTargets(state.stage, workflow),
+                    commit: commitCheckpoint(state, workflow),
+                    bindings: {
+                        skills: binding?.skills ?? [],
+                        rules: rules.map(r => ({ name: r.name, content: r.content })),
+                    },
+                }, null, 2);
+            }
+            if (a.operation === 'commit') {
+                const checkpoint = commitCheckpoint(state, workflow);
+                if (!checkpoint.allowed)
+                    throw new Error(checkpoint.reason ?? 'no commit is due');
+                if (workflow.commit.file_scope) {
+                    if (!a.files || a.files.length === 0) {
+                        throw new Error('commit requires files (the repo-relative paths being committed) when file_scope is on');
+                    }
+                    const scope = checkFileScope(state, a.files, workflow);
+                    if (!scope.ok) {
+                        throw new Error(scope.noScope
+                            ? 'task declares no file scope; record files first (create files=... or scope files=...)'
+                            : `commit touches files outside the task scope: ${scope.outside.join(', ')}`);
+                    }
+                }
+                const message = validateCommitMessage(a.message ?? '', workflow);
+                if (!message.ok)
+                    throw new Error(message.errors.join('; '));
+                if (a.hash)
+                    state.commits.push({ label: checkpoint.label, hash: a.hash });
+                await writeTask(fs, state);
+                return `commit approved (${checkpoint.label ?? ''}) — git add ${(a.files ?? []).join(' ')}; git commit -m "${a.message ?? ''}"`;
+            }
+            let note;
+            switch (a.operation) {
+                case 'confirm':
+                    if (a.field === 'requirement')
+                        state.requirement_confirmed = true;
+                    else if (a.field === 'solution')
+                        state.solution_confirmed = true;
+                    else
+                        throw new Error('confirm requires field: requirement|solution');
+                    break;
+                case 'record': {
+                    if (!a.artifact)
+                        throw new Error('record requires artifact (the artifact id)');
+                    const def = workflow.artifacts.find(artifact => artifact.id === a.artifact);
+                    if (!def) {
+                        throw new Error(`unknown artifact "${a.artifact}"; declared: ${workflow.artifacts.map(x => x.id).join(', ') || 'none'}`);
+                    }
+                    const merged = { ...(state.artifacts[def.id] ?? {}) };
+                    for (const [field, value] of Object.entries(a.fields ?? {})) {
+                        if (!def.fields.includes(field)) {
+                            throw new Error(`artifact "${def.id}" has no field "${field}"; fields: ${def.fields.join(', ')}`);
+                        }
+                        merged[field] = value === undefined || value === null ? '' : String(value);
+                    }
+                    state.artifacts[def.id] = merged;
+                    const missing = def.fields.filter(field => !merged[field] || merged[field].trim() === '');
+                    note = missing.length === 0
+                        ? `recorded ${def.name} ("${def.id}") — all required fields present`
+                        : `recorded ${def.name} ("${def.id}"); still missing: ${missing.join(', ')}`;
+                    break;
+                }
+                case 'scope':
+                    state.files = a.files ?? [];
+                    note = `file scope set to ${state.files.length} files${state.files.length > 0 ? ': ' + state.files.join(', ') : ' (empty — commits are blocked until files are declared)'}`;
+                    break;
+                case 'items':
+                    state.items = normalizeItems(a.items);
+                    note = `items set: ${state.items.map(i => `${i.id}:${i.status}`).join(', ') || 'none'}`;
+                    break;
+                case 'advance': {
+                    const result = assertAdvance(state, a.target_stage ?? '', workflow);
+                    if (!result.ok)
+                        throw new Error(result.errors.join('; '));
+                    state.stage = a.target_stage;
+                    const disclosure = await renderBindings(state.stage, workflow, fs);
+                    note = disclosure === '' ? `advanced to ${state.stage}` : `advanced to ${state.stage}\n${disclosure}`;
+                    break;
+                }
+                case 'verify':
+                    state.verification = { passed: a.passed === true, evidence: a.evidence ?? [] };
+                    break;
+                case 'review':
+                    if (a.outcome !== 'pass' && a.outcome !== 'blocked')
+                        throw new Error('review requires outcome: pass|blocked');
+                    state.review.outcome = a.outcome;
+                    break;
+                default:
+                    throw new Error(`unknown operation ${a.operation}`);
+            }
+            await writeTask(fs, state);
+            return note ?? `ok (stage ${state.stage})`;
+        },
+    }));
+}
+//# sourceMappingURL=dev-task.js.map

package/lib/dev-task.js.map

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

package/lib/index.d.ts

@@ -1,10 +1,13 @@
 /**
- * dsh-task-engine plugin: registers the model-facing `dev_task` tool (the hard
- * gate) and ships the bundled engineering skills.
+ * Host half of dsh-task-engine: mounts the `task-engine` Remote namespace that
+ * the browser workbench reads/writes, plus the browser half (declared via
+ * `dsh.client`), and seeds a pickable "工程化开发引擎" preset so activation is
+ * a single preset switch. The model-facing `dev_task` tool and the shipped
+ * engineering skills live on the AGENT plane (`./agent`), registered only in a
+ * preset that names it.
  *
  * @module dsh-task-engine
  */
 import type { Context } from '@deepseek-ai/cordis';
 export declare const name = "task-engine";
-export declare const inject: string[];
 export declare function apply(ctx: Context): void;