@devflow-tools/devflow 0.16.11 → 0.16.13

package/dist/plugin/dist/skills/devflow:react/SKILL.md

@@ -70,6 +70,14 @@ rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
 - 生成代码后必须通过 TypeScript 类型检查
 - 不能凭记忆猜测 API 行为，必须基于当前项目版本
 
+## 性能证据契约
+
+- `react_audit_performance` 返回的 `evidenceContract` 是机器强制约束，不是可选提示。
+- 最终性能回答必须包含“工具发现”“模型假设”“需要运行时验证”三个标题；优先直接使用工具返回的 `canonicalReport`。
+- `runtimeProfilingOccurred=false` 时，不得把静态候选升级为 P0、高风险、确认瓶颈、已观察卡顿/掉帧/CPU 热点，也不得给出未经测量的性能数字或收益比例。
+- 没有明确采样周期、丢弃规则和前后基准时，不得把 requestAnimationFrame/RAF 推荐为通用节流方案。
+- Stop 首次发现违规会要求纠正一次；重复违规会 fail-open 并记录 `evidence_contract_unresolved`，不得通过改写措辞规避证据边界。
+
 ## 知识来源
 
 以下版本描述知识源，不代表目标项目版本；目标项目的 package.json 与 lockfile 证据始终优先。

package/dist/plugin/hooks/session-start

@@ -209,7 +209,7 @@ elif [ "$DEVFLOW_DAEMON_REACHABLE" != "1" ]; then
 WARNING: DevFlow is in degraded mode (daemon unreachable): 4-Gate enforcement is unavailable, memory prefetch cache is unavailable, and daemon-shared Hook state is unavailable. Run devflow doctor for details."
 fi
 
-MEMORY_SNAPSHOT=$'## Project memory\n本项目暂无记忆'
+MEMORY_SNAPSHOT=$'## Project memory\nDevFlow memory snapshot=pending; source=none; reason=runtime_warming. Memory availability is not yet known; do not conclude that the project has no memories.'
 CONFIG_FILE="${PROJECT_ROOT}/.devflow/config.json"
 MEMORY_RESPONSE=""
 if { [ "$DEVFLOW_DAEMON_REACHABLE" = "1" ] || [ -z "$SESSION_START_INPUT" ]; } \
@@ -219,18 +219,12 @@ if { [ "$DEVFLOW_DAEMON_REACHABLE" = "1" ] || [ -z "$SESSION_START_INPUT" ]; } \
     DEVFLOW_HOOK_CLIENT_RETRY_DELAY_MS=0 \
     node "$CLIENT_JS" memory-snapshot </dev/null 2>/dev/null || echo "")
 fi
-if command -v python3 >/dev/null 2>&1; then
-  MEMORY_SNAPSHOT=$(DEVFLOW_MEMORY_RESPONSE="$MEMORY_RESPONSE" python3 - "$CONFIG_FILE" 2>/dev/null <<'PY'
-import json,os,sys
-try: cfg=json.load(open(sys.argv[1])).get('sessionStart',{}).get('injectMemories',True)
-except Exception: cfg=True
-if cfg is False: print(''); raise SystemExit
-try: response=json.loads(os.environ.get('DEVFLOW_MEMORY_RESPONSE',''))
-except Exception: response={}
-markdown = response.get('markdown')
-print(markdown or '## Project memory\n本项目暂无记忆')
-PY
-  ) || MEMORY_SNAPSHOT=$'## Project memory\n本项目暂无记忆'
+MEMORY_CACHE_JS="${PLUGIN_ROOT}/dist/hooks/memory-snapshot-cache.js"
+if [ -f "$MEMORY_CACHE_JS" ] && command -v node >/dev/null 2>&1; then
+  MEMORY_SNAPSHOT=$(DEVFLOW_MEMORY_SNAPSHOT_CLI=1 \
+    DEVFLOW_MEMORY_RESPONSE="$MEMORY_RESPONSE" \
+    node "$MEMORY_CACHE_JS" session-start "$PROJECT_ROOT" "$CONFIG_FILE" 2>/dev/null) \
+    || MEMORY_SNAPSHOT=$'## Project memory\nDevFlow memory snapshot=degraded; source=none; reason=cache_reader_failed. Memory availability is not yet known; do not conclude that the project has no memories.'
 fi
 
 ONBOARDING_SNAPSHOT=""
