impel-cli 0.20.50 → 0.20.51

package/RELEASE_NOTES.md

@@ -1,5 +1,18 @@
 # Release notes
 
+## 0.20.51 — Restore Claude Tasks in the sidebar
+
+- Restores one embedded Tasks row in managed Claude's existing sidebar,
+  directly after the Home/Code switcher and before New and Customize.
+- Uses the same confined `WebContentsView` board lifecycle as ChatGPT while
+  keeping the native fallback disabled, so Tasks cannot cover Claude during
+  startup or create a second control window.
+- Promotes Claude's real pinned-app renderer smoke from boot-only to a required
+  UI contract: working surface, exact row placement, interactive tenant-bound
+  board, restored host navigation, screenshots, and credential/egress checks.
+- Advances the managed profile contract to v42 so installed Claude apps rewrite
+  the repaired preload and restart without rebuilding their vendor bundles.
+
 ## 0.20.50 — Restore ChatGPT Tasks safely
 
 - Restores one embedded Tasks entry in the managed ChatGPT sidebar while

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impel-cli",
-  "version": "0.20.50",
+  "version": "0.20.51",
   "description": "Prepare isolated Claude and Codex workspaces for every accessible Impel tenant",
   "type": "module",
   "bin": {

package/src/apps.js

@@ -882,7 +882,7 @@ export function installManagedAppFiles({
     writeDesktopTasksProfileAssets(
       paths[target].root,
       config.appUrl || RUNTIME_BRAND.controlPlane.defaultOrigin,
-      { enableEmbed: target === "chatgpt" },
+      { enableEmbed: true },
     );
     // Non-bundle targets are the background-refresh / fast-open path: configs,
     // token helper, catalog, and manifest only. Bundle swaps require the app

package/src/desktopTasks.js

@@ -286,10 +286,31 @@ const NAVIGATION_SOURCE = String.raw`(() => {
     delete window.__impelDesktopTasksSetActive;
   };
   const shellControls = controls().filter((element) => visible(element) && Boolean(label(element)));
+  const namedControl = (name) => shellControls.find((element) => [
+    element.getAttribute("aria-label"),
+    element.getAttribute("title"),
+    element.textContent,
+  ].some((value) => (value || "").replace(/\s+/g, " ").trim() === name)) || null;
+  const bounds = (element) => {
+    if (!element) return null;
+    const value = element.getBoundingClientRect();
+    return {
+      top: Math.round(value.top),
+      bottom: Math.round(value.bottom),
+      left: Math.round(value.left),
+      right: Math.round(value.right),
+    };
+  };
   return {
     anchor: lastAnchor ? label(lastAnchor) : null,
     connected: Boolean(nav?.isConnected),
     shellReady: shellControls.length >= 2,
+    placement: {
+      tasks: bounds(nav),
+      code: bounds(namedControl("Code")),
+      new: bounds(namedControl("New")),
+      customize: bounds(namedControl("Customize")),
+    },
   };
 })();`;
 
@@ -326,17 +347,24 @@ if (
   const tasksUrl = appOrigin + ${JSON.stringify(DESKTOP_TASKS_BOARD_PATH)};
   const readyMarker = ${JSON.stringify(DESKTOP_TASKS_READY_MARKER)};
   const nativeFallbackEnabled = ${JSON.stringify(enableNativeFallback)};
+  const smokeMode = process.env.IMPEL_DESKTOP_TASKS_SMOKE === "1";
+  const smokeDirectory = process.env.IMPEL_DESKTOP_TASKS_SMOKE_DIR || "";
   const boardSessionMaxAgeMs = 7 * 60 * 60 * 1000;
   const tenantId = process.env.IMPEL_DESKTOP_TASKS_TENANT;
   const nativeShowChannel = "impel-desktop-tasks:native-show";
   const runtimeStatusPath = path.join(__dirname, "runtime-status.json");
   const escapeRegex = ${escapeRegexSource};
   const parseCredential = ${parserSource};
-  const record = (stage) => {
+  const runtimeHistory = [];
+  const record = (stage, details = null) => {
     try {
+      runtimeHistory.push({ stage, details, at: new Date().toISOString() });
+      if (runtimeHistory.length > 32) runtimeHistory.shift();
       fs.writeFileSync(runtimeStatusPath, JSON.stringify({
         schemaVersion: 2,
         stage,
+        details,
+        history: runtimeHistory,
         processType: process.type || null,
         electronVersion: process.versions.electron || null,
         pid: process.pid,
@@ -344,6 +372,14 @@ if (
       }, null, 2) + "\\n", { mode: 0o600 });
     } catch {}
   };
+  const captureSmokeProof = async (name, capturer) => {
+    if (!smokeMode || !smokeDirectory || typeof capturer?.capturePage !== "function") return;
+    try {
+      fs.mkdirSync(smokeDirectory, { recursive: true });
+      const image = await capturer.capturePage();
+      fs.writeFileSync(path.join(smokeDirectory, name), image.toPNG(), { mode: 0o600 });
+    } catch { record("smoke-capture-failed", { name }); }
+  };
   const token = () => new Promise((resolve, reject) => {
     const childEnvironment = { ...process.env };
     for (const name of ["ANTHROPIC_API_KEY", "CODEX_ACCESS_TOKEN", "CODEX_API_KEY", "OPENAI_API_KEY"]) {
@@ -410,7 +446,7 @@ if (
     const stateFor = (window) => {
       let state = windows.get(window.id);
       if (!state) {
-        state = { view: null, bounds: null, visible: false, nativeNav: null, hasDomNavigation: false, loaded: false, loadedAt: 0, loading: null, bootstrapping: false };
+        state = { window, view: null, bounds: null, visible: false, nativeNav: null, hasDomNavigation: false, loaded: false, loadedAt: 0, loading: null, bootstrapping: false, smokeStarted: false };
         windows.set(window.id, state);
       }
       return state;
@@ -496,6 +532,35 @@ if (
         state.loaded = true;
         state.loadedAt = Date.now();
         record("board-loaded");
+        if (smokeMode && state.smokeStarted) {
+          let boardProof = null;
+          const proofDeadline = Date.now() + 15000;
+          while (!contents.isDestroyed() && Date.now() < proofDeadline) {
+            try {
+              boardProof = await contents.executeJavaScript(
+                "(() => { const ready = document.querySelector('[data-impel-desktop-board-ready=\\\"true\\\"]') !== null; const action = document.getElementById('board-action'); if (action) action.click(); return {ready,actionClicked:Boolean(action),interactive:Boolean(document.getElementById('board-result')?.textContent?.trim())}; })()",
+                true,
+              );
+            } catch {}
+            if (boardProof?.ready && boardProof?.interactive) break;
+            await new Promise((resolve) => setTimeout(resolve, 100));
+          }
+          record("board-smoke-verified", boardProof);
+          await captureSmokeProof("claude-tasks-board.png", contents);
+          let hostClick = null;
+          try {
+            hostClick = await state.window.webContents.mainFrame.executeJavaScript(
+              "(() => { const norm = value => (value || '').replace(/\\s+/g, ' ').trim(); const visible = element => { const rect = element.getBoundingClientRect(); const style = getComputedStyle(element); return rect.width > 0 && rect.height > 0 && style.display !== 'none' && style.visibility !== 'hidden'; }; const controls = [...document.querySelectorAll('button, a, [role=\\\"button\\\"], [role=\\\"link\\\"], [tabindex]')]; const hit = controls.find(element => visible(element) && [element.getAttribute('aria-label'), element.getAttribute('title'), element.textContent].some(value => norm(value) === 'New')); if (!hit) return {clicked:false}; hit.click(); return {clicked:true}; })()",
+              true,
+            );
+          } catch {}
+          const restoreDeadline = Date.now() + 3000;
+          while (state.visible && Date.now() < restoreDeadline) {
+            await new Promise((resolve) => setTimeout(resolve, 50));
+          }
+          record("navigation-smoke-restored", { hostClick, boardHidden: !state.visible });
+          await captureSmokeProof("claude-restored.png", state.window);
+        }
       } catch {
         state.loaded = false;
         state.loadedAt = 0;
@@ -724,30 +789,88 @@ if (
     const attachContents = (contents) => {
       if (!contents || contents.isDestroyed() || contents.__impelDesktopTasksAttached || internalContents.has(contents)) return;
       contents.__impelDesktopTasksAttached = true;
+      record("renderer-attached", {
+        type: typeof contents.getType === "function" ? contents.getType() : null,
+        hasMainFrame: Boolean(contents.mainFrame),
+      });
       const navigationNonce = randomBytes(32).toString("base64url");
       const contentsNavSource = navSource.replace(
         JSON.stringify(navigationNoncePlaceholder),
         JSON.stringify(navigationNonce),
       );
+      let injectionPending = false;
+      let navigationReady = false;
+      let injectionAttempts = 0;
+      let injectionTimer = null;
       const inject = () => {
-        if (internalContents.has(contents)) return;
+        if (navigationReady || injectionPending || internalContents.has(contents) || contents.isDestroyed()) return;
+        injectionAttempts += 1;
         const frame = contents.mainFrame;
-        if (!frame || typeof frame.executeJavaScript !== "function") return;
+        if (!frame || typeof frame.executeJavaScript !== "function") {
+          if (injectionAttempts < 120) scheduleInject(500);
+          return;
+        }
+        injectionPending = true;
         frame.executeJavaScript(contentsNavSource, true)
-          .then((result) => {
+          .then(async (result) => {
             const window = ownerWindow(contents);
             if (!window || window !== primaryHostWindow()) return;
             const state = stateFor(window);
+            record("navigation-probed", result || null);
+            const placementReady = Boolean(
+              result?.placement?.tasks
+              && result?.placement?.code
+              && result?.placement?.new
+              && result?.placement?.customize,
+            );
+            navigationReady = Boolean(result?.connected && (!smokeMode || placementReady));
             if (result?.anchor) {
               markDomNavigation(window);
             } else if (result?.shellReady && !state.hasDomNavigation && !hasDomNavigation && nativeFallbackEnabled) {
               ensureNativeNav(window);
             }
+            if (
+              smokeMode
+              && placementReady
+              && !state.smokeStarted
+            ) {
+              state.smokeStarted = true;
+              await captureSmokeProof("claude-navigation.png", window);
+              let clicked = false;
+              try {
+                clicked = await frame.executeJavaScript(
+                  "Boolean(document.getElementById('impel-desktop-tasks-nav')?.click?.() || true)",
+                  true,
+                );
+              } catch {}
+              record("navigation-smoke-clicked", { clicked: Boolean(clicked), placement: result.placement || null });
+            }
           })
-          .catch(() => record("navigation-injection-failed"));
+          .catch(() => record("navigation-injection-failed"))
+          .finally(() => {
+            injectionPending = false;
+            if (!navigationReady && injectionAttempts < 120 && !contents.isDestroyed()) scheduleInject(500);
+          });
       };
-      contents.on("did-finish-load", () => inject());
-      if (!contents.isLoadingMainFrame()) setTimeout(() => inject(), 0);
+      // Claude can create its renderer while this main preload is still being
+      // installed. In that race isLoadingMainFrame() is true but the one
+      // did-finish-load edge has already crossed, leaving the injection dormant
+      // forever. Probe immediately and at each renderer-ready edge; navSource
+      // is idempotent and its MutationObserver handles the later SPA mount.
+      const scheduleInject = (delay = 0) => {
+        if (navigationReady || injectionPending || injectionTimer !== null) return;
+        injectionTimer = setTimeout(() => {
+          injectionTimer = null;
+          inject();
+        }, delay);
+      };
+      contents.on("dom-ready", () => scheduleInject());
+      contents.on("did-finish-load", () => scheduleInject());
+      contents.once("destroyed", () => {
+        if (injectionTimer !== null) clearTimeout(injectionTimer);
+        injectionTimer = null;
+      });
+      scheduleInject();
       const handledNavigationEvents = new Set();
       let handledLegacyNavigation = null;
       const handleNavigation = (event, url) => {

package/src/managedProfileVersion.js

@@ -1,8 +1,7 @@
 // Fleet generation shared by managed-profile writers and upstream clients.
 // Keep this isolated from apps.js so latency-sensitive transports do not load
 // desktop bundle machinery just to identify their managed config contract.
-// v41 restores ChatGPT's embedded Tasks entry through its real sidebar only.
-// The native fallback stays disabled, and a valid authenticated board is
-// reused across hide/show cycles so it cannot obscure or repeatedly bootstrap
-// the host.
-export const CURRENT_CONFIG_VERSION = 41;
+// v42 restores Claude's embedded Tasks entry through its real sidebar, using
+// the same fallback-free, tenant-bound board lifecycle already enabled for
+// managed ChatGPT profiles.
+export const CURRENT_CONFIG_VERSION = 42;