harnery 0.34.1 → 0.36.0

package/dist/lib/web-performance.d.ts

@@ -0,0 +1,118 @@
+export declare const WEB_PERFORMANCE_LOG = "web-performance.jsonl";
+interface BaseEvent {
+    event: string;
+    ts: string;
+    pid?: number;
+    mode?: string;
+}
+export interface WebRequestPerformanceEvent extends BaseEvent {
+    event: "request_complete";
+    request_id: string;
+    method: string;
+    route: string;
+    status: number | null;
+    outcome: "finished" | "aborted";
+    stream: boolean;
+    slow: boolean;
+    duration_ms: number;
+    process_cpu_ms_during_request: number;
+    concurrent_requests_at_start: number;
+    max_concurrent_requests: number;
+    event_loop_delay_count: number;
+    event_loop_delay_total_ms: number;
+    max_event_loop_delay_ms: number;
+}
+export interface WebEventLoopDelayEvent extends BaseEvent {
+    event: "event_loop_delay";
+    delay_ms: number;
+    active_request_count: number;
+    active_requests: Array<{
+        request_id: string;
+        method: string;
+        route: string;
+        age_ms: number;
+    }>;
+    active_requests_truncated: number;
+}
+export interface WebMemoryPerformanceEvent extends BaseEvent {
+    event: "memory_sample";
+    reason: "started" | "interval";
+    rss_bytes: number;
+    heap_used_bytes: number;
+    heap_total_bytes: number;
+    heap_limit_bytes: number;
+    heap_used_percent: number;
+    external_bytes: number;
+    array_buffers_bytes: number;
+    native_contexts: number;
+    detached_contexts: number;
+    active_request_count: number;
+    gc_count: number;
+    gc_duration_ms: number;
+    max_gc_pause_ms: number;
+    gc_by_kind: Record<string, {
+        count: number;
+        duration_ms: number;
+    }>;
+}
+export interface WebGcPauseEvent extends BaseEvent {
+    event: "gc_pause";
+    kind: string;
+    duration_ms: number;
+    rss_bytes: number;
+    heap_used_bytes: number;
+    heap_total_bytes: number;
+    heap_limit_bytes: number;
+    heap_used_percent: number;
+    active_request_count: number;
+}
+export interface WebRoutePerformanceSummary {
+    method: string;
+    route: string;
+    requests: number;
+    slow_requests: number;
+    aborted_requests: number;
+    p50_ms: number;
+    p95_ms: number;
+    max_ms: number;
+    max_event_loop_delay_ms: number;
+    max_concurrent_requests: number;
+}
+export interface WebPerformanceReport {
+    state: "ok" | "unavailable";
+    log_path: string;
+    since: string;
+    files_read: number;
+    invalid_lines: number;
+    requests_observed: number;
+    streams_observed: number;
+    slow_requests: number;
+    event_loop_delays: number;
+    memory: {
+        samples: number;
+        latest: WebMemoryPerformanceEvent;
+        peak_rss_bytes: number;
+        peak_heap_used_bytes: number;
+        max_heap_used_percent: number;
+    } | null;
+    garbage_collection: {
+        observed_collections: number;
+        observed_duration_ms: number;
+        recorded_pauses: number;
+        max_pause_ms: number;
+    };
+    routes: WebRoutePerformanceSummary[];
+    slowest_requests: WebRequestPerformanceEvent[];
+    largest_event_loop_delays: WebEventLoopDelayEvent[];
+    largest_gc_pauses: WebGcPauseEvent[];
+    hint?: string;
+}
+export declare function parsePerformanceWindow(input: string): number | null;
+export declare function readWebPerformanceReport(options: {
+    root: string;
+    since: string;
+    limit: number;
+    nowMs?: number;
+}): WebPerformanceReport;
+export {};
+//# sourceMappingURL=web-performance.d.ts.map

package/dist/lib/web-performance.d.ts.map

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

package/dist/lib/web-performance.js

