Skip to content

Local-first 🧠 memory for Hermes Agent that lives in your Obsidian vault and remembers project context. Nightly 😴 dream passes turn repeat corrections into confirmed preferences with measurable confidence. Adapters ship for Claude Code, Codex, and OpenClaw, with an MCP server for anything else.

TypeScript
3.0 KB
Raw Blame
/**
 * Shared coercion helpers for the `o2b` CLI.
 *
 * Parse and validate optional CLI flag values. Each helper returns a
 * `{ value, error }` tuple so the caller can decide the exit code.
 */

import { parseOptionalFiniteNumberInput } from "../core/validate.ts";

/**
 * Parse an optional `--<name>` flag whose value should be a finite number.
 * Returns `{ value: number | null, error: string | null }`.
 *
 * Trim before testing for emptiness — `Number(" ")` evaluates to `0` in JS.
 */
export function parseOptionalNumberFlag(
  flags: Record<string, string | boolean | string[] | undefined>,
  name: string,
): { value: number | null; error: string | null } {
  const raw = flags[name];
  if (raw === undefined) return { value: null, error: null };
  // A non-string value (boolean / string[]) indicates a misconfigured
  // flag schema — surface it as a clean validation error instead of
  // throwing at the `.trim()` call below.
  if (typeof raw !== "string") {
    return {
      value: null,
      error: `--${name} must be provided as a single string value`,
    };
  }
  const parsed = parseOptionalFiniteNumberInput(raw);
  if (parsed.error !== null) {
    return { value: null, error: `--${name} must be a number, got: ${raw}` };
  }
  return { value: parsed.value, error: null };
}

/**
 * Strict ISO-8601 timestamp matcher used by `--now / --since / --until`.
 * The plain `new Date(s)` constructor is far too permissive. We require
 * a full date-time including offset (`Z` or `±HH:MM`).
 *
 * Sibling regex: `ISO_UTC_TS_RE` in `src/core/brain/log-jsonl.ts`. That
 * one is intentionally stricter (Z only, no `±HH:MM`, no millisecond
 * cap) because it parses values that the *writer* (`renderJsonlLine`)
 * has just emitted in canonical UTC. This one is looser because it
 * has to accept whatever a human typed on the CLI; the resulting
 * `Date` is normalised to UTC by the JS runtime before any downstream
 * code touches it.
 */
export const ISO_8601_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-]\d{2}:\d{2})$/;

/**
 * Parse an optional `--<name>` flag as a strict ISO-8601 Date.
 * Returns `{ value: Date | null, error: string | null }`.
 */
export function parseOptionalIsoDate(
  flags: Record<string, string | boolean | string[] | undefined>,
  name: string,
): { value: Date | null; error: string | null } {
  const raw = flags[name];
  if (raw === undefined) return { value: null, error: null };
  if (typeof raw !== "string") {
    return {
      value: null,
      error: `--${name} must be provided as a single string value`,
    };
  }
  const trimmed = raw.trim();
  if (trimmed === "") return { value: null, error: null };
  if (!ISO_8601_RE.test(trimmed)) {
    return {
      value: null,
      error: `--${name} must be a valid ISO-8601 timestamp; got ${raw}`,
    };
  }
  const d = new Date(trimmed);
  if (!Number.isFinite(d.getTime())) {
    return {
      value: null,
      error: `--${name} must be a valid ISO-8601 timestamp; got ${raw}`,
    };
  }
  return { value: d, error: null };
}