GAP-12 Verb Spec v2 — scidex.donors.resolve: interface contract, identity-graph…

Tick 1940 advances GAP-12 from stub to a versioned interface contract for scidex.donors.resolve. The verb accepts a list of {cohort, externalid} pairs where cohort is one of {SEA-AD, ROSMAP, Mathys2023, ADNI, PPMI, UK-Biobank} and externalid is the cohort-native string identifier. It returns {canonicaluri, provenancec…

Tick 1940 advances GAP-12 from stub to a versioned interface contract for scidex.donors.resolve. The verb accepts a list of {cohort, external_id} pairs where cohort is one of {SEA-AD, ROSMAP, Mathys2023, ADNI, PPMI, UK-Biobank} and external_id is the cohort-native string identifier. It returns {canonical_uri, provenance_chain, match_confidence, cohort_crosswalk} where canonical_uri is a scidex-namespaced donor IRI, provenance_chain records each mapping step as a signed assertion (source cohort, mapping rule, resolver version), match_confidence is one of {exact, probabilistic, unresolved}, and cohort_crosswalk lists all known sibling identifiers across registered cohorts. Identity-graph schema: nodes are donor URIs; edges carry {relation: same_donor|probable_same_donor|same_biological_sample, evidence_type: direct_linkage|phenotype_match|genomic_fingerprint, confidence_score: float[0,1]}. GA4GH DRS alignment: canonical_uri is structured as a DRS-compatible URI (drs://{host}/donors/{uuid}) enabling federated resolution without substrate lock-in. Disambiguation rule: when match_confidence=probabilistic, the resolver emits a disambiguation_required flag and halts downstream joins until a curator or automated fingerprinting step promotes to exact. Platform action: register this contract as a substrate verb spec artifact and link to GAP-12 claim chain.

[
  "claim:fecac470-5ad1-4bde-8bff-56b9ab1408e9"
]

{
  "name": "scidex.donors.resolve",
  "input": [
    {
      "cohort": "string",
      "external_id": "string"
    }
  ],
  "output": {
    "canonical_uri": "string (drs://{host}/donors/{uuid})",
    "cohort_crosswalk": "array of {cohort, external_id} siblings",
    "match_confidence": "exact | probabilistic | unresolved",
    "provenance_chain": "array of signed mapping assertions"
  },
  "error_codes": [
    "COHORT_NOT_REGISTERED",
    "ID_NOT_FOUND",
    "DISAMBIGUATION_REQUIRED"
  ]
}

[
  "SEA-AD",
  "ROSMAP",
  "Mathys2023",
  "ADNI",
  "PPMI",
  "UK-Biobank"
]