Add podcast-only demo startup flag and CLI toggle

backend/app.py

@@ -48,7 +48,8 @@ load_dotenv(backend_dir / '.env')  # backend/.env
 load_dotenv(project_root / '.env')  # root .env (fallback)
 load_dotenv()  # CWD .env (fallback)
 
-PODCAST_ONLY_DEMO_MODE = os.getenv("PODCAST_ONLY_DEMO_MODE", "false").lower() in {"1", "true", "yes", "on"}
+# Feature flags (read early so app wiring can rely on a single source of truth)
+PODCAST_ONLY_DEMO_MODE = os.getenv("PODCAST_ONLY_DEMO_MODE", "false").lower() == "true"
 
 # Set up clean logging for end users
 from logging_config import setup_clean_logging
@@ -112,37 +113,36 @@ from services.startup_health import (
 # Import OAuth token monitoring routes
 from api.oauth_token_monitoring_routes import router as oauth_token_monitoring_router
 
-if not PODCAST_ONLY_DEMO_MODE:
+# Import SEO Dashboard endpoints
-    # Import SEO Dashboard endpoints only when non-demo features are enabled
+from api.seo_dashboard import (
-    from api.seo_dashboard import (
+    get_seo_dashboard_data,
-        get_seo_dashboard_data,
+    get_seo_health_score,
-        get_seo_health_score,
+    get_seo_metrics,
-        get_seo_metrics,
+    get_platform_status,
-        get_platform_status,
+    get_ai_insights,
-        get_ai_insights,
+    seo_dashboard_health_check,
-        seo_dashboard_health_check,
+    analyze_seo_comprehensive,
-        analyze_seo_comprehensive,
+    analyze_seo_full,
-        analyze_seo_full,
+    get_seo_metrics_detailed,
-        get_seo_metrics_detailed,
+    get_analysis_summary,
-        get_analysis_summary,
+    batch_analyze_urls,
-        batch_analyze_urls,
+    SEOAnalysisRequest,
-        SEOAnalysisRequest,
+    get_seo_dashboard_overview,
-        get_seo_dashboard_overview,
+    get_gsc_raw_data,
-        get_gsc_raw_data,
+    get_bing_raw_data,
-        get_bing_raw_data,
+    get_competitive_insights,
-        get_competitive_insights,
+    get_deep_competitor_analysis,
-        get_deep_competitor_analysis,
+    run_strategic_insights,
-        run_strategic_insights,
+    get_strategic_insights_history,
-        get_strategic_insights_history,
+    refresh_analytics_data,
-        refresh_analytics_data,
+    analyze_urls_ai,
-        analyze_urls_ai,
+    AnalyzeURLsRequest,
-        AnalyzeURLsRequest,
+    get_analyzed_pages,
-        get_analyzed_pages,
+    get_semantic_health,
-        get_semantic_health,
+    get_semantic_cache_stats,
-        get_semantic_cache_stats,
+    get_sif_indexing_health,
-        get_sif_indexing_health,
+    get_onboarding_task_health,
-        get_onboarding_task_health,
+)
-    )
 
 
 # Initialize FastAPI app
@@ -262,144 +262,171 @@ async def onboarding_status():
     return onboarding_manager.get_onboarding_status()
 
 # Include routers using modular utilities
-if not PODCAST_ONLY_DEMO_MODE:
+router_manager.include_core_routers()
-    router_manager.include_core_routers()
+router_manager.include_optional_routers()
-    router_manager.include_optional_routers()
-else:
-    logger.info("PODCAST_ONLY_DEMO_MODE enabled: including only podcast and subscription feature routers.")
-    app.include_router(subscription_router)
 
 # Include assets serving router (must be mounted to serve generated images)
 app.include_router(assets_serving_router)
 
-if not PODCAST_ONLY_DEMO_MODE:
+# SEO Dashboard endpoints
-    # SEO Dashboard endpoints
+@app.get("/api/seo-dashboard/data")
-    @app.get("/api/seo-dashboard/data")
+async def seo_dashboard_data():
-    async def seo_dashboard_data():
+    """Get complete SEO dashboard data."""
-        """Get complete SEO dashboard data."""
+    return await get_seo_dashboard_data()
-        return await get_seo_dashboard_data()
 
-    @app.get("/api/seo-dashboard/health-score")
+@app.get("/api/seo-dashboard/health-score")
-    async def seo_health_score():
+async def seo_health_score():
-        """Get SEO health score."""
+    """Get SEO health score."""
-        return await get_seo_health_score()
+    return await get_seo_health_score()
 
-    @app.get("/api/seo-dashboard/metrics")
+@app.get("/api/seo-dashboard/metrics")
-    async def seo_metrics():
+async def seo_metrics():
-        """Get SEO metrics."""
+    """Get SEO metrics."""
-        return await get_seo_metrics()
+    return await get_seo_metrics()
 
-    @app.get("/api/seo-dashboard/platforms")
+@app.get("/api/seo-dashboard/platforms")
-    async def seo_platforms(current_user: dict = Depends(get_current_user)):
+async def seo_platforms(current_user: dict = Depends(get_current_user)):
-        """Get platform status."""
+    """Get platform status."""
-        return await get_platform_status(current_user)
+    return await get_platform_status(current_user)
 
-    @app.get("/api/seo-dashboard/insights")
+@app.get("/api/seo-dashboard/insights")
-    async def seo_insights():
+async def seo_insights():
-        """Get AI insights."""
+    """Get AI insights."""
-        return await get_ai_insights()
+    return await get_ai_insights()
 
-    # New SEO Dashboard endpoints with real data
+# New SEO Dashboard endpoints with real data
-    @app.get("/api/seo-dashboard/overview")
+@app.get("/api/seo-dashboard/overview")
-    async def seo_dashboard_overview_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
+async def seo_dashboard_overview_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
-        """Get comprehensive SEO dashboard overview with real GSC/Bing data."""
+    """Get comprehensive SEO dashboard overview with real GSC/Bing data."""
-        return await get_seo_dashboard_overview(current_user, site_url)
+    return await get_seo_dashboard_overview(current_user, site_url)
 
-    @app.get("/api/seo-dashboard/gsc/raw")
+@app.get("/api/seo-dashboard/gsc/raw")
-    async def gsc_raw_data_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
+async def gsc_raw_data_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
-        """Get raw GSC data for the specified site."""
+    """Get raw GSC data for the specified site."""
-        return await get_gsc_raw_data(current_user, site_url)
+    return await get_gsc_raw_data(current_user, site_url)
 
-    @app.get("/api/seo-dashboard/bing/raw")
+@app.get("/api/seo-dashboard/bing/raw")
-    async def bing_raw_data_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
+async def bing_raw_data_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
-        """Get raw Bing data for the specified site."""
+    """Get raw Bing data for the specified site."""
-        return await get_bing_raw_data(current_user, site_url)
+    return await get_bing_raw_data(current_user, site_url)
 
-    @app.get("/api/seo-dashboard/competitive-insights")
+@app.get("/api/seo-dashboard/competitive-insights")
-    async def competitive_insights_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
+async def competitive_insights_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
-        """Get competitive insights from onboarding step 3 data."""
+    """Get competitive insights from onboarding step 3 data."""
-        return await get_competitive_insights(current_user, site_url)
+    return await get_competitive_insights(current_user, site_url)
 
-    @app.get("/api/seo-dashboard/deep-competitor-analysis")
+@app.get("/api/seo-dashboard/deep-competitor-analysis")
-    async def deep_competitor_analysis_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
+async def deep_competitor_analysis_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
-        """Get deep competitor analysis results (auto-scheduled post-onboarding)."""
+    """Get deep competitor analysis results (auto-scheduled post-onboarding)."""
-        return await get_deep_competitor_analysis(current_user, site_url)
+    return await get_deep_competitor_analysis(current_user, site_url)
 
-    @app.post("/api/seo-dashboard/strategic-insights/run")
+@app.post("/api/seo-dashboard/strategic-insights/run")
-    async def run_strategic_insights_endpoint(current_user: dict = Depends(get_current_user)):
+async def run_strategic_insights_endpoint(current_user: dict = Depends(get_current_user)):
-        """Run AI-powered strategic insights analysis manually."""
+    """Run AI-powered strategic insights analysis manually."""
-        return await run_strategic_insights(current_user)
+    return await run_strategic_insights(current_user)
 
-    @app.get("/api/seo-dashboard/strategic-insights/history")
+@app.get("/api/seo-dashboard/strategic-insights/history")
-    async def get_strategic_insights_history_endpoint(current_user: dict = Depends(get_current_user)):
+async def get_strategic_insights_history_endpoint(current_user: dict = Depends(get_current_user)):
-        """Fetch the history of strategic insights for the user."""
+    """Fetch the history of strategic insights for the user."""
-        return await get_strategic_insights_history(current_user)
+    return await get_strategic_insights_history(current_user)
 
-    @app.post("/api/seo-dashboard/refresh")
+@app.post("/api/seo-dashboard/refresh")
-    async def refresh_analytics_data_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
+async def refresh_analytics_data_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
-        """Refresh analytics data by invalidating cache and fetching fresh data."""
+    """Refresh analytics data by invalidating cache and fetching fresh data."""
-        return await refresh_analytics_data(current_user, site_url)
+    return await refresh_analytics_data(current_user, site_url)
 
-    @app.get("/api/seo-dashboard/onboarding-task-health")
-    async def onboarding_task_health_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
-        """Get consolidated health for onboarding-scheduled SEO tasks."""
-        return await get_onboarding_task_health(current_user, site_url)
 
-    @app.get("/api/seo-dashboard/health")
-    async def seo_dashboard_health():
-        """Health check for SEO dashboard."""
-        return await seo_dashboard_health_check()
 
-    # Phase 2B: Semantic health monitoring endpoint (24-hour polling)
+@app.get("/api/seo-dashboard/onboarding-task-health")
-    @app.get("/api/seo-dashboard/semantic-health")
+async def onboarding_task_health_endpoint(current_user: dict = Depends(get_current_user), site_url: str = None):
-    async def semantic_health_endpoint(current_user: dict = Depends(get_current_user)):
+    """Get consolidated health for onboarding-scheduled SEO tasks."""
-        """Get real-time semantic health metrics for content and competitors."""
+    return await get_onboarding_task_health(current_user, site_url)
-        return await get_semantic_health(current_user)
 
-    @app.get("/api/seo-dashboard/cache-stats")
+@app.get("/api/seo-dashboard/health")
-    async def semantic_cache_stats_endpoint(current_user: dict = Depends(get_current_user)):
+async def seo_dashboard_health():
-        """Get semantic cache performance statistics."""
+    """Health check for SEO dashboard."""
-        return await get_semantic_cache_stats(current_user)
+    return await seo_dashboard_health_check()
 
-    @app.get("/api/seo-dashboard/sif-health")
+# Phase 2B: Semantic health monitoring endpoint (24-hour polling)
-    async def sif_indexing_health_endpoint(current_user: dict = Depends(get_current_user)):
+@app.get("/api/seo-dashboard/semantic-health")
-        """Get SIF indexing health summary for the current user."""
+async def semantic_health_endpoint(current_user: dict = Depends(get_current_user)):
-        return await get_sif_indexing_health(current_user)
+    """
+    Get real-time semantic health metrics for content and competitors.
+    This endpoint provides Phase 2B semantic intelligence monitoring data.
     
-    # Comprehensive SEO Analysis endpoints
+    Returns semantic health score, status, and recommendations.
-    @app.post("/api/seo-dashboard/analyze-comprehensive")
+    Data is cached and updated every 24 hours via scheduler.
-    async def analyze_seo_comprehensive_endpoint(request: SEOAnalysisRequest):
+    """
-        """Analyze a URL for comprehensive SEO performance."""
+    return await get_semantic_health(current_user)
-        return await analyze_seo_comprehensive(request)
 
-    @app.post("/api/seo-dashboard/analyze-full")
-    async def analyze_seo_full_endpoint(request: SEOAnalysisRequest):
-        """Analyze a URL for comprehensive SEO performance."""
-        return await analyze_seo_full(request)
 
-    @app.get("/api/seo-dashboard/metrics-detailed")
+@app.get("/api/seo-dashboard/cache-stats")
-    async def seo_metrics_detailed(url: str):
+async def semantic_cache_stats_endpoint(current_user: dict = Depends(get_current_user)):
-        """Get detailed SEO metrics for a URL."""
+    """
-        return await get_seo_metrics_detailed(url)
+    Get semantic cache performance statistics.
+    Returns hit rate, memory usage, and eviction counts.
+    """
+    return await get_semantic_cache_stats(current_user)
 
-    @app.get("/api/seo-dashboard/analysis-summary")
-    async def seo_analysis_summary(url: str):
-        """Get a quick summary of SEO analysis for a URL."""
-        return await get_analysis_summary(url)
 
-    @app.post("/api/seo-dashboard/batch-analyze")
+@app.get("/api/seo-dashboard/sif-health")
-    async def batch_analyze_urls_endpoint(urls: list[str]):
+async def sif_indexing_health_endpoint(current_user: dict = Depends(get_current_user)):
-        """Analyze multiple URLs in batch."""
+    """
-        return await batch_analyze_urls(urls)
+    Get SIF indexing health summary for the current user.
+    Used by the Semantic Indexing Status widget on the dashboard.
+    """
+    return await get_sif_indexing_health(current_user)
 
-    @app.post("/api/seo-dashboard/analyze-urls-ai")
+# Comprehensive SEO Analysis endpoints
-    async def analyze_urls_ai_endpoint(request: AnalyzeURLsRequest, current_user: dict = Depends(get_current_user)):
+@app.post("/api/seo-dashboard/analyze-comprehensive")
-        """Run AI-powered SEO analysis on selected URLs."""
+async def analyze_seo_comprehensive_endpoint(request: SEOAnalysisRequest):
-        return await analyze_urls_ai(request, current_user)
+    """Analyze a URL for comprehensive SEO performance."""
+    return await analyze_seo_comprehensive(request)
 
+@app.post("/api/seo-dashboard/analyze-full")
+async def analyze_seo_full_endpoint(request: SEOAnalysisRequest):
+    """Analyze a URL for comprehensive SEO performance."""
+    return await analyze_seo_full(request)
+
+@app.get("/api/seo-dashboard/metrics-detailed")
+async def seo_metrics_detailed(url: str):
+    """Get detailed SEO metrics for a URL."""
+    return await get_seo_metrics_detailed(url)
+
+@app.get("/api/seo-dashboard/analysis-summary")
+async def seo_analysis_summary(url: str):
+    """Get a quick summary of SEO analysis for a URL."""
+    return await get_analysis_summary(url)
+
+@app.post("/api/seo-dashboard/batch-analyze")
+async def batch_analyze_urls_endpoint(urls: list[str]):
+    """Analyze multiple URLs in batch."""
+    return await batch_analyze_urls(urls)
+
+@app.post("/api/seo-dashboard/analyze-urls-ai")
+async def analyze_urls_ai_endpoint(request: AnalyzeURLsRequest, current_user: dict = Depends(get_current_user)):
+    """Run AI-powered SEO analysis on selected URLs."""
+    return await analyze_urls_ai(request, current_user)
+
+# Centralized mode helpers for router wiring.
+# Keep all mode decisions in this section to avoid scattered env checks.
+def is_podcast_only_demo_mode() -> bool:
+    return PODCAST_ONLY_DEMO_MODE
+
+
+def should_include_non_podcast_routers() -> bool:
+    return not is_podcast_only_demo_mode()
+
+
+# Include Podcast Maker router (available in all modes)
+from api.podcast.router import router as podcast_router
+app.include_router(podcast_router)
+
+if should_include_non_podcast_routers():
     # Include platform analytics router
     from routers.platform_analytics import router as platform_analytics_router
     app.include_router(platform_analytics_router)
+
     # Include Bing Analytics Storage router to expose storage-backed endpoints
     from routers.bing_analytics_storage import router as bing_analytics_storage_router
     app.include_router(bing_analytics_storage_router)
@@ -412,11 +439,6 @@ if not PODCAST_ONLY_DEMO_MODE:
     from api.content_assets.router import router as content_assets_router
     app.include_router(content_assets_router)
 
-# Include Podcast Maker router
-from api.podcast.router import router as podcast_router
-app.include_router(podcast_router)
-
-if not PODCAST_ONLY_DEMO_MODE:
     # Include YouTube Creator Studio router
     from api.youtube.router import router as youtube_router
     app.include_router(youtube_router, prefix="/api")
@@ -440,6 +462,8 @@ if not PODCAST_ONLY_DEMO_MODE:
     # Today workflow routes
     from api.today_workflow import router as today_workflow_router
     app.include_router(today_workflow_router)
+else:
+    logger.info("PODCAST_ONLY_DEMO_MODE is enabled: non-podcast routers are not registered.")
 
 # Setup frontend serving using modular utilities
 frontend_serving.setup_frontend_serving()

backend/start_alwrity_backend.py

@@ -298,6 +298,11 @@ def main():
     parser.add_argument("--dev", action="store_true", help="Enable development mode (auto-reload)")
     parser.add_argument("--production", action="store_true", help="Enable production mode (optimized for deployment)")
     parser.add_argument("--verbose", action="store_true", help="Enable verbose logging for debugging")
+    parser.add_argument(
+        "--podcast-only-demo",
+        action="store_true",
+        help="Enable podcast-only demo mode (sets PODCAST_ONLY_DEMO_MODE=true before app startup)",
+    )
     args = parser.parse_args()
     
     # Determine mode
@@ -307,6 +312,8 @@ def main():
     
     # Set global verbose flag for utilities
     os.environ["ALWRITY_VERBOSE"] = "true" if verbose_mode else "false"
+    if args.podcast_only_demo:
+        os.environ["PODCAST_ONLY_DEMO_MODE"] = "true"
     
     print("[*] ALwrity Backend Server")
     print("=" * 40)
@@ -314,6 +321,8 @@ def main():
     print(f"Auto-reload: {'ENABLED' if enable_reload else 'DISABLED'}")
     if verbose_mode:
         print("Verbose logging: ENABLED")
+    if args.podcast_only_demo:
+        print("Podcast-only demo mode: ENABLED")
     print("=" * 40)
     
     # Check if we're in the right directory