1pub const INIT_LONG: &str = "\
14Crawl the given directory trees for Git repositories and register every one found, up \
15to 8 levels deep. Registration is one entry in dev-prune's own registry file — nothing \
16in the repository is created, changed or deleted.
17
18After registering, it runs the same integration pass as `devp setup` (installing \
19whatever is missing, reporting whatever it skipped) and the same quiet release check \
20as `devp update`.
21
22`--auto` works the paths out instead of being told them: the directories your \
23registered repositories already sit in, the workspace you are standing in, and the \
24conventional locations under your home directory. It is the form to use when nobody \
25has said where the code is — an assistant setting the tool up, or a machine whose \
26repositories you would rather not list by hand.
27
28A bulk scan skips any repository holding an `ignore.devprune.json`, so a repository can \
29decline before it is ever registered. `devp link <path>` still registers it, because \
30naming one repository is not a bulk scan.
31
32Registration is what makes a repository visible to `devp run`, `devp status` and the \
33background pass. Registering is not pruning: a registered repository is still only \
34touched once it is idle, and only where a lockfile proves the directory can be rebuilt.";
35
36pub const INIT_EXAMPLES: &str = "\
37EXAMPLES:
38 devp init Register repositories under the current directory
39 devp init --auto Work out where the repositories are and register them
40 devp init --auto --dry-run Show what that would register, write nothing
41 devp init ~/Code Register everything under ~/Code
42 devp init ~/Code ~/Work/oss Multiple trees in one pass
43 devp scan ~/Code Same command — `scan` and `onboard` are aliases
44 DEV_PRUNE_NO_AUTO_SETUP=1 devp init ~/Code
45 Register repositories, install nothing
46
47OPTING OUT:
48 ignore.devprune.json A file by that name in a repository keeps it out,
49 both of a bulk scan and of every prune pass
50
51UNDO:
52 devp undo Reverts the most recent init or link";
53
54pub const LINK_LONG: &str = "\
55Register one Git repository for pruning. The path defaults to `.`, so inside a \
56repository `devp link` is the whole command. Registration writes one entry to \
57dev-prune's registry; the repository itself is untouched.
58
59`--quiet` is the form the global Git hook invokes: it prints nothing (a hook fires \
60inside someone's commit, whose terminal is not dev-prune's to write to) and it skips \
61repositories whose `.devprune.json` sets `disable_hooks`, so a workspace that opted \
62out of auto-registration stays out.";
63
64pub const LINK_EXAMPLES: &str = "\
65EXAMPLES:
66 devp link Register the current directory
67 devp link ~/Code/my-app Register a repository by path
68 devp link . --quiet What the Git hook runs; silent, honours opt-outs
69
70UNDO:
71 devp undo Reverts the most recent init or link
72 devp unlink Unregister (keeps every file on disk)";
73
74pub const UNLINK_LONG: &str = "\
75Remove a repository from dev-prune's registry. This deletes the registry entry and \
76nothing else — no workspace file is touched, and the repository's `.devprune.json`, \
77if it has one, stays where it is.
78
79`--missing` removes every registered path whose directory no longer exists, instead \
80of one named repository. Deleted clones, reformatted drives and moved workspaces all \
81leave dead entries behind; `devp doctor` counts them in one warning and points here \
82rather than printing one `devp unlink` line per dead path.";
83
84pub const UNLINK_EXAMPLES: &str = "\
85EXAMPLES:
86 devp unlink Unregister the current directory
87 devp unlink ~/Code/old-app Unregister a repository by path
88 devp unlink --missing Drop every entry whose path no longer exists";
89
90pub const UNDO_LONG: &str = "\
91Revert the most recent `devp init` or `devp link`: whatever repositories that one \
92action registered are unregistered again. Only registration is undone — `undo` never \
93deletes files, and it is not the undo for a prune (that is `devp restore --last-run`).";
94
95pub const UNDO_EXAMPLES: &str = "\
96EXAMPLES:
97 devp undo Unregister whatever the last init/link registered
98
99RELATED:
100 devp restore --last-run The undo for a prune pass — reinstalls what it deleted";
101
102pub const RUN_LONG: &str = "\
103Execute a prune pass: across every registered repository with no path, or on one \
104repository with `devp run <path>`. Each repository goes through the same gauntlet, \
105and a directory is deleted only when every check passes:
106
107 1. `ignore.devprune.json` in the root, or `\"ignore\": true` — skipped instantly.
108 2. Idle check: last commit and newest source mtime, against `idle_days` (15 by
109 default). `--ignore-idle` lifts this one check and nothing else.
110 3. Project discovery: the root and up to `scan_depth` levels below it (6 by
111 default), so a monorepo's every package is found.
112 4. The package manager's own binary must be present — a directory whose manager
113 is missing cannot be verified, so it is not touched.
114 5. Lockfile verification: the manager itself confirms the lockfile can rebuild
115 the directory. No flag bypasses this, and none ever will.
116 6. Size floor (`min_size_mb` / `--min-size`), symlink refusal, nested-repository
117 refusal.
118
119Interactively, a registry-wide pass opens a selection TUI showing what would be \
120deleted before anything is; a targeted `devp run <path>` lists every directory with \
121its size and the total, notes that `devp restore` brings it back, and asks. Either \
122way `-y` skips the confirmation, `--dry-run` reports what a pass would do without \
123deleting anything at all, and without a terminal the run exits with an error naming \
124`--yes` rather than waiting on a prompt. Adapter names for `--only`/`--skip` are: npm, pnpm, yarn, bun, uv, \
125poetry, pdm, pipenv, venv, cargo, go, composer, bundler, cocoapods, mix, mix_build, \
126gradle, maven, swift, terraform, dart, vcpkg, cmake_build — an unknown name is an \
127error listing the valid ones, not a silently empty pass. cargo, gradle, maven, \
128swift, dart, mix_build, vcpkg and cmake_build are opt-in (`devp config set \
129enable_cargo true`) and idle-gated separately by `build_idle_days`, because a \
130build directory takes far longer to get back than a dependency directory. \
131`devp config wizard` switches them on by language, and can give any one adapter \
132its own idle window.
133
134`--except` is the safe spelling of \"clean up but keep the API project\": the named \
135repositories are never verified, never deleted and never restored, which beats \
136pruning them and downloading everything back. Entries match by full path or by \
137directory name, case-insensitively, `~` expanded.
138
139`--explain` answers \"why was that repository not pruned?\": every repository and \
140directory is listed with its verdict, including the states a normal pass keeps quiet \
141about — still active (with the actual age), opted out, under the size floor. It is \
142read-only and cannot be combined with `--json`.";
143
144pub const RUN_EXAMPLES: &str = "\
145EXAMPLES:
146 devp run --dry-run What would be pruned, and why the rest would not
147 devp run Prune across all registered repositories (asks first)
148 devp run -y Same, no confirmation prompt
149 devp run . Prune only the current repository (asks first)
150 devp run ~/Code/my-app --ignore-idle -y
151 Prune it even though it was touched recently
152 devp run --except api-service,~/Code/playground
153 Everything except the ones you name
154 devp run --only cargo,uv --dry-run
155 Only these package managers
156 devp run --skip venv --min-size 50
157 Skip venvs; ignore directories under 50 MiB
158 devp run --json --dry-run One JSON document on stdout (schema in CLI_REFERENCE)
159 devp run --explain Why each repository would or would not be pruned
160
161Run interactively with a terminal, `--json` also copies the document to the clipboard.
162A run in which any repository failed exits 1, even if others succeeded.";
163
164pub const STATUS_LONG: &str = "\
165The dashboard: every registered repository with its state (Candidate, Active, \
166Ignored, No Bloat, Path Missing, or an unreadable `.devprune.json`), its reclaimable \
167space, and its last activity. In a terminal this is an interactive TUI; piped or \
168redirected it prints a plain table; `--json` replaces either with one document and \
169changes nothing at all.
170
171Sizes are what deleting the directory actually gives back: bytes hardlinked into a \
172pnpm or bun store are measured per file and excluded, because the store keeps them.
173
174TUI KEYS:
175 Up/Down, j/k Move PgUp/PgDn Jump ten rows
176 Home/End, g/G First/last p Prune-select mode (candidates pre-selected)
177 Space Toggle row a Toggle all candidates
178 Enter Prune the selection i Toggle ignore in .devprune.json
179 Esc Leave mode / exit q, Ctrl-C Exit
180
181SHORTCUTS:
182 devp status daemon = devp config daemon status
183 devp status . hook = devp config hook . status";
184
185pub const STATUS_EXAMPLES: &str = "\
186EXAMPLES:
187 devp status The dashboard (TUI in a terminal, table when piped)
188 devp status --top 10 Only the ten biggest repositories; totals unaffected
189 devp status --drift What would a prune refuse on, and how to record it
190 devp status --json | jq '.totals.reclaimable_bytes'
191 Machine-readable; stdout carries the document only
192 devp status --top 5 --json The trim is reported as a top-level \"top\" field
193
194Run interactively with a terminal, `--json` also copies the document to the clipboard.";
195
196pub const STATS_LONG: &str = "\
197What dev-prune has already done, as opposed to what it could do next: lifetime space \
198reclaimed, how many prune passes there have been, the most recent pass and how to \
199undo it, the last passes, and the repositories that have given back the most. \
200Read-only — it reads the registry and touches nothing.";
201
202pub const STATS_EXAMPLES: &str = "\
203EXAMPLES:
204 devp stats The report
205 devp stats --json | jq '.lifetime.bytes_freed'
206 Lifetime bytes as a number
207
208Run interactively with a terminal, `--json` also copies the document to the clipboard.";
209
210pub const HISTORY_LONG: &str = "Which pass deleted what. `devp stats` counts the passes and adds up the bytes; this lists them, newest first, and `--pass 1` opens one up: when it ran, whether someone typed it or the scheduler started it, the exact command with its flags, and every directory it removed grouped under the repository it came from.
211
212The list is one line per pass on purpose. A pass across forty repositories has hundreds of directories in it, so the detail is asked for by number rather than printed by default, and `--export` writes the whole log to a file for the times when the answer really is all of it. Redirect or pipe `--pass N` and nothing is elided — only a terminal gets a cap, because only a terminal has a scrollback to lose it in.
213
214Per-directory detail is recorded from 1.17.0 onward. Passes older than that are still listed, from the totals the registry has always kept, and marked so an upgraded machine does not look like it lost them.
215
216Read-only. It reads the log and the registry and writes nothing, except the file `--export` is asked for.";
217
218pub const HISTORY_EXAMPLES: &str = "EXAMPLES:
219 devp history Every pass, one line each, newest first
220 devp history --all Past the 20 the list stops at
221 devp history --pass 1 What the most recent pass deleted, and what asked it to
222 devp history --pass 3 --json That pass as one JSON document
223 devp history --export Write the whole log to your documents folder
224 devp history --export ./log.json
225 Write it where you say instead
226 devp history --json | jq '[.passes[] | select(.trigger == \"scheduled\")]'
227 Only the passes nobody typed
228
229Run interactively with a terminal, `--json` also copies the document to the clipboard.";
230
231pub const MAN_LONG: &str = "Render the manual, from the same clap definitions `--help` prints, so the manual cannot describe a flag the program does not have.
232
233`devp man` at a terminal prints the contents page: every command grouped by what it is for, one line each, plus the flags that go before the command and the exit codes. `devp man <command>` prints that one command's page — the same text `devp <command> --help` prints, because they are the same definition.
234
235The roff source is something `man` formats, not something a person reads, and on Windows there is no `man` to hand it to, so it appears only where something can use it: redirect or pipe the output and it is roff again, so `devp man > devp.1` and `devp man | man -l -` are unchanged. `--roff` forces roff at a terminal too.
236
237`--dir` writes the full set (`devp.1`, `dev-prune.1`, and one `devp-<command>.1` per subcommand) into a directory, ready to copy onto `manpath`.";
238
239pub const MAN_EXAMPLES: &str = "EXAMPLES:
240 devp man The contents page, on any platform
241 devp man run One command's page
242 devp man | man -l - Read it formatted by man (Linux/macOS)
243 devp man --roff > devp.1 Save the roff source
244 devp man run --roff > devp-run.1 Save one page's roff source
245 devp man --dir ./man Write the full set into ./man
246 sudo cp man/*.1 /usr/local/share/man/man1/ Install them system-wide";
247
248pub const COMPLETIONS_LONG: &str = "\
249Print a shell completion script to stdout — the script and nothing else, because the \
250output is meant to be redirected or eval'd and anything extra becomes a shell error \
251on every new terminal.
252
253The script is generated from the same argument definition the binary parses with, so \
254a flag cannot exist in one and be missing from the other. It completes whichever name \
255invoked it: `devp completions bash` completes `devp`, `dev-prune completions bash` \
256completes `dev-prune` — generate one for each name you actually type.";
257
258pub const COMPLETIONS_EXAMPLES: &str = "\
259EXAMPLES:
260 source <(devp completions bash) Bash, current shell
261 devp completions bash > ~/.local/share/bash-completion/completions/devp
262 devp completions zsh > ~/.zfunc/_devp Zsh (a directory on $fpath)
263 devp completions fish > ~/.config/fish/completions/devp.fish
264 devp completions powershell | Out-File -Append -Encoding utf8 $PROFILE
265 PowerShell, permanently";
266
267pub const CACHES_LONG: &str = "\
268Find every package-manager cache and store on the machine, size each one, and print \
269the command that clears it — largest first, with a total. On its own it deletes \
270nothing, and nothing that runs on a schedule ever will: a cache is shared by every \
271repository, so no single lockfile can prove its contents recoverable, which is the \
272bar every dev-prune deletion has to clear. Clearing one also turns the next `devp \
273restore` into a download.
274
275`devp caches clear <manager>` runs the command this table prints, after showing you \
276what goes and asking.
277
278`--volume V:` (or `--drive`, or `--volume /mnt/data`, or any path on the one you \
279mean) narrows the whole report to the caches that sit on one drive, and the \
280unfiltered table gains a line breaking the total down the same way. On a machine \
281whose projects live on a second disk, 22 GiB of caches is not the figure that \
282decides anything — the two gigabytes on the drive that is full is.
283
284Covered: npm, pnpm, yarn, bun, uv, pip, conda, cargo, go, maven, gradle, nuget, vcpkg, \
285conan, composer, cocoapods and hex. Each manager is asked where its cache is (`npm \
286config get cache`, `go env GOMODCACHE`, …) rather than assumed, with read-only queries \
287run from your home directory; a manager that is not installed falls back to the \
288conventional location, because a cache left behind by an uninstalled manager is \
289exactly the multi-gigabyte directory nobody remembers.";
290
291pub const CACHES_EXAMPLES: &str = "\
292EXAMPLES:
293 devp caches The table, largest first, with clear commands
294 devp caches --json | jq '.summary.total_bytes'
295 Machine-readable
296 devp caches clear npm Empty one, after asking
297 devp caches clear all --dry-run What would go, and nothing touched
298 devp caches --volume V: Only what sits on that drive (--drive is the same)
299
300Run interactively with a terminal, `--json` also copies the document to the clipboard.";
301
302pub const CACHES_DOCKER_LONG: &str = "\
303What the engine is holding, in its own words: images, containers, local volumes and build cache, each with a count, a size, and how much of that size it believes it could give back. Then the commands that would give it back, narrowest first.
304
305Read-only, permanently. dev-prune deletes only what a lockfile proves it can rebuild, and nothing here clears that bar: an image's registry tag can be retagged or deleted, the Dockerfile that built it may not be on this disk, and a named volume is the one thing on the machine that is not reproducible at all. So this prints the prune commands and never runs them, with or without `--yes`.
306
307The numbers come from the engine's own `system df` rather than from a directory walk. On Docker Desktop and Podman the store lives inside a VM disk image the host cannot see, and `~/.docker` is configuration rather than data — a size taken off the filesystem would be wrong by orders of magnitude, in the reassuring direction. Asking the engine is also the only way to learn what is *reclaimable*, which is the figure that decides anything: 40 GB of images with 38 GB dangling is a different situation from 40 GB with 2 GB dangling.
308
309An engine that is installed with its daemon stopped is reported as exactly that, in the engine's own words, rather than as an absence.";
310
311pub const CACHES_CONTAINERS_LONG: &str = "\
312The same read-only report as `devp caches docker`, for every container engine on this machine — docker, podman, nerdctl, finch and Apple's `container` — or for the one you name. An engine that is not installed is not mentioned; there is nothing to say about a tool that is not there.
313
314Local Kubernetes clusters are listed by name and deliberately not sized. kind, k3d and minikube run their nodes as containers, or as a VM disk belonging to an engine already in the table, so their disk is counted there. A figure beside the cluster name would be the same gigabytes twice. Delete one with its own tool — `kind delete cluster`, `minikube delete`, `k3d cluster delete` — which is what actually releases the space. The cluster list is read out of your kubeconfig with `kubectl config get-contexts`, which contacts nothing: a context pointing at a production cluster is filtered out by name here rather than by being dialled.";
315
316pub const CACHES_CONTAINERS_EXAMPLES: &str = "\
317EXAMPLES:
318 devp caches docker Images, containers, volumes, build cache
319 devp caches podman The same, for Podman
320 devp caches containers Every engine installed, plus local clusters
321 devp caches containers nerdctl Just that one
322 devp caches containers container Apple's engine, on Apple silicon
323 devp caches docker --json | jq '.summary.reclaimable_bytes'
324 Machine-readable
325
326Nothing here deletes anything. The prune commands are printed for you to run.";
327
328pub const CACHES_CLEAR_LONG: &str = "\
329Empty one manager's cache, or every one of them. What is about to go is listed and \
330sized first, and unless `--yes` answers for you, it asks.
331
332This is a convenience, not automation. No scheduler, no Git hook and no `devp run` \
333will ever clear a cache — this only runs when you type it.
334
335Wherever the manager ships its own subcommand, that is what runs: `npm cache clean \
336--force`, `pnpm store prune`, `go clean -modcache`. The manager knows what is still \
337referenced, which a directory delete cannot work out, and its own bookkeeping stays \
338consistent. cargo, gradle, vcpkg and hex ship nothing equivalent, so those \
339are cleared by removing the directory this command resolved and sized — never a string \
340handed to a shell.
341
342Maven is reported and never cleared. `~/.m2/repository` is an install target as \
343well as a download cache — `mvn install:install-file` puts artifacts there that no \
344remote can hand back — so dev-prune sizes it and prints `rm -rf ~/.m2/repository` \
345for you to run. `clear maven` says so and stops; `clear all` skips it.
346
347Two flags narrow what `all` means, so you do not have to pick the caches by hand. \
348`--over-cap` keeps only the managers that have outgrown the ceiling you set in \
349`cache_max_gb`; with no cap set anywhere it clears nothing and says so. `--unused` keeps \
350only the managers that no registered repository uses — a cache with nothing behind it \
351was filled for projects that are not on this disk any more. It counts only repositories \
352dev-prune knows about, so `devp link` anything you keep outside the registry first, and \
353it refuses to run at all when there are no registered repositories to check against.
354
355Nothing else in a cache is lost; every manager re-downloads what it needs. What it costs \
356is time, in every project on the machine, on the next install and the next `devp \
357restore`. The freed size reported afterwards is measured rather than assumed, because \
358a `prune` keeps what is still in use.";
359
360pub const CACHES_CLEAR_EXAMPLES: &str = "\
361EXAMPLES:
362 devp caches clear npm One manager, after confirming
363 devp caches clear cargo Both cargo rows: the registry cache and its sources
364 devp caches clear all --dry-run Everything that would go, and nothing touched
365 devp caches clear all --over-cap
366 Only the ones past their cache_max_gb
367 devp caches clear all --unused Only the ones no registered repository uses
368 devp caches clear all --yes No prompt, for a script
369 devp caches clear go --json --yes
370 Machine-readable (`--json` requires `--yes`)
371
372Exit code 1 if any cache could not be cleared; the rows are printed either way.
373Exit code 2 for `maven`, which is reported but never cleared.";
374
375pub const TRUST_LONG: &str = "\
376What dev-prune is allowed to do on this machine, on one screen. Read-only — it reads \
377the registry and the OS and changes nothing.
378
379Two sections, and the split is the point. The first is guaranteed by the code: the \
380seven safety invariants plus the two questions asked as often as any of them — there \
381is no telemetry endpoint, and build output is never deleted. Those rows read the same \
382on every machine and have no setting and no flag behind them. The second is read live \
383off this machine: whether the scheduler is installed, whether the Git hooks register \
384repositories on their own, how many repositories are registered, and the settings that \
385widen what may happen without you asking for it.
386
387There is no letter grade. A report that says `trust level: MEDIUM` tells you nothing \
388you can act on, so the widened settings are named instead — `devp config show` has \
389every one of them, and `devp config set <key> <value>` puts one back.
390
391The long form of the guarantees is docs/SAFETY_INVARIANTS.md.";
392
393pub const TRUST_EXAMPLES: &str = "\
394EXAMPLES:
395 devp trust The report
396 devp trust --json | jq '.summary.widened'
397 Just the settings that widen what may happen
398 devp trust --json | jq -e '.summary.widened_count == 0'
399 Exit 1 from jq if this machine has widened anything
400
401Run interactively with a terminal, `--json` also copies the document to the clipboard.";
402
403pub const CONFIG_LONG: &str = "\
404Everything configurable lives under here: global settings (get/set/show/wizard), the \
405per-repository `.devprune.json` (project), the OS background scheduler (daemon), the \
406global Git auto-registration hooks (hook), and the file-manager icon registration \
407(icon).
408
409SHORTHANDS — `daemon`, `hook` and `icon` work without the leading `config`, and the \
410action words people reach for are accepted:
411 devp hook install = devp config hook enable
412 devp hook uninstall = devp config hook disable
413 devp daemon on / off = devp config daemon enable / disable
414 devp icon = devp config icon
415Accepted action words: enable/install/on, disable/uninstall/remove/off, status/show. \
416Anything else is rejected — a mistyped action never silently degrades into a status \
417report.";
418
419pub const CONFIG_EXAMPLES: &str = "\
420EXAMPLES:
421 devp config show Every global setting and its value
422 devp config get idle_days One setting
423 devp config set idle_days 30 Change it (rejects out-of-range values)
424 devp config recommended Turn on everything the first run recommends
425 devp config wizard Walk through every setting, Enter keeps the current
426 devp config project . Inspect or create this repo's .devprune.json
427 devp config daemon status Is the background pass scheduled?
428 devp config . daemon disable Opt this repository out of the background pass
429 devp config hook enable --chain Take core.hooksPath, forwarding to the tool holding it
430 devp config icon Register the .devprune.json icon and schema";
431
432pub const CONFIG_GET_LONG: &str = "\
433Print one global setting's current value. The keys, defaults and meanings:
434
435 idle_days 15 Days untouched before a repo is a candidate
436 min_size_mb 0 Smallest directory worth deleting (0 = no floor)
437 scan_depth 6 Directory levels below a repo root discovery descends (1-32)
438 require_confirmation true Whether a prune pass asks before deleting
439 allow_manifest_rewrite false Whether verification may repair a drifted lockfile
440 command_timeout_secs 600 Ceiling on any one package-manager command
441 auto_setup true Whether the integration pass may run unattended
442 auto_daemon true …and may register the OS scheduler
443 check_interval_days 2 How often the scheduler runs a pass
444 auto_hooks true …and may install the global Git hooks
445 auto_hooks_chain false …and may chain onto another tool's core.hooksPath
446 update_check true Whether the periodic release check runs
447 update_check_interval_days 7 Minimum gap between two release checks
448 update_check_timeout_secs 5 How long that one request may hang
449
450Three have a per-repository override in `.devprune.json`, where they win for that \
451tree only: `idle_days` (spelled `override_idle_days` there), `min_size_mb` and \
452`scan_depth`. The rest are deliberately global — a committed `.devprune.json` must \
453not be able to grant a repository `allow_manifest_rewrite` over its own manifests.";
454
455pub const CONFIG_GET_EXAMPLES: &str = "\
456EXAMPLES:
457 devp config get idle_days
458 devp config get update_check";
459
460pub const CONFIG_SET_LONG: &str = "\
461Change one global setting. A value outside the accepted range is rejected with the \
462range in the message, never silently clamped — `scan_depth 0` and `scan_depth 40` are \
463both refused outright. Keys are the same list `devp config get --help` shows.";
464
465pub const CONFIG_SET_EXAMPLES: &str = "\
466EXAMPLES:
467 devp config set idle_days 30
468 devp config set min_size_mb 50
469 devp config set command_timeout_secs 1200
470 devp config set update_check false Turn the release check off for good";
471
472pub const CONFIG_SHOW_LONG: &str = "\
473Print every global setting with its current value. With `--update`, also run a sync \
474pass across all registered repositories, refreshing each one's `.devprune.json` \
475scaffolding without touching values you have changed.";
476
477pub const CONFIG_SHOW_EXAMPLES: &str = "\
478EXAMPLES:
479 devp config show
480 devp config show --update";
481
482pub const CONFIG_PROJECT_LONG: &str = "\
483Inspect a repository's `.devprune.json`, or create it when missing. The file holds \
484the per-repository overrides — `override_idle_days`, `min_size_mb`, `scan_depth`, \
485`ignore`, `disable_daemon`, `disable_hooks` — and carries a `$schema` line so any \
486editor with JSON Schema support validates and completes it.
487
488`--update` refreshes the file's scaffolding (schema pointer, missing keys) while \
489keeping every value you have set. A file that does not parse is refused, not reset — \
490fix it, or pass `--update` deliberately.
491
492Writing the file also records it in the repository's `.git/info/exclude`, so the \
493config — one machine's preference, not part of the project — never shows up in \
494`git status`. The shared, tracked `.gitignore` is never modified.
495
496`--team` addresses `project.devprune.json` instead: same keys, same schema, and \
497deliberately not excluded, because it is the half meant to be committed. Every key it \
498names wins over `.devprune.json`; every key it leaves out is still yours to answer. It \
499is created empty apart from the schema line for that reason. Nothing dev-prune writes \
500on your behalf ever edits it.
501
502Both files can also carry `prunable.directories`: directories no lockfile describes, \
503each with the `rebuild` command that puts it back. Unlike every other key, the two \
504files' lists add up rather than one winning — a team declaration never discards your \
505own. Before deleting one, dev-prune checks that it is inside the repository, that Git \
506is tracking nothing in it, and that the rebuild command's tool is on this machine.
507
508`prunable.exclude` lists declared paths to leave alone on this machine, whoever \
509declared them — how you keep a directory the committed file calls rebuildable without \
510editing a file the whole team shares. Spelled the same way as a `path`, and honoured \
511from whichever file names it, because a veto only ever deletes less. Naming one path in \
512both lists of the *same* file is a typo rather than a decision — the exclusion still \
513wins, so the declaration never runs — and `devp doctor` says so.
514
515Both files are read from the repository root and nowhere else, because the paths inside \
516them are relative to that root. A copy one directory down parses and does nothing at \
517all; `devp doctor` names it rather than moving it, since moving it would change what \
518every path inside it means.";
519
520pub const CONFIG_PROJECT_EXAMPLES: &str = "\
521EXAMPLES:
522 devp config project . Show (or create) this repository's config
523 devp config project ~/Code/api
524 devp config project . --update Refresh scaffolding, keep your values
525 devp config project . --team Create the committed project.devprune.json";
526
527pub const CONFIG_DAEMON_LONG: &str = "\
528The OS background scheduler — Task Scheduler on Windows, launchd on macOS, systemd \
529timers on Linux — which runs `devp run --daemon` every `check_interval_days` days.
530
531Globally: `enable` registers the schedule, `disable` removes it, `status` reports \
532it. With a path first, the same words act on one repository via `disable_daemon` in \
533its `.devprune.json`: the machine-wide pass keeps running, that repository sits it \
534out.";
535
536pub const CONFIG_DAEMON_EXAMPLES: &str = "\
537EXAMPLES:
538 devp daemon status Machine-wide scheduler state
539 devp daemon enable Register the schedule (also: install, on)
540 devp daemon disable Remove it (also: uninstall, remove, off)
541 devp config . daemon disable This repository opts out of the background pass
542 devp config ~/Code/api daemon enable";
543
544pub const CONFIG_HOOK_LONG: &str = "\
545The global Git hooks (via `core.hooksPath`) that auto-register any repository you \
546commit in — `devp link --quiet`, silent, honouring opt-outs. `enable` installs them, \
547`disable` removes them (restoring what was there), `status` reports them. With a \
548path first, the same words act on one repository via `disable_hooks`.
549
550Git has exactly one global `core.hooksPath` and no way to chain two, so a tool that \
551holds it (husky, pre-commit, lefthook) shuts every other one out. `--chain` is the \
552way through: dev-prune takes the slot and writes, per hook, a shim that does its own \
553work and then execs the same-named hook in the displaced directory — their hooks \
554keep firing, their exit codes still block commits. `devp hook uninstall` puts the \
555original back. The chain snapshots the other tool's hooks at install time; `devp \
556hook status` reports any that have drifted, and `devp hook install --chain` rebuilds.";
557
558pub const CONFIG_HOOK_EXAMPLES: &str = "\
559EXAMPLES:
560 devp hook status Installed? Chained? Drifted?
561 devp hook install Take the free core.hooksPath slot
562 devp hook install --chain Take a slot husky/pre-commit/lefthook holds, forwarding
563 devp hook uninstall Restore the previous core.hooksPath
564 devp config . hook disable This repository opts out of auto-registration";
565
566pub const CONFIG_ICON_LONG: &str = "\
567Register `*.devprune.json` with the OS file manager and write the icon files and the \
568JSON Schema into the config directory. On Linux this is a complete registration \
569(shared-mime-info plus hicolor icons — Nautilus, Dolphin, Thunar, Nemo, PCManFM). On \
570Windows, Explorer resolves icons by last extension only, so the config folder gets \
571its own icon instead of hijacking every `.json` on the machine. On macOS a UTI must \
572come from an application bundle, which a single binary is not.
573
574It also prints an editor snippet to paste yourself — it never edits your editor \
575settings, your PATH, or your shell startup files.";
576
577pub const CONFIG_ICON_EXAMPLES: &str = "\
578EXAMPLES:
579 devp icon Same command, without the leading `config`";
580
581pub const CONFIG_RECOMMENDED_LONG: &str = "\
582Turn on everything the first run recommends, without sitting through the first run.
583
584The recommendations are the adapters and behaviours that are off by default because \
585they are not universally wanted, not because they are risky: Cargo, Gradle, Maven, \
586Swift, Dart, Mix builds, vcpkg and CMake builds. Accepting them all is one command \
587here and one keypress in `devp config wizard`, and both read the same list, so the \
588two can never drift apart.
589
590One recommendation is held back: `allow_manifest_rewrite` lets `cargo` and `go` tidy \
591up their own manifests during a restore, which edits files in your working tree. \
592That is worth having and it is worth knowing about first, so it arrives only when \
593you type --with-cautious. Everything printed is also printed by `devp config show`, \
594which lists whatever you have not taken yet.
595
596Nothing here is irreversible: `devp config set <key> false` puts any of it back, and \
597this command never marks the settings as reviewed — the walkthrough you skipped is \
598still owed to you, and will still open.";
599
600pub const CONFIG_RECOMMENDED_EXAMPLES: &str = "\
601EXAMPLES:
602 devp config recommended Everything recommended without a caveat
603 devp config recommended --with-cautious That, plus allow_manifest_rewrite
604 devp config show What is still outstanding
605 devp config set enable_cargo false Put one back";
606
607pub const CONFIG_WIZARD_LONG: &str = "\
608Open every global setting in a full-screen configurator, with the `devp trust` \
609declaration in front of it: what this tool is allowed to do is on screen before any \
610of it is configurable.
611
612Enter is the \"keep going\" key: on a row with an untaken recommendation it takes \
613that advice and moves on, on any other row it just moves on, and on the Finish line \
614it opens a summary of exactly what will be written — one more Enter writes it. So \
615holding nothing but Enter reviews every setting, accepts the safe recommendations, \
616and finishes. The walk never takes the cautious tier (`allow_manifest_rewrite`); \
617turning that on stays a deliberate Space on its row. Arrows move without accepting \
618anything; Space changes the highlighted setting — a toggle flips, a number opens a \
619field, `disabled_adapters` opens the adapter checklist; `r` puts one back. `q` \
620leaves without saving anything, from anywhere.
621
622`devp config recommended` is the one-command version of the suggestions screen, for \
623when you know what you want and do not want to walk the list.
624
625It runs itself once on a first install — so the defaults are something you agreed \
626to, not something you inherited — and again after an upgrade adds a setting this \
627machine has never been shown, which it marks NEW and opens on. Settings you have \
628already confirmed are never re-asked.
629
630It never runs unattended: no TTY means skipped, not guessed at. `--no-tui`, and the \
631DEV_PRUNE_NO_TUI environment variable, ask one question per line instead — for \
632terminals the full-screen view cannot drive, and for agents, which hold a real \
633terminal and will never press a key. To configure this tool from a script, use \
634`devp config set <key> <value>`, which needs no terminal at all.";
635
636pub const CONFIG_WIZARD_EXAMPLES: &str = "\
637EXAMPLES:
638 devp config wizard
639 devp config wizard --no-tui One question per line
640 devp config set disabled_adapters go Leave Go projects alone entirely
641 devp config set disabled_adapters - Every adapter active again";
642
643pub const RESTORE_LONG: &str = "\
644Put dependencies back: detect each project's lockfile and run its manager's install \
645(`npm ci`, `pnpm install`, `uv sync`, `cargo fetch`, …). Mirrors pruning — every \
646project in the tree is restored, each by its own manager, so a monorepo comes back \
647whole.
648
649`--last-run` restores exactly what the most recent prune pass deleted, across every \
650repository it touched, and nothing else: the undo for a `devp run`. Each prune \
651records what it removed (a dry run records nothing), and the flag fails cleanly if \
652no pass has been recorded yet. It cannot be combined with a path — silently ignoring \
653the path would restore the wrong thing.";
654
655pub const RESTORE_EXAMPLES: &str = "\
656EXAMPLES:
657 devp restore Restore the current directory's projects
658 devp restore ~/Code/my-app
659 devp restore --last-run Undo the last prune pass, everywhere it acted";
660
661pub const UPDATE_LONG: &str = "\
662Print the installed version, ask GitHub for the latest release, and show the upgrade \
663command for how this copy was installed. When a newer release exists and stdin is a \
664terminal it then asks `Install vX.Y.Z now? [y/N]`; Enter leaves the binary alone, `y` \
665downloads the release, verifies its checksum and replaces every copy this install \
666runs, falling back to the package manager that owns this copy (cargo, npm, bun, pnpm, \
667yarn, uv, pipx, or the installer script) when there is no published binary for the \
668platform. `--install` or `-y` gives that answer up front; a copy run from a script or a \
669pipe is never asked and only prints the command. `--channels` prints the command for \
670every channel instead of only this one, and touches nothing. `auto_update` is on by default and does the verified-download half by \
671itself at the end of a prune pass when a newer release is known — never the \
672package-manager half, and nothing at all on WinGet, Scoop and Homebrew, where the \
673manager owns the upgrade; `devp config set auto_update false` stops it. An upgrade never interrupts the \
674scheduler: the scheduled pass runs a managed copy that refreshes itself from the \
675new binary on its next run.
676
677`devp config set version_lock true` outranks all of it. While the pin is on this \
678copy stays on the version it is: `auto_update` does not run however it is set, \
679`--install` refuses, `devp install --channel` refuses because moving channels \
680installs the latest release, and the install scripts leave the binary alone. \
681No flag bypasses it -- `devp config set version_lock false` is the way back.
682
683The same check also runs quietly from `devp run` and `devp status`, at most once \
684every `update_check_interval_days` (7 by default), printing one line only when a \
685newer version exists. It is the only thing in dev-prune that opens a network \
686connection, sends no body and no identifier, and `devp config set update_check \
687false` turns it off for good; `--offline` skips it for one run without changing the \
688setting.";
689
690pub const UPDATE_EXAMPLES: &str = "\
691EXAMPLES:
692 devp update Version, latest release, upgrade command, then [y/N]
693 devp update -y The same, answering the prompt with yes
694 devp update --install Upgrade now, without the version report
695 devp update --channels Every channel's upgrade command, no network
696 devp update --offline No network this run";
697
698pub const INSTALL_LONG: &str = "\
699Move this installation from one package manager to another.
700
701`devp update` always upgrades the copy that is running, through whichever channel \
702installed it. This command changes *which* channel owns it: it installs through the \
703manager you name, then removes the old copy through the manager that put it there — in \
704that order, so a failed install leaves the working copy untouched.
705
706Removing the old copy through its own manager, rather than deleting the file, is the \
707point: uv, pipx, npm, cargo and the rest each keep a record of what they installed, and \
708a manager whose record still says dev-prune is there will put the old binary back.
709
710bun, pnpm and yarn install the same npm package and are each their own channel, not \
711npm. A copy `bun add -g dev-prune` put in place is upgraded with bun and removed with \
712bun; running npm against it installs a second copy under npm's prefix and leaves the \
713first one stale and still on PATH.
714
715Nothing is migrated, because nothing needs to be. Settings, the repository registry and \
716the undo history live in the config directory, which no package manager owns.
717
718With no `--channel` it prints which manager installed this copy and what `--channel` \
719accepts. `--dry-run` prints the commands without running any of them.";
720
721pub const INSTALL_EXAMPLES: &str = "\
722EXAMPLES:
723 devp install Which channel owns this copy
724 devp install --channel winget --dry-run Print the plan, change nothing
725 devp install --channel uv Move onto uv, and remove the old copy
726 devp install --channel cargo --yes Skip the confirmation prompt";
727
728pub const SKILL_LONG: &str = "\
729Teach your AI assistant this tool. Exports SKILL.md — the full agent-facing manual: \
730every command, the JSON contracts, the safety invariants, the troubleshooting tree — \
731into the config directory, installs it into any detected agent skills directory \
732(`~/.claude/skills/dev-prune/`, the same install `devp setup` performs), and prints \
733ready-to-copy onboarding prompts for assistants without one (Gemini Antigravity, \
734Cursor, Windsurf, Copilot, OpenClaw).
735
736`--agent <EDITOR>` instead writes per-repository rules into the current repository, in \
737the file that editor's agent reads. Ten editors get a file of their own — cursor, \
738windsurf, antigravity, cline, roo, kilocode, continue, amazon-q, kiro, trae — and six \
739share a file with other tools, so dev-prune owns a marked block inside it: agents-md \
740(`AGENTS.md`, the cross-tool convention Codex, Jules, Amp and OpenCode read), copilot \
741(`.github/copilot-instructions.md`), gemini (`GEMINI.md`), junie \
742(`.junie/guidelines.md`), zed (`.rules`) and aider (`CONVENTIONS.md`, the one file its \
743editor does not read by finding it — writing it prints the `read: CONVENTIONS.md` line \
744that makes Aider load it). Every byte outside the markers is left as found. \
745`devp skill --help` lists each value with its exact path. Claude Code needs no \
746per-repository file — its skill installs globally.";
747
748pub const SKILL_EXAMPLES: &str = "\
749EXAMPLES:
750 devp skill Export SKILL.md, print onboarding prompts
751 devp skill --agent cursor Write .cursor/rules/dev-prune.mdc here
752 devp skill --agent agents-md Upsert the marked block in AGENTS.md";
753
754pub const SETUP_LONG: &str = "\
755Install whatever integration is missing and leave the rest alone: the `devp` alias, \
756the managed binary directory on your PATH (a user PATH entry on Windows, \
757`~/.local/bin` symlinks elsewhere — what keeps `devp` working after the venv or npx \
758cache it came from disappears), the exported SKILL.md and its agent-directory \
759install, the file-manager icon registration, the global Git hooks, and the OS \
760scheduler. Safe to run repeatedly: it is the same pass the install scripts run, the \
761same one `devp init` runs, and the same one that runs by itself on the first command \
762after an upgrade. Typing it is also the durable yes to the first-run question: a \
763machine where the setup walkthrough was quit -- or never shown -- treats `devp setup` \
764as the answer, and upgrades maintain what it installed from then on.
765
766It skips rather than forces: Git hooks when `git` is missing or another tool holds \
767`core.hooksPath` (take the slot with `devp hook install --chain`), the alias when \
768the running process is `devp` itself on Windows, and anything switched off by \
769`auto_setup`, `auto_hooks`, `auto_daemon` or `DEV_PRUNE_NO_AUTO_SETUP=1`.
770
771When a VS Code-family editor is on your PATH (VS Code, VSCodium, Cursor, Windsurf, \
772Positron, Kiro, or an Insiders build) and the dev-prune extension is not installed, \
773one run also asks — once ever, only at a terminal — whether to install it into each \
774editor found. Each editor installs from its own registry; when a fork's registry does \
775not carry the extension, the `.vsix` from the extension's own newest release is \
776installed instead. Decline and it never asks again; install it yourself later with \
777`code --install-extension VKrishna04.dev-prune`.";
778
779pub const SETUP_EXAMPLES: &str = "\
780EXAMPLES:
781 devp setup Install what is missing, report what was skipped
782 devp setup --status Report only; change nothing
783 DEV_PRUNE_NO_AUTO_SETUP=1 devp init ~/Code
784 Register repositories, install nothing";
785
786pub const DOCTOR_LONG: &str = "\
787One read-only pass that answers \"why is this not doing what I expect\". Without a \
788path it checks the installation: binary and twin, PATH, registry health, every \
789stored setting revalidated, SKILL.md, icons, hooks, scheduler, the package-manager \
790binaries your repositories actually need, and the release-check state. With a path \
791it checks that repository and ends by naming the single reason a prune would or \
792would not touch it.
793
794`--fix` is diagnosis first, then treatment — and it mends installed-but-broken only: \
795a stale or missing `devp` twin, a missing SKILL.md export, hooks or a scheduler \
796whose recorded binary moved, a drifted hook chain, and registry entries whose \
797repository is gone. Each repair is the corresponding `devp setup` pass re-run, so a \
798repair can never do more than setup itself would. It never performs a first-time \
799install, and never touches an unreadable registry — a parse failure is for you to \
800look at, not for a tool to guess at.
801
802EXIT CODES: 0 when everything works, warnings included — a missing scheduler should \
803not fail a script. 1 only for genuine breakage: an unreadable registry, an \
804out-of-range setting, a dead registered path, a directory that is not a Git \
805repository. `--fix` exits 1 when any repair failed or was out of reach.";
806
807pub const DOCTOR_EXAMPLES: &str = "\
808EXAMPLES:
809 devp doctor Check the installation
810 devp doctor . Why would a prune touch (or skip) this repository?
811 devp doctor ~/Code/api
812 devp doctor --fix Repair what the installation check finds broken";
813
814pub const UNINSTALL_LONG: &str = "\
815Remove dev-prune from the machine: the OS scheduler, the global Git hooks (only if \
816`core.hooksPath` still points at dev-prune), the file-type icons, the installed \
817agent skill, the PATH entry (or `~/.local/bin` symlinks), and the binaries — the \
818managed pair, the copy you invoked, and, with your confirmation, every other copy \
819found on PATH or in the well-known install directories (`~/.cargo/bin`, \
820`~/.local/bin`, npm's global directory, pip's Scripts directories). A copy owned by \
821a package manager is listed with its manager, and after removal the manager's own \
822uninstall command is printed so its records can be cleared too.
823
824On Windows, where a running executable cannot delete itself, a detached helper \
825removes the last files a few seconds after the command exits — no reboot, no closed \
826terminal.
827
828Without `--deep` the configuration survives, so a reinstall picks up where you left \
829off. With `--deep` the global config folder and every registered repository's \
830`.devprune.json` go too; that asks for confirmation, and refuses outright with no \
831terminal to ask on unless `-y` is passed. Exits 1 if anything could not be removed, \
832naming each leftover.";
833
834pub const UNINSTALL_EXAMPLES: &str = "\
835EXAMPLES:
836 devp uninstall Remove the program; keep config for a reinstall
837 devp uninstall --deep Also wipe config and per-repo .devprune.json (asks)
838 devp uninstall --deep -y Non-interactive; also confirms the stray-copy sweep";
839
840pub const COMMAND_GROUPS: [(&str, &[(&str, &str)]); 5] = [
853 (
854 "Register repositories",
855 &[
856 (
857 "init",
858 "find every Git repository under a path, register them",
859 ),
860 ("link", "register one repository"),
861 ("unlink", "forget one — deletes nothing"),
862 ("undo", "revert the last init or link"),
863 ],
864 ),
865 (
866 "Prune and put back",
867 &[
868 ("run", "delete what a lockfile proves comes back"),
869 ("restore", "reinstall what was deleted"),
870 ],
871 ),
872 (
873 "Look at what is going on",
874 &[
875 ("status", "every repository, its size and its idle days"),
876 ("stats", "space reclaimed over time"),
877 ("history", "which pass deleted what, and what asked it to"),
878 ("caches", "package manager caches on this machine"),
879 ("doctor", "what is broken, and how to fix it"),
880 ("trust", "what this program may do on this machine"),
881 ],
882 ),
883 (
884 "Settings and integration",
885 &[
886 ("config", "settings, the scheduler, Git hooks, icons"),
887 ("setup", "install whatever integration is missing"),
888 ("skill", "rules files for your editor's AI agent"),
889 ("completions", "a completion script for your shell"),
890 ("man", "this manual"),
891 ],
892 ),
893 (
894 "The program itself",
895 &[
896 ("update", "check for a newer release, and install it"),
897 ("install", "move it to another package manager"),
898 ("uninstall", "remove it, integration included"),
899 ],
900 ),
901];
902
903pub const HIDDEN_FROM_HELP: &[&str] = &["undo", "install"];
912
913pub const HELP_STYLES: clap::builder::Styles = clap::builder::Styles::styled()
918 .header(clap::builder::styling::AnsiColor::Green.on_default().bold())
919 .usage(clap::builder::styling::AnsiColor::Green.on_default().bold())
920 .literal(clap::builder::styling::AnsiColor::Cyan.on_default().bold())
921 .placeholder(clap::builder::styling::AnsiColor::Cyan.on_default());
922
923fn grouped_commands() -> String {
930 use colored::Colorize;
931 let mut out = String::new();
932 for (title, entries) in COMMAND_GROUPS {
933 let visible: Vec<&(&str, &str)> = entries
934 .iter()
935 .filter(|(name, _)| !HIDDEN_FROM_HELP.contains(name))
936 .collect();
937 if visible.is_empty() {
938 continue;
939 }
940 out.push_str(&format!("\n {}\n", title.bold()));
941 for (name, line) in visible {
942 let pad = " ".repeat(12usize.saturating_sub(name.len()));
943 out.push_str(&format!(" {}{pad} {line}\n", name.cyan().bold()));
944 }
945 }
946 out
947}
948
949pub static ROOT_HELP_TEMPLATE: std::sync::LazyLock<String> = std::sync::LazyLock::new(|| {
955 use colored::Colorize;
956 format!(
957 "{{before-help}}{{about-with-newline}}\n{{usage-heading}} {{usage}}\n\n{commands}\n{block}\n{options}\n{{options}}{{after-help}}",
958 commands = "Commands:".green().bold(),
959 block = grouped_commands(),
960 options = "Options:".green().bold(),
961 )
962});
963
964pub static ROOT_AFTER_HELP: std::sync::LazyLock<String> = std::sync::LazyLock::new(|| {
967 use colored::Colorize;
968 format!(
969 "{examples}
970 devp init ~/Code Scan directory trees & onboard workspaces
971 devp link Register current repository
972 devp run Execute prune pass across inactive repositories
973 devp status View system status dashboard
974 devp status --top 10 Show only the ten biggest reclaims
975 devp stats Lifetime totals, recent passes, biggest repositories
976 devp caches Size every package manager cache (deletes nothing)
977 devp completions powershell Emit a shell completion script
978 devp status daemon Check background daemon status (alias for `devp config daemon status`)
979 devp status . hook Check workspace Git hook status (alias for `devp config . hook status`)
980 devp config . daemon disable Disable daemon background pass for current workspace
981 devp restore . Restore missing node_modules/.venv via lockfile
982
983{alias}
984 `dev-prune` and `devp` invoke the exact same executable.
985
986dev-prune is written by VKrishna04 and licensed Apache-2.0.
987 https://github.com/Life-Experimentalist/dev-prune",
988 examples = "EXAMPLES:".green().bold(),
989 alias = "BINARY ALIAS:".green().bold(),
990 )
991});
992
993#[cfg(test)]
994mod tests {
995 use super::*;
996 use clap::CommandFactory;
997
998 #[test]
999 fn hidden_from_help_is_exactly_what_the_cli_hides() {
1000 let mut command = crate::Cli::command();
1003 command.build();
1004 for sub in command.get_subcommands() {
1005 if sub.get_name() == "help" {
1006 continue;
1007 }
1008 assert_eq!(
1009 sub.is_hide_set(),
1010 HIDDEN_FROM_HELP.contains(&sub.get_name()),
1011 "`{}` disagrees with HIDDEN_FROM_HELP",
1012 sub.get_name()
1013 );
1014 }
1015 }
1016
1017 #[test]
1018 fn the_front_page_lists_every_visible_command_and_no_hidden_one() {
1019 colored::control::set_override(false);
1022 let block = grouped_commands();
1023 colored::control::unset_override();
1024
1025 let mut command = crate::Cli::command();
1026 command.build();
1027 for sub in command.get_subcommands() {
1028 let name = sub.get_name();
1029 if name == "help" {
1030 continue;
1031 }
1032 let probe = format!(" {name} ");
1035 let listed = block.lines().any(|l| l.starts_with(&probe));
1036 assert_eq!(!sub.is_hide_set(), listed, "`{name}`");
1037 }
1038 }
1039}