okengine 0.18.4 → 0.19.0

package/src/console/ui-next/src/features/flows/traces/effect-kind.ts

@@ -2,8 +2,8 @@
  * EffectKind presentation for the trace detail Sheet.
  *
  * Kernel {@link EffectKind} values (singular): read · write · emit · send ·
- * ask · secret · call. Graph edge strokes use the plural Manifest keys
- * (reads/writes/emits/calls/asks) — map through {@link effectBarColor}.
+ * ask · embed · secret · call. Graph edge strokes use the plural Manifest keys
+ * (reads/writes/emits/calls/asks/embeds) — map through {@link effectBarColor}.
  * Icons reuse the same eight-element HugeIcons vocabulary as Flow graph
  * nodes (store / signal / flow / ai / channel / vault).
  */
@@ -23,8 +23,10 @@ export const EFFECT_KIND_LABEL: Readonly<Record<RunEffectKind, string>> = {
   emit: "Emit",
   send: "Send",
   ask: "Ask",
+  embed: "Embed",
   secret: "Secret",
   call: "Call",
+  fetch: "Fetch",
 };
 
 /**
@@ -40,8 +42,10 @@ export function effectKindSummaryLabel(kind: RunEffectKind, count: number): stri
     emit: "emit",
     send: "send",
     ask: "ask",
+    embed: "embed",
     secret: "secret",
     call: "call",
+    fetch: "fetch",
   };
   const plural: Record<RunEffectKind, string> = {
     read: "reads",
@@ -49,8 +53,10 @@ export function effectKindSummaryLabel(kind: RunEffectKind, count: number): stri
     emit: "emits",
     send: "sends",
     ask: "asks",
+    embed: "embeds",
     secret: "secrets",
     call: "calls",
+    fetch: "fetches",
   };
   return `${count} ${count === 1 ? singular[kind] : plural[kind]}`;
 }
@@ -73,8 +79,10 @@ export function effectBarColor(kind: RunEffectKind): string {
     case "call":
       return EDGE_STROKE.calls;
     case "ask":
+    case "embed":
       return EDGE_STROKE.asks;
     case "send":
+    case "fetch":
       return EDGE_STROKE.sends;
     case "secret":
       return EDGE_STROKE.secrets;
@@ -99,8 +107,10 @@ export function effectKindIcon(kind: RunEffectKind, resource?: string): ElementH
     case "call":
       return ELEMENT_ICONS.flow.icon;
     case "ask":
+    case "embed":
       return ELEMENT_ICONS.ai.icon;
     case "send":
+    case "fetch":
       return ELEMENT_ICONS.channel.icon;
     case "secret":
       return ELEMENT_ICONS.vault.icon;

package/src/console/ui-next/src/features/flows/traces/effect-summary.ts

@@ -43,7 +43,9 @@ const KIND_ORDER: readonly RunEffectKind[] = [
   "emit",
   "call",
   "ask",
+  "embed",
   "send",
+  "fetch",
   "secret",
 ];
 
@@ -201,8 +203,10 @@ export function effectEventLabel(effect: Pick<RunEffect, "kind" | "resource">):
     emit: "Emit",
     send: "Send",
     ask: "Ask",
+    embed: "Embed",
     secret: "Secret",
     call: "Call",
+    fetch: "Fetch",
   };
   return labels[effect.kind];
 }

package/src/console/ui-next/src/features/flows/traces/trace-detail-sheet.tsx

@@ -484,6 +484,7 @@ export function TraceDetailSheet({
                             data-slot="trace-event-row"
                             data-index={index}
                             data-focused={focused ? "true" : "false"}
+                            data-external={effect.external ? "true" : undefined}
                             className={cn(
                               EXPLORER_ROW_CLASS,
                               "cursor-pointer flex-col items-stretch gap-1 text-[11px]",
@@ -510,6 +511,9 @@ export function TraceDetailSheet({
                               </span>
                               <span className="min-w-0 flex-1 truncate font-mono text-muted-foreground">
                                 {effect.resource}
+                                {effect.external
+                                  ? ` · ↗ ${effect.external.host}${effect.external.kind ? ` (${effect.external.kind})` : ""}`
+                                  : ""}
                               </span>
                               <span className="shrink-0 tabular-nums text-muted-foreground">
                                 {formatDuration(effect.duration)}
@@ -815,6 +819,7 @@ function OverviewTrack({
                     "absolute inset-y-0.5 cursor-pointer rounded-full transition-opacity",
                     hoverIndex !== null && hoverIndex !== bar.index && !focused && "opacity-35",
                     focused && "ring-1 ring-foreground/40",
+                    bar.external && "outline outline-1 outline-dashed outline-foreground/50",
                   )}
                   style={{
                     left: `${mapped.left * 100}%`,
@@ -822,6 +827,7 @@ function OverviewTrack({
                     backgroundColor: effectBarColor(bar.kind),
                   }}
                   data-slot="trace-waterfall-overview-bar"
+                  data-external={bar.external ? "true" : undefined}
                   onClick={(event) => {
                     event.stopPropagation();
                     onSelect?.(bar.index);
@@ -995,6 +1001,7 @@ function PlaybackBarFill({
         "absolute inset-y-0 rounded-full transition-opacity",
         !animated && dimmed && !focused && "opacity-35",
         focused && "ring-1 ring-foreground/40",
+        bar.external && "outline outline-1 outline-dashed outline-foreground/50",
       )}
       style={{
         left: `${left * 100}%`,
@@ -1004,6 +1011,7 @@ function PlaybackBarFill({
         ...(animated ? { scaleX, opacity } : {}),
       }}
       data-slot={slot}
+      data-external={bar.external ? "true" : undefined}
     />
   );
 }

package/src/console/ui-next/src/features/flows/traces/waterfall-bars.ts

@@ -30,6 +30,8 @@ export type WaterfallBar = {
    * `offsetRatio + widthRatio === 1`.
    */
   readonly widthRatio: number;
