docs: 12 improvement ideas from automated audit

[clockblocker]

Summary

• Appends 12 new improvement ideas (DRY: Extract shared utils from propagation pipeline #18–chore: close low-risk BOW cleanup items #29) to documentation/ideas-to-consider.md as Tier 5 (Automated audit 2026-02-19)
• Based on automated codebase audit covering error handling, type safety, testing gaps, performance, and architecture
• Docs-only change: 1 file modified, 118 insertions, 0 source code modifications

New Ideas by Priority

P1 (High impact):

• DRY: Extract shared utils from propagation pipeline #18: Unit tests for stateless helpers (offset-mapper, block-id, markdown-strip)
• PR1: default propagationV2Enabled=true (keep kill-switch + v1 path) #19: OverlayManager test coverage

P2 (Medium):

• Soak tracking: PR1 default propagation-v2 rollout #20: Extract magic numbers to named constants in event coalescing
• PR2: remove v1 propagation path and propagationV2Enabled kill-switch #21: Wrap undocumented Obsidian API accesses in cd.ts
• Fix Keymaker bug, add loading feedback and API timeout, cleanup dead code #22: API error catch block improvement in api-service.ts
• DRY refactor: extract shared utilities #23: Resolve calibration TODOs for numeric thresholds
• DRY: consolidate duplicate utilities and remove dead code #24: Document error handling decision tree
• DRY: remove dead code and deduplicate patterns #25: Retry config per-API profile

P3 (Nice-to-have):

• Add loading spinners and API timeout to commands #26: OverlayManager teardown verification
• docs: 13 improvement ideas from automated audit #27: Suffix extraction consolidation
• Fix cache key, newline stripping, and dead code bugs #28: Self-event tracker prefix matching optimization
• chore: close low-risk BOW cleanup items #29: Path aliases in tsconfig.json

Diff scope

1 file changed, 118 insertions(+)
documentation/ideas-to-consider.md

No source code, test, or config files were touched.

🤖 Generated with Claude Code