Skip to content

armgit / peel

Public Imported from GitHub
0

Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.

Space empties the caches sandboxed apps keep in their containers

Țugui Dragoșddad80f41224
diff --git a/Localization/Peel/Localizable.xcstrings b/Localization/Peel/Localizable.xcstrings
index c1bbf215..08558ff4 100644
--- a/Localization/Peel/Localizable.xcstrings
+++ b/Localization/Peel/Localizable.xcstrings
@@ -95470,6 +95470,112 @@
}
}
},
+ "Sandboxed App Caches" : {
+ "localizations" : {
+ "cs" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Mezipaměti izolovaných aplikací"
+ }
+ },
+ "de" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Caches von Sandbox-Apps"
+ }
+ },
+ "es" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Cachés de apps aisladas"
+ }
+ },
+ "fr" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Caches des apps en sandbox"
+ }
+ },
+ "it" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Cache delle app in sandbox"
+ }
+ },
+ "ja" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "サンドボックスアプリのキャッシュ"
+ }
+ },
+ "ko" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "샌드박스 앱 캐시"
+ }
+ },
+ "nl" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Caches van sandbox-apps"
+ }
+ },
+ "pl" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Pamięci podręczne aplikacji w piaskownicy"
+ }
+ },
+ "pt" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Caches de Apps em Sandbox"
+ }
+ },
+ "ro" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Memorii tampon ale aplicațiilor izolate"
+ }
+ },
+ "ru" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Кэши приложений в песочнице"
+ }
+ },
+ "sv" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Cachar för sandlådeappar"
+ }
+ },
+ "tr" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Sandbox Uygulama Önbellekleri"
+ }
+ },
+ "uk" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Кеші ізольованих програм"
+ }
+ },
+ "zh-Hans" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "沙盒App缓存"
+ }
+ },
+ "zh-Hant" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "沙盒App快取"
+ }
+ }
+ }
+ },
"Save a list of what is installed and where it came from" : {
"localizations" : {
"cs" : {
@@ -130755,6 +130861,112 @@
}
}
},
+ "What sandboxed apps, such as those from the App Store, cached in their own containers. An app that is open keeps its caches, and those of Apple’s own apps are listed but never selected." : {
+ "localizations" : {
+ "cs" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Co izolované aplikace, například ty z App Storu, uložily do mezipaměti ve svých vlastních kontejnerech. Otevřená aplikace si své mezipaměti ponechá a mezipaměti vlastních aplikací společnosti Apple se zobrazují, ale nikdy se nevybírají."
+ }
+ },
+ "de" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Was Sandbox-Apps, etwa die aus dem App Store, in ihren eigenen Containern zwischengespeichert haben. Eine geöffnete App behält ihre Caches, und die von Apples eigenen Apps werden angezeigt, aber nie ausgewählt."
+ }
+ },
+ "es" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Lo que las apps aisladas, como las de App Store, han guardado en caché en sus propios contenedores. Una app que está abierta conserva sus cachés, y las de las propias apps de Apple se muestran pero nunca se seleccionan."
+ }
+ },
+ "fr" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Ce que les apps en sandbox, comme celles de l’App Store, ont mis en cache dans leurs propres conteneurs. Une app ouverte conserve ses caches, et ceux des apps d’Apple sont listés mais jamais sélectionnés."
+ }
+ },
+ "it" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Ciò che le app in sandbox, come quelle scaricate da App Store, hanno messo in cache nei propri contenitori. Un’app aperta conserva le sue cache, e quelle delle app di Apple sono elencate ma mai selezionate."
+ }
+ },
+ "ja" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "App Storeのアプリなど、サンドボックス化されたアプリが自身のコンテナにキャッシュしたものです。開いているアプリのキャッシュはそのまま残り、Apple製のアプリのキャッシュは一覧には表示されますが、自動で選択されることはありません。"
+ }
+ },
+ "ko" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "App Store에서 받은 앱 등 샌드박스가 적용된 앱이 자체 컨테이너에 캐시한 항목입니다. 열려 있는 앱은 캐시를 그대로 유지하며, Apple 자체 앱의 캐시는 목록에 표시되지만 절대 미리 선택되지 않습니다."
+ }
+ },
+ "nl" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Wat apps in een sandbox, zoals die uit de App Store, in hun eigen containers in de cache hebben gezet. Een app die open is, behoudt zijn caches, en die van de eigen apps van Apple worden getoond maar nooit geselecteerd."
+ }
+ },
+ "pl" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "To, co aplikacje działające w piaskownicy, takie jak te z App Store, zapisały w pamięci podręcznej we własnych kontenerach. Otwarta aplikacja zachowuje swoją pamięć podręczną, a pamięć podręczna własnych aplikacji Apple jest na liście, ale nigdy nie jest zaznaczana."
+ }
+ },
+ "pt" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "O que os apps em sandbox, como os da App Store, guardaram em cache nos próprios contêineres. Um app aberto mantém os seus caches, e os dos apps da própria Apple são listados, mas nunca selecionados."
+ }
+ },
+ "ro" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Ce au păstrat aplicațiile izolate, cum sunt cele din App Store, în memoria tampon din propriile containere. O aplicație deschisă își păstrează memoriile tampon, iar cele ale aplicațiilor Apple sunt listate, dar nu sunt niciodată selectate."
+ }
+ },
+ "ru" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Все, что приложения в песочнице, например из App Store, кэшировали в своих контейнерах. Кэши открытого приложения остаются на месте, а кэши собственных приложений Apple показываются в списке, но никогда не выбираются."
+ }
+ },
+ "sv" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Det som appar i sandlåda, till exempel de från App Store, har cachat i sina egna behållare. En app som är öppen behåller sina cachar, och cacharna för Apples egna appar visas i listan men markeras aldrig."
+ }
+ },
+ "tr" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "App Store’dan gelenler gibi Sandbox kullanan uygulamaların kendi kapsayıcılarında önbelleğe aldıkları. Açık olan bir uygulamanın önbellekleri yerinde kalır; Apple’ın kendi uygulamalarının önbellekleri ise listelenir ama hiçbir zaman seçilmez."
+ }
+ },
+ "uk" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Те, що ізольовані програми, як-от програми з App Store, кешували у власних контейнерах. Відкрита програма зберігає свої кеші, а кеші власних програм Apple показуються, але ніколи не вибираються."
+ }
+ },
+ "zh-Hans" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "沙盒App(例如来自App Store的App)在各自容器中缓存的内容。已打开的App会保留其缓存;Apple自己的App的缓存会列出,但绝不会被选择。"
+ }
+ },
+ "zh-Hant" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "沙盒App(例如來自App Store的App)在自己的容器中快取的內容。已打開的App會保留其快取,而Apple自家App的快取會列出,但絕不會選取。"
+ }
+ }
+ }
+ },
"What the App Keeps for You" : {
"localizations" : {
"cs" : {
diff --git a/Packages/PeelCore/Sources/PeelCore/Space/SpaceRemoval.swift b/Packages/PeelCore/Sources/PeelCore/Space/SpaceRemoval.swift
index 8a5fd7d6..1b7ab62c 100644
--- a/Packages/PeelCore/Sources/PeelCore/Space/SpaceRemoval.swift
+++ b/Packages/PeelCore/Sources/PeelCore/Space/SpaceRemoval.swift
@@ -51,16 +51,13 @@ public enum SpaceRemoval {
measure: LeftoverScanner.Measure
) async -> Plan {
let children = children(of: item, environment: environment, exclusions: exclusions, running: running)
- let caches = environment.locations.filter { $0.kind == .caches }
- let cachesFolders = Set(caches.map { PathPattern.comparablePath(of: $0.url) })
+ let systemCaches = SystemCaches(environment: environment)
var sizes: [URL: Int64] = [:]
var heldBack: [URL: HoldBack] = [:]
for child in children.removable where !Task.isCancelled {
let contents = await measure(child)
sizes[child] = contents.flatMap { $0.couldNotBeRead ? nil : $0.size }
- let isMacOSs = cachesFolders.contains(PathPattern.comparablePath(of: child.deletingLastPathComponent()))
- && SystemCaches.isMacOSs(child.lastPathComponent)
- heldBack[child] = isMacOSs ? .keptByMacOS : HoldBack.seen(in: contents)
+ heldBack[child] = systemCaches.keeps(child) ? .keptByMacOS : HoldBack.seen(in: contents)
}
return Plan(
removable: children.removable, inUse: children.inUse, leftToDeveloper: children.leftToDeveloper, sizes: sizes,
@@ -90,14 +87,15 @@ public enum SpaceRemoval {
var removable: [URL] = []
var inUse: [(url: URL, name: String)] = []
var leftToDeveloper: [URL] = []
- func sort(_ folder: URL, leaving owned: [[String]]) {
+ let systemCaches = SystemCaches(environment: environment)
+ func sort(_ folder: URL, leaving owned: [[String]], owner: String?) {
let children = try? FileManager.default.contentsOfDirectory(at: folder, includingPropertiesForKeys: nil)
for child in children ?? [] {
let name = child.lastPathComponent
- let app = running[Naming.normalized(name)]
+ let app = owner ?? running[Naming.normalized(name)]
let listed = owned.filter { fnmatch($0[0], name, FNM_CASEFOLD) == 0 }
if app == nil, !listed.isEmpty, !listed.contains(where: { $0.count == 1 }), child.isRealFolder {
- sort(child, leaving: listed.map { Array($0.dropFirst()) })
+ sort(child, leaving: listed.map { Array($0.dropFirst()) }, owner: owner)
continue
}
guard removalGuard.allowsRemoval(of: child) else { continue }
@@ -111,7 +109,10 @@ public enum SpaceRemoval {
}
}
for url in item.urls {
- sort(url, leaving: DeveloperCaches.foldersLeftToDeveloper(inside: url, home: environment.homeDirectory))
+ // Everything in an app's container is that app's, whatever its name.
+ let owner = systemCaches.container(holding: url).flatMap { running[Naming.normalized($0)] }
+ let owned = DeveloperCaches.foldersLeftToDeveloper(inside: url, home: environment.homeDirectory)
+ sort(url, leaving: owned, owner: owner)
}
return (removable, inUse, leftToDeveloper)
}
diff --git a/Packages/PeelCore/Sources/PeelCore/Space/SpaceReport.swift b/Packages/PeelCore/Sources/PeelCore/Space/SpaceReport.swift
index dbe867b9..b0ec7502 100644
--- a/Packages/PeelCore/Sources/PeelCore/Space/SpaceReport.swift
+++ b/Packages/PeelCore/Sources/PeelCore/Space/SpaceReport.swift
@@ -53,6 +53,8 @@ public enum SpaceInventory {
let category: SpaceItem.Category
let paths: [String]
let handling: SpaceItem.Handling
+ /// The folder inside every app's container (`Library/Containers/<identifier>`) that belongs to this area too.
+ var containerFolder: String?
}
/// The identifier of every area. Public so the app can check that it has words for each one: the words
@@ -187,7 +189,8 @@ public enum SpaceInventory {
id: "logs",
category: .library,
paths: ["Library/Logs"],
- handling: .trash
+ handling: .trash,
+ containerFolder: "Data/Library/Logs"
),
Definition(
id: "caches",
@@ -195,6 +198,13 @@ public enum SpaceInventory {
paths: ["Library/Caches"],
handling: .trash
),
+ Definition(
+ id: "container-caches",
+ category: .library,
+ paths: [],
+ handling: .trash,
+ containerFolder: "Data/Library/Caches"
+ ),
]
/// The total size of `urls`, or nil when any of them could not be measured. A folder a file provider owns
@@ -209,6 +219,13 @@ public enum SpaceInventory {
return total
}
+ /// Every app's container, listed rather than matched with `glob`, which stops at 128 paths.
+ static func appContainers(in home: URL) -> [URL] {
+ let containers = home.appending(path: "Library/Containers", directoryHint: .isDirectory)
+ let names = (try? FileManager.default.contentsOfDirectory(atPath: containers.path(percentEncoded: false))) ?? []
+ return names.sorted().map { containers.appending(path: $0, directoryHint: .isDirectory) }.filter(\.isRealFolder)
+ }
+
/// Anything smaller than this is noise in a report about space.
public static let minimumSize: Int64 = 50 * 1_000_000
@@ -225,6 +242,7 @@ public enum SpaceInventory {
minimumSize: Int64,
measure: @escaping FileSize.Measure
) async -> SpaceReport {
+ let containers = appContainers(in: home)
let wanted = definitions.compactMap { definition -> (Definition, [URL])? in
let urls = definition.paths
.map { path in
@@ -233,6 +251,9 @@ public enum SpaceInventory {
: home.appending(path: path, directoryHint: .isDirectory)
}
.filter { FileManager.default.fileExists(atPath: PathPattern.comparablePath(of: $0)) }
+ + (definition.containerFolder.map { folder in
+ containers.map { $0.appending(path: folder, directoryHint: .isDirectory) }.filter(\.isRealFolder)
+ } ?? [])
return urls.isEmpty ? nil : (definition, urls)
}
diff --git a/Packages/PeelCore/Sources/PeelCore/Space/SystemCaches.swift b/Packages/PeelCore/Sources/PeelCore/Space/SystemCaches.swift
index bf39d037..82658e5a 100644
--- a/Packages/PeelCore/Sources/PeelCore/Space/SystemCaches.swift
+++ b/Packages/PeelCore/Sources/PeelCore/Space/SystemCaches.swift
@@ -2,7 +2,7 @@ import Foundation
internal import PeelPrivileged
/// The folders in a Caches folder that macOS keeps for its own services, which may be using them at any moment.
-enum SystemCaches {
+struct SystemCaches {
/// The ones not named `com.apple.`, each with the part of the sealed system that carries its name.
static let named: [String: String] = [
"AMSDataMigratorTool": "/System/Library/PrivateFrameworks/AppleMediaServices.framework"
@@ -23,4 +23,29 @@ enum SystemCaches {
static func isMacOSs(_ name: String) -> Bool {
ProtectedData.isApplesName(name) || lowercasedNames.contains(name.lowercased())
}
+
+ private let cachesFolders: Set<String>
+ private let containers: [String]
+
+ init(environment: SearchEnvironment) {
+ let locations = environment.locations
+ cachesFolders = Set(locations.filter { $0.kind == .caches }.map { PathPattern.comparablePath(of: $0.url) })
+ let folder = locations.first { $0.kind == .containers }?.url
+ containers = folder.map { PathComponents.of(PathPattern.comparablePath(of: $0)) } ?? []
+ }
+
+ /// Whether macOS keeps `url` for itself: a folder in a Caches folder named for macOS, or anything in the container
+ /// of one of Apple's own apps.
+ func keeps(_ url: URL) -> Bool {
+ if cachesFolders.contains(PathPattern.comparablePath(of: url.deletingLastPathComponent())) {
+ return Self.isMacOSs(url.lastPathComponent)
+ }
+ return container(holding: url).map(ProtectedData.isApplesName) ?? false
+ }
+
+ func container(holding url: URL) -> String? {
+ let names = PathComponents.of(PathPattern.comparablePath(of: url))
+ guard !containers.isEmpty, names.count > containers.count, names.starts(with: containers) else { return nil }
+ return names[containers.count]
+ }
}
diff --git a/Packages/PeelCore/Tests/PeelCoreTests/SpaceInventoryTests.swift b/Packages/PeelCore/Tests/PeelCoreTests/SpaceInventoryTests.swift
index eaf0a45d..269032ca 100644
--- a/Packages/PeelCore/Tests/PeelCoreTests/SpaceInventoryTests.swift
+++ b/Packages/PeelCore/Tests/PeelCoreTests/SpaceInventoryTests.swift
@@ -98,10 +98,34 @@ struct SpaceInventoryTests {
#expect(!paths.contains("Caches"), "the caches Developer selects are counted here as well")
}
+ @Test func findsTheCachesAndLogsInEveryAppsContainer() async throws {
+ let directory = try TemporaryDirectory()
+ try directory.file("Library/Containers/org.example.chat/Data/Library/Caches/blob", bytes: 8_000)
+ try directory.file("Library/Containers/org.example.chat/Data/Library/Logs/run.log", bytes: 8_000)
+ try directory.file("Library/Containers/org.example.notes/Data/Library/Caches/blob", bytes: 8_000)
+ try directory.directory("Library/Containers/org.example.empty/Data/Documents")
+ try directory.directory("Elsewhere/Data/Library/Caches")
+ try FileManager.default.createSymbolicLink(
+ at: directory.url.appending(path: "Library/Containers/org.example.link"),
+ withDestinationURL: directory.url.appending(path: "Elsewhere")
+ )
+
+ let report = await SpaceInventory.scan(
+ home: directory.url, root: directory.url, minimumSize: 1, measure: FileSize.measure
+ )
+
+ let folders = { (id: String) in
+ report.items.first { $0.id == id }?.urls.map { $0.pathComponents.suffix(4).joined(separator: "/") } ?? []
+ }
+ let caches = ["org.example.chat/Data/Library/Caches", "org.example.notes/Data/Library/Caches"]
+ #expect(folders("container-caches") == caches)
+ #expect(folders("logs").contains("org.example.chat/Data/Library/Logs"))
+ }
+
@Test func everyDefinitionSaysWhatItIsAndWhoOwnsIt() {
for definition in SpaceInventory.definitions {
#expect(!definition.id.isEmpty)
- #expect(!definition.paths.isEmpty)
+ #expect(!definition.paths.isEmpty || definition.containerFolder != nil)
}
#expect(Set(SpaceInventory.definitions.map(\.id)).count == SpaceInventory.definitions.count)
}
diff --git a/Packages/PeelCore/Tests/PeelCoreTests/SpaceRemovalTests.swift b/Packages/PeelCore/Tests/PeelCoreTests/SpaceRemovalTests.swift
index 886ba323..3963d133 100644
--- a/Packages/PeelCore/Tests/PeelCoreTests/SpaceRemovalTests.swift
+++ b/Packages/PeelCore/Tests/PeelCoreTests/SpaceRemovalTests.swift
@@ -119,6 +119,34 @@ struct SpaceRemovalTests {
#expect(names(Array(logged.suggested)) == ["com.apple.example"])
}
+ @Test func emptiesAContainersCachesUnlessItsAppIsOpenOrApples() async throws {
+ let directory = try TemporaryDirectory()
+ let containers = "home/Library/Containers"
+ for container in ["org.example.chat", "org.example.notes", "com.apple.Safari"] {
+ try directory.file("\(containers)/\(container)/Data/Library/Caches/Cache.db", bytes: 4_096)
+ }
+ let item = SpaceItem(
+ id: "container-caches",
+ category: .library,
+ urls: ["org.example.chat", "org.example.notes", "com.apple.Safari"].map {
+ directory.url.appending(path: "\(containers)/\($0)/Data/Library/Caches", directoryHint: .isDirectory)
+ },
+ size: 0,
+ handling: .trash
+ )
+ let notes = URL(filePath: "/Applications/Notes Example.app")
+ let running = [RunningCopies.Process(identifier: 1, bundleIdentifier: "org.example.notes", bundleURL: notes)]
+ let owner = { (url: URL) in url.pathComponents.dropLast(4).last ?? "" }
+
+ let names = SpaceRemoval.namesOfRunningApps(running)
+ let plan = await SpaceRemoval.plan(for: item, environment: environment(directory), running: names)
+
+ #expect(plan.removable.map(owner).sorted() == ["com.apple.Safari", "org.example.chat"])
+ #expect(plan.suggested.map(owner) == ["org.example.chat"])
+ #expect(plan.heldBack.filter { $0.value == .keptByMacOS }.map { owner($0.key) } == ["com.apple.Safari"])
+ #expect(plan.inUse.map { owner($0.url) } == ["org.example.notes"])
+ }
+
@Test func leavesAloneWhatAnOpenAppIsStillUsing() async throws {
let directory = try TemporaryDirectory()
try directory.file("home/Library/Caches/com.spotify.client/audio.db")
diff --git a/Peel/Views/Space/SpaceText.swift b/Peel/Views/Space/SpaceText.swift
index 797f4852..b13658c5 100644
--- a/Peel/Views/Space/SpaceText.swift
+++ b/Peel/Views/Space/SpaceText.swift
@@ -137,6 +137,10 @@ extension SpaceItem {
title: "App Caches",
detail: "Everything that apps cached in your Library, each folder moved whole. Developer tools’ folders are left to the Developer page, which knows which part of each is only a cache."
),
+ "container-caches": Words(
+ title: "Sandboxed App Caches",
+ detail: "What sandboxed apps, such as those from the App Store, cached in their own containers. An app that is open keeps its caches, and those of Apple’s own apps are listed but never selected."
+ ),
]
}
diff --git a/SAFETY.md b/SAFETY.md
index efa76e35..09df63d5 100644
--- a/SAFETY.md
+++ b/SAFETY.md
@@ -169,13 +169,13 @@ apps. It is removed only by Remove Peel, in Settings, which takes its helper and
Never selected for you, even when found: Xcode's archives of the apps you built and the symbols it copied from your
devices, both needed to read crash reports, model weights, the packages a tool keeps installed outside your projects,
-virtual environments, the installers and boxes a tool keeps for you to install again, a cache macOS keeps for its
-own services in `~/Library/Caches` (Spotlight's, iCloud's, the fonts'), `/Users/Shared` (it belongs to every account,
-not just yours), a project you worked on this week, a folder with a repository, a wallet, or a signing
-key inside, a folder macOS would not let Peel read, and a folder Peel could not measure in time. Those last two are
-shown with their size as "Unknown", never as zero, in every tool and in History once they are moved: a folder too big to
-read quickly may be exactly the one with work inside, and nothing is selected for you without saying how much it is. A
-total that leaves such a folder out reads "Over" what is known.
+virtual environments, the installers and boxes a tool keeps for you to install again, a cache macOS keeps for its own
+services in `~/Library/Caches` (Spotlight's, iCloud's, the fonts') or in the container of one of Apple's apps,
+`/Users/Shared` (it belongs to every account, not just yours), a project you worked on this week, a folder with a
+repository, a wallet, or a signing key inside, a folder macOS would not let Peel read, and a folder Peel could not
+measure in time. Those last two are shown with their size as "Unknown", never as zero, in every tool and in History
+once they are moved: a folder too big to read quickly may be exactly the one with work inside, and nothing is
+selected for you without saying how much it is. A total that leaves such a folder out reads "Over" what is known.
A repository inside a folder its tool tags as a cache (`CACHEDIR.TAG`) is the one exception: the tool says it makes
everything in there again. Swift Package Manager tags `.build`, where it clones a package's dependencies, and