DOCUMENTATION

Getting Started with QuantumVerifi

Learn how to use our software analysis platform to validate your code, generate tests, and improve quality.

01ANALYSIS MODES

Analysis Modes

02GUIDES

Guides

Quick Start

Get your first analysis running in under 2 minutes.

  1. Sign up or sign in to your account
  2. Navigate to the Analyze page
  3. Enter a GitHub repository URL
  4. Click "Start Analysis" and wait for results

Understanding Grades

How the A-F grading system works.

  1. Grade A (90-100): Production-ready, all tests pass
  2. Grade B (80-89): Good quality, minor issues
  3. Grade C (70-79): Acceptable, some fixes needed
  4. Grade D (60-69): Below average, significant issues
  5. Grade F (<60): Not ready, major problems

Self-Healing Pipeline

How automatic test repair works.

  1. Tests are validated through 4 stages: Syntax, Compile, Execute, Grade
  2. Failed tests are automatically repaired up to 3 times
  3. Error context feeds Quantum Intelligence for targeted fixes
  4. Final grade reflects the validated, working tests
03REPOSITORY ANALYSIS

Repository Analysis

Clone → Understand → Generate → Validate → Grade

What happens when you point us at a Git repository.

  1. Clone — a shallow clone of your repo into an isolated temp workspace
  2. Detect — language, framework, and entry points (165+ languages parsed via tree-sitter AST)
  3. Baseline — current health and existing test coverage, so the grade reflects real improvement
  4. Understand — the model reads the codebase to learn its structure, dependencies, and conventions
  5. Generate — unit + integration tests via LLM tool-calling, 5 workers in parallel
  6. Validate — every test runs the syntax → compile → execute pipeline in an ephemeral cloud sandbox
  7. Self-heal — failing tests are clustered, regenerated, and re-run (up to 3× on paid plans)
  8. Grade — an A–F score backed only by tests that actually compiled and passed

Proven, not just generated

Mutation scoring proves the tests catch real bugs.

A test that never fails proves nothing. QuantumVerifi deliberately introduces bugs (mutants) into your code and re-runs the generated suite — a test that stays green against a broken mutant is flagged, and one that catches it is proven. The result is a mutation score, not just a pass rate.

Every generated file, sandbox run, and result is SHA-256-sealed into a replayable evidence chain.

04WEBSITE E2E TESTING

Website E2E Testing

Learn the site, then test it like a user

Real browser E2E tests generated from a live URL.

  1. Crawl — discover routes, forms, and user journeys from your live site
  2. See — screenshots + visual AI identify headers, forms, modals, and key UI regions
  3. Prioritise — flows are ranked P0/P1/P2 so the most important journeys are covered first
  4. Generate — real Playwright or Cypress tests for those journeys
  5. Execute — tests run in ephemeral cloud browser sandboxes, destroyed after the run
  6. Score — coverage × stability × risk, not a raw pass count

Behind the login

Gatekeeper tests authenticated areas — without storing credentials.

Connect your identity provider once (Clerk or generic OIDC). Per run, QuantumVerifi mints a fresh session server-side for a test user you designate, then proves access differentially — reached as the authorised user, denied as an unauthorised one.

Credentials are never stored, sessions expire with the run, and access is sealed into a tamper-evident Credential Receipt.

05API CONTRACT TESTING

API Contract Testing

Five Protocols, One Workflow

Auto-detect and test any API protocol.

QuantumVerifi auto-detects your API protocol from the spec content or URL, then generates protocol-aware tests with the correct transport, error handling, and security checks.

  1. RESTOpenAPI/Swagger specs — HTTP verb + path assertions, status code validation
  2. GraphQLIntrospection discovery — single-endpoint queries, response.data.errors checks, query depth testing
  3. gRPCServer reflection — service/method calls, gRPC status codes, Protocol Buffer validation
  4. WebSocketConnection lifecycle — connect, send, receive, close with async message assertions
  5. SOAPWSDL parsing — XML envelope construction, SOAPAction headers, SOAP Fault handling

Protocol-Specific Security

