@forwardimpact/libeval 0.1.51 → 0.1.52

package/src/profile-prompt.js

@@ -14,20 +14,25 @@
  *   of the above based on `opts.role`.
  */
 
-import { readFileSync } from "node:fs";
 import { join } from "node:path";
 
 /**
- * Compose a `claude_code`-preset system prompt from a profile file.
+ * Compose a `claude_code`-preset system prompt from a profile file. The
+ * profile is read synchronously off the injected `runtime.fsSync` surface —
+ * this composer runs inside the synchronous SDK-option builders of the
+ * supervisor / facilitator / discusser / judge factories, so it cannot go
+ * async without an unbounded cascade.
+ *
  * @param {string} name - Profile basename (no `.md` suffix)
  * @param {object} opts
  * @param {string} opts.profilesDir - Directory containing `<name>.md`
  * @param {string} [opts.trailer] - Mode-specific trailer appended after a blank line
+ * @param {import("@forwardimpact/libutil/runtime").Runtime} opts.runtime - Ambient collaborators; uses `fsSync.readFileSync`.
  * @returns {{type: "preset", preset: "claude_code", append: string}}
  */
-export function composeProfilePrompt(name, { profilesDir, trailer }) {
+export function composeProfilePrompt(name, { profilesDir, trailer, runtime }) {
   const path = join(profilesDir, `${name}.md`);
-  const raw = readFileSync(path, "utf8");
+  const raw = runtime.fsSync.readFileSync(path, "utf8");
   const body = stripFrontmatter(raw).trim();
   const append = trailer && trailer.length > 0 ? `${body}\n\n${trailer}` : body;
   return { type: "preset", preset: "claude_code", append };
@@ -39,13 +44,14 @@ export function composeProfilePrompt(name, { profilesDir, trailer }) {
  * @param {string} [opts.profile] - Profile basename (no `.md` suffix)
  * @param {string} [opts.profilesDir] - Directory containing profile files
  * @param {string} opts.trailer - Mode-specific orchestration instructions
+ * @param {import("@forwardimpact/libutil/runtime").Runtime} opts.runtime - Ambient collaborators; uses `fsSync.readFileSync`.
  * @returns {string}
  */
-export function composeLeadPrompt({ profile, profilesDir, trailer }) {
+export function composeLeadPrompt({ profile, profilesDir, trailer, runtime }) {
   if (!trailer) throw new Error("trailer is required");
   if (!profile) return trailer;
   const path = join(profilesDir, `${profile}.md`);
-  const raw = readFileSync(path, "utf8");
+  const raw = runtime.fsSync.readFileSync(path, "utf8");
   const body = stripFrontmatter(raw).trim();
   return `${body}\n\n${trailer}`;
 }
@@ -59,15 +65,22 @@ export function composeLeadPrompt({ profile, profilesDir, trailer }) {
  * @param {string} [opts.profile] - Profile basename
  * @param {string} [opts.profilesDir]
  * @param {string} opts.trailer - Mode-specific instructions
+ * @param {import("@forwardimpact/libutil/runtime").Runtime} opts.runtime - Ambient collaborators; uses `fsSync.readFileSync`.
  * @returns {string | {type: "preset", preset: "claude_code", append: string}}
  */
-export function composeSystemPrompt({ role, profile, profilesDir, trailer }) {
+export function composeSystemPrompt({
+  role,
+  profile,
+  profilesDir,
+  trailer,
+  runtime,
+}) {
   if (!trailer) throw new Error("trailer is required");
   if (role === "lead") {
-    return composeLeadPrompt({ profile, profilesDir, trailer });
+    return composeLeadPrompt({ profile, profilesDir, trailer, runtime });
   }
   if (profile) {
-    return composeProfilePrompt(profile, { profilesDir, trailer });
+    return composeProfilePrompt(profile, { profilesDir, trailer, runtime });
   }
   return { type: "preset", preset: "claude_code", append: trailer };
 }

package/src/supervisor.js

@@ -145,8 +145,10 @@ export function createSupervisor({
   taskAmend,
   agentMcpServers,
   redactor,
+  runtime,
 }) {
   if (!redactor) throw new Error("redactor is required");
+  if (!runtime) throw new Error("runtime is required");
   const resolvedProfilesDir =
     profilesDir ?? resolve(supervisorCwd, ".claude/agents");
 
@@ -180,6 +182,7 @@ export function createSupervisor({
       profile: agentProfile,
       profilesDir: resolvedProfilesDir,
       trailer: AGENT_SYSTEM_PROMPT,
+      runtime,
     }),
     mcpServers: { orchestration: agentServer, ...agentMcpServers },
     redactor,
@@ -213,6 +216,7 @@ export function createSupervisor({
       profile: supervisorProfile,
       profilesDir: resolvedProfilesDir,
       trailer: SUPERVISOR_SYSTEM_PROMPT,
+      runtime,
     }),
     mcpServers: { orchestration: supervisorServer },
     redactor,

package/src/tee-writer.js

@@ -27,15 +27,17 @@ export class TeeWriter extends Writable {
    * @param {import("stream").Writable} deps.fileStream - Stream to write raw NDJSON to
    * @param {import("stream").Writable} deps.textStream - Stream to write human-readable text to
    * @param {"raw"|"supervised"} [deps.mode] - Display mode: "raw" (no source labels) or "supervised" (source labels) (default: "raw")
+   * @param {function} [deps.now] - Injected ISO-timestamp source threaded into
+   *   the internal `TraceCollector` (`() => isoTimestamp(runtime.clock.now())`).
    */
-  constructor({ fileStream, textStream, mode }) {
+  constructor({ fileStream, textStream, mode, now }) {
     super();
     if (!fileStream) throw new Error("fileStream is required");
     if (!textStream) throw new Error("textStream is required");
     this.fileStream = fileStream;
     this.textStream = textStream;
     this.mode = mode ?? "raw";
-    this.collector = new TraceCollector();
+    this.collector = new TraceCollector({ now });
     this.turnsEmitted = 0;
   }
 

package/src/trace-collector.js

@@ -9,6 +9,8 @@
  * one formatting path.
  */
 
+import { isoTimestamp } from "@forwardimpact/libutil";
+
 import { renderTurnLines } from "./render/turn-renderer.js";
 import { isSuppressedOrchestratorEvent } from "./render/orchestrator-filter.js";
 
@@ -16,11 +18,16 @@ import { isSuppressedOrchestratorEvent } from "./render/orchestrator-filter.js";
 export class TraceCollector {
   /**
    * @param {object} [deps]
-   * @param {function} [deps.now] - Returns ISO timestamp string. Defaults to () => new Date().toISOString()
+   * @param {function} [deps.now] - Returns an ISO timestamp string. Injected
+   *   so the collector never reads the wall clock directly; construct it as
+   *   `() => isoTimestamp(runtime.clock.now())`. When omitted (pure
+   *   structural/replay use where every event already carries a `timestamp`),
+   *   the fallback formats the epoch — a deterministic sentinel, not a clock
+   *   read.
    */
   constructor(deps = {}) {
     /** @type {function} */
-    this.now = deps.now ?? (() => new Date().toISOString());
+    this.now = deps.now ?? (() => isoTimestamp(0));
     /** @type {object|null} */
     this.metadata = null;
     /** @type {Array<object>} */

package/src/trace-github.js

@@ -1,10 +1,9 @@
-import { execSync } from "node:child_process";
-import { createWriteStream } from "node:fs";
-import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import { pipeline } from "node:stream/promises";
 import { Readable } from "node:stream";
 
+import { isoTimestamp } from "@forwardimpact/libutil";
+
 const API = "https://api.github.com";
 
 /**
@@ -17,11 +16,15 @@ export class TraceGitHub {
    * @param {string} deps.token - GitHub token
    * @param {string} deps.owner - Repository owner
    * @param {string} deps.repo  - Repository name
+   * @param {import("@forwardimpact/libutil/runtime").Runtime} deps.runtime -
+   *   Ambient collaborators; uses `fs`, `subprocess`, `clock`.
    */
-  constructor({ token, owner, repo }) {
+  constructor({ token, owner, repo, runtime }) {
+    if (!runtime) throw new Error("runtime is required");
     this.token = token;
     this.owner = owner;
     this.repo = repo;
+    this.runtime = runtime;
   }
 
   /**
@@ -35,7 +38,7 @@ export class TraceGitHub {
    */
   async listRuns(opts = {}) {
     const { pattern = "agent", limit = 50, lookback = "7d" } = opts;
-    const cutoff = parseLookback(lookback);
+    const cutoff = parseLookback(lookback, this.runtime.clock.now());
 
     const params = new URLSearchParams({
       per_page: String(Math.min(limit, 100)),
@@ -77,8 +80,9 @@ export class TraceGitHub {
    * @returns {Promise<{dir: string, artifact: string, files: string[]}>}
    */
   async downloadTrace(runId, opts = {}) {
+    const fs = this.runtime.fs;
     const dir = opts.dir ?? `/tmp/trace-${runId}`;
-    await mkdir(dir, { recursive: true });
+    await fs.mkdir(dir, { recursive: true });
 
     // List artifacts for this run.
     const url = `${API}/repos/${this.owner}/${this.repo}/actions/runs/${runId}/artifacts`;
@@ -121,15 +125,27 @@ export class TraceGitHub {
     }
 
     // Stream to disk then extract.
-    await pipeline(Readable.fromWeb(response.body), createWriteStream(zipPath));
-
-    execSync(
-      `unzip -o -q ${JSON.stringify(zipPath)} -d ${JSON.stringify(dir)}`,
+    await pipeline(
+      Readable.fromWeb(response.body),
+      fs.createWriteStream(zipPath),
     );
 
+    const unzip = await this.runtime.subprocess.run("unzip", [
+      "-o",
+      "-q",
+      zipPath,
+      "-d",
+      dir,
+    ]);
+    if (unzip.exitCode !== 0) {
+      throw new Error(
+        `unzip failed (${unzip.exitCode}): ${unzip.stderr || unzip.stdout}`,
+      );
+    }
+
     // List extracted files.
-    const { readdirSync } = await import("node:fs");
-    const files = readdirSync(dir).filter((f) => !f.endsWith(".zip"));
+    const entries = await fs.readdir(dir);
+    const files = entries.filter((f) => !f.endsWith(".zip"));
 
     return { dir, artifact: artifact.name, files };
   }
@@ -160,14 +176,15 @@ export class TraceGitHub {
  * Parse a lookback duration string into an ISO date string.
  * Supports: Nd (days), Nh (hours), Nw (weeks).
  * @param {string} lookback
+ * @param {number} nowMs - Current time in ms (`runtime.clock.now()`).
  * @returns {string|null} ISO date string or null if unparseable
  */
-function parseLookback(lookback) {
+function parseLookback(lookback, nowMs) {
   const match = lookback.match(/^(\d+)([dhw])$/);
   if (!match) return null;
   const [, val, unit] = match;
   const ms = { d: 86400000, h: 3600000, w: 604800000 }[unit];
-  return new Date(Date.now() - parseInt(val, 10) * ms).toISOString();
+  return isoTimestamp(nowMs - parseInt(val, 10) * ms);
 }
 
 /**
@@ -203,22 +220,23 @@ export function parseGitRemote(remote) {
  *   1. `GITHUB_REPOSITORY` env var (set automatically by GitHub Actions).
  *   2. `git remote get-url origin` in the current working directory.
  *
- * @returns {{owner: string, repo: string}}
+ * @param {import("@forwardimpact/libutil/runtime").Runtime} runtime
+ * @returns {Promise<{owner: string, repo: string}>}
  * @throws {Error} with a clear message if neither source yields a parseable slug.
  */
-export function detectRepoSlug() {
-  const env = process.env.GITHUB_REPOSITORY;
+export async function detectRepoSlug(runtime) {
+  const env = runtime.proc.env.GITHUB_REPOSITORY;
   if (env && env.trim()) {
     return parseGitRemote(env.trim());
   }
 
-  let remote;
-  try {
-    remote = execSync("git remote get-url origin", {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-    }).trim();
-  } catch {
+  const result = await runtime.subprocess.run("git", [
+    "remote",
+    "get-url",
+    "origin",
+  ]);
+  const remote = result.exitCode === 0 ? result.stdout.trim() : "";
+  if (result.exitCode !== 0) {
     throw new Error(
       "Cannot detect repository: set --repo <owner/repo>, export GITHUB_REPOSITORY, or run inside a git checkout with an 'origin' remote.",
     );
@@ -245,10 +263,12 @@ export function detectRepoSlug() {
  * @param {object} opts
  * @param {string} opts.token - GitHub token (e.g. from `Config.ghToken()`)
  * @param {string} [opts.repo] - "owner/repo" override (default: detect from git remote)
+ * @param {import("@forwardimpact/libutil/runtime").Runtime} opts.runtime - Ambient collaborators.
  * @returns {Promise<TraceGitHub>}
  */
 export async function createTraceGitHub(opts = {}) {
-  const { token, repo: repoOverride } = opts;
+  const { token, repo: repoOverride, runtime } = opts;
+  if (!runtime) throw new Error("createTraceGitHub: runtime is required");
   if (!token) {
     throw new Error(
       "createTraceGitHub: token is required (pass Config.ghToken())",
@@ -257,7 +277,7 @@ export async function createTraceGitHub(opts = {}) {
 
   const { owner, repo } = repoOverride
     ? parseGitRemote(repoOverride)
-    : detectRepoSlug();
+    : await detectRepoSlug(runtime);
 
-  return new TraceGitHub({ token, owner, repo });
+  return new TraceGitHub({ token, owner, repo, runtime });
 }