okengine 0.2.1 → 0.2.2

package/README.md

@@ -8,7 +8,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Bun >=1.3](https://img.shields.io/badge/Bun-%3E%3D1.3-black.svg)](https://bun.sh)
 
-**Framework:** [`okengine`](https://www.npmjs.com/package/okengine) · **CLI:** `oke` · **Scaffold:** [`create-oke`](https://www.npmjs.com/package/create-oke) · **Docs:** [oke.dev](https://oke.dev) · **License:** MIT
+**Framework:** [`okengine`](https://www.npmjs.com/package/okengine) · **CLI:** `oke` · **Scaffold:** [`create-oke`](https://www.npmjs.com/package/create-oke) · **Docs:** [okengine.vercel.app](https://okengine.vercel.app) · **License:** MIT
 
 ### Install
 
@@ -35,7 +35,7 @@ Eight elements cover what a backend needs. Ten exports are the whole public voca
 import { on, flow, signal, store, clock, gate, vault, channel, ai, plugin } from "okengine";
 ```
 
-Batteries included for the Bun era: contract-first APIs, typed client, infrastructure primitives, Console, auth — pure TypeScript, MIT, self-hostable, no cloud lock-in. Handbook: [oke.dev/docs](https://oke.dev/docs). Spec depth: [`docs/spec/unified-theory.md`](https://github.com/omqkhafi/okengine/blob/main/docs/spec/unified-theory.md).
+Batteries included for the Bun era: contract-first APIs, typed client, infrastructure primitives, Console, auth — pure TypeScript, MIT, self-hostable, no cloud lock-in. Handbook: [handbook](https://okengine.vercel.app/docs). Spec depth: [`docs/spec/unified-theory.md`](https://github.com/omqkhafi/okengine/blob/main/docs/spec/unified-theory.md).
 
 ---
 
@@ -131,7 +131,7 @@ The rest of the scaffold is small and ordinary: `oke.config.ts` (drivers by prot
 
 ## How to learn (read in order)
 
-Start on the site if you want the handbook path: [Introduction](https://oke.dev/docs/get-started/introduction) → [Installation](https://oke.dev/docs/get-started/installation) → [Basic usage](https://oke.dev/docs/get-started/basic-usage).
+Start on the site if you want the handbook path: [Introduction](https://okengine.vercel.app/docs/get-started/introduction) → [Installation](https://okengine.vercel.app/docs/get-started/installation) → [Basic usage](https://okengine.vercel.app/docs/get-started/basic-usage).
 
 Each teaching app adds the smallest next set of ideas. Do not skip ahead.
 
@@ -153,8 +153,8 @@ Same path in the spec: [`docs/spec/four-applications.md`](docs/spec/four-applica
 
 ## Documentation
 
-- **Site** — [oke.dev](https://oke.dev) (landing) · [oke.dev/docs](https://oke.dev/docs) (handbook) · [changelog](https://oke.dev/changelog)
-- **Agents on the site** — [`/llms.txt`](https://oke.dev/llms.txt) index · [`/llms-full.txt`](https://oke.dev/llms-full.txt) full text · `/llms.mdx/docs/...` per-page markdown
+- **Site** — [okengine.vercel.app](https://okengine.vercel.app) (landing) · [handbook](https://okengine.vercel.app/docs) (handbook) · [changelog](https://okengine.vercel.app/changelog)
+- **Agents on the site** — [`/llms.txt`](https://okengine.vercel.app/llms.txt) index · [`/llms-full.txt`](https://okengine.vercel.app/llms-full.txt) full text · `/llms.mdx/docs/...` per-page markdown
 - **Docs MCP** — `:6536` · tools `oke.docs.search` / `oke.docs.get` (read-only; Host/Origin validated like the other surfaces)
 - **App MCP** — `:6535` · live Manifest, schemas, effects, traces, Console-safe actions (Bearer + confirmation for writes)
 - **Canonical specs in-repo** — [`docs/spec/`](docs/spec) (unified theory, four applications, Console)
@@ -204,7 +204,7 @@ flowchart TD
 
 Seventeen panels on `:6533` (app `:6530`, MCP `:6535`): Overview, Flows, Signals, Store, Clock, Gates, Vault, Channels, AI, Architecture, Traces, Runs, Manifest Diff, Access, Plugins — plus Privacy and Tenancy when those plugins are plugged.
 
-Operator and user planes stay separate. Every Console action is a real flow through `fx`, so the audit log is the trace. Spec: [`docs/spec/console.md`](docs/spec/console.md) · handbook: [oke.dev/docs/console](https://oke.dev/docs/console/overview).
+Operator and user planes stay separate. Every Console action is a real flow through `fx`, so the audit log is the trace. Spec: [`docs/spec/console.md`](docs/spec/console.md) · handbook: [console handbook](https://okengine.vercel.app/docs/console/overview).
 
 ---
 
@@ -348,11 +348,11 @@ Measured size and latency caps — see [`BUDGETS.md`](BUDGETS.md). Refresh with
 
 ## Status
 
-Pre-1.0. Published on [npm](https://www.npmjs.com/package/okengine) and [JSR](https://jsr.io/@omqkhafi/okengine) (`okengine` + `create-oke`, lockstep). Docs at [oke.dev](https://oke.dev). MIT. No `CONTRIBUTING` yet — issues and PRs welcome.
+Pre-1.0. Published on [npm](https://www.npmjs.com/package/okengine) and [JSR](https://jsr.io/@omqkhafi/okengine) (`okengine` + `create-oke`, lockstep). Docs at [okengine.vercel.app](https://okengine.vercel.app). MIT. No `CONTRIBUTING` yet — issues and PRs welcome.
 
 | Resource | Path |
 |---|---|
-| Docs site | [oke.dev](https://oke.dev) · [handbook](https://oke.dev/docs) · [changelog](https://oke.dev/changelog) |
+| Docs site | [okengine.vercel.app](https://okengine.vercel.app) · [handbook](https://okengine.vercel.app/docs) · [changelog](https://okengine.vercel.app/changelog) |
 | Unified theory | [`docs/spec/unified-theory.md`](https://github.com/omqkhafi/okengine/blob/main/docs/spec/unified-theory.md) |
 | Four applications | [`docs/spec/four-applications.md`](https://github.com/omqkhafi/okengine/blob/main/docs/spec/four-applications.md) |
 | Console | [`docs/spec/console.md`](https://github.com/omqkhafi/okengine/blob/main/docs/spec/console.md) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okengine",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "One law. Eight elements. Ten exports. One package. One manifest. Every backend need is derived, never added.",
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,7 @@
     "test:mcp": "bun test src/mcp",
     "test:console:smoke": "bunx playwright test tests/console/smoke.spec.ts",
     "build:console": "bunx vite build --config src/console/ui/vite.config.ts",
+    "prepack": "bun run build:console",
     "bench:cold-start": "bun test ./src/runtime/cold-start.bench.ts",
     "bench:client": "bun test src/client/budget.test.ts",
     "bench:console": "bun test src/console/budget.test.ts",

package/src/cli/dev-app-runner.ts

@@ -17,6 +17,7 @@ import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { createBunRuntime } from "../runtime/bun.ts";
 import { APP_PORT, type FetchApp } from "../runtime/types.ts";
+import { formatAppReadyLine } from "../term.ts";
 
 /** Stable Bun.serve id so `--hot` reuses the socket across soft reloads. */
 export const DEV_APP_SERVE_ID = "oke-dev-app";
@@ -59,8 +60,11 @@ const handle = createBunRuntime().serve(mod.app, {
   id: DEV_APP_SERVE_ID,
 });
 
-const line = `oke app http://${formatHostForUrl(hostname)}:${handle.port}\n`;
-process.stdout.write(line);
+process.stdout.write(
+  formatAppReadyLine(
+    `http://${formatHostForUrl(hostname)}:${handle.port}`,
+  ),
+);
 
 if (readyPath !== undefined && readyPath.length > 0) {
   await Bun.write(readyPath, `${handle.port}\n`);

package/src/cli/dev.ts

@@ -23,6 +23,11 @@ import {
   CONSOLE_PORT,
   MCP_PORT,
 } from "../runtime/types.ts";
+import {
+  formatDevBanner,
+  formatServiceLine,
+  formatStatusLine,
+} from "../term.ts";
 import { clientAdd } from "./client-add.ts";
 import { loadManifest, loadOkeConfig, resolveImages } from "./load-config.ts";
 import { mcpContextFromConsole } from "./mcp-from-console.ts";
@@ -258,7 +263,7 @@ export async function runDev(options: DevOptions = {}): Promise<DevResult> {
           }
         });
       await up(composeFiles, cwd);
-      write(`oke dev: stack up (${stackRoles.join(", ")})\n`);
+      write(formatStatusLine(`stack up (${stackRoles.join(", ")})`));
     }
   }
 
