@devflow-tools/devflow 0.18.72 → 0.19.0

package/dist/plugin/hooks/session-start

@@ -1,6 +1,16 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(cd "${SCRIPT_DIR}/.." && pwd)}"
+source "${PLUGIN_ROOT}/hooks/runtime-node"
+
+# Global kill switch: exit with no opinion before spawning any runtime.
+if devflow_is_disabled; then
+  cat >/dev/null 2>&1 || true
+  exit 0
+fi
+
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
 SESSION_START_INPUT="$(cat)"
 
@@ -18,14 +28,6 @@ RECEIPT_FILE="$RECEIPT_DIR/${SESSION_ID}.json"
 OVERRIDE_FILE="$RECEIPT_DIR/${SESSION_ID}.override"
 rm -f "$RECEIPT_FILE" "$OVERRIDE_FILE" 2>/dev/null || true
 
-# Determine plugin root directory (same way as superpowers)
-if [ -z "${CLAUDE_PLUGIN_ROOT:-}" ]; then
-  SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-  PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
-else
-  PLUGIN_ROOT="$CLAUDE_PLUGIN_ROOT"
-fi
-source "${PLUGIN_ROOT}/hooks/runtime-node"
 DEVFLOW_NODE="$(devflow_resolve_node "$PLUGIN_ROOT")"
 
 # The registry points at an immutable build directory. Verify that this
@@ -113,17 +115,16 @@ else
 fi
 GATEWAY_STATUS="${GATEWAY_STATUS}━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-# ── MCP Tool Usage Protocol (injected into every session) ──
+# ── DevFlow capability declaration (injected into every session) ──
 MCP_PROTOCOL="
 
-## DevFlow MCP 工具使用协议（必须遵守）
+## DevFlow MCP 使用指南
 
-当用户使用 /devflow: 开头的技能时（如 /devflow:react、/devflow:vue、/devflow:context 等），你必须按以下流程操作：
+用户使用 /devflow: 技能时（如 /devflow:react、/devflow:vue、/devflow:context），推荐流程：
 
