@teeras/afterhours 0.1.1 → 0.2.0

package/README.md

@@ -3,13 +3,20 @@
 Private AI-life balance and usage analytics for Codex, Claude Code, Gemini CLI,
 Cursor, and other coding agents.
 
+## For AI agents
+
+Installing this for your user? Run `npx @teeras/afterhours setup`, relay the
+printed code and link to your user, and let the command finish. Full
+instructions: [`llms-install.md`](./llms-install.md). Counts only — prompts,
+code, output, repo names, and paths never leave the machine.
+
 ```sh
 npx @teeras/afterhours
 ```
 
-The first run opens Google sign-in before reading activity, then returns to the
-terminal and prints the first report. A Teeras account is required. Install it
-once and the short command is simply:
+The first run reads supported agent activity locally and prints a seven-day
+view of agent activity, human attention, and after-hours check-ins without an
+account. Install it once and the short command is simply:
 
 ```sh
 trs
@@ -19,19 +26,33 @@ trs login
 trs sync
 trs sources
 trs privacy
+trs hook-config codex
+trs hook-config claude
 ```
 
 Afterhours parses the local session histories already written by supported
 coding agents and immediately reduces them to counts and hourly buckets. It
 never retains or returns prompt text, source code, model output, repository
 names, working directories, or file paths. Only the documented aggregate
-snapshot syncs after account approval.
+snapshot syncs after the user connects Teeras.
 
-Initial sources:
+Support matrix:
 
-- Codex app and CLI (`~/.codex/sessions`)
-- Claude Code (`~/.claude/projects`)
-- Gemini CLI (`~/.gemini/tmp`, session-level fidelity)
+- Codex desktop app and Codex CLI: activity, token, model, and episode
+  measurement from the shared `~/.codex/sessions` history. A distinct
+  `CODEX_HOME` is collected alongside the default App home.
+- Claude Code CLI: activity, token, model, and episode measurement from
+  `~/.claude/projects`, plus a distinct `CLAUDE_CONFIG_DIR` when configured.
+  Subagent transcripts are excluded from primary episode counts rather than
+  double-counted as human delegations. Claude Code Desktop keeps separate
+  history, so its shared opt-in lifecycle hook is the trustworthy live path.
+- Gemini CLI: activity, token, model, and episode measurement from current
+  `~/.gemini/tmp/*/chats` histories; older `logs.json` builds retain honest
+  session-level fidelity.
+- Claude desktop: detected separately. General Claude chat and Cowork activity
+  are not claimed as measured because those surfaces do not expose a stable,
+  content-free local lifecycle feed. Claude Code remains a separate first-class
+  source.
 - Cursor detection, ready for a consented adapter once its local schema is stable
 
 `trs connect` also detects Windsurf, VS Code + Copilot, Zed, Amp, OpenCode,
@@ -40,18 +61,83 @@ the rest are reported honestly as requiring a source adapter. The exported
 `SourceAdapter` contract lets any coding agent add counts-only support without
 changing the Afterhours core.
 
-## Keep your history in Teeras
+## Keep measuring across web and mobile
 
-The first `npx @teeras/afterhours` (or `trs login`) opens Teeras in the browser.
-Continue with Google, approve the counts-only boundary, and the CLI receives a
-revocable 90-day device token. Google OAuth tokens never enter the npm package.
+The first report stays on the computer. Run `trs connect` when you want to keep
+your history in Teeras. Continue with Google, approve the counts-only boundary,
+and the CLI receives a revocable 30-day device token. Google OAuth tokens never
+enter the npm package.
 
-Once connected, every deliberate `trs` run refreshes the account history. Use
-`trs sync` to sync without printing the report, or `trs logout` to remove this
-computer's token. There is no background daemon and no automatic LLM call.
+Connecting syncs the first report immediately. After that, a counts-only
+snapshot syncs as a side effect of your own agent activity: a lifecycle hook
+event can trigger one detached, rate-limited sync (at most one every 45
+minutes), so web and mobile stay current while you work. Every deliberate `trs`
+run also refreshes the history. Use `trs sync` to sync without printing the
+report, or `trs logout` to remove this computer's token. Nothing runs as a
+background daemon, the hook itself makes no network call, and there is no
+automatic LLM call.
 
 The default command (and `trs week`) prints a calm seven-day report. Use
 `--json` to inspect the privacy-safe snapshot consumed by the dashboard and
 optional MCP adapter. The cloud keeps one replaceable snapshot per device per
 day in a 790-day active-history window; the dashboard lets users export or
 delete that history.
