@devflow-tools/devflow 0.18.46 → 0.18.48

package/dist/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/claude-code-plugin",
-  "version": "0.18.46",
+  "version": "0.18.48",
   "description": "Claude Code hooks and skills for the DevFlow development intelligence runtime.",
   "type": "module",
   "scripts": {
@@ -12,20 +12,20 @@
     "verify:runtime-dependencies": "node --import tsx scripts/verify-runtime-dependencies.ts"
   },
   "dependencies": {
-    "@devflow-tools/benchmark": "0.18.46",
-    "@devflow-tools/context-engine": "0.18.46",
-    "@devflow-tools/database": "0.18.46",
-    "@devflow-tools/mcp-server": "0.18.46",
-    "@devflow-tools/memory-engine": "0.18.46",
-    "@devflow-tools/sdk": "0.18.46",
-    "@devflow-tools/semantic-engine": "0.18.46",
-    "@devflow-tools/server": "0.18.46",
-    "@devflow-tools/task-runtime": "0.18.46",
-    "@devflow-tools/telemetry": "0.18.46",
-    "@devflow-tools/workflow-engine": "0.18.46"
+    "@devflow-tools/benchmark": "0.18.48",
+    "@devflow-tools/context-engine": "0.18.48",
+    "@devflow-tools/database": "0.18.48",
+    "@devflow-tools/mcp-server": "0.18.48",
+    "@devflow-tools/memory-engine": "0.18.48",
+    "@devflow-tools/sdk": "0.18.48",
+    "@devflow-tools/semantic-engine": "0.18.48",
+    "@devflow-tools/server": "0.18.48",
+    "@devflow-tools/task-runtime": "0.18.48",
+    "@devflow-tools/telemetry": "0.18.48",
+    "@devflow-tools/workflow-engine": "0.18.48"
   },
   "devDependencies": {
-    "@devflow-tools/devflow": "0.18.46"
+    "@devflow-tools/devflow": "0.18.48"
   },
   "allowScripts": {
     "better-sqlite3@12.11.1": true,
@@ -50,7 +50,7 @@
     "hooks",
     "skills"
   ],
