harnery 0.35.0 → 0.37.0

package/src/commands/web.ts

@@ -2,11 +2,22 @@ import { spawn, spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createServer } from "node:net";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import type { Command } from "commander";
 import type { EmitContext } from "../commander.ts";
 import { DEFAULT_WEB_PORT, resolveWebPort } from "../core/config.ts";
 import { ensureSemanticServiceRunning } from "../core/semantic/service.ts";
+import { processLogDestination } from "../core/storage/process-log.ts";
+import { ensureSupervisorRunning } from "../core/supervisor/service.ts";
+import {
+  registerSupervisorConsumer,
+  unregisterSupervisorConsumer,
+} from "../core/supervisor/services.ts";
+import {
+  parsePerformanceWindow,
+  readWebPerformanceReport,
+  WEB_PERFORMANCE_LOG,
+} from "../lib/web-performance.ts";
 import { lazyFetchWebRoot, webRunner } from "./web-fetch.ts";
 
 /**
@@ -16,6 +27,7 @@ import { lazyFetchWebRoot, webRunner } from "./web-fetch.ts";
  *   up [--prod]:   start the server (dev mode default; --prod runs next start)
  *   build:         next build (production bundle)
  *   start:         next start (must `harn web build` first)
+ *   performance:   summarize request latency and event-loop delays
  *
  * Launches the Next.js app under `harnery/web/` against the user's current
  * working directory. The web app reads `.harnery/` via `HARNERY_COORD_ROOT`;
@@ -70,6 +82,27 @@ export function nodeOptionsWithHeapCap(mb: number): string | undefined {
   return `${inherited} --max-old-space-size=${mb}`.trim();
 }
 
+/** Preload the request diagnostics hook without replacing Next's HTTP server. */
+export function nodeOptionsWithWebDiagnostics(webDir: string, mb: number): string {
+  const inherited = nodeOptionsWithHeapCap(mb) ?? "";
+  if (inherited.includes("server-performance.mjs")) return inherited;
+  const preload = pathToFileURL(path.join(webDir, "server-performance.mjs")).href;
+  return `${inherited} --import=${preload}`.trim();
+}
+
+export function webPerformanceLogDestination(
+  coordRoot: string,
+  env: Readonly<Record<string, string | undefined>> = process.env,
+): string {
+  return processLogDestination({
+    coord_root: coordRoot,
+    family_id: "web-performance-log",
+    filename: "active.jsonl",
+    legacy_path: path.join(coordRoot, ".harnery", "logs", WEB_PERFORMANCE_LOG),
+    env,
+  });
+}
+
 async function startSemanticServiceWithWeb(coordRoot: string, emit: EmitContext): Promise<void> {
   const result = await ensureSemanticServiceRunning(coordRoot);
   if (result.state === "started") emit.log("semantic reader · started automatically", "info");
@@ -81,6 +114,16 @@ async function startSemanticServiceWithWeb(coordRoot: string, emit: EmitContext)
   }
 }
 
