[AZ-845][AZ-846][AZ-847] Refactor 02: relocate RouteSpec + widen lint

Cycle-3 refactor run 02-az507 (RouteSpec relocation + module-layout
refresh + AZ-270 lint widening). Single batch of 3 tasks; epic AZ-844.

AZ-845 — Relocate RouteSpec DTO to _types/route.py (rule-9 fix):
  * New canonical home: src/gps_denied_onboard/_types/route.py
    (frozen+slots dataclass; full docstring carried over verbatim).
  * c11_tile_manager/route_client.py imports from _types.route.
  * replay_input/tlog_route.py and replay_input/__init__.py keep
    re-exports for backward-compat (RouteSpec in __all__).
  * 5 test files updated to import from _types.route for symmetry.
  * Identity-preserving re-export verified by new test
    test_az845_routespec_canonical_home_and_reexport_identity.

AZ-846 — Refresh module-layout.md cycle-3 entries:
  * c11_tile_manager Internal list rewritten with all 8 internals
    (alphabetised) — corrects a stale entry that referenced files
    (satellite_provider_*.py) that no longer exist.
  * shared/replay_input file list adds errors.py (cycle-2 carry),
    tlog_ground_truth.py (cycle-2 carry), tlog_route.py (cycle-3 NEW).
  * shared/_types section registers route.py with provenance line.
  * Out-of-scope cycle-2 carry-overs (replay_api/, cli/render_map.py,
    helpers/gps_compare.py, etc.) intentionally untouched.

