Recon Extension

Read this before any infrastructure ops / fleet check work.

What Recon Does

Recon provides inventory knowledge, command templates, and learned patterns for quick fleet reconnaissance tasks -- the ad-hoc checks run from a management server against Dell servers via iDRAC, SSH, or SNMP.

Key Files

Rules

1. Always read `config/inventory-schema.json` first to know which CSV columns map to what fields.
2. Use `grep -w` (whole-word match) when looking up hostnames in the CSV. Never bare grep.
3. Label output with echo "=== $hostname ===" or similar -- unlabeled output is useless for batch checks.
4. Quote variables in loops: "$i" not $i.
5. Use host files (hosts.rN) when they exist rather than filtering the full CSV.
6. SSH to iDRAC: use -o StrictHostKeyChecking=no -o ConnectTimeout=5 to avoid hangs on unreachable hosts.
7. Prefer one-liners for quick checks. Only generate scripts for multi-step or reusable tasks.
8. Save useful generated scripts to scripts/ with a descriptive filename for reuse.

Common Patterns

Basic fleet loop

for h in $(cat hosts.r10); do
  ip=$(grep -w "$h" ~/sourceoftruth.csv | awk -F, '{print $11}')
  echo "=== $h ($ip) ==="
  # command here
done

iDRAC SSH check

sshpass -f ~/.idrac_pass ssh -o StrictHostKeyChecking=no -o ConnectTimeout=5 root@"$ip" racadm <command>

Parallel execution (when speed matters)

cat hosts.r10 | xargs -P 10 -I{} bash -c '
  ip=$(grep -w "{}" ~/sourceoftruth.csv | awk -F, '\''{print $11}'\'')
  echo "=== {} ($ip) ==="
  ssh -o ConnectTimeout=5 root@"$ip" racadm getsysinfo 2>/dev/null | grep -i "bios"
'

After Solving New Issues

When you discover a new gotcha or useful command:

1. Capture it as a skill: plugins/recon/skills/<slug>/SKILL.md
2. If it's a reusable command, also add it to the relevant template file
3. If broadly applicable beyond recon, copy to ~/.foundry/skills/<slug>/SKILL.md