rails_ai 0.1.0

data/COMMERCIAL_LICENSE_TEMPLATE.md

@@ -0,0 +1,92 @@
+# Commercial License Agreement - Rails AI
+
+## License Terms for Commercial Use
+
+This Commercial License Agreement ("Agreement") is entered into between:
+
+**Licensor**: Daniel Amah  
+**Address**: [Your Address, City, Province, Canada]  
+**Email**: amahdanieljack@gmail.com  
+**Software**: Rails AI (the "Software")
+
+**Licensee**: [Company Name]  
+**Address**: [Company Address]  
+**Email**: [licensee-email@example.com]  
+**Intended Use**: [Description of commercial use]
+
+## Terms and Conditions
+
+### 1. Grant of License
+Subject to the terms and conditions of this Agreement, Licensor hereby grants to Licensee a non-exclusive, non-transferable license to use the Software for commercial purposes for a period of one (1) year from the license start date.
+
+### 2. Permitted Uses
+Licensee may:
+- Use the Software in commercial applications
+- Integrate the Software into commercial products
+- Use the Software for revenue-generating activities
+- Distribute the Software as part of commercial products (with proper attribution)
+
+### 3. Restrictions
+Licensee may not:
+- Remove or modify copyright notices
+- Reverse engineer the Software for competitive purposes
+- Sublicense the Software without written permission
+- Use the Software in violation of applicable laws
+- Use the Software beyond the scope of this license
+
+### 4. License Fee
+Annual commercial license fee: $999 CAD per year
+Payment terms: Annual payment due on license anniversary date
+Currency: Canadian Dollars (CAD)
+Renewal: License must be renewed annually to maintain commercial use rights
+
+### 5. Support and Updates
+- [X] Included in annual license fee
+- [X] Updates included for the duration of the license
+- [X] Email support included
+- [X] Priority support for commercial licensees
+
+### 6. License Renewal
+- License expires one year from the start date
+- Renewal fee of $999 CAD is due annually
+- 30-day grace period for renewal payments
+- License becomes invalid if not renewed within grace period
+
+### 7. Warranty and Liability
+The Software is provided "as is" without warranty. Licensor's liability is limited to the annual license fee paid.
+
+### 8. Termination
+This license may be terminated if Licensee breaches any terms or fails to pay renewal fees. Upon termination, Licensee must cease all use of the Software immediately.
+
+### 9. Governing Law and Jurisdiction
+This Agreement is governed by the laws of Canada and the Province of [Your Province]. Any disputes shall be resolved in the courts of [Your Province], Canada. Licensee consents to the jurisdiction of Canadian courts.
+
+### 10. Enforcement and Remedies
+In case of breach, Licensor reserves the right to:
+- Seek injunctive relief to stop unauthorized use
+- Pursue monetary damages including lost licensing revenue
+- Recover attorney's fees and court costs
+- Seek statutory damages under the Canadian Copyright Act
+- Pursue criminal charges if applicable
+
+### 11. Audit Rights
+Licensor reserves the right to audit Licensee's use of the Software to ensure compliance with this Agreement.
+
+## Signature
+
+**Licensor**: Daniel Amah  
+**Address**: [Your Address]  
+**Email**: amahdanieljack@gmail.com  
+**Date**: _________
+
+**Licensee**: _________________________  
+**Address**: _________________________  
+**Email**: _________________________  
+**Date**: _________
+
+---
+
+**Contact for Commercial Licensing**: amahdanieljack@gmail.com
+**Subject**: Commercial License Inquiry - Rails AI
+**License Start Date**: _________
+**License Expiry Date**: _________

data/FEATURES.md

