workbite 0.1.5 → 0.1.7

package/README.md

@@ -3,13 +3,20 @@
 WorkBite installs and opens **Work Stack** (organizes the work) and
 **StackBite** (gets it moving) as one native suite.
 
-Launcher 0.1.5 (native bundle 0.1.4, unchanged) 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.
+Launcher 0.1.7 (native bundle 0.1.7) is a **Windows x64 only** release. It
+opens the familiar TypeScript Work Stack UI by default, which now has
+`9 Execution` in the same window: select a Task, start its agent, and see and
+control its native terminal without leaving the UI. The unified Rust UI stays
+an explicit alternative per open: `workbite open --frontend rust` (or bare
+`workbite --frontend rust`). Either frontend reuses the same owner and
+StackBite backend; the choice is not saved. Leaving the view or closing the UI
+keeps the agent running, and Task completion stays an explicit action.
+
+Linux x64: keep using `workbite@0.1.6` (native bundle 0.1.6, glibc 2.28+)
+until separate Linux compatibility work for this feature is done; 0.1.7 does
+not install on Linux. 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
@@ -19,7 +26,7 @@ workbite                                                   # afterwards (TypeScr
 workbite --frontend rust                                   # unified Rust UI with 9 Execution
 ```
 
-Node.js 20+ on Windows x64 or Linux x64 (glibc 2.28+).
+Node.js 20+ on Windows x64 (Linux x64: `npm install -g workbite@0.1.6`).
 
 - `workbite install` downloads the pinned bundle for your platform from
   `github.com/Shinick-Han/WorkBite-releases`, verifies its size and SHA-256 and
@@ -29,7 +36,7 @@ Node.js 20+ on Windows x64 or Linux x64 (glibc 2.28+).
 - `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
+  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

package/lib/cli.js

@@ -33,8 +33,9 @@ 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.
+  --frontend NAME  typescript (default): the familiar Work Stack UI, with same-window 9 Execution
+                   on execution bundles; rust: the explicit alternative unified UI (execution
+                   bundles only). Chosen per open, never saved.
 
 First time, name the workspace once:
   workbite open --workspace /abs/path/new-folder --init

package/lib/runtime.js

@@ -515,13 +515,25 @@ async function ensureExecutionSettings(file, attempt = 0) {
   return document.execution_ui.enabled ? 'enabled' : 'disabled';
 }
 
-function uiEnvironment(base, { executables, layout, endpoint, uid, backendId, execution = null }) {
+// The TypeScript UI's same-window 9 Execution (docs/WORKBITE-TYPESCRIPT-EXECUTION-CONFIG.md): set only by
+// this launcher for a verified v2 bundle whose device opt-in is enabled. The bridge is the bundle's own
+// verified workbite_tui (run by the UI with its fixed --workbite-execution-bridge argv), never a caller,
+// receipt or PATH value; the UI keeps its own WORKSTACK_TUI_SETTINGS, so these names carry the private
+// execution settings and intent paths separately. cleanEnvironment drops any caller WORKBITE_ value first.
+function typescriptExecutionEnvironment(layout, bridge) {
+  return { WORKBITE_EXECUTION_UI: '1', WORKBITE_EXECUTION_BRIDGE: bridge,
+    WORKBITE_EXECUTION_SETTINGS: layout.tuiSettings, WORKBITE_EXECUTION_INTENT: layout.tuiIntent };
+}
+const verifiedPath = value => typeof value === 'string' && path.isAbsolute(value) && !/[\x00-\x1f]/.test(value);
+
+function uiEnvironment(base, { executables, layout, endpoint, uid, backendId, execution = null, bridge = null }) {
   const home = path.dirname(executables.stackbite);
   return withPath({ ...base, WORKSTACK_TRANSPORT: 'native', WORKSTACK_NATIVE_CLIENT: executables.workstack_client,
     WORKSTACK_ENDPOINT: endpoint, WORKSTACK_WORKSPACE_UID: uid, WORKSTACK_STATE_DIR: layout.tuiState,
     WORKSTACK_EXECUTION_DOCK_CONFIG: layout.dock, WORKSTACK_EXECUTION_DOCK_BACKEND_ID: backendId,
     WORKSTACK_DEPLOY_JOURNAL_DIR: layout.journal, WORKSTACK_STACKBITE_EXECUTABLE: executables.stackbite,
-    ...(execution ? { WORKSTACK_TUI_STATE: layout.tuiIntent, WORKSTACK_TUI_SETTINGS: layout.tuiSettings } : {}) }, home);
+    ...(execution ? { WORKSTACK_TUI_STATE: layout.tuiIntent, WORKSTACK_TUI_SETTINGS: layout.tuiSettings } : {}),
+    ...(bridge ? typescriptExecutionEnvironment(layout, bridge) : {}) }, home);
 }
 
 function runForeground(command, args, environment, { spawnImpl = spawn, signalSource = process } = {}) {
@@ -559,6 +571,11 @@ async function openSuite({ installed, commands, workspace, init = false, stateRo
     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.');
   }
+  // A verified v2 bundle always holds the execution bridge; anything else is refused, never probed for.
+  const bridge = execution && frontend === 'typescript' ? installed.executables?.workbite_tui : null;
+  if (execution && frontend === 'typescript' && !verifiedPath(bridge)) {
+    fail('This WorkBite execution bundle has no verified execution bridge executable; nothing was started.');
+  }
   const layout = stateLayout(path.resolve(stateRoot));
   await prepareState(layout);
   const base = cleanEnvironment(environment);
@@ -601,9 +618,11 @@ async function openSuite({ installed, commands, workspace, init = false, stateRo
     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: frontend === 'rust' ? execution : null });
+    uid: session.uid, backendId: session.backendId, execution: frontend === 'rust' ? execution : null,
+    bridge: bridge && ['enabled', 'initialized'].includes(session.executionUi) ? bridge : null });
   // Exactly one foreground child in this terminal (inherited stdio, never detached or a new console).
-  // The TypeScript UI gets the same environment as on a v1 bundle, so it keeps its own familiar settings file.
+  // The TypeScript UI gets the v1 environment (keeping its own familiar settings file) plus, when the
+  // v2 opt-in is enabled, only the WORKBITE_EXECUTION_* names above.
   const result = await runForeground(commands[uiCommand], [], environmentForUi, { spawnImpl });
   return { ...result, summary };
 }

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "workbite",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "WorkBite (Work Stack + StackBite) verified native suite installer and launcher",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20"
   },
   "os": [
-    "win32",
-    "linux"
+    "win32"
   ],
   "cpu": [
     "x64"

package/release.json

@@ -1,24 +1,17 @@
 {
   "schema": "workbite.release.v1",
   "product": "WorkBite",
-  "version": "0.1.4",
-  "launcherVersion": "0.1.5",
+  "version": "0.1.7",
+  "launcherVersion": "0.1.7",
   "repository": "Shinick-Han/WorkBite-releases",
-  "tag": "v0.1.4",
+  "tag": "v0.1.7",
   "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"
-    },
-    "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.7-windows-x64.zip",
+      "sha256": "2b560376785c5e1c8cea670b753c779c0e57fd16433f577217f8ca68de9a6aa1",
+      "size": 97524335,
+      "bundleSha256": "5a6d347f7916695ff7b1f49bc48974e9da4188539e4ad1c81b5b0ef1af4b38ac",
+      "url": "https://github.com/Shinick-Han/WorkBite-releases/releases/download/v0.1.7/workbite-0.1.7-windows-x64.zip"
     }
   }
 }