impel-cli 0.20.16 → 0.20.18

package/README.md

@@ -378,10 +378,14 @@ control-plane HTTP bearer credential, and fixes tenant selection in the
 transport header. Generated Claude/Codex MCP entries contain neither the PAT
 nor a tenant-derived credential.
 
-- The pinned Impel Claude Desktop can render the standard MCP Apps Tasks
-  resource when its host supports that protocol.
-- Claude Code and stable Codex receive complete headless task tools and text
-  results; no experimental Codex MCP Apps flag is enabled.
+- The pinned Impel Claude Desktop renders the standard MCP Apps task board when
+  its host supports that protocol.
+- The exact pinned Impel Codex desktop profile enables its reviewed
+  `enable_mcp_apps` contract so `show_tasks` can render the same board. The
+  vendor-pin test fails closed if the embedded Codex binary stops accepting it.
+- Claude Code and Codex CLI profiles remain headless and receive complete task
+  tools plus text results; the desktop-only renderer flag is never written to
+  those profiles.
 - Profiles preserve unrelated MCP servers. If a user-authored server already
   owns the `impel-tasks` name, setup/update fails with remediation instead of
   overwriting it.

package/RELEASE_NOTES.md

@@ -1,5 +1,22 @@
 # Release notes
 
+## 0.20.18 — Recoverable Codex profiling cohorts
+
+- Widens the bounded retry window for transient current-tenant reads while
+  still rejecting an exact tenant mismatch before a Codex attempt starts.
+- Stops scheduling new work after an attempt-infrastructure failure, waits for
+  active workers to settle, and retains an explicitly incomplete private
+  aggregate so valid samples are not silently lost.
+
+## 0.20.17 — Managed desktop task views
+
+- Enables the reviewed MCP Apps renderer only in exact managed Codex Desktop
+  profiles, while keeping Codex CLI profiles on their text and tool fallback.
+- Captures Claude permission, notification, and task lifecycle events through
+  the existing asynchronous, tenant-bound session hooks.
+- Preserves the additional lifecycle context needed to correlate task updates
+  without expanding the oversized-hook payload boundary.
+
 ## 0.20.16 — Correlated Codex transport timing
 
 - Derives native-agent MCP duration from correlated, timestamped Codex rollout

package/package.json

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

package/scripts/profile-native-codex.mjs

@@ -14,6 +14,7 @@ const PROFILE_SCHEMA = "impel.native-codex-profile.v1";
 const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;
 const DEFAULT_GRACE_MS = 5_000;
 const MAX_CAPTURE_BYTES = 256 * 1024 * 1024;
