feat: real WordPress/Android/React/FastAPI/ReactNative knowledge injection into LLM prompts

backend/builder_api/service.py

@@ -3,6 +3,7 @@ from typing import Dict, Any, List
 
 from backend.builder.engine import AutonomousCodeBuilder
 from backend.models.gateway import model_gateway, DEFAULT_MODEL
+from backend.tools.knowledge_loader import build_prompt_with_knowledge
 
 
 
@@ -109,12 +110,8 @@ uvicorn
         description: str,
     ) -> Dict[str, Any]:
         """Generate a real FastAPI endpoint via LLM."""
-        prompt = (
-            f"Write a single FastAPI route handler for {method.upper()} {endpoint_path}. "
-            f"Description: {description}. "
-            f"Assume `app = FastAPI()` already exists. "
-            f"Output ONLY the code, no explanation, no markdown fences."
-        )
+        base_prompt = f"Write a production FastAPI route for {method.upper()} {endpoint_path}. Description: {description}. Assume app = FastAPI() exists. Include all imports."
+        prompt = build_prompt_with_knowledge(base_prompt, f"fastapi {description}")
 
         result = await model_gateway.generate(DEFAULT_MODEL, prompt)
 
@@ -136,11 +133,8 @@ uvicorn
         model_name = "".join(word.capitalize() for word in table_name.split("_"))
         field_desc = ", ".join(f"{f['name']}: {f['type']}" for f in fields)
 
-        prompt = (
-            f"Write a single Pydantic BaseModel class named {model_name}Base "
-            f"with fields: {field_desc}. "
-            f"Output ONLY the code, no explanation, no markdown fences."
-        )
+        base_prompt = f"Write a production Pydantic BaseModel named {model_name}Base with fields: {field_desc}. Include SQLAlchemy model too."
+        prompt = build_prompt_with_knowledge(base_prompt, "fastapi pydantic sqlalchemy")
 
         result = await model_gateway.generate(DEFAULT_MODEL, prompt)
 

backend/tools/knowledge/android.md

