{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Grid Settings",
  "description": "Configuration schema for The Grid multi-agent orchestration system",
  "type": "object",
  "properties": {
    "grid": {
      "type": "object",
      "description": "Grid configuration namespace",
      "properties": {
        "modelTier": {
          "type": "string",
          "enum": ["quality", "balanced", "budget"],
          "default": "quality",
          "description": "Model selection tier. 'quality' uses opus for reasoning, 'balanced' uses sonnet, 'budget' optimizes for cost with haiku where appropriate."
        },
        "budgetLimit": {
          "type": "number",
          "minimum": 0,
          "default": 0,
          "description": "Maximum spend limit in dollars. Set to 0 for unlimited. Grid will pause and warn when approaching this limit."
        },
        "autoVerify": {
          "type": "boolean",
          "default": true,
          "description": "Automatically run Recognizer verification after execution completes. Recommended for quality assurance."
        },
        "autoRefine": {
          "type": "boolean",
          "default": false,
          "description": "Automatically run the refinement swarm after execution. Adds polish but increases cost and time."
        },
        "daemonMode": {
          "type": "boolean",
          "default": false,
          "description": "Enable background execution mode. Grid will run autonomously and notify on completion or checkpoint."
        },
        "quickModeThreshold": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "default": 5,
          "description": "Maximum number of files that can be modified for a task to qualify for quick mode (no planning phase)."
        },
        "notifications": {
          "type": "object",
          "description": "Notification preferences for daemon mode and long-running tasks",
          "properties": {
            "system": {
              "type": "boolean",
              "default": true,
              "description": "Show system notifications (macOS/Linux) on completion"
            },
            "sound": {
              "type": "boolean",
              "default": true,
              "description": "Play sound on completion (macOS only)"
            }
          },
          "additionalProperties": false
        },
        "models": {
          "type": "object",
          "description": "Per-agent model overrides. Keys are agent names (e.g., 'planner', 'executor'), values are model names.",
          "additionalProperties": {
            "type": "string",
            "description": "Model name or alias (e.g., 'opus', 'sonnet', 'haiku', or full model ID)"
          }
        }
      },
      "additionalProperties": false
    }
  },
  "examples": [
    {
      "grid": {
        "modelTier": "balanced",
        "budgetLimit": 25.00,
        "autoVerify": true,
        "autoRefine": false,
        "quickModeThreshold": 5
      }
    },
    {
      "grid": {
        "modelTier": "quality",
        "budgetLimit": 0,
        "autoVerify": true,
        "autoRefine": true,
        "daemonMode": true,
        "notifications": {
          "system": true,
          "sound": true
        }
      }
    },
    {
      "grid": {
        "modelTier": "budget",
        "budgetLimit": 5.00,
        "autoVerify": false,
        "models": {
          "planner": "sonnet",
          "executor": "haiku"
        }
      }
    }
  ]
}