@aqa-pulse/cli 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# @aqa-pulse/cli
+
+CLI для подключения Playwright-проектов к AQA Pulse без локальных helper-скриптов в репозитории автотестов.
+
+## Команды
+
+```bash
+aqa-pulse upload-report --generate-source-facts --repo-root "$CI_PROJECT_DIR"
+aqa-pulse merge-reports --project-kind ui --output test-results/dashboard/ui-merged.json test-results/dashboard/ui-*.json
+aqa-pulse generate-source-facts --report test-results/dashboard/data.json --repo-root .
+```
+
+## GitLab CI
+
+```yaml
+variables:
+  AQA_PULSE_BASE_URL: "https://aqa-pulse.example.com"
+  AQA_PULSE_WORKSPACE_SLUG: "autotests-main"
+  AQA_PULSE_REPORT_PATH: "Playwright/test-results/dashboard/data.json"
+
+script:
+  - npm ci
+  - npm test
+  - npx @aqa-pulse/cli upload-report --generate-source-facts --repo-root "$CI_PROJECT_DIR"
+```
+
+`AQA_PULSE_WORKSPACE_API_KEY` лучше хранить в GitLab CI/CD Variables.
+
+## Публикация
+
+Публичный npm:
+
+```bash
+npm publish --access public
+```
+
+GitLab Package Registry:
+
+```bash
+echo "@aqa-pulse:registry=${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/npm/" > .npmrc
+echo "//${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/:_authToken=${CI_JOB_TOKEN}" >> .npmrc
+npm publish
+```

package/bin/aqa-pulse.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+const path = require('node:path')
+const { spawnSync } = require('node:child_process')
+
+const [, , command = '--help', ...restArgs] = process.argv
+
+const commandMap = {
+    'upload-report': '../dist/backend/upload-report.js',
+    upload: '../dist/backend/upload-report.js',
+    'merge-reports': '../dist/backend/merge-reports.js',
+    merge: '../dist/backend/merge-reports.js',
+    'generate-source-facts': '../dist/backend/generate-source-facts.js',
+    'source-facts': '../dist/backend/generate-source-facts.js',
+}
+
+if (command === '--help' || command === '-h') {
+    printHelp()
+} else if (!commandMap[command]) {
+    console.error(`Неизвестная команда: ${command}`)
+    printHelp()
+    process.exitCode = 1
+} else {
+    const entryFile = path.resolve(__dirname, commandMap[command])
+    const result = spawnSync(process.execPath, [entryFile, ...restArgs], {
+        stdio: 'inherit',
+        env: process.env,
+    })
+
+    if (result.error) {
+        throw result.error
+    }
+
+    process.exit(result.status ?? 1)
+}
+
+function printHelp() {
+    console.log('AQA Pulse CLI')
+    console.log('')
+    console.log('Использование:')
+    console.log('  aqa-pulse upload-report [--report <path>] [--generate-source-facts] [--repo-root <path>]')
+    console.log('  aqa-pulse merge-reports --project-kind ui|api --output <path> [--allow-missing] <input...>')
+    console.log('  aqa-pulse generate-source-facts [--report <path>] [--out <path>] [--repo-root <path>]')
+    console.log('')
+    console.log('Короткие алиасы:')
+    console.log('  aqa-pulse upload')
+    console.log('  aqa-pulse merge')
+    console.log('  aqa-pulse source-facts')
+}

package/dist/backend/generate-source-facts.d.ts

@@ -0,0 +1,2 @@
+import { type PrecomputedCodeQualitySourceFacts, type ReporterRoot } from '../dashboard-utils';
+export declare function buildPrecomputedSourceFacts(report: ReporterRoot, repoRoot: string, reportPath: string): PrecomputedCodeQualitySourceFacts;