Alpha-3

#Note Improved Makefile messaging didn't make it into this release. Replace the Makefile with the one in the master branch for a smoother UX install.

v0.4.0-alpha

Highlights

• Added configuration-driven application launching via run
• Implemented CCD-aware CPU affinity inheritance model
• Added hardware topology detection in privileged helper
• Introduced verbose (-v) mode
• Improved CLI consistency and usage behavior
• Installed default /etc/x3dctl.conf during system install
• Updated man page and README to reflect current functionality

---

Improvements

• Deterministic process pinning using affinity inheritance
• Lazy topology initialization in helper
• Stronger PID validation and input handling
• Clean removal of implicit default command behavior
• Improved Makefile install messaging
• Preserved DESTDIR compatibility for packaging
• Safer config parsing (frontend-only, no privileged parsing)
• Consistent command logging behavior

---

Behavioral Changes

• x3dctl with no arguments now displays usage instead of defaulting to status
• Added run command for policy-based execution
• Added system-wide configuration file at /etc/x3dctl.conf
• Verbose output available for debugging and inspection

---

Known Limitations

• Configuration supports only simple application=mode mapping
• No per-user configuration override yet
• No niceness or scheduler tuning integration
• No runtime game process detection (affinity applies to full process tree)
• Limited validation across multi-CCD (>2) systems

---

Future Goals

• Extended configuration schema (niceness, policy flags)
• Optional per-user config support (~/.config/x3dctl.conf)
• Multi-CCD topology generalization
• Optional cgroup integration
• Distribution packaging support
• Expanded hardware validation matrix

---

License

• MIT

---