Add AST-extracted metadata from .nix module files to a srctree filesystem tree using nix-meta.

Embed metadata (descriptions, author info, version numbers) in your Nix modules without affecting the evaluated configuration. metatree-nix strips _meta before evaluation.

1. nix-meta parses .nix files at the AST level and extracts the top-level _meta attribute set.
2. nix-meta removes _meta from each AST and renders the modified AST to temporary files.
3. srctree evaluates the stripped files.
4. metatree-nix merges the evaluated content and the extracted metadata into the final tree.

Add metatree-nix to your flake.nix inputs:

{
  inputs.metatree.url = "github:z1-0/metatree-nix";

  outputs = { metatree, ... }: {
    lib = metatree.lib;
  };
}

Add a top-level _meta attribute set to your module files:

# src/services/web.nix
{
  _meta = {
    description = "Web server service module";
    author = "team-infra";
    version = 1;
  };

  port = 8080;
  host = "0.0.0.0";
  workers = 4;
}

let
  pkgs = import nixpkgs { system = "x86_64-linux"; };
  metatree = metatree.lib.load pkgs ./src;
in
  metatree

• load returns the enriched tree structure directly.
• loadHaumea returns { tree, attrs } for haumea-style access.

{
  name = "web";
  path = "/abs/path/to/src/services/web.nix";
  type = "file";
  content = {
    port = 8080;
    host = "0.0.0.0";
    workers = 4;
  };
  meta = {
    description = "Web server service module";
    author = "team-infra";
    version = 1;
  };
}

load :: pkgs -> src -> tree

Load a directory with srctree, extract _meta from Nix files, strip it, evaluate, and return the enriched tree.

• pkgs: package set for running the parser/renderer utilities.
• src: source directory to load.

loadHaumea :: pkgs -> args -> { tree, attrs }

Load with a haumea-style return, giving you the tree and clean attrs.

• pkgs: package set for running the parser/renderer utilities.
• args: arguments forwarded to srctree.lib.loadHaumea.

withMeta :: pkgs -> tree -> tree

Enrich an already loaded srctree tree with AST-extracted _meta attributes.

• pkgs: package set for running the parser/renderer utilities.
• tree: srctree tree structure to enrich.