Fenris/Makefile

# 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

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"

# ─── 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 ==="
	@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
	
	@if systemctl is-active --quiet fenris-collect.timer; then \
		echo "=== Restarting timer (active) ==="; \
		sudo systemctl restart fenris-collect.timer; \
	fi
	
	@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