@@ -0,0 +1,114 @@
+# Android Development Reference (Jetpack/Kotlin)
+
+## build.gradle (app)
+android {
+    compileSdk = 34
+    defaultConfig {
+        applicationId = "com.example.app"
+        minSdk = 24
+        targetSdk = 34
+        versionCode = 1
+        versionName = "1.0"
+    }
+    buildFeatures { viewBinding = true; compose = true }
+    composeOptions { kotlinCompilerExtensionVersion = "1.5.0" }
+}
+dependencies {
+    implementation("androidx.core:core-ktx:1.12.0")
+    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.7.0")
+    implementation("androidx.navigation:navigation-fragment-ktx:2.7.5")
+    implementation("com.squareup.retrofit2:retrofit:2.9.0")
+    implementation("com.squareup.retrofit2:converter-gson:2.9.0")
+    implementation(platform("androidx.compose:compose-bom:2024.01.00"))
+    implementation("androidx.compose.ui:ui")
+    implementation("androidx.compose.material3:material3")
+    implementation("androidx.activity:activity-compose:1.8.2")
+    implementation("io.coil-kt:coil-compose:2.5.0")
+    implementation("com.google.dagger:hilt-android:2.50")
+}
+
+## Jetpack Compose Screen
+@Composable
+fun HomeScreen(viewModel: HomeViewModel = hiltViewModel()) {
+    val uiState by viewModel.uiState.collectAsState()
+    Scaffold(
+        topBar = { TopAppBar(title = { Text("App Name") }) }
+    ) { padding ->
+        LazyColumn(modifier = Modifier.padding(padding)) {
+            items(uiState.items) { item -> ItemCard(item = item) }
+        }
+    }
+}
+
+@Composable
+fun ItemCard(item: Item) {
+    Card(modifier = Modifier.fillMaxWidth().padding(8.dp)) {
+        Column(modifier = Modifier.padding(16.dp)) {
+            Text(item.title, style = MaterialTheme.typography.headlineSmall)
+            Text(item.description, style = MaterialTheme.typography.bodyMedium)
+        }
+    }
+}
+
+## ViewModel + StateFlow
+@HiltViewModel
+class HomeViewModel @Inject constructor(
+    private val repository: ItemRepository
+) : ViewModel() {
+    private val _uiState = MutableStateFlow(HomeUiState())
+    val uiState: StateFlow<HomeUiState> = _uiState.asStateFlow()
+
+    init { loadItems() }
+
+    private fun loadItems() {
+        viewModelScope.launch {
+            _uiState.update { it.copy(isLoading = true) }
+            try {
+                val items = repository.getItems()
+                _uiState.update { it.copy(items = items, isLoading = false) }
+            } catch (e: Exception) {
+                _uiState.update { it.copy(error = e.message, isLoading = false) }
+            }
+        }
+    }
+}
+data class HomeUiState(val items: List<Item> = emptyList(), val isLoading: Boolean = false, val error: String? = null)
+
+## Retrofit API Service
+interface ApiService {
+    @GET("posts") suspend fun getPosts(): List<Post>
+    @POST("posts") suspend fun createPost(@Body post: CreatePostRequest): Post
+    @GET("posts/{id}") suspend fun getPost(@Path("id") id: Int): Post
+}
+
+@Module @InstallIn(SingletonComponent::class)
+object NetworkModule {
+    @Provides @Singleton
+    fun provideRetrofit(): Retrofit = Retrofit.Builder()
+        .baseUrl("https://api.example.com/")
+        .addConverterFactory(GsonConverterFactory.create())
+        .build()
+
+    @Provides @Singleton
+    fun provideApiService(retrofit: Retrofit): ApiService = retrofit.create(ApiService::class.java)
+}
+
+## Room Database
+@Entity(tableName = "items")
+data class ItemEntity(@PrimaryKey(autoGenerate = true) val id: Int = 0, val title: String, val description: String)
+
+@Dao
+interface ItemDao {
+    @Query("SELECT * FROM items") fun getAll(): Flow<List<ItemEntity>>
+    @Insert(onConflict = OnConflictStrategy.REPLACE) suspend fun insert(item: ItemEntity)
+    @Delete suspend fun delete(item: ItemEntity)
+}
+
+@Database(entities = [ItemEntity::class], version = 1)
+abstract class AppDatabase : RoomDatabase() { abstract fun itemDao(): ItemDao }
+
+## AndroidManifest Permissions
+android.permission.INTERNET
+android.permission.ACCESS_NETWORK_STATE
+android.permission.CAMERA
+android.permission.READ_EXTERNAL_STORAGE

backend/tools/knowledge/fastapi.md

