@saulwade/swl-ses 2.6.0 → 2.8.0

package/schemas/agent-output-review.schema.json

@@ -1,98 +1,98 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$schemaVersion": "1.0.0",
-  "title": "AgentOutputReview",
-  "description": "Schema para output estructurado de agentes revisores (codigo, seguridad, lenguaje). Garantiza formato parseable entre agentes.",
-  "type": "object",
-  "required": [
-    "veredicto",
-    "criticos",
-    "mayores",
-    "menores",
-    "hallazgos"
-  ],
-  "properties": {
-    "veredicto": {
-      "type": "string",
-      "enum": [
-        "APROBADO",
-        "APROBADO_CON_OBSERVACIONES",
-        "REQUIERE_CORRECCIONES",
-        "RECHAZADO"
-      ],
-      "description": "Resultado global de la revision"
-    },
-    "criticos": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Cantidad de hallazgos criticos (bloquean merge)"
-    },
-    "mayores": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Cantidad de hallazgos mayores (requieren atencion)"
-    },
-    "menores": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Cantidad de hallazgos menores (sugerencias)"
-    },
-    "hallazgos": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": [
-          "severidad",
-          "archivo",
-          "descripcion"
-        ],
-        "properties": {
-          "severidad": {
-            "type": "string",
-            "enum": [
-              "CRITICO",
-              "MAYOR",
-              "MENOR"
-            ],
-            "description": "Nivel de severidad del hallazgo"
-          },
-          "archivo": {
-            "type": "string",
-            "description": "Ruta del archivo afectado"
-          },
-          "linea": {
-            "type": "integer",
-            "minimum": 1,
-            "description": "Numero de linea (opcional)"
-          },
-          "descripcion": {
-            "type": "string",
-            "description": "Que se encontro"
-          },
-          "fix": {
-            "type": "string",
-            "description": "Como corregirlo"
-          },
-          "cvss": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 10,
-            "description": "Score CVSSv3 (solo para revisor-seguridad)"
-          }
-        }
-      }
-    },
-    "cobertura": {
-      "type": "number",
-      "minimum": 0,
-      "maximum": 100,
-      "description": "Porcentaje de cobertura de tests (si aplica)"
-    },
-    "score": {
-      "type": "number",
-      "minimum": 0,
-      "maximum": 10,
-      "description": "Score global de calidad 0-10"
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$schemaVersion": "1.0.0",
+  "title": "AgentOutputReview",
+  "description": "Schema para output estructurado de agentes revisores (codigo, seguridad, lenguaje). Garantiza formato parseable entre agentes.",
+  "type": "object",
+  "required": [
+    "veredicto",
+    "criticos",
+    "mayores",
+    "menores",
+    "hallazgos"
+  ],
+  "properties": {
+    "veredicto": {
+      "type": "string",
+      "enum": [
+        "APROBADO",
+        "APROBADO_CON_OBSERVACIONES",
+        "REQUIERE_CORRECCIONES",
+        "RECHAZADO"
+      ],
+      "description": "Resultado global de la revision"
+    },
+    "criticos": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Cantidad de hallazgos criticos (bloquean merge)"
+    },
+    "mayores": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Cantidad de hallazgos mayores (requieren atencion)"
+    },
+    "menores": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Cantidad de hallazgos menores (sugerencias)"
+    },
+    "hallazgos": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "severidad",
+          "archivo",
+          "descripcion"
+        ],
+        "properties": {
+          "severidad": {
+            "type": "string",
+            "enum": [
+              "CRITICO",
+              "MAYOR",
+              "MENOR"
+            ],
+            "description": "Nivel de severidad del hallazgo"
+          },
+          "archivo": {
+            "type": "string",
+            "description": "Ruta del archivo afectado"
+          },
+          "linea": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Numero de linea (opcional)"
+          },
+          "descripcion": {
+            "type": "string",
+            "description": "Que se encontro"
+          },
+          "fix": {
+            "type": "string",
+            "description": "Como corregirlo"
+          },
+          "cvss": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 10,
+            "description": "Score CVSSv3 (solo para revisor-seguridad)"
+          }
+        }
+      }
+    },
+    "cobertura": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 100,
+      "description": "Porcentaje de cobertura de tests (si aplica)"
+    },
+    "score": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 10,
+      "description": "Score global de calidad 0-10"
+    }
+  }
+}

