@curdx/flow 3.0.0 → 3.1.0

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

@@ -1,92 +0,0 @@
-#!/usr/bin/env bash
-# CurDX-Flow SubagentStop Hook
-# Blocks successful subagent completion if the expected artifact never landed on disk.
-#
-# Why:
-# - long markdown/report-writing agents can truncate near the end of a run
-# - users then see a cheerful success summary but the actual file is missing or tiny
-# - latest Claude Code hooks expose SubagentStop with agent_type + last_assistant_message,
-#   which lets us guard only "success-looking" exits while allowing genuine precondition failures
-
-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)"
-
-if ! has_python3; then
-  # Without JSON parsing, fail open rather than blocking subagents blindly.
-  exit 0
-fi
-
-export SUBAGENT_GUARD_INPUT="$INPUT"
-
-AGENT_TYPE="$(python3 -c 'import json, os
-try:
-    data = json.loads(os.environ["SUBAGENT_GUARD_INPUT"])
-    print(data.get("agent_type", ""))
-except Exception:
-    print("")
-' 2>/dev/null)"
-
-LAST_MESSAGE="$(python3 -c 'import json, os
-try:
-    data = json.loads(os.environ["SUBAGENT_GUARD_INPUT"])
-    print((data.get("last_assistant_message") or "").strip())
-except Exception:
-    print("")
-' 2>/dev/null)"
-
-looks_like_success() {
-  local msg="${1:-}"
-  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)'
-}
-
-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
-}
-
-artifact_target=""
-minimum_size=200
-
-case "$AGENT_TYPE" in
-  flow-executor)
-    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
-    task_id="$(completed_task_id "$LAST_MESSAGE")"
-    [ -z "$task_id" ] && exit 0
-    if grep -Eq "^- \\[x\\] \\*\\*${task_id//./\\.}\\*\\*" "$artifact_target" 2>/dev/null; then
-      exit 0
-    fi
-    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
-    ;;
-  *)
-    curdx_resolve_artifact_contract "$AGENT_TYPE" "$LAST_MESSAGE" "$FLOW_ROOT" || exit 0
-    artifact_target="$CURDX_ARTIFACT_TARGET"
-    minimum_size="$CURDX_ARTIFACT_MIN_SIZE"
-    ;;
-esac
-
-if [ -f "$artifact_target" ]; then
-  size="$(wc -c < "$artifact_target" 2>/dev/null | tr -d ' ')"
-  if [ "${size:-0}" -ge "$minimum_size" ]; then
-    exit 0
-  fi
-fi
-
-if ! looks_like_success "$LAST_MESSAGE"; then
-  # The subagent appears to be stopping because of a real precondition failure,
-  # clarification request, or other non-success path. Let that response through.
-  exit 0
-fi
-
-emit_subagentstop_block "[CurDX-Flow subagent-artifact-guard] ${AGENT_TYPE} is stopping with a success summary, but ${artifact_target} is missing or too small. Write the full artifact to disk first, then respond with the minimal completion summary only."
-exit 0

package/hooks/scripts/subagent-statusline.sh

@@ -1,111 +0,0 @@
-#!/usr/bin/env bash
-# CurDX-Flow subagentStatusLine command.
-# Reads the official subagent status-line JSON payload from stdin and emits
-# one JSON line per CurDX-Flow subagent row that should be overridden.
-
-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_SUBAGENT_STATUSLINE_INPUT="$INPUT"
-
-python3 <<'PY'
-import json
-import os
-from pathlib import Path
-
-try:
-    data = json.loads(os.environ.get("CURDX_SUBAGENT_STATUSLINE_INPUT", "{}"))
-except Exception:
-    raise SystemExit(0)
-
-columns = data.get("columns")
-try:
-    columns = int(columns)
-except Exception:
-    columns = 100
-columns = max(40, columns)
-
-
-def flow_type(task):
-    raw = str(task.get("type") or task.get("name") or task.get("label") or "")
-    if raw.startswith("curdx-flow:"):
-        raw = raw.split(":", 1)[1]
-    return raw
-
-
-def is_flow_task(task):
-    values = [
-        task.get("type"),
-        task.get("name"),
-        task.get("label"),
-        task.get("description"),
-    ]
-    return any(str(value or "").startswith(("flow-", "curdx-flow:flow-")) for value in values)
-
-
-def active_spec(cwd):
-    if not cwd:
-        return ""
-    try:
-        current = Path(cwd).resolve()
-    except Exception:
-        return ""
-    for candidate in [current, *current.parents]:
-        try:
-            value = (candidate / ".flow" / ".active-spec").read_text(encoding="utf-8").strip()
-        except Exception:
-            continue
-        return value[:40]
-    return ""
-
-
-def token_label(value):
-    try:
-        count = int(value)
-    except Exception:
-        return ""
-    if count >= 1000:
-        return f"{count / 1000:.1f}k tok"
-    return f"{count} tok"
-
-
-def clamp(text):
-    if len(text) <= columns:
-        return text
-    if columns <= 4:
-        return text[:columns]
-    return text[: columns - 3] + "..."
-
-
-for task in data.get("tasks") or []:
-    if not isinstance(task, dict) or not is_flow_task(task):
-        continue
-
-    task_id = task.get("id")
-    if not task_id:
-        continue
-
-    parts = ["[curdx-flow]", flow_type(task) or "flow-agent"]
-
-    status = str(task.get("status") or "").strip()
-    if status:
-        parts.append(status)
-
-    spec = active_spec(task.get("cwd"))
-    if spec:
-        parts.append(f"spec:{spec}")
-
-    tokens = token_label(task.get("tokenCount"))
-    if tokens:
-        parts.append(tokens)
-
-    print(json.dumps({"id": str(task_id), "content": clamp(" | ".join(parts))}, ensure_ascii=True))
-PY

