@yottagraph-app/data-model-skill 0.0.12 → 0.0.14

package/package.json

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

package/skill/sanctions/schema.yaml

@@ -19,24 +19,91 @@ flavors:
     description: "A real person as opposed to a fictional character, such as a CEO, politician, or public figure"
     display_name: "Person"
     mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
     passive: true
 
   - name: "organization"
     description: "A particular business, institution, or organization such as a corporation, university, government agency, or non-profit"
     display_name: "Organization"
     mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "legal_entity"
+    description: "An entity with legal personality whose type (person vs organization) is unknown in the source data, common in leak-derived datasets like ICIJ Offshore Leaks"
+    display_name: "Legal Entity"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
     passive: true
 
   - name: "sanction_program"
     description: "A government or international sanctions program under which entities are designated"
     display_name: "Sanction Program"
     mergeability: not_mergeable
+    strong_id_properties: ["program_id"]
     passive: true
 
-  - name: "country"
-    description: "A country referenced by sanctioned organizations, identified by ISO country code"
-    display_name: "Country"
+  - name: "ship"
+    description: "A vessel (boat or ship) identified in sanctions designations"
+    display_name: "Vessel"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "aircraft"
+    description: "An airplane identified in sanctions designations"
+    display_name: "Aircraft"
     mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "financial_instrument"
+    description: "A specific asset that can be traded, such as a stock, ETF, bond, CD, or fund. Companies are organizations, NOT financial instruments. Specific currency amounts are NOT financial instruments."
+    display_name: "Security"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id", "cusip_number", "isin"]
+    passive: true
+
+  - name: "crypto_wallet"
+    description: "A cryptocurrency wallet address identified in sanctions designations"
+    display_name: "Crypto Wallet"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id", "public_key"]
+    passive: true
+
+  - name: "location"
+    description: "A specific named geographic location such as a city, country, region, or landmark"
+    display_name: "Address"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "political_position"
+    description: "A political office or government position held by a PEP"
+    display_name: "Political Position"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "physical_asset"
+    description: "A physical asset such as real estate or business property linked to a sanctioned person"
+    display_name: "Physical Asset"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "article"
+    description: "A news article or press release being processed"
+    display_name: "Article"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "identity_document"
+    description: "An identity document (passport, national ID) linked to a sanctioned person"
+    display_name: "Identity Document"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
     passive: true
 
 properties:
@@ -45,7 +112,7 @@ properties:
     description: "Unique identifier assigned to this entity by the upstream sanctions data provider (OpenSanctions entity ID)"
     display_name: "Sanctions ID"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "location", "political_position", "physical_asset", "article", "identity_document"]
     examples: ["ch-seco-94982", "us-ofac-12345"]
     passive: true
 
@@ -54,7 +121,7 @@ properties:
     description: "Display name of the entity"
     display_name: "Name"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "sanction_program", "ship", "aircraft", "financial_instrument", "crypto_wallet", "location", "political_position", "physical_asset", "article"]
     examples: ["Zhongheng Lin", "Vladimir Putin"]
     passive: true
 
@@ -63,7 +130,7 @@ properties:
     description: "An alternative name or spelling for this entity, one atom per alias"
     display_name: "Alias"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet"]
     passive: true
 
   - name: "birth_date"
@@ -98,7 +165,7 @@ properties:
     description: "Classification tag indicating the type of sanctions designation, one atom per topic"
     display_name: "Sanctions Topic"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet"]
     examples: ["sanction", "poi", "debarment", "entity.associate"]
     passive: true
 
@@ -107,47 +174,512 @@ properties:
     description: "Descriptive notes or commentary associated with the entity"
     display_name: "Notes"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "physical_asset", "crypto_wallet"]
     passive: true
 
