Skip to main content

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

  1. Grossa: esquema, versão de gramática e campos obrigatórios. Barata, falha cedo.
  2. 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 mestre
  • docs/ISTHMUS_v1.1_ponte_hibrida_2026-11-17.md: ponte híbrida e maturidade
  • docs/ISTHMUS_1.2_vocabulario_verificacao_2026-11-17.md: vocabulário e testes de aceite
  • docs/ISTHMUS_1.3_inventario_algoritmos_2026-11-17.md: inventário e ordem de construção
  • docs/ISTHMUS_1.4_implementacao_2026-11-17.md: primeira implementação, com medições
  • NAMING.md: nome canônico, abreviação ISTH e a derivada STH
  • docs/ERRATA.md: correções de nomenclatura, inclusive as que já foram para o histórico
  • CHANGELOG.md: versões, mudanças e quebras

Licença

Apache-2.0.

Metadata

Release files for isthmus 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for isthmus 1.0.3
File Size Uploaded Provenance Actions
isthmus-1.0.3.tar.gz 29.8 kB Without provenance Details for isthmus-1.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for isthmus 1.0.3
File Interpreter ABI Platform Actions
isthmus-1.0.3-py3-none-any.whl Python 3 none any Details for isthmus-1.0.3-py3-none-any.whl

Total release size: 57.2 kB

Release files / isthmus-1.0.3.tar.gz

Download URL isthmus-1.0.3.tar.gz
Size 29.8 kB
Tags Source
SHA-256 checksum
How to use checksums
e8fc72b2abbcfa27b4f8f06bd17e8064758482f8ae1d0032a5a903e3976d28e8
BLAKE2b-256 checksum
How to use checksums
c8aabe3242dc2cde4c8ed83bcf8abb89be90f80c6437a6a8241fd713d85ae89e
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.3-py3-none-any.whl

Download URL isthmus-1.0.3-py3-none-any.whl
Size 27.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fe66c77379067147e870d5db56e994c3ca7e35833977b6f117733ab3e96192ea
BLAKE2b-256 checksum
How to use checksums
0552d8f9ccae60eca4086349114ebada70cf99c2f9068bca8f7446f90b26ba62
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.3

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page