// CLASSIFICATION.SPEC v1

Classification contract

Canonical taxonomy enforced by /api/public/ingest/news. Fetch the JSON version at /api/public/spec/classification.

10 Signal types

Send the exact key in the flag field. Anything else is queued for admin review and not published.

๐Ÿ“ˆ IPO
IPOs & Going Public

S-1 filings, direct listings, de-SPAC, first-day pops, lockup expiries.

๐Ÿค M&A
M&A & Deals

Definitive acquisitions, takeovers, divestitures, buyouts, asset sales, structural merger closes.

๐Ÿ”— Partnership
Partnerships & Alliances

JVs, supply agreements (e.g. compute / spectrum / hardware), integrations, co-development, channel deals.

๐Ÿ’ฐ Funding
Funding & Capital Raises

Venture rounds, private debt, secondaries (private), grants, government co-investment structured as a round.

๐Ÿ›๏ธ Government & Policy
Government & Policy

Government is a PARTY: agency contract awards, export controls, sanctions, legislation, executive orders, rulemaking.

๐Ÿš€ Product
Product Launches

New product unveilings, GA releases, major version launches, hardware reveals, facility openings that ship a product.

๐Ÿ”ฌ Breakthrough
Breakthroughs & Milestones

Scientific results, clinical readouts, R&D firsts, technical world-firsts (e.g. net-positive fusion, first orbital catch).

โš–๏ธ Regulatory
Regulatory & Approvals

FDA, FAA, NRC, EU AI Act, EPA, SEC enforcement, Nasdaq compliance โ€” approvals, denials, sanctions, recalls, deadlines.

๐Ÿ“Š Earnings
Earnings & Performance

Quarterly/annual results, guidance changes, KPI disclosures, pre-announcements (SEC 8-K item 2.02).

๐Ÿ”ด Risk
Risk & Disruption

Chapter 11, going-concern, fatal incidents, disclosed-scope security breach, layoffs โ‰ฅ5%, short-seller report, federal investigation, major outage.

๐Ÿข Corporate
Corporate & Ownership

Boardroom and balance sheet: board and proxy outcomes, entity or segment changes, executive appointments and departures, dividends, buybacks, treasury purchases, credit facilities, committed capex, and 5%+ beneficial-owner or activist stakes.

๐ŸŽ–๏ธ Spotlight
Recognition & Voice

Awards, index and list placements, analyst leader positions, substantial third-party profiles, executive essays and keynotes, and community or CSR activity.

Source tiers

Required on every item. No default.

A
Primary / authoritative

Original reporting, regulatory filings, or official company disclosure.

Reuters, Bloomberg, FT, WSJ, NYT, SEC EDGAR, FDA/FAA/NRC releases, company IR, Nature, Science

B
Credible secondary

Solid trade press or analyst coverage; may aggregate Tier A but adds reporting.

TechCrunch, The Information, Axios, Ars Technica, IEEE Spectrum, SpaceNews, Endpoints, CNBC

C
Aggregator / unverified

Signal-only; requires corroboration before trusting standalone.

Substacks, Medium, Reddit, X threads, PR wires (unless original), niche blogs

Big-event criteria

Set is_big_event: true only if at least one applies. Items without structured evidence pass through but are flagged in classification_warnings.

  • DEAL_VALUE_GTE_1BDeal value โ‰ฅ $1B (M&A, funding, or contracts).
  • REGULATORY_DECISIONFinal regulatory decision on a major program (FDA approval, FAA cert, NRC license).
  • IPO_PRICINGIPO pricing or first-day trade of a tracked company.
  • FIRST_OF_KINDFirst-of-kind technical milestone (e.g. net-positive fusion, first orbital catch).
  • MARKET_MOVINGMarket-moving disclosure (>10% intraday move attributable to the event).
  • EXISTENTIAL_RISKExistential risk event (Chapter 11, fatal incident, major breach).

Hygiene notes

Codes you may include in notes[]. The server may also auto-append SINGLE_PAYWALLED_SOURCE and SINGLE_SOURCE_TIER_C.

  • SINGLE_PAYWALLED_SOURCEOnly one source and it is paywalled.
  • SINGLE_SOURCE_TIER_COnly one source and it is Tier C.
  • UNCORROBORATED_RUMORReported as rumor / not yet confirmed by primary source.
  • TRANSLATEDOriginal source not in English.