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,76 @@
+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 { execFileSync } = require('node:child_process');
+const { createContext } = require('../../dist/internal/runtime/context');
+const { LocalApi } = require('../../dist/internal/runtime/api');
+const { pruneLogs } = require('../../dist/internal/maintenance/maintenance');
+
+test('undated logs use modification calendar date and preserve active references at retention boundary', async (t) => {
+  const root = await fs.mkdtemp(path.join(os.tmpdir(), 'ql-retention-'));
+  t.after(() => fs.rm(root, { recursive: true, force: true }));
+  const now = new Date(2026, 0, 8, 12).getTime();
+  const modified = new Date(2026, 0, 1, 18);
+  t.mock.method(Date, 'now', () => now);
+  const queries = [];
+  t.mock.method(LocalApi.prototype, 'call', async (endpoint) => {
+    const log = new URL(`http://fixture/${endpoint}`).searchParams.get(
+      'log_path',
+    );
+    queries.push(log);
+    return { data: log.includes('active') ? { id: 1 } : null };
+  });
+  const createLogs = async (directory) => {
+    await fs.mkdir(directory, { recursive: true });
+    for (const name of [
+      'undated.log',
+      'active.log',
+      '2026-01-01-dated.log',
+      'ignore.txt',
+    ]) {
+      await fs.writeFile(path.join(directory, name), 'fixture');
+      await fs.utimes(path.join(directory, name), modified, modified);
+    }
+  };
+  const context = createContext({ root }, {});
+  await createLogs(context.paths.dir_log);
+  const result = await pruneLogs(context, 7);
+  assert.deepEqual(result.removed, ['2026-01-01-dated.log', 'undated.log']);
+  assert.deepEqual(result.retained, ['active.log']);
+  assert.deepEqual(queries.sort(), [
+    '2026-01-01-dated.log',
+    'active.log',
+    'undated.log',
+  ]);
+  assert.deepEqual((await fs.readdir(context.paths.dir_log)).sort(), [
+    'active.log',
+    'ignore.txt',
+  ]);
+  if (process.platform === 'linux') {
+    const legacy = path.join(root, 'legacy');
+    await createLogs(legacy);
+    execFileSync(
+      '/bin/bash',
+      [
+        path.join(__dirname, '../fixtures/log-retention.sh'),
+        path.resolve(__dirname, '../../../shell/rmlog.sh'),
+      ],
+      {
+        env: {
+          PATH: '/usr/bin:/bin',
+          dir_log: legacy,
+          is_macos: '0',
+          FIXED_NOW: String(now / 1000),
+          TZ: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        },
+        stdio: 'pipe',
+      },
+    );
+    assert.deepEqual((await fs.readdir(legacy)).sort(), [
+      'active.log',
+      'ignore.txt',
+    ]);
+  }
+});