Codex-generated pull request

.github/README.md

@@ -10,14 +10,20 @@
 
 **Create, optimize, and publish high‑quality content across platforms — in minutes, not months.**
 
-[🌐 Live Demo](https://www.alwrity.com) • [📚 Docs Site](https://ajaysi.github.io/ALwrity/) • [📖 Wiki](https://github.com/AJaySi/AI-Writer/wiki) • [💬 Discussions](https://github.com/AJaySi/AI-Writer/discussions) • [🐛 Issues](https://github.com/AJaySi/AI-Writer/issues)
+[🌐 Live Demo](https://www.alwrity.com) • [📚 Docs Site](https://ajaysi.github.io/ALwrity/) • [📖 Wiki](https://github.com/AJaySi/ALwrity/wiki) • [💬 Discussions](https://github.com/AJaySi/AI-Writer/discussions) • [🐛 Issues](https://github.com/AJaySi/AI-Writer/issues)
 
 </div>
 
 <p align="center">
-  <a href="https://ajaysi.github.io/ALwrity/"><img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/hero-1.jpg" alt="ALwrity dashboard overview" width="30%"/></a>
-  <a href="https://ajaysi.github.io/ALwrity/features/blog-writer/overview/"><img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/hero-2.png" alt="Story Writer workflow" width="30%"/></a>
-  <a href="https://ajaysi.github.io/ALwrity/features/seo-dashboard/overview/"><img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/hero-3.png" alt="SEO dashboard insights" width="30%"/></a>
+  <img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/hero-1.jpg" alt="ALwrity dashboard overview" width="30%"/>
+  <img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/hero-2.png" alt="Blog Writer workflow" width="30%"/>
+  <img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/hero-3.png" alt="SEO dashboard insights" width="30%"/>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/podcast-maker.png" alt="Podcast Maker - AI Audio Content" width="30%"/>
+  <img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/video-studio.png" alt="Video Studio - AI Video Creation" width="30%"/>
+  <img src="https://raw.githubusercontent.com/AJaySi/AI-Writer/main/docs-site/docs/assests/instagram-editor.png" alt="Instagram Editor - Social Media Content" width="30%"/>
 </p>
 
 ---
@@ -27,6 +33,7 @@
 - **Grounded & reliable**: Google grounding, Exa/Tavily research, citation management.
 - **Secure & scalable**: JWT auth, OAuth2, rate limiting, monitoring, subscription/usage tracking.
 - **Built for solopreneurs**: Enterprise-grade capabilities with a fast, friendly UI.
+- **Comprehensive documentation**: Detailed guides, user journeys, and contextual help throughout the platform.
 
 ---
 
@@ -40,13 +47,17 @@
 ---
 
 ### What’s functional now
-- **AI Blog Writer (Phases)**: Research → Outline → Content → SEO → Publish, with guarded navigation and local persistence (`frontend/src/hooks/usePhaseNavigation.ts`).
-- **SEO Dashboard**: Analysis, metadata, and Google Search Console insights (see docs under `docs-site/docs/features/seo-dashboard`).
-- **Story Writer**: Setup (premise) → Outline → Writing → Export with phase navigation and reset (`frontend/src/hooks/useStoryWriterPhaseNavigation.ts`).
-- **LinkedIn (Factual, Google‑Grounded)**: Real Google grounding + citations + quality metrics for posts/articles/carousels/scripts (see `frontend/docs/linkedin_factual_google_grounded_url_content.md`).
-- **Persona System**: Core personas and platform adaptations via APIs (`backend/api/persona.py`).
-- **Facebook Persona Service**: Gemini structured JSON for Facebook‑specific persona optimization (`backend/services/persona/facebook/facebook_persona_service.py`).
-- **Personalization & Brand Voice**: Validation and configuration of writing style, tone, structure (`backend/services/component_logic/personalization_logic.py`).
+- **AI Blog Writer (Phases)**: Research → Outline → Content → SEO → Publish, with guarded navigation and local persistence.
+- **SEO Dashboard**: Analysis, metadata, and Google Search Console insights with comprehensive optimization tools.
+- **Story Writer**: Setup (premise) → Outline → Writing → Export with phase navigation and multimedia integration.
+- **LinkedIn Writer**: Factual, Google‑grounded content with citations and quality metrics for posts/articles/carousels/scripts.
+- **Instagram Editor**: Multi-format content creation with CopilotKit integration for Feed, Stories, and Reels.
+- **Podcast Maker**: AI-powered audio content creation with research, scripting, and voice synthesis.
+- **Video Studio**: Comprehensive video creation with WaveSpeed AI integration and multiple modules.
+- **YouTube Studio**: AI-powered YouTube content planning, scene building, and optimization.
+- **Content Calendar**: AI-powered content planning and scheduling across all platforms.
+- **ALwrity Researcher**: Intent-driven research with multi-source integration and structured outputs.
+- **Persona System**: Core personas with platform-specific adaptations and brand voice management.
 
 See details in the Wiki: [Docs Home](https://github.com/AJaySi/AI-Writer/wiki)
 
@@ -117,14 +128,31 @@ For module details, see `backend/services/llm_providers/README.md`.
 ---
 
 ### Documentation
-- Docs Site (MkDocs): https://ajaysi.github.io/ALwrity/
-- Blog Writer (phases and UI): `docs-site/docs/features/blog-writer/overview.md`
-- SEO Dashboard overview: `docs-site/docs/features/seo-dashboard/overview.md`
-- SEO Dashboard GSC integration: `docs-site/docs/features/seo-dashboard/gsc-integration.md`
-- LinkedIn factual, Google-grounded content: `frontend/docs/linkedin_factual_google_grounded_url_content.md`
-- Persona Development (docs-site): `docs-site/docs/features/content-strategy/personas.md`
+- **[📖 GitHub Wiki](https://github.com/AJaySi/ALwrity/wiki)**: Complete documentation, guides, and tutorials
+- **[📚 Docs Site](https://ajaysi.github.io/ALwrity/)**: Interactive documentation with search
+
+#### 📖 **Wiki Documentation**
+- **[Getting Started](https://github.com/AJaySi/ALwrity/wiki/Getting-started-with-ALwrity-AI-writer)**
+- **[Configuration Options](https://github.com/AJaySi/ALwrity/wiki/Alwrity-AI-Writer-Configuration-options)**
+- **[Interface Overview](https://github.com/AJaySi/ALwrity/wiki/ALwrity-Interface-first-page-explanation)**
+- **[AI Web Research](https://github.com/AJaySi/ALwrity/wiki/Alwrity-AI-Web-Research-Details-for-content-writing)**
+- **[Blog from Audio](https://github.com/AJaySi/ALwrity/wiki/How-to-use-AI-to-blog-from-Audio)**
+- **[LLM Models](https://github.com/AJaySi/ALwrity/wiki/Changing-LLM-Models-in-Alwrity-AI-Writer)**
+
+#### 📖 **Internal Documentation**
+For developers and contributors:
+- **[Frontend Documentation Integration](docs/frontend-documentation-integration.md)**: Guide for implementing contextual help links
+- **[Implementation Guides](docs/)**: Technical specifications and implementation details
+- **[API Documentation](docs/Onboarding/README.md)**: Backend API and service documentation
+
+---
 
-For additional pages, browse the `docs-site/docs/` folder.
+### 🎯 **Recent Updates**
+- **📚 Enhanced Documentation**: Comprehensive GitHub Wiki with detailed feature guides and tutorials
+- **🔗 Contextual Help**: Integrated documentation links throughout the frontend UI
+- **📱 Multi-Platform Support**: Expanded content creation for YouTube, Instagram, LinkedIn, and more
+- **🎙️ Audio & Video**: Podcast Maker and Video Studio with AI-powered creation tools
+- **🤖 Advanced AI**: WaveSpeed AI integration for cutting-edge content generation
 
 ---
 
@@ -134,9 +162,6 @@ ALwrity generates a core writing persona from onboarding data, then adapts it pe
 - Core Persona & API: `backend/api/persona.py`
 - Facebook Persona Service (Gemini structured JSON): `backend/services/persona/facebook/facebook_persona_service.py`
 - Personalization/Brand Voice logic: `backend/services/component_logic/personalization_logic.py`
-- Docs (GitHub paths):
-  - Personas (docs-site): https://github.com/AJaySi/AI-Writer/blob/main/docs-site/docs/features/content-strategy/personas.md
-  - LinkedIn Grounded Content plan: https://github.com/AJaySi/AI-Writer/blob/main/frontend/docs/linkedin_factual_google_grounded_url_content.md
 
 At a glance:
 - Data → Persona: Onboarding + website analysis → core persona

.gitignore

@@ -20,6 +20,9 @@ youtube_videos/
 backend/podcast_images/
 backend/podcast_videos/
 
+backend\alwrity.db
+
+
 backend/researchtools_text/projects/
 youtube_avatars/
 youtube_avatars/*
@@ -241,3 +244,18 @@ docs/__pycache__/
 backend/.onboarding_progress*.json
 backend/researchtools_text/projects/Draft__AI_advanc_c2f90698.json
 backend/researchtools_text/projects/Draft__AI_adv_388d4491.json
+# Generated Media Content (MAJOR SIZE CONTRIBUTORS)
+youtube_videos/
+podcast_images/
+podcast_audio/
+podcast_videos/
+story_audio/
+story_images/
+story_videos/
+transform_videos/
+researchtools_text/
+
+# Backend Generated Images
+backend/image_studio_images/
+backend/linkedin_images/
+backend/linkedin_images/**

IMAGE_STUDIO_REVIEW.md

@@ -0,0 +1,80 @@
+# ALwrity Image Studio Review (End-User Perspective)
+
+## Scope Reviewed
+This review is based on a code walkthrough of the Image Studio frontend modules, routing, hooks, and backend Image Studio routers/services.
+
+## What feels strong (as an end user)
+
+1. **Broad studio coverage in one place**
+   - The dashboard and module catalog expose a full visual workflow: creation, editing, upscaling, control, social optimization, processing, face swap, and asset library.
+2. **Good UX framing and discoverability**
+   - The dashboard module cards include practical descriptions, highlights, and examples. This helps a non-technical marketer quickly choose the right tool.
+3. **Strong backend modularity and service separation**
+   - The backend facade splits image workflows into generation, editing, advanced, and utilities routers. This is a good foundation for scale and maintainability.
+4. **Coverage beyond generation**
+   - Image Studio includes practical post-processing capabilities (compression + format conversion), which are essential for publishing workflows.
+5. **Cost-awareness signals exist**
+   - Cost estimate APIs and “preflight operation” patterns indicate cost transparency is a design consideration.
+
+## Robustness assessment
+
+### Positive robustness signals
+- **Consistent top-level orchestration** via `ImageStudioManager`, which centralizes workflows for create/edit/upscale/control/social/transform/utilities.
+- **Health and status endpoints** exist for operational introspection.
+- **Input validation patterns** are visible in service layers (e.g., supported formats, platform validation), reducing invalid-request failures.
+
+### Robustness concerns / risks
+1. **Transform Studio appears implemented but not route-mounted in app routing**
+   - The module list points to `/image-transform` and `TransformStudio` exists, but the route is not defined in `App.tsx`.
+   - End-user impact: users can see/expect this capability but may hit dead navigation or inaccessible feature entry.
+2. **Mismatch between marketing copy and actual completion state in processing suite**
+   - Image Processing Studio advertises resizer/watermarking in copy but those tabs are disabled and marked “Coming Soon.”
+   - End-user impact: expectation gap and trust erosion.
+3. **Create flow can return `success: true` even with failed variations**
+   - The generation loop captures per-variation exceptions and still returns success at the top-level with failure counts.
+   - End-user impact: ambiguous success state; users may think job completed fully when partial/total failure occurred.
+4. **Operational observability is incomplete**
+   - `/metrics` is currently a placeholder, limiting production-level reliability visibility.
+5. **Potentially stale pricing language in UI descriptors**
+   - Module cards contain highly specific pricing text while provider/model costs in service code are hard-coded estimates.
+   - End-user impact: confusion if invoiced pricing diverges from UI estimates.
+
+## Feature gaps observed (end-user lens)
+
+1. **No clearly surfaced asynchronous job UX for long-running transform workflows**
+   - Current hook/flow appears request-response centric; if generation times spike, users may need resilient background jobs, retries, and resumable status views.
+2. **No integrated “workflow chaining” UX**
+   - A user likely wants: create → edit → upscale → social exports in a single guided flow with one asset lineage timeline.
+3. **Limited confidence UX around failure states**
+   - Error messages exist, but there is room for richer recovery guidance (“try smaller resolution”, “switch model”, “reduce prompt complexity”).
+4. **Expectation-setting around “planning” modules**
+   - Batch Processor is shown in dashboard catalog, but status is planning. That should be even more clearly gated for users.
+
+## Recommended enhancements (prioritized)
+
+### P0 (immediate trust & usability)
+1. **Fix Transform Studio route parity**
+   - Add route or hide module until route is available.
+2. **Harden top-level success semantics in Create Studio**
+   - Return `success: false` when all variations fail; return partial status explicitly when mixed.
+3. **Align UI claims with implementation state**
+   - Mark resizer/watermark features as roadmap-only in all surfaces where they are advertised.
+
+### P1 (reliability & user confidence)
+4. **Introduce first-class async jobs for transform operations**
+   - Add job IDs, polling/websocket updates, resumable results, and queued/cancel states.
+5. **Improve error recovery UX**
+   - Map backend error classes to actionable UI advice.
+6. **Replace static pricing snippets with backend-driven dynamic cost cards**
+   - Display estimate confidence and update timestamps.
+
+### P2 (delight & retention)
+7. **Add guided “Campaign Asset Pipeline”**
+   - Single wizard chaining Create/Edit/Upscale/Social export with saved presets per brand/persona.
+8. **Add quality scorecards per output**
+   - Platform compliance score, file-weight score, readability-safe-zone score.
+9. **Add version compare + rollback in Asset Library**
+   - Better creative iteration experience.
+
+## End-user verdict
+Image Studio is **feature-rich and architecturally promising**, especially with its modular backend and multi-tool surface. However, there are **critical product-polish gaps** (route parity, claim-vs-availability mismatches, ambiguous success semantics) that can weaken user trust. Fixing those quickly would materially improve perceived robustness and adoption.

ToBeMigrated/legacy_backlinker/App.css

@@ -0,0 +1,42 @@
+#root {
+  max-width: 1280px;
+  margin: 0 auto;
+  padding: 2rem;
+  text-align: center;
+}
+
+.logo {
+  height: 6em;
+  padding: 1.5em;
+  will-change: filter;
+  transition: filter 300ms;
+}
+.logo:hover {
+  filter: drop-shadow(0 0 2em #646cffaa);
+}
+.logo.react:hover {
+  filter: drop-shadow(0 0 2em #61dafbaa);
+}
+
+@keyframes logo-spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  a:nth-of-type(2) .logo {
+    animation: logo-spin infinite 20s linear;
+  }
+}
+
+.card {
+  padding: 2em;
+}
+
+.read-the-docs {
+  color: #888;
+}

ToBeMigrated/legacy_backlinker/App.tsx

@@ -0,0 +1,31 @@
+import { Toaster } from "@/components/ui/toaster";
+import { Toaster as Sonner } from "@/components/ui/sonner";
+import { TooltipProvider } from "@/components/ui/tooltip";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { BrowserRouter, Routes, Route } from "react-router-dom";
+import Index from "./pages/Index";
+import NotFound from "./pages/NotFound";
+import Dashboard from "./pages/Dashboard";
+import NewCampaign from "./pages/NewCampaign";
+
+const queryClient = new QueryClient();
+
+const App = () => (
+  <QueryClientProvider client={queryClient}>
+    <TooltipProvider>
+      <Toaster />
+      <Sonner />
+      <BrowserRouter>
+        <Routes>
+          <Route path="/" element={<Index />} />
+          <Route path="/dashboard" element={<Dashboard />} />
+          <Route path="/new-campaign" element={<NewCampaign />} />
+          {/* ADD ALL CUSTOM ROUTES ABOVE THE CATCH-ALL "*" ROUTE */}
+          <Route path="*" element={<NotFound />} />
+        </Routes>
+      </BrowserRouter>
+    </TooltipProvider>
+  </QueryClientProvider>
+);
+
+export default App;