token-harness 0.1.13 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-harness",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Quota-aware efficiency layer for Claude Code and Codex subscription limits.",
   "license": "Apache-2.0",
   "type": "module",

package/sbom.json

@@ -1,14 +1,14 @@
 {
   "bomFormat": "CycloneDX",
   "specVersion": "1.5",
-  "serialNumber": "urn:uuid:f53f4600-4e02-4fbe-462d-286326adfd0b",
+  "serialNumber": "urn:uuid:00b7739e-3dfa-0f35-6b77-d2f92796cd4d",
   "version": 1,
   "metadata": {
     "component": {
       "type": "application",
       "bom-ref": "token-harness",
       "name": "token-harness",
-      "version": "0.1.13",
+      "version": "0.1.15",
       "description": "Quota-aware efficiency layer for Claude Code and Codex subscription limits.",
       "licenses": [
         {
@@ -20,7 +20,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "f53f46004e024fbe462d286326adfd0be1a2e5d5c2678346e1e2e7e39bce853b"
+          "content": "00b7739e3dfa0f356b77d2f92796cd4d87fa151f04c568e476b4329fcee1eb81"
         }
       ]
     },

package/token-harness.mjs

@@ -9387,7 +9387,7 @@ var TOOL_VERSION;
 var init_version2 = __esm({
   "apps/cli/dist/src/version.js"() {
     "use strict";
-    TOOL_VERSION = "0.1.13";
+    TOOL_VERSION = "0.1.15";
   }
 });
 
@@ -31970,6 +31970,93 @@ var init_stack_combination_reviews = __esm({
 });
 
 // apps/cli/dist/src/guided.js
+function guideSetupTarget(report, harness, provider) {
+  const harnessDetection = report.harnesses.find((item) => item.harnessId === harness);
+  const detection = report.providers.find((item) => item.providerId === provider);
+  const label = name(provider);
+  if (harnessDetection === void 0 || harnessDetection.state === "absent") {
+    return {
+      providerId: provider,
+      provider: label,
+      state: "not-applicable",
+      reason: `${name(harness)} is not currently detected.`
+    };
+  }
+  if (detection === void 0) {
+    return {
+      providerId: provider,
+      provider: label,
+      state: "not-applicable",
+      reason: `${label} is not a managed provider in this build.`
+    };
+  }
+  if (detection.configuredHarnesses.includes(harnessDetection.harnessId)) {
+    return {
+      providerId: provider,
+      provider: label,
+      state: "connected",
+      reason: `${label} is configured for ${name(harness)}.`
+    };
+  }
+  const hasReviewedHarnessSurface = COMPATIBILITY_ROWS.some((row2) => row2.provider === provider && row2.harness === harnessDetection.harnessId);
+  if (!hasReviewedHarnessSurface) {
+    return {
+      providerId: provider,
+      provider: label,
+      state: "not-applicable",
+      reason: `Token Harness does not manage a reviewed ${label} connection for ${name(harness)}.`
+    };
+  }
+  if (detection.state === "absent" || detection.state === "available") {
+    return {
+      providerId: provider,
+      provider: label,
+      state: "unavailable",
+      reason: `${label} is not installed in a state Token Harness can configure automatically.`
+    };
+  }
+  if (detection.state === "broken") {
+    return {
+      providerId: provider,
+      provider: label,
+      state: "unavailable",
+      reason: `${label} is detected but its current integration needs attention before setup can continue.`
+    };
+  }
+  if (!detection.assignableHarnesses.includes(harnessDetection.harnessId)) {
+    return {
+      providerId: provider,
+      provider: label,
+      state: "unavailable",
+      reason: `The installed ${label} build does not expose a reviewed automatic setup for ${name(harness)}.`
+    };
+  }
+  const admission = admitManagedMutation(COMPATIBILITY_ROWS, {
+    provider: detection.providerId,
+    providerVersion: detection.version,
+    harness: harnessDetection.harnessId,
+    harnessVersion: harnessDetection.version,
+    os: report.platform.os,
+    wsl: report.platform.isWsl
+  });
+  if (admission.state !== "admitted") {
+    return {
+      providerId: provider,
+      provider: label,
+      state: "unavailable",
+      reason: `Automatic ${label} setup is not reviewed for the installed ${name(harness)} / ${label} version combination on ${report.platform.os}.`
+    };
+  }
+  return {
+    providerId: provider,
+    provider: label,
+    state: "actionable",
+    reason: `${label} can be configured automatically for ${name(harness)} with the reviewed transaction path.`
+  };
+}
+function guideSetupTargets(report, harness) {
+  return GUIDE_MANAGED_PROVIDERS.map((provider) => guideSetupTarget(report, harness, provider));
+}
 function explainGuideIssue(diagnostics, fallback) {
   const known = diagnostics.find((entry) => ISSUE_COPY[entry.code] !== void 0);
   if (known !== void 0)
@@ -31994,7 +32081,8 @@ function stackFingerprint(report) {
     version: item.version,
     versionVerdict: item.versionVerdict,
     managedByTokenHarness: item.managedByTokenHarness,
-    configuredHarnesses: [...item.configuredHarnesses].sort()
+    configuredHarnesses: [...item.configuredHarnesses].sort(),
+    assignableHarnesses: [...item.assignableHarnesses].sort()
   })).sort((left, right) => left.id.localeCompare(right.id));
   return JSON.stringify({ harnesses, providers });
 }
