# DrivePulse (CLI prototype)

Instant space map, largest-file finder, and duplicate-size candidate hints
for a directory tree. Working prototype of the DrivePulse concept's space
and cleanup-hint engine — see `../plan.md` for the full product plan.

**Scope note:** real SMART/disk-health telemetry needs OS- and
hardware-specific access this cross-platform CLI build doesn't attempt.
This build covers the space-map, largest-file, and duplicate-candidate
parts of v1 only.

## Build from source

Requires Go 1.24+, no external dependencies.

```
go build -o drivepulse .
```

Cross-compile for another platform:

```
GOOS=windows GOARCH=amd64 go build -o drivepulse.exe .
GOOS=darwin  GOARCH=arm64 go build -o drivepulse .
```

## Usage

```
drivepulse scan <dir> [--depth N] [--top N] [--json]
```

Walks `<dir>` once and reports three things: a folder-level space map
grouped to `--depth` levels, the `--top` largest individual files, and
duplicate-*size* candidates (files that share an exact byte size — a cheap
first signal, not a content match). For a real content-verified duplicate
report, pipe the candidates into DupePilot.

## Prebuilt binaries

See `../downloads/` for prebuilt binaries (Windows/macOS/Linux, amd64 +
darwin/arm64) and `CHECKSUMS.txt` for their SHA-256 hashes. These are
unsigned indie builds — Windows SmartScreen and macOS Gatekeeper will warn
on first run, which is expected until a code-signing certificate is in
place (see the build plan's risk section).