+const TENANT_PREFLIGHT_RETRY_DELAYS_MS = [250, 750, 1_500];
 
 function privateDirectory(directory) {
   if (fs.existsSync(directory) && fs.lstatSync(directory).isSymbolicLink()) {
@@ -211,16 +212,17 @@ function runCaptured(command, args, { environment = process.env, timeoutMs = 60_
 }
 
 async function currentTenant(impelBinary, environment) {
-  for (let attempt = 0; attempt < 2; attempt += 1) {
+  for (let attempt = 0; attempt <= TENANT_PREFLIGHT_RETRY_DELAYS_MS.length; attempt += 1) {
     const invocation = impelInvocation(impelBinary, ["tenant", "current"], environment);
     const result = await runCaptured(invocation.command, invocation.args, { environment });
     const lines = result.stdout.split(/\r?\n/u).map((line) => line.trim()).filter(Boolean);
     if (result.code === 0 && lines.length === 1 && /^[A-Za-z0-9_.:-]{1,160}$/u.test(lines[0])) {
       return lines[0];
     }
-    if (attempt === 0) await delay(250);
+    const retryDelay = TENANT_PREFLIGHT_RETRY_DELAYS_MS[attempt];
+    if (retryDelay !== undefined) await delay(retryDelay);
   }
-  throw new Error("could not establish one exact current Impel tenant after two bounded attempts");
+  throw new Error("could not establish one exact current Impel tenant after bounded attempts");
 }
 
 export async function assertExpectedTenant({ expectedTenant, impelBinary = "impel", environment = process.env }) {
@@ -495,19 +497,38 @@ async function profileAttempt(options, sessionDir, index) {
   return record;
 }
 
-async function runWorkers(options, sessionDir) {
+function profilerFailureClass(error) {
+  if (/could not establish one exact current Impel tenant/u.test(error?.message || "")) {
+    return "tenant-preflight-unavailable";
+  }
+  if (/selected tenant .* does not match expected tenant/u.test(error?.message || "")) {
+    return "tenant-mismatch";
+  }
+  return "attempt-infrastructure";
+}
+
+export async function runWorkers(options, sessionDir, profileAttemptImpl = profileAttempt) {
   const results = new Array(options.attempts);
   let next = 0;
+  let abort = null;
   const worker = async () => {
     for (;;) {
+      if (abort) return;
       const index = next;
       next += 1;
       if (index >= options.attempts) return;
-      results[index] = await profileAttempt(options, sessionDir, index);
+      try {
+        results[index] = await profileAttemptImpl(options, sessionDir, index);
+      } catch (error) {
+        abort ||= {
+          failureClass: profilerFailureClass(error),
+          attemptId: `${options.cohort}-${String(index + 1 + options.attemptOffset).padStart(3, "0")}`,
+        };
+      }
     }
   };
   await Promise.all(Array.from({ length: options.concurrency }, () => worker()));
-  return results;
+  return { attempts: results.filter(Boolean), abort };
 }
 
 async function restoreTenant(originalTenant, options) {
@@ -553,7 +574,7 @@ async function main(argv) {
   privateDirectory(sessionDir);
   let restored = false;
   try {
-    const attempts = await runWorkers(options, sessionDir);
+    const result = await runWorkers(options, sessionDir);
     const aggregate = {
       schema: PROFILE_SCHEMA,
       sessionId,
@@ -564,12 +585,18 @@ async function main(argv) {
       cohort: options.cohort,
       cliVersion: options.hostBuild,
       promptSha256: options.promptSha256,
-      attempts,
+      complete: result.abort === null && result.attempts.length === options.attempts,
+      expectedAttempts: options.attempts,
+      abort: result.abort,
+      attempts: result.attempts,
     };
     const aggregatePath = path.join(sessionDir, "aggregate.json");
     privateWrite(aggregatePath, `${JSON.stringify(aggregate, null, 2)}\n`);
     process.stderr.write(`Private Codex profile written under ${sessionDir}\n`);
     process.stdout.write(`${JSON.stringify(aggregate)}\n`);
+    if (!aggregate.complete) {
+      throw new Error(`cohort aborted (${aggregate.abort?.failureClass || "incomplete"}); partial aggregate retained`);
+    }
   } finally {
     restored = await restoreTenant(originalTenant, options);
     if (!restored) process.stderr.write("profile-native-codex: could not verify restoration of the original tenant\n");

package/src/apps.js

@@ -5,6 +5,7 @@ import crypto from "node:crypto";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import {
+  enableManagedCodexDesktopMcpApps,
   hardenManagedCodexToml,
   secureAllManagedCodexHomes,
   secureManagedCodexHome,
@@ -281,7 +282,9 @@ export function managedAppIdentity(target, tenantId = null, tenantName = null) {
 // expose direct-answer native agents through their one-shot local MCP binding.
 // 30: generate integrity-tracked top-level Codex profiles and direct code-mode
 // namespaces for fixed native-agent bindings.
-export const CURRENT_CONFIG_VERSION = 30;
+// 31: enable the reviewed MCP Apps renderer in pinned Codex Desktop profiles
+// and install Claude task, notification, and permission lifecycle hooks.
+export const CURRENT_CONFIG_VERSION = 31;
 
 // Identifies the bundle-BUILDING logic — the asar patches, plist rewrites,
 // helper rebranding, and signing. A vendored bundle is rebuilt only when this
@@ -1400,7 +1403,12 @@ function writeChatGPTConfig(
     CHATGPT_CONFIG_END,
   ].join("\n");
   const mergedToml = mergeManagedChatGPTToml(preservedToml, managedToml);
-  writeAtomic(configPath, hardenManagedCodexToml(mergedToml, configPath), 0o600);
+  const hardenedToml = hardenManagedCodexToml(mergedToml, configPath);
+  writeAtomic(
+    configPath,
+    enableManagedCodexDesktopMcpApps(hardenedToml, configPath),
+    0o600,
+  );
   secureManagedCodexHome(paths.chatgpt.codexHome);
 }
 

package/src/codexSecurity.js

@@ -148,6 +148,24 @@ export function hardenManagedCodexToml(toml, configPath = "managed Codex config"
   return applyManagedCodexSandboxPolicy(withoutCredentialSnapshots, configPath);
 }
 
+/**
+ * Enable the standard MCP Apps renderer only in the exact pinned desktop
+ * profile. CLI profiles deliberately stay headless, and vendor-pin contract
+ * tests must prove that the embedded Codex binary still recognizes this flag.
+ */
+export function enableManagedCodexDesktopMcpApps(
+  toml,
+  configPath = "managed Codex desktop config",
+) {
+  return upsertManagedScalar(
+    toml,
+    "features",
+    "enable_mcp_apps",
+    "true",
+    configPath,
+  );
+}
+
 function assertSafeManagedPath(target, expectedType) {
   const stat = lstatOrNull(target);
   if (!stat) return null;

package/src/sessionCollector.js

@@ -236,7 +236,8 @@ function compactLedgerPayload(input) {
   const keys = [
     "session_id", "hook_event_name", "cwd", "permission_mode", "model", "source", "reason",
     "turn_id", "prompt_id", "agent_id", "agent_type", "tool_name", "tool_use_id", "error",
-    "error_details", "last_assistant_message",
+    "error_details", "last_assistant_message", "notification_type", "message", "title",
+    "task_id", "task_subject", "task_description", "teammate_name", "tool_input",
   ];
   const payload = {};
   for (const key of keys) {

package/src/sessionHooks.js

@@ -12,10 +12,14 @@ const CODEX_TRUST_END = `# <<< ${RUNTIME_BRAND.product.id} managed session hook
 export const CLAUDE_SESSION_EVENTS = Object.freeze([
   "SessionStart",
   "UserPromptSubmit",
+  "PermissionRequest",
   "PostToolUse",
   "PostToolUseFailure",
+  "Notification",
   "SubagentStart",
   "SubagentStop",
+  "TaskCreated",
+  "TaskCompleted",
   "PreCompact",
   "PostCompact",
   "Stop",