@curdx/flow 2.3.10 → 3.0.0

package/cli/upgrade.js

@@ -2,7 +2,8 @@
  * upgrade command — update curdx-flow + recommended plugins to latest.
  */
 
-import { log } from "./utils.js";
+import { log, readConfig } from "./utils.js";
+import { reconcileLegacyContext7InstallState } from "./install-context7-config.js";
 import {
   PLUGINS_TO_UPDATE,
   MARKETPLACES_TO_REFRESH,
@@ -21,43 +22,70 @@ import {
   UPGRADE_STEP_COUNT,
 } from "./upgrade-workflow.js";
 
-export async function upgrade(args = []) {
-  log.title("⬆️  CurdX-Flow upgrade");
+export async function upgrade(
+  args = [],
+  {
+    updatePluginImpl = updatePlugin,
+    updatePluginMarketplaceImpl = updatePluginMarketplace,
+    ensureClaudeCliAvailableForUpgradeImpl = ensureClaudeCliAvailableForUpgrade,
+    getInstalledPluginNamesImpl = getInstalledPluginNames,
+    readConfigImpl = readConfig,
+    reconcileLegacyContext7InstallStateImpl = reconcileLegacyContext7InstallState,
+    logImpl = log,
+  } = {}
+) {
+  logImpl.title("⬆️  CurdX-Flow upgrade");
 
-  ensureClaudeCliAvailableForUpgrade();
+  ensureClaudeCliAvailableForUpgradeImpl({ logImpl });
 
   // Refresh marketplaces first (derived from cli/registry.js)
   await refreshMarketplaces(MARKETPLACES_TO_REFRESH, {
-    updatePluginMarketplaceImpl: updatePluginMarketplace,
+    updatePluginMarketplaceImpl,
+    logImpl,
   });
 
   // Update each plugin
-  log.blank();
-  log.step(2, UPGRADE_STEP_COUNT, "Updating installed plugins...");
-  const installedNames = getInstalledPluginNames();
+  logImpl.blank();
+  logImpl.step(2, UPGRADE_STEP_COUNT, "Updating installed plugins...");
+  const installedNames = getInstalledPluginNamesImpl();
 
   for (const spec of PLUGINS_TO_UPDATE) {
     const pluginName = getPluginNameFromSpec(spec);
     if (!installedNames.has(pluginName)) {
-      log.info(`   ${pluginName.padEnd(22)} not installed, skipping`);
+      logImpl.info(`   ${pluginName.padEnd(22)} not installed, skipping`);
       continue;
     }
 
-    const result = await updatePlugin(spec);
+    const result = await updatePluginImpl(spec);
     const status = classifyPluginUpdateResult(result);
 
     if (status.status === "updated") {
-      log.ok(`   ${pluginName.padEnd(22)} ${status.message}`);
+      logImpl.ok(`   ${pluginName.padEnd(22)} ${status.message}`);
       continue;
     }
 
     if (status.status === "unchanged") {
-      log.info(`   ${pluginName.padEnd(22)} ${status.message}`);
+      logImpl.info(`   ${pluginName.padEnd(22)} ${status.message}`);
       continue;
     }
 
-    log.warn(`   ${pluginName.padEnd(22)} ${status.message}`);
+    logImpl.warn(`   ${pluginName.padEnd(22)} ${status.message}`);
   }
 
-  printUpgradeSummary();
+  logImpl.blank();
+  logImpl.step(3, UPGRADE_STEP_COUNT, "Reconciling legacy Context7 state...");
+  if (installedNames.has("context7-plugin")) {
+    const config = readConfigImpl();
+    const language = config?.language === "zh" ? "zh" : "en";
+    await reconcileLegacyContext7InstallStateImpl(
+      { name: "context7-plugin" },
+      language,
+      config,
+      { logImpl }
+    );
+  } else {
+    logImpl.info("   context7-plugin          not installed, skipping");
+  }
+
+  printUpgradeSummary({ logImpl });
 }

package/hooks/hooks.json

@@ -21,6 +21,37 @@
         ]
       }
     ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-title.sh",
