omkit 0.1.6 → 0.1.7

package/dist/output/writers/NodeLogWriter.js

@@ -27,7 +27,18 @@ const header = (node) => [
     `#   started:  ${stamp(node.startedAt)}`,
     `#   finished: ${stamp(node.endedAt)} (${node.duration}ms)`,
     `#   status:   ${node.status}`,
+    ...(node.parentId === null ? legend : []), // the run's root log (main.log) only
 ].filter((line) => line !== null);
+/** A compact reading guide, printed once on the root log so an agent can follow the run. */
+const legend = [
+    "#",
+    "# ── legend ──────────────────────────────────────────────────────────",
+    "#   [n]              global sequence — the merge/order key across every .log",
+    "#   indented rows    a child action's milestones, bubbled up here",
+    "#   name [tags]      the action and its tags   ·   defined …  where its code lives",
+    "#   launch · → ….log a child started — open that file for its full output",
+    "#   ⚡ event   ✓ done ok   ⊘ cancelled   ✗ failed   ⊨/⊭ assert pass/fail   📸 snapshot   ▪ output",
+];
 const stamp = (ms) => (ms ? new Date(ms).toISOString() : "-");
 const renderArgs = (args) => {
     try {

package/dist/output/writers/entryLine.js

@@ -6,7 +6,11 @@ import { label } from "../../foundation/ActionRef.js";
  * the child by its {@link label} (name + tags) via `refOf`; everything else keeps its
  * `source` (proc name, `console`, …).
  */
-export const entryLine = (e, refOf) => `[${e.sequence}] ${bodyOf(e, refOf)}`;
+export const entryLine = (e, refOf) => {
+    // Bubbled child rows are nested a level in — the whole row, `[seq]` included.
+    const indent = e.level === "child" ? "    " : "";
+    return `${indent}[${e.sequence}] ${bodyOf(e, refOf)}`;
+};
 const bodyOf = (e, refOf) => {
     switch (e.level) {
         case "event":
@@ -24,9 +28,9 @@ const bodyOf = (e, refOf) => {
             // output. (Cancellation no longer logs at this level — it's a clean stop.)
             return e.source === "error" ? `✗ ${e.message}` : `▪ ${e.message}`;
         case "child": {
-            // A bubbled child milestone carries the child's id as `source`: name it with its
-            // tags (`name [tags]`) so the parent timeline always shows them. The launch
-            // pointer (`source === "launch"`) keeps its `→ id · logfile` message as-is.
+            // A bubbled child line (indented at the row level by `entryLine`). The launch pointer
+            // (`source === "launch"`) keeps its `→ id · logfile` message; a milestone names the
+            // child by its label (name + tags) via `refOf`.
             if (e.source === "launch")
                 return `${e.source} · ${e.message}`;
             const ref = refOf?.(e.source);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omkit",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "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",