docs: document gateway method descriptors

src/gateway/methods/core-descriptors.ts

@@ -1,3 +1,4 @@
+// Core gateway method descriptors keep handler names, auth scopes, startup availability, and write policy in one table.
 import type { OperatorScope } from "../operator-scopes.js";
 import {
   DYNAMIC_GATEWAY_METHOD_SCOPE,

src/gateway/methods/descriptor.ts

@@ -1,3 +1,4 @@
+// Gateway method descriptor types define the reusable contract shared by core, plugin, channel, and auxiliary methods.
 import type { OperatorScope } from "../operator-scopes.js";
 
 /** Scope marker for methods that only authenticated node clients may call. */

src/gateway/methods/registry.ts

@@ -1,3 +1,4 @@
+// Gateway method registry normalizes method descriptors, enforces unique names, and exposes dispatch policy metadata.
 import type { PluginRegistry } from "../../plugins/registry-types.js";
 import { normalizePluginGatewayMethodScope } from "../../shared/gateway-method-policy.js";
 import { ADMIN_SCOPE, type OperatorScope } from "../operator-scopes.js";