+  /** Egress identity when the effect left the process. */
+  readonly external?: RunEffect["external"];
 };
 
 /**
@@ -58,6 +60,7 @@ export function waterfallBars(
       durationMs: 0,
       offsetRatio: 0,
       widthRatio: 0,
+      ...(effect.external !== undefined ? { external: effect.external } : {}),
     }));
   }
 
@@ -75,6 +78,7 @@ export function waterfallBars(
       durationMs: clampedDuration,
       offsetRatio: startOffsetMs / durationMs,
       widthRatio: clampedDuration / durationMs,
+      ...(effect.external !== undefined ? { external: effect.external } : {}),
     };
   });
 }

package/src/console/ui-next/src/features/flows/traces/waterfall-tooltip.ts

@@ -9,12 +9,18 @@ import type { WaterfallBar } from "./waterfall-bars.ts";
 /**
  * Build the shadcn Tooltip content for one waterfall bar.
  *
- * Format: `{kind label} · {resource} · {duration} · +{start offset}`.
+ * Format: `{kind label} · {resource} · {duration} · +{start offset}`
+ * plus optional egress (`host` / provider / kind) when `external` is set.
  *
  * @param bar - Positioned bar (layout + effect identity)
  */
 export function waterfallBarTooltip(
-  bar: Pick<WaterfallBar, "kind" | "resource" | "durationMs" | "startOffsetMs">,
+  bar: Pick<WaterfallBar, "kind" | "resource" | "durationMs" | "startOffsetMs" | "external">,
 ): string {
-  return `${effectEventLabel(bar)} · ${bar.resource} · ${formatDuration(bar.durationMs)} · +${formatDuration(bar.startOffsetMs)}`;
+  const base = `${effectEventLabel(bar)} · ${bar.resource} · ${formatDuration(bar.durationMs)} · +${formatDuration(bar.startOffsetMs)}`;
+  if (!bar.external) return base;
+  const parts = [bar.external.host];
+  if (bar.external.provider) parts.push(bar.external.provider);
+  if (bar.external.kind) parts.push(bar.external.kind);
+  return `${base} · ↗ ${parts.join(" · ")}`;
 }

package/src/console/ui-next/src/features/store/detail/reveal-cell.tsx

