{
  "fixtureVersion": 1,
  "currentSchemaVersion": 2,
  "previousProductionVersion": 1,
  "migrationFixture": null,
  "firstProductionFormat": false,
  "rationale": "V2 supports explicit result viewers while preserving V1 bytes. Future V3 retains the original recovery precedence; no implicit V1 migration.",
  "cases": [
    {
      "id": "unsupported-version",
      "source": "{\"schemaVersion\":3,\"flowKey\":\"future_flow\",\"label\":\"Future Flow\",\"description\":\"\",\"inputs\":[],\"results\":[],\"nodes\":[],\"groups\":[],\"externalSubflows\":[],\"presentation\":{\"nodes\":{}},\"dependencies\":[],\"authoring\":{\"mode\":\"pxflowNative\"}}",
      "diagnostic": {
        "code": "PX_SCHEMA_UNSUPPORTED_VERSION",
        "path": "/schemaVersion",
        "severity": "error",
        "retryable": false,
        "params": {
          "actualVersion": "3",
          "supportedVersion": "2"
        },
        "suggestedAction": "OPEN_READ_ONLY"
      },
      "recovery": {
        "mode": "readOnly",
        "preserveSourceBytes": true,
        "materialize": false,
        "execute": false,
        "write": false
      }
    },
    {
      "id": "unknown-major",
      "source": "{\"schemaVersion\":99,\"flowKey\":\"unknown_major\",\"label\":\"Unknown major\",\"description\":\"\",\"inputs\":[],\"results\":[],\"nodes\":[],\"groups\":[],\"externalSubflows\":[],\"presentation\":{\"nodes\":{}},\"dependencies\":[],\"authoring\":{\"mode\":\"pxflowNative\"}}",
      "diagnostic": {
        "code": "PX_SCHEMA_UNSUPPORTED_VERSION",
        "path": "/schemaVersion",
        "severity": "error",
        "retryable": false,
        "params": {
          "actualVersion": "99",
          "supportedVersion": "2"
        },
        "suggestedAction": "OPEN_READ_ONLY"
      },
      "recovery": {
        "mode": "readOnly",
        "preserveSourceBytes": true,
        "materialize": false,
        "execute": false,
        "write": false
      }
    },
    {
      "id": "unsupported-version-and-malformed",
      "source": "{\"schemaVersion\":3,\"flowKey\":\"future_and_broken\",\"label\":\"Future and broken\",\"description\":\"\",\"inputs\":[],\"results\":[],\"nodes\":[{\"nodeKey\":\"python_node\",\"target\":{\"kind\":\"python\"},\"inputBindings\":{}}],\"groups\":[],\"externalSubflows\":[],\"presentation\":{\"nodes\":{}},\"dependencies\":[],\"authoring\":{\"mode\":\"pxflowNative\"}}",
      "diagnostic": {
        "code": "PX_SCHEMA_UNSUPPORTED_VERSION",
        "path": "/schemaVersion",
        "severity": "error",
        "retryable": false,
        "params": {
          "actualVersion": "3",
          "supportedVersion": "2"
        },
        "suggestedAction": "OPEN_READ_ONLY"
      },
      "recovery": {
        "mode": "readOnly",
        "preserveSourceBytes": true,
        "materialize": false,
        "execute": false,
        "write": false
      }
    },
    {
      "id": "unsupported-version-and-duplicate-key",
      "source": "{\"schemaVersion\":3,\"flowKey\":\"future_flow\",\"flowKey\":\"future_flow\",\"label\":\"Future and duplicated\",\"description\":\"\",\"inputs\":[],\"results\":[],\"nodes\":[],\"groups\":[],\"externalSubflows\":[],\"presentation\":{\"nodes\":{}},\"dependencies\":[],\"authoring\":{\"mode\":\"pxflowNative\"}}",
      "diagnostic": {
        "code": "PX_SCHEMA_UNSUPPORTED_VERSION",
        "path": "/schemaVersion",
        "severity": "error",
        "retryable": false,
        "params": {
          "actualVersion": "3",
          "supportedVersion": "2"
        },
        "suggestedAction": "OPEN_READ_ONLY"
      },
      "recovery": {
        "mode": "readOnly",
        "preserveSourceBytes": true,
        "materialize": false,
        "execute": false,
        "write": false
      }
    },
    {
      "id": "legacy-yaml",
      "source": "schemaVersion: 1\nflowKey: legacy_flow\nnodes: []\n",
      "diagnostic": {
        "code": "PX_DOCUMENT_LEGACY_FORMAT",
        "path": "",
        "severity": "error",
        "retryable": false,
        "params": {
          "detectedFormat": "yaml"
        },
        "suggestedAction": "OPEN_READ_ONLY"
      },
      "recovery": {
        "mode": "readOnly",
        "preserveSourceBytes": true,
        "materialize": false,
        "execute": false,
        "write": false
      }
    },
    {
      "id": "legacy-manifest",
      "source": "{\"schemaVersion\":1,\"manifest\":{\"nodes\":[]}}",
      "diagnostic": {
        "code": "PX_DOCUMENT_LEGACY_FORMAT",
        "path": "",
        "severity": "error",
        "retryable": false,
        "params": {
          "detectedFormat": "manifest"
        },
        "suggestedAction": "OPEN_READ_ONLY"
      },
      "recovery": {
        "mode": "readOnly",
        "preserveSourceBytes": true,
        "materialize": false,
        "execute": false,
        "write": false
      }
    }
  ]
}
