{
  "version": "2026.05.02",
  "canonicalSource": true,
  "lastUpdated": "2026-05-02T20:00:00Z",

  "service": "ScorePivot Platform",
  "title": "ScorePivot Master Schema Registry",
  "description": "Unified registry of all ScorePivot schemas, types, structural definitions, and validation surfaces. This file acts as the authoritative schema index for AI agents, ingestion engines, and autonomous crawlers.",

  "schemas": {
    "core": [
      {
        "id": "credit-report",
        "title": "Credit Report Schema",
        "path": "/schema/credit-report.json",
        "description": "Defines the structure of a synthetic credit report, including accounts, inquiries, negative items, and score snapshots."
      },
      {
        "id": "identity",
        "title": "Identity Schema",
        "path": "/schema/identity.json",
        "description": "Defines identity-related entities and attributes for future identity summarization workflows."
      },
      {
        "id": "dispute",
        "title": "Dispute Schema",
        "path": "/schema/dispute.json",
        "description": "Defines dispute entities, events, lifecycle states, and relationships."
      }
    ],

    "howTo": [
      {
        "id": "howto-import-credit-report",
        "title": "HowTo: Import Credit Report",
        "path": "/schema/howto-import-credit-report.json",
        "description": "Instructions for invoking ImportCreditReport with valid input."
      },
      {
        "id": "howto-analyze-credit-report",
        "title": "HowTo: Analyze Credit Report",
        "path": "/schema/howto-analyze-credit-report.json",
        "description": "Instructions for invoking AnalyzeCreditReport."
      },
      {
        "id": "howto-detect-negative-items",
        "title": "HowTo: Detect Negative Items",
        "path": "/schema/howto-detect-negative-items.json",
        "description": "Instructions for invoking DetectNegativeItems."
      },
      {
        "id": "howto-generate-dispute-letter-draft",
        "title": "HowTo: Generate Dispute Letter Draft",
        "path": "/schema/howto-generate-dispute-letter-draft.json",
        "description": "Instructions for invoking GenerateDisputeLetterDraft."
      },
      {
        "id": "howto-summarize-dispute-status",
        "title": "HowTo: Summarize Dispute Status",
        "path": "/schema/howto-summarize-dispute-status.json",
        "description": "Instructions for invoking SummarizeDisputeStatus."
      }
    ],

    "supporting": [
      {
        "id": "analysis-summary",
        "title": "Analysis Summary Schema",
        "path": "/schema/analysis-summary.json",
        "description": "Defines the structure of the analysisSummary object returned by AnalyzeCreditReport."
      },
      {
        "id": "negative-items",
        "title": "Negative Item List Schema",
        "path": "/schema/negative-items.json",
        "description": "Defines the structure of the negativeItemList returned by DetectNegativeItems."
      },
      {
        "id": "dispute-draft",
        "title": "Dispute Draft Schema",
        "path": "/schema/dispute-draft.json",
        "description": "Defines the structure of the draftDocument returned by GenerateDisputeLetterDraft."
      },
      {
        "id": "dispute-summary",
        "title": "Dispute Summary Schema",
        "path": "/schema/dispute-summary.json",
        "description": "Defines the structure of the disputeSummary returned by SummarizeDisputeStatus."
      }
    ]
  },

  "validationRules": {
    "source": "/.well-known/ai-rules.json",
    "description": "Central rule set for schema validation, required fields, type enforcement, and structural constraints."
  },

  "ontology": {
    "source": "/.well-known/ontology.json",
    "description": "Defines entities, relationships, and semantic constraints used across all schemas."
  },

  "usage": {
    "agents": [
      "Validation Engine",
      "Inference Engine",
      "Timeline Engine",
      "State Machines"
    ],
    "workflows": [
      "CreditReportProcessing",
      "IdentityProfileSummarization (planned)",
      "ScoreTrendAnalysisV2 (planned)"
    ],
    "tools": [
      "ImportCreditReport",
      "AnalyzeCreditReport",
      "DetectNegativeItems",
      "GenerateDisputeLetterDraft",
      "SummarizeDisputeStatus"
    ]
  },

  "notes": [
    "This registry is the authoritative schema index for all ScorePivot agentic systems.",
    "All schemas are deterministic and machine-readable.",
    "All capabilities are software-only and simulated.",
    "Optimized for Gemini, Perplexity, Claude, ChatGPT, SearchGPT, and Andi ingestion."
  ]
}