# Fenris Makefile # Spec: §10.1-10.6 SHELL := /bin/bash PYTHON := python3 VENV_DIR := /opt/fenris BIN_DIR := /usr/local/bin LIBEXEC_DIR := /usr/libexec/fenris UNIT_DIR := /etc/systemd/system POLKIT_DIR := /usr/share/polkit-1/actions CONF_DIR := /etc/fenris DATA_DIR := /var/lib/fenris # Placement manifest MANIFEST := $(DATA_DIR)/manifest.txt # Legacy history path (IN-4) LEGACY_HISTORY := ./data/history.jsonl .PHONY: help install upgrade uninstall purge update-deps test lint check-python check-smartctl import-legacy stage package-deb package-rpm package release clean help: @echo "Fenris NVMe endurance monitor" @echo "" @echo "Targets:" @echo " install - Install Fenris (builds wheel, installs to /opt/fenris)" @echo " upgrade - Upgrade Fenris (reinstall wheel, sync units)" @echo " uninstall - Uninstall Fenris (preserves config and store)" @echo " purge - Remove everything including config and store" @echo " test - Run tests" @echo " lint - Run linter" @echo " update-deps - Update dependency pins" @echo " stage - Stage packaging tree for nfpm" @echo " package - Build deb + rpm packages" @echo " package-deb - Build deb package only" @echo " package-rpm - Build rpm package only" @echo " release - Full release (build, sign, attach)" @echo " clean - Remove build artifacts" # ─── Pre-install gates ────────────────────────────────────────────────────── check-python: @echo "=== Verifying Python ≥ 3.9 ===" @$(PYTHON) -c "import sys; v=sys.version_info; exit(0 if (v>=(3,9)) else 1)" || { echo "Error: Python 3.9+ required (found $$($(PYTHON) --version 2>&1))"; exit 1; } check-smartctl: @echo "=== Verifying smartctl ===" @smartctl --version 2>/dev/null | head -1 || { echo "Error: smartctl not found (install smartmontools)"; exit 1; } # ─── Build ────────────────────────────────────────────────────────────────── dist/fenris-*.whl: pyproject.toml src/fenris/*.py @mkdir -p dist $(PYTHON) -m build --wheel -o dist # ─── Install ──────────────────────────────────────────────────────────────── install: check-python check-smartctl dist/fenris-*.whl @echo "=== Creating directories ===" @sudo mkdir -p $(LIBEXEC_DIR) @sudo mkdir -p $(CONF_DIR) @sudo mkdir -p $(POLKIT_DIR) @echo "=== Creating data directory (root-written, group-read) ===" @sudo groupadd -f fenris @sudo install -d -o root -g fenris -m 2750 $(DATA_DIR) @echo "=== Installing venv with pinned dependencies ===" @sudo rm -rf $(VENV_DIR) @sudo $(PYTHON) -m venv $(VENV_DIR) @sudo $(VENV_DIR)/bin/pip install --upgrade pip --quiet @sudo $(VENV_DIR)/bin/pip install dist/fenris-*.whl --quiet @echo "=== Installing wrapper ===" @sudo install -m 0755 scripts/fenris $(BIN_DIR)/fenris @echo "=== Installing helpers ===" @sudo install -m 0755 src/fenris/monitor.py $(LIBEXEC_DIR)/fenris-monitor @sudo install -m 0755 src/fenris/collect.py $(LIBEXEC_DIR)/fenris-collect @echo "=== Installing systemd units (dormant — not enabled/started) ===" @sudo install -m 0644 units/fenris-collect.timer $(UNIT_DIR)/ @sudo install -m 0644 units/fenris-collect.service $(UNIT_DIR)/ @sudo systemctl daemon-reload @echo "=== Installing polkit policy ===" @sudo install -m 0644 polkit/com.bongbetic.fenris.monitor.policy $(POLKIT_DIR)/ @echo "=== Recording manifest (IN-2, IN-10) ===" @echo "# Fenris placement manifest — do not edit" | sudo tee $(MANIFEST) > /dev/null @echo "# Generated by: sudo make install" | sudo tee -a $(MANIFEST) > /dev/null @echo "# Timestamp: $$(date -u +%%Y-%%m-%%dT%%H:%%M:%%SZ)" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(BIN_DIR)/fenris" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(LIBEXEC_DIR)/fenris-monitor" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(LIBEXEC_DIR)/fenris-collect" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(UNIT_DIR)/fenris-collect.timer" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(UNIT_DIR)/fenris-collect.service" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(POLKIT_DIR)/com.bongbetic.fenris.monitor.policy" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(VENV_DIR)" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(DATA_DIR)" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(CONF_DIR)" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(MANIFEST)" | sudo tee -a $(MANIFEST) > /dev/null @echo "=== Install complete ===" @echo "Units installed but NOT enabled or started (dormant — IN-3)." @echo "To start monitoring: fenris monitor resume" @$(MAKE) --no-print-directory import-legacy # ─── Legacy import (IN-4, ST-7) ──────────────────────────────────────────── import-legacy: @if [ -f "$(LEGACY_HISTORY)" ]; then \ echo "=== Detected legacy history: $(LEGACY_HISTORY) ==="; \ echo "Running idempotent import..."; \ $(VENV_DIR)/bin/python3 -c "import sys; sys.path.insert(0, 'src'); from fenris.legacy import import_legacy_history; from fenris.store import init_store; from pathlib import Path; conn = init_store(Path('$(DATA_DIR)/observations.db')); r = import_legacy_history(conn, Path('$(LEGACY_HISTORY)')); conn.close(); print(f' Samples imported: {r.get(\"samples_imported\", 0)}'); print(f' Hours imported: {r.get(\"hours_imported\", 0)}'); print(f' Malformed lines: {r.get(\"malformed_lines\", 0)}') if not r.get('skipped') else print(' Skipped: already imported')" || echo " Warning: import failed (non-fatal)"; \ else \ echo "=== No legacy history found at $(LEGACY_HISTORY) ==="; \ fi # ─── Upgrade ──────────────────────────────────────────────────────────────── upgrade: dist/fenris-*.whl @echo "=== Upgrading Fenris ===" @echo "=== Snapshotting database (IN-6) ===" @sudo cp $(DATA_DIR)/observations.db $(DATA_DIR)/observations.db.bak 2>/dev/null || true @echo "=== Installing new wheel with pinned dependencies ===" @sudo $(VENV_DIR)/bin/pip install dist/fenris-*.whl --quiet @echo "=== Syncing units against manifest ===" @sudo install -m 0644 units/fenris-collect.timer $(UNIT_DIR)/ @sudo install -m 0644 units/fenris-collect.service $(UNIT_DIR)/ @sudo install -m 0644 polkit/com.bongbetic.fenris.monitor.policy $(POLKIT_DIR)/ @sudo install -m 0755 scripts/fenris $(BIN_DIR)/fenris @sudo install -m 0755 src/fenris/monitor.py $(LIBEXEC_DIR)/fenris-monitor @sudo install -m 0755 src/fenris/collect.py $(LIBEXEC_DIR)/fenris-collect @sudo systemctl daemon-reload @echo "=== Updating manifest ===" @echo "# Fenris placement manifest — do not edit" | sudo tee $(MANIFEST) > /dev/null @echo "# Generated by: sudo make upgrade" | sudo tee -a $(MANIFEST) > /dev/null @echo "# Timestamp: $$(date -u +%%Y-%%m-%%dT%%H:%%M:%%SZ)" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(BIN_DIR)/fenris" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(LIBEXEC_DIR)/fenris-monitor" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(LIBEXEC_DIR)/fenris-collect" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(UNIT_DIR)/fenris-collect.timer" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(UNIT_DIR)/fenris-collect.service" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(POLKIT_DIR)/com.bongbetic.fenris.monitor.policy" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(VENV_DIR)" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(DATA_DIR)" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(CONF_DIR)" | sudo tee -a $(MANIFEST) > /dev/null @echo "$(MANIFEST)" | sudo tee -a $(MANIFEST) > /dev/null @echo "=== Restarting timer only if contents changed and active (IN-5) ===" @for unit in fenris-collect.timer fenris-collect.service; do \ TMPFILE=$$(mktemp); \ sudo systemctl cat $$unit > $$TMPFILE 2>/dev/null || true; \ if ! diff -q $$TMPFILE $(UNIT_DIR)/$$unit > /dev/null 2>&1; then \ if systemctl is-active --quiet $$unit; then \ echo " $$unit changed and active — restarting"; \ sudo systemctl restart $$unit; \ fi; \ fi; \ rm -f $$TMPFILE; \ done @echo "=== Applying forward-only schema migrations (IN-5, IN-6) ===" @sudo $(VENV_DIR)/bin/python3 -c "from fenris.store import migrate_to_latest; from pathlib import Path; n = migrate_to_latest(Path('$(DATA_DIR)/observations.db')); print(f' Migration steps applied: {n}') if n else print(' Schema already current')" @echo "=== Upgrade complete ===" # ─── Uninstall (IN-7) ────────────────────────────────────────────────────── uninstall: @echo "=== Uninstalling Fenris ===" @if [ -x $(LIBEXEC_DIR)/fenris-monitor ]; then \ echo "=== Performing sanctioned disable (§10.4) ==="; \ sudo $(LIBEXEC_DIR)/fenris-monitor disable --now || true; \ fi @echo "=== Stopping units ===" @sudo systemctl stop fenris-collect.timer 2>/dev/null || true @sudo systemctl disable fenris-collect.timer 2>/dev/null || true @sudo systemctl daemon-reload @echo "=== Removing installed files (preserving config and store) ===" @-rm -f $(BIN_DIR)/fenris @-rm -f $(LIBEXEC_DIR)/fenris-monitor @-rm -f $(LIBEXEC_DIR)/fenris-collect @-rmdir $(LIBEXEC_DIR) 2>/dev/null || true @-rm -f $(UNIT_DIR)/fenris-collect.timer @-rm -f $(UNIT_DIR)/fenris-collect.service @-rm -f $(POLKIT_DIR)/com.bongbetic.fenris.monitor.policy @sudo rm -rf $(VENV_DIR) @-sudo rm -f $(MANIFEST) @echo "=== Uninstall complete ===" @echo "Config preserved at $(CONF_DIR)" @echo "Store preserved at $(DATA_DIR)" # ─── Purge ────────────────────────────────────────────────────────────────── purge: uninstall @echo "=== Purging Fenris ===" @-sudo rm -rf $(CONF_DIR) @-sudo rm -rf $(DATA_DIR) @echo "=== Purge complete ===" # ─── Test ─────────────────────────────────────────────────────────────────── test: $(PYTHON) -m pytest tests/ -v # ─── Lint ─────────────────────────────────────────────────────────────────── lint: $(PYTHON) -m ruff check src/ tests/ # ─── Dependencies (IN-8) ─────────────────────────────────────────────────── update-deps: $(PYTHON) -m pip compile pyproject.toml -o requirements.txt # ─── Packaging (spec §3, §5) ──────────────────────────────────────────────── # Version is sourced from pyproject.toml for both formats FENRIS_VERSION := $(shell sed -n 's/^version = "\(.*\)"/\1/p' pyproject.toml) stage: dist/fenris-*.whl @echo "=== Staging packaging tree (v$(FENRIS_VERSION)) ===" bash packaging/stage.sh "$(FENRIS_VERSION)" package-deb: stage @echo "=== Building deb package ===" VERSION="$(FENRIS_VERSION)" nfpm pkg -f packaging/nfpm.yaml -p deb -t dist/ @echo "=== deb package built: dist/fenris_$(FENRIS_VERSION)_amd64.deb ===" package-rpm: stage @echo "=== Building rpm package ===" VERSION="$(FENRIS_VERSION)" nfpm pkg -f packaging/nfpm.yaml -p rpm -t dist/ @echo "=== rpm package built: dist/fenris-$(FENRIS_VERSION)-1.x86_64.rpm ===" package: package-deb package-rpm @echo "=== Both packages built in dist/ ===" release: package @echo "=== Release v$(FENRIS_VERSION) ===" @echo "Artifacts:" @ls -la dist/fenris_$(FENRIS_VERSION)_amd64.deb dist/fenris-$(FENRIS_VERSION)-1.x86_64.rpm 2>/dev/null @echo "" @echo "Manual steps (spec §5):" @echo " 1. Import packaging key: gpg --import " @echo " 2. Sign RPM payload: rpmsign --addsign dist/fenris-$(FENRIS_VERSION)-1.x86_64.rpm" @echo " 3. Generate checksums: cd dist && sha256sum fenris_$(FENRIS_VERSION)_amd64.deb fenris-$(FENRIS_VERSION)-1.x86_64.rpm > SHA256SUMS" @echo " 4. Clearsign manifest: gpg --clearsign dist/SHA256SUMS" @echo " 5. Upload to registry:" @echo " curl -X PUT -u user:token -T dist/fenris_$(FENRIS_VERSION)_amd64.deb \\" @echo " 'https://git.bongbetic.com/api/packages/xavierk/debian/pool/bookworm/main/upload'" @echo " curl -X PUT -u user:token -T dist/fenris_$(FENRIS_VERSION)_amd64.deb \\" @echo " 'https://git.bongbetic.com/api/packages/xavierk/debian/pool/jammy/main/upload'" @echo " curl -X PUT -u user:token -T dist/fenris_$(FENRIS_VERSION)_amd64.deb \\" @echo " 'https://git.bongbetic.com/api/packages/xavierk/debian/pool/noble/main/upload'" @echo " curl -X PUT -u user:token -T dist/fenris-$(FENRIS_VERSION)-1.x86_64.rpm \\" @echo " 'https://git.bongbetic.com/api/packages/xavierk/rpm/fenris/upload'" @echo " 6. Create Gitea release with notes and attach .deb, .rpm, SHA256SUMS.asc" clean: @echo "=== Cleaning build artifacts ===" rm -rf build/stage dist/fenris-*.deb dist/fenris-*.rpm dist/SHA256SUMS*