package/hooks/scripts/task-lifecycle-guard.sh

@@ -1,106 +0,0 @@
-#!/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_TASK_GUARD_INPUT="$INPUT"
-
-read_json_field() {
-  local field="$1"
-  python3 - "$field" <<'PY' 2>/dev/null
-import json
-import os
-import sys
-
-try:
-    data = json.loads(os.environ.get("CURDX_TASK_GUARD_INPUT", "{}"))
-except Exception:
-    data = {}
-
-field = sys.argv[1]
-value = data.get(field, "")
-if isinstance(value, str):
-    value = value.strip()
-elif value is None:
-    value = ""
-print(value)
-PY
-}
-
-HOOK_EVENT_NAME="$(read_json_field hook_event_name)"
-TASK_SUBJECT="$(read_json_field task_subject)"
-TASK_DESCRIPTION="$(read_json_field task_description)"
-
-FLOW_ROOT="$(resolve_flow_root 2>/dev/null || true)"
-[ -n "$FLOW_ROOT" ] || exit 0
-
-ACTIVE_SPEC="$(cat "$FLOW_ROOT/.flow/.active-spec" 2>/dev/null || true)"
-[ -n "$ACTIVE_SPEC" ] || exit 0
-
-TASKS_FILE="$FLOW_ROOT/.flow/specs/$ACTIVE_SPEC/tasks.md"
-[ -f "$TASKS_FILE" ] || exit 0
-
-extract_curdx_task_id() {
-  python3 <<'PY' 2>/dev/null
-import os
-import re
-
-subject = os.environ.get("CURDX_TASK_GUARD_SUBJECT", "").strip()
-patterns = [
-    r'^\[P\]\s+([0-9]+(?:\.([0-9]+|VF|X(\+[0-9]+)?))*)\b',
-    r'^\[VERIFY\]\s+([0-9]+(?:\.([0-9]+|VF|X(\+[0-9]+)?))*)\b',
-    r'^([0-9]+(?:\.([0-9]+|VF|X(\+[0-9]+)?))*)\b',
-]
-for pattern in patterns:
-    match = re.match(pattern, subject)
-    if match:
-        print(match.group(1))
-        break
-PY
-}
-
-export CURDX_TASK_GUARD_SUBJECT="$TASK_SUBJECT"
-CURDX_TASK_ID="$(extract_curdx_task_id)"
-[ -n "$CURDX_TASK_ID" ] || exit 0
-
-task_exists() {
-  local escaped_id
-  escaped_id="$(printf '%s' "$1" | sed 's/[.[\*^$()+?{|]/\\&/g')"
-  grep -Eq "^- \\[[ xX]\\] \\*\\*${escaped_id}\\*\\*" "$TASKS_FILE" 2>/dev/null
-}
-
-task_completed() {
-  local escaped_id
-  escaped_id="$(printf '%s' "$1" | sed 's/[.[\*^$()+?{|]/\\&/g')"
-  grep -Eq "^- \\[[xX]\\] \\*\\*${escaped_id}\\*\\*" "$TASKS_FILE" 2>/dev/null
-}
-
-if ! task_exists "$CURDX_TASK_ID"; then
-  printf '%s\n' "[CurDX-Flow task-lifecycle-guard] Native task '${TASK_SUBJECT}' references CurDX task ${CURDX_TASK_ID}, but ${TASKS_FILE} does not contain that task id. Rebuild native tasks from tasks.md before proceeding." >&2
-  exit 2
-fi
-
-case "$HOOK_EVENT_NAME" in
-  TaskCreated)
-    if [ -z "$TASK_DESCRIPTION" ]; then
-      printf '%s\n' "[CurDX-Flow task-lifecycle-guard] Native task '${TASK_SUBJECT}' is missing a description. Include a compact description derived from 'Done when' and 'Verify' so the task list mirrors tasks.md faithfully." >&2
-      exit 2
-    fi
-    ;;
-  TaskCompleted)
-    if ! task_completed "$CURDX_TASK_ID"; then
-      printf '%s\n' "[CurDX-Flow task-lifecycle-guard] Native task '${TASK_SUBJECT}' cannot be marked completed before ${TASKS_FILE} marks ${CURDX_TASK_ID} as [x]. Update tasks.md and disk-backed state first, then complete the native task." >&2
-      exit 2
-    fi
-    ;;
-esac
-
-exit 0