@@ -259,11 +253,14 @@ fi
 
 SUMMARY="${SUMMARY}${DEGRADED_CONTEXT}${DAEMON_CONTEXT}"$'\n\n'"${ONBOARDING_SNAPSHOT}"$'\n\n'"${MEMORY_SNAPSHOT}${MCP_PROTOCOL}"$'\n\n'"${GLOBAL_CONSTRAINT}${GATEWAY_STATUS}"
 
-if command -v python3 >/dev/null 2>&1 \
+if command -v node >/dev/null 2>&1 \
+  && ESCAPED=$(printf '%s\n' "$SUMMARY" | node -e "let s=''; process.stdin.setEncoding('utf8'); process.stdin.on('data',c=>s+=c); process.stdin.on('end',()=>process.stdout.write(JSON.stringify(s)))" 2>/dev/null); then
+  :
+elif command -v python3 >/dev/null 2>&1 \
   && ESCAPED=$(printf '%s\n' "$SUMMARY" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))" 2>/dev/null); then
   :
 else
-  ESCAPED='"DevFlow SessionStart 已完成。"'
+  ESCAPED='"DevFlow SessionStart status=degraded; memory snapshot=pending; runtime helpers unavailable. Memory availability is not yet known."'
 fi
 
 printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": %s\n  }\n}\n' "$ESCAPED"

package/dist/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/claude-code-plugin",
-  "version": "0.16.11",
+  "version": "0.16.13",
   "description": "DevFlow — Developer Intelligence Platform for Claude Code",
   "type": "module",
   "scripts": {
@@ -8,18 +8,18 @@
     "deploy": "npx tsx scripts/inject-gates.ts --deploy"
   },
   "dependencies": {
-    "@devflow-tools/database": "0.16.11",
-    "@devflow-tools/memory-engine": "0.16.11",
-    "@devflow-tools/sdk": "0.16.11",
-    "@devflow-tools/telemetry": "0.16.11",
-    "@devflow-tools/workflow-engine": "0.16.11"
+    "@devflow-tools/database": "0.16.13",
+    "@devflow-tools/memory-engine": "0.16.13",
+    "@devflow-tools/sdk": "0.16.13",
+    "@devflow-tools/telemetry": "0.16.13",
+    "@devflow-tools/workflow-engine": "0.16.13"
   },
   "allowScripts": {
     "better-sqlite3@12.11.1": true,
     "sharp@0.32.6": true
   },
   "devDependencies": {
-    "@devflow-tools/mcp-server": "0.16.11"
+    "@devflow-tools/mcp-server": "0.16.13"
   },
   "keywords": [
     "pi-package",

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

@@ -37,6 +37,14 @@ description: React 专家能力 — Bug 诊断、组件重构、性能优化、H
 - 生成代码后必须通过 TypeScript 类型检查
 - 不能凭记忆猜测 API 行为，必须基于当前项目版本
 
+## 性能证据契约
+
+- `react_audit_performance` 返回的 `evidenceContract` 是机器强制约束，不是可选提示。
+- 最终性能回答必须包含“工具发现”“模型假设”“需要运行时验证”三个标题；优先直接使用工具返回的 `canonicalReport`。
+- `runtimeProfilingOccurred=false` 时，不得把静态候选升级为 P0、高风险、确认瓶颈、已观察卡顿/掉帧/CPU 热点，也不得给出未经测量的性能数字或收益比例。
+- 没有明确采样周期、丢弃规则和前后基准时，不得把 requestAnimationFrame/RAF 推荐为通用节流方案。
+- Stop 首次发现违规会要求纠正一次；重复违规会 fail-open 并记录 `evidence_contract_unresolved`，不得通过改写措辞规避证据边界。
+
 ## 知识来源
 
 以下版本描述知识源，不代表目标项目版本；目标项目的 package.json 与 lockfile 证据始终优先。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/devflow",
-  "version": "0.16.11",
+  "version": "0.16.13",
   "type": "module",
   "description": "DevFlow - Developer Intelligence Platform (Distribution Package)",
   "bin": {
@@ -16,17 +16,17 @@
   },
   "dependencies": {
     "@colbymchenry/codegraph": "^1.1.1",
-    "@devflow-tools/adapters": "0.16.11",
-    "@devflow-tools/benchmark": "0.16.11",
-    "@devflow-tools/context-engine": "0.16.11",
-    "@devflow-tools/database": "0.16.11",
-    "@devflow-tools/knowledge-engine": "0.16.11",
-    "@devflow-tools/mcp-server": "0.16.11",
-    "@devflow-tools/memory-engine": "0.16.11",
-    "@devflow-tools/sdk": "0.16.11",
-    "@devflow-tools/server": "0.16.11",
-    "@devflow-tools/telemetry": "0.16.11",
-    "@devflow-tools/workflow-engine": "0.16.11",
+    "@devflow-tools/adapters": "0.16.13",
+    "@devflow-tools/benchmark": "0.16.13",
+    "@devflow-tools/context-engine": "0.16.13",
+    "@devflow-tools/database": "0.16.13",
+    "@devflow-tools/knowledge-engine": "0.16.13",
+    "@devflow-tools/mcp-server": "0.16.13",
+    "@devflow-tools/memory-engine": "0.16.13",
+    "@devflow-tools/sdk": "0.16.13",
+    "@devflow-tools/server": "0.16.13",
+    "@devflow-tools/telemetry": "0.16.13",
+    "@devflow-tools/workflow-engine": "0.16.13",
     "@inquirer/prompts": "^7.10.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@nestjs/common": "^10.4.0",
@@ -54,5 +54,5 @@
     "plugin-registry.json",
     "scripts/postinstall.js"
   ],
-  "gitHead": "d580af1e"
+  "gitHead": "67c9dfc3709bd0ce36b7c2a9341896eedcc8a725"
 }