+async function startSupervisorWithWeb(coordRoot: string, emit: EmitContext): Promise<void> {
+  registerSupervisorConsumer(coordRoot, { id: "dashboard" });
+  const result = await ensureSupervisorRunning(coordRoot);
+  if (result.state === "started") emit.log("local supervisor · started automatically", "info");
+  if (result.state === "running") emit.log("local supervisor · already running", "info");
+  if (result.state === "unavailable") {
+    emit.log(`local supervisor · unavailable (${result.error})`, "warn");
+  }
+}
+
 /**
  * Resolve the web app root. A local `web/` (source checkout / submodule) wins.
  * Otherwise, on an npm install, lazy-fetch it (clone + install) unless the
@@ -205,12 +248,16 @@ export function registerWebCommand(program: Command, emit: EmitContext): void {
 
       if (!(await requireAvailablePort(emit, port))) return;
 
+      await startSupervisorWithWeb(coordRoot, emit);
       await startSemanticServiceWithWeb(coordRoot, emit);
 
       const heapMb = resolveMaxOldSpaceMb(opts.maxOldSpace);
+      const nodeOptions = nodeOptionsWithWebDiagnostics(root, heapMb);
+      const performanceLogPath = webPerformanceLogDestination(coordRoot);
       emit.log(`harn web · http://localhost:${port} (${mode})`, "info");
       emit.log(`files origin · http://harnery-files.localhost:${port}`, "info");
       emit.log(`reading .harnery/ from: ${coordRoot}`, "info");
+      emit.log(`performance log · ${performanceLogPath}`, "info");
       if (heapMb > 0) emit.log(`heap ceiling · ${heapMb} MB`, "info");
 
       const child = spawn(webRunner(), ["run", mode], {
@@ -219,9 +266,9 @@ export function registerWebCommand(program: Command, emit: EmitContext): void {
           ...process.env,
           HARNERY_COORD_ROOT: coordRoot,
           HARNERY_WEB_PORT: String(port),
-          ...(nodeOptionsWithHeapCap(heapMb)
-            ? { NODE_OPTIONS: nodeOptionsWithHeapCap(heapMb) as string }
-            : {}),
+          HARNERY_WEB_MODE: mode,
+          HARNERY_WEB_PERFORMANCE_LOG_PATH: performanceLogPath,
+          NODE_OPTIONS: nodeOptions,
         },
         stdio: "inherit",
       });
@@ -233,6 +280,7 @@ export function registerWebCommand(program: Command, emit: EmitContext): void {
       process.on("SIGTERM", () => cleanup("SIGTERM"));
 
       child.on("exit", (code, sig) => {
+        unregisterSupervisorConsumer(coordRoot, "dashboard");
         if (sig) {
           emit.log(`web exited on ${sig}`, "info");
         } else if (code !== 0) {
@@ -295,10 +343,14 @@ export function registerWebCommand(program: Command, emit: EmitContext): void {
         return;
       }
       if (!(await requireAvailablePort(emit, port))) return;
+      await startSupervisorWithWeb(coordRoot, emit);
       await startSemanticServiceWithWeb(coordRoot, emit);
       const heapMb = resolveMaxOldSpaceMb(opts.maxOldSpace);
+      const nodeOptions = nodeOptionsWithWebDiagnostics(root, heapMb);
+      const performanceLogPath = webPerformanceLogDestination(coordRoot);
       emit.log(`harn web · http://localhost:${port} (start)`, "info");
       emit.log(`reading .harnery/ from: ${coordRoot}`, "info");
+      emit.log(`performance log · ${performanceLogPath}`, "info");
       if (heapMb > 0) emit.log(`heap ceiling · ${heapMb} MB`, "info");
 
       const child = spawn(webRunner(), ["run", "start"], {
@@ -307,9 +359,9 @@ export function registerWebCommand(program: Command, emit: EmitContext): void {
           ...process.env,
           HARNERY_COORD_ROOT: coordRoot,
           HARNERY_WEB_PORT: String(port),
-          ...(nodeOptionsWithHeapCap(heapMb)
-            ? { NODE_OPTIONS: nodeOptionsWithHeapCap(heapMb) as string }
-            : {}),
+          HARNERY_WEB_MODE: "start",
+          HARNERY_WEB_PERFORMANCE_LOG_PATH: performanceLogPath,
+          NODE_OPTIONS: nodeOptions,
         },
         stdio: "inherit",
       });
@@ -321,7 +373,44 @@ export function registerWebCommand(program: Command, emit: EmitContext): void {
       process.on("SIGTERM", () => cleanup("SIGTERM"));
 
       child.on("exit", (code) => {
+        unregisterSupervisorConsumer(coordRoot, "dashboard");
         process.exitCode = code ?? 0;
       });
     });
+
+  web
+    .command("performance")
+    .description("Summarize dashboard request, event-loop, memory, and GC diagnostics")
+    .option("--coord-root <dir>", "Override the coordination root", process.cwd())
+    .option("--since <window>", "Include the last Nm, Nh, or Nd", "1h")
+    .option("--limit <n>", "Keep the N slowest requests and delays", "20")
+    .option("--json", "Emit structured JSON")
+    .action((opts: { coordRoot: string; since: string; limit: string; json?: boolean }) => {
+      const windowMs = parsePerformanceWindow(opts.since);
+      if (windowMs === null) {
+        emit.error({
+          code: "invalid_web_performance_window",
+          message: `invalid --since value '${opts.since}'`,
+          hint: "Use Nm, Nh, or Nd, for example 30m, 1h, or 7d.",
+        });
+        return;
+      }
+      const limit = Number(opts.limit);
+      if (!Number.isSafeInteger(limit) || limit < 1 || limit > 500) {
+        emit.error({
+          code: "invalid_web_performance_limit",
+          message: `invalid --limit value '${opts.limit}'`,
+          hint: "Use an integer from 1 through 500.",
+        });
+        return;
+      }
+      if (opts.json) emit.config({ format: "json" });
+      emit.data(
+        readWebPerformanceReport({
+          root: opts.coordRoot,
+          since: opts.since,
+          limit,
+        }),
+      );
+    });
 }

package/src/commands/work.ts

@@ -6,9 +6,9 @@ import {
   createBuiltinAdapterRegistry,
   probeBinaryVersion,
 } from "../core/adapters/index.ts";
+import { resolveCoordRoot } from "../core/agents/coord-client.ts";
 import { workflowSubscriptionOnly } from "../core/config.ts";
 import { findCompletedMissionGoverning, reopenGovernorMission } from "../core/governor/index.ts";
-import { findCoordRoot } from "../core/hooks/resolve/coord-root.ts";
 import type { PolicyIsolation } from "../core/policy/index.ts";
 import { loadPolicyFile } from "../core/policy/index.ts";
 import {
@@ -467,7 +467,7 @@ export function renderAttemptBudget(record: WorkRecord): string {
 }
 
 function withWorkRoot(emit: EmitContext, fn: (coordRoot: string) => void): void {
-  const coordRoot = findCoordRoot();
+  const coordRoot = resolveCoordRoot();
   if (!coordRoot) {
     emit.error({
       code: "no_coord_root",
@@ -488,7 +488,7 @@ async function withWorkRootAsync(
   emit: EmitContext,
   fn: (coordRoot: string) => Promise<void>,
 ): Promise<void> {
-  const coordRoot = findCoordRoot();
+  const coordRoot = resolveCoordRoot();
   if (!coordRoot) {
     emit.error({
       code: "no_coord_root",

package/src/commands/workflow.ts

@@ -7,8 +7,8 @@ import {
   createBuiltinAdapterRegistry,
   probeBinaryVersion,
 } from "../core/adapters/index.ts";
+import { resolveCoordRoot } from "../core/agents/coord-client.ts";
 import { resolveBinName, workflowSubscriptionOnly } from "../core/config.ts";
-import { findCoordRoot } from "../core/hooks/resolve/coord-root.ts";
 import type { PolicyIsolation } from "../core/policy/index.ts";
 import { loadPolicyFile } from "../core/policy/index.ts";
 import type { WorkflowApproval, WorkflowApprovalStatus } from "../core/workflow/approvals.ts";
@@ -28,6 +28,7 @@ import type { WorkspaceProvider } from "../core/workflow/index.ts";
 interface WorkflowRunOpts {
   maxAgents?: string;
   concurrency?: string;
+  observePressure?: boolean;
   cwd?: string;
   adapter?: string;
   resumeFrom?: string;
@@ -98,6 +99,10 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     )
     .option("--max-agents <n>", "Total-agent ceiling for the run (default 50)")
     .option("--concurrency <n>", "Concurrent-subagent cap (default 4)")
+    .option(
+      "--observe-pressure",
+      "Record observer-only local pressure before the first real child dispatch",
+    )
     .option("--cwd <dir>", "Working directory children spawn in (default: coord root)")
     .option(
       "--adapter <name>",
@@ -132,7 +137,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .option("--approval-to <address>", "Address durable ASK requests (default: operator)")
     .option("--json", "Emit the full RunReport as JSON")
     .action(async (script: string, opts: WorkflowRunOpts) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",
@@ -194,6 +199,9 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
           allowApiBilling: opts.allowApiBilling,
           maxAgents: opts.maxAgents ? Number.parseInt(opts.maxAgents, 10) : undefined,
           concurrency: opts.concurrency ? Number.parseInt(opts.concurrency, 10) : undefined,
+          diagnosticAdmission: opts.observePressure
+            ? { schema_version: 1, mode: "shadow" }
+            : undefined,
           cwd: opts.cwd,
           ...adapterProofInputs(
             registry.list().map((adapter) => adapter.profile),
@@ -263,7 +271,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .description("Resume a parked workflow after its durable approval has been resolved.")
     .option("--json", "Emit the full RunReport or parked result as JSON")
     .action(async (runId: string, opts: { json?: boolean }) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",
@@ -345,7 +353,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .description("Show validated allocation, verification, integration, and cleanup state.")
     .option("--json", "Emit the validated workspace status as JSON")
     .action(async (runId: string, opts: { json?: boolean }) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",
@@ -374,7 +382,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .description("List validated isolated and shared-compatibility workspace decisions.")
     .option("--json", "Emit workspace inspections as JSON")
     .action(async (opts: { json?: boolean }) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",
@@ -433,7 +441,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .option("--approval-to <address>", "Address a durable policy ASK request")
     .option("--json", "Emit the durable integration plan as JSON")
     .action(async (runId: string, opts: WorkflowIntegrationPrepareOpts) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",
@@ -521,7 +529,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .option("--yes", "Confirm the target-branch mutation")
     .option("--json", "Emit the durable integration receipt as JSON")
     .action(async (runId: string, opts: WorkflowConfirmedMutationOpts) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",
@@ -565,7 +573,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .option("--yes", "Confirm the worktree and provider-branch removal attempt")
     .option("--json", "Emit the cleanup attempt or receipt as JSON")
     .action(async (runId: string, opts: WorkflowConfirmedMutationOpts) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",
@@ -616,7 +624,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .option("--discard", "Throw the uncommitted work away instead of salvaging it")
     .option("--json", "Emit the reclaim preparation and cleanup result as JSON")
     .action(async (runId: string, opts: WorkflowReclaimOpts) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",
@@ -687,7 +695,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .option("--status <status>", "Filter: pending | approved | denied")
     .option("--json", "Emit approval records as JSON")
     .action(async (opts: WorkflowApprovalListOpts) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({ code: "no_coord_root", message: "no .harnery/ coordination root found" });
         process.exit(1);
@@ -725,7 +733,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .description("Show one durable workflow approval.")
     .option("--json", "Emit the approval record as JSON")
     .action(async (approvalId: string, opts: { json?: boolean }) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({ code: "no_coord_root", message: "no .harnery/ coordination root found" });
         process.exit(1);
@@ -755,7 +763,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
       .option("--reason <text>", "Bounded decision reason")
       .option("--json", "Emit the resolved approval as JSON")
       .action(async (approvalId: string, opts: WorkflowApprovalDecisionOpts) => {
-        const coordRoot = findCoordRoot();
+        const coordRoot = resolveCoordRoot();
         if (!coordRoot) {
           emit.error({ code: "no_coord_root", message: "no .harnery/ coordination root found" });
           process.exit(1);
@@ -798,7 +806,7 @@ export function registerWorkflowCommand(program: Command, emit: EmitContext): vo
     .description("Show the bounded proof packet for a completed workflow run.")
     .option("--json", "Emit the stored proof packet as JSON")
     .action(async (runId: string, opts: WorkflowProofOpts) => {
-      const coordRoot = findCoordRoot();
+      const coordRoot = resolveCoordRoot();
       if (!coordRoot) {
         emit.error({
           code: "no_coord_root",