+            "statusMessage": "Refreshing CurDX-Flow session title"
+          }
+        ]
+      }
+    ],
+    "CwdChanged": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/flow-context-watch.sh"
+          }
+        ]
+      }
+    ],
+    "FileChanged": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/flow-context-watch.sh"
+          }
+        ]
+      }
+    ],
     "Stop": [
       {
         "hooks": [
@@ -43,6 +74,47 @@
         ]
       }
     ],
+    "TaskCreated": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/task-lifecycle-guard.sh"
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/task-lifecycle-guard.sh"
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/teammate-idle-guard.sh"
+          }
+        ]
+      }
+    ],
+    "ConfigChange": [
+      {
+        "matcher": "project_settings|local_settings",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/config-change-guard.sh"
+          }
+        ]
+      }
+    ],
     "PreToolUse": [
       {
         "matcher": "AskUserQuestion",

package/hooks/scripts/common.sh

@@ -4,6 +4,186 @@ has_python3() {
   command -v python3 >/dev/null 2>&1
 }
 
+resolve_flow_root() {
+  local candidate="${1:-${PWD:-}}"
+
+  if [ -n "${CLAUDE_PROJECT_DIR:-}" ] && [ -d "${CLAUDE_PROJECT_DIR}/.flow" ]; then
+    printf '%s\n' "${CLAUDE_PROJECT_DIR%/}"
+    return 0
+  fi
+
+  [ -n "$candidate" ] || candidate="$(pwd 2>/dev/null || printf '.')"
+
+  while [ -n "$candidate" ]; do
+    if [ -d "$candidate/.flow" ]; then
+      printf '%s\n' "$candidate"
+      return 0
+    fi
+
+    [ "$candidate" = "/" ] && break
+    candidate="$(dirname "$candidate")"
+  done
+
+  return 1
+}
+
+curdx_active_spec_name() {
+  local flow_root="${1:-${FLOW_ROOT:-}}"
+  [ -n "$flow_root" ] || return 1
+  [ -f "$flow_root/.flow/.active-spec" ] || return 1
+  cat "$flow_root/.flow/.active-spec" 2>/dev/null
+}
+
+curdx_active_spec_path() {
+  local flow_root="${1:-${FLOW_ROOT:-}}"
+  local file_name="${2:-}"
+  local active
+
+  [ -n "$flow_root" ] || return 1
+  [ -n "$file_name" ] || return 1
+
+  active="$(curdx_active_spec_name "$flow_root" 2>/dev/null || true)"
+  [ -n "$active" ] || return 1
+
+  printf '%s/.flow/specs/%s/%s\n' "$flow_root" "$active" "$file_name"
+}
+
+curdx_latest_epic_artifact_path() {
+  local flow_root="${1:-${FLOW_ROOT:-}}"
+
+  [ -n "$flow_root" ] || return 1
+  [ -d "$flow_root/.flow/_epics" ] || return 1
+  has_python3 || return 1
+
+  export CURDX_EPIC_DIR="$flow_root/.flow/_epics"
+  python3 <<'PY' 2>/dev/null
+import os
+from pathlib import Path
+
+base = Path(os.environ["CURDX_EPIC_DIR"])
+candidates = [path for path in base.glob("*/epic.md") if path.is_file()]
+if not candidates:
+    raise SystemExit(1)
+
+latest = max(candidates, key=lambda path: path.stat().st_mtime)
+print(str(latest))
+PY
+}
+
+curdx_epic_artifact_path_from_message() {
+  local flow_root="${1:-${FLOW_ROOT:-}}"
+  local msg="${2:-}"
+
+  [ -n "$flow_root" ] || return 1
+  has_python3 || return 1
+
+  export CURDX_EPIC_MSG="$msg"
+  export CURDX_FLOW_ROOT="$flow_root"
+  python3 <<'PY' 2>/dev/null
+import os
+import re
+
+msg = os.environ.get("CURDX_EPIC_MSG", "")
+match = re.search(r'(\.flow/_epics/[^/\s]+/epic\.md)\b', msg)
+if not match:
+    raise SystemExit(1)
+
+rel = match.group(1)
+if rel.startswith(".flow/"):
+    rel = rel[len(".flow/"):]
+
+print(os.path.join(os.environ["CURDX_FLOW_ROOT"], ".flow", rel))
+PY
+}
+
+curdx_resolve_artifact_contract() {
+  local agent_type="${1:-}"
+  local last_message="${2:-}"
+  local flow_root="${3:-${FLOW_ROOT:-}}"
+
+  CURDX_ARTIFACT_TARGET=""
+  CURDX_ARTIFACT_MIN_SIZE=0
+
+  [ -n "$agent_type" ] || return 1
+
+  case "$agent_type" in
+    flow-researcher)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" research.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=400
+      ;;
+    flow-product-designer)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" requirements.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=400
+      ;;
+    flow-architect)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" design.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=400
+      ;;
+    flow-planner)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" tasks.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=400
+      ;;
+    flow-executor)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" tasks.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=400
+      ;;
+    flow-debugger)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" debug-report.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=250
+      ;;
+    flow-reviewer)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" review-report.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=300
+      ;;
+    flow-verifier)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" verification-report.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=300
+      ;;
+    flow-security-auditor)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" security-audit.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=250
+      ;;
+    flow-qa-engineer)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" qa-report.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=250
+      ;;
+    flow-edge-hunter)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" edge-cases.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=250
+      ;;
+    flow-adversary)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" adversarial-review.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=250
+      ;;
+    flow-ui-researcher)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" ui-research.md)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=250
+      ;;
+    flow-ux-designer)
+      CURDX_ARTIFACT_TARGET="$(curdx_active_spec_path "$flow_root" ui-sketch/index.html)" || return 1
+      CURDX_ARTIFACT_MIN_SIZE=400
+      ;;
+    flow-triage-analyst)
+      CURDX_ARTIFACT_TARGET="$(curdx_epic_artifact_path_from_message "$flow_root" "$last_message" 2>/dev/null || true)"
+      if [ -z "$CURDX_ARTIFACT_TARGET" ]; then
+        CURDX_ARTIFACT_TARGET="$(curdx_latest_epic_artifact_path "$flow_root" 2>/dev/null || true)"
+      fi
+      [ -n "$CURDX_ARTIFACT_TARGET" ] || return 1
+      CURDX_ARTIFACT_MIN_SIZE=400
+      ;;
+    flow-brownfield-analyst)
+      [ -n "$flow_root" ] || return 1
+      CURDX_ARTIFACT_TARGET="$flow_root/.flow/codebase-index.md"
+      CURDX_ARTIFACT_MIN_SIZE=250
+      ;;
+    *)
+      return 1
+      ;;
+  esac
+
+  return 0
+}
+
 env_flag_enabled() {
   case "$(printf '%s' "${1:-}" | tr '[:upper:]' '[:lower:]')" in
     1|true|yes|on) return 0 ;;
