@blastin-dev/clocktopus-cli 0.3.0 → 0.4.0

package/README.md

@@ -182,10 +182,18 @@ one that silently understates what work cost.
 ### `clocktopus agent doctor`
 
 Checks every link in the chain, per agent, and names the first one that is
-broken: the config file parses, the exporter is configured, both hooks are
-installed, the hook command actually executes, Codex has approved its hooks,
-the receiver accepts the token, no other file is shadowing the
-configuration, and whether that agent needs restarting. The repository
+broken: the config file parses, the exporter is configured, every signal the
+receiver reads is being sent, both hooks are installed, the hook command
+actually executes, Codex has approved its hooks, the receiver accepts the
+token, no other file is shadowing the configuration, and whether that agent
+needs restarting.
+
+The signals check is there for configurations written before a signal
+existed. Those still hold a valid token and endpoint, so everything else
+passes while one stream never leaves the machine — a Claude Code install
+predating BLA-671 reports cost correctly and no sub-agent runtime at all.
+Re-running `agent setup` merges the missing keys in; nothing needs removing
+first. The repository
 checks — attached to a project, delivering commits — run once at the end,
 since they are facts about the repo rather than about any one agent.
 

package/dist/src/commands/agent/doctor.js

@@ -90,6 +90,19 @@ async function agentChecks(entry) {
             : `not configured in ${state.paths.join(", ")}`,
         fix: `clocktopus agent setup --agent ${entry.agent.id}`,
     });
+    // A configuration written before a lane existed still has a token and an endpoint, so
+    // every other check here passes while one signal never leaves the machine. Only worth
+    // saying once the agent is configured at all — otherwise the check above covers it.
+    if (state.token !== null) {
+        checks.push({
+            label: "Signals",
+            ok: state.missingLanes.length === 0,
+            detail: state.missingLanes.length === 0
+                ? "every signal the receiver reads is configured"
+                : `not being sent: ${state.missingLanes.join(", ")}`,
+            fix: `clocktopus agent setup --agent ${entry.agent.id} — this configuration predates it`,
+        });
+    }
     // Both events are required, for different reasons: SessionStart is the only source of the
     // *before* SHA and of `cwd`, SessionEnd the only source of the exact commit list. One
     // without the other silently degrades what can be attributed.

package/dist/src/commands/agent/status.d.ts

@@ -1,2 +1,14 @@
 export declare function statusCommand(): Promise<void>;
+/**
+ * The asymmetric-failure callouts — the reason the lanes are split.
+ *
+ * Each names the single next action, because "one lane is quiet" is only
+ * actionable once you know which half of the pipeline it implicates.
+ */
+export declare function diagnose(input: {
+    hookAge: number | null;
+    metricsAge: number | null;
+    unattributedSessions: number;
+    sessions: number;
+}): string[];
 //# sourceMappingURL=status.d.ts.map

package/dist/src/commands/agent/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/commands/agent/status.ts"],"names":[],"mappings":"AA2BA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAoFnD"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/commands/agent/status.ts"],"names":[],"mappings":"AA2BA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA4FnD;AAgBD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,EAAE,CAgDX"}

package/dist/src/commands/agent/status.js