@@ -0,0 +1,79 @@
+# FastAPI Production Reference
+
+## Project Structure
+backend/app/main.py: FastAPI app, middleware, routers
+backend/app/database.py: SQLAlchemy engine, session
+backend/app/models.py: SQLAlchemy ORM models
+backend/app/schemas.py: Pydantic request/response models
+backend/app/auth.py: JWT auth logic
+backend/app/routers/: Route modules
+
+## main.py
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from .database import engine, Base
+
+Base.metadata.create_all(bind=engine)
+app = FastAPI(title="API", version="1.0.0")
+app.add_middleware(CORSMiddleware, allow_origins=["http://localhost:3000"], allow_credentials=True, allow_methods=["*"], allow_headers=["*"])
+
+@app.get("/health")
+def health(): return {"status": "ok"}
+
+## database.py
+from sqlalchemy import create_engine
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import sessionmaker
+import os
+
+DATABASE_URL = os.getenv("DATABASE_URL", "sqlite:///./app.db")
+engine = create_engine(DATABASE_URL, connect_args={"check_same_thread": False})
+SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
+Base = declarative_base()
+
+def get_db():
+    db = SessionLocal()
+    try: yield db
+    finally: db.close()
+
+## JWT Auth
+from datetime import datetime, timedelta
+from jose import jwt
+from passlib.context import CryptContext
+from fastapi.security import OAuth2PasswordBearer
+
+SECRET_KEY = os.getenv("SECRET_KEY", "changeme")
+ALGORITHM = "HS256"
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+oauth2_scheme = OAuth2PasswordBearer(tokenUrl="auth/token")
+
+def create_access_token(data: dict):
+    expire = datetime.utcnow() + timedelta(minutes=30)
+    return jwt.encode({**data, "exp": expire}, SECRET_KEY, algorithm=ALGORITHM)
+
+def verify_password(plain: str, hashed: str) -> bool:
+    return pwd_context.verify(plain, hashed)
+
+## CRUD Router
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.orm import Session
+
+router = APIRouter()
+
+@router.get("/", response_model=list[schemas.Item])
+def list_items(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
+    return db.query(models.Item).offset(skip).limit(limit).all()
+
+@router.post("/", response_model=schemas.Item, status_code=201)
+def create_item(item: schemas.ItemCreate, db: Session = Depends(get_db)):
+    db_item = models.Item(**item.dict())
+    db.add(db_item)
+    db.commit()
+    db.refresh(db_item)
+    return db_item
+
+@router.get("/{item_id}", response_model=schemas.Item)
+def get_item(item_id: int, db: Session = Depends(get_db)):
+    item = db.query(models.Item).filter(models.Item.id == item_id).first()
+    if not item: raise HTTPException(status_code=404, detail="Not found")
+    return item

backend/tools/knowledge/react_native.md

@@ -0,0 +1,64 @@
+# React Native Production Reference (Expo)
+
+## Setup
+npx create-expo-app MyApp --template blank-typescript
+npx expo install expo-router react-native-safe-area-context react-native-screens
+
+## App Structure
+app/(tabs)/index.tsx: Home tab
+app/(tabs)/explore.tsx: Explore tab
+app/(tabs)/_layout.tsx: Tab navigator
+app/_layout.tsx: Root layout
+components/: Shared components
+
+## Core Screen
+import { View, Text, StyleSheet, TouchableOpacity, FlatList, TextInput, ScrollView } from 'react-native'
+import { SafeAreaView } from 'react-native-safe-area-context'
+
+export default function HomeScreen() {
+  const [text, setText] = useState('')
+  const [items, setItems] = useState([])
+
+  return (
+    <SafeAreaView style={styles.container}>
+      <ScrollView>
+        <Text style={styles.title}>Home</Text>
+        <TextInput style={styles.input} value={text} onChangeText={setText} placeholder="Search..." />
+        <FlatList
+          data={items}
+          keyExtractor={(item) => item.id.toString()}
+          renderItem={({ item }) => (
+            <TouchableOpacity style={styles.card} onPress={() => {}}>
+              <Text style={styles.cardTitle}>{item.title}</Text>
+            </TouchableOpacity>
+          )}
+        />
+      </ScrollView>
+    </SafeAreaView>
+  )
+}
+
+const styles = StyleSheet.create({
+  container: { flex: 1, backgroundColor: '#fff' },
+  title: { fontSize: 24, fontWeight: 'bold', padding: 16 },
+  input: { borderWidth: 1, borderColor: '#ddd', borderRadius: 8, padding: 12, margin: 16 },
+  card: { backgroundColor: '#f5f5f5', padding: 16, marginHorizontal: 16, marginBottom: 8, borderRadius: 8 },
+  cardTitle: { fontSize: 16, fontWeight: '600' },
+})
+
+## Navigation
+import { Link, useRouter } from 'expo-router'
+<Link href="/detail/123">Go to detail</Link>
+const router = useRouter()
+router.push('/detail/123')
+router.replace('/home')
+router.back()
+
+## Axios API Client
+import axios from 'axios'
+const api = axios.create({ baseURL: 'https://api.example.com', timeout: 10000 })
+api.interceptors.request.use(async (config) => {
+  const token = await AsyncStorage.getItem('token')
+  if (token) config.headers.Authorization = 'Bearer ' + token
+  return config
+})

backend/tools/knowledge/react_nextjs.md

@@ -0,0 +1,97 @@
+# React / Next.js 14 Production Reference
+
+## App Router Structure
+app/layout.tsx: Root layout with metadata
+app/page.tsx: Home page
+app/[slug]/page.tsx: Dynamic route
+app/api/route.ts: API route handler
+app/loading.tsx: Loading UI
+app/error.tsx: Error boundary
+components/: Shared components
+lib/: Utilities, db clients
+
+## layout.tsx
+import type { Metadata } from 'next'
+import { Inter } from 'next/font/google'
+import './globals.css'
+
+const inter = Inter({ subsets: ['latin'] })
+
+export const metadata: Metadata = {
+  title: 'App Name',
+  description: 'App description',
+}
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body className={inter.className}>{children}</body>
+    </html>
+  )
+}
+
+## Server Component
+async function getData() {
+  const res = await fetch('https://api.example.com/data', { next: { revalidate: 3600 } })
+  if (!res.ok) throw new Error('Failed to fetch')
+  return res.json()
+}
+
+export default async function Page() {
+  const data = await getData()
+  return (
+    <main>
+      <h1>{data.title}</h1>
+      {data.items.map((item: any) => <div key={item.id}>{item.name}</div>)}
+    </main>
+  )
+}
+
+## Client Component
+'use client'
+import { useState, useEffect } from 'react'
+
+export default function Counter() {
+  const [count, setCount] = useState(0)
+  useEffect(() => { document.title = 'Count: ' + count }, [count])
+  return <button onClick={() => setCount(c => c + 1)}>Count: {count}</button>
+}
+
+## API Route Handler
+import { NextRequest, NextResponse } from 'next/server'
+
+export async function GET(request: NextRequest) {
+  const { searchParams } = new URL(request.url)
+  const id = searchParams.get('id')
+  return NextResponse.json({ id, data: 'example' })
+}
+
+export async function POST(request: NextRequest) {
+  const body = await request.json()
+  return NextResponse.json({ success: true }, { status: 201 })
+}
+
+## Tailwind Card Grid
+<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
+  {items.map(item => (
+    <div key={item.id} className="bg-white rounded-lg shadow-md p-6 hover:shadow-lg transition-shadow">
+      <h3 className="text-xl font-semibold text-gray-900">{item.title}</h3>
+      <p className="text-gray-600 mt-2">{item.description}</p>
+      <button className="mt-4 bg-blue-600 text-white px-4 py-2 rounded-md hover:bg-blue-700">Learn More</button>
+    </div>
+  ))}
+</div>
+
+## Prisma ORM
+import { PrismaClient } from '@prisma/client'
+const globalForPrisma = globalThis as unknown as { prisma: PrismaClient }
+export const prisma = globalForPrisma.prisma ?? new PrismaClient()
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma
+
+## Zustand State
+import { create } from 'zustand'
+interface AppStore { user: User | null; setUser: (user: User | null) => void }
+export const useAppStore = create<AppStore>((set) => ({
+  user: null,
+  setUser: (user) => set({ user }),
+}))

