rcpanel 0.3.2 - verification record
Date: 2026-11-09

Environment: Linux, Python 3.12.14, standard-library curses.
Command: python3 -m unittest discover -s tests -q
Result: 515 tests passed, 0 failures, 0 errors.

The test suite covers:

- Service argument boundaries, name membership, privileges, and OS checks.
- Separate startup and runtime state, unknown status, and command failures.
- Child-process timeout, output bounds, and literal argv without a shell.
- Streaming beyond capture limits, split UTF-8 sequences, and observer failure
  without abandoning the child; explicit execution without a timeout; caller
  capture bounds for full repository indexes.
- Shared executable trust, fixed PATH resolution, unsafe root path refusal,
  clean account environment, nested-editor quoting, and invalid deadline refusal.
- Pipe/selector setup failures before child launch, descriptor cleanup, and
  actual surviving background children after the immediate command exits.
- Service mutations without a panel kill timer, retained query limits, valid
  leading-underscore service names, and refusal of comment-truncated flags.
- Configuration conflicts, file identity, encoding, size, and permissions.
- Symlinks, hard links, FIFOs, altered directories, and unsafe destinations.
- Validation failure, validator mutation, rename failure, and sync failure.
- Approval bound to the displayed candidate, foreign/stale reviews, replacement
  inodes, validation-path substitution, changed candidates during backup work,
  actual FIFO substitution without a hang, and stage cleanup identity.
- Exact original backups, restore staging, and preserved file metadata.
- DNS configuration roots, cross-root locking, bounded browsing, unsafe prefix
  and traversal refusal, and backup identity across configuration trees.
- Strict HTTP and SMTP form parsing; 840 HTTP field combinations are exercised
  inside the HTTP roundtrip test, in addition to malformed-input cases.
- Menu selection, scrolling, resizing, text editing, and terminal escaping.
- Complete Editor preference help at 60, 80, and 120 columns; wrapped prompt
  help, paging through every word, preserved field editing while resizing,
  escaped-control expansion, and shrink between size check and redraw.
- Stable map paths, search and breadcrumbs, every handler destination, and
  endpoint navigation without implicit execution.
- Numeric navigation, literal numeric input, and remembered selection/scroll
  through Help and terminal-size changes.
- Startup notice, resize without acceptance, terminal restoration at suspend,
  resumption at the notice, and Ctrl+C exit without entering the map.
- Saved startup pages, favorites, bounded session history, and command presets
  that load choices without executing an action.
- Viewer wrapping, searches across soft wraps, next/previous matches on the
  final visible page, page overlap, and optional hints.
- Preference drafts, validation, save/reload/default recovery, effective-user
  state, atomic replacement, stale-write detection, strict JSON, file identity,
  symlinks, hard links, permissions, bounded reads, and reported sync failures.
- Named command validation, round trips, replacement/removal, malformed state,
  and concurrent edits without silently overwriting another session.
- Actual program discovery against temporary trees, scan bounds, manual output
  formatting, exact report membership, and privileged executable path checks.
- Reviewed native-program handoff, literal argv/cwd, clean environment,
  cancellation, terminal restoration, and demo execution refusal.
- Sysctl tree parsing, exact current names, runtime/persistence separation,
  failed changes, native normalization, refreshed values, and inventory notices.
- Native package argv, inventory/search parsing, installed/manual-tag snapshots,
  private locking, exact selected package names, and one-use plan validation.
- Failed, truncated, altered, forged, stale, foreign, or reused package plans
  cannot apply; cancellation and native failure do not trigger retries.
- Package UI preview/confirmation/application order, bounded progress, details,
  refreshed installed markers, and in-memory demo mutation without native tools.
- Downloaded available-name catalogs, release/stable and snapshot sources,
  exact repository filenames, complete bounded indexes, cache provenance,
  refresh failures, corrupt/stale catalogs, and atomic persistent caching.
- Repository changes invalidating live search, install, update, and update-all
  plans; deletion independence from repository availability.
- Hostile oversized HTML tags and legitimate large directory-index parsing.
- Local available-package filtering, sorting, installed-name exclusion, explicit
  refresh, and reopening a saved demo catalog without a repository query.
- Cancellation, whole-file replacement confirmation, and no implicit reload.
- Actual delivery of SIGINT, SIGHUP, and SIGTERM during bounded worker jobs.
- Deferred suspension during a worker job and normal foreground job control
  around editors and explicitly launched native programs.
- Editor failure/recovery, signal handling, and private staged-file handoff.
- Versioned installation, isolated interpreter startup, and unsafe reuse refusal.
- Sticky installation directories, untrusted live interpreters, directory-sync
  ordering before launcher replacement, and honest post-replacement failures.
- Parent-directory synchronization for the first saved settings file.
- CLI help, status, map filtering, program filtering, package output, settings
  output, mutually exclusive modes, demo isolation, and live-mode refusal on
  Linux.

Eight end-to-end tests use real pseudo-terminals. They exercise a full HTTP form
edit, review, installation, reopening the saved form, repeated SIGWINCH resize,
editor handoff, discard without changing the live demo file, and clean exit.
They also cover a package preview cancelled before a later approved install,
updated installed-state display, map-code navigation, kernel-name search,
explicit runtime change, and a fresh observed kernel snapshot.
The four added flows cover Ctrl+C at the startup notice, Ctrl+Z followed by
SIGCONT and an ordinary continuation key, saving and reopening preferences,
and explicitly downloading and filtering the demo available-package catalog.
The suspend flow checks that canonical terminal input and echo are restored
while stopped and that resumption does not dismiss the notice.
The installer test launches the installed program with a hostile PYTHONPATH
and working directory and confirms that its selected modules are used.

Additional checks:

- All delivered source and documentation are ASCII text.
- All Python source parses with Python 3.10 grammar.
- The mdoc manual renders with groff -Tascii -mdoc without diagnostics.
- Installed test launchers successfully print demo status with isolated imports.
- A separate process with a 128 MiB address-space limit rejected a 4,194,341-byte
  hostile HTML index with PanelError in approximately 0.002 seconds. Peak RSS
  was 20,824 KiB on this Linux host. These are local measurements, not portable
  performance guarantees.

Test-boundary note:

The workspace Python executable lives under a runtime directory owned by a
different UID. Runner unit fixtures simulate ordinary-account path policy for
harmless Python child processes; separate tests assert root path refusal.
The real terminal editor fixture uses the root-trusted platform interpreter.
Production executable checks were not relaxed for tests or demo mode.

See SECURITY-REVIEW.txt for findings, preconditions, fixes, and residual limits.

Native status:

Live OpenBSD service tools, native syntax validators, system reports, sysctl,
manuals, and package operations were NOT run in this Linux workspace. Command
interfaces were checked against official OpenBSD manuals; the initial target is
OpenBSD 7.8. Native syntax acceptance, daemon behavior, real package transactions,
actual system state, and packaged Python compatibility remain to be verified
on OpenBSD. docs/OPENBSD-CHECKLIST.txt records that work.

No host service, firewall, SSH configuration, or live /etc file was changed
by these tests. Demo validation is explicitly simulated and is never reported
as a passed native OpenBSD configuration check.
