Provide Home Manager module for Determinate Nix

[lucperkins]

This module is more of a compatibility shim but could be useful in some cases.

Summary by CodeRabbit

• New Features

  • Home Manager support exported as a new, reusable module for integrating Home Manager configurations.

• Documentation

  • Added a Home Manager guidance section with configuration examples, integration notes, and a public reference link.

• Tests

  • Added test coverage demonstrating Home Manager integration and a sample user configuration for validation.

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds Home Manager integration: a new module that sets nix.package = null, exports it as homeManagerModules.default in the flake outputs, updates tests to build a Home Manager activation package, and documents usage and examples in README.md.

Changes

Cohort / File(s)	Summary
Flake exports flake.nix	Adds homeManagerModules.default export pointing to the new Home Manager module.
Home Manager module modules/home-manager/default.nix	New Nix module that declares nix.package = null.
Tests (flake) tests/flake.nix	Adds home-manager flake input, updates nix-darwin input handling, and introduces aarch64-darwin.home-manager output building an activationPackage using the new module with test user settings.
Documentation README.md	Adds Home Manager guidance, example configurations (inputs/modules), and a public reference link for home-manager.

Sequence Diagram(s)

sequenceDiagram
    participant Dev as Developer (flake consumer)
    participant Flake as Determinate Flake (outputs)
    participant HM as Home Manager flake
    participant Nixpkgs as nixpkgs

    Dev->>Flake: include flake as input / use `homeManagerModules.default`
    Flake->>HM: provide module to compose into Home Manager configuration
    Flake->>Nixpkgs: reference for system-specific pkgs import
    HM->>Nixpkgs: import pkgs { system = "aarch64-darwin" }
    HM->>HM: build homeManagerConfiguration with modules (including module from Flake)
    HM->>Dev: produce activationPackage (home-manager activation)

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Suggested reviewers

• cole-h
• colemickens

Poem

🐰 A flake hopped in with modules to share,

nix.package set to null with careful care,
Home Manager joins, activation in sight,
Tests build and docs show how to take flight. ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Provide Home Manager module for Determinate Nix' directly and concisely summarizes the main change: adding a Home Manager module to the Determinate Nix project. This is confirmed by the changes across README.md, flake.nix, modules/home-manager/default.nix, and tests/flake.nix.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch lucperkins/eng-1247-provide-minimal-home-manager-module-for-detnix

---

No actionable comments were generated in the recent review. 🎉

🧹 Recent nitpick comments

README.md (1)

168-188: First example snippet lacks flake context including the determinate input.

The second example (Line 193) is a full flake with inputs, but this first snippet references inputs.home-manager and inputs.nixpkgs without showing where they come from. Since the purpose of this first example is to show the manual approach (without the determinate module), consider either adding a minimal inputs block or adding a brief note that users should add the necessary inputs. This would keep it consistent with every other example in this README.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@README.md`:
- Around line 199-205: The example call to
inputs.home-manager.lib.homeManagerConfiguration is missing the required pkgs
parameter; update the homeConfigurations.my-system invocation (the
inputs.home-manager.lib.homeManagerConfiguration {...} block) to include a pkgs
attribute (e.g. pkgs = inputs.pkgs or pkgs =
inputs.nixpkgs.legacyPackages.x86_64-linux) alongside modules so the
configuration evaluates correctly.

🧹 Nitpick comments (1)

README.md (1)

168-207: Minor style nit: repeated phrasing across the two examples.

Lines 171 and 186 both use the identical sentence "This configuration, for example, would be compatible with Determinate Nix". Consider varying the wording for the second instance, e.g., "You can achieve the same result using the provided module:".