@@ -30,6 +210,12 @@ emit_session_start_context() {
     "$(json_escape "$context")"
 }
 
+emit_userprompt_submit_title() {
+  local title="${1:-}"
+  printf '{"hookSpecificOutput":{"hookEventName":"UserPromptSubmit","sessionTitle":%s}}\n' \
+    "$(json_escape "$title")"
+}
+
 emit_pretooluse_deny() {
   local reason="${1:-}"
   printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":%s}}\n' \
@@ -44,3 +230,8 @@ emit_stop_block() {
 emit_subagentstop_block() {
   emit_stop_block "${1:-}"
 }
+
+emit_configchange_block() {
+  local reason="${1:-}"
+  printf '{"decision":"block","reason":%s}\n' "$(json_escape "$reason")"
+}

package/hooks/scripts/config-change-guard.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+# CurDX-Flow ConfigChange Hook
+# Blocks mid-execute settings changes that would disable CurDX's runtime spine.
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+. "$SCRIPT_DIR/common.sh"
+
+INPUT="$(cat 2>/dev/null || echo "{}")"
+FLOW_ROOT="$(resolve_flow_root 2>/dev/null || true)"
+
+[ -n "$FLOW_ROOT" ] || exit 0
+has_python3 || exit 0
+
+export CURDX_CONFIG_CHANGE_INPUT="$INPUT"
+
+SOURCE="$(python3 -c 'import json, os
+try:
+    data = json.loads(os.environ["CURDX_CONFIG_CHANGE_INPUT"])
+    print(data.get("source", ""))
+except Exception:
+    print("")
+' 2>/dev/null)"
+
+case "$SOURCE" in
+  project_settings|local_settings) ;;
+  *) exit 0 ;;
+esac
+
+FILE_PATH="$(python3 -c 'import json, os
+try:
+    data = json.loads(os.environ["CURDX_CONFIG_CHANGE_INPUT"])
+    print(data.get("file_path", ""))
+except Exception:
+    print("")
+' 2>/dev/null)"
+
+[ -n "$FILE_PATH" ] || exit 0
+[ -f "$FILE_PATH" ] || exit 0
+[ -f "$FLOW_ROOT/.flow/.active-spec" ] || exit 0
+
+ACTIVE="$(cat "$FLOW_ROOT/.flow/.active-spec" 2>/dev/null)"
+[ -n "$ACTIVE" ] || exit 0
+
+STATE_FILE="$FLOW_ROOT/.flow/specs/$ACTIVE/.state.json"
+[ -f "$STATE_FILE" ] || exit 0
+
+export STATE_FILE
+PHASE="$(python3 -c 'import json, os
+try:
+    state = json.load(open(os.environ["STATE_FILE"]))
+    print(state.get("phase", ""))
+except Exception:
+    print("")
+' 2>/dev/null)"
+
+[ "$PHASE" = "execute" ] || exit 0
+
+export CURDX_CONFIG_CHANGE_FILE="$FILE_PATH"
+BLOCK_REASONS="$(python3 <<'PY' 2>/dev/null
+import json
+import os
+
+file_path = os.environ["CURDX_CONFIG_CHANGE_FILE"]
+try:
+    parsed = json.load(open(file_path))
+except Exception:
+    raise SystemExit(0)
+
+reasons = []
+
+if parsed.get("disableAllHooks") is True:
+    reasons.append("disableAllHooks would disable CurDX-Flow stop/recovery hooks and status lines")
+
+agent = parsed.get("agent")
+if isinstance(agent, str):
+    agent = agent.strip()
+    if agent and agent != "flow-orchestrator":
+        reasons.append(f'agent would reroute the main thread through subagent "{agent}"')
+
+enabled_plugins = parsed.get("enabledPlugins")
+if isinstance(enabled_plugins, dict) and enabled_plugins.get("curdx-flow@curdx-flow-marketplace") is False:
+    reasons.append("enabledPlugins would disable curdx-flow@curdx-flow-marketplace for this project")
+
+if reasons:
+    print(" | ".join(reasons))
+PY
+)"
+
+[ -n "$BLOCK_REASONS" ] || exit 0
+
+emit_configchange_block "[CurDX-Flow config-change-guard] Blocking ${SOURCE} update while spec '${ACTIVE}' is in execute: ${BLOCK_REASONS}. Finish or cancel the active implementation first, then reapply the settings change after execute ends."
+exit 0

