@lannguyensi/harness 0.10.1 → 0.11.0

package/dist/runtime/pending-approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-approval.js","sourceRoot":"","sources":["../../src/runtime/pending-approval.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,qEAAqE;AACrE,sEAAsE;AACtE,4EAA4E;AAC5E,sEAAsE;AACtE,uEAAuE;AACvE,oEAAoE;AACpE,EAAE;AACF,yEAAyE;AACzE,gEAAgE;AAChE,0EAA0E;AAC1E,4EAA4E;AAC5E,eAAe;AACf,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,qEAAqE;AACrE,wDAAwD;AAExD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,yEAAyE;AACzE,oEAAoE;AACpE,sEAAsE;AACtE,oBAAoB;AACpB,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAGnC;IACC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB,EAAE,SAAiB;IAC1E,eAAe,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,GAAG,SAAS,IAAI,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;AACH,CAAC"}

package/dist/runtime/session-id.d.ts

@@ -1,5 +1,5 @@
 /**
- * Resolve the active grounding session id.
+ * Resolve the active grounding session id (WRITE path).
  *
  * Empty strings are treated as "not provided" — both for the explicit
  * argument and for the env var, since `--session ''` from a forgetful
@@ -8,3 +8,42 @@
  * empty session.
  */
 export declare function resolveSessionId(explicit?: string): string;
+export interface DiscoverSessionOptions {
+    /** Override the Claude Code projects root (tests). */
+    projectsRoot?: string;
+    /** Override `$HOME` used to derive the projects root (tests). */
+    homeDir?: string;
+}
+/**
+ * Discover the current Claude Code session id from the most recently
+ * modified transcript JSONL under `~/.claude/projects/<project>/`.
+ *
+ * Claude Code appends to the active session's transcript live, so the
+ * newest-mtime `<uuid>.jsonl` across all project dirs is the running
+ * session. Returns `null` when the projects root is absent or holds no
+ * transcript files — callers fall through to their own default.
+ */
+export declare function discoverNewestSessionId(opts?: DiscoverSessionOptions): string | null;
+export interface ResolveReadSessionOptions extends DiscoverSessionOptions {
+    /**
+     * Test seam — override the transcript-discovery tier wholesale. The
+     * default scans the real `~/.claude/projects` via
+     * `discoverNewestSessionId`.
+     */
+    discover?: (opts: DiscoverSessionOptions) => string | null;
+}
+/**
+ * Resolve the session id for the READ path (`audit`,
+ * `explain --trace/--last`).
+ *
+ * Precedence:
+ *   1. explicit value (the `--session` flag)
+ *   2. `$CLAUDE_SESSION_ID` env
+ *   3. newest Claude Code transcript (the live session)
+ *   4. literal `"default"`
+ *
+ * The WRITE path keeps `resolveSessionId`: it always has
+ * `event.session_id`, so it never reaches the discovery tier, and a
+ * per-hook-event filesystem scan would be wasteful.
+ */
+export declare function resolveReadSessionId(explicit?: string, opts?: ResolveReadSessionOptions): string;

package/dist/runtime/session-id.js

@@ -9,16 +9,28 @@
 // audit/trace even though the writes had landed correctly under the
 // real UUID.
 //
