@curdx/flow 3.0.0 → 3.1.0

package/monitors/scripts/flow-state-monitor.sh

@@ -1,102 +0,0 @@
-#!/usr/bin/env bash
-
-set -u
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-. "$SCRIPT_DIR/../../hooks/scripts/common.sh"
-
-interval="${CLAUDE_PLUGIN_OPTION_MONITOR_INTERVAL_SECONDS:-8}"
-case "$interval" in
-  ''|*[!0-9]*)
-    interval=8
-    ;;
-esac
-if [ "$interval" -lt 3 ] 2>/dev/null; then
-  interval=3
-fi
-
-build_snapshot() {
-  local flow_root=""
-  flow_root="$(resolve_flow_root 2>/dev/null || true)"
-  [ -n "$flow_root" ] || return 0
-
-  local active=""
-  active="$(cat "$flow_root/.flow/.active-spec" 2>/dev/null || true)"
-  [ -z "$active" ] && return 0
-
-  local spec_dir="$flow_root/.flow/specs/$active"
-  [ ! -d "$spec_dir" ] && return 0
-
-  local state_file="$spec_dir/.state.json"
-  local tasks_file="$spec_dir/tasks.md"
-
-  python3 - "$active" "$state_file" "$tasks_file" <<'PY' 2>/dev/null
-import json
-import os
-import re
-import sys
-
-active, state_file, tasks_file = sys.argv[1:4]
-
-phase = "unknown"
-strategy = "unknown"
-task_index = 0
-total_tasks = 0
-failed_attempts = 0
-global_iteration = 0
-
-if os.path.exists(state_file):
-    try:
-        state = json.load(open(state_file, "r", encoding="utf-8"))
-        phase = state.get("phase") or phase
-        strategy = state.get("strategy") or strategy
-        execute_state = state.get("execute_state") or {}
-        task_index = execute_state.get("task_index") or 0
-        total_tasks = execute_state.get("total_tasks") or 0
-        failed_attempts = execute_state.get("failed_attempts") or 0
-        global_iteration = execute_state.get("global_iteration") or 0
-    except Exception:
-        phase = "invalid-state"
-
-unchecked = 0
-if os.path.exists(tasks_file):
-    try:
-        text = open(tasks_file, "r", encoding="utf-8").read()
-        unchecked = len(re.findall(r"^- \[ \] \*\*[0-9]+(\.[0-9]+|\.VF|\.X(\+[0-9]+)?)*\*\*", text, re.M))
-    except Exception:
-        unchecked = -1
-
-parts = [
-    f"CurDX-Flow monitor: spec={active}",
-    f"phase={phase}",
-    f"strategy={strategy}",
-]
-
-if total_tasks > 0:
-    parts.append(f"tasks={task_index}/{total_tasks}")
-parts.append(f"unchecked={unchecked}")
-
-if failed_attempts > 0:
-    parts.append(f"failed_attempts={failed_attempts}")
-if global_iteration > 0:
-    parts.append(f"loop={global_iteration}")
-
-print(" ".join(parts))
-PY
-}
-
-last_snapshot=""
-
-while true; do
-  snapshot="$(build_snapshot)"
-  if [ -n "$snapshot" ] && [ "$snapshot" != "$last_snapshot" ]; then
-    printf '%s\n' "$snapshot"
-    last_snapshot="$snapshot"
-  fi
-
-  if [ "${CURDX_FLOW_MONITOR_ONCE:-0}" = "1" ]; then
-    exit 0
-  fi
-
-  sleep "$interval"
-done

package/output-styles/curdx-evidence-first.md

@@ -1,34 +0,0 @@
----
-name: CurdX Evidence-First
-description: Concise, engineering-focused replies with explicit validation status, assumptions, and next actions.
-keep-coding-instructions: true
----
-
-# CurdX Evidence-First
-
-You are still Claude Code. Keep the default coding workflow, safety rules,
-tool usage behavior, and verification discipline.
-
-## Response priorities
-
-1. Lead with the concrete outcome or current state.
-2. State validation status explicitly:
-   - `Validated` when you actually ran checks and they passed
-   - `Unvalidated` when you did not run checks yet
-   - `Blocked` when validation could not be completed
-3. Separate observed facts from assumptions or proposals.
-4. Keep answers concise and operational; avoid filler and cheerleading.
-5. When work is incomplete, state the next highest-value action plainly.
-
-## Completion discipline
-
-- Never imply something is done without evidence.
-- If tests, builds, browser checks, or docs validation were not run, say so directly.
-- If you are making a best-effort inference, label it as an inference.
-- When relevant, point to the exact file paths or commands that support the claim.
-
-## Formatting
-
-- Use short section headers only when they improve scanability.
-- Prefer short bullet lists over long prose.
-- Match the user's language.

