@curdx/flow 2.3.11 → 3.0.0

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

package/hooks/scripts/session-title.sh

@@ -0,0 +1,87 @@
+#!/usr/bin/env bash
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+. "$SCRIPT_DIR/common.sh"
+
+INPUT="$(cat 2>/dev/null || echo "{}")"
+DATA_DIR="${CLAUDE_PLUGIN_DATA:-$HOME/.claude/plugins/data/curdx-flow}"
+FLOW_ROOT="$(resolve_flow_root 2>/dev/null || true)"
+
+[ -n "$FLOW_ROOT" ] || exit 0
+
+ACTIVE="$(cat "$FLOW_ROOT/.flow/.active-spec" 2>/dev/null || true)"
+[ -n "$ACTIVE" ] || exit 0
+
+if ! has_python3; then
+  emit_userprompt_submit_title "curdx-flow/${ACTIVE}"
+  exit 0
+fi
+
+export CURDX_FLOW_SESSION_TITLE_INPUT="$INPUT"
+export CURDX_FLOW_SESSION_TITLE_ACTIVE="$ACTIVE"
+export CURDX_FLOW_ROOT="$FLOW_ROOT"
+
+TITLE_INFO="$(python3 <<'PY' 2>/dev/null
+import json
+import os
+from pathlib import Path
+
+active = os.environ["CURDX_FLOW_SESSION_TITLE_ACTIVE"]
+data = json.loads(os.environ.get("CURDX_FLOW_SESSION_TITLE_INPUT", "{}"))
+session_id = data.get("session_id", "")
+
+phase = ""
+task_index = 0
+total_tasks = 0
+
+state_path = Path(os.environ["CURDX_FLOW_ROOT"]) / ".flow" / "specs" / active / ".state.json"
+if state_path.exists():
+    try:
+        state = json.loads(state_path.read_text(encoding="utf-8"))
+        phase = state.get("phase") or ""
+        execute_state = state.get("execute_state") or {}
+        task_index = int(execute_state.get("task_index") or 0)
+        total_tasks = int(execute_state.get("total_tasks") or 0)
+    except Exception:
+        phase = ""
+        task_index = 0
+        total_tasks = 0
+
+label = phase
+if phase == "execute" and total_tasks > 0:
+    label = f"{phase} {task_index}/{total_tasks}"
+
+title = f"curdx-flow/{active}"
+if label:
+    title = f"{title} [{label}]"
+
+print(session_id)
+print(title)
+PY
+)"
+
+SESSION_ID="$(printf '%s\n' "$TITLE_INFO" | sed -n '1p')"
+TITLE="$(printf '%s\n' "$TITLE_INFO" | sed -n '2p')"
+[ -n "$TITLE" ] || exit 0
+
+if [ -n "$SESSION_ID" ]; then
+  MARKER_DIR="$DATA_DIR/session-titles"
+  MARKER_FILE="$MARKER_DIR/$SESSION_ID"
+  LAST_TITLE=""
+
+  if [ -f "$MARKER_FILE" ]; then
+    LAST_TITLE="$(cat "$MARKER_FILE" 2>/dev/null || true)"
+  fi
+
+  if [ "$LAST_TITLE" = "$TITLE" ]; then
+    exit 0
+  fi
+
+  mkdir -p "$MARKER_DIR" 2>/dev/null || true
+  printf '%s\n' "$TITLE" > "$MARKER_FILE" 2>/dev/null || true
+fi
+
+emit_userprompt_submit_title "$TITLE"
+exit 0

package/hooks/scripts/stop-watcher.sh

@@ -38,12 +38,13 @@ block_continue() {
 }
 
 # ---------- 1. Must be a flow project ----------
-[ ! -d ".flow" ] && allow_stop
+FLOW_ROOT="$(resolve_flow_root 2>/dev/null || true)"
+[ -n "$FLOW_ROOT" ] || allow_stop
 
 # ---------- 2. Must have active spec ----------
-ACTIVE=$(cat .flow/.active-spec 2>/dev/null)
+ACTIVE=$(cat "$FLOW_ROOT/.flow/.active-spec" 2>/dev/null)
 [ -z "$ACTIVE" ] && allow_stop
-SPEC_DIR=".flow/specs/$ACTIVE"
+SPEC_DIR="$FLOW_ROOT/.flow/specs/$ACTIVE"
 [ ! -d "$SPEC_DIR" ] && allow_stop
 
 STATE_FILE="$SPEC_DIR/.state.json"

package/hooks/scripts/subagent-artifact-guard.sh

