Specs & ADRs¶
Design decisions that still describe the code. The code is the source of truth; see Architecture Overview and Deep Dive - Execution Logic for how it fits together.
| Topic | Note |
|---|---|
Packaging as a library (qasight) |
Library Packaging |
| Database-agnostic storage | Repository Pattern - Database-Agnostic Refactor |
| Any test runner as a stage | Command Adapter and JUnit Import |
| Run-to-run delta | Phase 3 Delta Comparison Engine Plan → Delta Comparison Policy |
| Unified dashboard | Phase 3 Unified Dashboard Plan |
| BYOK AI failure summaries | Phase 4 BYOK and Failure Analysis |
| Cycles-first UI | Phase 5 UI Redesign - Cycles-First Navigation |
| Navy glass look and sidebar | UI Restyle - 2026-10-19 |
| One engine, generated API types, blocking type checks | Architecture Consolidation - 2026-10-06 |
| Architecture review: read-side scaling, migrations, layering enforcement (proposals only) | Architecture Review - 2026-10-31 |
| Test labels and issue links, then environments, chosen-test runs and releases (gaps found next to Allure TestOps) | Test Labels, Environments and Releases - 2026-11-02 |
| Better flaky signal: retries, same-commit results, flips per branch, broken kept apart | Better Flaky Signal - 2026-11-01 |
| Importer and integration bug hunt: ranked findings, fixes and proposals | Importer and Integration Bug Hunt - 2026-10-31 |
| Engine fixes from the bug hunt: one run of a cycle at a time, and the other proposals | Engine Fixes - 2026-11-01 |
| Interview-readiness batch (pull requests 67 to 91, v1.1.0) | Interview Readiness Fixes - 2026-10-07 |
Docs vault as second brain, wiki generated from docs/ |
Docs Vault and Wiki Sync - 2026-10-07 |
| Post-publish features: flaky tests, PR comments, plugins, adapters | Open Source Features - 2026-10-19 |
| Run summary and PR comment from the GitHub Action | GitHub Action PR Comment - 2026-10-19 |
| Getting Started guide and the MkDocs docs site | Docs Site - 2026-10-19 |
| Third-party frameworks and reporters through entry points | Plugin API - 2026-10-19 |
| Playwright as its own equipment | Playwright Adapter - 2026-10-19 |
| Time to fix failing tests, suite and CI time, default-branch red time, and the waves of report metrics after them | Test Delivery Metrics - 2026-11-02 |
| Getting results out: copy menus, a manager report, PDF, PNG, CSV, XLSX and PowerPoint | Exporting Results - 2026-11-01 |
| Deleting chosen runs, stopping a run from the UI, and showing how long runs are kept | Run Deletion and Stop - 2026-11-02 |
| Quarantining flaky tests so they don't fail the run | Flaky Test Quarantine - 2026-10-22 |
Quarantine from the UI, API or qasight quarantine, kept on the server and applied to ingest and pytest --qasight too |
Quarantine From the UI - 2026-11-01 |
Running only the tests a change can affect (qasight affected, pytest --qasight-affected) |
Affected Test Selection - 2026-10-30 |
| Pools of keys (VMs, devices, accounts) leased to parallel workers | Resource Pools and Leases - 2026-10-26 |
| Checking keys, clean releases and a delay before reusing an expired key | Resource Lifecycle Hooks - 2026-10-26 |
| A provider of your own commands that never creates or deletes VMs on its own | Human-Run Resource Provider - 2026-10-30 |
| Playwright JSON reports: retries, flaky tests, traces | Playwright JSON Import - 2026-10-22 |
One-command setup for existing projects: qasight init, the zero-config Action, per-CI snippets, a PR comment preview |
Easy Setup - 2026-11-01 |
| Reading Jest/Vitest, .NET, Go, Robot, RSpec, k6, XCTest, Android and Allure results in their own formats | Runner Coverage - 2026-10-26 |
| Runs, stages and tests as OpenTelemetry traces (OTLP), off by default | OpenTelemetry Export - 2026-10-30 |
The run history as an MCP server for coding agents (qasight mcp), read-only by default |
MCP Server - 2026-11-01 |
| Coverage on the PR comment, weekly digest, secrets hidden in stored results, backup and restore, failed-first ordering | Free Copies of Paid Features - 2026-11-01 |
| The failing test's own source in AI failure summaries, opt-in and size-capped | Test Source in AI Summaries - 2026-11-01 |
| Security and fresh-install review: findings R1 to R18, fixes and proposals | Security and Install Review - 2026-10-31 |
| Slack and Teams alerts, failure annotations on the diff, flaky test issues | Alerts Where Developers Look - 2026-10-22 |
| A GitHub issue per test that turns flaky, assigned from CODEOWNERS and closed once it is stable | Flaky Test Issues - 2026-11-01 |
| BehaveX HTML report plus Allure results | BehaveX Reports - 2026-10-21 |
JSON Schema for qasight.yaml (editor autocomplete) |
Config JSON Schema - 2026-10-22 |
Record results from any CI (qasight ingest) and a shared team server |
Ingest and Team Server - 2026-10-22 |
| Capped concurrent API runs and opt-in parallel stages | Scale Runs and Stages - 2026-10-24 |
| Optional persistent run queue and per-user accounts, off by default | Switchable Team Features - 2026-10-24 |
| Running each server-started stage in a throwaway container, off by default | Throwaway Stage Containers - 2026-10-24 |
| Changelog enforcement | changelog_automation_policy.md |
| Product roadmap from the product review (failing tests first, and what follows) | Product Roadmap Work - 2026-10-25 |
| Product review second pass: every area except trust toward 10 | Product to Ten - 2026-10-25 |
| Project health page: a repeatable test health score and an optional AI review of the tests | Project Health - 2026-10-26 |
| README badge, asking about your tests, Jira issues from failures (and what was not built) | Qualflare Follow-ups - 2026-10-26 |
| Naming stack overflows and crashes on failing stages and tests | Crash Detection - 2026-10-31 |
| UI design review: ranked design and UX findings with annotated screenshots, 7.5 / 10 | UI Design Review - 2026-10-31 |
| Engineering health review: tests, CI, docs accuracy and dependencies, fixes in #222 and ranked proposals | Engineering Health Review - 2026-10-31 |
| UI review fixes: cycle results, run labels, Compare test list, test page charts, quieter cards | UI Review Fixes - 2026-11-01 |
| Collapsible cards, 3-row lists, made-up examples in the live demo | Tidy Cards and Demo Examples - 2026-11-05 |
| Automating the new user journey: setup pull request, fork comments, AI summaries in CI, automatic quarantine, MCP install, backups | New User Journey Automation - 2026-11-01 |
| Lifecycle fixes from the year-two review: storage limits and visibility, runs that die mid-way, token rotation | Lifecycle Fixes - 2026-11-02 |
The rename from Testosterone (testo-core, testo) to QASight (qasight), and the old names that keep working |
Rename to QASight - 2026-11-04 |
| The QASight logo: the eye and the name, where its files come from and how they are rendered | QASight Logo - 2026-11-05 |
Older plans and incident write-ups (Allure 3 migration plan, reporters port, report-links fix, CLI–UI parity, the doctor/clean/watch/init restore) are in the Archive.