Skip to content

Add scheduled workspace hygiene reports #146

@chubes4

Description

@chubes4

Problem

Workspace bloat is invisible until macOS complains or a command times out. DMC should proactively surface workspace health because it owns the runtime/workspace bridge.

Proposed solution

Add a scheduled workspace hygiene report, likely as a Data Machine system task registered by DMC.

The task should summarize:

  • Total workspace size.
  • Free disk space.
  • Worktree count.
  • Top repos by worktree size.
  • Biggest cleanup candidates.
  • Dirty/unpushed protected worktrees.
  • Missing metadata / external worktree skips.
  • Suggested cleanup command.

Delivery options

  • CLI command for on-demand report.
  • Recurring Data Machine system task for daily/weekly checks.
  • Optional agent memory/log entry or Discord notification depending on site configuration.

Acceptance criteria

  • There is an on-demand command that prints the hygiene report.
  • There is a scheduled task hook/handler that can run the same report.
  • The report does not require destructive actions.
  • The report has JSON output for automation.
  • The report highlights emergency thresholds, e.g. free disk below 20 GiB.

Example summary

Workspace hygiene report
- Free disk: 12.4 GiB (warning)
- Workspace size: 512.7 GiB
- Worktrees: 423
- Top repo: homeboy, 188 worktrees, 481.2 GiB
- Cleanup candidates: 91 clean merged/closed worktrees, estimated 274.3 GiB
- Protected: 12 dirty, 4 unpushed, 3 active symlink targets

Suggested next command:
wp datamachine-code workspace worktree cleanup --dry-run --sort=size

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions