logicroot 0.2.0__tar.gz

logicroot-0.2.0/.gitignore

@@ -0,0 +1,41 @@
+# Byte-compiled / optimized
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+.eggs/
+pip-wheel-metadata/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test and type-check caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# Tooling
+.tox/
+.nox/
+.hypothesis/
+
+# Editors and OS noise
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db
+
+# Local LOGICROOT state (should never be committed)
+logicroot.log
+*.local.toml

logicroot-0.2.0/CHANGELOG.md

@@ -0,0 +1,212 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project uses
+semantic versioning once it leaves alpha.
+
+## [Unreleased]
+
+Nothing yet.
+
+## [0.2.0] — Milestones 3–14
+
+The full command center: live monitoring, process/service/storage/network
+management, GPU telemetry, logs, diagnostics, cleanup, the interactive
+dashboard, and the opt-in assistant. Still alpha — the schema will change.
+
+### Added
+
+**Milestone 3 — live system monitoring (`logicroot status`, `logicroot.system`)**
+
+- Native `/proc` + `/sys` + `statvfs` sampling with no third-party dependency:
+  CPU utilisation via two-sample jiffy deltas (never 0% on the first tick),
+  memory/swap from `meminfo`, per-mount capacity, thermal zones plus hwmon
+  sensors, battery state, per-interface counters, load averages.
+- Windows sampler (one CIM query) and macOS sampler (`sysctl`/`vm_stat`/`df`
+ /`pmset`); unsupported hosts yield empty snapshots, not exceptions.
+- Background `MetricMonitor` with bounded history feeding the dashboard
+  sparklines.
+
+**Milestone 4 — process manager (`logicroot processes`, `logicroot.processes`)**
+
+- `/proc/[pid]` reader handling parenthesised names, kernel threads, UID
+  resolution, and RSS fallbacks; top-style CPU% from wall-clock deltas.
+- List/search/sort/inspect/tree views; `terminate` (SIGTERM + exit wait) and
+  `kill` (SIGKILL) gated by confirmation, refusing PID 1 and LOGICROOT itself.
+- Windows (CIM, command lines on inspect only) and macOS (`ps`) readers
+  producing the same normalized rows.
+
+**Milestone 5 — service manager (`logicroot services`, `logicroot.services`)**
+
+- `systemd` provider over `systemctl` only (list-units, show, is-enabled,
+  start/stop/restart), mapping privilege refusals to exit 3 without
+  escalating; Windows SCM provider (CIM + `sc.exe`); macOS launchd listing
+  with control honestly unsupported.
+
+**Milestone 6 — storage analysis (`logicroot storage`, `logicroot.storage`)**
+
+- Bounded tree scanner (single filesystem by default, no symlink following,
+  cancellable, error-tolerant) with bottom-up directory aggregates.
+- Largest-file ranking, three-phase duplicate detection (size → prefix hash
+  → full SHA-256), and a platform cache inventory.
+
+**Milestone 7 — network operations (`logicroot network`, `logicroot.network`)**
+
+- Live interfaces (ioctl addresses, `/proc/net/if_inet6`, gateway, DNS),
+  `/proc/net` socket parsing with inode→process resolution, throughput
+  measurement, and validated `ping` across all three platforms.
+
+**Milestone 8 — providers (`logicroot.providers`, `logicroot gpu`)**
+
+- NVIDIA (`nvidia-smi` CSV, UUID process attribution), AMD (`rocm-smi`
+  JSON, schema-tolerant), Intel (`intel_gpu_top` single sample) telemetry
+  paired with detected GPUs; per-manager package-cache measurement
+  (dnf/dnf5/apt/pacman/zypper).
+
+**Milestone 9 — logs (`logicroot logs`, `logicroot.logs`)**
+
+- `journalctl --output=json` reader with unit/priority/since/until/boot
+  filters, error shortcut, and boot history; unavailable off Linux with a
+  reason.
+
+**Milestone 10 — diagnostics (`logicroot diagnose`, `logicroot.diagnostics`)**
+
+- Eleven pure rules over one gathered bundle (CPU, memory, disk, read-only,
+  thermals, battery, network errors, GPU, failed services, boot, metric
+  availability) with worst-first findings, suggestions, passed/skipped lists,
+  and user `[thresholds]` honoured; `systemd-analyze` boot parsing.
+
+**Milestone 11 — cleanup (`logicroot cleanup`, `logicroot.cleanup`)**
+
+- Read-only planning from cache/package/journal informants with
+  safe/review/system risk labels; confirmed execution clears only planned
+  user-owned locations (symlinks unlinked, never followed) and prints exact
+  privileged commands for the rest.
+
+**Milestone 12 — dashboard (`logicroot` on a terminal, `logicroot.ui`)**
+
+- Textual app with sidebar navigation and nine screens (dashboard, processes,
+  services, storage, network, GPU, logs, diagnose, cleanup), per-screen
+  refresh cadences, worker-thread loading, confirmation modals, and
+  capability-aware degradation. Optional `tui` extra; bare `logicroot` falls back
+  to the text summary on pipes and minimal installs.
+
+**Milestone 13 — assistant (`logicroot ask`, `logicroot.assistant`)**
+
+- Offline rule-based answers from LOGICROOT data by default; network provider
+  (OpenAI-compatible, stdlib HTTP, no new dependency) only with
+  `privacy.allow_ai = true` + `LOGICROOT_AI_API_KEY` + `--ai`. Text-only replies,
+  scrubbed contexts, no file contents or command lines sent.
+
+### Fixed
+
+- `SubprocessCommandRunner` rejected absolute binary paths (breaking `ping`,
+  `/bin/ps`, and any caller passing a resolved path); explicit paths that
+  point at real files now execute.
+- Windows network speeds showed `9223372036854 Mb/s` from the disconnected-
+  adapter sentinel; terabit-plus values now read as unknown.
+- Windows DNS list included interface addresses from a config-map key
+  collision; servers and addresses are collected separately.
+- Storage scanner skipped every subdirectory on Windows (`st_dev` 0 vs real
+  volume id); a zero device now means "unknown", never "different".
+- Duplicate cache entries (`TEMP` vs `Local Temp`) are collapsed in both the
+  analyzer and the cleanup planner.
+
+[Unreleased]: https://github.com/madhav-manchanda/linx/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/madhav-manchanda/linx/releases/tag/v0.2.0
+[0.1.0]: https://github.com/madhav-manchanda/linx/releases/tag/v0.1.0
+
+## [0.1.0] — Milestones 1–2
+
+The first runnable build: LOGICROOT can detect a Linux machine, decide what that
+machine is capable of, and say so in the terminal or as JSON.
+
+### Added
+
+**Foundation**
+
+- `pyproject.toml` with a `logicroot` console script, Ruff and strict mypy, and a
+  `dev` extra.
+- Typed error hierarchy carrying user-facing hints and exit codes.
+- Exit-code contract: `0` success, `1` error, `2` usage, `3` permission,
+  `4` unsupported, `5` incomplete profile.
+- Bounded, argv-only subprocess execution (`shell=False`, per-command timeouts)
+  behind an injectable runner interface.
+- Tolerant filesystem readers for the many shapes Linux uses — one-line values,
+  `KEY=value` uevents, whitespace-padded integers, `0x`-prefixed sizes.
+- `tomllib` configuration with strict and lenient modes, XDG paths on every
+  platform, and atomic writes that never clobber an existing file.
+- Normalized, versioned serialization (`schema_version` on every profile).
+
+**Hardware discovery** — one module per subsystem, all failure-isolated:
+
+OS and kernel (including WSL and container detection), CPU topology, memory and
+NUMA, thermal zones, PCI devices with driver binding and `pci.ids` vendor
+lookup, USB devices, GPUs (NVIDIA/AMD/Intel, with VRAM and driver provenance),
+DRM display connectors and headless detection, block devices with rotational
+and SSD heuristics, network interfaces with addresses, routes, nameservers and
+Wi-Fi, batteries, Bluetooth, optional-tool inventory, systemd, container
+runtimes, and package-manager detection for dnf5, apt, pacman and zypper.
+
+- Single discovery timestamp shared by `discovered_at`, `uptime_seconds` and
+  `boot_time`, derived from `/proc/uptime`.
+- `DiscoveryContext` as the single injection point for roots and the command
+  runner.
+- Profile cache keyed by boot ID and schema version, with a TTL.
+
+**Capabilities**
+
+- 38 capabilities derived from the discovered profile.
+- Every disabled capability carries an actionable reason; a test asserts that
+  no capability is left undecided and none is blank.
+
+**CLI and UI**
+
+- `logicroot`, `logicroot hardware`, `logicroot capabilities`, `logicroot config`, each with
+  `--json`.
+- Global `--no-cache`, `--config`, `--verbose`, `--debug`, `--version`.
+- Rich panels for the hardware profile, capability table, startup summary and
+  unsupported-platform notice, bounded to 40–120 columns and degrading to plain
+  text when piped.
+- Unsupported hosts get exit `4` and, with `--json`, a machine-readable
+  `error` object.
+
+**Tests** — 412 tests, no hardware required
+
+- Seven mocked machines (A–G) covering workstation, laptop, server, container,
+  proprietary-NVIDIA box, foreign kernel and a locked-down host.
+- Parser tests written against byte-accurate real output, plus profile, cache,
+  serialization, capability, panel and CLI suites.
+- The suite passes on Windows and Linux; host-dependent behaviour is patched
+  rather than assumed.
+
+### Fixed
+
+Bugs found while building the test scenarios, all of which would have shipped:
+
+- `iw dev <if> link` output is tab-indented, so the `SSID:` pattern never
+  matched and no wireless network was ever named.
+- `ip -j address show` entries without a `family` key were silently dropped;
+  IPv6 and IPv4 addresses both come from that key.
+- `lspci -Dmm` prints the **vendor** before the **device**; the parser had them
+  reversed, so every PCI and GPU name was wrong.
+- `lsusb` accepts both `Device` and `Dev`; only the first was parsed.
+- USB Bluetooth class `e0/01` could never match, so Bluetooth adapters were
+  reported as absent on any Realtek or Mediatek dongle.
+- `/proc/net/fib_trie` leaf addresses carry trailing flags
+  (`192.168.1.42/32 host LOCAL`), so no address was ever extracted; the default
+  route `0.0.0.0` was not excluded.
+- A PCI device with a `driver` link pointing at a missing directory reported no
+  driver at all.
+- `columns_of()` divided by zero on any console narrower than the requested
+  column width, crashing the hint layout on small terminals.
+- `PLATFORM_SUDO` and `NETWORK_METRICS` were declared capabilities but never
+  registered, so they vanished from `logicroot capabilities` entirely.
+- XDG directory resolution was memoized, so tests could not redirect it, and
+  the POSIX fallbacks were reported as unreachable when type-checking on
+  Windows.
+- A broken `config.toml` was fatal in normal operation; it now warns and falls
+  back to defaults, and stays fatal only under `--debug`.
+
+[Unreleased]: https://github.com/madhav-manchanda/linx/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/madhav-manchanda/linx/releases/tag/v0.1.0

logicroot-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Madhav Manchanda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.