@@ -53,7 +53,7 @@ export async function statusCommand() {
         console.log(labelled("", `${where}${branch}`, 14));
     }
     if (status.hookLane.attributed === false) {
-        console.log(labelled("", "not attributed to a project — see 'agent doctor'", 14));
+        console.log(labelled("", "this repository is not attached to a project", 14));
     }
     console.log(labelled("Spend lane", `${mark(metricsAge)}  ${formatAgo(status.metricsLane.lastExportReceivedAt)}`, 14));
     if (status.metricsLane.lastModel) {
@@ -62,8 +62,11 @@ export async function statusCommand() {
     console.log("\nLast 7 days\n");
     console.log(labelled("Sessions", String(status.window.sessions)));
     console.log(labelled("Spend", microUsdToDisplay(status.window.costMicroUsd)));
+    // Deliberately not naming a cause. There are four, they are per-repository, and
+    // this figure is a `project_id IS NULL` count that knows none of them — only
+    // `agent doctor`, standing in the checkout, can say which one applies.
     if (status.window.unattributedSessions > 0) {
-        console.log(labelled("Unattributed", `${status.window.unattributedSessions} session(s) — no matching project`));
+        console.log(labelled("Unattributed", `${status.window.unattributedSessions} session(s) with no project`));
     }
     const local = readLocalSummary();
     if (local.length > 0) {
@@ -71,7 +74,12 @@ export async function statusCommand() {
         for (const line of local)
             console.log(line);
     }
-    for (const diagnosis of diagnose({ hookAge, metricsAge })) {
+    for (const diagnosis of diagnose({
+        hookAge,
+        metricsAge,
+        unattributedSessions: status.window.unattributedSessions,
+        sessions: status.window.sessions,
+    })) {
         console.log(`\n${diagnosis}`);
     }
 }
@@ -96,7 +104,7 @@ function mark(ageMs) {
  * Each names the single next action, because "one lane is quiet" is only
  * actionable once you know which half of the pipeline it implicates.
  */
-function diagnose(input) {
+export function diagnose(input) {
     const { hookAge, metricsAge } = input;
     const hookLive = hookAge !== null && hookAge <= STALE_AFTER_MS;
     const metricsLive = metricsAge !== null && metricsAge <= STALE_AFTER_MS;
@@ -122,6 +130,22 @@ function diagnose(input) {
                 "  Check the hook with 'clocktopus agent doctor'.",
         ];
     }
+    // Last, and only once both lanes are healthy. While the hook is silent every
+    // session is unattributed as a *consequence* of that, and the callout above is
+    // the one to act on. Reaching here means the pipeline works and the mapping does
+    // not, which is a different job in a different place.
+    if (input.unattributedSessions > 0) {
+        return [
+            `⚠ In the last 7 days, ${input.unattributedSessions} of ${input.sessions} sessions had no project.\n` +
+                '  Their spend is recorded and counted — it lands in the "Unattributed\n' +
+                '  agent work" row rather than against a client.\n' +
+                "\n" +
+                "  A session takes its project from the repository it ran in, so the fix\n" +
+                "  is a repository-to-project mapping and nothing on this machine changes\n" +
+                "  it. Run 'clocktopus agent doctor' inside that checkout: it names which\n" +
+                "  of the four reasons applies, and what to do about it.",
+        ];
+    }
     return [];
 }
 function readLocalSummary() {

package/dist/src/commands/agent/status.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=status.test.d.ts.map

package/dist/src/commands/agent/status.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/agent/status.test.ts"],"names":[],"mappings":""}

package/dist/src/commands/agent/status.test.js

@@ -0,0 +1,58 @@
+import { describe, expect, it } from "vitest";
+import { diagnose } from "./status";
+/**
+ * The callouts `agent status` prints under the lane table.
+ *
+ * Only the ordering is interesting, and it is the whole point: the checks run
+ * in pipeline order so the *first* failure is the one shown, because the rest
+ * are usually consequences of it.
+ */
+const LIVE = 60_000;
+const STALE = 48 * 60 * 60 * 1000;
+const healthy = { hookAge: LIVE, metricsAge: LIVE, sessions: 10 };
+describe("diagnose", () => {
+    it("says nothing when both lanes are live and everything is attributed", () => {
+        expect(diagnose({ ...healthy, unattributedSessions: 0 })).toEqual([]);
+    });
+    it("names the repository mapping when sessions land with no project", () => {
+        const [callout] = diagnose({ ...healthy, unattributedSessions: 3 });
+        expect(callout).toContain("3 of 10");
+        // The actionable object. Naming only "project" is what left people
+        // wondering whether it meant a ticket (BLA-671).
+        expect(callout).toContain("repository");
+        expect(callout).toContain("agent doctor");
+    });
+    it("reports a silent hook instead, while one is silent", () => {
+        // Every session is unattributed when the hook never runs — no telemetry
+        // stream carries path data — so the unattributed count is a symptom here
+        // and the hook is the thing to fix. Showing both would send someone to
+        // the dashboard to fix a mapping that is already correct.
+        const callouts = diagnose({
+            hookAge: STALE,
+            metricsAge: LIVE,
+            sessions: 10,
+            unattributedSessions: 10,
+        });
+        expect(callouts).toHaveLength(1);
+        expect(callouts[0]).toContain("hook is not running");
+    });
+    it("reports a silent exporter before anything else", () => {
+        const callouts = diagnose({
+            hookAge: LIVE,
+            metricsAge: STALE,
+            sessions: 10,
+            unattributedSessions: 4,
+        });
+        expect(callouts).toHaveLength(1);
+        expect(callouts[0]).toContain("no spend is");
+    });
+    it("sends someone to doctor when nothing has ever arrived", () => {
+        const callouts = diagnose({
+            hookAge: null,
+            metricsAge: null,
+            sessions: 0,
+            unattributedSessions: 0,
+        });
+        expect(callouts[0]).toContain("Nothing has ever arrived");
+    });
+});

package/dist/src/lib/agents.d.ts

@@ -6,6 +6,7 @@ export type AgentTelemetryState = {
     endpoint: string | null;
     /** Per-event, because a half-installed hook pair degrades silently. */
     hookCommands: Partial<Record<"SessionStart" | "SessionEnd", string>>;
+    missingLanes: string[];
     /** Newest mtime across the agent's config files, for the restart check. */
     modifiedAt: Date | null;
     /** Files we would write, whether or not they exist yet. */

package/dist/src/lib/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/lib/agents.ts"],"names":[],"mappings":"AAyDA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtD,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uEAAuE;IACvE,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,GAAG,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACrE,2EAA2E;IAC3E,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IAKf,kBAAkB,EAAE,OAAO,CAAC;IAU5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,2DAA2D;IAC3D,KAAK,IAAI,MAAM,EAAE,CAAC;IAClB,IAAI,IAAI,mBAAmB,CAAC;IAC5B,KAAK,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG;QACtE,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,MAAM,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAGhC,cAAc,IAAI,MAAM,EAAE,CAAC;IAI3B,WAAW,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAKjE;AAkND,eAAO,MAAM,MAAM,EAAE,SAAS,YAAY,EAIzC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,wEAAwE;IACxE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAOF,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAqB5C"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/lib/agents.ts"],"names":[],"mappings":"AAyDA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtD,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uEAAuE;IACvE,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,GAAG,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAIrE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2EAA2E;IAC3E,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IAKf,kBAAkB,EAAE,OAAO,CAAC;IAU5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,2DAA2D;IAC3D,KAAK,IAAI,MAAM,EAAE,CAAC;IAClB,IAAI,IAAI,mBAAmB,CAAC;IAC5B,KAAK,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG;QACtE,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,MAAM,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAGhC,cAAc,IAAI,MAAM,EAAE,CAAC;IAI3B,WAAW,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAKjE;AA0ND,eAAO,MAAM,MAAM,EAAE,SAAS,YAAY,EAIzC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,wEAAwE;IACxE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAOF,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAqB5C"}

package/dist/src/lib/agents.js

@@ -21,6 +21,11 @@ const claudeAdapter = {
             token: installed.env.CLOCKTOPUS_INGEST_TOKEN ?? null,
             endpoint: installed.env.CLOCKTOPUS_OTEL_ENDPOINT ?? null,
             hookCommands: installed.hookCommands,
+            // Added by BLA-671, so every install configured before it has a working metrics
+            // lane and no sub-agent runtime at all.
+            missingLanes: installed.env.OTEL_LOGS_EXPORTER === "otlp"
+                ? []
+                : ["sub-agent runtime"],
             modifiedAt: installed.modifiedAt,
             paths: [installed.path],
         };
@@ -63,6 +68,7 @@ const codexAdapter = {
             token: telemetry.token,
             endpoint: telemetry.endpoint,
             hookCommands: hooks.commands,
+            missingLanes: [],
             modifiedAt: newest([telemetry.modifiedAt, hooks.modifiedAt]),
             paths: [telemetry.path, hooks.path],
         };
@@ -158,6 +164,7 @@ const opencodeAdapter = {
                     SessionEnd: plugin.config.hookArgv.join(" "),
                 }
                 : {},
+            missingLanes: [],
             modifiedAt: plugin.modifiedAt,
             paths: [plugin.path],
         };

package/dist/src/lib/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/lib/auth.ts"],"names":[],"mappings":"AA6BA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA4BnE;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/lib/auth.ts"],"names":[],"mappings":"AA6BA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA4BnE;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CA0DrB;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/src/lib/auth.js

@@ -38,6 +38,17 @@ export async function pollForToken(deviceCode, interval) {
             grant_type: "urn:ietf:params:oauth:grant-type:device_code",
         }),
     });
