feat: update documentation, lib functions, modules, and packages

pkgs/default.nix

@@ -1,13 +1,21 @@
+# m3ta-nixpkgs package registry
+#
+# Flake inputs used:
+#   inputs.basecamp  → basecamp (pass-through)
+#   inputs.openspec → openspec (pass-through)
+#   inputs.opencode → opencode-desktop (build inputs + patches)
+#   inputs.agents   → not used directly here (used by lib/)
 {
   pkgs,
   inputs,
   ...
 }: let
-  # Used only for flake input pass-throughs (basecamp, openspec, opencode-desktop)
   system = pkgs.stdenv.hostPlatform.system;
 in {
-  # Custom packages registry
-  # Each package is defined in its own directory under pkgs/
+  # ── Local packages ────────────────────────────────────────────────
+  # Standard packages built from source in ./<name>/default.nix.
+  # No flake inputs required.
+
   sidecar = pkgs.callPackage ./sidecar {};
   td = pkgs.callPackage ./td {};
   code2prompt = pkgs.callPackage ./code2prompt {};
@@ -26,11 +34,18 @@ in {
   zellij-ps = pkgs.callPackage ./zellij-ps {};
   vibetyper = pkgs.callPackage ./vibetyper {};
 
-  # Imported from flake inputs (pass-through, no modifications)
+  # ── Pass-through packages ──────────────────────────────────────────
+  # Imported directly from flake inputs. No local modifications.
+
   basecamp = inputs.basecamp.packages.${system}.default;
   openspec = inputs.openspec.packages.${system}.default;
 
-  # Imported from flake inputs (with local modifications)
+  # ── Modified packages ────────────────────────────────────────────
+  # Imported from flake inputs but built with local overrides.
+
+  # inputs.opencode is used for:
+  #   - opencode binary (copied into the Tauri sidecars directory)
+  #   - node_modules (with FOD hash fix for upstream issue #11755)
+  #   - src + patches (via inputs.opencode)
   opencode-desktop = pkgs.callPackage ./opencode-desktop {inherit inputs;};
-  # opencode-desktop = inputs.opencode.packages.${pkgs.system}.desktop;
 }

pkgs/n8n/default.nix

@@ -26,20 +26,20 @@
 in
   stdenv.mkDerivation (finalAttrs: {
     pname = "n8n";
-    version = "2.16.1";
+    version = "2.17.5";
 
     src = fetchFromGitHub {
       owner = "n8n-io";
       repo = "n8n";
       tag = "n8n@${finalAttrs.version}";
-      hash = "sha256-5y00RY8WWVgpxC3TNPFS9XxshgZKTlShpw+HiJVQvmM=";
+      hash = "sha256-JwPrQOohXXeuUEcr5S+41ZElBJ3TxR3cgT45CjbzyR4=";
     };
 
     pnpmDeps = fetchPnpmDeps {
       inherit (finalAttrs) pname version src;
       pnpm = pnpm_10;
       fetcherVersion = 3;
-      hash = "sha256-qyD+zlsBiJLwrazEclVkDmUp+wAxvdH3P6oWpmiX5rc=";
+      hash = "sha256-MBSxAsZXCaxwQpstJVxOOCIAE+0RqwlIrgXtE/hiTJM=";
     };
 
     nativeBuildInputs =

pkgs/n8n/update.sh

@@ -2,5 +2,7 @@
 #!nix-shell --pure -i bash -p bash curl jq nix-update cacert git
 set -euo pipefail
 
-new_version="$(curl -s "https://api.github.com/repos/n8n-io/n8n/releases/latest" | jq --raw-output '.tag_name | ltrimstr("n8n@")')"
+# n8n now publishes two releases per version: a "stable" tag and a "n8n@X.Y.Z" versioned tag.
+# Skip the "stable" tag and get the actual version from the next release.
+new_version="$(curl -s "https://api.github.com/repos/n8n-io/n8n/releases" | jq --raw-output 'map(select(.tag_name != "stable")) | .[0].tag_name | ltrimstr("n8n@")')"
 nix-update n8n --flake --version "$new_version"