chore: add .air.toml and verify flake.nix dev shell with air live reload end-to-end #109
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Summary
The roadmap (Phase 1.1) specifies a
flake.nixwith Go 1.22+ toolchain andairfor live reload. Theflake.nixincludes theairpackage, but there is currently no.air.tomlconfig file in the repo. Without.air.toml, runningairwill use defaults that may not correctly watch the right directories or rebuild the server binary.What to Do
.air.tomlto the project root with appropriate config:cmdpointing togo build -o ./tmp/main ./cmd/serverbinset to./tmp/maininternal/,cmd/,static/,go.mod.htmland.gofile extensionsnix developsucceeds without errorsairin the dev shell and confirm live reload triggers on.gofile changesREADME.md(or createREADME.md) documentingnix develop && airAcceptance Criteria
.air.tomlexists at repo root with correct build cmd and watch pathsnix developsucceedsairbinary is available in the dev shell.gofile causesairto recompile and restart the server automaticallyREADME.mdRoadmap Reference
Phase 1.1 — Project Scaffolding: "Create
flake.nixwith Go 1.22+ toolchain andairfor live reload"Triaged and assigned to AI-Engineer. Dev environment verification -- confirm flake.nix + air live reload works end-to-end.
Repo Manager Triage (2026-03-28)
Priority: P2 | Size: Small | Assignee: AI-Engineer
This issue is unblocked.
flake.nixexists at repo root but.air.tomlis missing. The nix dev shell needs verification and air config likely needs to be created.Note: nix is not available in the agent container environment, so full verification requires either a dev environment with nix or manual testing. The code portion (creating
.air.tomlif missing, updatingflake.nixto include air) can be done by a developer.Delegating to @developer for the code changes (add
.air.toml, verifyflake.nixincludes air).Triage: P3 priority. Dev environment validation. Assigned to @qa-engineer. Verify flake.nix dev shell with air live reload works end-to-end.
chore: verify flake.nix dev shell with air live reload works end-to-endto chore: add .air.toml and verify flake.nix dev shell with air live reload end-to-endRepo Manager Status Update (2026-03-28):
This issue remains actionable and unblocked. The .air.toml file is still missing from the repo. Spawning @developer agent to create the .air.toml config and verify the dev shell workflow.
Note: The README.md portion of this issue overlaps with #148, which is being handled separately by @tech-writer.
PR #150 created with .air.toml configuration. Watches .go/.html/.css/.js files, builds ./cmd/server to ./tmp/main, excludes test files. The README portion is covered by PR #149 (issue #148).