Skip to content

feat: Supply Chain + Consumer Demand Intelligence (cross-industry exp… - #16

Merged
lnanology merged 3 commits into
mainfrom
feat/supply-chain-consumer-demand-intelligence
Aug 31, 2026
Merged

feat: Supply Chain + Consumer Demand Intelligence (cross-industry exp…#16
lnanology merged 3 commits into
mainfrom
feat/supply-chain-consumer-demand-intelligence

Conversation

@lnanology

Copy link
Copy Markdown
Owner

…ansion #2 and #3)

Closes out the 3-part cross-industry expansion (real estate was #1, shipped 2026-08-30). Both new modules follow the same pattern as real_estate_service.py: FRED national indicators paired with an explicit ticker map of names/sectors with a real, direct linkage -- None for any unmapped ticker, never a fabricated reading.

  • services/supply_chain_service.py: inventory/sales ratio, manufacturing new orders, durable goods orders, industrial production, manufacturing employment -- mapped to freight carriers, railroads, logistics, and 2 transportation ETFs. New GET /v1/supply-chain/{ticker}.

  • services/consumer_demand_service.py: retail sales, personal consumption expenditures, durable goods consumption -- mapped to large retailers, e-commerce, and 2 consumer-discretionary ETFs. New GET /v1/consumer-demand/{ticker}. Deliberately NOT Google Trends search-interest data -- no officially licensed, commercial-use-safe search-trends API exists (see that module's docstring); real FRED consumer-spending data is a more reliable proxy for the same question at zero legal risk. Also explicitly excludes UMCSENT (University of Michigan Consumer Sentiment) despite being on FRED, since it carries a third-party copyright notice per FRED's own terms -- verified by direct fetch of fred.stlouisfed.org/series/UMCSENT before excluding it.

All FRED series IDs verified live via direct fetch of their FRED series pages before use (ISRATIO, AMTMNO, DGORDER, IPMAN, MANEMP, RSAFS, RSXFS, PCE, PCEDG) -- all Census Bureau/BEA sourced, 'Public Domain: Citation Requested', no third-party copyright marker.

Also: wired both into intelligence status, changelog, PUBLIC_INTEL_PATHS, quota weights (2 each, same tier as real_estate/agriculture/energy), and 2 new scheduler pre-warm jobs (03:20, 03:25 UTC).

…ansion #2 and #3)

Closes out the 3-part cross-industry expansion (real estate was #1,
shipped 2026-08-30). Both new modules follow the same pattern as
real_estate_service.py: FRED national indicators paired with an
explicit ticker map of names/sectors with a real, direct linkage --
None for any unmapped ticker, never a fabricated reading.

- services/supply_chain_service.py: inventory/sales ratio, manufacturing
  new orders, durable goods orders, industrial production, manufacturing
  employment -- mapped to freight carriers, railroads, logistics, and
  2 transportation ETFs. New GET /v1/supply-chain/{ticker}.

- services/consumer_demand_service.py: retail sales, personal
  consumption expenditures, durable goods consumption -- mapped to
  large retailers, e-commerce, and 2 consumer-discretionary ETFs. New
  GET /v1/consumer-demand/{ticker}. Deliberately NOT Google Trends
  search-interest data -- no officially licensed, commercial-use-safe
  search-trends API exists (see that module's docstring); real FRED
  consumer-spending data is a more reliable proxy for the same question
  at zero legal risk. Also explicitly excludes UMCSENT (University of
  Michigan Consumer Sentiment) despite being on FRED, since it carries
  a third-party copyright notice per FRED's own terms -- verified by
  direct fetch of fred.stlouisfed.org/series/UMCSENT before excluding it.

All FRED series IDs verified live via direct fetch of their FRED series
pages before use (ISRATIO, AMTMNO, DGORDER, IPMAN, MANEMP, RSAFS, RSXFS,
PCE, PCEDG) -- all Census Bureau/BEA sourced, 'Public Domain: Citation
Requested', no third-party copyright marker.

Also: wired both into intelligence status, changelog, PUBLIC_INTEL_PATHS,
quota weights (2 each, same tier as real_estate/agriculture/energy), and
2 new scheduler pre-warm jobs (03:20, 03:25 UTC).
@vercel

vercel Bot commented Aug 31, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
finlab-ai Ready Ready Preview Aug 31, 2026 3:17am

real-estate shipped 2026-08-30 without doc/SDK coverage; closing that
gap together with the two endpoints in this same branch.

- intelligence-api.html: 3 new endpoint cards (schema docs, response
  fields, coverage lists) + 3 new try-it-now console options.
- services/i18n.py: 9 new i18n keys x 47 languages (ia_ep18/19/20
  name+desc, 3 schema notes) -- English text in every language block,
  matching this file's existing convention that developer-facing API
  doc strings (ia_ prefix) stay English-only, unlike the consumer-app
  strings that got full per-language translation in the mixed-language
  audit.
- sdk/python + sdk/js: real_estate()/realEstate(), supply_chain()/
  supplyChain(), consumer_demand()/consumerDemand() methods, same shape
  as the existing agriculture()/energy() methods.
Found while proposing promotion next steps -- the count was stale since
before this session even started (already ~20 endpoints, said seven).
Updated the static HTML default, the English i18n entry, and the 3
Chinese variants (zh-TW/zh-HK/zh-CN, AJ's primary audience). The other
44 languages' ia_hero_p still say 'Seven ...' in their own language --
known gap, not silently left unflagged; full retranslation to match is
a separate follow-up if wanted, out of scope for this pass.
@lnanology
lnanology merged commit a0cdd51 into main Aug 31, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant