Onde cada capacidade é acessível

Toda capacidade está disponível nas superfícies em que faz sentido; onde uma superfície não consegue carregar uma capacidade, a célula diz N/A e explica por quê. O mesmo motor roda por trás de cada superfície: os pontos de entrada Python, WebAssembly e MCP das capacidades da 0,35 são camadas finas sobre kshana::surface, que chama o código que a linha de comando executa.

Uma passagem que cita clientes de IA de terceiros foi omitida aqui; ela está em docs/SURFACES.md no GitHub.

Studio#

O Kshana Studio é o aplicativo web construído sobre o build WebAssembly; assim, existe uma visão do Studio onde a coluna WASM tem um ponto de entrada e, onde não tem, a célula aponta para um cartão Command line (o comando a executar, com seus argumentos), nunca para um resultado que o Studio calculou. Páginas (kshana.dev/studio/, no lado do cliente): Maritime trust (trust/), Training debrief (training/), Interference map (interference/), Geometry (geometry/: um skyplot representativo, skyline, DOP, elipse de erro e nuvem de Monte Carlo do motor; 0,36), Lunar station (lunar/: a cobertura modelada de uma estação de referência lunar a partir do tipo lunar-station-coverage; 0,36) e a página Tools, cujas seções são OSNMA (#osnma), Evidence packs (#evidence), exportação para test bench (#bench), mapeamento de compliance (#compliance), a aba Command line (cartão de telemetria, IQ, integrações marítimas: comandos a executar) e Use from your AI assistant (#ai). Um — na coluna Studio da tabela de subcomandos é um comando que não é uma das capacidades da 0,35 que o Studio apresenta.

Por que as células N/A são N/A#

• Signal K e OpenCPN. São consumidores do processo ao vivo em execução e do seu gate TCP; portanto, são implantações de linha de comando; o plugin traz um comando de guia prático e uma skill que apontam para docs/MARINE-INTEGRATIONS.md e não chamam nenhuma ferramenta.

• Um processo em execução. receiver-trust live mantém um fluxo aberto, pode servir o fluxo com gate a qualquer número de clientes TCP e roda até ser interrompido. Uma chamada Python, uma chamada de navegador, uma chamada de ferramenta MCP e uma ação de IDE retornam cada uma quando terminam e não mantêm um socket aberto para outros. Python, WASM e MCP trazem, em vez disso, a forma limitada: um trecho pontuado pelo mesmo motor, no esquema ao vivo (linhas JSON 1,3: position, uma declaração advisory e a geometry dos satélites em toda época, uma class em toda dedução), sem socket e sem gate (o gate marca uma solução como inválida em um fluxo ao vivo, o que só um processo no caminho dos dados pode fazer). Dois comportamentos pertencem ao processo e não estão nas ferramentas de trecho: um fluxo reproduzido mais rápido que o tempo real por receiver-trust live sem --replay é pontuado como não confiável (seu tempo discorda do relógio do host; um trecho é lido sem relógio de host), e --udp <port> e --listen tcp:<port> vinculam o endereço de loopback, a menos que um endereço seja dado.

• Telemetria de confiança. O WASM traz trust_telemetry(input, format, host, input_kind, options_json): os mesmos codificadores, retornando texto Prometheus, linhas de syslog CEF ou LEEF, ou o payload JSON OTLP para um fluxo ou um resultado em lote, sem relógio (as linhas de syslog carregam o timestamp nulo da RFC 5424) e sem nada enviado. O Python (trust_telemetry) e o MCP (trust_telemetry, com o comando de plugin /kshana-trust-telemetry) também a trazem. O restante de trust-telemetry serve métricas Prometheus, envia syslog e exporta OpenTelemetry a partir de um fluxo em execução; portanto, é um processo por natureza. Guia prático: encaminhe o comando ao vivo para ele, ou reproduza um arquivo de resultado (kshana trust-telemetry --result session.result.json --print-metrics); veja TRUST-TELEMETRY.md. Um agente ou um notebook que queira as pontuações por época chama, em vez disso, as funções de lote ou de trecho.

• Criar um pacote no navegador. A assinatura precisa de uma chave privada, que não deve passar por uma página web; o build para navegador verifica pacotes (evidence_verify) e as outras superfícies os criam. A ferramenta MCP nunca retorna nem registra a semente de assinatura e, sem uma, assina com uma chave descartável (integridade, não identidade); para uma chave que importe, use a CLI. O mesmo vale para transmitir NMEA de treinamento a um endereço: Python, WASM e MCP retornam o texto gerado, e a CLI o envia.

• Suítes de estudo. --study <suite.toml> executa um manifesto que nomeia arquivos de cenário irmãos em disco. As superfícies em memória recebem texto de cenário, não uma pasta de arquivos; por isso, executam cada membro como um cenário (run, run_scenario, run_all).

• IQ de GNSS no navegador, e gravações reescritas. Uma gravação tem gigabytes de amostras, que uma página não consegue conter e que o protocolo MCP não deve carregar; assim, o WASM não tem funções de IQ e as ferramentas MCP leem e escrevem em um único diretório de trabalho (KSHANA_MCP_IQ_DIR, com um orçamento de amostras por chamada). iq extract, convert e decimate existem para reescrever gravações em disco e permanecem exclusivos da linha de comando. iq labfit e iq conditions carregam texto, de modo que o MCP os recebe em linha (um log que nomeia um arquivo é recusado).

• O download de terra. É o único comando que abre uma conexão de rede, precisa do curl do sistema e de um --allow-network explícito, e confere um SHA-256 fixado. O navegador não tem curl, e um agente de IA não deve buscar dados em nome do usuário; as outras superfícies recebem o arquivo de terra como texto (land_geojson).

• Arquivos e diretórios de traços. interference-map adsb sobre um diretório de traços do readsb lê arquivos do disco e é exclusivo da linha de comando; as superfícies em memória recebem texto CSV.

Todo subcomando da linha de comando e quem o cobre#

Uma linha por subcomando ou modo de kshana --help. yes indica o ponto de entrada; no é uma lacuna com o seu motivo; N/A é uma superfície que não consegue carregá-lo pelo motivo dado acima ou na última coluna. As ações do JetBrains executam a linha de comando; portanto, um N/A ali declara por que não existe ação de IDE.

Funções utilitárias#

Pequenos pontos de entrada que não são uma linha de capacidade, e onde cada um fica:

Limites que diferem por superfície#

Níveis de evidência e ressalvas em cada superfície#

• Um pacote de evidências é um registro técnico do que o motor calculou a partir de um log sob configurações declaradas, com cada hash e uma assinatura sobre eles. Não é um parecer jurídico, uma constatação de fato sobre qualquer evento nem uma aprovação. Um resultado positivo da verificação diz que o registro não foi alterado; sem uma chave pública confiável, prova apenas a integridade em relação à chave que o próprio pacote nomeia.
• Os monitores de confiança do receptor e a pontuação de confiança são MODELLED: os limiares são entradas declaradas e nada afirma como eles se comportam diante de interferência real. A saída é consultiva; o Kshana não é um equipamento de navegação homologado (IEC 61108, IEC 61162) e o operador continua responsável. Uma pontuação alta não é prova de uma solução de posição genuína.
• O mapa de interferência é MODELLED (limiares pré-registrados, não validados em relação a uma medição de verdade de campo). Uma célula degradada não identifica a interferência como a causa; uma célula não observada não é evidência de uma rota livre; ele descreve relatos passados e não é uma previsão. É somente agregado: nenhum identificador é retornado.
• O NMEA de treinamento é somente texto: nenhum sinal de RF, IQ ou forma de onda é sintetizado, nada é transmitido, e ele nunca se destina aos sistemas de navegação ao vivo de uma embarcação.

O rótulo de evidência e as saídas que não trazem nenhum#

Cada figura e tabela que uma execução grava traz seu nível de evidência (VALIDATED, MODELLED ou PARTNER, o mais fraco das linhas do registro por trás dele) e os ids dessas linhas, em toda superfície que executa um cenário: o JSON de resultado (chave evidence), o SVG do gráfico (elemento de metadados e uma linha sob o gráfico) e a tabela CSV (linhas de comentário # evidence:). O mesmo rótulo está nas saídas de receiver-trust (CLI, MCP, Python), jammertest score --json, iq acquire, iq sweep, iq track --summary, iq monitor --json, no relatório de rota do mapa de interferência, e dentro do config.json de cada pacote de evidências (assinado; kshana evidence verify o informa). Os ids das linhas são estáveis (VM- e oito dígitos hexadecimais, a coluna ID de docs/VERIFICATION-MATRIX.md).

Estas saídas não trazem rótulo, cada uma por um motivo declarado (a lista é UNLABELLED_WRITERS em tests/evidence_labels_doc_sync.rs, que falha diante de um gravador que não está rotulado nem listado):