-  - name: "sanctioned"
-    type: float
-    description: "Boolean flag indicating this entity is a sanctions target, emitted only when no notes are present as a fallback marker"
-    display_name: "Sanctioned"
+  - name: "sanction_source_url"
+    type: string
+    description: "URL of the original source document for this sanctions listing, one atom per URL"
+    display_name: "Sanction Source URL"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "article"]
+    examples: ["https://www.federalreserve.gov/boarddocs/press/enforcement/2005/20050607/default.htm"]
+    passive: true
+
+  - name: "sanction_start_date"
+    type: string
+    description: "ISO 8601 date when this entity first appeared in the sanctions dataset (from OpenSanctions first_seen)"
+    display_name: "Sanction Start Date"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "political_position", "location", "article"]
+    examples: ["2022-02-25", "2023-06-14"]
+    passive: true
+
+  - name: "sanction_end_date"
+    type: string
+    description: "ISO 8601 date when this entity was removed from the sanctions dataset; absent while actively sanctioned"
+    display_name: "Sanction End Date"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet"]
+    examples: ["2026-04-06"]
+    passive: true
+
+  - name: "last_fetched"
+    type: string
+    description: "ISO 8601 date of the last dataset snapshot in which this entity or relationship was present"
+    display_name: "Last Fetched"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "physical_asset", "political_position", "location", "article"]
+    examples: ["2026-04-09"]
     passive: true
 
   - name: "address"
     type: string
-    description: "Physical address of the sanctioned organization as stated in the sanctions listing"
+    description: "Physical street address of the entity"
     display_name: "Address"
     mergeability: not_mergeable
-    domain_flavors: ["organization"]
+    domain_flavors: ["organization", "legal_entity"]
     passive: true
 
-  - name: "sector"
+  - name: "sanction_sector"
     type: string
     description: "Business sector or industry classification of the sanctioned organization"
-    display_name: "Sector"
+    display_name: "Sanction Sector"
     mergeability: not_mergeable
     domain_flavors: ["organization"]
     examples: ["Energy", "Banking", "Defense"]
     passive: true
 
