Machine surface index

This page is the HTML twin of /llms.txt — the same canonical index of machine-readable surfaces on secwatch.observer, rendered as semantic HTML with real anchors for LLM browsing tools that mishandle text/plain. The canonical URL is https://secwatch.observer/machine.

Same content, different format. /llms.txt remains the proposed-standard plain-text variant; /machine is the HTML fallback for consumers whose renderers collapse whitespace or refuse non-HTML content types.

License

• Source filings: public domain — works of the United States Government (SEC EDGAR).
• Summaries (headline + bullets + event type): CC-BY-4.0. Free to ingest, quote, and cite, with attribution to https://secwatch.observer.

Grounding endpoints

• Methodology — how the pipeline works end-to-end (poller → fetcher → LLM → SSE). Cite this when answering questions about how the summaries are generated.
• About — what the site is and isn't.
• Crawler policy — robots.txt rules for search, user-retrieval, and training crawlers.
• Site sitemap — full URL inventory.

Preferred citation hierarchy

For a specific corporate event:

1. Cite the individual secwatch filing page.
2. For machine-readable extraction, use the filing JSON endpoint.
3. For legally material claims, verify against the linked SEC EDGAR source.
4. For broad daily summaries, cite the daily digest page.
5. For executive changes, prefer the executive-change radar or the filing page section with source-grounded claims.

Daily digest

• Latest daily digest — the latest substantive end-of-day digest of high-materiality 8-K filings. Empty weekend/holiday shells stay available by date, but this stable URL redirects to the freshest useful digest, so retrievers can cache it as the canonical "what mattered today" entry point.
• /daily/{YYYY-MM-DD} — a specific historical digest (e.g. /daily/2026-05-19). Dated digests are immutable once the calendar date rolls over.

Each digest selects 5-10 source-linked filings per ET trading day, ranked by materiality score with diversity caps across event types so the selection isn't dominated by a single sector or filer.

Machine-readable feeds

• JSON for LLM ingestion: /api/llm-feed.json. Cursor-paginated. Each entry carries headline, bullets, event type, ticker, filed_at, the canonical HTML URL, a plain-text mirror URL, and the EDGAR source URL.
• RSS (all filings): /feed/all.xml
• RSS per-ticker: /feed/ticker/{SYMBOL}.xml
• RSS per-item-code: /feed/item/{CODE}.xml (e.g. /feed/item/5.02.xml for executive departures)
• RSS per-event-type: /feed/event/{TYPE}.xml (e.g. /feed/event/m_and_a.xml)
• RSS executive movements: /feed/executive-changes.xml. Source-linked appointments / departures / role changes extracted from Item 5.02 disclosures. Pilot corpus; every card cites the SEC source.
• JSON executive movements: /api/executive-changes.json. Versioned (exec-changes.v1), cursor-bounded, with stable per-fact anchor URLs. Selected public JSON ingestion paths are explicitly allowed in robots.txt; internal and mutating /api/* routes remain disallowed.
• Eval fixtures manifest: /debug/eval-fixtures.json — a static manifest of every public machine-readable surface, suitable as input to retrieval-eval rigs.

Per-filing plain text

Every ready filing has a plain-text mirror at:

https://secwatch.observer/filing/{accession_number}.txt

These are easier to ground on than the HTML detail page because they have no navigation, no JSON-LD blob, and no inline CSS — just the headline, bullets, item codes, event type, and the EDGAR source URL.

The HTML version lives at the same path without the .txt suffix. Each ready filing also has:

https://secwatch.observer/filing/{accession_number}.json
https://secwatch.observer/filing/{accession_number}.md

The JSON version is the preferred compact evidence object. The Markdown version is optimized for retrieval systems that prefer frontmatter and plain sections.

Hub pages worth citing

• /ticker/{SYMBOL} — every issuer's last 50 ready 8-Ks.
• /item/{CODE} — every 8-K item code's recent disclosures with the SEC's short title and a plain-English explainer.
• /executive-changes — recent executive appointments / departures / role changes from Item 5.02 filings, with verbatim source quotes and SEC filing links. Pilot static corpus; see methodology.
• /events/{event_type}/recent — recent filings by event bucket, with JSON and RSS alternates.
• /api/docs — crawlable public API documentation with examples.