+
+
+## Optional Codex and Claude Code lifecycle hooks
+
+Afterhours can measure episode boundaries and permission requests more
+accurately from opt-in lifecycle hooks.
+
+```sh
+# install the fragments for the agents found on this computer
+npx @teeras/afterhours setup
+```
+
+Running `setup` is the consent: it merges the Teeras fragment into the agents
+it finds on this computer, leaves every other hook untouched, and is safe to
+run again — a second run reports what is already connected instead of
+duplicating it. The hook command it writes is an absolute path inside
+`~/.teeras/afterhours`, so it keeps working after the `npx` directory is gone.
+Remove the Teeras entries from the settings file to stop hook measurement, or
+run `trs off` to do that for you — it clears the Teeras entries from both
+agents' settings and deletes the local runtime, leaving every other hook and
+your local journal and credentials untouched. If a settings file cannot be
+read, `trs off` leaves both that file and the runtime alone and says so: the
+entry it could not remove still points at the runtime, and deleting it would
+leave your agent calling a command that is gone.
+
+To review the configuration and merge it by hand instead:
+
+```sh
+# Codex CLI and Codex desktop app
+trs hook-config codex
+
+# Claude Code
+trs hook-config claude
+```
+
+For Codex, review the fragment and merge it into
+`$CODEX_HOME/hooks.json` (normally `~/.codex/hooks.json`), then review and trust
+the hook in Codex. The user-level Codex configuration is shared by the desktop
+app and CLI. For Claude Code, merge the fragment into
+`$CLAUDE_CONFIG_DIR/settings.json` (normally `~/.claude/settings.json`).
+Claude Code Desktop and CLI share hooks even though they maintain separate
+session histories.
+
+The hook command reduces each event immediately to a timestamp, an opaque
+device-keyed session id, and one allowlisted lifecycle kind. The id is keyed
+with a stable per-device secret (never a rotating login token), so episodes
+stay consistent across logins. Prompt text, working directories, transcript
+paths, tool inputs, notification messages, and outputs are discarded before
+the local journal is written.
+
+`trs sources` reports Codex and Claude Code hook status separately — event
+count and last event time — so a misconfigured or logged-out hook is visible
+instead of silently recording nothing. Passive local-history measurement
+continues even if hooks are unavailable in an older client version.
+
+Hooks improve measurement only. They do not currently trigger Walk Mode or
+claim that an autonomous runway prediction is valid. Teeras first asks
+participants to confirm episode boundaries and attention estimates in order to
+validate the measurement contract.

package/dist/activity.d.ts

@@ -1,13 +1,27 @@
-import type { ActivityBucket, SourceId, SourceSnapshot, TokenCounts } from "./types.js";
+import type { ActivityBucket, DelegationEpisode, EpisodeConfidence, SourceId, SourceSnapshot, TokenCounts } from "./types.js";
 export interface LocalEvent {
     at: number;
     kind: "agent" | "human";
 }
 export declare const EMPTY_TOKENS: TokenCounts;
 export declare function finiteNumber(value: unknown): number;
+export declare function optionalFiniteNumber(value: unknown): number | null;
+export declare function addToken(total: number | null, value: number | null): number | null;
 export declare function timestamp(value: unknown): number | null;
 export declare function inWindow(at: number, sinceMs: number, untilMs: number): boolean;
+/** Local calendar date in the same format buckets and episodes use. */
+export declare function localDateOf(at: number): string;
+export declare function opaqueEpisodeId(secret: string, sourceId: string, sourceSession: string): string;
 export declare function bucketsFrom(events: LocalEvent[]): ActivityBucket[];
 export declare function emptySource(id: SourceId, name: string, configured: boolean): SourceSnapshot;
