@cleocode/core 2026.3.45 → 2026.3.46

package/schemas/project-context.schema.json

@@ -0,0 +1,164 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/project-context.schema.json",
+  "schemaVersion": "1.0.0",
+  "title": "CLEO Project Context Schema",
+  "description": "LLM agent metadata structure for project discovery. Generated by cleo init --detect, consumed via @ reference injection. Distinct from config.json (executable config) - this provides discovery metadata and LLM guidance.",
+  "type": "object",
+  "required": ["schemaVersion", "detectedAt", "projectTypes"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference URI"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Project context schema version (semver)"
+    },
+    "detectedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of detection"
+    },
+    "projectTypes": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["node", "python", "rust", "go", "ruby", "elixir", "java", "php", "deno", "bun", "dotnet", "bash", "unknown"]
+      },
+      "minItems": 1,
+      "description": "All detected project types"
+    },
+    "primaryType": {
+      "type": "string",
+      "enum": ["node", "python", "rust", "go", "ruby", "elixir", "java", "php", "deno", "bun", "dotnet", "bash", "unknown"],
+      "description": "Primary project type"
+    },
+    "monorepo": {
+      "type": "boolean",
+      "default": false,
+      "description": "Whether project is a monorepo"
+    },
+    "testing": {
+      "type": "object",
+      "description": "Testing configuration summary.",
+      "additionalProperties": false,
+      "properties": {
+        "framework": {
+          "type": "string",
+          "enum": ["bats", "jest", "vitest", "playwright", "cypress", "mocha", "ava", "uvu", "tap", "node:test", "deno", "bun", "pytest", "go", "cargo", "rspec", "junit", "custom"],
+          "description": "Detected testing framework"
+        },
+        "command": {
+          "type": "string",
+          "description": "Test execution command"
+        },
+        "testFilePatterns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Glob patterns for test files"
+        },
+        "directories": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "unit": {
+              "type": "string"
+            },
+            "integration": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "build": {
+      "type": "object",
+      "description": "Build configuration summary.",
+      "additionalProperties": false,
+      "properties": {
+        "command": {
+          "type": "string",
+          "description": "Build command"
+        },
+        "outputDir": {
+          "type": "string",
+          "description": "Build output directory"
+        }
+      }
+    },
+    "directories": {
+      "type": "object",
+      "description": "Directory structure summary.",
+      "additionalProperties": false,
+      "properties": {
+        "source": {
+          "type": "string",
+          "description": "Source code directory"
+        },
+        "tests": {
+          "type": "string",
+          "description": "Test directory"
+        },
+        "docs": {
+          "type": "string",
+          "description": "Documentation directory"
+        }
+      }
+    },
+    "conventions": {
+      "type": "object",
+      "description": "Coding conventions.",
+      "additionalProperties": false,
+      "properties": {
+        "fileNaming": {
+          "type": "string",
+          "enum": ["kebab-case", "snake_case", "camelCase", "PascalCase"],
+          "description": "File naming convention"
+        },
+        "importStyle": {
+          "type": "string",
+          "enum": ["esm", "commonjs", "mixed"],
+          "description": "Module import style"
+        },
+        "typeSystem": {
+          "type": "string",
+          "description": "Type system (typescript, python-hints, rust, etc.)"
+        }
+      }
+    },
+    "llmHints": {
+      "type": "object",
+      "description": "LLM agent guidance for code generation and understanding.",
+      "additionalProperties": false,
+      "properties": {
+        "preferredTestStyle": {
+          "type": "string",
+          "description": "Framework-specific test style guidance"
+        },
+        "typeSystem": {
+          "type": "string",
+          "description": "Type system details (e.g., 'TypeScript strict mode')"
+        },
+        "commonPatterns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Framework-specific best practices"
+        },
+        "avoidPatterns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Deprecated APIs, incompatible syntax, style violations to avoid"
+        }
+      }
+    }
+  }
+}

package/schemas/project-info.schema.json

