clawdex-mobile 5.1.3-internal.8 → 5.1.3-internal.9

package/docs/setup-and-operations.md

@@ -84,10 +84,11 @@ gh codespace ports visibility 8787:public 8788:public
 
 ### Codespaces Bootstrap
 
-The repo devcontainer now includes:
+The source repo devcontainer now includes:
 
-- `postCreateCommand`: `npm install --include=dev && npm run codespaces:bootstrap -- --prepare-only`
-- `postStartCommand`: `npm run codespaces:bootstrap`
+- `updateContentCommand`: `npm install --include=dev --prefer-offline --no-audit --fund=false && npm run codespaces:bootstrap -- --prepare-only`
+- `postStartCommand`: fire-and-forget `npm run codespaces:bootstrap`, writing setup output to `.bridge-bootstrap.log`
+- `waitFor`: `updateContentCommand`
 
 `npm run codespaces:bootstrap` does the following:
 
@@ -99,9 +100,9 @@ The repo devcontainer now includes:
 
 Clawdex-created Codespaces request a 45-minute idle timeout. The bridge emits a lightweight active-turn keepalive while a Codex, OpenCode, or Cursor turn is running, so active work has activity even if a long step is otherwise quiet. When no turn is running, the keepalive stops and GitHub can pause the Codespace normally to save cost.
 
-That means the first Codespace create now front-loads the expensive bridge compile during `postCreateCommand`, so the later `postStartCommand` can usually start the bridge much faster.
+That means prebuild-enabled Codespaces can snapshot the expensive dependency install and bridge compile during `updateContentCommand`. The later `postStartCommand` starts the runtime bridge asynchronously so Codespaces does not block editor/app access while the bridge finishes warming up.
 
-The same bootstrap script is included in the published `clawdex-mobile` npm package. That lets the `clawdex-codespace` template stay minimal: it can install `clawdex-mobile@latest` globally in the devcontainer and invoke the packaged bootstrap against the current workspace instead of copying `scripts/*` and `services/rust-bridge/*` into the template repo.
+The same bootstrap script is included in the published `clawdex-mobile` npm package. That lets the `clawdex-codespace` template stay minimal: it installs `clawdex-mobile@internal` globally in `updateContentCommand` and invokes the packaged bootstrap against the current workspace instead of copying `scripts/*` and `services/rust-bridge/*` into the template repo. Because the published package ships Linux bridge binaries, the template does not need Rust, Cargo, or a local bridge compile.
 
 Manual examples:
 
@@ -115,7 +116,7 @@ CLAWDEX_CODESPACES_ENGINES=codex,opencode,cursor npm run codespaces:bootstrap
 Minimal template equivalent:
 
 ```bash
-npm install -g clawdex-mobile@latest @openai/codex
+npm install -g --no-fund --no-audit clawdex-mobile@internal @openai/codex
 CLAWDEX_WORKSPACE_ROOT="$PWD" node "$(npm root -g)/clawdex-mobile/scripts/codespaces-bootstrap.js" --prepare-only
 CLAWDEX_WORKSPACE_ROOT="$PWD" node "$(npm root -g)/clawdex-mobile/scripts/codespaces-bootstrap.js"
 ```

package/docs/troubleshooting.md

@@ -60,7 +60,7 @@ gh codespace ports visibility 8787:public 8788:public
 
 ## GitHub Codespaces bootstrap did not start the bridge
 
-- Check the post-start command output in the Codespace terminal or rerun it manually:
+- Check `.bridge-bootstrap.log` for the post-start bootstrap and `.bridge.log` for the bridge process, or rerun the bootstrap manually:
 
 ```bash
 npm run codespaces:bootstrap -- --prepare-only
@@ -81,8 +81,9 @@ CLAWDEX_WORKSPACE_ROOT="$PWD" node "$(npm root -g)/clawdex-mobile/scripts/codesp
 - Bridge startup logs and runtime state live in the Codespace repo root:
 
 ```bash
+tail -n 200 .bridge-bootstrap.log
 tail -n 200 .bridge.log