+export declare function delegationEpisode(input: {
+    id: string;
+    adapterVersion: string;
+    events: LocalEvent[];
+    tokens: TokenCounts;
+    untilMs: number;
+    confidence?: EpisodeConfidence;
+    modelFamily?: string | null;
+}): DelegationEpisode | null;
 export declare function finishSource(source: SourceSnapshot, events: LocalEvent[], fidelity?: SourceSnapshot["fidelity"]): SourceSnapshot;
 //# sourceMappingURL=activity.d.ts.map

package/dist/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,YAAY,EAAE,WAA8D,CAAC;AAE1F,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIvD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9E;AAwBD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAyBlE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,cAAc,CAY3F;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,UAAU,EAAE,EACpB,QAAQ,GAAE,cAAc,CAAC,UAAU,CAAc,GAChD,cAAc,CAMhB"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,YAAY,EAAE,WAA0E,CAAC;AAEtG,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAElE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAElF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIvD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAUD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAQ/F;AAgBD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAyBlE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,cAAc,CAa3F;AA2BD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,iBAAiB,GAAG,IAAI,CA8B3B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,UAAU,EAAE,EACpB,QAAQ,GAAE,cAAc,CAAC,UAAU,CAAc,GAChD,cAAc,CAMhB"}

package/dist/activity.js

@@ -1,7 +1,14 @@
-export const EMPTY_TOKENS = { input: 0, cached: 0, output: 0, reasoning: 0 };
+import { createHmac } from "node:crypto";
+export const EMPTY_TOKENS = { input: null, cached: null, output: null, reasoning: null };
 export function finiteNumber(value) {
     return typeof value === "number" && Number.isFinite(value) ? Math.max(0, value) : 0;
 }