backend/tools/knowledge/wordpress.md

@@ -0,0 +1,73 @@
+# WordPress Development Reference
+
+## Theme Structure
+- style.css: Theme header with Name, Version, Description
+- index.php: Main template fallback
+- functions.php: Theme setup, enqueue scripts/styles
+- header.php / footer.php: Site header and footer
+- single.php: Single post template
+- page.php: Static page template
+- archive.php: Archive/category/tag template
+- 404.php: Not found page
+- sidebar.php: Widget area
+
+## functions.php Essentials
+function theme_setup() {
+    add_theme_support('title-tag');
+    add_theme_support('post-thumbnails');
+    add_theme_support('html5', ['search-form','comment-form','comment-list','gallery','caption']);
+    register_nav_menus(['primary' => 'Primary Menu']);
+}
+add_action('after_setup_theme', 'theme_setup');
+
+function theme_scripts() {
+    wp_enqueue_style('theme-style', get_stylesheet_uri(), [], '1.0.0');
+    wp_enqueue_script('theme-script', get_template_directory_uri() . '/assets/js/main.js', ['jquery'], '1.0.0', true);
+}
+add_action('wp_enqueue_scripts', 'theme_scripts');
+
+## WordPress REST API
+Base URL: /wp-json/wp/v2/
+Posts: GET /wp-json/wp/v2/posts
+Pages: GET /wp-json/wp/v2/pages
+
+Custom endpoint:
+add_action('rest_api_init', function() {
+    register_rest_route('mytheme/v1', '/data', [
+        'methods' => 'GET',
+        'callback' => 'my_rest_callback',
+        'permission_callback' => '__return_true',
+    ]);
+});
+
+## Custom Post Types
+function register_portfolio_cpt() {
+    register_post_type('portfolio', [
+        'labels' => ['name' => 'Portfolio', 'singular_name' => 'Project'],
+        'public' => true,
+        'has_archive' => true,
+        'supports' => ['title', 'editor', 'thumbnail', 'excerpt'],
+        'show_in_rest' => true,
+        'rewrite' => ['slug' => 'portfolio'],
+    ]);
+}
+add_action('init', 'register_portfolio_cpt');
+
+## WooCommerce Integration
+- Check active: function_exists('WC')
+- Get products: wc_get_products(['limit' => 10, 'status' => 'publish'])
+- Product price: $product->get_price()
+- Cart URL: wc_get_cart_url()
+- Shop URL: get_permalink(wc_get_page_id('shop'))
+
+## ACF Fields
+- Get field: get_field('field_name')
+- Display: the_field('field_name')
+- Repeater: while(have_rows('repeater')): the_row(); get_sub_field('sub'); endwhile;
+
+## Security
+- Escape output: esc_html(), esc_url(), esc_attr()
+- Sanitize input: sanitize_text_field(), wp_kses_post()
+- Nonce: wp_nonce_field(), check_admin_referer()
+- Prepare SQL: $wpdb->prepare()
+- Capabilities: current_user_can('edit_posts')