package/output-styles/curdx-fast-mode.md

@@ -1,42 +0,0 @@
----
-name: CurdX Fast Mode
-description: Low-ceremony style for /curdx-flow:fast and small surgical work. Skip preamble, ship the change, validate, stop.
-keep-coding-instructions: true
----
-
-# CurdX Fast Mode
-
-You are still Claude Code. Keep the default coding workflow, safety rules,
-tool usage behavior, and verification discipline. This style strips ceremony
-for small, well-bounded tasks.
-
-## When this style fits
-
-Use during `/curdx-flow:fast` runs or any task that is obviously small,
-surgical, low-ambiguity, and not worth a full spec workflow.
-
-## Response priorities
-
-1. State the change in one sentence before the first edit.
-2. Make the smallest correct edit — do not refactor surrounding code, do
-   not introduce abstractions, do not "improve" unrelated lines.
-3. Run the smallest verification that proves the change works (one test,
-   one command, one curl). State it explicitly.
-4. End with a one-line status: `Validated` (with evidence), `Unvalidated`
-   (with reason), or `Blocked` (with the blocker).
-5. If you find scope creep — a second bug, a desired refactor, an unclear
-   interface — stop and surface it instead of expanding silently.
-
-## Hard rules
-
-- No spec scaffolding, no phase narration, no "let me think step by step".
-- No defensive validation, no fallback paths, no try/except for impossible
-  cases.
-- No new files unless the change inherently requires one.
-- No follow-on TODOs in the diff. Surface them in the reply, not the code.
-
-## Format
-
-- Plain prose with one diff or one command per paragraph.
-- Bullets only when listing more than two parallel items.
-- No section headers under three lines of content.

package/output-styles/curdx-spec-mode.md

@@ -1,46 +0,0 @@
----
-name: CurdX Spec Mode
-description: Spec-driven verbose style for multi-phase work. Lead with the active phase, cite artifact paths, and never claim done without an evidence block.
-keep-coding-instructions: true
----
-
-# CurdX Spec Mode
-
-You are still Claude Code. Keep the default coding workflow, safety rules,
-tool usage behavior, and verification discipline. This style adds spec-driven
-discipline on top of the defaults.
-
-## When this style fits
-
-Use this style during multi-phase CurDX-Flow work — research / requirements /
-design / tasks / execute / verify — when the user wants a clear paper trail
-across phases.
-
-## Response priorities
-
-1. State the active spec and phase explicitly. If no spec is active, say so.
-2. Lead with the artifact you produced or modified, including its full path
-   under `.flow/specs/<active>/`.
-3. Quote the smallest concrete decision that drove the change (one or two
-   lines). Do not repeat the full artifact body.
-4. End every reply with one of: `Validated`, `Unvalidated`, `Blocked`. State
-   what evidence backs the label.
-5. When proposing a next step, name the exact CurDX-Flow surface that should
-   run it (`/curdx-flow:spec --phase=design`, `flow-verifier`, etc.).
-
-## Hard rules
-
-- Never claim a phase is complete without referencing the produced artifact
-  on disk and the gate it passed.
-- Never produce a long architecture essay in chat — that belongs in the
-  spec artifact. The reply should point to the file and call out the
-  decision taken.
-- Never advance phase state from chat narrative. The phase counter in
-  `.state.json` is the source of truth; only the corresponding skill or
-  agent is allowed to advance it.
-
-## Format
-
-- Short headers only when they aid scanning.
-- Bullets for status, prose only for the decision rationale.
-- Match the user's language.

package/schemas/agent-frontmatter.schema.json