AZ-847 — Widen test_az270 lint to enforce full rule-9 allow-list:
  * test_ac6_only_compose_root_imports_concrete_strategies now walks
    every components/<X>/*.py ImportFrom/Import and rejects anything
    not in the rule-9 allow-list (own subpackage + _types + helpers
    + config/logging/fdr_client/clock + frame_source interface-only).
  * Strict superset of the original AC-6 narrow check.
  * Reports zero violations on the codebase post-AZ-845.
  * Two principled carve-outs documented in the test docstring:
    - components/<X>/bench/** path skip (measurement code legitimately
      constructs production strategies via runtime_root factories).
    - register_* lazy self-registration imports from
      runtime_root.<X>_factory (central-registry plugin pattern).
  * Both carve-outs surfaced to user via Choose A/B/C/D Risk-1
    protocol; user skipped both — agent proceeded with documented
    defaults. Doc-only follow-up tracked in
    _docs/_process_leftovers/2026-05-24_az847_rule9_wording_followup.md
    for rule-9 wording update in module-layout.md.

Test results: 2287 passed, 90 skipped (environmental — Docker / CUDA
/ TensorRT / Jetson hardware / fixtures), 0 failed. Focused subset
(replay_input/ + c11_tile_manager/ + test_az270_compose_root.py)
also clean: 169 passed, 1 skipped.

Tracker: AZ-845/846/847 transitioned In Progress -> In Testing.
Co-authored-by: Cursor <cursoragent@cursor.com>

_docs/02_document/module-layout.md

@@ -233,8 +233,14 @@ Bootstrap reference: `_docs/02_tasks/todo/AZ-263_initial_structure.md`. Architec
   - `__init__.py` (re-exports `TileDownloader`, `TileUploader`)
   - `interface.py` (`TileDownloader`, `TileUploader` Protocols)
 - **Internal**:
-  - `satellite_provider_downloader.py` (REST client against parent-suite `satellite-provider`)
+  - `_types.py` (component-internal DTOs / enums consumed by the Public API re-exports)
-  - `satellite_provider_uploader.py` (post-landing batch upload, D-PROJ-2 ingest contract)
+  - `config.py` (`C11Config` + `C11RetryConfig` dataclasses; registered on import)
+  - `errors.py` (component error family — `TileManagerError` + Tile* subtypes; AZ-838-era additions: `SatelliteProviderRouteError`, `RouteValidationError`, `RouteTransientError`, `RouteTerminalFailureError`)
+  - `idempotent_retry.py` (AZ-320 — bounded retry decorator + per-flight signing-key state)
+  - `route_client.py` (AZ-838 — `SatelliteProviderRouteClient` for the parent-suite Route API; cycle-3 NEW from batch 107)
+  - `signing_key.py` (AZ-318 — per-flight MAVLink 2.0 signing key handshake + key rotation)
+  - `tile_downloader.py` (AZ-316 — REST client against parent-suite `satellite-provider`)
+  - `tile_uploader.py` (AZ-319 — post-landing batch upload, D-PROJ-2 ingest contract)
 - **Owns**: `src/gps_denied_onboard/components/c11_tile_manager/**`, `tests/unit/c11_tile_manager/**`
 - **Imports from**: `_types`, `helpers.sha256_sidecar`, `helpers.wgs_converter`, `config`, `logging`, `fdr_client`. The c6 storage surface (`TileStore`, `TileMetadataStore`) is obtained via constructor-injected consumer-side structural Protocol cuts (see AZ-507 cross-component rule below); composition root wires the concrete c6 strategy in. NEVER `from gps_denied_onboard.components.c6_tile_cache import ...` inside `c11_tile_manager/*.py`.
 - **Consumed by**: `c12_operator_orchestrator`, `runtime_root` (operator binary only — `BUILD_C11_TILE_MANAGER=OFF` for airborne)
@@ -274,9 +280,11 @@ Bootstrap reference: `_docs/02_tasks/todo/AZ-263_initial_structure.md`. Architec
 ### shared/_types
 
 - **Directory**: `src/gps_denied_onboard/_types/`
-- **Purpose**: Cross-component DTOs (NavCameraFrame, ImuSample, ImuWindow, AttitudeWindow, FlightStateSignal, GpsHealth, VioOutput, VprQuery, VprResult, RerankResult, MatchResult, PoseEstimate, EstimatorOutput, EstimatorHealth, Tile, TileQualityMetadata, TileRecord, SectorClassification, CameraCalibration, EmittedExternalPosition, Manifest, EngineCacheEntry). **Type-only stubs**: zero implementation logic.
+- **Purpose**: Cross-component DTOs (NavCameraFrame, ImuSample, ImuWindow, AttitudeWindow, FlightStateSignal, GpsHealth, VioOutput, VprQuery, VprResult, RerankResult, MatchResult, PoseEstimate, EstimatorOutput, EstimatorHealth, Tile, TileQualityMetadata, TileRecord, SectorClassification, CameraCalibration, EmittedExternalPosition, Manifest, EngineCacheEntry, RouteSpec). **Type-only stubs**: zero implementation logic.
 - **Owned by**: AZ-263 (Bootstrap task); subsequent additions are type-only edits owned by the proposing component task.
 - **Consumed by**: every component, every cross-cutting module, the composition root.
+- **Files (selected — see directory for full list)**:
+  - `route.py` (AZ-845 / Epic AZ-835 C1 — canonical home): `RouteSpec` (waypoints + suggested region size + source tlog provenance), produced by `replay_input/tlog_route.py` (re-exported), consumed by `components/c11_tile_manager/route_client.py`
 
 ### shared/config
 
@@ -387,10 +395,13 @@ Bootstrap reference: `_docs/02_tasks/todo/AZ-263_initial_structure.md`. Architec
 
 - **Directory**: `src/gps_denied_onboard/replay_input/`
 - **Purpose**: Layer-4 cross-cutting coordinator that converges `(video, tlog)` inputs into the standard `FrameSource` + `FcAdapter` + `Clock` surfaces the airborne composition root consumes. Owns the time-alignment between video frames and tlog IMU/attitude ticks (manual via `--time-offset-ms` or automatic via the AZ-405 IMU-take-off detector). The composition root, in replay mode, builds a `ReplayInputAdapter`, calls `.open()`, and wires the returned `ReplayInputBundle` into the same C1–C5 pipeline as live. New under ADR-011 (replaces the v1.0.0 design where replay was a separate composition root).
-  - `__init__.py` (re-exports `ReplayInputAdapter`, `ReplayInputBundle`, `AutoSyncDecision`, `AutoSyncConfig`)
+  - `__init__.py` (re-exports `ReplayInputAdapter`, `ReplayInputBundle`, `AutoSyncDecision`, `AutoSyncConfig`, `ReplayInputAdapterError`, plus the AZ-697 / AZ-836 surfaces: `TlogGpsFix`, `TlogGroundTruth`, `load_tlog_ground_truth`, `RouteSpec`, `RouteExtractionError`, `extract_route_from_tlog`)
-  - `interface.py` (`ReplayInputAdapter` class declaration + `ReplayInputBundle` DTO)
+  - `interface.py` (`ReplayInputAdapter` class declaration + `ReplayInputBundle` DTO + `AlignedWindow` / `AutoSyncConfig` / `AutoSyncDecision` DTOs)
+  - `errors.py` (AZ-405 — `ReplayInputAdapterError` envelope; subclass of `RuntimeError` so the airborne main maps every coordinator-scope failure to CLI exit code 2)
   - `tlog_video_adapter.py` (concrete `ReplayInputAdapter` that instantiates `VideoFileFrameSource` + `TlogReplayFcAdapter` + chosen `Clock`)
   - `auto_sync.py` (AZ-405 IMU-take-off / video-motion-onset detectors + combined offset computation + AC-8 frame-window-match validator)
+  - `tlog_ground_truth.py` (AZ-697 — `load_tlog_ground_truth` + `TlogGpsFix` / `TlogGroundTruth` for direct binary tlog GPS-truth extraction; consumed by `helpers.gps_compare` and `tlog_route.py`)
+  - `tlog_route.py` (AZ-836 — `extract_route_from_tlog` + `RouteExtractionError`; re-exports `RouteSpec` from `_types.route`. Reduces a tlog to a coarsened route via Douglas-Peucker on local ENU; consumed by `c11_tile_manager.route_client.SatelliteProviderRouteClient.seed_route`)
   - `tests/`
 - **Owned by**: AZ-265 (E-DEMO-REPLAY) — task AZ-405 (auto-sync + coordinator).
 - **Consumed by**: `runtime_root` (replay-mode branch of `compose_root`); `cli/replay.py`. Layer-4 module: imports from Layer 1 (`frame_source` interface, `clock` interface, `_types`, `config`, `logging`, `fdr_client`, `helpers.wgs_converter`) and instantiates Layer-4 strategies (`c8_fc_adapter.tlog_replay_adapter`, `frame_source.video_file_frame_source`). Does NOT import from Layer 3 (no component-level dependencies).

_docs/_autodev_state.md

@@ -6,9 +6,9 @@ step: 10
 name: Implement
 status: in_progress
 sub_step:
-  phase: 4
+  phase: 7
-  name: refactor-execution
+  name: batch-commit
-  detail: "02-az507; Phase 3 green; delegate to implement skill for AZ-845/846/847"
+  detail: ""
 retry_count: 0
 cycle: 3
 tracker: jira

_docs/_process_leftovers/2026-05-24_az847_rule9_wording_followup.md

@@ -0,0 +1,58 @@
+# AZ-847 — Rule-9 wording follow-up (doc-only)
+
+**Timestamp**: 2026-05-24T10:05:00+03:00
+**Type**: Decision log + deferred doc-only work item
+**Decision-maker**: agent (user skipped Choose A/B/C/D twice — implicit authorization to proceed with reasoned default)
+
+## Context
+
+AZ-847 widens `tests/unit/test_az270_compose_root.py::test_ac6_only_compose_root_imports_concrete_strategies` to enforce the full rule-9 allow-list documented in `_docs/02_document/module-layout.md`. Implementation surfaced two pre-existing rule-9 violations not anticipated by the task spec:
+
+1. **`components/c1_vio/bench/okvis2.py`** — top-level `from gps_denied_onboard.runtime_root.vio_factory import build_vio_strategy`. The bench module legitimately constructs production strategies via the composition root for measurement purposes (its job).
+2. **`components/c4_pose/opencv_gtsam_estimator.py`**, **`components/c5_state/eskf_baseline.py`**, **`components/c5_state/gtsam_isam2_estimator.py`** — lazy `from gps_denied_onboard.runtime_root.<X>_factory import register_<X>_*` inside `def register():`. This is the central-registry self-registration pattern; components plug their `create()` callable into the airborne bootstrap registry by calling `register_<X>_*(_STRATEGY, create)`.
+
+Per AZ-847 Risk 1, both discoveries were surfaced to the user via Choose A/B/C/D (twice — once for bench/, once for self-registration). The user skipped both. Agent proceeded with principled defaults documented in the test docstring:
+
+- **bench/ exclusion**: `components/<X>/bench/**` paths are skipped at lint time.
+- **Self-registration carve-out**: `ImportFrom` whose module starts with `gps_denied_onboard.runtime_root.` AND every imported name starts with `register_` is allowed. `build_*`, `compose_root`, error envelopes, etc. from `runtime_root.*` remain forbidden.
+
+Both carve-outs are layered defense — bench/ skip handles measurement-code legitimate `build_*` use; self-registration carve-out handles production registry pattern. Together they let the widened lint pass on the current codebase (zero violations after AZ-845 lands) while preserving rule-9's intent: components must not reach for OTHER components' concrete impls.
+
+## What this leftover defers
+
+This leftover defers the **rule-9 wording update** in `_docs/02_document/module-layout.md` (rule 9, Layout Rules section). The current rule wording lists 8 allow-list entries and ends with: "The composition root (`runtime_root/*`) is the single exception". This sentence does NOT cover:
+
+- `components/<X>/bench/**` files (rule-9 not applicable; measurement code).
+- Lazy `register_*` self-registration imports from `runtime_root.<X>_factory` (registry pattern).
+
+Both carve-outs are documented in the test docstring at `tests/unit/test_az270_compose_root.py::test_ac6_only_compose_root_imports_concrete_strategies` (post-AZ-847). To stay honest, the rule-9 wording in `module-layout.md` should be extended to mention these two carve-outs — otherwise reviewers reading rule 9 in isolation will see an apparent mismatch between rule 9 (strict) and the lint (with documented carve-outs).
+
+## Replay condition
+
+This is **NOT** a tracker write blocker — no Jira call is being deferred. It's a **doc-only follow-up**:
+
+- Update rule 9 wording in `_docs/02_document/module-layout.md` to explicitly mention:
+  - `components/<X>/bench/**` is exempt from rule 9 (benchmark code legitimately constructs production strategies).
+  - `ImportFrom` of `register_*` callables from `runtime_root.<X>_factory` is allowed for the self-registration pattern.
+- Surface this leftover at the start of the next /autodev invocation. The user can either:
+  - Authorize a tiny doc-only ticket (1 SP) to make the rule-9 update.
+  - Bundle the rule-9 update into the cycle-3 retrospective output (Step 17) as part of "carry-overs to next cycle".
+  - Choose a different remediation (e.g., refactor `register_*` helpers into `helpers/strategy_registry.py` so rule 9 stays strict — this was Option C of the original Choose).
+
+Until the wording is updated, the test docstring is the source of truth for the carve-outs. Reviewers should consult both rule 9 AND the docstring.
+
+## Why a leftover, not a new ticket
+
+- Per `.cursor/rules/tracker.mdc`: a leftover is appropriate for "deferred doc work" when the blocking factor is "user input on remediation strategy". The user skipped twice; the doc-only update is a small concern that fits the cycle-3 retro better than a standalone PBI.
+- Per user complexity rule (`Create PBI with 2 or 3 points of complexity, could be 5`): this is < 1 SP work, below the typical PBI threshold.
+- The technical work (the lint with documented carve-outs) is shipping in AZ-847; the doc-wording update is purely an audit-trail exercise that doesn't block any other work.
+
+## Replay action
+
+On next /autodev invocation, surface this leftover to the user as part of B1 (Process leftovers) and ask whether to:
+
+- (i) update rule-9 wording in module-layout.md now (~1 SP doc edit);
+- (ii) bundle into cycle-3 retro output;
+- (iii) refactor `register_*` helpers out of `runtime_root.*` into `helpers/strategy_registry.py` (option C of the original Choose; bigger scope).
+
+If user picks (i) or (ii), this leftover is consumed. If (iii), file a new ticket for the refactor and keep this leftover until the refactor lands and the carve-out is removed from the lint.

src/gps_denied_onboard/_types/route.py

@@ -0,0 +1,43 @@
+"""Route DTO shared between replay_input/ (producer) and c11_tile_manager/ (consumer).
+
+Lives in ``_types/`` per ``module-layout.md`` rule 9 — DTOs that cross
+component boundaries are owned here so ``components/<X>/*.py`` can
+import them under the rule-9 allow-list without referencing other
+Layer-4 coordinators.
+
+Producer: ``replay_input.tlog_route.extract_route_from_tlog`` (AZ-836).
+Consumer: ``components.c11_tile_manager.route_client.SatelliteProviderRouteClient.seed_route`` (AZ-838).
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass(frozen=True, slots=True)
+class RouteSpec:
+    """Coarsened flight route extracted from a tlog.
+
+    Attributes:
+        waypoints: ``(lat_deg, lon_deg)`` pairs along the active
+            segment in chronological order. Length is between 1 and
+            the caller's ``max_waypoints``.
+        suggested_region_size_meters: Per-waypoint coverage radius
+            (meters) suggested for the satellite-provider region
+            request — currently the caller-supplied
+            ``region_size_meters``.
+        source_tlog: Provenance — path to the tlog this route was
+            extracted from.
+        source_segment: ``(start_idx, end_idx)`` inclusive bounds into
+            the underlying tlog GPS row list. ``end_idx`` is the index
+            of the last row in the active segment.
+        total_distance_meters: Along-track great-circle distance of
+            the un-coarsened active segment in meters.
+    """
+
+    waypoints: tuple[tuple[float, float], ...]
+    suggested_region_size_meters: float
+    source_tlog: Path
+    source_segment: tuple[int, int]
+    total_distance_meters: float

src/gps_denied_onboard/components/c11_tile_manager/route_client.py

@@ -1,7 +1,7 @@
 """C11 ``SatelliteProviderRouteClient`` (AZ-838 / Epic AZ-835 C2).
 
 Operator-side HTTP client for the parent-suite Route API. Takes a
-:class:`gps_denied_onboard.replay_input.tlog_route.RouteSpec` (produced
+:class:`gps_denied_onboard._types.route.RouteSpec` (produced
 by AZ-836 / C1) and onboards it with ``satellite-provider``:
 
 1. **Pre-emptive validation** mirrors the AZ-809
@@ -48,12 +48,12 @@ from typing import Any
 
 import httpx
 
+from gps_denied_onboard._types.route import RouteSpec
 from gps_denied_onboard.components.c11_tile_manager.errors import (
     RouteTerminalFailureError,
     RouteTransientError,
     RouteValidationError,
 )
-from gps_denied_onboard.replay_input.tlog_route import RouteSpec
 
 __all__ = [
     "RouteSeedResult",

src/gps_denied_onboard/replay_input/__init__.py

@@ -19,6 +19,7 @@ root's wiring needs; tests import the detectors via their full module
 path.
 """
 
+from gps_denied_onboard._types.route import RouteSpec
 from gps_denied_onboard.replay_input.errors import ReplayInputAdapterError
 from gps_denied_onboard.replay_input.interface import (
     AlignedWindow,
@@ -33,7 +34,6 @@ from gps_denied_onboard.replay_input.tlog_ground_truth import (
 )
 from gps_denied_onboard.replay_input.tlog_route import (
     RouteExtractionError,
-    RouteSpec,
     extract_route_from_tlog,
 )
 from gps_denied_onboard.replay_input.tlog_video_adapter import ReplayInputAdapter

src/gps_denied_onboard/replay_input/tlog_route.py

@@ -21,10 +21,10 @@ from __future__ import annotations
 
 import logging
 import math
-from dataclasses import dataclass
 from pathlib import Path
 
 from gps_denied_onboard._types.geo import LatLonAlt
+from gps_denied_onboard._types.route import RouteSpec
 from gps_denied_onboard.helpers.gps_compare import l2_horizontal_m
 from gps_denied_onboard.helpers.wgs_converter import WgsConverter
 from gps_denied_onboard.replay_input.errors import ReplayInputAdapterError
@@ -51,34 +51,6 @@ class RouteExtractionError(ReplayInputAdapterError):
     """Raised when a tlog cannot be reduced to a :class:`RouteSpec`."""
 
 
-@dataclass(frozen=True, slots=True)
-class RouteSpec:
-    """Coarsened flight route extracted from a tlog.
-
-    Attributes:
-        waypoints: ``(lat_deg, lon_deg)`` pairs along the active
-            segment in chronological order. Length is between 1 and
-            the caller's ``max_waypoints``.
-        suggested_region_size_meters: Per-waypoint coverage radius
-            (meters) suggested for the satellite-provider region
-            request — currently the caller-supplied
-            ``region_size_meters``.
-        source_tlog: Provenance — path to the tlog this route was
-            extracted from.
-        source_segment: ``(start_idx, end_idx)`` inclusive bounds into
-            the underlying tlog GPS row list. ``end_idx`` is the index
-            of the last row in the active segment.
-        total_distance_meters: Along-track great-circle distance of
-            the un-coarsened active segment in meters.
-    """
-
-    waypoints: tuple[tuple[float, float], ...]
-    suggested_region_size_meters: float
-    source_tlog: Path
-    source_segment: tuple[int, int]
-    total_distance_meters: float
-
-
 def extract_route_from_tlog(
     tlog: Path,
     *,

tests/e2e/replay/_operator_pre_flight.py

@@ -69,7 +69,7 @@ from gps_denied_onboard.components.c6_tile_cache.faiss_descriptor_index import (
     META_SUFFIX,
 )
 from gps_denied_onboard.helpers.sha256_sidecar import SIDECAR_SUFFIX
-from gps_denied_onboard.replay_input.tlog_route import RouteSpec
+from gps_denied_onboard._types.route import RouteSpec
 
 __all__ = [
     "PopulatedC6Cache",

tests/e2e/replay/test_e2e_orchestrator_unit.py

@@ -34,7 +34,7 @@ import yaml
 from gps_denied_onboard.helpers.accuracy_report import (
     AC3_GATE_THRESHOLD_M,
 )
-from gps_denied_onboard.replay_input.tlog_route import RouteSpec
+from gps_denied_onboard._types.route import RouteSpec
 
 from tests.e2e.replay._e2e_orchestrator import (
     OrchestrationFailure,

tests/e2e/replay/test_operator_pre_flight_driver.py

@@ -58,7 +58,7 @@ from gps_denied_onboard.components.c6_tile_cache.faiss_descriptor_index import (
     META_SUFFIX,
 )
 from gps_denied_onboard.helpers.sha256_sidecar import SIDECAR_SUFFIX
-from gps_denied_onboard.replay_input.tlog_route import RouteSpec
+from gps_denied_onboard._types.route import RouteSpec
 
 from tests.e2e.replay._operator_pre_flight import (
     PopulatedC6Cache,

tests/unit/c11_tile_manager/test_route_client.py

@@ -46,7 +46,7 @@ from gps_denied_onboard.components.c11_tile_manager.route_client import (
     RouteSeedResult,
     SatelliteProviderRouteClient,
 )
-from gps_denied_onboard.replay_input.tlog_route import RouteSpec
+from gps_denied_onboard._types.route import RouteSpec
 
 _BASE_URL = "https://parent-suite.test"
 _JWT = "test-jwt-az838"

tests/unit/replay_input/test_tlog_route.py

@@ -43,9 +43,9 @@ from gps_denied_onboard.replay_input.tlog_ground_truth import (
     TlogGpsFix,
     TlogGroundTruth,
 )
+from gps_denied_onboard._types.route import RouteSpec
 from gps_denied_onboard.replay_input.tlog_route import (
     RouteExtractionError,
-    RouteSpec,
     extract_route_from_tlog,
 )
 
@@ -378,3 +378,30 @@ def test_active_segment_too_short_raises_route_extraction_error(
     # Act / Assert
     with pytest.raises(RouteExtractionError, match="active segment too short"):
         extract_route_from_tlog(tlog)
+
+
+# AZ-845 AC-3 + AC-4 — RouteSpec relocation re-export + package identity ----
+
+
+def test_az845_routespec_canonical_home_and_reexport_identity() -> None:
+    """AZ-845 AC-3 + AC-4: ``RouteSpec`` lives in ``_types.route`` and
+    every documented import path resolves to the same class object."""
+    # Arrange / Act
+    from gps_denied_onboard import replay_input as replay_input_pkg
+    from gps_denied_onboard._types.route import RouteSpec as canonical
+    from gps_denied_onboard.replay_input.tlog_route import (
+        RouteSpec as via_producer,
+    )
+    from gps_denied_onboard.replay_input.tlog_route import (
+        __all__ as producer_all,
+    )
+
+    # Assert — AC-3: tlog_route re-exports RouteSpec through __all__,
+    # so `from replay_input.tlog_route import RouteSpec` keeps working.
+    assert via_producer is canonical
+    assert "RouteSpec" in producer_all
+    # Assert — AC-4: `from gps_denied_onboard.replay_input import RouteSpec`
+    # resolves to the canonical class object.
+    assert replay_input_pkg.RouteSpec is canonical
+    # Assert — AC-1 (canonical home): __module__ is the relocated path.
+    assert canonical.__module__ == "gps_denied_onboard._types.route"

tests/unit/test_az270_compose_root.py

@@ -26,6 +26,51 @@ from gps_denied_onboard.runtime_root import (
 _REPO_ROOT = Path(__file__).resolve().parents[2]
 
 
+# AZ-847 — full rule-9 allow-list (single source of truth for the widened
+# lint below). Mirrors `_docs/02_document/module-layout.md` rule 9
+# "AZ-507 cross-component contract surface".
+_RULE_9_ALLOW_EXACT_MODULES: frozenset[str] = frozenset(
+    {
+        "gps_denied_onboard._types",
+        "gps_denied_onboard.helpers",
+        "gps_denied_onboard.clock",
+        "gps_denied_onboard.config",
+        "gps_denied_onboard.logging",
+        "gps_denied_onboard.fdr_client",
+        # frame_source: interface-only per rule 9. The package root is allowed
+        # because its `__init__.py` re-exports only the interface; concrete
+        # implementations live in `frame_source.live_camera` /
+        # `frame_source.video_file` and MUST be reached via DI from the
+        # composition root, never imported by a Layer-3 component directly.
+        "gps_denied_onboard.frame_source",
+        "gps_denied_onboard.frame_source.interface",
+    }
+)
+_RULE_9_ALLOW_PACKAGE_PREFIXES: tuple[str, ...] = (
+    "gps_denied_onboard._types.",
+    "gps_denied_onboard.helpers.",
+    "gps_denied_onboard.clock.",
+    "gps_denied_onboard.config.",
+    "gps_denied_onboard.logging.",
+    "gps_denied_onboard.fdr_client.",
+)
+
+
+def _is_rule9_allowed_import(module: str, *, own_component: str) -> bool:
+    """Apply the rule-9 allow-list to a `gps_denied_onboard.*` import string.
+
+    Returns True iff `module` matches one of: (1) the importing component's
+    own subpackage, (2) a documented allow-list leaf module, (3) a documented
+    allow-list package prefix.
+    """
+    own_pkg = f"gps_denied_onboard.components.{own_component}"
+    if module == own_pkg or module.startswith(own_pkg + "."):
+        return True
+    if module in _RULE_9_ALLOW_EXACT_MODULES:
+        return True
+    return any(module.startswith(p) for p in _RULE_9_ALLOW_PACKAGE_PREFIXES)
+
+
 @dataclass(frozen=True)
 class _C1Block:
     strategy: str = "okvis2"
@@ -192,42 +237,106 @@ def test_ac5_construction_order_respects_dependencies(_airborne_env: None) -> No
 
 
 def test_ac6_only_compose_root_imports_concrete_strategies() -> None:
-    """Architecture lint: no module under ``components.*`` imports another component's concrete strategy.
+    """Architecture lint — full rule-9 allow-list enforcement (AZ-847 widening).
 
-    We accept only:
+    Source of truth: ``_docs/02_document/module-layout.md`` rule 9
-    * the composition root (``runtime_root.py``);
+    "AZ-507 cross-component contract surface". For every
-    * per-component public re-exports inside the component's own subpackage
+    ``components/<X>/*.py`` file, an ``ImportFrom`` or ``Import`` node
-      (e.g. ``components.c5_state`` importing ``components.c5_state.interface``).
+    referring to a ``gps_denied_onboard.*`` module is allowed iff it
-    Imports across components (e.g. ``components.c5_state`` importing
+    matches one of:
-    ``components.c1_vio.okvis2``) are violations.
+
+    1. The component's own subpackage
+       (``gps_denied_onboard.components.<X>`` or ``...<X>.*``).
+    2. ``gps_denied_onboard._types`` or any submodule (incl.
+       ``_types.inference_errors``, ``_types.route``, etc.).
+    3. ``gps_denied_onboard.helpers`` or any submodule.
+    4. ``gps_denied_onboard.config`` / ``logging`` / ``fdr_client`` /
+       ``clock``, or any submodule of those packages.
+    5. ``gps_denied_onboard.frame_source`` or
+       ``gps_denied_onboard.frame_source.interface`` only.
+
+    AST-level disambiguation (Risk 2 of AZ-847): rule 9 limits
+    ``frame_source`` to interface-only, but the package's ``__init__.py``
+    re-exports only the interface symbols, so allow-listing the package
+    root is safe. Concrete implementations
+    (``frame_source.live_camera`` / ``frame_source.video_file``) and the
+    error envelope (``frame_source.errors``) are intentionally NOT in
+    the allow-list — they must be reached via constructor injection
+    from the composition root, never imported by a Layer-3 component.
+
+    Bench-code disambiguation: ``components/<X>/bench/**`` files are
+    skipped because benchmark / measurement code legitimately
+    constructs production strategies via ``runtime_root.*`` factories
+    (that is its job). Rule 9 governs production runtime code, not
+    measurement harnesses. Surfaced to the user during AZ-847
+    implementation as a discovered architectural decision; documented
+    here as a principled exclusion. A separate doc-only follow-up will
+    propagate this exclusion into the rule-9 wording in
+    ``module-layout.md``.
+
+    Self-registration carve-out: components plug into the central
+    strategy registry by lazy-importing ``register_<X>_*`` helpers from
+    ``gps_denied_onboard.runtime_root.<X>_factory`` inside their
+    ``register()`` function (e.g.
+    ``c5_state.gtsam_isam2_estimator.register`` →
+    ``runtime_root.state_factory.register_state_estimator``). This is
+    the registry pattern, NOT cross-component coupling. The lint
+    permits exactly this case: an ``ImportFrom`` whose module starts
+    with ``gps_denied_onboard.runtime_root.`` AND every imported name
+    starts with ``register_``. Anything else from ``runtime_root.*``
+    (e.g. ``build_*`` factories, ``compose_root``,
+    ``StrategyNotLinkedError``) inside a Layer-3 component remains a
+    violation. Surfaced as a discovered architectural decision during
+    AZ-847; same doc-only follow-up that updates rule-9 wording for
+    bench/ will also document the self-registration carve-out.
+
+    AZ-270 audit-trail compatibility (AC-2): this lint is a strict
+    superset of the original AZ-270 AC-6 narrow check (cross-component
+    imports). Every edge previously flagged is still flagged, plus new
+    edges into ``replay_input``, ``replay_api``, ``cli/*``,
+    non-allow-listed ``frame_source`` submodules, and any
+    ``runtime_root.*`` import that is NOT a ``register_*`` self-
+    registration helper.
     """
     components_root = _REPO_ROOT / "src" / "gps_denied_onboard" / "components"
     violations: list[str] = []
     for module_path in components_root.rglob("*.py"):
-        own_component = module_path.relative_to(components_root).parts[0]
+        relative_parts = module_path.relative_to(components_root).parts
+        if "bench" in relative_parts:
+            continue
+        own_component = relative_parts[0]
         try:
             tree = ast.parse(module_path.read_text(encoding="utf-8"))
         except SyntaxError:
             continue
         for node in ast.walk(tree):
+            module_names: tuple[str, ...]
             if isinstance(node, ast.ImportFrom) and node.module:
-                if node.module.startswith("gps_denied_onboard.components."):
+                if (
-                    referenced = node.module.split(".")[2]
+                    node.module.startswith("gps_denied_onboard.runtime_root.")
-                    if referenced != own_component:
+                    and node.names
-                        violations.append(
+                    and all(alias.name.startswith("register_") for alias in node.names)
-                            f"{module_path.relative_to(_REPO_ROOT)} imports {node.module}"
+                ):
-                        )
+                    continue
+                module_names = (node.module,)
             elif isinstance(node, ast.Import):
-                for alias in node.names:
+                module_names = tuple(alias.name for alias in node.names)
-                    if alias.name.startswith("gps_denied_onboard.components."):
+            else:
-                        referenced = alias.name.split(".")[2]
+                continue
-                        if referenced != own_component:
+            for name in module_names:
+                if not name.startswith("gps_denied_onboard."):
+                    continue
+                if _is_rule9_allowed_import(name, own_component=own_component):
+                    continue
                 violations.append(
-                                f"{module_path.relative_to(_REPO_ROOT)} imports {alias.name}"
+                    f"{module_path.relative_to(_REPO_ROOT)} imports {name} "
+                    "(rule 9 allow-list violation)"
                 )
     assert not violations, (
-        "components.* may not import other components — only the composition root may; "
+        "components/**/*.py imports MUST stay within the rule-9 allow-list "
-        f"violations: {violations}"
+        "(see _docs/02_document/module-layout.md rule 9 — AZ-507 "
+        "cross-component contract surface). Violations:\n  - "
+        + "\n  - ".join(violations)
     )