feat(ql3): establish 3.0 incubation baseline

2026-09-20 16:07:11 +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,92 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+class QingLong3ServiceBridgeImportAuditError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'QingLong3ServiceBridgeImportAuditError';
+  }
+}
+
+function main() {
+  const root = path.resolve(__dirname, '..');
+  const packageRoot = path.join(root, 'packages/ql3-local-owner-cli');
+  const manifest = JSON.parse(
+    fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'),
+  );
+  const expectedBin = 'dist/deployment/service-manager/serviceBridgeCli.js';
+  if (manifest.bin?.['ql3-service-bridge'] !== expectedBin) {
+    throw new QingLong3ServiceBridgeImportAuditError(
+      'ql3-service-bridge binary entry drifted',
+    );
+  }
+  const entry = path.join(
+    packageRoot,
+    'dist/deployment/service-manager/serviceBridge.js',
+  );
+  if (!fs.existsSync(entry)) {
+    throw new QingLong3ServiceBridgeImportAuditError(
+      'service bridge must be built before import audit',
+    );
+  }
+  require(entry);
+  const loaded = Object.keys(require.cache)
+    .map((filePath) => path.resolve(filePath))
+    .filter(
+      (filePath) =>
+        filePath.startsWith(path.join(root, 'packages') + path.sep) &&
+        filePath.endsWith('.js'),
+    )
+    .map((filePath) => path.relative(root, filePath))
+    .sort();
+  const findings = [];
+  for (const file of loaded) {
+    const allowed =
+      file.startsWith(
+        'packages/ql3-local-owner-cli/dist/deployment/service-manager/',
+      ) ||
+      file ===
+        'packages/ql3-local-owner-cli/dist/deployment/foundation/contract.js' ||
+      file.startsWith('packages/ql3-local-command-file/dist/');
+    if (!allowed) findings.push({ code: 'FORBIDDEN_BRIDGE_IMPORT', file });
+  }
+  const source = fs.readFileSync(
+    path.join(
+      packageRoot,
+      'src/deployment/service-manager/serviceBridgeCli.ts',
+    ),
+    'utf8',
+  );
+  if (!source.includes("from './serviceBridge'")) {
+    findings.push({
+      code: 'BRIDGE_CLI_ENTRY_DRIFT',
+      file: 'packages/ql3-local-owner-cli/src/deployment/service-manager/serviceBridgeCli.ts',
+    });
+  }
+  const report = {
+    schemaVersion: 1,
+    compatible: findings.length === 0,
+    binary: expectedBin,
+    loaded,
+    findings,
+  };
+  process.stdout.write(`${JSON.stringify(report)}\n`);
+  if (findings.length > 0) process.exitCode = 1;
+}
+
+try {
+  main();
+} catch (error) {
+  process.stderr.write(
+    `${JSON.stringify({
+      code: 'QL3_SERVICE_BRIDGE_IMPORT_AUDIT_FAILED',
+      name: error?.name ?? 'Error',
+      message: error?.message ?? 'service bridge import audit failed',
+    })}\n`,
+  );
+  process.exitCode = 1;
+}