@teambit/harmony.content.cli-reference 2.0.1064 → 2.0.1066

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.
@@ -1,4 +1,4 @@
1
1
  ---
2
- description: 'Bit command synopses. Bit version: 1.13.203'
2
+ description: 'Bit command synopses. Bit version: 1.13.205'
3
3
  labels: ['cli', 'mdx', 'docs']
4
4
  ---
@@ -899,6 +899,11 @@
899
899
  "j",
900
900
  "json",
901
901
  "json format"
902
+ ],
903
+ [
904
+ "",
905
+ "with-stats",
906
+ "include total cache size, orphan count, and stale aspect-version count (walks the full cache)"
902
907
  ]
903
908
  ],
904
909
  "description": "list the capsules generated for this workspace",
@@ -980,6 +985,51 @@
980
985
  "extendedDescription": "with no args, only workspace's capsules are deleted",
981
986
  "group": "advanced",
982
987
  "private": false
988
+ },
989
+ {
990
+ "name": "prune",
991
+ "alias": "",
992
+ "options": [
993
+ [
994
+ "",
995
+ "older-than <days>",
996
+ "age threshold in days for aspect-version/scope capsule pruning (default 30)"
997
+ ],
998
+ [
999
+ "",
1000
+ "keep-workspace-caps",
1001
+ "skip workspace capsule deletion"
1002
+ ],
1003
+ [
1004
+ "",
1005
+ "no-orphans",
1006
+ "don't delete capsules whose origin path no longer exists"
1007
+ ],
1008
+ [
1009
+ "",
1010
+ "size-target <gb>",
1011
+ "after standard pruning, LRU-evict aspect-versions until total drops below this size (forces --with-sizes)"
1012
+ ],
1013
+ [
1014
+ "",
1015
+ "dry-run",
1016
+ "preview what would be removed without deleting"
1017
+ ],
1018
+ [
1019
+ "",
1020
+ "with-sizes",
1021
+ "compute byte sizes for the report (walks the full cache; slow on large caches). default: off — sizes shown as 0 but the prune itself is instant."
1022
+ ],
1023
+ [
1024
+ "j",
1025
+ "json",
1026
+ "json format"
1027
+ ]
1028
+ ],
1029
+ "description": "evict stale capsules from the global cache",
1030
+ "extendedDescription": "workspace capsules are deleted unconditionally; aspect-version and scope capsules are deleted when their last-used marker is older than --older-than (default 30 days).\nuse --dry-run first to preview what would be removed.",
1031
+ "group": "advanced",
1032
+ "private": false
983
1033
  }
984
1034
  ]
985
1035
  },
package/cli-reference.mdx CHANGED
@@ -265,9 +265,10 @@ ensures components work independently before publishing, similar to how they'll
265
265
 
266
266
  **Description**: list the capsules generated for this workspace
267
267
 
268
- | **Option** | **Option alias** | **Description** |
269
- | ---------- | :--------------: | --------------- |
270
- | `--json` | `-j` | json format |
268
+ | **Option** | **Option alias** | **Description** |
269
+ | -------------- | :--------------: | --------------------------------------------------------------------------------------------- |
270
+ | `--json` | `-j` | json format |
271
+ | `--with-stats` | | include total cache size, orphan count, and stale aspect-version count (walks the full cache) |
271
272
 
272
273
  ### capsule create
273
274
 
@@ -299,6 +300,24 @@ with no args, only workspace's capsules are deleted
299
300
  | `--scope-aspects` | | delete scope-aspects capsules |
300
301
  | `--all` | `-a` | delete all capsules for all workspaces and scopes |
301
302
 
303
+ ### capsule prune
304
+
305
+ **Usage**: `capsule prune`
306
+
307
+ **Description**: evict stale capsules from the global cache
308
+ workspace capsules are deleted unconditionally; aspect-version and scope capsules are deleted when their last-used marker is older than --older-than (default 30 days).
309
+ use --dry-run first to preview what would be removed.
310
+
311
+ | **Option** | **Option alias** | **Description** |
312
+ | ----------------------- | :--------------: | ------------------------------------------------------------------------------------------------------------------------------------------------ |
313
+ | `--older-than <days>` | | age threshold in days for aspect-version/scope capsule pruning (default 30) |
314
+ | `--keep-workspace-caps` | | skip workspace capsule deletion |
315
+ | `--no-orphans` | | don't delete capsules whose origin path no longer exists |
316
+ | `--size-target <gb>` | | after standard pruning, LRU-evict aspect-versions until total drops below this size (forces --with-sizes) |
317
+ | `--dry-run` | | preview what would be removed without deleting |
318
+ | `--with-sizes` | | compute byte sizes for the report (walks the full cache; slow on large caches). default: off — sizes shown as 0 but the prune itself is instant. |
319
+ | `--json` | `-j` | json format |
320
+
302
321
  | **Option** | **Option alias** | **Description** |
303
322
  | ---------- | :--------------: | --------------- |
304
323
  | `--json` | `-j` | json format |
@@ -1,4 +1,4 @@
1
1
  ---
2
- description: 'Bit command synopses. Bit version: 1.13.203'
2
+ description: 'Bit command synopses. Bit version: 1.13.205'
3
3
  labels: ['cli', 'mdx', 'docs']
4
4
  ---
@@ -899,6 +899,11 @@
899
899
  "j",
900
900
  "json",
901
901
  "json format"
902
+ ],
903
+ [
904
+ "",
905
+ "with-stats",
906
+ "include total cache size, orphan count, and stale aspect-version count (walks the full cache)"
902
907
  ]
903
908
  ],
904
909
  "description": "list the capsules generated for this workspace",
@@ -980,6 +985,51 @@
980
985
  "extendedDescription": "with no args, only workspace's capsules are deleted",
981
986
  "group": "advanced",
982
987
  "private": false
988
+ },
989
+ {
990
+ "name": "prune",
991
+ "alias": "",
992
+ "options": [
993
+ [
994
+ "",
995
+ "older-than <days>",
996
+ "age threshold in days for aspect-version/scope capsule pruning (default 30)"
997
+ ],
998
+ [
999
+ "",
1000
+ "keep-workspace-caps",
1001
+ "skip workspace capsule deletion"
1002
+ ],
1003
+ [
1004
+ "",
1005
+ "no-orphans",
1006
+ "don't delete capsules whose origin path no longer exists"
1007
+ ],
1008
+ [
1009
+ "",
1010
+ "size-target <gb>",
1011
+ "after standard pruning, LRU-evict aspect-versions until total drops below this size (forces --with-sizes)"
1012
+ ],
1013
+ [
1014
+ "",
1015
+ "dry-run",
1016
+ "preview what would be removed without deleting"
1017
+ ],
1018
+ [
1019
+ "",
1020
+ "with-sizes",
1021
+ "compute byte sizes for the report (walks the full cache; slow on large caches). default: off — sizes shown as 0 but the prune itself is instant."
1022
+ ],
1023
+ [
1024
+ "j",
1025
+ "json",
1026
+ "json format"
1027
+ ]
1028
+ ],
1029
+ "description": "evict stale capsules from the global cache",
1030
+ "extendedDescription": "workspace capsules are deleted unconditionally; aspect-version and scope capsules are deleted when their last-used marker is older than --older-than (default 30 days).\nuse --dry-run first to preview what would be removed.",
1031
+ "group": "advanced",
1032
+ "private": false
983
1033
  }
984
1034
  ]
985
1035
  },