Workspai Project Agent Entry

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://workspai.dev/schemas/workspace-intelligence/project-agent-entry.v1.json",
  "title": "Workspai Project Agent Entry",
  "description": "Portable host-discovery and canonical-first entry contract for an adopted or managed project.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schemaVersion",
    "generatedAt",
    "project",
    "workspace",
    "canonical",
    "protocol",
    "hosts",
    "integrity"
  ],
  "properties": {
    "schemaVersion": {
      "const": "workspai.agent-entry.v1"
    },
    "generatedAt": {
      "type": "string",
      "format": "date-time"
    },
    "project": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "relativePath"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1
        },
        "relativePath": {
          "$ref": "#/$defs/portablePath"
        },
        "runtime": {
          "type": "string",
          "minLength": 1
        },
        "framework": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    "workspace": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "relationship",
        "localBinding",
        "identityIsFilesystemPath",
        "resolverCommand",
        "portableUriScheme",
        "resolvedPathPolicy"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1
        },
        "relationship": {
          "enum": [
            "managed",
            "adopted",
            "imported",
            "linked",
            "restored"
          ]
        },
        "localBinding": {
          "const": ".workspai/workspace-link.local.json"
        },
        "identityIsFilesystemPath": {
          "const": false
        },
        "resolverCommand": {
          "const": "workspai project workspace status --json"
        },
        "portableUriScheme": {
          "const": "workspace:"
        },
        "resolvedPathPolicy": {
          "const": "runtime-private-never-persist"
        }
      }
    },
    "canonical": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "projectContext",
        "projectGrounding",
        "goalIndex",
        "workspaceIndex",
        "workspaceContext"
      ],
      "properties": {
        "projectContext": {
          "const": ".workspai/reports/project-context-agent.json"
        },
        "projectGrounding": {
          "const": ".workspai/PROJECT-GROUNDING.md"
        },
        "goalIndex": {
          "const": "workspace:.workspai/goals/index.json"
        },
        "workspaceIndex": {
          "const": "workspace:.workspai/reports/INDEX.json"
        },
        "workspaceContext": {
          "const": "workspace:.workspai/reports/workspace-context-agent.json"
        },
        "workspaceModel": {
          "const": "workspace:.workspai/reports/workspace-model.json"
        },
        "knowledgeGraph": {
          "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
        },
        "workspaceSkillsIndex": {
          "const": "workspace:.workspai/reports/workspace-skills-index.json"
        },
        "boundedGraphSearch": {
          "const": "command:workspai workspace graph search <task-query> --scope project:<project> --limit 12 --json"
        }
      },
      "anyOf": [
        {
          "properties": {
            "workspaceModel": {
              "const": "workspace:.workspai/reports/workspace-model.json"
            },
            "knowledgeGraph": {
              "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
            }
          },
          "required": [
            "workspaceModel",
            "knowledgeGraph"
          ]
        },
        {
          "properties": {
            "workspaceSkillsIndex": {
              "const": "workspace:.workspai/reports/workspace-skills-index.json"
            },
            "boundedGraphSearch": {
              "const": "command:workspai workspace graph search <task-query> --scope project:<project> --limit 12 --json"
            }
          },
          "required": [
            "workspaceSkillsIndex",
            "boundedGraphSearch"
          ]
        }
      ]
    },
    "protocol": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "mode",
        "bootstrapCommand",
        "verifyCommand",
        "requiredReadOrder",
        "sourcePolicy",
        "degradedMode"
      ],
      "properties": {
        "mode": {
          "const": "canonical-first"
        },
        "bootstrapCommand": {
          "type": "string",
          "minLength": 1
        },
        "verifyCommand": {
          "type": "string",
          "minLength": 1
        },
        "requiredReadOrder": {
          "type": "array",
          "minItems": 6,
          "maxItems": 16,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "sourcePolicy": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "liveSourceAuthority",
            "workspaceEvidenceAuthority",
            "broadScanBeforeBootstrap",
            "sourceMutation",
            "verificationClaims"
          ],
          "properties": {
            "liveSourceAuthority": {
              "const": "exact-implementation"
            },
            "workspaceEvidenceAuthority": {
              "const": "identity-topology-readiness-goals"
            },
            "broadScanBeforeBootstrap": {
              "const": false
            },
            "sourceMutation": {
              "const": "governed-only"
            },
            "verificationClaims": {
              "const": "cli-evidence-only"
            }
          }
        },
        "degradedMode": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "discloseMissingEvidence",
            "allowCompleteArchitectureClaims",
            "allowReadOnlySourceInspection"
          ],
          "properties": {
            "discloseMissingEvidence": {
              "const": true
            },
            "allowCompleteArchitectureClaims": {
              "const": false
            },
            "allowReadOnlySourceInspection": {
              "const": true
            }
          }
        }
      }
    },
    "hosts": {
      "type": "array",
      "minItems": 11,
      "maxItems": 11,
      "items": {
        "$ref": "#/$defs/host"
      }
    },
    "integrity": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "algorithm",
        "projectContextHash",
        "payloadHash",
        "portable",
        "absolutePathsEmitted"
      ],
      "properties": {
        "algorithm": {
          "const": "sha256"
        },
        "projectContextHash": {
          "$ref": "#/$defs/hash"
        },
        "payloadHash": {
          "$ref": "#/$defs/hash"
        },
        "portable": {
          "const": true
        },
        "absolutePathsEmitted": {
          "const": false
        }
      }
    }
  },
  "$defs": {
    "hash": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "portablePath": {
      "type": "string",
      "minLength": 1,
      "not": {
        "pattern": "^(?:/|[A-Za-z]:[\\\\/])"
      }
    },
    "host": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "discovery",
        "entryFiles",
        "status",
        "managed"
      ],
      "properties": {
        "id": {
          "enum": [
            "generic",
            "codex",
            "claude",
            "gemini",
            "qwen",
            "kimi",
            "grok",
            "copilot",
            "cursor",
            "windsurf",
            "amazon-q"
          ]
        },
        "discovery": {
          "enum": [
            "native",
            "adapter",
            "portable-fallback"
          ]
        },
        "entryFiles": {
          "type": "array",
          "minItems": 1,
          "maxItems": 3,
          "uniqueItems": true,
          "items": {
            "$ref": "#/$defs/portablePath"
          }
        },
        "status": {
          "enum": [
            "ready",
            "degraded",
            "blocked"
          ]
        },
        "managed": {
          "type": "boolean"
        },
        "reason": {
          "type": "string",
          "minLength": 1
        }
      }
    }
  }
}