MockWorld Map¶

All Fake adapters under src/mockworld/fakes/ (classes with _is_fake_adapter = True; nested-record dataclasses are filtered out), the *Port each implements (by name match), and the scenarios that wire them. Per ADR-0022 (MockWorld) and ADR-0047 (fake-adapter contract testing).

Fakes¶

Fake	Implements	Used in scenarios
FakeAgent	`AgentPort`	—
FakeBeads	`BeadsPort`	`tests/scenarios/fakes/test_fake_beads.py` `tests/scenarios/fakes/test_mock_world.py` `tests/scenarios/fuzz/test_invariants.py` `tests/scenarios/test_bead_workflow.py`
FakeBotPR	`BotPRPort`	—
FakeClock	`ClockPort`	`tests/scenarios/behaviors/test_latency.py` `tests/scenarios/fakes/test_fake_clock.py` `tests/scenarios/fakes/test_supporting_fakes.py` `tests/scenarios/test_fidelity.py`
FakeDocker	`DockerPort`	`tests/scenarios/fakes/test_fake_docker.py` `tests/scenarios/fakes/test_fake_subprocess_runner.py`
FakeFS	`FSPort`	`tests/scenarios/fakes/test_fake_fs.py`
FakeGit	`GitPort`	`tests/scenarios/behaviors/test_eventual_consistency.py` `tests/scenarios/behaviors/test_flaky.py` `tests/scenarios/behaviors/test_latency.py` `tests/scenarios/behaviors/test_rate_limit.py` `tests/scenarios/browser/scenarios/test_loops_browser.py` `tests/scenarios/fakes/test_fake_git.py` `tests/scenarios/fakes/test_fake_github.py` `tests/scenarios/fakes/test_mock_world.py` `tests/scenarios/fuzz/test_invariants.py` `tests/scenarios/test_auto_agent_redrive_scenario.py` `tests/scenarios/test_caretaker_loops_part2.py` `tests/scenarios/test_fidelity.py` `tests/scenarios/test_find_class_fold_scenario.py` `tests/scenarios/test_loops.py` `tests/scenarios/test_memory_backlog_scenario.py` `tests/scenarios/test_pr_unsticker_scope_scenario.py` `tests/scenarios/test_workspace_gc_landed_guard_scenario.py`
FakeGitHub	`GitHubPort`	`tests/scenarios/behaviors/test_eventual_consistency.py` `tests/scenarios/behaviors/test_flaky.py` `tests/scenarios/behaviors/test_latency.py` `tests/scenarios/behaviors/test_rate_limit.py` `tests/scenarios/browser/scenarios/test_loops_browser.py` `tests/scenarios/fakes/test_fake_github.py` `tests/scenarios/fakes/test_mock_world.py` `tests/scenarios/fuzz/test_invariants.py` `tests/scenarios/test_auto_agent_redrive_scenario.py` `tests/scenarios/test_caretaker_loops_part2.py` `tests/scenarios/test_fidelity.py` `tests/scenarios/test_find_class_fold_scenario.py` `tests/scenarios/test_loops.py` `tests/scenarios/test_memory_backlog_scenario.py` `tests/scenarios/test_pr_unsticker_scope_scenario.py` `tests/scenarios/test_workspace_gc_landed_guard_scenario.py`
FakeHTTP	`HTTPPort`	`tests/scenarios/fakes/test_fake_http.py`
FakeIssueFetcher	`IssueFetcherPort`	—
FakeIssueStore	`IssueStorePort`	`tests/scenarios/test_epic_replan_ownership_scenario.py` `tests/scenarios/test_pipeline_boot_readiness_scenario.py` `tests/scenarios/test_pipeline_snapshot_terminal_status_scenario.py`
FakeLLM	`LLMPort`	`tests/scenarios/behaviors/test_quota.py` `tests/scenarios/fakes/test_fake_llm.py` `tests/scenarios/fakes/test_fake_llm_streaming.py` `tests/scenarios/fakes/test_prior_failure_propagation.py` `tests/scenarios/test_fidelity.py`
FakeObservability	`ObservabilityPort`	`tests/scenarios/fakes/test_supporting_fakes.py`
FakeReviewInsightStore	`ReviewInsightStorePort`	—
FakeRouteBackCounter	`RouteBackCounterPort`	—
FakeSubprocessRunner	`SubprocessRunnerPort`	`tests/scenarios/fakes/test_fake_subprocess_runner.py`
FakeWikiCompiler	`WikiCompilerPort`	`tests/scenarios/test_repo_wiki_compile_scenario.py`
FakeWorkspace	`WorkspacePort`	`tests/scenarios/fakes/test_supporting_fakes.py` `tests/scenarios/test_workspace_gc_dead_registration_scenario.py` `tests/scenarios/test_workspace_gc_landed_guard_scenario.py`

Wiring¶

