@bluefly/llm-docs

1.0.2 • Public • Published

author: LLM Platform Team source: https://github.com/bluefly/llm-platform-ecosystem publisher: Bluefly Technologies permissions: public audience: developers, government-agencies, enterprise-architects category: platform-overview keyword: [llm, ai, government, enterprise, drupal, api-first, multi-tenant, data-sovereignty] resourceid: llm-platform-main

⚠️ CRITICAL PROJECT PROTECTION WARNING ⚠️ NEVER DELETE, DISABLE, REMOVE, OR MERGE ANY OF THE FOLLOWING PROJECTS:

  • All projects in common_npm/, models/, recipes/
  • All Drupal modules in web/modules/custom/
  • All themes in web/themes/custom/
  • chat.bluefly project
  • NO NEW PROJECTS should be created - work with existing projects only These are active, working projects with significant development investment.

🚀 LLM Platform Ecosystem

🎯 Overview

This is the main LLM ecosystem containing multiple specialized projects for AI-native development, government compliance, and enterprise solutions.

📁 Project Structure

🤖 AI & Development Tools (/common_npm/)

tddai - Test-Driven Development AI

  • Purpose: AI-powered TDD workflow automation with intelligent safe mode
  • Status: ✅ Production Ready (Safe Mode Enabled)
  • Location: /common_npm/tddai/
  • Safe Mode: 🛡️ Enterprise-grade protection with git respect, audit-first execution, and AI learning

tddai_cursor_agent - Cursor IDE Integration

  • Purpose: Cursor IDE extension for TDD workflows
  • Status: 🟡 Development Phase
  • Location: /common_npm/tddai_cursor_agent/

llmcli - Command Line Interface

  • Purpose: Unified CLI for all LLM platform operations
  • Status: ✅ Production Ready
  • Location: /common_npm/llmcli/
  • Features: Drupal integration, key management, module operations

llm_gateway - API Gateway

  • Purpose: Central API gateway for all LLM services
  • Status: ✅ Production Ready
  • Location: /common_npm/llm_gateway/

llm_mcp - Model Context Protocol

  • Purpose: MCP server for LLM operations
  • Status: 🟡 Functional (CLI only)
  • Location: /common_npm/llm_mcp/

llm_ui - User Interface Components

  • Purpose: Reusable UI components for LLM applications
  • Status: 🟡 Basic components only
  • Location: /common_npm/llm_ui/

🏛️ Government & Compliance (/common_npm/)

bfrfp - Bid for Request for Proposal

  • Purpose: Government RFP automation and compliance
  • Status: 🔴 152 TypeScript errors (CRITICAL)
  • Location: /common_npm/bfrfp/

gov_compliance - Government Compliance

  • Purpose: Government compliance and audit features
  • Status: 🔴 Needs implementation
  • Location: /common_npm/gov_compliance/

secure_project - Security Framework

  • Purpose: Security and compliance framework
  • Status: 🟡 Interfaces only
  • Location: /common_npm/secure_project/

🐳 Infrastructure & Intelligence (/common_npm/)

docker_intelligence - Docker AI

  • Purpose: AI-powered Docker container management
  • Status: 🔴 63 compilation errors (CRITICAL)
  • Location: /common_npm/docker_intelligence/

qdrant - Vector Database

  • Purpose: Vector database for RAG capabilities
  • Status: ✅ Production Ready
  • Location: /common_npm/qdrant/

📚 Documentation & Content (/common_npm/)

llm_docs - Documentation Hub

  • Purpose: Centralized documentation system
  • Status: 🔴 MDX compilation failures
  • Location: /common_npm/llm_docs/

🍎 Apple Integration (/common_npm/)

apple_fm - Apple Foundation Models

  • Purpose: Apple AI model integration
  • Status: 🟡 Development Phase
  • Location: /common_npm/apple_fm/

🧠 AI Models (/models/)

gov_rfp_model - Government RFP Model

  • Purpose: Specialized AI model for government RFPs
  • Status: 🟡 Development Phase
  • Location: /models/gov_rfp_model/

llm_platform_model - LLM Platform Model

  • Purpose: Core LLM platform AI model
  • Status: 🟡 Development Phase
  • Location: /models/llm_platform_model/

tddai_model - TDD AI Model

  • Purpose: AI model for test-driven development
  • Status: 🟡 Development Phase
  • Location: /models/tddai_model/

🌐 Drupal Test Site (/llm-platform/)

Drupal Modules (/web/modules/custom/)

  • ai_agent_crewai: CrewAI integration 🔴 Needs implementation
  • ai_agent_huggingface: HuggingFace integration 🔴 Needs implementation
  • ai_agent_orchestra: AI orchestration 🔴 Needs implementation
  • ai_agentic_workflows: Workflow management 🔴 Needs implementation
  • ai_provider_apple: Apple AI integration 🔴 Needs implementation
  • ai_provider_langchain: LangChain integration 🔴 Needs fixes
  • alternative_services: Alternative service providers 🟡 Partially working
  • api_normalizer: API normalization 🟡 Partially working
  • code_executor: Code execution engine 🔴 Needs implementation
  • dita_ccms: DITA content management 🔴 Needs implementation
  • gov_compliance: Government compliance features 🔴 Needs fixes
  • llm: Main LLM integration module ✅ Working
  • mcp_registry: MCP server registry ✅ Working
  • recipe_onboarding: Recipe management system 🟡 Partially working

