[Test Improver] test: add unit tests for DistributedAgentsCompiler (50%→97%)

[danielmeppiel]

🤖 Test Improver — automated AI assistant

What

55 new unit tests for DistributedAgentsCompiler in tests/unit/compilation/test_distributed_compiler.py.
Also fixes a pre-existing ANSI escape-code test failure in tests/unit/test_install_command.py.

Why

distributed_compiler.py is the core engine for generating distributed AGENTS.md files across a project. At 50% coverage, several critical paths had no unit-level regression protection:

• Orphaned-file detection, warning generation, and cleanup
• _generate_agents_content (the actual AGENTS.md content builder)
• _find_best_directory and _extract_directories_from_pattern (placement logic)
• Exception handling in compile_distributed
• Debug mode and clean_orphaned paths
• generate_distributed_agents_files — both the constitution-only and normal-case branches

Approach

• Isolated tests using unittest.mock.patch to avoid touching real filesystem or
  external dependencies (ContextOptimizer, UnifiedLinkResolver, CompilationFormatter).
• Real filesystem used only where strictly needed (orphaned-file I/O, constitution file).
• Tests verify observable behaviour (return values, warnings, file existence) rather than
  internal implementation details.
• ANSI fix: added _strip_ansi() helper in test_install_command.py (also added to
  TestAnsiStripping in the new file as a regression guard).

Coverage impact

File	Before	After
distributed_compiler.py	50%	97%
Overall (apm_cli/)	54%	55%

Remaining 3% (8 lines) are a debug branch triggered only with live context-file references, a line inside a min_instructions filtering loop, and two lines in _find_orphaned_agents_files guarding against external-path edge cases. These require complex fixture setup for marginal benefit.

Test status

1339 passed in 12.36s   (previously: 1284 passed, 1 failed)

Reproduce

uv sync --extra dev
uv run pytest tests/unit/compilation/test_distributed_compiler.py tests/unit/test_install_command.py -v
uv run pytest tests/unit/ --no-header -q --cov=apm_cli.compilation.distributed_compiler --cov-report=term-missing

Generated by Daily Test Improver · ◷

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/daily-test-improver.md@b87234850bf9664d198f28a02df0f937d0447295