🔍 rc-scan.sh

Script Path: bones/scripts/rc-scan.sh

Purpose

• Traverse the file tree to identify orphan files (not in manifest) and missing artifacts (in manifest but absent).
• Compute and record SHA256 checksums for all valid files.
• Produce machine-readable JSON and human-readable Markdown summaries.

CLI Interface

rc-scan.sh [--dry-run] [--verbose] [--help]

Supported flags: - --help, -h Show usage information and exit. - --dry-run Preview actions without writing reports. - --verbose Show detailed logs.

Workflow Steps

1. Parse Flags & Setup: Handle --dry-run, --verbose, and --help.
2. Verify Dependencies: check_deps find sha256sum yq.
3. Load Manifest: Read asset-manifest.yaml into manifest_list.
4. Scan Files: Walk home/assets/ (or specified dir) into disk_list.
5. Classification & Checksums: Identify missing, orphan files, compute SHA256.
6. Report Generation: Write JSON and Markdown reports or preview under dry-run.

Exit Codes

• 0 — Scan completed (even if orphans/missing found).
• 1 — Critical error (missing manifest, dependencies).
• 2 — No files found to scan.

Examples

# Standard scan
./bones/scripts/rc-scan.sh

# Preview scan without writing
./bones/scripts/rc-scan.sh --dry-run --verbose

# Show help
./bones/scripts/rc-scan.sh --help

🛣️ Navigation

• Scripts Index
• Scan Reference
• Bones Home