backend/tools/knowledge_loader.py

@@ -0,0 +1,59 @@
+"""
+Knowledge loader for MCP builder tools.
+Loads relevant documentation into LLM prompts based on build target.
+"""
+from pathlib import Path
+
+KNOWLEDGE_DIR = Path(__file__).parent / "knowledge"
+
+KNOWLEDGE_MAP = {
+    "wordpress": "wordpress.md",
+    "wp": "wordpress.md",
+    "woocommerce": "wordpress.md",
+    "android": "android.md",
+    "kotlin": "android.md",
+    "jetpack": "android.md",
+    "react": "react_nextjs.md",
+    "nextjs": "react_nextjs.md",
+    "next.js": "react_nextjs.md",
+    "next": "react_nextjs.md",
+    "tailwind": "react_nextjs.md",
+    "fastapi": "fastapi.md",
+    "python": "fastapi.md",
+    "sqlalchemy": "fastapi.md",
+    "pydantic": "fastapi.md",
+    "react-native": "react_native.md",
+    "react_native": "react_native.md",
+    "expo": "react_native.md",
+    "mobile": "react_native.md",
+}
+
+
+def load_knowledge(context: str) -> str:
+    context_lower = context.lower()
+    matched_file = None
+    for keyword, filename in KNOWLEDGE_MAP.items():
+        if keyword in context_lower:
+            matched_file = filename
+            break
+    if not matched_file:
+        return ""
+    knowledge_path = KNOWLEDGE_DIR / matched_file
+    if not knowledge_path.exists():
+        return ""
+    return knowledge_path.read_text(encoding="utf-8")
+
+
+def build_prompt_with_knowledge(base_prompt: str, context: str) -> str:
+    knowledge = load_knowledge(context)
+    if not knowledge:
+        return base_prompt + "\n\nOutput ONLY production-ready code. No placeholders, no TODOs, no mock data."
+    return f"""You are a senior software engineer. Use this reference documentation:
+
+{knowledge}
+
+---
+
+{base_prompt}
+
+Output ONLY production-ready code. No placeholders, no TODOs, no mock data, no comments saying 'add logic here'."""

workspace-template/backend/mcp/agents/definitions/builder.md

@@ -1,6 +1,22 @@
-# Builder
+# Builder Agent
 
-Responsibilities:
-- Generate production code
-- Apply fixes
-- Build applications
+## Role
+Senior full-stack software engineer. Build real, production-ready applications.
+
+## Rules
+- NEVER output placeholder code, mock data, TODOs, or "add logic here" comments
+- NEVER output incomplete functions or stubs
+- ALWAYS output working, runnable code with all imports included
+- Use the reference documentation provided in the prompt exactly
+- Follow framework best practices as shown in the reference docs
+
+## Capabilities
+- WordPress themes, plugins, WooCommerce, REST API, ACF, CPTs
+- Android with Kotlin, Jetpack Compose, ViewModel, Room, Retrofit, Hilt
+- React / Next.js 14 App Router, TypeScript, Tailwind CSS, Prisma, Zustand
+- FastAPI backends with SQLAlchemy, JWT auth, Pydantic, CORS, CRUD routers
+- React Native / Expo with navigation, API integration, AsyncStorage
+- Docker, docker-compose, deployment configs
+
+## Output
+Return ONLY the requested code. No explanations unless asked.