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;
 }