Files
ALwrity/frontend/src/components/OnboardingWizard/FinalStep/FinalStep.tsx
ajaysi 923fa671fe feat: ContentGuardianAgent, onboarding UX, Team Activity action wiring, docs, agent help modal
ContentGuardianAgent consolidation:
- Merge 3 duplicate classes into single source in specialized/content_guardian.py
- Watchdog audit_committee() with heuristic scoring, coverage gaps, overlaps, alerts
- Remove misleading rejection_rate() helper; use acceptance_rate directly
- Integrate audit + alerts + trend signals into today_workflow_service.py

Team Activity page:
- QualityAuditPanel: health ring, per-agent critiques, coverage gaps, overlaps
- TrendSignalsPanel: opportunity cards with urgency/impact/coverage bars
- AlertBanner: persistent dismiss via POST /alerts/{id}/mark-read
- AgentHelpModal: dialog showing all 8 agents with descriptions, tools, schedule
- QualityAuditPanel action buttons: Fill gap -> /content-planning, Resolve overlap, View CTA on alerts/issues
- TrendSignalsPanel action buttons: Create content from this trend -> /blog-writer with trend context state

Onboarding system:
- Step 4 validation: no auto-pass via basic_ready; requires persona data or explicit progression
- Step 5 validation: logs warning on auto-pass without integration data
- OnboardingCompletionService: single DB session, transactional task creation, upsert pattern
- Business-without-website: nullable website_url on SIFIndexingTask and MarketTrendsTask
- DeepCompetitorAnalysisExecutor: 5-min timeout, 10-competitor cap, asyncio.wait_for
- Persona generation: async with 30s timeout, falls back to scheduler
- OnboardingProgressService.reset_onboarding(): resets session + pauses all DB tasks
- OnboardingControlService.reset_onboarding(): also cancels APScheduler jobs
- FinalStep TaskSchedulingPanel: shows scheduled/failed tasks after completion, 8s auto-redirect
- onboarding_completed agent activity event logged to feed

Documentation:
- docs-site/features/onboarding/: overview, steps, scheduler-tasks, technical-reference (4 pages)
- docs-site/mkdocs.yml: added Onboarding System nav section
- docs-site/features/sif-agents/: overview, agent-directory, committee-system, content-guardian (4 pages)
- docs-site/features/team-activity/: overview, quality-audit, trend-signals, alert-system (4 pages)
- docs-site/features/todays-workflow/: updated overview, technical-architecture, workflow-guide, api-reference
2026-06-01 12:24:31 +05:30

643 lines
25 KiB
TypeScript