package/hooks/scripts/flow-context-watch.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+. "$SCRIPT_DIR/common.sh"
+
+INPUT="$(cat 2>/dev/null || echo "{}")"
+
+if ! has_python3; then
+  exit 0
+fi
+
+export CURDX_FLOW_CONTEXT_WATCH_INPUT="$INPUT"
+
+read_json_field() {
+  local field="$1"
+  python3 - "$field" <<'PY' 2>/dev/null
+import json
+import os
+import sys
+
+field = sys.argv[1]
+try:
+    data = json.loads(os.environ.get("CURDX_FLOW_CONTEXT_WATCH_INPUT", "{}"))
+except Exception:
+    data = {}
+
+value = data.get(field, "")
+if value is None:
+    value = ""
+print(value)
+PY
+}
+
+HOOK_EVENT_NAME="$(read_json_field hook_event_name)"
+NEW_CWD="$(read_json_field new_cwd)"
+CURRENT_CWD="$(read_json_field cwd)"
+
+START_DIR="$CURRENT_CWD"
+if [ "$HOOK_EVENT_NAME" = "CwdChanged" ] && [ -n "$NEW_CWD" ]; then
+  START_DIR="$NEW_CWD"
+fi
+
+FLOW_ROOT="$(resolve_flow_root "$START_DIR" 2>/dev/null || true)"
+ACTIVE_SPEC=""
+SPEC_DIR=""
+
+if [ -n "$FLOW_ROOT" ] && [ -f "$FLOW_ROOT/.flow/.active-spec" ]; then
+  ACTIVE_SPEC="$(cat "$FLOW_ROOT/.flow/.active-spec" 2>/dev/null || true)"
+fi
+
+if [ -n "$FLOW_ROOT" ] && [ -n "$ACTIVE_SPEC" ]; then
+  SPEC_DIR="$FLOW_ROOT/.flow/specs/$ACTIVE_SPEC"
+fi
+
+if [ -n "${CLAUDE_ENV_FILE:-}" ]; then
+  {
+    printf 'export CURDX_FLOW_PROJECT_ROOT=%s\n' "$(json_escape "$FLOW_ROOT")"
+    printf 'export CURDX_FLOW_ACTIVE_SPEC=%s\n' "$(json_escape "$ACTIVE_SPEC")"
+    if [ -n "$SPEC_DIR" ]; then
+      printf 'export CURDX_FLOW_SPEC_DIR=%s\n' "$(json_escape "$SPEC_DIR")"
+    else
+      printf 'export CURDX_FLOW_SPEC_DIR=%s\n' "$(json_escape "")"
+    fi
+  } >> "$CLAUDE_ENV_FILE" 2>/dev/null || true
+fi
+
+if [ -z "$FLOW_ROOT" ]; then
+  printf '{"watchPaths":[]}\n'
+  exit 0
+fi
+
+export CURDX_FLOW_CONTEXT_WATCH_ROOT="$FLOW_ROOT"
+export CURDX_FLOW_CONTEXT_WATCH_ACTIVE="$ACTIVE_SPEC"
+
+python3 <<'PY' 2>/dev/null
+import json
+import os
+from pathlib import Path
+
+root = Path(os.environ["CURDX_FLOW_CONTEXT_WATCH_ROOT"])
+active = os.environ.get("CURDX_FLOW_CONTEXT_WATCH_ACTIVE", "").strip()
+
+watch_paths = [str(root / ".flow" / ".active-spec")]
+if active:
+    spec_dir = root / ".flow" / "specs" / active
+    watch_paths.append(str(spec_dir / ".state.json"))
+    watch_paths.append(str(spec_dir / "tasks.md"))
+
+print(json.dumps({"watchPaths": watch_paths}, ensure_ascii=True))
+PY
+
+exit 0