package/hooks/scripts/teammate-idle-guard.sh

@@ -1,83 +0,0 @@
-#!/usr/bin/env bash
-# CurDX-Flow TeammateIdle Hook
-# Keeps artifact-producing CurDX teammates from idling before their disk artifact lands.
-
-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_TEAMMATE_IDLE_INPUT="$INPUT"
-
-read_json_field() {
-  local field="$1"
-  python3 - "$field" <<'PY' 2>/dev/null
-import json
-import os
-import sys
-
-try:
-    data = json.loads(os.environ.get("CURDX_TEAMMATE_IDLE_INPUT", "{}"))
-except Exception:
-    data = {}
-
-value = data.get(sys.argv[1], "")
-if isinstance(value, str):
-    value = value.strip()
-elif value is None:
-    value = ""
-print(value)
-PY
-}
-
-TEAM_NAME="$(read_json_field team_name)"
-TEAMMATE_NAME="$(read_json_field teammate_name)"
-
-[ -n "$TEAM_NAME" ] || exit 0
-[ -n "$TEAMMATE_NAME" ] || exit 0
-
-TEAM_CONFIG="${HOME}/.claude/teams/${TEAM_NAME}/config.json"
-[ -f "$TEAM_CONFIG" ] || exit 0
-
-export CURDX_TEAM_CONFIG="$TEAM_CONFIG"
-export CURDX_TEAMMATE_NAME="$TEAMMATE_NAME"
-
-AGENT_TYPE="$(python3 <<'PY' 2>/dev/null
-import json
-import os
-
-try:
-    data = json.load(open(os.environ["CURDX_TEAM_CONFIG"]))
-except Exception:
-    raise SystemExit(0)
-
-name = os.environ["CURDX_TEAMMATE_NAME"]
-for member in data.get("members", []) or []:
-    if isinstance(member, dict) and (member.get("name") or "").strip() == name:
-        print((member.get("agent_type") or "").strip())
-        break
-PY
-)"
-
-[ -n "$AGENT_TYPE" ] || exit 0
-
-curdx_resolve_artifact_contract "$AGENT_TYPE" "" "$FLOW_ROOT" || exit 0
-
-artifact_target="$CURDX_ARTIFACT_TARGET"
-minimum_size="$CURDX_ARTIFACT_MIN_SIZE"
-
-if [ -f "$artifact_target" ]; then
-  size="$(wc -c < "$artifact_target" 2>/dev/null | tr -d ' ')"
-  if [ "${size:-0}" -ge "$minimum_size" ]; then
-    exit 0
-  fi
-fi
-
-printf '%s\n' "[CurDX-Flow teammate-idle-guard] Teammate '${TEAMMATE_NAME}' (${AGENT_TYPE}) is about to go idle, but ${artifact_target} is missing or too small. Write the required CurDX artifact to disk before idling." >&2
-exit 2

package/knowledge/artifact-output-discipline.md

@@ -1,24 +0,0 @@
-# Artifact Output Discipline
-
-Use this discipline for artifact-producing agents that write canonical files
-such as `research.md`, `requirements.md`, `design.md`, `tasks.md`, or
-`codebase-index.md`.
-
-## Core Rules
-
-1. Write the artifact first. The first substantive action should be the `Write`
-   tool call for the final file content.
-2. Do not preview or paraphrase the artifact inline. The file is the
-   deliverable.
-3. Keep status updates minimal: short bullets or fixed summary lines only.
-4. End with the exact compact output contract defined by the agent-specific
-   section. No extra explanation before or after it.
-5. If something blocks the write, report the blocker directly instead of
-   emitting a fake success summary.
-
-## Why
-
-- Prevents context waste from duplicating the artifact in chat
-- Makes the written file the canonical output surface
-- Keeps artifact-producing subagents consistent across research, product,
-  architecture, planning, and brownfield mapping

package/knowledge/artifact-summary-contracts.md

@@ -1,50 +0,0 @@
-# Artifact Summary Contracts
-
-Use these compact summary contracts after an artifact lands successfully. Pair
-them with `artifact-output-discipline.md`: write first, no preview, then emit
-the exact contract below and stop.
-
-## research.md
-
-```text
-✓ research.md generated
-Recommendations: N
-Next: /curdx-flow:spec --phase=requirements
-```
-
-## requirements.md
-
-```text
-✓ requirements.md generated
-User stories: N
-Functional requirements: N
-Next: /curdx-flow:spec --phase=design
-```
-
-## design.md
-
-```text
-✓ design.md generated
-Architecture decisions: N
-Components: N
-Next: /curdx-flow:spec --phase=tasks
-```
-
-## tasks.md
-
-```text
-✓ tasks.md generated
-Total tasks: N
-Coverage audit: PASS
-Phases: 1-5
-Next: /curdx-flow:implement
-```
-
-## codebase-index.md
-
-```text
-✓ codebase-index.md generated
-Modules: N
-Entry points: N
-Next: /curdx-flow:start <feature-name>
-```