@cleocode/cleo 2026.2.5 → 2026.2.7

package/schemas/brain-decision.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/brain-decision.schema.json",
+  "schemaVersion": "1.0.0",
+  "title": "CLEO BRAIN Decision Memory Schema",
+  "description": "Schema for decision memory entries. Runtime store is SQLite (brain_decisions table). JSONL format is used for export/import portability. See ADR-009 Section 3.2.",
+  "type": "object",
+  "required": ["id", "type", "decision", "rationale", "confidence", "createdAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^D\\d+$",
+      "description": "Decision identifier (e.g., 'D001')."
+    },
+    "type": {
+      "type": "string",
+      "enum": ["architecture", "technical", "process", "strategic", "tactical"],
+      "description": "Category of the decision."
+    },
+    "decision": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The decision statement."
+    },
+    "rationale": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Why this decision was made."
+    },
+    "confidence": {
+      "type": "string",
+      "enum": ["low", "medium", "high"],
+      "description": "Confidence level in the decision."
+    },
+    "outcome": {
+      "type": ["string", "null"],
+      "enum": ["success", "failure", "mixed", "pending", null],
+      "description": "Observed outcome of the decision. Null if not yet evaluated."
+    },
+    "alternatives": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Alternative approaches that were considered."
+    },
+    "contextEpicId": {
+      "type": ["string", "null"],
+      "description": "Epic ID this decision relates to."
+    },
+    "contextTaskId": {
+      "type": ["string", "null"],
+      "description": "Task ID this decision relates to."
+    },
+    "contextPhase": {
+      "type": ["string", "null"],
+      "description": "Lifecycle phase when the decision was made."
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when the decision was recorded."
+    },
+    "updatedAt": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last update."
+    }
+  }
+}

package/schemas/brain-learning.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/brain-learning.schema.json",
+  "schemaVersion": "1.0.0",
+  "title": "CLEO BRAIN Learning Memory Schema",
+  "description": "Schema for learning memory entries. Runtime store is SQLite (brain_learnings table). JSONL format is used for export/import portability. See ADR-009 Section 3.2.",
+  "type": "object",
+  "required": ["id", "insight", "source", "confidence", "createdAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^L\\d+$",
+      "description": "Learning identifier (e.g., 'L001')."
+    },
+    "insight": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The learned insight."
+    },
+    "source": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Source of the insight (e.g., task completion analysis, blocker patterns)."
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0.0,
+      "maximum": 1.0,
+      "description": "Confidence score (0.0-1.0) in the insight."
+    },
+    "actionable": {
+      "type": "boolean",
+      "default": false,
+      "description": "Whether this insight has a concrete actionable recommendation."
+    },
+    "application": {
+      "type": ["string", "null"],
+      "description": "How to apply this insight in future work."
+    },
+    "applicableTypes": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Task types this insight applies to."
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when the learning was recorded."
+    },
+    "updatedAt": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last update."
+    }
+  }
+}

package/schemas/brain-pattern.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/brain-pattern.schema.json",
+  "schemaVersion": "1.0.0",
+  "title": "CLEO BRAIN Pattern Memory Schema",
+  "description": "Schema for pattern memory entries. Runtime store is SQLite (brain_patterns table). JSONL format is used for export/import portability. See ADR-009 Section 3.2.",
+  "type": "object",
+  "required": ["id", "type", "pattern", "context", "extractedAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^P\\d+$",
+      "description": "Pattern identifier (e.g., 'P001')."
+    },
+    "type": {
+      "type": "string",
+      "enum": ["workflow", "blocker", "success", "failure", "optimization"],
+      "description": "Category of the pattern."
+    },
+    "pattern": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Description of the observed pattern."
+    },
+    "context": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Context in which the pattern was observed."
+    },
+    "frequency": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 1,
+      "description": "Number of times this pattern has been observed."
+    },
+    "successRate": {
+      "type": ["number", "null"],
+      "minimum": 0.0,
+      "maximum": 1.0,
+      "description": "Success rate for workflow patterns (0.0-1.0)."
+    },
+    "impact": {
+      "type": ["string", "null"],
+      "enum": ["low", "medium", "high", null],
+      "description": "Impact level of the pattern."
+    },
+    "antiPattern": {
+      "type": ["string", "null"],
+      "description": "The anti-pattern to avoid, if applicable."
+    },
+    "mitigation": {
+      "type": ["string", "null"],
+      "description": "Recommended mitigation for blocker/failure patterns."
+    },
+    "examples": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Task IDs that exemplify this pattern."
+    },
+    "extractedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when the pattern was first extracted."
+    },
+    "updatedAt": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last update."
+    }
+  }
+}