package/plugin-registry.json

@@ -1,172 +1,172 @@
 {
   "version": "1.0.0",
-  "lastUpdated": "2026-07-24T10:30:23.592Z",
+  "lastUpdated": "2026-07-26T16:03:14.141Z",
   "plugins": [
     {
       "name": "@devflow-tools/plugin-animation",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "animation"
       ],
-      "size": "67494 B",
+      "size": "67846 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-css",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "css"
       ],
-      "size": "54962 B",
+      "size": "55302 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-docker",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "docker"
       ],
-      "size": "83550 B",
+      "size": "83896 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-electron",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "electron"
       ],
-      "size": "99234 B",
+      "size": "99584 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-git",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "git"
       ],
-      "size": "65270 B",
+      "size": "65610 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-graphql",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "graphql"
       ],
-      "size": "67236 B",
+      "size": "67584 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-nest",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "nest"
       ],
-      "size": "104071 B",
+      "size": "104413 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-nextjs",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "nextjs"
       ],
-      "size": "65636 B",
+      "size": "65982 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-performance",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "performance"
       ],
-      "size": "115749 B",
+      "size": "116105 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-react",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "react"
       ],
-      "size": "234629 B",
+      "size": "243708 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-tailwind",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "tailwind"
       ],
-      "size": "71932 B",
+      "size": "72282 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-taro",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "taro"
       ],
-      "size": "75751 B",
+      "size": "76093 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-ui-layout",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "ui-layout"
       ],
-      "size": "52865 B",
+      "size": "53217 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-vue",
-      "version": "0.16.11",
+      "version": "0.16.13",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "vue"
       ],
-      "size": "83937 B",
+      "size": "84277 B",
       "author": "DevFlow Team",
       "homepage": ""
     }