feat(ql3): establish 3.0 incubation baseline

2026-09-22 10:32:40 +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,83 @@
+#!/usr/bin/env node
+
+import type {
+  LocalApplicationProcessSignal,
+  LocalApplicationProcessSignalSource,
+} from '@qinglong/local-application/process';
+
+import { runProductionLocalApiProcess } from './production-process/processApplication';
+
+const USAGE = 'Usage: ql3-local-api --config /absolute/private-config.json';
+
+const nodeSignals: LocalApplicationProcessSignalSource = Object.freeze({
+  subscribe(
+    listener: (signal: LocalApplicationProcessSignal) => void,
+  ): () => void {
+    const handlers = Object.freeze({
+      SIGINT: () => listener('SIGINT' as const),
+      SIGTERM: () => listener('SIGTERM' as const),
+    });
+    process.on('SIGINT', handlers.SIGINT);
+    process.on('SIGTERM', handlers.SIGTERM);
+    return () => {
+      process.off('SIGINT', handlers.SIGINT);
+      process.off('SIGTERM', handlers.SIGTERM);
+    };
+  },
+});
+
+function configFileArgument(argv: readonly string[]): string | null {
+  return argv.length === 2 && argv[0] === '--config' && argv[1]
+    ? argv[1]
+    : null;
+}
+
+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-api',
+    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 }
+      : {}),
+  });
+}
+
+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) {
+    process.stderr.write(
+      `${JSON.stringify({
+        code: 'QL3_LOCAL_API_CLI_USAGE_INVALID',
+        message: USAGE,
+      })}\n`,
+    );
+    process.exitCode = 64;
+    return;
+  }
+  try {
+    const stopResult = await runProductionLocalApiProcess({
+      configFilePath,
+      signals: nodeSignals,
+      emit(event) {
+        process.stdout.write(`${JSON.stringify(event)}\n`);
+      },
+    });
+    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));