ISTHMUS
Sub-linguagem híbrida de interoperabilidade, controle e verificação do ecossistema ZEPHIRUM/ZYQL. Abreviações: ISTH e STH.
Quatorze algoritmos em três camadas, recibo com duas etapas de verificação, zero dependência externa.
Versão 0.1.1 · 42 testes · Apache-2.0
Instalar
pip install -e .
Rodar em trinta segundos
python3 -m unittest discover -s tests -v # 42 testes, todos passando
isth decide --p0 0.9 --shots 512 > r.json
sth verify r.json # {"state":"ok","stage":"fine"}
Os três comandos isthmus, isth e ist são equivalentes e decidem.
sth é a derivada: sela, verifica e encadeia, e não decide.
Alterar verdict no r.json e repetir a verificação devolve
{"state":"refused","code":"ISTH-FINE-SEAL"} com saída de código 1.
ISTH e STH
| ISTH | STH | |
|---|---|---|
| decide | sim | não |
| sela payload já decidido | sim | sim |
| verifica recibo e cadeia | sim | sim |
| tem Ramp, Shutter, banda, oráculo | sim | não |
isth decide --p0 0.9 --shots 512 > r.json # decide e sela
sth seal payload.json # sela payload cru, exige campo verdict
sth verify r.json # confere
sth chain r1.json r2.json r3.json # confere a cadeia
sth decide # recusa: ISTH-STH-NOT-ALLOWED
sth seal recebe um payload cru, não um recibo. O mínimo é:
{"p0": 0.9, "n": 4, "shots": 512, "seed": 1, "mode": "sim", "error_bound": 0.05, "verdict": 1}
Recibo emitido sob ISTH verifica sob STH. É o sentido da derivação: quem só confere não precisa da camada que decide.
O que existe
| Camada | Algoritmos | Estado |
|---|---|---|
| Clássico puro | Ramp, Shutter, Canonize, Fringe, Refase | implementado e testado |
| Híbrido | Sampler, Estimator com Alignment Two, Mitigation audit, Budget, Transpile audit | implementado como contrato |
| Ponta quântica | Prepare, Evolve, Measure, Reset, Flow, Characterize | implementado como fluxo local |
| Ponte com backend real | as cinco responsabilidades híbridas | planejado |
A ponte com QPU e simulador externo não está implementada. Nenhum adaptador foi conectado, e este README não afirma o contrário.
As duas etapas do verificador
- Grossa: esquema, versão de gramática e campos obrigatórios. Barata, falha cedo.
- Fina: selo SHA3-256 sobre os bytes canônicos. Cara, falha tarde.
A cadeia tem verificação própria: um elo re-selado passa sozinho e só
verify_chain o denuncia, que é a diferença entre dano contíguo (snowball) e
dano distribuído (shower).
Testado com simulador, não com hardware
A integração já rodada usa Qiskit Aer, simulador local: circuito de Bell, duas
rodadas de 1.024 tiros, p0 de 0,4951 e 0,5020, recibo e cadeia verificando,
adulteração recusada com ISTH-FINE-SEAL. Nenhum hardware foi usado.
Contradição aberta
Alignment Two exige duas rodadas; a regra do projeto diz uma chamada de oráculo por
decisão. Budget recebe oracle_calls declarado em vez de fingir que é sempre um.
As três saídas possíveis estão em docs/ISTHMUS_1.4_implementacao_2026-11-17.md.
Documentação
docs/ISTHMUS_prompt_mestre_2026-11-17.md: especificação e prompt mestredocs/ISTHMUS_v1.1_ponte_hibrida_2026-11-17.md: ponte híbrida e maturidadedocs/ISTHMUS_1.2_vocabulario_verificacao_2026-11-17.md: vocabulário e testes de aceitedocs/ISTHMUS_1.3_inventario_algoritmos_2026-11-17.md: inventário e ordem de construçãodocs/ISTHMUS_1.4_implementacao_2026-11-17.md: primeira implementação, com mediçõesNAMING.md: nome canônico, abreviação ISTH e a derivada STHdocs/ERRATA.md: correções de nomenclatura, inclusive as que já foram para o históricoCHANGELOG.md: versões, mudanças e quebras
Licença
Apache-2.0.
Metadata
Release files for isthmus 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| isthmus-1.0.1.tar.gz | 29.6 kB | Without provenance | Details for isthmus-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| isthmus-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for isthmus-1.0.1-py3-none-any.whl |
Total release size: 56.9 kB
Release files / isthmus-1.0.1.tar.gz
| Download URL | isthmus-1.0.1.tar.gz |
|---|---|
| Size | 29.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f67a336fe4ebb4509707f97d6335edb60b7041a61a81fd8775c28c9f813ba9ed
|
|
BLAKE2b-256 checksum How to use checksums |
0bf9beac83dfce5aaf11ed3711785d0eb125a1378353c8a212cb16d808783f50
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / isthmus-1.0.1-py3-none-any.whl
| Download URL | isthmus-1.0.1-py3-none-any.whl |
|---|---|
| Size | 27.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f1158f0e1c5a60f13125f6ad8f8c865def773a32a661b12340f946325a64a2da
|
|
BLAKE2b-256 checksum How to use checksums |
851c5147a556065d007e1b80a8815745ce3a30b622cce795d9689334ce4e7d1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Security for isthmus 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.