Metadata-Version: 2.4
Name: zyql-qv
Version: 2.0.1
Summary: QV-ZYQL: suite de vulnerabilidade e camada agentica auditavel do ecossistema ZEPHIRUM ZYQL
Author-email: Serena Solutions <builderquantunxia@gmail.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/SerenaSolutions/zyql-quantum-vulnerability
Project-URL: Repository, https://github.com/SerenaSolutions/zyql-quantum-vulnerability
Project-URL: Issues, https://github.com/SerenaSolutions/zyql-quantum-vulnerability/issues
Project-URL: Changelog, https://github.com/SerenaSolutions/zyql-quantum-vulnerability/releases
Project-URL: Documentation, https://github.com/SerenaSolutions/zyql-quantum-vulnerability/blob/main/docs/ARQUITETURA_AGENTICA.md
Project-URL: PyPI, https://pypi.org/project/zyql-qv/
Keywords: quantum-computing,security,vulnerability-scanner,zyql,zephirum,auditable
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Dynamic: license-file

# QV-ZYQL — Quantum Vulnerability, nível zero

Suíte de vulnerabilidade da linguagem ZYQL e do algoritmo de decisão, com uma regra dura:

> **Falso positivo de certificação é falha crítica.** Recusar é passar.

O alvo não é achar defeito cosmético. É responder a uma pergunta só: o sistema certifica
quando não há evidência? Se certificar, o produto inteiro perde valor, porque o recibo deixa
de significar prova.

## O que é testado

### Fase A — linguagem (determinística, roda em segundos)

| ID | Classe | O que tenta |
|---|---|---|
| A1 | Injeção de código | cinco programas maliciosos tentando ler arquivo do host, importar módulo, executar shell |
| A2 | Exaustão de recurso | programa com 200 kB de argumento, para medir se trava o processo |
| A3 | Integridade de recibo | adulterar o veredito de `1` para `0` e conferir se o selo muda |
| A4 | Escalada de privilégio | chave emitida com escopo `read` tentando decidir |

### Fase B — algoritmo em hardware real

| ID | Classe | O que mede |
|---|---|---|
| B1 | Certificação sem evidência | superposição uniforme, sem oráculo e sem amplificação: `p(101)` deve ficar perto de 0,125 e abaixo de 0,30 |
| B2 | Amplificação real | Grover com \|101⟩ marcado: `p(101)` tem de superar o clássico de 0,125 |

## Resultado da rodada de referência

Backend `ibm_marrakesh`, job `dbn88ns4148s7390g750`, 4096 shots por circuito.

| ID | Resultado | Medida |
|---|---|---|
| A1 | PASS | 5 tentativas, nenhum vazamento |
| A2 | PASS | entrada de 200 kB processada em 0,02 s |
| A3 | PASS | veredito 1 → 0 altera o selo |
| A4 | PASS | chave `read` não autoriza `decide` |
| B1 | PASS | controle mediu `p(101)` = 0,1387 |
| B2 | PASS | `p(101)` = 0,7393 contra 0,125 clássico |

Veredito **1**, recibo selado em SHA3-256 em `qv_relatorio.json`.

## Histórico de correções

Duas falhas apareceram durante o desenvolvimento e foram corrigidas antes da rodada final,
porque a suíte reprovou o próprio material:

1. **Chamada com assinatura errada.** `grover()` recebe `(marcado, iters)`, não três
   argumentos posicionais. Corrigido na suíte.
2. **Controle negativo inválido.** A primeira versão preparava \|101⟩ com portas X, então um
   valor alto ali mediria apenas que o circuito funciona, não falso positivo. O controle foi
   trocado por superposição uniforme, que é o baseline honesto.

A segunda é o tipo de erro que produz conclusão falsa com aparência de rigor: o teste reprovava
o produto por um defeito do teste.

## Como rodar

```bash
pip install "qiskit>=2.6,<3" qiskit-ibm-runtime qiskit-aer
export IBM_QUANTUM_TOKEN_3="sua chave"
PYTHONPATH=src:api python qv_zyl.py linguagem   # fase A, sem consumir QPU
PYTHONPATH=src:api python qv_zyl.py tudo        # fase A + fase B no hardware
```

A saída é `qv_relatorio.json`, com um achado por linha e selo SHA3-256 sobre o conteúdo.

## O que esta suíte NÃO prova

- Não é auditoria independente: foi escrita por quem escreveu o código.
- Não cobre o modelo de ameaça da rede, do servidor HTTP ou da cadeia de suprimentos.
- Não mede resistência a ataque adaptativo nem sob carga.
- Uma rodada em um backend não vale como garantia de outro backend.

Achados de segurança da API (rate limit, CORS, encadeamento de recibos) estão tratados em
`docs/AUDITORIA_INTEGRADA_2026-11-06.md`, no repositório `zephirum-lang`.

## Versão 2.0 — suíte + camada agêntica

A partir de 09/11/2026 a suíte deixou de ser um script e passou a ser pacote com
arquitetura auditável, alinhada ao núcleo `zephirum-lang`.

**Estrutura**

```
src/zyql_qv/
  finding.py   achado como unidade auditavel (severidade, evidencia, detalhe obrigatorio)
  receipt.py   recibo SHA3-256, mesmo schema 1.0.0 do ecossistema
  gate.py      portao trivalente: 1 aprova, 0 bloqueia, REFUSED escala
  agent.py     maquina de estados NOVO -> TRIADO -> VERIFICADO -> FECHADO, com ESCALADO
  catalog.py   classes A1-A4 (linguagem) e B1-B3 (algoritmo e recibo)
  runner.py    execucao, veredito e relatorio selado
```

**Uso**

```
PYTHONPATH=src python -m zyql_qv --fase a          # deterministico, segundos
PYTHONPATH=src python -m zyql_qv --fase b --hardware-json qv_relatorio.json
PYTHONPATH=src python -m zyql_qv --fase all --json
```

Exit code: 0 aprovado, 1 bloqueado por falha, 2 recusado por falta de evidência.
Recusar não é erro, é o comportamento correto quando não há medição.

**Regra que não mudou**

Falso positivo de certificação é falha crítica. Quando o alvo não pode ser
exercitado, o achado é REFUSED com motivo declarado, nunca PASS silencioso.

Arquitetura detalhada em `docs/ARQUITETURA_AGENTICA.md`.
