{
  "schema": "okf-docs-manifest/1",
  "version": "dedafcd",
  "count": 133,
  "documents": [
    {
      "path": "docs/clickhouse-schema-review.md",
      "section": "(root)",
      "sectionLabel": "Start here",
      "type": "note",
      "title": "ClickHouse schema review — Foundry storage experiment",
      "description": "Reviewed: 2026-04-21 • Schemas: ClickHouseSchemas.cs",
      "status": "archived",
      "updated": "2026-06-20",
      "tags": [
        "clickhouse",
        "outcome-context"
      ]
    },
    {
      "path": "docs/intro.md",
      "section": "(root)",
      "sectionLabel": "Start here",
      "type": "concept",
      "title": "Introduction to the Sports Content and Data Management Platform",
      "description": "This document provides an overview of the Sports Content and Data Management Platform, designed to power real-time sports data feeds across multiple use cases...",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "overview"
      ]
    },
    {
      "path": "docs/security.md",
      "section": "(root)",
      "sectionLabel": "Start here",
      "type": "reference",
      "title": "Centralized Authorization System",
      "description": "This document describes the centralized role-based authorization system implemented for commands and queries in the LBS Foundry platform.",
      "status": "current",
      "updated": "2025-11-05",
      "tags": [
        "security",
        "auth"
      ]
    },
    {
      "path": "docs/getting-started/README.md",
      "section": "getting-started",
      "sectionLabel": "Getting started",
      "type": "index",
      "title": "Getting Started with LBS Foundry",
      "description": "Welcome to the LBS Foundry development team! This guide will get you up and running with the codebase in no time.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "getting-started"
      ]
    },
    {
      "path": "docs/getting-started/authentication-testing.md",
      "section": "getting-started",
      "sectionLabel": "Getting started",
      "type": "guide",
      "title": "Quick Start: Testing Authentication with the SDK",
      "description": "This guide will help you test the new JWT authentication system end-to-end using the Foundry SDK.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "getting-started"
      ]
    },
    {
      "path": "docs/getting-started/backend-local-setup.md",
      "section": "getting-started",
      "sectionLabel": "Getting started",
      "type": "guide",
      "title": "Backend Local Setup (Windows)",
      "description": "This guide walks you through setting up the LBS.Foundry backend locally on Windows. It assumes you have already completed the steps in prerequisites.md...",
      "status": "current",
      "updated": "2026-06-04",
      "tags": [
        "getting-started"
      ]
    },
    {
      "path": "docs/getting-started/prerequisites.md",
      "section": "getting-started",
      "sectionLabel": "Getting started",
      "type": "guide",
      "title": "Prerequisites & Environment Setup",
      "description": "This guide walks you through installing every tool you need before you can build and run LBS Foundry. Once everything here is installed, follow...",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "getting-started"
      ]
    },
    {
      "path": "docs/architecture/README.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "index",
      "title": "LBS Foundry Architecture Overview",
      "description": "This guide provides a comprehensive overview of the LBS Foundry architecture, design patterns, and core principles.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/aggregates-events-and-commands.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "concept",
      "title": "Domain-Driven Design: Aggregates, Events, and Commands",
      "description": "This guide explains how to implement domain-driven design (DDD) concepts using our event sourcing framework.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/batch-command-design.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "design",
      "title": "Batch Command Execution Design",
      "description": "This document outlines design options for executing multiple commands in a single API request, with support for transactional execution grouped by aggregate...",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/data-harvesters.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "concept",
      "title": "Data Harvesters Overview",
      "description": "The Data Harvesters are responsible for ingesting real-time data from external sources into the system. These sources can include sports data feeds, social...",
      "status": "current",
      "updated": "2025-10-13",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/database-schema-diagram.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "reference",
      "title": "Foundry Database Schema Diagram",
      "description": "The following contracts are registered in their own Marten modules for the main event store database, not the Foundry read model store:",
      "status": "current",
      "updated": "2026-06-18",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/event-sourcing.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "concept",
      "title": "Event Sourcing Architecture",
      "description": "This document describes the event sourcing implementation in LBS Foundry, including patterns, practices, and technical details.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/foundry-reference.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "reference",
      "title": "Foundry — Architecture, Rationale & Glossary",
      "description": "Architecture, rationale, and glossary for the Foundry platform: what it is, what it delivers (a canonical record of the sport plus the full distribution of simulated game outcomes), and the canonical terminology.",
      "status": "current",
      "updated": "2026-06-25",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/foundry-use-case-walk.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "concept",
      "title": "Foundry — Architecture Use Case Walk",
      "description": "A use-case walk of the Foundry architecture. Each walk traces a realistic",
      "status": "current",
      "updated": "2026-06-06",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/generic-query-pattern.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "design",
      "title": "Generic Query Pattern",
      "description": "The generic query pattern provides abstract base classes for implementing common query operations (GetAll, GetById) while allowing derived classes to:",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/identity-linking-problem-summary.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "design",
      "title": "Identity Linking — Problem & Solution Summary",
      "description": "LBS.Foundry ingests sports data from multiple providers (FoxSports, SuperCoach, StatsPerform, NRL Web, and — in the NFL 2026-2027 initiative — NflVerse, ESPN)....",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/mermaid-diagram-update-prompt.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "reference",
      "title": "Mermaid Diagram Update Prompt",
      "description": "Use this prompt at the end of any session where you've added or modified contracts, events, or contract builders. Paste it into Claude Code (or any AI...",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/multihost-concurrency-design.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "design",
      "title": "Multi-Host Concurrency Design",
      "description": "The current TimerService implementation only controls concurrency within a single host process:",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/query-command-alignment-design.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "design",
      "title": "Query-Command System Alignment Design",
      "description": "This document outlines a design for aligning the query system architecture with the command system patterns to achieve consistency and reduce complexity.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "docs/architecture/real-time-notification-system-technical-design.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "design",
      "title": "Real-Time Notification System - Technical Design",
      "description": "Related ADR: real-time-notification-system.md",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "architecture"
      ]
    },
    {
      "path": "src/Domain/LBS.EntityResolution/README.md",
      "section": "architecture",
      "sectionLabel": "Architecture",
      "type": "reference",
      "title": "LBS.EntityResolution — Provider-to-canonical-ID resolution",
      "description": "Resolves a provider's rows to Foundry canonical_ids — one canonical identity per real-world entity across every provider, so downstream Foundry Core joins...",
      "status": "current",
      "updated": null,
      "tags": []
    },
    {
      "path": "docs/developer-guide/README.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "index",
      "title": "Developer Guide",
      "description": "Day-to-day development reference for LBS Foundry. For platform overview see intro; for architecture see architecture/README.",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/adding-event-history-to-pages.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Adding Event History to Detail Pages",
      "description": "This guide shows how to add event history viewing capabilities to any aggregate detail page in Foundry.",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/ci-cd-pipeline.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "CI/CD Pipeline",
      "description": "This document describes the LBS Foundry continuous integration and deployment pipeline, implemented in .github/workflows/Build-Container-Apps.yml.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/coding-standards.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Coding Standards",
      "description": "This guide outlines the coding standards and conventions for the LBS Foundry project. Following these standards ensures consistency, maintainability, and...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/common-tasks.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Common Development Tasks",
      "description": "This guide covers the most common tasks you'll perform while developing LBS Foundry. Each task includes step-by-step instructions and examples.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/debugging.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Debugging and Troubleshooting Guide",
      "description": "This guide covers common issues you might encounter while developing LBS Foundry and how to resolve them.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/deployment-pipeline-setup.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Deployment Pipeline Setup Guide",
      "description": "This guide provides step-by-step instructions for setting up the deployment pipeline for LBS Foundry applications, including GitHub secrets configuration and...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/development-workflow.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "LBS Foundry Development Workflow",
      "description": "This guide outlines the internal development workflow and best practices for the LBS Foundry team.",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/event-history-viewer-backend.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Event History Viewer (Backend)",
      "description": "This document describes the event history viewing feature in Foundry, which allows viewing the complete event stream for any aggregate.",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/event-versioning.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Event Versioning and Maintaining Backwards Compatibility",
      "description": "This guide explains how to version, rename, or retire an event in an event-sourced system without breaking replay, projections, local environments, or...",
      "status": "current",
      "updated": "2026-04-17",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/faq.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Frequently Asked Questions (FAQ)",
      "description": "Common questions and answers for LBS Foundry developers.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/generic-queries.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Generic Queries",
      "description": "Reusable base query records (GetAllQuery / GetByIdQuery) and their handlers for read models implementing IContract.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/module-system.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Module System",
      "description": "The LBS module system provides a declarative way to enable/disable features and timers based on enabled modules. It integrates seamlessly with the Timer...",
      "status": "current",
      "updated": "2025-10-07",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/notifications.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Real-Time Notification System - Developer Guide",
      "description": "The LBS Foundry notification system provides real-time WebSocket-based notifications for database entity changes. It eliminates the need for polling and...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/ownership-validation.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "design",
      "title": "GetByIdQuery Ownership Validation - Design Options",
      "description": "This document outlines potential approaches for implementing ownership validation in GetByIdQuery<TContract>. This is Phase 2 functionality that was deferred...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/real-world-testing.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Real-World Event Replay Testing",
      "description": "This guide explains how to create tests that replay production/staging events through builders to verify correct behavior and debug issues.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/sdk/sdk-generation-process.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "SDK Generation & Publishing Process",
      "description": "This document explains how and when the TypeScript and Python SDKs are generated and published.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/sdk/sdk-generation-strategy.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "SDK Generation Strategy & Versioning",
      "description": "RFC weighing whether to commit auto-generated SDK files, with a recommendation and versioning strategy.",
      "status": "archived",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/sdk/sdk-generation.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "SDK Generation",
      "description": "The LBS Foundry platform provides auto-generated client SDKs in multiple languages, ensuring type safety and API consistency across all client applications.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/sdk/sdk-github-token-setup.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "GitHub Token Setup for pnpm on Windows",
      "description": "This guide explains how to configure a GitHub Personal Access Token (PAT) for pnpm on Windows to access private packages from GitHub Packages.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/sdk/sdk-local-development.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "SDK Local Development Guide",
      "description": "This guide explains how to use the Foundry SDK locally during development, including linking the SDK to your applications and testing authentication.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/developer-guide/timer-infrastructure.md",
      "section": "developer-guide",
      "sectionLabel": "Developer guide",
      "type": "guide",
      "title": "Timer Infrastructure",
      "description": "LBS Foundry provides a declarative timer infrastructure for scheduling recurring tasks. Instead of writing manual SystemBackgroundService implementations with...",
      "status": "current",
      "updated": "2025-10-13",
      "tags": [
        "developer-guide"
      ]
    },
    {
      "path": "docs/adr/README.md",
      "section": "adr",
      "sectionLabel": "Architecture decisions (ADRs)",
      "type": "index",
      "title": "Architecture Decision Records (ADRs)",
      "description": "This directory contains Architecture Decision Records (ADRs) that document important architectural decisions made for the LBS Foundry platform.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "adr"
      ]
    },
    {
      "path": "docs/adr/adr-007-typescript-sdk-auto-generation.md",
      "section": "adr",
      "sectionLabel": "Architecture decisions (ADRs)",
      "type": "adr",
      "title": "ADR-007: Auto-Generated Multi-Language SDK for LBS Foundry API",
      "description": "Phase 1-3: TypeScript SDK generator and client (Completed)",
      "status": "current",
      "updated": "2026-05-21",
      "tags": [
        "adr"
      ]
    },
    {
      "path": "docs/adr/adr-008-openapi-specification-generation.md",
      "section": "adr",
      "sectionLabel": "Architecture decisions (ADRs)",
      "type": "adr",
      "title": "ADR-008: OpenAPI 3.0 Specification Generation",
      "description": "Future enhancement to complement custom SDK generation (ADR-007) with industry-standard API documentation.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "adr"
      ]
    },
    {
      "path": "docs/adr/adr-009-sports-content-query-service-validation.md",
      "section": "adr",
      "sectionLabel": "Architecture decisions (ADRs)",
      "type": "adr",
      "title": "ADR-009: Sports Content Query Service — Validation & Foundational Architecture",
      "description": "Pending review and sign-off by Engineering and Product. Closes the Validation",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "adr"
      ]
    },
    {
      "path": "docs/adr/real-time-notification-system.md",
      "section": "adr",
      "sectionLabel": "Architecture decisions (ADRs)",
      "type": "adr",
      "title": "ADR: Real-Time Data Change Notification System",
      "description": "Architecture decision for the real-time data change notification system; Phases 1-2 implemented.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "adr"
      ]
    },
    {
      "path": "docs/api/ballr/ballr-optimise-lineup-by-roster.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "Optimise Lineup by Roster",
      "description": "Query Handler: GetOptimiseLineupByRosterQueryHandler",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/ballr-optimise-lineup-input-by-teamid.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "Get Optimise Lineup Input by Team ID",
      "description": "Query Handler: GetOptimiseLineupInputByTeamIdQueryHandler",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/ballr-tradeassist-by-roster.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "TradeAssist by Roster",
      "description": "Query Handler: GetTradeAssistByRosterQueryHandler",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/ballr-tradeassist-input-by-teamid.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "Get TradeAssist Input by Team ID",
      "description": "Query Handler: GetTradeAssistInputByTeamIdQueryHandler",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/cacheable-player-search-query-readme.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "Query Caching Examples",
      "description": "This directory contains examples of how to implement cacheable queries using the ICacheableQuery interface.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/get-player-super-coach-points-predictions-api.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "GetPlayerSuperCoachPointsPredictions API",
      "description": "The GetPlayerSuperCoachPointsPredictions API returns SuperCoach points predictions for the players in a single match. This is a secure readmodel query that requires the Member role.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/get-supercoach-team-rankings.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "Get SuperCoach Team Rankings",
      "description": "File: src/Apps/Ballr.WebApi/Integration/SuperCoachTeam/Queries/GetSupercoachTeamRankingsQueryHandler.cs",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/get-team-rating-input-by-team-id-api.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "GetTeamRatingInputByTeamId API",
      "description": "The GetTeamRatingInputByTeamId API retrieves the team rating input payload for a SuperCoach team. This builds the structured input required by the SuperCoach...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/link-unlink-supercoach-team.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "Link / Unlink SuperCoach Team Commands",
      "description": "Commands: LinkSupercoachTeamCommand, UnlinkSupercoachTeamCommand",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/search-supercoach-teams.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "reference",
      "title": "Search SuperCoach Teams",
      "description": "File: src/Apps/Ballr.WebApi/Integration/SuperCoachTeam/Queries/SearchSupercoachTeamsQueryHandler.cs",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "api"
      ]
    },
    {
      "path": "docs/api/ballr/tradeassist-implementation.md",
      "section": "api",
      "sectionLabel": "API",
      "type": "note",
      "title": "LBS-1051: TradeAssist (historical note)",
      "description": "Component: Ballr SuperCoach",
      "status": "archived",
      "updated": "2026-06-20",
      "tags": [
        "api",
        "ballr",
        "LBS-1051"
      ]
    },
    {
      "path": "docs/importers/clear-rugby-league-player-projections-importer.md",
      "section": "importers",
      "sectionLabel": "Importers",
      "type": "guide",
      "title": "ClearRugbyLeaguePlayerProjectionsImporter",
      "description": "Clears player projections for NRL SuperCoach participant stats. Supports clearing all participants for a given season and round, or a specific subset of...",
      "status": "current",
      "updated": "2026-02-27",
      "tags": [
        "importers"
      ]
    },
    {
      "path": "docs/importers/event-integrators.md",
      "section": "importers",
      "sectionLabel": "Importers",
      "type": "guide",
      "title": "Event Integrators Guide",
      "description": "Event integrators allow you to react to domain events in the event store, enabling integration with external systems, cross-aggregate workflows, and...",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "importers"
      ]
    },
    {
      "path": "docs/importers/feed-importer-implementation.md",
      "section": "importers",
      "sectionLabel": "Importers",
      "type": "guide",
      "title": "Admin Feed Imports",
      "description": "How the admin Feed Imports UI browses harvested provider data and triggers imports through the generic per-entity importers and the import infrastructure.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "importers"
      ]
    },
    {
      "path": "docs/importers/import-infrastructure-usage.md",
      "section": "importers",
      "sectionLabel": "Importers",
      "type": "guide",
      "title": "Import Infrastructure Usage Guide",
      "description": "This document explains how to use the LBS Foundry import infrastructure for creating and executing transactional imports.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "importers"
      ]
    },
    {
      "path": "docs/importers/squad-importer.md",
      "section": "importers",
      "sectionLabel": "Importers",
      "type": "guide",
      "title": "SquadImporter",
      "description": "Imports squad rosters (team-by-season player, coach, and staff lists) from the foundry.squads ClickHouse table into the SquadAggregate, reconciling each squad declaratively against the feed.",
      "status": "current",
      "updated": "2026-06-24",
      "tags": [
        "importers"
      ]
    },
    {
      "path": "docs/importers/statsperform-nrl-match-state-reference.md",
      "section": "importers",
      "sectionLabel": "Importers",
      "type": "guide",
      "title": "Stats Perform NRL Match State Reference",
      "description": "Single source of truth for the Stats Perform Rugby League game state model and its mapping to the Foundry domain.",
      "status": "current",
      "updated": "2026-03-15",
      "tags": [
        "importers"
      ]
    },
    {
      "path": "docs/importers/statsperform-nrl-scoreboard-importer.md",
      "section": "importers",
      "sectionLabel": "Importers",
      "type": "guide",
      "title": "StatsPerformNrlScoreboardImporter",
      "description": "Manually triggers a full reprocess of an NRL match scoreboard from StatsPerform. Fetches live match data from the StatsPerform API, resolves player and team ID...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "importers"
      ]
    },
    {
      "path": "docs/integrations/clerk-authentication-integration.md",
      "section": "integrations",
      "sectionLabel": "Integrations",
      "type": "guide",
      "title": "Clerk Authentication Integration",
      "description": "This document describes the pure event-sourced User authentication system integrated with Clerk for the LBS Foundry platform.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "integrations"
      ]
    },
    {
      "path": "docs/integrations/clerk-webhook-implementation-plan.md",
      "section": "integrations",
      "sectionLabel": "Integrations",
      "type": "plan",
      "title": "Clerk Webhook Implementation Plan",
      "description": "Implement a secure webhook handler to synchronize user data between Clerk and our system, creating user aggregates and preferences when users are created...",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "integrations"
      ]
    },
    {
      "path": "docs/integrations/cloudflare-pfx-generation-guide.md",
      "section": "integrations",
      "sectionLabel": "Integrations",
      "type": "guide",
      "title": "Cloudflare PFX Certificate Generation Guide",
      "description": "Complete guide for generating PFX certificates from Cloudflare Origin Certificates for use with Azure Container Apps custom domains.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "integrations"
      ]
    },
    {
      "path": "docs/integrations/discord-integration.md",
      "section": "integrations",
      "sectionLabel": "Integrations",
      "type": "guide",
      "title": "Discord Integration Configuration",
      "description": "The LBS Foundry platform integrates with Discord to provide community engagement and user verification features. This document outlines the configuration...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "integrations"
      ]
    },
    {
      "path": "docs/integrations/discord-verification-frontend-implementation.md",
      "section": "integrations",
      "sectionLabel": "Integrations",
      "type": "guide",
      "title": "Discord Verification Frontend Flow",
      "description": "How the Discord verification frontend flow works: a backend-served verification page that hands off to the SvelteKit login page and back again to complete account linking.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "integrations"
      ]
    },
    {
      "path": "docs/integrations/mcp-server.md",
      "section": "integrations",
      "sectionLabel": "Integrations",
      "type": "guide",
      "title": "LBS Ballr MCP Server Setup Guide",
      "description": "The LBS Ballr MCP Server provides secure, controlled access to sports data via the Model Context Protocol (MCP). It integrates with Clerk OAuth for...",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "integrations"
      ]
    },
    {
      "path": "docs/integrations/nuget-publish.md",
      "section": "integrations",
      "sectionLabel": "Integrations",
      "type": "guide",
      "title": "NuGet Package Publishing Guide",
      "description": "This guide provides step-by-step instructions for publishing NuGet packages to GitHub Packages for this repository.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "integrations"
      ]
    },
    {
      "path": "docs/models/americanfootball/nfl-flow/README.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "index",
      "title": "NFL Simulation Flowchart",
      "description": "Mermaid visualization of the NFL game simulator state machine, organized into 3 phases (Initialization / Play Execution / Play Aftermath). Vendored from the...",
      "status": "current",
      "updated": "2026-05-25",
      "tags": [
        "models"
      ]
    },
    {
      "path": "docs/models/americanfootball/allocation-reduction-concepts.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "model",
      "title": "Allocation Reduction Concepts — Play Object",
      "description": "The current simulation allocates ~35,000 Play class instances per season (288 games × ~130 plays per game). Each Play has 38 properties (situation, personnel...",
      "status": "current",
      "updated": "2026-04-14",
      "tags": [
        "models"
      ]
    },
    {
      "path": "docs/models/americanfootball/nfl-flow/CONTEXT.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "model",
      "title": "NFL Game Simulation Flowchart — Glossary",
      "description": "Terms used across the flowchart and its supporting docs. Domain vocabulary (NFL game / simulator state machine) and doc-framework vocabulary (how this project...",
      "status": "current",
      "updated": "2026-05-25",
      "tags": [
        "models"
      ]
    },
    {
      "path": "docs/models/americanfootball/nfl-flow/UPDATING.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "model",
      "title": "UPDATING.md",
      "description": "Operating manual for docs/models/americanfootball/nfl-flow/. Read this before editing the flowchart.",
      "status": "current",
      "updated": "2026-05-25",
      "tags": [
        "models"
      ]
    },
    {
      "path": "docs/models/americanfootball/nfl-flow/rendered/nfl_sim_flowchart.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "reference",
      "title": "NFL Game Simulation — State Machine Flowchart",
      "description": "A readable visualization of the state machine in nfl_model_flow_diagram.htm. The simulator models an NFL game as ~40 states with branching outcomes; this...",
      "status": "current",
      "updated": "2026-05-25",
      "tags": [
        "models",
        "generated"
      ]
    },
    {
      "path": "docs/models/americanfootball/nfl-season-structure-pr-notes.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "note",
      "title": "NFL Season Structure — Playoffs & Super Bowl",
      "description": "The simulation previously produced a flat 18-week regular season with no structure beyond team and week. This PR adds the structural scaffolding needed to run...",
      "status": "archived",
      "updated": "2026-06-19",
      "tags": [
        "models"
      ]
    },
    {
      "path": "docs/models/americanfootball/play-decision-integration-performance.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "model",
      "title": "Play Decision Model Integration — Performance Comparison (LBS-1657)",
      "description": "This document records the measured cost of the Play Decision neural network at each step of its",
      "status": "current",
      "updated": "2026-06-11",
      "tags": [
        "models"
      ]
    },
    {
      "path": "docs/models/americanfootball/pseudo-simulation-model.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "model",
      "title": "Pseudo Simulation Model — Enabling Full Season Monte Carlo",
      "description": "A pseudo American Football simulation model that generates play-by-play data for a complete 18-week NFL season (32 teams, 288 games, ~35,000 plays per season)....",
      "status": "current",
      "updated": "2026-04-14",
      "tags": [
        "models"
      ]
    },
    {
      "path": "src/Models/AmericanFootball/LBS.Model.AmericanFootball.Prediction/PlayDecision/README.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "reference",
      "title": "Play Decision — Real Model Integration Contract",
      "description": "The Play Decision predictor is the first real model behind the Predictors seam: the quants' Play Decision network, replacing the LBS-1654 pseudo predictor...",
      "status": "current",
      "updated": null,
      "tags": []
    },
    {
      "path": "src/Models/AmericanFootball/LBS.Model.AmericanFootball.Simulation/Engine/README.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "model",
      "title": "Engine — NFL Game Simulator",
      "description": "NFL game simulator — a code-driven finite state machine that mirrors the flowchart in docs/models/americanfootball/nfl-flow/rendered/nfl_sim_flowchart.md. This...",
      "status": "current",
      "updated": null,
      "tags": []
    },
    {
      "path": "src/Models/AmericanFootball/LBS.Model.AmericanFootball.Benchmarks/README.md",
      "section": "models",
      "sectionLabel": "Models",
      "type": "guide",
      "title": "American Football Benchmarks",
      "description": "BenchmarkDotNet harness for the NFL simulation and outcome-context pipeline. Tracks the cost of simulating a season and folding it into outcome contexts, so...",
      "status": "current",
      "updated": null,
      "tags": []
    },
    {
      "path": "docs/outcome-context/README.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "index",
      "title": "Outcome Context platform",
      "description": "A probabilistic sports-prediction service. Customer asks a question",
      "status": "current",
      "updated": "2026-06-12",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/amf-outcome-catalogue.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "reference",
      "title": "American Football outcome catalogue",
      "description": "This is the list of outcomes the American Football simulation currently produces. Each",
      "status": "current",
      "updated": "2026-06-12",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/design-decisions.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "design",
      "title": "OutcomeContext — Cross-Cutting Design Decisions",
      "description": "Companion to the executive roadmap",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/design.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "design",
      "title": "OutcomeContext — High-Level Design",
      "description": "Three layers of code stacked over one shared data model. Every layer is",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/evaluations/redis-as-store.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "evaluation",
      "title": "Redis as an Outcome-Context store — deferred evaluation notes",
      "description": "Current primary store: ClickHouse Cloud Production tier (validated 100K full-pipeline end-to-end in 2h 58m — see status-summary.md).",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/evaluations/storage-experiment/problem-statement.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "evaluation",
      "title": "K Worlds in Under 60 Seconds — Problem Statement",
      "description": "We have measured this on a laptop. The cost is dominated by pure simulation CPU — the storage/database layer is no longer the bottleneck.",
      "status": "archived",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/evaluations/storage-experiment/rd-findings.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "evaluation",
      "title": "Storage Experiment — R&D Findings",
      "description": "Activity period covered: 2026-04-16 → 2026-04-21 (Australian income year FY2025-26)",
      "status": "archived",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/evaluations/storage-experiment/status-summary.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "evaluation",
      "title": "Storage Experiment — Status Summary",
      "description": "High-level test state + performance numbers. For process, architecture, and retrospective analysis, see status.md. For the R&D Tax evidence write-up...",
      "status": "archived",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/evaluations/storage-experiment/status.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "evaluation",
      "title": "Storage Experiment — Status Update",
      "description": "K full-pipeline end-to-end validated on ClickHouse Cloud in 2h 58m for ~$27/run. All three outcome tables (game_outcome_context, play_by_play...",
      "status": "archived",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/evaluations/storage-experiment/story.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "evaluation",
      "title": "Storage Experiment: Making NFL Simulation Data Fast",
      "description": "A plain-English walkthrough of what we're building and why.",
      "status": "archived",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/graphql-master-prompt.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "reference",
      "title": "OutcomeContext GraphQL — Assistant Master Prompt",
      "description": "This document is designed to be pasted as the first message of a fresh",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/phase-breakdown.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "plan",
      "title": "OutcomeContext — Per-Phase Breakdown",
      "description": "Companion to the executive roadmap.",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/query-layer/build-plan.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "plan",
      "title": "Outcome Context — Query Layer Build Plan",
      "description": "Reads alongside: gap analysis, convergence reference.",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/query-layer/gap-analysis.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "design",
      "title": "Outcome Context — query-layer convergence gap analysis",
      "description": "Point-in-time gap analysis between the GraphQL query-layer prototype and the Outcome Context storage experiment (historical snapshot).",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/query-layer/rd-findings.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "evaluation",
      "title": "Outcome Context Query Layer — R&D Findings",
      "description": "Activity period covered: 2026-04-25 → 2026-05-10 (Australian income year FY2025-26)",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/query-layer/reference.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "reference",
      "title": "Outcome Context — Query Layer Reference",
      "description": "This document is the orientation point for the Outcome Context query layer and the storage layer it sits on top of. It describes what the system is, what each...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/roadmap.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "plan",
      "title": "Outcome Context Platform — Strategic Roadmap",
      "description": "Validate platform architecture with real model working end to end through the season.",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/sequencing-rationale.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "design",
      "title": "OutcomeContext — Sequencing Rationale (ADR-lite)",
      "description": "Companion to the executive roadmap,",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/sub-designs/d2-derivation-build-pipeline.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "design",
      "title": "D2 sub-design — Derivation build pipeline",
      "description": "Reads alongside: gap analysis, build plan implementation status.",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/sub-designs/d3-pre-simulation-catalog.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "design",
      "title": "D3 sub-design — Pre-simulation catalog",
      "description": "Reads alongside: gap analysis, build plan implementation status.",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "docs/outcome-context/sub-designs/d4-store-interface.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "design",
      "title": "D4 sub-design — IOutcomeContextStore method shape",
      "description": "Reads alongside: gap analysis, build plan implementation status.",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "outcome-context"
      ]
    },
    {
      "path": "src/Apps/LBS.OutcomeContext.SimulationRunner.Benchmarks/README.md",
      "section": "outcome-context",
      "sectionLabel": "Outcome Context",
      "type": "guide",
      "title": "Simulation Runner Benchmarks — Outcome Context producer",
      "description": "End-to-end outcome-context producer benchmark, with ClickHouse faked.",
      "status": "current",
      "updated": null,
      "tags": []
    },
    {
      "path": "docs/sport/get-ladder-query.md",
      "section": "sport",
      "sectionLabel": "Sport / domain",
      "type": "reference",
      "title": "GetLadderQuery — Reference",
      "description": "Source-of-truth reference for GetLadderQuery: the read-model query that returns competition ladder",
      "status": "current",
      "updated": "2026-06-04",
      "tags": [
        "sport"
      ]
    },
    {
      "path": "docs/sport/get-sporting-events-query.md",
      "section": "sport",
      "sectionLabel": "Sport / domain",
      "type": "reference",
      "title": "GetSportingEventsQuery — Filter Mode Reference",
      "description": "Reference for the three mutually exclusive filter modes of GetSportingEventsQuery and the fixed priority ladder the handler uses to resolve exactly one mode per request.",
      "status": "current",
      "updated": "2026-06-25",
      "tags": [
        "sport"
      ]
    },
    {
      "path": "docs/sport/mapped-players-query.md",
      "section": "sport",
      "sectionLabel": "Sport / domain",
      "type": "reference",
      "title": "GetMappedPlayers Query",
      "description": "Retrieves the full list of mapped players from ClickHouse, providing a cross-reference between FOX Sports, NRL, and SuperCoach player identifiers.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "sport"
      ]
    },
    {
      "path": "docs/sport/scoreboard-tests.md",
      "section": "sport",
      "sectionLabel": "Sport / domain",
      "type": "reference",
      "title": "ScoreBoard Unit Tests Documentation",
      "description": "How the ScoreBoard aggregate unit-test suite is structured (Cricket and Rugby League partials, integrator, projection builder) and how to run it.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "sport"
      ]
    },
    {
      "path": "docs/sport/sporting-event.md",
      "section": "sport",
      "sectionLabel": "Sport / domain",
      "type": "reference",
      "title": "Process Flow of SetGroupCommand",
      "description": "This document describes the end-to-end flow for handling a SetGroupCommand against a sporting event aggregate, including validation, change detection, event...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "sport"
      ]
    },
    {
      "path": "docs/sport/supercoach-participant-stats/cricket-stats-rules.md",
      "section": "sport",
      "sectionLabel": "Sport / domain",
      "type": "reference",
      "title": "Cricket SuperCoach Participant Stats Rules",
      "description": "This document outlines the scoring rules and statistics tracked for Cricket SuperCoach participants. Each player receives one document per match that is...",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "sport"
      ]
    },
    {
      "path": "docs/data-engineering/foundry-data-ingestion-guide.md",
      "section": "data-engineering",
      "sectionLabel": "Data engineering",
      "type": "guide",
      "title": "Foundry Data Ingestion — Data Engineering Guide",
      "description": "Data science and data engineering are the first pass on any new data source. By the time a provider's data reaches Foundry, your team has already done the hard...",
      "status": "current",
      "updated": "2026-05-29",
      "tags": [
        "data-engineering"
      ]
    },
    {
      "path": "docs/testing/notification-system-testing-guide.md",
      "section": "testing",
      "sectionLabel": "Testing",
      "type": "guide",
      "title": "Notification System Testing Guide",
      "description": "This guide covers testing strategies for the LBS Real-Time Notification System across unit tests, integration tests, and end-to-end scenarios.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "testing"
      ]
    },
    {
      "path": "docs/testing/test-command-system.md",
      "section": "testing",
      "sectionLabel": "Testing",
      "type": "guide",
      "title": "Testing CQRS Command System",
      "description": "This document provides examples for testing the command endpoint (POST /api/command) using existing commands in the system. Requests are intended to be run...",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "testing"
      ]
    },
    {
      "path": "docs/testing/test-importer-system.md",
      "section": "testing",
      "sectionLabel": "Testing",
      "type": "guide",
      "title": "Importer System Testing",
      "description": "This document provides examples for testing the import endpoint (POST /api/import). Requests are intended to be run with Bruno; each example shows the request...",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "testing"
      ]
    },
    {
      "path": "docs/testing/test-readmodel-queries.md",
      "section": "testing",
      "sectionLabel": "Testing",
      "type": "guide",
      "title": "Read-Model Query Testing",
      "description": "This document provides examples for testing the read-model endpoint (POST /api/readmodel) and its authentication behaviour. Requests are intended to be run...",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "testing"
      ]
    },
    {
      "path": "docs/runbooks/archive-non-luckbox-aggregates.md",
      "section": "runbooks",
      "sectionLabel": "Runbooks",
      "type": "runbook",
      "title": "Runbook: Archive Non-LuckBox Aggregates",
      "description": "Scope: Marten event streams in events.mt_events whose Create event carried a non-LuckBox DataSource. These are duplicate aggregates left behind by the...",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "runbooks"
      ]
    },
    {
      "path": "docs/configuration/README.md",
      "section": "configuration",
      "sectionLabel": "Configuration",
      "type": "index",
      "title": "Configuration Samples",
      "description": "This directory contains sample configuration files for various integrations and features in LBS Foundry.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "configuration"
      ]
    },
    {
      "path": "docs/samples/README.md",
      "section": "samples",
      "sectionLabel": "Samples",
      "type": "index",
      "title": "Sample Outputs",
      "description": "Point-in-time snapshots generated by the accumulator test suite. These let",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "samples"
      ]
    },
    {
      "path": "docs/samples/experiment-runs/README.md",
      "section": "samples",
      "sectionLabel": "Samples",
      "type": "index",
      "title": "Experiment Run Results",
      "description": "Captured output from real runs of the storage experiment against a local ClickHouse container.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "samples"
      ]
    },
    {
      "path": "docs/samples/first-game-diagnostic.md",
      "section": "samples",
      "sectionLabel": "Samples",
      "type": "sample",
      "title": "First Game Diagnostic",
      "description": "Final Score: DEN 41, ATL 55",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "samples"
      ]
    },
    {
      "path": "docs/samples/single-world-sample.md",
      "section": "samples",
      "sectionLabel": "Samples",
      "type": "sample",
      "title": "Single World Accumulator Output Sample",
      "description": "Generated: 2026-05-06 13:31:03 UTC",
      "status": "current",
      "updated": "2026-05-20",
      "tags": [
        "samples"
      ]
    },
    {
      "path": "docs/usecases/README.md",
      "section": "usecases",
      "sectionLabel": "Use cases",
      "type": "index",
      "title": "Use Cases for Viewing and Data Integration",
      "description": "Title: View live fantasy points predictions for Supercoach players during the game.",
      "status": "current",
      "updated": "2026-04-30",
      "tags": [
        "usecases"
      ]
    },
    {
      "path": "docs/user-guides/cricket-projections-overview.md",
      "section": "user-guides",
      "sectionLabel": "User guides",
      "type": "guide",
      "title": "Cricket Projections: How It Works",
      "description": "Cricket projections provide predictive insights for matches, including:",
      "status": "current",
      "updated": "2026-01-02",
      "tags": [
        "user-guides"
      ]
    },
    {
      "path": "docs/user-guides/event-history-viewer.md",
      "section": "user-guides",
      "sectionLabel": "User guides",
      "type": "guide",
      "title": "Event History Viewer: How It Works",
      "description": "The Event History Viewer lets you see a complete timeline of every change made to an item in the system. Think of it as a detailed audit log that shows:",
      "status": "current",
      "updated": "2026-06-19",
      "tags": [
        "user-guides"
      ]
    },
    {
      "path": "docs/end-user-guides/projection-visibility-management.md",
      "section": "end-user-guides",
      "sectionLabel": "End-user guides",
      "type": "guide",
      "title": "Projection Visibility Management",
      "description": "Projection Visibility Management allows content managers to control which rounds of player projections are visible to Ballr users. All projection data for...",
      "status": "current",
      "updated": "2026-03-25",
      "tags": [
        "end-user"
      ]
    },
    {
      "path": "docs/meta/canonical-entity-mapping-deck-outline.md",
      "section": "meta",
      "sectionLabel": "Meta (docs about docs)",
      "type": "note",
      "title": "Canonical Entity Mapping — Presentation Outline",
      "description": "A 5–6 slide deck with a live demo in the middle, aimed at a mixed audience: execs, managers, end users, and developers. The structure leads with the problem in...",
      "status": "archived",
      "updated": "2026-06-19",
      "tags": [
        "meta"
      ]
    },
    {
      "path": "docs/meta/documentation-audit.md",
      "section": "meta",
      "sectionLabel": "Meta (docs about docs)",
      "type": "note",
      "title": "Documentation Audit & OKF Alignment Roadmap",
      "description": "Review of docs/ against Google's Open Knowledge Format, with a phased roadmap and file-by-file remediation.",
      "status": "draft",
      "updated": "2026-06-19",
      "tags": [
        "documentation",
        "okf",
        "meta"
      ]
    },
    {
      "path": "docs/meta/documentation-guide.md",
      "section": "meta",
      "sectionLabel": "Meta (docs about docs)",
      "type": "guide",
      "title": "Documentation Conventions",
      "description": "How docs in this repo are typed, named, placed, and frontmatter-tagged (the OKF-aligned convention).",
      "status": "current",
      "updated": "2026-06-26",
      "tags": [
        "documentation",
        "okf",
        "meta",
        "conventions"
      ]
    },
    {
      "path": "docs/meta/documentation-review.md",
      "section": "meta",
      "sectionLabel": "Meta (docs about docs)",
      "type": "note",
      "title": "Documentation Review — Relevance & Correctness",
      "description": "Systematic review of all 170 docs against the codebase; fixes applied and issues flagged for decision.",
      "status": "current",
      "updated": "2026-06-20",
      "tags": [
        "documentation",
        "review",
        "meta"
      ]
    },
    {
      "path": "docs/meta/okf-access-and-contributing.md",
      "section": "meta",
      "sectionLabel": "Meta (docs about docs)",
      "type": "guide",
      "title": "OKF docs: access & contributing",
      "description": "How to reach the LBS Foundry documentation (the site, the downloadable bundle, and the machine-readable manifest) and how to add to it.",
      "status": "current",
      "updated": "2026-06-26",
      "tags": [
        "documentation",
        "okf",
        "meta"
      ]
    }
  ]
}