refactor(docs): code analysis engine

changes:
  - file: orchestrator.py
    area: cli
    added: [_touch_recursive]
    modified: [_copy_cached_export]
  - file: test_orchestrator_cache_mtime.py
    area: test
    added: [_write]
    new_tests: 2

testing:
  new_tests: 2
  scenarios:
    - copy_cached_export_preserves_contents
    - copy_cached_export_refreshes_mtime

dependencies:
  flow: "orchestrator→prompt"
  - orchestrator.py -> prompt.py

stats:
  lines: "+16753/-251 (net +16502)"
  files: 23
  complexity: "Large structural change (normalized)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,31 @@
 ## [Unreleased]
 
+## [0.5.141] - 2026-04-21
+
+### Docs
+- Update docs/README.md
+- Update project/README.md
+- Update project/batch_1/context.md
+- Update project/context.md
+- Update project/root/context.md
+- Update project/test_python_only_examples/context.md
+
+### Test
+- Update tests/test_orchestrator_cache_mtime.py
+
+### Other
+- Update code2llm/cli_exports/orchestrator.py
+- Update project/analysis.toon.yaml
+- Update project/batch_1/analysis.toon.yaml
+- Update project/batch_1/evolution.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/calls.toon.yaml
+- Update project/calls.yaml
+- Update project/compact_flow.mmd
+- Update project/compact_flow.png
+- ... and 18 more files
+
 ## [0.5.140] - 2026-04-21
 
 ### Docs

README.md

@@ -3,7 +3,7 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.140-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.141-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-66.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
 - 🤖 **LLM usage:** $7.5000 (190 commits)

VERSION

@@ -1 +1 @@
-0.5.140
+0.5.141

code2llm/__init__.py

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

code2llm/cli_exports/orchestrator.py

@@ -4,6 +4,7 @@
 Maintains backward compatibility with all existing --format values.
 """
 
+import os
 import shutil
 import sys
 from pathlib import Path
@@ -164,6 +165,23 @@ def _copy_cached_export(cached_dir: Path, output_dir: Path, verbose: bool = Fals
             shutil.copytree(item, dest, dirs_exist_ok=True)
         else:
             shutil.copy2(item, dest)
+        # Refresh mtime so the user can tell these files were produced by
+        # the current run, even though the contents came from cache.
+        _touch_recursive(dest)
+
+
+def _touch_recursive(path: Path) -> None:
+    """Update mtime/atime to now for `path` (and all contents if it is a dir)."""
+    try:
+        os.utime(path, None)
+    except OSError:
+        return
+    if path.is_dir():
+        for sub in path.rglob('*'):
+            try:
+                os.utime(sub, None)
+            except OSError:
+                continue
 
 
 def _copy_to_cache(output_dir: Path, cache_dir: Path, verbose: bool = False) -> None:

code2llm/nlp/__init__.py

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