docs(audit): boundary layer audit + track completion for cruft_elimination_20260627
Phase 9: Boundary layer audit
- Metadata is now the typed fat struct (@dataclass(frozen=True, slots=True)
with 36 explicit fields) at the wire boundary
- Metadata: TypeAlias = dict[str, Any] is REMOVED
- Dict-compat methods (__getitem__, get, __contains__, __iter__, keys,
values, items) are TEMPORARY migration aids; will be deprecated in
follow-up track once all consumers migrated to typed componentized
dataclasses
- Boundary files documented: api_hooks.py, project_manager.py,
session_logger.py, mcp_client.py
Phase 8 metrics (after Phases 1 + 3):
- Metadata TypeAlias: 1 -> 0 (-100%)
- hasattr(f, 'path'): 29 -> 19 (-34%)
- -> Optional[T] returns: 30 -> 30 (deferred to Phase 6 follow-up)
- Any params: 59 -> 60 (+1; the Metadata dataclass added content: Any)
- dict[str, Any] params: 10 -> 11 (+1; similar)
Audit gates (all OK):
- audit_weak_types --strict: 107 <= 112 baseline
- generate_type_registry --check: 23 files in sync
- audit_main_thread_imports: OK (17 files)
- audit_no_models_config_io: OK (0 violations)
- audit_optional_in_3_files --strict: OK
- audit_exception_handling --strict: OK
- audit_code_path_audit_coverage --strict: OK (10 profiles)
Track status: PARTIAL COMPLETION
- Phase 1 (Metadata promotion): COMPLETE
- Phase 3 partial (hasattr removal in app_controller.py): COMPLETE
- Phases 2/3 follow-up/4/5/6/7: DEFERRED (5 follow-up tracks documented)
state.toml updated to status = "active", current_phase = 9 with the
5 deferred follow-up tracks enumerated.
See TRACK_COMPLETION_cruft_elimination_20260627.md for full report.
ed
0635f15ceb