refactor(docs): code analysis engine

changes:
  - file: examples_gen.py
    area: docs
    modified: [ExamplesGenerator, _generate_advanced]

stats:
  lines: "+8520/-50163 (net -41643)"
  files: 28
  complexity: "Stable complexity"

Author: tom-sapletta-com

.pyqual/pipeline.db

@@ -5,8 +5,152 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.10] - 2026-03-30
+
+### Fixed
+- Fix relative-imports issues (ticket-2a6fc9ae)
+- Fix relative-imports issues (ticket-910cf262)
+- Fix relative-imports issues (ticket-4425f0fc)
+- Fix ai-boilerplate issues (ticket-55c2615f)
+- Fix unused-imports issues (ticket-d42bc464)
+- Fix duplicate-imports issues (ticket-ac286168)
+- Fix string-concat issues (ticket-7657c798)
+- Fix unused-imports issues (ticket-6a60a169)
+- Fix string-concat issues (ticket-9c051a8c)
+- Fix unused-imports issues (ticket-3ea52d4c)
+- Fix relative-imports issues (ticket-b5156dbd)
+- Fix unused-imports issues (ticket-f9134bd1)
+- Fix relative-imports issues (ticket-80fa29e7)
+- Fix unused-imports issues (ticket-400563b9)
+- Fix unused-imports issues (ticket-0a4455ec)
+- Fix unused-imports issues (ticket-e0f2ff98)
+- Fix llm-generated-code issues (ticket-f876d5fa)
+- Fix relative-imports issues (ticket-beafb0b1)
+- Fix smart-return-type issues (ticket-bea652d7)
+- Fix string-concat issues (ticket-cdf62d0c)
+- Fix unused-imports issues (ticket-d3d49f30)
+- Fix duplicate-imports issues (ticket-86cb4d04)
+- Fix magic-numbers issues (ticket-128c7546)
+- Fix ai-boilerplate issues (ticket-bbe5ae00)
+- Fix relative-imports issues (ticket-ed96f712)
+- Fix relative-imports issues (ticket-37c899e3)
+- Fix smart-return-type issues (ticket-5ca18834)
+- Fix llm-hallucinations issues (ticket-8b882507)
+- Fix string-concat issues (ticket-4b436b35)
+- Fix unused-imports issues (ticket-75336043)
+- Fix llm-generated-code issues (ticket-72586520)
+- Fix relative-imports issues (ticket-c358621c)
+- Fix string-concat issues (ticket-089083ad)
+- Fix unused-imports issues (ticket-b9f82914)
+- Fix llm-hallucinations issues (ticket-f656d729)
+- Fix magic-numbers issues (ticket-7f5fe9fb)
+- Fix llm-generated-code issues (ticket-3f6b6f03)
+- Fix relative-imports issues (ticket-63b86a0c)
+- Fix relative-imports issues (ticket-82680675)
+- Fix string-concat issues (ticket-cfb10ab3)
+- Fix unused-imports issues (ticket-7f523f7c)
+- Fix magic-numbers issues (ticket-80b3891f)
+- Fix relative-imports issues (ticket-3dda2328)
+- Fix unused-imports issues (ticket-0086b26f)
+- Fix relative-imports issues (ticket-d9f6cafb)
+- Fix string-concat issues (ticket-f1e65d5f)
+- Fix unused-imports issues (ticket-4862bee0)
+- Fix relative-imports issues (ticket-dc003f2f)
+- Fix unused-imports issues (ticket-fbf89a4a)
+- Fix relative-imports issues (ticket-1bbd1403)
+- Fix string-concat issues (ticket-5b6e5bd1)
+- Fix unused-imports issues (ticket-27234b1f)
+- Fix llm-generated-code issues (ticket-5b1be9b1)
+- Fix relative-imports issues (ticket-6d0a2be4)
+- Fix unused-imports issues (ticket-432e2bad)
+- Fix relative-imports issues (ticket-f15f626a)
+- Fix unused-imports issues (ticket-18a693af)
+- Fix relative-imports issues (ticket-ea55f41f)
+- Fix string-concat issues (ticket-09ff796e)
+- Fix magic-numbers issues (ticket-e72a616e)
+- Fix relative-imports issues (ticket-c7d45465)
+- Fix string-concat issues (ticket-15b84f3b)
+- Fix unused-imports issues (ticket-bf419b94)
+- Fix relative-imports issues (ticket-5e5956f5)
+- Fix unused-imports issues (ticket-b1568110)
+- Fix relative-imports issues (ticket-25f8f0de)
+- Fix string-concat issues (ticket-c75d7cdc)
+- Fix magic-numbers issues (ticket-3fd4966c)
+- Fix llm-generated-code issues (ticket-cc81b085)
+- Fix relative-imports issues (ticket-259c0bb2)
+- Fix relative-imports issues (ticket-adf5d463)
+- Fix relative-imports issues (ticket-ac69ebe3)
+- Fix string-concat issues (ticket-7ee47f30)
+- Fix unused-imports issues (ticket-e22febff)
+- Fix duplicate-imports issues (ticket-dd911ec5)
+- Fix magic-numbers issues (ticket-9bdd0eaa)
+- Fix relative-imports issues (ticket-e5b1bf0c)
+- Fix string-concat issues (ticket-64471096)
+- Fix unused-imports issues (ticket-5336c6e5)
+- Fix duplicate-imports issues (ticket-dea42f1a)
+- Fix magic-numbers issues (ticket-c8111341)
+- Fix ai-boilerplate issues (ticket-8f3b1c1a)
+- Fix relative-imports issues (ticket-4c41651f)
+- Fix relative-imports issues (ticket-616cc85c)
+- Fix unused-imports issues (ticket-b381f3e1)
+- Fix relative-imports issues (ticket-4347e02f)
+- Fix unused-imports issues (ticket-1be94e1b)
+- Fix relative-imports issues (ticket-b7d98642)
+- Fix wildcard-imports issues (ticket-4b0b36a4)
+- Fix relative-imports issues (ticket-599a3591)
+- Fix smart-return-type issues (ticket-aa892334)
+- Fix unused-imports issues (ticket-fa0c4250)
+- Fix llm-generated-code issues (ticket-7024f495)
+- Fix ai-boilerplate issues (ticket-7de2f0bc)
+- Fix ai-boilerplate issues (ticket-ac199b41)
+- Fix smart-return-type issues (ticket-3ce5c01c)
+- Fix duplicate-imports issues (ticket-7f6532c4)
+- Fix llm-generated-code issues (ticket-43a4b866)
+- Fix ai-boilerplate issues (ticket-46649831)
+- Fix unused-imports issues (ticket-25d7a646)
+- Fix ai-boilerplate issues (ticket-afa56bb0)
+- Fix string-concat issues (ticket-84b7bc2c)
+- Fix unused-imports issues (ticket-ea6f1225)
+- Fix ai-boilerplate issues (ticket-d4588a0e)
+- Fix string-concat issues (ticket-72755f4e)
+- Fix magic-numbers issues (ticket-ca15732a)
+- Fix ai-boilerplate issues (ticket-ac50fdc9)
+- Fix string-concat issues (ticket-3b26b3c5)
+- Fix ai-boilerplate issues (ticket-e42df04d)
+- Fix unused-imports issues (ticket-71de81b8)
+- Fix duplicate-imports issues (ticket-5f4c94a4)
+- Fix llm-generated-code issues (ticket-3dd60300)
+- Fix llm-hallucinations issues (ticket-f6c7652c)
+- Fix unused-imports issues (ticket-6a7330c8)
+- Fix unused-imports issues (ticket-74662e84)
+- Fix relative-imports issues (ticket-d9884e57)
+
 ## [Unreleased]
 