-### Step 1: 获取上下文（必须先执行）
+### Step 1: 获取上下文
 调用 mcp__plugin_devflow_devflow__get_project_context，参数格式：{\"query\": \"用户的问题描述\", \"projectRoot\": \"\${CLAUDE_PROJECT_DIR}\"}
-这个工具返回项目中的相关文件、符号、风险提示和下一步建议。
-不要跳过这一步。不要用 Explore、Agent、Grep 或 Bash 代替。
+返回相关文件、符号、风险提示与下一步建议——通常比自行搜索更快更准。
 
 ### Step 2: 按需调用领域工具
 根据已加载 Skill 和 command registry 调用对应的 MCP 工具。以下仅为高频示例，完整能力以 /devflow 列表和 command registry 为准：
@@ -138,21 +139,21 @@ MCP_PROTOCOL="
 ### Step 3: 基于工具返回结果进行分析
 用 Read 确认工具返回的关键文件，然后给出分析结论。
 
-### 铁律
-- 永远不要用 Explore、Agent、Grep 或 Glob 替代 MCP 工具的第一步上下文获取
+### 约定
 - Every mcp__plugin_devflow_devflow__ tool MUST pass projectRoot = \${CLAUDE_PROJECT_DIR}; missing projectRoot is rejected; no cwd fallback.
-- 如果 MCP 工具返回错误，重试一次；再失败则回退到直接读文件"
+- MCP 工具失败时重试一次；再失败则回退直接读文件，并如实说明已降级"
 
 COMPACT_PROTOCOL="
 
-## DevFlow compact protocol
-- Project: ${PROJECT_NAME} (${PROJECT_ROOT})
-- For /devflow:* tasks, call mcp__plugin_devflow_devflow__get_project_context before broad native search, then use the applicable domain MCP tool.
-- Explicit memory is successful only after a DevFlow canonical receipt. Queue acceptance or host-local memory is not a successful save.
+## DevFlow
+You have DevFlow — project intelligence for this repo: scoped context packs, symbol and dependency search, project memory, knowledge base, and standardized workflows. /devflow lists every installed capability; /devflow:<stack> skills pair a task with the right tool. mcp__plugin_devflow_devflow__get_project_context is the fastest way to scope a task before searching.
+
+How DevFlow reports truth (whenever you use it):
+- A memory save counts only with a DevFlow canonical receipt; queue acceptance or host-local memory is not a saved memory.
 - Static findings are not runtime measurements. Do not claim observed bottlenecks, severity, or quantified benefit without evidence.
 - Workflow success requires canonical host-action and verification evidence. Never convert degraded, cancelled, failed, or unknown state into success.
 - Full versioned rules: devflow://protocol/core, devflow://protocol/memory, devflow://protocol/evidence.
-- Retry MCP transport failure once, then degrade truthfully to direct file inspection."
+- If an MCP call fails, retry once, then fall back to direct file inspection and say so."
 
 DEVFLOW_DAEMON_REACHABLE=0
 DEVFLOW_DAEMON_LAUNCHING=0
@@ -341,13 +342,13 @@ COMPACT_SESSION_START_MODE="${DEVFLOW_ROLLOUT_COMPACT_SESSION_START:-}"
 if [ -z "$COMPACT_SESSION_START_MODE" ] && [ -f "$CONFIG_FILE" ] && command -v python3 >/dev/null 2>&1; then
   COMPACT_SESSION_START_MODE=$(python3 - "$CONFIG_FILE" 2>/dev/null <<'PY'
 import json,sys
-try: value=json.load(open(sys.argv[1])).get('rollout',{}).get('compactSessionStart','off')
-except Exception: value='off'
-print(value if value in ('off','shadow','on') else 'off')
+try: value=json.load(open(sys.argv[1])).get('rollout',{}).get('compactSessionStart','on')
+except Exception: value='on'
+print(value if value in ('off','shadow','on') else 'on')
 PY
-  ) || COMPACT_SESSION_START_MODE="off"
+  ) || COMPACT_SESSION_START_MODE="on"
 fi
-case "$COMPACT_SESSION_START_MODE" in off|shadow|on) ;; *) COMPACT_SESSION_START_MODE="off" ;; esac
+case "$COMPACT_SESSION_START_MODE" in off|shadow|on) ;; *) COMPACT_SESSION_START_MODE="on" ;; esac
 if [ "${DEVFLOW_TEST_PROTOCOL_RESOURCE_FAIL:-0}" = "1" ]; then
   COMPACT_SESSION_START_MODE="off"
 fi

package/dist/plugin/hooks/stop

@@ -5,6 +5,13 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$SCRIPT_DIR/..}"
 source "$SCRIPT_DIR/runtime-node"
+
+# Global kill switch: exit with no opinion before spawning any runtime.
+if devflow_is_disabled; then
+  cat >/dev/null 2>&1 || true
+  exit 0
+fi
+
 DEVFLOW_NODE="$(devflow_resolve_node "$PLUGIN_ROOT")"
 
 # 1. Use the daemon as the authoritative Stop handler.

package/dist/plugin/hooks/user-prompt-submit

@@ -4,6 +4,13 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$SCRIPT_DIR/..}"
 source "$SCRIPT_DIR/runtime-node"
+
+# Global kill switch: exit with no opinion before spawning any runtime.
+if devflow_is_disabled; then
+  cat >/dev/null 2>&1 || true
+  exit 0
+fi
+
 DEVFLOW_NODE="$(devflow_resolve_node "$PLUGIN_ROOT")"
 CLIENT_JS="$PLUGIN_ROOT/dist/hooks/hook-client.js"
 FALLBACK_JS="$PLUGIN_ROOT/dist/hooks/user-prompt-submit.js"

package/dist/plugin/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/devflow",
-  "version": "0.18.72",
+  "version": "0.19.0",
   "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.72",
