code-coordinator 0.5.563__tar.gz → 0.5.565__tar.gz

{code_coordinator-0.5.563 → code_coordinator-0.5.565}/PKG-INFO

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-coordinator
-Version: 0.5.563
+Version: 0.5.565
 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.563 → code_coordinator-0.5.565}/code_coordinator.egg-info/SOURCES.txt

@@ -220,6 +220,7 @@ coord/commands/tui.py
 coord/dashboard/__init__.py
 coord/dashboard/fixture.py
 coord/dashboard/index.html
+coord/dashboard/reports.html
 coord/dashboard/server.py
 coord/dashboard/terminal.py
 coord/deploy/README.md
@@ -598,6 +599,7 @@ tests/test_dao.py
 tests/test_dashboard.py
 tests/test_dashboard_api.py
 tests/test_dashboard_fixture.py
+tests/test_dashboard_reports.py
 tests/test_dashboard_server.py
 tests/test_dashboard_terminal.py
 tests/test_dashboard_terminal_live.py

{code_coordinator-0.5.563 → code_coordinator-0.5.565}/code_coordinator.egg-info/scm_file_list.json

@@ -97,6 +97,7 @@
     "coord/dashboard/__init__.py",
     "coord/dashboard/fixture.py",
     "coord/dashboard/index.html",
+    "coord/dashboard/reports.html",
     "coord/dashboard/server.py",
     "coord/dashboard/terminal.py",
     "coord/db.py",
@@ -625,6 +626,7 @@
     "tests/test_dashboard.py",
     "tests/test_dashboard_api.py",
     "tests/test_dashboard_fixture.py",
+    "tests/test_dashboard_reports.py",
     "tests/test_dashboard_server.py",
     "tests/test_dashboard_terminal.py",
     "tests/test_dashboard_terminal_live.py",

{code_coordinator-0.5.563 → code_coordinator-0.5.565}/code_coordinator.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "0.5.563",
+  "tag": "0.5.565",
   "distance": 0,
-  "node": "gd370d95cd8b305a54b4761f01ee5c006b5fa5099",
+  "node": "g17a32a973761388195b697736864929850be4d1f",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-10-02"

{code_coordinator-0.5.563 → code_coordinator-0.5.565}/coord/config.py

@@ -1951,6 +1951,40 @@ class PricingConfig:
         return self.models.get(canonical_model)
 
 
+#: Open-but-finite vocabulary for ``reporting.cost_basis`` (#3471) — see
+#: :class:`ReportingConfig` for what each value asserts.
+COST_BASIS_CHOICES = ("api_equivalent", "billed")
+
+
+@dataclass
+class ReportingConfig:
+    """``reporting:`` block (#3471) — what a cost-bearing report's dollar
+    figure actually represents.
+
+    Every cost-bearing report (``usage``, ``completed``, ``trend``,
+    ``issue-cost``) sums ``cost_usd`` as captured off ``claude -p`` (or a
+    token-count estimate priced by :class:`PricingConfig` when no
+    ``cost_usd`` was captured at all). That figure is **always** an
+    API-list-price equivalent — what the tokens would have cost if billed
+    per call — which is NOT necessarily money actually billed: most of this
+    fleet runs `claude -p` on a Max/Pro *subscription*, where no per-call
+    invoice exists at all. ``cost_basis`` names which of those two things
+    the number should be read as, and every cost-bearing report stamps it
+    onto its cost ``ColumnMeta.basis`` (:mod:`coord.reports`) so a chart
+    screenshotted out of context for external use still states its own
+    basis rather than silently implying real billed spend.
+
+    ``"api_equivalent"`` (the default) is the honest assumption for a
+    subscription fleet: the number is a cost-equivalent, not an invoice
+    line. ``"billed"`` asserts the fleet actually pays per-call API rates
+    and the figure is real money charged — set it only when that is
+    actually true; this config does no verification of its own; it only
+    labels, on every report, what the operator asserts here.
+    """
+
+    cost_basis: str = "api_equivalent"
+
+
 @dataclass
 class ProviderDef:
     """Definition of a single named worker-command provider.
@@ -2656,6 +2690,9 @@ class Config:
         default_factory=ForgeAvailabilityConfig
     )
     pricing: PricingConfig = field(default_factory=PricingConfig)
+    # #3471 — absent block == cost_basis="api_equivalent" == today's honest
+    # default for a subscription fleet (see ReportingConfig).
+    reporting: ReportingConfig = field(default_factory=ReportingConfig)
     health: HealthConfig = field(default_factory=HealthConfig)
     # #1632 — absent block == disabled == today's behaviour (silence).
     notifications: NotificationsConfig = field(default_factory=NotificationsConfig)
@@ -2925,6 +2962,7 @@ def parse_mapping(raw: Any, *, path: Path | None = None) -> Config:
     audit = _parse_audit(raw.get("audit"))
     forge_availability = _parse_forge_availability(raw.get("forge_availability"))
     pricing = _parse_pricing(raw.get("pricing"))
+    reporting = _parse_reporting(raw.get("reporting"))
     health = _parse_health(raw.get("health"))
     notifications = _parse_notifications(raw.get("notifications"))
     portal = _parse_portal(raw.get("portal"), {r.name for r in repos})
@@ -2952,6 +2990,7 @@ def parse_mapping(raw: Any, *, path: Path | None = None) -> Config:
         audit=audit,
         forge_availability=forge_availability,
         pricing=pricing,
+        reporting=reporting,
         health=health,
         notifications=notifications,
         portal=portal,
@@ -5029,6 +5068,29 @@ def _parse_pricing(raw: Any) -> PricingConfig:
     return PricingConfig(models=models)
 
 
+def _parse_reporting(raw: Any) -> ReportingConfig:
+    """Parse the optional ``reporting:`` block from coordinator.yml (#3471).
+
+    An absent block returns ``ReportingConfig()`` — ``cost_basis:
+    "api_equivalent"``, the honest default for a subscription fleet.
+    """
+    if raw is None:
+        return ReportingConfig()
+    if not isinstance(raw, dict):
+        raise ConfigError("'reporting' must be a mapping")
+
+    cfg = ReportingConfig()
+    if "cost_basis" in raw:
+        value = raw["cost_basis"]
+        if not isinstance(value, str) or value not in COST_BASIS_CHOICES:
+            raise ConfigError(
+                "reporting.cost_basis must be one of: "
+                + ", ".join(COST_BASIS_CHOICES)
+            )
+        cfg.cost_basis = value
+    return cfg
+
+
 _ENV_VAR_RE = re.compile(r"\$\{([^}]+)\}")