Function readFileWall

packages/agent-core/src/tools/cron/clock.ts:110–136

(filePath: string)

const MAX_CLOCK_FILE_BYTES = 64;

function readFileWall(filePath: string): number {
  let bytesRead = 0;
  const buf = Buffer.alloc(MAX_CLOCK_FILE_BYTES);
  let fd: number;
  try {
    fd = openSync(filePath, 'r');
  } catch {
    return Date.now();
  }
  try {
    bytesRead = readSync(fd, buf, 0, MAX_CLOCK_FILE_BYTES, 0);
  } catch {
    return Date.now();
  } finally {
    try {
      closeSync(fd);
    } catch {
      /* swallow close errors */
    }
  }
  const raw = buf.subarray(0, bytesRead).toString('utf8');
  const firstLine = raw.split('\n', 1)[0]?.trim() ?? '';
  if (firstLine === '') return Date.now();
  const parsed = Number(firstLine);
  if (!Number.isFinite(parsed)) return Date.now();
  return parsed;
}

function debugInvalidSpec(spec: string, reason: string): void {
  // We do not pull in a logger here — `clock.ts` is the lowest layer of