-ls -la .bridge.pid .bridge.log .env.secure
+ls -la .bridge.pid .bridge.log .bridge-bootstrap.log .env.secure
 ```
 
 - To only rewrite `.env.secure` without starting the bridge:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawdex-mobile",
-  "version": "5.1.3-internal.8",
+  "version": "5.1.3-internal.9",
   "description": "Private-network mobile bridge and CLI for Codex and OpenCode",
   "keywords": [
     "codex",

package/scripts/start-bridge-secure.js

@@ -16,6 +16,7 @@ const {
 } = require("./bridge-binary");
 
 const DEFAULT_HEALTH_TIMEOUT_MS = 15000;
+const CODESPACES_HEALTH_TIMEOUT_MS = 60000;
 const DEV_HEALTH_TIMEOUT_MS = 60000;
 let qrcodeTerminal = null;
 let qrcodeTerminalLoaded = false;
@@ -346,6 +347,13 @@ function formatCodespacesVisibilityCommand(env, ports) {
   return ["gh", "codespace", "ports", "visibility", ...visibilityArgs, ...selectionArgs].join(" ");
 }
 
+function sleepSync(ms) {
+  if (!Number.isFinite(ms) || ms <= 0) {
+    return;
+  }
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
 function updateCodespacesBrowseUrls(env, ports) {
   if (!commandExists("gh")) {
     return;
@@ -416,38 +424,57 @@ function ensureCodespacesPortsArePublic(env, ports) {
     return notes;
   }
 
-  const result = spawnSync(
-    "gh",
-    [
-      "codespace",
-      "ports",
-      "visibility",
-      ...uniquePorts.map((port) => `${port}:public`),
-      ...codespaceSelectionArgs(env),
-    ],
-    {
-      encoding: "utf8",
-      env: ghAuthEnv(env),
-      stdio: ["ignore", "pipe", "pipe"],
+  const publishedPorts = [];
+  const failedPorts = [];
+  const selectionArgs = codespaceSelectionArgs(env);
+
+  for (const port of uniquePorts) {
+    let lastDetail = "";
+    for (let attempt = 1; attempt <= 8; attempt += 1) {
+      const result = spawnSync(
+        "gh",
+        ["codespace", "ports", "visibility", `${port}:public`, ...selectionArgs],
+        {
+          encoding: "utf8",
+          env: ghAuthEnv(env),
+          stdio: ["ignore", "pipe", "pipe"],
+        }
+      );
+
+      if ((result.status ?? 1) === 0) {
+        publishedPorts.push(port);
+        lastDetail = "";
+        break;
+      }
+
+      lastDetail = (result.stderr || result.stdout || "").trim();
+      if (attempt < 8) {
+        sleepSync(1_500);
+      }
     }
-  );
 
-  if ((result.status ?? 1) !== 0) {
-    const detail = (result.stderr || result.stdout || "").trim();
-    const suffix = detail ? ` (${detail.split(/\r?\n/, 1)[0]})` : "";
+    if (lastDetail) {
+      failedPorts.push({ port, detail: lastDetail });
+    }
+  }
+
+  if (publishedPorts.length > 0) {
+    updateCodespacesBrowseUrls(env, publishedPorts);
     notes.push(
-      `Could not set Codespaces forwarded ports public automatically${suffix}. Run '${formatCodespacesVisibilityCommand(
+      `Codespaces forwarded ports are set to public for bridge access: ${publishedPorts.join(", ")}.`
+    );
+  }
+
+  for (const failure of failedPorts) {
+    const suffix = failure.detail ? ` (${failure.detail.split(/\r?\n/, 1)[0]})` : "";
+    notes.push(
+      `Could not set Codespaces forwarded port ${failure.port} public automatically${suffix}. Run '${formatCodespacesVisibilityCommand(
         env,
-        uniquePorts
+        [failure.port]
       )}' or update the Ports panel manually.`
     );
-    return notes;
   }
 
-  updateCodespacesBrowseUrls(env, uniquePorts);
-  notes.push(
-    `Codespaces forwarded ports are set to public for bridge access: ${uniquePorts.join(", ")}.`
-  );
   return notes;
 }
 
@@ -752,6 +779,10 @@ function buildBridgeFromSource(packageDir, env, profile) {
 }
 
 function resolveLaunch(workspaceDir, packageDir, env, { devMode, forceSourceBuild }) {
+  const defaultHealthTimeoutMs = isCodespacesMode(env)
+    ? CODESPACES_HEALTH_TIMEOUT_MS
+    : DEFAULT_HEALTH_TIMEOUT_MS;
+
   if (devMode) {
     if (!commandExists("cargo")) {
       console.error("error: missing Rust/Cargo toolchain for dev bridge mode.");
@@ -779,7 +810,7 @@ function resolveLaunch(workspaceDir, packageDir, env, { devMode, forceSourceBuil
       args: [],
       cwd: workspaceDir,
       env,
-      healthTimeoutMs: DEFAULT_HEALTH_TIMEOUT_MS,
+      healthTimeoutMs: defaultHealthTimeoutMs,
     };
   }
 
@@ -792,7 +823,7 @@ function resolveLaunch(workspaceDir, packageDir, env, { devMode, forceSourceBuil
       args: [],
       cwd: workspaceDir,
       env,
-      healthTimeoutMs: DEFAULT_HEALTH_TIMEOUT_MS,
+      healthTimeoutMs: defaultHealthTimeoutMs,
     };
   }
 
@@ -804,7 +835,7 @@ function resolveLaunch(workspaceDir, packageDir, env, { devMode, forceSourceBuil
       args: [],
       cwd: workspaceDir,
       env,
-      healthTimeoutMs: DEFAULT_HEALTH_TIMEOUT_MS,
+      healthTimeoutMs: defaultHealthTimeoutMs,
     };
   }
 
@@ -833,7 +864,7 @@ function resolveLaunch(workspaceDir, packageDir, env, { devMode, forceSourceBuil
     args: [],
     cwd: workspaceDir,
     env,
-    healthTimeoutMs: DEFAULT_HEALTH_TIMEOUT_MS,
+    healthTimeoutMs: defaultHealthTimeoutMs,
   };
 }
 

package/services/rust-bridge/Cargo.lock

@@ -149,7 +149,7 @@ dependencies = [
 
 [[package]]
 name = "codex-rust-bridge"
-version = "5.1.3-internal.8"
+version = "5.1.3-internal.9"
 dependencies = [
  "axum",
  "base64",

package/services/rust-bridge/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "codex-rust-bridge"
-version = "5.1.3-internal.8"
+version = "5.1.3-internal.9"
 edition = "2021"
 
 [dependencies]

package/services/rust-bridge/src/main.rs

@@ -8202,7 +8202,7 @@ fn thread_list_stream_request_params(include_sub_agents: bool, limit: usize) ->
     json!({
         "cursor": Value::Null,
         "limit": limit,
-        "sortKey": Value::Null,
+        "sortKey": "updated_at",
         "modelProviders": Value::Null,
         "sourceKinds": source_kinds,
         "archived": false,
@@ -8258,7 +8258,7 @@ async fn list_workspace_roots(
             Some(json!({
                 "cursor": Value::Null,
                 "limit": limit,
-                "sortKey": Value::Null,
+                "sortKey": "updated_at",
                 "modelProviders": Value::Null,
                 "sourceKinds": ["cli", "vscode", "exec", "appServer", "unknown"],
                 "archived": false,