salva1973/raspi-guardian

No problems traced to this repository code in these checks.

OSV scanned supported lockfiles; unpinned dependencies and unsupported formats are outside this check.

A short run cannot establish that code is safe.

Connections show IP addresses; proxies can hide the final hostname.

Tracing covers dispatched commands and their children, not the whole OS; guest root can interfere with tracing.

Full safety evidence →

• The system command reports host diagnostics.: Real input produced the expected result: Host:

  Source: `system`, `disks` and `help` do not require a UPS destination.

  Input: system --no-color on the guest

  Expected: A system report with host, uptime, CPU, RAM and temperature fields.

  Command: /opt/raspi-guardian/bin/raspi-guardian system --no-color

  Observed: Host: sbx-1793114117-a4d3c5 │ Uptime: 3 min 7 s │ CPU load 1/5/15 min: 0.56 / 0.39 / 0.16 (2 cores) │ RAM used: 458 MiB / 3.8 GiB (12%) │ Temperature: n/a ╰─

Examples

• CLI only system diagnostics: command completed successfully

  Source: README.md, CLI-only / Install the global command

  Input: system --no-color

  Expected: System report

  Command: /opt/raspi-guardian/bin/raspi-guardian system --no-color

  Observed: ╭─ Raspi Guardian · System │ 🖥️ System │ Host: sbx-1793114117-a4d3c5 │ Uptime: 3 min 7 s │ CPU load 1/5/15 min: 0.56 / 0.39 / 0.16 (2 cores) │ RAM used: 466 MiB / 3.8 GiB (12%) │ Temperature: n/a ╰─

Local or hosted: local

Raspi Guardian system diagnostics

pwd; ls -la; sed -n '1,240p' README.md; python3 --version; id -u; rg --files -g '!*\.lock' | head -100
sed -n '240,520p' README.md; cat docs/linux-setup.md | head -180; ls -la bin src tests; cat guardian.env.example; cat .gitignore
sudo apt-get update && sudo apt-get -o DPkg::Lock::Timeout=300 install -y git curl ca-certificates xz-utils libstdc++6 nut-client util-linux nodejs; node --version; /usr/bin/node --version; command -v upsc; command -v findmnt
ls -l /usr/local/bin/node; /usr/local/bin/node --version; sed -n '1,180p' bin/raspi-guardian; sed -n '1,220p' src/cli.mjs
GUARDIAN_IMPORTANT_MOUNTS=/ GUARDIAN_DOCKER_ENABLED=false TERM=dumb /opt/raspi-guardian/bin/raspi-guardian system --no-color
install -d /opt/raspi-guardian/src /opt/raspi-guardian/bin /opt/raspi-guardian/docs; install -m 0644 src/*.mjs /opt/raspi-guardian/src/; install -m 0755 bin/raspi-guardian /opt/raspi-guardian/bin/; install -m 0644 docs/*.md /opt/raspi-guardian/docs/; install -m 0644 README.md LICENSE guardian.env.example /opt/raspi-guardian/; GUARDIAN_IMPORTANT_MOUNTS=/ GUARDIAN_DOCKER_ENABLED=false TERM=dumb /opt/raspi-guardian/bin/raspi-guardian system --no-color
sudo install -d -o root -g root -m 0755 /opt/raspi-guardian /opt/raspi-guardian/src /opt/raspi-guardian/bin /opt/raspi-guardian/docs; sudo install -o root -g root -m 0644 src/*.mjs /opt/raspi-guardian/src/; sudo install -o root -g root -m 0755 bin/raspi-guardian /opt/raspi-guardian/bin/; sudo install -o root -g root -m 0644 docs/*.md /opt/raspi-guardian/docs/; sudo install -o root -g root -m 0644 README.md LICENSE guardian.env.example /opt/raspi-guardian/; GUARDIAN_IMPORTANT_MOUNTS=/ GUARDIAN_DOCKER_ENABLED=false TERM=dumb /opt/raspi-guardian/bin/raspi-guardian system --no-color
find .coldpass -maxdepth 1 -type f -printf '%f\n'; sed -n '1,120p' <guest-path>
mkdir -p .coldpass; cat > .coldpass/probe.json <<'EOF'
{"kind":"cli","argv":["/opt/raspi-guardian/bin/raspi-guardian","system","--no-color"],"cwd":"<guest-path>","env":{"PATH":"/usr/local/bin:/usr/bin:/bin","GUARDIAN_IMPORTANT_MOUNTS":"/","GUARDIAN_DOCKER_ENABLED":"false","TERM":"dumb"},"expected_text":"Raspi Guardian · System"}
EOF
cat > .coldpass/claims.json <<'EOF'
[{"kind":"claim","claim":"The system command reports host diagnostics.","source":"`system`, `disks` and `help` do not require a UPS destination.","input":"system --no-color on the guest","expected":"A system report with host, uptime, CPU, RAM and temperature fields.","probe_kind":"cli","argv":["/opt/raspi-guardian/bin/raspi-guardian","system","--no-color"],"cwd":"<guest-path>","env":{"PATH":"/usr/local/bin:/usr/bin:/bin","GUARDIAN_IMPORTANT_MOUNTS":"/","GUARDIAN_DOCKER_ENABLED":"false","TERM":"dumb"},"expected_text":"Host:"}]
EOF
cat > .coldpass/examples.json <<'EOF'
[{"kind":"example","claim":"CLI only system diagnostics","source":"README.md, CLI-only / Install the global command","input":"system --no-color","expected":"System report","argv":["/opt/raspi-guardian/bin/raspi-guardian","system","--no-color"],"cwd":"<guest-path>","env":{"PATH":"/usr/local/bin:/usr/bin:/bin","GUARDIAN_IMPORTANT_MOUNTS":"/","GUARDIAN_DOCKER_ENABLED":"false","TERM":"dumb"},"expected_text":"Raspi Guardian · System"}]
EOF
cat > .coldpass/cycles.json <<'EOF'
{"detected":false,"reason":"README says each CLI invocation produces one report and exits; no scheduler or recurring CLI cycle exists. Telegram polling requires external credentials and is outside this diagnostic run.","checks":[]}
EOF
cat > .coldpass/report.json <<'EOF'
{"outcome":"working","fault_owner":null,"operation":"Raspi Guardian system diagnostics","operation_scope":"Documented CLI system report on Linux guest; Node 22, NUT client and util-linux installed; app installed under /opt/raspi-guardian.","steps":["Installed README prerequisite packages.","Installed the supplied app files under /opt/raspi-guardian.","Ran /opt/raspi-guardian/bin/raspi-guardian system --no-color with Node 22 on PATH."],"deviations":["The guest's /usr/bin/node is v18; used the preinstalled /usr/local/bin/node v22.23.4 according to the README compatibility requirement."],"stuck_step":null,"main_blocker":null,"plain_failure":null,"suggested_fix":null}
EOF
<env-var>=<guest-path> python3 -I <guest-path> --validate --replay