Onde cada capacidade é acessível

Todas as capacidades estão disponíveis nas superfícies onde fazem sentido; onde uma superfície não pode suportar uma capacidade, a célula diz N/A e porquê. O mesmo motor corre por trás de todas as superfícies: os pontos de entrada Python, WebAssembly e MCP das capacidades da 0,35 são invólucros finos sobre kshana::surface, que chama o código que a linha de comandos executa.

Uma passagem que nomeia clientes de IA de terceiros é omitida aqui; consta de docs/SURFACES.md no GitHub.

Studio#

O Kshana Studio é a aplicação web construída sobre a compilação WebAssembly, pelo que existe uma vista do Studio onde a coluna WASM tem um ponto de entrada, e onde não tem a célula aponta para um cartão Linha de comandos (o comando a executar, com os seus argumentos), nunca para um resultado que o Studio tenha calculado. Páginas (kshana.dev/studio/, do lado do cliente): Confiança marítima (trust/), Debriefing de formação (training/), Mapa de interferência (interference/), Geometria (geometry/: um gráfico de céu representativo, linha de horizonte, DOP, elipse de erro e nuvem de Monte Carlo a partir do motor; 0,36), Estação lunar (lunar/: a cobertura modelada de uma estação de referência lunar a partir do tipo de cenário lunar-station-coverage; 0,36) e a página de Ferramentas, cujas secções são OSNMA (#osnma), Pacotes de evidências (#evidence), Exportação de test bench (#bench), Mapeamento de compliance (#compliance), o separador Linha de comandos (cartão de telemetria, IQ, integrações marítimas: comandos a executar) e Utilização a partir do seu assistente de IA (#ai). Um — na coluna Studio da tabela de subcomandos é um comando que não é uma das capacidades da 0,35 que o Studio apresenta.

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

• Signal K e OpenCPN. São consumidores do processo em direto e da sua gate TCP, pelo que são implementações de linha de comandos; 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 filtrado a qualquer número de clientes TCP e corre até ser parado. Uma chamada Python, uma chamada de navegador, uma chamada de ferramenta MCP e uma ação de IDE devolvem cada uma o resultado quando terminam e não mantêm um socket aberto para outros. Python, WASM e MCP suportam, em vez disso, a forma limitada: um excerto pontuado pelo mesmo motor, no esquema em direto (linhas JSON 1,3: position, uma declaração advisory e a geometry dos satélites em cada época, uma class em cada dedução), sem socket e sem gate (a gate marca uma solução de posição como inválida num fluxo em direto, o que só um processo no percurso dos dados pode fazer). Dois comportamentos pertencem ao processo e não estão nas ferramentas de excerto: um fluxo repetido mais depressa do que em tempo real através de receiver-trust live sem --replay é pontuado como não fiável (o seu tempo discorda do relógio do anfitrião; um excerto é lido sem relógio do anfitrião), e --udp <port> e --listen tcp:<port> ligam-se ao endereço de loopback, a menos que seja indicado um endereço.

• Telemetria de confiança. O WASM suporta trust_telemetry(input, format, host, input_kind, options_json): os mesmos codificadores, devolvendo texto Prometheus, linhas syslog CEF ou LEEF, ou a carga OTLP em JSON para um fluxo ou um resultado em lote, sem relógio (as linhas syslog trazem a marca temporal nula do 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 o suportam. O resto de trust-telemetry serve métricas Prometheus, envia syslog e exporta OpenTelemetry a partir de um fluxo em execução, pelo que é um processo por natureza. Guia prático: encaminhe o comando em direto para ele, ou repita um ficheiro de resultado (kshana trust-telemetry --result session.result.json --print-metrics); ver TRUST-TELEMETRY.md. Um agente ou um notebook que queira as pontuações por época chama antes as funções de lote ou de excerto.

• Criar um pacote no navegador. A assinatura precisa de uma chave privada, que não deve passar por uma página web; a compilação para navegador verifica pacotes (evidence_verify) e as outras superfícies criam-nos. A ferramenta MCP nunca devolve nem regista a semente de assinatura e, sem uma, assina com uma chave de uso único (integridade, não identidade); para uma chave que importe, utilize a CLI. O mesmo se aplica à transmissão de NMEA de treino para um endereço: Python, WASM e MCP devolvem o texto gerado, e a CLI envia-o.

• Conjuntos de estudo. --study <suite.toml> executa um manifesto que nomeia ficheiros de cenário irmãos em disco. As superfícies em memória aceitam texto de cenário, e não uma pasta de ficheiros, pelo que executam cada membro como um cenário (run, run_scenario, run_all).

• IQ de GNSS no navegador, e gravações que são reescritas. Uma gravação tem gigabytes de amostras, que uma página não consegue conter e que o protocolo MCP não deve transportar, pelo que o WASM não tem funções de IQ e as ferramentas MCP leem e escrevem apenas um 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 ficam apenas na linha de comandos. iq labfit e iq conditions transportam texto, pelo que o MCP os aceita em linha (um registo que nomeia um ficheiro é recusado).

• O descarregamento de terra. É o único comando que abre uma ligação de rede, precisa do curl do sistema e de um --allow-network explícito, e verifica um SHA-256 fixado. O navegador não tem curl, e um agente de IA não deve obter dados em nome de um utilizador; as outras superfícies aceitam, em vez disso, o ficheiro de terra como texto (land_geojson).

• Arquivos e diretórios de traços. interference-map adsb sobre um diretório de traços readsb lê ficheiros do disco e é apenas de linha de comandos; as superfícies em memória aceitam texto CSV.

Todos os subcomandos da linha de comandos, e quem os cobre#

Uma linha por subcomando ou modo de kshana --help. sim nomeia o ponto de entrada; não é uma lacuna com o seu motivo; N/A é uma superfície que não o pode suportar pelo motivo indicado acima ou na última coluna. As ações do JetBrains executam a linha de comandos, pelo que um N/A aí indica porque não existe uma ação de IDE.

Funções utilitárias#

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

Limites que diferem por superfície#

Níveis de evidência e ressalvas em todas as superfícies#

• Um pacote de evidências é um registo técnico do que o motor calculou a partir de um registo sob definições declaradas, com todos os resumos criptográficos e uma assinatura sobre eles. Não é um parecer jurídico, uma constatação de facto sobre qualquer evento nem uma aprovação. Um resultado positivo da verificação diz que o registo não foi alterado; sem uma chave pública de confiança, prova apenas a integridade face à chave que o próprio pacote nomeia.
• Os monitores de confiança do recetor e a pontuação de confiança são MODELLED: os limiares são entradas declaradas e nada afirma como se comportam face a 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 a ser responsável. Uma pontuação elevada não prova uma solução de posição genuína.
• O mapa de interferência é MODELLED (limiares fixados antecipadamente, não validados face a uma medição de referência no terreno). Uma célula degradada não identifica a interferência como causa; uma célula não observada não é evidência de um percurso livre; descreve relatos passados e não é uma previsão. É apenas agregado: nenhum identificador é devolvido.
• O NMEA de treino é apenas texto: nenhum RF, IQ ou forma de onda é sintetizado, nada é transmitido, e nunca se destina aos sistemas de navegação em funcionamento de uma embarcação.

A etiqueta de evidência e as saídas que não trazem nenhuma#

Cada figura e tabela que uma execução escreve traz o seu nível de evidência (VALIDATED, MODELLED ou PARTNER, o mais fraco das linhas do registo 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:). A mesma etiqueta 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 indica-a). 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 etiqueta, cada uma por um motivo declarado (a lista é UNLABELLED_WRITERS em tests/evidence_labels_doc_sync.rs, que falha diante de um escritor que não está etiquetado nem listado):