refactor(docs): code analysis engine

changes:
  - file: cli.py
    area: cli
    added: [_print_summary_header, _build_file_list, _print_validator_issues, _output_batch_json, _print_validator_details, _build_results_table, +28 more]
    modified: [_output_text, batch, _output_json, check, validate]
  - file: scoring.py
    area: core
    added: [_initialize_context, _initialize_settings, _initialize_validators, _run_validation_pipeline]
    modified: [validate]
  - file: imports.py
    area: core
    removed: [_java_module_exists, _validate_cpp, walk, _rust_module_exists, ImportValidator, _extract_java_imports, +18 more]
  - file: base.py
    area: core
    added: [BaseImportValidator, module_exists, create_validation_result, validate, extract_imports]
  - file: c_imports.py
    area: core
    added: [walk, validate, __init__, CImportValidator, module_exists, extract_imports]
  - file: factory.py
    area: core
    added: [register_validator, ImportValidatorFactory, create_validator, supported_languages]
  - file: go_imports.py
    area: core
    added: [GoImportValidator, walk, module_exists, validate, extract_imports]
  - file: java_imports.py
    area: core
    added: [walk, module_exists, JavaImportValidator, validate, extract_imports]
  - file: javascript_imports.py
    area: core
    added: [walk, JavaScriptImportValidator, validate, __init__, module_exists, extract_imports]
  - file: python_imports.py
    area: core
    added: [module_exists, validate, PythonImportValidator, extract_imports]
  - file: rust_imports.py
    area: core
    added: [walk, RustImportValidator, module_exists, validate, extract_imports]
  - file: wrapper.py
    area: core
    added: [ImportValidator, validate]
  - file: imports_original.py
    area: core
    added: [_java_module_exists, _validate_cpp, walk, _rust_module_exists, ImportValidator, _extract_java_imports, +18 more]
  - file: semantic.py
    area: core
    added: [_parse_scores, _extract_json_from_response, _create_json_error_result, _create_parse_error_result, _parse_line_number, _parse_severity, +1 more]
    modified: [_parse_response, SemanticValidator]
  - file: test_cli_e2e.py
    area: cli
    modified: [TestCLICommands, TestConfiguration, test_batch_text_output, test_validate_nonexistent_file, test_validate_with_config_file, test_check_nonexistent_file, +1 more]
  - file: test_imports.py
    area: test
    modified: [test_non_python_skipped]
  - file: test_installation.py
    area: test
    modified: [test_pipx_install_editable, test_pip_install_with_extras, test_language_detection, test_basic_functionality, test_pip_install_from_local, test_pipx_install_with_extras, +4 more]
  - file: test_semantic_validation.py
    area: test
    modified: [TestSemanticValidation, test_semantic_validation_with_reference, test_semantic_validator_init, test_semantic_validation_good_code, test_semantic_validation_disabled]

stats:
  lines: "+22199/-2452 (net +19747)"
  files: 40
  complexity: "Large structural change (normalized)"

Author: tom-sapletta-com

CHANGELOG.md

@@ -2,10 +2,15 @@
 
 ### Summary
 
-docs: comprehensive documentation update with code health metrics and refactoring roadmap
+docs: comprehensive documentation update with code health metrics and CLI improvements
 
-### Docs
+### Added (CLI)
+- **Detailed batch output** — show reasons for failures with validator scores and issues
+- **New CLI options for batch**: `--verbose` (-v), `--show-issues` (-i) for detailed per-file results
+- **New output formats**: `json`, `yaml`, `toon` for batch results (was: rich, text only)
+- **Failed files summary** — list of failed files with scores, issues, and semantic validator summaries
 
+### Docs
 - docs: add code health metrics section to README (CC̄=3.5, max-CC=42, god modules=2)
 - docs: document critical functions requiring refactoring (batch CC=42, validate CC=18)
 - docs: add god modules inventory (imports.py 653L, cli.py 401L)
@@ -14,7 +19,6 @@ docs: comprehensive documentation update with code health metrics and refactorin
 - docs: update example list in README (12 examples including MCP and Ollama demos)
 
 ### Analysis
-
 - analysis: generate code2llm analysis files (analysis.toon, evolution.toon, context.md)
 - metrics: 91 functions, 19 classes, 56 modules, 8 critical functions (CC≥10)
 
@@ -109,7 +113,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - TOML config loading, `[tool.vallm]` support
 - Pre-commit hook integration
 - GitHub Actions CI/CD pipeline
-- CONTRIBUTING.md
 
 ### Added (Multi-Language Support)
 - **Language enum** — 30+ programming languages with metadata (compiled/scripting/web)
@@ -121,6 +124,36 @@ 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.10] - 2026-03-23
+
+### Docs
+- Update CHANGELOG.md
+- Update README.md
+- Update code2llm_output/README.md
+- Update code2llm_output/context.md
+- Update docs/README.md
+- Update project/README.md
+- Update project/context.md
+
+### Test
+- Update tests/test_cli_e2e.py
+- Update tests/test_imports.py
+- Update tests/test_installation.py
+- Update tests/test_semantic_validation.py
+
+### Other
+- Update code2llm_output/analysis.toon
+- Update examples/11_claude_code_autonomous/claude_autonomous_demo.py
+- Update project.sh
+- Update project/analysis.toon
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/compact_flow.mmd
+- Update project/compact_flow.png
+- Update project/dashboard.html
+- Update project/duplication.toon
+- ... and 10 more files
+
 ## [0.1.9] - 2026-03-22
 
 ### Docs

README.md

@@ -115,10 +115,18 @@ print(f"Score: {result.weighted_score:.2f}")
 vallm batch . --recursive --semantic --model qwen2.5-coder:7b
 vallm batch src/ --recursive --include "*.py,*.js" --exclude "*/test/*"
 vallm batch . --recursive --format json --fail-fast
+vallm batch . --recursive --verbose --show-issues  # Detailed per-file results
+
+# Output formats for batch results
+vallm batch . --recursive --format json   # Machine-readable JSON
+vallm batch . --recursive --format yaml   # YAML format
+vallm batch . --recursive --format toon   # Compact TOON format
+vallm batch . --recursive --format text   # Plain text
 
 # Single file validation
 vallm validate --file mycode.py --semantic --model qwen2.5-coder:7b
 vallm validate --file app.js --security
+vallm validate --file mycode.py --format json  # JSON output
 
 # Quick syntax check only
 vallm check mycode.py
@@ -128,6 +136,22 @@ vallm check src/main.go
 vallm info
 ```
 
+### Batch Command Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--recursive` | `-r` | Recurse into subdirectories |
+| `--include` | | File patterns to include (e.g., "*.py,*.js") |
+| `--exclude` | | File patterns to exclude |
+| `--use-gitignore` | | Respect .gitignore patterns (default: true) |
+| `--format` | `-f` | Output format: `rich`, `json`, `yaml`, `toon`, `text` |
+| `--fail-fast` | `-x` | Stop on first failure |
+| `--semantic` | | Enable LLM-as-judge semantic review |
+| `--security` | | Enable security checks |
+| `--model` | `-m` | LLM model for semantic review |
+| `--verbose` | `-v` | Show detailed validation results for each file |
+| `--show-issues` | `-i` | Show issues for failed files |
+
 ### With Ollama (LLM-as-judge)
 
 ```bash

VERSION

@@ -1 +1 @@
-0.1.9
+0.1.10