@chanaka_nakandala/integration-agent 2.3.0 → 2.3.1

package/README.md

@@ -1,396 +1,89 @@
-# Grubtech Integration Assistant
+# Grubtech Integration Agent
 
-> **AI-powered integration helper for Claude Code**
-> Get instant answers, generate code, and build Grubtech integrations faster
+## What This Is
 
----
-
-## 📖 What is This?
-
-If you're a **restaurant, POS system, delivery platform, or cloud kitchen** building an integration with Grubtech APIs, this tool helps you work faster by providing:
-
-- ✅ **Instant answers** to API questions (no more searching docs)
-- ✅ **Production-ready code** in TypeScript, Python, Java, or cURL
-- ✅ **AI guidance** from specialized Developer and Business Analyst agents
-- ✅ **Smart documentation search** using natural language
-
-**Example:** Instead of searching docs for 30 minutes, just ask:
-*"How do I authenticate with Grubtech?"* → Get working code instantly.
-
----
-
-## 🍔 What is Grubtech?
+This is an easy setup tool for connecting your restaurant system with Grubtech. Just run one simple command, and it installs an AI helper inside your Claude Code app that answers questions and writes code for you.
 
-[**Grubtech**](https://www.grubtech.com) is a leading cloud-based restaurant technology platform that powers:
-- Cloud kitchens and virtual restaurants
-- Multi-channel online ordering (delivery apps, web, mobile)
-- Menu management across platforms
-- Order aggregation and kitchen operations
+## What You Can Do With This
 
-**For Developers:** If you're integrating your restaurant POS, delivery platform, or ordering system with Grubtech, you'll need to work with their REST APIs.
+- **Ask questions** about Grubtech and get instant answers
+- **Get code examples** in TypeScript, Python, Java, or cURL
+- **Build integrations faster** with AI-powered help
+- **Search documentation** without opening a browser
 
-**Official Resources:**
-- 🌐 Website: https://www.grubtech.com
-- 📚 API Documentation: https://docs.grubtech.io
-- 📧 Support: support@grubtech.io
-
----
-
-## 👥 Who Should Use This?
-
-This tool is perfect for **external developers** who are:
-
-✅ **Restaurant/POS Developers** - Integrating your point-of-sale system with Grubtech
-✅ **Delivery Platform Engineers** - Building order sync between your platform and Grubtech
-✅ **Cloud Kitchen Tech Teams** - Connecting kitchen management systems
-✅ **Integration Consultants** - Building custom integrations for clients
-✅ **Technical Partners** - Developing apps in the Grubtech ecosystem
-
-**No prior Grubtech experience needed!** This AI assistant guides you through the entire process.
-
----
+## Who Should Use This
 
-## ⚡ Quick Start - ONE Command!
+- Restaurant and POS developers
+- Delivery platform engineers
+- Anyone building integrations with Grubtech
+- Technical teams at cloud kitchens
 
-### Prerequisites
+No prior Grubtech experience needed!
 
-- **Node.js 18+** - [Download](https://nodejs.org/)
-- **Claude Desktop or Claude Code** - [Download](https://claude.ai/)
+## How to Install
 
-### Installation
-
-Run this **ONE command** in your terminal:
+Open your terminal and run this single command:
 
 ```bash
 npx @chanaka_nakandala/integration-agent init
 ```
 
-That's it! This installs:
-- ✅ AI-powered MCP server for Claude Code
-- ✅ 2 specialized AI agent personas (Developer & Business Analyst)
-- ✅ 20 production-ready code templates
-- ✅ Intelligent documentation search
-
-**Then:**
-1. Restart Claude Code
-2. Select an agent persona from the menu
-3. Start asking questions!
-
----
-
-## 💬 How to Use
+That's it! Then restart Claude Code and start asking questions.
 
-### Example 1: Get Authentication Code
+## What Features This Supports
 
-**You ask Claude:**
-```
-How do I authenticate with Grubtech API in TypeScript?
-```
+**AI Chat Assistant**
+- Ask any question about Grubtech APIs
+- Get instant answers without searching docs
+- Works directly inside Claude Code
 
-**Claude responds with:**
-```typescript
-// Complete working code with error handling
-const API_KEY = 'your-api-key-here';
-const PARTNER_ID = 'your-partner-id';
+**Code Generation**
+- Authentication code
+- Menu synchronization
+- Order receiving from Grubtech
+- Order status updates
+- Item availability management
 
-async function authenticate() {
-  const response = await fetch('https://api.grubtech.io/auth/token', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ apiKey: API_KEY, partnerId: PARTNER_ID })
-  });
+**Two AI Helpers**
+- **Developer Agent**: For writing code and technical questions
+- **Business Analyst Agent**: For planning projects and requirements
 
-  if (!response.ok) {
-    throw new Error(`Authentication failed: ${response.statusText}`);
-  }
+**Documentation Search**
+- Find information from Grubtech docs instantly
+- No need to browse websites
+- Works with natural language questions
 
-  const { accessToken } = await response.json();
-  return accessToken;
-}
-```
-
-### Example 2: Search Documentation
+## Example Usage
 
 **You ask:**
 ```
-How do incoming orders work?
+How do I authenticate with Grubtech?
 ```
 
-**Claude responds with:**
-Relevant documentation about order webhooks, payload structure, authentication requirements, and best practices - all extracted from official Grubtech docs.
-
-### Example 3: Planning Your Integration
+**AI responds with:**
+Complete working code ready to use in your project.
 
 **You ask:**
 ```
-Help me plan my restaurant POS integration with Grubtech
+Help me build a menu sync integration
 ```
 
-**BA Agent responds:**
-- Asks discovery questions about your system
-- Identifies integration requirements
-- Creates a comprehensive project plan with architecture diagrams
-- Provides a handoff document for implementation
-
----
-
-## 🤖 Two AI Agent Personas
-
-### 🔧 Developer Agent (Technical Implementation)
-
-**When to use:** You're ready to write code
+**AI responds with:**
+Step-by-step guidance and code examples.
 
-**What it does:**
-- Generates production-ready code in TypeScript, Python, Java, or cURL
-- Provides API specifications and technical details
-- Helps debug API errors with specific solutions
-- Technical, concise, code-first responses
+## What Grubtech Is
 
-**Example questions:**
-- "Generate Python code for menu synchronization"
-- "How do I handle order status updates in Java?"
-- "Show me cURL examples for item availability"
+Grubtech is a restaurant technology platform for online ordering, menu management, and kitchen operations. If you're connecting your system to Grubtech, this tool makes the job easier.
 
-### 📊 Business Analyst Agent (Planning & Requirements)
-
-**When to use:** You're starting a new integration project
-
-**What it does:**
-- Asks discovery questions about your integration needs
-- Gathers comprehensive requirements
-- Creates project documentation with architecture diagrams
-- Provides process guidance and go-live checklists
-- Explanatory, question-driven, process-oriented responses
-
-**Example questions:**
-- "Help me plan my integration with Grubtech"
-- "What do I need to know before starting?"
-- "Create a requirements document for my POS integration"
-
-**💡 Best Practice:** Start with BA Agent for planning → Switch to Developer Agent for coding
-
----
-
-## 🛠️ Common Integration Scenarios
-
-This tool helps with all major Grubtech integration scenarios:
-
-### 1. **Authentication**
-Get access tokens to call Grubtech APIs securely.
-
-**Ask Claude:** *"How do I authenticate?"*
-
-### 2. **Menu Synchronization**
-Push your menu items, modifiers, and pricing to Grubtech.
-
-**Ask Claude:** *"Generate code to sync my menu"*
-
-### 3. **Receiving Orders**
-Handle incoming order webhooks from Grubtech when customers place orders.
-
-**Ask Claude:** *"How do I receive orders from Grubtech?"*
-
-### 4. **Order Status Updates**
-Update Grubtech when orders are accepted, prepared, or delivered.
-
-**Ask Claude:** *"Show me how to update order status"*
-
-### 5. **Item Availability**
-Toggle menu items on/off when they're out of stock.
-
-**Ask Claude:** *"How do I mark items as unavailable?"*
-
----
-
-## 📚 Available Code Templates
-
-20 production-ready templates for common operations:
-
-| Operation | TypeScript | Python | Java | cURL |
-|-----------|:----------:|:------:|:----:|:----:|
-| **Authentication** | ✅ | ✅ | ✅ | ✅ |
-| **Menu Sync** | ✅ | ✅ | ✅ | ✅ |
-| **Order Receive** | ✅ | ✅ | ✅ | ✅ |
-| **Order Status** | ✅ | ✅ | ✅ | ✅ |
-| **Item Availability** | ✅ | ✅ | ✅ | ✅ |
-
-Each template includes:
-- ✅ Complete working code
-- ✅ Error handling and logging
-- ✅ Type definitions (TypeScript/Python/Java)
-- ✅ Inline documentation
-- ✅ Placeholder markers for your credentials
-- ✅ Example usage
-
----
-
-## 🔐 Privacy & Security
-
-- **100% Local** - All processing happens on your machine
-- **No Data Collection** - Zero telemetry or analytics
-- **No External API Calls** - Works offline (after initial doc scraping)
-- **Open Source** - Audit the code yourself
-- **No API Keys Required** - Templates use placeholders for your keys
-
-Your code and credentials **never leave your machine**.
-
----
+**Learn more:**
+- Website: https://www.grubtech.com
+- Documentation: https://docs.grubtech.io
+- Support: support@grubtech.io
 
-## 🆘 Getting Help
-
-### Within Claude Code
-Just ask! The AI agents can help with:
-- API questions
-- Code errors
-- Integration planning
-- Best practices
-
-### External Resources
-- 📚 Grubtech API Docs: https://docs.grubtech.io
-- 🌐 Grubtech Website: https://www.grubtech.com
-- 📧 Email Support: support@grubtech.io
-
-### Common Questions
-
-**Q: Do I need a Grubtech account?**
-A: Yes, you'll need API credentials from Grubtech. Contact support@grubtech.io to get started.
-
-**Q: Which programming language should I use?**
-A: Use whatever your existing system is built with. This tool supports TypeScript, Python, Java, and cURL.
-
-**Q: Is this tool official from Grubtech?**
-A: This is a developer tool built to help with Grubtech integrations. For official support, contact Grubtech directly.
-
-**Q: Do I need to know Grubtech APIs beforehand?**
-A: No! The AI agents guide you through everything. Start with the BA Agent to learn the basics.
-
----
-
-## 🚀 What You Can Build
-
-Examples of integrations developers have built:
-
-- **Restaurant POS Systems** - Sync menus, receive orders, update status
-- **Delivery Management Platforms** - Route orders, track deliveries, update statuses
-- **Kitchen Display Systems** - Receive orders, mark as prepared
-- **Inventory Management** - Update item availability based on stock
-- **Custom Ordering Websites** - Pull menus, create orders, track status
-- **Multi-Brand Aggregators** - Manage menus across multiple virtual brands
-
----
-
-## 📝 Typical Integration Workflow
-
-### Phase 1: Planning (Use BA Agent)
-1. Ask: *"Help me plan my integration"*
-2. Answer discovery questions about your system
-3. Review generated requirements document
-
-### Phase 2: Setup
-1. Get API credentials from Grubtech
-2. Set up authentication
-3. Test connectivity
-
-### Phase 3: Implementation (Use Developer Agent)
-1. Implement menu synchronization
-2. Set up order webhook receiver
-3. Implement order status updates
-4. Add item availability management
-
-### Phase 4: Testing
-1. Test in Grubtech sandbox environment
-2. Validate data flows
-3. Handle edge cases
-
-### Phase 5: Go-Live
-1. Complete Grubtech certification
-2. Deploy to production
-3. Monitor integration health
-
-**💡 The AI agents guide you through each phase!**
-
----
-
-## 💻 Example Session
-
-```
-You: Help me start a POS integration with Grubtech
-
-BA Agent: I'll help you plan this integration. Let me ask a few questions:
-
-1. What type of system are you integrating?
-   - POS System, Delivery Platform, Kitchen Display, or Other?
-
-2. What's your tech stack?
-   - Language/framework you're using?
-
-3. What capabilities do you need?
-   - Menu sync, order receiving, status updates?
-
-[You answer the questions...]
-
-BA Agent: Based on your requirements, I've created a comprehensive
-integration plan. See docs/integration-requirements.md
-
-Next step: Switch to "Developer Agent" to start implementation.
-
----
-
-You: [Switch to Developer Agent]
-    I have the requirements document. Let's start with authentication.
-
-Developer Agent: I'll generate TypeScript authentication code for you.
-[Provides complete working code with error handling...]
-```
-
----
-
-## 🌟 Why Use This Tool?
-
-### Without This Tool:
-- ⏰ Spend hours searching documentation
-- 📄 Copy/paste code examples that don't quite fit
-- ❓ Get stuck on API errors with unclear messages
-- 🔄 Repeatedly ask the same questions
-
-### With This Tool:
-- ⚡ Get instant answers in Claude Code
-- 💻 Generate code tailored to your language
-- 🤖 AI agents guide you step-by-step
-- 📚 Smart search finds exactly what you need
-
-**Result:** Build integrations **5-10x faster** with fewer errors.
-
----
-
-## 📄 License
-
-MIT © Grubtech
-
-Free to use for commercial and personal projects.
-
----
-
-## 🔗 Links
-
-- **Grubtech Website:** https://www.grubtech.com
-- **API Documentation:** https://docs.grubtech.io
-- **Email Support:** support@grubtech.io
-- **NPM Package:** https://www.npmjs.com/package/@chanaka_nakandala/integration-agent
-
----
-
-## 🎉 Ready to Start?
-
-Install with ONE command:
-
-```bash
-npx @chanaka_nakandala/integration-agent init
-```
+## Getting Help
 
-Then restart Claude Code and start building! 🚀
+Just ask questions inside Claude Code after installation, or contact Grubtech support at support@grubtech.io
 
 ---
 
-**Built for external developers integrating with Grubtech APIs**
-*Questions? Ask the AI agents in Claude Code or contact support@grubtech.io*
+© 2025 Grubtech. All rights reserved.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chanaka_nakandala/integration-agent",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "One-command installer that sets up the complete Grubtech Integration Agent (MCP server + AI agent personas) for Claude Code to help developers build restaurant and POS integrations.",
   "type": "module",
   "main": "./dist/index.js",
@@ -56,7 +56,7 @@
   "author": "Grubtech <support@grubtech.io>",
   "license": "MIT",
   "dependencies": {
-    "@chanaka_nakandala/integration-personas": "^1.0.0"
+    "@chanaka_nakandala/integration-personas": "^1.0.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",