Workspai Agent Bootstrap Receipt

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://workspai.dev/schemas/workspace-intelligence/agent-bootstrap-receipt.v1.json",
  "title": "Workspai Agent Bootstrap Receipt",
  "description": "Portable per-session proof that an agent resolved canonical project evidence before broad source discovery.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schemaVersion",
    "generatedAt",
    "receiptId",
    "status",
    "requestedAgent",
    "resolvedHost",
    "project",
    "workspace",
    "entry",
    "canonicalEvidence",
    "activeGoal",
    "requiredReadOrder",
    "claims",
    "checks",
    "nextActions",
    "integrity"
  ],
  "properties": {
    "schemaVersion": {
      "const": "workspai.agent-bootstrap-receipt.v1"
    },
    "generatedAt": {
      "type": "string",
      "format": "date-time"
    },
    "receiptId": {
      "$ref": "#/$defs/hash"
    },
    "status": {
      "$ref": "#/$defs/status"
    },
    "requestedAgent": {
      "enum": [
        "generic",
        "codex",
        "claude",
        "gemini",
        "qwen",
        "kimi",
        "grok",
        "copilot",
        "cursor",
        "windsurf",
        "amazon-q",
        "all"
      ]
    },
    "resolvedHost": {
      "enum": [
        "generic",
        "codex",
        "claude",
        "gemini",
        "qwen",
        "kimi",
        "grok",
        "copilot",
        "cursor",
        "windsurf",
        "amazon-q",
        "all"
      ]
    },
    "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",
        "resolved",
        "identityIsFilesystemPath",
        "resolverCommand",
        "portableUriScheme",
        "resolvedPathPolicy"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1
        },
        "relationship": {
          "enum": [
            "managed",
            "adopted",
            "imported",
            "linked",
            "restored"
          ]
        },
        "resolved": {
          "const": true
        },
        "identityIsFilesystemPath": {
          "const": false
        },
        "resolverCommand": {
          "const": "workspai project workspace status --json"
        },
        "portableUriScheme": {
          "const": "workspace:"
        },
        "resolvedPathPolicy": {
          "const": "runtime-private-never-persist"
        }
      }
    },
    "entry": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "artifact",
        "schemaVersion",
        "hostStatus",
        "entryFiles"
      ],
      "properties": {
        "artifact": {
          "const": ".workspai/agent-entry.v1.json"
        },
        "schemaVersion": {
          "const": "workspai.agent-entry.v1"
        },
        "hostStatus": {
          "$ref": "#/$defs/status"
        },
        "entryFiles": {
          "type": "array",
          "minItems": 1,
          "maxItems": 16,
          "uniqueItems": true,
          "items": {
            "$ref": "#/$defs/portablePath"
          }
        }
      }
    },
    "canonicalEvidence": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "projectContext",
        "workspaceIndex",
        "workspaceContext",
        "modelFreshness",
        "graphFreshness",
        "graphMatchesModel",
        "liveInputsValidated",
        "blockerCount"
      ],
      "properties": {
        "projectContext": {
          "const": ".workspai/reports/project-context-agent.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"
        },
        "modelFreshness": {
          "enum": [
            "fresh",
            "stale",
            "unknown",
            "missing"
          ]
        },
        "graphFreshness": {
          "enum": [
            "fresh",
            "stale",
            "unknown",
            "missing"
          ]
        },
        "graphMatchesModel": {
          "type": "boolean"
        },
        "liveInputsValidated": {
          "type": "boolean"
        },
        "blockerCount": {
          "type": "integer",
          "minimum": 0
        }
      },
      "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"
          ]
        }
      ]
    },
    "activeGoal": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "present",
        "appliesToProject",
        "status"
      ],
      "properties": {
        "present": {
          "type": "boolean"
        },
        "appliesToProject": {
          "type": "boolean"
        },
        "status": {
          "enum": [
            "none",
            "ready",
            "stale",
            "invalid"
          ]
        },
        "id": {
          "type": "string",
          "minLength": 1
        },
        "objective": {
          "type": "string",
          "minLength": 1
        },
        "lifecycle": {
          "type": "string",
          "minLength": 1
        },
        "goalPack": {
          "$ref": "#/$defs/workspaceArtifact"
        },
        "agentHandoff": {
          "$ref": "#/$defs/workspaceArtifact"
        }
      },
      "allOf": [
        {
          "if": {
            "properties": {
              "status": {
                "const": "none"
              }
            }
          },
          "then": {
            "properties": {
              "present": {
                "const": false
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "status": {
                "enum": [
                  "ready",
                  "stale",
                  "invalid"
                ]
              }
            }
          },
          "then": {
            "properties": {
              "present": {
                "const": true
              }
            }
          }
        }
      ]
    },
    "requiredReadOrder": {
      "type": "array",
      "minItems": 6,
      "maxItems": 16,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "claims": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "architecture",
        "sourceInspection",
        "sourceMutation",
        "verification"
      ],
      "properties": {
        "architecture": {
          "enum": [
            "allowed-with-citations",
            "prohibited"
          ]
        },
        "sourceInspection": {
          "const": "bounded-and-targeted"
        },
        "sourceMutation": {
          "const": "governed-cli-transaction-only"
        },
        "verification": {
          "const": "cli-evidence-only"
        }
      }
    },
    "checks": {
      "type": "array",
      "minItems": 6,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "status",
          "message"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "enum": [
              "passed",
              "warning",
              "failed"
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1
          },
          "artifact": {
            "$ref": "#/$defs/portablePath"
          }
        }
      }
    },
    "nextActions": {
      "type": "array",
      "minItems": 1,
      "maxItems": 8,
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "integrity": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "algorithm",
        "manifestHash",
        "projectContextHash",
        "payloadHash",
        "portable",
        "absolutePathsEmitted"
      ],
      "properties": {
        "algorithm": {
          "const": "sha256"
        },
        "manifestHash": {
          "$ref": "#/$defs/hash"
        },
        "projectContextHash": {
          "$ref": "#/$defs/hash"
        },
        "payloadHash": {
          "$ref": "#/$defs/hash"
        },
        "portable": {
          "const": true
        },
        "absolutePathsEmitted": {
          "const": false
        }
      }
    }
  },
  "$defs": {
    "hash": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "status": {
      "enum": [
        "ready",
        "degraded",
        "blocked"
      ]
    },
    "portablePath": {
      "type": "string",
      "minLength": 1,
      "not": {
        "pattern": "^(?:/|[A-Za-z]:[\\\\/])"
      }
    },
    "workspaceArtifact": {
      "type": "string",
      "pattern": "^workspace:\\.workspai/"
    }
  }
}