package/hooks/scripts/quick-mode-guard.sh

@@ -35,12 +35,13 @@ if [ "$TOOL_NAME" != "AskUserQuestion" ]; then
 fi
 
 # Check if we're in a flow project with quick mode enabled.
-[ ! -d ".flow" ] && exit 0
+FLOW_ROOT="$(resolve_flow_root 2>/dev/null || true)"
+[ -n "$FLOW_ROOT" ] || exit 0
 
-ACTIVE=$(cat .flow/.active-spec 2>/dev/null)
+ACTIVE=$(cat "$FLOW_ROOT/.flow/.active-spec" 2>/dev/null)
 [ -z "$ACTIVE" ] && exit 0
 
-STATE_FILE=".flow/specs/$ACTIVE/.state.json"
+STATE_FILE="$FLOW_ROOT/.flow/specs/$ACTIVE/.state.json"
 [ ! -f "$STATE_FILE" ] && exit 0
 
 # Read quickMode. Pass STATE_FILE via env (NOT shell interpolation

package/hooks/scripts/session-start.sh

@@ -19,6 +19,7 @@ DATA_DIR="${CLAUDE_PLUGIN_DATA:-$HOME/.claude/plugins/data/curdx-flow}"
 MARKER="$DATA_DIR/.deps-checked"
 TODAY="$(date +%Y-%m-%d)"
 ADDITIONAL_CONTEXT=""
