harnery 0.35.0 → 0.37.0

package/dist/core/governor/service-read.js

@@ -1,7 +1,13 @@
-import { existsSync, readFileSync, statSync } from "node:fs";
+import { closeSync, existsSync, openSync, readFileSync, readSync, statSync } from "node:fs";
 import { hostname } from "node:os";
 import { join, resolve } from "node:path";
+import { gunzipSync } from "node:zlib";
+import { coordEnv } from "../../lib/env.js";
+import { createStorageCatalog } from "../storage/catalog.js";
+import { parseLogRecord } from "../storage/jsonl.js";
+import { familyLogDirectory, readSegmentManifest } from "../storage/segments.js";
 const MAX_FILE_BYTES = 512 * 1024;
+const MAX_LOG_RECORDS = 10_000;
 const MAX_GOALS = 100;
 const FOREIGN_STATUS_STALE_MS = 30_000;
 export function readGovernorServiceConfig(coordRootRaw) {
@@ -65,7 +71,265 @@ export function readGovernorServiceStatus(coordRootRaw) {
     return { running, stale: !running && record.state !== "stopped", record, config, runtime };
 }
 export function governorServiceLogPath(coordRoot) {
-    return join(serviceDir(resolve(coordRoot)), "service.log");
+    const root = resolve(coordRoot);
+    const legacy = join(serviceDir(root), "service.log");
+    if (coordEnv("SHARED_LOGS") === "0")
+        return legacy;
+    try {
+        const family = createStorageCatalog({ coord_root: root }).require("governor-service-log");
+        const directory = familyLogDirectory(family);
+        readSegmentManifest(directory, family);
+        const active = join(directory, "active.jsonl");
+        return existsSync(active) || !existsSync(legacy) ? active : legacy;
+    }
+    catch {
+        return legacy;
+    }
+}
+/** Read shared generations plus untouched legacy history under one aggregate budget. */
+export function readGovernorServiceLogs(coordRootRaw, options = {}) {
+    const coordRoot = resolve(coordRootRaw);
+    const maxBytes = options.max_bytes ?? MAX_FILE_BYTES;
+    const maxRecords = options.max_records ?? MAX_LOG_RECORDS;
+    if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
+        throw new Error("governor service log byte budget must be a positive integer");
+    }
+    if (!Number.isSafeInteger(maxRecords) || maxRecords <= 0) {
+        throw new Error("governor service log record budget must be a positive integer");
+    }
+    let bytes = 0;
+    let records = 0;
+    let truncated = false;
+    const reads = [];
+    if (coordEnv("SHARED_LOGS") !== "0") {
+        try {
+            const shared = readSharedGovernorLogs(coordRoot, maxBytes, maxRecords);
+            reads.push(shared.entries);
+            bytes += shared.bytes;
+            records += shared.records;
+            truncated ||= shared.truncated;
+        }
+        catch {
+            // A corrupt or racing shared generation fails closed into bounded legacy history.
+            truncated = true;
+        }
+    }
+    for (const legacy of [
+        { path: join(serviceDir(coordRoot), "events.jsonl"), structured: true },
+        { path: join(serviceDir(coordRoot), "service.log"), structured: false },
+    ]) {
+        const remainingBytes = maxBytes - bytes;
+        const remainingRecords = maxRecords - records;
+        if (remainingBytes <= 0 || remainingRecords <= 0) {
+            if (existsSync(legacy.path))
+                truncated = true;
+            continue;
+        }
+        const read = readLegacyGovernorLog(legacy.path, legacy.structured, remainingBytes, remainingRecords);
+        reads.push(read.entries);
+        bytes += read.bytes;
+        records += read.records;
+        truncated ||= read.truncated;
+    }
+    const merged = new Map();
+    for (const entries of reads) {
+        for (const entry of entries)
+            if (!merged.has(entry.identity))
+                merged.set(entry.identity, entry);
+    }
+    const lines = [...merged.values()]
+        .sort((left, right) => (left.timestamp ?? "").localeCompare(right.timestamp ?? "") ||
+        left.identity.localeCompare(right.identity))
+        .map(({ line }) => line);
+    return { lines, bytes_read: bytes, records_examined: records, truncated };
+}
+function readSharedGovernorLogs(coordRoot, maxBytes, maxRecords) {
+    const family = createStorageCatalog({ coord_root: coordRoot }).require("governor-service-log");
+    const directory = familyLogDirectory(family);
+    let totalBytes = 0;
+    let totalRecords = 0;
+    let raced = false;
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        const remainingBytes = maxBytes - totalBytes;
+        const remainingRecords = maxRecords - totalRecords;
+        if (remainingBytes <= 0 || remainingRecords <= 0)
+            break;
+        const manifest = readSegmentManifest(directory, family);
+        const generation = manifestGeneration(manifest);
+        const sources = [
+            ...manifest.segments.map((segment) => ({ path: join(directory, segment.file), gzip: true })),
+            { path: join(directory, "active.jsonl"), gzip: false },
+        ];
+        const read = readSharedSources(sources, remainingBytes, remainingRecords);
+        totalBytes += read.bytes;
+        totalRecords += read.records;
+        const after = readSegmentManifest(directory, family);
+        if (manifestGeneration(after) === generation) {
+            return {
+                entries: read.entries,
+                bytes: totalBytes,
+                records: totalRecords,
+                truncated: raced || read.truncated,
+            };
+        }
+        raced = true;
+    }
+    return { entries: [], bytes: totalBytes, records: totalRecords, truncated: raced };
+}
+function readSharedSources(sources, maxBytes, maxRecords) {
+    const entries = [];
+    let bytes = 0;
+    let records = 0;
+    let truncated = false;
+    for (const source of sources) {
+        if (!existsSync(source.path))
+            continue;
+        if (bytes >= maxBytes || records >= maxRecords) {
+            truncated = true;
+            break;
+        }
+        const body = readBoundedSource(source.path, source.gzip, maxBytes - bytes, false);
+        bytes += body.bytes;
+        truncated ||= body.truncated;
+        for (const line of completeLines(body.body, false)) {
+            if (records >= maxRecords) {
+                truncated = true;
+                break;
+            }
+            records += 1;
+            try {
+                entries.push(normalizeSharedGovernorRecord(parseLogRecord(line)));
+            }
+            catch {
+                // Malformed rows count against the source budget but cannot poison the readable tail.
+            }
+        }
+    }
+    return { entries, bytes, records, truncated };
+}
+function readLegacyGovernorLog(path, structured, maxBytes, maxRecords) {
+    if (!existsSync(path))
+        return { entries: [], bytes: 0, records: 0, truncated: false };
+    const source = readBoundedSource(path, false, maxBytes, true);
+    const entries = [];
+    let records = 0;
+    let truncated = source.truncated;
+    for (const line of completeLines(source.body, source.truncated)) {
+        if (records >= maxRecords) {
+            truncated = true;
+            break;
+        }
+        records += 1;
+        if (!structured) {
+            entries.push({ identity: `text:${line}`, line });
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(line);
+            if (isRecord(parsed))
+                entries.push(normalizeLegacyGovernorRecord(parsed));
+        }
+        catch {
+            // Malformed legacy lines stay excluded while consuming their source budget.
+        }
+    }
+    return { entries, bytes: source.bytes, records, truncated };
+}
+function readBoundedSource(path, gzip, maxBytes, tail) {
+    if (maxBytes <= 0)
+        return { body: "", bytes: 0, truncated: true };
+    const size = statSync(path).size;
+    if (size <= 0)
+        return { body: "", bytes: 0, truncated: false };
+    if (gzip) {
+        if (size > maxBytes)
+            return { body: "", bytes: maxBytes, truncated: true };
+        try {
+            const output = gunzipSync(readFileSync(path), { maxOutputLength: maxBytes });
+            return {
+                body: output.toString("utf8"),
+                bytes: Math.max(size, output.byteLength),
+                truncated: false,
+            };
+        }
+        catch {
+            return { body: "", bytes: maxBytes, truncated: true };
+        }
+    }
+    const length = Math.min(size, maxBytes);
+    const buffer = Buffer.allocUnsafe(length);
+    const descriptor = openSync(path, "r");
+    try {
+        const bytes = readSync(descriptor, buffer, 0, length, tail ? size - length : 0);
+        return {
+            body: buffer.subarray(0, bytes).toString("utf8"),
+            bytes,
+            truncated: size > bytes,
+        };
+    }
+    finally {
+        closeSync(descriptor);
+    }
+}
+function completeLines(body, truncatedPrefix) {
+    const start = truncatedPrefix ? body.indexOf("\n") + 1 : 0;
+    const end = body.lastIndexOf("\n");
+    if (start < 0 || end < start)
+        return [];
+    return body.slice(start, end).split("\n").filter(Boolean);
+}
+function normalizeSharedGovernorRecord(record) {
+    if (record.family_id !== "governor-service-log")
+        throw new Error("wrong governor log family");
+    const payload = {
+        ...Object.fromEntries(Object.entries(record.fields).map(([key, value]) => [key, parseJsonField(value)])),
+        ts: record.emitted_at,
+        event: record.event,
+    };
+    return normalizedGovernorEntry(payload);
+}
+function normalizeLegacyGovernorRecord(record) {
+    const { schema_version: _schemaVersion, ...payload } = record;
+    return normalizedGovernorEntry(payload);
+}
+function normalizedGovernorEntry(payload) {
+    const identity = stableJson(payload);
+    return {
+        identity,
+        line: JSON.stringify(payload),
+        ...(typeof payload.ts === "string" ? { timestamp: payload.ts } : {}),
+    };
+}
+function parseJsonField(value) {
+    if (typeof value !== "string" || (!value.startsWith("[") && !value.startsWith("{"))) {
+        return value;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (value && typeof value === "object") {
+        return `{${Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, child]) => `${JSON.stringify(key)}:${stableJson(child)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "null";
+}
+function manifestGeneration(manifest) {
+    return JSON.stringify([
+        manifest.next_sequence,
+        manifest.segments.map((segment) => [segment.file, segment.sha256]),
+    ]);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readStatusRecord(coordRoot) {
     const path = join(serviceDir(coordRoot), "status.json");

package/dist/core/governor/service.d.ts

@@ -111,4 +111,5 @@ export declare function requestGovernorServiceStop(coordRootRaw: string): Govern
 export declare function runGovernorServiceSweep(input: RunGovernorServiceSweepInput): Promise<GovernorServiceSweepReport>;
 export declare function runGovernorServiceDaemon(input: RunGovernorServiceDaemonInput): Promise<GovernorServiceStatusRecord>;
 export declare function governorServiceLogPath(coordRoot: string): string;
+export declare function appendGovernorServiceDiagnostic(coordRoot: string, data: Record<string, unknown>): "shared" | "legacy";
 //# sourceMappingURL=service.d.ts.map

package/dist/core/governor/service.d.ts.map

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

package/dist/core/governor/service.js

@@ -1,9 +1,12 @@
 import { spawn } from "node:child_process";
 import { randomBytes, randomUUID } from "node:crypto";
-import { appendFileSync, chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
 import { hostname } from "node:os";
 import { dirname, join, resolve } from "node:path";
+import { coordEnv } from "../../lib/env.js";
 import { normalizePolicy } from "../policy/index.js";
+import { closeProcessLoggers, legacyLogFields, processLogger } from "../storage/logger.js";
+import { RotatingTextSink } from "../storage/process-log.js";
 import { runGovernor } from "./runner.js";
 import { readGovernor } from "./state.js";
 export const GOVERNOR_SERVICE_CONFIG_SCHEMA_VERSION = 1;
@@ -99,18 +102,21 @@ export async function spawnGovernorService(coordRootRaw) {
         throw new Error(`governor service is already running under pid ${current.record?.pid}`);
     }
     mkdirSync(serviceDir(coordRoot), { recursive: true, mode: 0o700 });
-    const logFd = openSync(serviceLogPath(coordRoot), "a", 0o600);
-    chmodSync(serviceLogPath(coordRoot), 0o600);
+    const sharedLogs = coordEnv("SHARED_LOGS") !== "0";
+    const logFd = sharedLogs ? undefined : openSync(serviceLogPath(coordRoot), "a", 0o600);
+    if (logFd !== undefined)
+        chmodSync(serviceLogPath(coordRoot), 0o600);
     const harnBin = new URL("../../../bin/harn", import.meta.url).pathname;
     if (!existsSync(harnBin)) {
-        closeSync(logFd);
+        if (logFd !== undefined)
+            closeSync(logFd);
         throw new Error(`cannot find harn executable at ${harnBin}`);
     }
     let spawnError;
     const child = spawn(harnBin, ["governor", "service", "daemon"], {
         cwd: coordRoot,
         detached: true,
-        stdio: ["ignore", logFd, logFd],
+        stdio: logFd === undefined ? ["ignore", "ignore", "ignore"] : ["ignore", logFd, logFd],
         env: {
             ...process.env,
             HARNERY_COORD_ROOT_OVERRIDE: coordRoot,
@@ -120,7 +126,8 @@ export async function spawnGovernorService(coordRootRaw) {
     child.once("error", (error) => {
         spawnError = error;
     });
-    closeSync(logFd);
+    if (logFd !== undefined)
+        closeSync(logFd);
     child.unref();
     const deadline = Date.now() + 5_000;
     while (Date.now() < deadline) {
@@ -133,7 +140,7 @@ export async function spawnGovernorService(coordRootRaw) {
         if (child.exitCode !== null)
             break;
     }
-    throw new Error(`governor service failed to start; inspect ${serviceLogPath(coordRoot)}`);
+    throw new Error(`governor service failed to start; inspect ${governorServiceLogPath(coordRoot)}`);
 }
 export function requestGovernorServiceStop(coordRootRaw) {
     const coordRoot = resolve(coordRootRaw);
@@ -233,7 +240,7 @@ export async function runGovernorServiceSweep(input) {
                 stop_reason: report.stop_reason,
                 next_wake_at: runtime.goals[goalId]?.next_wake_at,
             });
-            appendServiceEvent(coordRoot, {
+            appendGovernorServiceDiagnostic(coordRoot, {
                 event: "goal.tick",
                 goal_id: goalId,
                 stop_reason: report.stop_reason,
@@ -273,7 +280,7 @@ export async function runGovernorServiceSweep(input) {
                 reason: message,
                 next_wake_at: nextWakeAt,
             });
-            appendServiceEvent(coordRoot, {
+            appendGovernorServiceDiagnostic(coordRoot, {
                 event: "goal.error",
                 goal_id: goalId,
                 error: message,
@@ -319,7 +326,7 @@ export async function runGovernorServiceDaemon(input) {
     process.on("SIGTERM", requestStop);
     status.state = "running";
     writeStatus();
-    appendServiceEvent(coordRoot, {
+    appendGovernorServiceDiagnostic(coordRoot, {
         event: "service.started",
         pid: process.pid,
         goals: config.goal_ids,
@@ -364,7 +371,7 @@ export async function runGovernorServiceDaemon(input) {
                 status.last_error = boundedError(error.message);
                 status.next_wake_at = new Date(Date.now() + config.error_backoff_max_ms).toISOString();
                 writeStatus();
-                appendServiceEvent(coordRoot, {
+                appendGovernorServiceDiagnostic(coordRoot, {
                     event: "service.sweep_error",
                     error: status.last_error,
                 });
@@ -385,18 +392,26 @@ export async function runGovernorServiceDaemon(input) {
         status.active_goal_id = undefined;
         status.stopped_at = new Date().toISOString();
         writeStatus();
-        appendServiceEvent(coordRoot, {
+        appendGovernorServiceDiagnostic(coordRoot, {
             event: "service.stopped",
             pid: process.pid,
             sweeps: status.sweep_count,
         });
         rmSync(serviceStopPath(coordRoot), { force: true });
-        release();
+        try {
+            await closeProcessLoggers();
+        }
+        finally {
+            release();
+        }
     }
     return status;
 }
 export function governorServiceLogPath(coordRoot) {
-    return serviceLogPath(resolve(coordRoot));
+    const root = resolve(coordRoot);
+    return coordEnv("SHARED_LOGS") === "0"
+        ? serviceLogPath(root)
+        : join(root, ".harnery", "logs", "governor-service", "active.jsonl");
 }
 function runtimeForConfig(coordRoot, config, timestamp) {
     let existing;
@@ -598,11 +613,31 @@ function pidAlive(pid) {
         return error.code === "EPERM";
     }
 }
-function appendServiceEvent(coordRoot, data) {
+export function appendGovernorServiceDiagnostic(coordRoot, data) {
+    if (coordEnv("SHARED_LOGS") !== "0") {
+        try {
+            const event = typeof data.event === "string" ? data.event : "service.event";
+            const fields = { ...data };
+            delete fields.event;
+            const logger = processLogger(coordRoot, "governor-service");
+            if (event.includes("error"))
+                logger.error(event, legacyLogFields(fields));
+            else
+                logger.info(event, legacyLogFields(fields));
+            return "shared";
+        }
+        catch {
+            // Bootstrap failures retain the legacy service event stream as the fallback.
+        }
+    }
+    appendGovernorServiceLegacyEvent(coordRoot, data);
+    return "legacy";
+}
+function appendGovernorServiceLegacyEvent(coordRoot, data) {
     const path = serviceEventsPath(coordRoot);
-    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
-    appendFileSync(path, `${JSON.stringify({ schema_version: 1, ts: new Date().toISOString(), ...data })}\n`, { encoding: "utf8", mode: 0o600 });
-    chmodSync(path, 0o600);
+    const sink = new RotatingTextSink({ path, max_bytes: MAX_FILE_BYTES });
+    sink.append(`${JSON.stringify({ schema_version: 1, ts: new Date().toISOString(), ...data })}\n`);
+    sink.close();
 }
 function renderSweepLog(report) {
     const counts = report.outcomes.reduce((acc, outcome) => {

package/dist/core/guard/evidence-v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evidence-v3.d.ts","sourceRoot":"","sources":["../../../src/core/guard/evidence-v3.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAetF;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,WAAW,GAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAa,GACpD,uBAAuB,EAAE,CAkD3B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,uBAAuB,EAAE,CAsD3B;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACpC,IAAI,IAAI,0BAA0B,CAMpC"}
+{"version":3,"file":"evidence-v3.d.ts","sourceRoot":"","sources":["../../../src/core/guard/evidence-v3.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAetF;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,WAAW,GAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAa,GACpD,uBAAuB,EAAE,CAmD3B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,uBAAuB,EAAE,CAsD3B;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACpC,IAAI,IAAI,0BAA0B,CAMpC"}

package/dist/core/guard/evidence-v3.js

@@ -36,6 +36,8 @@ export function normalizeRunQualityEventV3(event, priorEvents = new Map()) {
             const measurement = event.payload.measurement;
             if (measurement.state !== "observed")
                 return [];
+            if (!("used_tokens" in measurement.value))
+                return [];
             return [
                 {
                     ...base,

package/dist/core/hooks/adapter/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/adapter/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,wDAAwD;IACxD,UAAU,EAAE,cAAc,CAAC;IAC3B,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAczC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,EAapC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,YAAY,EAAE,SAAS,EAYnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAE,SAAS,EAG1C,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,UAYpC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAqBxD,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/adapter/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,wDAAwD;IACxD,UAAU,EAAE,cAAc,CAAC;IAC3B,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAczC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,EAcpC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,YAAY,EAAE,SAAS,EAYnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAE,SAAS,EAG1C,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,UAYpC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAqBxD,CAAC"}

package/dist/core/hooks/adapter/events.js

@@ -42,6 +42,7 @@ export const CURSOR_EVENTS = [
     { settingsKey: "subagentStart", subcommand: "sub-agent-start" },
     { settingsKey: "subagentStop", subcommand: "sub-agent-stop" },
     { settingsKey: "beforeSubmitPrompt", subcommand: "user-prompt-submit" },
+    { settingsKey: "afterAgentResponse", subcommand: "after-agent-response" },
     { settingsKey: "preCompact", subcommand: "pre-compact" },
     { settingsKey: "stop", subcommand: "stop" },
 ];

package/dist/core/hooks/adapter/output.d.ts

@@ -8,8 +8,10 @@
  * - **Claude Code**: `{hookSpecificOutput: {hookEventName, additionalContext}}`
  *   for SessionStart / UserPromptSubmit / SubagentStart; deny uses
  *   `{hookSpecificOutput: {hookEventName: "PreToolUse", permissionDecision: "deny", permissionDecisionReason}}`.
- * - **Cursor**: `{additional_context, env?}` flat for sessionStart /
- *   beforeSubmitPrompt; deny uses `{permission: "deny", agent_message, user_message}`.
+ * - **Cursor**: `{additional_context, env?}` flat for sessionStart and other
+ *   context-capable events. Its current beforeSubmitPrompt schema can validate
+ *   or block but cannot inject context, so UserPromptSubmit output is skipped.
+ *   Deny uses `{permission: "deny", agent_message, user_message}`.
  * - **Codex**: structurally identical to Claude Code for context and tool
  *   denials. Stop blocks are deliberately suppressed because their automatic
  *   continuation can replace a completed user-facing answer.
@@ -19,6 +21,14 @@
  */
 import type { Adapter } from "../../adapter.js";
 export type SystemEvent = "SessionStart" | "UserPromptSubmit" | "SubagentStart" | "PreToolUse" | "PostToolUse";
+/**
+ * Whether this adapter can actually receive injected context for an event.
+ * Cursor's beforeSubmitPrompt hook can allow or block a turn but cannot inject
+ * model context, so anything rendered for that event is discarded. A caller
+ * that consumes state to build the text (draining a mailbox, for instance)
+ * must check this first, or the state is spent on output nobody reads.
+ */
+export declare function canReceiveContext(adapter: Adapter, event: SystemEvent): boolean;
 /** Emit a context-injection (peer table, wiring check, council pending, …). */
 export declare function emitContext(adapter: Adapter, event: SystemEvent, text: string): void;
 /** Emit a PreToolUse deny: blocks the tool call with `reason` shown to the model. */

package/dist/core/hooks/adapter/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/adapter/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,aAAa,CAAC;AAElB,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIpF;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1C,SAAS,CAAC,EAAE,MAAM,GACjB,CAAC,GAAG,CAAC,CAwBP"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/adapter/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,aAAa,CAAC;AAElB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAE/E;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKpF;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1C,SAAS,CAAC,EAAE,MAAM,GACjB,CAAC,GAAG,CAAC,CA4BP"}

package/dist/core/hooks/adapter/output.js

@@ -8,8 +8,10 @@
  * - **Claude Code**: `{hookSpecificOutput: {hookEventName, additionalContext}}`
  *   for SessionStart / UserPromptSubmit / SubagentStart; deny uses
  *   `{hookSpecificOutput: {hookEventName: "PreToolUse", permissionDecision: "deny", permissionDecisionReason}}`.
- * - **Cursor**: `{additional_context, env?}` flat for sessionStart /
- *   beforeSubmitPrompt; deny uses `{permission: "deny", agent_message, user_message}`.
+ * - **Cursor**: `{additional_context, env?}` flat for sessionStart and other
+ *   context-capable events. Its current beforeSubmitPrompt schema can validate
+ *   or block but cannot inject context, so UserPromptSubmit output is skipped.
+ *   Deny uses `{permission: "deny", agent_message, user_message}`.
  * - **Codex**: structurally identical to Claude Code for context and tool
  *   denials. Stop blocks are deliberately suppressed because their automatic
  *   continuation can replace a completed user-facing answer.
@@ -19,10 +21,22 @@
  */
 import { STOP_REMEDIATION_MARKER } from "../../agents/rules/stop-hook.js";
 import { endOfTurnStatusCommand, resolveBinName } from "../../config.js";
+/**
+ * Whether this adapter can actually receive injected context for an event.
+ * Cursor's beforeSubmitPrompt hook can allow or block a turn but cannot inject
+ * model context, so anything rendered for that event is discarded. A caller
+ * that consumes state to build the text (draining a mailbox, for instance)
+ * must check this first, or the state is spent on output nobody reads.
+ */
+export function canReceiveContext(adapter, event) {
+    return !(adapter === "cursor" && event === "UserPromptSubmit");
+}
 /** Emit a context-injection (peer table, wiring check, council pending, …). */
 export function emitContext(adapter, event, text) {
     if (!text || text.length === 0)
         return;
+    if (!canReceiveContext(adapter, event))
+        return;
     const json = buildContextJson(adapter, event, text);
     process.stdout.write(`${JSON.stringify(json)}\n`);
 }
@@ -75,9 +89,13 @@ export function emitStopBlock(adapter, verdict, coordRoot) {
         process.stdout.write(`${JSON.stringify({ followup_message: message })}\n`);
         return 0;
     }
-    // Claude Code continues the SAME turn on exit 2, so the single failing rule is
-    // both accurate and sufficient there. Left unchanged deliberately.
-    process.stderr.write(`${reason}\n[agent-hook stop]: rule=${verdict.rule}\n`);
+    // Claude Code re-prompts inside one native Stop remediation cycle, but tools
+    // run after the first terminal are recorded in recovered telemetry turns.
+    // Name the whole ritual so one continuation can repair every required signal.
+    const bin = resolveBinName(coordRoot);
+    const statusCommand = endOfTurnStatusCommand(coordRoot);
+    const remediation = `Repair the whole ritual in this continuation: if the original turn used a tool and task evidence is missing, run \`${bin} agents set-task "<short focus>"\`; then run \`${statusCommand}\` as your last tool call and paste its status box verbatim in your reply.`;
+    process.stderr.write(`${reason}\n${remediation}\n[agent-hook stop]: rule=${verdict.rule}\n`);
     return 2;
 }
 function buildContextJson(adapter, event, text) {

package/dist/core/hooks/adapter/runtime-telemetry.d.ts

@@ -4,9 +4,22 @@ export type RuntimeContextTelemetry = {
     used_tokens: number;
     limit_tokens: number;
     measured_at: string;
-    method: "codex_transcript_token_count";
+    method: "codex_transcript_token_count" | "claude_transcript_usage_model_capability";
     source_event: string;
     source_witness: string;
+    attestation: "derived" | "inferred";
+    confidence: "exact" | "high" | "medium";
+    bytes_read: number;
+    io_duration_ms: number;
+} | {
+    state: "observed";
+    used_percent: number;
+    measured_at: string;
+    method: "cursor_composer_context_percent";
+    source_event: string;
+    source_witness: string;
+    attestation: "derived";
+    confidence: "high";
     runtime_version?: string;
     bytes_read: number;
     io_duration_ms: number;
@@ -23,20 +36,30 @@ export type RuntimeContextTelemetry = {
     bytes_read: 0;
     io_duration_ms: number;
 };
-export type RuntimeContextMissingReason = "codex_transcript_ambiguous" | "codex_transcript_session_mismatch" | "codex_transcript_unreadable" | "codex_transcript_turn_not_found" | "codex_transcript_turn_not_terminal" | "codex_transcript_token_count_missing" | "codex_transcript_sample_stale" | "context_used_tokens_not_reported" | "context_limit_tokens_not_reported" | "context_limit_tokens_invalid" | "claude_context_limit_tokens_not_reported" | "claude_transcript_session_mismatch" | "claude_transcript_turn_not_found" | "claude_transcript_unreadable";
+export type RuntimeContextMissingReason = "codex_transcript_ambiguous" | "codex_transcript_session_mismatch" | "codex_transcript_unreadable" | "codex_transcript_turn_not_found" | "codex_transcript_turn_not_terminal" | "codex_transcript_token_count_missing" | "codex_transcript_sample_stale" | "context_used_tokens_not_reported" | "context_limit_tokens_not_reported" | "context_limit_tokens_invalid" | "claude_context_limit_tokens_not_reported" | "claude_transcript_sample_stale" | "claude_transcript_session_mismatch" | "claude_transcript_turn_not_found" | "claude_transcript_unreadable" | "cursor_context_database_unavailable" | "cursor_context_database_unreadable" | "cursor_context_session_not_found" | "cursor_context_sample_ambiguous" | "cursor_context_sample_stale" | "cursor_context_sample_time_not_reported" | "cursor_context_usage_invalid";
 export type RuntimeContextUnsupportedReason = "runtime_context_telemetry_unavailable" | "runtime_session_id_not_reported" | "runtime_turn_id_not_reported" | "runtime_adapter_not_supported";
 export interface RuntimeContextRequest {
     adapter: Adapter;
     session_id?: string;
     turn_id?: string;
+    /** Canonical producer turn boundary used when task_started has left the bounded tail. */
+    turn_started_at?: string;
     transcript_path?: string;
-    /** Status callers may request the newest session sample without claiming turn attribution. */
-    mode: "turn" | "status";
+    observed_at?: string;
+    /**
+     * Status reads the newest session sample without turn attribution. Active
+     * turn reads require a matching task_started boundary but not task_complete.
+     */
+    mode: "turn" | "active_turn" | "status";
 }
 export interface RuntimeTelemetryOptions {
     codexRoots?: string[];
+    cursorRoots?: string[];
+    maxCursorDatabases?: number;
     maxTailBytes?: number;
     maxSampleAgeMs?: number;
+    /** Recorder-only cadence override used by deterministic tests. */
+    activeContextProbeIntervalMs?: number;
 }
 /**
  * Read privacy-safe context telemetry from a local runtime transcript.