{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Issue Task JSONL Schema",
  "description": "Schema for individual task entries in tasks.jsonl file",
  "type": "object",
  "required": ["id", "title", "type", "description", "depends_on", "delivery_criteria", "status", "current_phase", "executor"],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique task identifier (e.g., TASK-001)",
      "pattern": "^TASK-[0-9]+$"
    },
    "title": {
      "type": "string",
      "description": "Short summary of the task",
      "maxLength": 100
    },
    "type": {
      "type": "string",
      "enum": ["feature", "bug", "refactor", "test", "chore", "docs"],
      "description": "Task category"
    },
    "description": {
      "type": "string",
      "description": "Detailed instructions for the task"
    },
    "file_context": {
      "type": "array",
      "items": { "type": "string" },
      "description": "List of relevant files/globs",
      "default": []
    },
    "depends_on": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Array of Task IDs that must complete first",
      "default": []
    },
    "delivery_criteria": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Checklist items that define task completion",
      "minItems": 1
    },
    "pause_criteria": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Conditions that should halt execution (e.g., 'API spec unclear')",
      "default": []
    },
    "status": {
      "type": "string",
      "enum": ["pending", "ready", "in_progress", "completed", "failed", "paused", "skipped"],
      "description": "Current task status",
      "default": "pending"
    },
    "current_phase": {
      "type": "string",
      "enum": ["analyze", "implement", "test", "optimize", "commit", "done"],
      "description": "Current execution phase within the task lifecycle",
      "default": "analyze"
    },
    "executor": {
      "type": "string",
      "enum": ["agent", "codex", "gemini", "auto"],
      "description": "Preferred executor for this task",
      "default": "auto"
    },
    "priority": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Task priority (1=highest, 5=lowest)",
      "default": 3
    },
    "phase_results": {
      "type": "object",
      "description": "Results from each execution phase",
      "properties": {
        "analyze": {
          "type": "object",
          "properties": {
            "status": { "type": "string" },
            "findings": { "type": "array", "items": { "type": "string" } },
            "timestamp": { "type": "string", "format": "date-time" }
          }
        },
        "implement": {
          "type": "object",
          "properties": {
            "status": { "type": "string" },
            "files_modified": { "type": "array", "items": { "type": "string" } },
            "timestamp": { "type": "string", "format": "date-time" }
          }
        },
        "test": {
          "type": "object",
          "properties": {
            "status": { "type": "string" },
            "test_results": { "type": "string" },
            "retry_count": { "type": "integer" },
            "timestamp": { "type": "string", "format": "date-time" }
          }
        },
        "optimize": {
          "type": "object",
          "properties": {
            "status": { "type": "string" },
            "improvements": { "type": "array", "items": { "type": "string" } },
            "timestamp": { "type": "string", "format": "date-time" }
          }
        },
        "commit": {
          "type": "object",
          "properties": {
            "status": { "type": "string" },
            "commit_hash": { "type": "string" },
            "message": { "type": "string" },
            "timestamp": { "type": "string", "format": "date-time" }
          }
        }
      }
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Task creation timestamp"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Last update timestamp"
    }
  },
  "additionalProperties": false
}