@cleocode/core 2026.4.5 → 2026.4.7

package/schemas/migrations.schema.json

@@ -1,150 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://cleo-dev.com/schemas/v1/migrations.schema.json",
-  "schemaVersion": "1.0.0",
-  "title": "CLEO Migration Journal Schema",
-  "description": "Audit trail of schema migration operations. Tracks applied migrations with checksums and execution metadata for data integrity verification.",
-  "type": "object",
-  "required": [
-    "_meta",
-    "appliedMigrations"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "_meta": {
-      "type": "object",
-      "required": [
-        "schemaVersion"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "schemaVersion": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version for this migrations journal (semver)."
-        },
-        "lastChecked": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "format": "date-time",
-          "description": "Last time migration status was checked."
-        }
-      }
-    },
-    "appliedMigrations": {
-      "type": "array",
-      "description": "Chronologically ordered list of applied migrations. Append-only for audit trail.",
-      "items": {
-        "$ref": "#/definitions/migrationEntry"
-      }
-    }
-  },
-  "definitions": {
-    "migrationEntry": {
-      "type": "object",
-      "required": [
-        "version",
-        "fileType",
-        "checksum",
-        "appliedAt",
-        "status"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "version": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Target schema version of this migration (semver)."
-        },
-        "fileType": {
-          "type": "string",
-          "enum": [
-            "todo",
-            "config",
-            "archive",
-            "log",
-            "sessions",
-            "migrations"
-          ],
-          "description": "Type of file that was migrated."
-        },
-        "functionName": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "Migration function name that was executed (e.g., 'migrate_todo_to_2_3_0'). Null for version-bump-only migrations."
-        },
-        "checksum": {
-          "type": "string",
-          "pattern": "^[a-f0-9]{64}$",
-          "description": "SHA256 checksum of the migration function source code (for verification)."
-        },
-        "appliedAt": {
-          "type": "string",
-          "format": "date-time",
-          "description": "When this migration was executed (UTC)."
-        },
-        "status": {
-          "type": "string",
-          "enum": [
-            "success",
-            "failed",
-            "skipped"
-          ],
-          "description": "Outcome of the migration operation."
-        },
-        "executionTimeMs": {
-          "type": [
-            "integer",
-            "null"
-          ],
-          "minimum": 0,
-          "description": "Time taken to execute migration in milliseconds."
-        },
-        "previousVersion": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "pattern": "^\\d+\\.\\d+\\.\\d+$",
-          "description": "Schema version before this migration was applied."
-        },
-        "logs": {
-          "type": "array",
-          "description": "Log messages generated during migration execution.",
-          "items": {
-            "type": "string"
-          }
-        },
-        "backupPath": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "Path to backup created before migration (for rollback)."
-        },
-        "error": {
-          "type": [
-            "object",
-            "null"
-          ],
-          "description": "Error details if migration failed.",
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "recoverable": {
-              "type": "boolean"
-            }
-          }
-        }
-      }
-    }
-  }
-}

package/schemas/nexus-registry.schema.json

@@ -1,90 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://cleo-dev.com/schemas/v1/nexus-registry.schema.json",
-  "title": "CLEO Nexus Registry Schema (DEPRECATED)",
-  "description": "DEPRECATED: This schema is no longer used. nexus.db (SQLite) is the live backend as of 2026.3. Legacy JSON (projects-registry.json) is auto-migrated on first nexus init. Retained for historical reference only.",
-  "type": "object",
-  "required": ["version", "lastUpdated", "projects"],
-  "additionalProperties": false,
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "JSON Schema reference for validation."
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Schema version (semver). MUST match semantic versioning."
-    },
-    "lastUpdated": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp of last registry modification."
-    },
-    "projects": {
-      "type": "object",
-      "description": "Map of project_hash → project metadata. Keyed by 12-character hexadecimal hash.",
-      "patternProperties": {
-        "^[a-f0-9]{12}$": {
-          "$ref": "#/definitions/project"
-        }
-      },
-      "additionalProperties": false
-    }
-  },
-  "definitions": {
-    "project": {
-      "type": "object",
-      "description": "A registered CLEO project with metadata and access timestamps.",
-      "required": ["hash", "path", "name", "lastAccess"],
-      "additionalProperties": false,
-      "properties": {
-        "hash": {
-          "type": "string",
-          "pattern": "^[a-f0-9]{12}$",
-          "description": "12-character hexadecimal identifier. MUST match object key. Generated via generate_project_hash() (stable SHA256 of path)."
-        },
-        "path": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Absolute filesystem path to project root. MUST contain .cleo/todo.json to be valid."
-        },
-        "name": {
-          "type": "string",
-          "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$",
-          "minLength": 1,
-          "maxLength": 64,
-          "description": "Human-readable project identifier. MUST be unique across all registered projects. Lowercase with hyphens allowed."
-        },
-        "aliases": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$",
-            "minLength": 1,
-            "maxLength": 32
-          },
-          "uniqueItems": true,
-          "default": [],
-          "description": "Alternative names for project resolution. MUST NOT conflict with any project names."
-        },
-        "lastAccess": {
-          "type": "string",
-          "format": "date-time",
-          "description": "ISO 8601 timestamp of last read operation. Used for pruning inactive projects."
-        },
-        "taskCount": {
-          "type": "integer",
-          "minimum": 0,
-          "default": 0,
-          "description": "Number of tasks in project. Cached for quick reference."
-        },
-        "checksum": {
-          "type": "string",
-          "pattern": "^[a-f0-9]{16}$",
-          "description": "SHA-256 truncated hash of project's todo.json tasks array. Used for cache invalidation."
-        }
-      }
-    }
-  }
-}