graph LR
    FakeAgent -.-> AgentPort
    FakeBeads -.-> BeadsPort
    tests_scenarios_fakes_test_fake_beads_py([tests/scenarios/fakes/test_fake_beads.py]) --> FakeBeads
    tests_scenarios_fakes_test_mock_world_py([tests/scenarios/fakes/test_mock_world.py]) --> FakeBeads
    tests_scenarios_fuzz_test_invariants_py([tests/scenarios/fuzz/test_invariants.py]) --> FakeBeads
    FakeBotPR -.-> BotPRPort
    FakeClock -.-> ClockPort
    tests_scenarios_behaviors_test_latency_py([tests/scenarios/behaviors/test_latency.py]) --> FakeClock
    tests_scenarios_fakes_test_fake_clock_py([tests/scenarios/fakes/test_fake_clock.py]) --> FakeClock
    tests_scenarios_fakes_test_supporting_fakes_py([tests/scenarios/fakes/test_supporting_fakes.py]) --> FakeClock
    FakeDocker -.-> DockerPort
    tests_scenarios_fakes_test_fake_docker_py([tests/scenarios/fakes/test_fake_docker.py]) --> FakeDocker
    tests_scenarios_fakes_test_fake_subprocess_runner_py([tests/scenarios/fakes/test_fake_subprocess_runner.py]) --> FakeDocker
    FakeFS -.-> FSPort
    tests_scenarios_fakes_test_fake_fs_py([tests/scenarios/fakes/test_fake_fs.py]) --> FakeFS
    FakeGit -.-> GitPort
    tests_scenarios_behaviors_test_eventual_consistency_py([tests/scenarios/behaviors/test_eventual_consistency.py]) --> FakeGit
    tests_scenarios_behaviors_test_flaky_py([tests/scenarios/behaviors/test_flaky.py]) --> FakeGit
    tests_scenarios_behaviors_test_latency_py([tests/scenarios/behaviors/test_latency.py]) --> FakeGit
    FakeGitHub -.-> GitHubPort
    tests_scenarios_behaviors_test_eventual_consistency_py([tests/scenarios/behaviors/test_eventual_consistency.py]) --> FakeGitHub
    tests_scenarios_behaviors_test_flaky_py([tests/scenarios/behaviors/test_flaky.py]) --> FakeGitHub
    tests_scenarios_behaviors_test_latency_py([tests/scenarios/behaviors/test_latency.py]) --> FakeGitHub
    FakeHTTP -.-> HTTPPort
    tests_scenarios_fakes_test_fake_http_py([tests/scenarios/fakes/test_fake_http.py]) --> FakeHTTP
    FakeIssueFetcher -.-> IssueFetcherPort
    FakeIssueStore -.-> IssueStorePort
    tests_scenarios_test_epic_replan_ownership_scenario_py([tests/scenarios/test_epic_replan_ownership_scenario.py]) --> FakeIssueStore
    tests_scenarios_test_pipeline_boot_readiness_scenario_py([tests/scenarios/test_pipeline_boot_readiness_scenario.py]) --> FakeIssueStore
    tests_scenarios_test_pipeline_snapshot_terminal_status_scenario_py([tests/scenarios/test_pipeline_snapshot_terminal_status_scenario.py]) --> FakeIssueStore
    FakeLLM -.-> LLMPort
    tests_scenarios_behaviors_test_quota_py([tests/scenarios/behaviors/test_quota.py]) --> FakeLLM
    tests_scenarios_fakes_test_fake_llm_py([tests/scenarios/fakes/test_fake_llm.py]) --> FakeLLM
    tests_scenarios_fakes_test_fake_llm_streaming_py([tests/scenarios/fakes/test_fake_llm_streaming.py]) --> FakeLLM
    FakeObservability -.-> ObservabilityPort
    tests_scenarios_fakes_test_supporting_fakes_py([tests/scenarios/fakes/test_supporting_fakes.py]) --> FakeObservability
    FakeReviewInsightStore -.-> ReviewInsightStorePort
    FakeRouteBackCounter -.-> RouteBackCounterPort
    FakeSubprocessRunner -.-> SubprocessRunnerPort
    tests_scenarios_fakes_test_fake_subprocess_runner_py([tests/scenarios/fakes/test_fake_subprocess_runner.py]) --> FakeSubprocessRunner
    FakeWikiCompiler -.-> WikiCompilerPort
    tests_scenarios_test_repo_wiki_compile_scenario_py([tests/scenarios/test_repo_wiki_compile_scenario.py]) --> FakeWikiCompiler
    FakeWorkspace -.-> WorkspacePort
    tests_scenarios_fakes_test_supporting_fakes_py([tests/scenarios/fakes/test_supporting_fakes.py]) --> FakeWorkspace
    tests_scenarios_test_workspace_gc_dead_registration_scenario_py([tests/scenarios/test_workspace_gc_dead_registration_scenario.py]) --> FakeWorkspace
    tests_scenarios_test_workspace_gc_landed_guard_scenario_py([tests/scenarios/test_workspace_gc_landed_guard_scenario.py]) --> FakeWorkspace