Each protocol has its own attack surface.

  1. REST — OWASP Top 10: broken auth, injection, mass assignment, CORS misconfiguration
  2. GraphQL — Introspection exposure, query depth DoS, batch query attacks, field-level authorisation
  3. gRPC — Reflection exposure, metadata injection, certificate pinning, message size limits
  4. WebSocket — Origin validation, auth on upgrade, message injection, connection flooding
  5. SOAP — XXE attacks, WSDL information disclosure, WS-Security, XML bomb, action spoofing
06LOAD TESTING

Load Testing

Generate a k6 script, run it from the cloud, score it

Performance testing from just a URL.

  1. Target — point at a URL, or let auto-journey weight the routes real users actually hit
  2. Generate — QuantumVerifi writes a k6 load-test script for the chosen targets
  3. Execute — the script runs in a cloud sandbox at your chosen concurrency
  4. Measure — p95 / p99 latency, error rate, and throughput are captured
  5. Score — graded A–F against your thresholds (e.g. p95 < 500ms, error rate < 1%)

Four Load Profiles

Pick the shape of traffic you want to simulate.

  1. Baseline1 virtual user · 30s — establish a clean single-user baseline
  2. Load10 virtual users · 60s — normal expected traffic
  3. Stress50 virtual users · 120s — find where performance degrades
  4. Spike100 virtual users · 60s — a sudden traffic surge
07REQUIREMENT PROOF

Requirement Proof

Route each requirement to the engine that can prove it

Classify → Route → Execute → Ratify.

Paste or upload your requirements, point QuantumProof at a URL and/or a repository, and it proves each one against your actual system — never against a semantic match to the wording.

  1. Classify — each requirement is sorted into one of 12 classes (behavioural, data, security, performance, contract…)
  2. Route — the class selects the strongest oracle: repo unit tests, live API probes, browser E2E, k6 load, consumer contract, or eval
  3. Execute — that engine runs a real probe against your app and records what it observed
  4. Ratify — coverage is granted only from executed evidence; a requirement with no route to run stays honestly uncovered

The Requirement Evidence Matrix

Every requirement, every verdict, with receipts.

  1. Ratifiedexecuted evidence satisfies the oracle — covered
  2. Mutation-provengold tier: a deliberately-broken mutant made the test fail, proving it actually bites — covered
  3. Weakthe oracle needs a signal we can't observe (a backend read, human judgement) — honest, never shown green
  4. Gap / Contradictionthe behaviour is missing, or it directly violates the requirement
  5. Driftbehaviour exists with no matching requirement — your docs are stale

Only Ratified and Mutation-proven count as covered. The constitution: candidate → executed → ratified → mutation-proven — a weak oracle never shows green.

08CONSUMER CONTRACT

Consumer Contract

Consumer-driven contracts, without the contracts

Derive the contract from the consumer's code, then verify the provider.

No hand-written pact files to maintain. Point QuantumVerifi at a consumer repository and a provider URL, and it infers the contract from what the code actually uses.

  1. Clone — the consumer repository
  2. Derive — tree-sitter reads the call sites to find exactly which request fields, response fields, and status codes the consumer actually depends on (the Derived Consumer Contract)
  3. Probe — call the live provider
  4. Verify — confirm the provider still returns everything the consumer reads
  5. Seal — a tamper-evident contract verdict, bound to the evidence chain

De-risk the change before it ships

Gate a provider change against every consumer.

Point it at a proposed OpenAPI spec and it checks whether the change would break any registered consumer — so a field rename or a removed status code is caught in review, not in production.

Because the contract is derived from real code, it only ever asserts what a consumer genuinely reads — no over-specified pacts that break on harmless changes.

09ATTACK RESILIENCE

Attack Resilience

What is Attack Resilience?

Non-destructive adversarial probing of your live website.

Attack Resilience probes your website with 40+ adversarial payloads to measure how well your application resists being misused. It covers XSS, SQL injection, path traversal, auth boundary violations, encoding abuse, and more.

All probing is non-destructive — GET and POST only, rate limited, with sensitive paths skipped automatically. Safe for production.

Three Testing Domains

