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
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
import asyncio
|
||||
import time
|
||||
from datetime import datetime, timedelta
|
||||
from typing import Any, Dict
|
||||
@@ -16,6 +17,9 @@ from utils.logger_utils import get_service_logger
|
||||
|
||||
logger = get_service_logger("deep_competitor_analysis_executor")
|
||||
|
||||
DEEP_COMPETITOR_TIMEOUT_SECONDS = 300 # 5-minute hard timeout
|
||||
DEEP_COMPETITOR_MAX_COMPETITORS = 10 # cap to reduce API pressure
|
||||
|
||||
|
||||
class DeepCompetitorAnalysisExecutor(TaskExecutor):
|
||||
def __init__(self):
|
||||
@@ -82,17 +86,23 @@ class DeepCompetitorAnalysisExecutor(TaskExecutor):
|
||||
retryable=False
|
||||
)
|
||||
|
||||
max_competitors = int(payload.get("max_competitors") or 25)
|
||||
max_competitors = min(int(payload.get("max_competitors") or 25), DEEP_COMPETITOR_MAX_COMPETITORS)
|
||||
crawl_concurrency = int(payload.get("crawl_concurrency") or 4)
|
||||
mode = payload.get("mode", "deep_analysis")
|
||||
|
||||
if mode == "strategic_insights":
|
||||
logger.info(f"Executing weekly strategic insights for user {user_id}")
|
||||
report = await self.analysis_service.generate_weekly_strategy_brief(
|
||||
user_id=user_id,
|
||||
website_analysis=website_analysis if isinstance(website_analysis, dict) else {},
|
||||
competitors=competitors
|
||||
)
|
||||
try:
|
||||
report = await asyncio.wait_for(
|
||||
self.analysis_service.generate_weekly_strategy_brief(
|
||||
user_id=user_id,
|
||||
website_analysis=website_analysis if isinstance(website_analysis, dict) else {},
|
||||
competitors=competitors
|
||||
),
|
||||
timeout=DEEP_COMPETITOR_TIMEOUT_SECONDS
|
||||
)
|
||||
except asyncio.TimeoutError:
|
||||
raise TimeoutError(f"Strategic insights timed out after {DEEP_COMPETITOR_TIMEOUT_SECONDS}s for user {user_id}")
|
||||
|
||||
# Persist to WebsiteAnalysis history
|
||||
analysis_id = website_analysis.get('id')
|
||||
@@ -110,13 +120,19 @@ class DeepCompetitorAnalysisExecutor(TaskExecutor):
|
||||
flag_modified(wa, "strategic_insights_history")
|
||||
db.commit()
|
||||
else:
|
||||
report = await self.analysis_service.run(
|
||||
user_id=user_id,
|
||||
website_analysis=website_analysis if isinstance(website_analysis, dict) else {},
|
||||
competitors=competitors,
|
||||
max_competitors=max_competitors,
|
||||
crawl_concurrency=crawl_concurrency
|
||||
)
|
||||
try:
|
||||
report = await asyncio.wait_for(
|
||||
self.analysis_service.run(
|
||||
user_id=user_id,
|
||||
website_analysis=website_analysis if isinstance(website_analysis, dict) else {},
|
||||
competitors=competitors,
|
||||
max_competitors=max_competitors,
|
||||
crawl_concurrency=crawl_concurrency
|
||||
),
|
||||
timeout=DEEP_COMPETITOR_TIMEOUT_SECONDS
|
||||
)
|
||||
except asyncio.TimeoutError:
|
||||
raise TimeoutError(f"Deep competitor analysis timed out after {DEEP_COMPETITOR_TIMEOUT_SECONDS}s for user {user_id}")
|
||||
|
||||
task.last_executed = datetime.utcnow()
|
||||
task.last_success = datetime.utcnow()
|
||||
|
||||
@@ -103,7 +103,7 @@ class SIFIndexingExecutor(TaskExecutor):
|
||||
guardian_report = None
|
||||
if content_synced:
|
||||
try:
|
||||
from services.intelligence.sif_agents import ContentGuardianAgent
|
||||
from services.intelligence.agents.specialized import ContentGuardianAgent
|
||||
# Re-use the intelligence service from sif_service
|
||||
guardian_agent = ContentGuardianAgent(
|
||||
intelligence_service=sif_service.intelligence_service,
|
||||
|
||||
Reference in New Issue
Block a user