Scan a developer workspace for reclaimable artifacts, build files, virtualenvs, caches, and secret files.

Args: path: Root directory to scan (defaults to current directory). max_depth: Max directory traversal depth (default: 6). artifact_types: Optional list of specific types to filter: ['node_modules', 'python_venv', 'python_cache', 'build_artifact', 'temp_logs', 'env_secret']. min_size_mb: Minimum item size in Megabytes to report (default: 0.0).

Returns: Structured scan report with discovered items, sizes, categories, and secret warnings.

Audit workspace for security risks: untracked .env files, exposed API keys, and workspace hygiene.

Args: path: Root directory to audit.

Returns: Security audit report including health score (0-100), detected exposed .env files, and hygiene recommendations.

Dry-run simulation of workspace cleanup to inspect items and reclaimable space before executing.

Args: path: Root workspace path. target_paths: Optional list of explicit paths to clean. artifact_types: Optional list of artifact types to target. older_than_days: Only include artifacts inactive for at least N days.

Returns: Preview report with items that would be removed and total reclaimable bytes.

Clean reclaimable developer artifacts with safety checks and Recycle Bin quarantine.

IMPORTANT: dry_run is True by default for safety. You must explicitly set dry_run=False to perform deletion.

Args: path: Root directory of the workspace. target_paths: Explicit paths to clean. If omitted, cleans all non-secret artifacts matching criteria. artifact_types: Filter specific artifact types to clean. mode: Deletion mode ('trash' for OS Recycle Bin quarantine, 'permanent' for direct deletion). dry_run: If True, simulates cleanup without removing files. Default is True.

Returns: Clean report with status of removed items, freed space, and any errors.

Get high-level health overview and disk space metrics for a developer workspace.

Args: path: Workspace root directory.

Returns: Summary metrics (total reclaimable space, artifact count, secret alerts, category breakdown).

Retrieve historical workspace audit scans and cleanup activity logs.

Args: path: Optional workspace root directory to filter history. limit: Maximum number of records to return (default: 10).

Returns: Historical scan records and cleanup logs with totals and metrics.