fix: separa o flag de intercâmbio mínimo do sentido no bloco de intercâmbio do sistema.dat

[rjmalves]

Problema

No bloco de limites de intercâmbio do sistema.dat, a coluna sentido fundia dois conceitos ortogonais:

1. O campo 3 do registro tipo 1 (0 = limite, 1 = intercâmbio mínimo obrigatório) — uma propriedade do par de submercados, informada uma única vez no cabeçalho.
2. A direção A→B / B→A — que é posicional no arquivo: o grupo antes do registro em branco é A→B, o de depois é B→A.

O leitor semeia sentido com o campo 3 e o inverte a cada registro em branco, de modo que sentido = flag XOR direção. Isso guarda um bit onde existem dois.

Consequências para decks com flag = 1:

• A informação do flag se perde na leitura — ambos os valores de flag produzem o conjunto {0, 1} nos dois grupos do par, então não há como recuperar se o par era limite ou mínimo obrigatório.
• O round-trip corrompe o arquivo — a escrita ordenava por sentido e gravava o campo 3 a partir dele, invertendo os grupos A→B/B→A e gravando o campo 3 errado.

Para flag = 0 (a grande maioria dos decks) sentido coincide com a direção, então o problema não aparecia.

Correção

Expõe a coluna flag (campo 3, sem perdas) e mantém sentido exatamente com os valores anteriores:

• Leitura: o campo 3 é capturado em flag, constante nos dois grupos do par; sentido continua sendo calculado como antes.
• Escrita: o campo 3 é gravado a partir de flag, e a ordem dos grupos usa a direção = sentido XOR flag (A→B antes de B→A). Para flag = 0, direção == sentido e a saída é byte-idêntica à anterior.

A direção verdadeira fica derivável pelo usuário como sentido XOR flag.

Compatibilidade

• Decks apenas com limites (flag = 0): sentido inalterado e escrita byte-idêntica. A única mudança visível é a nova coluna flag (toda 0).
• Decks com intercâmbio mínimo obrigatório (flag = 1): antes com perda de informação e round-trip incorreto, agora corretos.

Testes

• test_bloco_intercambio_flag_e_sentido: no mock (flag 0), a coluna flag existe e é toda 0 e o sentido mantém os valores históricos (A→B = 0, B→A = 1).
• test_bloco_intercambio_flag_minimo_roundtrip: cenário sintético com flag = 1 — captura do flag, campo 3 = 1 na escrita, grupo A→B antes do B→A e round-trip estável.

Suíte completa: 1172 testes passando; ruff e mypy limpos.

Ressalva

O caminho flag = 1 é validado de forma sintética e contra a estrutura documentada no manual (grupo A→B · registro em branco · grupo B→A), pois não havia um deck real de intercâmbio mínimo obrigatório à disposição. A leitura sem perdas do campo 3 é correta independentemente disso; apenas a ordenação da escrita para flag = 1 depende do invariante "grupo A→B primeiro".

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.10%. Comparing base (4c19fbd) to head (eda3db6).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #125   +/-   ##
=======================================
  Coverage   91.10%   91.10%           
=======================================
  Files         526      526           
  Lines       18976    18982    +6     
=======================================
+ Hits        17288    17294    +6     
  Misses       1688     1688           

Flag	Coverage Δ
unittests	91.10% <100.00%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.