Bulkhead τ Domain

Semiconductors Database

SQLite Coverage Across Share, Financial, Price, and Event Data

Table Coverage

Table Rows Distinct Entities Date Range
market_share 36 9 companies, 3 markets, 4 segments 2024-12-31 to 2025-12-31
vendor_metrics 2,869 Vendor-period-metric observations SEC-driven fundamentals timeline
prices 106,413 14 tickers 1972-01-07 to 2026-02-05
events 10 6 companies 2024-01-25 to 2025-05-02

Schema Reference

market_share

Column Type Description
metric_dateTEXTSnapshot date (e.g., 2025-12-31)
marketTEXTCPU, GPU, Foundry
segmentTEXTClient, DataCenter, Discrete, Wafer
companyTEXTVendor label (e.g., NVIDIA, AMD)
share_pctREALMarket share percentage
sourceTEXTSource family for the observation

vendor_metrics

Column Type Description
metric_dateTEXTPeriod end date
periodTEXTReporting period (quarter/annual)
companyTEXTVendor name
tickerTEXTTrading symbol
metric_nameTEXTRevenue, GrossProfit, OperatingIncomeLoss, NetIncomeLoss
metric_valueREALReported numeric metric value

prices + events

Table Key Fields Purpose
prices trade_date, ticker, OHLCV Price trend, relative performance, event windows
events event_date, company, event_type, title Catalyst-aware analysis and SOP note generation

Ingestion Pipeline

SEC Fundamentals

scripts/pull_sec_companyfacts.py pulls company facts and normalizes vendor metrics.

Price History

scripts/pull_stooq_prices.py loads daily price history for benchmark and vendor tickers.

Authoritative Share Inputs

scripts/sources/normalize_authoritative_sources.sh maps source snapshots into data/manual/*_market_share.csv.

Database Build

scripts/init_db.py creates and refreshes SQLite tables via idempotent inserts.

Quick Commands

cd domains/Semiconductors pip install -r requirements.txt ./scripts/bootstrap_data.sh python cockpit_poc/agent/tests/test_agent.py --test