nexakit 0.0.0-stage → 0.2.0

package/schemas/agent-task-verify.schema.json

@@ -0,0 +1,198 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-toolkit.local/schemas/agent-task-verify.schema.json",
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$" },
+    "revision": { "type": "string", "pattern": "^r[0-9]{2,4}$" },
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullableSha256": { "anyOf": [{ "$ref": "#/$defs/sha256" }, { "type": "null" }] },
+    "phase": { "enum": ["before", "after"] },
+    "root": { "enum": ["source", "handoff"] },
+    "operation": { "enum": ["inspect", "modify", "create", "delete"] },
+    "reason": { "type": "string", "pattern": "^verify-[a-z0-9-]{1,80}$" },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["projectId", "taskId", "revision"],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/id" },
+        "taskId": { "$ref": "#/$defs/id" },
+        "revision": { "$ref": "#/$defs/revision" }
+      }
+    },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "root", "path", "operation", "before", "after"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "root": { "$ref": "#/$defs/root" },
+        "path": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "operation": { "$ref": "#/$defs/operation" },
+        "before": { "$ref": "#/$defs/nullableSha256" },
+        "after": { "$ref": "#/$defs/nullableSha256" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "operation": { "const": "inspect" } } },
+          "then": { "properties": { "before": { "$ref": "#/$defs/sha256" }, "after": { "$ref": "#/$defs/sha256" } } }
+        },
+        {
+          "if": { "properties": { "operation": { "const": "modify" } } },
+          "then": { "properties": { "before": { "$ref": "#/$defs/sha256" }, "after": { "$ref": "#/$defs/sha256" } } }
+        },
+        {
+          "if": { "properties": { "operation": { "const": "create" } } },
+          "then": { "properties": { "before": { "type": "null" }, "after": { "$ref": "#/$defs/sha256" } } }
+        },
+        {
+          "if": { "properties": { "operation": { "const": "delete" } } },
+          "then": { "properties": { "before": { "$ref": "#/$defs/sha256" }, "after": { "type": "null" } } }
+        }
+      ]
+    },
+    "contract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "schemaVersion", "identity", "scope", "entries"],
+      "properties": {
+        "kind": { "const": "agent-task-verify-contract" },
+        "schemaVersion": { "const": "1.0.0" },
+        "identity": { "$ref": "#/$defs/identity" },
+        "scope": { "const": "listed-files-only" },
+        "entries": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "#/$defs/entry" } }
+      }
+    },
+    "observation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "status", "sha256"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "status": { "enum": ["present", "absent", "blocked"] },
+        "sha256": { "$ref": "#/$defs/nullableSha256" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "status": { "enum": ["absent", "blocked"] } } },
+          "then": { "properties": { "sha256": { "type": "null" } } }
+        }
+      ]
+    },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract", "phase", "observations"],
+      "properties": {
+        "contract": { "type": "object" },
+        "phase": { "$ref": "#/$defs/phase" },
+        "observations": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/observation" } }
+      }
+    },
+    "result": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "root", "operation", "outcome", "expected", "observed"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "root": { "$ref": "#/$defs/root" },
+        "operation": { "$ref": "#/$defs/operation" },
+        "outcome": { "enum": ["matched-hash", "matched-absent", "hash-differs", "missing", "unexpected-present"] },
+        "expected": { "$ref": "#/$defs/nullableSha256" },
+        "observed": { "$ref": "#/$defs/nullableSha256" }
+      }
+    },
+    "audit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["verifySchemaSha256", "contractSha256", "contractByteSha256", "expectedPinSha256"],
+      "properties": {
+        "verifySchemaSha256": { "$ref": "#/$defs/sha256" },
+        "contractSha256": { "$ref": "#/$defs/nullableSha256" },
+        "contractByteSha256": { "$ref": "#/$defs/nullableSha256" },
+        "expectedPinSha256": { "$ref": "#/$defs/nullableSha256" }
+      }
+    },
+    "report": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "command", "schemaVersion", "state", "phase", "identity", "provenance", "results", "reasons", "audit",
+        "scopeCoverage", "unlistedChangesVerified", "contentQualityVerified", "testsExecuted", "permissionVerified",
+        "approvalGranted", "gitStateVerified", "modelVerified", "nativeAdmission", "runtimeReady",
+        "wrote", "sent", "executed", "humanReviewRequired"
+      ],
+      "properties": {
+        "command": { "const": "agent-task verify" },
+        "schemaVersion": { "const": "1.0.0" },
+        "state": { "enum": ["matched", "mismatched", "blocked", "invalid"] },
+        "phase": { "anyOf": [{ "$ref": "#/$defs/phase" }, { "type": "null" }] },
+        "identity": { "anyOf": [{ "$ref": "#/$defs/identity" }, { "type": "null" }] },
+        "provenance": { "enum": ["none", "declared-observations", "local-read"] },
+        "results": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/result" } },
+        "reasons": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/reason" } },
+        "audit": { "$ref": "#/$defs/audit" },
+        "scopeCoverage": { "const": "listed-files-only" },
+        "unlistedChangesVerified": { "const": false },
+        "contentQualityVerified": { "const": false },
+        "testsExecuted": { "const": false },
+        "permissionVerified": { "const": false },
+        "approvalGranted": { "const": false },
+        "gitStateVerified": { "const": false },
+        "modelVerified": { "const": false },
+        "nativeAdmission": { "const": false },
+        "runtimeReady": { "const": false },
+        "wrote": { "const": false },
+        "sent": { "const": false },
+        "executed": { "const": false },
+        "humanReviewRequired": { "const": true }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "state": { "enum": ["matched", "mismatched"] } } },
+          "then": {
+            "properties": {
+              "provenance": { "enum": ["declared-observations", "local-read"] },
+              "results": { "type": "array", "minItems": 1 },
+              "identity": { "$ref": "#/$defs/identity" },
+              "phase": { "$ref": "#/$defs/phase" },
+              "audit": { "type": "object", "properties": { "contractSha256": { "$ref": "#/$defs/sha256" } } }
+            }
+          },
+          "else": {
+            "properties": {
+              "provenance": { "const": "none" },
+              "results": { "type": "array", "maxItems": 0 }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "provenance": { "const": "local-read" } } },
+          "then": {
+            "properties": {
+              "audit": {
+                "type": "object",
+                "properties": {
+                  "contractByteSha256": { "$ref": "#/$defs/sha256" },
+                  "expectedPinSha256": { "$ref": "#/$defs/sha256" }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "state": { "const": "matched" } } },
+          "then": {
+            "properties": {
+              "reasons": { "type": "array", "contains": { "const": "verify-matched" } },
+              "results": {
+                "type": "array",
+                "items": { "type": "object", "properties": { "outcome": { "enum": ["matched-hash", "matched-absent"] } } }
+              }
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/project-memory-update.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Project Memory Update Proposal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "projectId", "repository", "reviewBranch", "pr", "mergeCommit", "memoryHead", "manifestSha256", "notes"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "projectId": { "type": "string", "minLength": 2, "maxLength": 64, "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "repository": { "type": "string", "maxLength": 200, "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$" },
+    "reviewBranch": { "type": "string", "minLength": 1, "maxLength": 255 },
+    "pr": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+    "mergeCommit": { "$ref": "#/$defs/gitSha" },
+    "memoryHead": { "$ref": "#/$defs/gitSha" },
+    "manifestSha256": { "$ref": "#/$defs/sha256" },
+    "notes": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "$ref": "#/$defs/note" } }
+  },
+  "$defs": {
+    "gitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "relativePath": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "note": {
+      "type": "object", "additionalProperties": false,
+      "required": ["path", "beforeSha256", "content", "sourcePaths"],
+      "properties": {
+        "path": { "$ref": "#/$defs/relativePath" },
+        "beforeSha256": { "$ref": "#/$defs/sha256" },
+        "content": { "type": "string", "minLength": 1, "maxLength": 1048576 },
+        "sourcePaths": { "type": "array", "minItems": 1, "maxItems": 20, "uniqueItems": true, "items": { "$ref": "#/$defs/relativePath" } }
+      }
+    }
+  }
+}

