@cleocode/core 2026.4.4 → 2026.4.6

package/schemas/grade.schema.json

@@ -1,49 +0,0 @@
-{
-  "$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/log.schema.json

@@ -1,250 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://cleo-dev.com/schemas/v1/log.schema.json",
-  "schemaVersion": "2.4.0",
-  "title": "CLEO Change Log Schema",
-  "description": "Immutable audit trail of all task operations. Used for debugging, history, and anti-hallucination verification.",
-  "type": "object",
-  "required": [
-    "version",
-    "project",
-    "entries",
-    "_meta"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Legacy schema version field (deprecated, use _meta.schemaVersion)"
-    },
-    "project": {
-      "type": "string",
-      "description": "Project identifier. Must match todo.json."
-    },
-    "_meta": {
-      "type": "object",
-      "required": [
-        "schemaVersion",
-        "totalEntries",
-        "firstEntry",
-        "lastEntry"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "schemaVersion": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version for this file (semver). Canonical source for schema version (replaces root version field)."
-        },
-        "formatVersion": {
-          "type": "string",
-          "pattern": "^\\d+$",
-          "default": "1",
-          "description": "Log entry format version for future compatibility. Increment when entry structure changes."
-        },
-        "totalEntries": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "firstEntry": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "format": "date-time"
-        },
-        "lastEntry": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "format": "date-time"
-        },
-        "entriesPruned": {
-          "type": "integer",
-          "default": 0,
-          "description": "Count of entries removed due to retention policy."
-        }
-      }
-    },
-    "entries": {
-      "type": "array",
-      "description": "Log entries in chronological order. Append-only.",
-      "items": {
-        "$ref": "#/definitions/logEntry"
-      }
-    }
-  },
-  "definitions": {
-    "logEntry": {
-      "type": "object",
-      "required": [
-        "id",
-        "timestamp",
-        "action",
-        "actor"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^log_[a-f0-9]{12}$",
-          "description": "Unique log entry ID. Format: log_<12-hex-chars>"
-        },
-        "timestamp": {
-          "type": "string",
-          "format": "date-time",
-          "description": "When this action occurred."
-        },
-        "sessionId": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "Session that performed this action."
-        },
-        "action": {
-          "type": "string",
-          "enum": [
-            "session_start",
-            "session_end",
-            "session_suspended",
-            "session_resumed",
-            "session_scope_defined",
-            "session_scope_conflict",
-            "session_focus_changed",
-            "session_timeout_warning",
-            "session_orphan_detected",
-            "session_auto_suspended",
-            "task_created",
-            "task_updated",
-            "status_changed",
-            "task_archived",
-            "focus_changed",
-            "config_changed",
-            "validation_run",
-            "checksum_updated",
-            "error_occurred",
-            "phase_changed",
-            "phase_started",
-            "phase_completed",
-            "phase_rollback"
-          ],
-          "description": "Type of action logged. Session actions (multi-session): session_suspended (paused), session_resumed (continued), session_scope_defined (scope created), session_scope_conflict (overlap detected), session_focus_changed (focus within session), session_timeout_warning (stale session), session_orphan_detected (crashed session), session_auto_suspended (timeout suspend). Phase actions: phase_changed, phase_started, phase_completed, phase_rollback."
-        },
-        "actor": {
-          "type": "string",
-          "enum": [
-            "human",
-            "claude",
-            "system"
-          ],
-          "description": "Who/what performed the action."
-        },
-        "taskId": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "pattern": "^T\\d{3,}$",
-          "description": "Task ID if action relates to a specific task."
-        },
-        "before": {
-          "type": [
-            "object",
-            "null"
-          ],
-          "description": "State before the action (for changes)."
-        },
-        "after": {
-          "type": [
-            "object",
-            "null"
-          ],
-          "description": "State after the action (for changes)."
-        },
-        "details": {
-          "type": [
-            "object",
-            "string",
-            "null"
-          ],
-          "description": "Additional context about the action."
-        },
-        "scope": {
-          "type": [
-            "object",
-            "null"
-          ],
-          "description": "Session scope context for multi-session log entries. Null for single-session mode.",
-          "additionalProperties": false,
-          "properties": {
-            "type": {
-              "type": "string",
-              "enum": [
-                "task",
-                "taskGroup",
-                "subtree",
-                "epicPhase",
-                "epic",
-                "custom"
-              ],
-              "description": "Scope type from session definition."
-            },
-            "rootTaskId": {
-              "type": "string",
-              "pattern": "^T\\d{3,}$",
-              "description": "Root task defining the scope."
-            },
-            "phaseFilter": {
-              "type": [
-                "string",
-                "null"
-              ],
-              "description": "Phase filter if scope is phase-limited."
-            },
-            "taskCount": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Number of tasks in scope at log time."
-            }
-          }
-        },
-        "agentId": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "Agent identifier in multi-session mode (e.g., 'opus-1', 'haiku-2')."
-        },
-        "otherActiveSessions": {
-          "type": [
-            "integer",
-            "null"
-          ],
-          "minimum": 0,
-          "description": "Count of other active sessions at log time. Useful for concurrency auditing."
-        },
-        "error": {
-          "type": [
-            "object",
-            "null"
-          ],
-          "description": "Error details if action failed.",
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "recoverable": {
-              "type": "boolean"
-            }
-          }
-        }
-      }
-    }
-  }
-}