package/schemas/operation-constitution.schema.json

@@ -1,438 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "CLEO Operation Constitution",
-  "description": "Validates the complete CLEO Operation Constitution document including the full registry, gateway matrices, and domain tables",
-  "type": "object",
-  "required": ["schemaVersion", "metadata", "registry", "gateways", "domains"],
-  "additionalProperties": false,
-  "definitions": {
-    "Gateway": {
-      "type": "string",
-      "enum": ["query", "mutate"],
-      "description": "CQRS gateway: read-only queries or state-changing mutations"
-    },
-    "CanonicalDomain": {
-      "type": "string",
-      "enum": ["tasks", "session", "memory", "check", "pipeline", "orchestrate", "tools", "admin", "nexus", "sticky"],
-      "description": "One of 10 canonical CLEO domains"
-    },
-    "Tier": {
-      "type": "integer",
-      "enum": [0, 1, 2],
-      "description": "Progressive disclosure tier: 0=basic, 1=extended, 2=full"
-    },
-    "ParamDef": {
-      "type": "object",
-      "required": ["name", "type", "required", "description"],
-      "properties": {
-        "name": {
-          "type": "string",
-          "pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
-          "description": "Canonical camelCase parameter name"
-        },
-        "type": {
-          "type": "string",
-          "enum": ["string", "number", "boolean", "array"],
-          "description": "Runtime value type"
-        },
-        "required": {
-          "type": "boolean",
-          "description": "Whether parameter is required"
-        },
-        "description": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Human-readable description"
-        },
-        "cli": {
-          "type": "object",
-          "properties": {
-            "positional": { "type": "boolean" },
-            "short": { "type": "string", "pattern": "^-[a-zA-Z]$" },
-            "flag": { "type": "string" },
-            "variadic": { "type": "boolean" }
-          },
-          "additionalProperties": false
-        },
-        "mcp": {
-          "type": "object",
-          "properties": {
-            "hidden": { "type": "boolean" },
-            "enum": {
-              "type": "array",
-              "items": { "type": "string" }
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "OperationDef": {
-      "type": "object",
-      "required": ["gateway", "domain", "operation", "description", "tier", "idempotent", "sessionRequired", "requiredParams"],
-      "properties": {
-        "gateway": { "$ref": "#/definitions/Gateway" },
-        "domain": { "$ref": "#/definitions/CanonicalDomain" },
-        "operation": {
-          "type": "string",
-          "pattern": "^[a-z][a-z0-9]*(\\.[a-z][a-z0-9]*)*$",
-          "description": "Dot-notation operation name (e.g. 'show', 'stage.validate')"
-        },
-        "description": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Brief human-readable description of the operation"
-        },
-        "tier": { "$ref": "#/definitions/Tier" },
-        "idempotent": {
-          "type": "boolean",
-          "description": "Whether the operation is safe to retry without side effects"
-        },
-        "sessionRequired": {
-          "type": "boolean",
-          "description": "Whether the operation requires an active session"
-        },
-        "requiredParams": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[a-zA-Z][a-zA-Z0-9]*$"
-          },
-          "description": "Parameter keys that MUST be present in the request"
-        },
-        "params": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/ParamDef" },
-          "description": "Full parameter descriptors (optional, replaces requiredParams when populated)"
-        },
-        "aliases": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[a-z][a-z0-9]*(\\.[a-z][a-z0-9]*)*$"
-          },
-          "description": "Backward-compatible operation name aliases"
-        }
-      },
-      "additionalProperties": false
-    }
-  },
-  "properties": {
-    "schemaVersion": {
-      "type": "string",
-      "pattern": "^\\d{4}\\.\\d+\\.\\d+$",
-      "description": "Constitution schema version (e.g. '2026.3.3')"
-    },
-    "metadata": {
-      "type": "object",
-      "required": ["version", "status", "date", "totalOperations", "gateways", "domains"],
-      "additionalProperties": false,
-      "properties": {
-        "version": {
-          "type": "string",
-          "description": "Constitution document version"
-        },
-        "status": {
-          "type": "string",
-          "enum": ["DRAFT", "APPROVED", "DEPRECATED"],
-          "description": "Constitution approval status"
-        },
-        "date": {
-          "type": "string",
-          "format": "date",
-          "description": "Constitution approval date (ISO 8601)"
-        },
-        "task": {
-          "type": "string",
-          "pattern": "^T\\d+$",
-          "description": "Associated task ID (e.g. 'T5241')"
-        },
-        "supersedes": {
-          "type": "string",
-          "description": "Document this constitution supersedes"
-        },
-        "totalOperations": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "Total number of operations in registry"
-        },
-        "gateways": {
-          "type": "object",
-          "required": ["query", "mutate"],
-          "additionalProperties": false,
-          "properties": {
-            "query": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Number of query operations"
-            },
-            "mutate": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Number of mutate operations"
-            }
-          }
-        },
-        "domains": {
-          "type": "object",
-          "required": ["count", "names"],
-          "additionalProperties": false,
-          "properties": {
-            "count": {
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 10,
-              "description": "Number of canonical domains"
-            },
-            "names": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/CanonicalDomain" },
-              "minItems": 10,
-              "maxItems": 10,
-              "description": "List of all canonical domain names"
-            }
-          }
-        }
-      }
-    },
-    "registry": {
-      "type": "object",
-      "required": ["operations"],
-      "additionalProperties": false,
-      "properties": {
-        "operations": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/OperationDef" },
-          "minItems": 1,
-          "description": "All 207 operations in the registry"
-        }
-      }
-    },
-    "gateways": {
-      "type": "object",
-      "required": ["query", "mutate"],
-      "additionalProperties": false,
-      "properties": {
-        "query": {
-          "type": "object",
-          "required": ["matrix", "operations"],
-          "additionalProperties": false,
-          "properties": {
-            "matrix": {
-              "type": "object",
-              "description": "Query gateway matrix: domain -> operations[]",
-              "patternProperties": {
-                "^(tasks|session|memory|check|pipeline|orchestrate|tools|admin|nexus|sticky)$": {
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "pattern": "^[a-z][a-z0-9]*(\\.[a-z][a-z0-9]*)*$"
-                  }
-                }
-              },
-              "additionalProperties": false
-            },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" },
-              "description": "All query operations"
-            }
-          }
-        },
-        "mutate": {
-          "type": "object",
-          "required": ["matrix", "operations"],
-          "additionalProperties": false,
-          "properties": {
-            "matrix": {
-              "type": "object",
-              "description": "Mutate gateway matrix: domain -> operations[]",
-              "patternProperties": {
-                "^(tasks|session|memory|check|pipeline|orchestrate|tools|admin|nexus|sticky)$": {
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "pattern": "^[a-z][a-z0-9]*(\\.[a-z][a-z0-9]*)*$"
-                  }
-                }
-              },
-              "additionalProperties": false
-            },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" },
-              "description": "All mutate operations"
-            }
-          }
-        }
-      }
-    },
-    "domains": {
-      "type": "object",
-      "description": "Domain tables: operations grouped by domain",
-      "required": ["tasks", "session", "memory", "check", "pipeline", "orchestrate", "tools", "admin", "nexus", "sticky"],
-      "additionalProperties": false,
-      "properties": {
-        "tasks": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "tasks" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "session": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "session" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "memory": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "memory" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "check": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "check" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "pipeline": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "pipeline" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "orchestrate": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "orchestrate" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "tools": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "tools" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "admin": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "admin" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "nexus": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "nexus" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        },
-        "sticky": {
-          "type": "object",
-          "required": ["name", "purpose", "operations"],
-          "properties": {
-            "name": { "const": "sticky" },
-            "purpose": { "type": "string" },
-            "primaryStore": { "type": "string" },
-            "operations": {
-              "type": "array",
-              "items": { "$ref": "#/definitions/OperationDef" }
-            }
-          }
-        }
-      }
-    },
-    "progressiveDisclosure": {
-      "type": "object",
-      "description": "Progressive disclosure contract by tier",
-      "properties": {
-        "tiers": {
-          "type": "array",
-          "minItems": 3,
-          "maxItems": 3,
-          "items": {
-            "type": "object",
-            "required": ["tier", "name", "description", "operationCount", "domains"],
-            "properties": {
-              "tier": { "$ref": "#/definitions/Tier" },
-              "name": {
-                "type": "string",
-                "enum": ["Core", "Extended", "Full System"]
-              },
-              "description": { "type": "string" },
-              "operationCount": { "type": "integer", "minimum": 0 },
-              "domains": {
-                "type": "array",
-                "items": { "$ref": "#/definitions/CanonicalDomain" }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}