@curdx/flow 1.1.4 → 1.1.6

package/schemas/config.schema.json

@@ -0,0 +1,100 @@
+{
+  "$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": ["sketch", "fast", "standard", "enterprise", "autonomous"],
+      "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"
+        }
+      }
+    },
+    "gates": {
+      "type": "object",
+      "description": "Which quality gates to enable. Gate definitions live in gates/*.md (Phase 3)",
+      "properties": {
+        "always_on": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": ["karpathy-gate", "verification-gate"]
+        },
+        "standard_mode": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "enterprise_mode": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "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"
+    }
+  }
+}

package/schemas/spec-frontmatter.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://curdx-flow.dev/schemas/spec-frontmatter.schema.json",
+  "title": "CurDX-Flow Spec Document Frontmatter",
+  "description": "YAML frontmatter at the top of research.md / requirements.md / design.md / tasks.md",
+  "type": "object",
+  "required": ["spec", "phase", "created", "version"],
+  "properties": {
+    "spec": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "phase": {
+      "type": "string",
+      "enum": ["research", "requirements", "design", "tasks"]
+    },
+    "created": {
+      "type": "string",
+      "format": "date"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+$"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["in_progress", "approved", "frozen", "superseded"]
+    },
+    "depends_on": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ],
+      "description": "Other spec files this one depends on (e.g. design.md depends on requirements.md)"
+    },
+    "task_size": {
+      "type": "string",
+      "enum": ["fine", "coarse"],
+      "description": "Only in tasks.md"
+    }
+  }
+}

package/schemas/spec-state.schema.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://curdx-flow.dev/schemas/spec-state.schema.json",
+  "title": "CurDX-Flow Spec State",
+  "description": "Schema for .flow/specs/<name>/.state.json — tracks phase progress across sessions",
+  "type": "object",
+  "required": ["version", "spec_name", "phase"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "1.0"
+    },
+    "spec_name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Kebab-case identifier matching the directory name"
+    },
+    "goal": {
+      "type": "string",
+      "description": "One-sentence goal from /flow-start"
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["sketch", "fast", "standard", "enterprise", "autonomous"],
+      "default": "standard"
+    },
+    "strategy": {
+      "type": "string",
+      "enum": ["auto", "subagent", "stop-hook", "wave", "linear"],
+      "default": "auto"
+    },
+    "phase": {
+      "type": "string",
+      "enum": [
+        "research",
+        "requirements",
+        "design",
+        "tasks",
+        "execute",
+        "verify",
+        "review",
+        "ship",
+        "completed"
+      ]
+    },
+    "phase_status": {
+      "type": "object",
+      "properties": {
+        "research": { "$ref": "#/definitions/phaseStatus" },
+        "requirements": { "$ref": "#/definitions/phaseStatus" },
+        "design": { "$ref": "#/definitions/phaseStatus" },
+        "tasks": { "$ref": "#/definitions/phaseStatus" },
+        "execute": { "$ref": "#/definitions/phaseStatus" },
+        "verify": { "$ref": "#/definitions/phaseStatus" },
+        "review": { "$ref": "#/definitions/phaseStatus" },
+        "ship": { "$ref": "#/definitions/phaseStatus" }
+      }
+    },
+    "execute_state": {
+      "type": "object",
+      "description": "Runtime state for Phase 2 (execution engine, post-Phase 1)",
+      "properties": {
+        "poc_complete": { "type": "boolean" },
+        "refactor_complete": { "type": "boolean" },
+        "test_complete": { "type": "boolean" },
+        "quality_gate_complete": { "type": "boolean" },
+        "task_index": { "type": "integer", "minimum": 0 },
+        "total_tasks": { "type": "integer", "minimum": 0 },
+        "task_iteration": { "type": "integer", "minimum": 1 },
+        "global_iteration": { "type": "integer", "minimum": 1 },
+        "failed_attempts": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "decisions": {
+      "type": "array",
+      "description": "Decisions locked in this spec (mirror of what's in STATE.md)",
+      "items": {
+        "type": "object",
+        "required": ["id", "decision"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^D-[0-9]{2,}$"
+          },
+          "decision": { "type": "string" },
+          "rationale": { "type": "string" },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      }
+    },
+    "gates_enabled": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "agents_active": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "created": {
+      "type": "string",
+      "format": "date"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date-time"
+    }
+  },
+  "definitions": {
+    "phaseStatus": {
+      "type": "string",
+      "enum": ["not_started", "in_progress", "completed", "skipped", "failed"]
+    }
+  }
+}