Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog.

[3.1.0] - 2026-02-25

Added

Plugin System

• Community plugin architecture — create xactions-plugin-* npm packages
• Plugin loader, manager, and template in src/plugins/
• CLI commands: xactions plugin install/list/remove
• MCP server auto-discovers and registers plugin tools

Real-Time Streaming

• Live event streams for tweets, followers, and mentions via Socket.IO
• Puppeteer-based polling with Redis deduplication and rate limit backoff
• Browser pool management (max 3 concurrent instances)
• MCP tools: x_stream_start, x_stream_stop, x_stream_list

Workflow Engine

• Declarative JSON automation pipelines with triggers, actions, and conditions
• Cron scheduling, webhook triggers, event-based triggers
• 3 example workflows: competitor monitor, auto-engage keywords, follower growth report
• CLI: xactions workflow create/run/list
• MCP tools: x_workflow_create, x_workflow_run, x_workflow_list

Cross-Platform Scrapers

• Unified scraper interface: scrape(platform, type, options)
• Bluesky support via AT Protocol (@atproto/api) — no Puppeteer needed
• Mastodon support via public REST API — any instance URL
• Threads support via Puppeteer
• Backward compatible — existing Twitter imports unchanged

Sentiment Analysis & Reputation Monitoring

• Built-in rule-based sentiment analyzer (works offline, zero dependencies)
• Optional LLM mode via OpenRouter for nuanced analysis
• Reputation monitoring with trend detection and anomaly alerts
• Alert delivery via webhook, Socket.IO, or console
• Daily/weekly reputation reports

Account Portability

• Full account export: profile, tweets, followers, following, bookmarks, likes
• Output formats: JSON, CSV, Markdown, self-contained HTML archive viewer
• Export diff tool — compare two snapshots to see changes
• Migration stubs for Bluesky and Mastodon

Social Graph Analysis

• Graph builder crawls N degrees from seed account
• Algorithms: mutual connections, bridge accounts, cluster detection, influence scoring
• Exports to D3.js JSON and Gephi GEXF formats
• Self-contained HTML visualization with force-directed layout

Browser Extension

• Manifest V3 Chrome/Firefox extension
• Popup UI to run automations without console access
• Content script injection, settings persistence, activity badge

Dashboard Enhancements

• automations.html — automation control panel with start/stop toggles
• monitor.html — real-time activity feed with Chart.js visualizations
• workflows.html — visual workflow builder
• analytics.html — sentiment timeline, mention analysis, alert configuration
• Full docs site generated at dashboard/docs/

New API Routes

• /api/streams — real-time stream management
• /api/workflows — workflow CRUD and execution
• /api/analytics — sentiment analysis and monitoring
• /api/portability — account export and migration
• /api/graph — social graph building and analysis
• /api/automations — automation start/stop control
• 15+ additional routes for bookmarks, discovery, engagement, posting, etc.

New Browser Scripts

• engagementBooster.js — systematic engagement with target accounts
• sentimentAnalyzer.js — in-browser sentiment scoring
• shadowbanChecker.js — detect account restrictions
• viralTweetDetector.js — find viral content early
• followerGrowthTracker.js — track growth over time
• tweetScheduleOptimizer.js — find best posting times
• welcomeNewFollowers.js — auto-welcome with templates
• quoteTweetAutomation.js — strategic quote tweeting
• threadComposer.js — multi-tweet thread builder
• contentCalendar.js — plan and schedule content
• audienceDemographics.js — analyze follower demographics
• accountHealthMonitor.js — monitor account health signals
• pinTweetManager.js — manage pinned tweets
• bulkDeleteTweets.js — mass delete old tweets
• autoReply.js — automated reply with templates

Other

• TypeScript type declarations (types/index.d.ts)
• Docker support (Dockerfile + docker-compose)
• New npm exports: xactions/streaming, xactions/analytics, xactions/plugins
• xactions-mcp and xactions-agent bin commands

Changed

• MCP server expanded from ~200 to 140+ registered tools
• Package exports updated for multi-platform scraper paths
• Dependencies updated: vitest 4.x, puppeteer 24.x, added node-cron, better-sqlite3, exceljs

[1.0.0] - 2026-02-11

Added

• Initial release