@@ -272,10 +277,7 @@ export async function runDev(options: DevOptions = {}): Promise<DevResult> {
     stackEnv,
   };
 
-  write(
-    `oke dev: app :${appPort} · Console :${consolePort} · MCP :${mcpPort}\n`,
-  );
-  write("oke dev: watching — client types regenerate on save\n");
+  write(formatDevBanner());
 
   if (options.dryRun) return { code: 0, plan };
 
@@ -312,7 +314,12 @@ export async function runDev(options: DevOptions = {}): Promise<DevResult> {
           ? { manifest: seedManifest }
           : {}),
       });
-      write(`oke Console http://127.0.0.1:${server.port}\n`);
+      write(
+        formatServiceLine(
+          "Console",
+          `http://127.0.0.1:${server.port}`,
+        ),
+      );
       return {
         console: server.console,
         port: server.port,
@@ -334,7 +341,7 @@ export async function runDev(options: DevOptions = {}): Promise<DevResult> {
         context: mcpOptions.context,
         now: mcpOptions.now,
       });
-      write(`oke MCP http://127.0.0.1:${server.port}\n`);
+      write(formatServiceLine("MCP", `http://127.0.0.1:${server.port}`));
       return {
         port: server.port,
         url: server.url,
@@ -352,7 +359,7 @@ export async function runDev(options: DevOptions = {}): Promise<DevResult> {
           url: appUrl,
           out: resolve(cwd, "oke-client.d.ts"),
         });