@@ -32212,7 +32300,7 @@ function describeChange(action, harness) {
     files: action.affectedPaths.length
   };
 }
-var GuideError, NAMES, name, TASKS, PERIODS, STACK_COMPONENTS, ISSUE_COPY, EFFORT_LABELS, SAFETY_RULES, TASK_RULES, READ_STAGES, GuideService;
+var GuideError, NAMES, name, GUIDE_MANAGED_PROVIDERS, RECOMMENDED_SETUP_PROVIDERS, TASKS, PERIODS, STACK_COMPONENTS, ISSUE_COPY, EFFORT_LABELS, SAFETY_RULES, TASK_RULES, READ_STAGES, GuideService;
 var init_guided = __esm({
   "apps/cli/dist/src/guided.js"() {
     "use strict";
@@ -32240,6 +32328,14 @@ var init_guided = __esm({
       headroom: "Headroom"
     };
     name = (id) => NAMES[id] ?? id;
+    GUIDE_MANAGED_PROVIDERS = [
+      "rtk",
+      "harnesstrim",
+      "mcptoon",
+      "gitnexus",
+      "headroom"
+    ];
+    RECOMMENDED_SETUP_PROVIDERS = ["rtk", "harnesstrim"];
     TASKS = /* @__PURE__ */ new Set(["mechanical", "standard", "hard", "critical"]);
     PERIODS = /* @__PURE__ */ new Set(["all", "7d", "30d"]);
     STACK_COMPONENTS = [
@@ -32542,6 +32638,8 @@ var init_guided = __esm({
           const providers = (doctor.data?.providers ?? []).filter((provider) => provider.state === "configured" && provider.configuredHarnesses.includes(agent.harnessId)).map((p) => p.providerId);
           const usage = budget.data?.harnesses.find((item) => item.harnessId === agent.harnessId);
           const observed = context.data?.harnesses.find((item) => item.harnessId === agent.harnessId);
+          const setup = doctor.data === null ? [] : guideSetupTargets(doctor.data, agent.harnessId);
+          const hasActionableSetup = setup.some((target) => target.state === "actionable");
           return {
             pending: [
               ...!complete2.rules ? ["reasoning"] : [],
@@ -32551,8 +32649,9 @@ var init_guided = __esm({
             name: name(agent.harnessId),
             version: agent.version,
             configured: providers.length > 0,
-            state: agent.state === "broken" ? "Needs attention" : providers.length > 0 ? "Integration configured" : "Ready to set up",
+            state: agent.state === "broken" ? "Needs attention" : providers.length > 0 ? "Integration configured" : hasActionableSetup ? "Ready to set up" : "No reviewed automatic setup available",
             providers: providers.map(name),
+            setup,
             effort: observed?.nativeEffort?.current ?? observed?.reasoningEffort ?? null,
             reasoning: reasoningView(agent.harnessId, observed),
             ...guidance?.[agent.harnessId] ? { guidance: guidance[agent.harnessId] } : {},
@@ -32753,30 +32852,49 @@ var init_guided = __esm({
           let network = false;
           for (const agent of selected) {
             this.record(`Preparing supported changes for ${name(agent.harnessId)}. No settings changed.`, "working");
-            const args = ["plan", "--harness", agent.harnessId];
-            if (data["action"] === "setup" && data["provider"] !== void 0)
-              args.push("--provider", String(data["provider"]));
-            if (data["action"] === "skill") {
-              args.push("--provider", "none", "--agent-skill");
-            } else if (data["action"] === "effort")
-              args.push("--provider", "none", "--native-policy", "--task", String(data["task"]), "--profile", data["task"] === "mechanical" ? "economy" : data["task"] === "standard" ? "balanced" : "quality");
-            const result6 = await this.call(args);
-            const report = result6.data;
-            if (report === null || result6.exitCode !== 0 || report.conflicts.length > 0 || report.actions.length === 0 || !report.persisted || report.planId === null) {
-              notices.push(`${name(agent.harnessId)}: ${explainGuideIssue(result6.diagnostics, data["action"] === "effort" ? "No supported preference change is needed or available. Your current preference is kept." : data["action"] === "skill" ? "In-session guidance is already present, or an existing user-owned skill location was left untouched." : "No safe setup change is available. The integration may already be configured, or a required provider is not installed.")}`);
-              continue;
-            }
-            plans.push(report.planId);
-            if (data["action"] === "skill") {
-              changes.push({
-                title: `${name(agent.harnessId)}: enable in-session guidance`,
-                description: "Installs one reviewed Token Harness Agent Skill in the standard user skill directory. It does not change model, login, billing, hooks, trust, or the current conversation.",
-                files: 1
-              });
+            const setupProviders = [];
+            if (data["action"] === "setup") {
+              const requested = data["provider"] === void 0 ? RECOMMENDED_SETUP_PROVIDERS : [String(data["provider"])];
+              for (const setupProvider of requested) {
+                const target = inventory.data === null ? null : guideSetupTarget(inventory.data, agent.harnessId, setupProvider);
+                if (target?.state === "actionable") {
+                  setupProviders.push(setupProvider);
+                } else if (target?.state === "connected") {
+                  notices.push(`${name(agent.harnessId)} \xB7 ${name(setupProvider)}: already connected. No setup change is needed.`);
+                } else if (target !== null) {
+                  notices.push(`${name(agent.harnessId)} \xB7 ${name(setupProvider)}: ${target.reason}`);
+                }
+              }
             } else {
-              changes.push(...report.actions.map((action2) => describeChange(action2, agent.harnessId)));
+              setupProviders.push(null);
+            }
+            for (const setupProvider of setupProviders) {
+              const args = ["plan", "--harness", agent.harnessId];
+              if (setupProvider !== null)
+                args.push("--provider", setupProvider);
+              if (data["action"] === "skill") {
+                args.push("--provider", "none", "--agent-skill");
+              } else if (data["action"] === "effort")
+                args.push("--provider", "none", "--native-policy", "--task", String(data["task"]), "--profile", data["task"] === "mechanical" ? "economy" : data["task"] === "standard" ? "balanced" : "quality");
+              const result6 = await this.call(args);
+              const report = result6.data;
+              if (report === null || result6.exitCode !== 0 || report.conflicts.length > 0 || report.actions.length === 0 || !report.persisted || report.planId === null) {
+                const subject = setupProvider !== null ? `${name(agent.harnessId)} \xB7 ${name(setupProvider)}` : name(agent.harnessId);
+                notices.push(`${subject}: ${explainGuideIssue(result6.diagnostics, data["action"] === "effort" ? "No supported preference change is needed or available. Your current preference is kept." : data["action"] === "skill" ? "In-session guidance is already present, or an existing user-owned skill location was left untouched." : "No safe setup change is available for the current provider, agent version and platform.")}`);
+                continue;
+              }
+              plans.push(report.planId);
+              if (data["action"] === "skill") {
+                changes.push({
+                  title: `${name(agent.harnessId)}: enable in-session guidance`,
+                  description: "Installs one reviewed Token Harness Agent Skill in the standard user skill directory. It does not change model, login, billing, hooks, trust, or the current conversation.",
+                  files: 1
+                });
+              } else {
+                changes.push(...report.actions.map((action2) => describeChange(action2, agent.harnessId)));
+              }
+              network ||= report.network.length > 0;
             }
-            network ||= report.network.length > 0;
           }
           if (selected.length === 0)
             notices.push("No supported coding agent was found. Install and sign in to Claude Code or Codex, then refresh.");
@@ -34840,9 +34958,20 @@ var init_guided_capabilities_client = __esm({
     return data;
   }
 
-  function markStale() {
-    $('stale-state').hidden = false;
-    $('stale-state').textContent = 'A reviewed change was applied. Displayed status is the previous state until you choose Refresh.';
+  async function waitForAutomaticRefresh() {
+    $('stale-state').hidden = true;
+    $('stale-state').textContent = '';
+    const spinner = $('reading-spinner');
+    const refresh = $('refresh');
+    let observedRefresh = false;
+    refresh.click();
+    const deadline = Date.now() + 120000;
+    while (Date.now() < deadline) {
+      if (!spinner.hidden) observedRefresh = true;
+      if (observedRefresh && spinner.hidden) return;
+      await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    throw new Error('The latest setup state could not be read automatically.');
   }
 
   async function applyTicket(ticket, title) {
@@ -34855,11 +34984,33 @@ var init_guided_capabilities_client = __esm({
       const result = await request('/api/apply', { ticket });
       if (activeRun !== runId) return;
       $('modal-title').textContent = result.ok ? title : 'Change needs attention';
-      $('modal-content').replaceChildren(message(result.ok ? 'Completed' : 'Needs attention', (result.messages || []).join(' ') || 'The transaction finished.', result.ok ? 'safe' : 'warn'));
-      if (result.ok) markStale();
+      $('modal-content').replaceChildren(
+        message(
+          result.ok ? 'Applied' : 'Needs attention',
+          (result.messages || []).join(' ') || 'The transaction finished.',
+          result.ok ? 'safe' : 'warn',
+        ),
+        progress(
+          'Refreshing the current setup',
+          'Please wait while Token Harness re-reads the latest agent and optimizer state.',
+        ),
+      );
+      $('modal-actions').replaceChildren(closeButton('Refreshing…', true));
+      await waitForAutomaticRefresh();
+      if (activeRun !== runId) return;
+      $('modal-content').replaceChildren(
+        message(
+          result.ok ? 'Completed and refreshed' : 'Action finished; status refreshed',
+          (result.messages || []).join(' ') || 'The latest setup state is now displayed.',
+          result.ok ? 'safe' : 'warn',
+        ),
+      );
       $('modal-actions').replaceChildren(closeButton('Done'));
     } catch (error) {
       if (activeRun !== runId) return;
+      $('stale-state').hidden = false;
+      $('stale-state').textContent =
+        'The action finished, but Token Harness could not automatically refresh the latest setup state.';
       $('modal-error').textContent = error.message;
       $('modal-error').hidden = false;
       $('modal-actions').replaceChildren(closeButton('Close'));
@@ -34881,14 +35032,22 @@ var init_guided_capabilities_client = __esm({
       const data = await request('/api/preview', body);
       if (activeRun !== runId || !$('modal').open) return;
       $('modal-content').replaceChildren();
-      if (!(data.changes || []).length)
-        $('modal-content').append(message('No managed change proposed', (data.notices || []).join(' ') || 'Nothing needs to be changed.'));
-      for (const change of data.changes || []) {
-        const item = node('article', undefined, 'preview-change');
-        item.append(node('h3', change.title), node('p', change.description));
-        $('modal-content').append(item);
-      }
-      for (const notice of data.notices || []) $('modal-content').append(node('p', notice, 'notice-row'));
+      if (!(data.changes || []).length) {
+        $('modal-content').append(
+          message(
+            'No managed change proposed',
+            (data.notices || []).join(' ') || 'Nothing needs to be changed.',
+          ),
+        );
+      } else {
+        for (const change of data.changes || []) {
+          const item = node('article', undefined, 'preview-change');
+          item.append(node('h3', change.title), node('p', change.description));
+          $('modal-content').append(item);
+        }
+        for (const notice of data.notices || [])
+          $('modal-content').append(node('p', notice, 'notice-row'));
+      }
       $('modal-content').append(message('Safety', 'Only Token Harness-owned changes can be applied or removed. User-owned provider installations and unrelated configuration are left untouched.', 'safe'));
       $('modal-actions').replaceChildren(closeButton(data.ticket ? 'Cancel' : 'Done'));
       if (data.ticket)
@@ -35304,22 +35463,61 @@ var init_guided_product_client = __esm({
     return (current?.stack?.components || []).filter(component => component.configured);
   }
 
-  function componentConfiguredFor(id, agentId) {
-    const component = managedComponent(id);
-    return Boolean(component?.configuredHarnesses?.includes(agentId));
+  function setupTarget(agentId, providerId) {
+    const agent = activeAgents().find(item => item.id === agentId);
+    return agent?.setup?.find(item => item.providerId === providerId) || null;
   }
 
-  function baselineReadyFor(agentId) {
-    return componentConfiguredFor('rtk', agentId) && componentConfiguredFor('harnesstrim', agentId);
+  function baselineStatusFor(agentId) {
+    const targets = ['rtk', 'harnesstrim']
+      .map(providerId => setupTarget(agentId, providerId))
+      .filter(Boolean);
+    const actionable = targets.filter(target => target.state === 'actionable');
+    const unavailable = targets.filter(target => target.state === 'unavailable');
+    const connected = targets.filter(target => target.state === 'connected');
+    if (actionable.length)
+      return {
+        state: 'incomplete',
+        label: 'Setup incomplete',
+        cls: 'warn',
+        actionable,
+        unavailable,
+        connected,
+      };
+    if (unavailable.length && connected.length === 0)
+      return {
+        state: 'unavailable',
+        label: 'No automatic setup',
+        cls: '',
+        actionable,
+        unavailable,
+        connected,
+      };
+    if (unavailable.length)
+      return {
+        state: 'limited',
+        label: 'Reviewed setup complete',
+        cls: 'good',
+        actionable,
+        unavailable,
+        connected,
+      };
+    return {
+      state: 'ready',
+      label: 'Ready',
+      cls: 'good',
+      actionable,
+      unavailable,
+      connected,
+    };
   }
 
   function baselineIncompleteAgents() {
-    return activeAgents().filter(agent => !baselineReadyFor(agent.id));
+    return activeAgents().filter(agent => baselineStatusFor(agent.id).state === 'incomplete');
   }
 
-  function providerSupportsAgent(providerId, agentId) {
-    if (providerId === 'gitnexus') return agentId === 'claude';
-    return agentId === 'claude' || agentId === 'codex';
+  function baselineUnavailableAgents() {
+    return activeAgents().filter(agent => baselineStatusFor(agent.id).state === 'unavailable');
   }
 
   function candidateObservation(id) {
@@ -35400,10 +35598,19 @@ var init_guided_product_client = __esm({
         cls: 'warn',
         title: incomplete.length === 1
           ? 'Finish setup for ' + incomplete[0].name
-          : 'Finish the recommended setup for your coding agents',
-        detail: 'The recommended baseline is RTK + HarnessTrim. Finish setup on each incomplete coding-agent card below; you will see the exact safe plan before anything changes.',
+          : 'Finish the available recommended setup for your coding agents',
+        detail: 'Every Finish setup action below has at least one reviewed provider change available for that exact agent, version and platform.',
         action: 'configure',
       };
+    const unavailable = baselineUnavailableAgents();
+    if (unavailable.length)
+      return {
+        label: 'No automatic setup',
+        cls: '',
+        title: 'No reviewed automatic setup is currently available',
+        detail: 'Token Harness will not show a setup button that cannot complete. The agent cards below explain which provider/version combination is not currently managed.',
+        action: 'none',
+      };
     if (!(current?.savings?.rows || []).length)
       return {
         label: 'Ready',
@@ -35457,7 +35664,7 @@ var init_guided_product_client = __esm({
     );
   }
 
-  function componentState(component) {
+  function componentState(id, component) {
     if (!component || component.detectedState === 'absent') return { label: 'Not installed', cls: '' };
     if (component.health === 'attention') return { label: 'Needs attention', cls: 'warn' };
     if (component.configured)
@@ -35465,14 +35672,19 @@ var init_guided_product_client = __esm({
         label: component.verification === 'verified' ? 'Connected · verified' : 'Connected',
         cls: 'good',
       };
-    if (component.installed) return { label: 'Installed · not connected', cls: '' };
+    const targets = activeAgents().map(agent => setupTarget(agent.id, id)).filter(Boolean);
+    if (component.installed && targets.some(target => target.state === 'actionable'))
+      return { label: 'Installed · setup available', cls: 'warn' };
+    if (component.installed && targets.some(target => target.state === 'unavailable'))
+      return { label: 'Installed · no automatic setup', cls: '' };
+    if (component.installed) return { label: 'Installed', cls: '' };
     return { label: 'Not installed', cls: '' };
   }
 
   function renderManagedTool(id) {
     const info = TOOL_INFO[id];
     const component = managedComponent(id);
-    const state = componentState(component);
+    const state = componentState(id, component);
     const card = node('article', undefined, 'tool-card');
     const head = node('div', undefined, 'tool-head');
     const title = node('div');
@@ -35485,9 +35697,20 @@ var init_guided_product_client = __esm({
 
     const facts = node('div', undefined, 'tool-facts');
     if (component?.version) facts.append(node('span', 'Installed version'), node('strong', 'v' + component.version));
+    const providerTargets = activeAgents()
+      .map(agent => ({ agent, target: setupTarget(agent.id, id) }))
+      .filter(item => item.target);
+    const actionableFor = providerTargets
+      .filter(item => item.target.state === 'actionable')
+      .map(item => item.agent.name);
+    const unavailableFor = providerTargets.filter(item => item.target.state === 'unavailable');
     const configuredFor = component?.configuredHarnesses?.length
       ? component.configuredHarnesses.map(agentName).join(', ')
-      : 'Not connected to a coding agent';
+      : actionableFor.length
+        ? 'Setup available for ' + actionableFor.join(', ')
+        : unavailableFor.length
+          ? 'No reviewed automatic connection is available'
+          : 'Not applicable to the detected coding agents';
     facts.append(node('span', 'Connection'), node('strong', configuredFor));
     if (component?.update === 'available')
       facts.append(
@@ -35498,6 +35721,19 @@ var init_guided_product_client = __esm({
       facts.append(node('span', 'Update'), node('strong', 'Newer version not reviewed yet'));
     card.append(facts);
 
+    if (
+      component?.installed &&
+      !(component?.configuredHarnesses?.length) &&
+      actionableFor.length === 0 &&
+      unavailableFor.length > 0
+    )
+      card.append(
+        messageBox(
+          'Why there is no Connect button',
+          unavailableFor[0].target.reason,
+        ),
+      );
+
     if (component?.warnings?.length) {
       const attention = component.health === 'attention';
       const prerequisite = !component.installed && component.nextAction?.kind === 'install-configure';
@@ -35512,18 +35748,16 @@ var init_guided_product_client = __esm({
     }
 
     const actions = node('div', undefined, 'inline-actions');
-    if (info.optional) {
-      for (const agent of activeAgents()) {
-        if (!providerSupportsAgent(id, agent.id)) continue;
-        if (!component?.configuredHarnesses?.includes(agent.id))
-          actions.append(
-            actionButton(
-              'Set up for ' + agent.name,
-              () => reviewSetup(agent.id, id),
-              'secondary',
-            ),
-          );
-      }
+    for (const agent of activeAgents()) {
+      const target = setupTarget(agent.id, id);
+      if (target?.state !== 'actionable') continue;
+      actions.append(
+        actionButton(
+          component?.installed ? 'Connect to ' + agent.name : 'Set up for ' + agent.name,
+          () => reviewSetup(agent.id, id),
+          'secondary',
+        ),
+      );
     }
     if (component?.update === 'available')
       actions.append(actionButton('Install update', () => readOnlyOperation('updates'), 'secondary'));
@@ -35550,7 +35784,7 @@ var init_guided_product_client = __esm({
       return;
     }
     for (const agent of activeAgents()) {
-      const ready = baselineReadyFor(agent.id);
+      const baseline = baselineStatusFor(agent.id);
       const card = node('article', undefined, 'tool-card compact');
       const head = node('div', undefined, 'tool-head');
       const title = node('div');
@@ -35558,16 +35792,18 @@ var init_guided_product_client = __esm({
         node('h3', agent.name),
         node('span', agent.version ? 'v' + agent.version : 'Version unavailable', 'caption'),
       );
-      head.append(title, pill(ready ? 'Ready' : 'Setup incomplete', ready ? 'good' : 'warn'));
-      card.append(
-        head,
-        node(
-          'p',
-          ready
-            ? 'RTK + HarnessTrim are configured for this coding agent.'
-            : 'The agent is detected. Finish the recommended RTK + HarnessTrim setup to complete onboarding.',
-        ),
-      );
+      head.append(title, pill(baseline.label, baseline.cls));
+      const detail =
+        baseline.state === 'incomplete'
+          ? 'A reviewed automatic setup is available for ' +
+            baseline.actionable.map(target => target.provider).join(' + ') +
+            '. Finish setup to review and apply it.'
+          : baseline.state === 'unavailable'
+            ? 'No reviewed automatic baseline change is available for this exact agent, provider versions and platform. Token Harness will not offer a no-op setup button.'
+            : baseline.state === 'limited'
+              ? 'All currently reviewed automatic baseline actions are complete. Other baseline combinations are not automatically changed on this version/platform.'
+              : 'All reviewed automatic baseline connections available for this coding agent are configured.';
+      card.append(head, node('p', detail));
       if (agent.providers?.length)
         card.append(
           node(
@@ -35576,10 +35812,16 @@ var init_guided_product_client = __esm({
             'caption',
           ),
         );
-      if (!ready) {
+      if (baseline.state === 'incomplete') {
         const actions = node('div', undefined, 'inline-actions');
         actions.append(actionButton('Finish setup', () => reviewSetup(agent.id)));
         card.append(actions);
+      } else if (baseline.unavailable.length) {
+        const details = node('details', undefined, 'agent-details');
+        details.append(node('summary', 'Why some automatic connections are unavailable'));
+        for (const target of baseline.unavailable)
+          details.append(node('p', target.provider + ': ' + target.reason, 'caption'));
+        card.append(details);
       }
       root.append(card);
     }
@@ -35601,7 +35843,7 @@ var init_guided_product_client = __esm({
         'Safe preview first',
         provider
           ? 'Token Harness will inspect only ' + provider.name + ' for ' + agent.name + '. If setup is supported, the exact change appears before you confirm it.'
-          : 'Token Harness will prepare the recommended RTK + HarnessTrim setup for ' + agent.name + '. The exact files and changes appear before you confirm them.',
+          : 'Token Harness will prepare only the reviewed RTK/HarnessTrim changes that are actually available for ' + agent.name + ' on this version and platform. The exact files and changes appear before you confirm them.',
       ),
       messageBox('Nothing changes yet', 'This first step only prepares the safe plan. You decide whether to apply it after seeing the concrete changes.'),
       progress('Checking ' + agent.name, 'Reading installed optimizer versions and current integration state.'),
@@ -35627,29 +35869,36 @@ var init_guided_product_client = __esm({
       .then(data => {
         if (run !== modalRun || !$('modal').open) return;
         pendingTicket = data.ticket;
+        if (!data.ticket) {
+          refreshOverviewAfterMutation('Refreshing setup availability after the review…').catch(
+            () => undefined,
+          );
+        }
         $('modal-content').replaceChildren();
         $('modal-content').append(
           messageBox(
             provider ? 'This optimizer only' : 'Recommended setup',
             provider
               ? 'This approval changes only ' + provider.name + ' for ' + agent.name + '. Other optimizers are left unchanged.'
-              : 'This approval covers only RTK + HarnessTrim for ' + agent.name + '. Optional optimizers stay separate.',
+              : 'This review includes only the currently actionable RTK/HarnessTrim changes for ' + agent.name + '. Unsupported or already-complete baseline providers are left out. Optional optimizers stay separate.',
           ),
         );
-        if (!data.changes.length)
+        if (!data.changes.length) {
           $('modal-content').append(
             messageBox(
               'No setup change available',
               (data.notices || []).join(' ') ||
-                'This setup is already complete, or a prerequisite/version prevents Token Harness from changing it safely.',
+                'No reviewed automatic change is available now. The dashboard is refreshing so an obsolete setup action is not left visible.',
             ),
           );
-        for (const change of data.changes) {
-          const item = node('article', undefined, 'preview-change');
-          item.append(node('h3', change.title), node('p', change.description));
-          $('modal-content').append(item);
+        } else {
+          for (const change of data.changes) {
+            const item = node('article', undefined, 'preview-change');
+            item.append(node('h3', change.title), node('p', change.description));
+            $('modal-content').append(item);
+          }
+          for (const notice of data.notices || []) $('modal-content').append(node('p', notice, 'notice-row'));
         }
-        for (const notice of data.notices || []) $('modal-content').append(node('p', notice, 'notice-row'));
         $('modal-content').append(messageBox('Safety', 'Apply uses the existing transactional engine with backups, compatibility checks, ownership checks and rollback. Unsupported versions are not forced.', 'safe'));
         $('modal-actions').replaceChildren(modalClose(data.ticket ? 'Cancel' : 'Done'));
         if (data.ticket)
@@ -35667,6 +35916,18 @@ var init_guided_product_client = __esm({
       });
   }
 
+  async function refreshOverviewAfterMutation(message = 'Refreshing setup after the approved change…') {
+    setStatus(message, true);
+    $('stale-state').hidden = true;
+    $('stale-state').textContent = '';
+    const period = $('period').value;
+    current = await request('/api/overview?period=' + encodeURIComponent(period) + '&refresh=1');
+    periodCache.set(period, current);
+    render();
+    await loadActivity();
+    setStatus('Updated at ' + new Date(current.generatedAt).toLocaleTimeString() + '.', false);
+  }
+
   async function applyTicket(ticket) {
     if (!ticket || busy) return;
     const run = modalRun;
@@ -35678,12 +35939,39 @@ var init_guided_product_client = __esm({
       const result = await request('/api/apply', { ticket });
       if (run !== modalRun) return;
       $('modal-title').textContent = result.title || (result.ok ? 'Setup completed' : 'Setup needs attention');
-      $('modal-content').replaceChildren(messageBox(result.ok ? 'Completed' : 'Needs attention', (result.messages || []).join(' '), result.ok ? 'safe' : 'warn'));
-      $('modal-content').append(node('p', 'The dashboard is now marked as previous state. Choose Refresh when you want to re-read the complete setup.', 'caption'));
-      $('stale-state').hidden = false;
-      $('stale-state').textContent = 'A setup change was applied. Displayed status is the previous state until you choose Refresh.';
+      $('modal-content').replaceChildren(
+        messageBox(result.ok ? 'Applied' : 'Needs attention', (result.messages || []).join(' '), result.ok ? 'safe' : 'warn'),
+        progress('Refreshing the current setup', 'Please wait while Token Harness re-reads agents, optimizer connections and health after the change.'),
+      );
+      $('modal-actions').replaceChildren(modalClose('Refreshing…', true));
+      try {
+        await refreshOverviewAfterMutation('Applying the new configuration and refreshing status…');
+        if (run !== modalRun) return;
+        $('modal-content').replaceChildren(
+          messageBox(
+            result.ok ? 'Completed and refreshed' : 'Action finished; status refreshed',
+            (result.messages || []).join(' ') || 'The latest setup state is now shown on the dashboard.',
+            result.ok ? 'safe' : 'warn',
+          ),
+        );
+      } catch (refreshError) {
+        if (run !== modalRun) return;
+        $('stale-state').hidden = false;
+        $('stale-state').textContent = 'The action finished, but Token Harness could not automatically refresh the latest setup state.';
+        $('modal-content').replaceChildren(
+          messageBox(
+            result.ok ? 'Change applied' : 'Action finished',
+            (result.messages || []).join(' ') || 'The action completed.',
+            result.ok ? 'safe' : 'warn',
+          ),
+          messageBox(
+            'Automatic refresh failed',
+            refreshError.message || 'The latest setup state could not be read automatically. Use Refresh to retry the status check.',
+            'warn',
+          ),
+        );
+      }
       $('modal-actions').replaceChildren(modalClose('Done'));
-      loadActivity();
     } catch (error) {
       if (run !== modalRun) return;
       $('modal-error').textContent = error.message;
@@ -36991,7 +37279,7 @@ ${GUIDE_CANDIDATE_READINESS_JS}`;
 </div>
 
 <section class="setup-step" id="coding-agents">
-<div class="section-title"><div><h2>Coding agents</h2><p>These are the harnesses Token Harness can configure today. A detected agent is not considered fully set up until the recommended RTK + HarnessTrim baseline is connected to it.</p></div></div>
+<div class="section-title"><div><h2>Coding agents</h2><p>Token Harness shows setup actions only when it has a reviewed automatic change for that exact agent, provider version and platform. Unsupported combinations are shown as unavailable instead of as unfinished work.</p></div></div>
 <div id="setup-agents" class="tool-grid"><article class="tool-card"><h3>Checking agents\u2026</h3></article></div>
 <details class="disclosure advanced-disclosure">
 <summary>Agent details and optional reasoning settings</summary>