@interactive-inc/claude-funnel 0.58.1 → 0.59.1

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { a as Settings, c as profileConfigSchema, i as SETTINGS_VERSION, l as settingsSchema, n as ChannelDeliveryMode, o as channelConfigSchema, r as ProfileConfig, s as channelDeliveryModeSchema, t as ChannelConfig } from "./settings-schema-1hh11jnN.js";
 import { n as FunnelIdGenerator, t as FunnelSettingsReader } from "./settings-reader-DPwqOVUm.js";
 import { S as FunnelLogger, _ as connectorConnectionEventSchema, a as ConnectorConnectionStatus, b as FunnelConnectorListener, c as ConnectorProcessedQuery, d as ConnectorRawEvent, f as ConnectorRawQuery, g as StoredRawEvent, h as StoredProcessedEvent, i as ConnectorConnectionRecord, l as ConnectorProcessedRecord, m as StoredConnectionEvent, n as ConnectorConnectionEvent, o as ConnectorDiagnosticLog, p as ConnectorRawRecord, r as ConnectorConnectionQuery, s as ConnectorProcessedEvent, t as CONNECTOR_CONNECTION_STATUSES, u as ConnectorQuery, v as connectorProcessedEventSchema, x as NotifyFn, y as connectorRawEventSchema } from "./diagnostic-log-Cb3v8P7p.js";
-import { a as RunOptions, i as ProcessSnapshot, n as DetachOptions, o as RunResult, r as FunnelProcessRunner, t as AttachOptions } from "./process-runner-Cx5O_fTf.js";
+import { a as RunOptions, i as ProcessSnapshot, n as DetachOptions, o as RunResult, r as FunnelProcessRunner, t as AttachOptions } from "./process-runner-DIm1cy95.js";
 import { n as FunnelFileSystem, t as FileStat } from "./file-system-DxpnnUVb.js";
-import { a as ChannelConnectorView, c as FunnelConnectorFactory, d as ConnectorConfig, f as ConnectorType, l as ScheduleListenerOptions, o as FunnelChannels, p as connectorConfigSchema, s as FunnelClock, u as SlackListenerOptions } from "./local-config-sync--f739oCJ.js";
+import { a as ChannelConnectorView, c as FunnelConnectorFactory, d as ConnectorConfig, f as ConnectorType, l as ScheduleListenerOptions, o as FunnelChannels, p as connectorConfigSchema, s as FunnelClock, u as SlackListenerOptions } from "./local-config-sync-BGPAS9Be.js";
 import { n as FunnelConnectorAdapter, r as JsonValue, t as CallInput } from "./connector-adapter-DGacCppE.js";
 import { a as ScheduleEntry, c as scheduleEntrySchema, i as ScheduleConnectorConfig, o as scheduleCatchupPolicySchema, r as ScheduleCatchupPolicy, s as scheduleConnectorSchema } from "./schedule-listener-DoMPjHZj.js";
 import { a as slackConnectorSchema, c as SlackProcessedEmit, d as SlackSkipReason, i as SlackConnectorConfig, l as SlackProcessedSkip, o as FunnelSlackEventProcessor, s as SlackProcessed, u as SlackRawEvent } from "./slack-listener-Dj9NFbAJ.js";
