# NicotineWire — Full Technical & Regulatory Documentation (llms-full.txt)

> Comprehensive data schema, API specifications, and statutory guidelines for NicotineWire™, operated by Half Radiation, LLC (Delaware, USA).

This document serves as the complete machine-readable index for Large Language Models, AI research assistants (Perplexity, ChatGPT, Claude, Gemini), algorithmic trading engines, and enterprise software integrators.

---

## 1. System Architecture & Technical Specifications

### Full-Text Search Engine: Tantivy (Rust)
- **Engine**: quickwit-oss/tantivy-py (v0.27.0)
- **Algorithm**: BM25 scoring with exact term matching bonuses
- **Latency**: Sub-5ms query resolution
- **Index Fields**:
  - `id`: Unique record identifier (e.g. `sec_PM_2026-10-21`, `fed_2026-21027`, `sku_ZYN`)
  - `title`: Document or docket title
  - `body`: Full summary text, regulatory scope, or filing abstract
  - `category`: Source class (`SEC EDGAR`, `Federal Register`, `SKU Compliance`, `Industry Wire`)
  - `urgency`: Priority indicator (`CLEAR_TO_SHIP`, `IMMEDIATE_HOLD`, `HIGH`, `NOTICE`, `INFO`)
  - `source`: Upstream URL or internal API route
  - `date`: Publication date (ISO 8601 `YYYY-MM-DD`)

### SEC EDGAR Ingestion Pipeline
- **Library**: `dgunning/edgartools` (v5.62.0)
- **User-Agent Identity**: `NicotineWire Research Terminal research@nicotinewire.com`
- **Monitored Tickers**:
  - `PM`: Philip Morris International Inc. (ZYN oral pouch shipments, Swedish Match US/EU operations, IQOS market expansion)
  - `MO`: Altria Group, Inc. (Helix Innovations on! pouches, NJOY FDA Marketing Granted Orders)
  - `BTI`: British American Tobacco p.l.c. (VELO modern oral pouches, Reynolds American vapor compliance)
  - `TPB`: Turning Point Brands, Inc. (FRE synthetic pouches, white pouch volume telemetry)
- **Target Filings**: Form 8-K, Form 6-K, Form 10-Q, Form 10-K, Item 2.02 (Results of Operations and Financial Condition), Exhibit 99.1 Press Releases.

### Telemetry & Alerting Dispatch Architecture
- **Human Alerting (Tier 2 - $399/mo)**: Powered by Apprise multi-channel dispatcher. Formats high-urgency operational text notices and broadcasts to Slack incoming webhooks, Microsoft Teams Connectors, Discord channels, and Twilio SMS within 400ms of state directory modifications.
- **Machine & ERP Webhooks (Tier 3 - $1,999/mo)**: Powered by Svix webhooks-as-a-service. Streams cryptographic HMAC-SHA256 signed JSON events directly into customer ERP endpoints (SAP S/4HANA, Oracle NetSuite, Fishbowl, AWS Lambda) with guaranteed exponential backoff retries and self-serve customer delivery log replay.

---

## 2. API Reference & Data Payloads

### GET /api/v1/compliance/check?brand={brand}
Evaluates the multi-jurisdiction compliance status of a specific brand.

```json
{
  "brand": "Geek Bar",
  "manufacturer": "Shenzhen Weiika Technology Co., Ltd.",
  "overall_status": "NON_COMPLIANT",
  "erp_action": "IMMEDIATE_HOLD_AND_QUARANTINE",
  "federal_enforcement": {
    "summary": "Warning Letter FDA-CTP-WL-2026-0891 (Aug 22, 2026)",
    "import_alert_active": true,
    "cmp_liability_per_day": 20678
  },
  "state_registries": {
    "by_state": {
      "FL": { "status": "DELISTED", "delisting_reason": "Unlawful marketing; removed from DBPR certified list" },
      "NC": { "status": "DELISTED", "delisting_reason": "No timely PMTA certification on file with NCDOR" },
      "LA": { "status": "SEIZURE", "delisting_reason": "Active ATC retail inventory confiscation directive" }
    }
  }
}
```

