pinokiod 8.0.47 → 8.0.49

package/server/public/vault.js

@@ -10,8 +10,9 @@ const COPY = {
   all_description: "Every scanned file and its current deduplication status.",
   duplicates_description: "Identical files waiting to be deduplicated or kept separate.",
   shared_description: "Files that share disk storage across multiple locations.",
+  tracked_description: "Files with no duplicate action required.",
   independent_description: "Duplicate files that remain as separate copies.",
-  reclaimable_description: "Stored copies no longer used by any configured location.",
+  reclaimable_description: "Private links no longer used by any linked file.",
   activity_description: "A history of scans and changes made by Save space.",
   add_external_folder: "Add external folder",
   files_region: "Files",
@@ -24,7 +25,7 @@ const COPY = {
   disk_space_saved: "of disk space saved",
   saved_for_app: "{size} saved for this app",
   before: "Before",
-  before_help: "Estimated space if every app stored its own copy.",
+  before_help: "Estimated size of every scanned location if each app stored its own copy. File Explorer may count deduplicated files differently.",
   after: "After",
   effective_help: "For deduplicated files, disk usage is divided evenly among every location using them.",
   nothing_more_to_save: "Nothing else to save",
@@ -86,6 +87,7 @@ const COPY = {
   search_all: "Search files",
   search_duplicates: "Search duplicates",
   search_shared: "Search deduplicated files",
+  search_tracked: "Search files with no action needed",
   search_skipped: "Search files kept separate",
   search_activity: "Search activity",
   search_in: "Search in {location}",
@@ -103,6 +105,9 @@ const COPY = {
   display_mode: "Display mode",
   sorted_largest: "sorted largest first",
   sorted_smallest: "sorted smallest first",
+  previous: "Previous",
+  next: "Next",
+  file_pages: "File pages",
   status: "Deduplication status",
   matches: "Matches",
   can_save: "Can save",
@@ -149,8 +154,13 @@ const COPY = {
   keep_separate: "Keep separate",
   kept_separate: "Kept separate",
   make_separate: "Make separate",
-  reclaim: "Delete",
-  reclaim_all: "Delete all",
+  reclaim: "Clean up",
+  reclaim_all: "Clean up all",
+  cleanup_ready: "{size} ready to clean up",
+  cleanup_ready_detail: "{count} left after their linked files were deleted.",
+  review_cleanup: "Review cleanup",
+  private_link: "private link",
+  private_links: "private links",
   undo: "Undo",
   identical_contents_at: "Identical contents at",
   no_files: "No files found",
@@ -161,26 +171,29 @@ const COPY = {
   no_duplicates_hint: "There are no files waiting for your review.",
   no_shared: "Nothing deduplicated yet",
   no_shared_hint: "Deduplicated files will appear here after you review duplicates.",
+  no_tracked: "No files with no action needed",
+  no_tracked_hint: "Files without a duplicate action will appear here after a scan.",
   no_skipped: "Nothing kept separate",
   no_skipped_hint: "Files you keep separate will appear here.",
-  no_reclaimable: "No unused files",
-  no_reclaimable_hint: "Copies no longer used by any configured location will appear here.",
+  no_reclaimable: "No cleanup needed",
+  no_reclaimable_hint: "Private links with no remaining linked files will appear here.",
   no_activity: "No activity yet",
   no_activity_hint: "Scans and actions will be recorded here.",
   view_all: "View all files",
   show_all_locations: "Show all locations",
   tracked_note: "Only files {size} and larger appear here. Files keep their current locations.",
   duplicate_note: "Only files waiting for review are shown.",
-  reclaimable_note: "These copies are no longer used by any configured location. Deleting them frees disk space.",
+  reclaimable_note: "These private links have no remaining linked files. Cleaning them up frees disk space.",
+  activity_note: "Recent scans and Save space actions.",
   converted: "Deduplicated",
   files_left_separate: "{count} remained separate",
   skipped_action: "Kept separate",
   separated: "Separated",
-  reclaimed: "Deleted",
+  reclaimed: "Cleaned up",
   event_convert: "Deduplicated",
   event_found: "Duplicate found",
   event_adopt: "Added",
-  event_reclaim: "Deleted unused file",
+  event_reclaim: "Cleaned up unused link",
   event_undo: "Undid deduplication",
   event_diverged: "Changed by an app — no longer deduplicated",
   event_detach: "Separated",
@@ -200,9 +213,10 @@ const statusUrl = (progress = false) => {
 const reviewedScanKey = `pinokio:vault:reviewed-scan:${SCOPE_ID || "global"}`
 const candidateSizeKey = "pinokio:vault:candidate-size"
 const candidateSizeBase = document.body.dataset.platform === "win32" ? 1024 : 1000
-const candidateSizeOptions = [10, 50, 100, 500]
+const candidateSizeOptions = [1, 10, 50, 100, 500]
   .map((value) => value * candidateSizeBase ** 2)
   .concat(candidateSizeBase ** 3)
+const PAGE_SIZE = 500
 
 const state = {
   data: null,
@@ -221,7 +235,9 @@ const state = {
   scanProblemsOpen: false,
   feedback: null,
   actionProgress: null,
-  actionRequest: false
+  actionRequest: false,
+  page: 0,
+  pageContext: null
 }
 
 const el = (id) => document.getElementById(id)
@@ -232,7 +248,7 @@ const attr = esc
 const fmt = window.PinokioFormatStorageSize
 const candidateSize = () => {
   const value = Number(el("vault-candidate-size").value)
-  return candidateSizeOptions.includes(value) ? value : candidateSizeOptions[2]
+  return candidateSizeOptions.includes(value) ? value : candidateSizeOptions[3]
 }
 const countLabel = (count, singular = COPY.file, plural = COPY.files) => `${count} ${count === 1 ? singular : plural}`
 const basename = (value) => String(value || "").split(/[\\/]/).filter(Boolean).pop() || ""
@@ -274,6 +290,16 @@ const sourcePath = (source) => {
   if (source.kind === "app") return IS_APP_MODE ? (source.display_path || source.root || "") : ""
   return source.display_path || source.root || ""
 }
+const externalLocation = (item) => {
+  const source = sourceById(item.source_id)
+  if (!source || source.kind !== "external") return ""
+  const base = sourcePath(source).replace(/[\\/]+$/, "")
+  const relative = String(item.relative_path || "").replace(/^[\\/]+/, "")
+  if (!base) return relative
+  if (!relative) return base
+  const separator = base.includes("\\") && !base.includes("/") ? "\\" : "/"
+  return `${base}${separator}${separator === "\\" ? relative.replace(/\//g, "\\") : relative}`
+}
 const isDescendantSource = (candidateId, parentId) => {
   if (!parentId) return true
   if (candidateId === parentId) return true
@@ -331,9 +357,10 @@ const getCounts = (items) => ({
   all: items.length,
   duplicates: items.filter((item) => item.status === "duplicate").length,
   shared: items.filter((item) => item.status === "shared").length,
+  tracked: items.filter((item) => item.status === "tracked").length,
   independent: items.filter((item) => item.status === "independent").length,
   reclaimable: state.data.blobs.filter((blob) => blob.orphan).length,
-  activity: state.data.events.length
+  activity: activityItems("").length
 })
 
 const sourceCounts = (items) => {
@@ -356,6 +383,7 @@ const activeItems = (items) => {
   let result = items
   if (state.view === "duplicates") result = result.filter((item) => item.status === "duplicate")
   if (state.view === "shared") result = result.filter((item) => item.status === "shared")
+  if (state.view === "tracked") result = result.filter((item) => item.status === "tracked")
   if (state.view === "independent") result = result.filter((item) => item.status === "independent")
   if (state.sourceId) result = result.filter((item) => isDescendantSource(item.source_id, state.sourceId))
   if (state.view === "all" && state.statusFilter !== "all") result = result.filter((item) => item.status === state.statusFilter)
@@ -368,6 +396,7 @@ const viewIcon = {
   all: "fa-regular fa-file-lines",
   duplicates: "fa-regular fa-copy",
   shared: "fa-solid fa-link",
+  tracked: "fa-regular fa-circle-check",
   independent: "fa-solid fa-circle-minus",
   reclaimable: "fa-regular fa-trash-can",
   activity: "fa-solid fa-wave-square"
@@ -376,6 +405,7 @@ const viewLabel = {
   all: COPY.all,
   duplicates: COPY.duplicates,
   shared: COPY.shared,
+  tracked: COPY.tracked,
   independent: COPY.skipped,
   reclaimable: COPY.reclaimable,
   activity: COPY.activity
@@ -391,18 +421,30 @@ const eventLabels = {
   skip: COPY.event_skip,
   reshare: COPY.event_reshare
 }
-const activityItems = () => {
-  const query = state.query.toLowerCase()
-  return state.data.events.filter((event) => !query ||
+const activityItems = (queryText = state.query) => {
+  const query = queryText.trim().toLowerCase()
+  const events = state.data.events.filter((event) => !query ||
     `${eventLabels[event.kind] || event.kind} ${event.path || ""}`.toLowerCase().includes(query))
+  const seenBatches = new Set()
+  const eventItems = events.map((event) => {
+    const showUndo = event.kind === "convert" && event.batch_id &&
+      event.undoable !== false && !seenBatches.has(event.batch_id)
+    if (showUndo) seenBatches.add(event.batch_id)
+    return Object.assign({}, event, { activity_type: "event", show_undo: showUndo })
+  })
+  const batchItems = (Array.isArray(state.data.undo_batches) ? state.data.undo_batches : [])
+    .filter((batch) => !seenBatches.has(batch.batch_id) && (!query ||
+      `${COPY.event_convert} ${batch.files || 0} ${COPY.files}`.toLowerCase().includes(query)))
+    .map((batch) => Object.assign({}, batch, { activity_type: "batch" }))
+  return batchItems.concat(eventItems)
 }
 
 const renderViews = (items) => {
   const counts = getCounts(items)
   el("views-label").textContent = COPY.views
   const views = IS_APP_MODE
-    ? ["all", "duplicates", "shared", "independent", "activity"]
-    : ["all", "duplicates", "shared", "independent", "reclaimable", "activity"]
+    ? ["all", "duplicates", "shared", "tracked", "independent", "activity"]
+    : ["all", "duplicates", "shared", "tracked", "independent", "reclaimable", "activity"]
   el("vault-views").innerHTML = views.map((view) => `
     <button class="vault-nav-row ${state.view === view ? "selected" : ""}" type="button" data-view="${view}" ${state.view === view ? 'aria-current="page"' : ""}>
       <i class="${viewIcon[view]}"></i>
@@ -510,12 +552,14 @@ const updateToolbarSummary = (visibleItems) => {
 const searchPlaceholder = () => {
   if (state.view === "duplicates") return COPY.search_duplicates
   if (state.view === "shared") return COPY.search_shared
+  if (state.view === "tracked") return COPY.search_tracked
   if (state.view === "independent") return COPY.search_skipped
   if (state.view === "activity") return COPY.search_activity
   const source = selectedSource()
   return source && source.kind === "app" ? COPY.search_in.replace("{location}", source.label) : COPY.search_all
 }
-const supportsDisplayMode = () => state.view === "all" || state.view === "shared" || state.view === "independent"
+const supportsDisplayMode = () => state.view === "all" || state.view === "shared" ||
+  state.view === "tracked" || state.view === "independent"
 const displayModeControl = () => supportsDisplayMode() ? `<div class="vault-display-mode" role="group" aria-label="${attr(COPY.display_mode)}">
   <button type="button" data-display-mode="folders" aria-pressed="${state.displayMode === "folders"}" class="${state.displayMode === "folders" ? "selected" : ""}">${esc(COPY.folders)}</button>
   <button type="button" data-display-mode="files" aria-pressed="${state.displayMode === "files"}" class="${state.displayMode === "files" ? "selected" : ""}">${esc(COPY.files_mode)}</button>
@@ -583,7 +627,7 @@ const sharingControl = (item) => {
 const fileDetail = (item) => {
   if (!state.expandedFiles.has(item.path) || !item.locations || item.locations.length < 2) return ""
   return `<div class="vault-detail"><div class="vault-detail-label">${esc(COPY.identical_contents_at)} ${countLabel(item.locations.length, COPY.location, COPY.locations_lower)}</div>${item.locations.map((location) => `
-    <div class="vault-location-detail"><i class="fa-regular fa-file"></i><span>${esc(location.source_label || "")}${location.relative_path ? ` / ${esc(location.relative_path)}` : ""}</span></div>`).join("")}</div>`
+    <div class="vault-location-detail"><i class="fa-regular fa-file"></i><span>${esc(externalLocation(location) || [location.source_label, location.relative_path].filter(Boolean).join(" / "))}</span></div>`).join("")}</div>`
 }
 
 const renderFileRow = (item, depth = 0, showMatch = false) => {
@@ -680,7 +724,8 @@ const sourceSort = (a, b) => {
   const rank = (source) => source && source.kind === "external" ? 1 : source ? 0 : 2
   return rank(first) - rank(second) || groupTitle(first).localeCompare(groupTitle(second))
 }
-const flatLocation = (item) => [groupTitle(sourceById(item.source_id)), item.relative_path].filter(Boolean).join(" / ")
+const flatLocation = (item) => externalLocation(item) ||
+  [groupTitle(sourceById(item.source_id)), item.relative_path].filter(Boolean).join(" / ")
 const renderFlatFiles = (items) => [...items]
   .sort((a, b) => compareRows(a, b, flatLocation))
   .map((item) => {
@@ -706,8 +751,9 @@ const renderDuplicateGroups = (items) => {
   return [...groups.entries()].sort(sourceSort).map(([sourceId, group]) => {
     const source = sourceById(sourceId)
     const bytes = group.filter((item) => item.shareable).reduce((sum, item) => sum + item.size, 0)
-    const action = source && source.shareable && group.some((item) => item.shareable)
-      ? `<button class="vault-button" type="button" data-deduplicate-scope="${attr(sourceId)}">${esc(COPY.deduplicate)} ${countLabel(group.filter((item) => item.shareable).length)}</button>`
+    const allShareable = scopeDuplicates(sourceId).filter((item) => item.shareable !== false)
+    const action = source && source.shareable && allShareable.length
+      ? `<button class="vault-button" type="button" data-deduplicate-scope="${attr(sourceId)}">${esc(COPY.deduplicate)} ${countLabel(allShareable.length)}</button>`
       : `<span class="vault-unavailable">${esc(COPY.sharing_unavailable)}</span>`
     return `<div class="vault-group-row"><div class="vault-group-main"><div class="vault-group-title"><i class="fa-regular fa-folder"></i><span>${esc(groupTitle(source))}</span></div><div class="vault-group-meta">${countLabel(group.length, COPY.duplicate.toLowerCase(), COPY.duplicates.toLowerCase())} · ${bytes ? fmt(bytes) : COPY.unavailable}</div></div><div class="vault-group-action">${action}</div></div>${[...group].sort((a, b) => compareRows(a, b, (item) => item.relative_path)).map((item) => renderFileRow(item, 0, true)).join("")}`
   }).join("")
@@ -743,6 +789,7 @@ const emptyState = (view) => {
       : [COPY.no_files, COPY.no_files_hint, "fa-regular fa-folder-open"],
     duplicates: [COPY.no_duplicates, COPY.no_duplicates_hint, "fa-regular fa-circle-check"],
     shared: [COPY.no_shared, COPY.no_shared_hint, "fa-solid fa-link"],
+    tracked: [COPY.no_tracked, COPY.no_tracked_hint, "fa-regular fa-circle-check"],
     independent: [COPY.no_skipped, COPY.no_skipped_hint, "fa-solid fa-circle-minus"],
     reclaimable: [COPY.no_reclaimable, COPY.no_reclaimable_hint, "fa-regular fa-circle-check"],
     activity: [COPY.no_activity, COPY.no_activity_hint, "fa-solid fa-wave-square"]
@@ -751,36 +798,26 @@ const emptyState = (view) => {
   return `<div class="vault-empty"><div class="vault-empty-inner"><i class="${content[2]}"></i><h3>${esc(content[0])}</h3><p>${esc(content[1])}</p>${view === "duplicates" ? `<button class="vault-button" type="button" data-view="all">${esc(COPY.view_all)}</button>` : view === "all" && !activeScan ? `<button class="vault-button" type="button" id="btn-empty-scan">${esc(scanLabel)}</button>` : ""}</div></div>`
 }
 
-const renderReclaimable = () => {
-  const blobs = state.data.blobs.filter((blob) => blob.orphan)
+const renderReclaimable = (blobs) => {
   if (!blobs.length) return emptyState("reclaimable")
-  return [...blobs].sort((a, b) => compareRows(a, b, (blob) => blob.names[0] ? blob.names[0].path : blob.hash)).map((blob) => `<div class="vault-file-row"><div class="vault-name-cell"><span class="vault-disclosure"></span><i class="fa-regular fa-file vault-name-icon"></i><span class="vault-name-copy"><span class="vault-file-name">${esc(blob.names[0] ? basename(blob.names[0].path) : `${blob.hash.slice(0, 12)}…`)}</span></span></div><span class="vault-size">${fmt(blob.size)}</span><span class="vault-space">${fmt(blob.size)}</span><span class="vault-row-action"><button class="vault-text-button" type="button" data-reclaim="${attr(blob.hash)}">${esc(COPY.reclaim)}</button></span></div>`).join("")
+  return blobs.map((blob) => `<div class="vault-file-row"><div class="vault-name-cell"><span class="vault-disclosure"></span><i class="fa-regular fa-file vault-name-icon"></i><span class="vault-name-copy"><span class="vault-file-name">${esc(blob.names[0] ? basename(blob.names[0].path) : `${blob.hash.slice(0, 12)}…`)}</span></span></div><span class="vault-size">${fmt(blob.size)}</span><span class="vault-space">${fmt(blob.size)}</span><span class="vault-row-action"><button class="vault-text-button" type="button" data-reclaim="${attr(blob.hash)}">${esc(COPY.reclaim)}</button></span></div>`).join("")
 }
 
-const renderActivity = () => {
-  const events = activityItems()
-  const query = state.query.trim().toLowerCase()
-  const undoBatches = Array.isArray(state.data.undo_batches)
-    ? state.data.undo_batches.filter((batch) => !query ||
-      `${COPY.event_convert} ${batch.files || 0} ${COPY.files}`.toLowerCase().includes(query))
-    : []
-  if (!events.length && !undoBatches.length) return emptyState("activity")
-  const seenBatches = new Set()
-  const eventRows = events.map((event) => {
-    let undo = ""
-    if (event.kind === "convert" && event.batch_id && event.undoable !== false && !seenBatches.has(event.batch_id)) {
-      seenBatches.add(event.batch_id)
-      undo = `<button class="vault-text-button" type="button" data-undo="${attr(event.batch_id)}">${esc(COPY.undo)}</button>`
+const renderActivity = (items) => {
+  if (!items.length) return emptyState("activity")
+  return items.map((item) => {
+    if (item.activity_type === "batch") {
+      return `<div class="vault-file-row"><div class="vault-name-cell"><span class="vault-disclosure"></span><i class="fa-solid fa-wave-square vault-name-icon"></i><span class="vault-name-copy"><span class="vault-file-name vault-event-kind">${esc(COPY.event_convert)}</span><span class="vault-file-path">${esc(countLabel(item.files || 0))}</span></span></div><span class="vault-size">${fmt(item.bytes || 0)}</span><span class="vault-event-time">${item.ts ? esc(new Date(item.ts).toLocaleString()) : "—"}</span><span class="vault-row-action"><button class="vault-text-button" type="button" data-undo="${attr(item.batch_id)}">${esc(COPY.undo)}</button></span></div>`
     }
+    const event = item
+    const undo = event.show_undo
+      ? `<button class="vault-text-button" type="button" data-undo="${attr(event.batch_id)}">${esc(COPY.undo)}</button>`
+      : ""
     const eventPath = event.path
       ? `${event.source_label ? `${event.source_label} / ` : ""}${event.relative_path || event.path}`
       : (event.hash || "").slice(0, 12)
     return `<div class="vault-file-row"><div class="vault-name-cell"><span class="vault-disclosure"></span><i class="fa-solid fa-wave-square vault-name-icon"></i><span class="vault-name-copy"><span class="vault-file-name vault-event-kind">${esc(eventLabels[event.kind] || event.kind)}</span><span class="vault-file-path">${esc(eventPath)}</span></span></div><span class="vault-size">${event.bytes_saved ? fmt(event.bytes_saved) : event.size ? fmt(event.size) : "—"}</span><span class="vault-event-time">${esc(new Date(event.ts).toLocaleString())}</span><span class="vault-row-action">${undo}</span></div>`
   }).join("")
-  const batchRows = undoBatches.filter((batch) => !seenBatches.has(batch.batch_id)).map((batch) =>
-    `<div class="vault-file-row"><div class="vault-name-cell"><span class="vault-disclosure"></span><i class="fa-solid fa-wave-square vault-name-icon"></i><span class="vault-name-copy"><span class="vault-file-name vault-event-kind">${esc(COPY.event_convert)}</span><span class="vault-file-path">${esc(countLabel(batch.files || 0))}</span></span></div><span class="vault-size">${fmt(batch.bytes || 0)}</span><span class="vault-event-time">${batch.ts ? esc(new Date(batch.ts).toLocaleString()) : "—"}</span><span class="vault-row-action"><button class="vault-text-button" type="button" data-undo="${attr(batch.batch_id)}">${esc(COPY.undo)}</button></span></div>`
-  ).join("")
-  return batchRows + eventRows
 }
 
 const renderTable = (items) => {
@@ -794,11 +831,11 @@ const renderTable = (items) => {
   } else if (state.view === "reclaimable") {
     tableClass = "reclaimable"
     headers = [COPY.name, COPY.size, COPY.can_free, ""]
-    body = renderReclaimable()
+    body = renderReclaimable(items)
   } else if (state.view === "activity") {
     tableClass = "activity"
     headers = [COPY.name, COPY.size, COPY.last_scanned, ""]
-    body = renderActivity()
+    body = renderActivity(items)
   } else if (state.displayMode === "files" && supportsDisplayMode()) {
     tableClass = "flat"
     headers = [COPY.name, COPY.location_column, COPY.size, COPY.status]
@@ -815,6 +852,71 @@ const renderTable = (items) => {
   el("vault-table-wrap").innerHTML = `<div class="vault-table ${tableClass}"><div class="vault-columns">${headerMarkup}</div>${body}</div>`
 }
 
+const orderedItems = (items) => {
+  if (state.view === "activity") return items
+  if (state.view === "reclaimable") {
+    return [...items].sort((a, b) => compareRows(a, b,
+      (blob) => blob.names[0] ? blob.names[0].path : blob.hash))
+  }
+  if (state.displayMode === "files" && supportsDisplayMode()) {
+    return [...items].sort((a, b) => compareRows(a, b, flatLocation))
+  }
+  return [...items].sort((a, b) => {
+    const sourceOrder = state.sourceId ? 0 : sourceSort([a.source_id], [b.source_id])
+    return sourceOrder || compareRows(a, b, (item) => item.relative_path || item.path)
+  })
+}
+
+const pagedItems = (items) => {
+  const context = JSON.stringify([
+    state.view, state.sourceId, state.query, state.statusFilter,
+    state.displayMode, state.sizeSort
+  ])
+  if (context !== state.pageContext) {
+    state.page = 0
+    state.pageContext = context
+  }
+  const ordered = orderedItems(items)
+  const pages = Math.max(1, Math.ceil(ordered.length / PAGE_SIZE))
+  state.page = Math.max(0, Math.min(state.page, pages - 1))
+  const start = state.page * PAGE_SIZE
+  const end = Math.min(start + PAGE_SIZE, ordered.length)
+  return { items: ordered.slice(start, end), start, end, total: ordered.length, pages }
+}
+
+const paneFooterText = (items) => {
+  if (state.displayMode === "files" && supportsDisplayMode()) {
+    const count = state.view === "shared"
+      ? countLabel(items.length, "deduplicated file", "deduplicated files")
+      : state.view === "independent"
+        ? countLabel(items.length, "file kept separate", "files kept separate")
+        : countLabel(items.length)
+    const order = state.sizeSort === "desc"
+      ? COPY.sorted_largest
+      : state.sizeSort === "asc" ? COPY.sorted_smallest : ""
+    return `${count}${order ? ` · ${order}` : ""}`
+  }
+  if (state.view === "duplicates") return COPY.duplicate_note
+  if (state.view === "reclaimable") return COPY.reclaimable_note
+  if (state.view === "activity") return COPY.activity_note
+  return COPY.tracked_note.replace("{size}", fmt(candidateSize()))
+}
+
+const renderPaneFooter = (items, page) => {
+  const footer = el("vault-pane-footer")
+  const message = paneFooterText(items)
+  if (page.pages === 1) {
+    footer.textContent = message
+    return
+  }
+  footer.innerHTML = `<span>${esc(message)}</span>
+    <span class="vault-pagination" role="navigation" aria-label="${attr(COPY.file_pages)}">
+      <button class="vault-text-button" type="button" data-page="previous" ${state.page === 0 ? "disabled" : ""}>${esc(COPY.previous)}</button>
+      <span class="vault-page-range">${page.start + 1}–${page.end} of ${page.total}</span>
+      <button class="vault-text-button" type="button" data-page="next" ${state.page === page.pages - 1 ? "disabled" : ""}>${esc(COPY.next)}</button>
+    </span>`
+}
+
 const renderOverview = () => {
   const data = state.data
   const last = data.last_scan
@@ -1115,12 +1217,34 @@ const renderCloudWarning = () => {
   warning.innerHTML = `<i class="fa-solid fa-triangle-exclamation"></i><span>${esc(message)}</span><button class="vault-text-button" id="btn-dismiss-cloud" type="button" data-warning-key="${attr(key)}">${esc(COPY.dismiss)}</button>`
 }
 
+const renderCleanupNotice = () => {
+  const notice = el("vault-cleanup-notice")
+  const blobs = state.data && Array.isArray(state.data.blobs) ? state.data.blobs : []
+  const unused = !IS_APP_MODE && state.data && state.data.enabled
+    ? blobs.filter((blob) => blob.orphan)
+    : []
+  if (!unused.length || state.view === "reclaimable") {
+    notice.className = "vault-cleanup-notice"
+    notice.innerHTML = ""
+    return
+  }
+  const bytes = unused.reduce((sum, blob) => sum + (Number(blob.size) || 0), 0)
+  const title = COPY.cleanup_ready.replace("{size}", fmt(bytes))
+  const detail = COPY.cleanup_ready_detail.replace(
+    "{count}",
+    countLabel(unused.length, COPY.private_link, COPY.private_links)
+  )
+  notice.className = "vault-cleanup-notice show"
+  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 render = () => {
   if (!state.data) return
   renderOverview()
   renderResult()
   renderFeedback()
   renderCloudWarning()
+  renderCleanupNotice()
   if (!state.data.enabled) {
     el("vault-explorer").style.display = "none"
     return
@@ -1131,23 +1255,10 @@ const render = () => {
   renderLocations(items)
   const visible = activeItems(items)
   renderToolbar(visible, items)
-  renderTable(visible)
+  const page = pagedItems(visible)
+  renderTable(page.items)
   renderActionProgress()
-  if (state.displayMode === "files" && supportsDisplayMode()) {
-    const count = state.view === "shared"
-      ? countLabel(visible.length, "deduplicated file", "deduplicated files")
-      : state.view === "independent"
-        ? countLabel(visible.length, "file kept separate", "files kept separate")
-        : countLabel(visible.length)
-    const order = state.sizeSort === "desc" ? COPY.sorted_largest : state.sizeSort === "asc" ? COPY.sorted_smallest : ""
-    el("vault-pane-footer").textContent = `${count}${order ? ` · ${order}` : ""}`
-  } else {
-    el("vault-pane-footer").textContent = state.view === "duplicates"
-      ? COPY.duplicate_note
-      : state.view === "reclaimable"
-        ? COPY.reclaimable_note
-        : COPY.tracked_note.replace("{size}", fmt(candidateSize()))
-  }
+  renderPaneFooter(visible, page)
 }
 
 const scanActive = (scan) => !!(scan && (scan.pending || scan.active || scan.queued > 0))
@@ -1203,13 +1314,16 @@ const applyFullData = (data) => {
   render()
   return scanning || !!fileAction
 }
+let refreshSequence = 0
 const refresh = async (forceFull = false) => {
+  const sequence = ++refreshSequence
   let delay = null
   try {
     const progressOnly = !forceFull &&
       !!(state.data && (scanActive(state.data.scan) || state.actionProgress))
     if (progressOnly) {
       const progress = await fetchJson(statusUrl(true))
+      if (sequence !== refreshSequence) return
       state.data.scan = progress.scan
       state.data.last_scan = progress.last_scan
       const fileAction = serverFileAction(progress.file_action)
@@ -1221,16 +1335,22 @@ const refresh = async (forceFull = false) => {
         renderActionProgress()
         renderFeedback()
       } else {
-        if (applyFullData(await fetchJson(statusUrl())) || state.scanRequested) delay = 1500
+        const data = await fetchJson(statusUrl())
+        if (sequence !== refreshSequence) return
+        if (applyFullData(data) || state.scanRequested) delay = 1500
       }
     } else {
-      if (applyFullData(await fetchJson(statusUrl())) || state.scanRequested) delay = 1500
+      const data = await fetchJson(statusUrl())
+      if (sequence !== refreshSequence) return
+      if (applyFullData(data) || state.scanRequested) delay = 1500
     }
   } catch (error) {
+    if (sequence !== refreshSequence) return
     state.feedback = { error: true, message: error && error.message ? error.message : String(error) }
     renderFeedback()
     delay = 5000
   } finally {
+    if (sequence !== refreshSequence) return
     clearTimeout(window.__vaultRefresh)
     window.__vaultRefresh = delay == null ? null : setTimeout(refresh, delay)
   }
@@ -1405,6 +1525,10 @@ document.addEventListener("click", async (event) => {
   if (target.id === "btn-dismiss-cloud") {
     try { localStorage.setItem(target.dataset.warningKey, "1") } catch (error) {}
     renderCloudWarning()
+  } else if (target.dataset.page) {
+    state.page += target.dataset.page === "next" ? 1 : -1
+    render()
+    el("vault-table-wrap").scrollTop = 0
   } else if (target.hasAttribute("data-sort-size")) {
     state.sizeSort = state.sizeSort === "desc" ? "asc" : "desc"
     render()
@@ -1412,8 +1536,8 @@ document.addEventListener("click", async (event) => {
     state.displayMode = target.dataset.displayMode === "files" ? "files" : "folders"
     state.sizeSort = state.displayMode === "files" ? "desc" : null
     render()
-  } else if (target.dataset.view) {
-    state.view = target.dataset.view
+  } else if (target.dataset.view || target.id === "btn-review-cleanup") {
+    state.view = target.dataset.view || "reclaimable"
     state.sourceId = SCOPE_ID
     state.query = ""
     state.statusFilter = "all"
@@ -1597,7 +1721,9 @@ document.addEventListener("input", (event) => {
   state.query = event.target.value
   const items = activeItems(buildItems())
   updateToolbarSummary(items)
-  renderTable(items)
+  const page = pagedItems(items)
+  renderTable(page.items)
+  renderPaneFooter(items, page)
   renderActionProgress()
 })
 document.addEventListener("change", (event) => {
@@ -1617,7 +1743,7 @@ candidateSizeSelect.setAttribute("aria-label", COPY.minimum_file_size)
 candidateSizeSelect.innerHTML = candidateSizeOptions
   .map((size) => `<option value="${size}">${fmt(size)}+</option>`)
   .join("")
-candidateSizeSelect.value = String(candidateSizeOptions[2])
+candidateSizeSelect.value = String(candidateSizeOptions[3])
 try {
   const storedCandidateSize = Number(localStorage.getItem(candidateSizeKey))
   if (candidateSizeOptions.includes(storedCandidateSize)) {

package/server/views/partials/vault_workspace.ejs

@@ -25,6 +25,7 @@
       <div class='vault-result' id='vault-result' role='status' aria-live='polite'></div>
       <div class='vault-feedback' id='vault-feedback' role='status' aria-live='polite'></div>
       <div class='vault-cloud-warning' id='vault-cloud-warning' role='status'></div>
+      <div class='vault-cleanup-notice' id='vault-cleanup-notice' role='status'></div>
       <section class='vault-explorer' id='vault-explorer'>
         <aside class='vault-rail'>
           <div class='vault-rail-section'>

package/test/vault-engine.test.js

@@ -97,6 +97,27 @@ describe('vault engine (phase 1)', () => {
     assert.strictEqual(fs.existsSync(path.resolve(h, 'vault', 'registry.json')), true)
   })
 
+  test('startup verification reports unused private links without deleting them', async () => {
+    const h = await home()
+    const vault = await makeVault(h)
+    const content = crypto.randomBytes(4096)
+    const hash = sha256(content)
+    const file = await writeFile(path.resolve(h, 'api', 'appA', 'unused.bin'), content)
+    await vault.adopt(file, hash, { app: 'appA' })
+    await vault.registry.flush()
+    await fs.promises.unlink(file)
+
+    const fresh = new Vault(fakeKernel(h))
+    await fresh.init({ existingOnly: true })
+    fresh.verificationPending = true
+    await fresh.ensureInitialized()
+
+    assert.strictEqual(fs.existsSync(fresh.storePathFor(hash)), true)
+    assert.strictEqual(fresh.registry.links.has(file), false)
+    assert.strictEqual(fresh.registry.blobs.get(hash).orphan, true)
+    assert.strictEqual((await fresh.status()).reclaimable, content.length)
+  })
+
   test('adopt: metadata-only, store name shares the inode', async () => {
     const h = await home()
     const vault = await makeVault(h)