@@ -14,6 +14,7 @@ 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)"
 
 if ! has_python3; then
   # Without JSON parsing, fail open rather than blocking subagents blindly.
@@ -43,18 +44,6 @@ looks_like_success() {
   printf '%s' "$msg" | grep -Eq '(^✓| generated$| generated\n|Wrote |Review complete|Requirements done|Research complete|UI Sketch generation complete|Report:|Next:|TASK_COMPLETE|ALL_TASKS_COMPLETE)'
 }
 
-active_spec_path() {
-  local file_name="$1"
-
-  [ ! -d ".flow" ] && return 1
-
-  local active
-  active="$(cat .flow/.active-spec 2>/dev/null)"
-  [ -z "$active" ] && return 1
-
-  printf '.flow/specs/%s/%s\n' "$active" "$file_name"
-}
-
 completed_task_id() {
   local msg="${1:-}"
   printf '%s' "$msg" | sed -nE 's/.*TASK_COMPLETE:[[:space:]]*([0-9]+(\.([0-9]+|VF|X(\+[0-9]+)?))*).*/\1/p' | head -1
@@ -64,24 +53,10 @@ artifact_target=""
 minimum_size=200
 
 case "$AGENT_TYPE" in
-  flow-researcher)
-    artifact_target="$(active_spec_path research.md)" || exit 0
-    minimum_size=400
-    ;;
-  flow-product-designer)
-    artifact_target="$(active_spec_path requirements.md)" || exit 0
-    minimum_size=400
-    ;;
-  flow-architect)
-    artifact_target="$(active_spec_path design.md)" || exit 0
-    minimum_size=400
-    ;;
-  flow-planner)
-    artifact_target="$(active_spec_path tasks.md)" || exit 0
-    minimum_size=400
-    ;;
   flow-executor)
-    artifact_target="$(active_spec_path tasks.md)" || exit 0
+    curdx_resolve_artifact_contract "$AGENT_TYPE" "$LAST_MESSAGE" "$FLOW_ROOT" || exit 0
+    artifact_target="$CURDX_ARTIFACT_TARGET"
+    minimum_size="$CURDX_ARTIFACT_MIN_SIZE"
     if printf '%s' "$LAST_MESSAGE" | grep -q 'ALL_TASKS_COMPLETE'; then
       exit 0
     fi
@@ -93,52 +68,10 @@ case "$AGENT_TYPE" in
     emit_subagentstop_block "[CurDX-Flow subagent-artifact-guard] flow-executor emitted TASK_COMPLETE: ${task_id}, but ${artifact_target} does not mark that task as [x]. Update tasks.md and the spec progress/state before stopping."
     exit 0
     ;;
-  flow-debugger)
-    artifact_target="$(active_spec_path debug-report.md)" || exit 0
-    minimum_size=250
-    ;;
-  flow-triage-analyst)
-    artifact_target="$(active_spec_path triage-report.md)" || exit 0
-    minimum_size=250
-    ;;
-  flow-ux-designer)
-    artifact_target="$(active_spec_path ui-sketch.md)" || exit 0
-    minimum_size=250
-    ;;
-  flow-reviewer)
-    artifact_target="$(active_spec_path review-report.md)" || exit 0
-    minimum_size=300
-    ;;
-  flow-verifier)
-    artifact_target="$(active_spec_path verification-report.md)" || exit 0
-    minimum_size=300
-    ;;
-  flow-security-auditor)
-    artifact_target="$(active_spec_path security-audit.md)" || exit 0
-    minimum_size=250
-    ;;
-  flow-qa-engineer)
-    artifact_target="$(active_spec_path qa-report.md)" || exit 0
-    minimum_size=250
-    ;;
-  flow-edge-hunter)
-    artifact_target="$(active_spec_path edge-cases.md)" || exit 0
-    minimum_size=250
-    ;;
-  flow-adversary)
-    artifact_target="$(active_spec_path adversarial-review.md)" || exit 0
-    minimum_size=250
-    ;;
-  flow-ui-researcher)
-    artifact_target="$(active_spec_path ui-research.md)" || exit 0
-    minimum_size=250
-    ;;
-  flow-brownfield-analyst)
-    artifact_target=".flow/codebase-index.md"
-    minimum_size=250
-    ;;
   *)
-    exit 0
+    curdx_resolve_artifact_contract "$AGENT_TYPE" "$LAST_MESSAGE" "$FLOW_ROOT" || exit 0
+    artifact_target="$CURDX_ARTIFACT_TARGET"
+    minimum_size="$CURDX_ARTIFACT_MIN_SIZE"
     ;;
 esac