@@ -0,0 +1,180 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/project-info.schema.json",
+  "schemaVersion": "1.0.0",
+  "title": "CLEO Project Info Schema",
+  "description": "Per-project metadata file (.cleo/project-info.json) containing schema versions, injection status, and health diagnostics. Part of the hybrid registry architecture where global registry tracks project locations and this file stores project-specific details.",
+  "type": "object",
+  "required": ["schemaVersion", "projectHash", "schemas"],
+  "additionalProperties": false,
+
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference for validation."
+    },
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Schema version for this file (semver)."
+    },
+    "projectHash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{12}$",
+      "description": "Unique 12-character hex hash derived from absolute project path (SHA-256 prefix). Links to global registry entry."
+    },
+    "cleoVersion": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "CLEO version that last modified this file (semver)."
+    },
+    "lastUpdated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last modification to this file."
+    },
+    "schemas": {
+      "type": "object",
+      "description": "Schema versions for core CLEO data files in this project.",
+      "required": ["config"],
+      "additionalProperties": false,
+      "properties": {
+        "config": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Schema version for config.json (semver)."
+        },
+        "sqlite": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Schema version for tasks.db SQLite store (semver)."
+        },
+        "projectContext": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Schema version for project-context.json (semver)."
+        },
+        "todo": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Deprecated: JSON todo.json schema version. Kept for backward compatibility."
+        },
+        "archive": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Deprecated: JSON archive schema version. Kept for backward compatibility."
+        },
+        "log": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Deprecated: JSON log schema version. Kept for backward compatibility."
+        }
+      }
+    },
+    "injection": {
+      "type": "object",
+      "description": "Injection versions for LLM agent documentation files. Null if file does not exist or injection not applied.",
+      "additionalProperties": false,
+      "properties": {
+        "CLAUDE.md": {
+          "type": ["string", "null"],
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Injection version in CLAUDE.md (semver) or null if not injected."
+        },
+        "AGENTS.md": {
+          "type": ["string", "null"],
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Injection version in AGENTS.md (semver) or null if not injected."
+        },
+        "GEMINI.md": {
+          "type": ["string", "null"],
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Injection version in GEMINI.md (semver) or null if not injected."
+        }
+      }
+    },
+    "health": {
+      "type": "object",
+      "description": "Project health status from last doctor check. Optional - may not exist until first health check.",
+      "required": ["status"],
+      "additionalProperties": false,
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["healthy", "warning", "error", "unknown"],
+          "description": "Overall project health: healthy=no issues, warning=minor issues, error=critical issues, unknown=not yet checked."
+        },
+        "lastCheck": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "description": "ISO 8601 timestamp of last health check (doctor command). Null if never checked."
+        },
+        "issues": {
+          "type": "array",
+          "description": "Array of health check issues. Empty if status='healthy'.",
+          "items": {
+            "$ref": "#/definitions/healthIssue"
+          }
+        }
+      }
+    },
+    "features": {
+      "type": "object",
+      "description": "Optional CLEO features enabled for this project.",
+      "additionalProperties": false,
+      "properties": {
+        "multiSession": {
+          "type": "boolean",
+          "description": "Multi-agent concurrent session support.",
+          "default": false
+        },
+        "verification": {
+          "type": "boolean",
+          "description": "Verification gates for task quality.",
+          "default": false
+        },
+        "contextAlerts": {
+          "type": "boolean",
+          "description": "Context window threshold alerts.",
+          "default": false
+        }
+      }
+    }
+  },
+
+  "definitions": {
+    "healthIssue": {
+      "type": "object",
+      "description": "Individual health check issue.",
+      "required": ["severity", "code", "message"],
+      "additionalProperties": false,
+      "properties": {
+        "severity": {
+          "type": "string",
+          "enum": ["warning", "error"],
+          "description": "Issue severity: warning=non-blocking, error=critical/blocking."
+        },
+        "code": {
+          "type": "string",
+          "pattern": "^[A-Z_]+$",
+          "description": "Machine-readable issue code (e.g., 'SCHEMA_OUTDATED', 'INJECTION_MISSING')."
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "Human-readable issue description."
+        },
+        "file": {
+          "type": "string",
+          "description": "File path related to the issue (relative to project root)."
+        },
+        "fix": {
+          "type": "string",
+          "maxLength": 200,
+          "description": "Suggested command or action to resolve the issue."
+        }
+      }
+    }
+  }
+}

package/schemas/projects-registry.schema.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/projects-registry.schema.json",
+  "schemaVersion": "2.0.0",
+  "title": "CLEO Projects Registry Schema",
+  "description": "Unified global registry tracking all CLEO-initialized projects. Single source of truth for both project management and Nexus cross-project coordination.",
+  "type": "object",
+  "required": ["schemaVersion", "lastUpdated", "projects"],
+  "additionalProperties": false,
+
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference for validation."
+    },
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Schema version for this file (semver)."
+    },
+    "lastUpdated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last registry modification."
+    },
+    "projects": {
+      "type": "object",
+      "description": "Hash-keyed project entries. Hash is 12-char hex SHA-256 prefix of absolute project path.",
+      "patternProperties": {
+        "^[a-f0-9]{12}$": {
+          "$ref": "#/definitions/projectEntry"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+
+  "definitions": {
+    "projectEntry": {
+      "type": "object",
+      "description": "Individual project registration record with metadata and optional Nexus fields.",
+      "required": ["hash", "path", "name", "registeredAt", "lastSeen"],
+      "additionalProperties": false,
+      "properties": {
+        "hash": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{12}$",
+          "description": "Unique 12-character hex hash derived from absolute project path (SHA-256 prefix). MUST match parent key."
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Absolute file system path to project root. MUST be unique across all projects."
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "description": "Human-readable project name (typically basename of path)."
+        },
+        "registeredAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp when project was first registered (cleo init)."
+        },
+        "lastSeen": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp of last CLEO operation in this project."
+        },
+        "healthStatus": {
+          "type": "string",
+          "enum": ["healthy", "warning", "error", "unknown"],
+          "description": "Overall project health status. Defaults to 'unknown' if not yet checked."
+        },
+        "healthLastCheck": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "description": "ISO 8601 timestamp of last health check. Null if never checked."
+        },
+        "permissions": {
+          "type": "string",
+          "enum": ["read", "write", "execute"],
+          "description": "Nexus cross-project permission level. Defaults to 'read'."
+        },
+        "taskCount": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of tasks in project. Cached for quick reference."
+        },
+        "labels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true,
+          "description": "Unique labels across all tasks in the project."
+        },
+        "lastSync": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "description": "ISO 8601 timestamp of last Nexus sync. Null if never synced."
+        }
+      }
+    }
+  }
+}

