docs(docs): configuration management system

stats:
  lines: "+40/-0 (net +40)"
  files: 1
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,3 +1,14 @@
+## [0.5.18] - 2026-03-03
+
+### Summary
+
+docs(docs): configuration management system
+
+### Docs
+
+- docs: update README
+
+
 ## [0.5.17] - 2026-03-03
 
 ### Summary

README.md

@@ -46,6 +46,46 @@ code2llm ./ -f all --max-memory 500
 code2llm ./ -f all --no-png
 ```
 
+### Large Repository Analysis (Chunking)
+For repositories >100 files, automatic chunking splits analysis into smaller subprojects:
+
+```bash
+# Auto-chunking when >100 files detected
+code2llm ./ -f toon,evolution,code2logic --verbose
+
+# Force chunking with custom size limit
+code2llm ./ -f toon --chunk --chunk-size 256
+
+# Analyze only specific subproject
+code2llm ./ -f toon --only-subproject src
+
+# Skip tests and examples
+code2llm ./ -f toon --skip-subprojects tests examples
+
+# Customize file limit per chunk
+code2llm ./ -f toon --chunk --max-files-per-chunk 50
+```
+
+**Chunking Benefits:**
+- Each subproject analyzed separately (examples/, tests/, src/, etc.)
+- Output limited to ~256KB per file (configurable)
+- Parallel processing of chunks possible
+- Reduced memory usage for large repos
+
+**Output Structure:**
+```
+./project/
+  ├── src/                    # Core code analysis
+  │   ├── analysis.toon
+  │   └── evolution.toon
+  ├── tests/                 # Test code analysis
+  │   └── analysis.toon
+  ├── examples/              # Examples analysis
+  │   └── analysis.toon
+  ├── analysis.toon          # Merged summary
+  └── evolution.toon         # Full refactoring queue
+```
+
 ### Refactoring Focus
 ```bash
 # Get refactoring recommendations

VERSION

@@ -1 +1 @@
-0.5.17
+0.5.18

code2llm/__init__.py

@@ -8,7 +8,7 @@
 and entity resolution with multilingual support.
 """
 
-__version__ = "0.5.17"
+__version__ = "0.5.18"
 __author__ = "STTS Project"
 
 # Core analysis components

code2llm/nlp/__init__.py

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

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2llm"
-version = "0.5.17"
+version = "0.5.18"
 description = "High-performance Python code flow analysis with optimized TOON format - CFG, DFG, call graphs, and intelligent code queries"
 readme = "README.md"
 requires-python = ">=3.8"