okengine 0.9.0 → 0.10.0

package/src/runtime/boot-warn.test.ts

@@ -0,0 +1,45 @@
+/**
+ * Boot honesty suppress flag for the `oke dev` Backend child.
+ */
+
+import { afterEach, describe, expect, test } from "bun:test";
+import { emitBootWarn } from "./boot-warn.ts";
+
+describe("emitBootWarn", () => {
+  const prev = process.env["OKE_SUPPRESS_BOOT_WARN"];
+
+  afterEach(() => {
+    if (prev === undefined) delete process.env["OKE_SUPPRESS_BOOT_WARN"];
+    else process.env["OKE_SUPPRESS_BOOT_WARN"] = prev;
+  });
+
+  test("forwards to console.warn by default", () => {
+    delete process.env["OKE_SUPPRESS_BOOT_WARN"];
+    const lines: string[] = [];
+    const original = console.warn;
+    console.warn = (...args: unknown[]) => {
+      lines.push(args.map(String).join(" "));
+    };
+    try {
+      emitBootWarn("oke boot: test notice");
+      expect(lines).toEqual(["oke boot: test notice"]);
+    } finally {
+      console.warn = original;
+    }
+  });
+
+  test("no-ops when OKE_SUPPRESS_BOOT_WARN=1", () => {
+    process.env["OKE_SUPPRESS_BOOT_WARN"] = "1";
+    const lines: string[] = [];
+    const original = console.warn;
+    console.warn = (...args: unknown[]) => {
+      lines.push(args.map(String).join(" "));
+    };
+    try {
+      emitBootWarn("oke boot: hidden");
+      expect(lines).toEqual([]);
+    } finally {
+      console.warn = original;
+    }
+  });
+});

package/src/runtime/boot-warn.ts

@@ -0,0 +1,17 @@
+/**
+ * Boot honesty lines (`oke boot: …`) — once per process, suppressible in
+ * the `oke dev` Backend child so the parent Console owns the notice.
+ */
+
+/**
+ * Emit a boot warning unless suppressed for this process.
+ *
+ * Set `OKE_SUPPRESS_BOOT_WARN=1` on the Backend child during `oke dev` so
+ * Signal / Channel / files process-local notices print once (parent only).
+ *
+ * @param message - Full warning text (usually prefixed `oke boot:`)
+ */
+export function emitBootWarn(message: string): void {
+  if (process.env["OKE_SUPPRESS_BOOT_WARN"] === "1") return;
+  console.warn(message);
+}

package/src/runtime/dev-request-log.ts

