@cleocode/cleo 2026.2.8 → 2026.3.0

package/schemas/archive/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" }
-  ]
-}

package/schemas/archive/migrations.schema.json

@@ -1,150 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://cleo-dev.com/schemas/v1/migrations.schema.json",
-  "schemaVersion": "1.0.0",
-  "title": "CLEO Migration Journal Schema",
-  "description": "Audit trail of schema migration operations. Tracks applied migrations with checksums and execution metadata for data integrity verification.",
-  "type": "object",
-  "required": [
-    "_meta",
-    "appliedMigrations"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "_meta": {
-      "type": "object",
-      "required": [
-        "schemaVersion"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "schemaVersion": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version for this migrations journal (semver)."
-        },
-        "lastChecked": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "format": "date-time",
-          "description": "Last time migration status was checked."
-        }
-      }
-    },
-    "appliedMigrations": {
-      "type": "array",
-      "description": "Chronologically ordered list of applied migrations. Append-only for audit trail.",
-      "items": {
-        "$ref": "#/definitions/migrationEntry"
-      }
-    }
-  },
-  "definitions": {
-    "migrationEntry": {
-      "type": "object",
-      "required": [
-        "version",
-        "fileType",
-        "checksum",
-        "appliedAt",
-        "status"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "version": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Target schema version of this migration (semver)."
-        },
-        "fileType": {
-          "type": "string",
-          "enum": [
-            "todo",
-            "config",
-            "archive",
-            "log",
-            "sessions",
-            "migrations"
-          ],
-          "description": "Type of file that was migrated."
-        },
-        "functionName": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "Migration function name that was executed (e.g., 'migrate_todo_to_2_3_0'). Null for version-bump-only migrations."
-        },
-        "checksum": {
-          "type": "string",
-          "pattern": "^[a-f0-9]{64}$",
-          "description": "SHA256 checksum of the migration function source code (for verification)."
-        },
-        "appliedAt": {
-          "type": "string",
-          "format": "date-time",
-          "description": "When this migration was executed (UTC)."
-        },
-        "status": {
-          "type": "string",
-          "enum": [
-            "success",
-            "failed",
-            "skipped"
-          ],
-          "description": "Outcome of the migration operation."
-        },
-        "executionTimeMs": {
-          "type": [
-            "integer",
-            "null"
-          ],
-          "minimum": 0,
-          "description": "Time taken to execute migration in milliseconds."
-        },
-        "previousVersion": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version before this migration was applied."
-        },
-        "logs": {
-          "type": "array",
-          "description": "Log messages generated during migration execution.",
-          "items": {
-            "type": "string"
-          }
-        },
-        "backupPath": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "Path to backup created before migration (for rollback)."
-        },
-        "error": {
-          "type": [
-            "object",
-            "null"
-          ],
-          "description": "Error details if migration failed.",
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "recoverable": {
-              "type": "boolean"
-            }
-          }
-        }
-      }
-    }
-  }
-}

package/schemas/archive/nexus-registry.schema.json

@@ -1,90 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://cleo-dev.com/schemas/v1/nexus-registry.schema.json",
-  "title": "CLEO Nexus Registry Schema (DEPRECATED)",
-  "description": "DEPRECATED: This schema is superseded by projects-registry.schema.json (v2.0.0). The unified registry at ~/.cleo/projects-registry.json now serves both global project management and Nexus cross-project coordination. This file is retained for reference only.",
-  "type": "object",
-  "required": ["version", "lastUpdated", "projects"],
-  "additionalProperties": false,
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "JSON Schema reference for validation."
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Schema version (semver). MUST match semantic versioning."
-    },
-    "lastUpdated": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp of last registry modification."
-    },
-    "projects": {
-      "type": "object",
-      "description": "Map of project_hash → project metadata. Keyed by 12-character hexadecimal hash.",
-      "patternProperties": {
-        "^[a-f0-9]{12}$": {
-          "$ref": "#/definitions/project"
-        }
-      },
-      "additionalProperties": false
-    }
-  },
-  "definitions": {
-    "project": {
-      "type": "object",
-      "description": "A registered CLEO project with metadata and access timestamps.",
-      "required": ["hash", "path", "name", "lastAccess"],
-      "additionalProperties": false,
-      "properties": {
-        "hash": {
-          "type": "string",
-          "pattern": "^[a-f0-9]{12}$",
-          "description": "12-character hexadecimal identifier. MUST match object key. Generated via generate_project_hash() (stable SHA256 of path)."
-        },
-        "path": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Absolute filesystem path to project root. MUST contain .cleo/todo.json to be valid."
-        },
-        "name": {
-          "type": "string",
-          "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$",
-          "minLength": 1,
-          "maxLength": 64,
-          "description": "Human-readable project identifier. MUST be unique across all registered projects. Lowercase with hyphens allowed."
-        },
-        "aliases": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$",
-            "minLength": 1,
-            "maxLength": 32
-          },
-          "uniqueItems": true,
-          "default": [],
-          "description": "Alternative names for project resolution. MUST NOT conflict with any project names."
-        },
-        "lastAccess": {
-          "type": "string",
-          "format": "date-time",
-          "description": "ISO 8601 timestamp of last read operation. Used for pruning inactive projects."
-        },
-        "taskCount": {
-          "type": "integer",
-          "minimum": 0,
-          "default": 0,
-          "description": "Number of tasks in project. Cached for quick reference."
-        },
-        "checksum": {
-          "type": "string",
-          "pattern": "^[a-f0-9]{16}$",
-          "description": "SHA-256 truncated hash of project's todo.json tasks array. Used for cache invalidation."
-        }
-      }
-    }
-  }
-}