Skip to main content
La StackKit Open Spec es el contrato publicado y ligero detrás del «estándar de homelab abierto». Indexa artefactos que se distribuyen con cada release de StackKits; no introduce ningún esquema nuevo. La versión de la spec sigue la etiqueta del release con el que se distribuye, y los cambios dentro de v0 son aditivos. La copia canónica reside en el repositorio público en docs/OPEN-SPEC.md. Todo en la spec es libre de cuentas: el Standard Mode no necesita una cuenta de kombify, ni un endpoint alojado de kombify, ni Techstack.

​
1. Instantánea de arquitectura

La instantánea de arquitectura, solo con hechos, describe un release: kits, topología, capacidades, modelo de ubicación, módulos, add-ons y madurez del soporte. CUE es la fuente de verdad técnica; la instantánea es una proyección de ella. Un consumidor lee la instantánea, nunca el CUE, y debe tolerar campos aditivos.

​
2. Verbos del ciclo de vida

Todos los kits se controlan con los mismos verbos mediante la CLI stackkit y el conector stackkit-mcp. Las entradas y salidas se documentan en la referencia de la CLI y en el recorrido por la CLI. Un verbo o bien se completa con evidencia o bien falla con un motivo terminal. Nunca informa de éxito por un trabajo que no hizo.

​
3. Taxonomía de ubicación

La ubicación describe dónde puede ejecutarse un kit o un módulo. El vocabulario se publica en foundation/placement.cue:
  • #PlacementMode: local-only, standard, managed-serverless
  • #PlacementSupport: metadatos de elegibilidad por módulo (en qué modos puede ejecutarse un módulo)
El ciclo de vida de código abierto realiza local-only y standard. managed-serverless es solo metadato de elegibilidad; su realización queda fuera de StackKits y fuera de esta spec.

​
4. Evidencia de verificación

Las palabras de madurez están respaldadas por evidencia, nunca declaradas. Las formas de la evidencia son JSON Schemas públicos; el release distribuye las instancias. Vocabulario:
  • Kits: supported (existe una vía de verificación citada para la celda confirmada), preview (se instala, pero la evidencia de verificación o de recuperación está pendiente), alpha (solo definición).
  • Filas de compatibilidad (sistemas operativos, hipervisores, kits por entorno, aplicaciones): supported (todas las fases del ciclo de vida se superaron en la ejecución más reciente sobre el release de evidencia), preview (de install a verify se superó; una fase posterior falló) o unverified (aún no hay una ejecución completada en ese release, o la ejecución más reciente falló antes de verify). La ausencia de evidencia se publica como unverified, nunca como soporte.
  • Un estado solo se amplía cuando existe una ejecución citada para el release exacto.

​
5. Conformidad

Una herramienta o un servicio es compatible con StackKit cuando
  1. consume la instantánea de arquitectura del release exacto al que se dirige,
  2. controla los kits solo mediante los verbos del ciclo de vida anteriores (directamente o a través del conector MCP) y conserva su evidencia,
  3. describe la ubicación con la taxonomía publicada, y
  4. publica los resultados de verificación en las formas de evidencia anteriores con la etiqueta del release a la que pertenecen.

​
Estado

Este es un borrador v0 publicado con la beta pública. Tras la beta llegará un repositorio de especificación aparte con una política de versionado; hasta entonces, el documento del repositorio y los artefactos enlazados son la spec.