SEC Official Dataset Rows

Local Package-4 C07 capability sec.official.dataset.rows. It streams bounded, typed rows from an explicitly versioned public SEC Data Library or DERA dataset table without domain-specific interpretation. It accepts no user URL, does not crawl broadly or invoke a sibling Actor. Each secOfficialDatasetRow preserves the source column names and typed values in data.fields, while normalized contains only safe cross-dataset identifiers such as CIK, accession, date, form, and file number.

Packages 1–4 supply the executable contract, Pydantic models, parser, inventory-bound resolver, exact-artifact HTTPX client, stateless cursor, service, native Apify adapter and offline tests. The adapter writes only schema-valid Dataset rows plus bounded SUMMARY and ERRORS values. It stores fixed, sanitized error messages and creates no charge event.

The public input intentionally has no C06 record or URL. The native adapter does not import, invoke, or read C06 at runtime. Its in-code registry currently supports only financial-statement-data-sets:2026-03-31, table sub, with the exact SEC 2026 Q1 archive and member sub.txt; all other version/table pairs fail closed as DATASET_UNMAPPED before a fetch. The registry is derived from the official Financial Statement Data Sets README/data dictionary and carries the ordered schema fingerprint and natural key. There is no archive discovery or caller-controlled locator.

The eventual reader is limited to 50,000 rows, 250 MiB compressed input, 1 GiB uncompressed input, and 1,000 SEC source requests per run. It will stream only known archive files, reject traversal and archive-limit hazards, apply typed filters during streaming, and retain valid rows on bounded per-row failures.

No Cloud action or pricing configuration is performed by the tests. A bounded manual SEC preflight is documented in the handover; the normal test suite is offline. See the docs/implementation-spec.md and docs/test-plan.md. Example input: examples/input-minimal.json.