+export function optionalFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? Math.max(0, value) : null;
+}
+export function addToken(total, value) {
+    return value == null ? total : (total ?? 0) + value;
+}
 export function timestamp(value) {
     if (typeof value !== "string" && typeof value !== "number")
         return null;
@@ -11,6 +18,10 @@ export function timestamp(value) {
 export function inWindow(at, sinceMs, untilMs) {
     return at >= sinceMs && at <= untilMs;
 }
+/** Local calendar date in the same format buckets and episodes use. */
+export function localDateOf(at) {
+    return localClock(at).localDate;
+}
 function localClock(at) {
     const d = new Date(at);
     const localDate = [d.getFullYear(), String(d.getMonth() + 1).padStart(2, "0"), String(d.getDate()).padStart(2, "0")].join("-");
@@ -18,6 +29,15 @@ function localClock(at) {
     d.setMinutes(0, 0, 0);
     return { hour: d.toISOString(), localDate, localHour: hourOfDay };
 }
+export function opaqueEpisodeId(secret, sourceId, sourceSession) {
+    return createHmac("sha256", secret)
+        .update("afterhours/delegation-episode/v1\0")
+        .update(sourceId)
+        .update("\0")
+        .update(sourceSession)
+        .digest("hex")
+        .slice(0, 40);
+}
 function observedMinutes(events, capMinutes) {
     const byHour = new Map();
     const sorted = [...new Set(events)].sort((a, b) => a - b);
@@ -69,6 +89,61 @@ export function emptySource(id, name, configured) {
         humanCheckIns: 0,
         tokens: { ...EMPTY_TOKENS },
         buckets: [],
+        episodes: [],
+    };
+}
+function minutesFrom(events, kind, capMinutes) {
+    return [...observedMinutes(events.filter((event) => event.kind === kind).map((event) => event.at), capMinutes).values()].reduce((sum, value) => sum + value, 0);
+}
+function longestAutonomousRun(events) {
+    const sorted = [...events].sort((a, b) => a.at - b.at);
+    let current = 0;
+    let longest = 0;
+    for (let index = 0; index < sorted.length; index += 1) {
+        const event = sorted[index];
+        if (!event)
+            continue;
+        if (event.kind === "human") {
+            current = 0;
+            continue;
+        }
+        const next = sorted[index + 1];
+        current += next == null ? 1 : Math.max(1, Math.min(5, (next.at - event.at) / 60_000));
+        longest = Math.max(longest, current);
+    }
+    return Math.round(longest * 100) / 100;
+}
+export function delegationEpisode(input) {
+    if (input.events.length === 0)
+        return null;
+    const events = [...input.events].sort((a, b) => a.at - b.at);
+    const first = events[0];
+    const last = events.at(-1);
+    if (!first || !last)
+        return null;
+    const humanCheckIns = events.filter((event) => event.kind === "human").length;
+    const clock = localClock(first.at);
+    return {
+        id: input.id,
+        startedAt: new Date(first.at).toISOString(),
+        endedAt: new Date(last.at).toISOString(),
+        localDate: clock.localDate,
+        localStartHour: clock.localHour,
+        status: input.untilMs - last.at <= 5 * 60_000 ? "open" : "observed_end",
+        confidence: input.confidence ?? "high",
+        metricVersion: "delegation-episode-v1",
+        adapterVersion: input.adapterVersion,
+        modelFamily: input.modelFamily ?? null,
+        agentTurns: events.filter((event) => event.kind === "agent").length,
+        humanCheckIns,
+        humanReEntries: Math.max(0, humanCheckIns - 1),
+        agentActiveMinutes: Math.round(minutesFrom(events, "agent", 5) * 100) / 100,
+        humanAttentionMinutes: Math.round(minutesFrom(events, "human", 10) * 100) / 100,
+        longestAutonomousRunMinutes: longestAutonomousRun(events),
+        approvalRequests: null,
+        failureEvents: null,
+        reworkEvents: null,
+        tokens: { ...input.tokens },
     };
 }
 export function finishSource(source, events, fidelity = "activity") {

package/dist/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"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"}

package/dist/autosync.d.ts

@@ -0,0 +1,22 @@
+import { spawn } from "node:child_process";
+export declare const AUTO_SYNC_WINDOW_MS: number;
+export interface SyncStamp {
+    attemptedAt: string | null;
+    succeededAt: string | null;
+}
+export declare function syncStampPath(home?: string): string;
+export declare function readSyncStamp(home?: string): SyncStamp;
+export declare function markSyncAttempt(home?: string, now?: number): void;
+export declare function markSyncSuccess(home?: string, now?: number): void;
+export declare function shouldAutoSync(home?: string, now?: number, windowMs?: number): boolean;
+/**
+ * Authoritative, child-side sync. Attempts are stamped before the network call
+ * so a failing server is retried at the window cadence, never per hook event.
+ */
+export declare function runAutoSync(home?: string, fetcher?: typeof fetch, now?: number): Promise<boolean>;
+/**
+ * Cheap parent-side decision inside `trs hook`: never network I/O here — the
+ * hook must return within the agent's timeout. The child re-checks the window.
+ */
+export declare function maybeSpawnAutoSync(cliPath: string, home?: string, spawner?: typeof spawn, now?: number): boolean;
+//# sourceMappingURL=autosync.d.ts.map

package/dist/autosync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autosync.d.ts","sourceRoot":"","sources":["../src/autosync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAO3C,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,IAAI,SAAY,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,IAAI,SAAY,GAAG,SAAS,CASzD;AAUD,wBAAgB,eAAe,CAAC,IAAI,SAAY,EAAE,GAAG,SAAa,GAAG,IAAI,CAExE;AAED,wBAAgB,eAAe,CAAC,IAAI,SAAY,EAAE,GAAG,SAAa,GAAG,IAAI,CAExE;AAED,wBAAgB,cAAc,CAAC,IAAI,SAAY,EAAE,GAAG,SAAa,EAAE,QAAQ,SAAsB,GAAG,OAAO,CAW1G;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,SAAY,EAAE,OAAO,GAAE,OAAO,KAAa,EAAE,GAAG,SAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAarH;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,SAAY,EAChB,OAAO,GAAE,OAAO,KAAa,EAC7B,GAAG,SAAa,GACf,OAAO,CAST"}

package/dist/autosync.js

@@ -0,0 +1,85 @@
+import { spawn } from "node:child_process";
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { readCredentials, syncSnapshot } from "./cloud.js";
+import { collectAfterhours } from "./collect.js";
+export const AUTO_SYNC_WINDOW_MS = 45 * 60_000;
+export function syncStampPath(home = homedir()) {
+    return join(home, ".teeras", "afterhours", "last-sync.json");
+}
+export function readSyncStamp(home = homedir()) {
+    try {
+        const value = JSON.parse(readFileSync(syncStampPath(home), "utf8"));
+        const iso = (candidate) => typeof candidate === "string" && Number.isFinite(Date.parse(candidate)) ? candidate : null;
+        return { attemptedAt: iso(value.attemptedAt), succeededAt: iso(value.succeededAt) };
+    }
+    catch {
+        return { attemptedAt: null, succeededAt: null };
+    }
+}
+function writeSyncStamp(stamp, home) {
+    const path = syncStampPath(home);
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    chmodSync(dirname(path), 0o700);
+    writeFileSync(path, `${JSON.stringify(stamp, null, 2)}\n`, { mode: 0o600 });
+    chmodSync(path, 0o600);
+}
+export function markSyncAttempt(home = homedir(), now = Date.now()) {
+    writeSyncStamp({ ...readSyncStamp(home), attemptedAt: new Date(now).toISOString() }, home);
+}
+export function markSyncSuccess(home = homedir(), now = Date.now()) {
+    writeSyncStamp({ ...readSyncStamp(home), succeededAt: new Date(now).toISOString() }, home);
+}
+export function shouldAutoSync(home = homedir(), now = Date.now(), windowMs = AUTO_SYNC_WINDOW_MS) {
+    if (!readCredentials(home))
+        return false;
+    const stamp = readSyncStamp(home);
+    // Manual commands (`setup`, `connect`, `login`, `sync`, `week`) stamp success
+    // only, so the window has to answer to whichever happened last — otherwise a
+    // hook event seconds after `trs setup` spawns a redundant sync.
+    const times = [stamp.attemptedAt, stamp.succeededAt]
+        .map((value) => (value ? Date.parse(value) : null))
+        .filter((value) => value != null);
+    if (times.length === 0)
+        return true;
+    return now - Math.max(...times) >= windowMs;
+}
+/**
+ * Authoritative, child-side sync. Attempts are stamped before the network call
+ * so a failing server is retried at the window cadence, never per hook event.
+ */
+export async function runAutoSync(home = homedir(), fetcher = fetch, now = Date.now()) {
+    if (!shouldAutoSync(home, now))
+        return false;
+    const credentials = readCredentials(home);
+    if (!credentials)
+        return false;
+    markSyncAttempt(home, now);
+    try {
+        await syncSnapshot(collectAfterhours({ home }), credentials, fetcher);
+        markSyncSuccess(home, now);
+        return true;
+    }
+    catch {
+        // Failure is visible via `trs sources` (last attempt vs last success).
+        return false;
+    }
+}
+/**
+ * Cheap parent-side decision inside `trs hook`: never network I/O here — the
+ * hook must return within the agent's timeout. The child re-checks the window.
+ */
+export function maybeSpawnAutoSync(cliPath, home = homedir(), spawner = spawn, now = Date.now()) {
+    if (!shouldAutoSync(home, now))
+        return false;
+    try {
+        const child = spawner(process.execPath, [cliPath, "autosync"], { detached: true, stdio: "ignore" });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=autosync.js.map

package/dist/autosync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autosync.js","sourceRoot":"","sources":["../src/autosync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,MAAM,CAAC;AAO/C,MAAM,UAAU,aAAa,CAAC,IAAI,GAAG,OAAO,EAAE;IAC5C,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAI,GAAG,OAAO,EAAE;IAC5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAuB,CAAC;QAC1F,MAAM,GAAG,GAAG,CAAC,SAAkB,EAAiB,EAAE,CAChD,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7F,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAgB,EAAE,IAAY;IACpD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAI,GAAG,OAAO,EAAE,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAChE,cAAc,CAAC,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAI,GAAG,OAAO,EAAE,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAChE,cAAc,CAAC,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAI,GAAG,OAAO,EAAE,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,GAAG,mBAAmB;IAC/F,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,8EAA8E;IAC9E,6EAA6E;IAC7E,gEAAgE;IAChE,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC;SACjD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,QAAQ,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAI,GAAG,OAAO,EAAE,EAAE,UAAwB,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACjG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/B,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACtE,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,IAAI,GAAG,OAAO,EAAE,EAChB,UAAwB,KAAK,EAC7B,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAEhB,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpG,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/cli.js

@@ -1,10 +1,18 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { collectAfterhours } from "./collect.js";
 import { openVerificationUri, pollDeviceLogin, readCredentials, removeCredentials, revokeDevice, startDeviceLogin, syncSnapshot, teerasBaseUrl, writeCredentials, } from "./cloud.js";
 import { detectCodingAgents } from "./detect.js";
+import { runOff } from "./off.js";
 import { DATA_BOUNDARY } from "./privacy.js";
+import { qrBlock } from "./qr.js";
 import { renderReport } from "./render.js";
 import { reportFrom } from "./report.js";
+import { claudeHookSettings, codexHookSettings, hookJournalReport, ingestClaudeHook, ingestCodexHook, } from "./hooks.js";
+import { ensureEpisodeSecret } from "./secret.js";
+import { maybeSpawnAutoSync, markSyncSuccess, readSyncStamp, runAutoSync } from "./autosync.js";
+import { runSetup } from "./setup.js";
 async function requireAccount() {
     const existing = readCredentials();
     if (existing)
@@ -27,12 +35,49 @@ async function requireAccount() {
 }
 async function main() {
     const command = process.argv[2];
+    if (command === "hook") {
+        // Recording stays gated on an account connection; `trs sources` reports a
+        // stale journal so this silent skip is visible instead of a mystery.
+        if (!readCredentials())
+            return;
+        try {
+            const raw = readFileSync(0, "utf8");
+            if (process.argv[3] === "codex")
+                ingestCodexHook(raw, ensureEpisodeSecret());
+            else
+                ingestClaudeHook(raw, ensureEpisodeSecret());
+            // Sync as a side effect of working: detached child, never blocks the hook.
+            maybeSpawnAutoSync(fileURLToPath(import.meta.url));
+        }
+        catch {
+            // Hooks are observability only and must never interrupt the agent.
+        }
+        return;
+    }
+    if (command === "autosync") {
+        // Hidden child command spawned by the hook branch; safe to run manually.
+        await runAutoSync();
+        return;
+    }
+    if (command === "hook-config") {
+        const source = process.argv[3] ?? "claude";
+        if (source === "codex") {
+            process.stdout.write(`${JSON.stringify(codexHookSettings(), null, 2)}\n`);
+        }
+        else if (source === "claude") {
+            process.stdout.write(`${JSON.stringify(claudeHookSettings(), null, 2)}\n`);
+        }
+        else {
+            process.stdout.write("usage: trs hook-config <codex|claude>\n");
+        }
+        return;
+    }
     if (command === "privacy") {
         process.stdout.write(`${JSON.stringify(DATA_BOUNDARY, null, 2)}\n`);
         return;
     }
     if (command === "connect") {
-        await requireAccount();
+        const credentials = await requireAccount();
         const installed = detectCodingAgents().filter((agent) => agent.installed);
         const lines = installed.length === 0
             ? ["  no coding agents found yet — install one, then run `trs connect` again."]
@@ -41,13 +86,25 @@ async function main() {
                 const state = agent.connection === "automatic" ? "connected locally" : "detected · connector needed";
                 return `  ${mark} ${agent.name.padEnd(22)} ${state}`;
             });
-        process.stdout.write(["", "  teeras · connect", "", ...lines, "", "  Prompt, code, and output are never retained or synced.", ""].join("\n"));
+        await syncSnapshot(collectAfterhours(), credentials);
+        markSyncSuccess();
+        process.stdout.write([
+            "",
+            "  teeras · connected",
+            "",
+            ...lines,
+            "",
+            "  ✓ your first week is ready on web and mobile",
+            "  Prompt, code, and output are never retained or synced.",
+            "",
+        ].join("\n"));
         return;
     }
     if (command === "login") {
         const credentials = await requireAccount();
         const snapshot = collectAfterhours();
         await syncSnapshot(snapshot, credentials);
+        markSyncSuccess();
         process.stdout.write("\n  ✓ connected · your first counts-only week is in Teeras.\n\n");
         return;
     }
@@ -58,32 +115,55 @@ async function main() {
         process.stdout.write(`\n  ${removed ? `✓ disconnected${revoked ? " and revoked" : " locally"}` : "this computer was not connected"}.\n\n`);
         return;
     }
+    if (command === "off") {
+        process.stdout.write(runOff().lines.join("\n"));
+        return;
+    }
     if (command === "sync") {
         const credentials = await requireAccount();
         const result = await syncSnapshot(collectAfterhours(), credentials);
+        markSyncSuccess();
         process.stdout.write(`\n  ✓ ${result.stored ? "your AI life moved forward" : "already beautifully up to date"}.\n\n`);
         return;
     }
-    if (command != null && !["week", "sources", "json", "--json", "setup"].includes(command)) {
-        process.stdout.write("usage: trs <week|connect|login|sync|logout|sources|privacy|json>\n");
+    if (command === "setup") {
+        await runSetup({ json: process.argv.includes("--json") });
         return;
     }
-    const credentials = await requireAccount();
+    if (command != null && !["week", "sources", "json", "--json", "autosync"].includes(command)) {
+        process.stdout.write("usage: trs <setup|week|connect|login|sync|logout|off|sources|privacy|json|hook-config>\n");
+        return;
+    }
+    const credentials = readCredentials();
     const snapshot = collectAfterhours();
+    if (!credentials && (command === "json" || command === "--json" || command === "sources")) {
+        process.stderr.write("  not connected yet · `npx @teeras/afterhours setup` links web + mobile\n");
+    }
     if (command === "--json" || command === "json") {
         process.stdout.write(`${JSON.stringify(snapshot, null, 2)}\n`);
         return;
     }
-    if (command == null || command === "week" || command === "setup") {
+    if (command == null || command === "week") {
         process.stdout.write(renderReport(snapshot, reportFrom(snapshot)));
+        if (!credentials) {
+            process.stdout.write("  Your baseline starts here.\n");
+            process.stdout.write("  See AI activity, sleep, and recovery together: `npx @teeras/afterhours setup`\n\n");
+            return;
+        }
         try {
-            await syncSnapshot(snapshot, credentials);
-            process.stdout.write("  ✓ history synced to your Teeras account\n\n");
+            const synced = await syncSnapshot(snapshot, credentials);
+            markSyncSuccess();
+            process.stdout.write("  ✓ history synced to your Teeras account\n");
+            if (!synced.reflectedToday) {
+                process.stdout.write("  ten-second check-in waiting · teeras.com/app\n");
+            }
+            process.stdout.write("\n");
         }
         catch (error) {
             const message = error instanceof Error ? error.message : "sync unavailable";
             process.stdout.write(`  local report is safe · ${message}\n\n`);
         }
+        process.stdout.write(`${qrBlock(process.stdout.isTTY === true).join("\n")}\n\n`);
         return;
     }
     if (command === "sources") {
@@ -92,7 +172,30 @@ async function main() {
             status: source.configured ? source.fidelity : "not found",
             sessions: source.sessions,
         }));
-        process.stdout.write(`${JSON.stringify(rows, null, 2)}\n`);
+        const journal = hookJournalReport();
+        const claudeJournal = hookJournalReport(undefined, undefined, "claude-code");
+        const codexJournal = hookJournalReport(undefined, undefined, "codex");
+        const hookStatus = (report, install) => journal.journalExists
+            ? {
+                status: report.eventCount > 0 ? "recording" : "no events yet",
+                events: report.eventCount,
+                lastEventAt: report.lastEventAt,
+                ...(report.eventCount === 0 ? { install } : {}),
+            }
+            : { status: "not installed", install };
+        const claudeHook = hookStatus(claudeJournal, "trs hook-config claude");
+        const codexHook = hookStatus(codexJournal, "trs hook-config codex");
+        const stamp = readSyncStamp();
+        process.stdout.write(`${JSON.stringify({
+            sources: rows,
+            codexHook,
+            claudeHook,
+            cloudSync: {
+                connected: credentials != null,
+                lastAttemptAt: stamp.attemptedAt,
+                lastSuccessAt: stamp.succeededAt,
+            },
+        }, null, 2)}\n`);
         return;
     }
 }