{
  "schema_version": "1.0",
  "content_version": "1.2.0",
  "last_modified": "2026-09-24",
  "canonical_url": "https://axiomcx.dev/data/report-contract.json",
  "human_readable_url": "https://axiomcx.dev/knowledge/report-contract.md",
  "scope": "public_retrieval_and_citation",
  "schemaVersion": "1.0",
  "title": "Axiom Cortex public report contract",
  "canonicalUrl": "https://axiomcx.dev/knowledge/report-contract.md",
  "description": "Public field and state descriptions for a traceable, human-reviewed interview evidence report.",
  "reportFields": [
    "reportId",
    "createdAt",
    "productVersion",
    "methodVersion",
    "roleId",
    "interviewId",
    "inputStatus",
    "roleCriteriaSummary",
    "questionCoverageSummary",
    "criterionFindings",
    "workReasoningSummary",
    "evidenceGaps",
    "explicitContradictions",
    "humanReviewStatus",
    "responsibleUseNotice"
  ],
  "criterionFindingFields": [
    "criterionId",
    "criterionDescription",
    "questionId",
    "opportunityState",
    "supportState",
    "sourceReference",
    "ownershipState",
    "missingEvidenceNote",
    "contradictionNote",
    "reviewerAction",
    "reviewStatus"
  ],
  "reviewStates": [
    {
      "id": "pending_review",
      "meaning": "No qualified reviewer has completed the review."
    },
    {
      "id": "reviewed",
      "meaning": "A qualified reviewer has inspected the report and source evidence."
    },
    {
      "id": "returned_for_correction",
      "meaning": "The reviewer identified a configuration, source, attribution, or interpretation problem."
    },
    {
      "id": "more_evidence_requested",
      "meaning": "The supplied interview does not establish one or more material criteria."
    },
    {
      "id": "excluded_from_decision",
      "meaning": "The reviewer determined that a finding or source should not be used."
    }
  ],
  "provenanceRequirements": [
    "Identify the supplied inputs.",
    "Identify the product and method version.",
    "Connect each material finding to a criterion and source reference.",
    "Preserve uncertainty when source quality or attribution is incomplete.",
    "Record the human review state."
  ],
  "publicBoundary": "This contract does not publish the proprietary numeric method or private implementation details.",
  "optionalReportFields": {
    "alignmentScore": "Role-specific alignment score when the configured evaluation requirements are met. Interpret it alongside source evidence, coverage, gaps, and human review. The public contract does not define a numeric scale or calculation.",
    "interviewIntegrityFlags": "Source-linked irregularities requiring contextual human review where the source supports analysis; not a finding of AI use or an automatic candidate penalty."
  }
}