package/schemas/protocol-frontmatter.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo.dev/schemas/protocol-frontmatter.schema.json",
+  "title": "Protocol Frontmatter Schema",
+  "description": "JSON Schema for CLEO protocol YAML frontmatter blocks",
+  "_meta": {
+    "schemaVersion": "1.0.0"
+  },
+  "type": "object",
+  "required": ["id", "title", "version", "status"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "enum": ["RSCH", "CONS", "SPEC", "DCMP", "IMPL", "CONT", "VALID", "TEST", "REL", "ADR", "ART", "PROV", "AGENT"],
+      "description": "Short protocol code"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Full protocol title"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semver version"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["active", "draft", "deprecated", "experimental"]
+    },
+    "type": {
+      "type": "string",
+      "enum": ["base", "conditional", "cross-cutting"]
+    },
+    "audience": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "skillRef": {
+      "type": "string",
+      "description": "ct-skills skill that executes this pipeline"
+    },
+    "mcpOperations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "lastUpdated": {
+      "type": "string",
+      "description": "ISO date string"
+    },
+    "provenanceTask": {
+      "type": "string",
+      "pattern": "^T\\d+$",
+      "description": "CLEO task ID that originated this protocol"
+    },
+    "enforcement": {
+      "type": "string",
+      "enum": ["strict", "advisory", "disabled"]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/rcasd-consensus-report.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-consensus-report.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-consensus-report.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-consensus-report schema."
+}

package/schemas/rcasd-evidence.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "schemaVersion": "1.0.0",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-evidence.schema.json",
+  "title": "RCASD Evidence",
+  "description": "Schema for lifecycle stage evidence records. Evidence links artifacts (files, URLs, manifests) to specific pipeline stages for provenance tracking.",
+  "type": "object",
+  "required": ["id", "stageId", "uri", "type", "recordedAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique evidence identifier"
+    },
+    "stageId": {
+      "type": "string",
+      "description": "Reference to the lifecycle stage this evidence supports"
+    },
+    "uri": {
+      "type": "string",
+      "description": "URI pointing to the evidence artifact"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["file", "url", "manifest"],
+      "description": "Type of evidence artifact"
+    },
+    "recordedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the evidence was recorded"
+    },
+    "recordedBy": {
+      "type": ["string", "null"],
+      "description": "Agent or user who recorded the evidence"
+    },
+    "description": {
+      "type": ["string", "null"],
+      "description": "Description of what this evidence demonstrates"
+    }
+  }
+}

package/schemas/rcasd-gate-result.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "schemaVersion": "1.0.0",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-gate-result.schema.json",
+  "title": "RCASD Gate Result",
+  "description": "Schema for lifecycle gate check results. Gates enforce quality requirements at stage boundaries in the RCASD-IVTR pipeline.",
+  "type": "object",
+  "required": ["id", "stageId", "gateName", "result", "checkedAt", "checkedBy"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique gate result identifier"
+    },
+    "stageId": {
+      "type": "string",
+      "description": "Reference to the lifecycle stage this gate belongs to"
+    },
+    "gateName": {
+      "type": "string",
+      "description": "Name of the gate check (e.g., prerequisites-met, code-complete)"
+    },
+    "result": {
+      "type": "string",
+      "enum": ["pass", "fail", "warn"],
+      "description": "Gate check result"
+    },
+    "checkedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the gate was checked"
+    },
+    "checkedBy": {
+      "type": "string",
+      "description": "Agent or user who performed the check"
+    },
+    "details": {
+      "type": ["string", "null"],
+      "description": "Additional details about the check result"
+    },
+    "reason": {
+      "type": ["string", "null"],
+      "description": "Reason for failure or warning"
+    }
+  }
+}

package/schemas/rcasd-hitl-resolution.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-hitl-resolution.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-hitl-resolution.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-hitl-resolution schema."
+}

package/schemas/rcasd-index.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-index.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-index.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-index schema."
+}

package/schemas/rcasd-manifest.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-manifest.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-manifest.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-manifest schema."
+}

package/schemas/rcasd-research-output.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://cleo-dev.com/schemas/v1/rcasd-research-output.schema.json",
+  "allOf": [
+    {
+      "$ref": "./rcsd-research-output.schema.json"
+    }
+  ],
+  "description": "RCASD schema alias. Backward compatible with legacy rcsd-research-output schema."
+}