@cleocode/core 2026.3.45 → 2026.3.47

package/schemas/global-config.schema.json

@@ -0,0 +1,219 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "schemaVersion": "1.0.0",
+  "$id": "https://cleo-dev.com/schemas/v1/global-config.schema.json",
+  "title": "Claude-TODO Global Configuration",
+  "description": "User-level global configuration for cleo CLI. These settings apply across all projects unless overridden by project-specific config.",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+",
+      "description": "Configuration schema version"
+    },
+    "output": {
+      "type": "object",
+      "description": "Output formatting preferences (applies to all commands)",
+      "properties": {
+        "defaultFormat": {
+          "type": "string",
+          "enum": ["text", "json", "jsonl", "csv", "tsv", "markdown", "table"],
+          "default": "text",
+          "description": "Default output format. Set to 'json' for LLM agent automation."
+        },
+        "showColor": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable colored output in terminal. Respects NO_COLOR env var."
+        },
+        "showUnicode": {
+          "type": "boolean",
+          "default": true,
+          "description": "Use Unicode symbols (checkmarks, progress bars, etc.)"
+        },
+        "showProgressBars": {
+          "type": "boolean",
+          "default": true,
+          "description": "Display progress bars for long operations"
+        },
+        "dateFormat": {
+          "type": "string",
+          "enum": ["iso8601", "relative", "unix", "locale"],
+          "default": "iso8601",
+          "description": "Date display format"
+        },
+        "showCompactTitles": {
+          "type": "boolean",
+          "default": false,
+          "description": "Truncate long task titles"
+        },
+        "maxTitleLength": {
+          "type": "integer",
+          "minimum": 20,
+          "maximum": 200,
+          "default": 80,
+          "description": "Maximum title length when compact mode is enabled"
+        }
+      },
+      "additionalProperties": false
+    },
+    "display": {
+      "type": "object",
+      "description": "Display preferences for status and informational output",
+      "properties": {
+        "showArchiveCount": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show count of archived tasks in status"
+        },
+        "showLogSummary": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show recent log summary in status"
+        },
+        "warnStaleDays": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 30,
+          "description": "Warn about tasks older than this many days"
+        }
+      },
+      "additionalProperties": false
+    },
+    "cli": {
+      "type": "object",
+      "description": "CLI behavior and customization",
+      "properties": {
+        "aliases": {
+          "type": "object",
+          "description": "Custom command aliases (alias → command)",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {},
+          "examples": [
+            {"ls": "list", "done": "complete", "new": "add"}
+          ]
+        },
+        "plugins": {
+          "type": "object",
+          "description": "Plugin system configuration",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable plugin discovery and loading"
+            },
+            "directories": {
+              "type": "array",
+              "items": {"type": "string"},
+              "default": ["~/.cleo/plugins", "./.claude/plugins"],
+              "description": "Directories to search for plugins"
+            },
+            "autoDiscover": {
+              "type": "boolean",
+              "default": true,
+              "description": "Auto-discover plugins in plugin directories"
+            }
+          },
+          "additionalProperties": false
+        },
+        "debug": {
+          "type": "object",
+          "description": "Debug and diagnostic settings",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable debug output"
+            },
+            "validateMappings": {
+              "type": "boolean",
+              "default": true,
+              "description": "Validate command mappings on startup"
+            },
+            "checksumVerify": {
+              "type": "boolean",
+              "default": true,
+              "description": "Verify script checksums"
+            },
+            "showTimings": {
+              "type": "boolean",
+              "default": false,
+              "description": "Show execution timing information"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "defaults": {
+      "type": "object",
+      "description": "Default values for new tasks (can be overridden per-project)",
+      "properties": {
+        "priority": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low"],
+          "default": "medium",
+          "description": "Default priority for new tasks"
+        },
+        "labels": {
+          "type": "array",
+          "items": {"type": "string"},
+          "default": [],
+          "description": "Default labels for new tasks"
+        }
+      },
+      "additionalProperties": false
+    },
+    "multiSession": {
+      "type": "object",
+      "description": "Multi-session configuration for concurrent agent work",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable multi-session support"
+        },
+        "maxConcurrentSessions": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 20,
+          "default": 5,
+          "description": "Maximum concurrent sessions allowed"
+        },
+        "maxActiveTasksPerScope": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "default": 1,
+          "description": "Maximum active tasks per session scope"
+        },
+        "scopeValidation": {
+          "type": "string",
+          "enum": ["strict", "warn", "none"],
+          "default": "strict",
+          "description": "Scope validation level"
+        },
+        "allowNestedScopes": {
+          "type": "boolean",
+          "default": true,
+          "description": "Allow nested session scopes"
+        },
+        "allowScopeOverlap": {
+          "type": "boolean",
+          "default": false,
+          "description": "Allow overlapping session scopes"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

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/log.schema.json

@@ -0,0 +1,250 @@
+{
+  "$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"
+            }
+          }
+        }
+      }
+    }
+  }
+}