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-09-28 09:02:12 +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,62 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const { parse } = require('../helpers/commands.cjs');
+const {
+  commands,
+  globalOptions,
+  localOptions,
+} = require('../helpers/commands.cjs');
+const { runnerOptions } = require('../../dist/internal/execution/definition');
+const { standaloneHelp } = require('../../dist/internal/help/standalone');
+const { spawnSync } = require('node:child_process');
+const path = require('node:path');
+
+test('every registered command and option is discoverable in both help languages', () => {
+  const previous = process.env.QL_LANG;
+  try {
+    for (const language of ['zh', 'en']) {
+      process.env.QL_LANG = language;
+      for (const surface of ['public', 'local']) {
+        const root = parse(['--help'], surface).help;
+        for (const spec of commands.filter((spec) =>
+          surface === 'local' ? spec.local : !spec.local,
+        )) {
+          assert.ok(
+            root.includes(surface === 'local' ? spec.name.slice(6) : spec.name),
+            spec.name,
+          );
+          const help = parse([...spec.name.split(' '), '--help'], surface).help;
+          for (const name of Object.keys({
+            ...globalOptions,
+            ...(spec.local ? localOptions : {}),
+            ...spec.options,
+          }))
+            assert.ok(help.includes(`--${name}`), `${spec.name}: ${name}`);
+        }
+      }
+      const runner = standaloneHelp('runner', { QL_LANG: language });
+      for (const name of Object.keys(runnerOptions))
+        assert.ok(runner.includes(`--${name}`), name);
+      const internal = spawnSync(
+        process.execPath,
+        [path.resolve(__dirname, '../../dist/ql.js'), '--help', '--json'],
+        {
+          env: { PATH: process.env.PATH, QL_LANG: language },
+          encoding: 'utf8',
+          timeout: 10000,
+        },
+      );
+      assert.equal(internal.status, 0, internal.stderr);
+      const help = JSON.parse(internal.stdout).data.help;
+      for (const spec of commands.filter((spec) => spec.local))
+        assert.ok(help.includes(spec.name.slice(6)), spec.name);
+      assert.doesNotMatch(
+        help,
+        /auth login|task run|subscription list|app list/,
+      );
+    }
+  } finally {
+    if (previous === undefined) delete process.env.QL_LANG;
+    else process.env.QL_LANG = previous;
+  }
+});