code-coordinator 0.5.241__tar.gz → 0.5.243__tar.gz

{code_coordinator-0.5.241 → code_coordinator-0.5.243}/CLAUDE.md

@@ -123,19 +123,31 @@ Setup / diagnostics (discoverable via `--help`): `coord init`, `coord config`, `
 ## Development
 
 Always work in a virtualenv. Agent workers are spawned with the agent's own
-venv stripped from `PATH` (#402), so a bare `pip install` resolves to system
-Python (PEP 668) — and must **never** target the agent's runtime venv. Create
-your own venv in the checkout (`.venv/` is gitignored):
+pinned venv (`~/.coord-venv` — the live fleet install, not a build artifact)
+stripped from `PATH` and `PIP_REQUIRE_VIRTUALENV=true` set (#402, hardened by
+#2569), so a `pip install` run **without first creating and activating your
+own venv** fails closed instead of silently resolving somewhere unintended
+— and must **never** target the agent's runtime venv. Create your own venv
+in the checkout (`.venv/` is gitignored):
 
 ```bash
-python3 -m venv .venv && . .venv/bin/activate
-pip install -e ".[dev]"
+python3 -m venv .venv && . .venv/bin/activate && pip install -e ".[dev]"
 pytest
 coord plan --dry-run
 coord approve --dry-run 1,2
 coord assign --dry-run precision claude-coordinator 42
 ```
 
+**Never run a bare `pip install` in a worktree as a separate command from
+venv creation (#2569).** The line above is ONE chained command
+(`venv && activate && install`) on purpose — an 11h fleet outage started
+when a worker ran only `pip install -e ".[dev]"` on its own, split off from
+the `venv`/`activate` step, and it silently landed in the live
+`~/.coord-venv` instead of failing. If you ever need to re-run `pip install`
+later in the same session, first confirm you're in an activated venv
+(`echo $VIRTUAL_ENV` should print your worktree's `.venv`, not empty) —
+never assume activation from an earlier command carried forward.
+
 **Workers: scope your test run to your diff, never `pytest` bare (#2169).**
 The full suite exceeds Claude Code's 600s Bash ceiling on this repo and
 duplicates the Test stage + CI, which both run it against your pushed SHA
@@ -208,10 +220,13 @@ versus keep in the coordinator session) are in
   still route issue/PR/milestone reads and writes through the `coord` seam wherever a subcommand
   covers it — that's what keeps the backend-agnostic forge seam
   ([`docs/FORGE_MIGRATION.md`](docs/FORGE_MIGRATION.md)) actually exercised instead of quietly
-  bypassed by the one class of session most likely to reach for `gh` out of habit. Where no `coord`
-  subcommand covers what's needed — a real gap as of 2026-08 (e.g. #2484: `coord issue` has no
-  `list`/`view`) — falling back to `gh` for that one read is fine, but say so and treat it as a gap
-  to flag or file, not a silent workaround.
+  bypassed by the one class of session most likely to reach for `gh` out of habit. Reads are
+  covered too — `coord issue list` and `coord issue view` shipped in #2484, so a plain issue
+  listing/search or an issue-plus-comments lookup has no excuse to reach for `gh`. Where no
+  `coord` subcommand covers what's needed — still a real gap in places as of 2026-08 (e.g. #2643:
+  `coord issue` can create/edit/label/close but cannot post a plain comment on an issue that stays
+  open) — falling back to `gh` for that one call is fine, but say so and treat it as a gap to flag
+  or file, not a silent workaround.
 
 ## Testing — black-box coverage is the acceptance bar
 
@@ -266,6 +281,16 @@ reviewer can stop reading here.
 - [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) — how it all fits together, plus the settled design rationale. Two diagnostic entry points: [why a merge/review isn't happening](docs/ARCHITECTURE.md#when-a-merge-isnt-happening) (**check here first when "Go does nothing"**) and [why an issue is in the Pipeline you never dispatched](docs/ARCHITECTURE.md#when-an-issue-is-sitting-in-the-pipeline-you-never-dispatched).
 - [`docs/COST_DISCIPLINE.md`](docs/COST_DISCIPLINE.md) — dispatch economics; what to send to a worker versus keep in the coordinator session.
 - [`docs/NOTIFIER.md`](docs/NOTIFIER.md) — the "nobody is coming" push channel (`coord notifier`).
+- [`docs/CUSTOMER_PORTAL.md`](docs/CUSTOMER_PORTAL.md) — the coord-portal bridge. **Its
+  [operator runbook](docs/CUSTOMER_PORTAL.md#running-one-end-to-end--the-operator-runbook) is
+  the one to read when a customer request needs turning into coordinator work** — repo
+  creation, the project↔repo mapping, the decomposition session, Gate-A mocks, and how a mock
+  gets back to the client for sign-off, in the order you actually do them.
+- [`docs/CUSTOMER_FACING_APPS.md`](docs/CUSTOMER_FACING_APPS.md) — shipping a repo whose
+  **external** customer judges it by looking at it (natal-chart today). Why `Work → Test →
+  Review → Merge → auto-deploy` makes that customer the first human to see the change, the
+  per-PR preview / `uat` gate / visual-baseline pattern that fixes it, and the manual runbook
+  to use until the gate exists.
 - [`docs/ORACLE_LOOP.md`](docs/ORACLE_LOOP.md) — sealed acceptance suites, Gate-A contracts, the test-author agent.
 - [`docs/PHONE_WEBAPP.md`](docs/PHONE_WEBAPP.md) — Phone Control Center v1 runbook and the `/api/pipeline` surface.
 - [`docs/GRAPHIFY_SETUP.md`](docs/GRAPHIFY_SETUP.md) — installing the knowledge graph on a new machine (four layers, all of which fail *silently*).

{code_coordinator-0.5.241 → code_coordinator-0.5.243}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-coordinator
-Version: 0.5.241
+Version: 0.5.243
 Summary: Coordinate Claude Code workers across multiple machines and repos.
 Author-email: John Donaghy <johnfdonaghy@gmail.com>
 License-Expression: LicenseRef-FSL-1.1-MIT

{code_coordinator-0.5.241 → code_coordinator-0.5.243}/code_coordinator.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-coordinator
-Version: 0.5.241
+Version: 0.5.243
 Summary: Coordinate Claude Code workers across multiple machines and repos.
 Author-email: John Donaghy <johnfdonaghy@gmail.com>
 License-Expression: LicenseRef-FSL-1.1-MIT

{code_coordinator-0.5.241 → code_coordinator-0.5.243}/code_coordinator.egg-info/SOURCES.txt

@@ -191,6 +191,9 @@ coord/deploy/coord-db-backup.sh
 coord/deploy/coord-db-backup.timer
 coord/deploy/coord-drive-queue.service
 coord/deploy/coord-drive-queue.timer
+coord/deploy/coord-failure-notify.service
+coord/deploy/coord-fleet-watchdog.service
+coord/deploy/coord-fleet-watchdog.timer
 coord/deploy/coord-notify.service
 coord/deploy/coord-notify.timer
 coord/deploy/coord-release-propagate.service
@@ -226,8 +229,10 @@ coord/health/checks/graph.py
 coord/health/checks/graphify_cli.py
 coord/health/checks/index_lock.py
 coord/health/checks/plan_usage.py
+coord/health/checks/release_cordon.py
 coord/health/checks/repo_state.py
 coord/health/checks/spawned_coord.py
+coord/health/checks/stalled_pipeline.py
 coord/health/checks/timer_active.py
 coord/health/checks/toolchain.py
 coord/health/checks/unit_drift.py
@@ -263,6 +268,10 @@ deploy/coord-db-backup.sh
 deploy/coord-db-backup.timer
 deploy/coord-drive-queue.service
 deploy/coord-drive-queue.timer
+deploy/coord-failure-notify.service
+deploy/coord-failure-notify.sh
+deploy/coord-fleet-watchdog.service
+deploy/coord-fleet-watchdog.timer
 deploy/coord-notify.service
 deploy/coord-notify.timer
 deploy/coord-release-propagate.service
@@ -286,6 +295,7 @@ docs/COCKPIT.md
 docs/CONTROL_CENTER.md
 docs/COST_DISCIPLINE.md
 docs/CROSS_PLATFORM.md
+docs/CUSTOMER_FACING_APPS.md
 docs/CUSTOMER_PORTAL.md
 docs/DRIVE_QUEUE.md
 docs/EPHEMERAL_WORKERS.md
@@ -316,7 +326,9 @@ scripts/audit_review_verdict_overrides.py
 scripts/check_gh_argv_containment.py
 scripts/codegen.py
 scripts/coord-test-runner.sh
+scripts/coord-venv-rollback.sh
 scripts/drive-batch.sh
+scripts/fleet_watchdog.py
 scripts/gen_board_fixture.py
 scripts/gen_mock_index.py
 scripts/next_release_tag.py
@@ -416,8 +428,10 @@ tests/test_cli_fix_headless_review.py
 tests/test_cli_gate_a.py
 tests/test_cli_install_drift.py
 tests/test_cli_install_skills.py
+tests/test_cli_issue_comment.py
 tests/test_cli_issue_create_label.py
 tests/test_cli_issue_reopen.py
+tests/test_cli_issue_view_list.py
 tests/test_cli_merge.py
 tests/test_cli_milestone_assign.py
 tests/test_cli_milestone_capture.py
@@ -440,9 +454,11 @@ tests/test_cli_release_preflight.py
 tests/test_cli_release_propagate.py
 tests/test_cli_release_window.py
 tests/test_cli_repo_2220.py
+tests/test_cli_review_test_author_tracking_epic_2639.py
 tests/test_cli_scorecard.py
 tests/test_cli_set_review_findings.py
 tests/test_cli_status_advisory_terminal.py
+tests/test_cli_status_contested_tag.py
 tests/test_cli_status_merge_queue.py
 tests/test_cli_status_provider.py
 tests/test_cli_status_review_finalizing.py
@@ -465,14 +481,17 @@ tests/test_config_usage_gate.py
 tests/test_confirm_test.py
 tests/test_conflict_fix.py
 tests/test_conflict_fix_semantic.py
+tests/test_coord_log_daemon_fallback_2547.py
 tests/test_coord_test.py
 tests/test_coord_test_runner_baseline.py
 tests/test_coord_test_runner_populated_home.py
 tests/test_coord_test_runner_routing.py
 tests/test_coord_test_runner_toolchain.py
+tests/test_coord_uat.py
 tests/test_coord_web_sse_restart_live.py
 tests/test_coordinator_machine.py
 tests/test_cross_platform_imports.py
+tests/test_dao.py
 tests/test_dashboard.py
 tests/test_dashboard_fixture.py
 tests/test_dashboard_terminal.py
@@ -484,6 +503,7 @@ tests/test_deploy_coord_db_backup.py
 tests/test_deploy_coord_web_dist.py
 tests/test_deploy_coord_web_rollback.py
 tests/test_deploy_drive_queue_unit.py
+tests/test_deploy_failure_notify_unit.py
 tests/test_deploy_manifest.py
 tests/test_deploy_notify_unit.py
 tests/test_deploy_units_lane.py
@@ -496,7 +516,11 @@ tests/test_dist_name.py
 tests/test_done_housekeeping.py
 tests/test_drive.py
 tests/test_drive_queue.py
+tests/test_drive_queue_blocked_rendering.py
+tests/test_drive_queue_launch_argv.py
+tests/test_drive_queue_max_parallel_per_repo_config.py
 tests/test_drive_queue_roll_pending.py
+tests/test_drive_queue_self_cordon_escalation.py
 tests/test_drive_state.py
 tests/test_drive_tmux.py
 tests/test_epic_up_capability_detection.py
@@ -511,6 +535,7 @@ tests/test_fix_of_force_override.py
 tests/test_fleet_config_health.py
 tests/test_fleet_health_probes.py
 tests/test_fleet_health_snapshot.py
+tests/test_fleet_watchdog.py
 tests/test_forge_availability.py
 tests/test_freshness.py
 tests/test_gate_a.py
@@ -532,9 +557,11 @@ tests/test_health_config.py
 tests/test_health_context.py
 tests/test_health_coord_web_ci_pin.py
 tests/test_health_deploy_lane_facts.py
+tests/test_health_fix.py
 tests/test_health_incident_regression.py
 tests/test_health_pypi.py
 tests/test_health_registry.py
+tests/test_health_release_cordon_probe.py
 tests/test_health_timer_active.py
 tests/test_health_toolchain.py
 tests/test_health_unit_drift.py
@@ -588,6 +615,7 @@ tests/test_overlap_predict.py
 tests/test_packaged_deploy_units.py
 tests/test_parentage.py
 tests/test_paste_landed.py
+tests/test_phantom_heal_venv_independence_2570.py
 tests/test_pipeline.py
 tests/test_plan_followup_approve_plan_command.py
 tests/test_plan_followup_pr_command.py
@@ -614,6 +642,7 @@ tests/test_reap_stale_interactive_tick.py
 tests/test_reconcile.py
 tests/test_reconcile_branch.py
 tests/test_reconcile_completions.py
+tests/test_reconcile_late_agent_reports_2547.py
 tests/test_reconcile_merges.py
 tests/test_reconcile_no_agent_record.py
 tests/test_reconcile_tick.py
@@ -624,6 +653,7 @@ tests/test_release_cordon_daemon_leads_2176.py
 tests/test_release_cordon_deadlock_2240.py
 tests/test_release_cordon_stuck_2490.py
 tests/test_release_propagate.py
+tests/test_release_propagate_threshold.py
 tests/test_release_roll_window_handoff.py
 tests/test_release_unified_1242.py
 tests/test_release_verify.py
@@ -676,6 +706,7 @@ tests/test_test_orchestrator.py
 tests/test_test_report.py
 tests/test_test_verdict_parsing.py
 tests/test_test_verdict_transcript_floor.py
+tests/test_text_io_encoding_audit.py
 tests/test_thin_client_board_audit.py
 tests/test_thin_client_config_load_1080.py
 tests/test_thin_client_daemon_routing_906.py
@@ -689,6 +720,7 @@ tests/test_venv_live_install_2121.py
 tests/test_version_single_source.py
 tests/test_watch.py
 tests/test_windows_job_is_a_real_gate_2000.py
+tests/test_worker_env_venv_isolation.py
 tests/test_worker_events.py
 tests/test_worker_image_pin_sync.py
 tests/test_worker_safety.py

{code_coordinator-0.5.241 → code_coordinator-0.5.243}/code_coordinator.egg-info/scm_file_list.json

@@ -99,6 +99,9 @@
     "coord/deploy/coord-db-backup.timer",
     "coord/deploy/coord-drive-queue.service",
     "coord/deploy/coord-drive-queue.timer",
+    "coord/deploy/coord-failure-notify.service",
+    "coord/deploy/coord-fleet-watchdog.service",
+    "coord/deploy/coord-fleet-watchdog.timer",
     "coord/deploy/coord-notify.service",
     "coord/deploy/coord-notify.timer",
     "coord/deploy/coord-release-propagate.service",
@@ -148,8 +151,10 @@
     "coord/health/checks/graphify_cli.py",
     "coord/health/checks/index_lock.py",
     "coord/health/checks/plan_usage.py",
+    "coord/health/checks/release_cordon.py",
     "coord/health/checks/repo_state.py",
     "coord/health/checks/spawned_coord.py",
+    "coord/health/checks/stalled_pipeline.py",
     "coord/health/checks/timer_active.py",
     "coord/health/checks/toolchain.py",
     "coord/health/checks/unit_drift.py",
@@ -255,6 +260,10 @@
     "deploy/coord-db-backup.timer",
     "deploy/coord-drive-queue.service",
     "deploy/coord-drive-queue.timer",
+    "deploy/coord-failure-notify.service",
+    "deploy/coord-failure-notify.sh",
+    "deploy/coord-fleet-watchdog.service",
+    "deploy/coord-fleet-watchdog.timer",
     "deploy/coord-notify.service",
     "deploy/coord-notify.timer",
     "deploy/coord-release-propagate.service",
@@ -278,6 +287,7 @@
     "docs/CONTROL_CENTER.md",
     "docs/COST_DISCIPLINE.md",
     "docs/CROSS_PLATFORM.md",
+    "docs/CUSTOMER_FACING_APPS.md",
     "docs/CUSTOMER_PORTAL.md",
     "docs/DRIVE_QUEUE.md",
     "docs/EPHEMERAL_WORKERS.md",
@@ -320,7 +330,9 @@
     "scripts/check_gh_argv_containment.py",
     "scripts/codegen.py",
     "scripts/coord-test-runner.sh",
+    "scripts/coord-venv-rollback.sh",
     "scripts/drive-batch.sh",
+    "scripts/fleet_watchdog.py",
     "scripts/gen_board_fixture.py",
     "scripts/gen_mock_index.py",
     "scripts/next_release_tag.py",
@@ -488,8 +500,10 @@
     "tests/test_cli_gate_a.py",
     "tests/test_cli_install_drift.py",
     "tests/test_cli_install_skills.py",
+    "tests/test_cli_issue_comment.py",
     "tests/test_cli_issue_create_label.py",
     "tests/test_cli_issue_reopen.py",
+    "tests/test_cli_issue_view_list.py",
     "tests/test_cli_merge.py",
     "tests/test_cli_milestone_assign.py",
     "tests/test_cli_milestone_capture.py",
@@ -512,9 +526,11 @@
     "tests/test_cli_release_propagate.py",
     "tests/test_cli_release_window.py",
     "tests/test_cli_repo_2220.py",
+    "tests/test_cli_review_test_author_tracking_epic_2639.py",
     "tests/test_cli_scorecard.py",
     "tests/test_cli_set_review_findings.py",
     "tests/test_cli_status_advisory_terminal.py",
+    "tests/test_cli_status_contested_tag.py",
     "tests/test_cli_status_merge_queue.py",
     "tests/test_cli_status_provider.py",
     "tests/test_cli_status_review_finalizing.py",
@@ -537,14 +553,17 @@
     "tests/test_confirm_test.py",
     "tests/test_conflict_fix.py",
     "tests/test_conflict_fix_semantic.py",
+    "tests/test_coord_log_daemon_fallback_2547.py",
     "tests/test_coord_test.py",
     "tests/test_coord_test_runner_baseline.py",
     "tests/test_coord_test_runner_populated_home.py",
     "tests/test_coord_test_runner_routing.py",
     "tests/test_coord_test_runner_toolchain.py",
+    "tests/test_coord_uat.py",
     "tests/test_coord_web_sse_restart_live.py",
     "tests/test_coordinator_machine.py",
     "tests/test_cross_platform_imports.py",
+    "tests/test_dao.py",
     "tests/test_dashboard.py",
     "tests/test_dashboard_fixture.py",
     "tests/test_dashboard_terminal.py",
@@ -556,6 +575,7 @@
     "tests/test_deploy_coord_web_dist.py",
     "tests/test_deploy_coord_web_rollback.py",
     "tests/test_deploy_drive_queue_unit.py",
+    "tests/test_deploy_failure_notify_unit.py",
     "tests/test_deploy_manifest.py",
     "tests/test_deploy_notify_unit.py",
     "tests/test_deploy_units_lane.py",
@@ -568,7 +588,11 @@
     "tests/test_done_housekeeping.py",
     "tests/test_drive.py",
     "tests/test_drive_queue.py",
+    "tests/test_drive_queue_blocked_rendering.py",
+    "tests/test_drive_queue_launch_argv.py",
+    "tests/test_drive_queue_max_parallel_per_repo_config.py",
     "tests/test_drive_queue_roll_pending.py",
+    "tests/test_drive_queue_self_cordon_escalation.py",
     "tests/test_drive_state.py",
     "tests/test_drive_tmux.py",
     "tests/test_epic_up_capability_detection.py",
@@ -583,6 +607,7 @@
     "tests/test_fleet_config_health.py",
     "tests/test_fleet_health_probes.py",
     "tests/test_fleet_health_snapshot.py",
+    "tests/test_fleet_watchdog.py",
     "tests/test_forge_availability.py",
     "tests/test_freshness.py",
     "tests/test_gate_a.py",
@@ -604,9 +629,11 @@
     "tests/test_health_context.py",
     "tests/test_health_coord_web_ci_pin.py",
     "tests/test_health_deploy_lane_facts.py",
+    "tests/test_health_fix.py",
     "tests/test_health_incident_regression.py",
     "tests/test_health_pypi.py",
     "tests/test_health_registry.py",
+    "tests/test_health_release_cordon_probe.py",
     "tests/test_health_timer_active.py",
     "tests/test_health_toolchain.py",
     "tests/test_health_unit_drift.py",
@@ -660,6 +687,7 @@
     "tests/test_packaged_deploy_units.py",
     "tests/test_parentage.py",
     "tests/test_paste_landed.py",
+    "tests/test_phantom_heal_venv_independence_2570.py",
     "tests/test_pipeline.py",
     "tests/test_plan_followup_approve_plan_command.py",
     "tests/test_plan_followup_pr_command.py",
@@ -686,6 +714,7 @@
     "tests/test_reconcile.py",
     "tests/test_reconcile_branch.py",
     "tests/test_reconcile_completions.py",
+    "tests/test_reconcile_late_agent_reports_2547.py",
     "tests/test_reconcile_merges.py",
     "tests/test_reconcile_no_agent_record.py",
     "tests/test_reconcile_tick.py",
@@ -696,6 +725,7 @@
     "tests/test_release_cordon_deadlock_2240.py",
     "tests/test_release_cordon_stuck_2490.py",
     "tests/test_release_propagate.py",
+    "tests/test_release_propagate_threshold.py",
     "tests/test_release_roll_window_handoff.py",
     "tests/test_release_unified_1242.py",
     "tests/test_release_verify.py",
@@ -748,6 +778,7 @@
     "tests/test_test_report.py",
     "tests/test_test_verdict_parsing.py",
     "tests/test_test_verdict_transcript_floor.py",
+    "tests/test_text_io_encoding_audit.py",
     "tests/test_thin_client_board_audit.py",
     "tests/test_thin_client_config_load_1080.py",
     "tests/test_thin_client_daemon_routing_906.py",
@@ -761,6 +792,7 @@
     "tests/test_version_single_source.py",
     "tests/test_watch.py",
     "tests/test_windows_job_is_a_real_gate_2000.py",
+    "tests/test_worker_env_venv_isolation.py",
     "tests/test_worker_events.py",
     "tests/test_worker_image_pin_sync.py",
     "tests/test_worker_safety.py",

code_coordinator-0.5.243/code_coordinator.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.5.243",
+  "distance": 0,
+  "node": "g1b9f7b7e97dc258d03dccf3588639dc09d1e6060",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-08-24"
+}

{code_coordinator-0.5.241 → code_coordinator-0.5.243}/coord/_board_mapping.py

@@ -98,6 +98,10 @@ def row_to_assignment(row: object) -> Assignment:
         review_posted_at=d.get("review_posted_at"),
         test_state=d.get("test_state"),
         test_reason=d.get("test_reason"),
+        # #2687: pre-merge UAT gate verdict; None for rows predating this
+        # column or a repo that hasn't opted in via Repo.uat_preview.
+        uat_state=d.get("uat_state"),
+        uat_reason=d.get("uat_reason"),
         # #1479: Test-gate staleness anchor; None for pre-1479 rows or where
         # it couldn't be captured — the merge-queue gate treats that as "SHA
         # tracking unavailable" and skips the staleness check (fail open).