workbite 0.1.4 → 0.1.6

package/README.md

@@ -3,15 +3,26 @@
 WorkBite installs and opens **Work Stack** (organizes the work) and
 **StackBite** (gets it moving) as one native suite.
 
-Version 0.1.4 opens the unified Rust UI: select a Task, start its agent, and
-use `9 Execution` to see and control its native terminal in the same window.
-The existing 1–8 menus remain available. Task completion stays an explicit action.
+Launcher 0.1.6 (native bundle 0.1.6) opens the familiar TypeScript
+Work Stack UI by default. The unified Rust UI, where you select a Task, start
+its agent and use `9 Execution` to see and control its native terminal in the
+same window, is opt-in per open: `workbite open --frontend rust` (or bare
+`workbite --frontend rust`). The TypeScript UI does not yet embed `9 Execution`.
+Either frontend reuses the same owner and StackBite backend; the choice is not
+saved. Task completion stays an explicit action.
+
+0.1.6 rebuilds the Windows terminal core for baseline x64 CPUs, removing the
+previous build machine's AVX-512 requirement, and adds bounded native startup
+failure diagnostics. Linux still supports glibc 2.28+. Updating from the 0.1.4
+native bundle requires an operator handover of existing backend processes;
+the launcher does not stop them or clear startup records automatically.
 
 ```sh
 npm install -g workbite
 workbite install
 workbite open --workspace /abs/path/new-folder --init      # first time, once
-workbite                                                   # afterwards
+workbite                                                   # afterwards (TypeScript UI)
+workbite --frontend rust                                   # unified Rust UI with 9 Execution
 ```
 
 Node.js 20+ on Windows x64 or Linux x64 (glibc 2.28+).
@@ -21,9 +32,11 @@ Node.js 20+ on Windows x64 or Linux x64 (glibc 2.28+).
   every file listed in its `bundle.json`, and installs it into an immutable
   per-user version folder. No auto-update, no install scripts, no dependencies.
 - `workbite check` re-verifies the installed bundle without downloading.
-- `workbite open --workspace ABS [--init] [--no-ui]` starts or reuses the
-  workspace's Work Stack owner and a StackBite backend (only processes it can
-  prove it started), then runs the unified WorkBite terminal UI. Backends keep
+- `workbite open --workspace ABS [--init] [--no-ui] [--frontend typescript|rust]`
+  starts or reuses the workspace's Work Stack owner and a StackBite backend
+  (only processes it can prove it started), then runs the TypeScript Work Stack
+  UI, or the unified Rust UI with `--frontend rust` (0.1.4+ execution bundle
+  only; an older bundle refuses it before starting anything). Backends keep
   running after the UI exits.
 - `workbite` (or `workbite open` without `--workspace`) reopens the last
   workspace that opened successfully; an explicit `--workspace` always wins.

package/lib/cli.js

@@ -2,7 +2,7 @@
 const path = require('node:path');
 const { fail, readSmall } = require('./common');
 const { locations, releaseSpec, ensureInstalled, stageReporter, packageVersion } = require('./install');
-const { openSuite } = require('./runtime');
+const { openSuite, FRONTENDS } = require('./runtime');
 const { bindAgent, executeAgent, agentCapabilities, WRITE_COMMANDS, MAX_PACKET_BYTES } = require('./agent');
 
 const HELP = `WorkBite ${packageVersion} - Work Stack organizes the work. StackBite gets it moving.
@@ -10,10 +10,11 @@ const HELP = `WorkBite ${packageVersion} - Work Stack organizes the work. StackB
 Usage:
   workbite install                       download, verify and install the pinned native suite
   workbite check                         verify the installed suite (no download, no processes)
-  workbite open --workspace ABS [--init] [--no-ui]
+  workbite open --workspace ABS [--init] [--no-ui] [--frontend typescript|rust]
                                          start or reuse this workspace's Work Stack owner and the
                                          StackBite backend, then run the Work Stack terminal UI
-  workbite [open] [--no-ui]              reopen the last workspace WorkBite opened successfully
+  workbite [open] [--no-ui] [--frontend typescript|rust]
+                                         reopen the last workspace WorkBite opened successfully
   workbite agent [--workspace ABS --workspace-uid UUID] COMMAND [--input-file FILE | --stdin] [flags]
                                          curated Work Stack agent commands against the running,
                                          WorkBite-owned owner (never starts one): capabilities, status,
@@ -32,6 +33,8 @@ open:
   --workspace ABS  absolute workspace folder; always wins over the remembered one
   --init           create a new Work Stack workspace in a new or empty folder (needs --workspace)
   --no-ui          start or reuse the backends, print one JSON summary and exit
+  --frontend NAME  typescript (default): the familiar Work Stack UI; rust: the unified UI with
+                   9 Execution (execution bundles only). Chosen per open, never saved.
 
 First time, name the workspace once:
   workbite open --workspace /abs/path/new-folder --init
