gloomberb 0.15.7 → 0.16.0

package/README.md

@@ -75,7 +75,14 @@ Press `Ctrl+P` to open the command bar, or press `` ` `` to search for a ticker.
 | `OPX SPY` / `GEX SPY` | Open interest by strike and expiry, max pain and dealer gamma ([method](docs/options-positioning.md)) |
 | `HVG AAPL` / `HVT AAPL` | Realized volatility and volatility cones |
 | `SEAS AAPL` | Seasonality: monthly returns by year and year overlays |
+| `RDCF AAPL` | Reverse DCF: the cash flow growth the price assumes |
+| `PEB AAPL` | P/E band: price against multiples of trailing EPS, and today's P/E in its own history |
+| `SIW` | Short squeeze watch: crowded shorts in your portfolios and watchlists that are moving up |
+| `RIPL` | Earnings Ripple: customers and suppliers of your holdings that report soon |
+| `MDAY SPY` | Macro-day reaction: how a name moves on CPI, jobs and FOMC days against a normal day |
 | `COT [code or root]` | CFTC positioning and cross-market extremes |
+| `DOE` / `NGS` | EIA weekly oil stocks and gas storage, with builds, draws and five-year ranges |
+| `CPI [component]` / `ECAN` | US consumer prices by component, with weights, contributions to the headline and the next release |
 | `TOP` | Market stories |
 | `WIRP` / `FFIP` | US rate path and conditional FOMC probabilities |
 | `BTMM` | Funding rates, bill curves and Federal Reserve liquidity |
@@ -83,7 +90,7 @@ Press `Ctrl+P` to open the command bar, or press `` ` `` to search for a ticker.
 | `PF` | Portfolios and watchlists |
 | `HELP` | Commands and keyboard shortcuts |
 
-Use `Tab` to switch panes and `j` / `k` to navigate lists. The [user guide](docs/usage.md) covers charts, broker setup, keyboard shortcuts, and the full command reference. See [research data conventions](docs/research-data.md) for return definitions, financial sources, and model assumptions.
+Use `Tab` to switch panes and `j` / `k` to navigate lists. The [user guide](docs/usage.md) covers charts, broker setup, keyboard shortcuts, and the full command reference. See [research data conventions](docs/research-data.md) for return definitions, financial sources, and model assumptions. [Supply chain evidence](docs/supply-chain.md) explains Pro SPLC trust tiers, source evidence, reverse relationships, flow diagrams and multi-hop graphs and path searches. [Credit documents](docs/credit-documents.md) covers CRDOC/COVN capital structure, covenant headroom and amendment evidence. [Research attention](docs/research-attention.md) covers the Pro ATTN dataset, privacy-qualified counts and Gloom Trending. [Hiring and app attention](docs/hiring-app-attention.md) covers HIRE/APPS observations, evidence and Pro previews.  [Government awards](docs/government-awards.md) covers AWARDS, procurement history and source coverage. [Distress records](docs/distress-monitor.md) covers DIST: 8-K filings, going-concern disclosures, listing designations and insolvency notices, with their dates and licences. [Power and grid capacity](docs/power-grid.md) covers POWER queues, large loads, utility exposure and source history. [Perpetual markets](docs/perpetuals.md) covers funding, open interest, premiums and Pro access.  [Exposure analysis](docs/exposure.md) covers EXPO scenario estimates, portfolio weights and evidence paths.
 
 ## CLI
 
@@ -130,10 +137,12 @@ gloomberb config set telemetry.usage false
 
 Setting `GLOOMBERB_NO_TELEMETRY=1` or `DO_NOT_TRACK=1` in the environment turns all of it off. The browser app also honours Do Not Track and Global Privacy Control.
 