package/schemas/metrics.schema.json

@@ -1,328 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://cleo-dev.com/schemas/v1/metrics.schema.json",
-  "schemaVersion": "1.0.0",
-  "title": "CLEO Metrics Schema",
-  "description": "Self-auditing metrics system for compliance, efficiency, session, and self-improvement tracking. ALL fields use STRICT ENUMS - NO freetext allowed.",
-  "type": "object",
-  "additionalProperties": false,
-
-  "definitions": {
-    "severityEnum": {
-      "type": "string",
-      "enum": ["low", "medium", "high", "critical"],
-      "description": "Violation severity level"
-    },
-    "manifestIntegrityEnum": {
-      "type": "string",
-      "enum": ["valid", "partial", "invalid", "missing"],
-      "description": "Manifest file integrity state"
-    },
-    "instructionStabilityEnum": {
-      "type": "string",
-      "enum": ["stable", "clarified", "revised", "unstable"],
-      "description": "User instruction consistency within session"
-    },
-    "sessionDegradationEnum": {
-      "type": "string",
-      "enum": ["none", "mild", "moderate", "severe"],
-      "description": "Performance degradation over session lifetime"
-    },
-    "agentReliabilityEnum": {
-      "type": "string",
-      "enum": ["high", "medium", "low", "unreliable"],
-      "description": "Agent task completion reliability rating"
-    },
-    "metricCategoryEnum": {
-      "type": "string",
-      "enum": ["compliance", "efficiency", "session", "improvement"],
-      "description": "Metric category classification"
-    },
-    "metricSourceEnum": {
-      "type": "string",
-      "enum": ["task", "session", "agent", "system", "orchestrator"],
-      "description": "Entity that generated this metric"
-    },
-    "aggregationPeriodEnum": {
-      "type": "string",
-      "enum": ["instant", "hourly", "daily", "weekly", "monthly"],
-      "description": "Time aggregation period for metric"
-    },
-
-    "complianceMetric": {
-      "type": "object",
-      "description": "Compliance-related metrics for rule adherence tracking",
-      "additionalProperties": false,
-      "properties": {
-        "compliance_pass_rate": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Percent tasks with zero violations (0.0-1.0)"
-        },
-        "rule_adherence_score": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Required rules satisfied / total rules (0.0-1.0)"
-        },
-        "violation_count": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Total violations per task/agent/session"
-        },
-        "violation_severity": {
-          "$ref": "#/definitions/severityEnum"
-        },
-        "critical_breach_rate": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Percent tasks with >=1 critical violation (0.0-1.0)"
-        },
-        "policy_drift_indicator": {
-          "type": "number",
-          "minimum": -1,
-          "maximum": 1,
-          "description": "Violation increase over time (-1.0 to 1.0, positive = worsening)"
-        },
-        "compliance_latency_ms": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Time to verdict after task completion (milliseconds)"
-        },
-        "manifest_integrity": {
-          "$ref": "#/definitions/manifestIntegrityEnum"
-        }
-      }
-    },
-
-    "efficiencyMetric": {
-      "type": "object",
-      "description": "Efficiency-related metrics for resource utilization tracking",
-      "additionalProperties": false,
-      "properties": {
-        "token_utilization_rate": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 2,
-          "description": "Tokens used / tokens allocated (0.0-2.0, >1 means over budget)"
-        },
-        "context_retention_efficiency": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Relevant tokens / total tokens (0.0-1.0)"
-        },
-        "token_waste_ratio": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Tokens in failed/discarded tasks / total tokens (0.0-1.0)"
-        },
-        "cost_per_successful_task": {
-          "type": "number",
-          "minimum": 0,
-          "description": "Cost / compliant tasks (USD cents)"
-        },
-        "task_completion_time_ms": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Start to return time (milliseconds)"
-        },
-        "agent_turn_count": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "Back-and-forth interactions required"
-        },
-        "retry_rate": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Re-executions due to failure / total executions (0.0-1.0)"
-        },
-        "sub_agent_yield": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Useful outputs / agents invoked (0.0-1.0)"
-        },
-        "orchestration_overhead": {
-          "type": "number",
-          "minimum": 0,
-          "description": "Orchestrator tokens / subagent tokens ratio"
-        }
-      }
-    },
-
-    "sessionMetric": {
-      "type": "object",
-      "description": "Session-related metrics for work session tracking",
-      "additionalProperties": false,
-      "properties": {
-        "session_efficiency_score": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Composite session score (0.0-1.0)"
-        },
-        "human_intervention_rate": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Percent tasks needing correction (0.0-1.0)"
-        },
-        "instruction_stability": {
-          "$ref": "#/definitions/instructionStabilityEnum"
-        },
-        "session_degradation": {
-          "$ref": "#/definitions/sessionDegradationEnum"
-        }
-      }
-    },
-
-    "improvementMetric": {
-      "type": "object",
-      "description": "Self-improvement metrics for agent learning tracking",
-      "additionalProperties": false,
-      "properties": {
-        "improvement_delta": {
-          "type": "number",
-          "minimum": -1,
-          "maximum": 1,
-          "description": "Change vs last N sessions (-1.0 to 1.0)"
-        },
-        "rule_friction_score": {
-          "type": "number",
-          "minimum": 0,
-          "description": "Violations per rule (lower = better)"
-        },
-        "agent_reliability": {
-          "$ref": "#/definitions/agentReliabilityEnum"
-        },
-        "prompt_effectiveness": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Pass rate per prompt version (0.0-1.0)"
-        },
-        "regression_signal": {
-          "type": "boolean",
-          "description": "True if sudden metric drop detected"
-        }
-      }
-    },
-
-    "metricEntry": {
-      "type": "object",
-      "description": "Single metrics JSONL line format",
-      "required": ["timestamp", "category", "source", "source_id"],
-      "additionalProperties": false,
-      "properties": {
-        "timestamp": {
-          "type": "string",
-          "format": "date-time",
-          "description": "ISO 8601 timestamp when metric was recorded"
-        },
-        "category": {
-          "$ref": "#/definitions/metricCategoryEnum"
-        },
-        "source": {
-          "$ref": "#/definitions/metricSourceEnum"
-        },
-        "source_id": {
-          "type": "string",
-          "pattern": "^[A-Za-z0-9_-]+$",
-          "minLength": 1,
-          "maxLength": 64,
-          "description": "ID of source entity (task ID, session ID, agent name)"
-        },
-        "period": {
-          "$ref": "#/definitions/aggregationPeriodEnum"
-        },
-        "compliance": {
-          "$ref": "#/definitions/complianceMetric"
-        },
-        "efficiency": {
-          "$ref": "#/definitions/efficiencyMetric"
-        },
-        "session": {
-          "$ref": "#/definitions/sessionMetric"
-        },
-        "improvement": {
-          "$ref": "#/definitions/improvementMetric"
-        },
-        "project": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 128,
-          "description": "Project name (for global metrics file)"
-        },
-        "tags": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[a-z][a-z0-9-]*$",
-            "minLength": 1,
-            "maxLength": 32
-          },
-          "maxItems": 10,
-          "uniqueItems": true,
-          "description": "Classification tags for filtering"
-        }
-      }
-    },
-
-    "metricsFile": {
-      "type": "object",
-      "description": "Full metrics JSON file format (alternative to JSONL)",
-      "required": ["version", "_meta", "entries"],
-      "additionalProperties": false,
-      "properties": {
-        "version": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version"
-        },
-        "_meta": {
-          "type": "object",
-          "required": ["schemaVersion", "lastModified", "entryCount"],
-          "additionalProperties": false,
-          "properties": {
-            "schemaVersion": {
-              "type": "string",
-              "pattern": "^\\d+\\.\\d+\\.\\d+$"
-            },
-            "lastModified": {
-              "type": "string",
-              "format": "date-time"
-            },
-            "entryCount": {
-              "type": "integer",
-              "minimum": 0
-            },
-            "oldestEntry": {
-              "type": "string",
-              "format": "date-time"
-            },
-            "newestEntry": {
-              "type": "string",
-              "format": "date-time"
-            }
-          }
-        },
-        "entries": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/metricEntry"
-          }
-        }
-      }
-    }
-  },
-
-  "oneOf": [
-    { "$ref": "#/definitions/metricEntry" },
-    { "$ref": "#/definitions/metricsFile" }
-  ]
-}