okengine 0.2.1 → 0.2.3

package/src/console/ui/shell/panels/overview/OverviewPanel.tsx

@@ -188,6 +188,14 @@ export function OverviewPanel() {
       </header>
 
       <main id="overview-main" className="flex flex-col gap-8 px-6 py-6">
+        {!loading && !manifestQuery.data ? (
+          <p className="text-sm text-[var(--oke-muted)]">
+            No Manifest yet — save a Flow under{" "}
+            <code className="font-mono text-[var(--oke-fg)]">src/</code> and
+            the Console will refresh.
+          </p>
+        ) : null}
+
         {view.hasDeclaredSlos ? (
           <BudgetStrip
             label="Error budgets"

package/src/console/ui/shell/public/favicon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 96 96" fill="none">
+  <rect width="96" height="96" rx="20" fill="#0D0D0D"/>
+  <path
+    d="M70.2 74.5C68.5 74.75 66.6 74.88 64.5 74.88H32.1C27 74.88 23 74.15 20.1 72.7C17.2 71.25 15.1 69.05 13.9 66.15C12.7 63.25 12.1 59.65 12.1 55.35V30.15C12.1 25.95 12.7 22.4 13.9 19.55C15.1 16.65 17.15 14.45 20 13C22.9 11.45 26.95 10.7 32.1 10.7H64.5C66.6 10.7 68.5 10.83 70.2 11.08V21.05H83.1C83.95 23.6 84.4 26.6 84.4 30.15V55.35C84.4 58.75 84 61.75 83.2 64.3H70.2V74.5ZM35.3 64.4H61C63.7 64.4 65.75 63.7 67.2 62.3C68.75 60.9 69.5 59 69.5 56.6V28.85C69.5 26.75 68.75 24.95 67.2 23.5C65.65 21.95 63.55 21.2 61 21.2H35.3C32.7 21.2 30.55 21.9 28.95 23.3C27.35 24.7 26.55 26.55 26.55 28.85V56.6C26.55 59.05 27.3 61 28.85 62.4C30.45 63.7 32.6 64.4 35.3 64.4Z"
+    fill="#FFFFFF"
+  />
+</svg>

package/src/console/ui/shell/setup/Wizard.tsx

@@ -6,6 +6,7 @@
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { useState, type FormEvent } from "react";
 import { consoleCalls, setAccessToken } from "../client.ts";
+import { OkeLogo } from "../components/oke-logo.tsx";
 import { Button, Field, Input } from "../components/ui.tsx";
 
 /**
@@ -55,7 +56,8 @@ export function SetupWizard() {
   if (status.data?.setupClosed) {
     return (
       <section className="mx-auto flex max-w-md flex-col gap-4 px-6 py-16">
-        <h1 className="text-2xl font-semibold tracking-tight">oke Console</h1>
+        <OkeLogo className="h-7 w-auto text-[var(--oke-fg)]" />
+        <h1 className="text-2xl font-semibold tracking-tight">Console</h1>
         <p className="text-[var(--oke-muted)]">
           Setup is closed. Sign in with an existing operator account.
         </p>
@@ -73,10 +75,11 @@ export function SetupWizard() {
   return (
     <section className="mx-auto flex max-w-md flex-col gap-6 px-6 py-16">
       <header className="flex flex-col gap-2">
+        <OkeLogo className="h-7 w-auto text-[var(--oke-fg)]" />
         <p className="text-xs uppercase tracking-[0.2em] text-[var(--oke-muted)]">
           First admin
         </p>
-        <h1 className="text-3xl font-semibold tracking-tight">oke Console</h1>
+        <h1 className="text-3xl font-semibold tracking-tight">Console</h1>
         <p className="text-[var(--oke-muted)]">
           Enter the claim code printed once to the boot log. This wizard closes
           permanently after the first operator.

package/src/docker/derive.ts

@@ -23,7 +23,9 @@ import type { DeriveOptions, DeriveResult, GeneratedFile } from "./types.ts";
  */
 export function deriveInfrastructure(options: DeriveOptions): DeriveResult {
   if (!options.images || Object.keys(options.images).length === 0) {
-    throw new Error("oke docker: no images configured — set `images` in oke.config.ts");
+    throw new Error(
+      "oke docker: no images configured — set `images` in oke.config.ts (or prod drivers postgres/redis for defaults)",
+    );
   }
 
   const specs = buildSpecs(options);

package/src/docker/dockerfile.integration.test.ts

@@ -73,7 +73,7 @@ console.log("listening", server.port);
 
       // No lockfile — adjust Dockerfile install for the fixture.
       const derived = deriveInfrastructure({
-        images: { "store.sql": "postgres:16-alpine" },
+        images: { "store.sql": "postgres:18-alpine" },
         credentials: {
           "store.sql": {
             user: "oke",

package/src/docker/stack.integration.test.ts

@@ -35,7 +35,7 @@ describe("oke dev --stack postgres integration", () => {
     const project = `oke-pg-${Date.now()}`;
     try {
       const derived = deriveInfrastructure({
-        images: { "store.sql": "postgres:16-alpine" },
+        images: { "store.sql": "postgres:18-alpine" },
         credentials: {
           "store.sql": {
             user: "oke",

package/src/docs-origin.ts

@@ -0,0 +1,19 @@
+/**
+ * Canonical public docs origin for error links, README, and the site.
+ *
+ * Flip this one constant when the custom domain is attached:
+ * `https://oke.omqkhafi.dev`
+ */
+
+/** Live docs site (Vercel). Planned cutover: `https://oke.omqkhafi.dev`. */
+export const DOCS_ORIGIN = "https://okengine.vercel.app" as const;
+
+/**
+ * Absolute docs URL for a path under the handbook / site.
+ *
+ * @param path - Path beginning with `/` (e.g. `/docs`, `/e/1001`)
+ */
+export function docsUrl(path: string): string {
+  const normalized = path.startsWith("/") ? path : `/${path}`;
+  return `${DOCS_ORIGIN}${normalized}`;
+}

package/src/kernel/errors.registry.test.ts

@@ -27,10 +27,12 @@ describe("OKE error-code registry", () => {
     }
   });
 
-  test("OkeError docsUrl matches https://oke.dev/e/{code}", () => {
+  test("OkeError docsUrl matches docs origin /e/{code}", () => {
     for (const def of Object.values(OKE_ERRORS) as OkeErrorDefinition[]) {
       const err = new OkeError(def);
-      expect(err.docsUrl).toBe(`https://oke.dev/e/${def.code}`);
+      expect(err.docsUrl).toBe(
+        `https://okengine.vercel.app/e/${def.code}`,
+      );
       expect(err.message).toContain(err.docsUrl);
       expect(err.message).toContain(`OKE${def.code}`);
       expect(err.message).toContain("→");

package/src/kernel/errors.ts

@@ -6,6 +6,8 @@
  * permanent from the moment they enter this registry.
  */
 
+import { docsUrl as absoluteDocsUrl } from "../docs-origin.ts";
+
 /** Numeric OKE error code (permanent once published). */
 export type OkeErrorCode = number;
 
@@ -45,7 +47,7 @@ export class OkeError extends Error {
   constructor(definition: OkeErrorDefinition, params: OkeErrorParams = {}) {
     const causeText = interpolate(definition.cause, params);
     const fix = interpolate(definition.fix, params);
-    const docsUrl = `https://oke.dev/e/${definition.code}`;
+    const docsUrl = absoluteDocsUrl(`/e/${definition.code}`);
     const message = formatOkeMessage(definition.code, causeText, fix, docsUrl);
     super(message);
     this.name = "OkeError";

package/src/kernel/fx.test.ts

@@ -43,7 +43,7 @@ describe("fx — capability enforcement", () => {
     expect(oke.fix).toBe(
       'Add "sql:users" to this flow\'s effects.reads.',
     );
-    expect(oke.docsUrl).toBe("https://oke.dev/e/1001");
+    expect(oke.docsUrl).toBe("https://okengine.vercel.app/e/1001");
     expect(oke.message).toBe(
       formatOkeMessage(1001, oke.causeText, oke.fix, oke.docsUrl),
     );
@@ -218,7 +218,7 @@ describe("errors — registry", () => {
     });
     expect(err.message).toContain("OKE1042");
     expect(err.message).toContain("no subscriber");
-    expect(err.message).toContain("https://oke.dev/e/1042");
+    expect(err.message).toContain("https://okengine.vercel.app/e/1042");
     expect(err.message).toContain("→");
   });
 

package/src/term.test.ts

@@ -0,0 +1,51 @@
+/**
+ * Terminal chrome — color off stays plain; claim/banner keep structure.
+ */
+
+import { describe, expect, test } from "bun:test";
+import {
+  formatAppReadyLine,
+  formatClaimNote,
+  formatDevBanner,
+  formatServiceLine,
+  formatStatusLine,
+  termStyle,
+} from "./term.ts";
+
+describe("term", () => {
+  test("termStyle(false) strips ANSI", () => {
+    const s = termStyle(false);
+    expect(s.cyan).toBe("");
+    expect(s.bold).toBe("");
+  });
+
+  test("formatDevBanner is readable without color", () => {
+    const out = formatDevBanner({ color: false });
+    expect(out).toContain("oke dev");
+    expect(out).toContain("Starting");
+    expect(out).toContain("watching");
+    expect(out).not.toMatch(/\u001b\[/);
+  });
+
+  test("formatServiceLine / formatAppReadyLine include URL", () => {
+    expect(formatServiceLine("Console", "http://127.0.0.1:6533", false)).toContain(
+      "http://127.0.0.1:6533",
+    );
+    expect(formatAppReadyLine("http://127.0.0.1:6530", false)).toContain(
+      "http://127.0.0.1:6530",
+    );
+  });
+
+  test("formatClaimNote embeds code and ownership line", () => {
+    const code = "aabbccddeeff00112233445566778899";
+    const out = formatClaimNote(code, false);
+    expect(out).toContain(code);
+    expect(out).toContain("Claim code");
+    expect(out).toContain("owns the server");
+    expect(out).not.toMatch(/\u001b\[/);
+  });
+
+  test("formatStatusLine keeps message", () => {
+    expect(formatStatusLine("stack up (sql)", false)).toContain("stack up");
+  });
+});

package/src/term.ts

@@ -0,0 +1,158 @@
+/**
+ * Clack-inspired terminal styling for `oke` CLI / boot logs.
+ *
+ * Human TTY gets color + unicode chrome; CI / pipes stay plain.
+ * Flip to monochrome with `NO_COLOR=1` or non-TTY stdout.
+ */
+
+/** Whether ANSI color should be applied. */
+export function termColorEnabled(
+  stream: { readonly isTTY?: boolean } = process.stdout,
+): boolean {
+  if (process.env["NO_COLOR"] !== undefined) return false;
+  if (process.env["FORCE_COLOR"] === "0") return false;
+  if (process.env["FORCE_COLOR"]) return true;
+  return stream.isTTY === true;
+}
+
+const ESC = "\u001b[";
+
+/** ANSI helpers — empty strings when color is off. */
+export type TermStyle = {
+  readonly reset: string;
+  readonly bold: string;
+  readonly dim: string;
+  readonly cyan: string;
+  readonly green: string;
+  readonly magenta: string;
+  readonly yellow: string;
+  readonly white: string;
+};
+
+/**
+ * Build a style palette for the current environment.
+ *
+ * @param color - Force on/off; default from {@link termColorEnabled}
+ */
+export function termStyle(color: boolean = termColorEnabled()): TermStyle {
+  if (!color) {
+    return {
+      reset: "",
+      bold: "",
+      dim: "",
+      cyan: "",
+      green: "",
+      magenta: "",
+      yellow: "",
+      white: "",
+    };
+  }
+  return {
+    reset: `${ESC}0m`,
+    bold: `${ESC}1m`,
+    dim: `${ESC}2m`,
+    cyan: `${ESC}36m`,
+    green: `${ESC}32m`,
+    magenta: `${ESC}35m`,
+    yellow: `${ESC}33m`,
+    white: `${ESC}37m`,
+  };
+}
+
+/**
+ * `oke dev` intro — clack chrome; service URLs print as each surface binds.
+ *
+ * @param options - Color / watch hint
+ */
+export function formatDevBanner(
+  options: { readonly color?: boolean; readonly watching?: boolean } = {},
+): string {
+  const s = termStyle(options.color ?? termColorEnabled());
+  const bar = `${s.dim}│${s.reset}`;
+  const lines = [
+    "",
+    `${s.cyan}${s.bold}┌${s.reset}  ${s.bold}oke dev${s.reset}`,
+    bar,
+    `${s.green}◇${s.reset}  Starting`,
+  ];
+  if (options.watching !== false) {
+    lines.push(
+      `${bar}  ${s.dim}watching — client types regenerate on save${s.reset}`,
+    );
+  }
+  lines.push(bar);
+  return `${lines.join("\n")}\n`;
+}
+
+/**
+ * One service URL line (Console / MCP after bind).
+ *
+ * @param label - Surface name
+ * @param url - Absolute URL
+ * @param color - Color on/off
+ */
+export function formatServiceLine(
+  label: string,
+  url: string,
+  color: boolean = termColorEnabled(),
+): string {
+  const s = termStyle(color);
+  const pad = label.padEnd(7);
+  return `${s.dim}│${s.reset}  ${s.dim}${pad}${s.reset}  ${s.cyan}${url}${s.reset}\n`;
+}
+
+/**
+ * App child ready line (`bun --hot` soft reload).
+ *
+ * @param url - App base URL
+ * @param color - Color on/off
+ */
+export function formatAppReadyLine(
+  url: string,
+  color: boolean = termColorEnabled(),
+): string {
+  const s = termStyle(color);
+  return `${s.green}●${s.reset}  ${s.dim}App${s.reset}      ${s.cyan}${url}${s.reset}\n`;
+}
+
+/**
+ * Quiet status line (regen, stack up, …).
+ *
+ * @param message - Status text
+ * @param color - Color on/off
+ */
+export function formatStatusLine(
+  message: string,
+  color: boolean = termColorEnabled(),
+): string {
+  const s = termStyle(color);
+  return `${s.dim}│${s.reset}  ${s.dim}${message}${s.reset}\n`;
+}
+
+/**
+ * First-admin claim code note (clack `note`-style box).
+ *
+ * @param code - Hex claim code
+ * @param color - Color on/off
+ */
+export function formatClaimNote(
+  code: string,
+  color: boolean = termColorEnabled(),
+): string {
+  const s = termStyle(color);
+  const bar = `${s.dim}│${s.reset}`;
+  const title = "Claim code";
+  const hint = "expires in 30 min";
+  const ownership = "Whoever can read this log already owns the server.";
+  const lines = [
+    "",
+    `${s.magenta}◆${s.reset}  ${s.bold}${title}${s.reset}  ${s.dim}${hint}${s.reset}`,
+    bar,
+    `${bar}  ${s.bold}${code}${s.reset}`,
+    bar,
+    `${bar}  ${s.dim}${ownership}${s.reset}`,
+    `${s.dim}└${s.reset}`,
+    "",
+  ];
+  return `${lines.join("\n")}\n`;
+}