package/schemas/diary-entry.schema.json

@@ -1,112 +1,112 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://swl-ses.dev/schemas/diary-entry.json",
-  "$schemaVersion": "1.0.0",
-  "title": "SWL Diary Entry",
-  "description": "Diario estructurado por sesion. Captura logros, decisiones, challenges y aprendizajes clave en formato consumible por /swl:aprender.",
-  "type": "object",
-  "required": [
-    "id",
-    "sessionId",
-    "date",
-    "createdAt"
-  ],
-  "properties": {
-    "id": {
-      "type": "string",
-      "pattern": "^diary-\\d{8}-[a-f0-9]+$",
-      "description": "ID unico del diario: diary-YYYYMMDD-{hash}"
-    },
-    "sessionId": {
-      "type": "string",
-      "minLength": 1,
-      "description": "ID de la sesion de Claude Code que origina el diario"
-    },
-    "agent": {
-      "type": [
-        "string",
-        "null"
-      ],
-      "description": "Agente principal de la sesion (si aplica)"
-    },
-    "date": {
-      "type": "string",
-      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-      "description": "Fecha de la sesion en formato YYYY-MM-DD"
-    },
-    "startTime": {
-      "type": [
-        "string",
-        "null"
-      ],
-      "format": "date-time",
-      "description": "Inicio de la sesion en ISO 8601"
-    },
-    "endTime": {
-      "type": [
-        "string",
-        "null"
-      ],
-      "format": "date-time",
-      "description": "Fin de la sesion en ISO 8601 (null si esta abierta)"
-    },
-    "accomplishments": {
-      "type": "array",
-      "maxItems": 20,
-      "items": {
-        "type": "string",
-        "maxLength": 500
-      },
-      "description": "Logros concretos de la sesion"
-    },
-    "decisions": {
-      "type": "array",
-      "maxItems": 20,
-      "items": {
-        "type": "string",
-        "maxLength": 500
-      },
-      "description": "Decisiones tomadas con su justificacion breve"
-    },
-    "challenges": {
-      "type": "array",
-      "maxItems": 20,
-      "items": {
-        "type": "string",
-        "maxLength": 500
-      },
-      "description": "Bloqueos o problemas encontrados"
-    },
-    "keyLearnings": {
-      "type": "array",
-      "maxItems": 20,
-      "items": {
-        "type": "string",
-        "maxLength": 500
-      },
-      "description": "Aprendizajes clave que alimentan APRENDIZAJES.md o instintos"
-    },
-    "tags": {
-      "type": "array",
-      "maxItems": 20,
-      "items": {
-        "type": "string",
-        "maxLength": 500
-      },
-      "description": "Etiquetas para clasificacion y busqueda"
-    },
-    "sourceAgents": {
-      "type": "array",
-      "uniqueItems": true,
-      "items": {
-        "type": "string"
-      },
-      "description": "Agentes que contribuyeron a la sesion (cross-agent enrichment)"
-    },
-    "createdAt": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Timestamp de creacion del diario"
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/diary-entry.json",
+  "$schemaVersion": "1.0.0",
+  "title": "SWL Diary Entry",
+  "description": "Diario estructurado por sesion. Captura logros, decisiones, challenges y aprendizajes clave en formato consumible por /swl:aprender.",
+  "type": "object",
+  "required": [
+    "id",
+    "sessionId",
+    "date",
+    "createdAt"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^diary-\\d{8}-[a-f0-9]+$",
+      "description": "ID unico del diario: diary-YYYYMMDD-{hash}"
+    },
+    "sessionId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "ID de la sesion de Claude Code que origina el diario"
+    },
+    "agent": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "Agente principal de la sesion (si aplica)"
+    },
+    "date": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "Fecha de la sesion en formato YYYY-MM-DD"
+    },
+    "startTime": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "format": "date-time",
+      "description": "Inicio de la sesion en ISO 8601"
+    },
+    "endTime": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "format": "date-time",
+      "description": "Fin de la sesion en ISO 8601 (null si esta abierta)"
+    },
+    "accomplishments": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "type": "string",
+        "maxLength": 500
+      },
+      "description": "Logros concretos de la sesion"
+    },
+    "decisions": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "type": "string",
+        "maxLength": 500
+      },
+      "description": "Decisiones tomadas con su justificacion breve"
+    },
+    "challenges": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "type": "string",
+        "maxLength": 500
+      },
+      "description": "Bloqueos o problemas encontrados"
+    },
+    "keyLearnings": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "type": "string",
+        "maxLength": 500
+      },
+      "description": "Aprendizajes clave que alimentan APRENDIZAJES.md o instintos"
+    },
+    "tags": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "type": "string",
+        "maxLength": 500
+      },
+      "description": "Etiquetas para clasificacion y busqueda"
+    },
+    "sourceAgents": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string"
+      },
+      "description": "Agentes que contribuyeron a la sesion (cross-agent enrichment)"
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Timestamp de creacion del diario"
+    }
+  }
+}