-        write("oke dev: regenerated oke-client.d.ts\n");
+        write(formatStatusLine("regenerated oke-client.d.ts"));
       } catch {
         // App may not be ready yet — ignore until next save.
       }
@@ -515,7 +522,7 @@ async function startAppHot(
       proc,
       APP_READY_TIMEOUT_MS,
     );
-    // Child prints `oke app http://…` (again on each soft reload).
+    // Child prints the App ready line (again on each soft reload).
     const url = new URL(`http://${hostname}:${boundPort}/`);
     return { stop, port: boundPort, url };
   } catch (err) {

package/src/console/server/claim.test.ts

@@ -52,10 +52,13 @@ describe("claim code", () => {
 
   test("prints to boot log exactly once", () => {
     const state = mintClaimCode(() => 1);
-    const lines: string[] = [];
-    printClaimCodeOnce(state, (l) => lines.push(l));
-    printClaimCodeOnce(state, (l) => lines.push(l));
-    expect(lines.filter((l) => l.includes(state.code)).length).toBe(1);
+    const chunks: string[] = [];
+    printClaimCodeOnce(state, (l) => chunks.push(l));
+    printClaimCodeOnce(state, (l) => chunks.push(l));
+    const joined = chunks.join("");
+    expect(joined).toContain(state.code);
+    expect(joined).toContain("Claim code");
+    expect(chunks.length).toBe(1);
   });
 
   test("constantTimeEqual is length-safe", () => {

package/src/console/server/claim.ts

@@ -5,6 +5,7 @@
  * and rate-limited (console §2.5 · §10.4).
  */
 
+import { formatClaimNote } from "../../term.ts";
 import {
   AUTH_RATE_LIMIT,
   AUTH_RATE_WINDOW_MS,
@@ -67,13 +68,7 @@ export function printClaimCodeOnce(
 ): void {
   if (state.printed) return;
   state.printed = true;
-  write("");
-  write("┌─────────────────────────────────────────────────────────┐");
-  write("│  oke Console — first-admin claim code (expires 30 min)  │");
-  write(`│  ${state.code}  │`);
-  write("│  Whoever can read this log already owns the server.     │");
-  write("└─────────────────────────────────────────────────────────┘");
-  write("");
+  write(formatClaimNote(state.code));
 }
 
 /** Result of {@link verifyClaimCode}. */