Historical task source. The Eve task board holds current task state.
Phase 23: Veritas - Autonomous AI News Agency Integration#
Yaa is a comprehensive autonomous AI-powered news agency for Ghana with multi-source aggregation, original journalism, multimedia production (video anchors, podcasts, TikTok), local language support (Twi, Ewe, Ga, Hausa), and mobile-first design. This phase integrates Yaa into the Oshun monorepo while enhancing it with state-of-the-art AI capabilities from other Oshun domains.
Domain Assignment: Yaa → Veritas#
Yaa will become the Veritas domain within Oshun, named after the Egyptian goddess of writing, wisdom, knowledge, libraries, and record-keeping. Veritas was the divine scribe who recorded truth and history - perfect for an AI journalism platform focused on fact-checking, bias transparency, and truth-seeking.
Library prefix: @veritas/* App prefix: veritas-*
23.1 Yaa Codebase Analysis & Inventory#
23.1.1 Service & Package Inventory#
-
23.1.1.1 [High/M] Document all Yaa packages and their responsibilities
- Packages: ai/, ingestion/, nlp/, audio/, video/, social/, api/, models/, web/
- Output:
docs/domains/veritas/package-inventory.md - Acceptance: Complete package map with dependencies
-
23.1.1.2 [High/M] Analyze inter-package communication patterns
- Document: REST APIs, event flows, queue patterns
- Document: BullMQ job queue usage
- Document: Redis pub/sub patterns
- Acceptance: Communication architecture documented
-
23.1.1.3 [High/M] Inventory all database schemas
- Document: PostgreSQL schemas (articles, sources, claims, etc.)
- Document: Elasticsearch index mappings
- Document: Redis data structures
- Document: Vector database collections
- Acceptance: Complete data model documentation
-
23.1.1.4 [High/S] Map external API integrations
- AI/LLM: Anthropic Claude, OpenAI GPT-4
- Voice/TTS: ElevenLabs, Ghana NLP Khaya/Abena AI
- Video: Tavus, HeyGen, D-ID, Runway ML
- Fact-Checking: ClaimBuster, Google Fact Check API
- Search: Brave Search, Serper
- Social: YouTube, TikTok, Instagram, WhatsApp, Telegram
- Payments: MTN MoMo, Vodafone Cash, AirtelTigo, Stripe
- Acceptance: Integration inventory complete
23.1.2 Technical Debt Assessment#
-
23.1.2.1 [High/M] Audit Yaa codebase for security vulnerabilities
- Action: Run OWASP security scan
- Action: Review authentication/authorization patterns
- Action: Check for data protection compliance (Ghana DPA)
- Acceptance: Security report with remediation plan
-
23.1.2.2 [Medium/M] Identify code quality issues
- Action: Run ESLint with strict rules
- Action: Identify missing TypeScript types
- Action: Find duplicated code across packages
- Acceptance: Technical debt backlog created
-
23.1.2.3 [Medium/M] Document outdated dependencies
- Action: Compare to Oshun shared dependency catalog
- Action: Identify security updates needed
- Action: Plan Node.js version alignment
- Acceptance: Dependency update plan
-
23.1.2.4 [Medium/S] Assess test coverage
- Action: Run coverage report
- Action: Identify critical paths without tests
- Action: Prioritize test additions
- Acceptance: Test coverage improvement plan
23.2 Yaa to Veritas Domain Refactoring#
23.2.1 Directory Structure Migration#
-
23.2.1.1 [High/L] Create Veritas domain directory structure
- Create:
apps/veritas/for service applications - Create:
libs/veritas/for domain libraries - Create:
libs/contracts/veritas/for API contracts - Update: pnpm-workspace.yaml with veritas paths
- Update: tsconfig.base.json with @veritas/* mappings
- Acceptance: Directory structure matches Oshun patterns
- Create:
-
23.2.1.2 [High/L] Migrate API service to Nx app
- From:
yaa/packages/api/ - To:
apps/veritas/api/ - Implement: Hono-based REST API (replacing Fastify)
- Implement: Nx project.json, proper tsconfig
- Acceptance: Service builds with
nx build veritas-api
- From:
-
23.2.1.3 [High/L] Migrate web application to Nx app
- From:
yaa/packages/web/andyaa/apps/web/ - To:
apps/veritas/web/ - Implement: Next.js 14+ with App Router
- Implement: Nx project.json with Next.js executor
- Acceptance: App builds with
nx build veritas-web
- From:
-
23.2.1.4 [High/L] Create ingestion service app
- From:
yaa/packages/ingestion/ - To:
apps/veritas/ingestion/ - Implement: RSS collector, scraper, scheduler
- Implement: Content processing pipeline
- Acceptance: Service builds with
nx build veritas-ingestion
- From:
-
23.2.1.5 [High/L] Create NLP service app
- From:
yaa/packages/nlp/andyaa/services/nlp/ - To:
apps/veritas/nlp/ - Implement: NER, topic classification, sentiment
- Implement: Summarization, keyword extraction
- Acceptance: Service builds with
nx build veritas-nlp
- From:
-
23.2.1.6 [High/L] Create AI workers service app
- From:
yaa/packages/ai/ - To:
apps/veritas/ai-workers/ - Implement: All 24+ AI worker processes
- Implement: BullMQ job processing
- Acceptance: Service builds with
nx build veritas-ai-workers
- From:
-
23.2.1.7 [High/L] Create audio production service app
- From:
yaa/packages/audio/ - To:
apps/veritas/audio/ - Implement: ElevenLabs TTS integration
- Implement: Ghana NLP voice integration
- Implement: Podcast generation pipeline
- Acceptance: Service builds with
nx build veritas-audio
- From:
-
23.2.1.8 [High/L] Create video production service app
- From:
yaa/packages/video/ - To:
apps/veritas/video/ - Implement: HeyGen avatar video (Tavus not in source)
- Implement: Shotstack composition (Runway ML not in source)
- Implement: Video rendering pipeline with BullMQ
- Acceptance: Service builds with
nx build veritas-video✓
- From:
-
23.2.1.9 [High/L] Create social media service app
- From:
yaa/packages/social/ - To:
apps/veritas/social/ - Implement: YouTube, TikTok, Instagram automation
- Implement: WhatsApp Channel, Telegram posting
- Implement: Unified scheduler
- Acceptance: Service builds with
nx build veritas-social✓
- From:
-
23.2.1.10 [High/M] Create editorial CMS app
- To:
apps/veritas/cms/ - Implement: Content management dashboard
- Implement: AI editorial review interface
- Implement: Publication scheduling
- Acceptance: Service builds with
nx build veritas-cms✓
- To:
-
23.2.1.11 [High/M] Create agent orchestration service app
- From:
yaa/packages/ai/agents/ - To:
apps/veritas/agents/ - Implement: Multi-agent coordination ✓
- Implement: Agent health monitoring ✓
- Implement: Agent communication bus ✓
- Acceptance: Service builds with
nx build veritas-agents✓
- From:
-
23.2.1.12 [Medium/M] Create analytics service app
- To:
apps/veritas/analytics/ - Implement: Content performance tracking
- Implement: User engagement analytics
- Implement: Revenue analytics
- Acceptance: Service builds with
nx build veritas-analytics
- To:
-
23.2.1.13 [Medium/M] Create notification service app
- To:
apps/veritas/notifications/ - Implement: Push notification delivery ✓
- Implement: Smart notification timing ✓
- Implement: Channel preference management ✓
- Acceptance: Service builds with
nx build veritas-notifications✓
- To:
23.2.2 Shared Library Extraction#
-
23.2.2.1 [High/L] Create @veritas/core library
- File:
libs/veritas/core/✓ - Extract: Article, Source, Author types ✓
- Extract: Category, Entity, Media types ✓
- Extract: StoryCluster, Claim, FactCheck types ✓
- Extract: BiasScore, Language types ✓
- Extract: Domain constants and error codes ✓
- Acceptance: Library exports all core primitives ✓
- File:
-
23.2.2.2 [High/L] Create @veritas/models library ✓
- File:
libs/veritas/models/✓ - Migrate:
yaa/packages/models/✓ - Implement: Zod schemas for all models ✓
- Implement: Type inference from schemas ✓
- Acceptance: All data models with validation ✓
- File:
-
23.2.2.3 [High/L] Create @veritas/database library ✓
- File:
libs/veritas/database/ - Implement: Prisma schema for Veritas domain ✓
- Implement: Article, Source, Author models ✓
- Implement: StoryCluster, Claim models ✓
- Implement: User, Subscription models ✓
- Implement: Migrations and seeding ✓
- Acceptance: Full database layer ✓
- File:
-
23.2.2.4 [High/L] Create @veritas/ingestion-core library ✓
- File:
libs/veritas/ingestion-core/✓ - Extract: RSS/Atom feed parsing ✓
- Extract: Web scraping utilities ✓
- Extract: Content normalization ✓
- Extract: Deduplication algorithms ✓
- Extract: Source registry management ✓
- Acceptance: Ingestion primitives extracted ✓
- File:
-
23.2.2.5 [High/L] Create @veritas/nlp-core library ✅
- File:
libs/veritas/nlp-core/ - Extract: NER utilities and pipelines ✓
- Extract: Topic classification ✓
- Extract: Sentiment analysis ✓
- Extract: Summarization interfaces ✓
- Extract: Embedding generation ✓
- Acceptance: NLP primitives extracted ✓
- File:
-
23.2.2.6 [High/L] Create @veritas/fact-checking library ✅
- File:
libs/veritas/fact-checking/ - Extract: Claim extraction service ✓
- Extract: Evidence retrieval ✓
- Extract: Verification scoring ✓
- Extract: Multi-source validation ✓
- Implement: ClaimBuster integration ✓
- Implement: Google Fact Check API ✓
- Acceptance: Fact-checking pipeline complete ✓
- File:
-
23.2.2.7 [High/L] Create @veritas/bias-detection library ✅
- File:
libs/veritas/bias-detection/ - Extract: Political bias scoring ✓
- Extract: Coverage balance analysis ✓
- Extract: Blindspot detection ✓
- Extract: Ghana political spectrum (NPP/NDC) ✓
- Acceptance: Bias detection complete ✓
- File:
-
23.2.2.8 [High/L] Create @veritas/story-clustering library ✅
- File:
libs/veritas/story-clustering/ - Extract: Semantic similarity scoring ✓
- Extract: Cluster creation/merging ✓
- Extract: Timeline construction ✓
- Extract: Canonical story selection ✓
- Acceptance: Clustering algorithms complete ✓
- File:
-
23.2.2.9 [High/L] Create @veritas/ghana-nlp library ✅
- File:
libs/veritas/ghana-nlp/ - Migrate:
yaa/packages/nlp/ghana-nlp/✓ - Implement: Khaya API client ✓
- Implement: Twi processing pipeline ✓
- Implement: Code-switching detection
- Implement: Ghanaian entity dictionary
- Acceptance: Ghana NLP integration complete
- File:
-
23.2.2.10 [High/L] Create @veritas/video-production library ✅
- File:
libs/veritas/video-production/ - Extract: Script generation
- Extract: Avatar management
- Extract: Video rendering pipeline
- Extract: HLS/DASH transcoding
- Implement: Tavus integration
- Implement: HeyGen integration
- Implement: D-ID streaming integration
- Acceptance: Video production primitives complete
- File:
-
23.2.2.11 [High/L] Create @veritas/audio-production library ✅
- File:
libs/veritas/audio-production/ - Extract: TTS orchestration
- Extract: Voice profile management
- Extract: Audio rendering pipeline
- Implement: ElevenLabs integration
- Implement: Ghana NLP Abena AI integration
- Acceptance: Audio production complete
- File:
-
23.2.2.12 [High/M] Create @veritas/social-automation library ✅
- File:
libs/veritas/social-automation/ - Extract: Platform adapters (YouTube, TikTok, etc.)
- Extract: Content formatting per platform
- Extract: Posting schedulers
- Extract: Analytics tracking
- Acceptance: Social automation complete
- File:
-
23.2.2.13 [High/M] Create @veritas/agents-core library ✅
- File:
libs/veritas/agents-core/ - Extract: Agent base classes
- Extract: Message bus protocol
- Extract: State management
- Extract: Health monitoring
- Acceptance: Agent framework complete
- File:
-
23.2.2.14 [Medium/M] Create @veritas/search library ✅
- File:
libs/veritas/search/ - Extract: Elasticsearch client wrapper
- Extract: Index management
- Extract: Query builders
- Extract: Search ranking
- Acceptance: Search utilities complete
- File:
-
23.2.2.15 [Medium/M] Create @veritas/recommendations library ✅
- File:
libs/veritas/recommendations/ - Implement: Content-based filtering
- Implement: Collaborative filtering
- Implement: Diversity injection (anti-filter-bubble)
- Implement: Real-time personalization
- Acceptance: Recommendation engine complete
- File:
-
23.2.2.16 [Medium/M] Create @veritas/payments library ✅
- File:
libs/veritas/payments/ - Implement: MTN Mobile Money integration
- Implement: Vodafone Cash integration
- Implement: AirtelTigo Money integration
- Implement: Stripe integration (international)
- Implement: Subscription management
- Acceptance: Payment integrations complete
- File:
-
23.2.2.17 [Medium/M] Create @veritas/notifications library ✅
- File:
libs/veritas/notifications/ - Implement: Push notification service
- Implement: Email notification templates
- Implement: SMS notification (optional)
- Implement: In-app notifications
- Implement: Smart timing optimization
- Acceptance: Notification system complete
- File:
-
23.2.2.18 [Medium/M] Create @veritas/analytics library ✅
- File:
libs/veritas/analytics/ - Implement: Event tracking ✅
- Implement: User engagement metrics ✅
- Implement: Content performance metrics ✅
- Implement: Revenue analytics ✅
- Acceptance: Analytics library complete ✅
- File:
23.2.3 TypeScript Migration#
-
23.2.3.1 [High/L] Add strict TypeScript to all Veritas libraries ✅
- Config: Enable strict, noImplicitAny, strictNullChecks ✅ (via tsconfig.base.json)
- Implement: Type all function parameters and returns ✅
- Implement: Add interface definitions for all data models ✅
- Acceptance: No TypeScript errors with strict mode ✅ (all 18 libraries build successfully)
-
23.2.3.2 [High/M] Create type definitions for articles and sources ✅
- File:
libs/veritas/core/src/article.ts,source.ts,author.ts✅ - Define: Article, ArticleVersion, ArticleMedia ✅ (Added ArticleVersion, ArticleMedia, ArticleVersionDiff, ArticleCreateInput, ArticleUpdateInput)
- Define: Source, SourceBias, SourceCredibility ✅ (Added SourceBias, SourceCredibility, SourceCredibilityTier, SourceCreateInput, SourceUpdateInput)
- Define: Author, AuthorProfile ✅ (Added AuthorProfile, AuthorCredential, AuthorAffiliation, AuthorBeat, AuthorCreateInput, AuthorUpdateInput)
- Acceptance: Fully typed article system ✅ (Build and lint pass)
- File:
-
23.2.3.3 [High/M] Create type definitions for fact-checking ✅
- File:
libs/veritas/fact-checking/src/types.ts✅ - Define: Claim, Evidence, VerificationResult ✅ (Already existed + enhanced)
- Define: FactCheckStatus, ConfidenceLevel ✅ (Added ConfidenceLevel, ConfidenceLevelInfo with full metadata)
- Enhanced: FactCheckVerdict, VerdictAppeal, PipelineResult, FactCheckReport, BatchFactCheckJob, DTOs
- Acceptance: Fully typed fact-checking ✅ (Build and lint pass)
- File:
-
23.2.3.4 [High/M] Create type definitions for bias scoring ✅
- File:
libs/veritas/bias-detection/src/types.ts✅ - Define: BiasScore, PoliticalLean, CoverageBalance ✅ (Added BiasScore interface, PoliticalLean type with info, CoverageBalanceInterpretation)
- Define: GhanaPoliticalSpectrum enum ✅ (Added GHANA_POLITICAL_SPECTRUM with NPP/NDC/IND metadata)
- Enhanced: AggregateBiasAnalysis, BiasTrendAnalysis, SourceBiasProfile, DTOs
- Acceptance: Fully typed bias system ✅ (Build and lint pass)
- File:
-
23.2.3.5 [Medium/M] Create type definitions for agents ✅
- File:
libs/veritas/agents-core/src/types.ts✅ (already comprehensive) - Define: Agent, AgentMessage, AgentState ✅ (AgentConfig, Message<T>, AgentState interfaces)
- Define: AgentRole, AgentCapability ✅ (AgentRole enum, AgentCapabilities interface)
- Already includes: TaskType, TaskStatus, TaskPriority enums, Message/Event types, Zod schemas
- Acceptance: Fully typed agent system ✅ (Build and lint pass)
- File:
23.3 Integration with Oshun Shared Libraries#
23.3.1 Authentication Integration#
-
23.3.1.1 [High/L] Integrate with @oshun/auth ✅
- Action: Replace custom auth with @oshun/auth
- Implement: User model alignment
- Implement: Session management via shared auth
- Implement: Role-based access control
- Implement: API key management for B2B
- Acceptance: Single auth system across Oshun
- Done: Created @veritas/auth with VeritasAuthAdapter, Hono middleware, ApiKeyService
-
23.3.1.2 [High/M] Implement OAuth provider support ✅
- Implement: Google OAuth
- Implement: Apple Sign-In
- Implement: Facebook OAuth
- Implement: Phone number OTP (Ghana)
- Acceptance: Multiple auth providers supported
- Done: Added GoogleOAuthProvider, AppleOAuthProvider, FacebookOAuthProvider, PhoneOtpService with Ghana number support
-
23.3.1.3 [Medium/M] Implement guest browsing mode ✅
- Implement: Anonymous session tracking
- Implement: Limited feature access
- Implement: Conversion prompts
- Acceptance: Guest mode works properly
- Done: GuestSessionService with session management, article/comment access control, activity tracking, and conversion prompts; Hono middleware for guest sessions with cookie management and access enforcement
23.3.2 Database Integration#
-
23.3.2.1 [High/M] Migrate to @oshun/database patterns ✅
- Action: Replace direct Prisma clients with @oshun/database
- Implement: Migration of Yaa schemas
- Implement: Connection pooling via shared pool
- Acceptance: Unified database access layer
- Done: Integrated @oshun/database patterns - enhanced health checking with caching/thresholds/HealthMonitor, DatabaseError with Prisma error mapping, DatabaseMetricsTracker for operation metrics, transaction helpers (withSerializableTransaction, withReadOnlyTransaction), connection string utilities, retry utilities, pagination helpers
-
23.3.2.2 [High/M] Create Veritas Prisma schemas ✅
- File:
libs/veritas/database/prisma/ - Implement: Article model with full metadata
- Implement: Source model with bias tracking
- Implement: StoryCluster model
- Implement: Claim and FactCheck models
- Implement: User preferences model
- Acceptance: Full schema coverage
- Done: Comprehensive Prisma schema with 60+ models including Article (full metadata, engagement, media), Source (bias tracking, feeds), StoryCluster (clustering methods, merge tracking), Claim/FactCheck (verification, evidence), User preferences (reads, saves, follows), plus taxonomy, entities, media assets, audio/video rendering, push notifications, and content scheduling models
- File:
-
23.3.2.3 [Medium/M] Implement data isolation patterns ✅
- Implement: Multi-tenant architecture (for future white-label)
- Implement: Row-level security policies
- Acceptance: Data properly isolated
- Done: Multi-tenant module with Tenant entity, TenantSettings/Branding, tenant context management (withTenant, setTenantContext), isolation strategies (column/schema/database), tenant-aware query helpers, RLS policy generators (generateTenantRlsPolicy, generateRlsSetupSql), ITenantRepository with InMemoryTenantRepository, tenant resolution helpers
23.3.3 Caching Integration#
-
23.3.3.1 [High/M] Migrate to @oshun/cache patterns
- Action: Replace direct Redis with @oshun/cache
- Implement: Article caching
- Implement: Search results caching
- Implement: User session caching
- Acceptance: Unified caching layer
- Done: Created @veritas/cache library (libs/veritas/cache/) with:
- Cache key builders (keys.ts): articleKey, searchResultsKey, sessionKey, userProfileKey, trendingTopicsKey, recommendationsKey, and 30+ more
- TTL constants (ttl.ts): VERITAS_TTL with article, search, session, trending, guest, and system TTL values
- ArticleCache (article-cache.ts): Full articles, metadata, lists, related articles, view/share counters, invalidation
- SearchCache (search-cache.ts): Search results, trending topics/articles, user recommendations, cache warming
- SessionCache (session-cache.ts): User profiles, preferences, saved articles, read history, authenticated sessions, guest sessions with view tracking and limits
- VeritasCacheService (service.ts): Unified service integrating all caches with memory cache support, generic operations, global instance management
- Fixed @oshun/cache and @oshun/logging ESM import issues (ioredis, pino)
-
23.3.3.2 [Medium/M] Implement real-time state synchronization
- Implement: Breaking news alerts
- Implement: Live article updates
- Implement: Viewer count tracking
- Acceptance: Real-time state works via shared cache
- Done: Created VeritasRealtimeService in realtime.ts with:
- Breaking news: publishBreakingNews, getActiveBreakingNews, dismissBreakingNews, subscribeToBreakingNews with priority levels (critical/high/normal)
- Live article updates: publishArticleUpdate, publishArticleStatus, subscribeToArticleUpdates (per-article and all), subscribeToArticleStatus
- Viewer tracking: registerViewer, updateViewerActivity, unregisterViewer, getViewerCount, getViewerCounts, getActiveViewers, cleanupStaleViewers, subscribeToViewerCount
- Editor presence: registerEditorPresence, updateEditorCursor, removeEditorPresence, getActiveEditors, subscribeToEditorPresence
- Additional events: fact-check updates, story cluster updates, trending updates, source status changes
- VERITAS_CHANNELS and REALTIME_KEYS constants for pub/sub channels
- Added BREAKING_NEWS, EDITOR_PRESENCE, VIEWER_SESSION TTL values
23.3.4 Messaging Integration#
-
23.3.4.1 [High/M] Migrate to @oshun/event-bus patterns ✅
- Action: Replace custom messaging with @oshun/event-bus
- Implement: Event-driven architecture alignment
- Implement: Domain event types for Veritas
- Acceptance: Unified messaging layer
- Completed: Created @veritas/events library with VeritasEventPublisher, VeritasEventSubscriber, and 45+ typed domain event payloads
-
23.3.4.2 [Medium/M] Define Veritas domain events ✅
- File:
libs/contracts/src/events/veritas.ts - Define: ArticlePublishedEvent, ArticleUpdatedEvent
- Define: FactCheckCompletedEvent
- Define: StoryClusterCreatedEvent
- Define: VideoGeneratedEvent, AudioGeneratedEvent
- Define: AlertTriggeredEvent
- Acceptance: Domain events published to shared bus
- Completed: Created 25+ Zod-validated event schemas with typed payloads including article, claim, story, feed, media, alert, analytics, and NLP events
- File:
23.3.5 Storage Integration#
-
23.3.5.1 [High/M] Migrate to @oshun/storage patterns ✅
- Action: Use shared S3 abstraction
- Implement: Media storage organization
- Implement: Video/audio storage
- Implement: Signed URL generation
- Acceptance: Unified storage access
- Completed: Created @veritas/storage library with ArticleStorageService, MediaStorageService, and ArchiveStorageService
-
23.3.5.2 [Medium/M] Implement content organization ✅
- Implement: Folder structure for articles
- Implement: Media asset organization
- Implement: Archive management
- Acceptance: Content properly organized
- Completed: Implemented date-partitioned folder structures, media variants, thumbnails, transcripts, and archive management with manifest support
23.4 Isis Domain Integration - AI Features#
Integrate Isis AI capabilities for intelligent journalism features.
23.4.1 LLM Integration#
-
23.4.1.1 [High/L] Create @veritas/llm library
- Implement: Claude API integration for content generation ✓
- Implement: GPT-4 fallback for reliability ✓
- Implement: Prompt engineering for journalism ✓
- Implement: Cost optimization and routing ✓
- Acceptance: LLM integration complete ✓
- Created standalone @veritas/llm library with Anthropic/OpenAI SDKs
-
23.4.1.2 [High/M] Create journalism-specific prompts
- Implement: Article summarization prompts ✓
- Implement: Headline generation prompts ✓
- Implement: Fact-check explanation prompts ✓
- Implement: Breaking news draft prompts ✓
- Acceptance: Prompt library complete ✓
- Location: libs/veritas/llm/src/prompts.ts
-
23.4.1.3 [Medium/M] Implement content safety filtering
- Implement: Misinformation detection ✓
- Implement: Harmful content filtering ✓
- Implement: Editorial policy enforcement ✓
- Acceptance: Safety filters active ✓
- Location: libs/veritas/llm/src/content-safety.ts
23.4.2 AI Content Analysis#
-
23.4.2.1 [High/L] Implement AI-powered claim extraction ✓
- Use: Claude/GPT-4 for claim identification ✓
- Implement: Claim boundary detection ✓
- Implement: Claim importance scoring ✓
- Implement: Claim categorization ✓
- Acceptance: Claims auto-extracted from articles ✓
- Location: libs/veritas/claims/
-
23.4.2.2 [High/M] Implement AI fact-checking assistance ✓
- Implement: Evidence search and ranking ✓
- Implement: Source credibility assessment ✓
- Implement: Verdict explanation generation ✓
- Acceptance: AI-assisted fact-checking works ✓
- Location: libs/veritas/fact-checking/src/ai-assist/
-
23.4.2.3 [Medium/M] Implement content classification ✓
- Implement: Topic auto-detection ✓
- Implement: Sensitivity classification ✓
- Implement: Priority scoring ✓
- Acceptance: Content auto-classified ✓
- Location: libs/veritas/content-classification/
23.4.3 AI Content Generation#
-
23.4.3.1 [High/XL] Implement autonomous article generation
- Implement: Research and data gathering ✓
- Implement: Multi-source synthesis ✓
- Implement: Draft generation with citations ✓
- Implement: Editorial voice consistency ✓
- Implement: Fact-verification integration ✓
- Acceptance: AI generates publishable articles ✓
- Location: libs/veritas/article-generation/
-
23.4.3.2 [High/L] Implement automated content types ✓
- Implement: Weather report generator (Ghana Met Service) ✓
- Implement: Sports score articles (GPL, Black Stars) ✓
- Implement: Market summaries (GSE, forex) ✓
- Implement: Traffic updates (Accra) ✓
- Implement: Fuel price updates ✓
- Implement: ECG load shedding tracker ✓
- Acceptance: Automated content flows smoothly ✓
- Location: libs/veritas/automated-content/
-
23.4.3.3 [High/M] Implement headline generation ✅
- Implement: Multiple headline variants ✓
- Implement: SEO optimization ✓
- Implement: A/B testing integration ✓
- Implement: Click-bait avoidance ✓
- Acceptance: Headlines auto-generated ✓
- Location: libs/veritas/headline-service/
23.5 Sophia Domain Integration - Knowledge Features#
Integrate Sophia's knowledge management for research capabilities.
23.5.1 Knowledge Graph Integration#
-
23.5.1.1 [High/L] Integrate with @sophia/knowledge-graph ✅
- Implement: Entity extraction and linking ✓
- Implement: Relationship mapping ✓
- Implement: Temporal knowledge tracking ✓
- Acceptance: Knowledge graph populated ✓
- Location: libs/veritas/knowledge-graph/
-
23.5.1.2 [Medium/M] Build entity profiles ✅
- Implement: Politician profiles (Ghana) ✓
- Implement: Organization profiles ✓
- Implement: Location/region profiles ✓
- Implement: Event tracking ✓
- Acceptance: Entity profiles available ✓
- Location: libs/veritas/knowledge-graph/src/profiles/
23.5.2 RAG Integration#
-
23.5.2.1 [High/M] Integrate with @sophia/rag
- Implement: Article archive indexing ✓
- Implement: Semantic search ✓
- Implement: Context retrieval for AI ✓
- Acceptance: RAG pipeline works ✓
- Location: libs/veritas/rag/
-
23.5.2.2 [Medium/M] Build research assistant
- Implement: Historical context retrieval ✓
- Implement: Related story discovery ✓
- Implement: Background briefing generation ✓
- Acceptance: Research assistant functional ✓
- Location: libs/veritas/research-assistant/
23.6 AI Agent Framework#
Implement autonomous AI agents for newsroom operations.
23.6.1 Core Agent Infrastructure#
-
23.6.1.1 [High/XL] Implement multi-agent orchestration ✅
- Implement: Agent registration and discovery
- Implement: Message bus for agent communication
- Implement: Task assignment and routing
- Implement: Conflict resolution
- Acceptance: Multi-agent system operational
- Completed: Created
@veritas/agents-orchestratorlibrary with:AgentRegistryfor agent registration, discovery, and lifecycle managementTaskRouterfor intelligent task assignment with multiple routing strategiesConflictResolverfor handling multi-agent conflictsMultiAgentOrchestratoras the unified orchestration service- Redis-backed distributed deployment support
-
23.6.1.2 [High/L] Implement agent state management ✅
- Implement: Persistent agent memory
- Implement: Context window management
- Implement: State snapshots and recovery
- Acceptance: Agent state persists correctly
- Completed: Enhanced
@veritas/agents-corewith:StateManager: Persistent storage, context, stats, snapshots, historyContextWindowManager: Token counting, budget allocation, summarization, pruning- Redis-backed distributed storage with compression
- Rolling summarization for long conversations
-
23.6.1.3 [High/M] Implement agent health monitoring ✅
- Implement: Heartbeat checks
- Implement: Performance metrics
- Implement: Auto-restart on failure
- Implement: Escalation alerts
- Acceptance: Agents self-heal
- Completed:
@veritas/agents-coreincludesHealthMonitorclass with:- Periodic health checks with configurable intervals
- Issue detection (latency, queue backlog, memory pressure, unresponsive)
- Self-healing (restart, failover, clear queue, alert operator)
- Rate limiting for healing actions
- Event emission for integration
23.6.2 Editorial Agents#
-
23.6.2.1 [High/XL] Implement Editor-in-Chief agent
- Implement: Editorial judgment with Claude
- Implement: News prioritization (P0-P3)
- Implement: Breaking news protocols
- Implement: Brand voice enforcement
- Implement: Cross-platform strategy
- Acceptance: Editor-in-Chief operates autonomously
-
23.6.2.2 [High/L] Implement Managing Editor agent
- Implement: Content flow management
- Implement: Quality control pipeline
- Implement: Deadline management
- Implement: Bottleneck detection
- Acceptance: Managing Editor coordinates production
-
23.6.2.3 [High/L] Implement Content Strategist agent
- Implement: Performance analysis
- Implement: Audience engagement prediction
- Implement: Trend detection
- Implement: Content gap identification
- Acceptance: Content strategy optimized
23.6.3 Journalism Agents#
-
23.6.3.1 [High/XL] Implement Political Correspondent agent
- Implement: Parliament coverage automation
- Implement: Election tracking
- Implement: Policy analysis
- Implement: Source relationship memory
- Acceptance: Political coverage autonomous
-
23.6.3.2 [High/L] Implement Business Correspondent agent
- Implement: Economic indicators tracking
- Implement: Company news monitoring
- Implement: Market analysis
- Acceptance: Business coverage autonomous
-
23.6.3.3 [High/L] Implement Sports Correspondent agent
- Implement: Ghana Premier League coverage
- Implement: Black Stars tracking
- Implement: International sports
- Acceptance: Sports coverage autonomous
-
23.6.3.4 [High/L] Implement Regional Correspondent agents
- Implement: 16 Ghana region coverage
- Implement: Local news detection
- Implement: Regional source cultivation
- Acceptance: Regional coverage complete
-
23.6.3.5 [High/L] Implement Investigative Journalism agent
- Implement: OSINT capabilities
- Implement: Document analysis
- Implement: Source protection
- Implement: Long-form investigation support
- Acceptance: Investigative capability operational
-
23.6.3.6 [High/M] Implement Breaking News agent
- Implement: Alert detection
- Implement: Rapid draft generation
- Implement: Multi-channel distribution
- Implement: Update tracking
- Acceptance: Breaking news <5 minute response
23.6.4 Fact-Checker Agent#
- 23.6.4.1 [High/L] Implement Fact-Checker agent
- Implement: Claim identification
- Implement: Multi-source verification
- Implement: Evidence ranking
- Implement: Confidence scoring
- Implement: IFCN methodology compliance
- Acceptance: Fact-checking autonomous
23.6.5 Social Media Agent#
- 23.6.5.1 [High/L] Implement Social Media Manager agent ✅
- Implement: Platform-specific adaptation ✅
- Implement: Engagement monitoring ✅
- Implement: Crisis detection ✅
- Implement: Viral content identification ✅
- Implement: Community management ✅
- Acceptance: Social media autonomous ✅
23.6.6 Technical Agents#
-
23.6.6.1 [Medium/L] Implement DevOps agent ✅
- Implement: Infrastructure monitoring ✅
- Implement: Auto-scaling decisions ✅
- Implement: Incident response ✅
- Implement: Cost optimization ✅
- Acceptance: DevOps autonomous ✅
-
23.6.6.2 [Medium/L] Implement QA agent ✅
- Implement: Automated test generation ✅
- Implement: Regression detection ✅
- Implement: Performance testing ✅
- Acceptance: QA autonomous ✅
-
23.6.6.3 [Medium/M] Implement Product Manager agent ✅
- Implement: User feedback analysis ✅
- Implement: Feature prioritization ✅
- Implement: Competitive intelligence ✅
- Acceptance: Product decisions data-driven ✅
23.7 Video Production Pipeline#
State-of-the-art AI video production for news content.
23.7.1 AI Anchor System#
-
23.7.1.1 [High/XL] Implement Tavus digital twin integration ✅
- Implement: Custom AI anchor creation (Yaa Asantewaa) ✅
- Implement: Real-time video generation ✅
- Implement: Lip-sync with Ghana NLP voices ✅
- Implement: Multi-anchor support ✅
- Acceptance: Tavus anchors operational ✅
-
23.7.1.2 [High/L] Implement HeyGen fallback integration
- Implement: Stock avatar configuration
- Implement: Video generation queue
- Implement: Quality validation
- Acceptance: HeyGen backup operational
-
23.7.1.3 [High/L] Implement D-ID streaming integration
- Implement: Real-time streaming avatar
- Implement: Interactive capabilities
- Implement: 24/7 live stream support
- Acceptance: D-ID streaming works
-
23.7.1.4 [High/M] Create AI anchor personas
- Create: Yaa Asantewaa (Female, English, Authoritative)
- Create: Kofi Mensah (Male, English, Conversational)
- Create: Akua Nyarko (Female, Twi, Warm)
- Create: Kwame Owusu (Male, Twi, Energetic)
- Create: Ama Serwaa (Female, Ewe, Professional)
- Acceptance: 5+ anchor personas available
23.7.2 Video Generation Pipeline#
-
23.7.2.1 [High/L] Implement script-to-video pipeline
- Implement: Script parsing and timing ✓
- Implement: Scene composition ✓
- Implement: B-roll insertion points ✓
- Implement: Graphics and lower thirds ✓
- Acceptance: Scripts become videos ✓
- Created:
apps/veritas/video/src/services/video-pipeline.ts - Features: Script parsing with timing estimation, scene composition (anchor/B-roll/graphics), B-roll insertion point generation, timeline building, video generation via unified provider
-
23.7.2.2 [High/L] Implement Runway ML B-roll generation
- Implement: Text-to-video for B-roll ✓
- Implement: Image-to-video transitions ✓
- Implement: Stock footage integration ✓
- Acceptance: B-roll auto-generated ✓
- Created:
apps/veritas/video/src/providers/runway.ts- Runway ML client - Created:
apps/veritas/video/src/providers/stock-footage.ts- Pexels stock footage client - Created:
apps/veritas/video/src/services/broll.ts- Unified B-roll generation service - Features: Text-to-video (Veo 3.1), image-to-video (Gen4 Turbo), stock footage search, fallback strategies, Ghana-specific content optimization, batch generation
-
23.7.2.3 [High/M] Implement video rendering pipeline
- Implement: Shotstack/JSON2Video integration ✓
- Implement: Template management ✓
- Implement: Multi-quality transcoding ✓
- Implement: HLS/DASH output ✓
- Acceptance: Videos render at scale ✓
- Files:
apps/veritas/video/src/providers/shotstack.ts- Comprehensive Shotstack clientapps/veritas/video/src/services/video-rendering.ts- Full video production orchestrator
- Features:
- Full Shotstack API integration (render, templates, probe)
- Timeline conversion from internal format to Shotstack
- News and shorts video template builders
- Quality presets (SD, HD, 1080, 4K)
- HLS streaming via Mux integration
- S3 destination support
- Multi-quality rendering with concurrent processing
-
23.7.2.4 [Medium/M] Implement auto-captioning
- Implement: AssemblyAI transcription provider ✓
- Implement: Deepgram transcription provider ✓
- Implement: Multi-language caption support (including Ghanaian languages) ✓
- Implement: Caption styling with font, color, position options ✓
- Implement: SRT/VTT/JSON subtitle export ✓
- Implement: Speaker diarization support ✓
- Acceptance: All videos captioned ✓
- Files:
apps/veritas/video/src/providers/assemblyai.ts- AssemblyAI transcription clientapps/veritas/video/src/providers/deepgram.ts- Deepgram transcription clientapps/veritas/video/src/services/captioning.ts- Unified captioning service
- Features:
- Dual-provider support (AssemblyAI for accuracy, Deepgram for speed)
- Word-level timestamps for karaoke-style captions
- Speaker diarization with speaker labels
- Custom vocabulary boosting
- Profanity filtering
- VTT styling support
- Shotstack caption asset builder
- Re-segmentation for custom character/word limits
23.7.3 Short-Form Video Production#
-
23.7.3.1 [High/L] Implement TikTok video production
- Implement: 9:16 vertical formatting
- Implement: 15-60 second clips
- Implement: Trend-aware editing
- Implement: Hook optimization
- Acceptance: TikTok videos at scale
-
23.7.3.2 [High/L] Implement YouTube Shorts production
- Implement: OpusClip integration
- Implement: Auto-clip from long videos
- Implement: Thumbnail generation
- Acceptance: YouTube Shorts automated
-
23.7.3.3 [High/M] Implement Instagram Reels production
- Implement: Instagram format optimization
- Implement: Music/sound integration
- Implement: Story integration
- Acceptance: Instagram Reels automated
23.7.4 24/7 Live Stream#
-
23.7.4.1 [High/XL] Implement 24/7 YouTube live stream
- Implement: Continuous broadcast architecture
- Implement: Content scheduling loop
- Implement: Breaking news interruption
- Implement: Viewer interaction handling
- Acceptance: 24/7 stream operational
-
23.7.4.2 [High/L] Implement live stream content mix
- Implement: News bulletin rotation ✅
- Implement: Interview segment automation ✅
- Implement: Weather/sports segments ✅
- Implement: Ambient news ticker ✅
- Acceptance: Varied content mix ✅
23.8 Audio Production Pipeline#
23.8.1 Text-to-Speech Integration#
-
23.8.1.1 [High/L] Implement ElevenLabs TTS integration
- Implement: Voice profile management ✅
- Implement: High-quality audio generation ✅
- Implement: Pronunciation customization ✅
- Implement: Audio caching and CDN ✅
- Acceptance: ElevenLabs TTS operational ✅
-
23.8.1.2 [High/L] Implement Ghana NLP voice integration ✅
- Implement: Abena AI for Twi ✅
- Implement: Additional Ghanaian language voices ✅
- Implement: Voice quality optimization ✅
- Acceptance: Ghana NLP voices operational ✅
-
23.8.1.3 [Medium/M] Implement voice persona management
- Implement: Multiple English voices
- Implement: Multiple Twi voices
- Implement: Voice assignment logic
- Acceptance: Voice variety available
23.8.2 Podcast Production#
-
23.8.2.1 [High/L] Implement podcast generation pipeline
- Implement: Script-to-podcast conversion
- Implement: Multi-voice conversation synthesis
- Implement: Music and sound effects
- Implement: Episode metadata
- Acceptance: Podcasts auto-generated
-
23.8.2.2 [High/M] Implement podcast series
- Implement: Daily news digest podcast
- Implement: Weekly deep-dive podcast
- Implement: Sports recap podcast
- Implement: Regional news podcasts
- Acceptance: Multiple podcast series
-
23.8.2.3 [Medium/M] Implement podcast distribution
- Implement: RSS feed generation
- Implement: Spotify integration
- Implement: Apple Podcasts integration
- Implement: Google Podcasts integration
- Acceptance: Podcasts widely distributed
23.8.3 Audio Articles#
- 23.8.3.1 [High/M] Implement article-to-audio conversion
- Implement: Article text preparation
- Implement: Audio generation queue
- Implement: Progressive loading
- Implement: Playback controls
- Acceptance: All articles have audio versions
23.9 Social Media Automation#
23.9.1 YouTube Automation#
-
23.9.1.1 [High/L] Implement YouTube channel management
- Implement: Video upload automation
- Implement: Metadata optimization
- Implement: Thumbnail generation
- Implement: Playlist management
- Acceptance: YouTube fully automated
-
23.9.1.2 [High/M] Implement YouTube Shorts automation
- Implement: Shorts upload pipeline ✅
- Implement: Scheduling (5-10/day) ✅
- Implement: Analytics tracking ✅
- Acceptance: YouTube Shorts at scale ✅
23.9.2 TikTok Automation#
-
23.9.2.1 [High/L] Implement TikTok posting automation ✅
- Implement: Video upload API ✅
- Implement: Hashtag optimization ✅
- Implement: Sound trend integration ✅
- Implement: Posting schedule optimization ✅
- Acceptance: TikTok fully automated ✅
-
23.9.2.2 [Medium/M] Implement TikTok analytics ✅
- Implement: Performance tracking ✅
- Implement: Trend detection ✅
- Implement: Content optimization ✅
- Acceptance: TikTok analytics operational ✅
23.9.3 Instagram Automation#
-
23.9.3.1 [High/M] Implement Instagram Reels automation ✅
- Implement: Video upload API
- Implement: Caption optimization
- Implement: Hashtag strategy
- Acceptance: Instagram Reels automated
-
23.9.3.2 [Medium/M] Implement Instagram Stories automation ✅
- Implement: Story creation
- Implement: Breaking news alerts
- Implement: Poll integration
- Acceptance: Instagram Stories automated
23.9.4 Messaging Platform Automation#
-
23.9.4.1 [High/L] Implement WhatsApp Channel automation ✅
- Implement: WhatsApp Business API
- Implement: Content formatting
- Implement: Breaking news alerts
- Implement: Rich media support
- Acceptance: WhatsApp Channel operational
-
23.9.4.2 [High/M] Implement Telegram channel automation
- Implement: Telegram Bot API ✅
- Implement: Channel posting ✅
- Implement: Media support ✅
- Acceptance: Telegram automated ✅
23.9.5 Unified Scheduler#
-
23.9.5.1 [High/L] Implement unified posting scheduler
- Implement: Cross-platform scheduling ✅
- Implement: Optimal time detection ✅
- Implement: Content calendar ✅
- Implement: Conflict resolution ✅
- Acceptance: Unified scheduling works ✅
-
23.9.5.2 [Medium/M] Implement posting analytics
- Implement: Cross-platform performance ✅
- Implement: Best time analysis ✅
- Implement: Content type performance ✅
- Acceptance: Posting analytics complete ✅
23.10 Mobile Applications#
23.10.1 React Native App Foundation#
-
23.10.1.1 [High/XL] Create React Native app project
- Create:
apps/veritas/mobile/ - Implement: Expo or bare React Native
- Implement: TypeScript strict mode
- Implement: Navigation structure
- Acceptance: Mobile app scaffolded
- Create:
-
23.10.1.2 [High/L] Implement core screens
- Implement: Home feed screen
- Implement: Article detail screen
- Implement: Category screens
- Implement: Search screen
- Implement: Settings screen
- Acceptance: Core screens complete
-
23.10.1.3 [High/L] Implement authentication
- Implement: Login/signup screens
- Implement: OAuth providers
- Implement: Phone OTP (Ghana)
- Implement: Biometric auth
- Acceptance: Mobile auth works
-
23.10.1.4 [High/M] Implement offline support
- Implement: Article caching
- Implement: Offline reading mode
- Implement: Background sync
- Acceptance: Offline reading works
23.10.2 iOS-Specific Features#
-
23.10.2.1 [High/M] Implement iOS widgets
- Implement: Home screen widget
- Implement: Lock screen widget
- Implement: Widget deep linking
- Acceptance: iOS widgets operational
-
23.10.2.2 [High/M] Implement Live Activities
- Implement: Breaking news Live Activity
- Implement: Sports score tracking
- Implement: Dynamic Island support
- Acceptance: Live Activities work
-
23.10.2.3 [Medium/M] Implement CarPlay support
- Implement: Audio playback interface
- Implement: News briefing mode
- Acceptance: CarPlay integration works
23.10.3 Android-Specific Features#
-
23.10.3.1 [High/M] Implement Android widgets
- Implement: Home screen widget
- Implement: Widget configuration
- Acceptance: Android widgets operational
-
23.10.3.2 [Medium/M] Implement Android Auto support
- Implement: Audio playback interface
- Implement: News briefing mode
- Acceptance: Android Auto integration works
23.10.4 Push Notifications#
-
23.10.4.1 [High/L] Implement push notification system
- Implement: FCM integration
- Implement: APNs integration
- Implement: Notification preferences
- Implement: Smart timing
- Acceptance: Push notifications work
-
23.10.4.2 [High/M] Implement breaking news alerts
- Implement: Priority notification handling
- Implement: Rich notifications with images
- Implement: Action buttons
- Acceptance: Breaking alerts work
23.11 Ghana-Specific Features#
23.11.1 Local Language Support#
-
23.11.1.1 [High/XL] Implement Twi language support
- Implement: Twi article translation
- Implement: Twi TTS (Ghana NLP Abena)
- Implement: Twi UI localization
- Implement: Code-switching detection
- Acceptance: Full Twi support
-
23.11.1.2 [High/L] Implement Ewe language support
- Implement: Ewe article translation
- Implement: Ewe TTS
- Implement: Ewe UI localization
- Acceptance: Ewe support added
-
23.11.1.3 [High/L] Implement Ga language support
- Implement: Ga article translation
- Implement: Ga TTS
- Implement: Ga UI localization
- Acceptance: Ga support added
-
23.11.1.4 [Medium/M] Implement Hausa language support
- Implement: Hausa article translation
- Implement: Hausa TTS
- Acceptance: Hausa support added
-
23.11.1.5 [Medium/M] Implement Dagbani language support
- Implement: Dagbani article translation
- Implement: Dagbani TTS
- Acceptance: Dagbani support added
23.11.2 Ghana News Sources#
-
23.11.2.1 [High/L] Implement Tier 1 Ghana sources
- Implement: Multimedia Group (Joy News, Joy FM)
- Implement: Citi Group (Citi News, ChannelOne)
- Implement: Graphic Communications (Daily Graphic)
- Implement: Media General (TV3, 3News)
- Implement: Despite Media (Peace FM, Okay FM)
- Implement: GBC
- Implement: GhanaWeb
- Acceptance: Tier 1 sources integrated
-
23.11.2.2 [High/M] Implement source bias tracking
- Implement: NPP/NDC lean tracking
- Implement: Regional emphasis tracking
- Implement: Ownership transparency
- Acceptance: Source bias visible
-
23.11.2.3 [Medium/M] Implement government sources
- Implement: Ghana.gov.gh
- Implement: Parliament feeds
- Implement: Ministry announcements
- Acceptance: Government sources integrated
23.11.3 Ghana Regulatory Compliance#
-
23.11.3.1 [High/M] Implement NMC compliance
- Implement: National Media Commission standards
- Implement: Content guidelines adherence
- Implement: Complaint handling
- Acceptance: NMC compliant
-
23.11.3.2 [High/M] Implement Ghana DPA compliance
- Implement: Data Protection Act adherence
- Implement: User consent management
- Implement: Data export/deletion
- Acceptance: DPA compliant
-
23.11.3.3 [Medium/M] Implement election coverage guidelines
- Implement: Electoral Commission rules
- Implement: Balance requirements
- Implement: Blackout period handling
- Acceptance: Election coverage compliant
23.11.4 Ghana Payment Integration#
-
23.11.4.1 [High/L] Implement MTN Mobile Money
- Implement: MTN MoMo API integration
- Implement: Subscription payments
- Implement: Micro-transactions
- Acceptance: MTN MoMo works
-
23.11.4.2 [High/M] Implement Vodafone Cash
- Implement: Vodafone Cash API
- Implement: Payment flow
- Acceptance: Vodafone Cash works
-
23.11.4.3 [High/M] Implement AirtelTigo Money
- Implement: AirtelTigo API
- Implement: Payment flow
- Acceptance: AirtelTigo Money works
-
23.11.4.4 [Medium/M] Implement Stripe (international)
- Implement: Stripe integration ✓
- Implement: Card payments ✓
- Implement: International subscriptions ✓
- Acceptance: Stripe works ✓
- Done:
apps/veritas/api/src/domain/payments/stripe.ts— Stripe SDK integration with Payment Intents, Customers, Subscriptions, Refunds, webhook verification - Done:
apps/veritas/api/src/interfaces/http/routes/v1/stripe-payments.ts— 19 endpoints (payment intents, customers, payment methods, subscriptions, refunds, webhooks, config) - Done:
apps/veritas/mobile/src/components/StripePaymentCard.tsx— Payment card UI component - Done: Mobile API client with 18 Stripe functions, types for all Stripe responses
23.12 Monetization System#
23.12.1 Subscription Tiers#
-
23.12.1.1 [High/L] Implement subscription management
- Implement: Free tier with limits ✓
- Implement: Premium tier features ✓
- Implement: Student discount tier ✓
- Implement: Family plan ✓
- Acceptance: Subscription tiers work ✓
- Done:
apps/veritas/api/src/domain/subscriptions.ts— 4 tiers (Free/Premium/Student/Family), multi-currency pricing (GHS/USD/EUR/GBP), feature access control (15 keys), usage metering (7 limits), family invitations, student .edu auto-verification, DB table initialization - Done:
apps/veritas/api/src/interfaces/http/routes/v1/subscriptions.ts— 27 endpoints for plans, lifecycle, usage, family, and student management - Done:
apps/veritas/mobile/src/components/SubscriptionPlanCard.tsx— Plan display with billing toggle, features, limits, family/student badges - Done: Mobile types (22 interfaces) and 24 API client functions
-
23.12.1.2 [High/M] Implement paywall system
- Implement: Article metering
- Implement: Soft paywall prompts
- Implement: Premium content gating
- Acceptance: Paywall operational
- Done:
apps/veritas/api/src/domain/paywall.ts— Multi-layer paywall domain module with metering, soft/hard paywall, premium content gating, content truncation (word-based and HTML), analytics events, article premium status management, and DB initialization - Done:
apps/veritas/api/src/interfaces/http/routes/v1/paywall.ts— 9 API endpoints: access check, article read recording, event tracking, metering status, config, set/bulk-set premium, analytics, and per-tier analytics - Done:
apps/veritas/mobile/src/components/PaywallPrompt.tsx— Contextual paywall UI component with metered_access, soft_paywall, hard_paywall, and premium_required variants, progress bar, dismiss animation, upgrade CTA - Done: Mobile types (13 types/interfaces) and 9 API client functions
-
23.12.1.3 [Medium/M] Implement subscription analytics
- Implement: Conversion tracking
- Implement: Churn prediction
- Implement: Revenue reporting
- Acceptance: Subscription analytics work
- Done:
apps/veritas/api/src/domain/subscription-analytics.ts— Full analytics domain with conversion funnel, CTA source tracking, time-to-conversion, trial metrics, churn risk scoring (5 factors, 4 levels), revenue MRR/ARR/LTV, cohort retention, daily snapshots, subscription transitions audit trail - Done:
apps/veritas/api/src/interfaces/http/routes/v1/subscription-analytics.ts— 15 API endpoints for conversion funnel, churn/at-risk, scoring, revenue report, MRR, snapshots, LTV, cohorts, and transition history - Done: DB tables: subscription_transitions, churn_risk_scores, revenue_snapshots
- Done: Mobile types (18 interfaces) and 15 API client functions
23.12.2 Advertising Integration#
-
23.12.2.1 [High/M] Implement ad placement system
- Implement: Banner ad slots
- Implement: In-feed native ads
- Implement: Video pre-roll
- Acceptance: Ad placements work
-
23.12.2.2 [Medium/M] Implement ad network integration
- Implement: Google Ad Manager
- Implement: Local Ghana ad networks
- Implement: Direct sold inventory
- Acceptance: Ad networks integrated
-
23.12.2.3 [Medium/M] Implement ad-free premium
- Implement: Ad removal for premium
- Implement: Clean reading mode
- Acceptance: Ad-free experience works
23.12.3 B2B API Platform#
-
23.12.3.1 [High/M] Implement B2B API products
- Implement: News Feed API
- Implement: Search API
- Implement: Fact-Check API
- Implement: Entity API
- Acceptance: B2B APIs available
-
23.12.3.2 [Medium/M] Implement API key management
- Implement: API key generation
- Implement: Usage tracking
- Implement: Rate limiting
- Implement: Billing integration
- Acceptance: API management works
23.13 Testing & Quality Assurance#
23.13.1 Unit Testing#
-
23.13.1.1 [High/L] Create unit test suite for core libraries
- Test: @veritas/core types and utilities
- Test: @veritas/models validation
- Test: @veritas/fact-checking algorithms
- Test: @veritas/bias-detection scoring
- Acceptance: 80%+ coverage on core libs
-
23.13.1.2 [High/M] Create unit tests for agents
- Test: Agent message handling
- Test: State transitions
- Test: Decision logic
- Acceptance: Agent logic tested
23.13.2 Integration Testing#
-
23.13.2.1 [High/L] Create API integration tests
- Test: Article endpoints
- Test: Search endpoints
- Test: Authentication flows
- Acceptance: API integration tested
-
23.13.2.2 [High/M] Create database integration tests
- Test: Prisma operations
- Test: Migration stability
- Test: Data integrity
- Acceptance: Database integration tested
23.13.3 E2E Testing#
-
23.13.3.1 [High/L] Create E2E test suite for web app
- Test: User flows (browse, read, save)
- Test: Authentication flows
- Test: Search functionality
- Acceptance: Web E2E tests pass
-
23.13.3.2 [High/M] Create E2E test suite for mobile app
- Test: Core user flows
- Test: Offline functionality
- Test: Push notifications
- Acceptance: Mobile E2E tests pass
23.13.4 Performance Testing#
-
23.13.4.1 [High/M] Implement load testing
- Test: API under load (1000+ req/s)
- Test: Database performance
- Test: CDN performance
- Acceptance: Performance targets met
-
23.13.4.2 [Medium/M] Implement stress testing
- Test: Breaking news surge handling
- Test: Video generation queue
- Test: Search under load
- Acceptance: System handles stress
23.14 CI/CD & Deployment#
23.14.1 CI Pipeline#
-
23.14.1.1 [High/L] Configure GitHub Actions CI
- Implement: Lint, typecheck, test on PR
- Implement: Build verification
- Implement: Coverage reporting
- Acceptance: CI runs on all PRs
-
23.14.1.2 [High/M] Configure Nx affected commands
- Implement: Affected:build
- Implement: Affected:test
- Implement: Affected:lint
- Acceptance: Only affected projects run
23.14.2 CD Pipeline#
-
23.14.2.1 [High/L] Configure production deployment
- Implement: Staging environment
- Implement: Production deployment
- Implement: Rollback capability
- Acceptance: CD pipeline works
-
23.14.2.2 [High/M] Configure container builds
- Implement: Docker builds for services
- Implement: Container registry
- Implement: Multi-arch builds
- Acceptance: Containers build correctly
23.14.3 Infrastructure as Code#
-
23.14.3.1 [High/L] Configure Terraform modules
- Implement: AWS/GCP resources
- Implement: Database infrastructure
- Implement: CDN configuration
- Acceptance: Infrastructure as code works
-
23.14.3.2 [High/M] Configure Kubernetes manifests
- Implement: Service deployments
- Implement: Auto-scaling policies
- Implement: Secret management
- Acceptance: K8s deployment works
23.15 Documentation#
23.15.1 Technical Documentation#
-
23.15.1.1 [High/M] Create architecture documentation
- Document: System architecture
- Document: Data flow diagrams
- Document: Service interactions
- Acceptance: Architecture documented
-
23.15.1.2 [High/M] Create API documentation
- Document: All REST endpoints
- Document: Authentication
- Document: Error handling
- Acceptance: API documented with OpenAPI
-
23.15.1.3 [Medium/M] Create runbook documentation
- Document: Deployment procedures
- Document: Incident response
- Document: Monitoring alerts
- Acceptance: Runbooks complete
23.15.2 Editorial Documentation#
-
23.15.2.1 [High/M] Create editorial guidelines
- Document: Style guide
- Document: Fact-checking procedures
- Document: AI content policies
- Acceptance: Editorial guidelines complete
-
23.15.2.2 [Medium/M] Create agent documentation
- Document: Agent roles and responsibilities
- Document: Agent interaction patterns
- Document: Escalation procedures
- Acceptance: Agent docs complete
23.16 Launch Preparation#
23.16.1 Pre-Launch Checklist#
-
23.16.1.1 [High/M] Complete security audit
- Audit: All API endpoints
- Audit: Authentication system
- Audit: Data protection
- Acceptance: Security audit passed
-
23.16.1.2 [High/M] Complete performance validation
- Validate: Response times
- Validate: Video generation latency
- Validate: Search performance
- Acceptance: Performance targets met
-
23.16.1.3 [High/M] Complete compliance review
- Review: NMC compliance
- Review: Ghana DPA compliance
- Review: AI disclosure compliance
- Acceptance: Compliance verified
23.16.2 App Store Submissions#
-
23.16.2.1 [High/L] Prepare iOS App Store submission
- Prepare: App binary
- Prepare: App Store assets
- Prepare: Privacy details
- Acceptance: Submitted to App Store
-
23.16.2.2 [High/L] Prepare Google Play submission
- Prepare: App bundle
- Prepare: Store listing
- Prepare: Data safety
- Acceptance: Submitted to Play Store
-
23.16.2.3 [High/M] Prepare Android TWA submission
- Prepare: TWA configuration
- Prepare: Digital Asset Links
- Acceptance: TWA ready for Play Store
23.16.3 Launch Monitoring ✅#
-
23.16.3.1 [High/M] Configure launch monitoring
- Monitor: Error rates
- Monitor: Performance metrics
- Monitor: User engagement
- Acceptance: Monitoring dashboard ready
-
23.16.3.2 [High/M] Configure incident response
- Configure: On-call rotation
- Configure: Escalation paths
- Configure: Communication templates
- Acceptance: Incident response ready
Phase 23 Summary Statistics#
| Section | Task Count |
|---|---|
| 23.1 Codebase Analysis & Inventory | 8 |
| 23.2 Domain Refactoring | 42 |
| 23.3 Oshun Shared Library Integration | 18 |
| 23.4 Isis Domain Integration (AI) | 12 |
| 23.5 Sophia Domain Integration (Knowledge) | 6 |
| 23.6 AI Agent Framework | 24 |
| 23.7 Video Production Pipeline | 18 |
| 23.8 Audio Production Pipeline | 11 |
| 23.9 Social Media Automation | 14 |
| 23.10 Mobile Applications | 14 |
| 23.11 Ghana-Specific Features | 18 |
| 23.12 Monetization System | 10 |
| 23.13 Testing & Quality Assurance | 10 |
| 23.14 CI/CD & Deployment | 8 |
| 23.15 Documentation | 6 |
| 23.16 Launch Preparation | 9 |
| TOTAL Phase 23 | 228 |
23.17 Veritas Product Implementation Tasks#
Note: The following tasks are the remaining product implementation work from the original Yaa codebase. These complement the migration tasks above and represent the features still to be built for the Veritas news platform.
23.17.1 Performance & Offline#
23.17.1.1 Performance Optimization#
- 23.17.1.1 Implement image lazy loading with blur placeholders
- Created
OptimizedImagecomponent with blur-up loading effect - Created image utilities (
lib/image-utils.ts) for blur data URL generation - Supports shimmer, color, and blur placeholder modes
- Includes Intersection Observer for true lazy loading
- Added fallback image support and error handling
- Created
ImageSkeletoncomponent for standalone image placeholders
- Created
- 23.17.1.2 Build skeleton loading states for all components
- Created comprehensive
Skeletoncomponent system incomponents/Skeleton/ Skeleton- Base skeleton with pulse/shimmer animationsSkeletonText- Multi-line text placeholders with variantsSkeletonArticleCard- News card skeletons (featured, horizontal, vertical, compact, text-only)SkeletonAvatar- Avatar placeholders with optional name/titleSkeletonButton- Button placeholders with icon supportSkeletonList- List/grid container for skeleton itemsSkeletonNavigation- Header, sidebar, tabbar, breadcrumb, tabs variants
- Created comprehensive
- 23.17.1.3 Optimize bundle size with code splitting
- Updated next.config.mjs with webpack chunk splitting for:
- Skeleton components (async loaded)
- Image utilities and OptimizedImage (async loaded)
- i18n related code (shared)
- Vendor node_modules (shared)
- Enabled SWC minification, compression, and disabled production source maps
- Added optimizePackageImports for next-intl
- Updated next.config.mjs with webpack chunk splitting for:
- 23.17.1.4 Implement route-based code splitting
- Created
components/dynamic.tsxwith lazy-loaded component variants:- DynamicOptimizedImage, DynamicImageSkeleton
- DynamicSkeleton, DynamicSkeletonText, DynamicSkeletonArticleCard
- DynamicSkeletonAvatar, DynamicSkeletonButton
- DynamicSkeletonList, DynamicSkeletonNavigation
- Added preload functions for proactive loading
- Each dynamic component has appropriate loading fallbacks
- Created
- 23.17.1.5 Configure aggressive caching strategies
- Updated next.config.mjs with Cache-Control headers:
- Static assets (/_next/static): immutable, 1 year
- Images (/_next/image): 30 days with SWR
- Public static files: 30 days with SWR
- Fonts: immutable, 1 year
- Favicon/icons/manifest: 1 day with SWR
- API routes: 60s with 5min SWR
- HTML pages: CDN edge caching (s-maxage=60)
- Created cache-utils.ts with:
- CacheControl presets for different content types
- FetchCache presets for Next.js data fetching
- CacheKey generators for consistent key creation
- CacheTTL constants (SHORT, MEDIUM, LONG, etc.)
- MemoryCache class for client-side caching
- withCache HOF for wrapping async functions
- deduplicateRequest for preventing duplicate requests
- prefetch function for proactive caching
- Updated next.config.mjs with Cache-Control headers:
- 23.17.1.6 Optimize Core Web Vitals (LCP < 2.5s, FID < 100ms, CLS <
0.1)
- Created web-vitals.ts with comprehensive utilities:
- VitalsThresholds with good/needs-improvement/poor thresholds
- getMetricRating() and formatMetricValue() functions
- createAnalyticsReporter() for sending metrics to analytics
- CLSPrevention utilities (aspect ratio padding, container styles)
- LCPOptimization utilities (preload hints, preconnect, critical origins)
- FIDOptimization utilities (deferWork, yieldToMain, processInChunks)
- Debounce and throttle functions for input handling
- ResourceOptimization utilities (connection type, reduced data/motion)
- getOptimalImageQuality() based on network conditions
- Created web-vitals.ts with comprehensive utilities:
- 23.17.1.7 Implement 3G connection optimization
- Created
src/lib/network-aware.tsxwith comprehensive network detection - NetworkProvider context for app-wide network state management
- useNetwork hook returning networkInfo, optimizationLevel, settings
- Four optimization levels: 'none' (4G), 'light' (slow 4G), 'moderate' (3G), 'aggressive' (2G/offline)
- ImageQualitySettings: quality, maxWidth, format based on connection
- ContentLoadingSettings: initialLoadCount, preloadImages, autoplayVideos, animations
- useAdaptiveImageProps for automatic image optimization
- useNetworkFeature for conditional feature enabling
- useAdaptiveInfiniteScroll for adaptive pagination
- useNetworkStyleClass for CSS class helpers
- Data saver mode toggle (manual override)
- Network Information API integration with fallbacks
- Online/offline event listeners
- Exported from lib/index.ts
- Created
23.17.1.2 Offline Capability#
- 23.17.1.8 Build reading list offline sync
- Created comprehensive IndexedDB storage layer
(
src/lib/offline/indexed-db.ts)- Article storage with caching metadata and size tracking
- Reading list management with progress, notes, sync priority
- Sync queue for offline operations with retry support
- Metadata store for app-level settings
- Storage estimation and persistent storage APIs
- Created sync manager (
src/lib/offline/sync-manager.ts)- Background sync with exponential backoff
- Online/offline detection with automatic sync on reconnect
- Configurable retry attempts and batch processing
- Event system for sync status updates
- Background Sync API and Periodic Sync API registration
- Created React hooks for reading list (
src/hooks/useReadingList.ts)- useReadingList hook with full CRUD operations
- Optimistic updates with rollback on error
- Sync status tracking and manual sync trigger
- Article caching for offline reading
- useIsInReadingList for lightweight checks
- Created service worker (
public/sw.js)- Cache-first strategy for static assets
- Network-first for API and pages
- Stale-while-revalidate for images
- Background sync event handling
- Push notifications support
- Message-based communication with client
- Created service worker hook (
src/hooks/useServiceWorker.ts)- Registration and update management
- Cache article and clear cache actions
- Update available detection
- Created offline page (
src/app/offline/page.tsx)- User-friendly offline experience
- Links to reading list and retry
- Tips for offline usage
- Exported all utilities from lib/index.ts and hooks/index.ts
- Created comprehensive IndexedDB storage layer
(
- 23.17.1.9 Implement intelligent article pre-fetching
- Created
src/lib/offline/prefetch-manager.tswith:- Priority-based prefetch queue (critical, high, medium, low)
- Configurable batch processing with delays
- Network-aware configuration (none, light, moderate, aggressive)
- Image prefetching with quality/size optimization
- Reading list auto-prefetch (highest priority)
- Related articles prefetch
- Trending articles prefetch
- Category visit tracking for personalized prefetch
- Abort controller for cancellation
- Event system for progress tracking
- Created
src/hooks/usePrefetch.tswith:- usePrefetch hook with full prefetch control
- Auto-intelligent prefetch based on context
- Progress and queue status tracking
- usePrefetchOnInteraction for hover/focus prefetch
- usePrefetchOnVisible for intersection-based prefetch
- Configuration per optimization level:
- none: 5 batch, 20 max, images enabled
- light: 3 batch, 10 max, images enabled
- moderate: 2 batch, 5 max, no images
- aggressive: disabled
- Exported from lib/offline/index.ts and hooks/index.ts
- Created
- 23.17.1.10 Create offline reading queue UI
- Created
src/components/ReadingList/directory with:- ReadingListCard - Article card with progress, offline status, menu
- ReadingListContainer - Main container with filtering, sorting, actions
- ReadingListHeader - Stats, filters, sort, sync/cache actions
- ReadingListEmpty - Empty state with feature highlights
- ReadingListSkeleton - Loading skeleton for the list
- Created
/[locale]/reading-list/page.tsxwith i18n support - Added translations (en.json, tw.json) for reading list
- Features:
- Filter by: all, unread, read, offline-only
- Sort by: recently added, progress, last read
- Online/offline status indicator
- Sync status with retry option
- Prefetch progress display
- "Cache All" button for offline storage
- Service worker update notification
- Progress bar on cards
- Compact and full card variants
- Exported from components/index.ts
- Created
- 23.17.1.11 Build background sync for user actions
- Implemented in sync-manager.ts (from reading list offline sync task):
- SyncManager class with automatic sync on reconnect
- Sync queue stored in IndexedDB
- Exponential backoff retry with configurable attempts
- Event system for sync status updates
- Background Sync API registration (sw.js)
- Periodic Sync API support for content refresh
- Service worker handles 'sync' events for reading-list operations
- Operations synced: add/remove from reading list, update progress, mark read, add notes
- Implemented in sync-manager.ts (from reading list offline sync task):
- 23.17.1.12 Implement data saver mode (text-only option)
- Created
src/lib/data-saver.tsxwith:- DataSaverProvider context for app-wide settings
- Five levels: off, low, medium, high, extreme (text-only)
- Configurable settings per level (images, video, animations, prefetch)
- Auto-detection of browser data saver setting
- localStorage persistence
- Estimated data savings display
- Created
src/components/DataSaver/DataSaverSettings.tsx:- Full settings UI with level selector
- Compact toggle variant
- Fine-tune individual settings
- Active settings summary
- Text-only mode notice
- Utility components:
- useDataSaver hook for settings access
- useDataSaverImageProps for adaptive image props
- useDataSaverFeature for feature checks
- DataSaverGuard for conditional rendering
- TextOnlyContent for HTML sanitization
- DataSaverImage component with placeholders
- Text-only mode strips images, videos, embeds from HTML
- Exported from lib/index.ts and components/index.ts
- Created
23.17.2 Advanced AI Systems#
23.17.2.1 Personalization Engine#
- 23.17.2.1 Build comprehensive user behavior tracking
- 23.17.2.2 Implement collaborative filtering recommendation
- 23.17.2.3 Create content-based recommendations
- 23.17.2.4 Build diversity injection algorithm (30% non-personalized)
- 23.17.2.5 Implement recommendation A/B testing framework
23.17.2.2 Improved Clustering#
- 23.17.2.6 Implement real-time cluster updates
- 23.17.2.7 Build cross-language story clustering
- 23.17.2.8 Create topic evolution tracking visualization
- 23.17.2.9 Implement cluster quality scoring and pruning
23.17.3 Video Production Scale-Up#
23.17.3.1 Tavus Integration#
- 23.17.3.1 Implement Tavus API integration
- 23.17.3.2 Create digital twin training pipeline
- 23.17.3.3 Build Phoenix-3 model integration
- 23.17.3.4 Implement Tavus failover from HeyGen
23.17.3.2 Custom AI Anchors ✅#
- 23.17.3.5 Design Veritas Asantewaa persona (Female, English)
- 23.17.3.6 Design Kofi Mensah persona (Male, English)
- 23.17.3.7 Design Akua Nyarko persona (Female, Twi)
- 23.17.3.8 Create ElevenLabs Professional Voice Clones
- 23.17.3.9 Build voice-avatar synchronization system
Status: Complete (23.17.3.2)
- Location:
apps/veritas/video/src/services/personas.ts - Veritas Asantewaa: Flagship female anchor, authoritative delivery, named after Ashanti queen warrior, ElevenLabs voice configured (Charlotte base until Professional Clone trained)
- Kofi Mensah: Male co-anchor, warm conversational style, relatable to all demographics, ElevenLabs voice configured (Daniel base)
- Akua Nyarko: Female Twi-language anchor, warm maternal presence, serves Akan-speaking communities, requires Professional Voice Clone for authentic Twi
- Additional personas: Kwame Owusu (sports/entertainment), Ama Serwaa (business/Ewe)
- ElevenLabs Integration: Full provider configuration with voice settings (stability, similarityBoost, styleExaggeration), Professional Voice Clone support, content-type optimized settings, stock voice recommendations
- Helper Functions: getPersonaElevenLabsConfig, hasElevenLabsVoice, isProfessionalVoiceClone, getOptimizedVoiceSettings, markAsProfessionalClone
- Voice Cloning Ready: Infrastructure for Professional Voice Clones in place with setElevenLabsVoice and markAsProfessionalClone functions
23.17.3.3 B-Roll Generation ✅#
- 23.17.3.10 Implement Runway ML Gen-4.5 API integration
- 23.17.3.11 Build B-roll prompt generation from article content
- Created:
apps/veritas/video/src/services/broll/prompt-generator.ts - Features: Concept-to-prompt transformation, Ghana/Africa-specific enhancements, style-aware prompt construction, multi-prompt generation, stock search terms
- Created:
- 23.17.3.12 Create visual concept extraction pipeline
- Created:
apps/veritas/video/src/services/broll/concept-extractor.ts - Features: Named entity recognition, action/event detection, scene setting identification, emotion/tone detection, Ghana-specific context detection, visual importance scoring
- Created:
- 23.17.3.13 Build B-roll library management with tagging
- Created:
apps/veritas/video/src/services/broll/library.ts - Features: Clip storage with metadata, hierarchical tagging system, semantic search by tags/descriptions, usage tracking and popularity scoring, license and attribution management, quality rating and moderation
- Created:
- 23.17.3.14 Implement B-roll caching and reuse
- Created:
apps/veritas/video/src/services/broll/cache.ts - Features: Content-addressable caching (hash-based), LRU eviction with cost awareness, fuzzy matching for similar prompts, cache warming strategies, multi-tier caching support, cost tracking and statistics
- Created:
23.17.3.4 Content Repurposing ✅#
- 23.17.3.15 Implement OpusClip API integration
- Already implemented:
apps/veritas/video/src/providers/opusclip.ts - Features: Project creation, clip retrieval, collections, export, polling
- Already implemented:
- 23.17.3.16 Build automated repurposing pipeline
- Created:
apps/veritas/video/src/services/repurposing/pipeline.ts - Features: Source video processing, OpusClip integration, job tracking, progress callbacks, batch processing
- Created:
- 23.17.3.17 Implement virality scoring filter
- Features: Configurable thresholds, topic-based score boosts, type penalties, duration constraints, platform-specific adjustments
- 23.17.3.18 Create multi-platform export automation
- Supports: TikTok, YouTube Shorts, Instagram Reels, Twitter, LinkedIn
- Features: Platform-specific aspect ratios, duration limits, scheduling
- 23.17.3.19 Build clip library management
- Created:
apps/veritas/video/src/services/repurposing/clip-library.ts - Features: Storage with metadata, tagging, search/filtering, performance tracking, approval workflow, statistics, cleanup automation
- Created:
23.17.3.5 Video Scale Targets#
- 23.17.3.20 Scale to 3x daily video bulletins automation
- 23.17.3.21 Scale YouTube Shorts to 10+/day
- 23.17.3.22 Scale TikTok to 6+/day
- 23.17.3.23 Implement comprehensive video analytics
Status: Complete (23.17.3.5)
- Location:
apps/veritas/video/src/services/scheduler/ - Production Scheduler (
production-scheduler.ts): High-volume scheduling with configurable daily targets (3x bulletins at 6am/12pm/6pm, 10+ YouTube Shorts, 6+ TikTok, 6+ Instagram Reels), priority-based queue management, concurrent production limits, automatic retry with backoff - Video Analytics (
video-analytics.ts): Comprehensive production and engagement metrics, platform-specific tracking, trend detection, performance analysis, topic effectiveness reporting, actionable recommendations - Full System (
index.ts): Combined production system with integrated analytics callbacks, daily schedule automation, system status reporting
23.17.4 Podcast Network Launch#
23.17.4.1 Podcast Production System#
- 23.17.4.1 Build NotebookLM-style discussion generator
- 23.17.4.2 Create podcast script templates
- 23.17.4.3 Design podcast host AI personas (2 voices, conversational)
- 23.17.4.4 Build multi-voice audio composition engine
- 23.17.4.5 Create podcast mixing/mastering pipeline
Status: Complete (23.17.4.1)
- Location:
apps/veritas/video/src/services/podcast/ - Discussion Generator (
discussion-generator.ts): NotebookLM-style two-host conversational discussions from news topics, with style patterns (informative, analytical, casual, debate), turn-based dialogue generation, Ghana context - Templates (
templates.ts): Veritas Daily (20min), Morning Briefing (5min), Evening Wrap (5min), Deep Dive (30min), Special Report templates with segment structure and music cues - Host Personas (
personas.ts): Kwame & Adwoa (discussion pair), Kofi (morning briefing), Ama (evening wrap) with voice configs, personality traits, verbal habits - Audio Composition (
audio-composition.ts): Multi-voice TTS integration, track management, music/speech mixing, timeline generation - Mixing Pipeline (
mixing-pipeline.ts): Professional audio processing with compressor, limiter, EQ, loudness normalization (LUFS), presets (Standard, Broadcast, Voice-Focused)
23.17.4.2 Podcast Shows#
- 23.17.4.6 Launch "Veritas Daily" (20 min daily news discussion) automation
- 23.17.4.7 Create podcast intro/outro audio assets
- 23.17.4.8 Design podcast artwork with AI generation
- 23.17.4.9 Generate show descriptions and metadata
Status: Complete (23.17.4.2)
- Location:
apps/veritas/video/src/services/podcast/shows.ts - Show Definitions: Veritas Daily, Morning Briefing, Evening Wrap with full metadata, schedules, audio assets, brand colors
- Show Manager: Episode creation, audio generation, artwork generation, RSS feed generation, episode publishing
- Audio Assets: Structured refs for intro/outro music, transitions, stingers
- Artwork System: Cover templates, episode artwork with text overlays, brand colors (Ghana green/gold/red)
- Metadata: Apple Podcasts/Spotify compatible with categories, keywords, copyright, author info
- RSS Feed Generator: Podcast-compliant XML with iTunes namespace
23.17.4.3 Audio Briefings ✅#
- 23.17.4.10 Build morning briefing generator (5 min, 6 AM)
- 23.17.4.11 Build evening wrap generator (5 min, 6 PM)
- 23.17.4.12 Create briefing scheduling automation
- 23.17.4.13 Implement personalized briefing generation
Status: Complete (23.17.4.3)
- Location:
apps/veritas/video/src/services/podcast/briefings.ts - Morning Briefing: 5-minute briefing with Kofi persona, scheduled for 6 AM Accra time, includes weather and market preview
- Evening Wrap: 5-minute briefing with Ama persona, scheduled for 6 PM Accra time, includes sports results and market close
- Scheduling System: Configurable schedules with timezone support (Africa/Accra default), day-of-week filtering, active/inactive toggles
- Personalization Layer: User preferences (topic priorities, region, language), must-include topics, exclude topics, preferred length, content filtering
- Content Management: Multiple content sources, priority-based ranking, breaking news prioritization, topic category mapping
- Helper Functions: createBriefingService, createMockContentSource, createDefaultSchedules, startBriefingScheduler
23.17.4.4 Podcast Distribution ✅#
- 23.17.4.14 Build Apple Podcasts submission automation
- 23.17.4.15 Build Spotify submission automation
- 23.17.4.16 Create RSS feed generator
- 23.17.4.17 Integrate podcast player in app/website
- 23.17.4.18 Implement podcast analytics
Status: Complete (23.17.4.4)
- Location:
apps/veritas/video/src/services/podcast/distribution.ts - RSS Feed Generator: Enhanced RSS with Podcast 2.0 namespace, chapters, transcripts, content encoding, iTunes/Spotify compatible
- Platform Submission: Apple Podcasts Connect integration, Spotify for Podcasters integration, submission status tracking, multi-platform batch submission
- Player Embeds: Apple Podcasts embed, Spotify embed, generic audio player with theme support (light/dark/auto)
- Podcast Analytics: Event tracking (downloads, plays, subscribes), summary generation, platform-specific analytics, episode analytics, trending episodes
- Helper Functions: getApplePodcastsSubmitUrl, getSpotifySubmitUrl, getAllSubmissionUrls, createInMemoryAnalyticsStorage
23.17.5 Smart Notifications & Personalization#
23.17.5.1 Notification Strategy#
- 23.17.5.1 Implement notification priority system (P0-P3)
- 23.17.5.2 Build breaking news push (P0: all, P1: followers, P2: engaged)
- 23.17.5.3 Implement personalized digest notifications (6AM, 12PM, 6PM)
- 23.17.5.4 Create topic-specific alerts (sports, stocks, weather)
- 23.17.5.5 Build engagement triggers ("story updated", "new in topic")
Completed (54.11.1.3): Full notification strategy service implemented in
apps/veritas/video/src/services/notifications/notification-strategy.ts
- Priority System: P0 (critical/breaking), P1 (high/followers), P2 (medium/engaged), P3 (low/digest)
- Breaking News Push: Priority-based targeting with P0 reaching all users, P1 reaching topic followers, P2 reaching engaged users
- Personalized Digests: Scheduled at 6AM, 12PM, 6PM with topic-based content aggregation per user preferences
- Topic Alerts: Support for politics, business, sports, entertainment, technology, health, local, international, weather, markets
- Engagement Triggers: story_update, new_in_topic, engagement_trigger notification types
- Delivery Channels: push, email, sms, in_app with provider abstraction
- User Preferences: Enabled channels, followed topics, engagement level, quiet hours, daily limits
- Statistics Tracking: Sent, delivered, opened, clicked counts with conversion rate calculation
- Helper Functions: createNotificationStrategyService, createInMemoryPreferencesStorage, createMockPushProvider, createMockEmailProvider, createMockSMSProvider
23.17.5.2 Notification Fatigue Prevention#
- 23.17.5.6 Implement configurable daily notification limit (4-6)
- 23.17.5.7 Build quiet hours feature with timezone awareness
- 23.17.5.8 Create relevance scoring for filtering
- 23.17.5.9 Implement frequency capping (max 1/hour except breaking)
- 23.17.5.10 Build smart bundling for related updates
Completed (54.11.1.3): Full notification fatigue prevention implemented in
apps/veritas/video/src/services/notifications/fatigue-prevention.ts
- Daily Limits: Configurable per-user daily limit (default 6), with P0 bypassing limits, getRemainingDailyNotifications tracking
- Quiet Hours: Timezone-aware quiet hours with start/end times (already in notification-strategy.ts), P0 exemption for breaking news
- Relevance Scoring: Multi-factor scoring (topicAffinity 35%, recency 15%, engagementHistory 25%, contentFreshness 10%, priorityWeight 15%) with configurable threshold (default 40)
- Frequency Capping: Max 1/hour except P0, min 30-minute gap, topic-specific cooldowns (sports 4h, markets 2h, weather 6h, etc.), P0 always exempt
- Smart Bundling: Automatic bundling by topic/story/type, min 2 max 5 notifications per bundle, 30-minute max wait, combined notification creation
- History Tracking: Sent counts, interaction tracking (opened/clicked/dismissed), topic engagement scores, history summary with open/click rates
- Helper Functions: createFatiguePreventionService, createInMemoryHistoryStorage, calculateRelevanceScore, filterNotifications
23.17.5.3 Advanced Personalization Engine#
- 23.17.5.11 Build user profile calculation (explicit + implicit)
- 23.17.5.12 Implement reading history analysis with decay
- 23.17.5.13 Create engagement pattern analysis
- 23.17.5.14 Build time preference detection
- 23.17.5.15 Implement diversity scoring (70/30 split)
Completed (54.11.1.3): Full personalization engine implemented in
apps/veritas/video/src/services/notifications/personalization-engine.ts
- User Profile Calculation: Combines explicit preferences (subscribed topics, blocked topics, digest times, content types, language, region) with implicit behavior (topic/content-type engagement, time patterns, session stats)
- Reading History with Decay: Time-weighted history analysis using 14-day half-life decay, getWeightedReadingHistory, calculateTopicEngagementWithDecay
- Engagement Pattern Analysis: Peak hours/days detection, session pattern (morning/evening/throughout/sporadic), consistency scoring, optimal notification time calculation
- Time Preference Detection: Preferred hours/days, recommended digest time, optimal push notification window with confidence scoring
- Diversity Scoring: 70/30 familiar/new content targeting, topic breadth, content type breadth, diversity recommendations for underexposed topics
- User Segmentation: news_junkie, topic_focused, casual_reader, breaking_only, morning_reader, evening_reader, weekend_reader, new_user
- Content Scoring: Multi-factor scoring (relevance, familiarity, novelty, timeliness) with diversity boost and priority adjustments
- Helper Functions: createPersonalizationEngine, createInMemoryProfileStorage, createInMemoryReadingHistoryStorage, scoreContentForUser, rankNotificationsForUser
23.17.6 Accessibility & Inclusion (WCAG 2.2 AA)#
23.17.6.1 Visual Accessibility#
- 23.17.6.1 Implement screen reader optimization (ARIA)
- 23.17.6.2 Ensure semantic HTML structure
- 23.17.6.3 Build AI-generated alt text for all images
- 23.17.6.4 Implement high contrast mode
- 23.17.6.5 Create color blind friendly design
- 23.17.6.6 Enable font size adjustment (up to 200%)
Completed (54.11.1.3): Full visual accessibility implemented in
apps/veritas/video/src/services/accessibility/visual-accessibility.ts
- ARIA Optimization: getAriaAttributes, getLandmarkAttributes, generateAriaId with support for all ARIA roles and attributes
- Semantic HTML: SEMANTIC_ELEMENTS mapping for 20+ element types, validateHeadingHierarchy, getSemanticElement helper
- AI Alt Text: generateAltText with optional AI provider, rule-based fallback, confidence scoring, decorative image handling
- High Contrast: HIGH_CONTRAST_DARK/LIGHT themes, getHighContrastStyles CSS
- Color Blind: simulateColorBlindness for all 7 types, areColorsDistinguishable, COLOR_BLIND_SAFE_PALETTE (Wong palette)
- Font Size: getFontSizeSettings with 1x-2x scale, getFontSizeCSSVariables, validateReadability checks
23.17.6.2 Motor Accessibility#
- 23.17.6.7 Implement full keyboard navigation
- 23.17.6.8 Add skip navigation links
- 23.17.6.9 Create visible focus indicators
- 23.17.6.10 Ensure touch targets >= 44px
- 23.17.6.11 Remove all time limits on interactions
Completed (54.11.1.3): Full motor accessibility implemented in
apps/veritas/video/src/services/accessibility/motor-accessibility.ts
- Keyboard Navigation: handleKeyboardNavigation, COMPONENT_SHORTCUTS for menu/tabs/dialog/carousel/listbox/tree/grid, roving tabindex support
- Skip Links: generateSkipLinks, DEFAULT_SKIP_LINKS (main/nav/search/footer)
- Focus Indicators: getFocusIndicatorStyles with default/high-contrast variants, generateFocusCss with :focus-visible support
- Touch Targets: validateTouchTarget, WCAG_MIN_TOUCH_TARGET=44px, generateTouchTargetStyles helper
- Timeout Control: createTimeout with pause/resume/extend/cancel, unlimited extensions option, generateTimeoutWarning
23.17.6.3 Auditory Accessibility#
- 23.17.6.12 Implement captions for all videos
- 23.17.6.13 Create transcripts for all podcasts
- 23.17.6.14 Build visual alternatives for audio alerts
Completed (54.11.1.3): Full auditory accessibility implemented in
apps/veritas/video/src/services/accessibility/auditory-cognitive-accessibility.ts
- Video Captions: createCaptionTrack, formatAsWebVTT/SRT, getCaptionStylingCss with customizable font/colors/edge styles, speaker identification
- Podcast Transcripts: createTranscript, formatTranscriptAsText/Html, getSegmentAtTime, searchTranscript, speaker sections
- Visual Alerts: createVisualAlert, registerAudioAlertMapping, ALERT_VISUAL_PROPERTIES for notification/warning/error/success/info
23.17.6.4 Cognitive Accessibility#
- 23.17.6.15 Create simplified language option
- 23.17.6.16 Ensure consistent navigation
- 23.17.6.17 Build distraction-free reading mode
- 23.17.6.18 Implement progress indicators
- 23.17.6.19 Design clear error prevention/recovery
Completed (54.11.1.3): Full cognitive accessibility implemented in
apps/veritas/video/src/services/accessibility/auditory-cognitive-accessibility.ts
- Simplified Language: simplifyText with word replacements, calculateReadingLevel (Flesch-Kincaid), READING_LEVELS descriptions, glossary generation
- Consistent Navigation: checkNavigationConsistency, STANDARD_NAVIGATION, order/missing item detection
- Reading Mode: DEFAULT_READING_MODE settings, generateReadingModeCss, getDyslexicFontCss, hide navigation/sidebar/comments options
- Progress Indicators: createProgressIndicator (steps/percentage/time/scroll), updateProgress, getProgressAriaAttributes, formatProgress
- Error Prevention: validateFormField, getErrorRecoveryOptions, formatErrorMessage with network/submission/timeout recovery actions
23.17.6.5 Assistive Technology Support#
- 23.17.6.20 Implement comprehensive ARIA landmarks
- 23.17.6.21 Add live region announcements
- 23.17.6.22 Create proper form field associations
- 23.17.6.23 Build accessible error identification
Completed (54.11.1.3): Assistive technology support integrated across accessibility services
- ARIA Landmarks: getLandmarkAttributes for banner/main/navigation/search/ complementary/contentinfo/form/region
- Live Regions: AriaLive type (off/polite/assertive), alert role with aria-live=assertive, status role with aria-live=polite
- Form Associations: aria-labelledby, aria-describedby, aria-invalid, aria-required in AriaAttributes interface
- Error Identification: FormErrorState with field/error/suggestion/helpLink, formatErrorMessage with summary/detailed/ariaDescription
23.17.6.6 Voice Navigation ✅#
- 23.17.6.24 Build voice command interface
- 23.17.6.25 Implement "read headlines" command
- 23.17.6.26 Create voice navigation commands
- 23.17.6.27 Enable voice search
Implementation:
apps/veritas/video/src/services/accessibility/voice-navigation.ts
- Voice Commands: 30+ default commands covering navigation, reading, playback, search, and accessibility categories
- Speech Recognition: Web Speech API integration with continuous listening, interim results, confidence thresholds, and auto-restart
- Speech Synthesis: Text-to-speech with configurable rate/pitch/volume, voice selection, and queue management
- Read Headlines: Queue-based headline reading with pause/resume/skip/stop controls, configurable count and category
- Voice Search: Pattern matching with confidence scoring and fuzzy search
- Error Handling: Comprehensive error messages for all speech recognition error types (no-speech, audio-capture, network, not-allowed, etc.)
- Configuration: Customizable language (default en-GH), confidence thresholds, speech settings, and command registration
23.17.7 Subscription System#
23.17.7.1 Payment Integration ✅#
- 23.17.7.1 Integrate MTN Mobile Money API
- 23.17.7.2 Integrate Vodafone Cash API
- 23.17.7.3 Integrate AirtelTigo Money API
- 23.17.7.4 Implement Stripe for international payments
- 23.17.7.5 Build payment processing service with webhooks
- 23.17.7.6 Implement subscription management system
Implementation: apps/veritas/video/src/services/payments/
- payment-providers.ts: MTN MoMo, Vodafone Cash, AirtelTigo Money, Stripe adapters with unified interface for payments, refunds, and webhook handling
- payment-service.ts: Unified payment processing with automatic provider selection, transaction tracking, status polling, and event handling
- subscription-management.ts: Subscription lifecycle management with plans, billing, grace periods, and feature access control
Key Features:
- Ghana phone number detection for automatic provider selection
- Currency conversion (GHS, USD, EUR, GBP) with exchange rates
- Payment reference generation and validation
- Webhook signature verification for all providers
- In-memory storage for transactions and subscriptions (production: use DB)
23.17.7.2 Subscription Tiers ✅#
- 23.17.7.7 Implement Free tier (Veritas Basic) feature gates
- 23.17.7.8 Implement Veritas Plus (₵30/month) features
- 23.17.7.9 Implement Veritas Pro (₵60/month) features
- 23.17.7.10 Build tier upgrade/downgrade flows
- 23.17.7.11 Implement trial periods automation
- 23.17.7.12 Create subscription analytics dashboard
Plans Implemented:
- Veritas Basic (Free): Standard news access
- Veritas Plus (GH₵30/month, $4.99/month): Reduced ads, offline reading, audio versions, custom alerts. 7-day trial.
- Veritas Pro (GH₵60/month, $9.99/month): Ad-free, enhanced offline, original content, early access, priority support. 14-day trial.
Features: Plan upgrade/downgrade with proration, trial management, grace periods (7 days), feature access control, billing automation
23.17.7.3 Premium Features ✅#
- 23.17.7.13 Implement ad reduction for Plus
- 23.17.7.14 Implement ad-free experience for Pro
- 23.17.7.15 Build unlimited original content access
- 23.17.7.16 Enable enhanced offline reading
- 23.17.7.17 Create early access for investigations
Implementation:
apps/veritas/video/src/services/payments/premium-features.ts
- Ad Configuration: Free (100% ads), Plus (25%, no video/interstitial), Pro (0% - completely ad-free)
- Offline Reading: Plus (50 articles, 500MB), Pro (500 articles, 5GB with videos, smart download)
- Audio Versions: Plus (2 voices, offline), Pro (6 voices, premium options)
- Custom Alerts: Plus (5 topics, 10 keywords), Pro (25 topics, 50 keywords, SMS)
- Analytics: Plus (30-day history), Pro (365-day history, export)
- Support: Plus (24hr response), Pro (4hr priority, live chat, phone)
- Original Content: Pro-exclusive with 7-day early access period
- Content Preview: 20-25% preview for non-subscribers
23.17.8 Advertising Integration ✅#
23.17.8.1 Ad Implementation ✅#
- 23.17.8.1 Integrate Google AdSense
- 23.17.8.2 Configure ad placements (banner, native, video)
- 23.17.8.3 Implement ad loading optimization
- 23.17.8.4 Build ad-free mode for subscribers
- 23.17.8.5 Create sponsored content workflow
23.17.8.2 YouTube Monetization ✅#
- 23.17.8.6 Build YouTube Partner Program application automation
- 23.17.8.7 Configure ad settings for all channels
- 23.17.8.8 Implement Super Chat handling
- 23.17.8.9 Build channel membership integration
23.18 Veritas 24/7 Broadcast & Monetization#
23.18.1 Native Mobile Apps#
23.18.1.1 React Native Foundation ✅#
- 23.18.1.1 Initialize React Native project with Expo
- 23.18.1.2 Configure TypeScript with strict mode
- 23.18.1.3 Implement React Navigation with deep linking
- 23.18.1.4 Set up state management (Zustand/Redux)
- 23.18.1.5 Create shared component library
- 23.18.1.6 Configure EAS build pipelines
23.18.1.2 Core App Features ✅#
- 23.18.1.7 Build Home tab with infinite scroll feed
- 23.18.1.8 Build Listen tab with audio player
- 23.18.1.9 Build Watch tab with vertical video feed
- 23.18.1.10 Build You tab (profile/settings)
- 23.18.1.11 Build Search tab with filters
- 23.18.1.12 Implement article detail view with sharing
- 23.18.1.13 Build authentication flows
23.18.1.3 Audio Player ✅#
- 23.18.1.14 Integrate react-native-track-player
- 23.18.1.15 Build mini player component
- 23.18.1.16 Build full-screen player
- 23.18.1.17 Implement background playback
- 23.18.1.18 Build playback controls (speed, skip)
- 23.18.1.19 Implement lock screen controls
- 23.18.1.20 Build sleep timer
- 23.18.1.21 Implement queue management
23.18.1.4 Video Player ✅#
- 23.18.1.22 Integrate react-native-video
- 23.18.1.23 Build TikTok-style vertical feed
- 23.18.1.24 Implement swipe navigation
- 23.18.1.25 Build Picture-in-Picture
- 23.18.1.26 Implement video caching
- 23.18.1.27 Build quality selection
23.18.1.5 iOS-Specific Features#
- 23.18.1.28 Build iOS widgets (WidgetKit)
- 23.18.1.29 Implement Lock Screen widgets
- 23.18.1.30 Build Live Activities for breaking news
- 23.18.1.31 Implement Dynamic Island support
- 23.18.1.32 Build CarPlay audio integration
- 23.18.1.33 Implement Siri Shortcuts
- 23.18.1.34 Build iPad optimization
23.18.1.6 Android-Specific Features#
- 23.18.1.35 Build Android widgets (Glance API)
- 23.18.1.36 Implement Android Auto
- 23.18.1.37 Configure notification channels
- 23.18.1.38 Implement adaptive icons
- 23.18.1.39 Build foldable device support
23.18.1.7 Biometric Authentication#
- 23.18.1.40 Implement Face ID/Touch ID (iOS)
- 23.18.1.41 Implement fingerprint/face unlock (Android)
- 23.18.1.42 Build PIN/password fallback
- 23.18.1.43 Create biometric unlock for premium content
23.18.1.8 App Store Submissions#
- 23.18.1.44 Create iOS App Store assets and metadata
- 23.18.1.45 Create iOS screenshots and preview videos
- 23.18.1.46 Build automated App Store submission
- 23.18.1.47 Create Google Play Store assets
- 23.18.1.48 Build automated Play Store submission
23.18.2 24/7 YouTube Live Stream#
23.18.2.1 Live Stream Infrastructure#
- 23.18.2.1 Build RTMP streaming server
- 23.18.2.2 Implement YouTube Live API integration
- 23.18.2.3 Build stream health monitoring with auto-recovery
- 23.18.2.4 Implement automatic stream restart on failure
- 23.18.2.5 Create stream scheduling automation
23.18.2.2 Real-Time Video Generation#
- 23.18.2.6 Integrate D-ID/Tavus real-time streaming API
- 23.18.2.7 Build live script injection system
- 23.18.2.8 Create breaking news interrupt system (< 5 min)
- 23.18.2.9 Implement smooth transitions between segments
- 23.18.2.10 Build lower-third graphics system
23.18.2.3 Programming Schedule Automation#
- 23.18.2.11 Implement AI program scheduler
- 23.18.2.12 Build morning bulletin format (5-6 AM)
- 23.18.2.13 Create breakfast news magazine (6-8 AM)
- 23.18.2.14 Build hourly update format
- 23.18.2.15 Create evening report format
- 23.18.2.16 Implement overnight highlight loop automation
- 23.18.2.17 Build program clock management
23.18.2.4 Breaking News System#
- 23.18.2.18 Build P0-P3 priority classification automation
- 23.18.2.19 Implement instant interrupt for P0 news
- 23.18.2.20 Create breaking news video generation (< 5 min)
- 23.18.2.21 Build all-platform simultaneous push
- 23.18.2.22 Implement breaking news archive
23.18.2.5 Interactive Features#
- 23.18.2.23 Integrate Tavus CVI for viewer Q&A
- TavusCVIClient with full API integration (conversation management, personas, documents)
- WebRTC-based communication via Daily.co
- Persona and replica management
- Document/knowledge base integration for RAG
- 23.18.2.24 Build question submission system
- Multi-platform QuestionChannelsManager (YouTube, Twitter, Instagram, Facebook, Telegram, Web, Mobile, SMS)
- Rate limiting and spam protection
- Channel-specific handlers with polling and webhook support
- 23.18.2.25 Implement AI moderation queue
- AIModerationService with LLM-powered content analysis
- Multi-dimensional scoring (appropriateness, relevance, quality, safety)
- Rules-based pre-filtering and AI-based scoring
- Ghana-specific cultural sensitivity awareness
- Sentiment analysis and topic classification
- 23.18.2.26 Create AI response generation
- AIResponseGenerator with anchor persona simulation
- Ghana-specific anchor personas (Kwame, Abena, Kofi, Akosua, Yaa)
- Fact-checking integration
- Source citation support
- Duration estimation for live delivery
- 23.18.2.27 Build viewer engagement analytics
- EngagementAnalyticsService with real-time metrics
- Session-based tracking with snapshots
- Comprehensive reports (source, topic, viewer, response, moderation, sentiment)
- Time-series data for dashboards
- Alert system for engagement thresholds
23.18.3 Additional Languages#
23.18.3.1 Ewe Language Support#
- 23.18.3.1 Integrate Ewe translation (Ghana NLP)
- 23.18.3.2 Build Ewe TTS pipeline
- 23.18.3.3 Create Ewe AI anchor persona
- Created
libs/veritas/video-production/src/avatars/ewe-anchors.ts - 5 anchor personas: Abla Agbeko (news), Kofi Amevor (news), Edem Kpodo (sports), Sena Akorli (breaking), Dzidzor Amegah (podcast)
- EWE_GREETINGS and EWE_SIGN_OFFS templates with authentic Ewe phrases
- Helper functions: getEwePresets, getEwePresetBySlug, getEwePresetsByRole/Gender/Dialect, generateEweIntroScript/OutroScript
- Added EweDialect type to shared types
- Created
- 23.18.3.4 Translate UI to Ewe
- 23.18.3.5 Launch Ewe content automation
- Ghana NLP language + voice integration:
libs/veritas/ghana-nlp/src/types.ts,apps/veritas/audio/src/providers/ghana-nlp.ts,apps/veritas/audio/src/services/ghana-voice.ts - UI coverage:
apps/veritas/mobile/src/i18n/locales/ewe.ts,apps/veritas/web/src/messages/ee.json - Automated rendering pipeline support:
apps/veritas/audio/src/services/article-audio-pipeline.ts
- Ghana NLP language + voice integration:
23.18.3.2 Ga Language Support#
- 23.18.3.6 Integrate Ga translation (Ghana NLP)
- 23.18.3.7 Build Ga TTS pipeline
- 23.18.3.8 Create Ga AI anchor persona
- Created
libs/veritas/video-production/src/avatars/ga-anchors.ts - 5 anchor personas: Adwoa Lamptey (news), Nii Tetteh (news), Ashong Mensah (sports), Naana Adjei (breaking), Dede Quarcoo (podcast)
- GA_GREETINGS and GA_SIGN_OFFS templates with authentic Ga phrases
- Helper functions: getGaPresets, getGaPresetBySlug, getGaPresetsByRole/Gender/Dialect, generateGaIntroScript/OutroScript
- Added GaDialect type to shared types and GhanaianDialect union type
- Created
- 23.18.3.9 Translate UI to Ga
- 23.18.3.10 Launch Ga content automation
- Ghana NLP language + voice integration:
libs/veritas/ghana-nlp/src/types.ts,apps/veritas/audio/src/providers/ghana-nlp.ts,apps/veritas/audio/src/services/ghana-voice.ts - UI coverage:
apps/veritas/mobile/src/i18n/locales/ga.ts,apps/veritas/web/src/messages/ga.json - Automated rendering pipeline support:
apps/veritas/audio/src/services/article-audio-pipeline.ts
- Ghana NLP language + voice integration:
23.18.4 YouTube Channel Ecosystem#
23.18.4.1 Channel Launches#
- 23.18.4.1 Launch @VeritasSports channel automation
- 23.18.4.2 Launch @VeritasBusiness channel automation
- 23.18.4.3 Launch @VeritasTwi channel automation
- 23.18.4.4 Launch @VeritasShorts channel automation
- 23.18.4.5 Create channel-specific branding automation
- Implemented in
apps/veritas/social/src/services/channel-ecosystem.ts(DEFAULT_CHANNELS,launchChannelAutomation,launchAllDefaultChannels,createChannelBrandingPlan)
- Implemented in
23.18.4.2 Channel Management#
- 23.18.4.6 Build multi-channel publishing system
- 23.18.4.7 Create channel-specific content routing
- 23.18.4.8 Implement cross-promotion automation
- 23.18.4.9 Build unified analytics dashboard
- Implemented in
apps/veritas/social/src/services/channel-ecosystem.ts(createMultiChannelPublishingPlan,routeContentToChannels,createCrossPromotionPlan,buildUnifiedAnalyticsDashboard) - Unified scheduler foundation retained in
apps/veritas/social/src/services/unified-scheduler.ts
- Implemented in
23.18.4.3 YouTube Memberships#
- 23.18.4.10 Design membership tier system
- 23.18.4.11 Create member-exclusive content automation
- 23.18.4.12 Build perks delivery system
- 23.18.4.13 Implement membership analytics
- Membership automation design/ops implemented in
apps/veritas/social/src/services/channel-ecosystem.ts(designMembershipTierSystem,createMemberExclusiveContentPlan,buildPerksDeliveryPlan,summarizeMembershipAnalytics) - Monetization and tier primitives retained in
apps/veritas/video/src/services/advertising/youtube-monetization.ts
- Membership automation design/ops implemented in
23.18.5 Social Media Mastery#
23.18.5.1 Scale Targets Automation#
- 23.18.5.1 Build TikTok growth automation (target: 500K)
- 23.18.5.2 Implement Instagram Reels optimization (target: 10M reach)
- 23.18.5.3 Build WhatsApp Channels growth system (target: 500K)
- 23.18.5.4 Create YouTube subscriber growth automation (target: 100K)
- Platform automation implemented in
apps/veritas/social/src/services/tiktok-automation.ts,apps/veritas/social/src/services/instagram-reels-automation.ts,apps/veritas/social/src/services/whatsapp-channel-automation.ts - YouTube growth target automation implemented in
apps/veritas/social/src/services/growth-partnership-automation.ts(buildYoutubeSubscriberGrowthPlan)
- Platform automation implemented in
23.18.5.2 Full Automation#
- 23.18.5.5 Complete social media automation pipeline
- 23.18.5.6 Build AI engagement response system
- 23.18.5.7 Implement real-time sentiment monitoring
- 23.18.5.8 Create crisis detection and response automation
- Cross-platform orchestration in
apps/veritas/social/src/services/unified-scheduler.ts - AI engagement + sentiment/crisis in
apps/veritas/social/src/services/growth-partnership-automation.ts(generateAiEngagementResponse,summarizeSentiment,detectCrisis)
- Cross-platform orchestration in
23.18.5.3 Creator Partnerships Automation#
- 23.18.5.9 Build influencer discovery and outreach automation
- 23.18.5.10 Create partnership proposal generation
- 23.18.5.11 Build content collaboration workflow
- 23.18.5.12 Implement affiliate tracking system
- Implemented in
apps/veritas/social/src/services/growth-partnership-automation.ts(discoverInfluencers,generatePartnershipProposal,buildCollaborationWorkflow,summarizeAffiliatePerformance)
- Implemented in
23.18.6 Podcast Expansion#
23.18.6.1 Additional Shows#
- 23.18.6.1 Launch "Veritas Sports" podcast automation (15 min)
- 23.18.6.2 Launch "Money Matters" podcast automation (20 min)
- 23.18.6.3 Launch "Veritas Culture" podcast automation (20 min)
- 23.18.6.4 Launch "Deep Dive" weekly (45 min)
- 23.18.6.5 Launch Twi language podcasts automation
- Show templates and defaults in
apps/veritas/audio/src/services/podcast.ts(sportsRecap,moneyMatters,veritasCulture,twiDaily) - Series automation and durations in
apps/veritas/audio/src/services/podcast-series.ts(buildSportsRecapSeries,buildMoneyMattersSeries,buildVeritasCultureSeries,buildWeeklyDeepDiveSeries,buildTwiDailySeries)
- Show templates and defaults in
23.18.6.2 Voice Assistant Integration#
- 23.18.6.6 Build Alexa Skill
- 23.18.6.7 Build Google Assistant Action
- 23.18.6.8 Implement voice commands
- 23.18.6.9 Create audio briefing for smart speakers
- Implemented in
apps/veritas/audio/src/services/voice-assistant.ts(registerAlexaSkill,registerGoogleAssistantAction,registerVoiceCommand,createSmartSpeakerBriefing,handleRequest)
- Implemented in
23.18.6.3 Radio Syndication#
- 23.18.6.10 Build radio station discovery automation
- 23.18.6.11 Create syndication package generator
- 23.18.6.12 Implement automated delivery system
- Implemented in
apps/veritas/audio/src/services/radio-syndication.ts(discoverStations,generateSyndicationPackage,deliverPackage)
- Implemented in
23.18.7 B2B API Platform#
23.18.7.1 API Products#
- 23.18.7.1 Build News Feed API (articles, summaries)
- Implemented in
apps/veritas/api/src/interfaces/http/routes/v1/b2b-api.ts - GET /b2b/feed - B2B-enriched article feed with engagement, entities, bias scores
- GET /b2b/feed/:id - Article detail with full content
- GET /b2b/feed/trending - Trending articles by view count
- Implemented in
- 23.18.7.2 Build Search API with advanced filters
- POST /b2b/search - Full-text search with faceted aggregations
- GET /b2b/search/suggest - Autocomplete suggestions
- Facets: categories, topics, sources, bias distribution, language, date histogram
- 23.18.7.3 Build Fact-Check API
- GET /b2b/fact-check/claims - List claims with ClaimReview schema.org
- GET /b2b/fact-check/claims/:id - Claim detail
- POST /b2b/fact-check/search - Search/verify claims
- ClaimReview schema.org structured data for Google Fact Check
- 23.18.7.4 Build Entity API (people, orgs, events)
- GET /b2b/entities/search - Search named entities
- GET/POST/PATCH /b2b/entities/:id - Entity CRUD
- GET /b2b/entities/:id/articles - Articles mentioning entity
- GET /b2b/entities/:id/relationships - Entity relationships
- POST /b2b/entities/mentions - Record entity mentions
- POST /b2b/entities/relationships - Create relationships
- 23.18.7.5 Build Monitoring/Alerts API
- GET/POST /b2b/alerts - Alert subscription management
- GET/PATCH/DELETE /b2b/alerts/:id - Individual subscription operations
- GET /b2b/alerts/notifications - Alert notifications history
- GET /b2b/monitoring/stats - Dashboard stats
- Alert types: keyword, topic, entity_mention, breaking_news, fact_check, source, sentiment_change
- Delivery: webhooks, email with instant/hourly/daily/weekly frequency
- 23.18.7.6 Build Media API (images, videos)
- GET /b2b/media - List media assets with filters (kind, role, date)
- GET /b2b/media/:id - Media asset detail with variants
- GET /b2b/media/article/:articleId - All media for an article
- POST /b2b/media/search - Search media by alt_text, caption, credit
- Support for images, videos, audio, documents, embeds
- Responsive variants and transcode status tracking
23.18.7.2 API Infrastructure#
- 23.18.7.7 Implement API key management system
- Full CRUD for API keys in
apps/veritas/api/src/interfaces/http/routes/v1/api-keys.ts - Key rotation with grace period
- Scope-based access control (articles, search, claims, entities, sources, analytics)
- IP allowlist support
- Test/production key modes
- Full CRUD for API keys in
- 23.18.7.8 Build usage tracking and metering
- recordUsage, getUsageSummary, getUserUsageSummary functions
- Per-endpoint usage tracking
- Date-range filtering for usage reports
- 23.18.7.9 Create rate limiting tiers
- Tier-based limits: free, starter, professional, enterprise
- Per-hour and per-day rate limits
- checkRateLimit function with sliding window
- 23.18.7.10 Implement webhook delivery system
- Created
apps/veritas/api/src/domain/webhooks.ts - WebhookDeliveryService with priority-based queue
- HMAC-SHA256 signature generation and verification
- Exponential backoff retry (configurable attempts, delays)
- Concurrent delivery with rate limiting
- Event-driven lifecycle (enqueued, started, delivered, failed, retrying)
- Database tables for jobs and delivery attempts
- Integrates with B2B alert subscriptions
- Created
- 23.18.7.11 Build API sandbox environment
- Created
apps/veritas/api/src/domain/sandbox.tswith comprehensive mock data generators for all B2B API endpoints - Sandbox middleware
(
apps/veritas/api/src/interfaces/http/middleware/sandbox.ts) auto-detects test keys (sktest*) and routes to sandbox environment - Per-key sandbox state with deterministic seeded random generation
- Full mock data for articles, entities, claims, sources, media, alerts
- Sandbox-specific routes (
/api/v1/sandbox/*) for management:- GET /status - sandbox configuration and stats
- PATCH /config - update sandbox settings
- POST /reset - reset sandbox state with options
- POST /scenario - trigger specific error scenarios
- Full B2B API mirror (feed, search, entities, claims, media, alerts)
- Scenario testing: rate_limited, server_error, slow_response, empty_results, large_results, invalid_data
- Header-based configuration: X-Sandbox-Mode, X-Sandbox-Scenario, X-Sandbox-Seed, X-Sandbox-Latency-Ms, X-Sandbox-Force-Error
- Relaxed rate limits (1000/hr, 10000/day) for development testing
- Request history logging for debugging
- Automatic cleanup of stale sandbox states
- Created
23.18.7.3 Developer Experience#
- 23.18.7.12 Generate comprehensive API documentation
- Created
docs/domains/veritas/extras/b2b-api/documentation suite - README.md - Overview and quick links
- getting-started.md - Quick start guide with authentication
- api-reference.md - Complete endpoint reference (all 6 API modules)
- sdks.md - JavaScript and Python SDK documentation
- error-handling.md - Error codes and handling strategies
- rate-limiting.md - Rate limits and best practices
- webhooks.md - Webhook integration guide with signatures
- sandbox.md - Testing environment documentation
- Created
- 23.18.7.13 Build JavaScript SDK
- Created
libs/veritas/b2b-sdk/TypeScript SDK package - Full TypeScript type definitions for all API entities
- VeritasClient class with resources for each API product:
feed- News Feed API (list, get, trending, iterate)search- Search API (query, suggest, iterate)claims- Fact-Check API (list, get, search, verify)entities- Entity API (search, get, create, update, relationships)media- Media API (list, get, forArticle, search)alerts- Monitoring/Alerts API (list, create, update, delete)sandbox- Sandbox management (status, configure, reset)
- Custom error classes with rich context (AuthenticationError, RateLimitError, etc.)
- Automatic retry with exponential backoff
- Rate limit header parsing
- Async iterators for pagination
- Sandbox mode detection from API key prefix
- Created
- 23.18.7.14 Build Python SDK
- Created
libs/veritas/b2b-sdk-python/Python SDK package - Both async (VeritasClient) and sync (SyncVeritasClient) clients
- Full TypedDict type hints for all API entities
- Resource classes for each API product:
feed- News Feed API (list, get, trending, iterate)search- Search API (query, suggest, iterate)claims- Fact-Check API (list, get, search, verify)entities- Entity API (search, get, create, update, relationships)media- Media API (list, get, for_article, search)alerts- Monitoring/Alerts API (list, create, update, delete)sandbox- Sandbox management (status, configure, reset)
- Custom exception classes with rich context
- HTTP client using httpx with automatic retry
- Async generators for pagination
- Context manager support for resource cleanup
- Comprehensive test suite with respx mocking
- Created
- 23.18.7.15 Create code examples and tutorials
- Created
docs/domains/veritas/extras/b2b-api/tutorials.mdcomprehensive tutorial guide - JavaScript examples:
- news-aggregator.js - Multi-category feed with caching
- fact-checker.js - Claim verification and reporting
- entity-tracker.js - Entity tracking and relationships
- Python examples:
- news_aggregator.py - Async news feed with caching
- alert_manager.py - Alert subscription management
- Tutorials for common use cases:
- News aggregation with caching
- Fact-checking service
- Entity tracking dashboard
- Real-time alerts with webhooks
- Media gallery building
- Created
- 23.18.7.16 Implement developer support chatbot ✅
23.18.7.4 API Pricing & Sales#
- 23.18.7.17 Implement usage billing system ✅
- 23.18.7.18 Create pricing tiers (Free, Basic, Pro, Enterprise) ✅
- 23.18.7.19 Build self-service signup flow ✅
- 23.18.7.20 Create enterprise sales automation ✅
23.18.8 Advanced Analytics#
23.18.8.1 Analytics Dashboard#
- 23.18.8.1 Build real-time traffic dashboard ✅
- 23.18.8.2 Create engagement analytics ✅
- 23.18.8.3 Build revenue analytics ✅
- 23.18.8.4 Implement cohort analysis ✅
- 23.18.8.5 Create content performance metrics ✅
23.18.8.2 A/B Testing Framework#
- 23.18.8.6 Implement A/B testing infrastructure ✅
- 23.18.8.7 Build headline testing system ✅
- 23.18.8.8 Create recommendation testing ✅
- 23.18.8.9 Implement UI/UX testing ✅
- 23.18.8.10 Build statistical significance automation ✅
23.18.8.3 Verification Sweep (2026-02-09)#
- 23.18.8.11 Verify strict TypeScript compilation for all Veritas apps
- Full app pass:
apps/veritas/{agents,ai-workers,analytics,api,audio,cms,ingestion,mobile,nlp,notifications,social,video,web} - Mobile strict fixes verified in:
apps/veritas/mobile/app/(tabs)/index.tsx,apps/veritas/mobile/app/(tabs)/watch.tsx,apps/veritas/mobile/app/(tabs)/you.tsx,apps/veritas/mobile/app/auth/phone-otp.tsx,apps/veritas/mobile/src/hooks/usePremiumContentLock.ts,apps/veritas/mobile/src/services/audio-player.ts,apps/veritas/mobile/src/services/tts.ts
- Full app pass:
- 23.18.8.12 Verify automated tests for 23.18 implementation modules
- Passed:
apps/veritas/social/src/services/channel-ecosystem.test.ts,apps/veritas/social/src/services/growth-partnership-automation.test.ts - Passed:
apps/veritas/audio/src/services/voice-assistant.test.ts,apps/veritas/audio/src/services/radio-syndication.test.ts,apps/veritas/audio/src/services/podcast-series.verification.test.ts - Passed:
apps/veritas/nlp/src/server.spec.ts
- Passed:
- 23.18.8.13 Verify runtime smoke tests across Veritas app surfaces
- Passed smoke suites in:
apps/veritas/ai-workers/src/smoke.test.ts,apps/veritas/audio/src/smoke.test.ts,apps/veritas/cms/src/smoke.test.ts,apps/veritas/ingestion/src/smoke.test.ts,apps/veritas/notifications/src/smoke.test.ts,apps/veritas/social/src/smoke.test.ts,apps/veritas/video/src/smoke.test.ts,apps/veritas/web/src/smoke.test.ts
- Passed smoke suites in:
23.19 Veritas Market Leadership (Year 2)#
23.19.1 Regional Expansion#
23.19.1.1 Full Regional Coverage#
- 23.19.1.1 Build coverage automation for all 16 Ghana regions
- 23.19.1.2 Create region-specific content streams
- 23.19.1.3 Build regional AI anchor personas
- 23.19.1.4 Implement location-based content delivery
23.19.1.2 Additional Languages#
- 23.19.1.5 Add Dagbani language support
- 23.19.1.6 Add Hausa language support
- 23.19.1.7 Explore Ghana Pidgin support
23.19.2 USSD Channel#
23.19.2.1 USSD Implementation#
- 23.19.2.1 Build telco USSD gateway integration
- 23.19.2.2 Design USSD menu structure
- 23.19.2.3 Create text-based news delivery
- 23.19.2.4 Implement voice callback option
23.19.3 Advanced Video Capabilities ✅#
23.19.3.1 Synthesia Enterprise#
- 23.19.3.1 Evaluate and integrate Synthesia Enterprise
- 23.19.3.2 Implement advanced avatar capabilities
- 23.19.3.3 Build long-form documentary production
- 23.19.3.4 Create internal training video system
23.19.3.2 Interactive Video#
- 23.19.3.5 Implement Synthesia Video Agents
- 23.19.3.6 Build personalized video briefings
- 23.19.3.7 Create interactive news experiences
- 23.19.3.8 Build AR news overlay foundation
23.19.3.3 Advanced Production#
- 23.19.3.9 Build AI documentary production pipeline
- 23.19.3.10 Create live event coverage automation
- 23.19.3.11 Implement multi-camera simulation
- 23.19.3.12 Build advanced graphics system
23.19.4 Next-Gen AI Features#
23.19.4.1 Full Tavus CVI Deployment#
- 23.19.4.1 Deploy real-time interactive anchors
- 23.19.4.2 Build live Q&A capability
- 23.19.4.3 Implement personalized anchor selection
- 23.19.4.4 Create viewer relationship memory
23.19.4.2 Advanced OSINT#
- 23.19.4.5 Build satellite imagery analysis integration
- 23.19.4.6 Implement social media forensics
- 23.19.4.7 Create document analysis pipeline
- 23.19.4.8 Build investigation automation tools
23.19.4.3 AI Investigations#
- 23.19.4.9 Build pattern detection system
- 23.19.4.10 Create anomaly detection for news events
- 23.19.4.11 Implement predictive coverage
- 23.19.4.12 Build automated investigation leads
23.19.5 Community Features#
23.19.5.1 Citizen Journalism#
- 23.19.5.1 Build citizen reporter portal
- 23.19.5.2 Create verification workflow for UGC
- 23.19.5.3 Implement AI rewards/recognition system
- 23.19.5.4 Build regional correspondent network automation
23.19.5.2 SecureDrop#
- 23.19.5.5 Deploy SecureDrop infrastructure
- 23.19.5.6 Set up Tor onion service
- 23.19.5.7 Create secure submission workflow
- 23.19.5.8 Build secure viewing environment
23.19.5.3 Gamification#
- 23.19.5.9 Build daily news quiz generator
- 23.19.5.10 Create prediction market system
- 23.19.5.11 Implement Veritas Points loyalty program
- 23.19.5.12 Build leaderboards
- 23.19.5.13 Create engagement badges
23.19.6 Additional Platforms#
23.19.6.1 Smartwatch Apps#
- 23.19.6.1 Build Apple Watch app
- 23.19.6.2 Implement complications
- 23.19.6.3 Build Wear OS app
- 23.19.6.4 Create watch-specific notifications
23.19.6.2 TV Apps#
- 23.19.6.5 Build Apple TV app
- 23.19.6.6 Build Android TV app
- 23.19.6.7 Build Amazon Fire TV app
23.19.7 Enterprise Features#
23.19.7.1 Media Monitoring#
- 23.19.7.1 Build enterprise monitoring dashboard
- 23.19.7.2 Create custom alert system
- 23.19.7.3 Implement brand mention tracking
- 23.19.7.4 Build competitor analysis automation
23.19.7.2 White-Label#
- 23.19.7.5 Design white-label offering
- 23.19.7.6 Build customization system
- 23.19.7.7 Create automated deployment pipeline
- 23.19.7.8 Develop licensing automation
23.19.8 Newsletter & Email Automation#
23.19.8.1 Newsletter Platform#
- 23.19.8.1 Implement email service (SendGrid/Mailchimp)
- 23.19.8.2 Configure email authentication (SPF, DKIM, DMARC)
- 23.19.8.3 Build email template system
- 23.19.8.4 Implement unsubscribe management
23.19.8.2 Daily Newsletters#
- 23.19.8.5 Build Morning Brief newsletter automation (6 AM)
- 23.19.8.6 Build Evening Digest automation (6 PM)
- 23.19.8.7 Build Personalized newsletter generation
- 23.19.8.8 Implement newsletter A/B testing
23.19.8.3 Topic Newsletters (Weekly)#
- 23.19.8.9 Create Veritas Business Monday automation
- 23.19.8.10 Create Veritas Politics Wednesday automation
- 23.19.8.11 Create Veritas Sports Friday automation
- 23.19.8.12 Create Veritas Culture Saturday automation
- 23.19.8.13 Create Week in Review Sunday automation
23.19.8.4 Special Newsletters#
- 23.19.8.14 Create Investigations newsletter automation
- 23.19.8.15 Create Elections newsletter automation
- 23.19.8.16 Create Diaspora newsletter automation
- 23.19.8.17 Create Regional newsletters automation
23.19.8.5 Email Automation#
- 23.19.8.18 Build welcome email series (5-email onboarding)
- 23.19.8.19 Create re-engagement campaign automation
- 23.19.8.20 Implement subscription upsell journeys
- 23.19.8.21 Build email personalization engine
23.19.9 SEO & Discovery Optimization#
23.19.9.1 Technical SEO#
- 23.19.9.1 Implement news sitemap (15 min updates)
- 23.19.9.2 Add NewsArticle structured data
- 23.19.9.3 Implement author schema with profiles
- 23.19.9.4 Add publisher schema
- 23.19.9.5 Implement ClaimReview schema for fact-checks
- 23.19.9.6 Configure canonical URLs
- 23.19.9.7 Implement pagination handling
- 23.19.9.8 Add hreflang tags for multi-language
23.19.9.2 Google News Optimization#
- 23.19.9.9 Build Google News Publisher Center submission
- 23.19.9.10 Submit news sitemap automation
- 23.19.9.11 Configure Google News metadata
- 23.19.9.12 Optimize for Google Discover
- 23.19.9.13 Build E-E-A-T signals (author pages, about)
23.19.9.3 Core Web Vitals Automation#
- 23.19.9.14 Build automated LCP monitoring (< 2.5s)
- 23.19.9.15 Build automated FID monitoring (< 100ms)
- 23.19.9.16 Build automated CLS monitoring (< 0.1)
- 23.19.9.17 Implement performance regression alerts
- 23.19.9.18 Create performance budgets
23.19.9.4 Web Stories#
- 23.19.9.19 Build Web Stories capability
- 23.19.9.20 Create Web Stories templates
- 23.19.9.21 Implement Web Stories distribution
23.19.10 Comment System & AI Moderation#
23.19.10.1 Comment System#
- 23.19.10.1 Design comment database schema
- 23.19.10.2 Build comment submission API
- 23.19.10.3 Implement threaded conversations
- 23.19.10.4 Build quote and reply functionality
- 23.19.10.5 Create reaction options
- 23.19.10.6 Implement comment notifications
23.19.10.2 AI Moderation (Perspective API)#
- 23.19.10.7 Integrate Google Perspective API
- 23.19.10.8 Configure toxicity detection thresholds
- 23.19.10.9 Implement auto-remove for severe toxicity (>0.8)
- 23.19.10.10 Build AI moderation queue for borderline
- 23.19.10.11 Implement spam filtering
- 23.19.10.12 Build personal information detection
- 23.19.10.13 Create threat detection system
23.19.10.3 AI Moderation Dashboard#
- 23.19.10.14 Build AI moderator dashboard
- 23.19.10.15 Create escalation workflow automation
- 23.19.10.16 Implement appeal process
- 23.19.10.17 Generate community guidelines
- 23.19.10.18 Create moderation analytics
23.19.10.4 Community Features#
- 23.19.10.19 Implement verified expert badges
- 23.19.10.20 Create quality contributor recognition
- 23.19.10.21 Build comment reporting system
- 23.19.10.22 Create commenter reputation system
23.19.11 Internal CMS & Editorial Tools#
23.19.11.1 Content Management System#
- 23.19.11.1 Build custom CMS foundation
- 23.19.11.2 Create rich text editor with AI assistance
- 23.19.11.3 Implement real-time collaboration
- 23.19.11.4 Build version control for articles
- 23.19.11.5 Create draft autosave system
- 23.19.11.6 Integrate media library
23.19.11.2 Editorial Workflow Automation#
- 23.19.11.7 Build AI assignment desk interface
- 23.19.11.8 Create story pitch generation system
- 23.19.11.9 Implement AI edit queue
- 23.19.11.10 Build approval workflow automation
- 23.19.11.11 Create publication scheduler
- 23.19.11.12 Build embargo management
23.19.11.3 Breaking News Dashboard#
- 23.19.11.13 Create breaking news command center
- 23.19.11.14 Implement one-click publishing
- 23.19.11.15 Build multi-platform push system
- 23.19.11.16 Create live update capability
- 23.19.11.17 Build breaking news templates
23.19.11.4 AI Assistance in CMS#
- 23.19.11.18 Integrate headline suggestions
- 23.19.11.19 Build SEO recommendations
- 23.19.11.20 Add fact-check integration
- 23.19.11.21 Create related content suggestions
- 23.19.11.22 Implement auto-tagging
- 23.19.11.23 Build readability scoring
23.19.12 Historical Archive & "On This Day"#
23.19.12.1 Archive System#
- 23.19.12.1 Design archive database schema
- 23.19.12.2 Build full-text archive search
- 23.19.12.3 Implement date range filtering
- 23.19.12.4 Create topic-based exploration
- 23.19.12.5 Build person/organization timelines
- 23.19.12.6 Implement source-based browsing
23.19.12.2 "On This Day" Feature#
- 23.19.12.7 Build daily historical highlights generator
- 23.19.12.8 Create anniversary reminder system
- 23.19.12.9 Build "This Week in History" newsletter
- 23.19.12.10 Implement historical context linking
23.19.12.3 Story Evolution Tracking#
- 23.19.12.11 Build story development tracker
- 23.19.12.12 Record key updates and corrections
- 23.19.12.13 Document source additions
- 23.19.12.14 Build story timeline visualization
23.19.12.4 Special Collections#
- 23.19.12.15 Create Ghana Independence archive
- 23.19.12.16 Build election archives
- 23.19.12.17 Create economic milestones collection
- 23.19.12.18 Build cultural moments archive
23.19.13 Real-Time Data Integrations#
23.19.13.1 Sports Data#
- 23.19.13.1 Integrate sports data API (SportsDataIO)
- 23.19.13.2 Build Ghana Premier League live scores
- 23.19.13.3 Implement Black Stars match tracking
- 23.19.13.4 Add international football scores
- 23.19.13.5 Build real-time statistics display
- 23.19.13.6 Create automated match report generation
23.19.13.2 Financial Data#
- 23.19.13.7 Integrate Ghana Stock Exchange data (GSE-CI)
- 23.19.13.8 Build stock ticker display
- 23.19.13.9 Implement forex rates (USD/GHS, EUR/GHS, GBP/GHS)
- 23.19.13.10 Add commodity prices (Gold, Cocoa, Oil)
- 23.19.13.11 Integrate Bank of Ghana rates
- 23.19.13.12 Build market alert system
23.19.13.3 Weather Data#
- 23.19.13.13 Integrate Ghana Meteorological Agency data
- 23.19.13.14 Build weather widget
- 23.19.13.15 Implement 7-day forecasts
- 23.19.13.16 Create severe weather alerts
- 23.19.13.17 Add farming weather advisories
- 23.19.13.18 Build Harmattan tracking
23.19.13.4 Additional Data#
- 23.19.13.19 Build Accra traffic conditions integration
- 23.19.13.20 Implement fuel prices by region
- 23.19.13.21 Add flight status (KIA) integration
- 23.19.13.22 Create ECG load shedding schedule
- 23.19.13.23 Build mobile money rates display
23.19.14 Crisis & Emergency Features#
23.19.14.1 Emergency Alert System#
- 23.19.14.1 Build national emergency detection
- 23.19.14.2 Create disaster alert system
- 23.19.14.3 Implement health emergency alerts
- 23.19.14.4 Build security alert capability
- 23.19.14.5 Create severe weather warning system
23.19.14.2 Emergency Distribution#
- 23.19.14.6 Implement all-user push notifications
- 23.19.14.7 Create SMS alert system (opt-in)
- 23.19.14.8 Build WhatsApp broadcast for emergencies
- 23.19.14.9 Implement homepage takeover automation
- 23.19.14.10 Create social media emergency blast
23.19.14.3 Election War Room#
- 23.19.14.11 Build dedicated election coverage dashboard
- 23.19.14.12 Create real-time results tracker
- 23.19.14.13 Implement misinformation rapid response
- 23.19.14.14 Build fact-check surge automation
- 23.19.14.15 Create source verification system
23.19.15 Blockchain & Content Authentication ✅#
23.19.15.1 Content Verification#
- 23.19.15.1 Implement cryptographic hash on publication
- 23.19.15.2 Build blockchain timestamp proof system
- 23.19.15.3 Create content authenticity certificates
- 23.19.15.4 Implement author signature verification
- 23.19.15.5 Build verification API for third parties
23.19.15.2 Source Media Verification#
- 23.19.15.6 Implement photo/video origin tracking
- 23.19.15.7 Build edit history transparency
- 23.19.15.8 Create device-level signing for UGC
- 23.19.15.9 Document chain of custody
23.19.15.3 Anti-Manipulation#
- 23.19.15.10 Integrate deepfake detection AI
- 23.19.15.11 Build image manipulation detection
- 23.19.15.12 Implement metadata integrity checks
- 23.19.15.13 Create "Verified Original" badges
23.19.16 Profitability & Business Optimization ✅#
23.19.16.1 Revenue Optimization#
- 23.19.16.1 Build ad placement optimization
- 23.19.16.2 Implement subscription conversion optimization
- 23.19.16.3 Scale B2B API revenue automation
- 23.19.16.4 Build sponsorship sales automation
23.19.16.2 Cost Optimization#
- 23.19.16.5 Implement infrastructure cost optimization
- 23.19.16.6 Build AI efficiency improvements
- 23.19.16.7 Create automated resource scaling
23.20 Veritas Pan-African Vision (Year 3+) ✅#
23.20.1 Geographic Expansion#
23.20.1.1 Nigeria Market Entry#
- 23.20.1.1 Build Nigeria market research automation
- 23.20.1.2 Generate Nigeria entity documentation
- 23.20.1.3 Build Nigeria content adaptation system
- 23.20.1.4 Create Nigeria AI anchor personas
- 23.20.1.5 Launch Veritas Nigeria automation
23.20.1.2 Kenya Market Entry#
- 23.20.1.6 Build Kenya market research automation
- 23.20.1.7 Generate Kenya entity documentation
- 23.20.1.8 Build Kenya content adaptation system
- 23.20.1.9 Create Kenya AI anchor personas
- 23.20.1.10 Launch Veritas Kenya automation
23.20.1.3 Additional Markets#
- 23.20.1.11 Build South Africa opportunity analysis
- 23.20.1.12 Explore Francophone Africa automation
- 23.20.1.13 Build pan-African content strategy
23.20.2 Technology Platform#
23.20.2.1 Veritas AI News Platform#
- 23.20.2.1 Package technology for licensing
- 23.20.2.2 Create onboarding automation
- 23.20.2.3 Build platform documentation
- 23.20.2.4 Develop automated training programs
23.20.2.2 African Languages Consortium#
- 23.20.2.5 Build NLP partnership automation
- 23.20.2.6 Contribute to open-source language models
- 23.20.2.7 Build shared language resources
23.20.2.3 AI Journalism Institute#
- 23.20.2.8 Design automated curriculum
- 23.20.2.9 Build training platform
- 23.20.2.10 Create certification automation
23.20.3 Scale & Growth#
23.20.3.1 Financial Milestones#
- 23.20.3.1 Build profitability tracking automation
- 23.20.3.2 Prepare Series A documentation
- 23.20.3.3 Build acquisition evaluation automation
- 23.20.3.4 Create $100M revenue tracking
23.21 Veritas Ongoing & Cross-Cutting Tasks ✅#
23.21.1 Security & Compliance#
23.21.1.1 Security Operations#
- 23.21.1.1 Implement automated security audits
- 23.21.1.2 Build automated penetration testing
- 23.21.1.3 Create policy update automation
- 23.21.1.4 Implement automated phishing detection
- 23.21.1.5 Build incident response automation
- 23.21.1.6 Create threat model updates
23.21.1.2 Data Protection#
- 23.21.1.7 Implement GDPR/DPA compliance automation
- 23.21.1.8 Build data subject request automation
- 23.21.1.9 Create privacy documentation updates
- 23.21.1.10 Implement data retention automation
- 23.21.1.11 Build third-party processor audit automation
23.21.1.3 Content Security#
- 23.21.1.12 Build content manipulation monitoring
- 23.21.1.13 Implement deepfake detection updates
- 23.21.1.14 Build content authentication verification
- 23.21.1.15 Maintain blockchain verification
23.21.2 Quality Assurance Automation#
23.21.2.1 Testing#
- 23.21.2.1 Build automated test suite (unit, integration, e2e)
- 23.21.2.2 Implement continuous regression testing
- 23.21.2.3 Build load/stress testing automation
- 23.21.2.4 Create cross-browser/device testing
- 23.21.2.5 Implement accessibility testing automation
23.21.2.2 Content Quality#
- 23.21.2.6 Build AI content accuracy monitoring
- 23.21.2.7 Implement correction rate tracking
- 23.21.2.8 Build fact-check accuracy auditing
- 23.21.2.9 Create editorial standards compliance automation
23.21.3 Performance Monitoring#
23.21.3.1 Technical Performance#
- 23.21.3.1 Build Core Web Vitals monitoring automation
- 23.21.3.2 Implement API response time tracking
- 23.21.3.3 Create error rate monitoring
- 23.21.3.4 Build uptime tracking (99.9% target)
- 23.21.3.5 Implement infrastructure cost monitoring
23.21.3.2 Business Performance#
- 23.21.3.6 Build weekly KPI tracking automation
- 23.21.3.7 Create monthly report generation
- 23.21.3.8 Implement quarterly review automation
- 23.21.3.9 Build annual strategic planning support
23.21.4 Autonomous Editorial Operations#
23.21.4.1 Daily Operations Automation#
- 23.21.4.1 Build autonomous morning editorial briefing
- 23.21.4.2 Implement breaking news monitoring and escalation
- 23.21.4.3 Build AI content quality review automation
- 23.21.4.4 Create fact-check queue management
- 23.21.4.5 Implement bias assessment updates
23.21.4.2 Content Calendar Automation#
- 23.21.4.6 Build weekly content planning automation
- 23.21.4.7 Create special coverage scheduling
- 23.21.4.8 Implement investigation coordination
- 23.21.4.9 Build seasonal content planning
23.21.5 Community & Support Automation#
23.21.5.1 User Support#
- 23.21.5.1 Build AI-powered help center
- 23.21.5.2 Implement automated ticket resolution
- 23.21.5.3 Build app store review monitoring and response
- 23.21.5.4 Create automated bug tracking
23.21.5.2 Community Engagement#
- 23.21.5.5 Build social media mention monitoring
- 23.21.5.6 Implement automated feedback response
- 23.21.5.7 Create citizen journalist engagement automation
- 23.21.5.8 Build community partnership automation
23.21.6 Documentation Automation#
23.21.6.1 Technical Documentation#
- 23.21.6.1 Build automated API documentation generation
- 23.21.6.2 Implement architecture documentation updates
- 23.21.6.3 Create deployment procedure automation
- 23.21.6.4 Build runbook maintenance automation
23.21.6.2 Business Documentation#
- 23.21.6.5 Build PRD update automation
- 23.21.6.6 Implement roadmap maintenance
- 23.21.6.7 Create process documentation automation
- 23.21.6.8 Build decision tracking system
23.21.7 Training & Development#
23.21.7.1 AI System Training#
- 23.21.7.1 Implement continuous model fine-tuning
- 23.21.7.2 Build AI ethics enforcement
- 23.21.7.3 Create journalism standards training for AI
- 23.21.7.4 Implement skill development automation
23.21.7.2 Public Education#
- 23.21.7.5 Build "How We Work" transparency page automation
- 23.21.7.6 Implement media literacy resource generation
- 23.21.7.7 Create educational content automation
- 23.21.7.8 Build journalism workshop content generation
23.21.8 Partnerships & Business Development Automation#
23.21.8.1 Content Partnerships#
- 23.21.8.1 Build wire service relationship automation
- 23.21.8.2 Implement photo agency licensing automation (Getty, AP, Shutterstock)
- 23.21.8.3 Create local photographer network automation
- 23.21.8.4 Build syndication partnership automation
23.21.8.2 Technology Partnerships#
- 23.21.8.5 Build AI vendor relationship management
- 23.21.8.6 Implement technology integration evaluation
- 23.21.8.7 Create industry group participation automation
23.21.8.3 Distribution Partnerships#
- 23.21.8.8 Build social platform relationship management
- 23.21.8.9 Implement telco partnership automation
- 23.21.8.10 Create media partnership automation
23.22 Veritas Risk Mitigation ✅#
23.22.1 Technical Risks#
- 23.22.1.1 Build AI hallucination monitoring system
- 23.22.1.2 Implement source backup automation
- 23.22.1.3 Create rate limiting mitigation
- 23.22.1.4 Build disaster recovery automation
- 23.22.1.5 Implement security incident response automation
23.22.2 Legal Risks#
- 23.22.2.1 Build copyright compliance automation
- 23.22.2.2 Implement defamation detection system
- 23.22.2.3 Create data protection audit automation
- 23.22.2.4 Build regulatory monitoring automation
23.22.3 Business Risks#
- 23.22.3.1 Implement revenue diversification automation
- 23.22.3.2 Build competitive response system
- 23.22.3.3 Create market research automation
- 23.22.3.4 Implement user feedback loop automation
23.22.4 Reputational Risks#
- 23.22.4.1 Build fact-checking quality assurance
- 23.22.4.2 Implement bias monitoring automation
- 23.22.4.3 Create correction process automation
- 23.22.4.4 Build crisis communication automation
Veritas Success Metrics Tracking#
| Metric | Month 6 Target | Year 1 Target | Year 2 Target |
|---|---|---|---|
| MAU | 100,000 | 500,000 | 2,000,000 |
| DAU | 20,000 | 100,000 | 500,000 |
| Paid Subscribers | 500 | 5,000 | 25,000 |
| API Customers | 5 | 20 | 100 |
| YouTube Subscribers | 25,000 | 100,000 | 500,000 |
| TikTok Followers | 100,000 | 500,000 | 2,000,000 |
| Articles/Day | 200 | 500+ | 1,000+ |
| AI-Generated Content % | 95% | 98% | 99% |
| Monthly Revenue | ₵50,000 | ₵150,000 | ₵500,000 |
| Trust Score | 3.5/5.0 | 4.0/5.0 | 4.5/5.0 |
Veritas Autonomous Agent Summary#
| Agent | Function | Key Capabilities |
|---|---|---|
| Editor-in-Chief Agent | Strategic editorial leadership | News prioritization, brand voice, cross-platform strategy |
| Managing Editor Agent | Daily operations | Content flow, quality control, deadline management |
| Journalist Agents (10+) | Content creation | Research, writing, source management, beat coverage |
| Fact-Checker Agent | Verification | Claim extraction, evidence retrieval, confidence scoring |
| Content Strategist Agent | Audience optimization | Performance analysis, trend detection, gap identification |
| Social Media Manager Agent | Platform management | Content adaptation, engagement, crisis response |
| Product Manager Agent | Feature prioritization | User feedback, roadmap, competitive intelligence |
| UX Analyst Agent | Interface optimization | Behavior analysis, usability, accessibility |
| DevOps Agent | Infrastructure management | Monitoring, scaling, security, deployment |
| QA Agent | Quality assurance | Automated testing, regression, performance |
Updated Phase 23 Summary Statistics#
| Section | Task Count |
|---|---|
| 23.1 Codebase Analysis & Inventory | 8 |
| 23.2 Domain Refactoring | 42 |
| 23.3 Oshun Shared Library Integration | 18 |
| 23.4 Isis Domain Integration (AI) | 12 |
| 23.5 Sophia Domain Integration (Knowledge) | 6 |
| 23.6 AI Agent Framework | 24 |
| 23.7 Video Production Pipeline | 18 |
| 23.8 Audio Production Pipeline | 11 |
| 23.9 Social Media Automation | 14 |
| 23.10 Mobile Applications | 14 |
| 23.11 Ghana-Specific Features | 18 |
| 23.12 Monetization System | 10 |
| 23.13 Testing & Quality Assurance | 10 |
| 23.14 CI/CD & Deployment | 8 |
| 23.15 Documentation | 6 |
| 23.16 Launch Preparation | 9 |
| 23.17 Product Implementation Tasks | ~100 |
| 23.18 24/7 Broadcast & Monetization | ~150 |
| 23.19 Market Leadership (Year 2) | ~200 |
| 23.20 Pan-African Vision (Year 3+) | ~50 |
| 23.21 Ongoing & Cross-Cutting Tasks | ~100 |
| 23.22 Risk Mitigation | ~20 |
| TOTAL Phase 23 | ~878 |