claudelink 1.4.3 → 1.5.0

package/dist/context-watcher-settings.js

@@ -0,0 +1,176 @@
+"use strict";
+// Persistent settings for the context-hygiene watcher. Stored as JSON at
+// ~/.claudelink/context-watcher.json. Parallel to recovery-watcher-settings.ts.
+//
+// The watcher monitors each live agent's CURRENT context occupancy (read from
+// its Claude Code transcript) and, at a threshold, nudges /compact into that
+// terminal so the agent stops re-reading a huge context every turn.
+//
+// SAFETY: mode defaults to "observe" — detect + log + project savings, NEVER
+// inject. "inject" mode (types /compact into live terminals) is founder-gated
+// and additionally idle-gated at dispatch time. enabled defaults to false.
+//
+// Defaults are CONSERVATIVE and PROVISIONAL — thresholdTokens / compactBaseline
+// align to the team's token/context protocol (dev-03) once it lands.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readContextWatcherSettings = readContextWatcherSettings;
+exports.writeContextWatcherSettings = writeContextWatcherSettings;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+// Settings location: defaults to ~/.claudelink/context-watcher.json. Honors
+// CLAUDELINK_CONTEXT_WATCHER_SETTINGS env var override so tests can run
+// against a temp file without disturbing the live fleet's config.
+// Evaluated on each call (not cached at module load) so tests can set the
+// env var AFTER importing the module.
+function settingsPath() {
+    return (process.env.CLAUDELINK_CONTEXT_WATCHER_SETTINGS ||
+        path_1.default.join(os_1.default.homedir(), ".claudelink", "context-watcher.json"));
+}
+const DEFAULTS = {
+    enabled: false,
+    mode: "observe",
+    intervalSec: 120,
+    contextOccupancyThreshold: 0.5,
+    dollarPerTurnThreshold: 0.27,
+    handshakeOverheadTokens: 5000,
+    activeWindowMin: 15,
+    thresholdTokens: 200000,
+    compactBaselineTokens: 60000,
+    cooldownMin: 30,
+    message: "/compact",
+    askMessage: "Context check (automated): you're at high context occupancy and currently idle. If this is a good moment to /compact, FIRST update your HANDOVER.md / artifacts so nothing is lost, THEN call signal_checkpoint with safe_to_clear=true and your handoff_path to consent — I'll /compact you on the next check. If you're mid-something-heavy, call signal_checkpoint with safe_to_clear=false and a one-line note and I'll hold off.",
+    consentFreshMin: 15,
+    injectAllowlist: [], // fail-closed: empty = arm nobody
+    oneShot: true,
+    activeSince: null,
+};
+function cleanAllowlist(v) {
+    if (!Array.isArray(v))
+        return [];
+    // Trim whitespace + drop empties + dedupe. Without trim, `["dev", "dev "]`
+    // would pass two distinct entries through and the gate's role-includes check
+    // would treat "dev " and "dev" as different roles — a footgun if the
+    // operator pastes a list with a stray space. Dedupe is belt-and-braces.
+    const seen = new Set();
+    const out = [];
+    for (const x of v) {
+        if (typeof x !== "string")
+            continue;
+        const trimmed = x.trim();
+        if (trimmed.length === 0)
+            continue;
+        if (seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+function clampInt(n, lo, hi, dflt) {
+    if (Number.isNaN(n))
+        return dflt;
+    return Math.max(lo, Math.min(hi, Math.floor(n)));
+}
+// Fractional [0,1]-style threshold, clamped to a sensible operational range.
+// Lower bound 0.10 prevents a typo (0.05) from arming the whole fleet at 10K
+// tokens; upper bound 0.95 keeps any nonzero fire latitude on a model whose
+// window we mis-estimate.
+function clampFrac(n, lo, hi, dflt) {
+    if (!Number.isFinite(n))
+        return dflt;
+    return Math.max(lo, Math.min(hi, n));
+}
+function readContextWatcherSettings() {
+    const SETTINGS_PATH = settingsPath();
+    try {
+        const raw = fs_1.default.readFileSync(SETTINGS_PATH, "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            enabled: Boolean(parsed.enabled),
+            mode: parsed.mode === "inject" ? "inject" : "observe",
+            intervalSec: clampInt(Number(parsed.intervalSec), 30, 600, DEFAULTS.intervalSec),
+            contextOccupancyThreshold: clampFrac(Number(parsed.contextOccupancyThreshold), 0.1, 0.95, DEFAULTS.contextOccupancyThreshold),
+            dollarPerTurnThreshold: Number.isFinite(Number(parsed.dollarPerTurnThreshold)) && Number(parsed.dollarPerTurnThreshold) > 0
+                ? Math.max(0.01, Math.min(10, Number(parsed.dollarPerTurnThreshold)))
+                : DEFAULTS.dollarPerTurnThreshold,
+            handshakeOverheadTokens: clampInt(Number(parsed.handshakeOverheadTokens), 0, 50000, DEFAULTS.handshakeOverheadTokens),
+            activeWindowMin: clampInt(Number(parsed.activeWindowMin), 1, 240, DEFAULTS.activeWindowMin),
+            thresholdTokens: clampInt(Number(parsed.thresholdTokens), 20000, 1000000, DEFAULTS.thresholdTokens),
+            compactBaselineTokens: clampInt(Number(parsed.compactBaselineTokens), 5000, 200000, DEFAULTS.compactBaselineTokens),
+            cooldownMin: clampInt(Number(parsed.cooldownMin), 5, 240, DEFAULTS.cooldownMin),
+            message: typeof parsed.message === "string" && parsed.message.length > 0
+                ? parsed.message
+                : DEFAULTS.message,
+            askMessage: typeof parsed.askMessage === "string" && parsed.askMessage.length > 0
+                ? parsed.askMessage
+                : DEFAULTS.askMessage,
+            consentFreshMin: clampInt(Number(parsed.consentFreshMin), 1, 120, DEFAULTS.consentFreshMin),
+            injectAllowlist: cleanAllowlist(parsed.injectAllowlist),
+            oneShot: parsed.oneShot === undefined ? DEFAULTS.oneShot : Boolean(parsed.oneShot),
+            activeSince: typeof parsed.activeSince === "string" && parsed.activeSince.length > 0
+                ? parsed.activeSince
+                : null,
+        };
+    }
+    catch {
+        return { ...DEFAULTS };
+    }
+}
+function writeContextWatcherSettings(partial) {
+    const current = readContextWatcherSettings();
+    const merged = {
+        enabled: partial.enabled !== undefined ? Boolean(partial.enabled) : current.enabled,
+        mode: partial.mode === "inject" || partial.mode === "observe" ? partial.mode : current.mode,
+        intervalSec: partial.intervalSec !== undefined
+            ? clampInt(Number(partial.intervalSec), 30, 600, current.intervalSec)
+            : current.intervalSec,
+        contextOccupancyThreshold: partial.contextOccupancyThreshold !== undefined
+            ? clampFrac(Number(partial.contextOccupancyThreshold), 0.1, 0.95, current.contextOccupancyThreshold)
+            : current.contextOccupancyThreshold,
+        dollarPerTurnThreshold: partial.dollarPerTurnThreshold !== undefined && Number(partial.dollarPerTurnThreshold) > 0
+            ? Math.max(0.01, Math.min(10, Number(partial.dollarPerTurnThreshold)))
+            : current.dollarPerTurnThreshold,
+        handshakeOverheadTokens: partial.handshakeOverheadTokens !== undefined
+            ? clampInt(Number(partial.handshakeOverheadTokens), 0, 50000, current.handshakeOverheadTokens)
+            : current.handshakeOverheadTokens,
+        activeWindowMin: partial.activeWindowMin !== undefined
+            ? clampInt(Number(partial.activeWindowMin), 1, 240, current.activeWindowMin)
+            : current.activeWindowMin,
+        thresholdTokens: partial.thresholdTokens !== undefined
+            ? clampInt(Number(partial.thresholdTokens), 20000, 1000000, current.thresholdTokens)
+            : current.thresholdTokens,
+        compactBaselineTokens: partial.compactBaselineTokens !== undefined
+            ? clampInt(Number(partial.compactBaselineTokens), 5000, 200000, current.compactBaselineTokens)
+            : current.compactBaselineTokens,
+        cooldownMin: partial.cooldownMin !== undefined
+            ? clampInt(Number(partial.cooldownMin), 5, 240, current.cooldownMin)
+            : current.cooldownMin,
+        message: partial.message !== undefined && typeof partial.message === "string" && partial.message.length > 0
+            ? partial.message
+            : current.message,
+        askMessage: partial.askMessage !== undefined && typeof partial.askMessage === "string" && partial.askMessage.length > 0
+            ? partial.askMessage
+            : current.askMessage,
+        consentFreshMin: partial.consentFreshMin !== undefined
+            ? clampInt(Number(partial.consentFreshMin), 1, 120, current.consentFreshMin)
+            : current.consentFreshMin,
+        injectAllowlist: partial.injectAllowlist !== undefined ? cleanAllowlist(partial.injectAllowlist) : current.injectAllowlist,
+        oneShot: partial.oneShot !== undefined ? Boolean(partial.oneShot) : current.oneShot,
+        activeSince: partial.activeSince !== undefined
+            ? (typeof partial.activeSince === "string" && partial.activeSince.length > 0 ? partial.activeSince : null)
+            : current.activeSince,
+    };
+    const SETTINGS_PATH = settingsPath();
+    const dir = path_1.default.dirname(SETTINGS_PATH);
+    if (!fs_1.default.existsSync(dir))
+        fs_1.default.mkdirSync(dir, { recursive: true });
+    const tmp = SETTINGS_PATH + ".tmp";
+    fs_1.default.writeFileSync(tmp, JSON.stringify(merged, null, 2));
+    fs_1.default.renameSync(tmp, SETTINGS_PATH);
+    return merged;
+}
+//# sourceMappingURL=context-watcher-settings.js.map

package/dist/context-watcher-settings.js.map

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

package/dist/context-watcher.d.ts

@@ -0,0 +1,70 @@
+import { WatcherMode } from "./context-watcher-settings.js";
+export interface GateStatusFields {
+    role: string;
+    agent_id: string;
+    mode: WatcherMode;
+    decision: string;
+    reason?: string;
+    context?: number;
+    occupancy_pct?: number;
+    model?: string;
+    per_turn_usd?: number;
+    turns_per_hr?: number;
+    progressing?: boolean;
+    signal_age_min?: number | null;
+    signal_age_turns?: number;
+    safe_to_clear?: 0 | 1;
+    economic_gate?: boolean;
+    ambiguous?: boolean;
+    allowlisted?: boolean;
+    idle?: boolean;
+    fresh_consent?: boolean;
+    handoff_ok?: boolean;
+    net_saved_usd?: number;
+}
+export declare function formatGateStatus(f: GateStatusFields): string;
+interface TurnEconomics {
+    contextTokens: number;
+    model: string;
+    lastTurnTs: number;
+    turnsPerHour: number;
+}
+export declare function latestTurnEconomics(file: string): Promise<TurnEconomics | null>;
+export interface CompactOpportunity {
+    windowDays: number;
+    thresholdTokens: number;
+    compactBaselineTokens: number;
+    flaggedTurns: number;
+    excessTokensUpperBound: number;
+    estUsdUpperBound: number;
+    perProject: {
+        label: string;
+        roles: string[];
+        flaggedTurns: number;
+        excessTokens: number;
+    }[];
+}
+interface AgentRef {
+    role: string;
+    pid: number;
+}
+export declare function projectCompactOpportunity(agents: AgentRef[], windowDays?: number, thresholdTokens?: number, compactBaselineTokens?: number): Promise<CompactOpportunity>;
+export declare function armGate(file: string, checkpointTs: number | null): Promise<{
+    idle: boolean;
+    turnsSinceSignal: number;
+    detail: string;
+    latestType: string;
+    ageSec: number;
+}>;
+export interface ContextWatcherHandle {
+    reschedule: () => void;
+    stop: () => void;
+    tickNow: () => Promise<{
+        checked: number;
+        flagged: number;
+        wouldNudge: number;
+        injected: number;
+    }>;
+}
+export declare function startContextWatcher(): ContextWatcherHandle;
+export {};