feat(nixvim): integrate ArchLens relationships

README.md

@@ -95,6 +95,7 @@ home-manager.users.<user>.home.packages = [
 
 ### Utils
 
+- `archlens.nix`: Installs and configures the published ArchLens Neovim plugin.
 - `trouble.nix`: Provides persistent diagnostics, quickfix, location-list, and TODO triage views.
 - `overseer.nix`: Runs bounded, repo-aware validation tasks while keeping persistent sessions in cmux.
 - `telescope.nix`: Configures the Telescope plugin for fuzzy finding and picking.

config/auto_cmds.nix

@@ -23,6 +23,7 @@
       event = [ "FileType" ];
       pattern = [
         "help"
+        "archlens"
         "snacks_dashboard"
         "neo-tree"
         "Trouble"

config/default.nix

@@ -50,6 +50,7 @@ _: {
     ./plugins/git/gitsigns.nix
 
     # Utils
+    ./plugins/utils/archlens.nix
     ./plugins/utils/trouble.nix
     ./plugins/utils/overseer.nix
     ./plugins/utils/telescope.nix

config/plugins/lsp/ocaml.nix

@@ -10,9 +10,12 @@
     packageFallback = true;
   };
 
-  # OCaml-LSP delegates formatting to ocamlformat. Keep the Nix package as a
-  # fallback so a project-local/opam version remains authoritative.
-  extraPackagesAfter = [ pkgs.ocamlPackages.ocamlformat ];
+  # OCaml-LSP needs Dune to load project documents and delegates formatting to
+  # ocamlformat. Keep both as fallbacks so project-local tools remain authoritative.
+  extraPackagesAfter = [
+    pkgs.dune_3
+    pkgs.ocamlPackages.ocamlformat
+  ];
 
   autoCmd = [
     {

config/plugins/utils/archlens.nix

@@ -0,0 +1,44 @@
+{
+  archlens,
+  lib,
+  pkgs,
+  ...
+}:
+{
+  extraPlugins = [ archlens ];
+  extraPackagesAfter = [
+    pkgs.ast-grep
+    pkgs.ripgrep
+  ];
+
+  extraConfigLua = lib.mkAfter ''
+    require("archlens").setup({
+      width = 64,
+      max_items = 8,
+      include_external = false,
+      ast_grep = {
+        command = "${lib.getExe pkgs.ast-grep}",
+        timeout_ms = 15000,
+        max_results = 80,
+        min_name_length = 5,
+      },
+      imports = {
+        inbound = {
+          command = "${lib.getExe pkgs.ripgrep}",
+        },
+      },
+    })
+  '';
+
+  keymaps = [
+    {
+      mode = "n";
+      key = "<leader>cm";
+      action = "<cmd>ArchLensHere<cr>";
+      options = {
+        desc = "Map local and project relationships";
+        silent = true;
+      };
+    }
+  ];
+}

config/plugins/utils/telescope.nix

@@ -1,6 +1,10 @@
+{ pkgs, ... }:
 {
+  extraPlugins = [ pkgs.vimPlugins.telescope-hierarchy-nvim ];
+
   plugins.telescope = {
     enable = true;
+    enabledExtensions = [ "hierarchy" ];
     extensions = {
       file-browser = {
         enable = true;
@@ -18,6 +22,11 @@
         };
         sorting_strategy = "ascending";
       };
+      extensions.hierarchy = {
+        initial_multi_expand = false;
+        multi_depth = 5;
+        layout_strategy = "horizontal";
+      };
     };
     keymaps = {
       "<leader><space>" = {
@@ -173,6 +182,22 @@
     };
   };
   keymaps = [
+    {
+      mode = "n";
+      key = "<leader>ci";
+      action = "<cmd>Telescope hierarchy incoming_calls<cr>";
+      options = {
+        desc = "Incoming call hierarchy";
+      };
+    }
+    {
+      mode = "n";
+      key = "<leader>co";
+      action = "<cmd>Telescope hierarchy outgoing_calls<cr>";
+      options = {
+        desc = "Outgoing call hierarchy";
+      };
+    }
     {
       mode = "n";
       key = "<leader>sd";

config/plugins/utils/trouble.nix

@@ -12,6 +12,18 @@ _: {
   };
 
   keymaps = [
+    {
+      mode = "n";
+      key = "<leader>cs";
+      action = "<cmd>Trouble symbols toggle focus=false<cr>";
+      options.desc = "Document symbols";
+    }
+    {
+      mode = "n";
+      key = "<leader>cl";
+      action = "<cmd>Trouble lsp toggle focus=false win.position=right<cr>";
+      options.desc = "LSP locations";
+    }
     {
       mode = "n";
       key = "<leader>xx";

flake.nix

@@ -10,6 +10,14 @@
     pre-commit-hooks = {
       url = "github:cachix/pre-commit-hooks.nix";
     };
+    archlens = {
+      url = "github:dc-tec/archlens";
+      inputs = {
+        flake-parts.follows = "flake-parts";
+        nixpkgs.follows = "nixpkgs";
+        nixvim.follows = "nixvim";
+      };
+    };
     md-render = {
       url = "github:delphinus/md-render.nvim/v3.4.0";
       flake = false;
@@ -52,6 +60,7 @@
             module = import ./config; # import the module directly
             # You can use `extraSpecialArgs` to pass additional arguments to your module files
             extraSpecialArgs = {
+              archlens = inputs.archlens.packages.${system}.default;
               mdRender = inputs.md-render;
               mmdr = inputs.mmdr.packages.${system}.default;
             };