hybard-agent 0.1.0

package/knowledge/CAPABILITIES.md

@@ -0,0 +1,448 @@
+# Hybard AI Agent — Capabilities Card
+## What I Can Do
+
+---
+
+## 🚀 Quick Reference
+
+### Core Abilities
+| Can Do | Example |
+|--------|---------|
+| ✅ Write code | Python, JS, TS, Dart, SQL |
+| ✅ Create files | Any file type |
+| ✅ Edit files | Modify existing code |
+| ✅ Delete files | Remove unwanted files |
+| ✅ Run commands | npm, pip, git, etc. |
+| ✅ Build apps | Web, Mobile, Backend |
+| ✅ Debug code | Find and fix errors |
+| ✅ Test code | Write and run tests |
+| ✅ Deploy apps | Docker, Cloud |
+| ✅ Use AI | LLM, RAG, Agents |
+
+---
+
+## 📁 File Operations
+
+### What I Can Do With Files
+```
+✅ Read file contents
+✅ Create new files
+✅ Write to files
+✅ Edit existing files
+✅ Delete files
+✅ Search by name (glob)
+✅ Search by content (grep)
+✅ Copy files
+✅ Move files
+✅ Rename files
+```
+
+### File Types I Handle
+```
+📝 Code: .py, .js, .ts, .dart, .sql, .html, .css
+📄 Config: .json, .yaml, .yml, .toml, .env
+📋 Docs: .md, .txt, .rst
+🔧 Scripts: .sh, .bat, .ps1
+📦 Packages: package.json, requirements.txt, pubspec.yaml
+```
+
+---
+
+## 💻 Programming Languages
+
+### Languages I Master
+| Language | Level | What I Can Do |
+|----------|-------|---------------|
+| **Python** | Expert | Scripts, APIs, ML, automation |
+| **JavaScript** | Expert | Web, Node.js, React |
+| **TypeScript** | Expert | Type-safe JS, React, APIs |
+| **Dart** | Expert | Flutter, mobile apps |
+| **SQL** | Expert | Queries, schemas, migrations |
+| **HTML** | Expert | Web pages, forms, semantic |
+| **CSS** | Expert | Styling, Flexbox, Grid |
+| **Bash** | Expert | Scripts, automation |
+
+### Code I Can Write
+```python
+# Python
+def hello():
+    print("Hello from Hybard!")
+    
+# FastAPI
+from fastapi import FastAPI
+app = FastAPI()
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+```
+
+```javascript
+// JavaScript
+const express = require('express');
+const app = express();
+
+app.get('/', (req, res) => {
+  res.json({ message: 'Hello from Hybard!' });
+});
+
+app.listen(3000);
+```
+
+```typescript
+// TypeScript
+interface User {
+  id: number;
+  name: string;
+}
+
+const getUser = (id: number): User => {
+  return { id, name: 'Hybard User' };
+};
+```
+
+```dart
+// Dart/Flutter
+import 'package:flutter/material.dart';
+
+void main() {
+  runApp(MyApp());
+}
+
+class MyApp extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        body: Center(
+          child: Text('Hello from Hybard!'),
+        ),
+      ),
+    );
+  }
+}
+```
+
+---
+
+## 🌐 Web Development
+
+### Frontend I Can Build
+| Framework | What I Create |
+|-----------|---------------|
+| **React** | Components, hooks, state management |
+| **Next.js** | SSR apps, API routes, pages |
+| **Vue** | Composition API, reactive apps |
+| **Angular** | Enterprise applications |
+| **HTML/CSS** | Static sites, landing pages |
+
+### Backend I Can Build
+| Framework | What I Create |
+|-----------|---------------|
+| **FastAPI** | Async Python APIs |
+| **Flask** | Microservices |
+| **Django** | Full-stack apps |
+| **Express** | Node.js APIs |
+| **NestJS** | TypeScript backends |
+
+### APIs I Can Create
+```
+✅ REST API (CRUD operations)
+✅ GraphQL API (queries, mutations)
+✅ WebSocket (real-time)
+✅ SSE (server-sent events)
+✅ Authentication (JWT, OAuth)
+```
+
+---
+
+## 🗄️ Database
+
+### Databases I Work With
+| Database | Type | What I Can Do |
+|----------|------|---------------|
+| **PostgreSQL** | SQL | Complex queries, schemas |
+| **MySQL** | SQL | Web app databases |
+| **SQLite** | SQL | Embedded, testing |
+| **MongoDB** | NoSQL | Document storage |
+| **Redis** | Cache | Caching, sessions |
+
+### Database Operations
+```
+✅ Design schemas
+✅ Write migrations
+✅ Create queries
+✅ Optimize performance
+✅ Set up indexing
+✅ Handle connections
+```
+
+---
+
+## 🤖 AI/ML
+
+### AI Capabilities
+| Area | What I Can Do |
+|------|---------------|
+| **LLM** | Work with GPT, Claude, Gemini, Ollama |
+| **Prompt Engineering** | Design effective prompts |
+| **RAG** | Build retrieval-augmented generation |
+| **Vector DB** | Use FAISS, Chroma, Qdrant |
+| **Embeddings** | Generate and search embeddings |
+| **Agent** | Build autonomous AI agents |
+
+### AI Code I Can Write
+```python
+# RAG System
+from langchain import ChatOpenAI
+from langchain.vectorstores import Chroma
+
+# Agent with Tools
+from langchain.agents import initialize_agent
+from langchain.tools import Tool
+
+# Prompt Template
+from langchain.prompts import ChatPromptTemplate
+```
+
+---
+
+## 🔧 Tool Calling
+
+### Tools I Can Use
+| Tool | What It Does |
+|------|--------------|
+| `read` | Read file contents |
+| `write` | Create/write files |
+| `edit` | Modify files |
+| `bash` | Run shell commands |
+| `glob` | Find files by pattern |
+| `grep` | Search file contents |
+| `webfetch` | Fetch web pages |
+| `websearch` | Search the internet |
+
+### Tool Chain Examples
+```
+Create Project:
+mkdir → npm init → write package.json → write files → npm install
+
+Fix Bug:
+read error → grep related code → edit fix → run tests
+
+Build Feature:
+read codebase → plan → write files → edit existing → test → build
+```
+
+---
+
+## 🐛 Debugging
+
+### What I Can Debug
+```
+✅ Syntax errors
+✅ Runtime errors
+✅ Logic errors
+✅ Type errors
+✅ Network errors
+✅ Database errors
+✅ API errors
+✅ Performance issues
+```
+
+### Debugging Flow
+```
+1. Read error message
+2. Find error location
+3. Analyze root cause
+4. Generate fix
+5. Apply fix
+6. Test solution
+7. Verify success
+```
+
+---
+
+## 🧪 Testing
+
+### Tests I Can Write
+| Type | What It Tests |
+|------|---------------|
+| **Unit** | Individual functions |
+| **Integration** | Component interaction |
+| **E2E** | Complete workflows |
+| **API** | Endpoint behavior |
+
+### Testing Tools
+```
+✅ Jest (JavaScript)
+✅ Pytest (Python)
+✅ Vitest (Vite)
+✅ Flutter Test (Dart)
+✅ Mocha (Node.js)
+```
+
+---
+
+## 🚀 Deployment
+
+### What I Can Deploy
+```
+✅ Web apps to cloud
+✅ APIs to servers
+✅ Docker containers
+✅ Static sites
+✅ Mobile apps (Flutter)
+```
+
+### Deployment Targets
+```
+☁️ Cloud: AWS, GCP, Azure
+🐳 Containers: Docker, Kubernetes
+🌐 CDN: Netlify, Vercel, Cloudflare
+🗄️ Database: Supabase, Firebase, PlanetScale
+```
+
+---
+
+## 🔒 Security
+
+### Security Practices I Follow
+```
+✅ Never hardcode secrets
+✅ Use environment variables
+✅ Validate user input
+✅ Sanitize outputs
+✅ Use parameterized queries
+✅ Follow OWASP guidelines
+✅ Handle errors safely
+✅ Use HTTPS
+```
+
+---
+
+## 📱 Mobile Development
+
+### Flutter Apps I Can Build
+```
+✅ UI components
+✅ State management (Riverpod, Provider)
+✅ Navigation
+✅ API integration
+✅ Local storage
+✅ Push notifications
+✅ Camera/Location
+✅ Animations
+```
+
+---
+
+## 🌍 Multilingual
+
+### Languages I Support
+| Language | Code | Support |
+|----------|------|---------|
+| বাংলা | bn | Native |
+| English | en | Native |
+| हिन्दी | hi | Supported |
+| 中文 | zh | Supported |
+| 日本語 | ja | Supported |
+| العربية | ar | Supported |
+| Español | es | Supported |
+| Français | fr | Supported |
+
+---
+
+## ⚡ Performance
+
+### What I Optimize
+```
+✅ Code efficiency
+✅ Database queries
+✅ API response time
+✅ Bundle size
+✅ Memory usage
+✅ Load time
+```
+
+---
+
+## 📊 Project Types
+
+### Complete Projects I Can Build
+| Type | Components |
+|------|------------|
+| **Web App** | Frontend + Backend + Database |
+| **Mobile App** | Flutter + API + Database |
+| **API Service** | REST/GraphQL + Auth + DB |
+| **CLI Tool** | Node.js/Python + Commands |
+| **AI Agent** | LLM + Tools + Memory |
+| **Full Stack** | All of the above combined |
+
+---
+
+## 🎯 Task Examples
+
+### "Create a login page"
+```
+1. Write HTML form
+2. Add CSS styling
+3. Add JavaScript validation
+4. Create backend API
+5. Add database storage
+6. Implement JWT auth
+7. Test everything
+```
+
+### "Fix this bug"
+```
+1. Read the error
+2. Find the code
+3. Understand the issue
+4. Write the fix
+5. Test the fix
+6. Verify it works
+```
+
+### "Build a REST API"
+```
+1. Set up project structure
+2. Create routes
+3. Add middleware
+4. Connect database
+5. Add authentication
+6. Write tests
+7. Deploy
+```
+
+---
+
+## 🆘 When I Need Help
+
+### I'll Ask For:
+```
+❓ Clarification on requirements
+❓ Specific framework preferences
+❓ Database choice
+❓ Deployment target
+❓ API credentials
+❓ Testing preferences
+```
+
+---
+
+## 📈 Growth Areas
+
+### What I'm Learning
+```
+🔄 Advanced ML model training
+🔄 Complex microservices
+🔄 Real-time systems
+🔄 Advanced mobile features
+🔄 Edge computing
+```
+
+---
+
+*This capabilities card is a quick reference for what Hybard AI Agent can do.*
+*For detailed information, see KNOWLEDGE_BASE.md*
+*Last Updated: 2026-07-26*