+    // The web app rate-limits `/device/token` on top of the interval this loop
+    // already respects, and a 429 carries Better Auth's own body — no `error`
+    // field — so it used to fall through to "Unexpected response" and kill a
+    // login that was doing nothing wrong. Back off and keep waiting instead.
+    if (response.status === 429) {
+        const retryAfter = Number(response.headers.get("x-retry-after"));
+        return {
+            status: "slow_down",
+            newInterval: retryAfter > 0 ? retryAfter + interval : interval + 5,
+        };
+    }
     const data = (await response.json());
     if ("access_token" in data) {
         return { status: "success", accessToken: data.access_token };

package/dist/src/lib/claude-settings.d.ts

@@ -1,6 +1,6 @@
 export declare const SETTINGS_FILENAME = "settings.json";
 /** Env keys `clocktopus agent setup` owns — and the only ones it removes. */
-export declare const TELEMETRY_ENV_KEYS: readonly ["CLAUDE_CODE_ENABLE_TELEMETRY", "OTEL_METRICS_EXPORTER", "OTEL_EXPORTER_OTLP_PROTOCOL", "OTEL_EXPORTER_OTLP_ENDPOINT", "OTEL_EXPORTER_OTLP_HEADERS", "OTEL_METRICS_INCLUDE_SESSION_ID", "OTEL_METRIC_EXPORT_INTERVAL", "CLOCKTOPUS_INGEST_TOKEN", "CLOCKTOPUS_OTEL_ENDPOINT"];
+export declare const TELEMETRY_ENV_KEYS: readonly ["CLAUDE_CODE_ENABLE_TELEMETRY", "OTEL_METRICS_EXPORTER", "OTEL_LOGS_EXPORTER", "OTEL_EXPORTER_OTLP_PROTOCOL", "OTEL_EXPORTER_OTLP_ENDPOINT", "OTEL_EXPORTER_OTLP_HEADERS", "OTEL_METRICS_INCLUDE_SESSION_ID", "OTEL_METRIC_EXPORT_INTERVAL", "CLOCKTOPUS_INGEST_TOKEN", "CLOCKTOPUS_OTEL_ENDPOINT"];
 export declare const METRIC_EXPORT_INTERVAL_MS = 60000;
 export declare const HOOK_TIMEOUT_SECONDS = 10;
 export type ClaudeSettings = Record<string, unknown>;

package/dist/src/lib/claude-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-settings.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-settings.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,yRAUrB,CAAC;AAKX,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAMhD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AASrD,qBAAa,kBAAmB,SAAQ,KAAK;aACf,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAMzC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAiB,GAAG;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;CAC1B,CA6BA;AAKD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,IAAI,SAAiB,GACpB;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAiB/B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBzB;AAED,QAAA,MAAM,WAAW,yCAA0C,CAAC;AAgC5D,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9D,cAAc,CA0ChB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG;IACjE,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB,CAmCA;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,IAAI,SAAiB,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrE,CAmCA"}
+{"version":3,"file":"claude-settings.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-settings.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,+SAWrB,CAAC;AAKX,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAMhD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AASrD,qBAAa,kBAAmB,SAAQ,KAAK;aACf,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAMzC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAiB,GAAG;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;CAC1B,CA6BA;AAKD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,IAAI,SAAiB,GACpB;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAiB/B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBzB;AAED,QAAA,MAAM,WAAW,yCAA0C,CAAC;AAgC5D,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9D,cAAc,CA0ChB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG;IACjE,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB,CAmCA;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,IAAI,SAAiB,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrE,CAmCA"}

package/dist/src/lib/claude-settings.js

@@ -16,6 +16,7 @@ export const SETTINGS_FILENAME = "settings.json";
 export const TELEMETRY_ENV_KEYS = [
     "CLAUDE_CODE_ENABLE_TELEMETRY",
     "OTEL_METRICS_EXPORTER",
+    "OTEL_LOGS_EXPORTER",
     "OTEL_EXPORTER_OTLP_PROTOCOL",
     "OTEL_EXPORTER_OTLP_ENDPOINT",
     "OTEL_EXPORTER_OTLP_HEADERS",
@@ -101,6 +102,12 @@ export function buildTelemetryEnv(input) {
     return {
         CLAUDE_CODE_ENABLE_TELEMETRY: "1",
         OTEL_METRICS_EXPORTER: "otlp",
+        // Sub-agent runtime, and nothing else (BLA-671). `claude_code.active_time.total`
+        // on the metric stream measures the main thread alone, so without this a session
+        // that delegates its work to `Task` agents reports the coordinator's time and none
+        // of theirs. The receiver reads exactly one event off this stream,
+        // `subagent_completed`, and never the ones carrying prompts or responses.
+        OTEL_LOGS_EXPORTER: "otlp",
         // The receiver answers protobuf with an explicit 415, but only JSON actually works.
         OTEL_EXPORTER_OTLP_PROTOCOL: "http/json",
         OTEL_EXPORTER_OTLP_ENDPOINT: endpoint,

package/dist/src/lib/claude-settings.test.js

@@ -115,6 +115,12 @@ describe("buildTelemetryEnv", () => {
         // stream, and every session loses its repository and branch.
         expect(env.OTEL_METRICS_INCLUDE_SESSION_ID).toBe("true");
     });
+    it("enables the log exporter, the only carrier of sub-agent runtime", () => {
+        // BLA-671: `claude_code.active_time.total` on the metric stream measures the
+        // main thread, so without this a session that delegates its work to `Task`
+        // agents reports the coordinator's time and none of theirs.
+        expect(buildTelemetryEnv(INSTALL).OTEL_LOGS_EXPORTER).toBe("otlp");
+    });
     it("normalises a trailing slash so paths do not double up", () => {
         const env = buildTelemetryEnv({
             ...INSTALL,
@@ -125,6 +131,13 @@ describe("buildTelemetryEnv", () => {
     });
 });
 describe("removeTelemetrySettings", () => {
+    it("removes the log exporter again on teardown", () => {
+        // Every key setup writes has to be one `agent disable` takes back, or a
+        // disabled agent keeps exporting to an endpoint that no longer wants it.
+        const installed = applyTelemetrySettings(userSettings(), INSTALL);
+        const { settings } = removeTelemetrySettings(installed);
+        expect(settings.env.OTEL_LOGS_EXPORTER).toBeUndefined();
+    });
     it("removes only what setup added", () => {
         const installed = applyTelemetrySettings(userSettings(), INSTALL);
         const { settings, removedEnvKeys, removedHooks } = removeTelemetrySettings(installed);
@@ -184,6 +197,18 @@ describe("reading and writing the file", () => {
         expect(installed.hookCommands.SessionStart).toBe("clocktopus agent hook");
         expect(installed.hookCommands.SessionEnd).toBe("clocktopus agent hook");
     });
+    it("reads back the log exporter, so an older install can be spotted", () => {
+        // What `agent doctor` branches on. A settings file written before BLA-671 has a
+        // token, an endpoint and both hooks — every other check passes — while sub-agent
+        // runtime never leaves the machine. This is the only signal that it is stale.
+        const beforeBla671 = applyTelemetrySettings(userSettings(), INSTALL);
+        delete beforeBla671.env.OTEL_LOGS_EXPORTER;
+        writeSettings(beforeBla671, path);
+        expect(readInstalledTelemetry(path).env.OTEL_LOGS_EXPORTER).toBeUndefined();
+        writeSettings(applyTelemetrySettings(beforeBla671, INSTALL), path);
+        // Re-running setup merges it in rather than needing a teardown first.
+        expect(readInstalledTelemetry(path).env.OTEL_LOGS_EXPORTER).toBe("otlp");
+    });
     it("reports no telemetry for a settings file that only has the user's own hooks", () => {
         writeFileSync(path, JSON.stringify(userSettings()), "utf8");
         const installed = readInstalledTelemetry(path);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blastin-dev/clocktopus-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "bin": {
     "clocktopus": "./dist/bin/clocktopus.js"
@@ -16,14 +16,14 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
+    "@repo/eslint-config": "0.0.0",
+    "@repo/prettier-config": "0.1.0",
+    "@repo/typescript-config": "0.0.0",
     "@types/node": "22.15.3",
     "eslint": "9.37.0",
     "eslint-plugin-import-x": "^4.16.1",
     "typescript": "5.9.2",
-    "vitest": "^4.1.5",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/prettier-config": "0.1.0",
-    "@repo/typescript-config": "0.0.0"
+    "vitest": "^4.1.5"
   },
   "prettier": "@repo/prettier-config",
   "scripts": {