@@ -0,0 +1,192 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+export const WEB_PERFORMANCE_LOG = "web-performance.jsonl";
+export function parsePerformanceWindow(input) {
+    const match = /^(\d+(?:\.\d+)?)(m|h|d)$/.exec(input.trim().toLowerCase());
+    if (!match)
+        return null;
+    const amount = Number(match[1]);
+    if (!Number.isFinite(amount) || amount <= 0)
+        return null;
+    const unitMs = match[2] === "m" ? 60_000 : match[2] === "h" ? 3_600_000 : 86_400_000;
+    return Math.floor(amount * unitMs);
+}
+function performanceLogPaths(root) {
+    const logsDir = path.join(root, ".harnery", "logs");
+    if (!existsSync(logsDir))
+        return [];
+    return [
+        ...rotatedLogPaths(path.join(logsDir, "web-performance"), "active.jsonl"),
+        ...rotatedLogPaths(logsDir, WEB_PERFORMANCE_LOG),
+    ];
+}
+function rotatedLogPaths(directory, activeName) {
+    if (!existsSync(directory))
+        return [];
+    const escaped = activeName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return readdirSync(directory)
+        .filter((name) => name === activeName || new RegExp(`^${escaped}\\.\\d+$`).test(name))
+        .sort((left, right) => {
+        if (left === activeName)
+            return 1;
+        if (right === activeName)
+            return -1;
+        return Number(right.split(".").at(-1)) - Number(left.split(".").at(-1));
+    })
+        .map((name) => path.join(directory, name));
+}
+function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function isRequestEvent(event) {
+    return (event.event === "request_complete" &&
+        typeof event.method === "string" &&
+        typeof event.route === "string" &&
+        numberField(event.duration_ms));
+}
+function isDelayEvent(event) {
+    return (event.event === "event_loop_delay" && numberField(event.delay_ms));
+}
+function isMemoryEvent(event) {
+    return (event.event === "memory_sample" &&
+        numberField(event.rss_bytes) &&
+        numberField(event.heap_used_bytes) &&
+        numberField(event.heap_limit_bytes));
+}
+function isGcPauseEvent(event) {
+    return event.event === "gc_pause" && numberField(event.duration_ms);
+}
+function percentile(sorted, fraction) {
+    if (sorted.length === 0)
+        return 0;
+    return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * fraction) - 1)] ?? 0;
+}
+export function readWebPerformanceReport(options) {
+    const root = path.resolve(options.root);
+    const logPath = path.join(root, ".harnery", "logs", "web-performance", "active.jsonl");
+    const windowMs = parsePerformanceWindow(options.since);
+    if (windowMs === null)
+        throw new Error(`invalid performance window: ${options.since}`);
+    const cutoffMs = (options.nowMs ?? Date.now()) - windowMs;
+    const paths = performanceLogPaths(root);
+    if (paths.length === 0) {
+        return {
+            state: "unavailable",
+            log_path: logPath,
+            since: options.since,
+            files_read: 0,
+            invalid_lines: 0,
+            requests_observed: 0,
+            streams_observed: 0,
+            slow_requests: 0,
+            event_loop_delays: 0,
+            memory: null,
+            garbage_collection: {
+                observed_collections: 0,
+                observed_duration_ms: 0,
+                recorded_pauses: 0,
+                max_pause_ms: 0,
+            },
+            routes: [],
+            slowest_requests: [],
+            largest_event_loop_delays: [],
+            largest_gc_pauses: [],
+            hint: "Start or restart `harn web`; performance diagnostics begin when the server receives its first request.",
+        };
+    }
+    const events = [];
+    const seenEvents = new Set();
+    let invalidLines = 0;
+    for (const file of paths) {
+        for (const line of readFileSync(file, "utf8").split("\n")) {
+            if (!line.trim())
+                continue;
+            try {
+                const event = JSON.parse(line);
+                const timestamp = Date.parse(event.ts);
+                if (!Number.isFinite(timestamp)) {
+                    invalidLines++;
+                    continue;
+                }
+                const identity = JSON.stringify(event);
+                if (timestamp >= cutoffMs && !seenEvents.has(identity)) {
+                    seenEvents.add(identity);
+                    events.push(event);
+                }
+            }
+            catch {
+                invalidLines++;
+            }
+        }
+    }
+    events.sort((left, right) => Date.parse(left.ts) - Date.parse(right.ts) ||
+        JSON.stringify(left).localeCompare(JSON.stringify(right)));
+    const allRequests = events.filter(isRequestEvent);
+    const requests = allRequests.filter((event) => !event.stream);
+    const delays = events.filter(isDelayEvent);
+    const memorySamples = events.filter(isMemoryEvent);
+    const gcPauses = events.filter(isGcPauseEvent);
+    const groups = new Map();
+    for (const request of requests) {
+        const key = `${request.method}\0${request.route}`;
+        const group = groups.get(key) ?? [];
+        group.push(request);
+        groups.set(key, group);
+    }
+    const routes = [...groups.values()]
+        .map((group) => {
+        const durations = group.map((event) => event.duration_ms).sort((a, b) => a - b);
+        return {
+            method: group[0]?.method ?? "GET",
+            route: group[0]?.route ?? "/",
+            requests: group.length,
+            slow_requests: group.filter((event) => event.slow).length,
+            aborted_requests: group.filter((event) => event.outcome === "aborted").length,
+            p50_ms: percentile(durations, 0.5),
+            p95_ms: percentile(durations, 0.95),
+            max_ms: durations.at(-1) ?? 0,
+            max_event_loop_delay_ms: Math.max(...group.map((event) => event.max_event_loop_delay_ms)),
+            max_concurrent_requests: Math.max(...group.map((event) => event.max_concurrent_requests)),
+        };
+    })
+        .sort((left, right) => right.max_ms - left.max_ms || right.p95_ms - left.p95_ms);
+    return {
+        state: "ok",
+        log_path: logPath,
+        since: options.since,
+        files_read: paths.length,
+        invalid_lines: invalidLines,
+        requests_observed: requests.length,
+        streams_observed: allRequests.length - requests.length,
+        slow_requests: requests.filter((event) => event.slow).length,
+        event_loop_delays: delays.length,
+        memory: memorySamples.length > 0
+            ? {
+                samples: memorySamples.length,
+                latest: memorySamples.at(-1),
+                peak_rss_bytes: Math.max(...memorySamples.map((event) => event.rss_bytes)),
+                peak_heap_used_bytes: Math.max(...memorySamples.map((event) => event.heap_used_bytes)),
+                max_heap_used_percent: Math.max(...memorySamples.map((event) => event.heap_used_percent)),
+            }
+            : null,
+        garbage_collection: {
+            observed_collections: memorySamples.reduce((sum, event) => sum + event.gc_count, 0),
+            observed_duration_ms: Math.round(memorySamples.reduce((sum, event) => sum + event.gc_duration_ms, 0)),
+            recorded_pauses: gcPauses.length,
+            max_pause_ms: Math.max(0, ...gcPauses.map((event) => event.duration_ms)),
+        },
+        routes,
+        slowest_requests: requests
+            .slice()
+            .sort((left, right) => right.duration_ms - left.duration_ms)
+            .slice(0, options.limit),
+        largest_event_loop_delays: delays
+            .slice()
+            .sort((left, right) => right.delay_ms - left.delay_ms)
+            .slice(0, options.limit),
+        largest_gc_pauses: gcPauses
+            .slice()
+            .sort((left, right) => right.duration_ms - left.duration_ms)
+            .slice(0, options.limit),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnery",
-  "version": "0.34.1",
+  "version": "0.36.0",
   "description": "Multi-agent coordination for AI coding agents - Claude Code, Cursor, and Codex.",
   "license": "MIT",
   "author": "Ryan Kelly",
@@ -102,6 +102,36 @@
       "types": "./dist/core/events/v3/index.d.ts",
       "import": "./dist/core/events/v3/index.js"
     },
+    "./core/events/v3/support-storage": {
+      "bun": "./src/core/events/v3/support-storage/index.ts",
+      "types": "./dist/core/events/v3/support-storage/index.d.ts",
+      "import": "./dist/core/events/v3/support-storage/index.js"
+    },
+    "./core/events/legacy-storage": {
+      "bun": "./src/core/events/legacy-storage/index.ts",
+      "types": "./dist/core/events/legacy-storage/index.d.ts",
+      "import": "./dist/core/events/legacy-storage/index.js"
+    },
+    "./core/storage": {
+      "bun": "./src/core/storage/index.ts",
+      "types": "./dist/core/storage/index.d.ts",
+      "import": "./dist/core/storage/index.js"
+    },
+    "./core/inbox": {
+      "bun": "./src/core/inbox/index.ts",
+      "types": "./dist/core/inbox/index.d.ts",
+      "import": "./dist/core/inbox/index.js"
+    },
+    "./core/conversations": {
+      "bun": "./src/core/conversations/index.ts",
+      "types": "./dist/core/conversations/index.d.ts",
+      "import": "./dist/core/conversations/index.js"
+    },
+    "./core/semantic": {
+      "bun": "./src/core/semantic/index.ts",
+      "types": "./dist/core/semantic/index.d.ts",
+      "import": "./dist/core/semantic/index.js"
+    },
     "./core/governor/plans": {
       "bun": "./src/core/governor/plan-read.ts",
       "types": "./dist/core/governor/plan-read.d.ts",
@@ -168,7 +198,7 @@
     "agent-coord": "./bin/agent-coord",
     "agent-hook": "./bin/agent-hook"
   },
-  "//files": "src ships as TS so the `bun` export condition resolves to source; negate co-located tests and their shared fixture helper so they don't ride into the tarball (a .npmignore is inert for paths already inside the files allowlist).",
+  "//files": "src ships as TS so the `bun` export condition resolves to source; negate co-located tests, fixture directories, and shared test helpers so they don't ride into the tarball (a .npmignore is inert for paths already inside the files allowlist).",
   "files": [
     "bin",
     "src",
@@ -178,6 +208,8 @@
     "LICENSE",
     "!src/**/*.test.ts",
     "!src/**/*.test.tsx",
+    "!src/**/__fixtures__/**",
+    "!dist/**/__fixtures__/**",
     "!dist/**/test-helpers.*",
     "!src/**/test-helpers.ts"
   ],

package/schemas/config.schema.json

@@ -185,6 +185,37 @@
         }
       }
     },
