omkit 0.0.13 → 0.0.14

package/dist/orchestration/spin/SpinHost.js

@@ -321,6 +321,11 @@ export class SpinHost {
         const file = await this.output.runLog.write();
         // Direct to the terminal — the file's already written, so this line isn't in it.
         this.term(LogRenderer.marker("run", `log → ${file}`));
+        // If this run logged any assertions, link the dedicated file beside the main one
+        // (only exists when there was at least one assertion). Terminal-only, like `log →`.
+        const assertionsFile = this.output.runLog.assertionsLog;
+        if (assertionsFile)
+            this.term(LogRenderer.marker("assert", `assertions → ${assertionsFile}`));
         const result = { ok: this.failures.length === 0, failures: this.failures };
         // One process = one run = one verdict; reflect pass/fail in the exit code so
         // shells and CI see it without parsing the log. Only set it on failure, so a

package/dist/output/log/RunLog.d.ts

@@ -13,7 +13,10 @@ import type { SnapshotStore } from "../snapshot/SnapshotStore.ts";
 export declare class RunLog {
     private readonly folder;
     private readonly snapshots;
+    private assertionsPath;
     constructor(folder: RunFolder, snapshots: SnapshotStore);
+    /** The `assertions.log` path if any assertion was logged this run, else `undefined`. */
+    get assertionsLog(): string | undefined;
     /**
      * Streams every log entry to `run.jsonl` (the complete, authoritative record) and a
      * live `run.log` incrementally as they arrive, so output survives a hard kill or lost

package/dist/output/log/RunLog.js

@@ -15,10 +15,18 @@ import { ymd, hms } from "../../utils/format.js";
 export class RunLog {
     folder;
     snapshots;
+    // Path of `assertions.log`, set the first time an assertion is streamed (lazily
+    // created). Stays `undefined` for a run with no assertions, so the finalize step
+    // links it only when it exists. See {@link assertionsLog}.
+    assertionsPath;
     constructor(folder, snapshots) {
         this.folder = folder;
         this.snapshots = snapshots;
     }
+    /** The `assertions.log` path if any assertion was logged this run, else `undefined`. */
+    get assertionsLog() {
+        return this.assertionsPath;
+    }
     /**
      * Streams every log entry to `run.jsonl` (the complete, authoritative record) and a
      * live `run.log` incrementally as they arrive, so output survives a hard kill or lost
@@ -46,7 +54,10 @@ export class RunLog {
                 jsonl.write(JSON.stringify(entry) + "\n");
                 pretty.write(renderer.render(entry) + "\n");
                 if (entry.level === "assert") {
-                    assertions ??= createWriteStream(this.folder.resolve("assertions.log"));
+                    if (!assertions) {
+                        this.assertionsPath = this.folder.resolve("assertions.log");
+                        assertions = createWriteStream(this.assertionsPath);
+                    }
                     assertions.write(LogRenderer.marker("assert", entry.message) + "\n");
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omkit",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "A tiny runtime for developer workflows: typed actions that pass runtime capabilities and emit typed events, under one run and one shared log. The operational/runtime layer to tskb's knowledge layer.",
   "type": "module",
   "main": "./dist/index.js",