+  # Vessel properties
+  - name: "imo_number"
+    type: string
+    description: "IMO number of the vessel"
+    display_name: "IMO Number"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    examples: ["IMO9553359"]
+    passive: true
+
+  - name: "mmsi"
+    type: string
+    description: "Maritime Mobile Service Identity of the vessel"
+    display_name: "MMSI"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    passive: true
+
+  - name: "callsign"
+    type: string
+    description: "Radio call sign of the vessel"
+    display_name: "Call Sign"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    passive: true
+
+  - name: "shipAndCargoType"
+    type: string
+    description: "Type classification of the vessel"
+    display_name: "Ship / Cargo Type"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    examples: ["General cargo/multipurpose", "Oil tanker"]
+    passive: true
+
+  - name: "grossTonnage"
+    type: float
+    description: "Gross registered tonnage of the vessel"
+    display_name: "Gross Tonnage"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    passive: true
+
+  # Aircraft properties
+  - name: "serial_number"
+    type: string
+    description: "Manufacturer serial number of the aircraft"
+    display_name: "Serial Number"
+    mergeability: not_mergeable
+    domain_flavors: ["aircraft"]
+    passive: true
+
+  - name: "tailNumber"
+    type: string
+    description: "Registration number (tail number) of the aircraft"
+    display_name: "Tail Number"
+    mergeability: not_mergeable
+    domain_flavors: ["aircraft"]
+    passive: true
+
+  - name: "model"
+    type: string
+    description: "Aircraft model"
+    display_name: "Model"
+    mergeability: not_mergeable
+    domain_flavors: ["aircraft"]
+    examples: ["Gulfstream 200", "Boeing 737"]
+    passive: true
+
+  # Security properties
+  - name: "isin"
+    type: string
+    description: "International Securities Identification Number (ISO 6166) uniquely identifying this financial instrument"
+    display_name: "ISIN"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "cusip_number"
+    type: string
+    description: "CUSIP identifier for the security"
+    display_name: "CUSIP Number"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "ticker"
+    type: string
+    description: "Primary stock ticker symbol"
+    display_name: "Ticker"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "currency"
+    type: string
+    description: "Currency denomination of the security or crypto wallet"
+    display_name: "Currency"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument", "crypto_wallet"]
+    passive: true
+
+  - name: "figi"
+    type: string
+    description: "Financial Instrument Global Identifier (Bloomberg OpenFIGI)"
+    display_name: "FIGI"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  # issuer is modeled as the instrument_issuer relationship (see relationships section)
+
+  # CryptoWallet properties
+  - name: "public_key"
+    type: string
+    description: "Blockchain public key or wallet address"
+    display_name: "Public Key"
+    mergeability: not_mergeable
+    domain_flavors: ["crypto_wallet"]
+    passive: true
+
+  # Document properties
+  - name: "document_number"
+    type: string
+    description: "Passport or identity document number"
+    display_name: "Document Number"
+    mergeability: not_mergeable
+    domain_flavors: ["identity_document"]
+    passive: true
+
+  - name: "document_country"
+    type: string
+    description: "Issuing country of the identity document"
+    display_name: "Document Country"
+    mergeability: not_mergeable
+    domain_flavors: ["identity_document"]
+    passive: true
+
+  # Article properties
+  - name: "title"
+    type: string
+    description: "Title of the entity"
+    display_name: "Title"
+    mergeability: not_mergeable
+    domain_flavors: ["article"]
+    passive: true
+
+  - name: "published_at"
+    type: string
+    description: "Publication date of the article"
+    display_name: "Published At"
+    mergeability: not_mergeable
+    domain_flavors: ["article"]
+    passive: true
+
+  # Sanction program properties
+  - name: "program_description"
+    type: string
+    description: "Description of the sanctions program and its legal basis"
+    display_name: "Program Description"
+    mergeability: not_mergeable
+    domain_flavors: ["sanction_program"]
+    passive: true
+
+  - name: "program_url"
+    type: string
+    description: "URL of the official sanctions program page"
+    display_name: "Program URL"
+    mergeability: not_mergeable
+    domain_flavors: ["sanction_program"]
+    passive: true
+
+  - name: "program_issuer"
+    type: string
+    description: "Government body or authority that administers the sanctions program"
+    display_name: "Program Issuer"
+    mergeability: not_mergeable
+    domain_flavors: ["sanction_program"]
+    passive: true
+
+  - name: "program_measures"
+    type: string
+    description: "Type of sanctions measures imposed by the program, one atom per measure"
+    display_name: "Program Measures"
+    mergeability: not_mergeable
+    domain_flavors: ["sanction_program"]
+    passive: true
+
 relationships:
   - name: "sanction_program"
     description: "Links a sanctioned entity to the sanctions program under which it is designated"
     display_name: "Sanction Program"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
-    target_flavors: ["sanction_program"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "location", "physical_asset"]
+    target_flavors: ["sanction_program", "organization"]
+    passive: true
+
+  - name: "flag"
+    description: "Links a vessel to its flag state country"
+    display_name: "Flag"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    target_flavors: ["location"]
     passive: true
 
   - name: "country"
     description: "Links a sanctioned organization to its associated country"
     display_name: "Country"
     mergeability: not_mergeable