package/schemas/config.schema.json

@@ -292,7 +292,7 @@
     },
     "logging": {
       "type": "object",
-      "description": "Change history logging settings.",
+      "description": "Legacy JSONL change history settings. Audit logs are now stored in SQLite audit_log table (T4837). This section is retained for backward compatibility but is no longer actively used by the SQLite engine.",
       "additionalProperties": false,
       "properties": {
         "enabled": {
@@ -324,6 +324,38 @@
         }
       }
     },
+    "pinoLogging": {
+      "type": "object",
+      "description": "Application diagnostic logging (pino). Writes to .cleo/logs/cleo.log.",
+      "additionalProperties": false,
+      "properties": {
+        "level": {
+          "type": "string",
+          "enum": ["trace", "debug", "info", "warn", "error", "fatal", "silent"],
+          "default": "info",
+          "description": "Minimum log level to record."
+        },
+        "filePath": {
+          "type": "string",
+          "default": "logs/cleo.log",
+          "description": "Log file path relative to .cleo/ directory."
+        },
+        "maxFileSize": {
+          "type": "integer",
+          "minimum": 1048576,
+          "maximum": 1073741824,
+          "default": 10485760,
+          "description": "Max log file size in bytes before rotation (default: 10MB)."
+        },
+        "maxFiles": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100,
+          "default": 5,
+          "description": "Number of rotated log files to retain."
+        }
+      }
+    },
     "validation": {
       "type": "object",
       "description": "Validation and integrity settings.",

package/schemas/grade.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "GradeResult",
+  "description": "Agent behavioral grade result from session audit analysis",
+  "_meta": {
+    "schemaVersion": "1.0.0"
+  },
+  "type": "object",
+  "required": ["sessionId", "totalScore", "maxScore", "dimensions", "flags", "timestamp", "entryCount"],
+  "properties": {
+    "sessionId": { "type": "string", "description": "Session ID that was graded" },
+    "taskId": { "type": "string", "description": "Optional associated task ID" },
+    "totalScore": { "type": "number", "minimum": 0, "maximum": 100 },
+    "maxScore": { "type": "number", "minimum": 0, "maximum": 100, "default": 100 },
+    "dimensions": {
+      "type": "object",
+      "properties": {
+        "sessionDiscipline": { "$ref": "#/definitions/dimensionScore" },
+        "discoveryEfficiency": { "$ref": "#/definitions/dimensionScore" },
+        "taskHygiene": { "$ref": "#/definitions/dimensionScore" },
+        "errorProtocol": { "$ref": "#/definitions/dimensionScore" },
+        "disclosureUse": { "$ref": "#/definitions/dimensionScore" }
+      }
+    },
+    "flags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific violations or improvement suggestions"
+    },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "entryCount": { "type": "number", "minimum": 0 },
+    "evaluator": { "type": "string", "enum": ["auto", "manual"] }
+  },
+  "definitions": {
+    "dimensionScore": {
+      "type": "object",
+      "required": ["score", "max", "evidence"],
+      "properties": {
+        "score": { "type": "number", "minimum": 0 },
+        "max": { "type": "number", "minimum": 0 },
+        "evidence": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Specific observations contributing to this score"
+        }
+      }
+    }
+  }
+}

package/schemas/project-info.schema.json

@@ -36,28 +36,38 @@
     "schemas": {
       "type": "object",
       "description": "Schema versions for core CLEO data files in this project.",
-      "required": ["todo", "config", "archive", "log"],
+      "required": ["config"],
       "additionalProperties": false,
       "properties": {
-        "todo": {
+        "config": {
           "type": "string",
           "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version for todo.json (semver)."
+          "description": "Schema version for config.json (semver)."
         },
-        "config": {
+        "sqlite": {
           "type": "string",
           "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version for config.json (semver)."
+          "description": "Schema version for tasks.db SQLite store (semver)."
+        },
+        "projectContext": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Schema version for project-context.json (semver)."
+        },
+        "todo": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Deprecated: JSON todo.json schema version. Kept for backward compatibility."
         },
         "archive": {
           "type": "string",
           "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version for todo-archive.json (semver)."
+          "description": "Deprecated: JSON archive schema version. Kept for backward compatibility."
         },
         "log": {
           "type": "string",
           "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version for todo-log.jsonl (semver)."
+          "description": "Deprecated: JSON log schema version. Kept for backward compatibility."
         }
       }
     },

