@cleocode/core 2026.3.45 → 2026.3.46

package/schemas/agent-registry.json

@@ -0,0 +1,243 @@
+{
+  "schemaVersion": "1.0.0",
+  "lastUpdated": "2026-01-27",
+  "agents": {
+    "claude-code": {
+      "id": "claude-code",
+      "displayName": "Claude Code",
+      "vendor": "Anthropic",
+      "globalDir": "$HOME/.claude",
+      "projectDir": ".claude",
+      "instructionFile": "CLAUDE.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".claude/skills",
+      "priority": "high",
+      "status": "active",
+      "agentSkillsCompatible": true,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.claude"
+      },
+      "notes": "Primary agent - Anthropic's official CLI with full CLEO integration"
+    },
+    "cursor": {
+      "id": "cursor",
+      "displayName": "Cursor",
+      "vendor": "Cursor",
+      "globalDir": "$HOME/.cursor",
+      "projectDir": ".cursor",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".cursor/skills",
+      "priority": "high",
+      "status": "active",
+      "agentSkillsCompatible": true,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.cursor"
+      },
+      "notes": "VS Code fork with AI integration - popular in development workflows"
+    },
+    "windsurf": {
+      "id": "windsurf",
+      "displayName": "Windsurf",
+      "vendor": "Codeium",
+      "globalDir": "$HOME/.codeium/windsurf",
+      "projectDir": ".windsurf",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".windsurf/skills",
+      "priority": "high",
+      "status": "active",
+      "agentSkillsCompatible": true,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.codeium/windsurf"
+      },
+      "notes": "Codeium's agentic IDE with flow state features"
+    },
+    "codex": {
+      "id": "codex",
+      "displayName": "OpenAI Codex",
+      "vendor": "OpenAI",
+      "globalDir": "$HOME/.codex",
+      "projectDir": ".codex",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".codex/skills",
+      "priority": "medium",
+      "status": "active",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.codex"
+      },
+      "notes": "OpenAI's code generation model integration"
+    },
+    "gemini": {
+      "id": "gemini",
+      "displayName": "Google Gemini",
+      "vendor": "Google",
+      "globalDir": "$HOME/.gemini",
+      "projectDir": ".gemini",
+      "instructionFile": "GEMINI.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".gemini/skills",
+      "priority": "medium",
+      "status": "active",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.gemini"
+      },
+      "notes": "Google's multimodal AI model with code capabilities"
+    },
+    "github-copilot": {
+      "id": "github-copilot",
+      "displayName": "GitHub Copilot",
+      "vendor": "GitHub",
+      "globalDir": "$HOME/.copilot",
+      "projectDir": ".github/copilot",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".github/copilot/skills",
+      "priority": "medium",
+      "status": "active",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.copilot"
+      },
+      "notes": "GitHub's AI pair programmer - widely adopted"
+    },
+    "opencode": {
+      "id": "opencode",
+      "displayName": "OpenCode",
+      "vendor": "OpenCode",
+      "globalDir": "$HOME/.config/opencode",
+      "projectDir": ".opencode",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".opencode/skills",
+      "priority": "medium",
+      "status": "active",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.config/opencode"
+      },
+      "notes": "Open-source coding assistant"
+    },
+    "kimi": {
+      "id": "kimi",
+      "displayName": "Kimi Coding",
+      "vendor": "Moonshot AI",
+      "globalDir": "$HOME/.kimi",
+      "projectDir": ".kimi",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".kimi/skills",
+      "priority": "low",
+      "status": "beta",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.kimi"
+      },
+      "notes": "Emerging Chinese AI coding assistant"
+    },
+    "cline": {
+      "id": "cline",
+      "displayName": "Cline",
+      "vendor": "Cline",
+      "globalDir": "$HOME/.cline",
+      "projectDir": ".cline",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".cline/skills",
+      "priority": "low",
+      "status": "beta",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.cline"
+      },
+      "notes": "VS Code extension for autonomous coding agents"
+    },
+    "roo": {
+      "id": "roo",
+      "displayName": "Roo Code",
+      "vendor": "Roo",
+      "globalDir": "$HOME/.roo",
+      "projectDir": ".roo",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".roo/skills",
+      "priority": "low",
+      "status": "beta",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.roo"
+      },
+      "notes": "Experimental agent-based coding tool"
+    },
+    "continue": {
+      "id": "continue",
+      "displayName": "Continue",
+      "vendor": "Continue",
+      "globalDir": "$HOME/.continue",
+      "projectDir": ".continue",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".continue/skills",
+      "priority": "low",
+      "status": "active",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.continue"
+      },
+      "notes": "Open-source autopilot for VS Code and JetBrains"
+    },
+    "antigravity": {
+      "id": "antigravity",
+      "displayName": "Antigravity",
+      "vendor": "Google",
+      "globalDir": "$HOME/.gemini/antigravity",
+      "projectDir": ".gemini/antigravity",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "global_skills",
+      "projectSkillsDir": ".gemini/antigravity/global_skills",
+      "priority": "low",
+      "status": "planned",
+      "agentSkillsCompatible": false,
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.gemini/antigravity"
+      },
+      "notes": "Google's experimental agentic framework for Gemini"
+    }
+  },
+  "instructionFileMap": {
+    "CLAUDE.md": ["claude-code"],
+    "AGENTS.md": [
+      "cursor",
+      "windsurf",
+      "codex",
+      "github-copilot",
+      "opencode",
+      "kimi",
+      "cline",
+      "roo",
+      "continue",
+      "antigravity"
+    ],
+    "GEMINI.md": ["gemini"]
+  },
+  "priorityTiers": {
+    "tier1": ["claude-code", "cursor", "windsurf"],
+    "tier2": ["codex", "gemini", "github-copilot", "opencode"],
+    "tier3": ["kimi", "cline", "roo", "continue", "antigravity"]
+  }
+}