@@ -1,5 +1,5 @@
 /**
- * Dev-only request lines for `oke dev` (App / Console / MCP).
+ * Dev-only request lines for `oke dev` (Backend / Console / MCP).
  *
  * Gated by `OKE_DEV_REQUEST_LOG=1`. Surfaces share one TTY; label + color
  * keep streams readable without a multiplexer.
@@ -18,22 +18,22 @@ export function shouldLogDevRequests(): boolean {
 }
 
 /**
- * Active surface for this async context, or `OKE_DEV_SURFACE`, or `App`.
+ * Active surface for this async context, or `OKE_DEV_SURFACE`, or `Backend`.
  */
 export function currentDevSurface(): DevLogSurface {
   const fromAls = surfaceAls.getStore();
   if (fromAls) return fromAls;
   const fromEnv = process.env.OKE_DEV_SURFACE;
-  if (fromEnv === "App" || fromEnv === "Console" || fromEnv === "MCP") {
+  if (fromEnv === "Backend" || fromEnv === "Console" || fromEnv === "MCP") {
     return fromEnv;
   }
-  return "App";
+  return "Backend";
 }
 
 /**
  * Run a handler tagged with a surface (Console wrap around `app.fetch`).
  *
- * @param surface - App · Console · MCP
+ * @param surface - Backend · Console · MCP
  * @param fn - Async work
  */
 export function runWithDevSurface<T>(

package/src/term.test.ts

@@ -5,7 +5,9 @@
 import { describe, expect, test } from "bun:test";
 import {
   formatAppReadyLine,
+  formatBootWarn,
   formatClaimNote,
+  formatCliChrome,
   formatDevBanner,
   formatDevHero,
   formatDevLogSeparator,
@@ -13,6 +15,11 @@ import {
   formatServiceLine,
   formatRequestLine,
   formatStackSummary,
+  countTermLines,
+  createAnchoredBoard,
+  createBootProgress,
+  createRewritableBlock,
+  formatStatusDot,
   formatStatusLine,
   termStyle,
 } from "./term.ts";
@@ -38,9 +45,10 @@ describe("term", () => {
       runtimeEnv: "local",
       system: "darwin 25.4.0 · bun 1.3.14",
       elements: [
-        { element: "flow", detail: "●" },
-        { element: "store", detail: "sql postgres · kv redis" },
-        { element: "signal", detail: "memory" },
+        { element: "flow", detail: "", status: "ready" },
+        { element: "store", detail: "sql postgres · kv redis", status: "ready" },
+        { element: "signal", detail: "memory", status: "ready" },
+        { element: "ai", detail: "openai-compatible · smollm2", status: "pending" },
       ],
     });
     expect(out).toContain("oke dev  v0.2.4");
@@ -53,11 +61,65 @@ describe("term", () => {
     expect(out).toContain("elements");
     expect(out).toContain("store");
     expect(out).toContain("postgres");
+    expect(out).toContain("● flow");
+    expect(out).toContain("● ai");
     expect(out).not.toContain("on(Trigger)");
     expect(out).not.toContain("O·K·E");
     expect(out).not.toMatch(/\u001b\[/);
   });
 
+  test("formatStatusDot colors by status", () => {
+    const s = termStyle(true);
+    expect(formatStatusDot("ready", true)).toBe(`${s.green}●${s.reset}`);
+    expect(formatStatusDot("pending", true)).toBe(`${s.yellow}●${s.reset}`);
+    expect(formatStatusDot("error", true)).toBe(`${s.red}●${s.reset}`);
+    expect(formatStatusDot("idle", true)).toBe(`${s.dim}●${s.reset}`);
+    expect(formatStatusDot("ready", false)).toBe("●");
+  });
+
+  test("createRewritableBlock appends when disabled", () => {
+    let out = "";
+    const block = createRewritableBlock((t) => {
+      out += t;
+    }, false);
+    block.paint("a\nb\n");
+    block.paint("c\n");
+    expect(out).toBe("a\nb\nc\n");
+    expect(countTermLines("a\nb\n")).toBe(2);
+  });
+
+  test("createBootProgress replaces keyed rows then clears", () => {
+    let out = "";
+    const progress = createBootProgress((t) => {
+      out += t;
+    }, false);
+    progress.set("compose", "compose…\n");
+    progress.set("compose", "compose ok\n");
+    progress.set("vault", "vault ok\n");
+    // Non-TTY appends each set (including replacements).
+    expect(out).toContain("compose ok\n");
+    expect(out).toContain("vault ok\n");
+    progress.clear();
+    // clear is a no-op on the stream when rewrite is disabled
+    expect(out).toContain("vault ok\n");
+  });
+
+  test("createAnchoredBoard wrapWrite tracks below output", () => {
+    let out = "";
+    const board = createAnchoredBoard((t) => {
+      out += t;
+    }, false);
+    board.paint("board\n");
+    const w = board.wrapWrite((t) => {
+      out += t;
+    });
+    w("below\n");
+    board.paint("board2\n"); // non-TTY: no rewrite append
+    expect(out).toContain("board\n");
+    expect(out).toContain("below\n");
+    board.stop();
+  });
+
   test("formatServiceLine / formatAppReadyLine include URL", () => {
     expect(formatServiceLine("Console", "http://127.0.0.1:6533", false)).toContain(
       "http://127.0.0.1:6533",
@@ -65,7 +127,7 @@ describe("term", () => {
     expect(formatAppReadyLine("http://127.0.0.1:6530", false)).toContain("http://127.0.0.1:6530");
   });
 
-  test("formatDevHero keeps App Console MCP URLs", () => {
+  test("formatDevHero keeps Backend Console MCP URLs", () => {
     const out = formatDevHero({
       appUrl: "http://127.0.0.1:6530",
       consoleUrl: "http://127.0.0.1:6533",
@@ -73,12 +135,12 @@ describe("term", () => {
       profile: "local",
       runtimeEnv: "local",
       system: "darwin 25.4.0 · bun 1.3.14",
-      elements: [{ element: "flow", detail: "●" }],
+      elements: [{ element: "flow", detail: "", status: "ready" }],
       color: false,
     });
     expect(out).toContain("oke dev");
     expect(out).toContain("██");
-    expect(out).toContain("App");
+    expect(out).toContain("Backend");
     expect(out).toContain("Console");
     expect(out).toContain("MCP");
     expect(out).toContain("http://127.0.0.1:6530");
@@ -106,10 +168,27 @@ describe("term", () => {
     expect(formatStatusLine("stack up (sql)", false)).toContain("stack up");
   });
 
+  test("formatBootWarn wraps under Notice chrome", () => {
+    const out = formatBootWarn(
+      "oke boot: Channel suppression defaults to process-local memory for multi-instance",
+      false,
+    );
+    expect(out).toContain("Notice");
+    expect(out).toContain("process-local");
+    expect(out).not.toContain("oke boot:");
+  });
+
+  test("formatCliChrome routes boot and status lines", () => {
+    const out = formatCliChrome("oke db seed: ok\noke boot: hello world\n", false);
+    expect(out).toContain("oke db seed: ok");
+    expect(out).toContain("Notice");
+    expect(out).toContain("hello world");
+  });
+
   test("formatRequestLine shows date, time, surface, flow, ms, status", () => {
     const at = new Date(2026, 6, 26, 3, 11, 42);
     const out = formatRequestLine({
-      surface: "App",
+      surface: "Backend",
       method: "GET",
       path: "/health",
       flow: "main.health",
@@ -120,7 +199,7 @@ describe("term", () => {
     });
     expect(out).toContain("2026-07-26");
     expect(out).toContain("03:11:42");
-    expect(out).toContain("App");
+    expect(out).toContain("Backend");
     expect(out).toContain("200");
     expect(out).not.toMatch(/\u001b\[/);
   });
@@ -144,14 +223,20 @@ describe("term", () => {
     const out = formatStackSummary({
       project: "oke-dev-a3f791",
       services: [
-        { label: "postgres", hostPort: 15975 },
-        { label: "redis", hostPort: 16975 },
+        { label: "postgres", hostPort: 15975, status: "ready" },
+        { label: "redis", hostPort: 16975, status: "ready" },
+        { label: "ai", hostPort: 23975, detail: "gemma4:e4b-q4_K_M", status: "pending" },
       ],
       appDrivers: ["postgres", "redis"],
       color: false,
     });
     expect(out).toContain("Docker");
     expect(out).toContain(":15975");
+    expect(out).toContain("gemma4:e4b-q4_K_M");
+    expect(out).toContain("● postgres");
+    expect(out).toContain("● ai");
+    // Blank │ row separates the Docker header from whatever sits above.
+    expect(out).toMatch(/│\n◇ {2}Docker/);
     expect(out).not.toMatch(/\u001b\[/);
   });
 });