Weighted scoring adapts to your attack surface.

  1. Web Resilience (35%)XSS (8 variants), CSRF token checks, path traversal, open redirects, information disclosure (.env, .git, debug endpoints)
  2. API Resilience (30%)Auth boundary probing (unauthenticated access), rate limit testing, schema manipulation (mass assignment, type confusion)
  3. Input Resilience (35%)SQL injection (error + blind), boundary values (10KB strings, NaN), encoding abuse (homoglyphs, null bytes), type confusion

Weights adjust automatically — if your site has no forms, form-based attacks don't penalise your score.

Safety Controls

Built-in safeguards for production use.

  1. Host boundary — all requests stay on the same origin
  2. Non-destructive — GET and POST only, no PUT/DELETE/PATCH
  3. Sensitive path denylist — skips /logout, /delete, /payment, /checkout
  4. Rate limiting — 200ms delay between probes + circuit breaker on 429/403
  5. Budget caps — max 15 targets, 10 probes per target, 60 total probes
10AI RESILIENCE

AI Resilience Testing

What is AI Resilience?

Automated adversarial testing for AI-powered features.

If your website has a chatbot, AI search bar, or virtual assistant, it has an attack surface. AI Resilience testing probes these surfaces with 25 adversarial strategies to identify vulnerabilities before attackers do.

Testing runs automatically as part of URL analysis — no extra configuration needed. QuantumVerifi detects AI surfaces during crawling, then runs multi-turn adversarial conversations in sandboxed browsers.

The Six Attack Categories

Mapped to the OWASP LLM Top 10.

  1. Prompt Injection (LLM01)Overriding AI instructions with injected prompts — persona hijacking, authority override, multi-turn escalation
  2. System Prompt Extraction (LLM06)Revealing internal instructions — reflection requests, context overflow, chain-of-thought extraction
  3. Policy Bypass (LLM01)Getting the AI to produce content it should refuse — role-play, task decomposition, few-shot poisoning
  4. Data Exfiltration (LLM06)Leaking training data, user data, or credentials — inference probing, credential extraction
  5. Tool Misuse (LLM07)Manipulating AI tools — attacker-controlled parameters, tool chain attacks
  6. Indirect Injection (LLM01)Injecting instructions through documents, URLs, or form fields the AI processes

Understanding Your Score

How the resilience score is calculated.

  1. Each strategy produces a verdict: Defended (100 pts), Partial Leak (40 pts), Inconclusive (20 pts), Failed (0 pts)
  2. Every verdict is double-checked by an adversarial reviewer — preventing hallucinated scores
  3. Category scores are weighted by severity and aggregated into an overall 0-100 score
  4. Grade A (90+): Strong guardrails. Grade F (<60): Minimal or no defences — common for default chatbot configs
  5. Findings include full conversation replays, judge verdicts, and structured remediation steps
11TRAINING ENGINE

Training Engine

The Learning Flywheel

Every analysis makes future analyses better.

  1. Analyse — run a normal analysis (URL, repo, API, or perf)
  2. Harvest — the system extracts successful outcomes as training episodes (passing tests, accurate findings)
  3. Train — fine-tune a QLoRA adapter on your episodes (15-45 min on GPU)
  4. Route — activate the adapter so future analyses use your fine-tuned model
  5. Repeat — the fine-tuned model produces better results, which become better episodes

Why Fine-Tune?

Cost, speed, and relevance.

  1. Cost — fine-tuned 14B model costs ~$0.01/analysis vs ~$0.08 for GPT-4.1 (8x reduction)
  2. Speed — smaller models generate tokens 2-3x faster than large API models
  3. Relevance — after 50+ analyses, the adapter knows your test framework, imports, and error patterns
  4. Privacy — your adapter is private to your tenant, trained on your data only

Available on Scale and Enterprise plans. Read the full guide.

12API REFERENCE

API Reference

The QuantumVerifi API allows you to programmatically trigger analyses and retrieve results.

# Create an analysis
POST /api/v1/analyses
# Get analysis status
GET /api/v1/analyses/:id
# Stream progress (SSE)
GET /api/v1/analyses/:id/stream

Full API documentation coming soon.

08SUPPORT

Need Help?

If you have questions or need assistance, contact our support team:

[email protected]
← Back to home