feat(ql3): establish 3.0 incubation baseline

2026-09-22 02:27:44 +08:00 · 2026-08-12 00:25:26 +08:00
parent 4bf92dcfeb
commit c699c32461
2817 changed files with 779642 additions and 653 deletions
@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+import {
+  runProductionLocalApplicationProcess,
+  type LocalApplicationProcessEvent,
+  type LocalApplicationProcessSignal,
+  type LocalApplicationProcessSignalSource,
+} from './production-process/processApplication';
+
+const USAGE =
+  'Usage: ql3-local-application --config /absolute/private-config.json';
+
+const nodeSignals: LocalApplicationProcessSignalSource = Object.freeze({
+  subscribe(
+    listener: (signal: LocalApplicationProcessSignal) => void,
+  ): () => void {
+    const handlers: Readonly<
+      Record<LocalApplicationProcessSignal, () => void>
+    > = Object.freeze({
+      SIGINT: () => listener('SIGINT'),
+      SIGTERM: () => listener('SIGTERM'),
+    });
+    process.on('SIGINT', handlers.SIGINT);
+    process.on('SIGTERM', handlers.SIGTERM);
+    return () => {
+      process.off('SIGINT', handlers.SIGINT);
+      process.off('SIGTERM', handlers.SIGTERM);
+    };
+  },
+});
+
+function emit(record: Readonly<LocalApplicationProcessEvent>): void {
+  process.stdout.write(`${JSON.stringify(record)}\n`);
+}
+
+function failureFact(error: unknown): Readonly<Record<string, unknown>> {
+  const candidate = error as {
+    readonly name?: unknown;
+    readonly code?: unknown;
+  };
+  return Object.freeze({
+    schemaVersion: 1,
+    component: 'qinglong3-local-application',
+    level: 'error',
+    event: 'process_failed',
+    name:
+      typeof candidate?.name === 'string' && candidate.name.length <= 128
+        ? candidate.name
+        : 'Error',
+    ...(typeof candidate?.code === 'string' && candidate.code.length <= 128
+      ? { code: candidate.code }
+      : {}),
+  });
+}
+
+function configFileArgument(argv: readonly string[]): string | null {
+  if (argv.length !== 2 || argv[0] !== '--config' || !argv[1]) return null;
+  return argv[1];
+}
+
+async function main(argv: readonly string[]): Promise<void> {
+  if (argv.length === 1 && (argv[0] === '--help' || argv[0] === '-h')) {
+    process.stdout.write(`${USAGE}\n`);
+    return;
+  }
+  const configFilePath = configFileArgument(argv);
+  if (configFilePath === null) {
+    process.stderr.write(
+      `${JSON.stringify({
+        code: 'QL3_LOCAL_APPLICATION_CLI_USAGE_INVALID',
+        message: USAGE,
+      })}\n`,
+    );
+    process.exitCode = 64;
+    return;
+  }
+  try {
+    const stopResult = await runProductionLocalApplicationProcess({
+      configFilePath,
+      signals: nodeSignals,
+      emit,
+    });
+    if (stopResult !== 'stopped') process.exitCode = 1;
+  } catch (error) {
+    process.stderr.write(`${JSON.stringify(failureFact(error))}\n`);
+    process.exitCode = 1;
+  }
+}
+
+void main(process.argv.slice(2));