refactor(docs): code analysis engine

stats:
  lines: "+1080/-465 (net +615)"
  files: 14
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -124,6 +124,26 @@ 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.57] - 2026-03-25
+
+### Docs
+- Update docs/README.md
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/compact_flow.mmd
+- Update project/compact_flow.png
+- Update project/duplication.toon.toon
+- Update project/evolution.toon.yaml
+- Update project/flow.mmd
+- Update project/flow.png
+- Update project/index.html
+- ... and 2 more files
+
 ## [0.1.56] - 2026-03-25
 
 ### Docs

VERSION

@@ -1 +1 @@
-0.1.56
+0.1.57

docs/README.md

@@ -332,7 +332,7 @@ code2llm ./ -f yaml --separate-orphans
 
 **Generated by**: `code2llm ./ -f all --readme`  
 **Analysis Date**: 2026-03-25  
-**Total Functions**: 12147  
+**Total Functions**: 12152  
 **Total Classes**: 3039  
 **Modules**: 1425  
 

project/README.md

@@ -2,9 +2,9 @@ format: toon-v2-yaml
 timestamp: '2026-03-25'
 header:
   files: 45
-  lines: 5699
-  functions: 12147
-  avg_cc: 3.6
+  lines: 5763
+  functions: 12152
+  avg_cc: 3.5
   critical_count: 4
   duplicates: 0
   cycles: 0
@@ -23,25 +23,25 @@ health:
     message: send CC=19 (limit:15)
   - severity: yellow
     code: CC
-    message: build_digest_header CC=19 (limit:15)
+    message: resolve_redirects CC=15 (limit:15)
   - severity: yellow
     code: CC
-    message: resolve_redirects CC=15 (limit:15)
+    message: build_digest_header CC=19 (limit:15)
   - severity: yellow
     code: CC
-    message: _encode_files CC=21 (limit:15)
+    message: super_len CC=18 (limit:15)
   - severity: yellow
     code: CC
-    message: prepare_url CC=17 (limit:15)
+    message: should_bypass_proxies CC=17 (limit:15)
   - severity: yellow
     code: CC
-    message: prepare_body CC=17 (limit:15)
+    message: _encode_files CC=21 (limit:15)
   - severity: yellow
     code: CC
-    message: super_len CC=18 (limit:15)
+    message: prepare_url CC=17 (limit:15)
   - severity: yellow
     code: CC
-    message: should_bypass_proxies CC=17 (limit:15)
+    message: prepare_body CC=17 (limit:15)
   - severity: yellow
     code: CC
     message: filter CC=16 (limit:15)
@@ -57,6 +57,9 @@ health:
   - severity: yellow
     code: CC
     message: mac_platforms CC=15 (limit:15)
+  - severity: yellow
+    code: CC
+    message: complete_struct_or_union CC=18 (limit:15)
   - severity: yellow
     code: CC
     message: collect_type_table CC=21 (limit:15)
@@ -69,9 +72,6 @@ health:
   - severity: yellow
     code: CC
     message: _struct_ctx CC=24 (limit:15)
-  - severity: yellow
-    code: CC
-    message: recompile CC=19 (limit:15)
 refactor:
   steps:
   - action: split_methods

project/analysis.toon.yaml

@@ -16,7 +16,7 @@ flowchart TD
     mcp_server["mcp.server<br/>13 funcs"]
     publish_env_lib["publish-env.lib<br/>11803 funcs"]
     scripts_bump_version["scripts.bump_version<br/>2 funcs"]
-    src_vallm["src.vallm<br/>183 funcs"]
+    src_vallm["src.vallm<br/>188 funcs"]
     src_vallm ==>|98| publish_env_lib
     examples_utils ==>|81| publish_env_lib
     examples_11_claude_code_autonomous ==>|76| publish_env_lib
@@ -42,8 +42,8 @@ flowchart TD
     examples_10_mcp_ollama_demo -->|2| examples_utils
     examples_04_graph_analysis -->|1| src_vallm
     examples_04_graph_analysis -->|1| examples_utils
-    examples_11_claude_code_autonomous -->|1| examples_utils
     examples_12_ollama_simple_demo -->|1| examples_utils
+    examples_11_claude_code_autonomous -->|1| examples_utils
     examples_01_basic_validation -->|1| publish_env_lib
     examples_03_security_check -->|1| examples_utils
     examples_02_ast_comparison -->|1| examples_utils

project/calls.mmd

@@ -6,10 +6,10 @@
 - **Primary Language**: python
 - **Languages**: python: 1410, shell: 9, cpp: 4, javascript: 2
 - **Analysis Mode**: static
-- **Total Functions**: 12147
+- **Total Functions**: 12152
 - **Total Classes**: 3039
 - **Modules**: 1425
-- **Entry Points**: 10379
+- **Entry Points**: 10381
 
 ## Architecture by Module
 
