@cats-inc/cats-platform 0.1.10 → 0.2.8

package/build/desktop/bootstrapPage.js

@@ -639,11 +639,11 @@ export function buildDesktopBootstrapPage() {
         'loading.ready': 'Ready.',
         'loading.retrying': 'Trying again\u2026',
         'loading.startingUp': 'Starting up\u2026',
-        'onboarding.headline': 'Welcome. Install a CLI now or continue into setup.',
+        'onboarding.headline': 'Choose which providers Cats may use, then continue into setup.',
         'onboarding.installCli': 'Install a CLI',
         'onboarding.installNodeFirst': 'Install Node first',
         'onboarding.nodeLabel': 'Node.js / npm',
-        'onboarding.nodeStatus': 'Required by npm CLIs',
+        'onboarding.ollamaLabel': 'Ollama',
         'onboarding.rescanClis': 'Detect again',
         'onboarding.scanClis': 'Detect installed CLIs',
         'onboarding.scanningClis': 'Detecting…',
@@ -657,7 +657,7 @@ export function buildDesktopBootstrapPage() {
         'recovery.summary.readyForSetup': 'Local helpers are running. Continue into setup to get started.',
         'recovery.title.failed': 'Cats needs a quick restart',
         'recovery.title.helperAttention': 'Cats can open, but one helper needs attention',
-        'recovery.title.installCliContinue': 'Install a CLI to continue using Cats',
+        'recovery.title.installCliContinue': 'Choose providers to continue using Cats',
         'recovery.title.oneSetupFix': 'Cats needs one setup fix',
         'recovery.title.pickCli': 'Pick a CLI to get started',
         'recovery.title.readyForSetup': 'Cats is ready to set up',
@@ -669,6 +669,12 @@ export function buildDesktopBootstrapPage() {
         'section.setupFix': 'Setup fix',
         'section.whatNeedsAttention': 'What needs attention',
         'setup.noSummary': 'No summary recorded.',
+        'selection.title': 'Choose your providers',
+        'selection.description': 'Cats only checks and uses the providers you select. Save an empty selection to continue without a provider.',
+        'selection.save': 'Save selection',
+        'selection.reload': 'Reload edited configuration',
+        'selection.reset': 'Discard unsaved changes',
+        'selection.loading': 'Loading provider selection…',
         'setup.recommendedNextStep': 'Recommended next step',
         'setup.restartNeeded': 'A restart is needed before the next step.',
         'setupError.failedBeforeStructuredOutput': '{helperLabel} failed before emitting structured output.',
@@ -760,8 +766,10 @@ export function buildDesktopBootstrapPage() {
         'status.error': 'error',
         'status.failed': 'failed',
         'status.info': 'info',
+        'status.checkingInstall': 'Checking…',
         'status.install': 'Install',
         'status.installed': 'Installed',
+        'status.notInstalled': 'Not installed',
         'status.installedWithCheck': '\u2713 Installed',
         'status.installing': 'Installing\u2026',
         'status.notDetected': 'Not detected yet',
@@ -892,11 +900,11 @@ export function buildDesktopBootstrapPage() {
         'loading.ready': '已就緒。',
         'loading.retrying': '正在重試…',
         'loading.startingUp': '正在啟動…',
-        'onboarding.headline': '歡迎。你可以現在安裝 CLI，或繼續進入設定。',
+        'onboarding.headline': '選擇 Cats 可以使用的 providers，再繼續設定。',
         'onboarding.installCli': '安裝 CLI',
         'onboarding.installNodeFirst': '請先安裝 Node',
         'onboarding.nodeLabel': 'Node.js / npm',
-        'onboarding.nodeStatus': 'npm CLI 需要此項',
+        'onboarding.ollamaLabel': 'Ollama',
         'onboarding.rescanClis': '重新偵測',
         'onboarding.scanClis': '偵測已安裝的 CLI',
         'onboarding.scanningClis': '偵測中…',
@@ -910,7 +918,7 @@ export function buildDesktopBootstrapPage() {
         'recovery.summary.readyForSetup': '本機輔助程式已在執行。請繼續進入設定開始使用。',
         'recovery.title.failed': 'Cats 需要快速重新啟動',
         'recovery.title.helperAttention': 'Cats 可以開啟，但有一個本機輔助程式需要處理',
-        'recovery.title.installCliContinue': '安裝 CLI 以繼續使用 Cats',
+        'recovery.title.installCliContinue': '選擇 providers 以繼續使用 Cats',
         'recovery.title.oneSetupFix': 'Cats 需要完成一項設定修復',
         'recovery.title.pickCli': '選一個 CLI 開始',
         'recovery.title.readyForSetup': 'Cats 已準備好進行設定',
@@ -922,6 +930,12 @@ export function buildDesktopBootstrapPage() {
         'section.setupFix': '設定修復',
         'section.whatNeedsAttention': '需要處理的項目',
         'setup.noSummary': '未記錄摘要。',
+        'selection.title': '選擇你要使用的 providers',
+        'selection.description': 'Cats 只會檢查與使用你選擇的 providers。也可以儲存空白選擇，稍後再設定。',
+        'selection.save': '儲存選擇',
+        'selection.reload': '重新載入已編輯的設定',
+        'selection.reset': '捨棄尚未儲存的變更',
+        'selection.loading': '正在載入 provider 選擇…',
         'setup.recommendedNextStep': '建議的下一步',
         'setup.restartNeeded': '下一步前需要重新啟動。',
         'setupError.failedBeforeStructuredOutput': '{helperLabel} 在輸出結構化結果前失敗。',
@@ -1013,8 +1027,10 @@ export function buildDesktopBootstrapPage() {
         'status.error': '錯誤',
         'status.failed': '失敗',
         'status.info': '資訊',
+        'status.checkingInstall': '檢查中…',
         'status.install': '安裝',
         'status.installed': '已安裝',
+        'status.notInstalled': '未安裝',
         'status.installedWithCheck': '\u2713 已安裝',
         'status.installing': '安裝中…',
         'status.notDetected': '尚未偵測',
@@ -1553,6 +1569,7 @@ export function buildDesktopBootstrapPage() {
           if (v == null || v === false) continue;
           if (k === 'class') e.className = v;
           else if (k === 'onclick') e.addEventListener('click', v);
+          else if (k === 'onchange') e.addEventListener('change', v);
           else if (k === 'disabled') e.disabled = true;
           else e.setAttribute(k, String(v));
         }
@@ -1603,13 +1620,9 @@ export function buildDesktopBootstrapPage() {
        when the user explicitly continues into setup. */
     var onboardingActive = false;
 
-    function isCliMissing(snapshot) {
-      return Boolean(
-        snapshot && snapshot.phase === 'needs_prerequisites'
-          && snapshot.prerequisites && snapshot.prerequisites.cliInventory
-          && snapshot.prerequisites.cliInventory.source === 'runtime'
-          && snapshot.prerequisites.cliInventory.total === 0
-      );
+    function isSelectionRequired(snapshot) {
+      var selection = snapshot && snapshot.prerequisites && snapshot.prerequisites.providerSelection;
+      return Boolean(selection && (selection.state === 'missing' || selection.state === 'invalid'));
     }
 
     function isSetupComplete(snapshot) {
@@ -1635,13 +1648,13 @@ export function buildDesktopBootstrapPage() {
       }
       if (
         usesSetupStatusOnboarding(snapshot)
-          && !setupComplete
+          && (!setupComplete || isSelectionRequired(snapshot))
           && snapshot.phase === 'ready_for_setup'
       ) {
         return 'onboarding';
       }
       if (snapshot.phase === 'needs_prerequisites') {
-        if (isCliMissing(snapshot) && !setupComplete) {
+        if (isSelectionRequired(snapshot) && !setupComplete) {
           return 'onboarding';
         }
         return 'recovery';
@@ -1652,21 +1665,25 @@ export function buildDesktopBootstrapPage() {
     /* CLI install card — used by onboarding mode AND the recovery accordion.
        First row favors CLIs that do not depend on Node/npm. Lower rows are
        collapsed until Show more is pressed, then npm prerequisites appear
-       before npm-based CLIs. */
+       before npm-based CLIs.
+
+       Ollama is deliberately absent from these lists: it is a local model
+       runtime, not a CLI provider, so the runtime scan never reports it. Its
+       card is built from the readiness audit instead (see
+       buildLocalModelCard). */
     var ONBOARDING_NATIVE_PROVIDER_ORDER = [
       'claude_code', 'antigravity', 'cursor_agent', 'kiro', 'junie',
-      'goose', 'grok', 'cline', 'devin', 'aider', 'ollama'
+      'goose', 'grok', 'devin', 'muse'
     ];
     var ONBOARDING_NPM_PROVIDER_ORDER = [
       'codex', 'copilot', 'opencode',
-      'kilo', 'auggie', 'pi'
+      'kilo', 'auggie', 'pi', 'cline'
     ];
     var ONBOARDING_NODE_HELPER_SUFFIX = '-node-host-installer';
+    var ONBOARDING_LOCAL_MODEL_HELPER_SUFFIX = '-ollama-local-model-installer';
     var ONBOARDING_CARD_LABELS = {
-      node: tx('onboarding.nodeLabel')
-    };
-    var ONBOARDING_CARD_STATUS = {
-      node: tx('onboarding.nodeStatus')
+      node: tx('onboarding.nodeLabel'),
+      ollama: tx('onboarding.ollamaLabel')
     };
     var ONBOARDING_PROVIDER_LABELS = {
       claude_code: 'Claude',
@@ -1684,23 +1701,23 @@ export function buildDesktopBootstrapPage() {
       grok: 'Grok',
       cline: 'Cline',
       devin: 'Devin',
-      aider: 'Aider',
-      ollama: 'Ollama'
+      muse: 'Meta Muse'
     };
     var cliInstallingState = Object.create(null);
     var cliScanInFlight = false;
     var onboardingExpanded = false;
 
     /* The runtime only fills in cliInventory after a setup scan has actually
-       run, and that scan is deliberately NOT part of the boot path — it spawns
-       one where/which lookup per provider and would add seconds to startup.
-       Until then every candidate arrives as installed:false, which is
+       run. The host now kicks that scan off in the background at startup, so
+       this is a window of a few seconds rather than a state the user is parked
+       in until they click Detect — but the window still exists, and until it
+       closes every candidate arrives as installed:false, which is
        indistinguishable from "we checked and it is missing". Render that as
        unknown instead of claiming the CLI is absent; the inventory's source
        field is the flag that tells the two apart. */
     function isCliInventoryScanned(snapshot) {
       var inv = snapshot && snapshot.prerequisites && snapshot.prerequisites.cliInventory;
-      return Boolean(inv && inv.source === 'runtime');
+      return Boolean(inv && inv.source === 'runtime' && inv.scannedAt);
     }
 
     function pickInventoryCandidate(snapshot, providerId) {
@@ -1744,45 +1761,133 @@ export function buildDesktopBootstrapPage() {
         || planned.indexOf('install_node_lts_via_nvm') >= 0;
     }
 
-    function isNodePrerequisiteReady(setupSnap) {
+    /* Last conclusive answer per audit-backed card.
+       setupSnap carries only the single most recent setup action, so installing
+       any CLI from this grid overwrites the audit result that these cards are
+       built from. Without a memory the Node card would fall back to "unknown"
+       every time the user installed something, which is the state it is least
+       able to leave on its own -- the audit only re-runs on its own terms. */
+    var lastKnownAuditState = { node: null, ollama: null };
+
+    function rememberAuditState(key, state) {
+      if (state !== 'checking') {
+        lastKnownAuditState[key] = state;
+      }
+      return state === 'checking' && lastKnownAuditState[key]
+        ? lastKnownAuditState[key]
+        : state;
+    }
+
+    /* 'checking' | 'ready' | 'missing'.
+       'checking' and 'missing' were previously the same value, so a card that
+       had not been looked at yet rendered exactly like one that had been looked
+       at and found absent -- a Node card reading "Install" while Node was in
+       fact installed. A failed audit resolves to 'missing' rather than
+       'checking': it is not coming back on its own, and an install button the
+       user can press beats a spinner that never stops. */
+    function resolveNodePrerequisiteState(setupSnap) {
       var action = setupSnap && setupSnap.state ? setupSnap.state.lastAction : null;
-      if (!action || action.runState === 'failed') return false;
+      if (!action) return rememberAuditState('node', 'checking');
+      if (action.runState === 'failed') return rememberAuditState('node', 'missing');
       if (isNodePrerequisiteHelperId(action.helperId)) {
-        return action.status === 'ready';
+        return rememberAuditState('node', action.status === 'ready' ? 'ready' : 'missing');
       }
       if (isReadinessAuditAction(action)) {
-        return !plannedActionsIncludeNodeInstall(action);
+        return rememberAuditState(
+          'node',
+          plannedActionsIncludeNodeInstall(action) ? 'missing' : 'ready'
+        );
       }
-      return false;
+      /* Some other helper ran and says nothing about Node. */
+      return rememberAuditState('node', 'checking');
+    }
+
+    function buildAuditBackedCard(helper, label, state) {
+      var ready = state === 'ready';
+      return {
+        helperId: helper ? helper.id : null,
+        label: label,
+        /* The status line carries a state in every card in this grid. It used
+           to carry the reason the card exists -- why npm CLIs depend on it --
+           which sits in the same place a state sits and therefore reads as one.
+           The state it implied was "you need this and do not have it", which
+           was wrong for the whole window before the audit reported. */
+        statusText: tx('status.notInstalled'),
+        installed: ready,
+        auditPending: state === 'checking',
+        available: helper ? helper.available : false,
+        supported: helper ? helper.supported : true,
+        supportsApply: ready || !helper ? false : helper.supportsApply
+      };
     }
 
     function buildNodePrerequisiteCard(setupSnap) {
       var helper = pickNodePrerequisiteHelper(setupSnap);
-      if (!helper) {
-        if (!setupSnap) {
-          return {
-            helperId: null,
-            label: ONBOARDING_CARD_LABELS.node,
-            statusText: ' ',
-            installed: false,
-            available: false,
-            supported: true,
-            supportsApply: false,
-            checkingHint: 'spinner-in-status'
-          };
-        }
+      if (!helper && setupSnap) {
         return null;
       }
-      var nodeReady = isNodePrerequisiteReady(setupSnap);
-      return {
-        helperId: helper.id,
-        label: ONBOARDING_CARD_LABELS.node,
-        statusText: ONBOARDING_CARD_STATUS.node,
-        installed: nodeReady,
-        available: helper.available,
-        supported: helper.supported,
-        supportsApply: nodeReady ? false : helper.supportsApply
-      };
+      return buildAuditBackedCard(
+        helper,
+        ONBOARDING_CARD_LABELS.node,
+        resolveNodePrerequisiteState(setupSnap)
+      );
+    }
+
+    function isLocalModelHelperId(helperId) {
+      return Boolean(helperId && helperId.indexOf(ONBOARDING_LOCAL_MODEL_HELPER_SUFFIX) > 0);
+    }
+
+    function pickLocalModelHelper(setupSnap) {
+      return pickSetupHelper(setupSnap, function (candidate) {
+        return candidate && isLocalModelHelperId(candidate.id);
+      });
+    }
+
+    function plannedActionsIncludeLocalModelInstall(action) {
+      var planned = action && Array.isArray(action.plannedActions) ? action.plannedActions : [];
+      return planned.indexOf('local_model:install_ollama_local_model') >= 0;
+    }
+
+    /* The audit reports installation and API readiness as separate planned
+       actions — start_ollama_local_model means the binary is already on disk,
+       the service just is not up. This card only ever claims installation, so
+       only the install action holds it back. A direct helper run reports the
+       same split through its status, and everything except not_installed
+       means the install itself landed. */
+    function resolveLocalModelState(setupSnap) {
+      var action = setupSnap && setupSnap.state ? setupSnap.state.lastAction : null;
+      if (!action) return rememberAuditState('ollama', 'checking');
+      if (action.runState === 'failed') return rememberAuditState('ollama', 'missing');
+      if (isLocalModelHelperId(action.helperId)) {
+        return rememberAuditState(
+          'ollama',
+          action.status !== 'not_installed' ? 'ready' : 'missing'
+        );
+      }
+      if (isReadinessAuditAction(action)) {
+        return rememberAuditState(
+          'ollama',
+          plannedActionsIncludeLocalModelInstall(action) ? 'missing' : 'ready'
+        );
+      }
+      return rememberAuditState('ollama', 'checking');
+    }
+
+    /* Ollama is not a CLI provider, so cats-runtime's setup scan has no entry
+       for it and its inventory candidate is hardcoded to installed:false —
+       a card driven from the inventory could never clear, not even right after
+       a successful install from that very card. Build it from the readiness
+       audit instead, exactly like the Node prerequisite card above. */
+    function buildLocalModelCard(setupSnap) {
+      var helper = pickLocalModelHelper(setupSnap);
+      if (!helper && setupSnap) {
+        return null;
+      }
+      return buildAuditBackedCard(
+        helper,
+        ONBOARDING_CARD_LABELS.ollama,
+        resolveLocalModelState(setupSnap)
+      );
     }
 
     function toProviderInstallCard(candidate, scanned) {
@@ -1858,6 +1963,14 @@ export function buildDesktopBootstrapPage() {
         statusClass = 'c-ok';
         statusContent = tx('status.installedWithCheck');
         btnContent = btnLabel;
+      } else if (card.auditPending) {
+        /* The readiness audit has not reported on this card yet. It runs
+           itself, so there is nothing for the user to press -- and pressing
+           Install here would act on an answer nobody has. */
+        btnLabel = tx('status.checkingInstall');
+        statusClass = '';
+        statusContent = tx('status.checkingInstall');
+        btnContent = spinnerEl();
       } else if (card.inventoryUnknown) {
         btnLabel = tx('status.detect');
         statusClass = '';
@@ -1868,11 +1981,6 @@ export function buildDesktopBootstrapPage() {
         statusClass = '';
         statusContent = card.statusText || ' ';
         btnContent = btnLabel;
-        if (card.checkingHint === 'spinner-in-status') {
-          statusContent = spinnerEl();
-        } else if (card.checkingHint === 'spinner-in-button') {
-          btnContent = spinnerEl();
-        }
       }
       var btn = el('button', {
         class: 'btn cli-card-btn',
@@ -1881,6 +1989,7 @@ export function buildDesktopBootstrapPage() {
            unknown — the CLI may well already be installed. */
         disabled: installing
           || cliScanInFlight
+          || card.auditPending
           || !card.available
           || !card.supported
           || (!card.inventoryUnknown && card.supportsApply === false),
@@ -1914,11 +2023,8 @@ export function buildDesktopBootstrapPage() {
         if (!candidate || !candidate.available) continue;
         var card = toProviderInstallCard(candidate, scanned);
         if (options && options.waitForNodePrerequisite) {
-          card.statusText = options.nodePrerequisiteStatusText || tx('onboarding.installNodeFirst');
+          card.statusText = tx('onboarding.installNodeFirst');
           card.supportsApply = false;
-          if (options.showCheckingSpinner) {
-            card.checkingHint = 'spinner-in-button';
-          }
         }
         card.collapsedSlot = ONBOARDING_COLLAPSED_PROVIDER_IDS.indexOf(providerId) !== -1;
         cards.push(card);
@@ -1930,17 +2036,26 @@ export function buildDesktopBootstrapPage() {
       var expanded = alwaysExpanded || onboardingExpanded;
       var entries = [];
       appendProviderCards(entries, snapshot, ONBOARDING_NATIVE_PROVIDER_ORDER);
+      /* Tail of the native row, where Ollama used to sit as a provider card. */
+      var localModelCard = pickInventoryCandidate(snapshot, 'ollama') ? buildLocalModelCard(setupSnap) : null;
+      if (localModelCard) {
+        entries.push(localModelCard);
+      }
       entries.push({ kind: 'break' });
-      var nodeCard = buildNodePrerequisiteCard(setupSnap);
+      var inventory = snapshot.prerequisites && snapshot.prerequisites.cliInventory;
+      var needsNode = inventory && inventory.candidates.some(function (entry) { return ONBOARDING_NPM_PROVIDER_ORDER.indexOf(entry.providerId) >= 0; });
+      var nodeCard = needsNode ? buildNodePrerequisiteCard(setupSnap) : null;
       if (nodeCard) {
         nodeCard.collapsedSlot = ONBOARDING_COLLAPSED_INCLUDES_NODE;
         entries.push(nodeCard);
       }
-      var nodeReady = isNodePrerequisiteReady(setupSnap);
+      /* Only a Node we know is missing holds the npm group back. While the
+         audit is still checking, these cards keep their own state: telling a
+         user to install Node first -- and taking Reinstall away from a CLI
+         they already have -- on the strength of an answer nobody has yet is
+         the same mistake the Node card itself was making. */
       appendProviderCards(entries, snapshot, ONBOARDING_NPM_PROVIDER_ORDER, {
-        waitForNodePrerequisite: !nodeReady,
-        nodePrerequisiteStatusText: setupSnap ? tx('onboarding.installNodeFirst') : ' ',
-        showCheckingSpinner: !setupSnap
+        waitForNodePrerequisite: resolveNodePrerequisiteState(setupSnap) === 'missing'
       });
 
       var elements = [];
@@ -2105,7 +2220,7 @@ export function buildDesktopBootstrapPage() {
     function recoveryTitle(snap) {
       if (snap.phase === 'failed') return tx('recovery.title.failed');
       if (snap.phase === 'needs_prerequisites') {
-        if (isCliMissing(snap)) {
+        if (isSelectionRequired(snap)) {
           return snap.app && snap.app.setupCompleteAt
             ? tx('recovery.title.installCliContinue')
             : tx('recovery.title.pickCli');
@@ -2129,7 +2244,7 @@ export function buildDesktopBootstrapPage() {
         return tx('recovery.summary.failedHelper');
       }
       if (snap.phase === 'needs_prerequisites') {
-        if (isCliMissing(snap)) {
+        if (isSelectionRequired(snap)) {
           return snap.app && snap.app.setupCompleteAt
             ? tx('recovery.summary.noCliAfterSetup')
             : tx('recovery.summary.noCliBeforeSetup');
@@ -2523,6 +2638,79 @@ export function buildDesktopBootstrapPage() {
       return 'retry';
     }
 
+    var selectionDraft = null;
+    var selectionDraftRevision = null;
+    var selectionSaving = false;
+    var selectionError = '';
+    function providerTargetKey(target) {
+      return JSON.stringify([target.provider, target.backend, target.instance]);
+    }
+    function hasSelectionDraftChanges(selection) {
+      if (!selectionDraft) return false;
+      var saved = selection.targets.map(providerTargetKey);
+      return selectionDraftRevision !== selection.revision || saved.length !== selectionDraft.length
+        || saved.some(function (key) { return selectionDraft.indexOf(key) < 0; });
+    }
+    function ProviderSelectionEditor(snap) {
+      var prerequisites = snap.prerequisites || {};
+      var selection = prerequisites.providerSelection;
+      if (!selection) return el('p', {}, tx('selection.loading'));
+      if (!selectionDraft) {
+        selectionDraft = selection.targets.map(providerTargetKey);
+        selectionDraftRevision = selection.revision;
+      }
+      var catalog = (prerequisites.providerCatalog || []).slice();
+      selection.targets.forEach(function (target) {
+        if (!catalog.some(function (entry) { return providerTargetKey(entry) === providerTargetKey(target); })) {
+          catalog.push(Object.assign({ familyLabel: target.provider }, target));
+        }
+      });
+      var choices = catalog.map(function (target) {
+        var key = providerTargetKey(target);
+        var checkbox = el('input', {
+          type: 'checkbox', disabled: selectionSaving,
+          onchange: function () {
+            selectionDraft = selectionDraft.filter(function (value) { return value !== key; });
+            if (this.checked) selectionDraft.push(key);
+            doRender();
+          }
+        });
+        checkbox.checked = selectionDraft.indexOf(key) >= 0;
+        return el('label', { class: 'cli-card' }, checkbox,
+          ' ' + target.familyLabel + ' (' + target.backend + '/' + target.instance + ')');
+      });
+      function saveSelection(reload) {
+        selectionSaving = true;
+        selectionError = '';
+        doRender();
+        bridge.saveProviderSelection({
+          targets: selectionDraft.map(function (key) {
+            var values = JSON.parse(key);
+            return { provider: values[0], backend: values[1], instance: values[2] };
+          }),
+          expectedRevision: reload ? selection.revision : selectionDraftRevision,
+          reload: reload
+        }).then(function (next) {
+          currentSnapshot = next;
+          selectionDraft = null;
+          selectionDraftRevision = null;
+        }).catch(function (error) {
+          selectionError = error && error.message ? error.message : String(error);
+        }).finally(function () { selectionSaving = false; doRender(); });
+      }
+      return el('section', { class: 'selection-editor' },
+        el('h2', {}, tx('selection.title')),
+        el('p', {}, tx('selection.description')),
+        el('div', { class: 'cli-grid' }, choices),
+        el('div', { class: 'onboarding-actions' },
+          el('button', { class: 'btn', disabled: selectionSaving, onclick: function () { saveSelection(false); } }, tx('selection.save')),
+          selection.diskChanged ? el('button', { class: 'btn', disabled: selectionSaving, onclick: function () { saveSelection(true); } }, tx('selection.reload')) : null,
+          hasSelectionDraftChanges(selection) ? el('button', { class: 'btn', disabled: selectionSaving, onclick: function () { selectionDraft = null; doRender(); } }, tx('selection.reset')) : null
+        ),
+        selectionError || selection.error ? el('p', { role: 'alert' }, selectionError || selection.error) : null
+      );
+    }
+
     function showOnboarding(snap) {
       onboardingActive = true;
       splashEl.classList.add('hidden');
@@ -2533,10 +2721,8 @@ export function buildDesktopBootstrapPage() {
 
       onboardingEl.innerHTML = '';
 
-      var legacyCliGate = snap.app && snap.app.onboardingMode === 'cli_inventory_gate';
-      var inventory = (snap.prerequisites && snap.prerequisites.cliInventory) || {};
-      var installedCount = Array.isArray(inventory.installed) ? inventory.installed.length : 0;
-      var continueDisabled = legacyCliGate && installedCount === 0;
+      var selection = snap.prerequisites && snap.prerequisites.providerSelection;
+      var continueDisabled = !selection || selection.state === 'missing' || selection.state === 'invalid' || hasSelectionDraftChanges(selection);
 
       var continueBtn = el('button', {
         class: 'btn',
@@ -2563,7 +2749,7 @@ export function buildDesktopBootstrapPage() {
         : (isCliInventoryScanned(snap) ? tx('onboarding.rescanClis') : tx('onboarding.scanClis'));
       actions.push(el('button', {
         class: 'btn',
-        disabled: cliScanInFlight,
+        disabled: cliScanInFlight || continueDisabled,
         onclick: handleCliScanClick
       }, scanLabel));
       if (cardSet.hasHiddenCards) {
@@ -2583,6 +2769,7 @@ export function buildDesktopBootstrapPage() {
         ),
         el('p', { class: 'onboarding-headline' },
           tx('onboarding.headline')),
+        ProviderSelectionEditor(snap),
         el('div', { class: 'onboarding-actions' }, actions),
         el('div', { class: 'cli-grid' }, cardSet.elements)
       );

package/build/desktop/bootstrapPage.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrapPage.js","sourceRoot":"","sources":["../../desktop/host/bootstrapPage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAisFD,CAAC;AACT,CAAC"}
+{"version":3,"file":"bootstrapPage.js","sourceRoot":"","sources":["../../desktop/host/bootstrapPage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA43FD,CAAC;AACT,CAAC"}

package/build/desktop/cliInventoryProbe.d.ts

@@ -1,16 +1,37 @@
 import { type DesktopCliInventory } from './contracts.js';
+import { type ProviderSelection, type ProviderSelectionCatalogEntry, type SelectedProviderTarget } from './providerSelection.js';
 export interface RuntimeCliInventoryProbe {
+    selection: ProviderSelection;
+    universe: ProviderSelectionCatalogEntry[];
+    bootstrapRequired?: boolean;
     state?: {
         status?: 'pending' | 'scanning' | 'ready' | 'applied' | 'error' | string;
         error?: string | null;
     } | null;
     scan: {
+        revision: string;
         scannedAt?: string | null;
-        providers: Array<{
-            provider: string;
+        providers: Array<SelectedProviderTarget & {
             available: boolean;
+            authStatus?: string;
         }>;
     } | null;
 }
+/**
+ * True when the runtime's own bootstrap answer on a probe disagrees with the
+ * one the caller has cached.
+ *
+ * The desktop snapshot phase is derived from a cached GET /health payload that
+ * is only refetched at startup and on a few user actions, never on a timer.
+ * Applying a provider config takes the runtime out of bootstrap in-process, so
+ * nothing tells the host: it keeps republishing "Cats Runtime setup is still
+ * required" from a payload captured before the apply, until the app restarts.
+ *
+ * Every probe already carries the runtime's current answer, so the
+ * disagreement is visible without asking for anything extra. A caller that has
+ * no cached answer yet, or a runtime too old to send the field, reports no
+ * disagreement -- absence of a signal is not a claim that the state changed.
+ */
+export declare function probeContradictsCachedBootstrapState(probe: RuntimeCliInventoryProbe | null, cachedBootstrapRequired: boolean | null): boolean;
 export declare function buildDesktopCliInventoryFromRuntime(probe: RuntimeCliInventoryProbe | null, platform?: NodeJS.Platform): DesktopCliInventory;
 //# sourceMappingURL=cliInventoryProbe.d.ts.map

package/build/desktop/cliInventoryProbe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cliInventoryProbe.d.ts","sourceRoot":"","sources":["../../desktop/host/cliInventoryProbe.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EAGzB,MAAM,gBAAgB,CAAC;AAKxB,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;QACzE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,GAAG,IAAI,CAAC;IACT,IAAI,EAAE;QACJ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAC5D,GAAG,IAAI,CAAC;CACV;AA8ED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wBAAwB,GAAG,IAAI,EACtC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,mBAAmB,CAsCrB"}
+{"version":3,"file":"cliInventoryProbe.d.ts","sourceRoot":"","sources":["../../desktop/host/cliInventoryProbe.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EAGzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAgC,KAAK,iBAAiB,EAAE,KAAK,6BAA6B,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAK/J,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,6BAA6B,EAAE,CAAC;IAK1C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;QACzE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,GAAG,IAAI,CAAC;IACT,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,EAAE,KAAK,CAAC,sBAAsB,GAAG;YAAE,SAAS,EAAE,OAAO,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxF,GAAG,IAAI,CAAC;CACV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,wBAAwB,GAAG,IAAI,EACtC,uBAAuB,EAAE,OAAO,GAAG,IAAI,GACtC,OAAO,CAKT;AA6FD,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wBAAwB,GAAG,IAAI,EACtC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,mBAAmB,CAiDrB"}