refactor: extract cli command runtime wiring

src/main/runtime/cli-command-runtime-handler.test.ts

@@ -0,0 +1,33 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { createCliCommandRuntimeHandler } from './cli-command-runtime-handler';
+
+test('cli command runtime handler applies precheck and forwards command with context', () => {
+  const calls: string[] = [];
+  const handler = createCliCommandRuntimeHandler({
+    handleTexthookerOnlyModeTransitionMainDeps: {
+      isTexthookerOnlyMode: () => true,
+      setTexthookerOnlyMode: () => calls.push('set-mode'),
+      commandNeedsOverlayRuntime: () => true,
+      startBackgroundWarmups: () => calls.push('warmups'),
+      logInfo: (message) => calls.push(`log:${message}`),
+    },
+    createCliCommandContext: () => {
+      calls.push('context');
+      return { id: 'ctx' };
+    },
+    handleCliCommandRuntimeServiceWithContext: (_args, source, context) => {
+      calls.push(`cli:${source}:${context.id}`);
+    },
+  });
+
+  handler({ start: true } as never);
+
+  assert.deepEqual(calls, [
+    'set-mode',
+    'log:Disabling texthooker-only mode after overlay/start command.',
+    'warmups',
+    'context',
+    'cli:initial:ctx',
+  ]);
+});

src/main/runtime/cli-command-runtime-handler.ts

@@ -0,0 +1,30 @@
+import type { CliArgs, CliCommandSource } from '../../cli/args';
+import { createHandleTexthookerOnlyModeTransitionHandler } from './cli-command-prechecks';
+import { createBuildHandleTexthookerOnlyModeTransitionMainDepsHandler } from './cli-command-prechecks-main-deps';
+
+type HandleTexthookerOnlyModeTransitionMainDeps = Parameters<
+  typeof createBuildHandleTexthookerOnlyModeTransitionMainDepsHandler
+>[0];
+
+export function createCliCommandRuntimeHandler<TCliContext>(deps: {
+  handleTexthookerOnlyModeTransitionMainDeps: HandleTexthookerOnlyModeTransitionMainDeps;
+  createCliCommandContext: () => TCliContext;
+  handleCliCommandRuntimeServiceWithContext: (
+    args: CliArgs,
+    source: CliCommandSource,
+    cliContext: TCliContext,
+  ) => void;
+}) {
+  const handleTexthookerOnlyModeTransitionHandler =
+    createHandleTexthookerOnlyModeTransitionHandler(
+      createBuildHandleTexthookerOnlyModeTransitionMainDepsHandler(
+        deps.handleTexthookerOnlyModeTransitionMainDeps,
+      )(),
+    );
+
+  return (args: CliArgs, source: CliCommandSource = 'initial'): void => {
+    handleTexthookerOnlyModeTransitionHandler(args);
+    const cliContext = deps.createCliCommandContext();
+    deps.handleCliCommandRuntimeServiceWithContext(args, source, cliContext);
+  };
+}