+**Attention Counts are separate and off by default.** Run `Attention Counts` in the command bar and review the consent dialog to share ticker research counts for Gloom Trending. This sends ticker symbols and the kind of explicit research action only while signed in with a verified account. It does not send holdings, watchlist names, queries or an install id. Consent stays on this device; cloud sync cannot enable it elsewhere. Turn the setting off to discard unsent counts, or run `gloomberb config set telemetry.attention false`. The environment and browser opt-outs above also disable Attention Counts. See the [attention privacy review](docs/attention-privacy.md) for the authenticated collection boundary, retention, aggregation and remaining risks.
+
 ## Sponsors
 
 <a href="https://adjacent.markets/?ref=gloomberb"><img src="docs/assets/adjacent.svg" alt="Adjacent" width="56" /></a>
 
 [Adjacent](https://adjacent.markets/?ref=gloomberb) builds prediction-market indices, reference rates, and data. Thank you for backing Gloomberb's open-source work.
 
-To sponsor Gloomberb, email [hello@gloom.sh](mailto:hello@gloom.sh).
+To sponsor Gloomberb, see [gloom.sh/sponsor](https://gloom.sh/sponsor).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.15.7",
+  "version": "0.16.0",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",

package/src/api-client/app-attention.ts

@@ -0,0 +1,147 @@
+type AppStore = "app-store" | "google-play"
+export type AppChart = "free" | "paid" | "grossing" | "unranked"
+
+export interface AppAttentionFilter {
+  symbol?: string
+  country?: string
+  chart?: AppChart
+  category?: string
+  days?: number
+  limit?: number
+  offset?: number
+}
+interface AppObservation {
+  appId: string
+  name: string
+  developer: string
+  developerId: string | null
+  appUrl: string
+  genres: string[]
+  genreIds: string[]
+  rank: number | null
+  rating: number | null
+  ratingCount: number | null
+  reviewCount: number | null
+  ratingObservedAt: string | null
+  ratingSourceUrl: string | null
+  symbol: string | null
+  exchange: string | null
+  entityId: string | null
+  parentEntityId: string | null
+  confidence: number
+  mappingSourceUrl: string | null
+  mappingRevisionId: string | null
+}
+interface AppStoredRow extends AppObservation {
+  sourceId: string
+  store: AppStore
+  country: string
+  chart: AppChart
+  category: string
+  chartLimit: number
+  sourceUrl: string
+  sourceUpdatedAt: string | null
+  observedAt: string
+  revisionId: string
+  supersedesRevisionId: string | null
+}
+interface AppAttentionRow extends AppStoredRow {
+  rankChange1d: number | null
+  rankChange7d: number | null
+  rankVelocity7d: number | null
+  ratingChange7d: number | null
+  ratingCountGrowth7d: number | null
+  reviewGrowth7d: number | null
+  stale: boolean
+}
+export interface AppCompany {
+  symbol: string
+  name: string
+  appCount: number
+  countryCount: number
+  chartCount: number
+  attentionScore: number | null
+  rankVelocity7d: number | null
+  ratingChange7d: number | null
+  ratingCountGrowth7d: number | null
+  comparableSeries7d: number
+  observedAt: string
+}
+interface AppHistoryPoint {
+  date: string
+  attentionScore: number | null
+  appCount: number
+  countryCount: number
+  seriesCount: number
+  rating: number | null
+  ratingCount: number | null
+  reviewCount: number | null
+}
+interface AppCountry {
+  country: string
+  appCount: number
+  rankedApps: number
+  attentionScore: number | null
+  rankVelocity7d: number | null
+  observedAt: string
+}
+interface AppSourceState {
+  sourceId: string
+  lastAttemptAt: string | null
+  lastOkAt: string | null
+  nextPollAt: string | null
+  failures: number
+  lastError: string | null
+  captures: number
+}
+export interface AppAttentionPayload {
+  generatedAt: string
+  requestedSymbol?: string
+  page?: { offset: number; limit: number; total: number; nextOffset: number | null }
+  symbol: string | null
+  access: "pro" | "preview"
+  status: "ready" | "collecting" | "unavailable"
+  summary: {
+    appCount: number
+    companyCount: number
+    countryCount: number
+    observationCount: number
+    mappedObservationCount: number
+    attentionScore: number | null
+    rankVelocity7d: number | null
+    ratingChange7d: number | null
+    ratingCountGrowth7d: number | null
+    comparableSeries7d: number
+    firstObservedAt: string | null
+    lastObservedAt: string | null
+  }
+  apps: AppAttentionRow[]
+  companies: AppCompany[]
+  peers: AppCompany[]
+  countries: AppCountry[]
+  history: AppHistoryPoint[]
+  spreads: Array<{ appId: string; name: string; chart: AppChart; category: string; bestCountry: string; bestRank: number; worstCountry: string; worstRank: number; spread: number; countryCount: number }>
+  evidence: Array<{ revisionId: string; supersedesRevisionId: string | null; sourceId: string; sourceUrl: string; observedAt: string; sourceUpdatedAt: string | null; appId: string; name: string; country: string; chart: AppChart; rank: number | null; rating: number | null; ratingCount: number | null; reviewCount: number | null; ratingSourceUrl: string | null; mappingSourceUrl: string | null; confidence: number }>
+  coverage: {
+    configuredCountries: string[]
+    observedCountries: string[]
+    availableCharts: AppChart[]
+    categories: string[]
+    sources: AppSourceState[]
+    limitations: string[]
+    historyDays: number
+    staleAfterHours: number
+  }
+  locked: { apps: number; companies: number; peers: number; countries: number; history: number; spreads: number; evidence: number }
+}
+
+export interface AppRankPayload {
+  generatedAt: string;
+  access: "pro" | "preview";
+  status: "ready" | "collecting";
+  store: AppStore;
+  appId: string;
+  rankHistory: Array<{ appId: string; name: string; store: AppStore; country: string; chart: AppChart; category: string; date: string; rank: number | null; rating: number | null; ratingCount: number | null; reviewCount: number | null; observedAt: string; sourceUpdatedAt: string | null; ratingSourceUrl: string | null; present: boolean; sourceUrl: string; revisionId: string; chartLimit: number }>;
+  page: { offset: number; limit: number; total: number; nextOffset: number | null };
+  locked: number;
+}

package/src/api-client/attention.ts

@@ -0,0 +1,26 @@
+export type AttentionWindow = "now" | "today" | "week";
+export interface AttentionPoint {
+  bucketStart: string; researchUnits: number; publishedAt?: string; minimumContributors?: number;
+  rounding?: number; lagHours?: number; methodologyVersion?: number;
+}
+export interface AttentionRow {
+  symbol: string; ticker: string; exchange: string; name: string | null; country: string | null; sector: string | null;
+  rank: number; researchUnits: number; sharePct: number; zScore: number | null; baselinePeriods: number;
+  priceChangePct: number | null; relativeVolume: number | null; marketAsOf: string | null; relativeVolumeAsOf?: string | null;
+  news: Array<{ title: string; url: string; publishedAt: string }>;
+  history: AttentionPoint[];
+  evidence: { source: string; asOf: string; periodStart: string; periodEnd: string; unit: string; confidence: string; methodologyVersion: number };
+}
+export interface AttentionGroup { name: string; researchUnits: number; sharePct: number; tickers: number }
+export interface AttentionPayload {
+  generatedAt: string; asOf: string | null; window: AttentionWindow; periodStart: string; periodEnd: string;
+  status: "disabled" | "collecting" | "ready"; stale: boolean;
+  rows: AttentionRow[]; sectors: AttentionGroup[]; countries: AttentionGroup[];
+  privacy: { minimumContributors: number; rounding: number; lagHours: number; methodologyVersion: number };
+  coverage: { publishedHours: number; publishedTickers: number; baselineDays: number };
+  history?: AttentionPoint[];
+  selectedListing?: Pick<AttentionRow, "symbol" | "ticker" | "exchange" | "name" | "country" | "sector"> | null;
+  historyEvidence?: AttentionRow["evidence"] | null;
+  methodologyUrl: string; entitlement: "pro" | "preview"; truncated: boolean;
+  counts: { rows: number; sectors: number; countries: number };
+}

package/src/api-client/awards.ts

@@ -0,0 +1,215 @@
+/** Public-source financial amounts remain decimal strings through persistence and REST. */
+export type AwardType = "prime" | "subaward" | "modification" | "notice"
+interface AwardIdentifier {
+  scheme: "uei" | "duns" | "cage" | "lei" | "source" | "cik"
+  value: string
+}
+interface AwardRecipient {
+  name: string
+  identifiers?: AwardIdentifier[]
+  country?: string | null
+}
+export interface AwardInput {
+  source: string
+  sourceAwardId: string
+  sourceRevisionId?: string | null
+  jurisdiction: string
+  awardType: AwardType
+  awardStatus?: string | null
+  title: string
+  description?: string | null
+  awardDate: string
+  dateBasis?: "award" | "publication" | "period-start"
+  dataBasis?:
+    | "api-award"
+    | "api-search"
+    | "api-combined"
+    | "bulk-latest-transaction"
+    | "bulk-transaction"
+    | "api-transaction"
+    | "combined-transaction"
+  dataEffectiveDate?: string
+  fieldAsOf?: Record<string, string>
+  fieldSourceUrls?: Record<string, string>
+  periodStart?: string | null
+  periodEnd?: string | null
+  fiscalYear?: number | null
+  currency: string
+  /** Cumulative award obligation. Never sum this with transaction flows. */
+  obligatedAmount?: string | null
+  ceilingAmount?: string | null
+  /** Face value for awards; action amount for modification records. */
+  awardAmount?: string | null
+  recipient: AwardRecipient
+  agency: { id?: string | null; name: string; parentName?: string | null }
+  parentAwardId?: string | null
+  parentSource?: string | null
+  parentRecipient?: AwardRecipient | null
+  transactionId?: string | null
+  modificationNumber?: string | null
+  actionType?: string | null
+  classifications?: { scheme: string; code: string; label?: string }[]
+  naics?: string | null
+  psc?: string | null
+  sector?: string | null
+  placeOfPerformance?: {
+    country?: string | null
+    region?: string | null
+    city?: string | null
+  } | null
+  sourceUrl: string
+  publishedAt?: string | null
+  sourceUpdatedAt?: string | null
+  evidenceQuote?: string | null
+  confidence?: number
+  rawPayload?: unknown
+}
+interface AwardEntityMatch {
+  ticker: string
+  exchange: string | null
+  legalName: string
+  parentName: string | null
+  cik: string | null
+  method: "identifier" | "legal-name" | "verified-alias"
+  evidenceUrl: string
+  confidence: number
+}
+export interface AwardRow extends AwardInput {
+  id: string
+  revisionId: string
+  observedAt: string
+  entity: AwardEntityMatch | null
+  revenueComparison: AwardRevenueComparison | null
+}
+interface AwardRevenueComparison {
+  awardAmount: string
+  annualRevenue: string
+  currency: string
+  periodStart: string
+  periodEnd: string
+  filedAt: string
+  sourceUrl: string
+  percent: number
+  basis: "award-value" | "obligated"
+}
+export interface AwardFilter {
+  ticker?: string
+  parentId?: string
+  jurisdiction?: string
+  agency?: string
+  sector?: string
+  source?: string
+  awardType?: AwardType
+  currency?: string
+  from?: string
+  to?: string
+  fiscalYear?: number
+  query?: string
+  minAmount?: string
+  cursor?: string
+  limit?: number
+}
+export interface AwardAggregate {
+  source: string
+  key: string
+  label: string
+  currency: string
+  awardType: AwardType
+  count: number
+  obligatedAmount: string | null
+  ceilingAmount: string | null
+  awardAmount: string | null
+  sharePercent: number | null
+}
+export interface AwardCompanyLeader extends AwardAggregate {
+  sector: string
+  ticker: string | null
+  exchange: string | null
+}
+export interface AwardHistoryPoint {
+  source: string
+  month: string
+  currency: string
+  awardType: AwardType
+  count: number
+  obligatedAmount: string | null
+  ceilingAmount: string | null
+  awardAmount: string | null
+  cumulativeObligatedAmount: string | null
+}
+interface AwardSourceState {
+  source: string
+  enabled: boolean
+  lastAttemptAt: string | null
+  lastOkAt: string | null
+  nextPollAt: string | null
+  failures: number
+  lastError: string | null
+  cursor: string | null
+  coverageStart: string | null
+  coverageEnd: string | null
+  coverageComplete: boolean
+  records: number
+  requestsToday: number
+}
+interface AwardCoverage {
+  source: string
+  startDate: string
+  endDate: string
+  status: "pending" | "running" | "complete" | "failed"
+  records: number
+  pages: number
+  cursor: string | null
+  lastError: string | null
+  updatedAt: string
+}
+export interface AwardsPayload {
+  generatedAt: string
+  asOf: string | null
+  status: "available" | "partial" | "unavailable"
+  access: "full" | "preview"
+  rows: AwardRow[]
+  nextCursor: string | null
+  agencies: AwardAggregate[]
+  sectors: AwardAggregate[]
+  leaders: AwardCompanyLeader[]
+  history: AwardHistoryPoint[]
+  alerts: AwardRow[]
+  sources: AwardSourceState[]
+  coverage: AwardCoverage[]
+  gaps: string[]
+  locked: boolean
+  truncated?: {
+    agencies: boolean
+    sectors: boolean
+    history: boolean
+    leaders: boolean
+  }
+}
+interface AwardRevision {
+  id: string
+  observedAt: string
+  sourceUpdatedAt: string | null
+  supersedes: string | null
+  award: AwardInput
+}
+interface AwardEdge {
+  kind: "government-customer" | "subcontractor"
+  from: AwardRecipient
+  to: AwardRecipient
+  awardId: string
+  sourceUrl: string
+  amount: string | null
+  currency: string
+}
+export interface AwardDetailPayload {
+  nextRevisionsCursor?: string | null
+  truncated?: { revisions: boolean; subawards: boolean; modifications: boolean }
+  row: AwardRow | null
+  revisions: AwardRevision[]
+  subawards: AwardRow[]
+  modifications: AwardRow[]
+  edges: AwardEdge[]
+  access: "full" | "preview"
+  locked: boolean
+}

package/src/api-client/catalysts.ts

@@ -0,0 +1,160 @@
+type QuoteMatchMode = "exact" | "whitespace" | "normalized"
+
+export const CATALYST_TYPES = ["regulatory", "clinical", "litigation", "antitrust", "recall", "sanctions", "export_control", "tariff", "rulemaking", "approval", "advisory", "pdufa"] as const
+export type CatalystType = (typeof CATALYST_TYPES)[number]
+type DatePrecision = "day" | "month" | "year"
+interface CatalystIdentifiers {
+  cik?: string
+  lei?: string
+  isin?: string
+  tickers?: Array<{ ticker: string; exchange?: string | null }>
+  [key: string]: unknown
+}
+interface CatalystPartyInput {
+  name: string
+  role?: string
+  identifiers?: CatalystIdentifiers
+}
+interface CatalystParty extends CatalystPartyInput {
+  entityId: string | null
+  ticker: string | null
+  exchange: string | null
+  resolution: "identifier" | "alias" | "unresolved"
+  confidence: number
+}
+interface CatalystOpinion {
+  label: "Model opinion"
+  direction: "positive" | "negative" | "mixed" | "uncertain"
+  type: CatalystType
+  rationale: string
+  quote: string
+  quoteOffset: number
+  quoteSourceLength: number
+  quoteMatchMode: QuoteMatchMode
+  confidence: number
+  model: string
+  gateModel: string
+  generatedAt: string
+  promptVersion: string
+}
+interface CatalystInput {
+  source: string
+  externalId: string
+  type: CatalystType
+  agency: string
+  jurisdiction: string
+  country?: string | null
+  title: string
+  summary: string
+  status: string
+  announcedDate?: string | null
+  effectiveDate?: string | null
+  deadlineDate?: string | null
+  datePrecision?: { announced?: DatePrecision; effective?: DatePrecision; deadline?: DatePrecision }
+  parties: CatalystPartyInput[]
+  sourceUrl: string
+  sourceDocumentId?: string | null
+  language?: string
+  observedAt: string
+  sourcePublishedAt?: string | null
+  quote?: string | null
+  /** Kept privately for evidence validation and repeatable extraction. */
+  sourceText?: string
+  confidence: number
+  metadata?: Record<string, unknown>
+  sector?: string | null
+  opinion?: CatalystOpinion | null
+}
+interface CatalystChange { field: string; before: unknown; after: unknown }
+export interface CatalystEvent extends Omit<CatalystInput, "parties" | "sourceText"> {
+  id: string
+  revisionId: string
+  revision: number
+  parties: CatalystParty[]
+  announcedDate: string | null
+  effectiveDate: string | null
+  deadlineDate: string | null
+  datePrecision: NonNullable<CatalystInput["datePrecision"]>
+  country: string | null
+  sector: string | null
+  language: string
+  quote: string | null
+  quoteOffset: number | null
+  quoteSourceLength: number | null
+  quoteMatchMode: QuoteMatchMode | null
+  opinion: CatalystOpinion | null
+  changes: CatalystChange[]
+  supersedesRevisionId: string | null
+  firstSeenAt: string
+  lastSeenAt: string
+}
+export interface CatalystFilters {
+  symbol?: string
+  type?: CatalystType
+  agency?: string
+  country?: string
+  sector?: string
+  status?: string
+  source?: string
+  search?: string
+  from?: string
+  to?: string
+  dateField?: "announced" | "effective" | "deadline" | "observed" | "any"
+  upcoming?: boolean
+  changed?: boolean
+  litigation?: boolean
+  limit?: number
+  offset?: number
+}
+interface CatalystSource {
+  id: string
+  name: string
+  agency: string
+  jurisdiction: string
+  country: string
+  enabled: boolean
+  disabledReason?: string
+  homepage: string
+  termsUrl?: string
+  cadenceMinutes: number
+  coverage: string
+}
+interface CatalystSourceState {
+  source: string
+  lastOkAt: string | null
+  lastAttemptAt: string | null
+  nextPollAt: string | null
+  failures: number
+  lastError: string | null
+  cursor: string | null
+  etag: string | null
+  lastModified: string | null
+  eventsSeen: number
+}
+interface CatalystCoverage {
+  sources: Array<CatalystSource & { state: CatalystSourceState | null; events: number }>
+  totalEvents: number
+  linkedEvents: number
+  unresolvedParties: number
+  jurisdictions: string[]
+  firstObservedAt: string | null
+  lastObservedAt: string | null
+}
+export interface CatalystResponse {
+  events: CatalystEvent[]
+  total: number
+  limit: number
+  offset: number
+  asOf: string
+  filters: CatalystFilters
+  coverage: CatalystCoverage
+  facets: { types: string[]; agencies: string[]; countries: string[]; sectors: string[]; statuses: string[] }
+  access?: { pro: boolean; lockedRows: number; previewLimit: number }
+}
+export interface CatalystDetail { event: CatalystEvent; history: CatalystEvent[]; historyTotal?: number; historyTruncated?: boolean; historyOffset?: number; historyLimit?: number; historyHasMore?: boolean; asOf: string; access?: { pro: boolean; lockedRows: number; previewLimit: number } }
+export interface CatalystStatus {
+  ready: boolean
+  coverage: CatalystCoverage
+}
+
+export interface CatalystChanges extends CatalystResponse { nextCursor: string | null; hasMore: boolean }