# kaenyne/citadel-abnb architecture

> Architecture diagram of the GitHub repository kaenyne/citadel-abnb, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kaenyne/citadel-abnb
- Repository: https://github.com/kaenyne/citadel-abnb

## Overview

Citadel-ABNB is a team research workspace for an Airbnb stock pitch, not a single runtime application. Its principal workflow is to collect and assess company, market, and alternative data; build point-in-time evidence and forecasts; analyze investment drivers; and prepare research exhibits for the pitch. The tree also shows regulatory research and many specialized forecasting and analysis workstreams. Source excerpts reveal a few concrete module dependencies; most other links are documented capabilities or unverified, so they are left out or marked dashed.

Main entry points: [`theos-past-research/src/abnb_alt_data/validation.py`](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/validation.py) (Alt-data validation), [`theos-past-research/src/abnb_forecasting/packet.py`](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/packet.py) (Forecast packets), [`ABNB-Crossover/tools/forward_exhibits.py`](https://github.com/kaenyne/citadel-abnb/blob/main/ABNB-Crossover/tools/forward_exhibits.py) (Pitch exhibits), [`theos-past-research/scripts/artifact_tool_runtime.mjs`](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/scripts/artifact_tool_runtime.mjs) (Workbook runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acquisition["Research Data"]
  node_acquisition["Data acquisition"]
  node_lodging_map["Lodging map<br/>[lodging_map.py]"]
end

subgraph group_evidence["Evidence Controls"]
  node_altdata_validation["Alt-data validation<br/>[validation.py]"]
  node_altdata_schemas["Alt-data schemas<br/>[schemas.py]"]
  node_altdata_policy["Import policy<br/>[import_policy.py]"]
  node_altdata_leakage["Leakage checks<br/>[leakage.py]"]
  node_guidance_evidence["Management evidence"]
  node_guidance_records["Guidance records<br/>[records.py]"]
  node_guidance_storage[("Guidance storage<br/>[storage.py]")]
end

subgraph group_forecasting["Forecasting"]
  node_eligibility["Evidence eligibility<br/>[eligibility.py]"]
  node_forecast_contracts["Forecast contracts<br/>[contracts.py]"]
  node_forecast_baselines["Forecast baselines<br/>[baselines.py]"]
  node_forecast_packets["Forecast packets<br/>[packet.py]"]
  node_forecast_methods["Forecast methods"]
end

subgraph group_analysis["Pitch Analysis"]
  node_party_reviews["Party-size analysis"]
  node_regulatory["Regulatory analysis"]
  node_promo_analysis["Promotion analysis<br/>[parse_promos.py]"]
  node_pitch_exhibits["Pitch exhibits"]
  node_deck_charts["Deck charts<br/>[deck_charts_v2.py]"]
  node_guidance_comparison["Guidance comparison<br/>[build_workbook.mjs]"]
  node_source_comparison["Source comparison<br/>[build_workbook.mjs]"]
  node_reaction_workbook["Reaction workbook"]
  node_artifact_runtime["Workbook runtime"]
end

node_analyst(("Pitch team"))

node_guidance_evidence -->|"uses records"| node_guidance_records
node_altdata_validation -->|"checks policy"| node_altdata_policy
node_altdata_validation -->|"checks leakage"| node_altdata_leakage
node_altdata_validation -->|"checks schemas"| node_altdata_schemas
node_forecast_contracts -->|"uses timestamps"| node_eligibility
node_forecast_packets -->|"validates records"| node_forecast_contracts
node_forecast_packets -->|"audits features"| node_eligibility
node_forecast_packets -->|"uses baselines"| node_forecast_baselines
node_guidance_comparison -->|"loads runtime"| node_artifact_runtime
node_source_comparison -->|"loads runtime"| node_artifact_runtime
node_reaction_workbook -->|"loads runtime"| node_artifact_runtime
node_analyst -.->|"initiates research"| node_acquisition
node_analyst -.->|"prepares pitch"| node_pitch_exhibits
node_acquisition -.->|"provides inputs"| node_altdata_validation
node_guidance_storage -.->|"stores records"| node_guidance_records
node_forecast_methods -.->|"produces forecasts"| node_forecast_packets
node_party_reviews -.->|"informs exhibits"| node_pitch_exhibits
node_regulatory -.->|"informs exhibits"| node_pitch_exhibits
node_promo_analysis -.->|"informs exhibits"| node_pitch_exhibits
node_deck_charts -.->|"supports pitch"| node_analyst

click node_acquisition "https://github.com/kaenyne/citadel-abnb/tree/main/analysis/src/acquisition"
click node_altdata_validation "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/validation.py"
click node_altdata_schemas "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/schemas.py"
click node_altdata_policy "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/import_policy.py"
click node_altdata_leakage "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/leakage.py"
click node_lodging_map "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/lodging_map.py"
click node_guidance_evidence "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_guidance/management_evidence.py"
click node_guidance_records "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_guidance/records.py"
click node_guidance_storage "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_guidance/storage.py"
click node_eligibility "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/eligibility.py"
click node_forecast_contracts "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/contracts.py"
click node_forecast_baselines "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/baselines.py"
click node_forecast_packets "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/packet.py"
click node_forecast_methods "https://github.com/kaenyne/citadel-abnb/tree/main/analysis/src/forecast_methods"
click node_party_reviews "https://github.com/kaenyne/citadel-abnb/blob/main/analysis/src/abnb_party_size_reviews.py"
click node_regulatory "https://github.com/kaenyne/citadel-abnb/blob/main/analysis/src/build_regulatory_database.py"
click node_promo_analysis "https://github.com/kaenyne/citadel-abnb/blob/main/ABNB-Crossover/tools/parse_promos.py"
click node_pitch_exhibits "https://github.com/kaenyne/citadel-abnb/blob/main/ABNB-Crossover/tools/forward_exhibits.py"
click node_deck_charts "https://github.com/kaenyne/citadel-abnb/blob/main/ABNB-Crossover/tools/deck_charts_v2.py"
click node_guidance_comparison "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/research/forecasting/runs/20260903T233712Z_us_europe_guidance_comparison/build_workbook.mjs"
click node_source_comparison "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/research/forecasting/runs/20260903T224632Z_50_source_guidance_format/build_workbook.mjs"
click node_reaction_workbook "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/outputs/reproducibility/us-europe-guidance/build_abnb_edge_guidance_reaction.mjs"
click node_artifact_runtime "https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/scripts/artifact_tool_runtime.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_acquisition,node_lodging_map toneBlue
class node_altdata_validation,node_altdata_schemas,node_altdata_policy,node_altdata_leakage,node_guidance_evidence,node_guidance_records,node_guidance_storage toneAmber
class node_eligibility,node_forecast_contracts,node_forecast_baselines,node_forecast_packets,node_forecast_methods toneMint
class node_party_reviews,node_regulatory,node_promo_analysis,node_pitch_exhibits,node_deck_charts,node_guidance_comparison,node_source_comparison,node_reaction_workbook,node_artifact_runtime toneRose
class node_analyst toneIndigo
```

## Components

### Research Data

- [Data acquisition](https://github.com/kaenyne/citadel-abnb/tree/main/analysis/src/acquisition): `analysis/src/acquisition`
- [Lodging map](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/lodging_map.py): `theos-past-research/src/abnb_alt_data/lodging_map.py`

### Evidence Controls

- [Alt-data validation](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/validation.py): `theos-past-research/src/abnb_alt_data/validation.py`
- [Alt-data schemas](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/schemas.py): `theos-past-research/src/abnb_alt_data/schemas.py`
- [Import policy](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/import_policy.py): `theos-past-research/src/abnb_alt_data/import_policy.py`
- [Leakage checks](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_alt_data/leakage.py): `theos-past-research/src/abnb_alt_data/leakage.py`
- [Management evidence](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_guidance/management_evidence.py): `theos-past-research/src/abnb_guidance/management_evidence.py`
- [Guidance records](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_guidance/records.py): `theos-past-research/src/abnb_guidance/records.py`
- [Guidance storage](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_guidance/storage.py): `theos-past-research/src/abnb_guidance/storage.py`

### Forecasting

- [Evidence eligibility](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/eligibility.py): `theos-past-research/src/abnb_forecasting/eligibility.py`
- [Forecast contracts](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/contracts.py): `theos-past-research/src/abnb_forecasting/contracts.py`
- [Forecast baselines](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/baselines.py): `theos-past-research/src/abnb_forecasting/baselines.py`
- [Forecast packets](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/src/abnb_forecasting/packet.py): `theos-past-research/src/abnb_forecasting/packet.py`
- [Forecast methods](https://github.com/kaenyne/citadel-abnb/tree/main/analysis/src/forecast_methods): `analysis/src/forecast_methods`

### Pitch Analysis

- [Party-size analysis](https://github.com/kaenyne/citadel-abnb/blob/main/analysis/src/abnb_party_size_reviews.py): `analysis/src/abnb_party_size_reviews.py`
- [Regulatory analysis](https://github.com/kaenyne/citadel-abnb/blob/main/analysis/src/build_regulatory_database.py): `analysis/src/build_regulatory_database.py`
- [Promotion analysis](https://github.com/kaenyne/citadel-abnb/blob/main/ABNB-Crossover/tools/parse_promos.py): `ABNB-Crossover/tools/parse_promos.py`
- [Pitch exhibits](https://github.com/kaenyne/citadel-abnb/blob/main/ABNB-Crossover/tools/forward_exhibits.py): `ABNB-Crossover/tools/forward_exhibits.py`
- [Deck charts](https://github.com/kaenyne/citadel-abnb/blob/main/ABNB-Crossover/tools/deck_charts_v2.py): `ABNB-Crossover/tools/deck_charts_v2.py`
- [Guidance comparison](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/research/forecasting/runs/20260903T233712Z_us_europe_guidance_comparison/build_workbook.mjs): `theos-past-research/research/forecasting/runs/20260903T233712Z_us_europe_guidance_comparison/build_workbook.mjs`
- [Source comparison](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/research/forecasting/runs/20260903T224632Z_50_source_guidance_format/build_workbook.mjs): `theos-past-research/research/forecasting/runs/20260903T224632Z_50_source_guidance_format/build_workbook.mjs`
- [Reaction workbook](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/outputs/reproducibility/us-europe-guidance/build_abnb_edge_guidance_reaction.mjs): `theos-past-research/outputs/reproducibility/us-europe-guidance/build_abnb_edge_guidance_reaction.mjs`
- [Workbook runtime](https://github.com/kaenyne/citadel-abnb/blob/main/theos-past-research/scripts/artifact_tool_runtime.mjs): `theos-past-research/scripts/artifact_tool_runtime.mjs`

### Other components

- **Pitch team**

## Connections

- Management evidence → Guidance records: uses records (evidence: `theos-past-research/src/abnb_guidance/management_evidence.py`)
- Alt-data validation → Import policy: checks policy (evidence: `theos-past-research/src/abnb_alt_data/validation.py`)
- Alt-data validation → Leakage checks: checks leakage (evidence: `theos-past-research/src/abnb_alt_data/validation.py`)
- Alt-data validation → Alt-data schemas: checks schemas (evidence: `theos-past-research/src/abnb_alt_data/validation.py`)
- Forecast contracts → Evidence eligibility: uses timestamps (evidence: `theos-past-research/src/abnb_forecasting/contracts.py`)
- Forecast packets → Forecast contracts: validates records (evidence: `theos-past-research/src/abnb_forecasting/packet.py`)
- Forecast packets → Evidence eligibility: audits features (evidence: `theos-past-research/src/abnb_forecasting/packet.py`)
- Forecast packets → Forecast baselines: uses baselines (evidence: `theos-past-research/src/abnb_forecasting/packet.py`)
- Guidance comparison → Workbook runtime: loads runtime (evidence: `theos-past-research/research/forecasting/runs/20260903T233712Z_us_europe_guidance_comparison/build_workbook.mjs`)
- Source comparison → Workbook runtime: loads runtime (evidence: `theos-past-research/research/forecasting/runs/20260903T224632Z_50_source_guidance_format/build_workbook.mjs`)
- Reaction workbook → Workbook runtime: loads runtime (evidence: `theos-past-research/outputs/reproducibility/us-europe-guidance/build_abnb_edge_guidance_reaction.mjs`)
- Pitch team → Data acquisition: initiates research (evidence: `README.md`)
- Pitch team → Pitch exhibits: prepares pitch (evidence: `README.md`)
- Data acquisition → Alt-data validation: provides inputs
- Guidance storage → Guidance records: stores records (evidence: `theos-past-research/src/abnb_guidance/storage.py`)
- Forecast methods → Forecast packets: produces forecasts
- Party-size analysis → Pitch exhibits: informs exhibits
- Regulatory analysis → Pitch exhibits: informs exhibits
- Promotion analysis → Pitch exhibits: informs exhibits
- Deck charts → Pitch team: supports pitch
