{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/JamesMorales04/agentic-engineering-harness/schemas/project.schema.json",
  "title": "Agentic Engineering Harness project configuration",
  "type": "object",
  "required": ["version", "project"],
  "properties": {
    "version": { "const": 1 },
    "project": { "type": "object", "required": ["name"], "properties": { "name": { "type": "string", "minLength": 1 } } },
    "agents": { "type": "object", "properties": { "configPath": { "type": "string" }, "generatedPath": { "type": "string" }, "activeProfile": { "type": "string" }, "required": { "type": "boolean" }, "findingsDir": { "type": "string" } } },
    "controlPlane": { "type": "object", "properties": { "snapshotDir": { "type": "string" }, "include": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" } } },
    "workflow": { "type": "object", "properties": {
      "quick": { "type": "object", "properties": { "maxFiles": { "type": "integer", "minimum": 1 }, "disallowedDomains": { "type": "array", "items": { "type": "string" } } } },
      "issueIntake": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "snapshotDir": { "type": "string" }, "verifyDriftOnRun": { "type": "boolean" }, "requireOpen": { "type": "boolean" }, "plannerAgent": { "type": "string", "minLength": 1 }, "autoHandoff": { "type": "boolean" } } },
      "planning": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "plannerAgent": { "type": "string" }, "worktreeIsolation": { "type": "boolean" }, "barrierValidation": { "type": "boolean" }, "maxWaveConcurrency": { "type": "integer", "minimum": 1 }, "distributed": { "type": "boolean" } } },
      "reviews": { "type": "object", "properties": {
        "enabled": { "type": "boolean" }, "reviewQuick": { "type": "boolean" }, "leadAcceptance": { "type": "boolean" }, "leadAcceptanceQuick": { "type": "boolean" },
        "maxRemediationRounds": { "type": "integer", "minimum": 0, "deprecated": true },
        "blockingSeverities": { "type": "array", "deprecated": true, "items": { "enum": ["critical", "high", "medium", "low", "note"] } },
        "quality": { "type": "object", "properties": { "severityPoints": { "$ref": "#/$defs/severityNumbers" } } },
        "convergence": { "type": "object", "properties": { "minimumDebtPointImprovement": { "type": "integer", "minimum": 0 }, "stagnationWindow": { "type": "integer", "minimum": 1 }, "cycleDetection": { "type": "boolean" }, "regressionDetection": { "type": "boolean" } } },
        "finalQualityGate": { "type": "object", "properties": { "maxBySeverity": { "$ref": "#/$defs/severityNumbers" }, "maxDebtPoints": { "type": "integer", "minimum": 0 } } },
        "escalation": { "type": "object", "properties": { "criticalStartStage": { "type": "integer", "minimum": 0 }, "replanResumeStage": { "type": "integer", "minimum": 0 }, "stages": { "type": "array", "items": { "type": "object", "required": ["name"], "properties": { "name": { "type": "string", "minLength": 1 }, "action": { "enum": ["remediate", "diagnose", "replan"] }, "agent": { "type": "string", "minLength": 1 }, "model": { "type": "string", "minLength": 1 } } } } } }
      } }
    } },
    "orchestration": { "type": "object", "properties": {
      "provider": { "type": "string" },
      "required": { "type": "boolean" },
      "worker": { "type": "object", "properties": { "provider": { "type": "string" }, "model": { "type": "string" }, "maxRepairAttempts": { "type": "integer", "minimum": 0 }, "titlePrefix": { "type": "string" } } },
      "operations": { "type": "object", "properties": {
        "ownerBoundaryScope": { "enum": ["CHAIN_SCOPED_BOUNDARY", "PROJECT_OR_OWNER_GLOBAL_BOUNDARY"], "default": "CHAIN_SCOPED_BOUNDARY" },
        "supervision": { "type": "object", "properties": { "initializationTimeoutSeconds": { "type": "integer", "minimum": 1 }, "turnTimeoutSeconds": { "type": "integer", "minimum": 1 }, "context": { "type": "object", "properties": { "handoffThreshold": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 }, "hardHandoffThreshold": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 } } } } },
        "liveness": { "$ref": "#/$defs/executionLiveness" },
        "economicEnvelope": { "$ref": "#/$defs/economicEnvelope" }
      } },
      "interactive": { "type": "object", "properties": {
        "autoSetup": { "type": "boolean" },
        "webUi": { "type": "boolean" },
        "leadAgent": { "type": "string", "minLength": 1 },
        "reuseSession": { "type": "boolean", "deprecated": true },
        "sessionPolicy": { "enum": ["fresh-on-start", "reuse-compatible", "resume-explicit"] },
        "usePaseoTools": { "type": "boolean" },
        "context": { "type": "object", "properties": { "pressureThreshold": { "type": "number", "minimum": 0, "maximum": 1 }, "handoffThreshold": { "type": "number", "minimum": 0, "maximum": 1 }, "hardHandoffThreshold": { "type": "number", "minimum": 0, "maximum": 1 } } },
        "stateDir": { "type": "string", "minLength": 1 },
        "title": { "type": "string", "minLength": 1 }
      } }
    } },
    "toolchain": { "type": "object", "properties": { "configPath": { "type": "string" }, "lockPath": { "type": "string" }, "statePath": { "type": "string" }, "generatedMisePath": { "type": "string" } } },
    "mcp": { "type": "object", "properties": {
      "servers": { "type": "object", "additionalProperties": { "type": "object", "required": ["type"], "properties": { "description": { "type": "string" }, "type": { "enum": ["local", "remote"] }, "command": { "type": "array", "items": { "type": "string" }, "minItems": 1 }, "url": { "type": "string", "format": "uri" }, "environment": { "type": "object", "additionalProperties": { "type": "string" } }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "oauth": { "type": "boolean" }, "enabled": { "type": "boolean" }, "timeoutMs": { "type": "integer", "minimum": 1 }, "codemode": { "type": "boolean" } } } },
      "benchmark": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "resultsDir": { "type": "string" }, "repetitions": { "type": "integer", "minimum": 1 } } },
      "packs": { "type": "object", "additionalProperties": { "type": "object", "required": ["servers"], "properties": { "servers": { "type": "array", "items": { "type": "string" } }, "enabled": { "type": "boolean" } } } }
    } },
    "delivery": { "type": "object", "properties": { "stateDir": { "type": "string" }, "github": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "allowedActions": { "type": "array", "items": { "enum": ["git.branch.create","git.commit","git.push","github.issue.create","github.branch.create","github.pull-request.create","github.pull-request.merge"] } }, "tokenEnv": { "type": "string", "minLength": 1 }, "repository": { "type": "string", "pattern": "^[^/]+/[^/]+$" }, "apiBaseUrl": { "type": "string", "format": "uri" }, "assignTokenOwner": { "type": "boolean" }, "labels": { "type": "array", "items": { "type": "string" } }, "branchPattern": { "type": "string", "minLength": 1 }, "finalizeOnAcceptance": { "type": "boolean" }, "pullRequestDraft": { "type": "boolean" }, "pullRequests": { "type": "boolean" }, "mergeMode": { "enum": ["PR_ONLY","AUTO_MERGE","RISK_GATED"] } }, "allOf": [{ "if": { "properties": { "enabled": { "const": true } }, "required": ["enabled"] }, "then": { "required": ["allowedActions"] } }] }, "paseo": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "createWorkspace": { "type": "boolean" }, "autoUseWorkspace": { "type": "boolean" }, "worktreeSlugPattern": { "type": "string", "minLength": 1 } } } } },
    "memory": { "type": "object" },
    "codeIntelligence": { "type": "object", "properties": { "provider": { "type": "string" }, "required": { "type": "boolean" }, "graphPath": { "type": "string" }, "snapshotDir": { "type": "string" }, "codeOnly": { "type": "boolean" }, "refreshCommand": { "type": "string" }, "scheduling": { "type": "object", "properties": { "useEdges": { "type": "boolean" }, "maxGraphHops": { "type": "integer", "minimum": 1 }, "maxSharedNodes": { "type": "integer", "minimum": 0 }, "centralityConflictThreshold": { "type": "number", "minimum": 0 } } } } },
    "context": { "type": "object", "properties": {
      "mode": { "enum": ["observe", "enforce"] },
      "budgets": { "type": "object", "properties": {
        "default": { "$ref": "#/$defs/contextBudget" },
        "agents": { "type": "object", "additionalProperties": { "$ref": "#/$defs/contextBudget" } },
        "phases": { "type": "object", "additionalProperties": { "$ref": "#/$defs/contextBudget" } }
      } },
      "repositoryMap": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "tokenBudget": { "type": "integer", "minimum": 1 }, "maxGraphHops": { "type": "integer", "minimum": 1 } } },
      "semanticRetrieval": { "type": "object", "properties": { "provider": { "type": "string", "const": "serena" }, "required": { "const": true }, "editing": { "type": "boolean" } } },
      "compression": { "type": "object", "properties": { "provider": { "type": "string", "const": "headroom" }, "required": { "const": true }, "minTokens": { "type": "integer", "minimum": 1 }, "reversible": { "type": "boolean" }, "command": { "type": "string", "minLength": 1 } } },
      "retrieval": { "type": "object", "properties": { "maxRequestsPerTurn": { "type": "integer", "minimum": 1 }, "maxTokensPerRequest": { "type": "integer", "minimum": 1 }, "maxTotalTokensPerTurn": { "type": "integer", "minimum": 1 } } },
      "outputPolicy": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "modes": { "type": "object", "additionalProperties": { "enum": ["terse", "compact", "normal"] } } } }
    } },
    "evidence": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "outputDir": { "type": "string" }, "requireComplete": { "type": "boolean" } } },
    "organization": { "type": "object", "properties": { "policyBundles": { "type": "object", "properties": { "cacheDir": { "type": "string" }, "required": { "type": "boolean" }, "sources": { "type": "array", "items": { "$ref": "#/$defs/policyBundleSource" } } } } } },
    "distributed": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "provider": { "type": "string" }, "queueDir": { "type": "string" }, "endpoint": { "type": "string", "format": "uri" }, "tokenEnv": { "type": "string" }, "pollIntervalMs": { "type": "integer", "minimum": 1 }, "leaseSeconds": { "type": "integer", "minimum": 1 }, "workerId": { "type": "string" } } },
    "sdd": { "type": "object", "properties": { "specsDir": { "type": "string" }, "contractsDir": { "type": "string" }, "reportsDir": { "type": "string" }, "repairsDir": { "type": "string" }, "runsDir": { "type": "string" }, "authoring": { "type": "object", "properties": { "provider": { "type": "string", "minLength": 1 }, "schema": { "type": "string", "minLength": 1 }, "managerAgent": { "type": "string", "minLength": 1 } } } } },
    "validation": { "type": "object", "properties": { "baseRef": { "type": "string" }, "commands": { "type": "array" }, "validators": { "type": "array" }, "providers": { "type": "array", "items": { "type": "object", "required": ["id", "capability", "provider"], "properties": { "id": { "type": "string", "minLength": 1 }, "capability": { "type": "string", "minLength": 1 }, "provider": { "type": "string", "minLength": 1 }, "command": { "type": "string" }, "required": { "type": "boolean" }, "timeoutSeconds": { "type": "integer", "minimum": 1 }, "workingDirectory": { "type": "string" }, "options": { "type": "object" } } } }, "testAttribution": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 300 }, "minItems": 1, "maxItems": 64 } }, "frozenPaths": { "type": "array" }, "requireSeal": { "type": "boolean" } } },
    "security": { "type": "object", "properties": { "sandbox": { "type": "object", "properties": { "provider": { "type": "string" }, "required": { "type": "boolean" }, "image": { "type": "string" }, "imageDigest": { "type": "string" }, "network": { "type": "boolean" }, "extraArgs": { "type": "array", "items": { "type": "string" } }, "readOnlyRoot": { "type": "boolean" }, "ephemeralHome": { "type": "boolean" }, "noNewPrivileges": { "type": "boolean" }, "capDropAll": { "type": "boolean" }, "pidsLimit": { "type": "integer", "minimum": 1 }, "memory": { "type": "string" }, "cpus": { "type": "number", "exclusiveMinimum": 0 }, "tmpfs": { "type": "array", "items": { "type": "string" } }, "forceForRisks": { "type": "array", "items": { "enum": ["low", "medium", "high"] } }, "environmentAllowlist": { "type": "array", "items": { "type": "string" } }, "credentialEnvAllowlist": { "type": "array", "items": { "type": "string" } } } }, "isolation": { "type": "object", "properties": { "required": { "type": "boolean" }, "provider": { "type": "string" }, "network": { "type": "boolean" }, "environmentAllowlist": { "type": "array", "items": { "type": "string" } } } }, "tools": { "type": "array", "items": { "type": "string" } } } },
    "telemetry": { "type": "object" },
    "evals": { "type": "object", "properties": { "corpusDir": { "type": "string" }, "resultsDir": { "type": "string" }, "workspacesDir": { "type": "string" }, "defaultRuns": { "type": "integer", "minimum": 1 }, "confidenceLevel": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 } } },
    "certification": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "policyPath": { "type": "string" }, "provider": { "type": "string" }, "fixtureRoot": { "type": "string" }, "requireSandbox": { "type": "boolean" }, "maxAttempts": { "type": "integer", "minimum": 0 }, "maxDurationMs": { "type": "integer", "minimum": 1 }, "maxCostUsd": { "type": "number", "minimum": 0 }, "maxTotalTokens": { "type": "integer", "minimum": 0 } } },
    "provenance": { "type": "object", "additionalProperties": false, "properties": { "outputDir": { "type": "string", "pattern": "^(?![\\\\/])(?![A-Za-z]:)(?!.*(?:^|[\\\\/])(?:\\.{1,2})(?:[\\\\/]|$))(?!.*[\\\\/]{2})(?!.*[\\\\/]$).+$" }, "artifact": { "type": "string", "minLength": 1, "pattern": "^(?![\\\\/])(?![A-Za-z]:)(?!.*(?:^|[\\\\/])(?:\\.{1,2})(?:[\\\\/]|$))(?!.*[\\\\/]{2})(?!.*[\\\\/]$).+$" }, "buildType": { "type": "string" }, "required": { "type": "boolean" }, "sbom": { "type": "object", "additionalProperties": false, "properties": { "required": { "type": "boolean" }, "command": { "type": "string", "minLength": 1 } } }, "signing": { "type": "object", "additionalProperties": false, "properties": { "required": { "type": "boolean" }, "key": { "type": "string" } } }, "verification": { "type": "object", "additionalProperties": false, "properties": { "required": { "type": "boolean" }, "publicKey": { "type": "string" } } } }, "allOf": [{ "if": { "anyOf": [{ "properties": { "required": { "const": true } }, "required": ["required"] }, { "properties": { "sbom": { "properties": { "required": { "const": true } }, "required": ["required"] } }, "required": ["sbom"] }, { "properties": { "signing": { "properties": { "required": { "const": true } }, "required": ["required"] } }, "required": ["signing"] }, { "properties": { "verification": { "properties": { "required": { "const": true } }, "required": ["required"] } }, "required": ["verification"] }] }, "then": { "required": ["artifact"] } }, { "if": { "anyOf": [{ "properties": { "signing": { "properties": { "required": { "const": true } }, "required": ["required"] } }, "required": ["signing"] }, { "properties": { "verification": { "properties": { "required": { "const": true } }, "required": ["required"] } }, "required": ["verification"] }] }, "then": { "required": ["signing", "verification"], "properties": { "signing": { "required": ["key"] }, "verification": { "required": ["publicKey"] } } } }] }
  },
  "$defs": {
    "severityNumbers": { "type": "object", "properties": { "critical": { "type": "integer", "minimum": 0 }, "high": { "type": "integer", "minimum": 0 }, "medium": { "type": "integer", "minimum": 0 }, "low": { "type": "integer", "minimum": 0 }, "note": { "type": "integer", "minimum": 0 } } },
    "contextBudget": { "type": "object", "properties": { "inputTokens": { "type": "integer", "minimum": 1 }, "maxTokens": { "type": "integer", "minimum": 1 }, "reserved": { "type": "object", "properties": { "instructions": { "type": "integer", "minimum": 0 }, "normative": { "type": "integer", "minimum": 0 }, "evidence": { "type": "integer", "minimum": 0 }, "response": { "type": "integer", "minimum": 0 } } } } },
    "executionLiveness": { "type": "object", "additionalProperties": false, "properties": { "hardDeadlineMs": { "type": "integer", "minimum": 1 }, "progressLeaseMs": { "type": "integer", "minimum": 1 }, "stallWindowMs": { "type": "integer", "minimum": 1 }, "providerTurnDeadlineMs": { "type": "integer", "minimum": 1 }, "participantTurnDeadlineMs": { "type": "integer", "minimum": 1 }, "reviewerTurnDeadlineMs": { "type": "integer", "minimum": 1 }, "permissionWaitTimeoutMs": { "type": "integer", "minimum": 1 }, "defaultToolDeadlineMs": { "type": "integer", "minimum": 1 }, "maxNoProgressRenewals": { "type": "integer", "minimum": 0 }, "maxParticipantRestarts": { "type": "integer", "minimum": 0 }, "maxLocalRetriesPerFailure": { "type": "integer", "minimum": 0 }, "softBudgetThreshold": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 }, "toolDeadlinesMs": { "type": "object", "propertyNames": { "minLength": 1 }, "additionalProperties": { "type": "integer", "minimum": 1 } } } },
    "economicEnvelope": { "type": "object", "additionalProperties": false, "properties": { "initialProviderTurns": { "type": "integer", "minimum": 0 }, "supervisorProviderTurns": { "type": "integer", "minimum": 0 }, "hardProviderTurns": { "type": "integer", "minimum": 0 }, "maxLocalRetries": { "type": "integer", "minimum": 0 }, "maxParticipantRestarts": { "type": "integer", "minimum": 0 }, "softThreshold": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 }, "hardToolCalls": { "type": "integer", "minimum": 0 }, "hardTotalTokens": { "type": "integer", "minimum": 0 }, "hardCostUsd": { "type": "number", "minimum": 0 } } },
    "policyBundleSource": { "type": "object", "required": ["name"], "properties": { "name": { "type": "string", "minLength": 1 }, "path": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "required": { "type": "boolean" }, "publicKey": { "type": "string" }, "signature": { "type": "string" } } }
  },
  "additionalProperties": false
}
