docs: document daemon oauth command seams

src/commands/node-daemon-install-helpers.ts

@@ -1,3 +1,4 @@
+/** Node-based daemon install plan builder for managed gateway services. */
 import { formatNodeServiceDescription } from "../daemon/constants.js";
 import { resolveNodeProgramArguments } from "../daemon/program-args.js";
 import { buildNodeServiceEnvironment } from "../daemon/service-env.js";
@@ -27,6 +28,7 @@ function buildNodeInstallEnvironmentValueSources(): Record<
   };
 }
 
+/** Builds launch arguments, environment, and metadata for a Node daemon service install. */
 export async function buildNodeInstallPlan(params: {
   env: Record<string, string | undefined>;
   host: string;

src/commands/node-daemon-runtime.ts

@@ -1,13 +1,17 @@
+/** Compatibility exports for the Node daemon runtime selector. */
 import {
   DEFAULT_GATEWAY_DAEMON_RUNTIME,
   isGatewayDaemonRuntime,
   type GatewayDaemonRuntime,
 } from "./daemon-runtime.js";
 
+/** Runtime id accepted by Node daemon install/start helpers. */
 export type NodeDaemonRuntime = GatewayDaemonRuntime;
 
+/** Default Node daemon runtime, currently shared with the gateway daemon runtime. */
 export const DEFAULT_NODE_DAEMON_RUNTIME = DEFAULT_GATEWAY_DAEMON_RUNTIME;
 
+/** Returns true when a string is a supported Node daemon runtime id. */
 export function isNodeDaemonRuntime(value: string | undefined): value is NodeDaemonRuntime {
   return isGatewayDaemonRuntime(value);
 }

src/commands/non-interactive-prompter.ts

@@ -1,6 +1,8 @@
+/** Non-interactive wizard prompter that logs progress but rejects input prompts. */
 import type { RuntimeEnv } from "../runtime.js";
 import type { WizardPrompter } from "../wizard/prompts.js";
 
+/** Builds a WizardPrompter for commands that must fail instead of prompting. */
 export function createNonInteractiveLoggingPrompter(
   runtime: RuntimeEnv,
   formatPromptError: (message: string) => string,

src/commands/oauth-env.ts

@@ -1 +1,2 @@
+/** Back-compat command seam for remote OAuth environment detection. */
 export { isRemoteEnvironment } from "../infra/remote-env.js";

src/commands/oauth-tls-preflight.ts

@@ -1 +1,2 @@
+/** Back-compat command seam for OpenAI ChatGPT OAuth TLS preflight helpers. */
 export * from "../plugins/provider-openai-chatgpt-oauth-tls.js";