bunqueue-dashboard 1.0.2 → 1.0.3

package/README.md

@@ -32,7 +32,7 @@ The live demo uses sample data. The docs explain how to connect and operate a re
 ![Vite 8](https://img.shields.io/badge/Vite-8-646CFF?logo=vite&logoColor=white)
 ![Bun](https://img.shields.io/badge/Bun-1.4-000?logo=bun&logoColor=white)
 ![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?logo=typescript&logoColor=white)
-![Oxlint + Oxfmt](https://img.shields.io/badge/Oxc-Oxlint%20%2B%20Oxfmt-7C3AED)
+![Oxlint + Bun fmt](https://img.shields.io/badge/Tooling-Oxlint%20%2B%20Bun%20fmt-7C3AED)
 
 <br />
 
@@ -263,20 +263,21 @@ target-pinned Flow, Workflow, Queue and Backup agent operations.
 | `bun start` | **Agent + dashboard together** (one-command dev) |
 | `bun dev` | Dashboard only (Vite dev server) |
 | `bun run agent` | Control agent only |
-| `bun run build` | Typecheck (`tsc --noEmit`) + production build → `dist/` |
+| `bun run build` | Native Bun typecheck + production build → `dist/` |
+| `bun run typecheck` | Native `bun check` for the frontend, agent/scripts, examples and browser tests |
 | `bun run preview` | Preview the production build |
 | `bun run lint` | Lint with Oxlint, including type-aware rules and the implicit-`any` parity guard |
-| `bun run format:check` | Check formatting with Oxfmt |
-| `bun run check` | Oxlint + Oxfmt validation (the CI gate) |
-| `bun run check:fix` | Apply safe Oxlint fixes, then format with Oxfmt |
+| `bun run format:check` | Check formatting with native `bun fmt --check` |
+| `bun run check` | Native typechecking, Oxlint and native formatting validation |
+| `bun run check:fix` | Apply safe Oxlint fixes, then format with native `bun fmt` |
 | `bun test` | Unit + agent-lifecycle tests |
 | `bun run test:e2e:tls` | Queue, Flow and Workflow over verified native TLS, including untrusted-certificate rejection |
-| `bun run test:e2e:upgrade` | Real npm Bunqueue 2.9.2 SQLite schema-35 → 2.9.4 schema-37 migration and retention semantics |
+| `bun run test:e2e:upgrade` | Real npm Bunqueue 2.9.2 SQLite schema-35 → 2.9.20 schema-37 migration and retention semantics |
 | `bun run test:e2e` | Real TLS, SQLite upgrade, Flow, Workflow, Queue SDK, and three-broker PostgreSQL runtime tests |
 | `bun run test:e2e:browser` | Production UI tests on Chromium, Firefox and WebKit |
 | `bun run test:e2e:browser:postgres-fleet` | Real UI operations across three PostgreSQL brokers (requires Docker and Chromium) |
 | `bun run quality` | Complete static, build, docs, coverage, runtime, package and dependency gate |
-| `bun run test:e2e:postgres-fleet` | Three authenticated Bunqueue 2.9.4 brokers + three agents sharing disposable PostgreSQL 18.6 |
+| `bun run test:e2e:postgres-fleet` | Three authenticated Bunqueue 2.9.20 brokers + three agents sharing disposable PostgreSQL 18.6 |
 
 ## Docker
 

package/agent/manager/config.ts

@@ -1,3 +1,4 @@
+import manifest from '../../package.json';
 import type { ServerConfig } from './types';
 
 const CONFIG_KEYS = new Set<keyof ServerConfig>([
@@ -10,7 +11,7 @@ const CONFIG_KEYS = new Set<keyof ServerConfig>([
 
 export function defaultConfig(): ServerConfig {
   return {
-    command: process.env.BUNQUEUE_START_CMD || 'bunx bunqueue@2.9.4 start',
+    command: process.env.BUNQUEUE_START_CMD || `bunx bunqueue@${manifest.dependencies.bunqueue} start`,
     httpPort: Number(process.env.HTTP_PORT) || 6790,
     tcpPort: Number(process.env.TCP_PORT) || 6789,
     dataPath: process.env.BUNQUEUE_DATA_PATH || './data/bunq.db',

package/agent/server/handler.ts

@@ -65,7 +65,8 @@ export function createFetchHandler(
       return new Response(null, { status: 204, headers: corsHeaders(origin, allowedOrigins) });
     }
     const mutating = method === 'POST' || method === 'PUT';
-    const authRequired = requireTokenForAll || (mutating && Boolean(token));
+    const configurationRead = pathname === '/control/config' || pathname === '/control/status';
+    const authRequired = requireTokenForAll || ((mutating || configurationRead) && Boolean(token));
     if (authRequired && !tokenOk(request, token)) {
       return json({ ok: false, error: 'Unauthorized' }, 401, origin);
     }

package/agent/server/router.ts

@@ -201,6 +201,7 @@ function isWorkflowRuntimeRoute(pathname: string, method: string): boolean {
   if (method !== 'POST') return false;
   return (
     [
+      '/workflows/runtime/initialize',
       '/workflows/runtime/reload',
       '/workflows/start',
       '/workflows/recover',

package/agent/server/types.ts

@@ -5,7 +5,7 @@ export interface AgentOptions {
   allowedOrigins: string[];
   /** DNS-rebinding defense; compared by hostname only. */
   allowedHosts?: string[];
-  /** On loopback, when set, changing requests must present this token. */
+  /** On loopback, when set, mutations and complete configuration reads require this token. */
   token?: string;
   /** Network exposure: require token on every non-OPTIONS request. */
   requireTokenForAll?: boolean;

package/agent/workflow/runtime.ts

@@ -29,10 +29,12 @@ export interface WorkflowRuntimeStatus {
   queueName?: string;
   concurrency?: number;
   error?: string;
+  needsInitialization?: boolean;
 }
 
 export interface WorkflowRuntimePort {
-  status(config: ServerConfig, activate?: boolean): Promise<WorkflowRuntimeStatus>;
+  status(config: ServerConfig, serverRunning?: boolean): Promise<WorkflowRuntimeStatus>;
+  initialize(config: ServerConfig): Promise<WorkflowRuntimeStatus>;
   reload(config: ServerConfig): Promise<WorkflowRuntimeStatus>;
   start(config: ServerConfig, workflowName: string, input?: unknown): Promise<unknown>;
   signal(config: ServerConfig, id: string, event: string, payload?: unknown): Promise<void>;
@@ -72,20 +74,32 @@ export class WorkflowRuntime implements WorkflowRuntimePort {
     private readonly createEngine: WorkflowEngineFactory = (options) => new Engine(options)
   ) {}
 
-  status(config: ServerConfig, activate = true): Promise<WorkflowRuntimeStatus> {
+  status(config: ServerConfig, serverRunning = true): Promise<WorkflowRuntimeStatus> {
     return this.serial(async () => {
       const modulePath = configuredWorkflowModule(config);
       try {
         if (!modulePath) {
-          await this.closeActive();
           return { configured: false, ready: false, workflowNames: [] };
         }
-        if (!activate) {
-          await this.closeActive();
+        if (!serverRunning) {
           return stoppedRuntimeStatus(config, modulePath);
         }
-        const active = await this.ensure(config);
-        return readyRuntimeStatus(active);
+        const active = this.active;
+        if (active?.closeFailure !== undefined) throw quarantinedRuntimeError(active);
+        const path = await realpath(modulePath);
+        const modified = (await stat(path)).mtimeMs;
+        const options = workflowRuntimeOptions(config);
+        if (active?.signature === workflowRuntimeSignature(config, path, modified, options)) {
+          return readyRuntimeStatus(active);
+        }
+        return {
+          configured: true,
+          ready: false,
+          needsInitialization: true,
+          moduleName: basename(modulePath),
+          workflowNames: [],
+          ...options,
+        };
       } catch (error) {
         const active = this.active;
         return {
@@ -101,6 +115,10 @@ export class WorkflowRuntime implements WorkflowRuntimePort {
     });
   }
 
+  initialize(config: ServerConfig): Promise<WorkflowRuntimeStatus> {
+    return this.serial(async () => readyRuntimeStatus(await this.ensure(config)));
+  }
+
   reload(config: ServerConfig): Promise<WorkflowRuntimeStatus> {
     return this.serial(async () => {
       await this.closeActive();

package/agent/workflow/runtimeRoutes.ts

@@ -49,6 +49,9 @@ export async function routeWorkflowRuntimeRequest(
     );
   }
   if (!serverRunning) throw new Error('Start the managed Bunqueue server before workflow control.');
+  if (pathname === '/workflows/runtime/initialize') {
+    return success(await admitted(true, ({ config: current }) => runtime.initialize(current)));
+  }
   if (pathname === '/workflows/runtime/reload') {
     return success(await admitted(true, ({ config: current }) => runtime.reload(current)));
   }
@@ -98,7 +101,7 @@ function isRuntimePath(pathname: string, method: string): boolean {
   if (method === 'GET') return pathname === '/workflows/runtime';
   if (method !== 'POST') return false;
   return (
-    ['/workflows/runtime/reload', '/workflows/start', '/workflows/recover', '/workflows/archive', '/workflows/cleanup'].includes(pathname) ||
+    ['/workflows/runtime/initialize', '/workflows/runtime/reload', '/workflows/start', '/workflows/recover', '/workflows/archive', '/workflows/cleanup'].includes(pathname) ||
     /^\/workflows\/[^/]+\/(signal|resume-compensation|abandon-compensation)$/.test(pathname)
   );
 }