qaify-playwright-reporter 0.7.0 → 0.8.0

package/README.md

@@ -105,11 +105,15 @@ Untuk aplikasi yang repo FE dan BE-nya terpisah dan belum memasang Playwright, Q
 
 1. Pilih repo runner: repo kosong (mis. `qaify-runner`) atau repo aplikasinya sendiri. Jalankan `npx qaify-playwright-reporter init-runner` di dalamnya. Perintah ini menulis `.github/workflows/qaify-audit.yml`.
 2. Pasang GitHub App Qaify di repo runner, repo FE, dan repo BE.
-3. Di repo runner, isi secret `QA_FACTORY_TOKEN` (token reporter repo runner), dan variable `QA_FACTORY_URL`. Secret `CLAUDE_CODE_OAUTH_TOKEN` bersifat opsional.
+3. Di repo runner, isi secret `QA_FACTORY_TOKEN` (token reporter repo runner), dan variable `QA_FACTORY_URL`. Secret `CLAUDE_CODE_OAUTH_TOKEN` bersifat opsional. Secret ini dibutuhkan untuk [perbaikan temuan oleh Claude](#perbaikan-temuan-audit-oleh-claude-pr-ke-repo-febe) dan audit mode Claude.
 
-   - Tanpa secret itu, audit berjalan **tanpa AI** (`qaify audit-static`): build, test, `composer audit` / `npm audit`, route GET publik BE, dan smoke test Playwright FE (desktop + mobile, screenshot setiap halaman untuk lampiran laporan PDF). Smoke test juga memeriksa elemen yang meluap, gambar rusak, tombol yang tertutup elemen lain, error JavaScript, request API, dan aset yang gagal. Setiap jenis masalah difoto lagi dengan kotak merah di elemennya atau banner berisi pesan errornya. Temuan smoke diberi halaman dan berkas sumber bila bisa ditebak (route FE → komponen halaman, route BE → method controller). Request FE yang gagal dipetakan ke controller BE, dan route BE yang error dihubungkan ke halaman FE yang memanggilnya.
-   - Dengan secret itu, Claude yang mengaudit. Hasilnya lebih dalam, termasuk logika bisnis dan kontrak API.
-   - Mode bisa dipaksa lewat variable `QA_FACTORY_AUDIT_MODE` (`static` / `claude`).
+   Mode audit dipilih di Qaify: **Tanpa AI** (default) atau **Claude**, sebagai setelan aplikasi, dan bisa diganti di dialog **Audit sekarang**. Jadi Claude bisa dipakai hanya untuk memperbaiki temuan, sementara auditnya tetap tanpa AI. Mode Claude tanpa secret di atas dijalankan sebagai Tanpa AI (dengan peringatan di run).
+
+   - **Tanpa AI** (`qaify audit-static`): build, test, `composer audit` / `npm audit`, route GET publik BE, dan smoke test Playwright FE (desktop + mobile, screenshot setiap halaman untuk lampiran laporan PDF). Smoke test juga memeriksa elemen yang meluap, gambar rusak, tombol yang tertutup elemen lain, error JavaScript, request API, dan aset yang gagal. Setiap jenis masalah difoto lagi dengan kotak merah di elemennya atau banner berisi pesan errornya. Temuan smoke diberi halaman dan berkas sumber bila bisa ditebak (route FE → komponen halaman, route BE → method controller). Request FE yang gagal dipetakan ke controller BE, dan route BE yang error dihubungkan ke halaman FE yang memanggilnya.
+   - **Claude**: Claude yang mengaudit. Hasilnya lebih dalam, termasuk logika bisnis dan kontrak API, tetapi memakan kuota langganan.
+   - Variable `QA_FACTORY_AUDIT_MODE` (`static` / `claude`) hanya dipakai bila backend Qaify belum mengirim mode (versi lama).
+
+   Runner yang dibuat sebelum 0.8 perlu memperbarui workflow: `npx qaify-playwright-reporter init-runner --force`. Tanpa itu, workflow lama tetap memilih mode dari secret dan variable.
 4. Di Qaify → **Aplikasi**, tambahkan aplikasi (repo FE, BE, runner), lalu klik **Audit sekarang**.
 
 Alur di workflow:
@@ -128,7 +132,7 @@ Keamanan:
 - `QA_FACTORY_TOKEN` tidak tersedia di step Claude.
 - Isi repo diperlakukan sebagai data, bukan instruksi.
 
-Satu audit adalah satu sesi Claude yang panjang (sampai 45 menit), sehingga memakan kuota langganan pemilik runner.
+Satu audit mode Claude adalah satu sesi Claude yang panjang (sampai 45 menit), sehingga memakan kuota langganan pemilik runner. Audit tanpa AI tidak memakai kuota.
 
 ## Perbaikan temuan audit oleh Claude (PR ke repo FE/BE)
 

package/dist/audit.d.ts

@@ -279,9 +279,13 @@ export declare const defaultExec: Exec;
 export interface AuditContextResult {
     ok: boolean;
     commits: Record<string, string>;
+    /** auditor pilihan Qaify (static / claude); undefined = backend lama, workflow memilih sendiri */
+    mode?: AuditMode;
     /** alasan gagal; juga ditulis ke context-error.txt agar audit-submit bisa melaporkannya */
     error?: string;
 }
+export declare const AUDIT_MODES: readonly ["static", "claude"];
+export type AuditMode = (typeof AUDIT_MODES)[number];
 /**
  * GET /api/ingest/audits/{id}/context → clone apps/<role> → cabut token.
  * Token hanya lewat header git dari environment (tidak pernah di argumen, URL remote, atau disk)

package/dist/audit.js

@@ -174,6 +174,7 @@ export function parseAuditOutput(raw) {
 const execFileAsync = promisify(execFile);
 export const defaultExec = async (file, args, env) => (await execFileAsync(file, args, { env: { ...process.env, ...env }, maxBuffer: 10 * 1024 * 1024 })).stdout;
 const branchOf = (repo) => repo.branch || repo.default_branch;
+export const AUDIT_MODES = ['static', 'claude'];
 const CONTEXT_ERROR_FILE = 'context-error.txt';
 /**
  * GET /api/ingest/audits/{id}/context → clone apps/<role> → cabut token.
@@ -214,12 +215,14 @@ export async function auditContext(client, auditId, dir, opts = {}) {
         return contextFailed(dir, `Clone repo gagal: ${detail}`, commits);
     }
     await revoke(repos, opts.fetch);
+    const mode = AUDIT_MODES.includes(ctx.mode) ? ctx.mode : undefined;
     await writeFile(join(dir, 'context.json'), JSON.stringify({
         audit_id: ctx.audit_id,
+        mode: mode ?? null,
         project: ctx.project,
         repos: repos.map((r) => ({ role: r.role, full_name: r.full_name, branch: branchOf(r), commit: commits[r.role] ?? null })),
     }, null, 2));
-    return { ok: true, commits };
+    return { ok: true, commits, mode };
 }
 /** Peringatan (annotation di ringkasan run) + context-error.txt untuk audit-submit. */
 async function contextFailed(dir, error, commits) {

package/dist/cli.js

@@ -137,8 +137,9 @@ switch (args.command) {
             // step merah: tanpa ini auditor & kirim hasil dilewati diam-diam dan audit macet "running"
             process.exitCode = 1;
         }
+        // mode kosong = backend lama: workflow memilih dari variable / secret
         if (process.env.GITHUB_OUTPUT)
-            await appendFile(process.env.GITHUB_OUTPUT, `ok=${result.ok}\n`);
+            await appendFile(process.env.GITHUB_OUTPUT, `ok=${result.ok}\nmode=${('mode' in result && result.mode) || ''}\n`);
         break;
     }
     case 'audit-schema': {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qaify-playwright-reporter",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Reporter Playwright untuk QA Factory (Qaify): kirim hasil test dan artefak ke /api/ingest, tanpa pernah menggagalkan test.",
   "license": "MIT",
   "author": "ahmdkenz",

package/templates/qaify-audit.yml

@@ -3,13 +3,14 @@
 # Butuh di repo runner ini (Settings → Secrets and variables → Actions):
 #   secret   QA_FACTORY_TOKEN         token reporter repo runner (Pengaturan → Token Reporter)
 #   variable QA_FACTORY_URL           URL API Qaify
-#   secret   CLAUDE_CODE_OAUTH_TOKEN  opsional: audit dengan Claude (langganan Claude Pro/Max Anda, `claude setup-token`)
-#   variable QA_FACTORY_AUDIT_MODE    opsional, `static` atau `claude` (default: claude bila secret di atas ada)
+#   secret   CLAUDE_CODE_OAUTH_TOKEN  opsional: perbaikan temuan & audit mode claude (langganan Claude Pro/Max, `claude setup-token`)
+#   variable QA_FACTORY_AUDIT_MODE    opsional, `static` / `claude`; hanya dipakai bila Qaify tidak mengirim mode
 #   variable QA_FACTORY_AI_MODEL      opsional, default sonnet
 #   variable QA_FACTORY_MCP_VERSION   opsional, versi @playwright/mcp (default latest)
 # GitHub App Qaify harus terpasang di repo ini dan di repo FE + BE. Nama file harus tetap qaify-audit.yml.
+# Mode audit dipilih di Qaify (setelan aplikasi, bisa diganti per audit); mode claude tanpa secret jatuh ke static.
 # Mode static (tanpa AI): build, test, composer/npm audit, dan smoke test Playwright; cepat, tanpa kuota AI,
-# tetapi tanpa analisis logika bisnis / kontrak API dari kode.
+# tetapi tanpa analisis logika bisnis / kontrak API dari kode. Temuannya tetap bisa diperbaiki Claude (qaify-fix.yml).
 # Mode claude: satu sesi Claude yang panjang; kuota langganan dipakai bersama pemakaian pribadi.
 name: Qaify audit
 run-name: audit ${{ inputs.audit_id }}
@@ -42,9 +43,8 @@ jobs:
         env: { POSTGRES_PASSWORD: postgres, POSTGRES_DB: app }
         ports: ['5432:5432']
         options: --health-cmd="pg_isready -U postgres" --health-interval=10s --health-timeout=5s --health-retries=10
-    # context runner tidak tersedia di env level job; WORK diisi lewat GITHUB_ENV di step pertama
-    env:
-      AUDIT_MODE: ${{ vars.QA_FACTORY_AUDIT_MODE || (secrets.CLAUDE_CODE_OAUTH_TOKEN != '' && 'claude' || 'static') }}
+    # context runner tidak tersedia di env level job; WORK diisi lewat GITHUB_ENV di step pertama,
+    # AUDIT_MODE di step "Tentukan mode audit" (mode baru diketahui dari konteks audit)
     steps:
       - name: Siapkan direktori kerja
         run: echo "WORK=$RUNNER_TEMP/qaify" >> "$GITHUB_ENV"
@@ -58,9 +58,7 @@ jobs:
           tools: composer
 
       - name: Pasang Qaify CLI
-        run: |
-          npm install -g qaify-playwright-reporter@0.5 playwright-core@1
-          if [ "$AUDIT_MODE" = claude ]; then npm install -g @anthropic-ai/claude-code; fi
+        run: npm install -g qaify-playwright-reporter@0.8 playwright-core@1
 
       # token clone sekali pakai (read-only, hanya repo FE + BE) dicabut sebelum auditor berjalan
       - name: Ambil konteks & clone repo FE + BE
@@ -70,6 +68,25 @@ jobs:
           QA_FACTORY_TOKEN: ${{ secrets.QA_FACTORY_TOKEN }}
         run: qaify audit-context --audit "${{ inputs.audit_id }}" --dir "$WORK"
 
+      # pilihan Qaify → variable QA_FACTORY_AUDIT_MODE → claude bila secret ada; claude tanpa secret → static
+      - name: Tentukan mode audit
+        if: steps.ctx.outputs.ok == 'true'
+        env:
+          REQUESTED: ${{ steps.ctx.outputs.mode || vars.QA_FACTORY_AUDIT_MODE }}
+          HAS_CLAUDE: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN != '' }}
+        run: |
+          mode="${REQUESTED:-$([ "$HAS_CLAUDE" = true ] && echo claude || echo static)}"
+          if [ "$mode" != static ] && [ "$mode" != claude ]; then
+            echo "::warning::Mode audit tidak dikenal ($mode); memakai static."
+            mode=static
+          fi
+          if [ "$mode" = claude ] && [ "$HAS_CLAUDE" != true ]; then
+            echo "::warning::Mode claude diminta tetapi secret CLAUDE_CODE_OAUTH_TOKEN kosong; audit dijalankan tanpa AI."
+            mode=static
+          fi
+          echo "qa-factory: mode audit $mode"
+          echo "AUDIT_MODE=$mode" >> "$GITHUB_ENV"
+
       # tanpa secret apa pun: kode aplikasi (composer/npm script) berjalan di step ini
       - name: Audit tanpa AI (Playwright)
         if: steps.ctx.outputs.ok == 'true' && env.AUDIT_MODE == 'static'
@@ -80,6 +97,7 @@ jobs:
       - name: Siapkan instruksi & Playwright MCP
         if: steps.ctx.outputs.ok == 'true' && env.AUDIT_MODE == 'claude'
         run: |
+          npm install -g @anthropic-ai/claude-code
           mkdir -p "$WORK/.qaify"
           qaify audit-schema --out "$WORK/.qaify/schema.json" --instructions "$WORK/.qaify/instructions.txt"
           # Google Chrome sudah ada di runner ubuntu-latest