-  "gitHead": "5f38c848134541c95e31d62a2a3f7461b3615277",
+  "gitHead": "f80c5d8fde0b5387e89cf3d38a0c533a5fbfb8c2",
   "license": "MIT",
   "repository": {
     "type": "git",

package/dist/plugin/skills/approve/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: devflow:approve
 description: Approve the current DevFlow artifact through the trusted user channel
-argument-hint: <decision-id>
+argument-hint: [optional decision-id]
 disable-model-invocation: true
 ---
 

package/dist/plugin/skills/delivery/SKILL.md

@@ -10,6 +10,7 @@ description: 通过可审计 Delivery Line 将需求推进到验证完成的 int
 ## 开始案件
 
 收到新的交付需求时，调用 `mcp__plugin_devflow_devflow__delivery_create_case`。使用当前项目绝对路径；默认 `baseRef=HEAD`、`targetRef=main`，除非用户明确指定其他值。为 actor、session、execution 和每次写操作生成稳定且可追踪的标识与幂等键。
+- 同一 Claude session、项目路径和规范化标题只能维护一个未终止案件。`delivery_create_case` 若返回已有 `caseId`，必须直接读取它的 `delivery_status` 并继续当前 `nextActions`，不得重新询问已经回答过的边界或设计问题。
 - `get_project_context` 返回后、创建案件前，对请求中点名的组件、路由、服务或文件做一次聚焦的只读
   Glob/Grep/Read 核验。检索相关度低或未命中不能证明实现不存在；不得仅凭检索摘要宣称“没有现有实现”。
 - 若发现同名组件、同一路由或多个框架实现，将候选路径通过 `existingImplementations` 传入创建案件参数，让案件先进入阻塞澄清；不要自行选择复用或替换。
@@ -17,7 +18,7 @@ description: 通过可审计 Delivery Line 将需求推进到验证完成的 int
 ## 推进规则
 
 - 调用 `mcp__plugin_devflow_devflow__get_project_context` 后必须等待该 MCP 返回，再进行任何 Read/Grep/Glob/Bash/Write/Edit；不要并发发起上下文请求和直接工具调用。
-- 每次写操作后读取返回状态；状态不明确或发生 stale turn 时调用 `mcp__plugin_devflow_devflow__delivery_status`。
+- 每次写操作后读取返回状态；保存返回的 `stateVersion`、`snapshotHash` 和 `lastEventId`。下一次仅在需要确认变化时调用 `delivery_status` 并传 `sinceVersion`；若返回 `unchanged=true`，不得重复展示决策或重放 mutation。
 - 读取 `contextQuality.channelAvailability` 时区分三种结果：`available` 表示有可用证据，
   `empty_valid` 表示 producer 正常但项目没有匹配记录，可带降级说明继续；`unavailable`
   表示 producer 失败。Memory/Knowledge 默认是辅助通道，只有案件策略明确将其设为 required
@@ -25,9 +26,11 @@ description: 通过可审计 Delivery Line 将需求推进到验证完成的 int
 - `delivery_status` 返回的 `currentTurn` 是唯一 canonical turn；所有后续 `answer`、`compare_options` 和
   `approve` 都原样使用该值。审批不会自动递增 turn，只有 `answer`/`revise` 打开新交互时才会变化。
 - 只执行当前 `nextActions` 允许的操作。
+- 同一 `pendingDecisions[].id` 在同一 host turn 只能展示一次。展示内容必须与决策快照完全一致；重复展示应复用原问题的用户回答并等待状态变化，不得重新 propose 或改写选项。
 - 澄清只问一个会改变实现边界或验收结果、且尚未由用户请求或代码证据回答的问题。不得换一种说法
   重复确认已经明确的目标、组件/页面边界或技术约束。若请求已经说明“组件”，不要再问“组件还是页面”；
   应核验现有实现后询问真正未决的复用关系、公开 API 或数据流。
+- 每个用户回答必须写入当前 intent/spec，并从 `openQuestions`、`blockingUnknowns` 和 pending decision 中移除对应问题；在状态返回前不得再次提出语义等价问题。先用规范化文本和选项身份判断是否已经回答，不能只比较自然语言表面差异。
 - 结构化选项必须是实质不同的方案。每个 option 使用稳定的短 `id`、简洁 `label` 和具体
   `description`；description 说明范围、数据流、保留/替换行为和主要权衡，供 spec artifact 使用。
 - `designing` 阶段没有 `design` 审批动作。设计方案确认后，必须使用当前状态返回的
@@ -57,11 +60,13 @@ description: 通过可审计 Delivery Line 将需求推进到验证完成的 int
 - 如果 pending decision 返回了结构化 `options`，必须把它们原样展示给用户，不得自行增加、改写或排序后再提交。使用 Claude 原生 `AskUserQuestion` 展示单选题，并在唯一问题的 `header` 中保留精确标记 `DevFlow decision <decisionId>`；选项的 `label` 和 `description` 必须与返回值完全一致。宿主 PostToolUse hook 会校验问题、选项、session、版本和 hash，并自动签名/消费用户选择；随后重新调用 `delivery_status`。审批、拒绝、继续执行等操作也必须优先使用这个选项选择流程，不要把 `/devflow:approve` 或 `/devflow:reject` 作为默认提示让用户手动输入。
 - 如果 pending decision 的 `options` 为空，这是自由文本澄清，不要伪造选择项。要求用户在同一 Claude 会话提交规范命令：`/devflow:decide <decisionId> -- <answer>`；host hook 会签名该 `UserPromptSubmit` 并消费 pending decision。
 - 如果一个澄清问题本身适合有限选项但当前 `options` 为空，先调用 `delivery_propose_options` 提交至少两个带稳定 `id`/`label` 的候选，再使用上述 `AskUserQuestion` 流程。
+- 设计阶段若当前 pending decision 的问题和选项 hash 未变化，`delivery_propose_options` 是幂等读取，不得再次创建同一设计问题。已回答的 unknown topic（placement、reuse、public_api、data_flow 等）不得用改写后的自然语言重新提问。
 - 无论哪种可信用户通道，命令或交互处理成功后都必须重新调用 `delivery_status`，以返回的 `currentTurn` 和 `nextActions` 继续。
 - artifact 审批使用 `pendingDecisions` 返回的原生批准/退回选项；展示前用 Read 打开
   `<projectRoot>/.devflow/delivery-line/artifacts/<caseId>/<artifact.path>`，只给出不重复的关键摘要和风险。必须调用 `AskUserQuestion` 让用户选择批准或退回；不要要求用户复制命令。
   宿主会将选择映射为精确审批事件。Slash command 仅是宿主原生交互不可用时的 fallback，不得把命令
   作为默认交互，也不得由 agent 调用 MCP mutation 模拟用户批准或拒绝。
+- 用户需要手动批准时，优先提示 `/devflow:approve`，系统会在当前 session 只有一个待审批 gate 时自动绑定当前案件；不要要求用户复制 decision UUID。仅在存在多个待审批案件或快捷命令无法解析时，才显示完整 decisionId 或回到原生 `AskUserQuestion`。
 - `/devflow:revise`、`/devflow:cancel` 和 `/devflow:exit` 尚未注册为可信命令；仅使用当前 `nextActions` 已实现的路径，不得向用户展示不存在的命令。
 - 审批返回后不要结束会话：立即调用 `delivery_status`，按返回的 `nextActions` 连续推进；只有出现新的
   人工 gate、明确 blocker、终态或用户明确暂停时才结束。
@@ -69,6 +74,8 @@ description: 通过可审计 Delivery Line 将需求推进到验证完成的 int
   不要先调用只改变阶段但不启动 worker 的 `delivery_advance`。`delivery_resume` 应连续运行执行、验证与
   review，直到下一个真实 gate 或 blocker。
 - 失败任务只通过 `mcp__plugin_devflow_devflow__delivery_retry_task` 重试；取消和导出分别使用 `mcp__plugin_devflow_devflow__delivery_cancel` 与 `mcp__plugin_devflow_devflow__delivery_export`。
+- `REQUIRED_CONTEXT_MISSING` 会将案件持久化为 `held` 并返回 `repair_context`；先调用 `mcp__plugin_devflow_devflow__delivery_repair_context`，成功后重新读取状态并再次准备计划。不得用新的幂等键重复提交同一个失败计划。
+- `HOST_MODEL_UNAVAILABLE` 或 `HOST_AUTHENTICATION_REQUIRED` 返回 `refresh_activation` 时，先修复宿主配置，再调用 `mcp__plugin_devflow_devflow__delivery_refresh_activation`。该操作会失效旧执行产物并要求重新审批计划，不能直接重试旧 task。
 - Claude 在当前工作区产生的修改不是 Delivery 输出；只能先调用 `mcp__plugin_devflow_devflow__delivery_import_external_change`，由系统校验 base/candidate、允许文件、context receipt 和验证证据后再进入 integration。
 
 ## 可用操作
@@ -84,6 +91,7 @@ description: 通过可审计 Delivery Line 将需求推进到验证完成的 int
 - MCP 返回 `ok: false` 时，该操作已经失败。向用户呈现 `error.code` 和 `error.message`，不得把 transport 成功误报为交付成功。
 - `error.retryable=false` 时不得自动重试；`error.recoveryAction` 是下一步建议，不是已完成的动作。
 - 遇到 `HELD`、`WORKER_UNAVAILABLE`、`REQUIRED_CONTEXT_MISSING` 或 producer/stale 警告时，先刷新 `delivery_status` 并保留阻塞状态；不得通过普通 Write/Edit/Bash/git commit 绕过 Delivery authority。
+- `repair_context` 最多自动尝试两次；仍失败时必须让用户提供明确的文件、符号或路径锚点，不能把降级或无关证据当作成功上下文。
 - `REQUIRED_CONTEXT_MISSING` 且返回 `retrieval returned unrelated context evidence` 时，核对检索结果是否包含案件已确认的现有实现路径；同一案件、同一查询下不要换幂等键反复调用 `delivery_prepare_plan`。记录无关证据路径和缺失的目标路径，待检索证据修复后再继续。
 - 遇到 `STALE_INTERACTION_TURN`、`MISSING_PREREQUISITE` 或 `INVALID_TRANSITION` 时，先调用 `mcp__plugin_devflow_devflow__delivery_status` 刷新案件状态；只有新的 `nextActions` 明确允许时才继续。
 - Delivery 工具失败后不得为了绕过写入限制调用 `delivery_cancel`；只有用户明确要求取消时才可取消。取消或拒绝后的同一会话仍禁止直接 Write/Edit/Bash，必须新建 Delivery 案件或开启新会话。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/devflow",
-  "version": "0.18.46",
+  "version": "0.18.48",
   "type": "module",
   "description": "Installable DevFlow distribution containing the CLI, runtime hooks, and Claude plugin.",
   "bin": {
@@ -21,21 +21,21 @@
   },
   "dependencies": {
     "@colbymchenry/codegraph": "^1.1.1",
-    "@devflow-tools/adapters": "0.18.46",
-    "@devflow-tools/benchmark": "0.18.46",
-    "@devflow-tools/context-engine": "0.18.46",
-    "@devflow-tools/database": "0.18.46",
-    "@devflow-tools/delivery-line": "0.18.46",
-    "@devflow-tools/knowledge-engine": "0.18.46",
-    "@devflow-tools/mcp-server": "0.18.46",
-    "@devflow-tools/memory-engine": "0.18.46",
-    "@devflow-tools/retrieval-engine": "0.18.46",
-    "@devflow-tools/sdk": "0.18.46",
-    "@devflow-tools/semantic-engine": "0.18.46",
-    "@devflow-tools/server": "0.18.46",
-    "@devflow-tools/task-runtime": "0.18.46",
-    "@devflow-tools/telemetry": "0.18.46",
-    "@devflow-tools/workflow-engine": "0.18.46",
+    "@devflow-tools/adapters": "0.18.48",
+    "@devflow-tools/benchmark": "0.18.48",
+    "@devflow-tools/context-engine": "0.18.48",
+    "@devflow-tools/database": "0.18.48",
+    "@devflow-tools/delivery-line": "0.18.48",
+    "@devflow-tools/knowledge-engine": "0.18.48",
+    "@devflow-tools/mcp-server": "0.18.48",
+    "@devflow-tools/memory-engine": "0.18.48",
+    "@devflow-tools/retrieval-engine": "0.18.48",
+    "@devflow-tools/sdk": "0.18.48",
+    "@devflow-tools/semantic-engine": "0.18.48",
+    "@devflow-tools/server": "0.18.48",
+    "@devflow-tools/task-runtime": "0.18.48",
+    "@devflow-tools/telemetry": "0.18.48",
+    "@devflow-tools/workflow-engine": "0.18.48",
     "@inquirer/prompts": "^7.10.1",
     "@modelcontextprotocol/sdk": "^1.32.1",
     "@nestjs/common": "^12.1.2",
@@ -63,7 +63,7 @@
     "plugin-registry.json",
     "scripts/postinstall.js"
   ],
-  "gitHead": "5f38c848134541c95e31d62a2a3f7461b3615277",
+  "gitHead": "f80c5d8fde0b5387e89cf3d38a0c533a5fbfb8c2",
   "license": "MIT",
   "repository": {
     "type": "git",

package/plugin-registry.json

@@ -1,118 +1,118 @@
 {
   "version": "1.0.0",
-  "lastUpdated": "2026-10-10T06:22:41.393Z",
+  "lastUpdated": "2026-10-12T13:18:57.920Z",
   "plugins": [
     {
       "name": "@devflow-tools/plugin-animation",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Animation analysis and generation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "animation"
       ],
-      "size": "83287 B",
+      "size": "84916 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-css",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "CSS analysis and selector audit tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "css"
       ],
-      "size": "70324 B",
+      "size": "71941 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-docker",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Docker configuration and diagnostic tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "docker"
       ],
-      "size": "99121 B",
+      "size": "100744 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-electron",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Electron application analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "electron"
       ],
-      "size": "114973 B",
+      "size": "116600 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-git",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Git repository analysis and workflow tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "git"
       ],
