Decompose Step 6 snapshot: 140 task specs + contract docs

Closes out greenfield Step 6 (Decompose) for all 14 components
(C1-C13 + cross-cutting helpers/replay). Covers tasks AZ-266..AZ-446
plus the _dependencies_table.md and component contract documents.

State file updated to greenfield Step 7 (Implement), not_started.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Oleksandr Bezdieniezhnykh
2026-05-11 00:39:48 +03:00
parent 8171fcb29e
commit 880eabcb3f
172 changed files with 22897 additions and 35 deletions
@@ -0,0 +1,75 @@
# Config Precedence Unit Tests
**Task**: AZ-271_config_precedence_tests
**Name**: Config Precedence Tests
**Description**: A focused unit-test module that verifies the env > YAML > defaults precedence rule for at least 3 keys per layer (per epic AZ-246 AC-3) and the multi-file YAML merge order (later wins). Companion to AZ-269 / AZ-270.
**Complexity**: 2 points
**Dependencies**: AZ-269_config_loader, AZ-270_compose_root
**Component**: shared.config (cross-cutting; epic AZ-246 / E-CC-CONF)
**Tracker**: AZ-271
**Epic**: AZ-246 (E-CC-CONF)
### Document Dependencies
- `_docs/02_document/contracts/shared_config/composition_root_protocol.md` — the contract whose precedence invariant this test suite verifies.
## Problem
The composition_root_protocol contract declares a hard precedence rule. Without explicit, tabular tests covering at least 3 keys per layer, regressions in the loader silently flip precedence and cause field bugs that only show up in production deployments where env overrides matter most.
## Outcome
- A pytest module with clearly-named cases covering precedence for ≥3 keys at each layer.
- A multi-file YAML merge case proving later paths win over earlier paths.
- Failure messages name the layer (env / YAML / defaults) so on-call engineers can triage fast.
## Scope
### Included
- Precedence cases for ≥3 keys at each of: env > YAML, YAML > defaults, multi-file YAML merge order.
- One reachability case driving `compose_root` end-to-end with a stub Config to prove the loader and composition functions integrate cleanly.
- Test fixtures (in-memory YAML strings + env dict, no real files needed for precedence cases; one tmp_path for the multi-file case).
### Excluded
- Performance microbench — owned by AZ-269.
- Strategy/build-flag mismatch tests — owned by AZ-270.
- Per-component config block tests — owned by each component epic.
## Acceptance Criteria
**AC-1: env > YAML for at least 3 keys**
Given env sets `LOG_LEVEL`, `FDR_QUEUE_SIZE`, `MAVLINK_BAUD` and YAML sets all three to different values
When `load_config(env, [yaml])` runs
Then all three resolved values match env
**AC-2: YAML > defaults for at least 3 keys**
Given env is empty and YAML sets `log.level`, `fdr.queue_size`, `mavlink.baud`
When `load_config(env, [yaml])` runs
Then all three resolved values match YAML (not the documented defaults)
**AC-3: Defaults apply for at least 3 keys**
Given env is empty and YAML omits the three keys
When `load_config(env, [yaml])` runs
Then all three resolved values match the documented defaults
**AC-4: Multi-file YAML — later wins**
Given two YAML paths setting the same key to different values
When `load_config(env, [first, second])` runs
Then the resolved value matches the second file
**AC-5: Failure messages name the layer**
Given a precedence assertion fails
When pytest reports the failure
Then the assertion message names which layer's value was expected and which was found
## Non-Functional Requirements
**Reliability**
- Tests are hermetic: no real env vars consulted, no real YAML files outside tmp_path.
## Constraints
- Test file path is fixed at `tests/unit/shared/config/test_precedence.py` (mirrors the `tests/unit/<component>/` convention from module-layout.md Layout Rule 7 — `shared/config` is the component slug).
- Cases use the SAME 3 keys per layer to make the test matrix comparable across layers.