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,57 @@
+const fs = require('node:fs/promises');
+const path = require('node:path');
+
+// Test-only reversible switch; callers must first reject initialized panels.
+exports.installEvaluationEntrypoints =
+  async function installEvaluationEntrypoints() {
+    if (process.env.QL_PANEL_INTEGRATION !== '1')
+      throw new Error('Disposable panel required');
+    const changed = [];
+    const restore = async () => {
+      for (const entry of changed.reverse()) {
+        await fs.rm(entry.target, { force: true });
+        await fs.rename(entry.backup, entry.target);
+      }
+    };
+    try {
+      for (const [name, moduleName, entry] of [
+        ['task', 'task', 'taskMain'],
+        ['ql', 'ql', 'qlMain'],
+      ]) {
+        const target = path.join(require('node:os').homedir(), 'bin', name);
+        const backup = `${target}.shell-evaluation-backup`;
+        const stat = await fs.lstat(target);
+        if (!stat.isSymbolicLink())
+          throw new Error(`Expected original symlink: ${name}`);
+        await fs.access(backup).then(
+          () => {
+            throw new Error('Backup already exists');
+          },
+          (error) => {
+            if (error.code !== 'ENOENT') throw error;
+          },
+        );
+        await fs.rename(target, backup);
+        changed.push({ target, backup });
+        const modulePath = path.resolve(__dirname, '../../dist', moduleName);
+        await fs.writeFile(
+          target,
+          `#!${process.execPath}\nrequire(${JSON.stringify(
+            modulePath,
+          )}).${entry}().then(code => {process.exitCode = code;});\n`,
+          { mode: 0o755, flag: 'wx' },
+        );
+      }
+      if (process.env.QL_PANEL_LOADER === '1') {
+        const target = '/ql/static/build/loaders/deps.js';
+        const backup = `${target}.shell-evaluation-backup`;
+        await fs.rename(target, backup);
+        changed.push({ target, backup });
+        await fs.copyFile('/candidate/deps.js', target);
+      }
+      return restore;
+    } catch (error) {
+      await restore();
+      throw error;
+    }
+  };