-      "size": "80645 B",
+      "size": "82262 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-graphql",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "GraphQL schema and operation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "graphql"
       ],
-      "size": "82888 B",
+      "size": "84513 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-nest",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "NestJS analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "nest"
       ],
-      "size": "119510 B",
+      "size": "121129 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-nextjs",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Next.js analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "nextjs"
       ],
-      "size": "81220 B",
+      "size": "82843 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-performance",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Web performance audit and optimization tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "performance"
       ],
-      "size": "131691 B",
+      "size": "133324 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-react",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "React analysis, audit, and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
@@ -124,55 +124,55 @@
         "path": "scripts/run-capability.mjs",
         "timeoutMs": 30000
       },
-      "size": "278096 B",
+      "size": "279717 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-tailwind",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Tailwind CSS analysis and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "tailwind"
       ],
-      "size": "87661 B",
+      "size": "89288 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-taro",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Taro application analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "taro"
       ],
-      "size": "91195 B",
+      "size": "92814 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-ui-layout",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "UI layout analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "ui-layout"
       ],
-      "size": "68665 B",
+      "size": "70294 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-vue",
-      "version": "0.18.43",
+      "version": "0.18.48",
       "description": "Vue analysis, audit, and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "vue"
       ],
-      "size": "99296 B",
+      "size": "100913 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     }