package/schemas/agent-registry.schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://cleo-dev.com/schemas/v1/agent-registry.schema.json",
+  "title": "CLEO Agent Registry Schema",
+  "description": "Unified registry for LLM coding agent configurations, paths, and capabilities",
+  "type": "object",
+  "required": ["schemaVersion", "lastUpdated", "agents"],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Semantic version of this schema"
+    },
+    "lastUpdated": {
+      "type": "string",
+      "format": "date",
+      "description": "Last update date (ISO 8601)"
+    },
+    "agents": {
+      "type": "object",
+      "description": "Map of agent ID to configuration",
+      "additionalProperties": {
+        "$ref": "#/$defs/agentConfig"
+      }
+    },
+    "instructionFileMap": {
+      "type": "object",
+      "description": "Map of instruction file names to list of agents using them",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string" }
+      }
+    },
+    "priorityTiers": {
+      "type": "object",
+      "description": "Agent groupings by priority tier",
+      "properties": {
+        "tier1": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "High priority - primary agents"
+        },
+        "tier2": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Medium priority - secondary agents"
+        },
+        "tier3": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Low priority - emerging agents"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "agentConfig": {
+      "type": "object",
+      "required": ["id", "displayName", "globalDir", "instructionFile", "skillsDir", "priority"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Unique agent identifier (lowercase, hyphenated)"
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Human-readable display name"
+        },
+        "vendor": {
+          "type": "string",
+          "description": "Company/organization behind the agent"
+        },
+        "globalDir": {
+          "type": "string",
+          "description": "Global configuration directory path (use $HOME for home dir)"
+        },
+        "projectDir": {
+          "type": "string",
+          "description": "Project-level configuration directory (relative to project root)"
+        },
+        "instructionFile": {
+          "type": "string",
+          "description": "Instruction/configuration markdown file name"
+        },
+        "skillsDir": {
+          "type": "string",
+          "description": "Skills directory path relative to globalDir"
+        },
+        "projectSkillsDir": {
+          "type": "string",
+          "description": "Project-level skills directory (relative to project root)"
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["high", "medium", "low"],
+          "description": "Agent priority tier for CLEO support"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["active", "beta", "deprecated", "planned"],
+          "default": "active",
+          "description": "Support status"
+        },
+        "cliDetection": {
+          "type": "object",
+          "description": "How to detect if agent CLI is installed",
+          "properties": {
+            "method": {
+              "type": "string",
+              "enum": ["directory", "command", "file"],
+              "description": "Detection method"
+            },
+            "check": {
+              "type": "string",
+              "description": "Path, command, or file to check"
+            }
+          }
+        },
+        "agentSkillsCompatible": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether agent is compatible with vercel-labs/add-skill"
+        },
+        "notes": {
+          "type": "string",
+          "description": "Additional notes about this agent"
+        }
+      }
+    }
+  }
+}