@@ -7,6 +7,7 @@ import { ViewIcon, ViewOffSlashIcon } from "@hugeicons/core-free-icons";
 import { HugeiconsIcon } from "@hugeicons/react";
 import { Button } from "@/components/ui/button";
 import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
+import { formatTemporalCell, formatGridCell } from "../lib/grid-model.ts";
 import { useStoreReveal } from "../data/use-store-reveal.ts";
 
 /** Props for {@link RevealCell}. */
@@ -38,7 +39,9 @@ export function RevealCell({
   if (clear !== null) {
     return (
       <span className="inline-flex max-w-full items-center gap-1" data-slot="reveal-cell">
-        <span className="min-w-0 truncate font-mono text-[11px]">{formatCell(clear.value)}</span>
+        <span className="min-w-0 truncate font-mono text-[11px]">
+          {formatRevealCell(column, clear.value)}
+        </span>
         <Tooltip>
           <TooltipTrigger
             render={(props) => (
@@ -120,18 +123,11 @@ export function RevealCell({
           {reveal.error.message}
         </span>
       ) : null}
-      <span className="sr-only">{formatCell(maskedValue)}</span>
+      <span className="sr-only">{formatRevealCell(column, maskedValue)}</span>
     </span>
   );
 }
 
-function formatCell(value: unknown): string {
-  if (value === null || value === undefined) return "—";
-  if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  try {
-    return JSON.stringify(value);
-  } catch {
-    return "[unserializable]";
-  }
+function formatRevealCell(column: string, value: unknown): string {
+  return formatTemporalCell(column, value) ?? formatGridCell(value);
 }

package/src/console/ui-next/src/features/store/detail/store-row-detail-sheet.tsx

@@ -25,7 +25,7 @@ import { cn } from "@/lib/utils";
 import { useStoreEdit } from "../data/use-store-edit.ts";
 import { RevealCell } from "./reveal-cell.tsx";
 import {
-  formatGridCell,
+  formatStoreCell,
   type StoreGridColumn,
   type StoreGridModel,
   type StoreGridRow,
@@ -236,7 +236,7 @@ export function StoreRowDetailSheet({
                         className="min-w-0 flex-1 font-mono text-[11px] break-words"
                         dir={isRtlText(value) ? "rtl" : "ltr"}
                       >
-                        {formatGridCell(value)}
+                        {formatStoreCell(col, value)}
                       </span>
                     )}
                   </li>

package/src/console/ui-next/src/features/store/lib/fields-from-table.ts

@@ -66,6 +66,8 @@ function fieldFromColumn(
     ...(description !== undefined ? { description } : {}),
     ...(col.pii === true ? { pii: true } : {}),
     ...(col.sensitive === true ? { sensitive: true } : {}),
+    ...(declared?.searchable ? { searchable: true, searchWeight: declared.searchable.weight } : {}),
+    ...(declared?.embed ? { embed: true, embedDims: declared.embed.dims } : {}),
     ...(declared?.primaryKey === true ? { primaryKey: true } : {}),
     ...(declared?.unique === true && declared.primaryKey !== true ? { unique: true } : {}),
     ...(declared?.references?.table

package/src/console/ui-next/src/features/store/lib/grid-model.test.ts

@@ -1,5 +1,11 @@
 import { describe, expect, test } from "bun:test";
-import { buildStoreGridModel, sqlRowId } from "./grid-model.ts";
+import {
+  buildStoreGridModel,
+  formatStoreCell,
+  formatTemporalCell,
+  isTemporalColumnKey,
+  sqlRowId,
+} from "./grid-model.ts";
 
 describe("buildStoreGridModel", () => {
   test("sql rows map to editable typed columns with pii flags", () => {
@@ -125,3 +131,21 @@ describe("sqlRowId", () => {
     expect(sqlRowId({})).toBe("");
   });
 });
+
+describe("formatTemporalCell / formatStoreCell", () => {
+  test("formats epoch-ms *_at columns as ISO", () => {
+    expect(isTemporalColumnKey("created_at")).toBe(true);
+    expect(isTemporalColumnKey("createdAt")).toBe(true);
+    expect(isTemporalColumnKey("seats")).toBe(false);
+    expect(formatTemporalCell("created_at", 1_723_622_400_000)).toBe("2024-08-14T08:00:00.000Z");
+    expect(
+      formatStoreCell(
+        { key: "created_at", type: "integer", editable: false, pii: false },
+        1_723_622_400_000,
+      ),
+    ).toBe("2024-08-14T08:00:00.000Z");
+    expect(formatStoreCell({ key: "seats", type: "integer", editable: true, pii: false }, 2)).toBe(
+      "2",
+    );
+  });
+});

package/src/console/ui-next/src/features/store/lib/grid-model.ts

@@ -197,6 +197,7 @@ export function sqlRowId(row: Readonly<Record<string, unknown>>): string {
 /** Format a cell value for display. */
 export function formatGridCell(value: unknown): string {
   if (value === null || value === undefined) return "—";
+  if (value instanceof Date) return value.toISOString();
   if (typeof value === "string") return value;
   if (typeof value === "number" || typeof value === "boolean") return String(value);
   try {
@@ -207,7 +208,39 @@ export function formatGridCell(value: unknown): string {
 }
 
 /**
- * Format a cell using the column's display hint (TTL / bytes) when set.
+ * True when a SQL column name looks like an instant (`created_at`, `expiresAt`, …).
+ *
+ * @param key - Column key (camelCase or snake_case)
+ */
+export function isTemporalColumnKey(key: string): boolean {
+  return /(?:^|_)(at|time|timestamp)$/i.test(key) || /(?:At|Time|Timestamp)$/.test(key);
+}
+
+/**
+ * Format epoch-ms / `Date` / ISO for a temporal column. Returns `null` when the
+ * value should keep the default grid formatter (non-temporal or non-instant).
+ *
+ * @param key - Column key
+ * @param value - Raw cell
+ */
+export function formatTemporalCell(key: string, value: unknown): string | null {
+  if (value === null || value === undefined) return null;
+  if (value instanceof Date) return value.toISOString();
+  if (typeof value === "string") {
+    if (!isTemporalColumnKey(key)) return null;
+    const ms = Date.parse(value);
+    return Number.isNaN(ms) ? null : new Date(ms).toISOString();
+  }
+  if (typeof value === "number" && Number.isFinite(value) && isTemporalColumnKey(key)) {
+    // Auth / clock system tables store epoch-ms; reject tiny integers (counts).
+    if (value < 1_000_000_000_000 || value > 10_000_000_000_000) return null;
+    return new Date(value).toISOString();
+  }
+  return null;
+}
+
+/**
+ * Format a cell using the column's display hint (TTL / bytes / temporal) when set.
  *
  * @param col - Column descriptor
  * @param value - Raw cell
@@ -215,5 +248,7 @@ export function formatGridCell(value: unknown): string {
 export function formatStoreCell(col: StoreGridColumn, value: unknown): string {
   if (col.format === "ttl") return formatKvTtl(value);
   if (col.format === "bytes") return formatByteSize(value);
+  const temporal = formatTemporalCell(col.key, value);
+  if (temporal !== null) return temporal;
   return formatGridCell(value);
 }

package/src/console/ui-next/src/features/store/query/query-results.tsx

@@ -36,7 +36,7 @@ import { cn } from "@/lib/utils.ts";
 import { JsonValueSheet } from "../detail/json-value-sheet.tsx";
 import { ToolbarTip } from "@/components/ui/toolbar-tip.tsx";
 import { cellExportText, rowsToCsv } from "../lib/grid-transfer.ts";
-import { formatGridCell } from "../lib/grid-model.ts";
+import { formatGridCell, formatTemporalCell } from "../lib/grid-model.ts";
 import { asInspectableJson } from "../lib/json-value.ts";
 import type { QueryHighlightLanguage } from "../lib/query-highlight.ts";
 import { QueryHighlightView } from "./query-highlight-view.tsx";
@@ -310,10 +310,10 @@ export function QueryResults({
                                     setInspect({ rowId: String(i), column: col, value })
                                   }
                                 >
-                                  {formatGridCell(value)}
+                                  {formatTemporalCell(col, value) ?? formatGridCell(value)}
                                 </button>
                               ) : (
-                                formatGridCell(value)
+                                (formatTemporalCell(col, value) ?? formatGridCell(value))
                               )}
                             </td>
                           );

package/src/console/ui-next/src/features/units/detail/effects-summary.tsx

@@ -82,7 +82,9 @@ function flattenEffects(effects: Effects | undefined): EffectChip[] {
   push("emit", effects.emits);
   push("send", effects.sends);
   push("ask", effects.asks);
+  push("embed", effects.embeds);
   push("secret", effects.secrets);
   push("call", effects.calls);
+  push("fetch", effects.fetches);
   return out;
 }

package/src/console/ui-next/src/features/units/lib/call-read-safe.ts

@@ -16,7 +16,9 @@ export function isReadSafeCall(row: UnitFlowRow): boolean {
     (effects.writes?.length ?? 0) === 0 &&
     (effects.emits?.length ?? 0) === 0 &&
     (effects.sends?.length ?? 0) === 0 &&
-    (effects.asks?.length ?? 0) === 0
+    (effects.asks?.length ?? 0) === 0 &&
+    (effects.embeds?.length ?? 0) === 0 &&
+    (effects.fetches?.length ?? 0) === 0
   );
 }
 

package/src/console/ui-next/src/features/units/lib/fields-from-schema.ts

@@ -25,6 +25,12 @@ export interface FormField {
   readonly pii?: boolean;
   /** When true, column is sensitive-classified (Store schema pills). */
   readonly sensitive?: boolean;
+  /** Built-in hybrid search — BM25 via `.searchable()`. */
+  readonly searchable?: boolean;
+  readonly searchWeight?: number;
+  /** Async LSH embed via `.embed()`. */
+  readonly embed?: boolean;
+  readonly embedDims?: number;
   /** When true, column is a primary key (Store schema pills). */
   readonly primaryKey?: boolean;
   /** When true, column is a foreign key (declared or inferred). */

package/src/docker/ai-model-status.test.ts

@@ -5,7 +5,6 @@ import {
   normalizeAiProbeUrl,
   probeAiModelStatus,
   startAiModelWatch,
-  statusFromOllamaTags,
   statusFromOpenAiModels,
 } from "./ai-model-status.ts";
 
@@ -17,12 +16,9 @@ describe("ai-model-status", () => {
     expect(normalizeAiProbeUrl("http://127.0.0.1:8080/v1/", "openai-compatible")).toBe(
       "http://127.0.0.1:8080/v1",
     );
-    expect(normalizeAiProbeUrl("http://127.0.0.1:11434/v1", "ollama")).toBe(
-      "http://127.0.0.1:11434",
-    );
   });
 
-  test("aiModelIdsMatch tolerates llama.cpp quant aliasing", () => {
+  test("aiModelIdsMatch tolerates quant aliasing", () => {
     expect(aiModelIdsMatch("gemma4:e4b-q4_K_M", "gemma4:Q4_K_M")).toBe(true);
     expect(aiModelIdsMatch("smollm2", "smollm2")).toBe(true);
     expect(aiModelIdsMatch("gemma4:e4b-q4_K_M", "qwen3:8b")).toBe(false);
@@ -45,13 +41,6 @@ describe("ai-model-status", () => {
     expect(statusFromOpenAiModels("smollm2", { data: [] }).phase).toBe("starting");
   });
 
-  test("statusFromOllamaTags ready when present", () => {
-    expect(statusFromOllamaTags("qwen3.5:9b", { models: [{ name: "qwen3.5:9b" }] }).phase).toBe(
-      "ready",
-    );
-    expect(statusFromOllamaTags("qwen3.5:9b", { models: [] }).phase).toBe("loading");
-  });
-
   test("probeAiModelStatus uses injectable fetch", async () => {
     const status = await probeAiModelStatus({
       url: "http://127.0.0.1:9/v1",

package/src/docker/ai-model-status.ts

@@ -1,6 +1,6 @@
 /**
- * Probe local AI servers for configured-model readiness (llama.cpp / Ollama /
- * OpenAI-compatible). Used by `oke dev` to show model id + phase without
+ * Probe OpenAI-compatible AI servers for configured-model readiness
+ * (BYO `OKE_AI_URL`). Used by `oke dev` to show model id + phase without
  * blocking boot.
  */
 
@@ -19,14 +19,14 @@ export type AiModelStatus = {
 };
 
 /** Which HTTP surface to probe. */
-export type AiModelProbeKind = "openai-compatible" | "ollama";
+export type AiModelProbeKind = "openai-compatible";
 
 /** Fetch contract (injectable for tests). */
 export type AiModelFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 
 /** Options for {@link probeAiModelStatus}. */
 export type ProbeAiModelStatusOptions = {
-  /** Base URL — with or without trailing `/v1` for OpenAI-compatible. */
+  /** Base URL — with or without trailing `/v1`. */
   readonly url: string;
   readonly model: string;
   readonly kind: AiModelProbeKind;
@@ -34,17 +34,15 @@ export type ProbeAiModelStatusOptions = {
 };
 
 /**
- * Strip trailing slashes; for OpenAI-compatible keep a single `/v1` suffix.
+ * Strip trailing slashes; keep a single `/v1` suffix for OpenAI-compatible.
  *
  * @param url - Raw base URL
  * @param kind - Probe kind
  */
 export function normalizeAiProbeUrl(url: string, kind: AiModelProbeKind): string {
   let base = url.trim().replace(/\/+$/, "");
-  if (kind === "openai-compatible") {
-    if (!base.endsWith("/v1")) base = `${base}/v1`;
-  } else if (base.endsWith("/v1")) {
-    base = base.slice(0, -3);
+  if (kind === "openai-compatible" && !base.endsWith("/v1")) {
+    base = `${base}/v1`;
   }
   return base;
 }
@@ -52,7 +50,7 @@ export function normalizeAiProbeUrl(url: string, kind: AiModelProbeKind): string
 /**
  * Whether a reported model id covers the requested `OKE_AI_MODEL`.
  *
- * Tolerates llama.cpp alias normalization (`gemma4:e4b-q4_K_M` ↔ `gemma4:Q4_K_M`).
+ * Tolerates quant / alias normalization (`gemma4:e4b-q4_K_M` ↔ `gemma4:Q4_K_M`).
  *
  * @param want - Requested id
  * @param reported - Server id
@@ -123,30 +121,6 @@ export function statusFromOpenAiModels(model: string, json: unknown): AiModelSta
   };
 }
 
-/**
- * Parse Ollama `GET /api/tags` into a status for `model`.
- *
- * @param model - Requested id
- * @param json - Parsed JSON
- */
-export function statusFromOllamaTags(model: string, json: unknown): AiModelStatus {
-  if (!json || typeof json !== "object") {
-    return { model, phase: "starting", detail: "invalid /api/tags body" };
-  }
-  const models = (json as { models?: unknown }).models;
-  if (!Array.isArray(models)) {
-    return { model, phase: "starting" };
-  }
-  for (const row of models) {
-    if (!row || typeof row !== "object") continue;
-    const name = (row as { name?: unknown }).name;
-    if (typeof name === "string" && aiModelIdsMatch(model, name)) {
-      return { model, phase: "ready", reportedId: name };
-    }
-  }
-  return { model, phase: "loading", detail: "not in /api/tags yet" };
-}
-
 /**
  * Map a server-native status string to {@link AiModelPhase}.
  *
@@ -173,7 +147,7 @@ export async function probeAiModelStatus(opts: ProbeAiModelStatusOptions): Promi
   if (!model) return { model: "", phase: "error", detail: "OKE_AI_MODEL is empty" };
   const fetchFn = opts.fetch ?? globalThis.fetch;
   const base = normalizeAiProbeUrl(opts.url, opts.kind);
-  const path = opts.kind === "ollama" ? `${base}/api/tags` : `${base}/models`;
+  const path = `${base}/models`;
   try {
     const res = await fetchFn(path, { method: "GET" });
     if (!res.ok) {
@@ -184,9 +158,7 @@ export async function probeAiModelStatus(opts: ProbeAiModelStatusOptions): Promi
       };
     }
     const json: unknown = await res.json().catch(() => null);
-    return opts.kind === "ollama"
-      ? statusFromOllamaTags(model, json)
-      : statusFromOpenAiModels(model, json);
+    return statusFromOpenAiModels(model, json);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return { model, phase: "unreachable", detail: msg };

package/src/docker/compose-up.test.ts

@@ -0,0 +1,100 @@
+/**
+ * Unit tests for compose-up progress parsing / labels.
+ */
+
+import { describe, expect, test } from "bun:test";
+import {
+  composeUpPhaseLabel,
+  composeUpPhaseStatus,
+  formatComposeUpEventMessage,
+  parseComposeProgressLine,
+  shortenComposeTarget,
+  stripAnsi,
+} from "./compose-up.ts";
+
+describe("parseComposeProgressLine", () => {
+  test("parses Image / Container lifecycle lines", () => {
+    expect(parseComposeProgressLine(" Image postgres:16-alpine Pulling ")).toEqual({
+      raw: "Image postgres:16-alpine Pulling",
+      target: "postgres:16-alpine",
+      kind: "image",
+      phase: "pulling",
+    });
+    expect(parseComposeProgressLine("Container oke-oke-2-postgres-1 Started")).toEqual({
+      raw: "Container oke-oke-2-postgres-1 Started",
+      target: "oke-oke-2-postgres-1",
+      kind: "container",
+      phase: "started",
+    });
+    expect(parseComposeProgressLine("Network oke-oke-2_default Creating")).toEqual({
+      raw: "Network oke-oke-2_default Creating",
+      target: "oke-oke-2_default",
+      kind: "network",
+      phase: "creating",
+    });
+  });
+
+  test("parses bare service Pulling / Pulled", () => {
+    expect(parseComposeProgressLine("postgres Pulling")).toEqual({
+      raw: "postgres Pulling",
+      target: "postgres",
+      phase: "pulling",
+    });
+    expect(parseComposeProgressLine("redis Pulled")).toEqual({
+      raw: "redis Pulled",
+      target: "redis",
+      phase: "pulled",
+    });
+  });
+
+  test("parses download / extract / error chatter", () => {
+    expect(parseComposeProgressLine("1f2544649a1a Downloading [====>] 5MB/12MB")?.phase).toBe(
+      "downloading",
+    );
+    expect(parseComposeProgressLine("1f2544649a1a Extracting [========>]")?.phase).toBe(
+      "extracting",
+    );
+    expect(parseComposeProgressLine("Error response from daemon: boom")?.phase).toBe("error");
+  });
+
+  test("keeps unknown lines as activity", () => {
+    expect(parseComposeProgressLine("some compose note")).toEqual({
+      raw: "some compose note",
+      phase: "other",
+      detail: "some compose note",
+    });
+  });
+
+  test("skips empty / spinner-only", () => {
+    expect(parseComposeProgressLine("   ")).toBeNull();
+    expect(parseComposeProgressLine("…")).toBeNull();
+  });
+
+  test("strips ANSI before parse", () => {
+    const line = "\x1b[32mContainer oke-x-redis-1 Started\x1b[0m";
+    expect(parseComposeProgressLine(line)?.phase).toBe("started");
+    expect(stripAnsi(line)).toBe("Container oke-x-redis-1 Started");
+  });
+});
+
+describe("shortenComposeTarget / labels", () => {
+  test("shortens oke container and image refs", () => {
+    expect(shortenComposeTarget("oke-oke-2-postgres-1")).toBe("postgres");
+    expect(shortenComposeTarget("postgres:16-alpine")).toBe("postgres");
+    expect(shortenComposeTarget("ghcr.io/org/mailpit:latest")).toBe("mailpit");
+  });
+
+  test("formats event messages and status dots", () => {
+    expect(
+      formatComposeUpEventMessage({
+        raw: "Image postgres:16 Pulling",
+        target: "postgres:16",
+        phase: "pulling",
+      }),
+    ).toBe("postgres pulling…");
+    expect(composeUpPhaseLabel("started")).toBe("started");
+    expect(composeUpPhaseStatus("pulling")).toBe("pending");
+    expect(composeUpPhaseStatus("started")).toBe("ready");
+    expect(composeUpPhaseStatus("error")).toBe("error");
+  });
+});