Configuration

# .anatoly.yml
 
project:
  name: "my-project"       # Optional project name
  monorepo: false           # Set to true for monorepo support
 
scan:
  include:                  # Glob patterns for files to scan
    - "src/**/*.ts"
    - "src/**/*.tsx"
  exclude:                  # Glob patterns for files to skip
    - "node_modules/**"
    - "dist/**"
    - "**/*.test.ts"
    - "**/*.spec.ts"
 
coverage:
  enabled: true
  command: "npx vitest run --coverage.reporter=json"
  report_path: "coverage/coverage-final.json"
 
llm:
  model: "claude-sonnet-4-6"              # Primary review model
  index_model: "claude-haiku-4-5-20251001"  # Model for indexing tasks
  fast_model: ~                            # Optional fast model override
  agentic_tools: true                      # Enable agent tool use (grep, read, RAG query)
  timeout_per_file: 600                    # Seconds before a file review times out
  max_retries: 3                           # Retries per file on transient errors (1-10)
  concurrency: 4                           # Parallel file reviews (1-10)
  min_confidence: 70                       # Minimum confidence threshold (0-100)
  max_stop_iterations: 3                   # Max stop iterations per review (1-10)
  deliberation: false                      # Enable Opus deliberation pass
  deliberation_model: "claude-opus-4-6"    # Model for deliberation pass
 
  axes:
    utility:
      enabled: true
      model: ~              # Override model for this axis
    duplication:
      enabled: true
    correction:
      enabled: true
    overengineering:
      enabled: true
    tests:
      enabled: true
      skip:                 # Skip test axis on specific files
        - "src/drivers/**"
    best_practices:
      enabled: true
 
rag:
  enabled: true             # Enable semantic RAG cross-file analysis
  dual_embedding: true      # Dual code+NLP embedding (auto-disabled when nomic-embed-code GGUF container is active)
  code_model: auto          # Code embedding model ('auto' = nomic-embed-code via Docker GGUF if GPU, else Jina ONNX)
  nlp_model: auto           # NLP embedding model ('auto' = Qwen3-Embedding-8B via Docker GGUF, else all-MiniLM-L6-v2 ONNX)
  code_weight: 0.6          # Hybrid search weighting (0-1, only used in dual mode)
 
logging:
  level: "warn"             # Log level: fatal, error, warn, info, debug, trace
  file: ~                   # Optional path to write ndjson logs
  pretty: true              # Pretty-print logs to terminal
 
output:
  max_runs: ~               # Auto-purge old runs, keeping N most recent
 
notifications:
  telegram:
    enabled: false                          # Enable Telegram notifications
    username: "YourTelegramUsername"         # Your Telegram username (without @)
    # chat_id: "-1001234567890"             # Or explicit chat ID (for groups/channels)
    bot_token_env: "ANATOLY_TELEGRAM_BOT_TOKEN"  # Env var holding the bot token
    report_url: ~                           # Optional URL to hosted report
 
badge:
  enabled: true             # Inject "Checked by Anatoly" badge into README.md
  verdict: false            # Include audit verdict (CLEAN/FINDINGS) in badge
  link: "https://github.com/r-via/anatoly"

axes:
  tests:
    enabled: true
    skip:
      - "src/drivers/**"       # OS-specific I/O — integration tests only
      - "**/tunnel.rs"
  documentation:
    enabled: true
    skip:
      - "src/internal/**"      # Private helpers with inline comments

documentation:
  docs_path: docs
  module_mapping:
    src/core/scanner.ts:
      - docs/02-Architecture/01-Pipeline-Overview.md
    src/core/axes:
      - docs/04-Core-Modules/04-Axis-Evaluators.md

# .anatoly.yml
llm:
  concurrency: 2

# .anatoly.yml
llm:
  concurrency: 4
  deliberation: true
 
output:
  max_runs: 5

# .anatoly.yml
scan:
  include:
    - "src/**/*.ts"
    - "src/**/*.tsx"
    - "lib/**/*.ts"
  exclude:
    - "node_modules/**"
    - "dist/**"
    - "**/*.test.ts"
    - "**/*.spec.ts"
    - "**/*.generated.ts"
    - "src/migrations/**"
 
llm:
  concurrency: 8
  deliberation: true
  timeout_per_file: 900
 
  axes:
    best_practices:
      enabled: false    # Skip for faster runs on large codebases
 
output:
  max_runs: 3

# .anatoly.yml
llm:
  concurrency: 4
  deliberation: false   # Faster for CI
 
badge:
  enabled: false        # No README modification in CI
 
logging:
  level: "info"
  pretty: false         # Structured output for CI

# My Project Instructions
 
## General
This is an ESM-only Node.js project with strict TypeScript.
 
## Documentation
- We do NOT use JSDoc -- TypeScript types are the documentation.
- Every module > 100 lines must have a descriptive header comment.
 
## Best Practices
- No barrel files (index.ts re-exports) -- direct imports only.
- Zod is required for all external input validation.
 
## Correction
- Race conditions on background workers are known and accepted (ignore).
 
## Tests
- Every endpoint must have a supertest integration test.
- Expected minimum coverage: 80% on services.
 
## Utility
- Exports in src/legacy/ are intentionally unused (migration in progress).
 
## Overengineering
- The factory pattern in src/providers/ is intentional (not over-engineered).
 
## Duplication
- Similar validation logic across controllers is accepted (no shared abstraction).

ANATOLY.md section "best_practices" is very long (~2500 tokens). Long sections may dilute scoring accuracy.