Files
claudetools/projects
Mike Swanson e4392afce9 docs: Document Dataforth test database system and troubleshooting
Investigation and Documentation:
- Discovered and documented test database system on AD2 server
- Created comprehensive TEST_DATABASE_ARCHITECTURE.md with full system details
- Retrieved all key database files from AD2 (import.js, schema.sql, server configs)
- Documented data flow: DOS machines → NAS → AD2 → SQLite → Web interface
- Verified database health: 1,027,517 records, 1075 MB, dates back to 1990

Database System Architecture:
- SQLite database with Node.js/Express.js web server (port 3000)
- Automated import via Sync-FromNAS.ps1 (runs every 15 minutes)
- 8 log types supported: DSCLOG, 5BLOG, 7BLOG, 8BLOG, PWRLOG, SCTLOG, VASLOG, SHT
- FTS5 full-text search, comprehensive indexes for performance
- API endpoints: search, stats, export, datasheet generation

Troubleshooting Scripts Created:
- Database diagnostics: check-db-simple.ps1, test-db-directly.ps1
- Server status checks: check-node-running.ps1, check-db-server.ps1
- Performance analysis: check-db-performance.ps1, check-wal-files.ps1
- API testing: test-api-endpoint.ps1, test-query.js
- Import monitoring: check-new-records.ps1
- Database optimization attempts: api-js-optimized.js, api-js-fixed.js
- Deployment scripts: deploy-db-optimization.ps1, deploy-db-fix.ps1, restore-original.ps1

Key Findings:
- Database file healthy and queryable (verified with test-query.js)
- Node.js server not running (port 3000 closed) - root cause of web interface issues
- Database last updated 8 days ago (01/13/2026) - automated sync may be broken
- Attempted performance optimizations (WAL mode) incompatible with readonly connections
- Original api.js restored from backup after optimization conflicts

Retrieved Documentation:
- QUICKSTART-retrieved.md: Quick start guide for database server
- SESSION_NOTES-retrieved.md: Complete session notes from database creation
- Sync-FromNAS-retrieved.ps1: Full sync script with database import logic
- import-js-retrieved.js: Node.js import script (12,774 bytes)
- schema-retrieved.sql: SQLite schema with FTS5 triggers
- server-js-retrieved.js: Express.js server configuration
- api-js-retrieved.js: API routes and endpoints
- package-retrieved.json: Node.js dependencies

Action Items Identified:
1. Start Node.js server on AD2 to restore web interface functionality
2. Investigate why automated sync hasn't updated database in 8 days
3. Check Windows Task Scheduler for Sync-FromNAS.ps1 scheduled task
4. Run manual import to catch up on 8 days of test data if needed

Technical Details:
- Database path: C:\Shares\testdatadb\database\testdata.db
- Web interface: http://192.168.0.6:3000 (when running)
- Database size: 1075.14 MB (1,127,362,560 bytes)
- Total records: 1,027,517 (slight variance from original 1,030,940)
- Pass rate: 99.82% (1,029,046 passed, 1,888 failed)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-21 16:38:54 -07:00
..

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:

  1. Create a descriptive folder name (e.g., project-name/)
  2. Include conversation history if available
  3. Update this README with project details
  4. Consider creating a project-specific README
  5. Tag appropriately for context recall

  • 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