@@ -531,19 +531,25 @@ This is a partial replacement of the standard library's
 > Process input string and push block tokens into `outTokens`.
 - **Output to**: StateBlock, self.tokenize
 
-### publish-env.lib.python3.13.site-packages.rfc3986.parseresult.ParseResult.encode
-> Convert to an instance of ParseResultBytes.
-- **Output to**: dict, ParseResultBytes, zip, publish-env.lib.python3.13.site-packages.docutils.nodes.Element.hasattr, attr.encode
+### publish-env.lib.python3.13.site-packages.rfc3986.iri.IRIReference.encode
+> Encode an IRIReference into a URIReference instance.
+
+If the ``idna`` module is installed or the ``r
+- **Output to**: uri.URIReference, None.join, exceptions.MissingDependencyError, any, str
 
 ### publish-env.lib.python3.13.site-packages.markdown_it.parser_inline.ParserInline.parse
 > Process input string and push inline tokens into `tokens`
 - **Output to**: StateInline, self.tokenize, self.ruler2.getRules, publish-env.lib.python3.13.site-packages.rich.console.Console.rule
 
-### publish-env.lib.python3.13.site-packages.rfc3986.iri.IRIReference.encode
-> Encode an IRIReference into a URIReference instance.
+### publish-env.lib.python3.13.site-packages.rfc3986.parseresult.ParseResult.encode
+> Convert to an instance of ParseResultBytes.
+- **Output to**: dict, ParseResultBytes, zip, publish-env.lib.python3.13.site-packages.docutils.nodes.Element.hasattr, attr.encode
 
-If the ``idna`` module is installed or the ``r
-- **Output to**: uri.URIReference, None.join, exceptions.MissingDependencyError, any, str
+### publish-env.lib.python3.13.site-packages.markdown_it._punycode.encode
+- **Output to**: None.decode, codecs.encode
+
+### publish-env.lib.python3.13.site-packages.markdown_it._punycode.decode
+- **Output to**: codecs.decode
 
 ### publish-env.lib.python3.13.site-packages.markdown_it.main.MarkdownIt.parse
 > Parse the source string to a token stream
@@ -565,32 +571,29 @@ If the ``idna`` module is installed or the ``r
 This validator can prohibit more than really needed 
 - **Output to**: normalize_url.validateLink
 
-### publish-env.lib.python3.13.site-packages.markdown_it._punycode.encode
-- **Output to**: None.decode, codecs.encode
-
-### publish-env.lib.python3.13.site-packages.markdown_it._punycode.decode
-- **Output to**: codecs.decode
-
 ### publish-env.lib.python3.13.site-packages.markdown_it.token.convert_attrs
 > Convert Token.attrs set as ``None`` or ``[[key, value], ...]`` to a dict.
 
 This improves compatibili
 - **Output to**: isinstance, dict
 
-### publish-env.lib.python3.13.site-packages.requests.models.RequestEncodingMixin._encode_params
-> Encode parameters in a piece of data.
+### publish-env.lib.python3.13.site-packages.requests.utils.parse_list_header
+> Parse lists as described by RFC 2068 Section 2.
 
-Will successfully encode parameters when passed as a dict or 
-- **Output to**: isinstance, publish-env.lib.python3.13.site-packages.docutils.nodes.Element.hasattr, publish-env.lib.python3.13.site-packages.docutils.nodes.Element.hasattr, publish-env.lib.python3.13.site-packages.requests.utils.to_key_val_list, publish-env.lib.python3.13.site-packages.requests_toolbelt.utils.formdata.urlencode
+In particular, parse comma-separated lists where th
+- **Output to**: _parse_list_header, result.append, publish-env.lib.python3.13.site-packages.requests.utils.unquote_header_value
 
-### publish-env.lib.python3.13.site-packages.requests.models.RequestEncodingMixin._encode_files
-> Build the body for a multipart/form-data request.
+### publish-env.lib.python3.13.site-packages.requests.utils.parse_dict_header
+> Parse lists of key, value pairs as described by RFC 2068 Section 2 and
+convert them into a python di
+- **Output to**: _parse_list_header, item.split, publish-env.lib.python3.13.site-packages.requests.utils.unquote_header_value
 
-Will successfully encode files when passed as a d
-- **Output to**: publish-env.lib.python3.13.site-packages.requests.utils.to_key_val_list, publish-env.lib.python3.13.site-packages.requests.utils.to_key_val_list, publish-env.lib.python3.13.site-packages.urllib3.filepost.encode_multipart_formdata, ValueError, isinstance
+### publish-env.lib.python3.13.site-packages.requests.utils._parse_content_type_header
+> Returns content type and parameters from given header
 
-### publish-env.lib.python3.13.site-packages.requests.models.PreparedRequest._get_idna_encoded_host
-- **Output to**: None.decode, idna.encode
+:param header: string
+:return: tuple containi
+- **Output to**: header.split, None.strip, param.strip, param.find, None.strip
 
 ## Behavioral Patterns