@@ -1,66 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://curdx-flow.dev/schemas/agent-frontmatter.schema.json",
-  "title": "CurdX-Flow Agent Frontmatter",
-  "description": "Supported YAML frontmatter fields for agents/*.md plugin subagent definitions. Tracks the canonical field list documented at https://code.claude.com/docs/en/sub-agents.md#supported-frontmatter-fields. The fields `hooks`, `mcpServers`, and `permissionMode` are canonical for non-plugin agents but are silently ignored when an agent is loaded from a plugin (Claude Code security boundary), so this schema intentionally omits them — `additionalProperties: false` rejects them and surfaces the mistake at validation time instead of at runtime.",
-  "type": "object",
-  "required": ["name", "description"],
-  "additionalProperties": false,
-  "properties": {
-    "name": {
-      "type": "string",
-      "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
-    },
-    "description": {
-      "type": "string",
-      "minLength": 1
-    },
-    "tools": {
-      "oneOf": [
-        { "type": "string" },
-        { "type": "array", "items": { "type": "string" } }
-      ]
-    },
-    "disallowedTools": {
-      "oneOf": [
-        { "type": "string" },
-        { "type": "array", "items": { "type": "string" } }
-      ]
-    },
-    "model": {
-      "type": "string"
-    },
-    "effort": {
-      "type": "string",
-      "enum": ["low", "medium", "high", "xhigh", "max"]
-    },
-    "maxTurns": {
-      "type": "integer",
-      "minimum": 1
-    },
-    "skills": {
-      "oneOf": [
-        { "type": "string" },
-        { "type": "array", "items": { "type": "string" } }
-      ]
-    },
-    "memory": {
-      "type": "string",
-      "enum": ["user", "project", "local"]
-    },
-    "background": {
-      "type": "boolean"
-    },
-    "isolation": {
-      "type": "string",
-      "enum": ["worktree"]
-    },
-    "initialPrompt": {
-      "type": "string"
-    },
-    "color": {
-      "type": "string",
-      "enum": ["red", "blue", "green", "yellow", "purple", "orange", "pink", "cyan"]
-    }
-  }
-}

package/schemas/config.schema.json

@@ -1,134 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://curdx-flow.dev/schemas/config.schema.json",
-  "title": "CurdX-Flow Project Config",
-  "description": "Schema for .flow/config.json",
-  "type": "object",
-  "required": ["version", "mode"],
-  "properties": {
-    "$schema": { "type": "string" },
-    "version": {
-      "type": "string",
-      "const": "1.0"
-    },
-    "mode": {
-      "type": "string",
-      "enum": ["fast", "standard", "enterprise"],
-      "description": "Default workflow depth for this project"
-    },
-    "execution": {
-      "type": "object",
-      "properties": {
-        "strategy": {
-          "type": "string",
-          "enum": ["auto", "subagent", "stop-hook", "wave", "linear"],
-          "default": "auto"
-        },
-        "max_parallel": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 20,
-          "default": 5
-        },
-        "subagent_threshold": {
-          "type": "integer",
-          "minimum": 1,
-          "default": 8,
-          "description": "Task count above which subagent strategy is preferred"
-        },
-        "wave_fail_policy": {
-          "type": "string",
-          "enum": ["continue-on-single", "stop-on-any"],
-          "default": "continue-on-single"
-        },
-        "recovery_mode": {
-          "type": "string",
-          "enum": ["manual", "fix-task"],
-          "default": "manual",
-          "description": "How /curdx-flow:implement handles TASK_FAILED during execution. manual blocks for retry; fix-task inserts targeted [FIX <task>] tasks before retrying."
-        },
-        "max_fix_tasks_per_original": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 5,
-          "default": 2,
-          "description": "Maximum generated [FIX <task>] tasks allowed for a single original task when recovery_mode is fix-task."
-        }
-      }
-    },
-    "gates": {
-      "type": "object",
-      "description": "Which quality gates to enable. Gate definitions live in gates/*.md (Phase 3)",
-      "properties": {
-        "always_on": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/gateName" },
-          "default": ["karpathy-gate", "verification-gate"]
-        },
-        "standard_mode": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/gateName" }
-        },
-        "enterprise_mode": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/gateName" }
-        }
-      }
-    },
-    "specs": {
-      "type": "object",
-      "properties": {
-        "directories": {
-          "type": "array",
-          "items": { "type": "string" },
-          "default": ["./.flow/specs"],
-          "description": "Monorepo-friendly: multiple spec directories supported"
-        },
-        "default_task_size": {
-          "type": "string",
-          "enum": ["fine", "coarse"],
-          "default": "fine"
-        }
-      }
-    },
-    "addons": {
-      "type": "object",
-      "properties": {
-        "pua": {
-          "type": "object",
-          "properties": {
-            "enabled": { "type": "boolean", "default": false },
-            "style": {
-              "type": "string",
-              "enum": ["alibaba", "bytedance", "huawei", "tencent", "baidu", "pdd", "meituan", "jd", "xiaomi", "netflix", "musk", "jobs", "amazon"]
-            },
-            "auto_trigger": {
-              "type": "string",
-              "enum": ["on-failure", "always", "manual"]
-            }
-          }
-        }
-      }
-    },
-    "created": {
-      "type": "string",
-      "format": "date"
-    }
-  },
-  "definitions": {
-    "gateName": {
-      "type": "string",
-      "enum": [
-        "karpathy-gate",
-        "verification-gate",
-        "tdd-gate",
-        "test-quality-gate",
-        "coverage-audit-gate",
-        "adversarial-review-gate",
-        "edge-case-gate",
-        "security-gate",
-        "devex-gate"
-      ]
-    }
-  }
-}