+    "logs": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Structured-log settings. Retention overrides change only approved byte and age scalars; roots, providers, privacy, durability, writers, and record limits stay source-owned.",
+      "properties": {
+        "storage": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Storage budgets for shared operational and debug log segments. Project values override user-global values at the same path; exact-family values are more specific than class values.",
+          "properties": {
+            "classes": {
+              "type": "object",
+              "additionalProperties": false,
+              "description": "Defaults applied to every shared log family in the named storage class.",
+              "properties": {
+                "operational-log": { "$ref": "#/$defs/logStorageOverride" },
+                "debug-log": { "$ref": "#/$defs/logStorageOverride" }
+              }
+            },
+            "families": {
+              "type": "object",
+              "description": "Overrides for exact registered shared-log family IDs.",
+              "propertyNames": {
+                "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
+              },
+              "additionalProperties": { "$ref": "#/$defs/logStorageOverride" }
+            }
+          }
+        }
+      }
+    },
     "artifacts": {
       "type": "object",
       "additionalProperties": false,
@@ -285,6 +316,13 @@
         "hostAddendumFile": {
           "type": "string",
           "description": "Repo-relative path to a markdown file holding this project's own coordination policy. `harn init` splices its contents into a second managed region in AGENTS.md, `init --check` reports drift against it, and `deinit` (or removing this key) takes the region back out. Harnery never parses the content. Must resolve inside the project and be non-empty."
+        },
+        "promptReminder": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$",
+          "description": "One project-owned line emitted on every supported prompt for adapters that lack native reminder behavior. Project config only; user-global values are ignored. The text is not copied into coordination state."
         }
       }
     },
@@ -353,5 +391,25 @@
         }
       }
     }
+  },
+  "$defs": {
+    "logStorageOverride": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "max_bytes": {
+          "type": "integer",
+          "minimum": 10485760,
+          "maximum": 1099511627776,
+          "description": "Logical storage budget in bytes. This is an asynchronous retention budget, not a producer write quota."
+        },
+        "max_age_days": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 3650,
+          "description": "Age in whole days after which an immutable sealed segment is eligible for retention."
+        }
+      }
+    }
   }
 }