@@ -148,6 +151,11 @@ function parseArguments(argv) {
       else if (argument === '--no-ui' && options.ui) options.ui = false;
       else if (argument === '--workspace' && options.workspace === undefined && rest[index + 1] !== undefined
           && !rest[index + 1].startsWith('--')) options.workspace = rest[++index];
+      else if (argument === '--frontend' && options.frontend === undefined) {
+        const name = rest[++index];
+        if (!FRONTENDS.includes(name)) fail(`--frontend must be one of: ${FRONTENDS.join(', ')}`);
+        options.frontend = name;
+      }
       else fail(`Unknown or repeated open option: ${String(argument).slice(0, 64)}. See workbite --help.`);
     }
     // Without --workspace the remembered workspace is reopened; --init never picks a folder by itself.
@@ -237,7 +245,7 @@ async function main(argv = process.argv.slice(2), options = {}) {
     return { code: 0, signal: null };
   }
   return openSuite({ installed, commands: options.commands, workspace: parsed.workspace, init: parsed.init, ui: parsed.ui,
-    stateRoot, environment, spawnImpl: options.spawnImpl, execImpl: options.execImpl, stdout, timeouts: options.timeouts });
+    frontend: parsed.frontend, stateRoot, environment, spawnImpl: options.spawnImpl, execImpl: options.execImpl, stdout, timeouts: options.timeouts });
 }
 
 module.exports = { main, parseArguments, HELP };

package/lib/runtime.js

@@ -20,6 +20,8 @@ const CONNECTION_SCHEMA = 'workstack.helm-connection.v1';
 const OWNER_SCHEMA = 'workbite.owner.v2';
 const STACKBITE_SCHEMA = 'workbite.stackbite-backend.v2';
 const SELECTION_SCHEMA = 'workbite.workspace-selection.v1';
+// Foreground UI per open: the familiar TypeScript Work Stack UI by default, the unified Rust UI on request.
+const FRONTENDS = Object.freeze(['typescript', 'rust']);
 const LOOPBACK = /^http:\/\/127\.0\.0\.1:([1-9][0-9]{0,4})$/;
 // Ports of the existing official StackBite and its previews are never chosen.
 const RESERVED_PORTS = new Set([8089, 8090, 8091, 54036, 54039, 54236, 54239]);