package/schemas/gate-frontmatter.schema.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://curdx-flow.dev/schemas/gate-frontmatter.schema.json",
-  "title": "CurdX-Flow Gate Frontmatter",
-  "description": "Supported YAML frontmatter fields for gates/*.md quality gate definitions.",
-  "type": "object",
-  "required": ["gate", "category", "severity", "depends_on"],
-  "additionalProperties": false,
-  "properties": {
-    "gate": {
-      "type": "string",
-      "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
-    },
-    "category": {
-      "type": "string",
-      "enum": ["always-on", "standard-mode", "enterprise-mode"]
-    },
-    "severity": {
-      "type": "string",
-      "enum": ["blocking", "warning"]
-    },
-    "depends_on": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
-      }
-    }
-  }
-}

package/schemas/hooks.schema.json

@@ -1,115 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://curdx-flow.dev/schemas/hooks.schema.json",
-  "title": "CurdX-Flow Hook Configuration",
-  "description": "Supported event names and handler shape for hooks/hooks.json.",
-  "type": "object",
-  "required": ["hooks"],
-  "additionalProperties": false,
-  "properties": {
-    "hooks": {
-      "type": "object",
-      "propertyNames": {
-        "enum": [
-          "SessionStart",
-          "InstructionsLoaded",
-          "UserPromptSubmit",
-          "UserPromptExpansion",
-          "PreToolUse",
-          "PermissionRequest",
-          "PostToolUse",
-          "PostToolUseFailure",
-          "PostToolBatch",
-          "PermissionDenied",
-          "Notification",
-          "SubagentStart",
-          "SubagentStop",
-          "TaskCreated",
-          "TaskCompleted",
-          "Stop",
-          "StopFailure",
-          "TeammateIdle",
-          "ConfigChange",
-          "CwdChanged",
-          "FileChanged",
-          "WorktreeCreate",
-          "WorktreeRemove",
-          "PreCompact",
-          "PostCompact",
-          "Elicitation",
-          "ElicitationResult",
-          "SessionEnd"
-        ]
-      },
-      "additionalProperties": {
-        "type": "array",
-        "items": { "$ref": "#/definitions/matcherGroup" }
-      }
-    }
-  },
-  "definitions": {
-    "matcherGroup": {
-      "type": "object",
-      "required": ["hooks"],
-      "additionalProperties": false,
-      "properties": {
-        "matcher": { "type": "string" },
-        "hooks": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/hookHandler" }
-        }
-      }
-    },
-    "hookHandler": {
-      "type": "object",
-      "required": ["type"],
-      "additionalProperties": false,
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": ["command", "http", "mcp_tool", "prompt", "agent"]
-        },
-        "if": { "type": "string" },
-        "timeout": { "type": "integer", "minimum": 1 },
-        "statusMessage": { "type": "string" },
-        "async": { "type": "boolean" },
-        "asyncRewake": { "type": "boolean" },
-        "once": { "type": "boolean" },
-        "command": { "type": "string" },
-        "shell": {
-          "type": "string",
-          "enum": ["bash", "powershell"]
-        },
-        "url": { "type": "string" },
-        "headers": { "type": "object" },
-        "allowedEnvVars": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "server": { "type": "string" },
-        "tool": { "type": "string" },
-        "input": { "type": "object" },
-        "prompt": { "type": "string" },
-        "model": { "type": "string" }
-      },
-      "allOf": [
-        {
-          "if": { "properties": { "type": { "const": "command" } } },
-          "then": { "required": ["command"] }
-        },
-        {
-          "if": { "properties": { "type": { "const": "http" } } },
-          "then": { "required": ["url"] }
-        },
-        {
-          "if": { "properties": { "type": { "const": "mcp_tool" } } },
-          "then": { "required": ["server", "tool"] }
-        },
-        {
-          "if": { "properties": { "type": { "enum": ["prompt", "agent"] } } },
-          "then": { "required": ["prompt"] }
-        }
-      ]
-    }
-  }
-}

package/schemas/output-style-frontmatter.schema.json

@@ -1,22 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://curdx-flow.dev/schemas/output-style-frontmatter.schema.json",
-  "title": "CurdX-Flow Output Style Frontmatter",
-  "description": "Supported YAML frontmatter fields for output-styles/*.md.",
-  "type": "object",
-  "required": ["name", "description", "keep-coding-instructions"],
-  "additionalProperties": false,
-  "properties": {
-    "name": {
-      "type": "string",
-      "minLength": 1
-    },
-    "description": {
-      "type": "string",
-      "minLength": 1
-    },
-    "keep-coding-instructions": {
-      "type": "boolean"
-    }
-  }
-}