Tiny system app that suggests concrete, niche API integrations based on actual user routine: "This MS Word macro could be chained with last week's Python scraper and Dropbox move to create a new workflow—here's sample code." No cloud; totally local, learning from usage patterns, not vendors.

• 🔍 Automatic File System Monitoring - Tracks file access, creation, modification, and deletion
• 📊 Pattern Detection - Identifies usage patterns, temporal sequences, and file relationships
• 💡 Smart Suggestions - Suggests API integrations based on your actual workflow
• 🔗 Relationship Mapping - Detects input/output relationships and file dependencies
• ⏱️ Temporal Analysis - Learns sequential workflows and time-based patterns
• 🔒 Privacy First - All data stored locally, no cloud, no external services
• ⚙️ Configurable - Customize monitored directories, exclusions, and behavior

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

# Start automatic file system monitoring
floyo watch

# In another terminal, get suggestions
floyo suggest

# View usage patterns
floyo patterns

# Check tracking status
floyo status

• floyo watch - Start file system monitoring
• floyo suggest - Show integration suggestions
• floyo patterns - Show usage patterns
• floyo status - Show tracking statistics
• floyo temporal - Show temporal patterns
• floyo relationships [file] - Show file relationships
• floyo record <file> - Manually record file access
• floyo export <file> - Export tracking data
• floyo import <file> - Import tracking data
• floyo clear - Clear all tracking data

See USER_GUIDE.md for detailed documentation.

Configuration is stored in ~/.floyo/config.toml. Customize monitored directories, exclusion patterns, and more.

# Run tests
pytest

# Run tests with coverage
pytest --cov=floyo

# View documentation
cat docs/USER_GUIDE.md
cat docs/DEVELOPER_GUIDE.md

See DEVELOPER_GUIDE.md for development documentation.

• tracker.py - Usage tracking and pattern analysis
• suggester.py - Integration suggestion engine
• watcher.py - File system monitoring (uses watchdog)
• command_tracker.py - Command execution tracking
• config.py - Configuration management
• cli.py - Command-line interface

• Python 3.7+
• watchdog (file system monitoring)
• pyyaml (configuration)
• toml (configuration)

Security & Compliance - Must complete before launch

• ✅ 2FA/MFA Support - TOTP implementation (Google Authenticator compatible)
• ✅ Security Headers - CSP, HSTS, X-Frame-Options middleware
• ✅ Data Encryption - Encrypt sensitive fields (integration configs)
• ✅ Security Audit - Comprehensive security event logging
• Password Reset Flow - Complete email service integration
• Security Audit Review - Penetration testing and vulnerability assessment

Frontend Improvements & User Experience

• ✅ Advanced Filtering UI - Enhanced event and pattern filtering
• ✅ Data Visualization Charts - Pattern and timeline charts
• ✅ Dark Mode Support - Full dark mode implementation
• ✅ Loading States - Skeleton screens and loading indicators
• ✅ Mobile Responsiveness - Touch-optimized components and gestures
• ✅ Keyboard Shortcuts - Power user keyboard navigation
• Infinite Scroll - Virtual scrolling for large lists
• Pattern Timeline Visualization - Enhanced time-based charts

Testing & Quality Assurance

• ✅ Security Tests - 2FA, encryption, sanitization test coverage
• ✅ Frontend Component Tests - Test infrastructure setup
• Increase Test Coverage - Target >80% coverage
• Performance Testing - Load testing with k6
• Accessibility Testing - WCAG 2.1 AA compliance
• E2E Test Suite - Comprehensive end-to-end tests

Weeks 5-8: Growth Engine ✅

• Retention optimization system with cohorts and campaigns
• Viral growth system with referral tracking
• Workflow sharing and marketplace foundation
• Growth analytics and metrics

Weeks 9-12: Monetization ✅

• Billing and subscription system (Free, Pro, Enterprise)
• Usage tracking and tier-based feature access
• LTV:CAC calculation and pricing intelligence

Weeks 13-16: Enterprise & Ecosystem ✅

• SSO integration framework (SAML/OIDC)
• Enterprise admin dashboard and analytics
• Compliance reporting (GDPR, SOC2)
• Workflow marketplace and ecosystem

Security (P0) - Current Sprint ✅

• 2FA/MFA implementation with TOTP
• Security headers middleware (CSP, HSTS, etc.)
• Data encryption for sensitive fields
• Security audit and event logging
• Password strength validation
• Input sanitization and validation

See ROADMAP.md and REMAINING_ROADMAP_ITEMS.md for complete roadmap details.

This repository includes a self-operating production framework with comprehensive operations tooling. See OPS_README.md for full documentation.

Quick Start:

npm run ops init
npm run ops doctor
npm run ops release

Key Features:

• 🔍 Master Orchestrator CLI (ops doctor | init | check | release | ...)
• 🧪 Reality Suite (Playwright E2E + synthetic monitors)
• 🔐 Secrets Regimen (auto-rotation, 20-day alerts)
• 🛡️ RLS Enforcer (Supabase security scanning)
• 📸 Migration Safety (shadow migrations, encrypted snapshots)
• 📊 Observability Suite (OpenTelemetry, dashboards)
• ⚡ Performance Budgets (Lighthouse CI, bundle analyzer)
• 🚀 Release Train (semantic-release, Vercel deploys)
• 🔄 DR Playbook (quarterly automated rehearsals)
• 📈 Growth Engine (UTM tracking, cohort analysis, LTV)
• ✅ Compliance Guard (DSAR, cookie consent, data inventory)
• 🤖 AI Agent Guardrails (schema validation, circuit breaker)
• 💰 Offers & Paywalls (feature-flagged pricing, admin UI)
• 🌍 Internationalization (auto-extraction, CI validation)
• 📚 Auto-Generated Docs (Mermaid diagrams, endpoint examples)
• 🔴 Red-Team Tests (auth breaches, rate limits, RLS regression)
• 💳 Billing Stub (Stripe webhooks, feature flag)
• 📱 Store Pack (app store manifests, privacy labels)
• 🔇 Quiet Mode (incident degradation toggle)
• 💵 Cost Caps (quota enforcement, throttling)
• 🤝 Partner Hooks (integration contracts, Postman collection)

Operations Schedule:

• Daily: ops doctor → check reports → fix → release if green
• Weekly: ops release + growth report + rotate secrets
• Monthly: DR rehearsal + deps update + red-team sweep

Apache-2.0