+## [3.0.23] - 2026-03-31
+
+### Docs
+- Update CHANGELOG.md
+- Update README.md
+- Update TODO.md
+- Update docs/README.md
+- Update docs/examples/advanced_usage.py
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update .pyqual/pipeline.db
+- Update .pyqual/ruff.json
+- Update code2docs/generators/examples_gen.py
+- Update planfile.yaml
+- Update prefact.yaml
+- Update project/analysis.json
+- Update project/analysis.toon.yaml
+- Update project/analysis.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- ... and 11 more files
+
 ## [3.0.22] - 2026-03-15
 
 ### Docs

.pyqual/ruff.json

@@ -1,6 +1,21 @@
 # code2docs
 
-![version](https://img.shields.io/badge/version-3.0.22-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![docs](https://img.shields.io/badge/docs-auto--generated-blueviolet)
+
+## AI Cost Tracking
+
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-3.0.23-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-16.2h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+
+- 🤖 **LLM usage:** $7.5000 (52 commits)
+- 👤 **Human dev:** ~$1621 (16.2h @ $100/h, 30min dedup)
+
+Generated on 2026-03-31 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+
+---
+
+
+
+![version](https://img.shields.io/badge/version-3.0.23-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![docs](https://img.shields.io/badge/docs-auto--generated-blueviolet)
 
 > Auto-generate and sync project documentation from source code analysis.
 
@@ -140,7 +155,7 @@ code2docs can update only specific sections of an existing README using markers:
 ```markdown
 <!-- code2docs:start --># code2docs
 
-![version](https://img.shields.io/badge/version-3.0.22-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-276-green)
+![version](https://img.shields.io/badge/version-3.0.23-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-276-green)
 > **276** functions | **57** classes | **51** files | CC̄ = 3.8
 
 > Auto-generated project documentation from source code analysis.
@@ -773,8 +788,7 @@ code2docs/
 
 ## License
 
-Apache License 2.0 - see [LICENSE](LICENSE) for details.
-
+Licensed under Apache-2.0.
 ## Author
 
-Created by **Tom Sapletta** - [tom@sapletta.com](mailto:tom@sapletta.com)
+Tom Sapletta