-// This helper lifts the precedence chain into one place:
-//   1. explicit value (from a `--session` flag or the runtime's
-//      `event.session_id`)
-//   2. `$CLAUDE_SESSION_ID` env (set by the Claude Code harness inside
-//      every session)
-//   3. literal `"default"` — preserves prior behaviour for ad-hoc
-//      invocations outside a Claude Code session.
+// `resolveSessionId` lifts the precedence chain into one place for the
+// WRITE path (`policy intercept`), which always carries a concrete
+// `event.session_id`:
+//   1. explicit value (the runtime's `event.session_id`)
+//   2. `$CLAUDE_SESSION_ID` env
+//   3. literal `"default"`
+//
+// The READ path (`audit`, `explain --trace/--last`) needs more. The
+// Phase 5 #2 fix assumed `$CLAUDE_SESSION_ID` is exported into the
+// session's shell environment — it is not (Claude Code does not put it
+// in the Bash tool env), so tier 2 is inert in practice and the readers
+// still fell through to `"default"`. `resolveReadSessionId` adds a
+// transcript-discovery tier: when no explicit id and no env, it reads
+// the active session id off the newest Claude Code transcript JSONL.
+// That is the programmatic form of the heuristic `harness approve`'s
+// own help text recommends to humans.
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
 const FALLBACK = "default";
 /**
- * Resolve the active grounding session id.
+ * Resolve the active grounding session id (WRITE path).
  *
  * Empty strings are treated as "not provided" — both for the explicit
  * argument and for the env var, since `--session ''` from a forgetful
@@ -34,4 +46,83 @@ export function resolveSessionId(explicit) {
         return env;
     return FALLBACK;
 }
+// Claude Code names each session's transcript `<uuid>.jsonl`. Anchored
+// so sibling files (memory dirs, `.pending-approval`, etc.) are ignored.
+const SESSION_TRANSCRIPT_RE = /^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\.jsonl$/i;
+/**
+ * Discover the current Claude Code session id from the most recently
+ * modified transcript JSONL under `~/.claude/projects/<project>/`.
+ *
+ * Claude Code appends to the active session's transcript live, so the
+ * newest-mtime `<uuid>.jsonl` across all project dirs is the running
+ * session. Returns `null` when the projects root is absent or holds no
+ * transcript files — callers fall through to their own default.
+ */
+export function discoverNewestSessionId(opts = {}) {
+    const projectsRoot = opts.projectsRoot ??
+        path.join(opts.homeDir ?? os.homedir(), ".claude", "projects");
+    let projectDirs;
+    try {
+        projectDirs = fs.readdirSync(projectsRoot);
+    }
+    catch {
+        return null;
+    }
+    let newest = null;
+    for (const dir of projectDirs) {
+        const projectPath = path.join(projectsRoot, dir);
+        let files;
+        try {
+            files = fs.readdirSync(projectPath);
+        }
+        catch {
+            continue; // not a directory, or unreadable — skip
+        }
+        for (const file of files) {
+            const match = SESSION_TRANSCRIPT_RE.exec(file);
+            if (!match)
+                continue;
+            let mtimeMs;
+            try {
+                mtimeMs = fs.statSync(path.join(projectPath, file)).mtimeMs;
+            }
+            catch {
+                continue;
+            }
+            if (newest === null || mtimeMs > newest.mtimeMs) {
+                newest = { id: match[1], mtimeMs };
+            }
+        }
+    }
+    return newest === null ? null : newest.id;
+}
+/**
+ * Resolve the session id for the READ path (`audit`,
+ * `explain --trace/--last`).
+ *
+ * Precedence:
+ *   1. explicit value (the `--session` flag)
+ *   2. `$CLAUDE_SESSION_ID` env
+ *   3. newest Claude Code transcript (the live session)
+ *   4. literal `"default"`
+ *
+ * The WRITE path keeps `resolveSessionId`: it always has
+ * `event.session_id`, so it never reaches the discovery tier, and a
+ * per-hook-event filesystem scan would be wasteful.
+ */
+export function resolveReadSessionId(explicit, opts = {}) {
+    if (typeof explicit === "string" && explicit.length > 0)
+        return explicit;
+    const env = process.env.CLAUDE_SESSION_ID;
+    if (typeof env === "string" && env.length > 0)
+        return env;
+    const discover = opts.discover ?? discoverNewestSessionId;
+    const discovered = discover({
+        ...(opts.projectsRoot !== undefined && { projectsRoot: opts.projectsRoot }),
+        ...(opts.homeDir !== undefined && { homeDir: opts.homeDir }),
+    });
+    if (typeof discovered === "string" && discovered.length > 0)
+        return discovered;
+    return FALLBACK;
+}
 //# sourceMappingURL=session-id.js.map

package/dist/runtime/session-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-id.js","sourceRoot":"","sources":["../../src/runtime/session-id.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,uEAAuE;AACvE,iEAAiE;AACjE,qEAAqE;AACrE,8DAA8D;AAC9D,wEAAwE;AACxE,iEAAiE;AACjE,oEAAoE;AACpE,aAAa;AACb,EAAE;AACF,yDAAyD;AACzD,gEAAgE;AAChE,2BAA2B;AAC3B,uEAAuE;AACvE,sBAAsB;AACtB,kEAAkE;AAClE,kDAAkD;AAElD,MAAM,QAAQ,GAAG,SAAS,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"session-id.js","sourceRoot":"","sources":["../../src/runtime/session-id.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lannguyensi/harness",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "Declarative control plane for agent harnesses — one YAML for grounding, tools, memory, and hooks.",
   "license": "MIT",
   "homepage": "https://github.com/LanNguyenSi/harness",