Skip to content

Releases: gitayam/researchtoolspy

v2.8.2 - Critical Bug Fixes & Production Cleanup

09 Oct 21:21
@gitayam gitayam
v2.8.2
3717a2e

Choose a tag to compare

View all tags
v2.8.2 - Critical Bug Fixes & Production Cleanup Latest
Latest

🐛 Critical Bug Fix

Framework Q&A Data Display Issue

Fixed: Starbursting and other frameworks were showing zero Q&A items despite correct database storage.

Root Cause: Double JSON parsing bug where both API endpoint and component were parsing the same data, causing safeJSONParse() to return an empty object when called on already-parsed data.

Solution: Added type checking before parsing: typeof data === 'object' ? data : safeJSONParse(data, {})

Impact: Affects all framework views - SWOT, COG, PEST, PMESII-PT, DIME, Deception, Starbursting, etc.

Files Modified:

  • src/pages/frameworks/index.tsx (9 instances fixed)
  • functions/api/frameworks.ts (removed debug logging)
  • functions/api/content-intelligence/starbursting.ts (removed debug logging)

✨ Content Intelligence Enhancements

Word Cloud Improvements

  • ✅ Fixed export with oklch color compatibility for html2canvas
  • ✅ Added single word frequency tracking (100+ stop words filter)
  • ✅ Improved word cloud visualization and export

Entity Extraction

  • ✅ Fixed author/entity confusion (article authors excluded from story entities)
  • ✅ Enhanced text cleaning to remove bylines
  • ✅ Improved AI prompt to distinguish authors from subjects

UX Improvements

  • ✅ Made logo and brand text clickable for navigation
  • ✅ Fixed "Analyze Now" button async state issue
  • ✅ Added comprehensive export reports with all analysis data

🔒 Security & Infrastructure

  • ✅ Fixed web manifest Content-Type header via Cloudflare _headers
  • ✅ Added security headers:
    • X-Frame-Options: SAMEORIGIN
    • X-Content-Type-Options: nosniff
    • Referrer-Policy: strict-origin-when-cross-origin
    • Permissions-Policy: camera=(), microphone=(), geolocation=()

📝 Documentation & Cleanup

  • ✅ Updated README.md with complete feature list
  • ✅ Added comprehensive double-parsing bug documentation to docs/LESSONS_LEARNED.md
  • ✅ Archived 24 working documents to archive/working-docs-2025/
  • ✅ Removed debug console.log statements from production code
  • ✅ Organized documentation with clear categories

📦 Deployment

🔧 Developer Notes

Double JSON Parsing Bug - Lessons Learned

How to Diagnose:

  1. Add logging at each data transformation point
  2. Check for multiple JSON.parse() calls in data flow
  3. Look for safeJSONParse() on already-parsed objects
  4. Verify data type at each step

Prevention:

// Always check type before parsing
const parsedData = typeof data === 'object' ? data : JSON.parse(data)

See: docs/LESSONS_LEARNED.md for full details.

📊 Statistics

  • Files Changed: 33
  • Insertions: +487 lines
  • Deletions: -79 lines
  • Bug Fixes: 1 critical, multiple minor
  • Documentation Updates: 3 files
  • Archived Documents: 24 files
Assets 2
Loading

v2.0.0: Complete Research Analysis Platform

28 Aug 14:21
@gitayam gitayam
v2.0.0
b3be07e

Choose a tag to compare

View all tags
v2.0.0: Complete Research Analysis Platform

🚀 ResearchTools v2.0.0

🎯 Overview

Complete research analysis platform with 10 professional frameworks, privacy-focused authentication, and enterprise-grade export capabilities.

✨ Major Features

🏗️ Architecture

  • Backend: FastAPI with comprehensive REST API
  • Frontend: Next.js with TypeScript and Tailwind CSS
  • Database: SQLite (dev) / PostgreSQL (production)
  • Authentication: Privacy-first hash-based system (Mullvad-style)
  • Deployment: Docker-ready with docker-compose

📊 10 Analysis Frameworks

  1. SWOT Analysis - Strengths, Weaknesses, Opportunities, Threats
  2. COG Analysis - Center of Gravity strategic assessment
  3. PMESII-PT - Comprehensive operational environment analysis
  4. ACH - Analysis of Competing Hypotheses
  5. DOTMLPF - Defense capability assessment
  6. Deception Detection - Truth verification framework
  7. Behavioral Analysis - Pattern recognition system
  8. Starbursting - Question-based analysis
  9. Causeway - Cause-and-effect mapping
  10. DIME - Diplomatic/Information/Military/Economic analysis

🔐 Privacy & Security

  • No personal data collection (no emails, names, or passwords)
  • 16-digit account hash authentication
  • JWT-based session management
  • Anti-timing attack protections
  • CORS-configured for secure deployments

📤 Export Capabilities

  • Excel spreadsheets
  • Word documents
  • PowerPoint presentations
  • PDF reports
  • JSON data
  • CSV files

🎨 User Experience

  • Dark mode with WCAG compliance
  • Mobile-responsive design
  • Real-time analysis updates
  • Intuitive framework navigation
  • Professional report generation

🛠️ Technical Details

API Endpoints

  • /api/v1/auth/ - Authentication endpoints
  • /api/v1/frameworks/ - All 10 framework APIs
  • /api/v1/tools/ - Research tool integrations
  • /api/v1/export/ - Document generation

Development Setup

# Clone repository
git clone https://github.com/gitayam/researchtoolspy.git
cd researchtoolspy

# Start with Docker
docker-compose up -d

# Access application
http://localhost:6780 (Frontend)
http://localhost:8000 (API)

📚 Documentation

  • Comprehensive API documentation at /docs
  • Framework implementation guides
  • Export format specifications
  • Dark mode implementation patterns

🤝 Contributors

  • IrregularChat Community
  • Open source contributors

📄 License

See LICENSE file for details

🤖 Generated with Claude Code

Loading