# OpenCode: Future Nix Flake Improvements

This document tracks potential improvements to the Nix flake configuration.

## 📋 Status Overview

| Category | Status |
|---------|--------|
| Code Quality | 🟡 In Progress |
| CI/CD | ✅ Baseline Done |
| Developer Experience | ⏸ Not Started |
| Utilities | ⏸ Not Started |
| Structure | ⏸ Not Started |

## ✅ Completed

### CI and Git Hooks
- ✅ **GitHub Actions CI** - `.github/workflows/flake-check.yaml`
- ✅ **Nix-native git hooks** - `modules/git-hooks/default.nix`
- ✅ **Declarative hook installation** - Auto-installs on rebuild
- ✅ **nixfmt integration** - Runs on commit and CI
- ✅ **statix integration** - Lints for Nix antipatterns
- ✅ **deadnix integration** - Finds dead code
- ✅ **.editorconfig** - Unified code style
- ✅ **Git hooks on all hosts** - Enabled on andromache, astyanax, hecuba, eetion, vm

### Deduplication
- ✅ **Created `mkNixOS` helper** - Centralized system configuration

## 📋 Pending Improvements

See [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md) for detailed implementation phases.

### Quick Reference
| Priority | Task | Phase |
|----------|-------|--------|
| HIGH | Add statix hook | 1.1 |
| HIGH | Add deadnix hook | 1.2 |
| HIGH | Enable git-hooks on all hosts | 1.3 |
| HIGH | Add CI caching | 2.1 |
| MEDIUM | Add automated flake.lock updates | 2.2 |
| MEDIUM | Add nil/nixd LSP | 3.1 |
| MEDIUM | Add nix-index + comma | 3.2 |
| MEDIUM | Add nh | 3.3 |
| LOW | Add utility tools (nix-tree, etc.) | 4.x |
| LOW | Migrate to flake-parts | 5.1 |

## 🎯 Next Steps

1. Review [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md) for complete roadmap
2. Start with Phase 1 (Enhanced Code Quality)
3. Update this document as items are completed

## 📚 Documentation

| Document | Purpose |
|----------|---------|
| [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md) | ✅ **Main plan** - Consolidated roadmap |
| [CI_HOOKS_SUMMARY.md](CI_HOOKS_SUMMARY.md) | Current CI/hooks setup |
| [AWESOME_NIX_PLAN.md](AWESOME_NIX_PLAN.md) | Awesome-nix integration details |
| [DRUPOL_INFRA_ANALYSIS.md](DRUPOL_INFRA_ANALYSIS.md) | Reference patterns |

## 🔗 Links

- [awesome-nix](https://github.com/nix-community/awesome-nix)
- [git-hooks.nix](https://github.com/cachix/git-hooks.nix)
- [drupol/infra](https://github.com/drupol/infra)