Dónde se puede acceder a cada capacidad

Cada capacidad está disponible en las superficies donde tiene sentido; donde una superficie no puede soportar una capacidad, la celda indica N/A y el motivo. El mismo motor funciona detrás de todas las superficies: los puntos de entrada de Python, WebAssembly y MCP para las 0,35 capacidades son envoltorios finos sobre kshana::surface, que llama al código que ejecuta la línea de comandos.

Aquí se omite un pasaje que nombra clientes de IA de terceros; está en docs/SURFACES.md en GitHub.

Studio#

Kshana Studio es la aplicación web construida sobre la compilación WebAssembly, de modo que existe una vista de Studio donde la columna WASM tiene un punto de entrada, y donde no lo tiene la celda remite a una tarjeta Command line (el comando que se ejecuta, con sus argumentos), nunca a un resultado calculado por Studio. Páginas (kshana.dev/studio/, en el cliente): Maritime trust (trust/), Training debrief (training/), Interference map (interference/), Geometry (geometry/: un skyplot representativo, perfil del horizonte, DOP, elipse de error y nube Monte Carlo del motor; 0,36), Lunar station (lunar/: la cobertura modelada de una estación de referencia lunar a partir del tipo lunar-station-coverage; 0,36) y la página Tools, cuyas secciones son OSNMA (#osnma), Evidence packs (#evidence), Test-bench export (#bench), Compliance mapping (#compliance), la pestaña Command line (tarjeta de telemetría, IQ, integraciones marinas: comandos que se ejecutan) y Use from your AI assistant (#ai). Un — en la columna de Studio de la tabla de subcomandos es un comando que no es una de las 0,35 capacidades que presenta Studio.

Por qué las celdas N/A son N/A#

• Signal K y OpenCPN. Son consumidores del proceso en vivo en ejecución y de su compuerta TCP, de modo que son despliegues de línea de comandos; el plugin lleva un comando de guía práctica y una skill que remiten a docs/MARINE-INTEGRATIONS.md y no llaman a ninguna herramienta.

• Un proceso en ejecución. receiver-trust live mantiene abierto un flujo, puede servir el flujo con compuerta a cualquier número de clientes TCP y se ejecuta hasta que se detiene. Una llamada de Python, una llamada de navegador, una llamada a una herramienta MCP y una acción de IDE devuelven cada una su resultado al terminar y no mantienen abierto un socket para otros. Python, WASM y MCP llevan en su lugar la forma acotada: un fragmento puntuado por el mismo motor, en el esquema en vivo (líneas JSON 1,3: position, una declaración advisory y la geometry de satélites en cada época, una class en cada deducción), sin socket y sin compuerta (la compuerta marca una posición como no válida en un flujo en vivo, algo que solo un proceso situado en la ruta de los datos puede hacer). Dos comportamientos pertenecen al proceso y no están en las herramientas de fragmentos: un flujo reproducido más rápido que el tiempo real mediante receiver-trust live sin --replay se puntúa como no fiable (su hora no coincide con el reloj del anfitrión; un fragmento se lee sin reloj del anfitrión), y --udp <port> y --listen tcp:<port> se enlazan a la dirección de bucle local salvo que se indique una dirección.

• Telemetría de confianza. WASM lleva trust_telemetry(input, format, host, input_kind, options_json): los mismos codificadores, que devuelven texto de Prometheus, líneas de syslog CEF o LEEF, o la carga JSON de OTLP para un flujo o un resultado por lotes, sin reloj (las líneas de syslog llevan la marca de tiempo nula de la RFC 5424) y sin enviar nada. Python (trust_telemetry) y MCP (trust_telemetry, con el comando del plugin /kshana-trust-telemetry) también la llevan. El resto de trust-telemetry sirve métricas de Prometheus, envía syslog y exporta OpenTelemetry desde un flujo en ejecución, por lo que es un proceso por naturaleza. Guía práctica: canalice el comando en vivo hacia él, o reproduzca un archivo de resultado (kshana trust-telemetry --result session.result.json --print-metrics); véase TRUST-TELEMETRY.md. Un agente o un notebook que quiera las puntuaciones por época llama en su lugar a las funciones por lotes o de fragmentos.

• Crear un paquete en el navegador. Firmar necesita una clave privada, que no debe pasar por una página web; la compilación para navegador verifica paquetes (evidence_verify) y las demás superficies los crean. La herramienta MCP nunca devuelve ni registra la semilla de firma y, sin ella, firma con una clave de un solo uso (integridad, no identidad); para una clave que importe, use la CLI. Lo mismo vale para transmitir NMEA de entrenamiento a una dirección: Python, WASM y MCP devuelven el texto generado, y la CLI lo envía.

• Suites de estudio. --study <suite.toml> ejecuta un manifiesto que nombra archivos de escenario hermanos en disco. Las superficies en memoria admiten texto de escenario, no una carpeta de archivos, de modo que ejecutan cada miembro como un escenario (run, run_scenario, run_all).

• IQ de GNSS en el navegador y grabaciones que se reescriben. Una grabación son gigabytes de muestras, que una página no puede contener y que el protocolo MCP no debe transportar, de modo que WASM no tiene funciones de IQ y las herramientas MCP leen y escriben en un único directorio de trabajo (KSHANA_MCP_IQ_DIR, con un presupuesto de muestras por llamada). iq extract, convert y decimate existen para reescribir grabaciones en disco y siguen siendo solo de línea de comandos. iq labfit y iq conditions llevan texto, por lo que MCP los admite en línea (se rechaza un registro que nombra un archivo).

• La descarga de tierra. Es el único comando que abre una conexión de red, necesita el curl del sistema y un --allow-network explícito, y comprueba un SHA-256 fijado. El navegador no tiene curl, y un agente de IA no debe obtener datos en nombre de un usuario; las demás superficies admiten en su lugar el archivo de tierra como texto (land_geojson).

• Archivos de trazas y directorios. interference-map adsb sobre un directorio de trazas de readsb lee archivos del disco y es solo de línea de comandos; las superficies en memoria admiten texto CSV.

Cada subcomando de la línea de comandos y quién lo cubre#

Una fila por subcomando o modo de kshana --help. yes indica el punto de entrada; no es una laguna con su motivo; N/A es una superficie que no puede soportarlo por el motivo indicado arriba o en la última columna. Las acciones de JetBrains ejecutan la línea de comandos, de modo que un N/A ahí indica por qué no existe una acción de IDE.

Funciones de utilidad#

Pequeños puntos de entrada que no son una fila de capacidad, y dónde reside cada uno:

Límites que difieren según la superficie#

Niveles de evidencia y salvedades en todas las superficies#

• Un paquete de evidencias es un registro técnico de lo que el motor calculó a partir de un registro con unos ajustes indicados, con cada hash y una firma sobre ellos. No es un dictamen jurídico, una constatación de hechos sobre ningún suceso ni una aprobación. Un resultado superado de verify indica que el registro no ha cambiado; sin una clave pública de confianza, prueba solo la integridad frente a la clave que el propio paquete nombra.
• Los monitores de confianza del receptor y la puntuación de confianza son MODELLED: los umbrales son entradas declaradas y nada afirma cómo se comportan frente a una interferencia real. La salida es orientativa; Kshana no es un equipo de navegación homologado (IEC 61108, IEC 61162) y el operador sigue siendo responsable. Una puntuación alta no es prueba de una posición genuina.
• El mapa de interferencias es MODELLED (umbrales fijados de antemano, no validados frente a una medición de verdad de referencia). Una celda degradada no identifica la interferencia como causa; una celda no observada no es evidencia de una ruta despejada; describe informes pasados y no es una previsión. Es solo agregado: no se devuelve ningún identificador.
• El NMEA de entrenamiento es solo texto: no se sintetiza RF, IQ ni forma de onda, no se transmite nada, y nunca está destinado a los sistemas de navegación en vivo de un buque.

La etiqueta de evidencia y las salidas que no llevan ninguna#

Cada figura y tabla que escribe una ejecución lleva su nivel de evidencia (VALIDATED, MODELLED o PARTNER, el más débil de las filas del registro que la respaldan) y los identificadores de esas filas, en cada superficie que ejecuta un escenario: el JSON de resultados (clave evidence), el SVG del gráfico (elemento de metadatos y una línea bajo el trazado) y la tabla CSV (líneas de comentario # evidence:). La misma etiqueta está en las salidas de receiver-trust (CLI, MCP, Python), jammertest score --json, iq acquire, iq sweep, iq track --summary, iq monitor --json, el informe de ruta del mapa de interferencias, y dentro del config.json de cada paquete de evidencias (firmado; kshana evidence verify lo informa). Los identificadores de fila son estables (VM- y ocho dígitos hexadecimales, la columna ID de docs/VERIFICATION-MATRIX.md).

Estas salidas no llevan etiqueta, cada una por un motivo indicado (la lista es UNLABELLED_WRITERS en tests/evidence_labels_doc_sync.rs, que falla con un escritor que ni está etiquetado ni figura en la lista):