### GET /api/v1/compliance/export/erp?format=csv
Generates a live, RFC 4180 compliant CSV export formatted specifically for warehouse inventory software to block pick-list label printing.

**Headers:**
`sku,brand,upc,state,status,effective_action,statute_cmp_per_day,last_verified_utc`

**Sample Rows:**
```csv
ZYN-6MG-SPM,ZYN,028400041128,FL,COMPLIANT,CLEAR_TO_SHIP,0,2026-10-22T07:00:00Z
ZYN-6MG-SPM,ZYN,028400041128,NC,COMPLIANT,CLEAR_TO_SHIP,0,2026-10-22T07:00:00Z
ZYN-6MG-SPM,ZYN,028400041128,LA,COMPLIANT,CLEAR_TO_SHIP,0,2026-10-22T07:00:00Z
GB-PLS-15K-WAT,Geek Bar,697421890123,FL,DELISTED,IMMEDIATE_HOLD_AND_QUARANTINE,20678,2026-10-22T07:00:00Z
GB-PLS-15K-WAT,Geek Bar,697421890123,NC,DELISTED,IMMEDIATE_HOLD_AND_QUARANTINE,20678,2026-10-22T07:00:00Z
GB-PLS-15K-WAT,Geek Bar,697421890123,LA,SEIZURE,IMMEDIATE_HOLD_AND_QUARANTINE,20678,2026-10-22T07:00:00Z
```

### GET /api/terminal-search?q={query}
BM25 full-text query engine returning ranked federal dockets and SEC corporate filings.

```json
{
  "engine": "Tantivy (Rust / quickwit-oss/tantivy-py v0.27.0)",
  "query": "TPSAC",
  "count": 1,
  "results": [
    {
      "id": "fed_2026-21027",
      "title": "[FDA CTP] Request for Nominations for Voting Members on TPSAC",
      "body": "FDA Center for Tobacco Products vacancies for advisory committee reviewing PMTA applications...",
      "category": "Federal Register",
      "urgency": "NOTICE",
      "source": "https://www.federalregister.gov/documents/2026/10/15/2026-21027/request-for-nominations-for-voting-members-on-a-public-advisory-committee-tobacco-products",
      "date": "2026-10-15",
      "score": 8.421
    }
  ]
}
```

---

## 3. Statutory Authority & Enforcement Rules

1. **Section 910 of the Federal Food, Drug, and Cosmetic Act (21 U.S.C. 387j)**:
   Mandates premarket authorization for any new tobacco product commercialized after February 15, 2007. Non-authorized products are deemed adulterated under Section 902 and misbranded under Section 903.
2. **Civil Money Penalty (CMP) Inflation Adjustments (21 CFR Part 17)**:
   The maximum civil penalty levied by the Center for Tobacco Products for distributing unauthorized deemed tobacco products is indexed annually for inflation, currently set at **$20,678 per violation per day**, up to statutory maximums exceeding $1,000,000 for ongoing violations.
3. **FDA Red List Detention (Import Alert #99-43)**:
   Products originating from overseas facilities listed on Import Alert #99-43 are detained at all United States ports of entry without physical examination. Importers bear the burden of demonstrating authorization before customs release.
4. **State Directory Statutes (Florida DBPR Section 569.32 et seq., Louisiana R.S. 26:926, North Carolina G.S. 14-401.18A)**:
   State statutes impose affirmative legal obligations on licensed distributors: shipping any brand not listed on the state directory constitutes grounds for immediate physical seizure of goods, revocation of state wholesale tobacco license, and statutory fines of $1,000 to $10,000 per shipment.

---

## 4. Corporate & Legal Disclaimers

- **Operator**: Half Radiation, LLC, a Delaware limited liability company.
- **Governing Law**: State of Delaware, United States.
- **No Legal Counsel**: NicotineWire is an automated informational intelligence tool. None of the data feeds, directory scrapes, or alerts constitute formal legal counsel. Customers must independently verify state directories prior to physical transport.
- **Limitation of Liability**: Half Radiation, LLC's aggregate liability under any contract is strictly capped at the amount paid by the customer in the preceding 12 months or $100.