claudetools/projects/msp-tools/README.md

# MSP Tools Project

**Location:** `D:\ClaudeTools\projects\msp-tools\`
**Status:** Active Development
**Last Updated:** 2026-01-17

---

## Overview

MSP Tools is a collection of Managed Service Provider (MSP) infrastructure and integration projects. This directory contains conversation archives from the development of two key MSP systems:

1. **guru-rmm** - Remote Monitoring and Management system
2. **guru-connect** - MSP connectivity and integration platform

---

## Project Statistics

**Total Files:** 94 JSONL conversation files
**Total Size:** 20.1 MB
**Original Import Date:** 2026-01-17
**Moved to Projects:** 2026-01-17

---

## Subprojects

### guru-rmm (54 files, 14 MB)

**Description:** Remote Monitoring and Management (RMM) system development

**Original Source:** `C:\Users\MikeSwanson\.claude\projects\C--Users-MikeSwanson-claude-projects-gururmm-guru-rmm`

**Purpose:** Core MSP infrastructure tool for monitoring and managing client systems

**Key Development Topics:**
- RMM system architecture and design
- Monitoring agent development
- Alert and notification systems
- Client system inventory management
- Performance monitoring dashboards
- Agent deployment strategies
- Data collection and reporting
- Integration with ticketing systems

**Technology Focus:**
- System monitoring frameworks
- Agent-based architecture
- Real-time data collection
- Database design for metrics
- API development for integrations

---

### guru-connect (40 files, 6.1 MB)

**Description:** MSP connectivity and integration platform

**Original Source:** `C:\Users\MikeSwanson\.claude\projects\C--Users-MikeSwanson-claude-projects-guru-connect`

**Purpose:** Connectivity layer for integrating various MSP tools and services

**Key Development Topics:**
- API integration patterns
- Service orchestration
- Client portal development
- Third-party service connections
- Authentication and authorization
- Webhook handling
- Data synchronization
- Multi-tenant architecture

**Technology Focus:**
- API gateway design
- OAuth/SSO integration
- Message queuing
- Microservices architecture
- Integration middleware

---

## File Format

All files are in JSONL (JSON Lines) format:
- **Format:** Newline-delimited JSON
- **Extension:** `.jsonl`
- **Encoding:** UTF-8
- **Structure:** Each line = one conversation message
- **Usage:** Can be processed line-by-line or batch imported

---

## Development Context

These conversations represent the development history of both projects and contain:

- Architectural decisions and rationale
- Code implementation discussions
- Problem-solving approaches
- Design pattern selections
- API design considerations
- Database schema evolution
- Testing strategies
- Deployment planning
- Integration challenges and solutions

---

## Integration with ClaudeTools

### Context Recall Integration

These conversations can be indexed into the ClaudeTools context recall system:

```bash
# Example: Extract decisions from guru-rmm conversations
# (To be implemented)
python scripts/extract_decisions.py \
  --source "D:\ClaudeTools\projects\msp-tools\guru-rmm" \
  --project "guru-rmm"
```

### Knowledge Extraction

Potential uses of this conversation archive:

1. **Decision Logs** - Extract key architectural decisions
2. **Context Snippets** - Save reusable code patterns
3. **Problem Solutions** - Index common issues and fixes
4. **Best Practices** - Document learned patterns
5. **API Documentation** - Generate docs from conversations

---

## Accessing Conversations

### Browse Files

```bash
# List guru-rmm conversations
ls -lh D:\ClaudeTools\projects\msp-tools\guru-rmm\

# List guru-connect conversations
ls -lh D:\ClaudeTools\projects\msp-tools\guru-connect\

# Count total conversations
find D:\ClaudeTools\projects\msp-tools\ -name "*.jsonl" | wc -l
```

### Search Content

```bash
# Search for FastAPI references
grep -r "FastAPI" D:\ClaudeTools\projects\msp-tools\

# Search for database topics
grep -r "database\|schema\|migration" D:\ClaudeTools\projects\msp-tools\

# Search for specific API endpoints
grep -r "/api/" D:\ClaudeTools\projects\msp-tools\
```

### Parse JSONL

```python
# Example: Read a conversation file
import json

with open('conversation.jsonl', 'r', encoding='utf-8') as f:
    for line in f:
        message = json.loads(line)
        print(f"{message['role']}: {message['content'][:100]}...")
```

---

## Project Metadata

### guru-rmm Metadata

- **File Count:** 54 files
- **Size:** 14 MB (69.7% of total)
- **Type:** MSP Infrastructure
- **Status:** Active development conversations
- **Import Status:** Moved to projects from archive

### guru-connect Metadata

- **File Count:** 40 files
- **Size:** 6.1 MB (30.3% of total)
- **Type:** MSP Integration
- **Status:** Active development conversations
- **Import Status:** Moved to projects from archive

---

## Related Documentation

- **D:\ClaudeTools\projects\README.md** - Projects directory overview
- **D:\ClaudeTools\imported-conversations\INDEX.md** - Complete import archive index
- **D:\ClaudeTools\imported-conversations\IMPORT_MANIFEST.json** - Detailed import metadata
- **D:\ClaudeTools\.claude\CLAUDE.md** - Main ClaudeTools documentation

---

## Future Development

### Planned Enhancements

1. **Conversation Analysis**
   - Automated extraction of key decisions
   - Code snippet extraction
   - API endpoint documentation
   - Pattern recognition

2. **Knowledge Base Integration**
   - Import into context_snippets table
   - Create searchable decision logs
   - Build reusable code library
   - Generate project evolution timeline

3. **Development Continuation**
   - Resume guru-rmm development
   - Extend guru-connect features
   - Cross-project integration
   - Shared component library

### Potential New Subprojects

- **guru-backup** - Backup and recovery automation
- **guru-dashboard** - Unified MSP management interface
- **guru-billing** - Automated billing and invoicing
- **guru-reports** - Reporting and analytics platform

---

## Notes

- Moved from `imported-conversations/` on 2026-01-17
- All timestamps and metadata preserved
- Original source paths documented in IMPORT_MANIFEST.json
- Ready for active development and knowledge extraction
- Conversations span complete development lifecycle of both projects

---

**Project Status:** Active
**Maintained By:** ClaudeTools Project
**Last Review:** 2026-01-17