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

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.1
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)

Table of built distributions (wheels) for isthmus 1.0.1
File Interpreter ABI Platform Actions
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.

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