pinokiod 8.0.58 → 8.0.61

package/kernel/vault/automatic_scans.js

@@ -10,7 +10,7 @@ const {
 } = require("./operation_errors")
 
 const COMPLETE_PHASES = new Set(["complete", "completed_with_exclusions"])
-const STOP_SETTLE_MS = 3000
+const STOP_SETTLE_MS = 1000
 const PROGRESS_INTERVAL_MS = 5000
 const isMissing = (error) => !!(error &&
   (error.code === "ENOENT" || error.code === "ENOTDIR"))
@@ -41,6 +41,7 @@ class AutomaticScans {
     this.waitingFor = null
     this.listeners = new Set()
     this.appTransitions = new Map()
+    this.globalScanReady = false
   }
 
   log(event, details = {}) {
@@ -134,7 +135,8 @@ class AutomaticScans {
   snapshot() {
     return {
       enabled: !!this.vault.enabled,
-      rows: [...this.entries.values()]
+      global_scan_ready: this.globalScanReady,
+      rows: (this.globalScanReady ? [...this.entries.values()] : [])
         .filter((entry) => !entry.hidden)
         .sort((left, right) =>
           (Number(left.updated_at) || 0) -
@@ -147,6 +149,14 @@ class AutomaticScans {
     }
   }
 
+  async refreshGlobalScanReady() {
+    const ready = typeof this.vault.globalScanReady === "function" &&
+      !!await this.vault.globalScanReady()
+    const changed = ready !== this.globalScanReady
+    this.globalScanReady = ready
+    return changed
+  }
+
   modeFor(app) {
     const setting = this.settings.get(app)
     return setting && setting.mode === "manual" ? "manual" : "automatic"
@@ -236,6 +246,10 @@ class AutomaticScans {
   }
 
   queueApp(app) {
+    if (!this.globalScanReady) {
+      this.log("queue-skipped", { app, reason: "global-scan-required" })
+      return false
+    }
     if (this.modeFor(app) === "manual") {
       this.log("queue-skipped", { app, reason: "manual" })
       return false
@@ -324,6 +338,12 @@ class AutomaticScans {
     this.log("preparing", { app })
     await this.vault.ensureRegistryInitialized()
     if (this.pendingStops.get(app) !== pending) return
+    await this.refreshGlobalScanReady()
+    if (!this.globalScanReady) {
+      this.pendingStops.delete(app)
+      this.log("check-skipped", { app, reason: "global-scan-required" })
+      return
+    }
     await this.hydrate()
     await this.withAppTransition(app, async () => {
       if (this.pendingStops.get(app) !== pending) return
@@ -395,6 +415,11 @@ class AutomaticScans {
     if (!this.hydrated && typeof this.vault.automaticScanStatus === "function") {
       await this.vault.automaticScanStatus()
     }
+    await this.refreshGlobalScanReady()
+    if (!this.globalScanReady) {
+      this.log("check-skipped", { app, reason: "global-scan-required" })
+      return
+    }
     if (this.modeFor(app) === "manual") {
       this.log("check-skipped", { app, reason: "manual" })
       return
@@ -547,14 +572,16 @@ class AutomaticScans {
 
   async drain() {
     if (!this.vault.enabled || !this.vault.registry || this.active) return
+    const entry = [...this.entries.values()].find((item) =>
+      item.state === "checking")
+    if (!entry) return
+    await this.refreshGlobalScanReady()
+    if (!this.globalScanReady) return
     if (this.manualDepth > 0 || this.currentBusyPromise() ||
         this.vault.fileActionProgress) {
       this.waitForBusyWork()
       return
     }
-    const entry = [...this.entries.values()].find((item) =>
-      item.state === "checking")
-    if (!entry) return
     let appAvailable
     try {
       appAvailable = await this.appRootIsAvailable(entry.app)
@@ -842,6 +869,7 @@ class AutomaticScans {
 
   async scanFinished({ scopeId, result, error }) {
     const complete = !error && result && COMPLETE_PHASES.has(result.outcome)
+    let readinessChanged = false
     try {
       if (complete) {
         await this.hydrate()
@@ -852,7 +880,9 @@ class AutomaticScans {
           { cancelPending: true, states: ["checking", "result"] }
         )
       }
+      if (!scopeId) readinessChanged = await this.refreshGlobalScanReady()
     } finally {
+      if (readinessChanged) this.broadcast()
       this.schedule()
     }
   }
@@ -897,6 +927,16 @@ class AutomaticScans {
       await this.persistMode(app, mode)
       const entry = this.entries.get(app)
       if (entry && entry.state === "paused") this.entries.delete(app)
+      await this.refreshGlobalScanReady()
+      if (!this.globalScanReady) {
+        this.log("mode-changed", {
+          app,
+          mode,
+          check: "global-scan-required"
+        })
+        this.broadcast()
+        return { app, mode }
+      }
       if (!this.appIsRunning(app)) {
         this.log("mode-changed", { app, mode })
         this.queueApp(app)

package/kernel/vault/index.js

@@ -73,6 +73,9 @@ const STATUS_FILTERS = new Set([
 const FOLDER_DISCOVERY_COMPLETE_PHASES = new Set([
   "complete", "completed_with_exclusions"
 ])
+const GLOBAL_SCAN_READY_OUTCOMES = new Set([
+  "complete", "completed_with_exclusions"
+])
 
 const isMissingError = (error) => !!(error &&
   (error.code === "ENOENT" || error.code === "ENOTDIR"))
@@ -672,9 +675,23 @@ class Vault {
       await this.ensureRegistryInitialized()
     }
     await this.automaticScans.hydrate()
+    await this.automaticScans.refreshGlobalScanReady()
     return this.automaticScans.snapshot()
   }
 
+  async globalScanReady() {
+    if (!this.registry) return false
+    const scan = await this.registry.scanFor()
+    if (scan) this.lastScanCache.set("", scan)
+    else this.lastScanCache.delete("")
+    return this.globalScanIsReady(scan)
+  }
+
+  globalScanIsReady(scan = this.lastScanCache.get("")) {
+    return !!(scan && scan.ts &&
+      GLOBAL_SCAN_READY_OUTCOMES.has(scan.outcome))
+  }
+
   async refreshAnchorStores() {
     let config = this.readConfig()
     const candidates = [
@@ -1790,9 +1807,19 @@ class Vault {
         return this.runMutation(() =>
           this.removeExternalSource(payload.source_id))
       case "scan": {
-        if (payload.scope_id && !this.scanSource(payload.scope_id)) {
+        const scanSource = payload.scope_id
+          ? this.scanSource(payload.scope_id)
+          : null
+        if (payload.scope_id && !scanSource) {
           return { error: "That scan location is no longer available." }
         }
+        if (scanSource && scanSource.kind === "app" &&
+            !await this.globalScanReady()) {
+          return {
+            error: "Run an initial scan before scanning individual apps.",
+            code: "global_scan_required"
+          }
+        }
         let threshold = this.sizeThreshold
         if (payload.candidate_size != null) {
           if (!CANDIDATE_SIZE_OPTIONS.includes(payload.candidate_size)) {
@@ -3266,6 +3293,9 @@ class Vault {
     }
 
     const lastScan = await this.scanForScope(scopeId)
+    const globalScanReady = scopeId
+      ? await this.globalScanReady()
+      : this.globalScanIsReady(lastScan)
     const before = lastScan && Number.isFinite(lastScan.bytes_total)
       ? lastScan.bytes_total
       : 0
@@ -3302,6 +3332,7 @@ class Vault {
     const sourceCounts = this.sourceCountMaps(snapshot.scopeRows)
     const result = {
       enabled: true,
+      global_scan_ready: globalScanReady,
       mode: this.mode,
       scan: this.scanStatus(),
       last_scan: lastScan,
@@ -3402,6 +3433,7 @@ class Vault {
   async progressStatus(scopeId = null) {
     const result = {
       enabled: !!this.enabled,
+      global_scan_ready: this.globalScanIsReady(),
       scan: this.scanStatus(),
       file_action: this.fileActionStatus(scopeId),
       last_scan: this.lastScanCache.get(scopeId || "") || null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pinokiod",
-  "version": "8.0.58",
+  "version": "8.0.61",
   "description": "",
   "main": "index.js",
   "scripts": {

package/server/index.js

@@ -1994,9 +1994,12 @@ class Server {
     if (vault && vault.ready) await vault.ready
     result.vault_enabled = !!(vault && vault.enabled)
     result.vault_automatic_mode = "automatic"
+    result.vault_global_scan_ready = false
     if (result.vault_enabled) {
       try {
         const snapshot = await vault.automaticScanStatus()
+        result.vault_global_scan_ready =
+          snapshot && snapshot.global_scan_ready === true
         const setting = Array.isArray(snapshot && snapshot.settings)
           ? snapshot.settings.find((item) =>
             item && item.app === name)

package/server/public/app-vault-mode.js

@@ -5,14 +5,22 @@
   const app = status.dataset.app || ""
   const tab = status.closest("#save-space-tab")
   const label = status.querySelector("[data-app-vault-mode-label]")
-  const setMode = (value) => {
+  const setState = (value, ready) => {
     const mode = value === "manual" ? "manual" : "automatic"
+    const globalScanReady = ready === true
     status.dataset.mode = mode
+    status.dataset.ready = String(globalScanReady)
     status.hidden = false
-    if (label) label.textContent = mode === "automatic" ? "Auto" : "Manual"
+    if (label) {
+      label.textContent = globalScanReady
+        ? (mode === "automatic" ? "Auto" : "Manual")
+        : "Set up"
+    }
     if (tab) {
       tab.setAttribute("aria-label",
-        `Disk Saver — ${mode === "automatic" ? "Automatic" : "Manual"} checking`)
+        globalScanReady
+          ? `Disk Saver — ${mode === "automatic" ? "Automatic" : "Manual"} checking`
+          : "Disk Saver — Set up required")
     }
   }
   const applySnapshot = (snapshot) => {
@@ -20,10 +28,11 @@
       ? snapshot.settings
       : []
     const setting = settings.find((item) => item && item.app === app)
-    setMode(setting && setting.mode)
+    setState(setting && setting.mode,
+      snapshot && snapshot.global_scan_ready === true)
   }
 
-  setMode(status.dataset.mode)
+  setState(status.dataset.mode, status.dataset.ready === "true")
   if (!app || typeof window.EventSource !== "function") return
 
   const source = new window.EventSource(

package/server/public/layout.js

@@ -1068,6 +1068,13 @@
     }
 
     function render(snapshot, options = {}) {
+      if (!snapshot || snapshot.global_scan_ready !== true) {
+        [...completions.keys()].forEach(removeCompletion);
+        visibleCheckingApps = new Set();
+        tray.replaceChildren();
+        tray.hidden = true;
+        return;
+      }
       const rows = snapshot && Array.isArray(snapshot.rows)
         ? snapshot.rows
         : [];

package/server/public/vault.css

@@ -218,6 +218,31 @@ body[data-vault-mode="app"] .vault-overview {
   letter-spacing: -.025em;
   line-height: 1.15;
 }
+.vault-setup-copy {
+  max-width: 560px;
+  margin: 8px 0 0;
+  color: var(--task-muted);
+  font-size: 12px;
+  line-height: 1.5;
+}
+.vault-body.setup-required .vault-overview {
+  min-height: 260px;
+  flex: 1 1 auto;
+  justify-content: center;
+  gap: 32px;
+  padding: 48px;
+  border-bottom: 0;
+}
+.vault-body.setup-required .vault-metrics.summary {
+  max-width: 620px;
+  flex: 0 1 620px;
+  grid-template-columns: minmax(0, 1fr);
+}
+.vault-body.setup-required .vault-summary-value {
+  margin-top: 8px;
+  font-size: 24px;
+}
+.vault-body.setup-required .vault-summary-side { display: none; }
 .vault-storage-chart {
   width: min(100%, 540px);
   min-width: 0;

package/server/public/vault.js

@@ -105,6 +105,9 @@ const COPY = {
   never: "Never",
   scan: "Scan",
   scan_app: "Scan this app",
+  setup_disk_saver: "Set up Disk Saver",
+  setup_title: "Run an initial scan to enable app scans",
+  setup_description: "This creates the file index used to compare apps and enables automatic checks.",
   scan_again: "Scan again",
   cancel_scan: "Cancel scan",
   scanning: "Scanning…",
@@ -533,6 +536,9 @@ const post = async (payload) => {
   if (!result) throw new Error(COPY.action_request_failed.replace("{status}", response.status))
   return result
 }
+const openGlobalWorkspace = () => {
+  window.parent.location.assign("/vault")
+}
 let automaticModeEventSource = null
 const applyAutomaticScanSnapshot = (snapshot) => {
   if (!IS_APP_MODE) return
@@ -543,9 +549,17 @@ const applyAutomaticScanSnapshot = (snapshot) => {
   const mode = setting && setting.mode === "manual"
     ? "manual"
     : "automatic"
-  if (state.automaticMode === mode) return
+  const globalScanReady = !!(snapshot &&
+    snapshot.global_scan_ready === true)
+  const readinessChanged = state.data &&
+    state.data.global_scan_ready !== globalScanReady
+  if (state.data) state.data.global_scan_ready = globalScanReady
+  if (state.automaticMode === mode && !readinessChanged) return
   state.automaticMode = mode
-  if (state.data) renderOverview()
+  if (state.data) {
+    if (readinessChanged) refresh(true)
+    else renderOverview()
+  }
 }
 const loadAutomaticMode = async () => {
   if (!IS_APP_MODE) return
@@ -2176,7 +2190,51 @@ const automaticModeMarkup = () => {
   </details>`
 }
 
-const renderOverview = () => {
+const appSetupRequired = () => IS_APP_MODE && state.data &&
+  state.data.global_scan_ready !== true
+
+const restoreAutomaticModeMenu = (open) => {
+  const modeMenu = el("vault-auto-mode")
+  if (modeMenu && open) modeMenu.open = true
+  if (!modeMenu || !state.automaticModeMenuRequested) return
+  state.automaticModeMenuRequested = false
+  modeMenu.classList.add("targeted")
+  const trigger = modeMenu.querySelector("summary")
+  requestAnimationFrame(() => {
+    if (trigger && trigger.isConnected) trigger.focus()
+  })
+  setTimeout(() => {
+    if (modeMenu.isConnected) modeMenu.classList.remove("targeted")
+  }, 1600)
+}
+
+const renderSetupOverview = () => {
+  const metrics = el("vault-metrics")
+  const existingModeMenu = el("vault-auto-mode")
+  const modeMenuOpen = !!(existingModeMenu && existingModeMenu.open) ||
+    state.automaticModeMenuRequested
+  metrics.classList.add("summary")
+  metrics.innerHTML = `
+    <div class="vault-summary-main">
+      <div class="vault-summary-label"><i class="fa-solid fa-hard-drive"></i><span>${esc(COPY.save_space)}</span>${automaticModeMarkup()}</div>
+      <div class="vault-summary-value">${esc(COPY.setup_title)}</div>
+      <p class="vault-setup-copy">${esc(COPY.setup_description)}</p>
+    </div>
+    <div class="vault-summary-side"></div>`
+  restoreAutomaticModeMenu(modeMenuOpen)
+
+  const scanButton = el("btn-scan")
+  scanButton.innerHTML = `<i class="fa-solid fa-arrow-right" aria-hidden="true"></i>${esc(COPY.setup_disk_saver)}`
+  scanButton.classList.add("primary")
+  scanButton.disabled = false
+  const candidateSizeSelect = el("vault-candidate-size")
+  if (candidateSizeSelect) candidateSizeSelect.hidden = true
+  const scanState = el("vault-scan-state")
+  scanState.classList.remove("show")
+  scanState.innerHTML = ""
+}
+
+const renderNormalOverview = () => {
   const data = state.data
   const last = data.last_scan
   const activeScan = scanActive(data.scan)
@@ -2251,19 +2309,7 @@ const renderOverview = () => {
         ${summary}
       </div>
       <div class="vault-summary-side">${summarySide}</div>`
-    const modeMenu = el("vault-auto-mode")
-    if (modeMenu && modeMenuOpen) modeMenu.open = true
-    if (modeMenu && state.automaticModeMenuRequested) {
-      state.automaticModeMenuRequested = false
-      modeMenu.classList.add("targeted")
-      const trigger = modeMenu.querySelector("summary")
-      requestAnimationFrame(() => {
-        if (trigger && trigger.isConnected) trigger.focus()
-      })
-      setTimeout(() => {
-        if (modeMenu.isConnected) modeMenu.classList.remove("targeted")
-      }, 1600)
-    }
+    restoreAutomaticModeMenu(modeMenuOpen)
   }
   const idleScanLabel = IS_APP_MODE
     ? (last ? COPY.scan_again : COPY.scan_app)
@@ -2289,7 +2335,10 @@ const renderOverview = () => {
     })
   }
   const candidateSizeSelect = el("vault-candidate-size")
-  if (candidateSizeSelect) candidateSizeSelect.disabled = activeScan
+  if (candidateSizeSelect) {
+    candidateSizeSelect.hidden = false
+    candidateSizeSelect.disabled = activeScan
+  }
   const scanControl = el("vault-scan-control")
   if (scanControl) scanControl.classList.toggle("single", activeScan)
   const scanSizeMenu = el("vault-scan-size-menu")
@@ -2369,6 +2418,14 @@ const renderOverview = () => {
   }
 }
 
+const renderOverview = () => {
+  if (appSetupRequired()) {
+    renderSetupOverview()
+    return
+  }
+  renderNormalOverview()
+}
+
 const renderResult = () => {
   const result = el("vault-result")
   if (!state.scanResult) {
@@ -2555,11 +2612,34 @@ const renderCleanupNotice = () => {
   notice.innerHTML = `<i class="fa-solid fa-broom" aria-hidden="true"></i><strong>${esc(title)}</strong><span class="vault-cleanup-notice-detail">${esc(detail)}</span><button class="vault-button" id="btn-review-cleanup" type="button">${esc(COPY.review_cleanup)}<i class="fa-solid fa-chevron-right" aria-hidden="true"></i></button>`
 }
 
+const clearPanel = (id, className) => {
+  const panel = el(id)
+  panel.className = className
+  panel.innerHTML = ""
+}
+
+const renderSetupWorkspace = () => {
+  renderSetupOverview()
+  renderFeedback()
+  el("vault-explorer").style.display = "none"
+  clearPanel("vault-action-state", "vault-action-state")
+  clearPanel("vault-result", "vault-result")
+  clearPanel("vault-cleanup-notice", "vault-cleanup-notice")
+  renderedActionProgress = null
+}
+
 const render = () => {
   if (!state.data) return
+  const setupRequired = appSetupRequired()
+  const body = document.querySelector(".vault-body")
+  if (body) body.classList.toggle("setup-required", setupRequired)
+  if (setupRequired) {
+    renderSetupWorkspace()
+    return
+  }
   renderOverview()
-  renderResult()
   renderFeedback()
+  renderResult()
   renderCleanupNotice()
   if (!state.data.enabled) {
     el("vault-explorer").style.display = "none"
@@ -2738,12 +2818,16 @@ const refresh = async (forceFull = false) => {
           folderDiscoveryActive(progress.folder_discovery) ||
           fileAction) {
         delay = 1500
-        renderOverview()
-        renderResult()
-        renderActionProgress()
-        renderFeedback()
-        renderExternalPrompt()
-        renderFolderDiscovery()
+        if (appSetupRequired()) {
+          renderSetupWorkspace()
+        } else {
+          renderOverview()
+          renderResult()
+          renderActionProgress()
+          renderFeedback()
+          renderExternalPrompt()
+          renderFolderDiscovery()
+        }
       } else {
         const data = await fetchJson(statusUrl())
         if (sequence !== refreshSequence) return
@@ -3553,6 +3637,10 @@ document.addEventListener("click", async (event) => {
       }
       return
     }
+    if (appSetupRequired()) {
+      openGlobalWorkspace()
+      return
+    }
     state.scanRequested = true
     state.scanBaseline = state.data.last_scan ? state.data.last_scan.ts : null
     state.scanResult = null

package/server/views/app.ejs

@@ -4121,12 +4121,18 @@ body.dark .disk-usage {
 .app-vault-mode[data-mode="automatic"] {
   color: #b45309;
 }
+.app-vault-mode[data-ready="false"] {
+  color: #b45309;
+}
 body.dark .app-vault-mode {
   color: rgba(203, 213, 225, 0.74);
 }
 body.dark .app-vault-mode[data-mode="automatic"] {
   color: #e0a54b;
 }
+body.dark .app-vault-mode[data-ready="false"] {
+  color: #e0a54b;
+}
 .app-vault-mode-chevron,
 .app-autolaunch-chevron {
   display: inline-flex;
@@ -8501,13 +8507,14 @@ body.dark .pinokio-custom-terminal-header {
         </button>
         <% if (typeof vault_enabled !== 'undefined' && vault_enabled) { %>
         <% const vaultAutomaticMode = typeof vault_automatic_mode === 'string' && vault_automatic_mode === 'manual' ? 'manual' : 'automatic' %>
-        <a id='save-space-tab' data-mode="refresh" target="app-vault" href="/vault/app/<%=encodeURIComponent(name)%>" class="btn header-item frame-link" data-index="vault" data-static="retain" data-tab-link-popover="false" aria-label="Disk Saver — <%=vaultAutomaticMode === 'automatic' ? 'Automatic' : 'Manual'%> checking">
+        <% const vaultGlobalScanReady = typeof vault_global_scan_ready !== 'undefined' && vault_global_scan_ready === true %>
+        <a id='save-space-tab' data-mode="refresh" target="app-vault" href="/vault/app/<%=encodeURIComponent(name)%>" class="btn header-item frame-link" data-index="vault" data-static="retain" data-tab-link-popover="false" aria-label="<%=vaultGlobalScanReady ? `Disk Saver — ${vaultAutomaticMode === 'automatic' ? 'Automatic' : 'Manual'} checking` : 'Disk Saver — Set up required'%>">
           <div class='tab'>
             <i class="fa-solid fa-hard-drive menu-action-leading-icon"></i>
             <div class='display'>Disk Saver</div>
             <div class='flexible'></div>
-            <span class="app-vault-mode" data-app-vault-mode data-app="<%=name%>" data-mode="<%=vaultAutomaticMode%>" aria-hidden="true">
-              <span data-app-vault-mode-label><%=vaultAutomaticMode === 'automatic' ? 'Auto' : 'Manual'%></span>
+            <span class="app-vault-mode" data-app-vault-mode data-app="<%=name%>" data-mode="<%=vaultAutomaticMode%>" data-ready="<%=vaultGlobalScanReady ? 'true' : 'false'%>" aria-hidden="true">
+              <span data-app-vault-mode-label><%=vaultGlobalScanReady ? (vaultAutomaticMode === 'automatic' ? 'Auto' : 'Manual') : 'Set up'%></span>
             </span>
             <i class="fa-solid fa-angle-down app-vault-mode-chevron" aria-hidden="true"></i>
           </div>

package/test/vault-automatic-scan-ui.test.js

@@ -50,6 +50,7 @@ test("the shared layout renders and reviews automatic possible-match notices", a
         status: 200,
         json: async () => ({
           enabled: true,
+          global_scan_ready: true,
           rows: []
         })
       }
@@ -72,6 +73,22 @@ test("the shared layout renders and reviews automatic possible-match notices", a
   eventSources[0].onmessage({
     data: JSON.stringify({
       enabled: true,
+      global_scan_ready: false,
+      rows: [{
+        app: "ComfyUI",
+        state: "checking",
+        notice_id: "checking:0:"
+      }]
+    })
+  })
+  assert.equal(dom.window.document.getElementById(
+    "vault-auto-scan-tray").hidden, true)
+  assert.equal(dom.window.document.querySelector(
+    ".vault-auto-scan-row"), null)
+  eventSources[0].onmessage({
+    data: JSON.stringify({
+      enabled: true,
+      global_scan_ready: true,
       rows: [{
         app: "ComfyUI",
         state: "result",
@@ -171,6 +188,7 @@ test("checking notices expose settings, Pause, and dismissal", async () => {
   eventSources[0].onmessage({
     data: JSON.stringify({
       enabled: true,
+      global_scan_ready: true,
       rows: [{
         app: "ComfyUI",
         state: "checking",
@@ -286,6 +304,7 @@ test("an empty automatic check briefly confirms completion", async () => {
         status: 200,
         json: async () => ({
           enabled: true,
+          global_scan_ready: true,
           rows: [],
           settings: [{ app: "ComfyUI", mode: "automatic" }]
         })
@@ -304,7 +323,7 @@ test("an empty automatic check briefly confirms completion", async () => {
   dom.window.eval(script)
   await waitFor(() => eventSources.length === 1)
   const send = (payload) => eventSources[0].onmessage({
-    data: JSON.stringify(payload)
+    data: JSON.stringify(Object.assign({ global_scan_ready: true }, payload))
   })
 
   send({
@@ -527,7 +546,7 @@ test("the app sidebar mirrors Automatic and Manual Disk Saver modes", async () =
   const script = await fs.promises.readFile(
     path.join(root, "server", "public", "app-vault-mode.js"), "utf8")
   const dom = new JSDOM(`<a id="save-space-tab">
-    <span data-app-vault-mode data-app="ComfyUI" data-mode="automatic">
+    <span data-app-vault-mode data-app="ComfyUI" data-mode="automatic" data-ready="true">
       <span data-app-vault-mode-label>Auto</span>
     </span>
   </a>`, {
@@ -557,6 +576,7 @@ test("the app sidebar mirrors Automatic and Manual Disk Saver modes", async () =
 
   eventSources[0].onmessage({
     data: JSON.stringify({
+      global_scan_ready: true,
       settings: [{ app: "ComfyUI", mode: "manual" }]
     })
   })
@@ -566,10 +586,32 @@ test("the app sidebar mirrors Automatic and Manual Disk Saver modes", async () =
   assert.equal(dom.window.document.getElementById("save-space-tab")
     .getAttribute("aria-label"), "Disk Saver — Manual checking")
 
-  eventSources[0].onmessage({ data: JSON.stringify({ settings: [] }) })
+  eventSources[0].onmessage({
+    data: JSON.stringify({ global_scan_ready: true, settings: [] })
+  })
   assert.equal(status.dataset.mode, "automatic")
   assert.equal(status.hidden, false)
   assert.equal(label.textContent, "Auto")
+
+  eventSources[0].onmessage({
+    data: JSON.stringify({
+      global_scan_ready: false,
+      settings: [{ app: "ComfyUI", mode: "automatic" }]
+    })
+  })
+  assert.equal(status.dataset.ready, "false")
+  assert.equal(label.textContent, "Set up")
+  assert.equal(dom.window.document.getElementById("save-space-tab")
+    .getAttribute("aria-label"), "Disk Saver — Set up required")
+
+  eventSources[0].onmessage({
+    data: JSON.stringify({
+      global_scan_ready: true,
+      settings: [{ app: "ComfyUI", mode: "automatic" }]
+    })
+  })
+  assert.equal(status.dataset.ready, "true")
+  assert.equal(label.textContent, "Auto")
   assert.match(template, /data-app-vault-mode/)
   assert.match(template, /app-vault-mode\.js/)
   assert.match(template,
@@ -592,6 +634,7 @@ test("the app sidebar mirrors Automatic and Manual Disk Saver modes", async () =
   assert.doesNotMatch(template, /app-vault-mode-dot/)
   assert.match(server,
     /result\.vault_automatic_mode = setting && setting\.mode === "manual"/)
+  assert.match(server, /result\.vault_global_scan_ready/)
 
   dom.window.close()
 })

package/test/vault-automatic-scans.test.js

@@ -39,6 +39,11 @@ const makeVault = async (home, options = {}) => {
   } else {
     await vault.init()
   }
+  const globalScanReady = options.globalScanReady !== undefined
+    ? !!options.globalScanReady
+    : true
+  vault.globalScanReady = async () => globalScanReady
+  vault.automaticScans.globalScanReady = globalScanReady
   return vault
 }
 
@@ -75,14 +80,32 @@ describe("automatic app checks", () => {
 
   test("reading notice state does not create Vault storage", async () => {
     const home = await makeHome()
-    const vault = await makeVault(home, { deferStorage: true })
+    const vault = await makeVault(home, {
+      deferStorage: true,
+      globalScanReady: false
+    })
 
-    assert.deepEqual((await vault.automaticScanStatus()).rows, [])
+    const status = await vault.automaticScanStatus()
+    assert.equal(status.global_scan_ready, false)
+    assert.deepEqual(status.rows, [])
     assert.equal(vault.initialized, false)
     assert.equal(fs.existsSync(path.join(home, "vault")), false)
     await close(vault)
   })
 
+  test("missing readiness state keeps automatic checks locked", async () => {
+    const automatic = new AutomaticScans({ enabled: true })
+
+    await automatic.refreshGlobalScanReady()
+
+    assert.equal(automatic.globalScanReady, false)
+    assert.deepEqual(automatic.snapshot().rows, [])
+  })
+
+  test("automatic checks wait one second after an app stops", () => {
+    assert.equal(AutomaticScans.STOP_SETTLE_MS, 1000)
+  })
+
   test("disabled Vault ignores app-stop events", async () => {
     const home = await makeHome()
     const appRoot = path.join(home, "api", "disabled-app")
@@ -111,6 +134,7 @@ describe("automatic app checks", () => {
         api: { running_paths: {} }
       },
       sources: () => [],
+      globalScanReady: async () => true,
       automaticScanStatus: async () => ({ rows: [] })
     }
     const automatic = new AutomaticScans(vault)
@@ -840,6 +864,7 @@ describe("automatic app checks", () => {
         }
       }
     })
+    automatic.globalScanReady = true
     automatic.hydrated = true
     automatic.log = () => {}
     automatic.active = {
@@ -904,6 +929,7 @@ describe("automatic app checks", () => {
         }
       }
     })
+    automatic.globalScanReady = true
     automatic.hydrated = true
     automatic.log = () => {}
     automatic.entries.set("demo", {

package/test/vault-engine.test.js

@@ -134,6 +134,77 @@ describe("Save Space engine", () => {
     await close(vault)
   })
 
+  test("global readiness accepts only successful publication outcomes", async () => {
+    const { vault } = await makeVault()
+    const scan = (outcome) => ({ ts: 1, outcome })
+
+    assert.equal(vault.globalScanIsReady(scan("complete")), true)
+    assert.equal(vault.globalScanIsReady(
+      scan("completed_with_exclusions")), true)
+    assert.equal(vault.globalScanIsReady(scan("cancelled")), false)
+    assert.equal(vault.globalScanIsReady(scan("failed")), false)
+    assert.equal(vault.globalScanIsReady(null), false)
+
+    await close(vault)
+  })
+
+  test("app scans stay locked until the first global scan is published", async () => {
+    const { home, vault } = await makeVault()
+    await write(path.join(home, "api", "demo", "model.bin"), "demo")
+    await vault.openWorkspace()
+    const source = vault.sources().find((item) =>
+      item.kind === "app" && item.app === "demo")
+
+    assert.equal(await vault.globalScanReady(), false)
+    assert.equal((await vault.status(source.id)).global_scan_ready, false)
+    assert.deepEqual(await vault.perform("scan", {
+      scope_id: source.id,
+      candidate_size: 0
+    }), {
+      error: "Run an initial scan before scanning individual apps.",
+      code: "global_scan_required"
+    })
+
+    assert.deepEqual(await vault.perform("automatic_set_mode", {
+      app: "demo",
+      mode: "automatic"
+    }), { app: "demo", mode: "automatic" })
+    const launchPath = path.join(home, "api", "demo", "start.js")
+    vault.automaticScans.handleStarted(launchPath)
+    await vault.automaticScans.handleStopped(launchPath)
+    assert.equal(vault.automaticScans.pendingStops.size, 0)
+    assert.deepEqual(vault.automaticScans.snapshot().rows, [])
+
+    assert.equal((await vault.perform("scan", {
+      candidate_size: 0
+    })).started, true)
+    await waitForEngine(() =>
+      !vault.scanPromise && !vault.scanCompletionPromise)
+
+    assert.equal(await vault.globalScanReady(), true)
+    await vault.automaticScans.scanFinished({
+      scopeId: null,
+      result: { outcome: "cancelled" },
+      error: null
+    })
+    assert.equal(await vault.globalScanReady(), true)
+    await vault.automaticScans.scanFinished({
+      scopeId: null,
+      result: null,
+      error: new Error("scan failed")
+    })
+    assert.equal(await vault.globalScanReady(), true)
+    assert.equal(vault.automaticScans.active, null)
+    assert.deepEqual(vault.automaticScans.snapshot().rows, [])
+    assert.equal((await vault.perform("scan", {
+      scope_id: source.id,
+      candidate_size: 0
+    })).started, true)
+    await waitForEngine(() =>
+      !vault.scanPromise && !vault.scanCompletionPromise)
+    await close(vault)
+  })
+
   test("locations and anchor stores persist in the Disk Saver config", async () => {
     const base = await makeHome()
     const home = path.join(base, "pinokio")
@@ -903,6 +974,7 @@ describe("Save Space engine", () => {
     const outside = await makeOutside()
     const pair = await duplicatePair(home)
     await vault.sweeper.scan()
+    assert.equal(await vault.globalScanReady(), true)
     const duplicate = [...await vault.registry.files({
       statuses: ["duplicate"]
     })][0]
@@ -922,6 +994,7 @@ describe("Save Space engine", () => {
     replacement.sizeThreshold = pair.contents.length * 2
 
     assert.deepEqual(replacement.configuredLocations(), [])
+    assert.equal(await replacement.globalScanReady(), false)
     assert.equal(await replacement.registry.countFiles(), 0)
     assert.equal(fs.existsSync(anchorPath), true)
     await replacement.sweeper.scan()

package/test/vault-ui.test.js

@@ -49,6 +49,7 @@ const fixture = (items = [], overrides = {}) => {
   const shared = items.filter((entry) => entry.status === "shared")
   return Object.assign({
     enabled: true,
+    global_scan_ready: true,
     mode: "link",
     scan: {
       active: false,
@@ -162,6 +163,7 @@ const makePage = async (status, options = {}) => {
     }
   )
   const requests = []
+  const parentNavigations = []
   const selectedSources = new Set(options.folderDiscoverySelected || [])
   const recommendedSources = new Set()
   const confirmations = []
@@ -249,6 +251,18 @@ const makePage = async (status, options = {}) => {
   }
   dom.window.requestAnimationFrame = (callback) =>
     dom.window.setTimeout(callback, 0)
+  if (options.embeddedApp) {
+    Object.defineProperty(dom.window, "parent", {
+      configurable: true,
+      value: {
+        location: {
+          assign(target) {
+            parentNavigations.push(target)
+          }
+        }
+      }
+    })
+  }
   if (options.fastStatusRetry) {
     const setTimeout = dom.window.setTimeout.bind(dom.window)
     dom.window.setTimeout = (callback, delay, ...args) =>
@@ -370,7 +384,8 @@ const makePage = async (status, options = {}) => {
   }
   dom.window.eval(await source(path.join(publicRoot, "storage-size.js")))
   dom.window.eval(await source(path.join(publicRoot, "vault.js")))
-  await waitFor(() => dom.window.document.querySelector(".vault-table"))
+  await waitFor(() => dom.window.document.querySelector(
+    ".vault-summary-value"))
   const choosePickedPath = (folderPath) => {
     const pending = pendingPickers.shift()
     if (!pending) throw new Error("No folder picker is waiting for a selection.")
@@ -398,6 +413,7 @@ const makePage = async (status, options = {}) => {
   return {
     dom,
     requests,
+    parentNavigations,
     confirmations,
     pickerRequests,
     choosePickedPath,
@@ -444,6 +460,7 @@ describe("Save Space interface", () => {
     assert.doesNotMatch(combined, /Previous completed results were kept\./)
     assert.match(combined, /Scan completed with exclusions/)
     assert.match(combined, /Provisional until the scan completes/)
+    assert.match(combined, /Set up Disk Saver/)
     assert.doesNotMatch(combined, /Scan all locations/)
     assert.match(combined, /data-find-home-folder/)
     assert.match(combined, /data-find-other-folder/)
@@ -2204,6 +2221,95 @@ describe("Save Space interface", () => {
     dom.window.close()
   })
 
+  test("an app without a global baseline shows setup and opens global Disk Saver", async () => {
+    const status = fixture([], {
+      global_scan_ready: false,
+      last_scan: null,
+      logical_bytes: 0,
+      saved_by_sharing: 0,
+      pending_bytes: 0
+    })
+    const { dom, requests, parentNavigations } = await makePage(status, {
+      appMode: true,
+      embeddedApp: true,
+      scopeId: "app:app",
+      actionResults: {
+        automatic_set_mode: { app: "app", mode: "manual" }
+      }
+    })
+    const document = dom.window.document
+    const scanButton = document.getElementById("btn-scan")
+
+    assert.match(document.querySelector(".vault-summary-value").textContent,
+      /Run an initial scan to enable app scans/)
+    assert.match(document.querySelector(".vault-setup-copy").textContent,
+      /creates the file index used to compare apps/)
+    assert.match(scanButton.textContent, /Set up Disk Saver/)
+    assert.equal(scanButton.classList.contains("primary"), true)
+    assert.equal(document.getElementById("vault-candidate-size").hidden, true)
+    assert.equal(document.getElementById("vault-explorer").style.display,
+      "none")
+    assert.doesNotMatch(document.getElementById("vault-metrics").textContent,
+      /Nothing else to save/)
+
+    await waitFor(() => document.querySelector(
+      '[data-automatic-mode="manual"]'))
+    document.querySelector('[data-automatic-mode="manual"]').click()
+    await waitFor(() => requests.some((request) =>
+      request.action === "automatic_set_mode"))
+    await waitFor(() => document.getElementById(
+      "vault-auto-mode").classList.contains("manual"))
+    assert.match(document.querySelector(".vault-summary-value").textContent,
+      /Run an initial scan to enable app scans/)
+    assert.equal(document.getElementById("vault-explorer").style.display,
+      "none")
+
+    scanButton.click()
+    assert.deepEqual(parentNavigations, ["/vault"])
+    assert.equal(requests.some((request) => request.action === "scan"), false)
+
+    dom.window.close()
+  })
+
+  test("app setup remains visible during global scan progress", async () => {
+    let progressRequests = 0
+    const status = fixture([], {
+      global_scan_ready: false,
+      scan: {
+        active: true,
+        pending: false,
+        phase: "walking",
+        queued: 0,
+        scope_id: null
+      },
+      last_scan: null,
+      logical_bytes: 0,
+      saved_by_sharing: 0,
+      pending_bytes: 0
+    })
+    const { dom } = await makePage((url) => {
+      if (url.includes("progress=1")) progressRequests += 1
+      return status
+    }, {
+      appMode: true,
+      scopeId: "app:app"
+    })
+    const document = dom.window.document
+
+    for (let attempt = 0; attempt < 400 && !progressRequests; attempt++) {
+      await new Promise((resolve) => setTimeout(resolve, 5))
+    }
+    assert.ok(progressRequests)
+    assert.match(document.querySelector(".vault-summary-value").textContent,
+      /Run an initial scan to enable app scans/)
+    assert.equal(document.getElementById("vault-explorer").style.display,
+      "none")
+    assert.equal(document.getElementById("vault-result").textContent, "")
+    assert.equal(document.getElementById("vault-action-state").textContent, "")
+
+    dom.window.close()
+  })
+
   test("app mode uses full-width results without redundant locations", async () => {
     const status = fixture([item()])
     const { dom, requests } = await makePage(status, {