package/schemas/project-memory.schema.json

@@ -0,0 +1,298 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-toolkit.local/schemas/project-memory.schema.json",
+  "title": "Project Memory Manifest",
+  "description": "Contrato portable para conectar un repositorio, una memoria privada y agentes compatibles.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "project",
+    "source",
+    "memory",
+    "agents",
+    "security"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "minLength": 1
+    },
+    "schemaVersion": {
+      "const": "1.0.0"
+    },
+    "project": {
+      "$ref": "#/$defs/project"
+    },
+    "source": {
+      "$ref": "#/$defs/source"
+    },
+    "memory": {
+      "$ref": "#/$defs/memory"
+    },
+    "agents": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/agent"
+      }
+    },
+    "security": {
+      "$ref": "#/$defs/security"
+    },
+    "automation": {
+      "$ref": "#/$defs/automation"
+    }
+  },
+  "$defs": {
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+          "minLength": 2,
+          "maxLength": 64
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 500
+        }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "repositoryPath",
+        "defaultBranch"
+      ],
+      "properties": {
+        "repositoryPath": {
+          "$ref": "#/$defs/localPath"
+        },
+        "remoteUrl": {
+          "type": "string",
+          "minLength": 1,
+          "description": "URL pública o privada sin credenciales incrustadas."
+        },
+        "defaultBranch": {
+          "$ref": "#/$defs/branchName"
+        },
+        "integrationBranch": {
+          "$ref": "#/$defs/branchName"
+        },
+        "documentationPaths": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "memory": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "vaultPath",
+        "mcpServerName",
+        "repositoryBranch",
+        "syncMode"
+      ],
+      "properties": {
+        "vaultPath": {
+          "$ref": "#/$defs/localPath"
+        },
+        "repositoryRemote": {
+          "type": "string",
+          "minLength": 1,
+          "description": "URL del remoto sin tokens ni credenciales incrustadas."
+        },
+        "repositoryBranch": {
+          "$ref": "#/$defs/branchName"
+        },
+        "mcpServerName": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+          "minLength": 2,
+          "maxLength": 80
+        },
+        "syncMode": {
+          "enum": [
+            "git-manual",
+            "git-automated",
+            "none"
+          ]
+        },
+        "layout": {
+          "$ref": "#/$defs/layout"
+        }
+      }
+    },
+    "layout": {
+      "description": "Estructura que project-memory doctor debe exigir en la bóveda.",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "profile"
+          ],
+          "properties": {
+            "profile": {
+              "const": "canonical-v1"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "profile",
+            "requiredDirectories",
+            "requiredNotes"
+          ],
+          "properties": {
+            "profile": {
+              "const": "declared"
+            },
+            "requiredDirectories": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 64,
+              "uniqueItems": true,
+              "items": {
+                "$ref": "#/$defs/relativeMemoryPath"
+              }
+            },
+            "requiredNotes": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 128,
+              "uniqueItems": true,
+              "items": {
+                "$ref": "#/$defs/relativeMarkdownPath"
+              }
+            }
+          }
+        }
+      ]
+    },
+    "agent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "enabled"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+          "minLength": 2,
+          "maxLength": 64
+        },
+        "enabled": {
+          "type": "boolean"
+        },
+        "skillName": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+          "minLength": 2,
+          "maxLength": 80
+        }
+      }
+    },
+    "security": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mcpAccess",
+        "sensitiveDataPolicy",
+        "writeRequiresExplicitAuthorization",
+        "allowCredentialsInMemory"
+      ],
+      "properties": {
+        "mcpAccess": {
+          "const": "read-only"
+        },
+        "sensitiveDataPolicy": {
+          "const": "forbidden"
+        },
+        "writeRequiresExplicitAuthorization": {
+          "const": true
+        },
+        "allowCredentialsInMemory": {
+          "const": false
+        }
+      }
+    },
+    "automation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "requiresMergedChange"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "reviewBranch": {
+          "$ref": "#/$defs/branchName"
+        },
+        "requiresMergedChange": {
+          "const": true
+        },
+        "schedule": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Descripción portable; la plataforma decide el formato ejecutable."
+        }
+      }
+    },
+    "localPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4096,
+      "description": "Ruta local absoluta o resoluble por el adaptador de la plataforma."
+    },
+    "relativeMemoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*\\\\)(?!.*\\/$).+$",
+      "description": "Ruta relativa a la raíz de la bóveda, sin retrocesos ni separadores finales."
+    },
+    "relativeMarkdownPath": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/relativeMemoryPath"
+        },
+        {
+          "type": "string",
+          "pattern": "\\.md$"
+        }
+      ]
+    },
+    "branchName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 255,
+      "pattern": "^(?!.*(?:\\.\\.|//|@\\{|\\\\))[A-Za-z0-9][A-Za-z0-9._/-]*[A-Za-z0-9]$|^[A-Za-z0-9]$"
+    }
+  }
+}