@@ -540,14 +542,22 @@ function runForeground(command, args, environment, { spawnImpl = spawn, signalSo
 
 // commands maps each bundle executable to its argv prefix; tests substitute fixtures.
 async function openSuite({ installed, commands, workspace, init = false, stateRoot, environment = process.env,
-  ui = true, spawnImpl = spawn, execImpl = execFile, platform = process.platform, stdout = process.stdout, timeouts = {} }) {
+  ui = true, frontend = 'typescript', spawnImpl = spawn, execImpl = execFile, platform = process.platform,
+  stdout = process.stdout, timeouts = {} }) {
+  if (!FRONTENDS.includes(frontend)) fail(`--frontend must be one of: ${FRONTENDS.join(', ')}`);
   if (workspace !== undefined) workspace = checkedWorkspace(workspace);
   else if (init) fail('--init needs --workspace ABS naming the new or empty folder');
   commands = commands || Object.fromEntries(Object.entries(installed.executables).map(([name, file]) => [name, [file]]));
-  // A v2 bundle always runs its execution UI; a v1 bundle keeps the legacy UI. There is no fallback between them.
+  // A v2 bundle keeps its owner/backend markers and native init whichever frontend runs; only the
+  // foreground UI differs. TypeScript is the default; rust needs a v2 bundle. There is no fallback between them.
   const execution = installed.bundle?.schema === BUNDLE_V2 ? { bundleVersion: installed.bundle.version } : null;
-  if (execution && !(Array.isArray(commands.workbite_tui) && commands.workbite_tui.length)) {
-    fail('This WorkBite bundle has no verified execution UI executable; nothing was started.');
+  if (frontend === 'rust' && !execution) {
+    fail('--frontend rust needs a WorkBite execution (v2) bundle; this installed bundle has only the TypeScript UI. Nothing was started.');
+  }
+  const uiCommand = frontend === 'rust' ? 'workbite_tui' : 'workstack_tui';
+  if (!(Array.isArray(commands[uiCommand]) && commands[uiCommand].length)) {
+    fail(frontend === 'rust' ? 'This WorkBite bundle has no verified execution UI executable; nothing was started.'
+      : 'This WorkBite bundle has no verified TypeScript UI executable; nothing was started.');
   }
   const layout = stateLayout(path.resolve(stateRoot));
   await prepareState(layout);
@@ -584,20 +594,21 @@ async function openSuite({ installed, commands, workspace, init = false, stateRo
   });
   const summary = { schema: 'workbite.open.v1', workspace, workspace_uid: session.uid, endpoint: session.engine.endpoint,
     owner_reused: session.engine.reused, stackbite_url: session.stackbite.url, stackbite_reused: session.stackbite.reused,
-    backend_id: session.backendId, state: layout.root,
+    backend_id: session.backendId, state: layout.root, frontend,
     ...(execution ? { execution_ui: session.executionUi, execution_bundle_version: execution.bundleVersion } : {}) };
   if (!ui) {
     stdout.write(JSON.stringify(summary) + '\n');
     return { code: 0, signal: null, summary };
   }
   const environmentForUi = uiEnvironment(base, { executables: installed.executables, layout, endpoint: session.engine.endpoint,
-    uid: session.uid, backendId: session.backendId, execution });
+    uid: session.uid, backendId: session.backendId, execution: frontend === 'rust' ? execution : null });
   // Exactly one foreground child in this terminal (inherited stdio, never detached or a new console).
-  const result = await runForeground(execution ? commands.workbite_tui : commands.workstack_tui, [], environmentForUi, { spawnImpl });
+  // The TypeScript UI gets the same environment as on a v1 bundle, so it keeps its own familiar settings file.
+  const result = await runForeground(commands[uiCommand], [], environmentForUi, { spawnImpl });
   return { ...result, summary };
 }
 
 module.exports = { cleanEnvironment, stateLayout, prepareState, ensureBackendId, workspaceKey, readWorkspaceUid,
   initializeWorkspace, engineIdentity, stackbiteIdentity, freePort, ensureEngine, ensureStackbite, writeDockConfig,
   withLock, uiEnvironment, openSuite, rememberedWorkspace, ensureExecutionSettings, initializeNativeRuntime, RESERVED_PORTS,
-  SELECTION_SCHEMA, EXECUTION_UI_DEFAULT, NATIVE_INIT_SCHEMA };
+  SELECTION_SCHEMA, EXECUTION_UI_DEFAULT, NATIVE_INIT_SCHEMA, FRONTENDS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workbite",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "WorkBite (Work Stack + StackBite) verified native suite installer and launcher",
   "license": "UNLICENSED",
   "engines": {

package/release.json

@@ -1,24 +1,24 @@
 {
   "schema": "workbite.release.v1",
   "product": "WorkBite",
-  "version": "0.1.4",
-  "launcherVersion": "0.1.4",
+  "version": "0.1.6",
+  "launcherVersion": "0.1.6",
   "repository": "Shinick-Han/WorkBite-releases",
-  "tag": "v0.1.4",
+  "tag": "v0.1.6",
   "platforms": {
     "windows-x64": {
-      "asset": "workbite-0.1.4-windows-x64.zip",
-      "sha256": "82150e6731bbe2cc00b08265ea5f97f12dc92e6213d32fc53ba4cd3bb1f98c50",
-      "size": 97936126,
-      "bundleSha256": "77efe214a312c14f4565075574541777a96e541ce3d0065d3e85184b0c4a2568",
-      "url": "https://github.com/Shinick-Han/WorkBite-releases/releases/download/v0.1.4/workbite-0.1.4-windows-x64.zip"
+      "asset": "workbite-0.1.6-windows-x64.zip",
+      "sha256": "7a639475361111a5afb8c04ac5d8532a125f57c1de00f9b1a6587356357bbe65",
+      "size": 97763242,
+      "bundleSha256": "aadb8ab699423879b6ce56a987ad3e1f2d242764f057fa249d8537f3e3841630",
+      "url": "https://github.com/Shinick-Han/WorkBite-releases/releases/download/v0.1.6/workbite-0.1.6-windows-x64.zip"
     },
     "linux-x64": {
-      "asset": "workbite-0.1.4-linux-x64.tar.gz",
-      "sha256": "f349f8c0eebbcf171a488bd1108d74b123cb57633ec6fc54c55c79532b47ae12",
-      "size": 81647804,
-      "bundleSha256": "aa37923f4dd74e8a12ceac09d26cea956a960ea6d34939be1bef303c79042222",
-      "url": "https://github.com/Shinick-Han/WorkBite-releases/releases/download/v0.1.4/workbite-0.1.4-linux-x64.tar.gz"
+      "asset": "workbite-0.1.6-linux-x64.tar.gz",
+      "sha256": "028f237823078d2adfb96d074b62ed1c8538879a46dd55252a49f43a0f2092b7",
+      "size": 81660896,
+      "bundleSha256": "3fb3d0b42341df58ee00664342407d00b3251795686300f1000261eb8dffe725",
+      "url": "https://github.com/Shinick-Han/WorkBite-releases/releases/download/v0.1.6/workbite-0.1.6-linux-x64.tar.gz"
     }
   }
 }