@letsrunit/journal 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# Journal Package (`@letsrunit/journal`)
+
+## Installation
+
+```bash
+npm install @letsrunit/journal
+# or
+yarn add @letsrunit/journal
+```
+
+Logging and reporting infrastructure for test execution and AI decision processes. It provides a structured way to capture logs, artifacts (like screenshots), and metadata during automation runs.
+
+## Exported Classes
+
+### `Journal<TSink>`
+
+The main class for logging. It requires a `Sink` to publish entries.
+
+#### Methods:
+
+- **`static nil()`**: Creates a journal with a `NoSink` (logs are ignored).
+- **`log(message, options)`**: The base logging method.
+- **`debug|info|warn|error(message, options)`**: Standard logging levels.
+- **`title(message, options)`**: Logs a title/header.
+- **`start|success|failure(message, options)`**: Methods to track the lifecycle of an action.
+- **`prepare(message, options)`**: Logs a preparation step.
+- **`do(message, callback, metaFn)`**: A wrapper for executing an action. It automatically logs `start`, `success` (with meta/artifacts), or `failure`.
+- **`batch()`**: Returns a `JournalBatch` instance for fluent, batched logging.
+
+### `JournalBatch`
+
+A builder-like class for logging multiple entries at once.
+
+## Sinks
+
+Sinks define where the logs are sent:
+
+- **`NoSink`**: Discards all logs.
+- **`ConsoleSink`**: Logs to the terminal.
+- **`CliSink`**: Advanced console logging with progress indicators and verbosity control.
+- **`SupabaseSink`**: Sends logs and artifacts to Supabase for persistence and real-time dashboard updates.
+
+## Testing
+
+Run tests for this package:
+
+```bash
+yarn test
+```

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+import { writeFile } from 'node:fs/promises';
+import { SupabaseClient } from '@supabase/supabase-js';
+
+interface JournalEntry {
+    timestamp: number;
+    type: 'debug' | 'info' | 'title' | 'warn' | 'error' | 'prepare' | 'start' | 'success' | 'failure';
+    message: string;
+    artifacts: File[];
+    meta: Record<string, any>;
+}
+interface Sink {
+    publish(...entries: JournalEntry[]): Promise<void>;
+}
+
+type Options$1 = Partial<Pick<JournalEntry, 'artifacts' | 'meta'>>;
+declare class JournalBatch {
+    private sink;
+    private entries;
+    constructor(sink: Sink);
+    log(message: string | undefined, options: Options$1 & {
+        type: JournalEntry['type'];
+    }): JournalBatch;
+    flush(): Promise<void>;
+    debug(message: string | undefined, options?: Options$1): JournalBatch;
+    info(message: string | undefined, options?: Options$1): JournalBatch;
+    title(message: string | undefined, options?: Options$1): JournalBatch;
+    warn(message: string | undefined, options?: Options$1): JournalBatch;
+    error(message: string | undefined, options?: Options$1): JournalBatch;
+    prepare(message: string | undefined, options?: Options$1): JournalBatch;
+    success(message: string | undefined, options?: Options$1): JournalBatch;
+    failure(message: string | undefined, options?: Options$1): JournalBatch;
+    each<T>(items: Array<T>, fn: (journal: JournalBatch, item: T) => void): JournalBatch;
+}
+
+type WriteFile = typeof writeFile;
+interface CliSinkOptions {
+    stream?: NodeJS.WriteStream;
+    verbosity?: number;
+    artifactPath?: string;
+    writeFile?: WriteFile;
+}
+declare class CliSink implements Sink {
+    readonly stream: NodeJS.WriteStream;
+    readonly verbosity: number;
+    readonly artifactPath: string | undefined;
+    private readonly writeFile;
+    private entries;
+    constructor(options?: CliSinkOptions);
+    publish(...entries: JournalEntry[]): Promise<void>;
+    endSection(): void;
+    private replace;
+    private append;
+    private format;
+    private stripAnsi;
+    private countDisplayLines;
+    private storeArtifacts;
+}
+
+declare class NoSink implements Sink {
+    publish(): Promise<void>;
+}
+
+interface SupabaseSinkOptions {
+    supabase: SupabaseClient;
+    run: {
+        id: string;
+        projectId: string;
+    };
+    tableName?: string;
+    bucket?: string;
+    console?: {
+        error: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+    };
+}
+declare class SupabaseSink implements Sink {
+    private readonly supabase;
+    private readonly projectId;
+    private readonly runId;
+    private readonly tableName;
+    private readonly bucket?;
+    private readonly console;
+    private bucketEnsured;
+    constructor(options: SupabaseSinkOptions);
+    publish(...entries: JournalEntry[]): Promise<void>;
+    private ensureBucket;
+    private storeArtifacts;
+    private artifactExists;
+}
+
+type Options = Partial<Pick<JournalEntry, 'artifacts' | 'meta'>>;
+declare class Journal<TSink extends Sink = Sink> {
+    readonly sink: TSink;
+    constructor(sink: TSink);
+    static nil(): Journal<NoSink>;
+    log(message: string, options: Options & {
+        type: JournalEntry['type'];
+    }): Promise<void>;
+    batch(): JournalBatch;
+    do<T>(message: string, callback: () => T | Promise<T>, metaFn?: (result: T) => {
+        meta?: Record<string, any>;
+        artifacts?: File[];
+    }): Promise<T>;
+    debug(message: string, options?: Options): Promise<void>;
+    info(message: string, options?: Options): Promise<void>;
+    warn(message: string, options?: Options): Promise<void>;
+    error(message: string, options?: Options): Promise<void>;
+    title(message: string, options?: Options): Promise<void>;
+    prepare(message: string, options?: Options): Promise<void>;
+    start(message: string, options?: Options): Promise<void>;
+    success(message: string, options?: Options): Promise<void>;
+    failure(message: string, options?: Options): Promise<void>;
+}
+
+export { CliSink, Journal, type JournalEntry, NoSink, type Sink, SupabaseSink };

package/dist/index.js

