---
roadcrew_template_name: "verify-install.md"
roadcrew_template_type: "command"
execution_mode: "auto-execute"
roadcrew_template_version: "v1.0"
roadcrew_last_updated: "2025-10-25"
roadcrew_min_version: "1.5.0"
roadcrew_license: "See LICENSE file in .roadcrew folder"
roadcrew_copyright: "Copyright (c) 2025 North Star Holdings, LLC"
spdx_license_identifier: "LicenseRef-RoadcrewLicense-1.0"
---

# /verify-install

Validate Roadcrew installation health with comprehensive diagnostics and remediation.

**Tier:** STARTER  
**Pattern:** PUBLISH (Distribution & Customer Support)  
**Related:** Epic #146, Issue #150

## What It Does

1. **Check Structure:** Verify required directories exist
2. **Verify Files:** Ensure key files are present
3. **Test Commands:** Run simple self-test
4. **Check Permissions:** Verify file permissions
5. **Validate Version:** Check version consistency
6. **Generate Report:** Create health report
7. **Suggest Fixes:** Provide remediation steps if issues found

## Usage

```bash
# Full health check
/verify-install

# Detailed report with verbose output
/verify-install --verbose

# Fix known issues automatically
/verify-install --fix

# Check specific component
/verify-install --check commands
/verify-install --check templates
/verify-install --check scripts
```

## Health Checks

**Structure Checks**
- ✅ .roadcrew/ directory exists
- ✅ commands/ subdirectory exists
- ✅ templates/ subdirectory exists
- ✅ scripts/ subdirectory exists
- ✅ dist/ subdirectory exists

**File Checks**
- ✅ install.js exists and readable
- ✅ package.json exists and valid JSON
- ✅ README.md exists
- ✅ LICENSE file exists
- ✅ setup.sh executable (if present)

**Functionality Checks**
- ✅ Node.js version ≥18 (from build-validator)
- ✅ npm installed and working
- ✅ git available for version control
- ✅ At least one command file found
- ✅ At least one template file found

**Permission Checks**
- ✅ .roadcrew/ readable by current user
- ✅ install.js executable
- ✅ setup.sh executable (if present)
- ✅ scripts/ readable

**Version Checks**
- ✅ package.json has version field
- ✅ Version matches semver format (v X.Y.Z)
- ✅ Version in install.js matches (if applicable)

## Report Format

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 ROADCREW INSTALLATION HEALTH REPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation Path: /path/to/.roadcrew
Version: v1.5.2
Status: ✅ HEALTHY

📋 STRUCTURE CHECKS
  ✅ .roadcrew/ exists
  ✅ commands/ found (X files)
  ✅ templates/ found (Y files)
  ✅ scripts/ found (Z files)

✅ FILE CHECKS
  ✅ install.js present
  ✅ package.json valid
  ✅ README.md present
  ✅ LICENSE present

⚙️  FUNCTIONALITY CHECKS
  ✅ Node.js v18.0.0 (required: ≥18)
  ✅ npm v9.0.0
  ✅ git v2.40.0
  ✅ 5 commands available
  ✅ 3 templates available

🔐 PERMISSION CHECKS
  ✅ .roadcrew/ readable
  ✅ install.js executable
  ✅ scripts/ readable

🏷️  VERSION CHECKS
  ✅ package.json version: v1.5.2
  ✅ Version format valid (semver)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ INSTALLATION HEALTHY - All systems operational
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

## Implementation Notes

**Uses Utilities:**
- `BuildValidator.validateAll()` - Run build health checks
- `BuildValidator.formatReport()` - Format diagnostic report
- `BuildValidator.getHealthStatus()` - Get quick health summary

**Key Functions:**
- `verifyStructure()` - Check directory structure
- `verifyFiles()` - Ensure required files exist
- `verifyFunctionality()` - Test commands work
- `verifyPermissions()` - Check file permissions
- `verifyVersion()` - Validate version info
- `generateReport()` - Create formatted report
- `suggestFixes()` - Recommend remediation steps

**Remediation Logic:**
- Missing directory: Suggest running install.js
- Missing files: Suggest reinstalling
- Permission issues: Suggest chmod commands
- Version mismatch: Suggest re-running install
- Node version too old: Suggest upgrading Node.js

## Success Criteria

- ✅ All structure checks pass
- ✅ All required files present
- ✅ Functionality verified
- ✅ Permissions correct
- ✅ Version consistent
- ✅ Report clear and actionable
- ✅ Remediation suggestions helpful
- ✅ Customers can self-diagnose issues
- ✅ All edge cases handled gracefully

## Related

- See Epic #146 for full PUBLISH pattern
- Depends on: BuildValidator from Issue #148
- Pairs with: /update-roadcrew-customer for post-update verification
- Used by: Customers for self-service diagnostics