-    "@devflow-tools/benchmark": "0.18.72",
-    "@devflow-tools/context-engine": "0.18.72",
-    "@devflow-tools/database": "0.18.72",
-    "@devflow-tools/delivery-line": "0.18.72",
-    "@devflow-tools/knowledge-engine": "0.18.72",
-    "@devflow-tools/mcp-server": "0.18.72",
-    "@devflow-tools/memory-engine": "0.18.72",
-    "@devflow-tools/retrieval-engine": "0.18.72",
-    "@devflow-tools/sdk": "0.18.72",
-    "@devflow-tools/semantic-engine": "0.18.72",
-    "@devflow-tools/server": "0.18.72",
-    "@devflow-tools/task-runtime": "0.18.72",
-    "@devflow-tools/telemetry": "0.18.72",
-    "@devflow-tools/workflow-engine": "0.18.72",
+    "@devflow-tools/adapters": "0.19.0",
+    "@devflow-tools/benchmark": "0.19.0",
+    "@devflow-tools/context-engine": "0.19.0",
+    "@devflow-tools/database": "0.19.0",
+    "@devflow-tools/delivery-line": "0.19.0",
+    "@devflow-tools/knowledge-engine": "0.19.0",
+    "@devflow-tools/mcp-server": "0.19.0",
+    "@devflow-tools/memory-engine": "0.19.0",
+    "@devflow-tools/retrieval-engine": "0.19.0",
+    "@devflow-tools/sdk": "0.19.0",
+    "@devflow-tools/semantic-engine": "0.19.0",
+    "@devflow-tools/server": "0.19.0",
+    "@devflow-tools/task-runtime": "0.19.0",
+    "@devflow-tools/telemetry": "0.19.0",
+    "@devflow-tools/workflow-engine": "0.19.0",
     "@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": "f80c5d8fde0b5387e89cf3d38a0c533a5fbfb8c2",
+  "gitHead": "d4f681428ac2f83d868e152a10c85ec892afda8b",
   "license": "MIT",
   "repository": {
     "type": "git",

package/plugin-registry.json

@@ -1,118 +1,118 @@
 {
   "version": "1.0.0",
-  "lastUpdated": "2026-10-17T09:33:13.711Z",
+  "lastUpdated": "2026-10-17T10:43:37.646Z",
   "plugins": [
     {
       "name": "@devflow-tools/plugin-animation",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Animation analysis and generation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "animation"
       ],
-      "size": "88964 B",
+      "size": "89140 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-css",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "CSS analysis and selector audit tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "css"
       ],
-      "size": "75851 B",
+      "size": "76021 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-docker",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Docker configuration and diagnostic tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "docker"
       ],
-      "size": "104723 B",
+      "size": "104896 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-electron",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Electron application analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "electron"
       ],
-      "size": "120625 B",
+      "size": "120800 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-git",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Git repository analysis and workflow tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "git"
       ],
-      "size": "86172 B",
+      "size": "86342 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-graphql",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "GraphQL schema and operation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "graphql"
       ],
-      "size": "88515 B",
+      "size": "88689 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-nest",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "NestJS analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "nest"
       ],
-      "size": "125062 B",
+      "size": "125233 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-nextjs",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Next.js analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "nextjs"
       ],
-      "size": "86822 B",
+      "size": "86995 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-performance",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Web performance audit and optimization tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "performance"
       ],
-      "size": "137418 B",
+      "size": "137596 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-react",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "React analysis, audit, and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
@@ -124,55 +124,55 @@
         "path": "scripts/run-capability.mjs",
         "timeoutMs": 30000
       },
-      "size": "283673 B",
+      "size": "283845 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-tailwind",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Tailwind CSS analysis and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "tailwind"
       ],
-      "size": "93313 B",
+      "size": "93488 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-taro",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Taro application analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "taro"
       ],
-      "size": "96747 B",
+      "size": "96918 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-ui-layout",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "UI layout analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "ui-layout"
       ],
-      "size": "74342 B",
+      "size": "74518 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-vue",
-      "version": "0.18.72",
+      "version": "0.18.73",
       "description": "Vue analysis, audit, and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "vue"
       ],
-      "size": "104823 B",
+      "size": "104993 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     }