{
  "schema_version": "changelog-v1",
  "updated_at": "2026-08-18T00:00:00Z",
  "entries": [
    {
      "date": "2026-08-18",
      "release": "property-profile-v2",
      "status": "current",
      "summary": "Global canonical property profile for public integrations.",
      "changes": [
        {"type": "added", "surface": "property-profile-v2", "breaking": true, "detail": "Canonical identity, grouped marketplace listings, historical facts, area context, and provenance now share one global profile."},
        {"type": "added", "surface": "property-profile-field-catalog-v2", "breaking": false, "detail": "Machine-readable field semantics for the global property profile."},
        {"type": "changed", "surface": "public documentation", "breaking": true, "detail": "Examples, OpenAPI responses, reference clients, and agent acceptance now require property-profile-v2."}
      ]
    },
    {
      "date": "2026-08-04",
      "release": "contracts-2026-08-04",
      "status": "current",
      "summary": "Enterprise contract and agent-discovery package.",
      "changes": [
        {"type": "added", "surface": "field catalog", "breaking": false, "detail": "Machine-readable field semantics, units, omission policy, identity, and provenance."},
        {"type": "added", "surface": "Arazzo", "breaking": false, "detail": "Deterministic bounded-search and property-history workflows."},
        {"type": "added", "surface": "AsyncAPI", "breaking": false, "detail": "Signed property-event and test-event webhook contract."},
        {"type": "added", "surface": "MCP", "breaking": false, "detail": "Tool output schemas, conservative behavior annotations, and contract resources."},
        {"type": "clarified", "surface": "MCP search", "breaking": false, "detail": "Search is non-destructive and idempotent but not read-only because it commits a Unit receipt."}
      ]
    },
    {
      "date": "2026-08-04",
      "release": "machine-access-v1",
      "status": "current",
      "summary": "Release-gated workspace API keys and MCP property tools.",
      "changes": [
        {"type": "added", "surface": "API keys", "breaking": false, "detail": "Workspace-scoped, revocable properties:read credentials."},
        {"type": "added", "surface": "Unit receipts", "breaking": false, "detail": "Atomic metering, max_units ceilings, and durable idempotent replay."},
        {"type": "added", "surface": "MCP", "breaking": false, "detail": "Five bounded property tools over Streamable HTTP."}
      ]
    }
  ]
}