package/knowledge/INDEX.md

@@ -0,0 +1,204 @@
+# Hybard Knowledge Base — Quick Index
+
+## 🔍 Quick Lookup
+
+### By Category
+
+| # | Category | Key Topics | File Reference |
+|---|----------|------------|----------------|
+| 1 | Programming Foundation | Python, JS, TS, Dart, SQL, Git | KNOWLEDGE_BASE.md#1 |
+| 2 | Computer Fundamentals | OS, CPU, RAM, GPU, Networking | KNOWLEDGE_BASE.md#2 |
+| 3 | Terminal / CLI | Shell, Commands, Process Mgmt | KNOWLEDGE_BASE.md#3 |
+| 4 | Web Development | HTML, CSS, React, REST API | KNOWLEDGE_BASE.md#4 |
+| 5 | Backend | FastAPI, Express, Django | KNOWLEDGE_BASE.md#5 |
+| 6 | Database | PostgreSQL, MongoDB, Vector DB | KNOWLEDGE_BASE.md#6 |
+| 7 | AI Foundation | ML, DL, Neural Networks | KNOWLEDGE_BASE.md#7 |
+| 8 | Deep Learning | CNN, RNN, Transformer, PyTorch | KNOWLEDGE_BASE.md#8 |
+| 9 | LLM Core | Tokenizer, Attention, Inference | KNOWLEDGE_BASE.md#9 |
+| 10 | LLM Training | Fine-tuning, RLHF, LoRA | KNOWLEDGE_BASE.md#10 |
+| 11 | Code AI | Code Generation, Completion | KNOWLEDGE_BASE.md#11 |
+| 12 | Prompt Engineering | System Prompt, Few-shot, CoT | KNOWLEDGE_BASE.md#12 |
+| 13 | Tool Calling | Function Calling, Tool Schema | KNOWLEDGE_BASE.md#13 |
+| 14 | Agent Core | Agent Loop, Planner, Executor | KNOWLEDGE_BASE.md#14 |
+| 15 | Agent Memory | Short/Long-term Memory | KNOWLEDGE_BASE.md#15 |
+| 16 | RAG | Chunking, Embedding, Search | KNOWLEDGE_BASE.md#16 |
+| 17 | Codebase Intelligence | AST, Code Graph, Symbol Index | KNOWLEDGE_BASE.md#17 |
+| 18 | File System Tools | Read/Write/Edit/Delete | KNOWLEDGE_BASE.md#18 |
+| 19 | Terminal Agent | Command Execution | KNOWLEDGE_BASE.md#19 |
+| 20 | Code Verification | Testing, Linting | KNOWLEDGE_BASE.md#20 |
+| 21 | Debugging Agent | Error Detection, Fix | KNOWLEDGE_BASE.md#21 |
+| 22 | Security | Auth, Sandbox, Injection | KNOWLEDGE_BASE.md#22 |
+| 23 | Package Management | npm, pip, uv, poetry | KNOWLEDGE_BASE.md#23 |
+| 24 | Git | Branch, Commit, PR | KNOWLEDGE_BASE.md#24 |
+| 25 | Web Agent | Search, Fetch, Scraping | KNOWLEDGE_BASE.md#25 |
+| 26 | Documentation Intel | Version Detection | KNOWLEDGE_BASE.md#26 |
+| 27 | Voice AI | STT, TTS, VAD | KNOWLEDGE_BASE.md#27 |
+| 28 | Multilingual AI | Language Detection, Translation | KNOWLEDGE_BASE.md#28 |
+| 29 | Image AI | Generation, Understanding | KNOWLEDGE_BASE.md#29 |
+| 30 | Video AI | Generation, Processing | KNOWLEDGE_BASE.md#30 |
+| 31 | AI Coding IDE | Monaco, Terminal, Diff | KNOWLEDGE_BASE.md#31 |
+| 32 | Cloud & Deployment | Docker, CDN, DNS | KNOWLEDGE_BASE.md#32 |
+| 33 | Production System | Logging, Monitoring | KNOWLEDGE_BASE.md#33 |
+| 34 | AI Evaluation | Accuracy, Latency | KNOWLEDGE_BASE.md#34 |
+| 35 | Advanced Agent | Multi-Agent, Handoff | KNOWLEDGE_BASE.md#35 |
+
+---
+
+## 🎯 Task-Based Lookup
+
+### "I want to build a..."
+| Task | Relevant Topics |
+|------|-----------------|
+| **Web App** | 4 (Web Dev), 5 (Backend), 6 (Database) |
+| **Mobile App** | 1 (Dart/Flutter), 4 (HTML/CSS) |
+| **API** | 5 (Backend), 12 (Prompt), 13 (Tool Calling) |
+| **AI Agent** | 14 (Agent Core), 15 (Memory), 16 (RAG) |
+| **Code Generator** | 11 (Code AI), 12 (Prompt), 17 (Codebase Intel) |
+| **Chatbot** | 9 (LLM), 12 (Prompt), 27 (Voice) |
+| **Data Pipeline** | 6 (Database), 7 (AI), 16 (RAG) |
+| **ML Model** | 7 (AI), 8 (Deep Learning), 10 (Training) |
+| **DevOps Tool** | 19 (Terminal), 24 (Git), 32 (Cloud) |
+| **Security Tool** | 22 (Security), 20 (Verification) |
+
+### "How do I..."
+| Action | Relevant Topics |
+|--------|-----------------|
+| **Read a file** | 18 (File Tools) |
+| **Run a command** | 19 (Terminal Agent) |
+| **Generate code** | 11 (Code AI), 12 (Prompt) |
+| **Fix a bug** | 21 (Debugging), 20 (Verification) |
+| **Search codebase** | 17 (Codebase Intel) |
+| **Use Git** | 24 (Git) |
+| **Deploy to cloud** | 32 (Cloud) |
+| **Add authentication** | 22 (Security), 5 (Backend) |
+| **Implement RAG** | 16 (RAG) |
+| **Build multi-agent** | 35 (Advanced Agent) |
+
+---
+
+## 📊 Capability Matrix
+
+### Language Support
+| Language | Code | Read | Write | Execute | Debug |
+|----------|------|------|-------|---------|-------|
+| Python | py | ✅ | ✅ | ✅ | ✅ |
+| JavaScript | js | ✅ | ✅ | ✅ | ✅ |
+| TypeScript | ts | ✅ | ✅ | ✅ | ✅ |
+| Dart | dart | ✅ | ✅ | ✅ | ✅ |
+| SQL | sql | ✅ | ✅ | ✅ | ✅ |
+| HTML | html | ✅ | ✅ | - | ✅ |
+| CSS | css | ✅ | ✅ | - | ✅ |
+| Bash | sh | ✅ | ✅ | ✅ | ✅ |
+
+### Framework Support
+| Framework | Type | Can Build |
+|-----------|------|-----------|
+| React | Frontend | Web apps, SPAs |
+| Next.js | Full-stack | SSR apps, APIs |
+| Vue | Frontend | Web apps |
+| Angular | Frontend | Enterprise apps |
+| FastAPI | Backend | REST APIs |
+| Flask | Backend | Microservices |
+| Django | Backend | Full-stack apps |
+| Express | Backend | Node.js APIs |
+| Flutter | Mobile | iOS/Android apps |
+
+### Database Support
+| Database | Type | Use Case |
+|----------|------|----------|
+| PostgreSQL | SQL | Complex queries, production |
+| MySQL | SQL | Web applications |
+| SQLite | SQL | Embedded, testing |
+| MongoDB | NoSQL | Documents, flexible schema |
+| Redis | Cache | Caching, sessions |
+| FAISS | Vector | Similarity search |
+| Chroma | Vector | AI embeddings |
+
+---
+
+## 🧠 AI Concepts Quick Reference
+
+### LLM Pipeline
+```
+Input → Tokenization → Embedding → Transformer → Logits → Softmax → Output
+```
+
+### Agent Loop
+```
+Think → Act → Observe → Evaluate → Fix → Repeat
+```
+
+### RAG Pipeline
+```
+Query → Embedding → Vector Search → Retrieval → Context Injection → LLM → Response
+```
+
+### Training Pipeline
+```
+Data → Preprocessing → Training → Validation → Testing → Deployment
+```
+
+---
+
+## 📚 Learning Path
+
+### Phase 1: Foundation (Weeks 1-4)
+- [ ] Python, JavaScript, TypeScript
+- [ ] HTML, CSS, SQL
+- [ ] Git, Terminal
+- [ ] Computer Fundamentals
+
+### Phase 2: Web Development (Weeks 5-8)
+- [ ] React / Next.js
+- [ ] FastAPI / Express
+- [ ] PostgreSQL / MongoDB
+- [ ] REST API, WebSocket
+
+### Phase 3: AI/ML (Weeks 9-12)
+- [ ] Machine Learning
+- [ ] Deep Learning
+- [ ] PyTorch
+- [ ] Transformer Architecture
+
+### Phase 4: LLM & Agent (Weeks 13-16)
+- [ ] LLM Core Concepts
+- [ ] Prompt Engineering
+- [ ] Tool Calling
+- [ ] Agent Architecture
+
+### Phase 5: Code AI (Weeks 17-20)
+- [ ] Code Generation
+- [ ] Codebase Intelligence
+- [ ] File System Tools
+- [ ] Terminal Agent
+
+### Phase 6: Advanced (Weeks 21-24)
+- [ ] Security
+- [ ] Multi-Agent System
+- [ ] Voice/Image AI
+- [ ] Cloud Deployment
+
+---
+
+## 🔗 Cross-References
+
+### Topics That Build on Each Other
+```
+1 (Programming) → 4 (Web) → 5 (Backend) → 6 (Database)
+                                        ↓
+7 (AI Foundation) → 8 (Deep Learning) → 9 (LLM) → 10 (Training)
+                                        ↓
+11 (Code AI) → 12 (Prompt) → 13 (Tool Calling) → 14 (Agent Core)
+                                        ↓
+15 (Memory) → 16 (RAG) → 17 (Codebase Intel) → 18-21 (Tools)
+                                        ↓
+22 (Security) → 23 (Packages) → 24 (Git) → 25-34 (Advanced)
+                                        ↓
+35 (Multi-Agent)
+```
+
+---
+
+*Total Topics: 35*
+*Total Sub-topics: 500+*
+*Last Updated: 2026-07-26*