ecosystem-status
Show a read-only dashboard of stashes grouped by the tool that produced them, including an estimate of potentially reclaimable storage.
Usage
fcheap ecosystem-status [--json]The command has no command-specific flags. It honors the global flags.
What it reports
For each tool value, the table shows:
| Field | Meaning |
|---|---|
COUNT | Number of stashes from the tool |
STORED | Estimated bytes currently occupied by content, accounting for compressed archives |
OLDEST | Age in whole days of the oldest stash |
EXPIRED | Stashes whose TTL has elapsed |
ORPHANED | Stashes whose recorded source path no longer exists |
EVIDENCE | Cairntrace or Glyphrun run evidence whose source path no longer exists |
Stashes without a tool are grouped under -. Unlike the default list command, the dashboard includes expired stashes so its totals describe the whole local vault.
The summary distinguishes:
- logical size: the original uncompressed payload sizes recorded by manifests;
- stored content estimate: current payload bytes after compression;
- recommended cleanup savings: the size of candidates identified by the smart cleanup analysis with a 30-day stale threshold;
- retained run evidence: run evidence whose source is gone, shown only when present and excluded from the savings estimate.
Two kinds of stash are never counted as reclaimable. A stash tagged keep is pinned, whatever else is true of it. A Cairntrace or Glyphrun run directory is pruned by its own retention after it has been saved, so a missing source is the normal state of run evidence and the stash is usually the last copy; it is reported as EVIDENCE rather than ORPHANED.
Safety
ecosystem-status never compresses or deletes a stash. The cleanup value is an estimate, not authorization to remove everything it counts.
Review candidates with:
fcheap cleanup --smart
fcheap sweepBoth are also previews by default. Apply deletion only after reviewing the plan and confirming that unique evidence is not being treated as a regenerable cache.
Example
Ecosystem Status
TOOL COUNT STORED OLDEST EXPIRED ORPHANED EVIDENCE
cairntrace 5 600 MB 30d 0 0 4
codemap 8 42 MB 18d 3 1 0
vidtrace 3 1.2 GB 41d 0 0 0
- 2 16 KB 2d 0 0 0
Total: 18 stashes, 2.4 GB logical
Stored content estimate: 1.8 GB
Recommended cleanup savings: 42 MB
Retained run evidence: 4 stashes, 580 MB (last copy, not reclaimable)Values depend on the current vault; this example illustrates the fields rather than an exact formatting contract.
JSON output
Use JSON for automation:
fcheap ecosystem-status --jsonThe top level contains tools and overall. Per-tool values include count, logical_size, stored_size, oldest_age_seconds, expired, orphaned, and evidence. The overall object includes total_stashes, logical and stored sizes, human-readable usage strings, reclaimable_size, evidence_count, evidence_size, evidence_usage, and the underlying cleanup_result, whose by_category map uses the evidence category for retained run evidence.
total_size remains as a deprecated alias for logical_size; new integrations should use the explicit field names.