@@ -0,0 +1,318 @@
+import { statusSymbol } from '@letsrunit/utils';
+import { cursorUp, cursorLeft, eraseDown } from 'ansi-escapes';
+import { writeFile } from 'fs/promises';
+import YAML from 'yaml';
+
+// src/journal-batch.ts
+var JournalBatch = class {
+  constructor(sink) {
+    this.sink = sink;
+  }
+  entries = [];
+  log(message, options) {
+    if (message) {
+      this.entries.push({
+        timestamp: Date.now(),
+        message,
+        type: options.type,
+        artifacts: options.artifacts ?? [],
+        meta: options.meta ?? {}
+      });
+    }
+    return this;
+  }
+  async flush() {
+    await this.sink.publish(...this.entries);
+  }
+  debug(message, options = {}) {
+    return this.log(message, { ...options, type: "debug" });
+  }
+  info(message, options = {}) {
+    return this.log(message, { ...options, type: "info" });
+  }
+  title(message, options = {}) {
+    return this.log(message, { ...options, type: "title" });
+  }
+  warn(message, options = {}) {
+    return this.log(message, { ...options, type: "warn" });
+  }
+  error(message, options = {}) {
+    return this.log(message, { ...options, type: "error" });
+  }
+  prepare(message, options = {}) {
+    return this.log(message, { ...options, type: "prepare" });
+  }
+  success(message, options = {}) {
+    return this.log(message, { ...options, type: "success" });
+  }
+  failure(message, options = {}) {
+    return this.log(message, { ...options, type: "failure" });
+  }
+  each(items, fn) {
+    for (const item of items) {
+      fn(this, item);
+    }
+    return this;
+  }
+};
+function colorize(type, text) {
+  switch (type) {
+    case "debug":
+    case "prepare":
+      return `\x1B[90m${text}\x1B[0m`;
+    case "warn":
+      return `\x1B[33m${text}\x1B[0m`;
+    case "error":
+    case "failure":
+      return `\x1B[31m${text}\x1B[0m`;
+    case "success":
+      return `\x1B[32m${text}\x1B[0m`;
+    case "title":
+      return `\x1B[1m${text}\x1B[0m`;
+    case "info":
+    default:
+      return text;
+  }
+}
+var CliSink = class {
+  stream;
+  verbosity;
+  artifactPath;
+  writeFile;
+  entries = [];
+  constructor(options = {}) {
+    this.stream = options.stream ?? process.stdout;
+    this.verbosity = options.verbosity ?? 1;
+    this.artifactPath = options.artifactPath;
+    this.writeFile = options.writeFile ?? writeFile;
+  }
+  async publish(...entries) {
+    for (const entry of entries) {
+      if (entry.type === "debug" && this.verbosity < 2) continue;
+      if (entry.type !== "error" && this.verbosity < 1) continue;
+      if (entry.type === "title") this.endSection();
+      this.replace(entry) || this.append(entry);
+      await this.storeArtifacts(entry.artifacts);
+    }
+  }
+  endSection() {
+    this.entries = [];
+  }
+  replace(entry) {
+    if (entry.type !== "start" && entry.type !== "success" && entry.type !== "failure") return false;
+    const index = this.entries.findLastIndex(
+      (e) => e.message === entry.message && (e.type === "prepare" || e.type === "start" && entry.type !== "start")
+    );
+    if (index < 0) return false;
+    const oldTexts = this.entries.slice(index).map((e) => this.format(e));
+    const columns = this.stream.columns ?? 0;
+    const oldLength = oldTexts.reduce((total, current) => total + this.countDisplayLines(current, columns), 0);
+    this.entries[index] = entry;
+    const newTexts = this.entries.slice(index).map((e) => this.format(e));
+    this.stream.write(cursorUp(oldLength));
+    this.stream.write(cursorLeft);
+    this.stream.write(newTexts.join("\n") + "\n");
+    this.stream.write(eraseDown);
+    return true;
+  }
+  append(entry) {
+    this.entries.push(entry);
+    const text = this.format(entry);
+    this.stream.write(text + "\n");
+  }
+  format(entry) {
+    const lines = [];
+    const message = entry.message.trim();
+    if (["prepare", "start", "success", "failure"].includes(entry.type)) {
+      const prefix = colorize(entry.type, statusSymbol(entry.type));
+      lines.push(`${prefix} ${message}`);
+    } else {
+      lines.push(colorize(entry.type, message));
+    }
+    if (this.verbosity >= 3) {
+      if (entry.meta && Object.values(entry.meta).length && Object.keys(entry.meta).length) {
+        const yaml = YAML.stringify(entry.meta).trimEnd();
+        lines.push(colorize("debug", `[Meta]
+${yaml}`));
+      }
+    }
+    return lines.join("\n");
+  }
+  stripAnsi(input) {
+    const pattern = /[\u001B\u009B][[\]()#;?]*(?:((?:[a-zA-Z\d]*(?:;[a-zA-Z\d]*)*)?\u0007)|(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~])/g;
+    return input.replace(pattern, "");
+  }
+  countDisplayLines(text, columns) {
+    if (!columns || columns <= 0 || !Number.isFinite(columns)) {
+      return text.split("\n").length;
+    }
+    let count = 0;
+    const lines = text.split("\n");
+    for (const line of lines) {
+      const visible = this.stripAnsi(line);
+      const len = [...visible].length;
+      const wraps = Math.max(1, Math.ceil(len / columns));
+      count += wraps;
+    }
+    return count;
+  }
+  async storeArtifacts(artifacts) {
+    if (!this.artifactPath || artifacts.length === 0) return;
+    for (const artifact of artifacts) {
+      const data = await artifact.bytes();
+      await this.writeFile(`${this.artifactPath}/${artifact.name}`, data);
+    }
+  }
+};
+
+// src/sink/no-sink.ts
+var NoSink = class {
+  async publish() {
+  }
+};
+
+// src/sink/supabase-sink.ts
+var SupabaseSink = class {
+  supabase;
+  projectId;
+  runId;
+  tableName;
+  bucket;
+  console;
+  bucketEnsured = false;
+  constructor(options) {
+    this.supabase = options.supabase;
+    this.runId = options.run.id;
+    this.projectId = options.run.projectId;
+    this.tableName = options.tableName ?? "log_entries";
+    this.bucket = options.bucket;
+    this.console = options.console || console;
+  }
+  async publish(...entries) {
+    for (const entry of entries) {
+      const artifactList = await this.storeArtifacts(entry.artifacts);
+      const { error } = await this.supabase.from(this.tableName).insert({
+        run_id: this.runId,
+        type: entry.type,
+        message: entry.message,
+        meta: entry.meta ?? {},
+        artifacts: artifactList,
+        created_at: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      if (error) {
+        this.console.error("SupabaseSink insert failed:", error);
+      }
+    }
+  }
+  async ensureBucket() {
+    if (!this.bucket || this.bucketEnsured) return;
+    try {
+      await this.supabase.storage?.createBucket?.(this.bucket, { public: true });
+      this.bucketEnsured = true;
+    } catch (error) {
+      this.console.warn(error);
+    }
+  }
+  async storeArtifacts(artifacts) {
+    if (!this.bucket || artifacts.length === 0) return [];
+    await this.ensureBucket();
+    const stored = [];
+    const uniqueArtifacts = artifacts.filter(
+      (artifact, index, self) => index === self.findIndex((a) => a.name === artifact.name)
+    );
+    for (const artifact of uniqueArtifacts) {
+      try {
+        const path = `${this.projectId}/${artifact.name}`;
+        const { data } = this.supabase.storage.from(this.bucket).getPublicUrl(path);
+        const publicUrl = data.publicUrl;
+        const exists = await this.artifactExists(publicUrl);
+        if (!exists) {
+          const { error } = await this.supabase.storage.from(this.bucket).upload(path, await artifact.bytes(), { contentType: artifact.type, upsert: true });
+          if (error) throw error;
+        }
+        stored.push({
+          name: artifact.name,
+          url: publicUrl,
+          size: artifact.size
+        });
+      } catch (error) {
+        this.console.warn("SupabaseSink upload failed:", error);
+      }
+    }
+    return stored;
+  }
+  async artifactExists(url) {
+    try {
+      const response = await fetch(url, { method: "HEAD" });
+      return response.ok;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/journal.ts
+var Journal = class _Journal {
+  constructor(sink) {
+    this.sink = sink;
+  }
+  static nil() {
+    return new _Journal(new NoSink());
+  }
+  async log(message, options) {
+    const entry = {
+      timestamp: Date.now(),
+      message,
+      type: options.type,
+      artifacts: options.artifacts ?? [],
+      meta: options.meta ?? {}
+    };
+    await this.sink.publish(entry);
+  }
+  batch() {
+    return new JournalBatch(this.sink);
+  }
+  async do(message, callback, metaFn) {
+    try {
+      await this.start(message);
+      const result = await callback();
+      const { meta, artifacts } = metaFn?.(result) ?? {};
+      await this.success(message, { meta, artifacts });
+      return result;
+    } catch (e) {
+      await this.failure(message);
+      throw e;
+    }
+  }
+  async debug(message, options = {}) {
+    await this.log(message, { ...options, type: "debug" });
+  }
+  async info(message, options = {}) {
+    await this.log(message, { ...options, type: "info" });
+  }
+  async warn(message, options = {}) {
+    await this.log(message, { ...options, type: "warn" });
+  }
+  async error(message, options = {}) {
+    await this.log(message, { ...options, type: "error" });
+  }
+  async title(message, options = {}) {
+    await this.log(message, { ...options, type: "title" });
+  }
+  async prepare(message, options = {}) {
+    await this.log(message, { ...options, type: "prepare" });
+  }
+  async start(message, options = {}) {
+    await this.log(message, { ...options, type: "start" });
+  }
+  async success(message, options = {}) {
+    await this.log(message, { ...options, type: "success" });
+  }
+  async failure(message, options = {}) {
+    await this.log(message, { ...options, type: "failure" });
+  }
+};
+
+export { CliSink, Journal, NoSink, SupabaseSink };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/journal-batch.ts","../src/sink/cli-sink.ts","../src/sink/no-sink.ts","../src/sink/supabase-sink.ts","../src/journal.ts"],"names":[],"mappings":";;;;;;AAIO,IAAM,eAAN,MAAmB;AAAA,EAGxB,YAAoB,IAAA,EAAY;AAAZ,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAa;AAAA,EAFzB,UAA0B,EAAC;AAAA,EAInC,GAAA,CAAI,SAA6B,OAAA,EAAiE;AAChG,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,IAAA,CAAK,QAAQ,IAAA,CAAK;AAAA,QAChB,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,QACpB,OAAA;AAAA,QACA,MAAM,OAAA,CAAQ,IAAA;AAAA,QACd,SAAA,EAAW,OAAA,CAAQ,SAAA,IAAa,EAAC;AAAA,QACjC,IAAA,EAAM,OAAA,CAAQ,IAAA,IAAQ;AAAC,OACxB,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,MAAM,KAAA,GAAQ;AACZ,IAAA,MAAM,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,GAAG,KAAK,OAAO,CAAA;AAAA,EACzC;AAAA,EAEA,KAAA,CAAM,OAAA,EAA6B,OAAA,GAAmB,EAAC,EAAiB;AACtE,IAAA,OAAO,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAAA,EACxD;AAAA,EAEA,IAAA,CAAK,OAAA,EAA6B,OAAA,GAAmB,EAAC,EAAiB;AACrE,IAAA,OAAO,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,QAAQ,CAAA;AAAA,EACvD;AAAA,EAEA,KAAA,CAAM,OAAA,EAA6B,OAAA,GAAmB,EAAC,EAAiB;AACtE,IAAA,OAAO,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAAA,EACxD;AAAA,EAEA,IAAA,CAAK,OAAA,EAA6B,OAAA,GAAmB,EAAC,EAAiB;AACrE,IAAA,OAAO,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,QAAQ,CAAA;AAAA,EACvD;AAAA,EAEA,KAAA,CAAM,OAAA,EAA6B,OAAA,GAAmB,EAAC,EAAiB;AACtE,IAAA,OAAO,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAAA,EACxD;AAAA,EAEA,OAAA,CAAQ,OAAA,EAA6B,OAAA,GAAmB,EAAC,EAAiB;AACxE,IAAA,OAAO,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,WAAW,CAAA;AAAA,EAC1D;AAAA,EAEA,OAAA,CAAQ,OAAA,EAA6B,OAAA,GAAmB,EAAC,EAAiB;AACxE,IAAA,OAAO,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,WAAW,CAAA;AAAA,EAC1D;AAAA,EAEA,OAAA,CAAQ,OAAA,EAA6B,OAAA,GAAmB,EAAC,EAAiB;AACxE,IAAA,OAAO,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,WAAW,CAAA;AAAA,EAC1D;AAAA,EAEA,IAAA,CAAQ,OAAiB,EAAA,EAA4D;AACnF,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,EAAA,CAAG,MAAM,IAAI,CAAA;AAAA,IACf;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AACF,CAAA;ACnDA,SAAS,QAAA,CAAS,MAA4B,IAAA,EAAsB;AAElE,EAAA,QAAQ,IAAA;AAAM,IACZ,KAAK,OAAA;AAAA,IACL,KAAK,SAAA;AACH,MAAA,OAAO,WAAW,IAAI,CAAA,OAAA,CAAA;AAAA,IACxB,KAAK,MAAA;AACH,MAAA,OAAO,WAAW,IAAI,CAAA,OAAA,CAAA;AAAA,IACxB,KAAK,OAAA;AAAA,IACL,KAAK,SAAA;AACH,MAAA,OAAO,WAAW,IAAI,CAAA,OAAA,CAAA;AAAA,IACxB,KAAK,SAAA;AACH,MAAA,OAAO,WAAW,IAAI,CAAA,OAAA,CAAA;AAAA,IACxB,KAAK,OAAA;AACH,MAAA,OAAO,UAAU,IAAI,CAAA,OAAA,CAAA;AAAA,IACvB,KAAK,MAAA;AAAA,IACL;AACE,MAAA,OAAO,IAAA;AAAA;AAEb;AAEO,IAAM,UAAN,MAA8B;AAAA,EACnB,MAAA;AAAA,EACA,SAAA;AAAA,EACA,YAAA;AAAA,EACC,SAAA;AAAA,EAET,UAA0B,EAAC;AAAA,EAEnC,WAAA,CAAY,OAAA,GAA0B,EAAC,EAAG;AACxC,IAAA,IAAA,CAAK,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,OAAA,CAAQ,MAAA;AACxC,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,CAAA;AACtC,IAAA,IAAA,CAAK,eAAe,OAAA,CAAQ,YAAA;AAC5B,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,SAAA;AAAA,EACxC;AAAA,EAEA,MAAM,WAAW,OAAA,EAAwC;AACvD,IAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,MAAA,IAAI,KAAA,CAAM,IAAA,KAAS,OAAA,IAAW,IAAA,CAAK,YAAY,CAAA,EAAG;AAClD,MAAA,IAAI,KAAA,CAAM,IAAA,KAAS,OAAA,IAAW,IAAA,CAAK,YAAY,CAAA,EAAG;AAElD,MAAA,IAAI,KAAA,CAAM,IAAA,KAAS,OAAA,EAAS,IAAA,CAAK,UAAA,EAAW;AAE5C,MAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAA,IAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AAExC,MAAA,MAAM,IAAA,CAAK,cAAA,CAAe,KAAA,CAAM,SAAS,CAAA;AAAA,IAC3C;AAAA,EACF;AAAA,EAEA,UAAA,GAAa;AACX,IAAA,IAAA,CAAK,UAAU,EAAC;AAAA,EAClB;AAAA,EAEQ,QAAQ,KAAA,EAA8B;AAC5C,IAAA,IAAI,KAAA,CAAM,SAAS,OAAA,IAAW,KAAA,CAAM,SAAS,SAAA,IAAa,KAAA,CAAM,IAAA,KAAS,SAAA,EAAW,OAAO,KAAA;AAE3F,IAAA,MAAM,KAAA,GAAQ,KAAK,OAAA,CAAQ,aAAA;AAAA,MACzB,CAAC,CAAA,KAAM,CAAA,CAAE,OAAA,KAAY,KAAA,CAAM,OAAA,KACxB,CAAA,CAAE,IAAA,KAAS,SAAA,IAAc,CAAA,CAAE,IAAA,KAAS,OAAA,IAAW,MAAM,IAAA,KAAS,OAAA;AAAA,KACnE;AACA,IAAA,IAAI,KAAA,GAAQ,GAAG,OAAO,KAAA;AAEtB,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,KAAK,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,KAAM,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AACpE,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,MAAA,CAAO,OAAA,IAAW,CAAA;AACvC,IAAA,MAAM,SAAA,GAAY,QAAA,CAAS,MAAA,CAAO,CAAC,KAAA,EAAO,OAAA,KAAY,KAAA,GAAQ,IAAA,CAAK,iBAAA,CAAkB,OAAA,EAAS,OAAO,CAAA,EAAG,CAAC,CAAA;AAEzG,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA;AACtB,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,KAAK,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,KAAM,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AAEpE,IAAA,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,QAAA,CAAS,SAAS,CAAC,CAAA;AACrC,IAAA,IAAA,CAAK,MAAA,CAAO,MAAM,UAAU,CAAA;AAC5B,IAAA,IAAA,CAAK,OAAO,KAAA,CAAM,QAAA,CAAS,IAAA,CAAK,IAAI,IAAI,IAAI,CAAA;AAC5C,IAAA,IAAA,CAAK,MAAA,CAAO,MAAM,SAAS,CAAA;AAE3B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEQ,OAAO,KAAA,EAA2B;AACxC,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,KAAK,CAAA;AAEvB,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AAC9B,IAAA,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,IAAA,GAAO,IAAI,CAAA;AAAA,EAC/B;AAAA,EAEQ,OAAO,KAAA,EAA6B;AAC1C,IAAA,MAAM,QAAQ,EAAC;AAEf,IAAA,MAAM,OAAA,GAAU,KAAA,CAAM,OAAA,CAAQ,IAAA,EAAK;AAEnC,IAAA,IAAI,CAAC,WAAW,OAAA,EAAS,SAAA,EAAW,SAAS,CAAA,CAAE,QAAA,CAAS,KAAA,CAAM,IAAI,CAAA,EAAG;AACnE,MAAA,MAAM,SAAS,QAAA,CAAS,KAAA,CAAM,MAAM,YAAA,CAAa,KAAA,CAAM,IAAI,CAAC,CAAA;AAC5D,MAAA,KAAA,CAAM,IAAA,CAAK,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,CAAA;AAAA,IACnC,CAAA,MAAO;AACL,MAAA,KAAA,CAAM,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,IAAA,EAAM,OAAO,CAAC,CAAA;AAAA,IAC1C;AAEA,IAAA,IAAI,IAAA,CAAK,aAAa,CAAA,EAAG;AACvB,MAAA,IAAI,KAAA,CAAM,IAAA,IAAQ,MAAA,CAAO,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA,CAAE,MAAA,IAAU,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,IAAI,EAAE,MAAA,EAAQ;AACpF,QAAA,MAAM,OAAO,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,IAAI,EAAE,OAAA,EAAQ;AAChD,QAAA,KAAA,CAAM,IAAA,CAAK,SAAS,OAAA,EAAS,CAAA;AAAA,EAAW,IAAI,EAAE,CAAC,CAAA;AAAA,MACjD;AAAA,IACF;AAEA,IAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AAAA,EACxB;AAAA,EAEQ,UAAU,KAAA,EAAuB;AAEvC,IAAA,MAAM,OAAA,GAAU,0HAAA;AAChB,IAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,OAAA,EAAS,EAAE,CAAA;AAAA,EAClC;AAAA,EAEQ,iBAAA,CAAkB,MAAc,OAAA,EAAyB;AAE/D,IAAA,IAAI,CAAC,WAAW,OAAA,IAAW,CAAA,IAAK,CAAC,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,EAAG;AACzD,MAAA,OAAO,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA,CAAE,MAAA;AAAA,IAC1B;AAEA,IAAA,IAAI,KAAA,GAAQ,CAAA;AACZ,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AAC7B,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA;AACnC,MAAA,MAAM,GAAA,GAAM,CAAC,GAAG,OAAO,CAAA,CAAE,MAAA;AACzB,MAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,IAAA,CAAK,GAAA,GAAM,OAAO,CAAC,CAAA;AAClD,MAAA,KAAA,IAAS,KAAA;AAAA,IACX;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,MAAc,eAAe,SAAA,EAAmB;AAC9C,IAAA,IAAI,CAAC,IAAA,CAAK,YAAA,IAAgB,SAAA,CAAU,WAAW,CAAA,EAAG;AAElD,IAAA,KAAA,MAAW,YAAY,SAAA,EAAW;AAChC,MAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,KAAA,EAAM;AAClC,MAAA,MAAM,IAAA,CAAK,UAAU,CAAA,EAAG,IAAA,CAAK,YAAY,CAAA,CAAA,EAAI,QAAA,CAAS,IAAI,CAAA,CAAA,EAAI,IAAI,CAAA;AAAA,IACpE;AAAA,EACF;AACF;;;ACrJO,IAAM,SAAN,MAA6B;AAAA,EAClC,MAAM,OAAA,GAAyB;AAAA,EAAC;AAClC;;;ACMO,IAAM,eAAN,MAAmC;AAAA,EACvB,QAAA;AAAA,EACA,SAAA;AAAA,EACA,KAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,OAAA;AAAA,EACT,aAAA,GAAgB,KAAA;AAAA,EAExB,YAAY,OAAA,EAA8B;AACxC,IAAA,IAAA,CAAK,WAAW,OAAA,CAAQ,QAAA;AACxB,IAAA,IAAA,CAAK,KAAA,GAAQ,QAAQ,GAAA,CAAI,EAAA;AACzB,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,GAAA,CAAI,SAAA;AAC7B,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,aAAA;AACtC,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,OAAA,GAAU,QAAQ,OAAA,IAAW,OAAA;AAAA,EACpC;AAAA,EAEA,MAAM,WAAW,OAAA,EAAwC;AACvD,IAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,MAAA,MAAM,YAAA,GAAe,MAAM,IAAA,CAAK,cAAA,CAAe,MAAM,SAAS,CAAA;AAE9D,MAAA,MAAM,EAAE,KAAA,EAAM,GAAI,MAAM,IAAA,CAAK,SAAS,IAAA,CAAK,IAAA,CAAK,SAAS,CAAA,CAAE,MAAA,CAAO;AAAA,QAChE,QAAQ,IAAA,CAAK,KAAA;AAAA,QACb,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,SAAS,KAAA,CAAM,OAAA;AAAA,QACf,IAAA,EAAM,KAAA,CAAM,IAAA,IAAQ,EAAC;AAAA,QACrB,SAAA,EAAW,YAAA;AAAA,QACX,UAAA,EAAA,iBAAY,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,OACpC,CAAA;AAED,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,6BAAA,EAA+B,KAAK,CAAA;AAAA,MACzD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,YAAA,GAAe;AAC3B,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,IAAU,IAAA,CAAK,aAAA,EAAe;AAExC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,SAAS,OAAA,EAAS,YAAA,GAAe,KAAK,MAAA,EAAQ,EAAE,MAAA,EAAQ,IAAA,EAAM,CAAA;AACzE,MAAA,IAAA,CAAK,aAAA,GAAgB,IAAA;AAAA,IACvB,SAAS,KAAA,EAAO;AACd,MAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,KAAK,CAAA;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,MAAc,eAAe,SAAA,EAAmC;AAC9D,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,IAAU,UAAU,MAAA,KAAW,CAAA,SAAU,EAAC;AAEpD,IAAA,MAAM,KAAK,YAAA,EAAa;AAExB,IAAA,MAAM,SAAgB,EAAC;AAEvB,IAAA,MAAM,kBAAkB,SAAA,CAAU,MAAA;AAAA,MAChC,CAAC,QAAA,EAAU,KAAA,EAAO,IAAA,KAAS,KAAA,KAAU,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,KAAS,QAAA,CAAS,IAAI;AAAA,KACrF;AAEA,IAAA,KAAA,MAAW,YAAY,eAAA,EAAiB;AACtC,MAAA,IAAI;AACF,QAAA,MAAM,OAAO,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA,CAAA,EAAI,SAAS,IAAI,CAAA,CAAA;AAC/C,QAAA,MAAM,EAAE,IAAA,EAAK,GAAI,IAAA,CAAK,QAAA,CAAS,OAAA,CAAQ,IAAA,CAAK,IAAA,CAAK,MAAM,CAAA,CAAE,YAAA,CAAa,IAAI,CAAA;AAC1E,QAAA,MAAM,YAAY,IAAA,CAAK,SAAA;AAEvB,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,cAAA,CAAe,SAAS,CAAA;AAElD,QAAA,IAAI,CAAC,MAAA,EAAQ;AACX,UAAA,MAAM,EAAE,OAAM,GAAI,MAAM,KAAK,QAAA,CAAS,OAAA,CACnC,IAAA,CAAK,IAAA,CAAK,MAAM,CAAA,CAChB,OAAO,IAAA,EAAM,MAAM,QAAA,CAAS,KAAA,EAAM,EAAG,EAAE,aAAa,QAAA,CAAS,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAM,CAAA;AACpF,UAAA,IAAI,OAAO,MAAM,KAAA;AAAA,QACnB;AAEA,QAAA,MAAA,CAAO,IAAA,CAAK;AAAA,UACV,MAAM,QAAA,CAAS,IAAA;AAAA,UACf,GAAA,EAAK,SAAA;AAAA,UACL,MAAM,QAAA,CAAS;AAAA,SAChB,CAAA;AAAA,MACH,SAAS,KAAA,EAAO;AACd,QAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,6BAAA,EAA+B,KAAK,CAAA;AAAA,MACxD;AAAA,IACF;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEA,MAAc,eAAe,GAAA,EAA+B;AAC1D,IAAA,IAAI;AACF,MAAA,MAAM,WAAW,MAAM,KAAA,CAAM,KAAK,EAAE,MAAA,EAAQ,QAAQ,CAAA;AACpD,MAAA,OAAO,QAAA,CAAS,EAAA;AAAA,IAClB,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AACF;;;ACpGO,IAAM,OAAA,GAAN,MAAM,QAAA,CAAmC;AAAA,EAC9C,YAAqB,IAAA,EAAa;AAAb,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAc;AAAA,EAEnC,OAAO,GAAA,GAAM;AACX,IAAA,OAAO,IAAI,QAAA,CAAQ,IAAI,MAAA,EAAQ,CAAA;AAAA,EACjC;AAAA,EAEA,MAAM,GAAA,CAAI,OAAA,EAAiB,OAAA,EAAkE;AAC3F,IAAA,MAAM,KAAA,GAAsB;AAAA,MAC1B,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,MACpB,OAAA;AAAA,MACA,MAAM,OAAA,CAAQ,IAAA;AAAA,MACd,SAAA,EAAW,OAAA,CAAQ,SAAA,IAAa,EAAC;AAAA,MACjC,IAAA,EAAM,OAAA,CAAQ,IAAA,IAAQ;AAAC,KACzB;AAEA,IAAA,MAAM,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAA;AAAA,EAC/B;AAAA,EAEA,KAAA,GAAQ;AACN,IAAA,OAAO,IAAI,YAAA,CAAa,IAAA,CAAK,IAAI,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,EAAA,CACJ,OAAA,EACA,QAAA,EACA,MAAA,EACY;AACZ,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,MAAM,OAAO,CAAA;AAExB,MAAA,MAAM,MAAA,GAAS,MAAM,QAAA,EAAS;AAE9B,MAAA,MAAM,EAAE,IAAA,EAAM,SAAA,KAAc,MAAA,GAAS,MAAM,KAAK,EAAC;AACjD,MAAA,MAAM,KAAK,OAAA,CAAQ,OAAA,EAAS,EAAE,IAAA,EAAM,WAAW,CAAA;AAE/C,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,CAAA,EAAG;AACV,MAAA,MAAM,IAAA,CAAK,QAAQ,OAAO,CAAA;AAC1B,MAAA,MAAM,CAAA;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAM,KAAA,CAAM,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AACjE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAAA,EACvD;AAAA,EAEA,MAAM,IAAA,CAAK,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AAChE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,QAAQ,CAAA;AAAA,EACtD;AAAA,EAEA,MAAM,IAAA,CAAK,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AAChE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,QAAQ,CAAA;AAAA,EACtD;AAAA,EAEA,MAAM,KAAA,CAAM,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AACjE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAAA,EACvD;AAAA,EAEA,MAAM,KAAA,CAAM,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AACjE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAAA,EACvD;AAAA,EAEA,MAAM,OAAA,CAAQ,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AACnE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,WAAW,CAAA;AAAA,EACzD;AAAA,EAEA,MAAM,KAAA,CAAM,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AACjE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,SAAS,CAAA;AAAA,EACvD;AAAA,EAEA,MAAM,OAAA,CAAQ,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AACnE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,WAAW,CAAA;AAAA,EACzD;AAAA,EAEA,MAAM,OAAA,CAAQ,OAAA,EAAiB,OAAA,GAAmB,EAAC,EAAkB;AACnE,IAAA,MAAM,IAAA,CAAK,IAAI,OAAA,EAAS,EAAE,GAAG,OAAA,EAAS,IAAA,EAAM,WAAW,CAAA;AAAA,EACzD;AACF","file":"index.js","sourcesContent":["import type { Sink, JournalEntry } from './types';\n\ntype Options = Partial<Pick<JournalEntry, 'artifacts' | 'meta'>>;\n\nexport class JournalBatch {\n  private entries: JournalEntry[] = [];\n\n  constructor(private sink: Sink) {}\n\n  log(message: string | undefined, options: Options & { type: JournalEntry['type'] }): JournalBatch {\n    if (message) {\n      this.entries.push({\n        timestamp: Date.now(),\n        message,\n        type: options.type,\n        artifacts: options.artifacts ?? [],\n        meta: options.meta ?? {},\n      });\n    }\n\n    return this;\n  }\n\n  async flush() {\n    await this.sink.publish(...this.entries);\n  }\n\n  debug(message: string | undefined, options: Options = {}): JournalBatch {\n    return this.log(message, { ...options, type: 'debug' });\n  }\n\n  info(message: string | undefined, options: Options = {}): JournalBatch {\n    return this.log(message, { ...options, type: 'info' });\n  }\n\n  title(message: string | undefined, options: Options = {}): JournalBatch {\n    return this.log(message, { ...options, type: 'title' });\n  }\n\n  warn(message: string | undefined, options: Options = {}): JournalBatch {\n    return this.log(message, { ...options, type: 'warn' });\n  }\n\n  error(message: string | undefined, options: Options = {}): JournalBatch {\n    return this.log(message, { ...options, type: 'error' });\n  }\n\n  prepare(message: string | undefined, options: Options = {}): JournalBatch {\n    return this.log(message, { ...options, type: 'prepare' });\n  }\n\n  success(message: string | undefined, options: Options = {}): JournalBatch {\n    return this.log(message, { ...options, type: 'success' });\n  }\n\n  failure(message: string | undefined, options: Options = {}): JournalBatch {\n    return this.log(message, { ...options, type: 'failure' });\n  }\n\n  each<T>(items: Array<T>, fn: (journal: JournalBatch, item: T) => void): JournalBatch {\n    for (const item of items) {\n      fn(this, item);\n    }\n\n    return this;\n  }\n}\n","import { statusSymbol } from '@letsrunit/utils';\nimport { cursorLeft, cursorUp, eraseDown } from 'ansi-escapes';\nimport { writeFile } from 'node:fs/promises';\nimport YAML from 'yaml';\nimport type { JournalEntry, Sink } from '../types';\n\ntype WriteFile = typeof writeFile;\n\ninterface CliSinkOptions {\n  stream?: NodeJS.WriteStream;\n  verbosity?: number;\n  artifactPath?: string;\n  writeFile?: WriteFile;\n}\n\nfunction colorize(type: JournalEntry['type'], text: string): string {\n  // ANSI escape codes: debug=bright black (gray), warn=yellow, error=red, info=no color\n  switch (type) {\n    case 'debug':\n    case 'prepare':\n      return `\\x1b[90m${text}\\x1b[0m`;\n    case 'warn':\n      return `\\x1b[33m${text}\\x1b[0m`;\n    case 'error':\n    case 'failure':\n      return `\\x1b[31m${text}\\x1b[0m`;\n    case 'success':\n      return `\\x1b[32m${text}\\x1b[0m`;\n    case 'title':\n      return `\\x1b[1m${text}\\x1b[0m`;\n    case 'info':\n    default:\n      return text;\n  }\n}\n\nexport class CliSink implements Sink {\n  public readonly stream: NodeJS.WriteStream;\n  public readonly verbosity: number;\n  public readonly artifactPath: string | undefined;\n  private readonly writeFile: WriteFile;\n\n  private entries: JournalEntry[] = [];\n\n  constructor(options: CliSinkOptions = {}) {\n    this.stream = options.stream ?? process.stdout;\n    this.verbosity = options.verbosity ?? 1;\n    this.artifactPath = options.artifactPath;\n    this.writeFile = options.writeFile ?? writeFile;\n  }\n\n  async publish(...entries: JournalEntry[]): Promise<void> {\n    for (const entry of entries) {\n      if (entry.type === 'debug' && this.verbosity < 2) continue;\n      if (entry.type !== 'error' && this.verbosity < 1) continue;\n\n      if (entry.type === 'title') this.endSection();\n\n      this.replace(entry) || this.append(entry);\n\n      await this.storeArtifacts(entry.artifacts);\n    }\n  }\n\n  endSection() {\n    this.entries = [];\n  }\n\n  private replace(entry: JournalEntry): boolean {\n    if (entry.type !== 'start' && entry.type !== 'success' && entry.type !== 'failure') return false;\n\n    const index = this.entries.findLastIndex(\n      (e) => e.message === entry.message &&\n        (e.type === 'prepare' || (e.type === 'start' && entry.type !== 'start'))\n    );\n    if (index < 0) return false;\n\n    const oldTexts = this.entries.slice(index).map((e) => this.format(e));\n    const columns = this.stream.columns ?? 0;\n    const oldLength = oldTexts.reduce((total, current) => total + this.countDisplayLines(current, columns), 0);\n\n    this.entries[index] = entry;\n    const newTexts = this.entries.slice(index).map((e) => this.format(e));\n\n    this.stream.write(cursorUp(oldLength));\n    this.stream.write(cursorLeft);\n    this.stream.write(newTexts.join('\\n') + '\\n');\n    this.stream.write(eraseDown);\n\n    return true;\n  }\n\n  private append(entry: JournalEntry): void {\n    this.entries.push(entry);\n\n    const text = this.format(entry);\n    this.stream.write(text + '\\n');\n  }\n\n  private format(entry: JournalEntry): string {\n    const lines = [];\n\n    const message = entry.message.trim();\n\n    if (['prepare', 'start', 'success', 'failure'].includes(entry.type)) {\n      const prefix = colorize(entry.type, statusSymbol(entry.type));\n      lines.push(`${prefix} ${message}`);\n    } else {\n      lines.push(colorize(entry.type, message));\n    }\n\n    if (this.verbosity >= 3) {\n      if (entry.meta && Object.values(entry.meta).length && Object.keys(entry.meta).length) {\n        const yaml = YAML.stringify(entry.meta).trimEnd();\n        lines.push(colorize('debug', `[Meta]\\n${yaml}`));\n      }\n    }\n\n    return lines.join('\\n');\n  }\n\n  private stripAnsi(input: string): string {\n    // Regex from chalk/strip-ansi to remove ANSI escape sequences\n    const pattern = /[\\u001B\\u009B][[\\]()#;?]*(?:((?:[a-zA-Z\\d]*(?:;[a-zA-Z\\d]*)*)?\\u0007)|(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~])/g;\n    return input.replace(pattern, '');\n  }\n\n  private countDisplayLines(text: string, columns: number): number {\n    // If columns is not available (non-TTY), fall back to newline-based counting\n    if (!columns || columns <= 0 || !Number.isFinite(columns)) {\n      return text.split('\\n').length;\n    }\n\n    let count = 0;\n    const lines = text.split('\\n');\n    for (const line of lines) {\n      const visible = this.stripAnsi(line);\n      const len = [...visible].length; // handles surrogate pairs reasonably\n      const wraps = Math.max(1, Math.ceil(len / columns));\n      count += wraps;\n    }\n    return count;\n  }\n\n  private async storeArtifacts(artifacts: File[]) {\n    if (!this.artifactPath || artifacts.length === 0) return;\n\n    for (const artifact of artifacts) {\n      const data = await artifact.bytes();\n      await this.writeFile(`${this.artifactPath}/${artifact.name}`, data);\n    }\n  }\n}\n","import type { Sink } from '../types';\n\n/* v8 ignore start */\nexport class NoSink implements Sink {\n  async publish(): Promise<void> {}\n}\n","import { SupabaseClient } from '@supabase/supabase-js';\nimport type { JournalEntry, Sink } from '../types';\n\ninterface SupabaseSinkOptions {\n  supabase: SupabaseClient;\n  run: { id: string; projectId: string };\n  tableName?: string;\n  bucket?: string;\n  console?: { error: (...args: any[]) => void; warn: (...args: any[]) => void };\n}\n\nexport class SupabaseSink implements Sink {\n  private readonly supabase: SupabaseClient;\n  private readonly projectId: string;\n  private readonly runId: string;\n  private readonly tableName: string;\n  private readonly bucket?: string;\n  private readonly console: { error: (...args: any[]) => void; warn: (...args: any[]) => void };\n  private bucketEnsured = false;\n\n  constructor(options: SupabaseSinkOptions) {\n    this.supabase = options.supabase;\n    this.runId = options.run.id;\n    this.projectId = options.run.projectId;\n    this.tableName = options.tableName ?? 'log_entries';\n    this.bucket = options.bucket;\n    this.console = options.console || console;\n  }\n\n  async publish(...entries: JournalEntry[]): Promise<void> {\n    for (const entry of entries) {\n      const artifactList = await this.storeArtifacts(entry.artifacts);\n\n      const { error } = await this.supabase.from(this.tableName).insert({\n        run_id: this.runId,\n        type: entry.type,\n        message: entry.message,\n        meta: entry.meta ?? {},\n        artifacts: artifactList,\n        created_at: new Date().toISOString(),\n      });\n\n      if (error) {\n        this.console.error('SupabaseSink insert failed:', error);\n      }\n    }\n  }\n\n  private async ensureBucket() {\n    if (!this.bucket || this.bucketEnsured) return;\n\n    try {\n      await this.supabase.storage?.createBucket?.(this.bucket, { public: true });\n      this.bucketEnsured = true;\n    } catch (error) {\n      this.console.warn(error);\n    }\n  }\n\n  private async storeArtifacts(artifacts: File[]): Promise<any[]> {\n    if (!this.bucket || artifacts.length === 0) return [];\n\n    await this.ensureBucket();\n\n    const stored: any[] = [];\n\n    const uniqueArtifacts = artifacts.filter(\n      (artifact, index, self) => index === self.findIndex((a) => a.name === artifact.name),\n    );\n\n    for (const artifact of uniqueArtifacts) {\n      try {\n        const path = `${this.projectId}/${artifact.name}`;\n        const { data } = this.supabase.storage.from(this.bucket).getPublicUrl(path);\n        const publicUrl = data.publicUrl;\n\n        const exists = await this.artifactExists(publicUrl);\n\n        if (!exists) {\n          const { error } = await this.supabase.storage\n            .from(this.bucket)\n            .upload(path, await artifact.bytes(), { contentType: artifact.type, upsert: true });\n          if (error) throw error;\n        }\n\n        stored.push({\n          name: artifact.name,\n          url: publicUrl,\n          size: artifact.size,\n        });\n      } catch (error) {\n        this.console.warn('SupabaseSink upload failed:', error);\n      }\n    }\n\n    return stored;\n  }\n\n  private async artifactExists(url: string): Promise<boolean> {\n    try {\n      const response = await fetch(url, { method: 'HEAD' });\n      return response.ok;\n    } catch {\n      return false;\n    }\n  }\n}\n","import { JournalBatch } from './journal-batch';\nimport { NoSink } from './sink';\nimport type { JournalEntry, Sink } from './types';\n\ntype Options = Partial<Pick<JournalEntry, 'artifacts' | 'meta'>>;\n\nexport class Journal<TSink extends Sink = Sink> {\n  constructor(readonly sink: TSink) {}\n\n  static nil() {\n    return new Journal(new NoSink());\n  }\n\n  async log(message: string, options: Options & { type: JournalEntry['type'] }): Promise<void> {\n    const entry: JournalEntry = {\n      timestamp: Date.now(),\n      message,\n      type: options.type,\n      artifacts: options.artifacts ?? [],\n      meta: options.meta ?? {},\n    };\n\n    await this.sink.publish(entry);\n  }\n\n  batch() {\n    return new JournalBatch(this.sink);\n  }\n\n  async do<T>(\n    message: string,\n    callback: () => T | Promise<T>,\n    metaFn?: (result: T) => { meta?: Record<string, any>; artifacts?: File[] },\n  ): Promise<T> {\n    try {\n      await this.start(message);\n\n      const result = await callback();\n\n      const { meta, artifacts } = metaFn?.(result) ?? {};\n      await this.success(message, { meta, artifacts });\n\n      return result;\n    } catch (e) {\n      await this.failure(message);\n      throw e;\n    }\n  }\n\n  async debug(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'debug' });\n  }\n\n  async info(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'info' });\n  }\n\n  async warn(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'warn' });\n  }\n\n  async error(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'error' });\n  }\n\n  async title(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'title' });\n  }\n\n  async prepare(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'prepare' });\n  }\n\n  async start(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'start' });\n  }\n\n  async success(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'success' });\n  }\n\n  async failure(message: string, options: Options = {}): Promise<void> {\n    await this.log(message, { ...options, type: 'failure' });\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@letsrunit/journal",
+  "version": "0.1.0",
+  "description": "Logging and journaling system for letsrunit",
+  "keywords": [
+    "testing",
+    "logging",
+    "journal",
+    "letsrunit"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/letsrunit/letsrunit.git",
+    "directory": "packages/journal"
+  },
+  "bugs": "https://github.com/letsrunit/letsrunit/issues",
+  "homepage": "https://github.com/letsrunit/letsrunit#readme",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "../../node_modules/.bin/tsup",
+    "test": "vitest run",
+    "test:cov": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "packageManager": "yarn@4.10.3",
+  "dependencies": {
+    "@letsrunit/utils": "workspace:*",
+    "@supabase/supabase-js": "^2.91.0",
+    "ansi-escapes": "^7.2.0",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@vitest/coverage-v8": "4.0.17",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './journal';
+export * from './sink';
+export * from './types';

package/src/journal-batch.ts

@@ -0,0 +1,67 @@
+import type { Sink, JournalEntry } from './types';
+
+type Options = Partial<Pick<JournalEntry, 'artifacts' | 'meta'>>;
+
+export class JournalBatch {
+  private entries: JournalEntry[] = [];
+
+  constructor(private sink: Sink) {}
+
+  log(message: string | undefined, options: Options & { type: JournalEntry['type'] }): JournalBatch {
+    if (message) {
+      this.entries.push({
+        timestamp: Date.now(),
+        message,
+        type: options.type,
+        artifacts: options.artifacts ?? [],
+        meta: options.meta ?? {},
+      });
+    }
+
+    return this;
+  }
+
+  async flush() {
+    await this.sink.publish(...this.entries);
+  }
+
+  debug(message: string | undefined, options: Options = {}): JournalBatch {
+    return this.log(message, { ...options, type: 'debug' });
+  }
+
+  info(message: string | undefined, options: Options = {}): JournalBatch {
+    return this.log(message, { ...options, type: 'info' });
+  }
+
+  title(message: string | undefined, options: Options = {}): JournalBatch {
+    return this.log(message, { ...options, type: 'title' });
+  }
+
+  warn(message: string | undefined, options: Options = {}): JournalBatch {
+    return this.log(message, { ...options, type: 'warn' });
+  }
+
+  error(message: string | undefined, options: Options = {}): JournalBatch {
+    return this.log(message, { ...options, type: 'error' });
+  }
+
+  prepare(message: string | undefined, options: Options = {}): JournalBatch {
+    return this.log(message, { ...options, type: 'prepare' });
+  }
+
+  success(message: string | undefined, options: Options = {}): JournalBatch {
+    return this.log(message, { ...options, type: 'success' });
+  }
+
+  failure(message: string | undefined, options: Options = {}): JournalBatch {
+    return this.log(message, { ...options, type: 'failure' });
+  }
+
+  each<T>(items: Array<T>, fn: (journal: JournalBatch, item: T) => void): JournalBatch {
+    for (const item of items) {
+      fn(this, item);
+    }
+
+    return this;
+  }
+}

package/src/journal.ts

@@ -0,0 +1,85 @@
+import { JournalBatch } from './journal-batch';
+import { NoSink } from './sink';
+import type { JournalEntry, Sink } from './types';
+
+type Options = Partial<Pick<JournalEntry, 'artifacts' | 'meta'>>;
+
+export class Journal<TSink extends Sink = Sink> {
+  constructor(readonly sink: TSink) {}
+
+  static nil() {
+    return new Journal(new NoSink());
+  }
+
+  async log(message: string, options: Options & { type: JournalEntry['type'] }): Promise<void> {
+    const entry: JournalEntry = {
+      timestamp: Date.now(),
+      message,
+      type: options.type,
+      artifacts: options.artifacts ?? [],
+      meta: options.meta ?? {},
+    };
+
+    await this.sink.publish(entry);
+  }
+
+  batch() {
+    return new JournalBatch(this.sink);
+  }
+
+  async do<T>(
+    message: string,
+    callback: () => T | Promise<T>,
+    metaFn?: (result: T) => { meta?: Record<string, any>; artifacts?: File[] },
+  ): Promise<T> {
+    try {
+      await this.start(message);
+
+      const result = await callback();
+
+      const { meta, artifacts } = metaFn?.(result) ?? {};
+      await this.success(message, { meta, artifacts });
+
+      return result;
+    } catch (e) {
+      await this.failure(message);
+      throw e;
+    }
+  }
+
+  async debug(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'debug' });
+  }
+
+  async info(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'info' });
+  }
+
+  async warn(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'warn' });
+  }
+
+  async error(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'error' });
+  }
+
+  async title(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'title' });
+  }
+
+  async prepare(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'prepare' });
+  }
+
+  async start(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'start' });
+  }
+
+  async success(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'success' });
+  }
+
+  async failure(message: string, options: Options = {}): Promise<void> {
+    await this.log(message, { ...options, type: 'failure' });
+  }
+}