package/schemas/gate-state.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/gate-state.schema.json",
+  "title": "SWL Verified Gate State v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "phaseId", "configurationDigest", "planDigest",
+    "activeApprovalDigest", "activeG1",
+    "planVersion", "phaseState", "version", "taskStates", "planInvalidated",
+    "observedPlanDigest", "lastEvent"
+  ],
+  "properties": {
+    "kind": { "const": "verified-gate-state" },
+    "schemaVersion": { "const": "1.0.0" },
+    "phaseId": { "$ref": "#/$defs/identifier" },
+    "configurationDigest": { "$ref": "#/$defs/sha256" },
+    "planDigest": { "$ref": "#/$defs/sha256" },
+    "activeApprovalDigest": { "$ref": "#/$defs/sha256" },
+    "activeG1": { "oneOf": [{ "$ref": "#/$defs/g1Approval" }, { "type": "null" }] },
+    "planVersion": { "$ref": "#/$defs/identifier" },
+    "phaseState": {
+      "enum": [
+        "sin_spec", "spec_validada", "plan_aprobado", "red_evidenciado",
+        "tdd_exento", "implementacion_activa", "tests_verdes",
+        "trazabilidad_verificada", "cerrada"
+      ]
+    },
+    "version": { "type": "integer", "minimum": 0 },
+    "taskStates": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "$ref": "#/$defs/taskState" },
+      "propertyNames": { "pattern": "^T-[0-9]{2}$" }
+    },
+    "planInvalidated": { "type": "boolean" },
+    "observedPlanDigest": { "oneOf": [{ "$ref": "#/$defs/sha256" }, { "type": "null" }] },
+    "lastEvent": { "oneOf": [{ "type": "string" }, { "type": "null" }] }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "identifier": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$" },
+    "g1Approval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind", "approvalDigest", "evidenceDigest", "approverDigest", "phaseId",
+        "planDigest", "planBindingDigest", "issuedAt", "expiresAt"
+      ],
+      "properties": {
+        "kind": { "const": "g1-approval-receipt" },
+        "approvalDigest": { "$ref": "#/$defs/sha256" },
+        "evidenceDigest": { "$ref": "#/$defs/sha256" },
+        "approverDigest": { "$ref": "#/$defs/sha256" },
+        "phaseId": { "$ref": "#/$defs/identifier" },
+        "planDigest": { "$ref": "#/$defs/sha256" },
+        "planBindingDigest": { "$ref": "#/$defs/sha256" },
+        "issuedAt": { "type": "string", "format": "date-time" },
+        "expiresAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "taskState": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "g2EvidenceDigest", "g3EvidenceDigest", "baseHead"],
+      "properties": {
+        "state": {
+          "enum": ["pendiente", "red_evidenciado", "tdd_exento", "implementacion_activa", "tests_verdes"]
+        },
+        "g2EvidenceDigest": { "oneOf": [{ "$ref": "#/$defs/sha256" }, { "type": "null" }] },
+        "g3EvidenceDigest": { "oneOf": [{ "$ref": "#/$defs/sha256" }, { "type": "null" }] },
+        "baseHead": { "oneOf": [{ "type": "string", "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$" }, { "type": "null" }] }
+      }
+    }
+  }
+}