schema_version: 1
generated_at_utc: "2026-03-21T04:47:58Z"
generated_from: ".ai/environment/tools.raw.yaml"
generator: "scripts/generate-ai-environment.py"
platform:
  family: "wsl-linux"
  os: "Linux"
  distro: "Ubuntu 24.04.4 LTS"
  shell: "bash"
capabilities:
  dotnet: true
  python: true
  node: true
  bun: true
  docker: true
  fast_search: true
  json_cli: true
tool_selection:
  search:
    preferred: "rg"
    fallback: "grep"
    use_for: "Repository text search."
  json:
    preferred: "jq"
    fallback: "python3"
    use_for: "Inspecting or transforming JSON command output."
  shell:
    preferred: "bash"
    fallback: "sh"
    use_for: "Repository shell scripts and command execution."
  scripting:
    preferred: "python3"
    fallback: "bash"
    use_for: "Non-trivial local automation and helper scripts."
  docs_package_manager:
    preferred: "bun"
    fallback: "npm"
    use_for: "Installing and previewing the docs site."
  build_and_test:
    preferred: "dotnet"
    fallback: "unavailable"
    use_for: "Build, test, restore, and solution validation."
python:
  available: true
  helper_packages:
    requests: true
    rich: true
    openai: false
    tiktoken: false
    pydantic: false
    pytest: false
preferences:
  prefer_project_listed_tools: true
  prefer_python_for_non_trivial_automation: true
  avoid_unlisted_system_tools: true
rules:
  - "Use rg instead of grep for repository search when rg is available."
  - "Use jq for JSON inspection; fall back to python3 if jq is unavailable."
  - "Prefer python3 over complex bash for non-trivial scripting when python3 is available."
  - "Use bun for docs preview workflows when bun is available; otherwise fall back to npm."
  - "Use dotnet for repository build and test workflows."
  - "Do not assume unrelated system tools are part of the supported project environment."