when running squad doctor i see this message | casting/registry.json exists — registry/history pair is invalid: Cannot read a consistent casting registry/history pair: registry revision is invalid"

[mikeywashere]

my registry.json has this content

{
"agents": {}
}

[ZYZ666-RGB]

That error is expected for the stub you posted. squad doctor is trying to read a consistent registry.json / history.json pair. In validatePairRoots (packages/squad-sdk/src/casting/durable-registry.ts), once both files are present, registry.revision must be a safe integer ≥ 1. A file that is only {"agents": {}} has no revision, which is exactly:

Cannot read a consistent casting registry/history pair: registry revision is invalid

An empty registry is allowed, but it still needs the current provenance shape, for example:

{
  "schema": "squad-agent-provenance/v1",
  "schema_version": 1,
  "revision": 1,
  "generated_at": "<ISO-8601 timestamp>",
  "agents": {}
}

plus a matching empty history.json:

{
  "assignment_cast_snapshots": {},
  "universe_usage_history": []
}

If you only add revision and leave the rest incomplete, the next checks are history shape is invalid or registry shape is invalid. I'd use the official initialization or upgrade flow so both files are written together, rather than hand-editing a stub or changing only one of the pair.