Last Updated: 2025-12-27
Scope: All projects under gitlab.com/blueflyio (excluding collaborative-impact, assets)
GitLab Group Structure
blueflyio/
agent-platform/ # Main platform - Drupal + TypeScript services
ossa/ # Open Standard for Scalable AI Agents specification
gitlab_components # Reusable CI/CD components
platform-agents # OSSA v0.3.0 compliant agent registry
security-policies # Security policy management
devops # Drupal DevOps template
1. TypeScript Services ([object Object])
Core microservices for the agent platform.
| Package | Description | Port |
|---|
agent-brain | Qdrant vector database service for embeddings, similarity search, RAG pipelines | 3006 |
agent-chat | Multi-modal AI chat interface with LibreChat integration | 3003 |
agent-mesh | Distributed agent coordination, service discovery, load balancing | 3005 |
agent-protocol | MCP server for tool registration, context routing, OpenAPI sync | 3001 |
agent-router | RESTful API gateway for multi-provider LLM orchestration | 3007 |
agent-studio | Cross-platform IDE suite (macOS, iOS, Electron, VS Code, Web) | 3008 |
agent-tracer | Unified observability (Phoenix, Qdrant, Prometheus, OpenTelemetry) | 3002 |
agent-tailscale | Tailscale integration for distributed agent networking | - |
agentic-flows | OpenAPI-first agentic workflow orchestration engine | - |
compliance-engine | Enterprise compliance validation and enforcement | - |
foundation-bridge | Integration bridge for foundation model providers | - |
kiro-supercharger | Kiro IDE enhancement with safety rules, steering, MCP configs | - |
rfp-automation | AI-powered RFP document processing and automation | 8500 |
studio-ui | React component library for AI platform interfaces | - |
workflow-engine | Production workflow execution and orchestration | 3004 |
2. Drupal Modules ([object Object])
Custom Drupal 11 modules for the LLM Platform.
Core AI Integration
| Module | Description |
|---|
ai_agents | Core module enabling AI agent integration with Drupal |
ai_agents_client | SDK for building agent communication clients |
ai_agents_ossa | OSSA 1.0 manifest validation and generation services |
ai_agents_ossa_base | Base OSSA integration layer |
ai_agentic_workflows | Complex multi-agent workflow automation engine |
ai_agents_orchestra | Multi-agent orchestration for coordinated AI workflows |
Provider Integrations
| Module | Description |
|---|
ai_agents_claude | Anthropic Claude AI provider integration |
ai_agents_cursor | Cursor IDE integration for AI-assisted TDD |
ai_agents_crewai | CrewAI multi-agent orchestration with gov compliance |
ai_agents_huggingface | HuggingFace model management with ECA workflows |
ai_agents_kagent | Kagent.dev Kubernetes runtime for OSSA agents |
ai_provider_apple | Apple Foundation Models on-device AI provider |
ai_provider_langchain | LangChain framework integration |
| Module | Description |
|---|
llm | Core LLM configuration, workflow management, admin UI |
api_normalization | OpenAPI schema to Drupal entity automatic generation |
mcp_registry | Model Context Protocol service registry |
code_executor | Secure sandboxed code execution for agent operations |
charts_ai_analytics | AI analytics charting and visualization |
alternative_services | Visual service orchestration UI |
ai_agents_marketplace | Centralized platform for discovering/deploying agents |
recipe_onboarding | Automated user onboarding with recipe generation |
Compliance & Security
| Module | Description |
|---|
gov_compliance | FedRAMP/NIST government compliance and security hardening |
dita_ccms | Darwin Information Typing Architecture content management |
drupal_patch_framework | Drupal patching framework |
Migration & Integration
| Module | Description |
|---|
external_migration | AI-enhanced multi-CMS migration with field mapping |
layout_system_converter | Legacy layout migration to Experience Builder |
blockchain_manager | Blockchain integration with secure, auditable workflows |
3. Drupal Recipes ([object Object])
| Recipe | Description |
|---|
llm_platform | Full AI platform with multi-provider LLM integration |
secure_drupal | FedRAMP-aligned security-hardened Drupal |
agent_marketplace | OSSA-compliant agent marketplace |
4. Drupal Themes ([object Object])
| Theme | Description |
|---|
llm_platform_manager | Bootstrap 5 admin theme with 4 configurable sub-themes |
5. ML Models ([object Object])
Fine-tuned models for specific domains.
| Model | Description |
|---|
llm-platform_model | Core model for software development and agent orchestration |
agent-studio_model | Fine-tuned for test-driven development assistance |
civicpolicy_model | Civic policy analysis and regulatory frameworks |
gov-rfp_model | Government RFP analysis and procurement |
6. OSSA (Open Standard for Scalable AI Agents)
Located in OssA/ and gitlab.com/blueflyio/ossa/
| Project | Description |
|---|
openstandardagents | OSSA specification - vendor-neutral, portable agent format |
openstandardagents.org | Website, Discord config, DevOps agents |
lab/gitlab-agent_ossa | POC for OSSA schema integration with GitLab Duo |
| Project | Description |
|---|
llm-platform | Drupal 11 AI orchestration platform (main application) |
agent-buildkit | Enterprise agent orchestration with TDD, GitLab CI/CD, K8s, OSSA |
agent-docker | Docker and Kubernetes containerization |
api-schema-registry | Master OpenAPI 3.1 specifications and shared schemas |
gitlab_components | 60+ reusable GitLab CI/CD components for OSSA workflows |
platform-agents | OSSA v0.3.0 compliant agent framework with registry |
technical-docs | Unified documentation portal |
8. Local Directory Structure
$LLM_ROOT/
agent-buildkit/ # Main CLI and orchestration tool
all_drupal_custom/ # Drupal modules, recipes, themes (SOURCE)
‚ modules/ # 24 custom modules
‚ recipes/ # 3 recipes
‚ themes/ # 1 theme
api-schema-registry/ # OpenAPI schemas
common_npm/ # 16 TypeScript packages
gitlab_components/ # CI/CD components
llm-platform/ # Drupal 11 application (COMPOSER-MANAGED)
models/ # 4 ML models
OssA/ # OSSA specification
‚ openstandardagents/ # Main spec repo
‚ openstandardagents.org/
platform-agents/ # Agent registry
technical-docs/ # Documentation wiki clone
WIKIs/ # Local wiki clones
Separation of Duties
| Layer | Technology | Location |
|---|
| Specification | OSSA v0.3.0 | OssA/openstandardagents |
| Runtime Services | TypeScript/Node | common_npm/* |
| CMS/Admin | Drupal 11 | all_drupal_custom/* † llm-platform/ |
| ML Models | MLflow/HuggingFace | models/* |
| CI/CD | GitLab Components | gitlab_components/ |
| Infrastructure | K8s/Docker | agent-docker/, agent-buildkit/ |
| Documentation | GitLab Wiki | technical-docs/ |
Quick Reference
Important URLs
Key Commands
# Sync Drupal modules
buildkit drupal sync
# Validate OSSA manifests
ossa validate .agents/
# Run platform
cd llm-platform && ddev start
# Build TypeScript services
cd common_npm/<service> && npm run build