@deimoscloud/coreai 0.1.0

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@deimoscloud/coreai",
+  "version": "0.1.0",
+  "description": "A configurable, team-ready AI agent orchestration platform",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "coreai": "dist/cli/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DeimosCloud/coreai.git"
+  },
+  "homepage": "https://github.com/DeimosCloud/coreai#readme",
+  "bugs": {
+    "url": "https://github.com/DeimosCloud/coreai/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "test:coverage": "NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "claude",
+    "cli",
+    "orchestration"
+  ],
+  "author": "Deimos Cloud",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "jest": "^30.2.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.3.0",
+    "typescript-eslint": "^8.53.1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "commander": "^14.0.2",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.5"
+  }
+}

package/schemas/agent.schema.json

@@ -0,0 +1,171 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://coreai.dev/schemas/agent.schema.json",
+  "title": "CoreAI Agent Definition",
+  "description": "Schema for CoreAI agent YAML definitions",
+  "type": "object",
+  "required": ["role", "type", "display_name", "description"],
+  "properties": {
+    "role": {
+      "type": "string",
+      "description": "Agent identifier (e.g., backend-engineer)",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "type": {
+      "type": "string",
+      "description": "Agent type category",
+      "enum": ["ic-engineer", "manager", "specialist", "coordinator"]
+    },
+    "display_name": {
+      "type": "string",
+      "description": "Human-readable agent name"
+    },
+    "description": {
+      "type": "string",
+      "description": "Agent role description"
+    },
+    "responsibilities": {
+      "type": "array",
+      "description": "List of agent responsibilities",
+      "items": {
+        "type": "string"
+      }
+    },
+    "expertise": {
+      "$ref": "#/$defs/expertise"
+    },
+    "skills": {
+      "type": "array",
+      "description": "Additional capabilities",
+      "items": {
+        "type": "string"
+      }
+    },
+    "principles": {
+      "$ref": "#/$defs/principles"
+    },
+    "behaviors": {
+      "$ref": "#/$defs/behaviors"
+    },
+    "context_sources": {
+      "$ref": "#/$defs/contextSources"
+    },
+    "communication": {
+      "$ref": "#/$defs/communication"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "expertise": {
+      "type": "object",
+      "description": "Agent expertise and skills",
+      "properties": {
+        "primary": {
+          "type": "array",
+          "description": "Primary areas of expertise",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tech_stack": {
+          "type": "string",
+          "description": "Technology stack (can be variable reference like ${config.tech_stack})"
+        }
+      },
+      "additionalProperties": true
+    },
+    "principles": {
+      "type": "object",
+      "description": "Development principles and guidelines",
+      "properties": {
+        "code_quality": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "testing": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "security": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "performance": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "behaviors": {
+      "type": "object",
+      "description": "Workflow and behavior configuration",
+      "properties": {
+        "workflow": {
+          "type": "string",
+          "description": "Workflow type",
+          "enum": [
+            "ticket-implementation",
+            "bug-investigation",
+            "code-review",
+            "planning-estimation"
+          ]
+        },
+        "quality_gates": {
+          "type": "string",
+          "description": "Quality gates reference (can be variable like ${config.quality_gates})"
+        }
+      },
+      "additionalProperties": true
+    },
+    "contextSources": {
+      "type": "object",
+      "description": "Context sources for the agent",
+      "properties": {
+        "shared": {
+          "type": "array",
+          "description": "Shared/remote context sources",
+          "items": {
+            "type": "string"
+          }
+        },
+        "personal": {
+          "type": "array",
+          "description": "Personal/local context sources",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "communication": {
+      "type": "object",
+      "description": "Communication paths for agent messaging",
+      "properties": {
+        "inbox": {
+          "type": "string",
+          "description": "Path to inbox directory"
+        },
+        "outbox": {
+          "type": "string",
+          "description": "Path to outbox directory"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/coreai.config.schema.json

@@ -0,0 +1,257 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://coreai.dev/schemas/coreai.config.schema.json",
+  "title": "CoreAI Configuration",
+  "description": "Configuration schema for CoreAI projects",
+  "type": "object",
+  "required": ["version", "project"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Configuration schema version",
+      "enum": ["1.0"]
+    },
+    "project": {
+      "type": "object",
+      "description": "Project metadata",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Project name"
+        },
+        "type": {
+          "type": "string",
+          "description": "Project type",
+          "enum": ["software", "infrastructure", "data", "mobile"],
+          "default": "software"
+        }
+      },
+      "additionalProperties": false
+    },
+    "team": {
+      "type": "object",
+      "description": "Team configuration",
+      "properties": {
+        "agents": {
+          "type": "array",
+          "description": "List of enabled agents",
+          "items": {
+            "type": "string"
+          },
+          "default": ["backend-engineer", "frontend-engineer", "devops-engineer", "engineering-manager"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "integrations": {
+      "type": "object",
+      "description": "External tool integrations",
+      "properties": {
+        "issue_tracker": {
+          "$ref": "#/$defs/issueTrackerIntegration"
+        },
+        "git": {
+          "$ref": "#/$defs/gitIntegration"
+        },
+        "documentation": {
+          "$ref": "#/$defs/documentationIntegration"
+        },
+        "state": {
+          "$ref": "#/$defs/stateIntegration"
+        }
+      },
+      "additionalProperties": false
+    },
+    "quality_gates": {
+      "type": "object",
+      "description": "Quality gate definitions",
+      "additionalProperties": {
+        "$ref": "#/$defs/qualityGate"
+      }
+    },
+    "tech_stack": {
+      "type": "object",
+      "description": "Technology stack information",
+      "properties": {
+        "primary_language": {
+          "type": "string",
+          "description": "Primary programming language"
+        },
+        "frameworks": {
+          "type": "array",
+          "description": "Frameworks and libraries used",
+          "items": {
+            "type": "string"
+          }
+        },
+        "cloud": {
+          "type": "string",
+          "description": "Cloud provider (if applicable)"
+        }
+      },
+      "additionalProperties": true
+    },
+    "mcp": {
+      "type": "object",
+      "description": "MCP (Model Context Protocol) settings",
+      "properties": {
+        "expose_adapters": {
+          "type": "boolean",
+          "description": "Expose adapters as MCP tools",
+          "default": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "issueTrackerIntegration": {
+      "type": "object",
+      "required": ["provider"],
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": ["jira", "linear", "github-issues", "azure-devops"]
+        },
+        "config": {
+          "type": "object",
+          "properties": {
+            "project_key": {
+              "type": "string",
+              "description": "Project key or identifier"
+            },
+            "base_url": {
+              "type": "string",
+              "format": "uri",
+              "description": "Base URL for the issue tracker"
+            }
+          },
+          "additionalProperties": true
+        },
+        "strategy": {
+          "type": "string",
+          "enum": ["mcp", "native", "auto"],
+          "default": "auto",
+          "description": "Adapter strategy: prefer MCP, native API, or auto-detect"
+        }
+      },
+      "additionalProperties": false
+    },
+    "gitIntegration": {
+      "type": "object",
+      "required": ["provider"],
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": ["github", "gitlab", "bitbucket", "azure-devops"]
+        },
+        "config": {
+          "type": "object",
+          "properties": {
+            "repo": {
+              "type": "string",
+              "description": "Repository identifier (e.g., owner/repo)"
+            },
+            "default_branch": {
+              "type": "string",
+              "default": "main",
+              "description": "Default branch name"
+            }
+          },
+          "additionalProperties": true
+        },
+        "strategy": {
+          "type": "string",
+          "enum": ["mcp", "native", "auto"],
+          "default": "auto"
+        }
+      },
+      "additionalProperties": false
+    },
+    "documentationIntegration": {
+      "type": "object",
+      "required": ["provider"],
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": ["confluence", "notion", "github-wiki", "local"]
+        },
+        "config": {
+          "type": "object",
+          "properties": {
+            "space_key": {
+              "type": "string",
+              "description": "Space or workspace identifier"
+            },
+            "base_url": {
+              "type": "string",
+              "format": "uri",
+              "description": "Base URL for the documentation provider"
+            },
+            "base_path": {
+              "type": "string",
+              "description": "Base path within the provider"
+            }
+          },
+          "additionalProperties": true
+        },
+        "strategy": {
+          "type": "string",
+          "enum": ["mcp", "native", "auto"],
+          "default": "auto"
+        }
+      },
+      "additionalProperties": false
+    },
+    "stateIntegration": {
+      "type": "object",
+      "required": ["provider"],
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": ["confluence", "notion", "s3", "github-repo", "local"]
+        },
+        "config": {
+          "type": "object",
+          "properties": {
+            "space_key": {
+              "type": "string"
+            },
+            "base_path": {
+              "type": "string"
+            },
+            "bucket": {
+              "type": "string",
+              "description": "S3 bucket name (for s3 provider)"
+            }
+          },
+          "additionalProperties": true
+        },
+        "strategy": {
+          "type": "string",
+          "enum": ["mcp", "native", "auto"],
+          "default": "auto"
+        }
+      },
+      "additionalProperties": false
+    },
+    "qualityGate": {
+      "type": "object",
+      "required": ["command"],
+      "properties": {
+        "command": {
+          "type": "string",
+          "description": "Command to run for this quality gate"
+        },
+        "required": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether this gate must pass"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}