@@ -0,0 +1,204 @@
+# Rails AI - Complete Feature List
+
+## 🎯 Core AI Capabilities
+
+### Text-Based Operations
+- ✅ **Chat Interface** - `RailsAi.chat(prompt)`
+- ✅ **Streaming Chat** - `RailsAi.stream(prompt) { |token| ... }`
+- ✅ **Text Embeddings** - `RailsAi.embed(texts)`
+- ✅ **Content Summarization** - `RailsAi.summarize(content)`
+- ✅ **Translation** - `RailsAi.translate(content, language)`
+- ✅ **Classification** - `RailsAi.classify(content, categories)`
+- ✅ **Entity Extraction** - `RailsAi.extract_entities(content)`
+- ✅ **Code Generation** - `RailsAi.generate_code(prompt, language)`
+- ✅ **Code Explanation** - `RailsAi.explain_code(code, language)`
+
+### Image Operations
+- ✅ **Image Generation** - `RailsAi.generate_image(prompt)`
+- ✅ **Image Editing** - `RailsAi.edit_image(image, prompt)`
+- ✅ **Image Variations** - `RailsAi.create_variation(image)`
+- ✅ **Image Analysis** - `RailsAi.analyze_image(image, prompt)`
+
+### Video Operations
+- ✅ **Video Generation** - `RailsAi.generate_video(prompt, duration)`
+- ✅ **Video Editing** - `RailsAi.edit_video(video, prompt)`
+- ✅ **Video Analysis** - `RailsAi.analyze_video(video, prompt)`
+
+### Audio Operations
+- ✅ **Speech Generation** - `RailsAi.generate_speech(text, voice)`
+- ✅ **Audio Transcription** - `RailsAi.transcribe_audio(audio)`
+
+## 🧠 Context-Aware Intelligence
+
+### Context Types
+- ✅ **User Context** - ID, email, role, preferences, timestamps
+- ✅ **Window Context** - Controller, action, params, request details
+- ✅ **Image Context** - Source, format, dimensions, metadata
+- ✅ **Temporal Context** - Current time, environment, Rails version
+
+### Context-Aware Methods
+- ✅ **Context Image Analysis** - `RailsAi.analyze_image_with_context(image, prompt, contexts)`
+- ✅ **Context Text Generation** - `RailsAi.generate_with_context(prompt, contexts)`
+- ✅ **Context Image Generation** - `RailsAi.generate_image_with_context(prompt, contexts)`
+
+## 🔌 Provider System
+
+### Built-in Providers
+- ✅ **OpenAI Adapter** - Full OpenAI API support
+- ✅ **Dummy Adapter** - Testing and development
+- ✅ **Base Provider** - Extensible provider interface
+
+### Provider Features
+- ✅ **Chat Completion** - Text generation and conversation
+- ✅ **Streaming** - Real-time token streaming
+- ✅ **Embeddings** - Vector embeddings for search
+- ✅ **Image Generation** - DALL-E integration
+- ✅ **Image Editing** - Image modification capabilities
+- ✅ **Audio Generation** - Text-to-speech synthesis
+- ✅ **Audio Transcription** - Speech-to-text conversion
+
+## 🚀 Rails Integration
+
+### Generators
+- ✅ **Install Generator** - `rails generate rails_ai:install`
+- ✅ **Feature Generator** - `rails generate rails_ai:feature name`
+- ✅ **Template System** - Customizable generator templates
+
+### View Components
+- ✅ **Prompt Component** - `RailsAi::PromptComponent`
+- ✅ **AI Widgets** - Reusable UI components
+- ✅ **Form Helpers** - AI-powered form elements
+
+### Controller Integration
+- ✅ **Context Aware Concern** - `RailsAi::ContextAware`
+- ✅ **Streaming Concern** - `RailsAi::Streaming`
+- ✅ **Helper Methods** - Convenient AI operations
+
+### Model Integration
+- ✅ **Embeddable Concern** - `RailsAi::Embeddable`
+- ✅ **Semantic Search** - Vector-based similarity search
+- ✅ **AI Methods** - Model-level AI operations
+
+### Job Integration
+- ✅ **Background Processing** - AI operations in jobs
+- ✅ **Queue Management** - Configurable job queues
+- ✅ **Error Handling** - Robust error management
+
+### Action Cable
+- ✅ **Real-time Streaming** - Live AI responses
+- ✅ **Channel Management** - `RailsAi::AiStreamChannel`
+- ✅ **Broadcasting** - Multi-user streaming support
+
+## 🛠️ Developer Experience
+
+### Configuration
+- ✅ **Flexible Config** - `RailsAi.configure` block
+- ✅ **Environment Support** - Development, test, production
+- ✅ **Provider Selection** - Easy provider switching
+- ✅ **Model Configuration** - Custom model selection
+
+### Caching
+- ✅ **Intelligent Caching** - Automatic response caching
+- ✅ **TTL Configuration** - Configurable cache expiration
+- ✅ **Cache Keys** - Smart cache key generation
+- ✅ **Cache Invalidation** - Context-aware invalidation
+
+### Security
+- ✅ **Content Redaction** - PII filtering
+- ✅ **Parameter Sanitization** - Sensitive data removal
+- ✅ **API Key Management** - Secure credential handling
+- ✅ **Input Validation** - Safe content processing
+
+### Observability
+- ✅ **Event Logging** - `RailsAi::Events.log!`
+- ✅ **Metrics Collection** - Performance monitoring
+- ✅ **Error Tracking** - Comprehensive error handling
+- ✅ **Debug Support** - Development debugging tools
+
+## 🧪 Testing & Quality
+
+### Test Support
+- ✅ **RSpec Integration** - Comprehensive test suite
+- ✅ **Dummy Providers** - Test-friendly providers
+- ✅ **Mock Support** - Easy mocking and stubbing
+- ✅ **Test Helpers** - Convenient test utilities
+
+### Code Quality
+- ✅ **StandardRB** - Code style enforcement
+- ✅ **RuboCop** - Additional linting
+- ✅ **CI/CD** - Automated testing pipeline
+- ✅ **Documentation** - Comprehensive docs
+
+### Performance
+- ✅ **Memory Optimization** - Efficient memory usage
+- ✅ **Response Caching** - Fast response times
+- ✅ **Background Jobs** - Non-blocking operations
+- ✅ **Streaming** - Real-time user experience
+
+## 🔄 Rails Version Support
+
+### Compatibility
+- ✅ **Rails 5.2+** - Full backward compatibility
+- ✅ **Rails 6.0, 6.1** - Enhanced features
+- ✅ **Rails 7.0, 7.1** - Importmap support
+- ✅ **Rails 8.0** - Latest features and performance
+
+### Ruby Support
+- ✅ **Ruby 3.x** - Primary target
+- ✅ **Ruby 2.7+** - Backward compatibility
+
+## 📊 Use Cases
+
+### Content Creation
+- ✅ **Blog Writing** - Automated content generation
+- ✅ **Product Descriptions** - E-commerce content
+- ✅ **Marketing Copy** - Advertising content
+- ✅ **Social Media** - Platform-specific content
+
+### Visual Content
+- ✅ **Image Generation** - Custom artwork and photos
+- ✅ **Thumbnail Creation** - Automated image processing
+- ✅ **Video Production** - Short-form video content
+- ✅ **Image Analysis** - Content understanding
+
+### Code Assistance
+- ✅ **Code Generation** - Automated coding
+- ✅ **Code Review** - Quality analysis
+- ✅ **Documentation** - Auto-generated docs
+- ✅ **Debugging** - Error analysis and fixes
+
+### Data Processing
+- ✅ **Text Analysis** - Sentiment, classification
+- ✅ **Entity Extraction** - Information extraction
+- ✅ **Translation** - Multi-language support
+- ✅ **Summarization** - Content condensation
+
+### Customer Support
+- ✅ **Chatbots** - Automated customer service
+- ✅ **FAQ Generation** - Knowledge base creation
+- ✅ **Ticket Routing** - Intelligent categorization
+- ✅ **Response Generation** - Automated responses
+
+## 🎨 Advanced Features
+
+### Multimodal AI
+- ✅ **Cross-Modal Operations** - Text + Image + Video
+- ✅ **Context Bridging** - Seamless modality switching
+- ✅ **Unified Interface** - Single API for all operations
+
+### Real-time Features
+- ✅ **Live Streaming** - Real-time AI responses
+- ✅ **WebSocket Support** - Bidirectional communication
+- ✅ **Progress Tracking** - Operation status updates
+
+### Enterprise Features
+- ✅ **Scalability** - High-performance processing
+- ✅ **Reliability** - Robust error handling
+- ✅ **Security** - Enterprise-grade security
+- ✅ **Monitoring** - Comprehensive observability
+
+---
+
+**Total Features: 100+** 🚀
+
+Rails AI provides everything you need to build AI-powered Rails applications with confidence and ease!

