Skip to content

Integration Test Map

Generated: 2026-04-04 03:23 UTC

89 tests across 9 directories

(root)/

Test Class File
test_dns_resolves TestBypassContainerConnectivity tests/integration/test_bypass_connectivity.py
test_outbound_http_reachable TestBypassContainerConnectivity tests/integration/test_bypass_connectivity.py
test_shield_down_does_not_break_connectivity TestBypassContainerConnectivity tests/integration/test_bypass_connectivity.py
test_allowed_domain_reachable TestShieldedContainerLifecycle tests/integration/test_container_e2e.py
test_blocked_by_default TestShieldedContainerLifecycle tests/integration/test_container_e2e.py
test_clone_via_gate TestShieldedContainerLifecycle tests/integration/test_container_e2e.py
test_dns_resolves TestShieldedContainerLifecycle tests/integration/test_container_e2e.py
test_global_hooks_detected TestHooksInstalled tests/integration/test_shield_hooks.py
test_hooks_dir_contains_hook_json TestHooksInstalled tests/integration/test_shield_hooks.py
test_multiple_loopback_ports TestPreStartIntegration tests/integration/test_shield_no_podman.py
test_no_loopback_ports TestPreStartIntegration tests/integration/test_shield_no_podman.py
test_pasta_with_loopback_port TestPreStartIntegration tests/integration/test_shield_no_podman.py
test_rootful_no_network_args TestPreStartIntegration tests/integration/test_shield_no_podman.py
test_slirp4netns TestPreStartIntegration tests/integration/test_shield_no_podman.py
test_compose_profiles_returns_domains TestProfilesIntegration tests/integration/test_shield_no_podman.py
test_list_profiles_includes_bundled TestProfilesIntegration tests/integration/test_shield_no_podman.py
test_bypass_uses_pasta_networking TestSandboxRunShieldIntegration tests/integration/test_shield_no_podman.py
test_bypass_uses_slirp4netns_networking TestSandboxRunShieldIntegration tests/integration/test_shield_no_podman.py
test_sandbox_run_includes_shield_args TestSandboxRunShieldIntegration tests/integration/test_shield_no_podman.py
test_unrestricted_skips_no_new_privileges TestSandboxRunShieldIntegration tests/integration/test_shield_no_podman.py
test_status_returns_real_dict TestShieldStatusIntegration tests/integration/test_shield_no_podman.py
test_egress_allowed_after_allow TestShieldEgress tests/integration/test_shield_podman.py
test_egress_blocked_by_default TestShieldEgress tests/integration/test_shield_podman.py
test_allow_then_deny TestShieldEndToEnd tests/integration/test_shield_podman.py
test_container_starts_with_annotations TestShieldEndToEnd tests/integration/test_shield_podman.py
test_shield_rules_returns_ruleset TestShieldEndToEnd tests/integration/test_shield_podman.py
test_01_container_running_after_creation TestShieldRestart tests/integration/test_shield_restart.py
test_02_shield_active_after_creation TestShieldRestart tests/integration/test_shield_restart.py
test_03_rules_present_after_creation TestShieldRestart tests/integration/test_shield_restart.py
test_04_container_stopped TestShieldRestart tests/integration/test_shield_restart.py
test_05_container_running_after_restart TestShieldRestart tests/integration/test_shield_restart.py
test_06_shield_active_after_restart TestShieldRestart tests/integration/test_shield_restart.py
test_07_rules_present_after_restart TestShieldRestart tests/integration/test_shield_restart.py

cli/

Real CLI smoke tests that execute python -m terok.cli against isolated config/state roots. These verify top-level help and command discovery without mocking the parser or dispatch layer.

Test Class File
test_root_help_lists_core_workflows TestCliHelp tests/integration/cli/test_help.py
test_task_help_lists_management_commands TestCliHelp tests/integration/cli/test_help.py

containers/

Test Class File
test_authorship_modes[agent-human] TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_authorship_modes[agent] TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_authorship_modes[human-agent] TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_authorship_modes[human] TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_bash_env_sources_terok_env TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_git_commit_identity[agent-human] TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_git_commit_identity[agent] TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_git_commit_identity[human-agent] TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_git_commit_identity[human] TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_human_env_vars_present TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py
test_identity_function_available_noninteractive TestGitIdentityContainer tests/integration/containers/test_git_identity_container.py

credential_proxy/

