Contratos y capacidades

Panorama Maestro

ork.maestro-snapshot/v1 es una proyección de lectura. Sus secciones declaran fuente, instante, fingerprint, estado y cobertura. empty significa vacío observado; unavailable significa fuente inaccesible. La paginación y las omisiones forman parte del contrato. La instantánea no crea un ciclo, aprueba un gate ni demuestra SHIP. La instantánea también incluye project.root, con ~, project.remote, sin credenciales, y notConsulted, con lo que el panorama no leyó. Cero threads en el panorama nunca significa un roadmap vacío.

ork maestro --json
ork maestro --json --thread <thread>

Registro de proyectos y cabecera de la consulta

ork.projetos/v1 es el registro de esta máquina en ~/.orkastery/projetos.json, con modo 0600 y sin secretos: nombre, abbrev, raíz, remoto sin usuario ni contraseña, fechas y la fuente del registro. Un archivo ausente, dañado o de otro contrato equivale a un registro vacío. ork.consulta/v1 es la cabecera de maestro, board, board plan, fabrica y roadmap status: el proyecto consultado, el origen de la elección, lo que se leyó y lo que no.

Los rechazos projeto.desconhecido, projeto.ambiguo, projeto.sem-manifesto, projeto.escolha, projeto.nenhum y projeto.fora-do-servidor incluyen los candidatos y la corrección. Quien consume el registro lo lee sin escribir, comprueba el contrato y nunca elige la primera copia de un nombre ambiguo.

ork projetos --json
ork roadmap status --json

Capacidad y permiso son distintos

El playbook describe transporte, herramientas nativas y límites por fase. PLAN no edita el producto; GO recibe la worktree; CHECK requiere revisión independiente. El schema de salida de claims contiene candidatos: una respuesta del modelo no registra ni verifica la alegación. La configuración instalada no demuestra validación en vivo.

Métricas con cobertura y procedencia

ork.ledger-stats/v1 agrega hechos registrados en un intervalo UTC semiabierto. Los tokens y la duración tienen cobertura explícita; los valores ausentes siguen ausentes. custoReferencia es una estimación para comparar escenarios, no una factura. El throughput depende de ship_done; no cuente un commit local como entrega remota.

ork ledger stats --desde 7d --json