data/LEGAL_PROTECTION_GUIDE.md

@@ -0,0 +1,222 @@
+# Legal Protection Guide for Rails AI - Canada
+
+## 🛡️ How to Protect Your Intellectual Property in Canada
+
+### 1. Copyright Registration (CRITICAL)
+
+**Why Register:**
+- Provides prima facie evidence of ownership
+- Enables statutory damages (up to $20,000 per work)
+- Allows recovery of attorney's fees
+- Required for certain legal remedies
+
+**How to Register:**
+1. Visit: https://ised-isde.canada.ca/site/canadian-intellectual-property-office/en/copyright
+2. File Form 1: Application for Registration of Copyright
+3. Pay fee: $50 CAD per work
+4. Submit source code and documentation
+5. Keep registration certificate
+
+**What to Register:**
+- Main Rails AI codebase
+- Documentation
+- Each major version/release
+- Agent AI system components
+
+### 2. Trademark Protection
+
+**Consider Registering:**
+- "Rails AI" as a trademark
+- Logo/design marks
+- Domain names
+
+**Process:**
+1. Search existing trademarks: https://www.ic.gc.ca/app/opic-cipo/trdmrks/srch/home
+2. File application with CIPO
+3. Fee: $200+ CAD
+
+### 3. Legal Documentation
+
+**Essential Documents:**
+- Copyright registration certificates
+- License agreements (signed copies)
+- Cease and desist letter templates
+- DMCA takedown notice templates
+- Legal notices for your website
+
+### 4. Monitoring and Detection
+
+**How to Find Unauthorized Use:**
+- Google Alerts for "Rails AI" + commercial terms
+- GitHub searches for your code
+- Regular web searches
+- Code plagiarism detection tools
+- Social media monitoring
+
+**Red Flags to Watch For:**
+- Companies using your gem in commercial products
+- Code copied without attribution
+- Modified versions being sold
+- API services using your code
+
+### 5. Legal Action Process
+
+**Step 1: Cease and Desist Letter**
+```
+Subject: Cease and Desist - Unauthorized Use of Rails AI
+
+Dear [Company],
+
+We have discovered that your company is using Rails AI software 
+without proper licensing. This constitutes copyright infringement.
+
+You must:
+1. Cease all use immediately
+2. Remove all copies from your systems
+3. Pay licensing fees for past use
+4. Sign proper license agreement for future use
+
+Failure to comply will result in legal action.
+
+Contact: amahdanieljack@gmail.com
+```
+
+**Step 2: DMCA Takedown (for online platforms)**
+- GitHub, GitLab, etc.
+- Package repositories (RubyGems)
+- Code sharing sites
+
+**Step 3: Legal Action**
+- Small claims court (under $35,000)
+- Provincial court (higher amounts)
+- Federal court (copyright cases)
+
+### 6. Evidence Collection
+
+**Document Everything:**
+- Screenshots of unauthorized use
+- Website archives (Wayback Machine)
+- Email communications
+- License agreements
+- Payment records
+- Usage analytics
+
+**Timeline Documentation:**
+- When you created the code
+- When you published it
+- When you discovered infringement
+- All communications
+
+### 7. Canadian Copyright Act Benefits
+
+**Statutory Damages:**
+- $500 - $20,000 per work (commercial infringement)
+- $100 - $5,000 per work (non-commercial)
+- No need to prove actual damages
+
+**Other Remedies:**
+- Injunctions to stop use
+- Account of profits
+- Delivery up of infringing copies
+- Attorney's fees (in some cases)
+
+### 8. Practical Enforcement Steps
+
+**Immediate Actions:**
+1. Register copyright immediately
+2. Add clear license notices to all code
+3. Include license in package metadata
+4. Add legal notices to documentation
+5. Monitor usage regularly
+
+**When You Find Infringement:**
+1. Document everything
+2. Send cease and desist letter
+3. File DMCA takedowns
+4. Consider legal action if necessary
+5. Keep records of all communications
+
+### 9. Website Legal Notices
+
+**Add to Your Website:**
+```
+LEGAL NOTICE
+
+Rails AI is protected by Canadian copyright law.
+Commercial use requires a license agreement.
+Unauthorized commercial use is strictly prohibited.
+
+For licensing inquiries: amahdanieljack@gmail.com
+```
+
+### 10. Insurance Considerations
+
+**Consider Getting:**
+- Professional liability insurance
+- Intellectual property insurance
+- Legal expense insurance
+
+### 11. Legal Resources in Canada
+
+**Government Resources:**
+- Canadian Intellectual Property Office (CIPO)
+- Copyright Board of Canada
+- Competition Bureau
+
+**Legal Aid:**
+- Pro Bono legal services
+- Law school clinics
+- Legal aid societies
+
+**Professional Help:**
+- Intellectual property lawyers
+- Copyright specialists
+- Technology law firms
+
+### 12. International Protection
+
+**Consider:**
+- WIPO copyright registration
+- International trademark registration
+- Cross-border enforcement agreements
+
+## 🚨 Emergency Response Plan
+
+**If You Discover Major Infringement:**
+
+1. **Immediate (Same Day):**
+   - Document everything with screenshots
+   - Save evidence to multiple locations
+   - Send cease and desist letter
+   - File DMCA takedowns
+
+2. **Within 48 Hours:**
+   - Consult with IP lawyer
+   - Assess damages and scope
+   - Prepare legal strategy
+   - Send formal legal notice
+
+3. **Within 1 Week:**
+   - File copyright infringement lawsuit if necessary
+   - Seek injunctive relief
+   - Notify relevant authorities
+   - Public disclosure if appropriate
+
+## 📞 Emergency Contacts
+
+**Legal Help:**
+- Law Society of [Your Province] referral service
+- Canadian Bar Association
+- Local IP law firms
+
+**Government:**
+- CIPO: 1-866-997-1936
+- Copyright Board: 613-952-8621
+
+**Your Information:**
+- Email: amahdanieljack@gmail.com
+- Keep this guide updated with your specific details
+
+---
+
+**Remember:** Copyright protection is automatic in Canada, but registration significantly strengthens your legal position. Act quickly when you discover infringement, and always document everything!

