{
  "markdown": "# GrappleAI - Active Defense Layer for Consumers\n\nAn AI-driven dispute resolution platform built with React frontend and AWS CDK Lambda backend. GrappleAI advocates for consumers in post-purchase disputes using autonomous agents and the Model Context Protocol (MCP).\n\n## 🚀 Quick Start\n\nGet up and running in 5 minutes:\n\n```bash\n# Frontend\ncd app && npm install && npm run dev\n\n# Backend (separate terminal)\ncd backend && npm install && npm run cdk:deploy\n```\n\nSee [QUICKSTART.md](./QUICKSTART.md) for detailed instructions.\n\n## 📚 Documentation\n\n### Getting Started\n- **[Quick Start Guide](./QUICKSTART.md)** - Get running in 5 minutes\n- **[Complete Setup Guide](./SETUP.md)** - Detailed setup instructions\n- **[Project Overview](./PROJECT_OVERVIEW.md)** - Architecture and features\n\n### Methodology & Vision\n- **[AI-DLC Methodology](./SDLC%20to%20AIDLC/AIDLC.md)** - AI-Driven Development Life Cycle\n- **[Traditional SDLC](./SDLC%20to%20AIDLC/SDLC.md)** - SDLC vs AIDLC comparison\n- **[GrappleAI Concept](./ProblemStatement.md)** - Problem statement and vision\n- **[AI-DLC Details](./AI-DLC/AI-DLC.md)** - Active Defense Layer for Consumers\n\n### Component Documentation\n- **[Frontend README](./app/README.md)** - React app details\n- **[Backend README](./backend/README.md)** - AWS CDK backend details\n\n## 🏗️ Architecture\n\n```\nReact Frontend (Vite)\n        ↓ HTTP/REST\nAPI Gateway (AWS)\n        ↓\nLambda Function (Node.js 20.x)\n        ├─ MCP Server\n        ├─ Request Handler\n        └─ Business Logic\n        ↓\n    ┌───┴───┬────────┐\n    ↓       ↓        ↓\nDynamoDB  S3      DynamoDB\nDisputes  Evidence Negotiations\n```\n\n## ✨ Features\n\n- **Dispute Management** - Create, track, and manage disputes\n- **Evidence Verification** - Automatic confidence scoring and secure storage\n- **Autonomous Negotiation** - AI-driven negotiation with sellers\n- **Consumer Rights** - Consumer Protection Act 2019 integration\n- **Dashboard Analytics** - Real-time dispute statistics\n- **Multi-language Support** - Vernacular interface support\n\n## 🛠️ Tech Stack\n\n### Frontend\n- React 18 + TypeScript\n- Vite (build tool)\n- Tailwind CSS (styling)\n- Zustand (state management)\n- React Router (navigation)\n\n### Backend\n- AWS CDK (infrastructure as code)\n- AWS Lambda (serverless compute)\n- AWS API Gateway (REST API)\n- AWS DynamoDB (database)\n- AWS S3 (storage)\n- Node.js 20.x\n\n## 📁 Project Structure\n\n```\ngrappleai/\n├── app/                    # React frontend\n│   ├── src/\n│   │   ├── components/    # React components\n│   │   ├── pages/         # Page components\n│   │   ├── services/      # API client\n│   │   ├── store/         # State management\n│   │   └── types/         # TypeScript types\n│   └── package.json\n│\n├── backend/               # AWS CDK backend\n│   ├── lib/\n│   │   ├── cdk/          # CDK stack\n│   │   ├── lambda/       # Lambda handler\n│   │   ├── mcp/          # MCP server\n│   │   └── types/        # TypeScript types\n│   └── package.json\n│\n├── SDLC to AIDLC/        # Methodology docs\n│   ├── AIDLC.md\n│   └── SDLC.md\n│\n├── AI-DLC/               # AI-DLC documentation\n│   └── AI-DLC.md\n│\n├── QUICKSTART.md         # 5-minute setup\n├── SETUP.md              # Complete setup guide\n├── PROJECT_OVERVIEW.md   # Architecture overview\n└── README.md             # This file\n```\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js 18+\n- AWS Account\n- AWS CLI configured\n\n### Frontend Setup\n```bash\ncd app\nnpm install\nnpm run dev\n```\n\nVisit: `http://localhost:5173`\n\n### Backend Setup\n```bash\ncd backend\nnpm install\nnpm run cdk:deploy\n```\n\n### Connect Frontend to Backend\nUpdate `app/.env.local`:\n```\nVITE_API_URL=https://your-api-endpoint.com/api\n```\n\n## 📖 API Endpoints\n\n### Disputes\n- `POST /disputes` - Create dispute\n- `GET /disputes` - List disputes\n- `GET /disputes/{id}` - Get dispute details\n- `PUT /disputes/{id}` - Update dispute\n\n### Evidence\n- `POST /evidence/upload` - Upload evidence\n- `GET /evidence/{id}` - Get evidence\n- `POST /evidence/{id}/verify` - Verify evidence\n\n### Negotiation\n- `POST /negotiation/initiate` - Start negotiation\n- `GET /negotiation/{txId}` - Get status\n\n## 🔧 MCP Server Tools\n\nThe backend implements these MCP tools:\n\n1. **secureEvidence** - Clutch evidence securely with confidence scoring\n2. **negotiateRefund** - Initiate autonomous negotiation\n3. **generateDisputeNotice** - Generate formal dispute notice\n4. **verifyConsumerRights** - Verify Consumer Protection Act rights\n\n## 📊 Dashboard Features\n\n- **Statistics** - Total disputes, resolved, in-progress, success rate\n- **Dispute List** - View all disputes with status indicators\n- **Create Dispute** - File new disputes with evidence\n- **Real-time Updates** - Track dispute progress\n\n## 🔐 Security\n\n- JWT/OAuth2 ready\n- Input validation\n- IAM roles with least privilege\n- Encryption at rest and in transit\n- CORS enabled\n- API rate limiting ready\n\n## 📈 Performance\n\n- Frontend: ~50KB gzipped\n- Lambda: 512MB memory, 30s timeout\n- DynamoDB: On-demand billing\n- API: <100ms response time\n\n## 💰 Cost Estimation\n\n**Monthly (small-medium usage):**\n- Lambda: $0.20 per 1M requests\n- DynamoDB: $1.25 per 100 write units\n- S3: $0.023 per GB\n- API Gateway: $3.50 per 1M requests\n- **Total: ~$50-200/month**\n\n## 🧪 Development\n\n### Frontend Commands\n```bash\nnpm run dev          # Start dev server\nnpm run build        # Build for production\nnpm run lint         # Run linter\nnpm run type-check   # Check types\n```\n\n### Backend Commands\n```bash\nnpm run build        # Compile TypeScript\nnpm run cdk:deploy   # Deploy to AWS\nnpm run cdk:destroy  # Destroy stack\nnpm run cdk:diff     # Preview changes\n```\n\n## 🚢 Deployment\n\n### Frontend\n- Vercel: `vercel deploy`\n- Netlify: `netlify deploy --prod --dir=dist`\n- AWS S3: `aws s3 sync dist/ s3://bucket/`\n\n### Backend\n```bash\ncd backend\nnpm run cdk:deploy\n```\n\n## 📚 Learn More\n\n- [AWS CDK Documentation](https://docs.aws.amazon.com/cdk/)\n- [React Documentation](https://react.dev)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n- [Consumer Protection Act 2019](https://consumeraffairs.gov.in)\n\n## 🤝 Contributing\n\n1. Create feature branch\n2. Make changes\n3. Run linter and type-check\n4. Submit PR\n\n## 📄 License\n\nMIT\n\n## 🎯 Vision\n\nGrappleAI is building the trust layer for India's digital economy. By combining AI, law, and technology, we're creating an active advocate for every consumer—ensuring that disputes are resolved fairly, quickly, and in the consumer's preferred language.\n\n---\n\n**Ready to build?** Start with [QUICKSTART.md](./QUICKSTART.md)!\n\n*GrappleAI - Active Defense Layer for Consumers*\n*Building trust in India's digital economy, one dispute at a time.*\n",
  "bytes": 6632,
  "sha": "72bfdf8cb6ccc99d5fc05159094fd814a116d48ae42afb169a1edb5029a7190c",
  "repo_slug": "kambleaa007/grappleai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kambleaa007_weather_d70bd51e/readme"
}