feat(cli): cover OpenAPI with a remote npm CLI and internal panel tools (#3074)

* feat(cli): add unified Commander CLI for QingLong 2.x * fix(cli): publish via npm and address security review feedback * ci(cli): package npm artifacts and remove evaluation collateral * test(cli): use a fixed shell fixture for log retention * refactor(cli): separate remote npm client from panel tools * feat(cli): cover active panel OpenAPI resources * docs(cli): unify authentication and skill guidance * refactor(cli): isolate internal commands and generate Commander help * refactor(cli): organize remote and internal modules by responsibility * ci(cli): publish verified npm archives from master * fix(cli): publish under the whyour npm scope * ci: use npm trusted publishing for both packages * docs: introduce the published CLI on the project homepage * fix(cli): preserve server log truncation and correct login hints * fix(cli): accept dashboard record request bodies * fix(cli): preserve stdin for local task execution * fix(cli): resolve task executables after changing directory * fix(cli): preserve shell function tasks and sanitize test failures * fix(cli): preserve shell hook state and resolve workdir after hooks * fix(cli): preserve cleanup across shared shell task timeouts * fix(cli): isolate shell control descriptors and reap timed-out descendants
2026-10-01 05:13:50 +08:00 · 2026-09-25 23:24:41 +08:00
parent f051135fc4
commit 801a71d740
185 changed files with 22412 additions and 6 deletions
@@ -0,0 +1,98 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs/promises');
+const os = require('node:os');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const { sourceEnvironment } = require('../../dist/internal/runtime/context');
+
+test('all local entrypoints report missing, relative and non-directory roots before doing work', async (t) => {
+  const base = await fs.mkdtemp(
+    path.join(os.tmpdir(), 'ql-context-diagnostics-'),
+  );
+  t.after(() => fs.rm(base, { recursive: true, force: true }));
+  const file = path.join(base, 'file');
+  await fs.writeFile(file, 'unchanged');
+  for (const [entry, args] of [
+    ['admin', ['extra', '--json']],
+    ['startup', ['--json']],
+    ['runner', ['--json', 'sample.js']],
+    ['compat', ['extra']],
+    ['subscription-worker', ['raw', 'https://example.invalid/script.js']],
+  ]) {
+    for (const root of [
+      '',
+      'relative-root',
+      path.join(base, 'missing'),
+      file,
+    ]) {
+      for (const language of ['zh', 'en']) {
+        const child = spawnSync(
+          process.execPath,
+          [path.resolve(__dirname, `../../dist/${entry}.js`), ...args],
+          {
+            env: {
+              ...process.env,
+              QL_LANG: language,
+              QL_DIR: root,
+              QL_DATA_DIR: '',
+              SUB_ID: '',
+            },
+            encoding: 'utf8',
+            timeout: 5000,
+          },
+        );
+        assert.equal(child.status, 2, `${entry}: ${child.stderr}`);
+        assert.equal(child.stdout, '');
+        const error = JSON.parse(child.stderr);
+        assert.equal(error.code, 2);
+        assert.match(
+          error.message,
+          path.isAbsolute(root)
+            ? language === 'en'
+              ? /Panel root does not exist/
+              : /面板安装目录不存在或不是目录/
+            : language === 'en'
+            ? /absolute --root or QL_DIR/
+            : /--root 或 QL_DIR 指定绝对路径/,
+        );
+      }
+    }
+  }
+  assert.equal(await fs.readFile(file, 'utf8'), 'unchanged');
+  assert.deepEqual(await fs.readdir(base), ['file']);
+});
+
+test('configuration bridge localizes execution, invalid-data and cancellation errors without changing their types', async () => {
+  for (const language of ['zh', 'en']) {
+    const env = { PATH: process.env.PATH, QL_LANG: language };
+    for (const [command, chinese, english] of [
+      ['exit 7', /用户配置加载失败/, /User configuration evaluation failed/],
+      ['exit 0', /无效的环境数据/, /invalid environment data/],
+    ]) {
+      await assert.rejects(
+        sourceEnvironment(env, [], [], { command }),
+        (error) => {
+          assert.equal(error.name, 'Error');
+          assert.match(error.message, language === 'en' ? english : chinese);
+          return true;
+        },
+      );
+    }
+    const controller = new AbortController();
+    const execution = sourceEnvironment(env, [], [], {
+      command: 'printf ready; sleep 30',
+      signal: controller.signal,
+      output: () => controller.abort(),
+    });
+    await assert.rejects(execution, (error) => {
+      assert.equal(error.name, 'AbortError');
+      assert.equal(error.code, 'ABORT_ERR');
+      assert.match(
+        error.message,
+        language === 'en' ? /evaluation cancelled/ : /用户配置加载已取消/,
+      );
+      return true;
+    });
+  }
+});