Fix coverage source inventories and preserve nested c8 counters

.agents/pm/history/ops-0c8k.jsonl

@@ -0,0 +1,5 @@
+{"hash_algorithm":"sha256","ts":"2026-09-29T20:07:47.887Z","author":"codex-coverage-inventory","author_source":"asserted","agent_harness":"codex","agent_model":"gpt-6.1-sol","agent_model_source":"probe","agent_instance":"9d2669fa650245f45ec88b84","agent_provenance":{"model":{"value":"gpt-6.1-sol","source":"probe"},"effort":{"value":"xhigh","source":"probe"},"role":{"value":"implementer","source":"argv"},"topic":null},"op":"create","patch":[{"op":"add","path":"/metadata/id","value":"ops-0c8k"},{"op":"add","path":"/metadata/title","value":"Enforce documentation for all runtime modules and internal declarations"},{"op":"add","path":"/metadata/description","value":"The existing selected-surface docstring gate passes 221 declarations across 23 runtime/tooling/template files. A separate read-only TypeScript AST presence census finds 580 documented declarations of 1879 and module docblocks on 22 of 23 files. The denominator includes named functions, classes, interfaces, type aliases, methods and signatures, properties and signatures, constructors, accessors and variable statements. Imports, parameters, tests, dependencies and generated output are excluded. Presence alone does not establish documentation quality. The public and large-body policy introduced by closed ops-073p does not enforce the full internal declaration requirement."},{"op":"add","path":"/metadata/type","value":"Issue"},{"op":"add","path":"/metadata/status","value":"open"},{"op":"add","path":"/metadata/priority","value":1},{"op":"add","path":"/metadata/tags","value":[]},{"op":"add","path":"/metadata/created_at","value":"2026-09-29T20:07:47.887Z"},{"op":"add","path":"/metadata/updated_at","value":"2026-09-29T20:07:47.887Z"},{"op":"add","path":"/metadata/author","value":"codex-coverage-inventory"},{"op":"add","path":"/metadata/estimated_minutes","value":480},{"op":"add","path":"/metadata/acceptance_criteria","value":"Define and enforce the full source module and documentable-declaration denominator; document contracts, invariants, side effects and failures for every declaration including internal APIs; prove missing internal docs fail local and CI checks without exclusions or lowered thresholds; retain explicit compatibility for the existing selected-surface analyzer"},{"op":"add","path":"/metadata/risk","value":"medium"},{"op":"add","path":"/metadata/repro_steps","value":"Run npm run docstring, then compare all authored runtime and tooling declarations against JSDoc presence using an installed TypeScript AST reader."},{"op":"add","path":"/metadata/expected_result","value":"The mandatory gate measures and enforces all authored runtime modules and internal documentable declarations."},{"op":"add","path":"/metadata/actual_result","value":"The selected-surface gate passes 221 declarations while the full presence census finds 580 of 1879 documented declarations and 22 of 23 module docblocks."},{"op":"add","path":"/metadata/component","value":"docstrings"}],"before_hash":"3cc22dff72be7b14824654a7a64ea62b04799939b2fee54c1b5f52ca60bf6df0","after_hash":"d4f4b3d9d4ffb0f257875f86b9763b01e683c3906436d738ed807b4f769bcfc9","item_hash_version":3,"message":"","context":{"agent_provenance_outcomes":{"model":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"effort":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"version":{"status":"unavailable","reason":"harness_unavailable","resolver":"ai_agent_version","rule_version":"v1"}}},"event_class":"substantive","record_hash_version":1,"record_hash":"4eba89d2b52b54c1d3aa75975abba6cd4e70822c209bb37f484ca1c7a0134f09"}
+{"hash_algorithm":"sha256","ts":"2026-09-29T20:36:20.238Z","author":"codex-coverage-inventory","author_source":"asserted","agent_harness":"codex","agent_model":"gpt-6.1-sol","agent_model_source":"probe","agent_instance":"9d2669fa650245f45ec88b84","agent_provenance":{"model":{"value":"gpt-6.1-sol","source":"probe"},"effort":{"value":"xhigh","source":"probe"},"role":null,"topic":null},"op":"note_add","patch":[{"op":"replace","path":"/metadata/updated_at","value":"2026-09-29T20:36:20.238Z"},{"op":"add","path":"/metadata/notes","value":[{"created_at":"2026-09-29T20:36:20.238Z","author":"codex-coverage-inventory","text":"Coverage review changes add two documented internal functions. Updated independent TypeScript AST presence census over the same 23 runtime/tooling/template modules is 582/1883 declarations and 22/23 module docblocks. The denominator includes named functions, classes, interfaces, aliases, methods/signatures, properties/signatures, constructors/accessors and variable statements. Presence is not semantic documentation quality. Required full coverage remains unmet."}]}],"before_hash":"d4f4b3d9d4ffb0f257875f86b9763b01e683c3906436d738ed807b4f769bcfc9","after_hash":"4a18a749684d2d76a49397549cf600c3beec68f55ba1ca8dbe181b6e02e37e2c","item_hash_version":3,"context":{"agent_provenance_outcomes":{"model":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"effort":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"version":{"status":"unavailable","reason":"harness_unavailable","resolver":"ai_agent_version","rule_version":"v1"}}},"event_class":"substantive","record_hash_version":1,"record_hash":"f601c02a4b6d4255aa4c41c630b8a6d2bac894ff64e3e55e28d801b10145641f"}
+{"hash_algorithm":"sha256","ts":"2026-09-29T20:40:19.566Z","author":"codex-coverage-inventory","author_source":"asserted","agent_harness":"codex","agent_model":"gpt-6.1-sol","agent_model_source":"probe","agent_instance":"9d2669fa650245f45ec88b84","agent_provenance":{"model":{"value":"gpt-6.1-sol","source":"probe"},"effort":{"value":"xhigh","source":"probe"},"role":{"value":"implementer","source":"argv"},"topic":null},"op":"update","patch":[{"op":"replace","path":"/metadata/actual_result","value":"The selected-surface gate passes 221 declarations while the current full presence census finds 582 of 1883 documented declarations and 22 of 23 module docblocks"},{"op":"replace","path":"/metadata/updated_at","value":"2026-09-29T20:40:19.566Z"}],"before_hash":"4a18a749684d2d76a49397549cf600c3beec68f55ba1ca8dbe181b6e02e37e2c","after_hash":"206d366b621de119c5742dce5de1c5b4583d54d7d99ce35986ea69e89e5a390e","item_hash_version":3,"message":"Refresh current documentation gap while preserving earlier measurement notes","context":{"agent_provenance_outcomes":{"model":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"effort":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"version":{"status":"unavailable","reason":"harness_unavailable","resolver":"ai_agent_version","rule_version":"v1"}}},"event_class":"maintenance","record_hash_version":1,"record_hash":"eed0c5b18304f36b5859304df992dcf17497d38595b449471563e351518647e4"}
+{"hash_algorithm":"sha256","ts":"2026-09-29T21:00:58.487Z","author":"codex-coverage-inventory","author_source":"asserted","agent_harness":"codex","agent_model":"gpt-6.1-sol","agent_model_source":"probe","agent_instance":"9d2669fa650245f45ec88b84","agent_provenance":{"model":{"value":"gpt-6.1-sol","source":"probe"},"effort":{"value":"xhigh","source":"probe"},"role":{"value":"implementer","source":"argv"},"topic":null},"op":"update","patch":[{"op":"add","path":"/metadata/notes/1","value":{"created_at":"2026-09-29T21:00:58.468Z","author":"codex-coverage-inventory","text":"Fail-closed coverage evidence adds three documented internal declarations. Current full AST presence denominator: 585/1887 declarations, 22/23 module docblocks over 23 runtime/tooling/template files. Selected 221-declaration gate remains narrower than the required complete scope. No threshold or denominator waiver."}},{"op":"replace","path":"/metadata/actual_result","value":"The selected-surface gate passes 221 declarations while the full presence census finds 585 of 1887 documented declarations and 22 of 23 module docblocks"},{"op":"replace","path":"/metadata/updated_at","value":"2026-09-29T21:00:58.487Z"}],"before_hash":"206d366b621de119c5742dce5de1c5b4583d54d7d99ce35986ea69e89e5a390e","after_hash":"8ad484c5388071c7c779bbcc70405e4a8937a930af0b02b3629e893e30d9bbda","item_hash_version":3,"message":"Refresh independent full documentation denominator","context":{"agent_provenance_outcomes":{"model":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"effort":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"version":{"status":"unavailable","reason":"harness_unavailable","resolver":"ai_agent_version","rule_version":"v1"}}},"event_class":"maintenance","record_hash_version":1,"record_hash":"1ca819cef0d5d9d8a9e2eb0429cecea05e5a5062f74bb1d52a8e184cdce1ab12"}
+{"hash_algorithm":"sha256","ts":"2026-09-29T21:10:47.707Z","author":"codex-coverage-inventory","author_source":"asserted","agent_harness":"codex","agent_model":"gpt-6.1-sol","agent_model_source":"probe","agent_instance":"9d2669fa650245f45ec88b84","agent_provenance":{"model":{"value":"gpt-6.1-sol","source":"probe"},"effort":{"value":"xhigh","source":"probe"},"role":{"value":"implementer","source":"argv"},"topic":null},"op":"update","patch":[{"op":"add","path":"/metadata/notes/2","value":{"created_at":"2026-09-29T21:10:47.687Z","author":"codex-coverage-inventory","text":"Final assurance boundaries and generated-path/state declarations all have source documentation. Current measured presence is 590/1887 declarations and 22/23 module docblocks. Tests and additional authored documentation obligations still require separate denominator verification; this source census does not establish complete repository documentation compliance."}},{"op":"replace","path":"/metadata/actual_result","value":"The selected-surface gate passes 221 declarations while the complete runtime/tooling/template presence census finds 590 of 1887 documented declarations and 22 of 23 module docblocks"},{"op":"replace","path":"/metadata/updated_at","value":"2026-09-29T21:10:47.707Z"}],"before_hash":"8ad484c5388071c7c779bbcc70405e4a8937a930af0b02b3629e893e30d9bbda","after_hash":"b5f03c0f8fb5e7e95d2142de2c202ec0d0f0f068a9ea991abc914bd1dac398c6","item_hash_version":3,"message":"Record final denominator and preserve full documentation blocker","context":{"agent_provenance_outcomes":{"model":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"effort":{"status":"resolved","resolver":"codex_session_file","rule_version":"v1"},"version":{"status":"unavailable","reason":"harness_unavailable","resolver":"ai_agent_version","rule_version":"v1"}}},"event_class":"maintenance","record_hash_version":1,"record_hash":"7b2021e4c74c6406af4b97af18f4fe323d5d9850caef3787893fa7433bb2cca9"}