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.0

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.0
File Size Uploaded Provenance Actions
isthmus-1.0.0.tar.gz 29.6 kB Without provenance Details for isthmus-1.0.0.tar.gz

Built distribution (wheel)

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

Total release size: 56.9 kB

Release files / isthmus-1.0.0.tar.gz

Download URL isthmus-1.0.0.tar.gz
Size 29.6 kB
Tags Source
SHA-256 checksum
How to use checksums
eb7eb4302205cd088214701300c5e49805dd3aeb6bd1acff68a6c707cef8925c
BLAKE2b-256 checksum
How to use checksums
85bb9bd22c821199e2809d7539ed0cc44cd7bec64677cf8dc3af7cd67f2afc87
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.0-py3-none-any.whl

Download URL isthmus-1.0.0-py3-none-any.whl
Size 27.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
68a1a1a1555867b57090e9490f594ab100de0e4dc94ee7f5496ce8e9de8826ba
BLAKE2b-256 checksum
How to use checksums
9fcd7fdf775e739ff5644a3f2c62909e4bece51eafe43010c6e591adfdbdcbc8
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.0

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