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

{code_coordinator-0.5.241 → code_coordinator-0.5.242}/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,11 @@ 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/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.242}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-coordinator
-Version: 0.5.241
+Version: 0.5.242
 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.242}/code_coordinator.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-coordinator
-Version: 0.5.241
+Version: 0.5.242
 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.242}/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,6 +229,7 @@ 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/timer_active.py
@@ -263,6 +267,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
@@ -316,7 +324,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
@@ -418,6 +428,7 @@ tests/test_cli_install_drift.py
 tests/test_cli_install_skills.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 +451,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,6 +478,7 @@ 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
@@ -484,6 +498,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 +511,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 +530,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
@@ -535,6 +555,7 @@ tests/test_health_deploy_lane_facts.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 +609,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 +636,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
@@ -689,6 +712,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.242}/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,6 +151,7 @@
     "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/timer_active.py",
@@ -255,6 +259,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",
@@ -320,7 +328,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",
@@ -490,6 +500,7 @@
     "tests/test_cli_install_skills.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 +523,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,6 +550,7 @@
     "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",
@@ -556,6 +570,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 +583,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 +602,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",
@@ -607,6 +627,7 @@
     "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 +681,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 +708,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",
@@ -761,6 +784,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.241 → code_coordinator-0.5.242}/code_coordinator.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "0.5.241",
+  "tag": "0.5.242",
   "distance": 0,
-  "node": "gf7a7056ba9c9f723298a0b5f62a8949e5c01bd1f",
+  "node": "g4e2ed9d805b260892bd2073853f67ede3e8a5971",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-08-23"