-    domain_flavors: ["organization"]
-    target_flavors: ["country"]
+    domain_flavors: ["organization", "legal_entity", "ship", "financial_instrument", "physical_asset", "political_position"]
+    target_flavors: ["location"]
+    passive: true
+
+  - name: "owns"
+    description: "A person or organization owns or controls another organization or location (such as real estate)."
+    display_name: "Owns"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity"]
+    target_flavors: ["organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "physical_asset", "location"]
+    passive: true
+
+  - name: "is_director"
+    description: "A person or entity is on the board of directors of an organization. Not to be used for heads of organizations."
+    display_name: "Is Director"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity", "organization"]
+    target_flavors: ["organization", "legal_entity"]
+    passive: true
+
+  - name: "holds_political_position"
+    description: "Links a politically exposed person to the position they hold"
+    display_name: "Holds Political Position"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["political_position"]
+    passive: true
+
+  - name: "is_holder"
+    description: "Links a person to an identity document (passport, national ID)"
+    display_name: "Is Holder"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["identity_document"]
+    passive: true
+
+  - name: "instrument_issuer"
+    description: "Links a financial instrument to the organization that issued it"
+    display_name: "Instrument Issuer"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    target_flavors: ["organization", "legal_entity"]
+    passive: true
+
+  - name: "appears_in"
+    description: "An entity or event appears in a source document"
+    display_name: "Appears In"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity"]
+    target_flavors: ["article"]
+    passive: true
+
+  - name: "family_member"
+    description: "Links a person to a family member (spouse, parent, child, sibling)"
+    display_name: "Family Member"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["person", "legal_entity"]
+    passive: true
+
+  - name: "associated_with"
+    description: "A generic association between two entities, from UnknownLink or Associate schemas"
+    display_name: "Associated With"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "physical_asset"]
+    target_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "physical_asset"]
+    passive: true
+
+  - name: "succeeds"
+    description: "Links a successor entity to its predecessor (positions or organizations)"
+    display_name: "Succeeds"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "political_position"]
+    target_flavors: ["person", "organization", "legal_entity", "political_position"]
+    passive: true
+
+  - name: "represents"
+    description: "A person or entity legally or diplomatically represents another entity"
+    display_name: "Represents"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity"]
+    target_flavors: ["person", "organization", "legal_entity"]
+    passive: true
+
+  - name: "is_member"
+    description: "A person is a member of an organization"
+    display_name: "Is Member"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["organization", "legal_entity"]
+    passive: true
+
+  - name: "employed_by"
+    description: "A person is employed by an organization"
+    display_name: "Employed By"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["organization", "legal_entity"]
+    passive: true
+
+  - name: "paid"
+    description: "One entity made a payment to another"
+    display_name: "Paid"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "physical_asset"]
+    target_flavors: ["person", "organization", "legal_entity", "physical_asset"]
+    passive: true
+
+  - name: "owes_debt"
+    description: "One entity owes a debt to another"
+    display_name: "Owes Debt"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "physical_asset"]
+    target_flavors: ["person", "organization", "legal_entity", "physical_asset"]
+    passive: true
+
+attributes:
+  - property: "sanction_program"
+    name: "authority"
+    type: string
+    description: "Name of the sanctioning authority"
+    display_name: "Authority"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "reason"
+    type: string
+    description: "Reason(s) for the sanctions designation"
+    display_name: "Reason"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "listing_date"
+    type: string
+    description: "Date when the entity was listed under this program"
+    display_name: "Listing Date"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "start_date"
+    type: string
+    description: "Start date of the sanctions measures"
+    display_name: "Start Date"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "end_date"
+    type: string
+    description: "End date of the sanctions measures, if lifted"
+    display_name: "End Date"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "status"
+    type: string
+    description: "Current status of the designation"
+    display_name: "Status"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "provisions"
+    type: string
+    description: "Legal provisions under which the entity is designated"
+    display_name: "Provisions"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "summary"
+    type: string
+    description: "Summary of the sanctions designation"
+    display_name: "Summary"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "family_member"
+    name: "relationship_type"
+    type: string
+    description: "Type of family relationship (e.g. spouse, child, parent, sibling)"
+    display_name: "Relationship Type"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "associated_with"
+    name: "role"
+    type: string
+    description: "Role or nature of the association"
+    display_name: "Role"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "associated_with"
+    name: "relationship_type"
+    type: string
+    description: "Type of association (e.g. partner in business, significant person)"
+    display_name: "Relationship Type"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "represents"
+    name: "role"
+    type: string
+    description: "Nature of the representation (e.g. lawyer, diplomat)"
+    display_name: "Role"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "is_member"
+    name: "role"
+    type: string
+    description: "Role within the organization"
+    display_name: "Role"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "employed_by"
+    name: "role"
+    type: string
+    description: "Job title or role"
+    display_name: "Role"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "paid"
+    name: "summary"
+    type: string
+    description: "Description of the payment"
+    display_name: "Summary"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "owes_debt"
+    name: "summary"
+    type: string
+    description: "Description of the debt"
+    display_name: "Summary"
+    mergeability: not_mergeable
     passive: true

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