@cleocode/core 2026.4.5 → 2026.4.7

package/schemas/doctor-output.schema.json

@@ -1,283 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://cleo-dev.com/schemas/v1/doctor-output.schema.json",
-  "schemaVersion": "1.0.0",
-  "title": "CLEO Doctor Output Schema",
-  "description": "JSON output structure for `cleo doctor` diagnostic command. Defines health check results, severity levels, and actionable fixes for global CLEO installation, agent configurations, and registered projects. Exit code mapping: 0 (ok), 50 (warning), 52 (failed/critical), 100 (special/no_config).",
-  "type": "object",
-  "required": ["_meta", "success", "severity", "checks", "summary", "projects"],
-  "additionalProperties": false,
-
-  "properties": {
-    "_meta": {
-      "type": "object",
-      "description": "Standard envelope metadata for command output.",
-      "required": ["format", "command", "timestamp", "version"],
-      "additionalProperties": false,
-      "properties": {
-        "format": {
-          "type": "string",
-          "const": "cleo-doctor-output",
-          "description": "Output format identifier for parsing."
-        },
-        "command": {
-          "type": "string",
-          "const": "doctor",
-          "description": "Command that generated this output."
-        },
-        "timestamp": {
-          "type": "string",
-          "format": "date-time",
-          "description": "ISO 8601 timestamp when diagnostic was run."
-        },
-        "version": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "CLEO CLI version that ran the diagnostic."
-        },
-        "schemaVersion": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "default": "1.0.0",
-          "description": "Schema version for this output format."
-        }
-      }
-    },
-
-    "success": {
-      "type": "boolean",
-      "description": "Overall success status. True only if ALL checks passed without warnings or failures."
-    },
-
-    "severity": {
-      "type": "string",
-      "enum": ["ok", "warning", "failed"],
-      "description": "Overall severity level. ok=all passed (exit 0), warning=minor issues (exit 50), failed=critical problems requiring action (exit 52)."
-    },
-
-    "checks": {
-      "type": "array",
-      "description": "Array of individual health check results.",
-      "items": {
-        "$ref": "#/definitions/check"
-      }
-    },
-
-    "summary": {
-      "type": "object",
-      "description": "Summary statistics across all checks.",
-      "required": ["totalChecks", "passed", "warnings", "failed", "severity"],
-      "additionalProperties": false,
-      "properties": {
-        "totalChecks": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Total number of checks performed."
-        },
-        "passed": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of checks that passed without issues."
-        },
-        "warnings": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of checks with warnings (non-critical)."
-        },
-        "failed": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of checks that failed."
-        },
-        "severity": {
-          "type": "string",
-          "enum": ["ok", "warning", "failed"],
-          "description": "Overall severity across all checks. ok=all passed, warning=minor issues, failed=critical problems."
-        }
-      }
-    },
-
-    "projects": {
-      "type": "object",
-      "description": "Project registry validation results. Summary of all registered CLEO projects and their health status.",
-      "required": ["total", "healthy", "warnings", "failed", "orphaned", "projects"],
-      "additionalProperties": false,
-      "properties": {
-        "total": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Total number of registered projects."
-        },
-        "healthy": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of projects with no issues."
-        },
-        "warnings": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of projects with warnings (non-critical issues)."
-        },
-        "failed": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of projects with critical issues."
-        },
-        "orphaned": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of projects in registry with missing paths."
-        },
-        "projects": {
-          "type": "array",
-          "description": "Array of individual project health results.",
-          "items": {
-            "$ref": "#/definitions/projectHealth"
-          }
-        }
-      }
-    }
-  },
-
-  "definitions": {
-    "check": {
-      "type": "object",
-      "description": "Individual health check result with diagnostic data and actionable fixes.",
-      "required": ["id", "category", "status", "message"],
-      "additionalProperties": false,
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$",
-          "description": "Unique check identifier (snake_case, e.g., 'cli_installation', 'agent_config_exists')."
-        },
-        "category": {
-          "type": "string",
-          "enum": ["installation", "configuration", "registry", "projects"],
-          "description": "Check category for grouping related diagnostics. installation=CLI setup, configuration=agent configs, registry=project registry, projects=per-project checks."
-        },
-        "status": {
-          "type": "string",
-          "enum": ["passed", "warning", "failed"],
-          "description": "Check result status. passed=no issues, warning=non-critical, failed=requires action."
-        },
-        "message": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 500,
-          "description": "Human-readable description of check result."
-        },
-        "details": {
-          "type": "object",
-          "description": "Structured diagnostic data specific to this check. Schema varies by check ID.",
-          "additionalProperties": true
-        },
-        "fix": {
-          "type": ["string", "null"],
-          "maxLength": 500,
-          "description": "Copy-paste command to resolve issue. Null if check passed or no automated fix available."
-        }
-      }
-    },
-
-    "projectHealth": {
-      "type": "object",
-      "description": "Individual project health check result. Tracks project path, status, schema versions, injection status, and issues.",
-      "required": ["hash", "path", "name", "status"],
-      "additionalProperties": false,
-      "properties": {
-        "hash": {
-          "type": "string",
-          "pattern": "^[a-f0-9]{8}$",
-          "description": "Project hash identifier (first 8 chars of path hash)."
-        },
-        "path": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Absolute path to project directory."
-        },
-        "name": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Project name from todo.json or directory name."
-        },
-        "status": {
-          "type": "string",
-          "enum": ["healthy", "warning", "failed", "orphaned"],
-          "description": "Project health status. healthy=no issues, warning=minor issues, failed=critical problems, orphaned=path missing."
-        },
-        "schemas": {
-          "type": ["object", "null"],
-          "description": "Schema version information for project files.",
-          "additionalProperties": false,
-          "properties": {
-            "todo": {
-              "type": ["string", "null"],
-              "pattern": "^\\d+\\.\\d+\\.\\d+$",
-              "description": "todo.json schema version."
-            },
-            "config": {
-              "type": ["string", "null"],
-              "pattern": "^\\d+\\.\\d+\\.\\d+$",
-              "description": "config.json schema version."
-            },
-            "archive": {
-              "type": ["string", "null"],
-              "pattern": "^\\d+\\.\\d+\\.\\d+$",
-              "description": "archive.json schema version."
-            },
-            "log": {
-              "type": ["string", "null"],
-              "pattern": "^\\d+\\.\\d+\\.\\d+$",
-              "description": "log.json schema version."
-            }
-          }
-        },
-        "injection": {
-          "type": ["object", "null"],
-          "description": "Agent file injection status for this project.",
-          "additionalProperties": false,
-          "properties": {
-            "status": {
-              "type": "string",
-              "enum": ["current", "outdated", "missing"],
-              "description": "Injection status. current=up-to-date, outdated=old version, missing=not injected."
-            },
-            "version": {
-              "type": ["string", "null"],
-              "pattern": "^\\d+\\.\\d+\\.\\d+$",
-              "description": "Version of injected content in agent files."
-            }
-          }
-        },
-        "issues": {
-          "type": "array",
-          "description": "Array of issues found in this project.",
-          "items": {
-            "type": "object",
-            "required": ["severity", "message"],
-            "additionalProperties": false,
-            "properties": {
-              "severity": {
-                "type": "string",
-                "enum": ["warning", "error"],
-                "description": "Issue severity level."
-              },
-              "message": {
-                "type": "string",
-                "minLength": 1,
-                "maxLength": 500,
-                "description": "Human-readable issue description."
-              },
-              "fix": {
-                "type": ["string", "null"],
-                "maxLength": 200,
-                "description": "Suggested fix command. Null if no automated fix available."
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}

package/schemas/error.schema.json

@@ -1,161 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "schemaVersion": "1.0.0",
-  "$id": "https://cleo-dev.com/schemas/v1/error.schema.json",
-  "title": "CLEO Error Envelope",
-  "description": "Standard JSON envelope for all cleo error responses",
-  "type": "object",
-  "required": ["_meta", "success", "error"],
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "Schema URL for validation",
-      "const": "https://cleo-dev.com/schemas/v1/error.schema.json"
-    },
-    "_meta": {
-      "type": "object",
-      "description": "Response metadata",
-      "required": ["command", "timestamp", "version"],
-      "properties": {
-        "format": {
-          "type": "string",
-          "const": "json",
-          "description": "Output format identifier"
-        },
-        "version": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+",
-          "description": "cleo version (semver)"
-        },
-        "command": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Command name that generated this error"
-        },
-        "timestamp": {
-          "type": "string",
-          "format": "date-time",
-          "description": "ISO-8601 UTC timestamp of error generation"
-        }
-      },
-      "additionalProperties": false
-    },
-    "success": {
-      "type": "boolean",
-      "const": false,
-      "description": "Always false for error responses"
-    },
-    "error": {
-      "type": "object",
-      "description": "Error details",
-      "required": ["code", "message", "exitCode"],
-      "properties": {
-        "code": {
-          "type": "string",
-          "pattern": "^E_[A-Z_]+$",
-          "description": "Error code (E_ prefix convention)",
-          "enum": [
-            "E_TASK_NOT_FOUND",
-            "E_TASK_ALREADY_EXISTS",
-            "E_TASK_INVALID_ID",
-            "E_TASK_INVALID_STATUS",
-            "E_FILE_NOT_FOUND",
-            "E_FILE_READ_ERROR",
-            "E_FILE_WRITE_ERROR",
-            "E_FILE_PERMISSION",
-            "E_VALIDATION_SCHEMA",
-            "E_VALIDATION_CHECKSUM",
-            "E_VALIDATION_REQUIRED",
-            "E_INPUT_MISSING",
-            "E_INPUT_INVALID",
-            "E_INPUT_FORMAT",
-            "E_DEPENDENCY_MISSING",
-            "E_DEPENDENCY_VERSION",
-            "E_PHASE_NOT_FOUND",
-            "E_PHASE_INVALID",
-            "E_SESSION_ACTIVE",
-            "E_SESSION_NOT_ACTIVE",
-            "E_UNKNOWN",
-            "E_NOT_INITIALIZED",
-            "E_PARENT_NOT_FOUND",
-            "E_DEPTH_EXCEEDED",
-            "E_SIBLING_LIMIT",
-            "E_INVALID_PARENT_TYPE",
-            "E_CIRCULAR_REFERENCE",
-            "E_ORPHAN_DETECTED",
-            "E_HAS_CHILDREN",
-            "E_TASK_COMPLETED",
-            "E_CASCADE_FAILED",
-            "E_CANCEL_REASON_REQUIRED",
-            "E_CHECKSUM_MISMATCH",
-            "E_CONCURRENT_MODIFICATION",
-            "E_ID_COLLISION",
-            "E_SESSION_EXISTS",
-            "E_SESSION_NOT_FOUND",
-            "E_SCOPE_CONFLICT",
-            "E_SCOPE_INVALID",
-            "E_TASK_NOT_IN_SCOPE",
-            "E_TASK_CLAIMED",
-            "E_SESSION_REQUIRED",
-            "E_SESSION_CLOSE_BLOCKED",
-            "E_FOCUS_REQUIRED",
-            "E_NOTES_REQUIRED",
-            "E_SESSION_DISCOVERY_MODE",
-            "E_SESSION_RESUME_ACTIVE",
-            "E_ALREADY_INITIALIZED",
-            "E_CONFIRMATION_REQUIRED",
-            "E_HAS_DEPENDENTS"
-          ]
-        },
-        "message": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Human-readable error message"
-        },
-        "exitCode": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 127,
-          "description": "Shell exit code for this error"
-        },
-        "recoverable": {
-          "type": "boolean",
-          "description": "Whether the error can be recovered from"
-        },
-        "suggestion": {
-          "type": ["string", "null"],
-          "description": "Suggested action to resolve the error"
-        },
-        "fix": {
-          "type": ["string", "null"],
-          "description": "Concrete command to fix the error (copy-paste ready)"
-        },
-        "alternatives": {
-          "type": "array",
-          "description": "Alternative recovery actions with executable commands",
-          "items": {
-            "type": "object",
-            "required": ["action", "command"],
-            "properties": {
-              "action": {
-                "type": "string",
-                "description": "Short description of what this alternative does"
-              },
-              "command": {
-                "type": "string",
-                "description": "Executable command (copy-paste ready)"
-              }
-            }
-          }
-        },
-        "context": {
-          "type": "object",
-          "description": "Additional error context (varies by error type)",
-          "additionalProperties": true
-        }
-      },
-      "additionalProperties": false
-    }
-  },
-  "additionalProperties": false
-}

package/schemas/global-config.schema.json

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