Refactor: split SDK example flow and related metadata helpers

[tom-sapletta-com]

Scope-limited refactor branch from origin/main:

• split python SDK basic example flow
• split generation metadata helper logic
• split intake CLI encode/decode/parsing path
• fix syntax/typing issues in generation-validation and run-helpers

[tom-sapletta-com]

Oznaczam jako draft po uporządkowaniu kolejki. Kodowe verify i Java przechodzą na aktualnym headzie, ale PR musi po #22 dostać świeżą bazę, osobny aktywny ticket i ponowną recenzję Koru/Validator App. Dotychczasowy Koru na starej bazie używał przestarzałego workflow DeepSeek i zgłosił także realny problem obsługi błędnego Base64 w src/interfaces/intake_cli.py.

[tom-sapletta-com]

Zamykam ten PR bez merge jako niezgodny z aktualnym kontraktem zmian. Head jest za main, nie ma jednego aktywnego ticketu, a diff miesza SDK, interfaces, runtime i LLM. Historyczne review wskazało też nierozwiązany przypadek błędnego Base64 w src/interfaces/intake_cli.py. Branch refactor/sdk-example-flow-split-clean2 i wszystkie commity pozostają zachowane; poprawki należy odtworzyć w małych, jedno-workstreamowych ticketach na aktualnym main.