package/schemas/protocol-frontmatter.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo.dev/schemas/protocol-frontmatter.schema.json",
+  "title": "Protocol Frontmatter Schema",
+  "description": "JSON Schema for CLEO protocol YAML frontmatter blocks",
+  "_meta": {
+    "schemaVersion": "1.0.0"
+  },
+  "type": "object",
+  "required": ["id", "title", "version", "status"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "enum": ["RSCH", "CONS", "SPEC", "DCMP", "IMPL", "CONT", "VALID", "TEST", "REL", "ADR", "ART", "PROV", "AGENT"],
+      "description": "Short protocol code"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Full protocol title"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semver version"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["active", "draft", "deprecated", "experimental"]
+    },
+    "type": {
+      "type": "string",
+      "enum": ["base", "conditional", "cross-cutting"]
+    },
+    "audience": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "skillRef": {
+      "type": "string",
+      "description": "ct-skills skill that executes this pipeline"
+    },
+    "mcpOperations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "lastUpdated": {
+      "type": "string",
+      "description": "ISO date string"
+    },
+    "provenanceTask": {
+      "type": "string",
+      "pattern": "^T\\d+$",
+      "description": "CLEO task ID that originated this protocol"
+    },
+    "enforcement": {
+      "type": "string",
+      "enum": ["strict", "advisory", "disabled"]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/rcasd-consensus-report.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-consensus-report.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-consensus-report.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-consensus-report schema."
+}

package/schemas/rcasd-evidence.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "schemaVersion": "1.0.0",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-evidence.schema.json",
+  "title": "RCASD Evidence",
+  "description": "Schema for lifecycle stage evidence records. Evidence links artifacts (files, URLs, manifests) to specific pipeline stages for provenance tracking.",
+  "type": "object",
+  "required": ["id", "stageId", "uri", "type", "recordedAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique evidence identifier"
+    },
+    "stageId": {
+      "type": "string",
+      "description": "Reference to the lifecycle stage this evidence supports"
+    },
+    "uri": {
+      "type": "string",
+      "description": "URI pointing to the evidence artifact"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["file", "url", "manifest"],
+      "description": "Type of evidence artifact"
+    },
+    "recordedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the evidence was recorded"
+    },
+    "recordedBy": {
+      "type": ["string", "null"],
+      "description": "Agent or user who recorded the evidence"
+    },
+    "description": {
+      "type": ["string", "null"],
+      "description": "Description of what this evidence demonstrates"
+    }
+  }
+}

package/schemas/rcasd-gate-result.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "schemaVersion": "1.0.0",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-gate-result.schema.json",
+  "title": "RCASD Gate Result",
+  "description": "Schema for lifecycle gate check results. Gates enforce quality requirements at stage boundaries in the RCASD-IVTR pipeline.",
+  "type": "object",
+  "required": ["id", "stageId", "gateName", "result", "checkedAt", "checkedBy"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique gate result identifier"
+    },
+    "stageId": {
+      "type": "string",
+      "description": "Reference to the lifecycle stage this gate belongs to"
+    },
+    "gateName": {
+      "type": "string",
+      "description": "Name of the gate check (e.g., prerequisites-met, code-complete)"
+    },
+    "result": {
+      "type": "string",
+      "enum": ["pass", "fail", "warn"],
+      "description": "Gate check result"
+    },
+    "checkedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the gate was checked"
+    },
+    "checkedBy": {
+      "type": "string",
+      "description": "Agent or user who performed the check"
+    },
+    "details": {
+      "type": ["string", "null"],
+      "description": "Additional details about the check result"
+    },
+    "reason": {
+      "type": ["string", "null"],
+      "description": "Reason for failure or warning"
+    }
+  }
+}

package/schemas/rcasd-hitl-resolution.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-hitl-resolution.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-hitl-resolution.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-hitl-resolution schema."
+}

package/schemas/rcasd-index.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-index.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-index.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-index schema."
+}

package/schemas/rcasd-manifest.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-manifest.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-manifest.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-manifest schema."
+}

package/schemas/rcasd-research-output.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-research-output.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-research-output.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-research-output schema."
+}

package/schemas/rcasd-spec-frontmatter.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-spec-frontmatter.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-spec-frontmatter.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-spec-frontmatter schema."
+}