Refactor snap manifest to use package version from package.json and enhance local development permissions documentation

Author: mj-kiwi

packages/gator-permissions-snap/snap.manifest.ts

@@ -3,11 +3,14 @@
 
 import type { SnapManifest } from '@metamask/7715-permissions-shared/types';
 
+// eslint-disable-next-line import/no-relative-packages
+import packageJson from './package.json' with { type: 'json' };
+
 const kernelSnapId = process.env.KERNEL_SNAP_ID;
 const messageSnapId = process.env.MESSAGE_SIGNING_SNAP_ID;
 const snapEnv = process.env.SNAP_ENV;
 const manifest: SnapManifest = {
-  version: '0.3.0',
+  version: packageJson.version,
   description: 'Grants 7715 permissions from a DeleGator smart account',
   proposedName: 'Gator Permissions',
   repository: {
@@ -48,7 +51,18 @@ if (kernelSnapId) {
 }
 
 if (snapEnv === 'local') {
-  // Grant lifecycle hooks permission in local development environment
+  /**
+   * Grant lifecycle hooks permission in local development environment.
+   *
+   * The lifecycle hooks endowment is required to enable the onInstall handler
+   * which automatically installs the message signing snap during local development.
+   * This ensures that the gator permissions snap can establish the necessary
+   * connection to the message signing snap for 7715 permissions functionality.
+   *
+   * In production environments, the message signing snap is pre-installed by
+   * the MetaMask extension, making this endowment unnecessary and it's excluded
+   * to minimize the snap's permission footprint.
+   */
   manifest.initialPermissions['endowment:lifecycle-hooks'] = {};
 }
 

packages/permissions-kernel-snap/snap.manifest.ts

@@ -2,10 +2,11 @@
 /* eslint-disable no-restricted-globals */
 import type { SnapManifest } from '@metamask/7715-permissions-shared/types';
 
-const gatorSnapId = process.env.GATOR_PERMISSIONS_PROVIDER_SNAP_ID;
+// eslint-disable-next-line import/no-relative-packages
+import packageJson from './package.json' with { type: 'json' };
 
 const manifest: SnapManifest = {
-  version: '0.3.0',
+  version: packageJson.version,
   description: 'Manage onchain 7715 permissions',
   proposedName: 'MetaMask Permissions Kernel',
   repository: {
@@ -33,10 +34,4 @@ const manifest: SnapManifest = {
   manifestVersion: '0.1',
 };
 
-if (gatorSnapId) {
-  manifest.initialConnections = {
-    [gatorSnapId]: {},
-  };
-}
-
 export default manifest;