import React, { useState, useEffect } from 'react';
import {
Box,
Button,
Typography,
Alert,
Container,
Fade,
Zoom,
CircularProgress
} from '@mui/material';
import {
Rocket,
Star,
CheckCircle,
// CreditCard,
// Warning
} from '@mui/icons-material';
// import OnboardingButton from '../common/OnboardingButton';
import { useNavigate } from 'react-router-dom';
import { getApiKeys, completeOnboarding, getOnboardingSummary, getWebsiteAnalysisData, getResearchPreferencesData, setCurrentStep } from '../../../api/onboarding';
import { SetupSummary, CapabilitiesOverview, AgentTeamSection, TaskSchedulingPanel } from './components';
import { FinalStepProps, OnboardingData, Capability, OnboardingCompletionResult } from './types';
import { getAgentTeam, type AgentTeamCatalogEntry } from '../../../api/agentsTeam';
const FinalStep: React.FC<FinalStepProps> = ({ onContinue, updateHeaderContent }) => {
const navigate = useNavigate();
const [loading, setLoading] = useState(false);
const [dataLoading, setDataLoading] = useState(false);
const [error, setError] = useState<string | null>(null);
const [onboardingData, setOnboardingData] = useState<OnboardingData>({
apiKeys: {}
});
const [expandedSection, setExpandedSection] = useState<string | null>('summary');
const [validationStatus, setValidationStatus] = useState<{isValid: boolean, missingSteps: string[]} | null>(null);
const [agentTeam, setAgentTeam] = useState<AgentTeamCatalogEntry[]>([]);
const [agentTeamError, setAgentTeamError] = useState<string | null>(null);
const [completionResult, setCompletionResult] = useState<OnboardingCompletionResult | null>(null);
const [countdown, setCountdown] = useState<number | null>(null);
// const buttonRef = useRef<HTMLButtonElement>(null);
useEffect(() => {
updateHeaderContent({
title: 'Review & Launch Alwrity 🚀',
description: 'Review your configuration and confirm all settings before launching your AI-powered content creation workspace.'
});
// Always attempt to load data once on mount
loadOnboardingData();
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [updateHeaderContent]);
// Auto-redirect countdown after successful onboarding completion
useEffect(() => {
if (completionResult && countdown === null) {
setCountdown(8);
}
if (countdown === null || countdown <= 0) return;
const timer = setTimeout(() => {
setCountdown(prev => {
const next = (prev ?? 0) - 1;
if (next <= 0) {
navigate('/dashboard', { replace: true });
return 0;
}
return next;
});
}, 1000);
return () => clearTimeout(timer);
}, [completionResult, countdown, navigate]);
// Remove the DOM manipulation approach - we'll use React's built-in event handling
const loadOnboardingData = async () => {
// Prevent multiple simultaneous data loading calls
if (dataLoading) {
return;
}
setDataLoading(true);
// Set a timeout to prevent infinite loading
const loadingTimeout = setTimeout(() => {
console.log('FinalStep: Data loading timeout reached, proceeding with available data');
setDataLoading(false);
}, 4000); // 4s timeout
try {
// Load comprehensive onboarding summary
const summary = await getOnboardingSummary();
// Load individual data sources for detailed information
const websiteAnalysis = await getWebsiteAnalysisData();
const researchPreferences = await getResearchPreferencesData();
try {
const team = await getAgentTeam();
setAgentTeam(team || []);
setAgentTeamError(null);
} catch (e: any) {
setAgentTeam([]);
setAgentTeamError(e?.message || 'Failed to load agent team configuration');
}
// Frontend fallbacks to Step 2 cached data (ensures non-breaking UI)
const cachedUrl = typeof window !== 'undefined' ? localStorage.getItem('website_url') : null;
const cachedAnalysisRaw = typeof window !== 'undefined' ? localStorage.getItem('website_analysis_data') : null;
const cachedAnalysis = cachedAnalysisRaw ? safeParseJSON(cachedAnalysisRaw) : undefined;
const newOnboardingData = {
apiKeys: summary.api_keys || {},
websiteUrl: websiteAnalysis?.website_url || summary.website_url || cachedUrl || undefined,
researchPreferences: researchPreferences || summary.research_preferences,
personalizationSettings: summary.personalization_settings,
integrations: summary.integrations || {},
styleAnalysis: websiteAnalysis?.style_analysis || summary.style_analysis || cachedAnalysis || undefined,
canonicalProfile: summary.canonical_profile
};
setOnboardingData(newOnboardingData);
// Validate completion status after data is loaded
console.log('FinalStep: Data loaded, running validation...');
const validation = await validateOnboardingCompletionWithData(newOnboardingData);
setValidationStatus(validation);
} catch (error) {
console.error('Error loading onboarding data:', error);
// Error handling is managed by global API client interceptors
// Fallback to just API keys if other endpoints fail
try {
const apiKeys = await getApiKeys();
setOnboardingData({
apiKeys,
websiteUrl: undefined,
researchPreferences: undefined,
personalizationSettings: undefined,
integrations: undefined,
styleAnalysis: undefined
});
} catch (fallbackError) {
console.error('Error loading API keys as fallback:', fallbackError);
// Error handling is managed by global API client interceptors
}
} finally {
setDataLoading(false);
clearTimeout(loadingTimeout);
}
};
const websiteName = React.useMemo(() => {
const url = onboardingData.websiteUrl;
if (!url) return 'Your';
try {
const hostname = new URL(url).hostname.replace(/^www\./, '');
const parts = hostname.split('.');
if (parts.length <= 2) return parts[0] || hostname;
return parts.slice(0, -1).join('.') || hostname;
} catch {
return 'Your';
}
}, [onboardingData.websiteUrl]);
const agentContextCard = React.useMemo(() => {
const style = onboardingData.styleAnalysis || {};
const persona = onboardingData.personalizationSettings || {};
const canonical = onboardingData.canonicalProfile || {};
const research = onboardingData.researchPreferences || {};
const contentPillars =
style?.content_strategy_insights?.content_pillars ||
style?.sitemap_analysis?.content_pillars ||
canonical?.content_pillars ||
[];
const competitors =
research?.competitors ||
canonical?.competitors ||
[];
return {
website_name: websiteName,
website_url: onboardingData.websiteUrl,
brand_voice: persona?.corePersona || persona?.platformPersonas || persona?.brand_voice || canonical?.brand_voice || "",
target_audience: style?.target_audience || canonical?.target_audience || "",
style_guidelines: style?.style_guidelines || style?.style_patterns || canonical?.style_guidelines || "",
content_pillars: Array.isArray(contentPillars) ? contentPillars : [],
competitors: Array.isArray(competitors) ? competitors : [],
business_goals: canonical?.business_goals || [],
};
}, [onboardingData, websiteName]);
// Safe JSON parser for cached data
const safeParseJSON = (raw: string | null): any | undefined => {
if (!raw) return undefined;
try { return JSON.parse(raw); } catch { return undefined; }
};
const validateOnboardingCompletionWithData = async (data: OnboardingData): Promise<{isValid: boolean, missingSteps: string[]}> => {
console.log('FinalStep: Validating onboarding completion with data...');
console.log('FinalStep: Data to validate:', data);
const missingSteps: string[] = [];
try {
// Check API Keys (Step 1) - Since the user is on step 5 (FinalStep),
// they must have completed step 1 (API Keys) to get here
// The backend has EXA_API_KEY and GEMINI_API_KEY in .env and user completed step 1
const hasApiKeys = true; // User is on final step, so step 1 must be completed
console.log('FinalStep: API Keys check:', {
hasApiKeys,
reason: 'User is on final step, so step 1 (API Keys) must be completed',
note: 'Backend has EXA_API_KEY and GEMINI_API_KEY in .env'
});
if (!hasApiKeys) {
missingSteps.push('API Keys');
}
// Check Website Analysis (Step 2) - Check for website URL or analysis data
const hasWebsiteAnalysis = (data.websiteUrl && data.websiteUrl.trim() !== '') ||
(data.styleAnalysis && Object.keys(data.styleAnalysis).length > 0);
console.log('FinalStep: Website Analysis check:', {
websiteUrl: data.websiteUrl,
styleAnalysis: data.styleAnalysis,
hasWebsiteAnalysis
});
if (!hasWebsiteAnalysis) {
missingSteps.push('Website Analysis');
}
// Check Research Preferences (Step 3) - Check for research preferences data
const hasResearchPreferences = data.researchPreferences &&
(data.researchPreferences.research_depth ||
data.researchPreferences.content_characteristics ||
Object.keys(data.researchPreferences).length > 0);
console.log('FinalStep: Research Preferences check:', {
researchPreferences: data.researchPreferences,
hasResearchPreferences
});
if (!hasResearchPreferences) {
missingSteps.push('Research Preferences');
}
// Check Persona Generation (Step 4) - Check for persona readiness or data
const hasPersonaData = (data.personaReadiness && data.personaReadiness.isReady) ||
(data.personalizationSettings && Object.keys(data.personalizationSettings).length > 0);
console.log('FinalStep: Persona Generation check:', {
personaReadiness: data.personaReadiness,
personalizationSettings: data.personalizationSettings,
hasPersonaData
});
if (!hasPersonaData) {
missingSteps.push('Persona Generation');
}
// Check Integrations (Step 5) - For now, we'll consider this optional
// In the future, this could check for specific integration data
const isValid = missingSteps.length === 0;
console.log('FinalStep: Validation result:', {isValid, missingSteps});
return {isValid, missingSteps};
} catch (error) {
console.error('FinalStep: Error validating completion:', error);
return {isValid: false, missingSteps: ['Validation Error']};
}
};
const validateOnboardingCompletion = async (): Promise<{isValid: boolean, missingSteps: string[]}> => {
return validateOnboardingCompletionWithData(onboardingData);
};
const handleLaunch = async () => {
console.log('FinalStep: handleLaunch called - button clicked');
console.log('FinalStep: handleLaunch - starting execution');
console.log('FinalStep: handleLaunch - current state:', {loading, error, validationStatus, dataLoading});
if (loading) {
console.log('FinalStep: Already processing, ignoring click');
return;
}
// Wait for data to be fully loaded before proceeding
if (dataLoading) {
console.log('FinalStep: Data still loading, waiting...');
// Wait a bit and try again
setTimeout(() => {
if (!dataLoading) {
handleLaunch();
}
}, 100);
return;
}
setLoading(true);
setError(null);
try {
console.log('FinalStep: Starting onboarding completion...');
// First, validate that all required steps are completed
console.log('FinalStep: Validating all required steps...');
const validationResult = await validateOnboardingCompletion();
if (!validationResult.isValid) {
throw new Error(`Cannot complete onboarding. Missing steps: ${validationResult.missingSteps.join(', ')}`);
}
console.log('FinalStep: All required steps validated successfully');
// Complete step 6 (Final Step) to mark it as completed
console.log('FinalStep: Completing step 6...');
console.log('FinalStep: Calling setCurrentStep(6)...');
const step6Result = await setCurrentStep(6);
console.log('FinalStep: Step 6 completed successfully:', step6Result);
// Complete the entire onboarding process
console.log('FinalStep: Completing onboarding...');
console.log('FinalStep: Calling completeOnboarding()...');
const completionResult = await completeOnboarding();
console.log('FinalStep: Onboarding completed successfully:', completionResult);
// Mark onboarding as complete locally to unblock immediate navigation
try {
localStorage.setItem('onboarding_complete', 'true');
localStorage.setItem('onboarding_active_step', String(stepsLengthFallback()));
} catch {}
// Show TaskSchedulingPanel with completion result (auto-redirect starts)
const typedResult: OnboardingCompletionResult = {
message: completionResult?.message || 'Onboarding completed successfully',
completed_at: completionResult?.completed_at || new Date().toISOString(),
completion_percentage: completionResult?.completion_percentage ?? 100,
persona_generated: completionResult?.persona_generated ?? false,
scheduled_tasks: completionResult?.scheduled_tasks || [],
failed_tasks: completionResult?.failed_tasks || null,
};
setCompletionResult(typedResult);
} catch (e: any) {
console.error('FinalStep: Error completing onboarding:', e);
console.error('FinalStep: Error details:', {
message: e.message,
status: e.response?.status,
statusText: e.response?.statusText,
data: e.response?.data,
stack: e.stack
});
// Error handling is managed by global API client interceptors
// Provide more specific error messages
let errorMessage = 'Failed to complete onboarding. Please try again.';
if (e.response?.data?.detail) {
errorMessage = e.response.data.detail;
} else if (e.response?.data?.message) {
errorMessage = e.response.data.message;
} else if (e.message) {
errorMessage = e.message;
}
setError(errorMessage);
}
setLoading(false);
};
// Helper to compute steps length for storing active step (fallback value)
const stepsLengthFallback = () => 6;
const capabilities: Capability[] = [
{
id: 'ai-content',
title: 'AI Content Generation',
description: 'Generate high-quality, personalized content using advanced AI models',
icon: <CheckCircle />,
unlocked: Object.keys(onboardingData.apiKeys).length > 0,
required: ['API Keys']
},
{
id: 'style-analysis',
title: 'Style Analysis',
description: 'Analyze and match your brand\'s writing style and tone',
icon: <CheckCircle />,
unlocked: !!onboardingData.websiteUrl,
required: ['Website URL']
},
{
id: 'research-tools',
title: 'AI Research Tools',
description: 'Automated research and fact-checking capabilities',
icon: <CheckCircle />,
unlocked: !!onboardingData.researchPreferences,
required: ['Research Configuration']
},
{
id: 'personalization',
title: 'Content Personalization',
description: 'Tailored content based on your brand voice and preferences',
icon: <CheckCircle />,
unlocked: !!onboardingData.personalizationSettings,
required: ['Personalization Settings']
},
{
id: 'integrations',
title: 'Third-party Integrations',
description: 'Connect with external tools and platforms',
icon: <CheckCircle />,
unlocked: !!onboardingData.integrations,
required: ['Integration Setup']
}
];
const getMissingRequirements = () => {
const missing = [];
if (Object.keys(onboardingData.apiKeys).length === 0) {
missing.push('At least one AI provider API key');
}
if (!onboardingData.websiteUrl) {
missing.push('Website URL for style analysis');
}
return missing;
};
const missingRequirements = getMissingRequirements();
return (
<Fade in={true} timeout={500}>
<Container maxWidth="lg" sx={{ py: 2 }}>
{/* Loading State */}
{dataLoading && (
<Box sx={{ display: 'flex', justifyContent: 'center', alignItems: 'center', py: 8 }}>
<Box sx={{ textAlign: 'center' }}>
<CircularProgress size={60} sx={{ mb: 2 }} />
<Typography variant="h6" sx={{ mb: 1 }}>
Loading your configuration...
</Typography>
<Typography variant="body2" color="text.secondary">
Retrieving your onboarding data and settings
</Typography>
</Box>
</Box>
)}
{/* Content - Only show when data is loaded */}
{!dataLoading && (
<React.Fragment>
{/* Post-completion: show TaskSchedulingPanel and hide setup details */}
{completionResult ? (
<React.Fragment>
<TaskSchedulingPanel
scheduledTasks={completionResult.scheduled_tasks}
failedTasks={completionResult.failed_tasks || []}
personaGenerated={completionResult.persona_generated}
completedAt={completionResult.completed_at}
/>
<Box sx={{ display: 'flex', justifyContent: 'center', mt: 3, gap: 2 }}>
<Button
variant="contained"
size="large"
startIcon={<Rocket />}
onClick={() => navigate('/dashboard', { replace: true })}
sx={{
background: 'linear-gradient(135deg, #0f172a 0%, #312e81 40%, #4f46e5 100%)',
fontSize: '1.125rem',
fontWeight: 600,
px: 4,
py: 2,
borderRadius: 999,
textTransform: 'none',
boxShadow: '0 10px 28px rgba(15,23,42,0.45)',
letterSpacing: 0.2,
'&:hover': {
background: 'linear-gradient(135deg, #020617 0%, #1e1b4b 40%, #4338ca 100%)',
transform: 'translateY(-1px)',
boxShadow: '0 14px 36px rgba(15,23,42,0.55)',
},
}}
>
Go to Dashboard
</Button>
</Box>
<Box sx={{ mt: 2, textAlign: 'center' }}>
<Typography variant="body2" color="text.secondary">
Auto-redirecting to dashboard in {countdown ?? 0}s...
</Typography>
</Box>
</React.Fragment>
) : (
<React.Fragment>
{/* Setup Summary */}
<SetupSummary
onboardingData={onboardingData}
capabilities={capabilities}
expandedSection={expandedSection}
setExpandedSection={setExpandedSection}
/>
{/* Capabilities Overview */}
<CapabilitiesOverview capabilities={capabilities} />
{/* Agent Team */}
{agentTeamError && (
<Alert severity="warning" sx={{ mt: 3, borderRadius: 2 }}>
<Typography variant="subtitle2" sx={{ fontWeight: 600, mb: 0.5 }}>
Agent team configuration unavailable
</Typography>
<Typography variant="body2">{agentTeamError}</Typography>
</Alert>
)}
{!agentTeamError && agentTeam.length > 0 && (
<AgentTeamSection websiteName={websiteName} agents={agentTeam} contextCard={agentContextCard} />
)}
{/* Missing Requirements Warning */}
{missingRequirements.length > 0 && (
<Zoom in={true} timeout={1400}>
<Alert
severity="warning"
sx={{ mb: 4, borderRadius: 2 }}
action={
<Button color="inherit" size="small">
Configure Now
</Button>
}
>
<Typography variant="subtitle2" sx={{ fontWeight: 600, mb: 1 }}>
Missing Requirements
</Typography>
<Typography variant="body2">
The following items are recommended for optimal experience: {missingRequirements.join(', ')}
</Typography>
</Alert>
</Zoom>
)}
{/* Alerts */}
<Box sx={{ mt: 3 }}>
{error && (
<Fade in={true}>
<Alert
severity="error"
sx={{ mb: 2, borderRadius: 2 }}
action={
<Box sx={{ display: 'flex', gap: 1 }}>
<Button
color="inherit"
size="small"
onClick={() => setError(null)}
>
Dismiss
</Button>
</Box>
}
>
<Typography variant="subtitle2" sx={{ fontWeight: 600, mb: 1 }}>
Setup Incomplete
</Typography>
<Typography variant="body2">
{error}
</Typography>
</Alert>
</Fade>
)}
</Box>
{/* Validation Status */}
{validationStatus && !validationStatus.isValid && (
<Box sx={{ mb: 3 }}>
<Alert severity="warning" sx={{ borderRadius: 2 }}>
<Typography variant="subtitle2" sx={{ fontWeight: 600, mb: 1 }}>
Setup Incomplete
</Typography>
<Typography variant="body2" sx={{ mb: 1 }}>
The following steps need to be completed before launching:
</Typography>
<Box component="ul" sx={{ pl: 2, m: 0 }}>
{validationStatus.missingSteps.map((step, index) => (
<li key={index}>
<Typography variant="body2">{step}</Typography>
</li>
))}
</Box>
</Alert>
</Box>
)}
{/* Launch Button */}
<Box sx={{ display: 'flex', justifyContent: 'center', mt: 4 }}>
<Button
variant="contained"
size="large"
disabled={loading || dataLoading}
onClick={handleLaunch}
startIcon={<Rocket />}
sx={{
background: 'linear-gradient(135deg, #0f172a 0%, #312e81 40%, #4f46e5 100%)',
fontSize: '1.125rem',
fontWeight: 600,
px: 4,
py: 2,
borderRadius: 999,
textTransform: 'none',
boxShadow: '0 10px 28px rgba(15,23,42,0.45)',
letterSpacing: 0.2,
'&:hover': {
background: 'linear-gradient(135deg, #020617 0%, #1e1b4b 40%, #4338ca 100%)',
transform: 'translateY(-1px)',
boxShadow: '0 14px 36px rgba(15,23,42,0.55)',
},
'&:disabled': {
background: 'rgba(148,163,184,0.4)',
color: 'rgba(15,23,42,0.6)',
boxShadow: 'none',
transform: 'none',
}
}}
>
Launch Alwrity & Complete Setup
</Button>
</Box>
{/* Help Text */}
<Box sx={{ mt: 3, textAlign: 'center' }}>
<Typography variant="body2" color="text.secondary" sx={{ mb: 1.5 }}>
This will complete your onboarding and launch Alwrity with your configured settings.
</Typography>
<Typography
variant="body2"
color="text.secondary"
sx={{ display: 'flex', alignItems: 'center', justifyContent: 'center', gap: 1 }}
>
<Star sx={{ fontSize: 16, color: '#fbbf24' }} />
Your SIF Agent Framework is ready to orchestrate your marketing.
</Typography>
</Box>
</React.Fragment>
)}
</React.Fragment>
)}
</Container>
</Fade>
);
};
export default FinalStep;