@@ -13,5 +13,5 @@ import { a as RecoveryListenerControl, i as RecoveryGatewayControl, n as Recover
 import { n as DoctorReport, r as FunnelDoctor, t as DoctorFixMode } from "./funnel-doctor-vxO96TCA.js";
 import { a as HttpResponse, i as HttpRequest, n as discordConnectorSchema, r as FunnelHttpClient, t as DiscordConnectorConfig } from "./discord-connector-schema-CQyfDkLD.js";
 import { n as ghConnectorSchema, t as GhConnectorConfig } from "./gh-connector-schema-CZzwzvqY.js";
-import { $ as PublishResult, A as NodeFunnelFileSystem, B as GatewayServerOptions, C as MemoryProcessCall, D as ProcessListStub, E as MemoryProcessSyncHandler, F as FunnelSettingsStore, G as FunnelGateway, H as ListListenersResult, I as SETTINGS_PATH, J as MemoryFunnelEventLog, K as MemoryConnectorDiagnosticLog, L as resolveFunnelDir, M as createSettings, N as DEFAULT_GATEWAY_PORT, O as NodeFunnelProcessRunner, P as FUNNEL_DIR, Q as PublishResponse, R as resolveFunnelPort, S as MemoryFunnelProcessRunner, St as OnFunnelError, T as MemoryProcessResponse, U as ListenerEntry, V as FunnelListenersClient, W as ListenerOpResult, X as FunnelChannelPublisher, Y as SqliteFunnelEventLog, Z as PublishRequest, _ as NoopFunnelLogger, _t as FunnelListenerSupervisor, a as toRequest, at as ChannelWsUrlInput, b as NodeFunnelLogger, bt as FunnelBroadcaster, c as buildServiceRoutes, ct as FunnelGatewayServer, d as MemoryHttpResponse, dt as FunnelEventLog, et as publishRequestSchema, f as NodeFunnelHttpClient, ft as FunnelEventRecord, g as NodeFunnelClock, gt as GatewayRouteDeps, h as MemoryFunnelClock, ht as GatewayEmitInput, i as queryToCliArgs, it as gatewayLoopbackUrl, j as MockFunnelSettingsReader, k as MemoryFunnelFileSystem, l as MemoryFunnelHttpClient, lt as GatewayEventStore, m as NodeFunnelIdGenerator, mt as Env$1, n as CliApp, nt as DEFAULT_GATEWAY_TOKEN_PATH, o as Env, ot as channelWsProtocols, p as MemoryFunnelIdGenerator, pt as funnelEventSchema, q as SqliteConnectorDiagnosticLog, r as routes, rt as FunnelGatewayToken, s as factory, st as channelWsUrl, t as GatewayApp, tt as publishResponseSchema, u as MemoryHttpHandler, ut as FunnelEvent, v as LogEntry, vt as BroadcastEvent, w as MemoryProcessHandler, x as AliveStub, xt as ReplayableEvent, y as MemoryFunnelLogger, yt as BroadcastSubscriber, z as Funnel } from "./index-B9iyugar.js";
-export { AliveStub, AttachOptions, BroadcastEvent, BroadcastSubscriber, CONNECTOR_CONNECTION_STATUSES, CallInput, ChannelConfig, ChannelConnectorView, ChannelDeliveryMode, ChannelDiagnosis, ChannelWsUrlInput, CliApp, ConnectorConfig, ConnectorConnectionEvent, ConnectorConnectionQuery, ConnectorConnectionRecord, ConnectorConnectionStatus, ConnectorDiagnosticLog, ConnectorDiagnosticSqlReader, ConnectorProcessedEvent, ConnectorProcessedQuery, ConnectorProcessedRecord, ConnectorQuery, ConnectorRawEvent, ConnectorRawQuery, ConnectorRawRecord, ConnectorType, DEFAULT_GATEWAY_PORT, DEFAULT_GATEWAY_TOKEN_PATH, DetachOptions, DiagnoseAllReport, DiagnosisStatus, DiagnosticConnectionError, DiagnosticEvent, DiagnosticsChannelSource, DiagnosticsGatewayProbe, DiagnosticsPublisher, DiagnosticsTokenReader, DiscordConnectorConfig, DocsTopicListing, DoctorFixMode, DoctorReport, Env, FUNNEL_DIR, FileStat, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClock, FunnelConnectorAdapter, FunnelConnectorFactory, FunnelConnectorListener, FunnelDiagnostics, FunnelDocs, FunnelDoctor, FunnelEvent, FunnelEventLog, FunnelEventRecord, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelHttpClient, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLogger, FunnelProcessRunner, FunnelRecovery, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, GatewayApp, GatewayEmitInput, GatewayEventStore, GatewayRouteDeps, Env$1 as GatewayServerEnv, GatewayServerOptions, GhConnectorConfig, HttpRequest, HttpResponse, JsonValue, ListListenersResult, ListenerEntry, ListenerOpResult, LogEntry, MemoryConnectorDiagnosticLog, MemoryFunnelClock, MemoryFunnelEventLog, MemoryFunnelFileSystem, MemoryFunnelHttpClient, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryHttpHandler, MemoryHttpResponse, MemoryProcessCall, MemoryProcessHandler, MemoryProcessResponse, MemoryProcessSyncHandler, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelHttpClient, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NoopFunnelLogger, NotifyFn, OnFunnelError, ProcessListStub, ProcessSnapshot, ProfileConfig, PublishRequest, PublishResponse, PublishResult, RecoveryAction, RecoveryChannelSource, RecoveryGatewayControl, RecoveryListenerControl, RecoveryResult, ReplayResult, ReplayableEvent, RunOptions, RunResult, SETTINGS_PATH, SETTINGS_VERSION, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleEntry, ScheduleListenerOptions, Settings, SlackConnectorConfig, SlackListenerOptions, SlackProcessed, SlackProcessedEmit, SlackProcessedSkip, SlackRawEvent, SlackSkipReason, SqliteConnectorDiagnosticLog, SqliteFunnelEventLog, StoredConnectionEvent, StoredProcessedEvent, StoredRawEvent, buildServiceRoutes, channelConfigSchema, channelDeliveryModeSchema, channelWsProtocols, channelWsUrl, routes as cliRoutes, connectorConfigSchema, connectorConnectionEventSchema, connectorProcessedEventSchema, connectorRawEventSchema, createSettings, discordConnectorSchema, factory, funnelEventSchema, gatewayLoopbackUrl, ghConnectorSchema, previewOf, profileConfigSchema, publishRequestSchema, publishResponseSchema, queryRows, queryToCliArgs, resolveFunnelDir, resolveFunnelPort, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, toDiagnosticConnectionError, toDiagnosticEvent, toRequest };
+import { $ as PublishResponse, A as MemoryFunnelFileSystem, B as Funnel, C as MemoryProcessCall, Ct as OnFunnelError, D as ProcessListStub, E as MemoryProcessSyncHandler, F as FUNNEL_DIR, G as ListenerOpResult, H as FunnelListenersClient, I as FunnelSettingsStore, J as SqliteConnectorDiagnosticLog, K as FunnelGateway, L as SETTINGS_PATH, M as MockFunnelSettingsReader, N as createSettings, O as StartTimeStub, P as DEFAULT_GATEWAY_PORT, Q as PublishRequest, R as resolveFunnelDir, S as MemoryFunnelProcessRunner, St as ReplayableEvent, T as MemoryProcessResponse, U as ListListenersResult, V as GatewayServerOptions, W as ListenerEntry, X as SqliteFunnelEventLog, Y as MemoryFunnelEventLog, Z as FunnelChannelPublisher, _ as NoopFunnelLogger, _t as GatewayRouteDeps, a as toRequest, at as gatewayLoopbackUrl, b as NodeFunnelLogger, bt as BroadcastSubscriber, c as buildServiceRoutes, ct as channelWsUrl, d as MemoryHttpResponse, dt as FunnelEvent, et as PublishResult, f as NodeFunnelHttpClient, ft as FunnelEventLog, g as NodeFunnelClock, gt as GatewayEmitInput, h as MemoryFunnelClock, ht as Env$1, i as queryToCliArgs, it as FunnelGatewayToken, j as NodeFunnelFileSystem, k as NodeFunnelProcessRunner, l as MemoryFunnelHttpClient, lt as FunnelGatewayServer, m as NodeFunnelIdGenerator, mt as funnelEventSchema, n as CliApp, nt as publishResponseSchema, o as Env, ot as ChannelWsUrlInput, p as MemoryFunnelIdGenerator, pt as FunnelEventRecord, q as MemoryConnectorDiagnosticLog, r as routes, rt as DEFAULT_GATEWAY_TOKEN_PATH, s as factory, st as channelWsProtocols, t as GatewayApp, tt as publishRequestSchema, u as MemoryHttpHandler, ut as GatewayEventStore, v as LogEntry, vt as FunnelListenerSupervisor, w as MemoryProcessHandler, x as AliveStub, xt as FunnelBroadcaster, y as MemoryFunnelLogger, yt as BroadcastEvent, z as resolveFunnelPort } from "./index-D7mjirUL.js";
+export { AliveStub, AttachOptions, BroadcastEvent, BroadcastSubscriber, CONNECTOR_CONNECTION_STATUSES, CallInput, ChannelConfig, ChannelConnectorView, ChannelDeliveryMode, ChannelDiagnosis, ChannelWsUrlInput, CliApp, ConnectorConfig, ConnectorConnectionEvent, ConnectorConnectionQuery, ConnectorConnectionRecord, ConnectorConnectionStatus, ConnectorDiagnosticLog, ConnectorDiagnosticSqlReader, ConnectorProcessedEvent, ConnectorProcessedQuery, ConnectorProcessedRecord, ConnectorQuery, ConnectorRawEvent, ConnectorRawQuery, ConnectorRawRecord, ConnectorType, DEFAULT_GATEWAY_PORT, DEFAULT_GATEWAY_TOKEN_PATH, DetachOptions, DiagnoseAllReport, DiagnosisStatus, DiagnosticConnectionError, DiagnosticEvent, DiagnosticsChannelSource, DiagnosticsGatewayProbe, DiagnosticsPublisher, DiagnosticsTokenReader, DiscordConnectorConfig, DocsTopicListing, DoctorFixMode, DoctorReport, Env, FUNNEL_DIR, FileStat, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClock, FunnelConnectorAdapter, FunnelConnectorFactory, FunnelConnectorListener, FunnelDiagnostics, FunnelDocs, FunnelDoctor, FunnelEvent, FunnelEventLog, FunnelEventRecord, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelHttpClient, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLogger, FunnelProcessRunner, FunnelRecovery, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, GatewayApp, GatewayEmitInput, GatewayEventStore, GatewayRouteDeps, Env$1 as GatewayServerEnv, GatewayServerOptions, GhConnectorConfig, HttpRequest, HttpResponse, JsonValue, ListListenersResult, ListenerEntry, ListenerOpResult, LogEntry, MemoryConnectorDiagnosticLog, MemoryFunnelClock, MemoryFunnelEventLog, MemoryFunnelFileSystem, MemoryFunnelHttpClient, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryHttpHandler, MemoryHttpResponse, MemoryProcessCall, MemoryProcessHandler, MemoryProcessResponse, MemoryProcessSyncHandler, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelHttpClient, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NoopFunnelLogger, NotifyFn, OnFunnelError, ProcessListStub, ProcessSnapshot, ProfileConfig, PublishRequest, PublishResponse, PublishResult, RecoveryAction, RecoveryChannelSource, RecoveryGatewayControl, RecoveryListenerControl, RecoveryResult, ReplayResult, ReplayableEvent, RunOptions, RunResult, SETTINGS_PATH, SETTINGS_VERSION, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleEntry, ScheduleListenerOptions, Settings, SlackConnectorConfig, SlackListenerOptions, SlackProcessed, SlackProcessedEmit, SlackProcessedSkip, SlackRawEvent, SlackSkipReason, SqliteConnectorDiagnosticLog, SqliteFunnelEventLog, StartTimeStub, StoredConnectionEvent, StoredProcessedEvent, StoredRawEvent, buildServiceRoutes, channelConfigSchema, channelDeliveryModeSchema, channelWsProtocols, channelWsUrl, routes as cliRoutes, connectorConfigSchema, connectorConnectionEventSchema, connectorProcessedEventSchema, connectorRawEventSchema, createSettings, discordConnectorSchema, factory, funnelEventSchema, gatewayLoopbackUrl, ghConnectorSchema, previewOf, profileConfigSchema, publishRequestSchema, publishResponseSchema, queryRows, queryToCliArgs, resolveFunnelDir, resolveFunnelPort, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, toDiagnosticConnectionError, toDiagnosticEvent, toRequest };

package/dist/index.js

@@ -2,18 +2,18 @@ import { t as FunnelConnectorAdapter } from "./connector-adapter-qwXLjQId.js";
 import { a as FunnelHttpClient, i as NodeFunnelHttpClient, r as FunnelDiscordAdapter, t as FunnelDiscordListener } from "./discord-listener-CKsZGTnH.js";
 import { t as FunnelConnectorListener } from "./connector-listener-CpHBecCj.js";
 import { t as FunnelLogger } from "./logger-BP6SisKt.js";
-import { n as NodeFunnelProcessRunner, r as FunnelProcessRunner, t as ghConnectorSchema } from "./gh-connector-schema-DUcZgN2Q.js";
-import { n as FunnelGhAdapter, t as FunnelGhListener } from "./gh-listener-Dsx6AmhH.js";
+import { n as NodeFunnelProcessRunner, r as FunnelProcessRunner, t as ghConnectorSchema } from "./gh-connector-schema-ClPLSYD9.js";
+import { n as FunnelGhAdapter, t as FunnelGhListener } from "./gh-listener-B2I4s8qh.js";
 import { n as ScheduleStateStore, t as FunnelScheduleListener } from "./schedule-listener-DP9Jhc6U.js";
 import { t as FunnelFileSystem } from "./file-system-PWKKU7lA.js";
 import { t as NodeFunnelFileSystem } from "./node-file-system-BcrmWN9I.js";
 import { n as FunnelSlackEventProcessor, r as FunnelSlackAdapter, t as FunnelSlackListener } from "./slack-listener-C4wlZaOq.js";
 import { n as FunnelIdGenerator, t as FunnelSettingsReader } from "./settings-reader-DPqrpV7s.js";
-import { a as SETTINGS_PATH, c as SETTINGS_VERSION, d as profileConfigSchema, f as settingsSchema, i as FunnelSettingsStore, l as channelConfigSchema, m as NodeFunnelIdGenerator, n as DEFAULT_GATEWAY_PORT, o as resolveFunnelDir, p as connectorConfigSchema, r as FUNNEL_DIR, s as resolveFunnelPort, t as gatewayLoopbackUrl, u as channelDeliveryModeSchema } from "./gateway-base-url-6foMXfFf.js";
+import { a as SETTINGS_PATH, c as SETTINGS_VERSION, d as profileConfigSchema, f as settingsSchema, i as FunnelSettingsStore, l as channelConfigSchema, m as NodeFunnelIdGenerator, n as DEFAULT_GATEWAY_PORT, o as resolveFunnelDir, p as connectorConfigSchema, r as FUNNEL_DIR, s as resolveFunnelPort, t as gatewayLoopbackUrl, u as channelDeliveryModeSchema } from "./gateway-base-url-DxVjjDoW.js";
 import { t as discordConnectorSchema } from "./discord-connector-schema-B_N6IXLz.js";
 import { n as scheduleConnectorSchema, r as scheduleEntrySchema, t as scheduleCatchupPolicySchema } from "./schedule-connector-schema-B_xO5z5B.js";
 import { t as slackConnectorSchema } from "./slack-connector-schema-C1zEf4TG.js";
-import { a as FunnelMcp, o as FileProcessGuard, s as FunnelClaude, t as renderYaml } from "./yaml-render-C9Hhjk-0.js";
+import { a as FunnelMcp, o as FileProcessGuard, s as FunnelClaude, t as renderYaml } from "./yaml-render-cZu6CxkE.js";
 import { a as toDiagnosticEvent, i as toDiagnosticConnectionError, n as previewOf, r as queryRows, t as FunnelDiagnostics } from "./funnel-diagnostics-BpKYrMSu.js";
 import { t as ConnectorDiagnosticSqlReader } from "./diagnostic-sql-reader-CzYgZpq2.js";
 import { t as FunnelDoctor } from "./funnel-doctor-CApCezTq.js";
@@ -21,7 +21,7 @@ import { t as FunnelDocs } from "./funnel-docs-ng5K8w4j.js";
 import { a as FunnelLocalConfig, n as NodeFunnelTokenPrompter, r as FunnelLocalConfigSync, t as funnelJsonSchema } from "./local-config-json-schema-DE1zkMcb.js";
 import { t as FunnelProfiles } from "./profiles-MnXvYfZF.js";
 import { t as FunnelRecovery } from "./funnel-recovery-D9CxD5Zs.js";
-import { C as funnelTmpDir, S as publishResponseSchema, _ as funnelEventSchema, a as connectorConnectionEventSchema, b as FunnelChannelPublisher, c as MemoryFunnelEventLog, d as DEFAULT_GATEWAY_TOKEN_PATH, f as FunnelGatewayToken, g as FunnelEventLog, h as SqliteFunnelEventLog, i as ConnectorDiagnosticLog, l as channelWsProtocols, m as FunnelListenerSupervisor, n as SqliteConnectorDiagnosticLog, o as connectorProcessedEventSchema, p as FunnelGatewayServer, r as CONNECTOR_CONNECTION_STATUSES, s as connectorRawEventSchema, t as MemoryConnectorDiagnosticLog, u as channelWsUrl, v as FunnelBroadcaster, x as publishRequestSchema, y as requireBearerToken } from "./memory-diagnostic-log-5LzwJ_F7.js";
+import { C as funnelTmpDir, S as publishResponseSchema, _ as funnelEventSchema, a as connectorConnectionEventSchema, b as FunnelChannelPublisher, c as MemoryFunnelEventLog, d as DEFAULT_GATEWAY_TOKEN_PATH, f as FunnelGatewayToken, g as FunnelEventLog, h as SqliteFunnelEventLog, i as ConnectorDiagnosticLog, l as channelWsProtocols, m as FunnelListenerSupervisor, n as SqliteConnectorDiagnosticLog, o as connectorProcessedEventSchema, p as FunnelGatewayServer, r as CONNECTOR_CONNECTION_STATUSES, s as connectorRawEventSchema, t as MemoryConnectorDiagnosticLog, u as channelWsUrl, v as FunnelBroadcaster, x as publishRequestSchema, y as requireBearerToken } from "./memory-diagnostic-log-B9Us7X05.js";
 import { dirname, join, resolve } from "node:path";
 import { hc } from "hono/client";
 import { appendFileSync, existsSync, mkdirSync } from "node:fs";
@@ -29,7 +29,7 @@ import { z } from "zod";
 import { fileURLToPath } from "node:url";
 import { createFactory } from "hono/factory";
 import { HTTPException } from "hono/http-exception";
-import { zValidator } from "@hono/zod-validator";
+import { zValidator as zValidator$1 } from "@hono/zod-validator";
 import { Hono } from "hono";
 //#region lib/engine/connectors/connector-factory.ts
 const defaultFs$1 = new NodeFunnelFileSystem();
@@ -596,6 +596,7 @@ var MemoryFunnelProcessRunner = class extends FunnelProcessRunner {
 	syncHandler = () => empty;
 	aliveStub = null;
 	listStub = null;
+	startTimeStub = null;
 	on(handler) {
 		this.handler = handler;
 		return this;
@@ -612,6 +613,10 @@ var MemoryFunnelProcessRunner = class extends FunnelProcessRunner {
 		this.listStub = stub;
 		return this;
 	}
+	onGetStartTime(stub) {
+		this.startTimeStub = stub;
+		return this;
+	}
 	async run(command, options = {}) {
 		this.calls.push({
 			kind: "run",
@@ -681,6 +686,10 @@ var MemoryFunnelProcessRunner = class extends FunnelProcessRunner {
 		if (this.listStub) return this.listStub(marker);
 		return [];
 	}
+	getStartTime(pid) {
+		if (this.startTimeStub) return this.startTimeStub(pid);
+		return null;
+	}
 };
 //#endregion
 //#region lib/engine/settings/mock-settings-reader.ts
@@ -1469,19 +1478,19 @@ usage: funnel channels add <name> [--delivery fanout|exclusive]
 options:
   --delivery    routing mode (default fanout):
                   fanout      every connected client receives every event
-                  exclusive   each event delivered to exactly one client (round-robin)`;
+                  exclusive   each event delivered to exactly one client (round-robin)
+
+A channel is a named event stream. After creating it, add connectors
+(Slack, Discord, GitHub, schedule) to feed events into it, then connect
+Claude Code clients to consume them.
+
+examples:
+  funnel channels add production
+  funnel channels add ci-events --delivery exclusive
+
+see also: funnel channels, funnel channels <name> connectors add`;
 const channelsAddHelpHandler = factory.createHandlers((c) => c.text(help$17));
 //#endregion
-//#region lib/cli/router/validator.ts
-const zValidator$1 = (target, schema, helpText) => zValidator(target, schema, (result, c) => {
-	if (helpText && c.req.query("help")) return c.text(helpText);
-	if (result.success) return;
-	const issue = result.error.issues[0];
-	if (!issue) throw new HTTPException(400, { message: "invalid request" });
-	const path = issue.path.join(".");
-	throw new HTTPException(400, { message: path ? `${path}: ${issue.message}` : issue.message });
-});
-//#endregion
 //#region lib/cli/routes/channels.add.$channel.ts
 const channelsAddHandler = factory.createHandlers(zValidator$1("param", z.object({ channel: z.string() })), zValidator$1("query", z.object({ delivery: channelDeliveryModeSchema.optional() })), (c) => {
 	const param = c.req.valid("param");
@@ -1492,7 +1501,15 @@ const channelsAddHandler = factory.createHandlers(zValidator$1("param", z.object
 	});
 	return c.text(`added channel "${created.name}" (id: ${created.id})`);
 });
-const channelsConnectorsGroupHandler = factory.createHandlers(zValidator$1("param", z.object({ channel: z.string() })), zValidator$1("query", z.object({}), `funnel channels <channel> connectors — manage connectors in a channel
+//#endregion
+//#region lib/cli/router/help-guard.ts
+function helpGuard(help) {
+	return async (c, next) => {
+		if (c.req.query("help")) return c.text(help);
+		await next();
+	};
+}
+const channelsConnectorsGroupHandler = factory.createHandlers(zValidator$1("param", z.object({ channel: z.string() })), helpGuard(`funnel channels <channel> connectors — manage connectors in a channel
 
 usage: funnel channels <channel> connectors [subcommand]
 
@@ -1516,15 +1533,29 @@ subcommands:
 });
 //#endregion
 //#region lib/cli/routes/channels.$channel.connectors.add.ts
-const help$16 = `funnel channels <channel> connectors add <connector> — add a connector to a channel
+const help$16 = `funnel channels <channel> connectors add <name> — add a connector to a channel
 
 usage:
-  funnel channels <channel> connectors add <connector> --type=slack --bot-token=xoxb-... --app-token=xapp-...
-  funnel channels <channel> connectors add <connector> --type=gh [--poll-interval=60]
-  funnel channels <channel> connectors add <connector> --type=discord --bot-token=...
-  funnel channels <channel> connectors add <connector> --type=schedule
+  funnel channels <channel> connectors add <name> --type=slack --bot-token=xoxb-... --app-token=xapp-...
+  funnel channels <channel> connectors add <name> --type=gh [--poll-interval=60]
+  funnel channels <channel> connectors add <name> --type=discord --bot-token=...
+  funnel channels <channel> connectors add <name> --type=schedule
+
+connector types:
+  slack      Slack Socket Mode (requires bot-token + app-token)
+  gh         GitHub webhook polling
+  discord    Discord bot gateway
+  schedule   cron / one-shot timer (no external service)
+
+Token uniqueness is enforced across all channels — the same bot-token
+cannot appear in two connectors.
 
-Token uniqueness is enforced across all channels.`;
+examples:
+  funnel channels prod connectors add main-slack --type=slack --bot-token=xoxb-... --app-token=xapp-...
+  funnel channels ci connectors add gh-events --type=gh --poll-interval=30
+  funnel channels alerts connectors add daily --type=schedule
+
+see also: funnel channels <channel> connectors, funnel channels <channel> connectors remove`;
 const channelsConnectorsAddHelpHandler = factory.createHandlers((c) => c.text(help$16));
 //#endregion
 //#region lib/cli/routes/channels.$channel.connectors.add.$connector.ts
@@ -1595,7 +1626,16 @@ const channelsConnectorsAddHandler = factory.createHandlers(zValidator$1("param"
 //#region lib/cli/routes/channels.$channel.connectors.remove.ts
 const help$15 = `funnel channels <channel> connectors remove <connector> — remove a connector
 
-usage: funnel channels <channel> connectors remove <connector>`;
+usage: funnel channels <channel> connectors remove <connector>
+
+Removes the connector from the channel configuration. The gateway drops
+it on the next reload. No external resources (Slack apps, Discord bots,
+GitHub webhooks) are touched.
+
+examples:
+  funnel channels production connectors remove slack-main
+
+see also: funnel channels <channel> connectors, funnel channels <channel> connectors add`;
 const channelsConnectorsRemoveHelpHandler = factory.createHandlers((c) => c.text(help$15));
 //#endregion
 //#region lib/cli/routes/channels.$channel.connectors.remove.$connector.ts
@@ -1646,7 +1686,7 @@ const channelsConnectorsSetHandler = factory.createHandlers(zValidator$1("param"
 const channelsConnectorsShowHandler = factory.createHandlers(zValidator$1("param", z.object({
 	channel: z.string(),
 	connector: z.string()
-})), zValidator$1("query", z.object({}), `funnel channels <channel> connectors <connector> / show connector config
+})), helpGuard(`funnel channels <channel> connectors <connector> / show connector config
 
 subcommands:
   rename <new> / rename this connector
@@ -1661,9 +1701,18 @@ output / valid YAML`), (c) => {
 });
 //#endregion
 //#region lib/cli/routes/channels.$channel.connectors.rename.ts
-const help$13 = `funnel channels <channel> connectors rename <connector> <new-name>
+const help$13 = `funnel channels <channel> connectors rename <old> <new> — rename a connector
 
-usage: funnel channels <channel> connectors rename <connector> <new-name>`;
+usage: funnel channels <channel> connectors rename <old> <new>
+
+Renames the connector in the configuration file. Tokens, type, and
+schedules are preserved. The gateway picks up the new name on the
+next reload.
+
+examples:
+  funnel channels production connectors rename slack-1 slack-main
+
+see also: funnel channels <channel> connectors`;
 const channelsConnectorsRenameHelpHandler = factory.createHandlers((c) => c.text(help$13));
 //#endregion
 //#region lib/cli/routes/channels.$channel.connectors.$connector.rename.$newName.ts
@@ -1688,10 +1737,7 @@ const channelsConnectorRenameHelpHandler = factory.createHandlers((c) => c.text(
 const channelsConnectorsRequestHandler = factory.createHandlers(zValidator$1("param", z.object({
 	channel: z.string(),
 	connector: z.string()
-})), zValidator$1("query", z.object({
-	method: z.string(),
-	path: z.string().optional()
-}).passthrough(), `funnel channels <channel> connectors <connector> request / call a connector's outbound API
+})), helpGuard(`funnel channels <channel> connectors <connector> request / call a connector's outbound API
 
 usage / funnel channels <channel> connectors <connector> request --method=<m> [--path=<p>] [--key=value ...]
 
@@ -1699,7 +1745,10 @@ options:
   --method / slack: API method (e.g. chat.postMessage). gh/discord: HTTP verb (GET/POST/...).
   --path / gh/discord: endpoint (e.g. repos/o/r/issues). Omit for slack (defaults to --method).
 
-output / valid YAML (or raw text when the adapter returns text)`), async (c) => {
+output / valid YAML (or raw text when the adapter returns text)`), zValidator$1("query", z.object({
+	method: z.string(),
+	path: z.string().optional()
+}).passthrough()), async (c) => {
 	const param = c.req.valid("param");
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
@@ -1718,7 +1767,7 @@ output / valid YAML (or raw text when the adapter returns text)`), async (c) =>
 const channelsConnectorsSchedulesGroupHandler = factory.createHandlers(zValidator$1("param", z.object({
 	channel: z.string(),
 	connector: z.string()
-})), zValidator$1("query", z.object({}), `funnel channels <ch> connectors <conn> schedules — manage schedule entries
+})), helpGuard(`funnel channels <ch> connectors <conn> schedules — manage schedule entries
 
 usage: funnel channels <ch> connectors <conn> schedules [subcommand]
 
@@ -1815,9 +1864,18 @@ const channelsPublishHandler = factory.createHandlers(zValidator$1("param", z.ob
 });
 //#endregion
 //#region lib/cli/routes/channels.remove.ts
-const help$8 = `funnel channels remove — remove a channel
+const help$8 = `funnel channels remove — remove a channel and all its connectors
+
+usage: funnel channels remove <name>
 
-usage: funnel channels remove <name>`;
+The channel, its connectors, and their schedules are deleted from the
+configuration file. The gateway drops the channel on the next reload.
+No external resources (Slack apps, Discord bots, etc.) are touched.
+
+examples:
+  funnel channels remove staging
+
+see also: funnel channels, funnel channels add`;
 const channelsRemoveHelpHandler = factory.createHandlers((c) => c.text(help$8));
 //#endregion
 //#region lib/cli/routes/channels.remove.$channel.ts
@@ -1832,7 +1890,17 @@ const help$7 = `funnel channels rename — rename a channel
 
 usage:
   funnel channels rename <old> <new>
-  funnel channels <old> rename <new>`;
+  funnel channels <old> rename <new>
+
+Renames the channel in the configuration file. Connectors, schedules,
+and delivery mode are preserved. The gateway picks up the new name on
+the next reload.
+
+examples:
+  funnel channels rename staging production
+  funnel channels staging rename production
+
+see also: funnel channels, funnel channels <name>`;
 const channelsRenameHelpHandler = factory.createHandlers((c) => c.text(help$7));
 //#endregion
 //#region lib/cli/routes/channels.$channel.rename.ts
@@ -1852,10 +1920,7 @@ const channelsRenameHandler = factory.createHandlers(zValidator$1("param", z.obj
 	c.env.funnel.channels.rename(param.channel, param.newName);
 	return c.text(`renamed channel "${param.channel}" to "${param.newName}"`);
 });
-const channelsSetDeliveryHandler = factory.createHandlers(zValidator$1("param", z.object({
-	channel: z.string(),
-	mode: channelDeliveryModeSchema
-}), `funnel channels <name> set delivery <mode> — change a channel's routing mode
+const channelsSetDeliveryHandler = factory.createHandlers(helpGuard(`funnel channels <name> set delivery <mode> — change a channel's routing mode
 
 usage: funnel channels <name> set delivery fanout | exclusive
 
@@ -1863,12 +1928,15 @@ modes:
   fanout      every connected WS client receives every event (default)
   exclusive   each event is delivered to exactly one connected client (round-robin)
 
-`), (c) => {
+`), zValidator$1("param", z.object({
+	channel: z.string(),
+	mode: channelDeliveryModeSchema
+})), (c) => {
 	const param = c.req.valid("param");
 	c.env.funnel.channels.setDelivery(param.channel, param.mode);
 	return c.text(`channel "${param.channel}" delivery set to ${param.mode}`);
 });
-const channelsShowHandler = factory.createHandlers(zValidator$1("param", z.object({ channel: z.string() })), zValidator$1("query", z.object({}), `funnel channels <name> / show channel details
+const channelsShowHandler = factory.createHandlers(zValidator$1("param", z.object({ channel: z.string() })), helpGuard(`funnel channels <name> / show channel details
 
 subcommands:
   set delivery fanout|exclusive / change routing mode
@@ -1892,7 +1960,7 @@ output / valid YAML`), (c) => {
 		}))
 	}));
 });
-const channelsGroupHandler = factory.createHandlers(zValidator$1("query", z.object({}), `funnel channels / manage subscription boxes
+const channelsGroupHandler = factory.createHandlers(helpGuard(`funnel channels / manage subscription boxes
 
 usage / funnel channels [subcommand]
 
@@ -2057,10 +2125,10 @@ see also:
 
 programmable: funnel.claude.launch({ profileId | channelId, options, env, resume })`;
 const RESERVED_KEYS$1 = ["profile", "channel"];
-const claudeHandler = factory.createHandlers(zValidator$1("query", z.object({
+const claudeHandler = factory.createHandlers(helpGuard(claudeHelp), zValidator$1("query", z.object({
 	profile: z.string().optional(),
 	channel: z.string().optional()
-}).passthrough(), claudeHelp), async (c) => {
+}).passthrough()), async (c) => {
 	const query = c.req.valid("query");
 	const { funnel, claude, profiles, localConfig, localConfigSync } = c.env;
 	const userArgs = queryToCliArgs(c.req.url, RESERVED_KEYS$1);
@@ -2204,7 +2272,7 @@ const resolveTargetChannel = (c, channelArg) => {
 		}
 	};
 };
-const debugHandler = factory.createHandlers(zValidator$1("query", z.object({
+const debugHandler = factory.createHandlers(helpGuard(debugHelp), zValidator$1("query", z.object({
 	channel: z.string().optional(),
 	all: z.enum([
 		"true",
@@ -2212,7 +2280,7 @@ const debugHandler = factory.createHandlers(zValidator$1("query", z.object({
 		""
 	]).optional(),
 	limit: z.string().optional()
-}), debugHelp), async (c) => {
+})), async (c) => {
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
 	if (query.all === "true" || query.all === "") {
@@ -2242,7 +2310,7 @@ const debugHandler = factory.createHandlers(zValidator$1("query", z.object({
 	if (!report) return c.text(renderYaml({ error: "channel not resolvable" }));
 	return c.text(renderYaml(report));
 });
-const debugEventsHandler = factory.createHandlers(zValidator$1("query", channelLimitQuery, debugEventsHelp), async (c) => {
+const debugEventsHandler = factory.createHandlers(helpGuard(debugEventsHelp), zValidator$1("query", channelLimitQuery), async (c) => {
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
 	const limit = query.limit ? Math.max(1, Number(query.limit)) : 20;
@@ -2251,7 +2319,7 @@ const debugEventsHandler = factory.createHandlers(zValidator$1("query", channelL
 	const events = await funnel.diagnostics.recentEvents(resolved.name, limit);
 	return c.text(renderYaml({ events }));
 });
-const debugDroppedHandler = factory.createHandlers(zValidator$1("query", channelLimitQuery, debugDroppedHelp), async (c) => {
+const debugDroppedHandler = factory.createHandlers(helpGuard(debugDroppedHelp), zValidator$1("query", channelLimitQuery), async (c) => {
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
 	const limit = query.limit ? Math.max(1, Number(query.limit)) : 20;
@@ -2260,7 +2328,7 @@ const debugDroppedHandler = factory.createHandlers(zValidator$1("query", channel
 	const events = await funnel.diagnostics.droppedEvents(resolved.name, limit);
 	return c.text(renderYaml({ dropped: events }));
 });
-const debugErrorsHandler = factory.createHandlers(zValidator$1("query", channelLimitQuery, debugErrorsHelp), async (c) => {
+const debugErrorsHandler = factory.createHandlers(helpGuard(debugErrorsHelp), zValidator$1("query", channelLimitQuery), async (c) => {
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
 	const limit = query.limit ? Math.max(1, Number(query.limit)) : 20;
@@ -2269,10 +2337,10 @@ const debugErrorsHandler = factory.createHandlers(zValidator$1("query", channelL
 	const errors = await funnel.diagnostics.connectionErrors(resolved.name, limit);
 	return c.text(renderYaml({ errors }));
 });
-const debugReplayHandler = factory.createHandlers(zValidator$1("query", z.object({
+const debugReplayHandler = factory.createHandlers(helpGuard(debugReplayHelp), zValidator$1("query", z.object({
 	channel: z.string().optional(),
 	seq: z.string().optional()
-}), debugReplayHelp), async (c) => {
+})), async (c) => {
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
 	const resolved = resolveTargetChannel(c, query.channel);
@@ -2282,7 +2350,7 @@ const debugReplayHandler = factory.createHandlers(zValidator$1("query", z.object
 	const result = await funnel.diagnostics.replay(resolved.name, seq);
 	return c.text(renderYaml(result));
 });
-const docsIndexHandler = factory.createHandlers(zValidator$1("query", z.object({}), `funnel docs / embedded documentation
+const docsIndexHandler = factory.createHandlers(helpGuard(`funnel docs / embedded documentation
 
 usage / funnel docs [topic]
 
@@ -2309,18 +2377,7 @@ const docsTopicHandler = factory.createHandlers(zValidator$1("param", z.object({
 	}));
 	return c.text(text);
 });
-const doctorHandler = factory.createHandlers(zValidator$1("query", z.object({
-	fix: z.enum([
-		"true",
-		"false",
-		""
-	]).optional(),
-	aggressive: z.enum([
-		"true",
-		"false",
-		""
-	]).optional()
-}), `funnel doctor / diagnose every channel; --fix applies safe self-healing
+const doctorHandler = factory.createHandlers(helpGuard(`funnel doctor / diagnose every channel; --fix applies safe self-healing
 
 usage / funnel doctor [--fix] [--aggressive]
 
@@ -2336,7 +2393,18 @@ programmable / await funnel.doctor.run() / await funnel.doctor.run("safe") / awa
 examples:
   funnel doctor
   funnel doctor --fix
-  funnel doctor --fix --aggressive`), async (c) => {
+  funnel doctor --fix --aggressive`), zValidator$1("query", z.object({
+	fix: z.enum([
+		"true",
+		"false",
+		""
+	]).optional(),
+	aggressive: z.enum([
+		"true",
+		"false",
+		""
+	]).optional()
+})), async (c) => {
 	const query = c.req.valid("query");
 	const wantsFix = query.fix === "true" || query.fix === "";
 	const wantsAggressive = query.aggressive === "true" || query.aggressive === "";
@@ -2407,8 +2475,8 @@ const renderGatewayStatus = async (c) => {
 		}))
 	}));
 };
-const gatewayGroupHandler = factory.createHandlers(zValidator$1("query", z.object({}), groupHelp$1), renderGatewayStatus);
-const gatewayListenersHandler = factory.createHandlers(zValidator$1("query", z.object({}), `funnel gateway listeners / show running connector listeners
+const gatewayGroupHandler = factory.createHandlers(helpGuard(groupHelp$1), renderGatewayStatus);
+const gatewayListenersHandler = factory.createHandlers(helpGuard(`funnel gateway listeners / show running connector listeners
 
 usage / funnel gateway listeners
 
@@ -2477,10 +2545,10 @@ const formatMeta = (meta) => {
 const formatPlain = (entry) => {
 	return `${entry.time.slice(11, 19)} ${entry.level.toUpperCase().padEnd(5)} ${entry.message.padEnd(30)}${formatMeta(entry.meta)}\n`;
 };
-const gatewayLogsHandler = factory.createHandlers(zValidator$1("query", z.object({
+const gatewayLogsHandler = factory.createHandlers(helpGuard(logsHelp), zValidator$1("query", z.object({
 	n: z.string().optional(),
 	format: z.enum(["plain", "json"]).optional()
-}), logsHelp), async (c) => {
+})), async (c) => {
 	const query = c.req.valid("query");
 	const path = logger.file;
 	if (!path || !existsSync(path)) return c.text("no logs");
@@ -2585,12 +2653,12 @@ programmable: const reader = new ConnectorDiagnosticSqlReader({ rawPath, process
               reader.query("SELECT …")
               — but for most cases, funnel.diagnostics.recentEvents() / .droppedEvents()
               / .connectionErrors() are higher level and don't need SQL.`;
-const gatewaySqlHandler = factory.createHandlers(zValidator$1("query", z.object({
+const gatewaySqlHandler = factory.createHandlers(helpGuard(sqlHelp), zValidator$1("query", z.object({
 	query: z.string().optional(),
 	preset: z.enum(Object.keys(PRESETS)).optional(),
 	channel: z.string().optional(),
 	limit: z.string().optional()
-}), sqlHelp), async (c) => {
+})), async (c) => {
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
 	let sql = null;
@@ -2629,7 +2697,7 @@ const gatewaySqlHandler = factory.createHandlers(zValidator$1("query", z.object(
 	if (rows instanceof Error) return c.text(renderYaml({ error: rows.message }));
 	return c.text(renderYaml({ rows }));
 });
-const gatewayRestartHandler = factory.createHandlers(zValidator$1("query", z.object({ "no-caffeine": z.string().optional() }), `funnel gateway restart — restart the gateway
+const gatewayRestartHandler = factory.createHandlers(helpGuard(`funnel gateway restart — restart the gateway
 
 usage: funnel gateway restart [--no-caffeine]
 
@@ -2641,7 +2709,7 @@ examples:
   funnel gateway restart --no-caffeine
 
 programmable: funnel.gateway.restart({ caffeinate })
-              funnel.recovery.restartGateway()`), async (c) => {
+              funnel.recovery.restartGateway()`), zValidator$1("query", z.object({ "no-caffeine": z.string().optional() })), async (c) => {
 	const query = c.req.valid("query");
 	const result = await c.env.funnel.gateway.restart({ caffeinate: query["no-caffeine"] !== "true" });
 	const lines = [];
@@ -2651,7 +2719,7 @@ programmable: funnel.gateway.restart({ caffeinate })
 	if (!result.ok) throw new HTTPException(500, { message: body });
 	return c.text(body);
 });
-const gatewayRunHandler = factory.createHandlers(zValidator$1("query", z.object({ "no-caffeine": z.string().optional() }), `funnel gateway run — run the gateway in foreground
+const gatewayRunHandler = factory.createHandlers(helpGuard(`funnel gateway run — run the gateway in foreground
 
 usage: funnel gateway run [--no-caffeine]
 
@@ -2664,7 +2732,7 @@ examples:
   funnel gateway run
   funnel gateway run --no-caffeine
 
-programmable: funnel.runGatewayForeground({ caffeinate })`), async (c) => {
+programmable: funnel.runGatewayForeground({ caffeinate })`), zValidator$1("query", z.object({ "no-caffeine": z.string().optional() })), async (c) => {
 	const query = c.req.valid("query");
 	const exitCode = await c.env.funnel.runGatewayForeground({ caffeinate: query["no-caffeine"] !== "true" });
 	process.exit(exitCode);
@@ -2688,7 +2756,7 @@ examples:
   funnel gateway start --no-caffeine
 
 programmable: funnel.gateway.start({ caffeinate })`;
-const gatewayStartHandler = factory.createHandlers(zValidator$1("query", z.object({ "no-caffeine": z.string().optional() }), startHelp), async (c) => {
+const gatewayStartHandler = factory.createHandlers(helpGuard(startHelp), zValidator$1("query", z.object({ "no-caffeine": z.string().optional() })), async (c) => {
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
 	if (funnel.gateway.isRunning()) {
@@ -2698,14 +2766,14 @@ const gatewayStartHandler = factory.createHandlers(zValidator$1("query", z.objec
 	if (!await funnel.gateway.start({ caffeinate: query["no-caffeine"] !== "true" })) throw new HTTPException(500, { message: "funnel gateway: failed to start" });
 	return c.text("funnel gateway: started");
 });
-const gatewayStatusHandler = factory.createHandlers(zValidator$1("query", z.object({}), `funnel gateway status / show gateway running status
+const gatewayStatusHandler = factory.createHandlers(helpGuard(`funnel gateway status / show gateway running status
 
 usage / funnel gateway status
 
 output / valid YAML
 
 programmable / funnel.gateway.getStatus()`), async (c) => renderGatewayStatus(c));
-const gatewayStopHandler = factory.createHandlers(zValidator$1("query", z.object({}), `funnel gateway stop — stop the gateway
+const gatewayStopHandler = factory.createHandlers(helpGuard(`funnel gateway stop — stop the gateway
 
 usage: funnel gateway stop
 
@@ -2798,7 +2866,7 @@ const profilesAddHandler = factory.createHandlers(zValidator$1("param", z.object
 	});
 	return c.text(`added profile "${param.profile}"`);
 });
-const profilesAsDefaultHandler = factory.createHandlers(zValidator$1("param", z.object({ profile: z.string() })), zValidator$1("query", z.object({}), `funnel profiles <name> as-default — move profile to the front of the list
+const profilesAsDefaultHandler = factory.createHandlers(zValidator$1("param", z.object({ profile: z.string() })), helpGuard(`funnel profiles <name> as-default — move profile to the front of the list
 
 usage: funnel profiles <name> as-default
 
@@ -2844,7 +2912,7 @@ const launchHelp = `funnel profiles <name> run — launch a profile (sugar for f
 usage: funnel profiles <name> run [additional claude args...]
        funnel profiles <name>     (alias)`;
 const RESERVED_KEYS = [];
-const profilesLaunchHandler = factory.createHandlers(zValidator$1("param", z.object({ profile: z.string() })), zValidator$1("query", z.object({}).passthrough(), launchHelp), async (c) => {
+const profilesLaunchHandler = factory.createHandlers(zValidator$1("param", z.object({ profile: z.string() })), helpGuard(launchHelp), zValidator$1("query", z.object({}).passthrough()), async (c) => {
 	const param = c.req.valid("param");
 	c.env.funnel;
 	const { profiles, claude } = c.env;
@@ -2920,7 +2988,7 @@ const profilesSetHandler = factory.createHandlers(zValidator$1("param", z.object
 	});
 	return c.text(`updated profile "${param.profile}"`);
 });
-const profilesGroupHandler = factory.createHandlers(zValidator$1("query", z.object({}), `funnel profiles / manage launch profiles
+const profilesGroupHandler = factory.createHandlers(helpGuard(`funnel profiles / manage launch profiles
 
 usage / funnel profiles [subcommand]
 
@@ -2957,7 +3025,7 @@ examples:
 		resume: profile.resume
 	})) }));
 });
-const schemaHandler = factory.createHandlers(zValidator$1("query", z.object({}), `funnel schema — print the JSON Schema for funnel.json
+const schemaHandler = factory.createHandlers(helpGuard(`funnel schema — print the JSON Schema for funnel.json
 
 usage: funnel schema
 
@@ -3056,14 +3124,14 @@ const buildStatusReport = async (funnel, profiles) => {
 		})
 	};
 };
-const statusHandler = factory.createHandlers(zValidator$1("query", z.object({
+const statusHandler = factory.createHandlers(helpGuard(statusHelp), zValidator$1("query", z.object({
 	watch: z.enum([
 		"true",
 		"false",
 		""
 	]).optional(),
 	interval: z.string().optional()
-}), statusHelp), async (c) => {
+})), async (c) => {
 	const query = c.req.valid("query");
 	const funnel = c.env.funnel;
 	const isWatch = query.watch === "true" || query.watch === "";
@@ -3100,7 +3168,7 @@ Runs "bun i -g @interactive-inc/claude-funnel".
 This command has no programmable equivalent — package management belongs to
 the host (npm / bun / yarn install in the host's own way).`;
 const PACKAGE = "@interactive-inc/claude-funnel";
-const updateHandler = factory.createHandlers(zValidator$1("query", z.object({}), updateHelp), async (c) => {
+const updateHandler = factory.createHandlers(helpGuard(updateHelp), async (c) => {
 	const exitCode = await new NodeFunnelProcessRunner().attach([
 		"bun",
 		"i",

package/dist/{local-config-sync--f739oCJ.d.ts → local-config-sync-BGPAS9Be.d.ts}

@@ -1,7 +1,7 @@
 import { n as ChannelDeliveryMode, t as ChannelConfig } from "./settings-schema-1hh11jnN.js";
 import { n as FunnelIdGenerator, t as FunnelSettingsReader } from "./settings-reader-DPwqOVUm.js";
 import { S as FunnelLogger, b as FunnelConnectorListener, o as ConnectorDiagnosticLog } from "./diagnostic-log-Cb3v8P7p.js";
-import { r as FunnelProcessRunner } from "./process-runner-Cx5O_fTf.js";
+import { r as FunnelProcessRunner } from "./process-runner-DIm1cy95.js";
 import { n as FunnelFileSystem } from "./file-system-DxpnnUVb.js";
 import { n as FunnelConnectorAdapter, t as CallInput } from "./connector-adapter-DGacCppE.js";
 import { a as ScheduleEntry, n as ScheduleOnFired } from "./schedule-listener-DoMPjHZj.js";