feat(docs): code analysis engine

stats:
  lines: "+6859/-962 (net +5897)"
  files: 8
  complexity: "Stable complexity"

Author: tom-sapletta-com

.pyqual/ruff.json

@@ -350,6 +350,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Tree-sitter for all** — syntax validation for 165+ languages
 - **Example 07** — comprehensive multi-language demo with 8 languages
 
+## [0.1.70] - 2026-03-31
+
+### Docs
+- Update README.md
+- Update TODO.md
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update .pyqual/ruff.json
+- Update VERSION
+- Update project.sh
+- Update project/analysis.toon.yaml
+- Update project/validation.toon.yaml
+- Update project/verify/validation.toon.yaml
+
 ## [0.1.68] - 2026-03-31
 
 ### Docs

CHANGELOG.md

@@ -26,18 +26,16 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.68-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-14.4h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.70-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-15.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (78 commits)
-- 👤 **Human dev:** ~$1436 (14.4h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (80 commits)
+- 👤 **Human dev:** ~$1586 (15.9h @ $100/h, 30min dedup)
 
-Generated on 2026-03-30 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-03-31 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-
-
 vallm validates code proposals through a **four-tier pipeline** — from millisecond syntax checks to LLM-as-judge semantic review — before a single line ships.
 
 ## Features

README.md

@@ -1 +1 @@
-0.1.68
+0.1.70

TODO.md

@@ -1,24 +1,35 @@
 #!/usr/bin/env bash
+set -e
 clear
-pip install -e .
-pip install prefact --upgrade
-pip install vallm --upgrade
-pip install redup --upgrade
-pip install glon --upgrade
-pip install goal --upgrade
-pip install code2logic --upgrade
-pip install code2llm --upgrade
-#code2llm ./ -f toon,evolution,code2logic,project-yaml -o ./project --no-chunk
-code2llm ./ -f all -o ./project --no-chunk
-#code2llm report --format all       # → all views
-rm project/analysis.json
-rm project/analysis.yaml
 
-pip install code2docs --upgrade
-code2docs ./ --readme-only
-redup scan . --format toon --output ./project
-#redup scan . --functions-only -f toon --output ./project
-#vallm batch ./src --recursive --semantic --model qwen2.5-coder:7b
-#vallm batch --parallel .
-vallm batch . --recursive --format toon --output ./project
-prefact -a
+VENV=".venv"
+PIP="$VENV/bin/pip"
+
+if [ ! -f "$PIP" ]; then
+    echo "Creating virtual environment..."
+    python3 -m venv "$VENV"
+fi
+
+$PIP install -e . --quiet
+$PIP install pyqual --upgrade --quiet
+$PIP install prefact --upgrade --quiet
+$PIP install vallm --upgrade --quiet
+$PIP install redup --upgrade --quiet
+$PIP install glon --upgrade --quiet
+$PIP install goal --upgrade --quiet
+$PIP install code2logic --upgrade --quiet
+$PIP install code2llm --upgrade --quiet
+#$VENV/bin/code2llm ./ -f toon,evolution,code2logic,project-yaml -o ./project --no-chunk
+$VENV/bin/code2llm ./ -f all -o ./project --no-chunk
+#$VENV/bin/code2llm report --format all       # → all views
+rm -f project/analysis.json
+rm -f project/analysis.yaml
+
+$PIP install code2docs --upgrade --quiet
+$VENV/bin/code2docs ./ --readme-only
+$VENV/bin/redup scan . --format toon --output ./project
+#$VENV/bin/redup scan . --functions-only -f toon --output ./project
+#$VENV/bin/vallm batch ./src --recursive --semantic --model qwen2.5-coder:7b
+#$VENV/bin/vallm batch --parallel .
+$VENV/bin/vallm batch . --recursive --format toon --output ./project
+$VENV/bin/prefact -a

VERSION

@@ -332,9 +332,9 @@ code2llm ./ -f yaml --separate-orphans
 ---
 
 **Generated by**: `code2llm ./ -f all --readme`  
-**Analysis Date**: 2026-03-30  
-**Total Functions**: 12172  
-**Total Classes**: 3039  
-**Modules**: 1425  
+**Analysis Date**: 2026-03-31  
+**Total Functions**: 369  
+**Total Classes**: 41  
+**Modules**: 87  
 
 For more information about code2llm, visit: https://github.com/tom-sapletta/code2llm

project.sh

@@ -1,46 +1,26 @@
-# code2llm | 45f 5875L | python:44,shell:1 | 2026-03-30
-# CC̄=3.4 | critical:0/12172 | dups:0 | cycles:0
+# code2llm | 45f 5897L | python:44,shell:1 | 2026-03-31
+# CC̄=3.4 | critical:0/369 | dups:0 | cycles:2
 
-HEALTH[20]:
-  🟡 CC    renderToken CC=17 (limit:15)
-  🟡 CC    send CC=19 (limit:15)
-  🟡 CC    build_digest_header CC=19 (limit:15)
-  🟡 CC    resolve_redirects CC=15 (limit:15)
-  🟡 CC    super_len CC=18 (limit:15)
-  🟡 CC    should_bypass_proxies CC=17 (limit:15)
-  🟡 CC    _encode_files CC=21 (limit:15)
-  🟡 CC    prepare_url CC=17 (limit:15)
-  🟡 CC    prepare_body CC=17 (limit:15)
-  🟡 CC    filter CC=16 (limit:15)
-  🟡 CC    parse_email CC=26 (limit:15)
-  🟡 CC    _cpython_abis CC=15 (limit:15)
-  🟡 CC    cpython_tags CC=15 (limit:15)
-  🟡 CC    mac_platforms CC=15 (limit:15)
-  🟡 CC    collect_type_table CC=21 (limit:15)
-  🟡 CC    write_c_source_to_f CC=23 (limit:15)
-  🟡 CC    _generate_cpy_function_decl CC=30 (limit:15)
-  🟡 CC    _struct_ctx CC=24 (limit:15)
-  🟡 CC    recompile CC=19 (limit:15)
-  🟡 CC    _generate_cpy_function_decl CC=18 (limit:15)
+HEALTH[0]: ok
 
 REFACTOR[1]:
-  1. split 20 high-CC methods  (CC>15)
+  1. break 2 circular dependencies
 
-PIPELINES[8390]:
-  [1] Src [handle_validate_syntax]: handle_validate_syntax → validate_syntax → _format_issue
+PIPELINES[173]:
+  [1] Src [main]: main → print
       PURITY: 100% pure
-  [2] Src [handle_validate_imports]: handle_validate_imports → validate_imports → _format_issue
+  [2] Src [main]: main → run_validation_examples → print
       PURITY: 100% pure
-  [3] Src [handle_validate_security]: handle_validate_security → validate_security → _format_issue
+  [3] Src [main]: main → print
       PURITY: 100% pure
-  [4] Src [handle_validate_code]: handle_validate_code → validate_code → _run_validators
+  [4] Src [main]: main → print
       PURITY: 100% pure
-  [5] Src [__init__]: __init__
+  [5] Src [__init__]: __init__ → load_config
       PURITY: 100% pure
 
 LAYERS:
   scripts/                        CC̄=5.0    ←in:0  →out:0
-  │ bump_version                78L  0C    2m  CC=5      ←2
+  │ bump_version                78L  0C    2m  CC=5      ←0
   │
   mcp/                            CC̄=4.1    ←in:0  →out:0
   │ _tools_vallm               485L  0C   12m  CC=12     ←1
@@ -51,18 +31,18 @@ LAYERS:
   src/                            CC̄=3.3    ←in:0  →out:0
   │ output_formatters          476L  0C   24m  CC=10     ←2
   │ batch_processor            357L  1C   17m  CC=12     ←0
-  │ command_handlers           344L  0C   11m  CC=6      ←0
-  │ semantic                   296L  1C   15m  CC=4      ←0
+  │ command_handlers           345L  0C   11m  CC=8      ←0
+  │ semantic                   299L  1C   15m  CC=4      ←0
   │ gitignore                  272L  1C   10m  CC=11     ←1
   │ regression                 265L  1C   10m  CC=7      ←0
   │ security                   255L  1C    5m  CC=9      ←0
   │ languages                  227L  1C    6m  CC=6      ←5
   │ scoring                    218L  5C    8m  CC=7      ←0
-  │ semantic_cache             187L  1C    8m  CC=5      ←2
+  │ semantic_cache             187L  1C    8m  CC=5      ←5
   │ complexity                 183L  1C    4m  CC=12     ←0
   │ lint                       182L  1C    6m  CC=9      ←0
-  │ utils                      155L  0C    4m  CC=14     ←0
-  │ python_imports             146L  1C    7m  CC=14     ←0
+  │ utils                      155L  0C    4m  CC=14     ←5
+  │ python_imports             153L  1C    7m  CC=14     ←0
   │ runner                     144L  2C    4m  CC=4      ←0
   │ logical                    142L  1C    5m  CC=6      ←0
   │ ast_compare                135L  0C    7m  CC=4      ←2
@@ -81,16 +61,16 @@ LAYERS:
   │ hookspecs                   33L  1C    3m  CC=1      ←0
   │ wrapper                     30L  1C    1m  CC=2      ←0
   │ __init__                    25L  0C    0m  CC=0.0    ←0
-  │ base                        21L  1C    1m  CC=1      ←0
+  │ base                        21L  1C    1m  CC=1      ←12
   │ __init__                    19L  0C    0m  CC=0.0    ←0
   │ __main__                     5L  0C    0m  CC=0.0    ←0
   │ __init__                     3L  0C    0m  CC=0.0    ←0
   │ __init__                     1L  0C    0m  CC=0.0    ←0
   │ __init__                     1L  0C    0m  CC=0.0    ←0
   │
   ./                              CC̄=0.0    ←in:0  →out:0
+  │ project.sh                  35L  0C    0m  CC=0.0    ←0
   │ mcp_server                  28L  0C    0m  CC=0.0    ←0
-  │ project.sh                  24L  0C    0m  CC=0.0    ←0
   │
 
 COUPLING: no cross-package imports detected