{
  "schemaVersion": "1.0",
  "reviewedAt": "2026-08-12",
  "status": "Frozen kit ready locally; no real-question coverage claimed",
  "outcomes": {
    "governed-answer": "A governed answer resolves the decision at its stated boundary",
    "clarification-required": "The question needs more identity, method, timing, denominator or decision context",
    "honest-no-match": "No current governed answer or named gap fits without forcing similarity",
    "named-evidence-gap": "The question resolves to an existing named evidence gap",
    "scope-refusal": "The request exceeds the library authority and receives a bounded refusal",
    "not-usable": "Consent, question meaning or the review record is insufficient"
  },
  "statusCompatibility": {
    "governed-answer": [
      "answered",
      "added-to-guide",
      "already-covered"
    ],
    "clarification-required": [
      "not-usable"
    ],
    "honest-no-match": [
      "not-usable"
    ],
    "named-evidence-gap": [
      "needs-evidence"
    ],
    "scope-refusal": [
      "out-of-scope"
    ],
    "not-usable": [
      "not-usable",
      "withdrawn"
    ]
  },
  "reviewSteps": [
    "Preserve the submitted question and context inside the private moderation boundary before assigning a theme.",
    "Check explicit scope refusal before textual matching so similar words cannot create false authority.",
    "Run the shared keeper-language navigator and record its first result or honest no-match.",
    "Review the complete governing guide, claim or gap rather than routing from a title alone.",
    "Assign one validation outcome using the fixed decision order and record every moderator override with a reason.",
    "Use only a compatible desk status; clarification and honest no-match do not become publishable confident answers.",
    "Publish only moderator-written de-identified wording with its governing path and retain adverse or unresolved outcomes in the audit.",
    "Rerun the fixed editorial benchmark after retrieval changes and inspect recurring failures at the protocol review point."
  ],
  "failureCodes": [
    "forced-similar-match",
    "improvised-confident-answer",
    "unrecorded-moderator-override",
    "raw-submission-published",
    "repetition-treated-as-biological-proof",
    "private-data-copied",
    "no-match-hidden",
    "missing-governing-path",
    "status-outcome-mismatch"
  ],
  "recordFields": [
    "question id",
    "submitted date",
    "source category",
    "topic",
    "raw question preserved privately",
    "scope boundary checked",
    "navigator first result",
    "navigator no-match",
    "moderated path",
    "moderator override reason",
    "validation outcome",
    "desk status",
    "answer boundary complete",
    "public answer path",
    "failure codes",
    "retrieval or guide change",
    "named gap change",
    "raw submission redacted",
    "reviewer"
  ],
  "calibrationCases": [
    {
      "id": "existing-tds-answer",
      "question": "Does matching TDS mean the seller water and my tank have the same minerals?",
      "context": "The decision is how to compare two measured waters before receiving Neocaridina.",
      "input": {
        "usableRecord": true,
        "scopeRefusal": false,
        "clarificationRequired": false,
        "namedGapPath": null,
        "governingAnswerPath": "/care/parameters",
        "answerBoundaryComplete": true
      },
      "expectedOutcome": "governed-answer",
      "expectedPath": "/care/parameters",
      "reason": "The parameters guide directly explains the conductivity-derived display and its composition limit, so no improvised answer or new gap is needed."
    },
    {
      "id": "clarify-identity-and-decision",
      "question": "What should I do with this shrimp?",
      "context": "No taxon, photograph, observation, measurement, timing or decision is supplied.",
      "input": {
        "usableRecord": true,
        "scopeRefusal": false,
        "clarificationRequired": true,
        "namedGapPath": null,
        "governingAnswerPath": null,
        "answerBoundaryComplete": false
      },
      "expectedOutcome": "clarification-required",
      "expectedPath": null,
      "reason": "Routing a generic animal question would manufacture meaning. The anonymous desk cannot request follow-up, so it remains private or closes as not usable."
    },
    {
      "id": "honest-unmapped-sound",
      "question": "Which exact vibration frequencies from a home aquarium pump change long-term Neocaridina reproduction?",
      "context": "The request is Neocaridina-specific and answerable in principle, but no current guide or named gap governs a frequency-specific chronic reproductive decision.",
      "input": {
        "usableRecord": true,
        "scopeRefusal": false,
        "clarificationRequired": false,
        "namedGapPath": null,
        "governingAnswerPath": null,
        "answerBoundaryComplete": false
      },
      "expectedOutcome": "honest-no-match",
      "expectedPath": null,
      "reason": "A behavior or filtration page may share words but does not answer the frequency-specific chronic question. Preserve the no-match for editorial gap review."
    },
    {
      "id": "named-transfer-gap",
      "question": "Which measured transfer rate improves survival after shipping when source and receiving water differ?",
      "context": "The question asks for a comparative receiving method and delayed animal outcome rather than the current bounded house protocol.",
      "input": {
        "usableRecord": true,
        "scopeRefusal": false,
        "clarificationRequired": false,
        "namedGapPath": "/research/gaps/transfer-rate",
        "governingAnswerPath": "/care/acclimation",
        "answerBoundaryComplete": false
      },
      "expectedOutcome": "named-evidence-gap",
      "expectedPath": "/research/gaps/transfer-rate",
      "reason": "The acclimation guide explains current practice and limits, while the named transfer-rate gap owns the unanswered comparative claim."
    },
    {
      "id": "other-taxon-refusal",
      "question": "How do I breed Amano shrimp larvae?",
      "context": "The animal is Caridina multidentata rather than Neocaridina.",
      "input": {
        "usableRecord": true,
        "scopeRefusal": true,
        "clarificationRequired": false,
        "namedGapPath": null,
        "governingAnswerPath": null,
        "answerBoundaryComplete": false
      },
      "expectedOutcome": "scope-refusal",
      "expectedPath": null,
      "reason": "Shared aquarium language cannot make a Neocaridina library authoritative for another genus and a different larval life history."
    },
    {
      "id": "prescription-refusal",
      "question": "Which antibiotic dose will cure the shrimp in this photograph?",
      "context": "The request asks for diagnosis and prescription from an image without confirmed identity or agent.",
      "input": {
        "usableRecord": true,
        "scopeRefusal": true,
        "clarificationRequired": false,
        "namedGapPath": null,
        "governingAnswerPath": "/care/health",
        "answerBoundaryComplete": false
      },
      "expectedOutcome": "scope-refusal",
      "expectedPath": "/care/health",
      "reason": "The health guide can support immediate system triage and observation, but the requested diagnosis and dose remain outside authority."
    },
    {
      "id": "unusable-private-data",
      "question": "Please contact the other person whose full private details I included and solve this.",
      "context": "The record violates the no-private-information confirmation and does not contain one reviewable keeper decision.",
      "input": {
        "usableRecord": false,
        "scopeRefusal": false,
        "clarificationRequired": false,
        "namedGapPath": null,
        "governingAnswerPath": null,
        "answerBoundaryComplete": false
      },
      "expectedOutcome": "not-usable",
      "expectedPath": null,
      "reason": "The private information must be removed and the record cannot become a public question or coverage success."
    },
    {
      "id": "existing-cycling-answer",
      "question": "Is my tank ready because it has been running for six weeks and nitrate is visible?",
      "context": "The keeper needs a commissioning decision and has not reported a known challenge.",
      "input": {
        "usableRecord": true,
        "scopeRefusal": false,
        "clarificationRequired": false,
        "namedGapPath": null,
        "governingAnswerPath": "/care/cycling",
        "answerBoundaryComplete": true
      },
      "expectedOutcome": "governed-answer",
      "expectedPath": "/care/cycling",
      "reason": "The cycling guide directly separates calendar age and nitrate presence from a recorded whole-system nitrogen-processing challenge."
    }
  ]
}
