token-harness 0.1.14 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-harness",
-  "version": "0.1.14",
+  "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:8840bbd7-fcea-b78f-b033-a40bef562512",
+  "serialNumber": "urn:uuid:00b7739e-3dfa-0f35-6b77-d2f92796cd4d",
   "version": 1,
   "metadata": {
     "component": {
       "type": "application",
       "bom-ref": "token-harness",
       "name": "token-harness",
-      "version": "0.1.14",
+      "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": "8840bbd7fceab78fb033a40bef5625123772648c48cb4fea73b39020b714e9cf"
+          "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.14";
+    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] } : {},
@@ -32754,11 +32853,17 @@ var init_guided = __esm({
           for (const agent of selected) {
             this.record(`Preparing supported changes for ${name(agent.harnessId)}. No settings changed.`, "working");
             const setupProviders = [];
-            if (data["action"] === "setup" && data["harness"] !== void 0) {
-              if (data["provider"] === void 0) {
-                setupProviders.push("rtk", "harnesstrim");
-              } else {
-                setupProviders.push(String(data["provider"]));
+            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 {
               setupProviders.push(null);
@@ -32775,7 +32880,7 @@ var init_guided = __esm({
               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. The integration may already be configured, or a required provider is not installed.")}`);
+                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);
@@ -35358,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) {
@@ -35454,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',
@@ -35511,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)
@@ -35519,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');
@@ -35539,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(
@@ -35552,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';
@@ -35567,25 +35749,15 @@ var init_guided_product_client = __esm({
 
     const actions = node('div', undefined, 'inline-actions');
     for (const agent of activeAgents()) {
-      if (!providerSupportsAgent(id, agent.id)) continue;
-      if (component?.configuredHarnesses?.includes(agent.id)) continue;
-      if (info.optional) {
-        actions.append(
-          actionButton(
-            'Set up for ' + agent.name,
-            () => reviewSetup(agent.id, id),
-            'secondary',
-          ),
-        );
-      } else {
-        actions.append(
-          actionButton(
-            component?.installed ? 'Connect to ' + agent.name : 'Set up for ' + agent.name,
-            () => reviewSetup(agent.id, id),
-            'secondary',
-          ),
-        );
-      }
+      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'));
@@ -35612,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');
@@ -35620,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(
@@ -35638,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);
     }
@@ -35663,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.'),
@@ -35689,13 +35869,18 @@ 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) {
@@ -35703,7 +35888,7 @@ var init_guided_product_client = __esm({
             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.',
             ),
           );
         } else {
@@ -37094,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>