@cleocode/core 2026.3.45 → 2026.3.46

package/schemas/critical-path.schema.json

@@ -0,0 +1,246 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "schemaVersion": "1.0.0",
+  "$id": "https://cleo-dev.com/schemas/v1/critical-path.schema.json",
+  "title": "Claude-TODO Critical Path Analysis Response",
+  "description": "Schema for critical path analysis output from blockers analyze command",
+  "type": "object",
+  "required": ["_meta", "summary", "criticalPath"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Schema URL for validation"
+    },
+    "_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",
+          "const": "blockers analyze",
+          "description": "Command name that generated this response"
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO-8601 UTC timestamp of response generation"
+        },
+        "execution_ms": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Execution time in milliseconds (optional)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "summary": {
+      "type": "object",
+      "description": "Summary statistics about blocked tasks and analysis",
+      "required": ["blockedCount"],
+      "properties": {
+        "blockedCount": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of blocked tasks"
+        },
+        "maxChainDepth": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Maximum dependency chain depth"
+        },
+        "totalImpactedTasks": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total tasks affected by blockers"
+        },
+        "criticalPathLength": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Length of the critical path"
+        },
+        "bottleneckCount": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of identified bottlenecks"
+        }
+      },
+      "additionalProperties": false
+    },
+    "criticalPath": {
+      "type": "object",
+      "description": "The task at the root of the longest dependency chain",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^T\\d{3}$",
+          "description": "Task ID at critical path root"
+        },
+        "title": {
+          "type": "string",
+          "description": "Title of the critical path task"
+        },
+        "chainDepth": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Depth of the dependency chain"
+        },
+        "impactCount": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of tasks impacted by this task"
+        },
+        "length": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total path length"
+        },
+        "path": {
+          "type": "array",
+          "description": "Ordered list of tasks in the critical path",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^T\\d{3}$"
+              },
+              "title": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string",
+                "enum": ["pending", "active", "blocked", "done"]
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "bottlenecks": {
+      "type": "array",
+      "description": "Tasks blocking multiple other tasks",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^T\\d{3}$",
+            "description": "ID of the bottleneck task"
+          },
+          "title": {
+            "type": "string",
+            "description": "Title of the bottleneck task"
+          },
+          "impactCount": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Number of tasks blocked by this task"
+          },
+          "blockedTasks": {
+            "type": "array",
+            "description": "List of task IDs blocked by this bottleneck",
+            "items": {
+              "type": "string",
+              "pattern": "^T\\d{3}$"
+            }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "recommendations": {
+      "type": "object",
+      "description": "Prioritized action recommendations",
+      "properties": {
+        "highImpact": {
+          "type": "array",
+          "description": "High-impact tasks to prioritize",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^T\\d{3}$"
+              },
+              "title": {
+                "type": "string"
+              },
+              "impactCount": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "reason": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "quickWins": {
+          "type": "array",
+          "description": "Tasks with short dependency chains",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^T\\d{3}$"
+              },
+              "title": {
+                "type": "string"
+              },
+              "chainDepth": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "reason": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "blockedTasks": {
+      "type": "array",
+      "description": "List of all blocked tasks with details",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^T\\d{3}$"
+          },
+          "title": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "blockedBy": {
+            "type": "string"
+          },
+          "chainDepth": {
+            "type": "integer"
+          },
+          "impactCount": {
+            "type": "integer"
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/deps-cache.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1.0/deps-cache.schema.json",
+  "schemaVersion": "1.0.0",
+  "title": "CLEO Dependency Graph Cache Schema",
+  "description": "Pre-computed dependency graph cache for O(1) dependency lookups. Generated from todo.json tasks array.",
+  "type": "object",
+  "required": ["_meta", "forward", "reverse", "hierarchy", "relates"],
+  "additionalProperties": false,
+
+  "properties": {
+    "_meta": {
+      "type": "object",
+      "description": "Cache metadata for staleness detection and diagnostics.",
+      "required": ["schemaVersion", "generatedAt", "sourceChecksum", "taskCount"],
+      "additionalProperties": false,
+      "properties": {
+        "schemaVersion": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Schema version for this cache format."
+        },
+        "generatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp when cache was generated."
+        },
+        "sourceChecksum": {
+          "type": "string",
+          "description": "Checksum from todo.json._meta.checksum at generation time. Used for staleness detection."
+        },
+        "sourceTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "lastModified timestamp from todo.json._meta at generation time."
+        },
+        "taskCount": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of tasks in todo.json when cache was generated."
+        }
+      }
+    },
+
+    "forward": {
+      "type": "object",
+      "description": "Forward dependency map: task_id -> [task_ids this task depends on]. Key is task ID, value is array of dependency task IDs from the 'depends' field.",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "pattern": "^T\\d{3,}$"
+        },
+        "uniqueItems": true
+      }
+    },
+
+    "reverse": {
+      "type": "object",
+      "description": "Reverse dependency map: task_id -> [task_ids that depend on this task]. Inverse of forward map for O(1) 'who depends on me' lookups.",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "pattern": "^T\\d{3,}$"
+        },
+        "uniqueItems": true
+      }
+    },
+
+    "hierarchy": {
+      "type": "object",
+      "description": "Hierarchy map: parent_id -> [child_task_ids]. Built from parentId field for O(1) 'get children' lookups.",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "pattern": "^T\\d{3,}$"
+        },
+        "uniqueItems": true
+      }
+    },
+
+    "relates": {
+      "type": "object",
+      "description": "Relates map: task_id -> [related_task_ids]. Extracted from 'relates' array for O(1) relationship lookups.",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "pattern": "^T\\d{3,}$"
+        },
+        "uniqueItems": true
+      }
+    }
+  }
+}

package/schemas/doctor-output.schema.json

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