feat: Rust backend with CLI

[productdevbook]

🗺️ PortKiller Architecture Roadmap

💡 Based on suggestion from @poyotanp in #53

Vision: Shared Backend Architecture

flowchart TB
    subgraph Core["🦀 portkiller-core (Rust Library)"]
        Scanner["📡 Port Scanner<br/>• macOS ✅<br/>• Linux 🚧<br/>• Windows 🚧"]
        Killer["💀 Process Killer<br/>• SIGTERM ✅<br/>• SIGKILL ✅<br/>• Graceful ✅"]
        Config["⚙️ Config Store<br/>• favorites ✅<br/>• watched ✅<br/>• JSON sync ✅"]
        Models["📦 Models<br/>• PortInfo ✅<br/>• ProcessType ✅<br/>• Filter ✅"]
    end

    subgraph Clients["Frontends"]
        CLI["🖥️ Rust CLI ✅<br/>• list, kill, fav, watch<br/>• TUI (ratatui)<br/>• JSON output"]
        Swift["🍎 Swift GUI 🚧<br/>• SwiftUI<br/>• Menu Bar<br/>• Sparkle"]
        Future["🔮 Future<br/>• Tauri (Linux/Win)<br/>• Wails"]
    end

    subgraph Storage["💾 Shared Storage"]
        JSON["~/.portkiller/config.json"]
    end

    Core --> CLI
    Core -->|"FFI (uniffi)"| Swift
    Core --> Future
    Config <--> JSON
    Swift <--> JSON

Loading

---

✅ This PR: Phase 1 Complete

Core Library (backend/core/)

Component	Status	Description
Scanner (macOS)	✅	lsof parsing
Scanner (Linux)	🚧	ss/netstat (stub ready)
Scanner (Windows)	🚧	netstat (stub ready)
Process Killer	✅	SIGTERM → SIGKILL
Config Store	✅	JSON at ~/.portkiller/
Models	✅	PortInfo, ProcessType, WatchedPort, PortFilter

CLI (backend/cli/)

Feature	Status
portkiller list	✅
portkiller kill <port>	✅
portkiller fav add/rm/list	✅
portkiller watch add/rm/list	✅
portkiller config	✅
TUI (ratatui)	✅
JSON output	✅

---

📋 Roadmap

gantt
    title PortKiller Rust Backend Roadmap
    dateFormat  YYYY-MM-DD
    section Phase 1
    Core Library (macOS)   :done, p1a, 2024-12-19, 1d
    Rust CLI + TUI         :done, p1b, 2024-12-19, 1d
    section Phase 2
    Linux Scanner          :p2a, after p1b, 3d
    Windows Scanner        :p2b, after p2a, 3d
    section Phase 3
    Swift FFI (uniffi)     :p3a, after p2b, 7d
    Replace PortScanner.swift :p3b, after p3a, 3d
    section Phase 4
    Release Binaries       :p4a, after p3b, 2d
    Tauri GUI (optional)   :p4b, after p4a, 14d

Loading

---

🧪 Test

cd backend

# Run tests (37 passing)
cargo test

# List ports (macOS)
cargo run --bin portkiller -- list

# Kill process
cargo run --bin portkiller -- kill 3000

# TUI mode
cargo run --bin portkiller

---

🤖 Generated with Claude Code