Repository navigation
Releases
ZEPHIRUM 2.5.10
Primeira release do nucleo com recibo estatistico completo.
intervalo_exato(Clopper-Pearson), sem dependencia externa, publicado no recibo como relato.- Adaptador qBraid com negociacao de capacidades e conversao para portas nativas.
zephirum.__version__agora acompanha o pyproject, corrigindo o 2.5.9.- Piso de qiskit elevado para 2.6.1 pelas correcoes de QPY e QASM3.
Archived on Zenodo: 10.5281/zenodo.24250453 (concept DOI 10.5281/zenodo.23632019). Synced automatically by the ZENODO_SYNC action.
v2.5.9 — guardas de entrada, cota de erro honesta e intervalo de Wilson
Corrigido
shots=0levantavaZeroDivisionErrorcru; agoraValueErrorcom mensagem.epsilonfora de (0, 1] e tipos invalidos (shots=2048.5,'2048',None,n=-1)
passam a ser recusados na entrada, em vez de estourar excecao de biblioteca.- Oráculo que devolve valor fora de {0, 1} (
2,None,'1') era lido em silencio como
constante 0; agora levantaValueError.True/Falsecontinuam validos: a convencao
declarada ef == 1 em todo ponto -> DECIDE 1. error_boundpor Hoeffding podia passar de 1 com poucos shots, o que nao significa
nada como cota de probabilidade. Passa a ser limitado a 1, comerror_bound_rawe
error_bound_clampedexpondo o valor original.
Adicionado
wilson_interval(k, n, delta)em stdlib pura, e os camposp_lo/p_hi/
interval_ruleem todo veredito: intervalo que fica dentro de [0, 1] por construcao.tests/test_input_validation.py, 8 casos cobrindo as guardas acima.
Publicado no PyPI em 13/11/2026 (17h18 UTC), wheel zephirum-2.5.9-py3-none-any.whl. Tag v2.5.9.
- Perfil de evidência para medida clássica (
MEASURE): a incerteza declara o método
(amostra ou expandida, com fator de coberturak), e a obrigação declara quais
tipos de evidência a quitam. O padrão segue fechado em apenas quântico. - Três defesas ativas: obrigação quântica recusa medida clássica;
MEASUREsemk
é recusada; tipo de evidência desconhecido é recusa, nunca omissão. - Bateria de metrologia: 20 casos com veredito previsto antes da execução, 19/20,
com 5/5 nos casos de bancada clássica.
pip install zephirum==2.5.9 · PyPI: https://pypi.org/project/zephirum/2.5.9/ · DOI conceito: 10.5281/zenodo.23632019
Archived on Zenodo: 10.5281/zenodo.24206164 (concept DOI 10.5281/zenodo.23632019). Synced automatically by the ZENODO_SYNC action.
v0.5.0 — ZYQL Decision Gate (Marketplace)
Listagem do Marketplace corrigida e outputs do gate funcionando
O Marketplace publica o action.yml da release. Esta release carrega o que foi
mergeado em #79 e o que veio depois:
- Descrição honesta: "Block or pass a workflow on an auditable decision: verdict
1, 0, REFUSED or INCONCLUSIVE, sealed in a SHA3-256 receipt". Antes prometia
"signed receipt" quando o gate sela e não assina. verdictereceiptsão exportados de verdade. Na v0.4.0 eram declarados e
nunca escritos.- README com a seção Use it in CI: workflow, tabela de inputs, a regra
declarada (p_hat,eps, limiar) e o aviso de queINCONCLUSIVEnão reprova
por padrão. - Nenhum nome de dispositivo e nenhum job_id em material público; os selos
SHA3-256 seguem publicados e verificáveis. pip install zephirum==2.5.7 || trueremovido do passo: o script é stdlib.
Correção crítica de verificação (entra no pacote 2.5.8)
Recibo recém-gerado era reportado como adulterado por zqgate verify e
qroute verify, porque os verificadores liam a chave sha3_256 com
separadores compactos e o interpretador grava selo_sha3_256 com o canon da
casa. Agora há um verificador único (zqea_canon), uma regra normativa e as
variantes históricas aceitas; adulterar um valor continua sendo detectado.
Requisito
Pin SerenaSolutions/zephirum-lang@v0.5.0 para usar os outputs.
v0.4.0 — ZYQL Decision Gate
Action composta que reprova um workflow quando a decisao nao e sustentada pela evidencia.
Entradas: shots, counts, threshold, delta, fail_on.
Saidas: verdict (1, 0, REFUSED, INCONCLUSIVE) e caminho do recibo.
Regra proporcao-v1 com limite de Hoeffding: o veredito so e 1 quando p - eps supera o limiar,
0 quando p + eps fica abaixo, INCONCLUSIVE quando as barras se cruzam e REFUSED quando o
contrato e invalido (contagem impossivel, politica fora de faixa). Cada decisao gera recibo
com compromisso do insumo e hash proprio.
Uso:
- uses: SerenaSolutions/zephirum-lang@v0.4.0
with:
shots: 1024
counts: '{"000": 964}'
threshold: 0.9
v2.5.2
ZEPHIRUM / ZYQL v2.5.2
Adicionado — espelhamento para o Entire
scripts/mirror_to_entire.sh: espelha os 32 repositórios da conta para a forge do Entire,
com--dry-run, token por header HTTP (nunca na URL) e contagem explícita de falhas.docs/ENTIRE.md: o que é o Entire (fundada por Thomas Dohmke, ex-CEO do GitHub), por que
encaixa com a nossa tese de recibo de decisão, e o estado verificado: a página do namespace
responde com Login, eENTIRE_TOKENnão está no ambiente.
Correção de rota durante a implementação: a listagem usava /orgs/, que devolve erro para
conta pessoal; trocada por /users/, e erro de API agora falha alto em vez de virar lista
vazia silenciosa.
Instalar: pip install . a partir do código-fonte anexado.
Verificar: confira SHA256SUMS e a atestação .sigstore.json.
Escopo: linguagem e verificação. O hardware é coprocessador opcional; o núcleo é determinístico e auditável.
v2.5.1
ZEPHIRUM / ZYQL v2.5.1
Adicionado — sinais de maturidade e protocolo de difusão global
Auditoria contra o padrão de an industry-standard quantum SDK, a differentiable quantum SDK, another quantum SDK e Q#: faltavam seis marcadores que
revisor técnico procura em 30 segundos.
src/py.typed— consumidor Python sabe que há tipos declarados;.pre-commit-config.yaml— ruff e checagens de arquivo antes do commit;.github/workflows/coverage.yml— CI de cobertura com piso (não regride);docs/DEPRECATION.md— semver como contrato, aviso de 2 MINOR ou 90 dias, recibos nunca
invalidados;GOVERNANCE.md— como uma mudança entra; recusa não pode virar alegação automática;packaging/conda/meta.yaml— recipe conda-forge pronta parastaged-recipes;docs/DIFUSAO_GLOBAL.md— protocolo em 4 fases com estado real de cada canal e bloqueios.
Nada aqui alega vantagem técnica: é infraestrutura de credibilidade. Suite inalterada e verde.
Nota de erro próprio: a tag v2.5.1 chegou a ser criada antes do bump de versão no
pyproject.toml; o test_meta.py acusou a inconsistência e o bump foi feito em seguida.
Instalar: pip install . a partir do código-fonte anexado.
Verificar: confira SHA256SUMS e a atestação .sigstore.json.
Escopo: linguagem e verificação. O hardware é coprocessador opcional; o núcleo é determinístico e auditável.
v2.5.0
ZEPHIRUM / ZYQL v2.5.0
Adicionado — API REST com a matemática exposta
api/server.py reescrito: antes era um wrapper que executava programa e devolvia
"executed". Agora devolve veredito trivalente com a conta junto.
POST /decide— veredito 1 / 0 / REFUSED comp0, banda de Hoeffding usada, shots,
epsilon, família e recibo SHA3-256 (assinatura ML-DSA-44 opcional comsign=true).POST /bound— a álgebra separada do veredito: banda para S shots ou shots
necessários para uma banda-alvo (S = ln(2/(ε/k)) / 2m²).POST /verify— verificação offline: recomputa o selo, denunciaSEAL_MISMATCH.POST /oracle/revealePOST /oracle/promise— modos v2.4.0 pela rede.GET /limits— o que o sistema não faz, declarado em produção.
Duas honestidades embutidas (e testadas)
hardware=truedevolve 409, não uma simulação disfarçada. Execução em QPU exige
job ID verificável e vive no script de hardware do repositório.- Família de testes maior encolhe a banda (Bonferroni na direção correta). Um teste
verifica a monotonicidade em vez de assumi-la — foi exatamente aqui que a primeira
implementação errou no passado.
Corrigido durante a implementação
- A banda não aparecia no recibo porque o kernel devolve
error_bounde nãomargin;
o campo agora é derivado explicitamente deadaptive_margin_family. - Um teste meu afirmava que família 500 com 64 shots seria "insolúvel" — falso pela
fórmula. O teste foi corrigido para verificar a propriedade real (monotonicidade),
não uma suposição.
Testes: tests/test_api.py — 18 verificações, incluindo banda conferida contra a conta
feita à mão (tolerância 1e-12).
Instalar: pip install . a partir do código-fonte anexado.
Verificar: confira SHA256SUMS e a atestação .sigstore.json.
Escopo: linguagem e verificação. O hardware é coprocessador opcional; o núcleo é determinístico e auditável.
v2.4.0
ZEPHIRUM / ZYQL v2.4.0
Adicionado — modos de DESCOBERTA do oráculo
O núcleo já respondia "que classe é este oráculo?". Este módulo responde "qual é o oráculo?",
identificando a função escondida com a mesma semântica trivalente.
reveal_linear(mask, n)— Bernstein–Vazirani: recupera a máscara s de f(x) = (s·x) mod 2 em
uma única consulta (clássico: n consultas). Verificado para todas as máscaras de 2 e 3 bits.find_period(table, n)— Simon: recupera o período s escondido resolvendo o espaço nulo sobre
GF(2) dos y medidos. Afirma s só quando a dimensão é 1; caso contrário REFUSED com candidatos.
Função injetora devolve veredito 0 (sem período inventado).identify_2bit(table)— identifica os 16 booleanos de 2 variáveis, com flag de promessa.audit_promise(table)— a promessa de Deutsch–Jozsa (constante OU balanceado) raramente é
testada: oráculo de peso 1 ou 3 parece "ruído" e some num REFUSED. Aqui ele é acusado como
NO_PROMISE com testemunha (entradas que provam a violação).
Bugs encontrados e corrigidos durante a implementação (registro honesto)
- Oráculo BV com CZ: com âncilla em |−⟩ e porta CZ o âncilla NÃO se fatora e a
interferência cai pela metade (p = 0,5 em vez de 1,0). Troca para CX produz o chute de fase
correto. - Ordem de leitura do registrador:
probabilities_dictlista o qubit mais alto primeiro;
ler os primeiros n caracteres devolvia o âncilla e metade da entrada. A entrada são os
últimos n caracteres. - Oráculo de Simon controlando só os bits em 1: o caso x=10 disparava também em x=11 e
anulava o MCX de x=11, quebrando o período (só s=11, palíndromo, passava). Correção:
inverter os zeros e controlar em TODOS os n qubits.
Testes: tests/test_oracle_id.py cobre 8 máscaras BV, 3 períodos Simon + caso injetor,
16 funções identificadas e 4 casos de auditoria de promessa. Todos falsificáveis.
Instalar: pip install . a partir do código-fonte anexado.
Verificar: confira SHA256SUMS e a atestação .sigstore.json.
Escopo: linguagem e verificação. O hardware é coprocessador opcional; o núcleo é determinístico e auditável.
v2.3.2
ZEPHIRUM / ZYQL v2.3.2
Corrigido (check-up estático)
- Bug latente em
qroute/hardware.py: a funçãop_marcadoscarregava a expressão
morta{...for m in marcados} if False else None, que referenciavanindefinido
(ruff F821) e alocava uma variável sem uso. Não quebrava em execução porque o ramo
nunca era avaliado — mas código que mente sobre o que faz é dívida. Removida. - Código morto removido em
zyql_quantum_gate(band_pending) e emzyql_mps
(cálculo dekeepnunca lido: uma soma de array por passo a menos). zyql_zne: resíduo da extrapolação renomeado para_residual, preservando a
intenção informativa sem enganar o lint.- Ruff F821/F841/F811: de 6 ocorrências para 2 (ambas de variável de efeito colateral
emquantum_types, declaradas como tal).
Validado
- Bateria de 1000 execuções por app (8 apps, 8.000 no total): 0 erros.
- Rodada no silício (the provider_marrakesh, 256 shots, n=2): const-1 → 1, const-0 → 0,
paridade → REFUSED. 3/3 conforme esperado, 6s de QPU.
Instalar: pip install . a partir do código-fonte anexado.
Verificar: confira SHA256SUMS e a atestação .sigstore.json.
Escopo: linguagem e verificação. O hardware é coprocessador opcional; o núcleo é determinístico e auditável.
v2.3.1
ZEPHIRUM / ZYQL v2.3.1
Corrigido
- Cap do an industry-standard quantum SDK declarado (
an industry-standard quantum SDK>=2.6,<3), atendendo ao checkup Q03 do an industry-standard quantum SDK
Ecosystem (revisão do PR #1433). Extras de hardware também receberam teto
(an industry-standard quantum SDK-aer>=0.17,<0.19). Sem teto, uma futura 3.x poderia quebrar o pacote
sem que o metadata avisasse; o cap torna o limite explícito e auditável.
Instalar: pip install . a partir do código-fonte anexado.
Verificar: confira SHA256SUMS e a atestação .sigstore.json.
Escopo: linguagem e verificação. O hardware é coprocessador opcional; o núcleo é determinístico e auditável.