Test Class File
test_bypass_returns_empty TestProxyBypassConfig tests/integration/credential_proxy/test_proxy_env_integration.py
test_oauth_credential_direct_transport TestProxyEnvIntegration tests/integration/credential_proxy/test_proxy_env_integration.py
test_oauth_credential_uses_oauth_phantom_env TestProxyEnvIntegration tests/integration/credential_proxy/test_proxy_env_integration.py
test_phantom_token_is_unique_per_task TestProxyEnvIntegration tests/integration/credential_proxy/test_proxy_env_integration.py
test_phantom_tokens_injected_for_stored_provider TestProxyEnvIntegration tests/integration/credential_proxy/test_proxy_env_integration.py
test_proxy_not_running_raises TestProxyEnvIntegration tests/integration/credential_proxy/test_proxy_env_integration.py
test_unstored_providers_excluded TestProxyEnvIntegration tests/integration/credential_proxy/test_proxy_env_integration.py
test_api_key_auth_to_proxy_forwarding TestStoryAuthThroughProxy tests/integration/credential_proxy/test_proxy_stories.py
test_oauth_auth_to_proxy_forwarding TestStoryAuthThroughProxy tests/integration/credential_proxy/test_proxy_stories.py
test_full_env_assembly TestStoryEnvWiring tests/integration/credential_proxy/test_proxy_stories.py
test_revoked_phantom_rejected TestStoryTokenRevocation tests/integration/credential_proxy/test_proxy_stories.py
test_no_ssh_keys_no_ssh_env TestStorySSHAgentEnvWiring tests/integration/credential_proxy/test_ssh_agent_stories.py
test_ssh_agent_env_vars_injected TestStorySSHAgentEnvWiring tests/integration/credential_proxy/test_ssh_agent_stories.py
test_full_sign_flow TestStorySSHAgentSigning tests/integration/credential_proxy/test_ssh_agent_stories.py
test_revoked_token_rejected TestStorySSHAgentTokenRevocation tests/integration/credential_proxy/test_ssh_agent_stories.py

gate/

Host-side git-gate workflows exercised through the real terok CLI: - initial gate-sync - incremental mirror updates from a local upstream - conflict detection for projects that try to share a gate path incorrectly

Test Class File
test_gate_sync_creates_bare_mirror_and_fetches_updates TestGateSync tests/integration/gate/test_sync.py
test_gate_sync_rejects_conflicting_shared_gate TestGateSync tests/integration/gate/test_sync.py

launch/

Launch and restart workflows exercised through the real terok CLI: - task start in CLI mode - task start --web browser-launch workflow - task start --toad browser-served TUI workflow - task restart for previously created tasks These tests use a lightweight fake podman shim so they can validate terok's real CLI orchestration on normal host runners without requiring actual container execution.

Test Class File
test_task_restart_starts_existing_stopped_container TestLaunchWorkflows tests/integration/launch/test_task_start.py
test_task_start_cli_launches_container TestLaunchWorkflows tests/integration/launch/test_task_start.py
test_task_start_toad_launches_browser_tui TestLaunchWorkflows tests/integration/launch/test_task_start.py

projects/

Integration tests for project discovery and derivation. These use the real CLI and on-disk project roots, verifying how terok resolves user-vs-system config locations and writes derived project configs.

Test Class File
test_project_derive_preserves_infra_and_clears_agent TestProjects tests/integration/projects/test_projects.py
test_project_derive_preserves_yaml_comments TestProjects tests/integration/projects/test_projects.py
test_projects_lists_user_and_system_projects TestProjects tests/integration/projects/test_projects.py

setup/

Host-side setup workflows exercised through the real terok CLI: - ssh-init - config/env path resolution used by setup commands - other bootstrap flows that do not require Podman containers

Test Class File
test_ssh_init_creates_default_keypair_and_config TestSshInit tests/integration/setup/test_ssh_init.py
test_ssh_init_respects_custom_host_dir_and_key_name TestSshInit tests/integration/setup/test_ssh_init.py

tasks/

Integration tests for task metadata lifecycle: creating tasks, listing them, renaming them, showing status, and archiving them on delete. These are real filesystem workflows but intentionally avoid podman-dependent task execution.

Test Class File
test_agent_human_mode TestAuthorshipModes tests/integration/tasks/test_git_identity.py
test_agent_mode TestAuthorshipModes tests/integration/tasks/test_git_identity.py
test_human_agent_mode TestAuthorshipModes tests/integration/tasks/test_git_identity.py
test_human_mode TestAuthorshipModes tests/integration/tasks/test_git_identity.py
test_global_authorship_mode_applied TestConfigStackIdentity tests/integration/tasks/test_git_identity.py
test_global_config_overrides_host_git TestConfigStackIdentity tests/integration/tasks/test_git_identity.py
test_host_git_config_autoloaded_as_fallback TestConfigStackIdentity tests/integration/tasks/test_git_identity.py
test_no_host_git_no_global_config_uses_project_yml TestConfigStackIdentity tests/integration/tasks/test_git_identity.py
test_no_identity_anywhere_falls_back_to_nobody TestConfigStackIdentity tests/integration/tasks/test_git_identity.py
test_partial_host_git_name_only TestConfigStackIdentity tests/integration/tasks/test_git_identity.py
test_project_yml_overrides_global_config TestConfigStackIdentity tests/integration/tasks/test_git_identity.py
test_project_yml_overrides_host_git_config TestConfigStackIdentity tests/integration/tasks/test_git_identity.py
test_git_commit_respects_all_modes[agent-human] TestGitCommitIdentity tests/integration/tasks/test_git_identity.py
test_git_commit_respects_all_modes[agent] TestGitCommitIdentity tests/integration/tasks/test_git_identity.py
test_git_commit_respects_all_modes[human-agent] TestGitCommitIdentity tests/integration/tasks/test_git_identity.py
test_git_commit_respects_all_modes[human] TestGitCommitIdentity tests/integration/tasks/test_git_identity.py
test_task_new_creates_workspace_and_lists_tasks TestTaskLifecycle tests/integration/tasks/test_lifecycle.py
test_task_rename_status_and_archive_delete TestTaskLifecycle tests/integration/tasks/test_lifecycle.py