data/LICENSE

@@ -0,0 +1,62 @@
+MIT License with Non-Commercial Use Restriction
+
+Copyright (c) 2025 Daniel Amah (Rails AI)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software for NON-COMMERCIAL PURPOSES ONLY, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, and sublicense copies of the Software
+for non-commercial purposes, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in all
+   copies or substantial portions of the Software.
+
+2. COMMERCIAL USE RESTRICTION: This software may NOT be used for commercial purposes
+   without the express written permission of the copyright holder. Commercial use
+   includes, but is not limited to:
+   - Use in commercial software products
+   - Use in commercial web applications
+   - Use in commercial services or platforms
+   - Use in any context where the software generates revenue or commercial value
+   - Use by commercial entities for business operations
+   - Integration into any product or service offered for sale
+   - Use in any business that generates income or profit
+   - Selling, licensing, or distributing the Software for commercial purposes
+
+3. For commercial use, you must:
+   - Contact the copyright holder at amahdanieljack@gmail.com
+   - Obtain explicit written permission via signed license agreement
+   - Agree to all terms and conditions set by the copyright holder
+   - Pay the required annual licensing fee of $999 per year
+   - Provide proof of payment before commercial use begins
+
+4. Non-commercial use (personal projects, educational purposes, open source projects
+   that are not commercial) is permitted under the standard MIT license terms.
+
+5. Forking and contributing to the open source project is permitted for
+   non-commercial purposes only.
+
+6. ENFORCEMENT: Unauthorized commercial use constitutes copyright infringement
+   and breach of contract. The copyright holder reserves all rights to pursue
+   legal action, including but not limited to:
+   - Injunctive relief to stop unauthorized use
+   - Monetary damages including lost licensing revenue
+   - Attorney's fees and court costs
+   - Statutory damages under Canadian Copyright Act
+
+7. JURISDICTION: This license is governed by the laws of Canada and the
+   Province of [Your Province]. Any disputes shall be resolved in the courts
+   of [Your Province], Canada.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+For commercial licensing inquiries, please contact:
+Email: amahdanieljack@gmail.com
+Subject: Commercial License Inquiry - Rails AI

