Add LAN device discovery (ping sweep + ARP, known/unknown labeling)
CI / web (push) Successful in 17s
CI / api (push) Successful in 23s

Runs as a host-level systemd timer on CT122 (scripts/discover-devices.sh)
rather than inside the api container, since real ARP entries live in the
host's network namespace, not Docker's bridge network. See
docs/device-discovery.md for the full writeup, including why literal
passive-only ARP reading was dropped (near-empty result in practice).

API reads the resulting JSON file each poll cycle, cross-references
config/hosts.yaml's knownDevices list by IP, and serves /api/devices.
Dashboard gets a new "Network Devices" table.

Closes #9.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-12 20:49:22 -06:00
parent d75bd58792
commit 04282232cc
15 changed files with 434 additions and 8 deletions
+36
View File
@@ -0,0 +1,36 @@
import { readFile } from "node:fs/promises";
import type Database from "better-sqlite3";
import { upsertDevices, type DiscoveredDevice } from "../db/index.js";
interface RawEntry {
ip: string;
mac: string;
state: string;
}
// Reads the JSON file produced by scripts/discover-devices.sh (a systemd timer
// on the deploy host, not this process) and labels each entry against the
// known-device list from config/hosts.yaml. See docs/device-discovery.md.
export async function refreshDevices(
db: Database.Database,
filePath: string,
knownDevices: Map<string, string>
): Promise<void> {
let raw: RawEntry[];
try {
raw = JSON.parse(await readFile(filePath, "utf8"));
} catch (err) {
// Missing file (timer hasn't run yet, or not deployed on this host) isn't
// fatal — just means no device data this cycle.
if ((err as NodeJS.ErrnoException).code === "ENOENT") return;
throw err;
}
const devices: DiscoveredDevice[] = raw.map((entry) => ({
ip: entry.ip,
mac: entry.mac,
knownName: knownDevices.get(entry.ip) ?? null,
}));
upsertDevices(db, devices);
}