Mike Swanson
f20a9628c3
Make the radio archive Q&A pairs actually browseable end to end:
- /api/qa list endpoint (year, min_score, exclude_banter, topic_class,
pagination, sort by air_date or score). Returns the same column shape as
/api/search Q&A hits.
- /api/audio/{episode_id} streams the MP3 with HTTP Range support so the
browser <audio> can seek. 206 + Content-Range when ranged, 200 when
full-file. Returns 404 cleanly when episodes/ tree is absent (Jupiter).
- /episode/{id} HTML transcript view: chronological segments with clickable
timestamps, Q&A blocks spliced inline (anchor #qa-<id>), intros marked
inline, right-rail summary. Hash-anchor on load auto-seeks the audio.
- New question_excerpt / answer_excerpt fields on /api/search Q&A hits and
on /api/qa items: trim leading run-on chatter, take ~300 chars, end on a
sentence boundary or word boundary with ellipsis.
- Index UI: each Q&A hit now links to /episode/{id}#qa-{qa_id}; new
"Browse all Q&A" toggle (year selector, sort, append-load 50 per page,
defaults to min_score=3); FTS snippet replaced with the plain excerpt
when available.
No new dependencies, no schema changes, no LLM calls. Uses
EPISODES_DIR env (default /data/episodes) — Jupiter compose still only
mounts /data so audio degrades gracefully to 404 there until episodes
are uploaded.
ClaudeTools Active Projects
Directory: D:\ClaudeTools\projects\
Purpose: Active development projects and related conversation archives
Last Updated: 2026-01-17
Overview
This directory contains active projects being developed or maintained as part of the ClaudeTools ecosystem. Unlike the imported-conversations/ directory which serves as an archive, projects here are actively worked on and may include both source code and conversation history.
Current Projects
MSP Tools (94 files, 20.1 MB)
Moved From: D:\ClaudeTools\imported-conversations\msp-tools/
Move Date: 2026-01-17
Status: Active development
Managed Service Provider (MSP) tooling and infrastructure projects, including conversation history and development artifacts.
Structure
msp-tools/
├── guru-rmm/ # 54 files, 14 MB
│ └── [JSONL conversation files] # RMM system development history
└── guru-connect/ # 40 files, 6.1 MB
└── [JSONL conversation files] # MSP integration development history
guru-rmm (54 files, 14 MB)
Description: Remote Monitoring and Management (RMM) system development conversations
Source: C:\Users\MikeSwanson\.claude\projects\C--Users-MikeSwanson-claude-projects-gururmm-guru-rmm
Key Topics:
- RMM system architecture
- Monitoring solutions
- Agent deployment
- Infrastructure management
- MSP automation
Project Type: MSP Infrastructure
guru-connect (40 files, 6.1 MB)
Description: MSP connectivity and integration tooling conversations
Source: C:\Users\MikeSwanson\.claude\projects\C--Users-MikeSwanson-claude-projects-guru-connect
Key Topics:
- Integration patterns
- API connectivity
- Service orchestration
- Client management
- Cross-platform integration
Project Type: MSP Integration
File Format
All conversation files are in JSONL (JSON Lines) format:
- Extension:
.jsonl - Format: Each line is a valid JSON object
- Content: Individual conversation messages from Claude
- Encoding: UTF-8
- Can be processed line-by-line for analysis
Usage
Accessing Project Files
# List all projects
ls -lh D:\ClaudeTools\projects\
# Browse MSP tools conversations
ls -lh D:\ClaudeTools\projects\msp-tools\guru-rmm\
# Count conversation files
find D:\ClaudeTools\projects\ -name "*.jsonl" | wc -l
# Search for specific topics
grep -r "FastAPI" D:\ClaudeTools\projects\
Integration with ClaudeTools
These conversations can be:
- Analyzed and indexed into context recall system
- Used to extract reusable code snippets
- Mined for technical decisions and patterns
- Converted into knowledge base entries
- Referenced for similar future projects
Adding New Projects
When adding new active projects to this directory:
- Create a descriptive folder name (e.g.,
project-name/) - Include conversation history if available
- Update this README with project details
- Consider creating a project-specific README
- Tag appropriately for context recall
Related Documentation
- imported-conversations/INDEX.md - Archive of all imported conversations
- imported-conversations/IMPORT_MANIFEST.json - Detailed import metadata
- .claude/CLAUDE.md - Main ClaudeTools project documentation
- SESSION_STATE.md - Current project state and development history
Project Organization
Active Projects (this directory):
- Currently under development
- May include both code and conversation history
- Subject to frequent updates
- Integrated with ClaudeTools development
Archived Conversations (imported-conversations/):
- Historical reference only
- Read-only archive
- Organized by project type
- Preserved for knowledge extraction
Future Projects
This directory will grow as new projects are added. Potential additions:
- guru-backup - Backup and recovery tooling
- guru-dashboard - MSP management dashboard
- integration-tools - Third-party integration utilities
- automation-scripts - MSP automation workflows
Statistics
Current Totals:
- Projects: 1 (msp-tools)
- Conversation Files: 94 JSONL files
- Total Size: 20.1 MB
- Subcategories: 2 (guru-rmm, guru-connect)
Breakdown:
- guru-rmm: 54 files (57.4%), 14 MB (69.7%)
- guru-connect: 40 files (42.6%), 6.1 MB (30.3%)
Notes
- This directory was created on 2026-01-17
- First project (msp-tools) moved from imported-conversations archive
- All conversation files preserved with original timestamps
- Original source paths documented in IMPORT_MANIFEST.json
Maintained By: ClaudeTools Project
Location: D:\ClaudeTools\projects
Documentation Status: Active