+FLOW_ROOT="$(resolve_flow_root 2>/dev/null || true)"
 
 mkdir -p "$DATA_DIR" 2>/dev/null || true
 
@@ -50,22 +51,22 @@ if env_flag_enabled "${CLAUDE_PLUGIN_OPTION_DAILY_DEPENDENCY_CHECK:-1}" && [ "$L
 fi
 
 # ---------- 2. Load .flow/ state (if project is a flow project) ----------
-if [ -d ".flow" ]; then
+if [ -n "$FLOW_ROOT" ]; then
   ADDITIONAL_CONTEXT+="## CurDX-Flow Project Active\n\n"
   ADDITIONAL_CONTEXT+="- Plugin root: \`${CLAUDE_PLUGIN_ROOT:-unknown}\`\n"
   ADDITIONAL_CONTEXT+="- Plugin data: \`${CLAUDE_PLUGIN_DATA:-$DATA_DIR}\`\n"
   ADDITIONAL_CONTEXT+="- Best practice: write long agent artifacts to disk first; keep final assistant summaries short.\n\n"
 
-  if [ -f ".flow/PROJECT.md" ]; then
-    ADDITIONAL_CONTEXT+="### Project Vision\n$(head -80 .flow/PROJECT.md)\n\n"
+  if [ -f "$FLOW_ROOT/.flow/PROJECT.md" ]; then
+    ADDITIONAL_CONTEXT+="### Project Vision\n$(head -80 "$FLOW_ROOT/.flow/PROJECT.md")\n\n"
   fi
 
-  if [ -f ".flow/.active-spec" ]; then
-    ACTIVE="$(cat .flow/.active-spec 2>/dev/null)"
-    if [ -n "$ACTIVE" ] && [ -d ".flow/specs/$ACTIVE" ]; then
+  if [ -f "$FLOW_ROOT/.flow/.active-spec" ]; then
+    ACTIVE="$(cat "$FLOW_ROOT/.flow/.active-spec" 2>/dev/null)"
+    if [ -n "$ACTIVE" ] && [ -d "$FLOW_ROOT/.flow/specs/$ACTIVE" ]; then
       ADDITIONAL_CONTEXT+="### Active Spec: \`$ACTIVE\`\n\n"
-      if [ -f ".flow/specs/$ACTIVE/.progress.md" ]; then
-        ADDITIONAL_CONTEXT+="$(head -40 ".flow/specs/$ACTIVE/.progress.md")\n\n"
+      if [ -f "$FLOW_ROOT/.flow/specs/$ACTIVE/.progress.md" ]; then
+        ADDITIONAL_CONTEXT+="$(head -40 "$FLOW_ROOT/.flow/specs/$ACTIVE/.progress.md")\n\n"
       fi
     fi
   fi
@@ -76,8 +77,11 @@ if [ -n "${CLAUDE_ENV_FILE:-}" ]; then
   {
     printf 'export CURDX_FLOW_PLUGIN_ROOT=%s\n' "$(json_escape "${CLAUDE_PLUGIN_ROOT:-}")"
     printf 'export CURDX_FLOW_PLUGIN_DATA=%s\n' "$(json_escape "${CLAUDE_PLUGIN_DATA:-$DATA_DIR}")"
-    if [ -f ".flow/.active-spec" ]; then
-      printf 'export CURDX_FLOW_ACTIVE_SPEC=%s\n' "$(json_escape "$(cat .flow/.active-spec 2>/dev/null)")"
+    if [ -n "$FLOW_ROOT" ]; then
+      printf 'export CURDX_FLOW_PROJECT_ROOT=%s\n' "$(json_escape "$FLOW_ROOT")"
+    fi
+    if [ -n "$FLOW_ROOT" ] && [ -f "$FLOW_ROOT/.flow/.active-spec" ]; then
+      printf 'export CURDX_FLOW_ACTIVE_SPEC=%s\n' "$(json_escape "$(cat "$FLOW_ROOT/.flow/.active-spec" 2>/dev/null)")"
     fi
   } >> "$CLAUDE_ENV_FILE" 2>/dev/null || true
 fi