Briefing de missão · Sessão 2 de 6
Conceito explicado
- Missão
- Definir contrato de entrada e saida
- 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 exercicio, use este contrato:
comando: studyops-ingest <arquivo> [--format text|json]
entrada principal: caminho de um arquivo TXT ou Markdown
saida text: caminho + quantidade de linhas
saida json: objeto com source e lineCount
falha: mensagem em stderr e codigo de retorno diferente de zero
O contrato separa tres tipos de informacao:
- dado do trabalho: o caminho do arquivo;
- configuracao: o formato pedido;
- diagnostico: argumento ausente, formato invalido ou arquivo inacessivel.
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.