@yottagraph-app/data-model-skill 0.0.11 → 0.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottagraph-app/data-model-skill",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Data model skill documentation for AI agents - entity types, properties, and schemas from Lovelace fetch sources",
   "repository": {
     "type": "git",

package/skill/edgar/schema.yaml

@@ -1924,3 +1924,61 @@ attributes:
     description: "Fiscal period: FY (annual), Q1, Q2, Q3 (quarterly)"
     display_name: "Filing Period"
     mergeability: not_mergeable
+
+  # ── holds_position relationship attributes (13F-HR) ──
+
+  - property: "holds_position"
+    name: "position_value"
+    type: string
+    description: "Market value of the position in thousands of USD"
+    display_name: "Position Value"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "shares_held"
+    type: string
+    description: "Number of shares or principal amount held"
+    display_name: "Shares Held"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "instrument_type"
+    type: string
+    description: "Type of instrument: SH (shares) or PRN (principal amount)"
+    display_name: "Instrument Type"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "put_call"
+    type: string
+    description: "Option type if applicable: PUT or CALL"
+    display_name: "Put/Call"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "investment_discretion"
+    type: string
+    description: "Investment discretion: SOLE, SHARED, or DEFINED"
+    display_name: "Investment Discretion"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "voting_authority_sole"
+    type: string
+    description: "Shares with sole voting authority"
+    display_name: "Voting Authority (Sole)"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "voting_authority_shared"
+    type: string
+    description: "Shares with shared voting authority"
+    display_name: "Voting Authority (Shared)"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "voting_authority_none"
+    type: string
+    description: "Shares with no voting authority"
+    display_name: "Voting Authority (None)"
+    mergeability: not_mergeable

package/skill/stocks/DATA_DICTIONARY.md

@@ -2,9 +2,9 @@
 
 ## Source Overview
 
-Alpha Vantage stock market data via the `TIME_SERIES_DAILY` REST API. Provides daily OHLCV (open, high, low, close, volume) candlestick data for US-listed equities on NYSE, NASDAQ, and AMEX exchanges.
+Alpha Vantage stock market data via the `TIME_SERIES_DAILY` and `TIME_SERIES_INTRADAY` REST APIs. Provides daily and 15-minute OHLCV (open, high, low, close, volume) candlestick data for US-listed equities on NYSE, NASDAQ, and AMEX exchanges.
 
-Historical data available via `outputsize=full` (20+ years). Recent data (last 100 trading days) available via `outputsize=compact`. The streamer uses `full` for initial backfill and `compact` for daily incremental updates.
+Historical data uses daily candles: `outputsize=full` (20+ years) for initial backfill, `outputsize=compact` (last 100 trading days) for incremental catch-ups. Current-day data uses intraday candles at 15-minute intervals (15-min delayed). The streamer automatically handles both: daily backfill when needed, plus intraday polling every 15 minutes.
 
 Symbol universe: ~6,900 tickers (after filtering preferred stock symbols) sourced from the NASDAQ screener (static CSV, downloaded 2026-03-13). Symbols containing `^` (preferred shares) are excluded because Alpha Vantage does not support them.
 
@@ -12,7 +12,7 @@ Rate limit: 1,200 requests/minute (premium plan). Downloads run concurrently (10
 
 | Pipeline | `Record.Source` |
 |----------|----------------|
-| Daily OHLCV | `stocks` |
+| Daily + Intraday OHLCV | `stocks` |
 
 ---
 
@@ -68,32 +68,32 @@ A company or entity whose equity securities are publicly traded on a US exchange
   * Examples: `"Computer Manufacturing"`, `"Biotechnology: Laboratory Analytical Instruments"`
   * Derivation: `industry` field from the NASDAQ screener CSV. May be empty.
 
-#### Price Data (per daily candle)
+#### Price Data (per candle)
 
-Each record represents one daily OHLCV candlestick for a single security. The atom timestamp is the trading day's date (Eastern time, converted to UTC).
+Each record represents one OHLCV candlestick for a single security. For daily candles the timestamp is the trading day's date; for intraday candles it is the interval's start time. All timestamps are Eastern time, converted to UTC.
 
 * `open_price`
-  * Definition: Opening price of the trading day. Unit: USD.
+  * Definition: Opening price of the trading interval. Unit: USD.
   * Examples: `233.55`, `247.10`
-  * Derivation: `1. open` field from Alpha Vantage `Time Series (Daily)` response, parsed as float.
+  * Derivation: `1. open` field from Alpha Vantage time series response, parsed as float.
 
 * `high_price`
-  * Definition: Highest price reached during the trading day. Unit: USD.
+  * Definition: Highest price reached during the trading interval. Unit: USD.
   * Examples: `234.00`, `250.05`
   * Derivation: `2. high` field from Alpha Vantage response, parsed as float.
 
 * `low_price`
-  * Definition: Lowest price reached during the trading day. Unit: USD.
+  * Definition: Lowest price reached during the trading interval. Unit: USD.
   * Examples: `233.00`, `245.64`
   * Derivation: `3. low` field from Alpha Vantage response, parsed as float.
 
 * `close_price`
-  * Definition: Closing price of the trading day. Unit: USD.
+  * Definition: Closing price of the trading interval. Unit: USD.
   * Examples: `233.50`, `247.68`
   * Derivation: `4. close` field from Alpha Vantage response, parsed as float.
 
 * `trading_volume`
-  * Definition: Number of shares traded during the day. Unit: shares.
+  * Definition: Number of shares traded during the interval. Unit: shares.
   * Examples: `1858`, `5547724`
   * Derivation: `5. volume` field from Alpha Vantage response, parsed as integer (stored as float per v2 convention).
 
@@ -118,5 +118,5 @@ organization ──[traded_as]──→ financial_instrument
 - **Timestamps**: Alpha Vantage returns timestamps in US/Eastern time. All atom timestamps are converted to UTC before storage.
 - **Adjusted prices**: The daily endpoint returns raw (as-traded) prices. Split/dividend-adjusted data is available via `TIME_SERIES_DAILY_ADJUSTED` (premium) but is not currently used.
 - **Missing data**: Not all symbols have data for all dates. Candles only exist for days with trading activity.
-- **Streaming model**: HandleStream runs as a continuous polling loop. First run downloads full history (`outputsize=full`). Subsequent runs download compact data (`outputsize=compact`, last 100 trading days) and atomize only candles newer than the checkpoint. Default poll interval: 24 hours.
+- **Streaming model**: HandleStream runs as a unified polling loop (default: every 15 minutes). First run downloads full daily history (`outputsize=full`) plus current-day intraday data. Subsequent runs download compact daily data once per day to catch yesterday's close, then poll intraday data every 15 minutes. Only candles newer than the checkpoint are atomized.
 - **Preferred stock symbols**: Tickers containing `^` (e.g., `AHT^F`, `F^C`) are filtered out during symbol loading because Alpha Vantage returns empty responses for them.

package/skill/stocks/schema.yaml

@@ -7,7 +7,7 @@
 # All elements are passive -- created by the atomizer from structured JSON
 # fields, not by LLM extraction.
 name: "stocks"
-description: "US equity OHLCV price data from Alpha Vantage, covering NYSE, NASDAQ, and AMEX listed securities at 15-minute and daily intervals"
+description: "US equity OHLCV price data from Alpha Vantage, covering NYSE, NASDAQ, and AMEX listed securities. Daily candles for historical data, 15-minute intraday candles for current-day data."
 
 extraction:
   flavors: closed
@@ -129,3 +129,43 @@ relationships:
     target_flavors: ["financial_instrument"]
     examples: ["Apple Inc. traded as AAPL", "International Business Machines Corporation traded as IBM"]
     passive: true
+
+# Each price and volume atom carries a candle_interval attribute indicating
+# the time period it covers. Only representative entries are listed; the
+# attribute is added dynamically by the atomizer to all price/volume atoms.
+
+attributes:
+  - property: "open_price"
+    name: "candle_interval"
+    type: string
+    description: "Time period covered by this candle: '1day' for daily end-of-day, '15min'/'5min'/'1min' for intraday"
+    display_name: "Candle Interval"
+    mergeability: not_mergeable
+
+  - property: "high_price"
+    name: "candle_interval"
+    type: string
+    description: "Time period covered by this candle: '1day' for daily end-of-day, '15min'/'5min'/'1min' for intraday"
+    display_name: "Candle Interval"
+    mergeability: not_mergeable
+
+  - property: "low_price"
+    name: "candle_interval"
+    type: string
+    description: "Time period covered by this candle: '1day' for daily end-of-day, '15min'/'5min'/'1min' for intraday"
+    display_name: "Candle Interval"
+    mergeability: not_mergeable
+
+  - property: "close_price"
+    name: "candle_interval"
+    type: string
+    description: "Time period covered by this candle: '1day' for daily end-of-day, '15min'/'5min'/'1min' for intraday"
+    display_name: "Candle Interval"
+    mergeability: not_mergeable
+
+  - property: "trading_volume"
+    name: "candle_interval"
+    type: string
+    description: "Time period covered by this candle: '1day' for daily end-of-day, '15min'/'5min'/'1min' for intraday"
+    display_name: "Candle Interval"
+    mergeability: not_mergeable