Briefing de missão · Sessão 2 de 6
Conceito explicado
- Missão
- Definir contrato de entrada e saída
- Registro
- Logbook local
Contexto de missão
Conceito explicado
Esta leitura alimenta o fundamento CLI para ferramentas. Termine com uma evidência pequena antes de avançar.
- Contexto
- Sessão 2 de 6
Uma interface boa define o que entra e o que sai sem expor como o programa foi implementado. Para o primeiro exercício, use este contrato:
comando: studyops-ingest <arquivo> [--format text|json]
entrada principal: caminho de um arquivo TXT ou Markdown
saída text: caminho + quantidade de linhas
saída json: objeto com source e lineCount
falha: mensagem em stderr e código de retorno diferente de zero
O contrato separa três tipos de informação:
- dado do trabalho: o caminho do arquivo;
- configuração: o formato pedido;
- diagnóstico: argumento ausente, formato inválido ou arquivo inacessível.
Logbook técnico
Registro de campo desta sessão
O conteúdo continua público. O registro técnico fica disponível após autenticação.