feat(docs): deep code analysis engine with 7 supporting modules

changes:
  - file: __main__.py
    area: core
    added: [_build_log_entry, _build_logs_query, _format_log_row, _emit_command_not_found, _emit_command_result]
    modified: [cmd_run, cmd_logs]
  - file: _extract.py
    area: core
    added: [_should_extract, _extract_return_meta, _extract_kwargs_meta, _extract_args_meta, _get_effective_policy]
    modified: [_maybe_extract]
  - file: extractors.py
    area: core
    added: [_is_pandas_dataframe, _is_numpy_array, _try_custom_extractors, _extract_bytes_meta, _is_file_like]
    modified: [extract_meta]
  - file: log_flow.py
    area: core
    added: [_ensure_graph, _format_traces, _build_edge_rows, _build_node_rows, _extract_event_fields, _get_raw_data, +7 more]
    modified: [normalize_entry, compress_for_llm, LogFlowParser, build_flow_graph]
  - file: terminal.py
    area: core
    added: [_format_meta_str, _format_result, _format_duration, _format_args_str]
    modified: [_write_toon, TerminalSink]

stats:
  lines: "+2871/-454 (net +2417)"
  files: 11
  complexity: "Large structural change (normalized)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,167 @@
 ## [Unreleased]
 
+## [0.2.20] - 2026-03-30
+
+### Docs
+- Update CHANGELOG.md
+- Update TODO.md
+
+### Other
+- Update nfo/__main__.py
+- Update nfo/decorators/_extract.py
+- Update nfo/extractors.py
+- Update nfo/log_flow.py
+- Update nfo/terminal.py
+- Update planfile.yaml
+- Update prefact.yaml
+- Update project.sh
+- Update project/validation.toon.yaml
+
+## [0.1.10] - 2026-03-30
+
+### Fixed
+- Fix duplicate-imports issues (ticket-996e3777)
+- Fix smart-return-type issues (ticket-ceca156b)
+- Fix string-concat issues (ticket-2447e6cc)
+- Fix ai-boilerplate issues (ticket-67c10259)
+- Fix magic-numbers issues (ticket-e1e1d16c)
+- Fix ai-boilerplate issues (ticket-9115e565)
+- Fix magic-numbers issues (ticket-8716e39b)
+- Fix ai-boilerplate issues (ticket-7317dadf)
+- Fix string-concat issues (ticket-642a527b)
+- Fix unused-imports issues (ticket-ff925dbe)
+- Fix ai-boilerplate issues (ticket-d50f9255)
+- Fix smart-return-type issues (ticket-210effd6)
+- Fix string-concat issues (ticket-ca3c34ae)
+- Fix ai-boilerplate issues (ticket-fcda95b2)
+- Fix smart-return-type issues (ticket-dc7983ac)
+- Fix string-concat issues (ticket-049b8426)
+- Fix unused-imports issues (ticket-2b2ca4d2)
+- Fix magic-numbers issues (ticket-ac6ce058)
+- Fix llm-generated-code issues (ticket-8c1984e9)
+- Fix ai-boilerplate issues (ticket-bad6cc8e)
+- Fix smart-return-type issues (ticket-db9328c8)
+- Fix ai-boilerplate issues (ticket-0d7d2647)
+- Fix smart-return-type issues (ticket-fc99f384)
+- Fix ai-boilerplate issues (ticket-5aa73546)
+- Fix smart-return-type issues (ticket-0570d306)
+- Fix magic-numbers issues (ticket-7de654e8)
+- Fix ai-boilerplate issues (ticket-b9c68db7)
+- Fix magic-numbers issues (ticket-0ecd0c2a)
+- Fix ai-boilerplate issues (ticket-dfd961fc)
+- Fix smart-return-type issues (ticket-ad9c0a5b)
+- Fix string-concat issues (ticket-88d82026)
+- Fix magic-numbers issues (ticket-fa378406)
+- Fix llm-generated-code issues (ticket-3a12ba6f)
+- Fix ai-boilerplate issues (ticket-8070c897)
+- Fix magic-numbers issues (ticket-30dcc156)
+- Fix ai-boilerplate issues (ticket-55223232)
+- Fix smart-return-type issues (ticket-eb18bf91)
+- Fix unused-imports issues (ticket-6702ace2)
+- Fix magic-numbers issues (ticket-d65e0e0f)
+- Fix ai-boilerplate issues (ticket-c9f4ea89)
+- Fix unused-imports issues (ticket-d4cfc6c0)
+- Fix magic-numbers issues (ticket-5ca2ed3c)
+- Fix ai-boilerplate issues (ticket-d24b721d)
+- Fix magic-numbers issues (ticket-1bf162c2)
+- Fix smart-return-type issues (ticket-9a6edafe)
+- Fix string-concat issues (ticket-b0f0db2b)
+- Fix unused-imports issues (ticket-31ed21cf)
+- Fix llm-hallucinations issues (ticket-15d30c1d)
+- Fix llm-generated-code issues (ticket-d8386f7b)
+- Fix smart-return-type issues (ticket-56e3e59b)
+- Fix unused-imports issues (ticket-12379ec5)
+- Fix magic-numbers issues (ticket-e2a09748)
+- Fix ai-boilerplate issues (ticket-d1849036)
+- Fix ai-boilerplate issues (ticket-b49f1e86)
+- Fix magic-numbers issues (ticket-5a5d66ad)
+- Fix ai-boilerplate issues (ticket-125d7ab8)
+- Fix string-concat issues (ticket-c817a5db)
+- Fix magic-numbers issues (ticket-79fbd55d)
+- Fix ai-boilerplate issues (ticket-ee78f1e9)
+- Fix unused-imports issues (ticket-53bc2e30)
+- Fix llm-generated-code issues (ticket-13da8d34)
+- Fix unused-imports issues (ticket-624a35d1)
+- Fix llm-generated-code issues (ticket-eed0a900)
+- Fix unused-imports issues (ticket-736bbd8b)
+- Fix llm-generated-code issues (ticket-b67f5af3)
+- Fix unused-imports issues (ticket-feef05c1)
+- Fix magic-numbers issues (ticket-ae6380cf)
+- Fix ai-boilerplate issues (ticket-65c34093)
+- Fix relative-imports issues (ticket-325d19c6)
+- Fix unused-imports issues (ticket-d672145a)
+- Fix unused-imports issues (ticket-d418b387)
+- Fix duplicate-imports issues (ticket-e14bb5db)
+- Fix smart-return-type issues (ticket-64939a2f)
+- Fix unused-imports issues (ticket-f987595a)
+- Fix duplicate-imports issues (ticket-0eeeccb9)
+- Fix magic-numbers issues (ticket-95e2cbfe)
+- Fix ai-boilerplate issues (ticket-270e14b5)
+- Fix relative-imports issues (ticket-f8c70912)
+- Fix unused-imports issues (ticket-bc92c92b)
+- Fix string-concat issues (ticket-1ab3658f)
+- Fix unused-imports issues (ticket-01599cd4)
+- Fix duplicate-imports issues (ticket-c2774ab7)
+- Fix magic-numbers issues (ticket-beb5fec1)
+- Fix llm-generated-code issues (ticket-a9e00942)
+- Fix unused-imports issues (ticket-255d3e6d)
+- Fix relative-imports issues (ticket-05fa2561)
+- Fix unused-imports issues (ticket-964beb66)
+- Fix llm-generated-code issues (ticket-950dc645)
+- Fix unused-imports issues (ticket-52cc7bdd)
+- Fix relative-imports issues (ticket-abec993c)
+- Fix unused-imports issues (ticket-d5eba924)
+- Fix llm-generated-code issues (ticket-c17b09f5)
+- Fix string-concat issues (ticket-113c9f73)
+- Fix unused-imports issues (ticket-bb65ec30)
+- Fix magic-numbers issues (ticket-d21ea20d)
+- Fix llm-generated-code issues (ticket-a9b1e86b)
+- Fix string-concat issues (ticket-6dea0db3)
+- Fix unused-imports issues (ticket-35ee1785)
+- Fix magic-numbers issues (ticket-5189fe26)
+- Fix llm-generated-code issues (ticket-028d82e0)
+- Fix unused-imports issues (ticket-9e98330b)
+- Fix magic-numbers issues (ticket-f91c6161)
+- Fix string-concat issues (ticket-80e24290)
+- Fix unused-imports issues (ticket-d19eb691)
+- Fix llm-generated-code issues (ticket-68d21b21)
+- Fix string-concat issues (ticket-d3f748e6)
+- Fix unused-imports issues (ticket-d2146e76)
+- Fix magic-numbers issues (ticket-e56f6c98)
+- Fix llm-generated-code issues (ticket-d314854b)
+- Fix unused-imports issues (ticket-e6d1a5f2)
+- Fix magic-numbers issues (ticket-68d8f1c4)
+- Fix llm-generated-code issues (ticket-686e6e99)
+- Fix unused-imports issues (ticket-91b55c94)
+- Fix llm-generated-code issues (ticket-22992e35)
+- Fix unused-imports issues (ticket-92c44ef3)
+- Fix unused-imports issues (ticket-9f9f152b)
+- Fix llm-generated-code issues (ticket-f967edee)
+- Fix unused-imports issues (ticket-a0c930f0)
+- Fix unused-imports issues (ticket-a32f9ac6)
+- Fix string-concat issues (ticket-5ccefd01)
+- Fix unused-imports issues (ticket-1108000a)
+- Fix magic-numbers issues (ticket-70ce405f)
+- Fix unused-imports issues (ticket-e8338705)
+- Fix llm-generated-code issues (ticket-54972783)
+- Fix string-concat issues (ticket-7c64ac9d)
+- Fix unused-imports issues (ticket-f876e599)
+- Fix llm-generated-code issues (ticket-adbcb04a)
+- Fix unused-imports issues (ticket-d5267bce)
+- Fix llm-generated-code issues (ticket-5d7769a7)
+- Fix string-concat issues (ticket-2035ffa4)
+- Fix unused-imports issues (ticket-46f5667d)
+- Fix ai-boilerplate issues (ticket-055af3ed)
+- Fix duplicate-imports issues (ticket-2f0574a0)
+- Fix unused-imports issues (ticket-eb31ef75)
+- Fix magic-numbers issues (ticket-380fbba4)
+- Fix llm-generated-code issues (ticket-7f3cedc7)
+- Fix string-concat issues (ticket-314f9a6a)
+- Fix unused-imports issues (ticket-a0bb689f)
+- Fix duplicate-imports issues (ticket-d9b5a030)
+- Fix magic-numbers issues (ticket-b6f9211c)
+- Fix llm-generated-code issues (ticket-0ddba9ff)
+
 ## [0.2.19] - 2026-03-30
 
 ### Docs

README.md

@@ -24,7 +24,7 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.19-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.20-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 ![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-17.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
 - 🤖 **LLM usage:** $7.5000 (57 commits)