package/schemas/archive/research-manifest.schema.json

@@ -0,0 +1,257 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/research-manifest.schema.json",
+  "title": "Agent Output Manifest Entry",
+  "description": "Schema for MANIFEST.jsonl entries tracking outputs from all agent types (research, implementation, validation, documentation) in the Orchestrator Protocol",
+  "type": "object",
+  "required": [
+    "id",
+    "file",
+    "title",
+    "date",
+    "status",
+    "topics",
+    "key_findings",
+    "actionable"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique identifier slug with date suffix",
+      "pattern": "^[a-z0-9-]+-[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "file": {
+      "type": "string",
+      "description": "Output filename in agent-outputs directory (relative path)",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}_[a-z0-9-]+\\.md$"
+    },
+    "title": {
+      "type": "string",
+      "description": "Human-readable title for the agent output entry",
+      "minLength": 5,
+      "maxLength": 200
+    },
+    "date": {
+      "type": "string",
+      "description": "ISO 8601 date (YYYY-MM-DD)",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "timestamp": {
+      "type": "string",
+      "description": "ISO 8601 datetime for precise ordering",
+      "format": "date-time"
+    },
+    "status": {
+      "type": "string",
+      "description": "Progress status of the agent output",
+      "enum": ["complete", "partial", "blocked", "archived"]
+    },
+    "topics": {
+      "type": "array",
+      "description": "Categorization tags",
+      "items": {"type": "string"},
+      "minItems": 1,
+      "maxItems": 10
+    },
+    "key_findings": {
+      "type": "array",
+      "description": "Executive summary (3-7 single-sentence findings)",
+      "items": {
+        "type": "string",
+        "maxLength": 200
+      },
+      "minItems": 3,
+      "maxItems": 7
+    },
+    "actionable": {
+      "type": "boolean",
+      "description": "Whether this agent output requires follow-up action"
+    },
+    "needs_followup": {
+      "type": "array",
+      "description": "Task IDs or BLOCKED:reason entries for handoff",
+      "items": {
+        "type": "string",
+        "pattern": "^(T[0-9]+|BLOCKED:.+)$"
+      },
+      "default": []
+    },
+    "linked_tasks": {
+      "type": "array",
+      "description": "CLEO task IDs this agent output relates to",
+      "items": {
+        "type": "string",
+        "pattern": "^T[0-9]+$"
+      }
+    },
+    "agent_type": {
+      "type": "string",
+      "description": "Type of agent that created this output entry",
+      "enum": ["research", "implementation", "validation", "documentation", "analysis", "specification"],
+      "default": "research"
+    },
+    "source": {
+      "type": "string",
+      "description": "Origin of the entry (e.g., epic-architect)"
+    },
+    "output_file": {
+      "type": "string",
+      "description": "Relative path to output file in agent-outputs directory (alternative to file field)"
+    },
+    "files_modified": {
+      "type": "array",
+      "description": "Files modified by implementation agents (relative paths from project root)",
+      "items": {
+        "type": "string"
+      }
+    },
+    "tests_run": {
+      "type": "array",
+      "description": "Test results from validation agents",
+      "items": {
+        "type": "object",
+        "properties": {
+          "test": {
+            "type": "string",
+            "description": "Test name or file path"
+          },
+          "result": {
+            "type": "string",
+            "enum": ["pass", "fail", "skip", "error"]
+          },
+          "details": {
+            "type": "string",
+            "description": "Optional failure details or notes"
+          }
+        },
+        "required": ["test", "result"]
+      }
+    },
+    "documentation_artifacts": {
+      "type": "array",
+      "description": "Documentation files created or updated by documentation agents",
+      "items": {
+        "type": "string"
+      }
+    },
+    "parentId": {
+      "type": ["string", "null"],
+      "description": "Parent manifest entry ID for hierarchy (null for root entries)",
+      "default": null
+    },
+    "epicId": {
+      "type": ["string", "null"],
+      "description": "Root epic task ID this entry belongs to",
+      "pattern": "^T\\d+$",
+      "default": null
+    },
+    "path": {
+      "type": "string",
+      "description": "Slash-delimited ancestry path from root epic (e.g., 'T2968/T2973/T2997')",
+      "default": ""
+    },
+    "depth": {
+      "type": "integer",
+      "description": "Nesting depth (0=root, 1=child, 2=grandchild)",
+      "minimum": 0,
+      "maximum": 10,
+      "default": 0
+    },
+    "childCount": {
+      "type": "integer",
+      "description": "Number of direct child entries",
+      "minimum": 0,
+      "default": 0
+    },
+    "audit": {
+      "type": "object",
+      "description": "Provenance and lifecycle tracking (v2.10.0+ - optional for backward compatibility)",
+      "properties": {
+        "created_by": {
+          "type": "string",
+          "description": "Agent ID that created this output (format: {role}-agent-{taskId})",
+          "pattern": "^[a-z]+-agent-T[0-9]+$"
+        },
+        "created_at": {
+          "type": "string",
+          "description": "ISO 8601 datetime when output was created",
+          "format": "date-time"
+        },
+        "validated_by": {
+          "type": ["string", "null"],
+          "description": "Agent ID that validated this output (MUST differ from created_by)",
+          "pattern": "^[a-z]+-agent-T[0-9]+$"
+        },
+        "validated_at": {
+          "type": ["string", "null"],
+          "description": "ISO 8601 datetime when output was validated",
+          "format": "date-time"
+        },
+        "validation_status": {
+          "type": "string",
+          "description": "Validation workflow state",
+          "enum": ["pending", "in_review", "approved", "rejected", "needs_revision"],
+          "default": "pending"
+        },
+        "tested_by": {
+          "type": ["string", "null"],
+          "description": "Agent ID that tested this output (MUST differ from created_by and validated_by)",
+          "pattern": "^[a-z]+-agent-T[0-9]+$"
+        },
+        "tested_at": {
+          "type": ["string", "null"],
+          "description": "ISO 8601 datetime when output was tested",
+          "format": "date-time"
+        },
+        "lifecycle_state": {
+          "type": "string",
+          "description": "RCSD→IVTR pipeline stage",
+          "enum": ["research", "consensus", "specification", "decomposition", "implementation", "validation", "testing", "release"]
+        },
+        "provenance_chain": {
+          "type": "array",
+          "description": "Full lineage from research to release (array of task/manifest IDs or objects)",
+          "items": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "Simple ID reference",
+                "pattern": "^(T[0-9]+|[a-z0-9-]+)$"
+              },
+              {
+                "type": "object",
+                "description": "Detailed chain entry",
+                "required": ["type", "id"],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": ["task", "research", "consensus", "specification", "decomposition", "implementation", "validation", "testing", "release"]
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                }
+              }
+            ]
+          },
+          "default": []
+        },
+        "validates_task": {
+          "type": "string",
+          "description": "Task ID this output validates (for consensus/validation agents)",
+          "pattern": "^T[0-9]+$"
+        },
+        "validation_result": {
+          "type": "string",
+          "description": "Result of validation (approved/rejected/needs_revision)",
+          "enum": ["approved", "rejected", "needs_revision"]
+        }
+      },
+      "required": ["created_by", "created_at", "lifecycle_state"]
+    }
+  },
+  "additionalProperties": true
+}