ccs/docs/hardening-debt-burndown.md

Hardening Debt Burndown Tracker

Last Updated: 2026-02-12 Owner: Stream D (#542)

Scope

Maintainability hardening groundwork with low-risk changes:

• Inventory legacy shims/compatibility markers
• Inventory sync filesystem usage, especially runtime hotpaths
• Incrementally migrate hotpath sync I/O to async I/O with tests

How to Measure

Run:

bun run report:hardening

Generated artifacts:

• docs/reports/hardening-inventory.json
• docs/reports/hardening-inventory.md

Kickoff Baseline (Issue #542 Stream D)

The current baseline is sourced from docs/reports/hardening-inventory.json after running bun run report:hardening. Baseline captured: 2026-02-12.

Metric	Baseline
Sync fs occurrences (all)	835
Sync fs files affected (all)	100
Sync fs occurrences (runtime hotpaths)	724
Sync fs files affected (runtime hotpaths)	89
Legacy shim markers	131
Legacy shim files affected	56

Initial Async I/O Migration Log

Date	Area	Change	Safety Notes
2026-02-12	src/web-server/jsonl-parser.ts	Migrated parseProjectDirectory() directory listing from sync readdirSync to async fs.promises.readdir	Existing behavior kept (same filtering/fallback); covered by tests/unit/jsonl-parser.test.ts