SEC Regulatory Publication Catalog

The supported minimal query selects the bounded current SEC publication catalog without depending on one item remaining on a rolling overview. The catalog remains inventory-bound: current SEC table and collection listings are parsed only at the fourteen declared official endpoints.

Current executable sources are the dated SEC listings. Staff Guidance, Investor Alerts, and Distributions overviews are retained as visible partial coverage because their current official pages do not expose attributable dated rows; the Actor does not infer dates or crawl linked detail pages.

Local Packages 1–4 implementation for the planned SEC Complete Data Suite coverage actor sec.regulatory.publication.catalog.

The future actor will normalize explicitly inventoried public non-EDGAR SEC publications. Package 2 includes deterministic, offline HTML/Atom listing parsers, normalization, reconciliation, source anchors, source-attributed minimized fixtures, and hard supplied-body/record limits. Package 3 adds a bounded, inventory-only SEC HTTP client, resolver, deterministic service, and stateless cursor. Its tests use httpx.MockTransport and fakes only; the default suite makes no SEC request. Package 4 adds the native Apify lifecycle: it validates input before constructing transport, pushes only validated secRegulatoryPublication Dataset records, and always writes schema-valid SUMMARY and ERRORS KVS values. Persisted errors use fixed sanitized text; they never include raw input, source bodies, exception messages, or URLs.

Local planned pay-per-event configuration has no events. The adapter makes no charge calls and records an empty event map plus exact 0.000000 estimates in every SUMMARY. This is not Cloud pricing configuration and does not authorize publication or a price change. Package 5 remains the independent local release review; lifecycle status remains planned.

The executable local contract is in ./.actor/. Scope and staged implementation are documented in ./docs/implementation-spec.md.

Local development

Python 3.13 is required. The Docker entry point is python -m sec_regulatory_publication_catalog.

PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=src:vendor \
  ../sec-8k-event-normalizer/.venv/bin/python -m pytest
apify validate-schema