@piwitests/server 0.25.0 → 0.26.0

package/.output/server/chunks/build/HelpHint-C96TlqxY.mjs

@@ -0,0 +1,1070 @@
+import { q as _sfc_main$l, k as _sfc_main$p, s as _sfc_main$8, l as _sfc_main$k } from './server.mjs';
+import { defineComponent, computed, mergeProps, unref, withCtx, renderSlot, createTextVNode, openBlock, createBlock, createCommentVNode, ref, isRef, createVNode, toDisplayString, Fragment, renderList, useSSRContext } from 'vue';
+import { ssrRenderComponent, ssrRenderSlot, ssrInterpolate, ssrRenderList, ssrRenderAttr } from 'vue/server-renderer';
+import { H as HELP_TOPICS } from './help-content-BK3jcgLw.mjs';
+import { a as useCopy } from './fetch-DOcN2mHf.mjs';
+
+const DOCS_BASE_URL = "https://piwitests.dev";
+function docsUrl(pathWithAnchor) {
+  return `${DOCS_BASE_URL}/${pathWithAnchor.replace(/^\//, "")}`;
+}
+
+const PIWI_ENV_VARS = {
+  // ── General ──────────────────────────────────────────────────────────────
+  PIWI_SITE_URL: {
+    description: "Public base URL of the instance (e.g. https://piwi.example.com). Used to build links in emails.",
+    category: "general",
+    type: "url",
+    example: "https://piwi.example.com",
+    notes: "When unset, links in emails point to http://localhost:3000 and OAuth callback URLs are inferred from the request host \u2014 set it when running behind a reverse proxy."
+  },
+  PIWI_SECRET_KEY: {
+    description: "Master key for AES-256-GCM encryption of secrets stored in the database (AI API keys, webhook/SCM secrets). Strongly recommended in production.",
+    category: "general",
+    secret: true,
+    example: "a 64-char random hex string",
+    notes: "Falls back to an insecure built-in development key (with a startup warning in production). Generate one with `node -e \"console.log(require('node:crypto').randomBytes(32).toString('hex'))\"`."
+  },
+  PIWI_BUILD_DIR: {
+    description: "Overrides the Nuxt build output directory. Used by the test harness to isolate parallel builds.",
+    category: "build",
+    runtimeOnly: true,
+    type: "path"
+  },
+  PIWI_BUILD_SHA: {
+    description: "Commit SHA baked into the build for provenance. Shown on Settings \u2192 About. Set as a build-time arg.",
+    category: "build",
+    runtimeOnly: true
+  },
+  PIWI_DESKTOP_TOKEN: {
+    description: "Per-install access token the desktop (Tauri) app injects to gate its local server. Set automatically by the desktop shell \u2014 not user-configurable. Absent on the server build.",
+    category: "desktop",
+    secret: true,
+    runtimeOnly: true,
+    since: "0.16.0"
+  },
+  // ── Database ─────────────────────────────────────────────────────────────
+  PIWI_DATABASE_PATH: {
+    description: "Path to the SQLite database file (used when PIWI_DATABASE_URL is not set).",
+    category: "database",
+    type: "path",
+    default: ".data/piwi.db",
+    relevantWhen: { PIWI_DATABASE_URL: "" }
+  },
+  PIWI_DATABASE_URL: {
+    description: "PostgreSQL connection string. When set, PostgreSQL is used instead of SQLite and migrations run automatically on startup.",
+    category: "database",
+    secret: true,
+    example: "postgres://piwi:piwi@db:5432/piwi",
+    docs: "database#postgresql"
+  },
+  PIWI_RETENTION_DAYS: {
+    description: "Days of test-run history the nightly retention sweep keeps. Unset or 0 disables automatic run pruning (the default \u2014 pruning is opt-in).",
+    category: "database",
+    type: "number",
+    min: 0,
+    docs: "storage#data-retention"
+  },
+  PIWI_RETENTION_NOTIFICATION_DAYS: {
+    description: "Days to keep sent/failed notification outbox rows before the nightly sweep prunes them (default 30; 0 keeps them forever).",
+    category: "database",
+    type: "number",
+    default: "30",
+    min: 0
+  },
+  PIWI_RETENTION_DIAGNOSIS_VERSIONS: {
+    description: "AI-diagnosis history versions kept per diagnosis by the nightly sweep (default 20; 0 disables capping).",
+    category: "database",
+    type: "number",
+    default: "20",
+    min: 0
+  },
+  // ── Storage ──────────────────────────────────────────────────────────────
+  PIWI_STORAGE_TYPE: {
+    description: 'Storage backend for test artifacts (HTML reports, traces, attachments): "local" or "s3".',
+    category: "storage",
+    type: "enum",
+    enum: ["local", "s3"],
+    default: "local",
+    notes: "Only the exact value `s3` selects S3; any other value falls back to local storage."
+  },
+  PIWI_STORAGE_PATH: {
+    description: 'Directory for local file storage (when PIWI_STORAGE_TYPE is "local").',
+    category: "storage",
+    type: "path",
+    default: ".data/storage",
+    relevantWhen: { PIWI_STORAGE_TYPE: "local" }
+  },
+  PIWI_S3_BUCKET: {
+    description: 'S3 bucket name for artifact storage (when PIWI_STORAGE_TYPE is "s3").',
+    category: "storage",
+    relevantWhen: { PIWI_STORAGE_TYPE: "s3" },
+    requiredWhen: { PIWI_STORAGE_TYPE: "s3" },
+    docs: "storage#s3-compatible-storage"
+  },
+  PIWI_S3_REGION: {
+    description: 'S3 bucket region (when PIWI_STORAGE_TYPE is "s3").',
+    category: "storage",
+    example: "us-east-1",
+    relevantWhen: { PIWI_STORAGE_TYPE: "s3" },
+    requiredWhen: { PIWI_STORAGE_TYPE: "s3" }
+  },
+  PIWI_S3_ACCESS_KEY_ID: {
+    description: "S3 access key id with write access to the bucket.",
+    category: "storage",
+    secret: true,
+    relevantWhen: { PIWI_STORAGE_TYPE: "s3" },
+    requiredWhen: { PIWI_STORAGE_TYPE: "s3" }
+  },
+  PIWI_S3_SECRET_ACCESS_KEY: {
+    description: "S3 secret access key.",
+    category: "storage",
+    secret: true,
+    relevantWhen: { PIWI_STORAGE_TYPE: "s3" },
+    requiredWhen: { PIWI_STORAGE_TYPE: "s3" }
+  },
+  PIWI_S3_ENDPOINT: {
+    description: "Custom endpoint for S3-compatible services (MinIO, R2, Spaces).",
+    category: "storage",
+    type: "url",
+    example: "https://minio.example.com",
+    relevantWhen: { PIWI_STORAGE_TYPE: "s3" }
+  },
+  PIWI_S3_FORCE_PATH_STYLE: {
+    description: "Use path-style addressing (required by some S3-compatible services).",
+    category: "storage",
+    type: "boolean",
+    relevantWhen: { PIWI_STORAGE_TYPE: "s3" },
+    notes: "Defaults to on when a custom endpoint is set, off otherwise; only the exact value `false` turns it off explicitly."
+  },
+  // ── Authentication ───────────────────────────────────────────────────────
+  PIWI_AUTH_ENABLED: {
+    description: 'Set to "true" to enable role-based access control and API keys. Off by default.',
+    category: "auth",
+    type: "boolean",
+    default: "false"
+  },
+  PIWI_AUTH_SECRET: {
+    description: "Secret used to sign/encrypt session cookies. Required when PIWI_AUTH_ENABLED is true.",
+    category: "auth",
+    secret: true,
+    relevantWhen: { PIWI_AUTH_ENABLED: "true" },
+    requiredWhen: { PIWI_AUTH_ENABLED: "true" },
+    notes: "The server refuses to start when auth is enabled and this is unset."
+  },
+  PIWI_SHARE_LINKS_ENABLED: {
+    description: 'Set to "true" to allow minting read-only public share links for executions and failure clusters. Off by default; turning it off again immediately dead-ends every outstanding link without deleting anything.',
+    category: "auth",
+    type: "boolean",
+    default: "false",
+    since: "0.26.0"
+  },
+  PIWI_SHARE_LINK_MAX_TTL_DAYS: {
+    description: "Longest allowed share-link lifetime, in days. The creation dialog offers expiries up to this; 0 lifts the cap and allows links with no expiry.",
+    category: "auth",
+    type: "number",
+    default: "30",
+    min: 0,
+    max: 3650,
+    relevantWhen: { PIWI_SHARE_LINKS_ENABLED: "true" },
+    since: "0.26.0"
+  },
+  PIWI_TRUST_PROXY: {
+    description: `Set to "true" when a reverse proxy sits in front of Piwi, so per-IP rate limits on the auth endpoints key on the client address your proxy appends to X-Forwarded-For instead of on the proxy's own address (which would pool every client into one bucket). Leave off when clients connect directly: the header is client-controlled then, and trusting it would let a caller choose its own bucket.`,
+    category: "auth",
+    type: "boolean",
+    default: "false",
+    since: "0.26.0"
+  },
+  // ── OAuth ────────────────────────────────────────────────────────────────
+  PIWI_OAUTH_GOOGLE_CLIENT_ID: {
+    description: "Google OAuth client id (optional single sign-on).",
+    category: "oauth",
+    relevantWhen: { PIWI_AUTH_ENABLED: "true" },
+    requiredWhen: { PIWI_OAUTH_GOOGLE_CLIENT_SECRET: "*" },
+    docs: "authentication#oauth-google-github"
+  },
+  PIWI_OAUTH_GOOGLE_CLIENT_SECRET: {
+    description: "Google OAuth client secret.",
+    category: "oauth",
+    secret: true,
+    relevantWhen: { PIWI_AUTH_ENABLED: "true" },
+    requiredWhen: { PIWI_OAUTH_GOOGLE_CLIENT_ID: "*" }
+  },
+  PIWI_OAUTH_GITHUB_CLIENT_ID: {
+    description: "GitHub OAuth client id (optional single sign-on).",
+    category: "oauth",
+    relevantWhen: { PIWI_AUTH_ENABLED: "true" },
+    requiredWhen: { PIWI_OAUTH_GITHUB_CLIENT_SECRET: "*" },
+    docs: "authentication#oauth-google-github"
+  },
+  PIWI_OAUTH_GITHUB_CLIENT_SECRET: {
+    description: "GitHub OAuth client secret.",
+    category: "oauth",
+    secret: true,
+    relevantWhen: { PIWI_AUTH_ENABLED: "true" },
+    requiredWhen: { PIWI_OAUTH_GITHUB_CLIENT_ID: "*" }
+  },
+  PIWI_OAUTH_ALLOWED_DOMAINS: {
+    description: "Comma-separated verified email domains allowed to sign in via OAuth (all providers).",
+    category: "oauth",
+    type: "list",
+    example: "example.com,corp.example.com",
+    relevantWhen: { PIWI_AUTH_ENABLED: "true" },
+    notes: "Only verified emails in these domains are accepted. Empty means no domain restriction."
+  },
+  PIWI_OAUTH_GITHUB_ALLOWED_ORGS: {
+    description: "Comma-separated GitHub org logins a user must belong to (requests read:org scope).",
+    category: "oauth",
+    type: "list",
+    relevantWhen: { PIWI_OAUTH_GITHUB_CLIENT_ID: "*" }
+  },
+  // ── AI — diagnosis model ─────────────────────────────────────────────────
+  PIWI_AI_PROVIDER: {
+    description: 'AI provider for failure diagnosis: "anthropic" or "openai" (OpenAI-compatible).',
+    category: "ai",
+    type: "enum",
+    enum: ["anthropic", "openai"]
+  },
+  PIWI_AI_API_KEY: {
+    description: "API key for the diagnosis provider. Takes precedence over the DB-stored key.",
+    category: "ai",
+    secret: true,
+    relevantWhen: { PIWI_AI_PROVIDER: "*" },
+    requiredWhen: { PIWI_AI_PROVIDER: "anthropic" },
+    notes: "Optional for OpenAI-compatible providers that need no key (e.g. a local model)."
+  },
+  PIWI_AI_MODEL: {
+    description: "Diagnosis model name (default: claude-opus-4-8 for Anthropic).",
+    category: "ai",
+    example: "claude-opus-4-8",
+    relevantWhen: { PIWI_AI_PROVIDER: "*" },
+    requiredWhen: { PIWI_AI_PROVIDER: "openai" }
+  },
+  PIWI_AI_BASE_URL: {
+    description: "Base URL for OpenAI-compatible providers (e.g. http://localhost:11434/v1).",
+    category: "ai",
+    type: "url",
+    example: "http://localhost:11434/v1",
+    relevantWhen: { PIWI_AI_PROVIDER: "*" },
+    requiredWhen: { PIWI_AI_PROVIDER: "openai" }
+  },
+  PIWI_AI_AUTO_DIAGNOSE: {
+    description: 'Set to "true" to auto-diagnose new failure clusters when a run finishes.',
+    category: "ai",
+    type: "boolean",
+    default: "false",
+    relevantWhen: { PIWI_AI_PROVIDER: "*" }
+  },
+  PIWI_AI_AUTO_DIAGNOSE_MAX: {
+    description: "Max clusters auto-diagnosed per finished run (budget cap; default 3).",
+    category: "ai",
+    type: "number",
+    default: "3",
+    min: 1,
+    relevantWhen: { PIWI_AI_AUTO_DIAGNOSE: "true" }
+  },
+  // ── AI — research model ──────────────────────────────────────────────────
+  PIWI_AI_RESEARCH_PROVIDER: {
+    description: "Provider for the optional research (pre-analysis) stage. Falls back to PIWI_AI_PROVIDER.",
+    category: "ai",
+    type: "enum",
+    enum: ["anthropic", "openai"],
+    relevantWhen: { PIWI_AI_RESEARCH_MODEL: "*" }
+  },
+  PIWI_AI_RESEARCH_MODEL: {
+    description: "Cheaper/faster model for the research stage. Empty disables the two-stage pipeline.",
+    category: "ai",
+    relevantWhen: { PIWI_AI_PROVIDER: "*" }
+  },
+  PIWI_AI_RESEARCH_BASE_URL: {
+    description: "Base URL for the research-stage provider. Falls back to PIWI_AI_BASE_URL.",
+    category: "ai",
+    type: "url",
+    relevantWhen: { PIWI_AI_RESEARCH_MODEL: "*" }
+  },
+  PIWI_AI_RESEARCH_API_KEY: {
+    description: "API key for the research-stage provider. Falls back to PIWI_AI_API_KEY.",
+    category: "ai",
+    secret: true,
+    relevantWhen: { PIWI_AI_RESEARCH_MODEL: "*" }
+  },
+  // ── AI — embedding model ─────────────────────────────────────────────────
+  PIWI_AI_EMBEDDING_PROVIDER: {
+    description: "Provider for embeddings (semantic failure clustering). Falls back to PIWI_AI_PROVIDER.",
+    category: "ai",
+    type: "enum",
+    enum: ["openai"],
+    relevantWhen: { PIWI_AI_EMBEDDING_MODEL: "*" },
+    notes: 'Must resolve to an OpenAI-compatible provider \u2014 Anthropic has no embeddings API \u2014 so the fallback only helps when the main provider is "openai".'
+  },
+  PIWI_AI_EMBEDDING_MODEL: {
+    description: "Embedding model name (e.g. text-embedding-3-small).",
+    category: "ai",
+    example: "text-embedding-3-small",
+    relevantWhen: { PIWI_AI_PROVIDER: "*" },
+    notes: "Empty disables semantic clustering (and the embedding fallbacks)."
+  },
+  PIWI_AI_EMBEDDING_BASE_URL: {
+    description: "Base URL for the embedding provider. Falls back to PIWI_AI_BASE_URL.",
+    category: "ai",
+    type: "url",
+    relevantWhen: { PIWI_AI_EMBEDDING_MODEL: "*" }
+  },
+  PIWI_AI_EMBEDDING_API_KEY: {
+    description: "API key for the embedding provider. Falls back to PIWI_AI_API_KEY.",
+    category: "ai",
+    secret: true,
+    relevantWhen: { PIWI_AI_EMBEDDING_MODEL: "*" }
+  },
+  // ── AI — diagnosis context limits ────────────────────────────────────────
+  PIWI_AI_MAX_SAMPLE_ERROR_CHARS: {
+    description: "Max characters of raw error text (per error block).",
+    category: "ai-limits",
+    type: "number",
+    default: "10000",
+    min: 200,
+    max: 5e4
+  },
+  PIWI_AI_MAX_SCM_PATCH_BUDGET: {
+    description: "Total characters of diff patches across changed files.",
+    category: "ai-limits",
+    type: "number",
+    default: "15000",
+    min: 0,
+    max: 5e4
+  },
+  PIWI_AI_MAX_AFFECTED_TESTS: {
+    description: "Max affected tests listed in the diagnosis context.",
+    category: "ai-limits",
+    type: "number",
+    default: "30",
+    min: 1,
+    max: 200
+  },
+  PIWI_AI_MAX_STEPS: {
+    description: "Max recent test steps included.",
+    category: "ai-limits",
+    type: "number",
+    default: "50",
+    min: 1,
+    max: 200
+  },
+  PIWI_AI_MAX_CONSOLE_ENTRIES: {
+    description: "Max console error/warning entries included.",
+    category: "ai-limits",
+    type: "number",
+    default: "30",
+    min: 0,
+    max: 200
+  },
+  PIWI_AI_MAX_CONSOLE_ENTRY_CHARS: {
+    description: "Max characters per console entry.",
+    category: "ai-limits",
+    type: "number",
+    default: "1000",
+    min: 50,
+    max: 5e3
+  },
+  PIWI_AI_MAX_NETWORK_REQUESTS: {
+    description: "Max failed network requests included.",
+    category: "ai-limits",
+    type: "number",
+    default: "25",
+    min: 0,
+    max: 200
+  },
+  PIWI_AI_MAX_ARIA_SNAPSHOT_CHARS: {
+    description: "Max characters of the page ARIA snapshot.",
+    category: "ai-limits",
+    type: "number",
+    default: "12000",
+    min: 0,
+    max: 5e4
+  },
+  PIWI_AI_MAX_TEST_SOURCE_CHARS: {
+    description: "Max characters of the test source snippet.",
+    category: "ai-limits",
+    type: "number",
+    default: "8000",
+    min: 0,
+    max: 5e4
+  },
+  PIWI_AI_MAX_SOURCE_FILES: {
+    description: "Max full source files fetched from SCM to ground patches (0 disables).",
+    category: "ai-limits",
+    type: "number",
+    default: "4",
+    min: 0,
+    max: 20
+  },
+  PIWI_AI_MAX_SOURCE_FILE_CHARS: {
+    description: "Max characters per fetched full source file.",
+    category: "ai-limits",
+    type: "number",
+    default: "12000",
+    min: 0,
+    max: 5e4
+  },
+  PIWI_AI_MAX_SERVER_LOG_ENTRIES: {
+    description: "Max backend server log entries (from X-Piwi-Logs header) included.",
+    category: "ai-limits",
+    type: "number",
+    default: "50",
+    min: 0,
+    max: 200
+  },
+  PIWI_AI_MAX_SERVER_LOG_ENTRY_CHARS: {
+    description: "Max characters per backend server log entry.",
+    category: "ai-limits",
+    type: "number",
+    default: "1000",
+    min: 50,
+    max: 5e3
+  },
+  PIWI_AI_MAX_SERVER_TRACE_SPANS: {
+    description: "Max backend server spans (from X-Piwi-Trace header) included in AI diagnosis (0 disables).",
+    category: "ai-limits",
+    type: "number",
+    default: "40",
+    min: 0,
+    max: 500,
+    since: "0.16.0"
+  },
+  PIWI_AI_MAX_STEP_INTENTS: {
+    description: "Max AI-step intent mappings (natural-language prompt \u2192 compiled locator) included in a diagnosis (0 disables the section).",
+    category: "ai-limits",
+    type: "number",
+    default: "20",
+    min: 0,
+    max: 100,
+    since: "0.24.0"
+  },
+  PIWI_AI_STEP_MAX_SNAPSHOT_CHARS: {
+    description: "Max characters of the page ARIA snapshot the reporter sends per AI-step authoring iteration.",
+    category: "ai-steps",
+    type: "number",
+    default: "24000",
+    min: 0,
+    max: 1e5,
+    since: "0.24.0"
+  },
+  PIWI_AI_STEP_MAX_OUTPUT_TOKENS: {
+    description: "Max output tokens the model may return per AI-step authoring iteration. Reasoning models count hidden chain-of-thought against this, so raise it (up to 8192) when authoring with one.",
+    category: "ai-steps",
+    type: "number",
+    default: "1024",
+    min: 256,
+    max: 8192,
+    since: "0.24.0"
+  },
+  PIWI_AI_MAX_IMAGES: {
+    description: "Max screenshots auto-included in the diagnosis context.",
+    category: "ai-limits",
+    type: "number",
+    default: "5",
+    min: 0,
+    max: 20
+  },
+  PIWI_AI_MAX_PASSED_PEERS: {
+    description: "Max peer tests in the same file listed when they passed.",
+    category: "ai-limits",
+    type: "number",
+    default: "20",
+    min: 0,
+    max: 100
+  },
+  PIWI_AI_MAX_CONSOLE_WINDOW: {
+    description: "Max console entries of any type in the window before failure.",
+    category: "ai-limits",
+    type: "number",
+    default: "50",
+    min: 0,
+    max: 200
+  },
+  PIWI_AI_SLOW_REQUEST_MS: {
+    description: "Network request duration (ms) threshold for flagging as slow.",
+    category: "ai-limits",
+    type: "number",
+    default: "1500",
+    min: 100,
+    max: 3e4
+  },
+  PIWI_AI_MAX_TRACE_ACTIONS: {
+    description: "Max actions extracted from trace ZIP for failing-action context (0 disables).",
+    category: "ai-limits",
+    type: "number",
+    default: "10",
+    min: 0,
+    max: 50
+  },
+  PIWI_AI_TRACE_DOM_CHARS: {
+    description: "Max characters for the trace-derived DOM/ARIA excerpt in failing-action context.",
+    category: "ai-limits",
+    type: "number",
+    default: "6000",
+    min: 0,
+    max: 2e4
+  },
+  PIWI_AI_MAX_TRACE_STACK_FRAMES: {
+    description: "Max call-stack frames (with source windows) from the trace call-stack section (0 disables).",
+    category: "ai-limits",
+    type: "number",
+    default: "10",
+    min: 0,
+    max: 50
+  },
+  PIWI_AI_MAX_TRACE_NETWORK_REQUESTS: {
+    description: "Max requests included from the trace network stream (0 disables).",
+    category: "ai-limits",
+    type: "number",
+    default: "20",
+    min: 0,
+    max: 200
+  },
+  PIWI_AI_MAX_DOM_SNAPSHOT_CHARS: {
+    description: "Max characters of the failure-time DOM snapshot rendered from the trace (0 disables).",
+    category: "ai-limits",
+    type: "number",
+    default: "8000",
+    min: 0,
+    max: 5e4
+  },
+  PIWI_AI_IMAGE_MAX_EDGE: {
+    description: "Screenshots are downscaled to at most this many pixels on the long edge before being sent.",
+    category: "ai-limits",
+    type: "number",
+    default: "1920",
+    min: 512,
+    max: 8192
+  },
+  // ── Ingest storage limits ────────────────────────────────────────────────
+  PIWI_INGEST_MAX_CONSOLE_ENTRIES: {
+    description: "Max console entries stored per test execution.",
+    category: "ingest",
+    type: "number",
+    default: "200",
+    min: 10,
+    max: 5e3
+  },
+  PIWI_IMPORT_MAX_BYTES: {
+    description: "Max size of a single multipart upload (report upload or blob-report import), in bytes. Lower it to match a reverse proxy that rejects large bodies, so the import page rejects an oversized archive before uploading it.",
+    category: "ingest",
+    type: "number",
+    default: String(500 * 1024 * 1024),
+    min: 1024 * 1024,
+    max: 5 * 1024 * 1024 * 1024,
+    since: "0.19.0"
+  },
+  // ── Offline export limits ───────────────────────────────────────────────
+  PIWI_EXPORT_MAX_INLINE_BYTES: {
+    description: "Max size of a single evidence file embedded as a data: URI in an HTML export, in bytes. Larger files are left out of the single-file HTML (and listed as omitted); the ZIP export still carries them at full size.",
+    category: "export",
+    type: "number",
+    default: String(8 * 1024 * 1024),
+    min: 64 * 1024,
+    max: 512 * 1024 * 1024,
+    since: "0.19.0"
+  },
+  PIWI_EXPORT_MAX_BYTES: {
+    description: "Max total size of one export, in bytes. Evidence is added largest-last until the budget is reached; the rest is listed as omitted. The archive is built in memory, so this also bounds what a single export costs the server.",
+    category: "export",
+    type: "number",
+    default: String(500 * 1024 * 1024),
+    min: 1024 * 1024,
+    max: 4 * 1024 * 1024 * 1024,
+    since: "0.19.0"
+  },
+  PIWI_EXPORT_MAX_CASES: {
+    description: "Max member executions carrying full evidence in a failure-cluster export. Remaining affected tests are listed by name without their evidence.",
+    category: "export",
+    type: "number",
+    default: "25",
+    min: 1,
+    max: 200,
+    since: "0.19.0"
+  },
+  PIWI_INGEST_MAX_CONSOLE_ENTRY_CHARS: {
+    description: "Max characters stored per console entry.",
+    category: "ingest",
+    type: "number",
+    default: "2000",
+    min: 200,
+    max: 2e4
+  },
+  PIWI_INGEST_MAX_STEPS: {
+    description: "Max test steps stored per execution.",
+    category: "ingest",
+    type: "number",
+    default: "500",
+    min: 20,
+    max: 5e3
+  },
+  PIWI_INGEST_MAX_STEP_EVENTS: {
+    description: "Max step events stored per execution.",
+    category: "ingest",
+    type: "number",
+    default: "1000",
+    min: 20,
+    max: 1e4
+  },
+  PIWI_INGEST_MAX_ARIA_CHARS: {
+    description: "Max characters of the ARIA snapshot stored per failing execution.",
+    category: "ingest",
+    type: "number",
+    default: "100000",
+    min: 1e3,
+    max: 1e6
+  },
+  PIWI_INGEST_MAX_ERROR_CHARS: {
+    description: "Max characters of error text stored per execution (head and tail are kept).",
+    category: "ingest",
+    type: "number",
+    default: "20000",
+    min: 1e3,
+    max: 1e5
+  },
+  PIWI_INGEST_MAX_SAMPLE_ERROR_CHARS: {
+    description: "Max characters of the sample error stored per failure cluster.",
+    category: "ingest",
+    type: "number",
+    default: "50000",
+    min: 1e3,
+    max: 2e5
+  },
+  PIWI_INGEST_MAX_TEST_SOURCE_CHARS: {
+    description: "Max characters of the test source snippet stored per failing execution.",
+    category: "ingest",
+    type: "number",
+    default: "50000",
+    min: 1e3,
+    max: 2e5
+  },
+  PIWI_INGEST_MAX_SOURCE_FRAMES: {
+    description: "Max source stack frames stored per failing execution.",
+    category: "ingest",
+    type: "number",
+    default: "8",
+    min: 1,
+    max: 32
+  },
+  PIWI_INGEST_MAX_SOURCE_FRAME_CHARS: {
+    description: "Max characters per stored source frame snippet.",
+    category: "ingest",
+    type: "number",
+    default: "4000",
+    min: 500,
+    max: 2e4
+  },
+  PIWI_AUTO_MARKERS: {
+    description: "Automatically create a timeline marker when a run\u2019s environment, Playwright version, or reporter version changes from the previous run (default: enabled). Set to false to disable.",
+    category: "markers",
+    type: "boolean",
+    default: "true",
+    docs: "timeline-markers",
+    notes: "Only the exact value `false` disables auto-markers."
+  },
+  PIWI_TEST_LOGS_DISABLED: {
+    description: "Disable X-Piwi-Logs response header emission (default: auto-disabled in production, enabled in development).",
+    category: "testing",
+    type: "boolean",
+    docs: "backend-logs",
+    notes: "Unset: capture is on in development and off in production builds; `true` forces it off everywhere, `false` forces it on even in production."
+  },
+  // ── Failure clustering ───────────────────────────────────────────────────
+  PIWI_CLUSTER_SIMILARITY_THRESHOLD: {
+    description: "Cosine similarity (0\u20131) above which two failure embeddings merge into one cluster.",
+    category: "clustering",
+    type: "number",
+    default: "0.92",
+    min: 0,
+    max: 1,
+    relevantWhen: { PIWI_AI_EMBEDDING_MODEL: "*" },
+    notes: "Must be greater than 0 and at most 1; invalid values fall back to the default."
+  },
+  PIWI_CLUSTER_SUGGEST_THRESHOLD: {
+    description: "Similarity at which a failure is suggested (not auto-merged) as related to a cluster.",
+    category: "clustering",
+    type: "number",
+    default: "0.80",
+    min: 0,
+    max: 1,
+    relevantWhen: { PIWI_AI_EMBEDDING_MODEL: "*" },
+    notes: "Capped at the merge threshold."
+  },
+  // ── SMTP ─────────────────────────────────────────────────────────────────
+  PIWI_SMTP_HOST: {
+    description: "SMTP server hostname for outbound email.",
+    category: "smtp",
+    example: "smtp.example.com"
+  },
+  PIWI_SMTP_PORT: {
+    description: "SMTP port (default 587; 465 for implicit TLS).",
+    category: "smtp",
+    type: "number",
+    default: "587",
+    min: 1,
+    max: 65535,
+    relevantWhen: { PIWI_SMTP_HOST: "*" }
+  },
+  PIWI_SMTP_USER: {
+    description: "SMTP username. Optional \u2014 only when the server requires authentication.",
+    category: "smtp",
+    relevantWhen: { PIWI_SMTP_HOST: "*" }
+  },
+  PIWI_SMTP_PASS: {
+    description: "SMTP password. Optional \u2014 only when the server requires authentication. Never returned by the API.",
+    category: "smtp",
+    secret: true,
+    relevantWhen: { PIWI_SMTP_HOST: "*" }
+  },
+  PIWI_SMTP_FROM: {
+    description: "From address for outbound email (e.g. noreply@example.com).",
+    category: "smtp",
+    example: "noreply@example.com",
+    relevantWhen: { PIWI_SMTP_HOST: "*" },
+    requiredWhen: { PIWI_SMTP_HOST: "*" }
+  },
+  PIWI_SMTP_FROM_NAME: {
+    description: "Display name for the from address (optional).",
+    category: "smtp",
+    default: "Piwi Dashboard",
+    relevantWhen: { PIWI_SMTP_HOST: "*" }
+  },
+  PIWI_SMTP_SECURE: {
+    description: 'Set to "true" for implicit TLS on port 465 (default false \u2192 STARTTLS/plain).',
+    category: "smtp",
+    type: "boolean",
+    relevantWhen: { PIWI_SMTP_HOST: "*" },
+    notes: "Defaults to on when the port is 465, off otherwise."
+  },
+  // ── Wasted-time analysis ─────────────────────────────────────────────────
+  PIWI_WASTED_WAIT_PATTERNS: {
+    description: "Glob patterns (comma or newline separated) defining which wait steps count as wasted time. Locks the UI when set.",
+    category: "wasted-time",
+    type: "list",
+    default: "Wait for timeout*,*waitForTimeout*",
+    notes: "Case-insensitive globs (`*` and `?`) matched against a wait step\u2019s title or source location. Use `*` to count every wait."
+  },
+  // ── Demo / build mode ────────────────────────────────────────────────────
+  PIWI_DEMO_MODE: {
+    description: 'Set to "true" to build the standalone client-side demo SPA (no server).',
+    category: "demo",
+    runtimeOnly: true,
+    type: "boolean"
+  },
+  // ── Test harness only (not user settings) ────────────────────────────────
+  PIWI_BASE_URL: {
+    description: "Base URL the metadata test spec targets (defaults to http://localhost:3000).",
+    category: "test",
+    runtimeOnly: true
+  },
+  PIWI_POSTGRES_TEST_URL: {
+    description: "PostgreSQL connection string used by the Postgres test suite.",
+    category: "test",
+    runtimeOnly: true,
+    secret: true
+  },
+  PIWI_S3_TEST_BUCKET: {
+    description: "S3 bucket for the storage integration tests.",
+    category: "test",
+    runtimeOnly: true
+  },
+  PIWI_S3_TEST_REGION: {
+    description: "Region for the S3 storage integration tests.",
+    category: "test",
+    runtimeOnly: true
+  },
+  PIWI_S3_TEST_ACCESS_KEY_ID: {
+    description: "Access key id for the S3 storage integration tests.",
+    category: "test",
+    runtimeOnly: true,
+    secret: true
+  },
+  PIWI_S3_TEST_SECRET_ACCESS_KEY: {
+    description: "Secret access key for the S3 storage integration tests.",
+    category: "test",
+    runtimeOnly: true,
+    secret: true
+  },
+  PIWI_S3_TEST_ENDPOINT: {
+    description: "Custom endpoint for the S3 storage integration tests.",
+    category: "test",
+    runtimeOnly: true
+  },
+  PIWI_MAILPIT_URL: {
+    description: "Mailpit base URL; when set, the email/notification E2E tests run against it.",
+    category: "test",
+    runtimeOnly: true
+  },
+  PIWI_MAILPIT_SMTP_PORT: {
+    description: "SMTP port the email E2E tests send to (Mailpit).",
+    category: "test",
+    runtimeOnly: true
+  },
+  PIWI_EMAIL_SERVER_URL: {
+    description: "Base URL the email test spec targets.",
+    category: "test",
+    runtimeOnly: true
+  },
+  PIWI_TEST_CLEANUP_ENABLED: {
+    description: "Allow the E2E cleanup endpoint (`DELETE /api/tests/cleanup`) on a production build, which CI needs because it runs the suite against one. Never set it on a real deployment.",
+    category: "test",
+    runtimeOnly: true,
+    type: "boolean",
+    since: "0.19.0"
+  }
+};
+function getEnvVarMeta(name) {
+  return PIWI_ENV_VARS[name];
+}
+function envVarsByCategory(category) {
+  return Object.keys(PIWI_ENV_VARS).filter((name) => PIWI_ENV_VARS[name].category === category);
+}
+
+const _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  __name: "DocLink",
+  __ssrInlineRender: true,
+  props: {
+    to: {},
+    noIcon: { type: Boolean }
+  },
+  setup(__props) {
+    const props = __props;
+    const href = computed(() => docsUrl(props.to));
+    return (_ctx, _push, _parent, _attrs) => {
+      const _component_ULink = _sfc_main$l;
+      const _component_UIcon = _sfc_main$p;
+      _push(ssrRenderComponent(_component_ULink, mergeProps({
+        to: unref(href),
+        target: "_blank",
+        rel: "noopener noreferrer",
+        class: "inline-flex items-center gap-1 text-primary hover:underline"
+      }, _attrs), {
+        default: withCtx((_, _push2, _parent2, _scopeId) => {
+          if (_push2) {
+            ssrRenderSlot(_ctx.$slots, "default", {}, () => {
+              _push2(`Learn more`);
+            }, _push2, _parent2, _scopeId);
+            if (!__props.noIcon) {
+              _push2(ssrRenderComponent(_component_UIcon, {
+                name: "i-lucide-external-link",
+                class: "w-3.5 h-3.5 shrink-0"
+              }, null, _parent2, _scopeId));
+            } else {
+              _push2(`<!---->`);
+            }
+          } else {
+            return [
+              renderSlot(_ctx.$slots, "default", {}, () => [
+                createTextVNode("Learn more")
+              ]),
+              !__props.noIcon ? (openBlock(), createBlock(_component_UIcon, {
+                key: 0,
+                name: "i-lucide-external-link",
+                class: "w-3.5 h-3.5 shrink-0"
+              })) : createCommentVNode("", true)
+            ];
+          }
+        }),
+        _: 3
+      }, _parent));
+    };
+  }
+});
+const _sfc_setup$1 = _sfc_main$1.setup;
+_sfc_main$1.setup = (props, ctx) => {
+  const ssrContext = useSSRContext();
+  (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("components/shared/DocLink.vue");
+  return _sfc_setup$1 ? _sfc_setup$1(props, ctx) : void 0;
+};
+const __nuxt_component_9 = Object.assign(_sfc_main$1, { __name: "DocLink" });
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  __name: "HelpHint",
+  __ssrInlineRender: true,
+  props: {
+    topic: {},
+    title: {},
+    text: {},
+    doc: {},
+    envVars: {},
+    size: {}
+  },
+  setup(__props) {
+    const props = __props;
+    const { copy } = useCopy();
+    const entry = computed(() => props.topic ? HELP_TOPICS[props.topic] : null);
+    const title = computed(() => props.title ?? entry.value?.title);
+    const text = computed(() => props.text ?? entry.value?.text ?? "");
+    const doc = computed(() => props.doc ?? entry.value?.doc);
+    const envVars = computed(() => props.envVars ?? entry.value?.envVars);
+    const open = ref(false);
+    const ariaLabel = computed(() => title.value ? `Help: ${title.value}` : "Help");
+    const contentAttrs = computed(() => ({ side: "bottom", "aria-label": ariaLabel.value }));
+    return (_ctx, _push, _parent, _attrs) => {
+      const _component_UPopover = _sfc_main$8;
+      const _component_UButton = _sfc_main$k;
+      const _component_DocLink = __nuxt_component_9;
+      _push(ssrRenderComponent(_component_UPopover, mergeProps({
+        open: unref(open),
+        "onUpdate:open": ($event) => isRef(open) ? open.value = $event : null,
+        content: unref(contentAttrs),
+        ui: { content: "max-w-xs p-3 text-sm" }
+      }, _attrs), {
+        content: withCtx((_, _push2, _parent2, _scopeId) => {
+          if (_push2) {
+            if (unref(title)) {
+              _push2(`<p class="font-medium mb-1"${_scopeId}>${ssrInterpolate(unref(title))}</p>`);
+            } else {
+              _push2(`<!---->`);
+            }
+            _push2(`<p class="text-muted"${_scopeId}>${ssrInterpolate(unref(text))}</p>`);
+            if (unref(envVars)?.length) {
+              _push2(`<div class="mt-2 space-y-1"${_scopeId}><p class="text-muted text-xs"${_scopeId}>Environment variable${ssrInterpolate(unref(envVars).length > 1 ? "s" : "")}:</p><div class="flex flex-col gap-1.5"${_scopeId}><!--[-->`);
+              ssrRenderList(unref(envVars), (v) => {
+                _push2(`<button type="button" class="group text-left"${ssrRenderAttr("title", `Click to copy ${v}`)}${_scopeId}><code class="block font-mono text-xs bg-elevated rounded px-1.5 py-0.5 select-all cursor-pointer group-hover:ring-1 ring-default"${_scopeId}>${ssrInterpolate(v)}</code>`);
+                if (unref(getEnvVarMeta)(v).description) {
+                  _push2(`<span class="block text-muted text-[11px] mt-0.5"${_scopeId}>${ssrInterpolate(unref(getEnvVarMeta)(v).description)}</span>`);
+                } else {
+                  _push2(`<!---->`);
+                }
+                _push2(`</button>`);
+              });
+              _push2(`<!--]--></div></div>`);
+            } else {
+              _push2(`<!---->`);
+            }
+            if (unref(doc) || unref(envVars)?.length) {
+              _push2(`<div class="mt-2 flex flex-col gap-1"${_scopeId}>`);
+              if (unref(doc)) {
+                _push2(ssrRenderComponent(_component_DocLink, { to: unref(doc) }, {
+                  default: withCtx((_2, _push3, _parent3, _scopeId2) => {
+                    if (_push3) {
+                      _push3(`Learn more`);
+                    } else {
+                      return [
+                        createTextVNode("Learn more")
+                      ];
+                    }
+                  }),
+                  _: 1
+                }, _parent2, _scopeId));
+              } else {
+                _push2(`<!---->`);
+              }
+              if (unref(envVars)?.length) {
+                _push2(ssrRenderComponent(_component_DocLink, { to: "configuration" }, {
+                  default: withCtx((_2, _push3, _parent3, _scopeId2) => {
+                    if (_push3) {
+                      _push3(`Configuration reference`);
+                    } else {
+                      return [
+                        createTextVNode("Configuration reference")
+                      ];
+                    }
+                  }),
+                  _: 1
+                }, _parent2, _scopeId));
+              } else {
+                _push2(`<!---->`);
+              }
+              _push2(`</div>`);
+            } else {
+              _push2(`<!---->`);
+            }
+          } else {
+            return [
+              unref(title) ? (openBlock(), createBlock("p", {
+                key: 0,
+                class: "font-medium mb-1"
+              }, toDisplayString(unref(title)), 1)) : createCommentVNode("", true),
+              createVNode("p", { class: "text-muted" }, toDisplayString(unref(text)), 1),
+              unref(envVars)?.length ? (openBlock(), createBlock("div", {
+                key: 1,
+                class: "mt-2 space-y-1"
+              }, [
+                createVNode("p", { class: "text-muted text-xs" }, "Environment variable" + toDisplayString(unref(envVars).length > 1 ? "s" : "") + ":", 1),
+                createVNode("div", { class: "flex flex-col gap-1.5" }, [
+                  (openBlock(true), createBlock(Fragment, null, renderList(unref(envVars), (v) => {
+                    return openBlock(), createBlock("button", {
+                      key: v,
+                      type: "button",
+                      class: "group text-left",
+                      title: `Click to copy ${v}`,
+                      onClick: ($event) => unref(copy)(v, { toast: `Copied ${v}` })
+                    }, [
+                      createVNode("code", { class: "block font-mono text-xs bg-elevated rounded px-1.5 py-0.5 select-all cursor-pointer group-hover:ring-1 ring-default" }, toDisplayString(v), 1),
+                      unref(getEnvVarMeta)(v).description ? (openBlock(), createBlock("span", {
+                        key: 0,
+                        class: "block text-muted text-[11px] mt-0.5"
+                      }, toDisplayString(unref(getEnvVarMeta)(v).description), 1)) : createCommentVNode("", true)
+                    ], 8, ["title", "onClick"]);
+                  }), 128))
+                ])
+              ])) : createCommentVNode("", true),
+              unref(doc) || unref(envVars)?.length ? (openBlock(), createBlock("div", {
+                key: 2,
+                class: "mt-2 flex flex-col gap-1"
+              }, [
+                unref(doc) ? (openBlock(), createBlock(_component_DocLink, {
+                  key: 0,
+                  to: unref(doc)
+                }, {
+                  default: withCtx(() => [
+                    createTextVNode("Learn more")
+                  ]),
+                  _: 1
+                }, 8, ["to"])) : createCommentVNode("", true),
+                unref(envVars)?.length ? (openBlock(), createBlock(_component_DocLink, {
+                  key: 1,
+                  to: "configuration"
+                }, {
+                  default: withCtx(() => [
+                    createTextVNode("Configuration reference")
+                  ]),
+                  _: 1
+                })) : createCommentVNode("", true)
+              ])) : createCommentVNode("", true)
+            ];
+          }
+        }),
+        default: withCtx((_, _push2, _parent2, _scopeId) => {
+          if (_push2) {
+            _push2(ssrRenderComponent(_component_UButton, {
+              size: __props.size ?? "xs",
+              variant: "ghost",
+              color: "neutral",
+              icon: "i-lucide-circle-help",
+              "aria-label": unref(ariaLabel),
+              title: "What is this?",
+              class: "text-muted hover:text-default align-middle"
+            }, null, _parent2, _scopeId));
+          } else {
+            return [
+              createVNode(_component_UButton, {
+                size: __props.size ?? "xs",
+                variant: "ghost",
+                color: "neutral",
+                icon: "i-lucide-circle-help",
+                "aria-label": unref(ariaLabel),
+                title: "What is this?",
+                class: "text-muted hover:text-default align-middle"
+              }, null, 8, ["size", "aria-label"])
+            ];
+          }
+        }),
+        _: 1
+      }, _parent));
+    };
+  }
+});
+const _sfc_setup = _sfc_main.setup;
+_sfc_main.setup = (props, ctx) => {
+  const ssrContext = useSSRContext();
+  (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("components/shared/HelpHint.vue");
+  return _sfc_setup ? _sfc_setup(props, ctx) : void 0;
+};
+const __nuxt_component_2 = Object.assign(_sfc_main, { __name: "HelpHint" });
+
+export { __nuxt_component_2 as _, __nuxt_component_9 as a, docsUrl as d, envVarsByCategory as e, getEnvVarMeta as g };
+//# sourceMappingURL=HelpHint-C96TlqxY.mjs.map