data/LICENSE_SUMMARY.md

@@ -0,0 +1,74 @@
+# Rails AI License Summary
+
+## 🚫 **COMMERCIAL USE PROHIBITED**
+
+**This software is NOT for commercial use without explicit permission.**
+
+## ✅ **ALLOWED USES**
+
+### **Personal Use** ✅
+- Personal projects
+- Learning and education
+- Non-commercial experimentation
+- Individual development
+
+### **Open Source Use** ✅
+- Contributing to open source projects
+- Forking for non-commercial purposes
+- Educational institutions (non-commercial)
+- Research projects (non-commercial)
+
+## ❌ **PROHIBITED USES**
+
+### **Commercial Use** ❌
+- Commercial software products
+- Commercial web applications
+- Commercial services or platforms
+- Any revenue-generating use
+- Business operations
+- Products or services offered for sale
+- Any income or profit-generating activity
+
+## �� **COMMERCIAL LICENSING**
+
+### **To Use Commercially:**
+1. **Contact**: amahdanieljack@gmail.com
+2. **Subject**: Commercial License Inquiry - Rails AI
+3. **Fee**: $999 per year
+4. **Process**: Signed license agreement required
+
+### **Commercial License Includes:**
+- Full commercial use rights
+- Priority support
+- Updates and patches
+- Legal protection
+- Commercial documentation
+
+## ⚖️ **LEGAL ENFORCEMENT**
+
+### **Unauthorized Commercial Use:**
+- **Copyright Infringement**: Legal action will be taken
+- **Monetary Damages**: Lost licensing revenue + costs
+- **Injunctive Relief**: Immediate stop to unauthorized use
+- **Canadian Law**: Governed by Canadian Copyright Act
+
+### **Your Rights:**
+- **Fork**: Yes, for non-commercial purposes
+- **Contribute**: Yes, to open source projects
+- **Modify**: Yes, for personal use
+- **Distribute**: Yes, with license intact
+
+## 📞 **CONTACT**
+
+**For Commercial Licensing:**
+- **Email**: amahdanieljack@gmail.com
+- **Subject**: Commercial License Inquiry - Rails AI
+- **Response Time**: Within 24 hours
+
+**For Questions:**
+- **Email**: amahdanieljack@gmail.com
+- **Subject**: License Question - Rails AI
+
+---
+
+**Remember**: This is a non-commercial license. Commercial use requires explicit permission and payment of the annual licensing fee.