Drupal Recipes (/recipes/)

  • llm_platform: Main platform recipe
  • secure_drupal: Security-focused recipe

Drupal Theme (/web/themes/custom/)

  • llm_platform_manager: Admin theme for LLM platform

🔧 Critical Issues to Fix

🔴 High Priority (Fix First)

  1. bfrfp: 152 TypeScript compilation errors
  2. docker_intelligence: 63 compilation errors
  3. llm_docs: MDX compilation failures
  4. ai_provider_langchain: Missing interfaces

🟡 Medium Priority

  1. gov_compliance: Government compliance features
  2. llm_mcp: npm start script missing
  3. llm_ui: Advanced components needed
  4. secure_project: Actual implementation needed

🚀 Quick Start

Prerequisites

# Install dependencies for all projects
cd /Users/flux423/Sites/LLM
npm install

Development Workflow

# Start Drupal test site
cd llm-platform
ddev start

# Run TDD AI with Safe Mode (Recommended)
cd ../common_npm/tddai
tddai safe-exec --respect "npm start"

# Run CLI tool
cd ../common_npm/llmcli
npm start

🛡️ TDDAI Safe Mode

TDDAI Safe Mode provides enterprise-grade protection for AI-assisted development:

Core Protection Rules

  • 🚫 NEVER DELETE .git - Version history is sacred
  • 🔍 AUDIT EVERYTHING - No blind writes, no magic overwrites
  • 📋 CHECK UNCOMMITTED CHANGES - Always verify git status before operations
  • 🤝 RESPECT THE CODEBASE - Fix problems, don't disable features
  • 🧠 LEARN FROM PATTERNS - Uses /models/tddai-model to get smarter

Safe Mode Commands

# Maximum protection mode
tddai safe-exec --respect "rm old_file.txt"

# Audit only (no execution)
tddai safe-exec --audit-only "composer update"

# Self-audit TDDAI before changes
tddai self-audit

# Show safety recommendations
tddai predict-safety "drush sql-drop -y"

# Learn from execution patterns
tddai learn --analyze-patterns

Intelligence Features

  • 🔍 Pre-execution audit - Checks git status, protected paths, dangerous commands
  • 💾 Automatic backups - Creates recovery points before risky operations
  • 🧠 Pattern learning - Learns from successful/failed executions
  • 📊 Safety scoring - Calculates risk levels for commands
  • 💡 Smart recommendations - Suggests safer alternatives based on context

Drupal Integration

  • Standards enforcement - Validates Drupal coding standards
  • Module awareness - Understands Drupal module dependencies
  • Recipe validation - Checks recipe compatibility before application
  • API-first compliance - Ensures OpenAPI 3.1 specifications

📊 Status Summary

Project Status Priority Issues
tddai ✅ Production Low None
llmcli ✅ Production Low None
llm_gateway ✅ Production Low None
bfrfp 🔴 Critical HIGH 152 TS errors
docker_intelligence 🔴 Critical HIGH 63 errors
llm_docs 🔴 Critical HIGH MDX failures
llm_mcp 🟡 Functional Medium npm start
llm_ui 🟡 Basic Medium Advanced components
gov_compliance 🔴 Needs work Medium Implementation
secure_project 🟡 Interfaces Medium Implementation

🎯 Next Steps

Immediate (This Week)

  1. Fix bfrfp TypeScript compilation errors
  2. Fix docker_intelligence compilation errors
  3. Fix llm_docs MDX compilation
  4. Fix ai_provider_langchain missing interfaces

Short Term (Next 2 Weeks)

  1. Complete all critical fixes
  2. Implement missing module functionality
  3. Add advanced UI components
  4. Complete government compliance features

Medium Term (Next Month)

  1. Performance optimization
  2. Security hardening
  3. Accessibility compliance
  4. Complete documentation

📚 Documentation

  • Architecture: /docs/cursor-integration.md
  • API Documentation: /docs/api/
  • Development Guides: /docs/development/
  • Deployment: /docs/deployment/

🤝 Contributing

Each project has its own development workflow:

  • Drupal modules: Follow Drupal coding standards
  • Node.js projects: Follow TDD workflow
  • AI models: Follow ML best practices
  • CLI tools: Follow command-line UX principles

📞 Support

  • Issues: Create issues in respective project repositories
  • Documentation: Check /docs/ for each project
  • Development: Follow MASTER_ROADMAP.md for priorities

Maintainer: Thomas Scola
Version: 1.0.0 - Ecosystem Overview
Last Updated: August 2025

This ecosystem represents a comprehensive AI-native development platform with government compliance capabilities.

Readme

Keywords

none

Package Sidebar

Install

npm i @bluefly/llm-docs

Weekly Downloads

8

Version

1.0.2

License

none

Unpacked Size

6.34 MB

Total Files

516

Last publish

Collaborators

  • bluefly