refactor(docs): code analysis engine

changes:
  - file: cli_parser.py
    area: analyzer
    modified: [create_parser]
  - file: readme_exporter.py
    area: docs
    modified: [READMEExporter, _generate_readme_content]

stats:
  lines: "+295/-295 (net +0)"
  files: 11
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,22 @@
 ## [Unreleased]
 
+## [0.5.86] - 2026-03-26
+
+### Docs
+- Update README.md
+- Update project/README.md
+- Update project/context.md
+
+### Other
+- Update code2llm/cli_parser.py
+- Update code2llm/exporters/readme_exporter.py
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/flow.mmd
+- Update project/index.html
+- Update project/map.toon.yaml
+
 ## [0.5.85] - 2026-03-26
 
 ### Docs

README.md

@@ -26,8 +26,8 @@ When you run `code2llm ./ -f all`, the following files are created:
 # Quick health check (TOON format only)
 code2llm ./ -f toon
 
-# Generate all formats (what created these files)
-code2llm ./ -f all
+# Generate all formats + prompt.txt (single-project mode)
+code2llm ./ -f all -o ./project --no-chunk
 
 # LLM-ready context only
 code2llm ./ -f context
@@ -142,8 +142,10 @@ grep -E "^  .*[0-9]{3,}$" project.toon.yaml | sort -t',' -k2 -n -r | head -10
 
 ### `prompt.txt` - Ready-to-Send LLM Prompt
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
+**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`
 **Contents**:
 - **Files section**: Lists all existing generated files with descriptions
+- **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`
 - **Missing section**: Shows which files weren't generated (if any)
 - **Task section**: Instructions for LLM analysis
 - **Requirements section**: Guidelines for suggested changes

VERSION

@@ -1 +1 @@
-0.5.85
+0.5.86

code2llm/__init__.py

@@ -8,7 +8,7 @@
 and entity resolution with multilingual support.
 """
 
-__version__ = "0.5.85"
+__version__ = "0.5.86"
 __author__ = "STTS Project"
 
 # Core analysis components (lightweight, always needed)

code2llm/cli_parser.py

@@ -14,7 +14,7 @@ def create_parser() -> argparse.ArgumentParser:
         epilog='''
 Examples:
   code2llm ./                                       # Default: TOON diagnostics + README
-  code2llm ./ -f all -o ./docs                      # All core formats to ./docs/
+  code2llm ./ -f all -o ./docs --no-chunk           # All core formats + prompt.txt to ./docs/
   code2llm ./ -f toon,map,evolution                 # Consolidated diagnostics + structure + roadmap
   code2llm ./ -f context                            # LLM narrative (context.md)
   code2llm ./ --streaming --strategy deep -f all    # Deep streaming analysis, all core outputs
@@ -43,7 +43,7 @@ def create_parser() -> argparse.ArgumentParser:
   flow         — Data-flow analysis (flow.toon) — legacy, explicit opt-in
   code2logic   — Generate project logic (legacy project.toon) via external code2logic
   project-yaml — Legacy project.yaml export (single source of truth) + generated views
-  all          — Generate core formats (analysis.toon, map.toon.yaml, evolution.toon.yaml, context, mermaid)
+  all          — Generate core formats (analysis.toon, map.toon.yaml, evolution.toon.yaml, context, mermaid) plus prompt.txt in single-project runs
 
 Strategy Options (--strategy):
   quick     — Fast overview, fewer files analyzed

code2llm/exporters/readme_exporter.py

@@ -233,6 +233,7 @@ def _generate_readme_content(self, project_path: str, output_dir: Path,
 
 ### `prompt.txt` - Ready-to-Send LLM Prompt
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
+**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`
 **Contents**:
 - **Files section**: Lists all existing generated files with descriptions
 - **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`

code2llm/nlp/__init__.py

@@ -4,7 +4,7 @@
 with multilingual support and fuzzy matching.
 """
 
-__version__ = "0.5.85"
+__version__ = "0.5.86"
 
 from .pipeline import NLPPipeline
 from .normalization import QueryNormalizer

project/README.md

@@ -151,6 +151,7 @@ grep -E "^  .*[0-9]{3,}$" project.toon.yaml | sort -t',' -k2 -n -r | head -10
 
 ### `prompt.txt` - Ready-to-Send LLM Prompt
 **Purpose**: Pre-formatted prompt listing all generated files for LLM conversation
+**Generation**: Written when `code2llm` runs with a source path and requests `-f all` (including `--no-chunk`) or `code2logic`
 **Contents**:
 - **Files section**: Lists all existing generated files with descriptions
 - **Source files section**: Highlights important source files such as `cli_exports/orchestrator.py`

project/analysis.toon.yaml

@@ -1,4 +1,4 @@
-# code2llm | 113f 21433L | python:105,shell:2,java:1 | 2026-03-26
+# code2llm | 113f 21434L | python:105,shell:2,php:1 | 2026-03-26
 # CC̄=4.6 | critical:10/932 | dups:0 | cycles:0
 
 HEALTH[10]:
@@ -17,15 +17,15 @@ REFACTOR[1]:
   1. split 10 high-CC methods  (CC>15)
 
 PIPELINES[637]:
-  [1] Src [read_readme]: read_readme
+  [1] Src [run_benchmark]: run_benchmark → load_previous
       PURITY: 100% pure
-  [2] Src [save_report]: save_report
+  [2] Src [read_readme]: read_readme
       PURITY: 100% pure
   [3] Src [main]: main → load_file → is_toon_file
       PURITY: 100% pure
-  [4] Src [run_benchmark]: run_benchmark → load_previous
+  [4] Src [save_report]: save_report
       PURITY: 100% pure
-  [5] Src [__init__]: __init__
+  [5] Src [main]: main → create_html → get_shield_url
       PURITY: 100% pure
 
 LAYERS:
@@ -36,7 +36,7 @@ LAYERS:
   │ !! pipeline_detector          506L  3C   18m  CC=13     ←0
   │ !! html_dashboard             504L  1C   14m  CC=7      ←0
   │ !! metrics                    501L  1C   27m  CC=12     ←0
-  │ readme_exporter            494L  1C    7m  CC=13     ←0
+  │ readme_exporter            495L  1C    7m  CC=13     ←0
   │ large_repo                 488L  2C   20m  CC=9      ←1
   │ mermaid                    485L  0C   16m  CC=13     ←1
   │ llm_flow                   472L  1C   24m  CC=14     ←0
@@ -148,9 +148,9 @@ LAYERS:
   │
   demo_langs/                     CC̄=1.5    ←in:0  →out:0
   │ sample.rs                   47L  1C    5m  CC=2      ←0
-  │ sample.java                 47L  2C    7m  CC=3      ←1
+  │ sample.java                 47L  2C    4m  CC=2      ←0
   │ sample.go                   46L  0C    4m  CC=3      ←0
-  │ sample.php                  44L  1C    1m  CC=1      ←0
+  │ sample.php                  44L  2C    4m  CC=2      ←2
   │ sample                      40L  1C    4m  CC=3      ←0
   │ sample.ts                   26L  1C    1m  CC=1      ←0
   │