dev-prune-darwin-x64 1.16.0 → 1.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -22
- package/bin/dev-prune +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -52,7 +52,7 @@ gigabytes hostage for a build you are not running.
|
|
|
52
52
|
|
|
53
53
|
`dev-prune` finds those directories across every Git repository you register, and deletes
|
|
54
54
|
them — but only after proving the exact command that puts them back would succeed. It
|
|
55
|
-
knows twenty-
|
|
55
|
+
knows twenty-four package managers, not just the obvious four: Composer, Bundler, Mix,
|
|
56
56
|
CocoaPods and Terraform are as first-class as npm and pip. It is a single Rust binary,
|
|
57
57
|
installs its own background schedule, and answers to two names: `dev-prune` and `devp`.
|
|
58
58
|
|
|
@@ -351,9 +351,12 @@ devp restore --last-run # put back exactly what that pass deleted
|
|
|
351
351
|
A few more worth knowing on day one:
|
|
352
352
|
|
|
353
353
|
```bash
|
|
354
|
-
devp stats # how much has been reclaimed so far, and by
|
|
354
|
+
devp stats # how much has been reclaimed so far, by repository and by package manager
|
|
355
|
+
devp history # which pass reclaimed it, and what started that pass
|
|
356
|
+
devp history --pass 1 # the exact command line, and every directory it took
|
|
355
357
|
devp caches # every package manager cache, sized. The report deletes nothing
|
|
356
|
-
devp caches docker # what Docker holds, and the prune commands
|
|
358
|
+
devp caches docker # what Docker holds, and the prune commands
|
|
359
|
+
devp caches clear docker # run the narrow ones — never a volume, never on a schedule
|
|
357
360
|
devp status --drift # anything installed that the lockfiles don't record?
|
|
358
361
|
devp doctor . # why is this repository not being pruned?
|
|
359
362
|
devp doctor --fix # repair a broken integration — never a first-time install
|
|
@@ -500,16 +503,27 @@ Container engines
|
|
|
500
503
|
```
|
|
501
504
|
|
|
502
505
|
Clearing 6 GiB of npm cache while a Docker install nobody has looked at in a year sits on
|
|
503
|
-
40 GiB is the mistake this exists to prevent. `devp caches podman
|
|
504
|
-
nerdctl`
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
506
|
+
40 GiB is the mistake this exists to prevent. `devp caches podman`, `devp caches
|
|
507
|
+
nerdctl`, `devp caches finch` and `devp caches containers container` — Apple's engine, on
|
|
508
|
+
Apple silicon — are the same report for those engines, and `devp caches containers` runs
|
|
509
|
+
every one it finds and lists any local Kubernetes clusters (kind, k3d, minikube) by name.
|
|
510
|
+
|
|
511
|
+
**The report deletes nothing, and nothing on a schedule ever will** — no daemon, no Git
|
|
512
|
+
hook and no `devp run` path reaches container disk, with or without `--yes`. What used to
|
|
513
|
+
end there now has a second half: `devp caches clear docker` runs the narrow commands for
|
|
514
|
+
you — `builder prune -a -f`, `image prune -a -f`, `container prune -f` — after printing
|
|
515
|
+
them and asking, and counts what came back on its own line in `devp stats`. Printing four
|
|
516
|
+
commands and asking you to go and type one in another window meant the 20 GiB you
|
|
517
|
+
reclaimed on its advice was yours to have remembered, and dev-prune could not account for
|
|
518
|
+
it.
|
|
519
|
+
|
|
520
|
+
**It will not touch a volume, and no flag makes it.** There is no argument anywhere in
|
|
521
|
+
that table containing the word, and a unit test fails the build if one appears. That is a
|
|
522
|
+
different promise from the lockfile rule: an image can be pulled again and a build cache
|
|
523
|
+
rebuilt, so those are a question of consent and the prompt is the consent. What is inside
|
|
524
|
+
a named volume is the only copy. `docker volume prune` stays a command this prints and
|
|
525
|
+
you type — and the estimate says how much unused-volume space it is leaving alone rather
|
|
526
|
+
than folding it into a number these commands cannot deliver.
|
|
513
527
|
|
|
514
528
|
The figures come from the engine's own `system df`, not a walk of the disk. On Docker
|
|
515
529
|
Desktop and Podman the store lives inside a VM disk image the host filesystem cannot see,
|
|
@@ -600,8 +614,8 @@ process that leaves a dirty working tree is a surprise.
|
|
|
600
614
|
| 🧩 **Any number of ecosystems per repository** | uv, npm and cargo in one root, or spread across `frontend/`, `services/api/` and `tools/cli/` — each discovered, verified and pruned on its own terms |
|
|
601
615
|
| ↩️ **One-command restore** | `devp restore .` reinstalls a tree; `devp restore --last-run` puts back exactly what the most recent pass deleted, across every repository it touched |
|
|
602
616
|
| 🕒 **Activity-aware** | Combines `git log` timestamps with source-file `mtime`, so uncommitted work protects a repository just as a commit does |
|
|
603
|
-
| 🐳 **Container report** | `devp caches docker` (also `podman`, `nerdctl`, or `containers` for all of them plus local Kubernetes clusters) breaks a container engine's disk into images, containers, local volumes and build cache, each with what the engine itself calls reclaimable, and prints the prune commands narrowest first with what each takes with it.
|
|
604
|
-
| 📊 **Cache report** | `devp caches` sizes every package manager cache and store on the machine — npm to cargo to conda, Maven, Gradle, NuGet, vcpkg, Conan, Composer, CocoaPods and
|
|
617
|
+
| 🐳 **Container report** | `devp caches docker` (also `podman`, `nerdctl`, `finch`, Apple's `container`, or `containers` for all of them plus local Kubernetes clusters) breaks a container engine's disk into images, containers, local volumes and build cache, each with what the engine itself calls reclaimable, and prints the prune commands narrowest first with what each takes with it. `devp caches clear docker` then runs the narrow ones for you, after asking, and counts them in `devp stats` — **never a volume**, and never from a scheduler or a hook. `devp caches` carries a one-line summary per engine, outside its own total |
|
|
618
|
+
| 📊 **Cache report** | `devp caches` sizes every package manager cache and store on the machine — npm to cargo to conda, Maven, Gradle, NuGet, vcpkg, Conan, Composer, CocoaPods, Hex, Bundler, pub, SwiftPM, Terraform, Poetry, PDM and Deno — and prints the command that clears each. It also finds the stores that belong to no package manager at all and are routinely the largest things in the list: the Playwright and Puppeteer browser bundles, the Cypress binary cache, the Electron and electron-builder download caches, and the HuggingFace hub — a whole browser or model per version, and nothing ever removes the old one. The report is read-only; `devp caches clear <manager>` runs that command for you, after asking. `devp config set cache_max_gb default=10` says how big is too big — for every manager at once, or per manager with `default=10,npm=4` — and marks the ones past it — `devp caches clear --over-cap all` then empties exactly those, still only when you type it. Each manager also says how many of your registered repositories use it and what that works out to per repository, and `devp caches clear --unused all` empties the ones nothing uses at all. pnpm is reported once per filesystem, because a store it hardlinks into `node_modules` cannot cross one and projects kept off the system disk get a store of their own. Nothing on a schedule ever touches a cache, and Maven's `~/.m2/repository` is never cleared at all — it holds artifacts `mvn install:install-file` put there that no remote can hand back |
|
|
605
619
|
| 🩺 **`devp doctor`** | One read-only pass that ends by naming the *single* reason a repository would or would not be pruned. Runs no package manager, repairs nothing, safe to run twice. `devp doctor --fix` then mends what it found — installed-but-broken only |
|
|
606
620
|
| 🤖 **Self-installing automation** | OS-native scheduler (Task Scheduler, LaunchAgent, systemd user timer) and non-blocking Git hooks, installed at install time and restored after an upgrade. `auto_setup`, `auto_hooks`, `auto_daemon` or `DEV_PRUNE_NO_AUTO_SETUP=1` turn it off |
|
|
607
621
|
| ⚡ **0ms opt-out** | An `ignore.devprune.json` in a repository root is honoured by file presence alone — no read, no parse. It applies at registration as well: a bulk scan (`devp init`, and the scheduled pass's own discovery) will not register a repository that holds it, so a repository can decline before it ever reaches `devp status`. `devp link <path>` still registers one, because naming a single repository is not a bulk scan |
|
|
@@ -624,11 +638,12 @@ process that leaves a dirty working tree is a surprise.
|
|
|
624
638
|
| `devp undo` | :------------------------------------------------------------------ | Reverts the most recent `init` or `link` |
|
|
625
639
|
| `devp run [PATH]` | `--dry-run`, `--only`, `--skip`, `--except`, `--min-size`, `--json` | Prunes every registered repository, or one target |
|
|
626
640
|
| `devp status` | `--top N`, `--drift`, `--json` | Interactive dashboard; a plain table when there is no TTY. `--top N` shows only the N biggest repositories; `--drift` lists every environment holding packages its lockfile never recorded |
|
|
627
|
-
| `devp stats` | `--json` | What has already been reclaimed: lifetime total from pruning, a separate lifetime total from `devp caches clear`, prune passes, the last pass,
|
|
641
|
+
| `devp stats` | `--json` | What has already been reclaimed: lifetime total from pruning, a separate lifetime total from `devp caches clear`, prune passes, the last pass, the biggest contributors, which package managers the space came from, and how many passes you typed rather than scheduled |
|
|
642
|
+
| `devp history` | `--pass N`, `--limit N`, `--all`, `--json`, `--export [PATH]` | Which pass deleted what, and what asked it to — one line per pass, then `--pass N` for the command line that ran it and every directory it removed. `--export` writes the lot to your documents folder |
|
|
628
643
|
| `devp completions` | `bash`, `zsh`, `fish`, `powershell`, `elvish` | Prints a shell completion script to stdout, generated from the same argument definitions the binary parses with |
|
|
629
644
|
| `devp caches` | `clear <manager\|all>`, `--json` | Sizes every package manager cache on the machine and prints the command that clears each. The report deletes nothing and nothing on a schedule ever will; `clear` empties one when you type it, after asking |
|
|
630
|
-
| `devp caches docker` | `podman`, `nerdctl`, `containers [ENGINE]`, `--json`
|
|
631
|
-
| `devp trust` | `--json` | What dev-prune may do on this machine: the guarantees the code enforces, then the scheduler, hooks and settings read live. Read-only
|
|
645
|
+
| `devp caches docker` | `podman`, `nerdctl`, `finch`, `container`, `containers [ENGINE]`, `--json` | What a container engine holds — images, containers, volumes, build cache — each sized, with what the engine calls reclaimable, then the prune commands. The report deletes nothing; `devp caches clear <engine>` runs the narrow ones when you name it, never a volume |
|
|
646
|
+
| `devp trust` | `--json` | What dev-prune may do on this machine: the guarantees the code enforces, then the scheduler, hooks and settings read live, then every copy of dev-prune on the machine with the manager that installed it and its SHA-256. Read-only |
|
|
632
647
|
| `devp restore [PATH]` | `--last-run` | Reinstalls dependencies for every project in a tree; `--last-run` undoes the last prune pass |
|
|
633
648
|
| `devp doctor [PATH]` | `--fix` | Diagnoses the installation, or one repository — ending with the single reason a pass would or would not touch it. `--fix` repairs what the checks found; it never performs a first-time install |
|
|
634
649
|
| `devp config [ACTION]` | `get`, `set`, `show`, `wizard`, `project`, `daemon`, `hook`, `icon` | Global settings, per-repository `.devprune.json`, scheduler, Git hooks, file manager icons |
|
|
@@ -663,6 +678,7 @@ Adapters detect the project, verify the lockfile, and own the bloat directories:
|
|
|
663
678
|
| **pnpm** | `pnpm-lock.yaml` | `node_modules` | `pnpm install --lockfile-only --frozen-lockfile` | `pnpm install --frozen-lockfile` |
|
|
664
679
|
| **Yarn** | `yarn.lock` | `node_modules` | `yarn install --immutable --mode update-lockfile` (Berry); on Classic an existing `yarn.lock` is itself the proof | `yarn install --immutable` |
|
|
665
680
|
| **Bun** | `bun.lockb`, `bun.lock` | `node_modules` | `bun install --frozen-lockfile --dry-run --ignore-scripts` | `bun install --frozen-lockfile` |
|
|
681
|
+
| **Deno** | `deno.lock` | `node_modules`, `vendor` *(when the config asked for one)* | `deno.lock` parses and carries its `version`, and is no older than the config it came from | `deno install` |
|
|
666
682
|
| **uv** (Python) | `uv.lock`, `[tool.uv]` in `pyproject.toml` | `.venv` | `uv lock --locked` | `uv sync` |
|
|
667
683
|
| **Poetry** (Python) | `poetry.lock`, `[tool.poetry]` in `pyproject.toml` | `.venv` | `poetry check --lock`, plus no installed package the lockfile never recorded | `poetry install` |
|
|
668
684
|
| **PDM** (Python) | `pdm.lock`, `[tool.pdm]` or `pdm.backend` in `pyproject.toml` | `.venv`, `__pypackages__` | `pdm lock --check` | `pdm install` |
|
|
@@ -701,10 +717,13 @@ it beside the adapter checklist, grouped by language, where one heading sets the
|
|
|
701
717
|
window for every adapter under it.
|
|
702
718
|
|
|
703
719
|
A download cache is a bet that re-downloading costs less than the disk it occupies,
|
|
704
|
-
and somewhere the bet stops paying. `devp config set cache_max_gb
|
|
720
|
+
and somewhere the bet stops paying. `devp config set cache_max_gb default=10` is
|
|
705
721
|
where you say where: a ceiling in gibibytes — GiB, the unit the report prints —
|
|
706
|
-
|
|
707
|
-
manager's whole footprint.
|
|
722
|
+
for every manager at once, measured against each
|
|
723
|
+
manager's whole footprint. `default=10,npm=4` gives one of them a figure of its own,
|
|
724
|
+
and a manager named outright is held to that rather than to both. The first run
|
|
725
|
+
suggests `default=10`, and any ceiling you have already set counts as the suggestion
|
|
726
|
+
taken — `devp config recommended` never overwrites a number you chose. A manager over its cap is **marked** in `devp caches` —
|
|
708
727
|
setting one deletes nothing — and `devp caches clear --over-cap all` empties exactly
|
|
709
728
|
what is marked, when you type it. It is keyed by the names `devp caches clear` takes
|
|
710
729
|
(`npm`, `pnpm`, `uv`, `pip`, `cargo`, `go`, `nuget`, …) rather than by adapter name,
|
|
@@ -841,7 +860,7 @@ rather than downloading. That is the whole reason each one is a switch.
|
|
|
841
860
|
|
|
842
861
|
| Key | Default | Meaning |
|
|
843
862
|
| :--- | :---: | :--- |
|
|
844
|
-
| `cache_max_gb` | *(none)* | Per-manager cache caps in GiB, as `
|
|
863
|
+
| `cache_max_gb` | *(none)* | Per-manager cache caps in GiB, as `default=10,npm=4` — `default` covers every manager not named separately, and the cap itself deletes nothing |
|
|
845
864
|
|
|
846
865
|
**Running without being asked** — what dev-prune may install here, and how often it may
|
|
847
866
|
act on its own.
|
package/bin/dev-prune
CHANGED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dev-prune-darwin-x64",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.17.0",
|
|
4
4
|
"description": "Prebuilt dev-prune binary for darwin x64. Installed automatically by the 'dev-prune' package; not meant to be depended on directly.",
|
|
5
5
|
"os": ["darwin"],
|
|
6
6
|
"cpu": ["x64"],
|