harnery 0.32.0 → 0.34.0

package/dist/core/agents/state/session-state.js

@@ -0,0 +1,90 @@
+const TERMINAL_ACTIVITY_EVENTS = new Set([
+    "session.ended",
+    "agent.completed",
+    "turn.completed",
+]);
+/**
+ * Apply one canonical event to the two independent state axes.
+ *
+ * The table is deliberately evidence-only. Output chunks, post-tool events,
+ * narration, coordination commands, and elapsed time cannot clear an observed
+ * input wait. A command start only counts as progress when the session was
+ * already inside an open turn (`working` or `needs_input`).
+ */
+export function applySessionStateEvent(current, event) {
+    const next = { ...current };
+    if (event.event_type === "session.started" ||
+        event.event_type === "session.resumed" ||
+        event.event_type === "agent.started") {
+        setActivity(next, "idle", event);
+    }
+    else if (event.event_type === "turn.started" || event.event_type === "tool.requested") {
+        setActivity(next, "working", event);
+    }
+    else if (event.event_type === "wait.started") {
+        setActivity(next, "needs_input", event);
+    }
+    else if (event.event_type === "wait.ended") {
+        setActivity(next, "working", event);
+    }
+    else if (event.event_type === "command.started" &&
+        (current.activity === "working" || current.activity === "needs_input")) {
+        setActivity(next, "working", event);
+    }
+    else if (TERMINAL_ACTIVITY_EVENTS.has(event.event_type)) {
+        setActivity(next, "idle", event);
+    }
+    if (event.event_type === "coord.lifecycle_changed") {
+        const payload = event.payload ?? {};
+        const state = field(payload, "new_state");
+        if (state === "active" || state === "blocked" || state === "done") {
+            next.task_state = state;
+            next.task_state_updated_at = event.ts;
+            const reason = field(payload, "reason");
+            if (typeof reason === "string" && reason.length > 0) {
+                next.task_state_reason = reason;
+            }
+            else {
+                delete next.task_state_reason;
+            }
+        }
+    }
+    return next;
+}
+/**
+ * Rebuild both axes from canonical events after a heartbeat has disappeared.
+ * Events may be the whole ledger or an already-filtered session slice.
+ */
+export function foldSessionState(events, selector = {}) {
+    const ordered = events
+        .map((event, index) => ({ event, index }))
+        .filter(({ event }) => matches(event, selector))
+        .sort((a, b) => timestamp(a.event) - timestamp(b.event) || a.index - b.index);
+    let fields = {};
+    for (const { event } of ordered)
+        fields = applySessionStateEvent(fields, event);
+    return {
+        ...fields,
+        activity: fields.activity ?? "unknown",
+        task_state: fields.task_state ?? "active",
+    };
+}
+function setActivity(target, activity, event) {
+    target.activity = activity;
+    target.activity_updated_at = event.ts;
+    target.activity_source = event.event_type;
+}
+function matches(event, selector) {
+    if (selector.instance_id && event.instance_id !== selector.instance_id)
+        return false;
+    if (selector.session_id && event.session_id !== selector.session_id)
+        return false;
+    return true;
+}
+function timestamp(event) {
+    const parsed = Date.parse(event.ts);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function field(data, key) {
+    return data[key];
+}

package/dist/core/agents/state/stale-sweep.d.ts

@@ -2,7 +2,7 @@
  * Stale-sweep: prune dead heartbeats + orphaned pid-map + .last-peer-hash
  * files.
  *
- * Fires at session.start to clean up crashed-peer detritus before the new
+ * Runs after session.started to clean up crashed-peer detritus before the new
  * session's UX layer reads peer state.
  *
  * Freshness threshold defaults to 600s; configurable via the

package/dist/core/agents/state/stale-sweep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stale-sweep.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/stale-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+CH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;IAC7C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CA2HA"}
+{"version":3,"file":"stale-sweep.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/stale-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoDH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;IAC7C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CA6IA"}

package/dist/core/agents/state/stale-sweep.js

@@ -2,7 +2,7 @@
  * Stale-sweep: prune dead heartbeats + orphaned pid-map + .last-peer-hash
  * files.
  *
- * Fires at session.start to clean up crashed-peer detritus before the new
+ * Runs after session.started to clean up crashed-peer detritus before the new
  * session's UX layer reads peer state.
  *
  * Freshness threshold defaults to 600s; configurable via the
@@ -12,7 +12,7 @@
 import { existsSync, readdirSync, readFileSync, statSync, unlinkSync } from "node:fs";
 import { join } from "node:path";
 import { coordFreshnessSeconds } from "../../config.js";
-import { emit } from "../events/emit.js";
+import { recordLiveSweepObservationV3 } from "../live-lifecycle-v3.js";
 /** platform → adapter, for the swept-event envelope (mirrors heartbeat-writer's adapterOf). */
 function adapterFromPlatform(platform) {
     if (platform === "cursor")
@@ -21,21 +21,25 @@ function adapterFromPlatform(platform) {
         return "codex";
     return "claude-code";
 }
-/** Emit a best-effort health.heartbeat_swept event. Telemetry only, never throws. */
+/** Record the sweep before deleting authority state. V3 ambiguity fails closed. */
 function emitSwept(coordRoot, instanceId, adapter, sessionId, reason, ageSecs) {
     try {
-        emit(coordRoot, {
-            event_type: "health.heartbeat_swept",
-            instance_id: instanceId,
-            session_id: sessionId,
+        recordLiveSweepObservationV3({
+            coordRoot,
+            owner: instanceId,
+            nativeSessionId: sessionId,
             adapter,
-            source: "agent-coord",
-            data: { reason, ...(ageSecs !== undefined ? { age_secs: ageSecs } : {}) },
-            // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+            observation: reason === "stale"
+                ? "stale_heartbeat"
+                : reason === "unparseable"
+                    ? "unparseable_heartbeat"
+                    : "missing_timestamp",
+            ageMs: Math.max(0, (ageSecs ?? 0) * 1_000),
         });
+        return true;
     }
     catch {
-        /* telemetry only, never break the sweep */
+        return false;
     }
 }
 /** File mtime in epoch-seconds, or +Infinity if it can't be read (treat as fresh → don't reap). */
@@ -54,7 +58,7 @@ export function staleSweep(coordRoot) {
     const freshness = coordFreshnessSeconds(coordRoot);
     const nowSec = Math.floor(Date.now() / 1000);
     const cutoff = nowSec - freshness;
-    // 1. Prune stale heartbeats from the canonical `.harnery/active/` dir.
+    // 1. Prune stale rows from the disposable V3 coordination cache.
     //
     // Two deletion regimes, deliberately asymmetric:
     //   • Valid JSON with an OLD last_heartbeat → the legitimate dead/idle-agent
@@ -87,9 +91,12 @@ export function staleSweep(coordRoot) {
                 // Unparseable: only reap if the file itself is mtime-old.
                 if (mtimeSecs(path) < cutoff) {
                     try {
+                        const ageSecs = nowSec - mtimeSecs(path);
+                        if (!emitSwept(coordRoot, idFromFile, "claude-code", idFromFile, "unparseable", ageSecs)) {
+                            continue;
+                        }
                         unlinkSync(path);
                         heartbeatsRemoved.push(f);
-                        emitSwept(coordRoot, idFromFile, "claude-code", idFromFile, "unparseable");
                     }
                     catch {
                         /* swallow */
@@ -106,9 +113,11 @@ export function staleSweep(coordRoot) {
             if (!parsed.last_heartbeat || !Number.isFinite(ts)) {
                 // No / NaN last_heartbeat: can't trust content; gate on mtime.
                 if (mtimeSecs(path) < cutoff) {
+                    if (!emitSwept(coordRoot, instanceId, adapter, sessionId, "missing_ts", nowSec - mtimeSecs(path))) {
+                        continue;
+                    }
                     unlinkSync(path);
                     heartbeatsRemoved.push(f);
-                    emitSwept(coordRoot, instanceId, adapter, sessionId, "missing_ts");
                 }
                 else if (parsed.instance_id) {
                     liveInstanceIds.add(parsed.instance_id);
@@ -117,9 +126,11 @@ export function staleSweep(coordRoot) {
             }
             if (ts < cutoff) {
                 // Legitimate stale prune (valid timestamp, past the freshness cutoff).
+                if (!emitSwept(coordRoot, instanceId, adapter, sessionId, "stale", nowSec - ts)) {
+                    continue;
+                }
                 unlinkSync(path);
                 heartbeatsRemoved.push(f);
-                emitSwept(coordRoot, instanceId, adapter, sessionId, "stale", nowSec - ts);
                 continue;
             }
             if (parsed.instance_id)

package/dist/core/artifacts/index.d.ts.map

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

package/dist/core/artifacts/index.js

@@ -11,6 +11,7 @@ import { spawnSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { readLiveCoordinationRow } from "../agents/state/live-coordination-view.js";
 import { artifactDefaultRetentionDays } from "../config.js";
 export const ARTIFACTS_DIR = join(".harnery", "artifacts");
 export const ARTIFACT_MANIFEST = ".harnery-artifact.json";
@@ -311,14 +312,11 @@ function atomicWriteManifest(path, manifest) {
     renameSync(tmp, target);
 }
 function ownerLiveness(repoRoot, instanceId, now, freshnessSeconds) {
-    const path = join(repoRoot, ".harnery", "active", `${instanceId}.json`);
-    if (!existsSync(path))
-        return "stale";
     try {
-        const hb = JSON.parse(readFileSync(path, "utf8"));
-        if (typeof hb.last_heartbeat !== "string")
-            return "unknown";
-        const ts = Date.parse(hb.last_heartbeat);
+        const row = readLiveCoordinationRow(repoRoot, instanceId);
+        if (!row)
+            return "stale";
+        const ts = Date.parse(row.last_heartbeat);
         if (!Number.isFinite(ts))
             return "unknown";
         return now.getTime() - ts <= freshnessSeconds * 1000 ? "live" : "stale";

package/dist/core/config.d.ts

@@ -9,8 +9,8 @@
  * Fields owned here: `binName` (host CLI name for agent-facing strings),
  * `hooksSetupHint`, `agents`, `tools`, `workflow`, `skills`, `presence`, plus the tunable
  * `coord` (heartbeat freshness), `artifacts` (working-file retention),
- * `backup` (restic repo/password/prune policy), and `sync` (rclone
- * remote/prefix) sections. The `files` deny/override section
+ * `backup` (restic repo/password/prune policy), `sync` (rclone
+ * remote/prefix), and `web` (dashboard port) sections. The `files` deny/override section
  * is parsed separately by `web/lib/files.ts`.
  *
  * Env vars and CLI flags override any config value per invocation (each accessor
@@ -21,6 +21,16 @@
 export declare const DEFAULT_BIN_NAME = "harn";
 /** Heartbeat-freshness default (seconds): the sweep window when nothing overrides it. */
 export declare const DEFAULT_FRESHNESS_SECS = 600;
+/** Mnemonic dashboard port: 4276 spells HARN on a phone keypad. */
+export declare const DEFAULT_WEB_PORT = 4276;
+export interface SessionFinalizationConfig {
+    archiveGraceSeconds: number;
+    idleObserveSeconds: number;
+    idleFinalizeSeconds: number;
+    cascadeGraceSeconds: number;
+    reconcileIntervalSeconds: number;
+}
+export declare const DEFAULT_SESSION_FINALIZATION_CONFIG: SessionFinalizationConfig;
 export type AgentFinalizationDisposition = "git" | "output";
 export interface AgentFinalizationRoot {
     path: string;
@@ -28,6 +38,18 @@ export interface AgentFinalizationRoot {
 }
 /** Strip `//` and `/* *​/` comments from JSONC, ignoring comment-like runs inside strings. */
 export declare function stripJsonComments(input: string): string;
+export interface CoordRunQualityConfigSource {
+    value: unknown;
+    invalid: boolean;
+    /** Stable digest seed that contains no config values when parsing failed. */
+    digest_seed: unknown;
+}
+/**
+ * Effective user-plus-project `coord.run_quality` value with parse diagnostics.
+ * The ordinary config reader stays fail-soft; this one lets the guard visibly
+ * disable itself rather than silently substituting defaults for malformed JSONC.
+ */
+export declare function coordRunQualityConfigSource(root: string): CoordRunQualityConfigSource;
 /**
  * Resolve the host CLI's bin name for user-facing strings. Precedence:
  *   1. `HARNERY_BIN` env (explicit per-process override)
@@ -120,6 +142,15 @@ export declare function presenceRelayUrl(coordRoot?: string | null): string | nu
  * `coordRoot` is resolved via `findCoordRoot()` when not passed.
  */
 export declare function coordFreshnessSeconds(coordRoot?: string | null): number;
+/**
+ * Resolve the standalone dashboard port.
+ *
+ * Precedence: explicit `--port` flag, `HARNERY_WEB_PORT`, merged
+ * `.harnery/config.jsonc` `web.port`, then the mnemonic built-in default 4276.
+ */
+export declare function resolveWebPort(explicitPort?: string, coordRoot?: string | null): number;
+/** Policy for converging independent termination signals on one finalizer. */
+export declare function sessionFinalizationConfig(coordRoot?: string | null): SessionFinalizationConfig;
 /**
  * Default retention for a newly-created working artifact. Precedence:
  * `HARNERY_ARTIFACT_RETENTION_DAYS` -> project/user config

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,4BAA4B,CAAC;CAC3C;AA+ED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqCvD;AAuGD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAShE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAK9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAO/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,EAAE,CAY1F;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIxE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAOrE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAO3E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAOlE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAWzE;AAQD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CASvE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAe9E;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAmBpE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS3C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,mCAAmC,EAAE,yBAMjD,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,4BAA4B,CAAC;CAC3C;AA2FD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqCvD;AA0CD,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,CAqBrF;AAmFD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAShE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAK9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAO/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,EAAE,CAY1F;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIxE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAOrE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAO3E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAOlE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAWzE;AAQD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CASvE;AAUD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAcvF;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,yBAAyB,CA0B9F;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAe9E;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAmBpE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS3C"}

package/dist/core/config.js

@@ -9,8 +9,8 @@
  * Fields owned here: `binName` (host CLI name for agent-facing strings),
  * `hooksSetupHint`, `agents`, `tools`, `workflow`, `skills`, `presence`, plus the tunable
  * `coord` (heartbeat freshness), `artifacts` (working-file retention),
- * `backup` (restic repo/password/prune policy), and `sync` (rclone
- * remote/prefix) sections. The `files` deny/override section
+ * `backup` (restic repo/password/prune policy), `sync` (rclone
+ * remote/prefix), and `web` (dashboard port) sections. The `files` deny/override section
  * is parsed separately by `web/lib/files.ts`.
  *
  * Env vars and CLI flags override any config value per invocation (each accessor
@@ -26,6 +26,15 @@ import { findCoordRoot } from "./hooks/resolve/coord-root.js";
 export const DEFAULT_BIN_NAME = "harn";
 /** Heartbeat-freshness default (seconds): the sweep window when nothing overrides it. */
 export const DEFAULT_FRESHNESS_SECS = 600;
+/** Mnemonic dashboard port: 4276 spells HARN on a phone keypad. */
+export const DEFAULT_WEB_PORT = 4276;
+export const DEFAULT_SESSION_FINALIZATION_CONFIG = {
+    archiveGraceSeconds: 600,
+    idleObserveSeconds: 3 * 24 * 60 * 60,
+    idleFinalizeSeconds: 7 * 24 * 60 * 60,
+    cascadeGraceSeconds: 60 * 60,
+    reconcileIntervalSeconds: 15 * 60,
+};
 /** Strip `//` and `/* *​/` comments from JSONC, ignoring comment-like runs inside strings. */
 export function stripJsonComments(input) {
     let out = "";
@@ -108,6 +117,49 @@ function parseConfigFile(p) {
     }
     return {};
 }
+/**
+ * Effective user-plus-project `coord.run_quality` value with parse diagnostics.
+ * The ordinary config reader stays fail-soft; this one lets the guard visibly
+ * disable itself rather than silently substituting defaults for malformed JSONC.
+ */
+export function coordRunQualityConfigSource(root) {
+    const projectPath = join(root, ".harnery", "config.jsonc");
+    const userPath = userConfigPath();
+    const layers = [userPath, projectPath].map((path) => parseConfigLayer(path));
+    const invalid = layers.filter((layer) => layer.invalid);
+    if (invalid.length > 0) {
+        return {
+            value: undefined,
+            invalid: true,
+            digest_seed: invalid.map((layer) => ({
+                path_kind: layer.path_kind,
+                signature: layer.signature,
+            })),
+        };
+    }
+    const merged = mergeConfig(layers[0].config, layers[1].config);
+    return {
+        value: merged.coord?.run_quality,
+        invalid: false,
+        digest_seed: merged.coord?.run_quality,
+    };
+}
+function parseConfigLayer(path) {
+    const pathKind = path === userConfigPath() ? "user" : "project";
+    const signature = statSignature(path);
+    if (signature === null)
+        return { config: {}, invalid: false, path_kind: pathKind, signature };
+    try {
+        const value = JSON.parse(stripJsonComments(readFileSync(path, "utf8")));
+        if (isPlainObject(value)) {
+            return { config: value, invalid: false, path_kind: pathKind, signature };
+        }
+    }
+    catch {
+        // The guard reports one bounded health event for this file signature.
+    }
+    return { config: {}, invalid: true, path_kind: pathKind, signature };
+}
 function isPlainObject(v) {
     return typeof v === "object" && v !== null && !Array.isArray(v);
 }
@@ -358,6 +410,50 @@ export function coordFreshnessSeconds(coordRoot) {
         return posIntOr(readConfig(root).coord?.freshness_seconds, DEFAULT_FRESHNESS_SECS);
     return DEFAULT_FRESHNESS_SECS;
 }
+function parseWebPort(value, source) {
+    const port = typeof value === "number" ? value : Number(value);
+    if (!Number.isInteger(port) || port < 1024 || port > 65535) {
+        throw new RangeError(`${source} must be an integer from 1024 through 65535`);
+    }
+    return port;
+}
+/**
+ * Resolve the standalone dashboard port.
+ *
+ * Precedence: explicit `--port` flag, `HARNERY_WEB_PORT`, merged
+ * `.harnery/config.jsonc` `web.port`, then the mnemonic built-in default 4276.
+ */
+export function resolveWebPort(explicitPort, coordRoot) {
+    if (explicitPort !== undefined && explicitPort.trim() !== "") {
+        return parseWebPort(explicitPort, "--port");
+    }
+    const envPort = coordEnv("WEB_PORT");
+    if (envPort !== undefined && envPort.trim() !== "") {
+        return parseWebPort(envPort, "HARNERY_WEB_PORT");
+    }
+    const root = coordRoot ?? findCoordRoot();
+    const configuredPort = root ? readConfig(root).web?.port : undefined;
+    if (configuredPort !== undefined) {
+        return parseWebPort(configuredPort, "web.port");
+    }
+    return DEFAULT_WEB_PORT;
+}
+/** Policy for converging independent termination signals on one finalizer. */
+export function sessionFinalizationConfig(coordRoot) {
+    const root = coordRoot ?? findCoordRoot();
+    const configured = root ? readConfig(root).coord?.finalization : undefined;
+    const defaults = DEFAULT_SESSION_FINALIZATION_CONFIG;
+    const archiveGraceSeconds = posIntOr(configured?.archive_grace_seconds, defaults.archiveGraceSeconds);
+    const idleObserveSeconds = posIntOr(configured?.idle_observe_seconds, defaults.idleObserveSeconds);
+    const idleFinalizeSeconds = Math.max(idleObserveSeconds, posIntOr(configured?.idle_finalize_seconds, defaults.idleFinalizeSeconds));
+    return {
+        archiveGraceSeconds,
+        idleObserveSeconds,
+        idleFinalizeSeconds,
+        cascadeGraceSeconds: posIntOr(configured?.cascade_grace_seconds, defaults.cascadeGraceSeconds),
+        reconcileIntervalSeconds: posIntOr(configured?.reconcile_interval_seconds, defaults.reconcileIntervalSeconds),
+    };
+}
 /**
  * Default retention for a newly-created working artifact. Precedence:
  * `HARNERY_ARTIFACT_RETENTION_DAYS` -> project/user config

package/dist/core/context/index.d.ts

@@ -4,7 +4,7 @@
  * context telemetry when the adapter exposes it, checkpoints external work
  * state before compaction, and renders a verified recovery briefing after it.
  */
-import type { Adapter } from "../hooks/events/schema.js";
+import type { Adapter } from "../adapter.js";
 export declare const CONTEXT_SCHEMA_VERSION: 1;
 export declare const MAX_CAPSULE_BYTES: number;
 export type ContextSampleSource = "hook" | "native_event" | "result" | "transcript" | "estimate";
@@ -58,12 +58,9 @@ export interface ContinuityCapsule {
     context?: ContextSample;
     work: {
         task?: string;
-        turn_summary?: string;
         continuation_note?: string;
         files_held: string[];
         files_held_truncated?: boolean;
-        last_tool?: string;
-        last_tool_target?: string;
     };
     repo: RepoSnapshot;
 }

package/dist/core/context/index.d.ts.map

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

package/dist/core/context/index.js

@@ -8,6 +8,7 @@ import { spawnSync } from "node:child_process";
 import { createHash, randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { readLiveCoordinationRow } from "../agents/state/live-coordination-view.js";
 export const CONTEXT_SCHEMA_VERSION = 1;
 export const MAX_CAPSULE_BYTES = 32 * 1024;
 const MAX_SNAPSHOT_PATHS = 15;
@@ -214,17 +215,12 @@ export function renderRecoveryBriefing(capsule, liveRepo) {
     ];
     if (capsule.work.task)
         lines.push(`Task: ${capsule.work.task}`);
-    if (capsule.work.turn_summary)
-        lines.push(`Last progress: ${capsule.work.turn_summary}`);
     if (capsule.work.continuation_note) {
         lines.push(`Continuation note: ${capsule.work.continuation_note}`);
     }
     if (capsule.work.files_held.length > 0) {
         lines.push(`Files held: ${capsule.work.files_held.join(", ")}`);
     }
-    if (capsule.work.last_tool) {
-        lines.push(`Last tool: ${capsule.work.last_tool}${capsule.work.last_tool_target ? ` (${capsule.work.last_tool_target})` : ""}`);
-    }
     const drift = [];
     if (capsule.repo.branch && liveRepo.branch && capsule.repo.branch !== liveRepo.branch) {
         drift.push(`branch changed ${capsule.repo.branch} -> ${liveRepo.branch}`);
@@ -275,16 +271,20 @@ function buildWorkSnapshot(heartbeat, continuationNote) {
         : [];
     return {
         task: clampString(heartbeat?.task, 1_000),
-        turn_summary: clampString(heartbeat?.turn_summary, 3_000),
         continuation_note: clampString(continuationNote, 3_000),
         files_held: files.slice(0, MAX_SNAPSHOT_PATHS),
         ...(files.length > MAX_SNAPSHOT_PATHS ? { files_held_truncated: true } : {}),
-        last_tool: clampString(heartbeat?.last_tool, 200),
-        last_tool_target: clampString(heartbeat?.last_tool_target, 1_000),
     };
 }
 function readHeartbeat(coordRoot, instanceId) {
-    return readJson(join(coordRoot, ".harnery", "active", `${instanceId}.json`));
+    const row = readLiveCoordinationRow(coordRoot, instanceId);
+    if (!row)
+        return null;
+    return {
+        model: row.model,
+        task: row.task,
+        files_touched: row.files_touched,
+    };
 }
 function newState(input) {
     return {

package/dist/core/events/span-parent.d.ts

@@ -0,0 +1,15 @@
+export interface OpenToolSpanForCommandParent {
+    span_id: `span_${string}`;
+    turn_id?: `tid_${string}`;
+    requested_event_id?: `evt_${string}`;
+    tool_name?: string;
+}
+/**
+ * Choose a command's tool parent only when attribution cannot silently pick
+ * the wrong span. A single open tool is unambiguous. With parallel tools,
+ * exactly one shell-class span may be selected; every other case stays
+ * top-level so any over-count remains visible.
+ */
+export declare function selectCommandParentSpan(spans: readonly OpenToolSpanForCommandParent[], turnId: `tid_${string}`): `span_${string}` | undefined;
+export declare function isShellToolName(name: string | undefined): boolean;
+//# sourceMappingURL=span-parent.d.ts.map

package/dist/core/events/span-parent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-parent.d.ts","sourceRoot":"","sources":["../../../src/core/events/span-parent.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,QAAQ,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,MAAM,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,MAAM,EAAE,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAcD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,4BAA4B,EAAE,EAC9C,MAAM,EAAE,OAAO,MAAM,EAAE,GACtB,QAAQ,MAAM,EAAE,GAAG,SAAS,CAO9B;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAQjE"}

package/dist/core/events/span-parent.js

@@ -0,0 +1,34 @@
+const SHELL_TOOL_NAMES = new Set([
+    "apply_patch",
+    "bash",
+    "exec",
+    "exec_command",
+    "execute",
+    "powershell",
+    "run_command",
+    "shell",
+    "terminal",
+]);
+/**
+ * Choose a command's tool parent only when attribution cannot silently pick
+ * the wrong span. A single open tool is unambiguous. With parallel tools,
+ * exactly one shell-class span may be selected; every other case stays
+ * top-level so any over-count remains visible.
+ */
+export function selectCommandParentSpan(spans, turnId) {
+    const open = spans.filter((span) => span.turn_id === turnId && span.requested_event_id !== undefined);
+    if (open.length === 1)
+        return open[0]?.span_id;
+    const shell = open.filter((span) => isShellToolName(span.tool_name));
+    return shell.length === 1 ? shell[0]?.span_id : undefined;
+}
+export function isShellToolName(name) {
+    if (!name)
+        return false;
+    const normalized = name
+        .trim()
+        .toLowerCase()
+        .replace(/^.*[.:/]/, "")
+        .replaceAll("-", "_");
+    return SHELL_TOOL_NAMES.has(normalized);
+}

package/dist/core/events/v3/advance.d.ts

@@ -0,0 +1,14 @@
+import type { TSchema } from "@sinclair/typebox";
+export interface SchemaAdvanceEligibilityV3 {
+    eligible: boolean;
+    strict: boolean;
+    issues: string[];
+}
+/**
+ * Mechanical half of ADR 0080's in-place advance gate. It proves that every
+ * value accepted by the prior JSON Schema remains accepted by the next schema.
+ * Semantic reinterpretations remain breaking even when this structural check
+ * passes and require genesis review.
+ */
+export declare function validateAdditiveSchemaAdvanceV3(prior: TSchema, next: TSchema): SchemaAdvanceEligibilityV3;
+//# sourceMappingURL=advance.d.ts.map

package/dist/core/events/v3/advance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advance.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/advance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,GACZ,0BAA0B,CAQ5B"}