package/src/sink/cli-sink.ts

@@ -0,0 +1,153 @@
+import { statusSymbol } from '@letsrunit/utils';
+import { cursorLeft, cursorUp, eraseDown } from 'ansi-escapes';
+import { writeFile } from 'node:fs/promises';
+import YAML from 'yaml';
+import type { JournalEntry, Sink } from '../types';
+
+type WriteFile = typeof writeFile;
+
+interface CliSinkOptions {
+  stream?: NodeJS.WriteStream;
+  verbosity?: number;
+  artifactPath?: string;
+  writeFile?: WriteFile;
+}
+
+function colorize(type: JournalEntry['type'], text: string): string {
+  // ANSI escape codes: debug=bright black (gray), warn=yellow, error=red, info=no color
+  switch (type) {
+    case 'debug':
+    case 'prepare':
+      return `\x1b[90m${text}\x1b[0m`;
+    case 'warn':
+      return `\x1b[33m${text}\x1b[0m`;
+    case 'error':
+    case 'failure':
+      return `\x1b[31m${text}\x1b[0m`;
+    case 'success':
+      return `\x1b[32m${text}\x1b[0m`;
+    case 'title':
+      return `\x1b[1m${text}\x1b[0m`;
+    case 'info':
+    default:
+      return text;
+  }
+}
+
+export class CliSink implements Sink {
+  public readonly stream: NodeJS.WriteStream;
+  public readonly verbosity: number;
+  public readonly artifactPath: string | undefined;
+  private readonly writeFile: WriteFile;
+
+  private entries: JournalEntry[] = [];
+
+  constructor(options: CliSinkOptions = {}) {
+    this.stream = options.stream ?? process.stdout;
+    this.verbosity = options.verbosity ?? 1;
+    this.artifactPath = options.artifactPath;
+    this.writeFile = options.writeFile ?? writeFile;
+  }
+
+  async publish(...entries: JournalEntry[]): Promise<void> {
+    for (const entry of entries) {
+      if (entry.type === 'debug' && this.verbosity < 2) continue;
+      if (entry.type !== 'error' && this.verbosity < 1) continue;
+
+      if (entry.type === 'title') this.endSection();
+
+      this.replace(entry) || this.append(entry);
+
+      await this.storeArtifacts(entry.artifacts);
+    }
+  }
+
+  endSection() {
+    this.entries = [];
+  }
+
+  private replace(entry: JournalEntry): boolean {
+    if (entry.type !== 'start' && entry.type !== 'success' && entry.type !== 'failure') return false;
+
+    const index = this.entries.findLastIndex(
+      (e) => e.message === entry.message &&
+        (e.type === 'prepare' || (e.type === 'start' && entry.type !== 'start'))
+    );
+    if (index < 0) return false;
+
+    const oldTexts = this.entries.slice(index).map((e) => this.format(e));
+    const columns = this.stream.columns ?? 0;
+    const oldLength = oldTexts.reduce((total, current) => total + this.countDisplayLines(current, columns), 0);
+
+    this.entries[index] = entry;
+    const newTexts = this.entries.slice(index).map((e) => this.format(e));
+
+    this.stream.write(cursorUp(oldLength));
+    this.stream.write(cursorLeft);
+    this.stream.write(newTexts.join('\n') + '\n');
+    this.stream.write(eraseDown);
+
+    return true;
+  }
+
+  private append(entry: JournalEntry): void {
+    this.entries.push(entry);
+
+    const text = this.format(entry);
+    this.stream.write(text + '\n');
+  }
+
+  private format(entry: JournalEntry): string {
+    const lines = [];
+
+    const message = entry.message.trim();
+
+    if (['prepare', 'start', 'success', 'failure'].includes(entry.type)) {
+      const prefix = colorize(entry.type, statusSymbol(entry.type));
+      lines.push(`${prefix} ${message}`);
+    } else {
+      lines.push(colorize(entry.type, message));
+    }
+
+    if (this.verbosity >= 3) {
+      if (entry.meta && Object.values(entry.meta).length && Object.keys(entry.meta).length) {
+        const yaml = YAML.stringify(entry.meta).trimEnd();
+        lines.push(colorize('debug', `[Meta]\n${yaml}`));
+      }
+    }
+
+    return lines.join('\n');
+  }
+
+  private stripAnsi(input: string): string {
+    // Regex from chalk/strip-ansi to remove ANSI escape sequences
+    const pattern = /[\u001B\u009B][[\]()#;?]*(?:((?:[a-zA-Z\d]*(?:;[a-zA-Z\d]*)*)?\u0007)|(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~])/g;
+    return input.replace(pattern, '');
+  }
+
+  private countDisplayLines(text: string, columns: number): number {
+    // If columns is not available (non-TTY), fall back to newline-based counting
+    if (!columns || columns <= 0 || !Number.isFinite(columns)) {
+      return text.split('\n').length;
+    }
+
+    let count = 0;
+    const lines = text.split('\n');
+    for (const line of lines) {
+      const visible = this.stripAnsi(line);
+      const len = [...visible].length; // handles surrogate pairs reasonably
+      const wraps = Math.max(1, Math.ceil(len / columns));
+      count += wraps;
+    }
+    return count;
+  }
+
+  private async storeArtifacts(artifacts: File[]) {
+    if (!this.artifactPath || artifacts.length === 0) return;
+
+    for (const artifact of artifacts) {
+      const data = await artifact.bytes();
+      await this.writeFile(`${this.artifactPath}/${artifact.name}`, data);
+    }
+  }
+}

package/src/sink/index.ts

@@ -0,0 +1,3 @@
+export * from './cli-sink';
+export * from './no-sink';
+export * from './supabase-sink';

package/src/sink/no-sink.ts

@@ -0,0 +1,6 @@
+import type { Sink } from '../types';
+
+/* v8 ignore start */
+export class NoSink implements Sink {
+  async publish(): Promise<void> {}
+}

package/src/sink/supabase-sink.ts

@@ -0,0 +1,107 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+import type { JournalEntry, Sink } from '../types';
+
+interface SupabaseSinkOptions {
+  supabase: SupabaseClient;
+  run: { id: string; projectId: string };
+  tableName?: string;
+  bucket?: string;
+  console?: { error: (...args: any[]) => void; warn: (...args: any[]) => void };
+}
+
+export class SupabaseSink implements Sink {
+  private readonly supabase: SupabaseClient;
+  private readonly projectId: string;
+  private readonly runId: string;
+  private readonly tableName: string;
+  private readonly bucket?: string;
+  private readonly console: { error: (...args: any[]) => void; warn: (...args: any[]) => void };
+  private bucketEnsured = false;
+
+  constructor(options: SupabaseSinkOptions) {
+    this.supabase = options.supabase;
+    this.runId = options.run.id;
+    this.projectId = options.run.projectId;
+    this.tableName = options.tableName ?? 'log_entries';
+    this.bucket = options.bucket;
+    this.console = options.console || console;
+  }
+
+  async publish(...entries: JournalEntry[]): Promise<void> {
+    for (const entry of entries) {
+      const artifactList = await this.storeArtifacts(entry.artifacts);
+
+      const { error } = await this.supabase.from(this.tableName).insert({
+        run_id: this.runId,
+        type: entry.type,
+        message: entry.message,
+        meta: entry.meta ?? {},
+        artifacts: artifactList,
+        created_at: new Date().toISOString(),
+      });
+
+      if (error) {
+        this.console.error('SupabaseSink insert failed:', error);
+      }
+    }
+  }
+
+  private async ensureBucket() {
+    if (!this.bucket || this.bucketEnsured) return;
+
+    try {
+      await this.supabase.storage?.createBucket?.(this.bucket, { public: true });
+      this.bucketEnsured = true;
+    } catch (error) {
+      this.console.warn(error);
+    }
+  }
+
+  private async storeArtifacts(artifacts: File[]): Promise<any[]> {
+    if (!this.bucket || artifacts.length === 0) return [];
+
+    await this.ensureBucket();
+
+    const stored: any[] = [];
+
+    const uniqueArtifacts = artifacts.filter(
+      (artifact, index, self) => index === self.findIndex((a) => a.name === artifact.name),
+    );
+
+    for (const artifact of uniqueArtifacts) {
+      try {
+        const path = `${this.projectId}/${artifact.name}`;
+        const { data } = this.supabase.storage.from(this.bucket).getPublicUrl(path);
+        const publicUrl = data.publicUrl;
+
+        const exists = await this.artifactExists(publicUrl);
+
+        if (!exists) {
+          const { error } = await this.supabase.storage
+            .from(this.bucket)
+            .upload(path, await artifact.bytes(), { contentType: artifact.type, upsert: true });
+          if (error) throw error;
+        }
+
+        stored.push({
+          name: artifact.name,
+          url: publicUrl,
+          size: artifact.size,
+        });
+      } catch (error) {
+        this.console.warn('SupabaseSink upload failed:', error);
+      }
+    }
+
+    return stored;
+  }
+
+  private async artifactExists(url: string): Promise<boolean> {
+    try {
+      const response = await fetch(url, { method: 'HEAD' });
+      return response.ok;
+    } catch {
+      return false;
+    }
+  }
+}

package/src/types.ts

@@ -0,0 +1,11 @@
+export interface JournalEntry {
+  timestamp: number;
+  type: 'debug' | 'info' | 'title' | 'warn' | 'error' | 'prepare' | 'start' | 'success' | 'failure';
+  message: string;
+  artifacts: File[];
+  meta: Record<string, any>;
+}
+
+export interface Sink {
+  publish(...entries: JournalEntry[]): Promise<void>
+}