dwindown/wp-agentic-writer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

first commit all files

Browse Source
This commit is contained in:
dwindown
2026-01-28 00:26:00 +07:00
parent 65dd207a74
commit 97426d5ab1
72 changed files with 91484 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

791
AGENTIC_AUDIT_REPORT.md Normal file
View File

@@ -0,0 +1,791 @@
# WP Agentic Writer - Comprehensive Agentic Audit Report
**Audit Date:** January 21, 2026
**Auditor:** Cascade AI
**Plugin Version:** 0.1.0
**Goal:** Evaluate "Agentic-like IDE" capabilities in WordPress Gutenberg editor
---
## Executive Summary
WP Agentic Writer is a sophisticated AI-powered writing assistant with a **solid foundation** for agentic workflows. The plugin successfully implements the core "plan-first" approach: `Scribble → Research → Plan → Execute → Refine`. However, several gaps exist between the current implementation and a truly **IDE-like agentic experience**.
**Overall Agentic Score: 7.5/10**
### Strengths
- ✅ Multi-phase workflow (planning → execution)
- ✅ Clarification quiz for context gathering
- ✅ `@mention` system for block targeting (IDE-like)
- ✅ Slash commands (`/add below`, `/add above`, `/append code`)
- ✅ Real-time streaming with timeline progress
- ✅ Section-aware refinement with context
- ✅ Plan preview with diff-style actions
- ✅ Cost tracking and budget management
### Gaps Identified
- ⚠️ No undo/redo for AI changes
- ⚠️ No diff view before applying changes
- ⚠️ No "Accept/Reject" workflow for refinements
- ⚠️ Limited autonomous decision-making
- ⚠️ No agent memory across sessions (post-level only)
- ⚠️ No multi-step autonomous execution
- ⚠️ Missing keyboard shortcuts for power users
---
## Part 1: Current Architecture Analysis
### 1.1 Core Workflow Trace
```
┌─────────────────────────────────────────────────────────────────┐
│ USER INPUT (Chat Sidebar) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ CLARITY CHECK (if enabled) │
│ - Evaluates 7 context categories │
│ - Generates clarification quiz if confidence < threshold │
│ - Categories: outcome, audience, tone, depth, expertise, │
│ content type, POV │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ MODE DETECTION │
│ - "writing" mode → Full article generation │
│ - "planning" mode → Outline only │
│ - Refinement detected → Chat refinement flow │
│ - Insert command detected → Add block flow │
└─────────────────────────────────────────────────────────────────┘
│
┌───────────────┴───────────────┐
▼ ▼
┌──────────────────────┐ ┌──────────────────────┐
│ PLAN GENERATION │ │ CHAT REFINEMENT │
│ - Stream outline │ │ - @mention resolve │
│ - Section breakdown │ │ - Edit plan create │
│ - Auto-execute │ │ - Block replacement │
└──────────────────────┘ └──────────────────────┘
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ GUTENBERG BLOCK OPERATIONS │
│ - createBlock(), insertBlocks(), replaceBlocks() │
│ - Section tracking (sectionBlocksRef) │
│ - Real-time editor updates │
└─────────────────────────────────────────────────────────────────┘
```
### 1.2 File Structure Analysis
| File | Purpose | Lines | Agentic Features |
|------|---------|-------|------------------|
| `sidebar.js` | Main UI + logic | 4,359 | @mentions, slash commands, plan execution |
| `class-gutenberg-sidebar.php` | REST API + AI calls | 4,274 | Streaming, refinement, memory |
| `class-openrouter-provider.php` | AI provider | 566 | Multi-model, web search |
| `block-refine.js` | Toolbar integration | 115 | @chat button on blocks |
| `sidebar.css` | Styling | 1,817 | Timeline, quiz UI |
### 1.3 Agent Modes
| Mode | Description | Agentic Level |
|------|-------------|---------------|
| **Writing** | Full article generation from prompt | ⭐⭐⭐ Medium |
| **Planning** | Outline-only with manual execution | ⭐⭐ Low |
| **Refinement** | Block-level changes via @mentions | ⭐⭐⭐⭐ High |
---
## Part 2: UI/UX Analysis
### 2.1 Sidebar Interface
**Current Structure:**
```
┌─────────────────────────────────────────┐
│ 💬 Chat │ ⚙️ Config │ 💰 Cost │ ← Tab Navigation
├─────────────────────────────────────────┤
│ [Status Bar - Mode + Cost] │
├─────────────────────────────────────────┤
│ ┌─────────────────────────────────────┐ │
│ │ Messages Area (scrollable) │ │
│ │ - User messages │ │
│ │ - Assistant responses │ │
│ │ - Timeline entries (progress) │ │
│ │ - Plan cards │ │
│ │ - Error messages │ │
│ └─────────────────────────────────────┘ │
├─────────────────────────────────────────┤
│ ┌─────────────────────────────────────┐ │
│ │ Input Area │ │
│ │ - Mode selector │ │
│ │ - Textarea with @mention support │ │
│ │ - Send button │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────┘
```
**✅ Good:**
- Dark theme matches IDE aesthetic
- Monospace fonts for code-like feel
- Timeline progress shows "agent thinking"
- @mention autocomplete is discoverable
**❌ Issues:**
1. **No keyboard shortcuts** - Power users expect Cmd+Enter to send
2. **No command palette** - IDEs have Cmd+Shift+P for quick actions
3. **Config tab is underutilized** - Only article length selector
4. **No block outline view** - Can't see article structure at a glance
### 2.2 Block Toolbar Integration
**Current:** `@chat` button in block toolbar sends mention to sidebar
**Issue:** The button label is just "@chat" - unclear what it does
**Recommendation:** Rename to "Refine with AI" or add tooltip
### 2.3 Clarification Quiz UX
**Current Flow:**
1. Quiz appears as modal overlay in chat
2. Radio buttons for predefined options
3. Progress bar shows completion
4. Skip button available
**✅ Good:**
- Predefined options reduce friction
- Progress indicator is clear
- Fallback questions when AI fails
**❌ Issues:**
1. **No "Don't ask again" option** - Users may want to skip permanently
2. **Quiz interrupts flow** - Could be inline instead of modal
3. **No learning from previous posts** - Always starts fresh
---
## Part 3: Functionality Deep Dive
### 3.1 Generation Flow
**Strengths:**
- Streaming responses with real-time timeline
- Section-by-section execution
- Automatic title update from AI
- Resume capability after errors
**Gaps:**
1. **No preview before insertion** - Blocks appear directly
2. **No staged commits** - Can't review all changes before applying
3. **No branch/version history** - Can't revert to previous state
### 3.2 Refinement System
**Supported Commands:**
| Command | Action |
|---------|--------|
| `@this` | Current selected block |
| `@previous` | Block before current |
| `@next` | Block after current |
| `@all` | All content blocks |
| `@paragraph-N` | Nth paragraph |
| `@heading-N` | Nth heading |
| `@list-N` | Nth list |
| `/add below @block` | Insert paragraph below |
| `/add above @block` | Insert paragraph above |
| `/append code @block` | Insert code block |
| `/reformat @block` | Convert markdown to blocks |
**✅ This is very IDE-like!**
**Gaps:**
1. **No `@code-N`** - Can't target code blocks directly
2. **No `@image-N`** - Can't target images
3. **No range selection** - Can't say `@paragraph-1:3` for range
4. **No diff preview** - Changes apply immediately
### 3.3 Edit Plan System
**Current:**
```javascript
// Edit plan structure
{
"summary": "short summary",
"actions": [
{"action": "keep", "blockId": "..."},
{"action": "replace", "blockId": "...", "blockType": "...", "content": "..."},
{"action": "insert_after", "blockId": "...", "blockType": "...", "content": "..."},
{"action": "delete", "blockId": "..."}
]
}
```
**✅ Good:**
- Diff-style action preview
- Click-to-scroll to target block
- Execute/Cancel buttons
**❌ Issues:**
1. **All-or-nothing execution** - Can't apply individual actions
2. **No partial accept** - Can't accept some, reject others
3. **No inline editing** - Can't modify plan before applying
### 3.4 Memory System
**Current:**
- Post-level memory stored in `_wpaw_memory` meta
- Contains: summary, last_prompt, last_intent
- Chat history persisted per post
**Gaps:**
1. **No global memory** - Can't learn user preferences across posts
2. **No style guide storage** - Can't save writing style preferences
3. **No context from other posts** - Can't reference previous work
---
## Part 4: Agentic Gaps & Recommendations
### 4.1 Critical Missing Features (High Priority)
#### 4.1.1 Undo/Redo for AI Changes
**Problem:** No way to revert AI changes without manual Cmd+Z
**Solution:**
```javascript
// Add undo stack for AI operations
const aiUndoStack = [];
const executeWithUndo = (operation) => {
const snapshot = captureEditorState();
aiUndoStack.push(snapshot);
operation();
};
// UI: Add "Undo AI" button in timeline entries
```
#### 4.1.2 Diff View Before Apply
**Problem:** Users can't see what will change before it happens
**Solution:**
- Add "Preview Changes" mode
- Show side-by-side or inline diff
- GitHub-style green/red highlighting
#### 4.1.3 Accept/Reject Workflow
**Problem:** Changes apply immediately with no approval
**Solution:**
```
┌─────────────────────────────────────────┐
│ AI suggests: Replace paragraph 3 │
│ │
│ Before: "The old content..." │
│ After: "The new content..." │
│ │
│ [Accept] [Reject] [Edit] [Skip] │
└─────────────────────────────────────────┘
```
### 4.2 Agentic Enhancements (Medium Priority)
#### 4.2.1 Autonomous Multi-Step Execution
**Current:** User must approve each step
**Agentic:** Agent completes entire task autonomously
**Recommendation:** Add "Full Auto" mode
```javascript
const agentModes = {
'supervised': 'Approve each change', // Current
'semi-auto': 'Approve plan, auto-execute', // New
'full-auto': 'Complete task autonomously' // New (advanced)
};
```
#### 4.2.2 Agent Memory & Learning
**Current:** No learning across sessions
**Agentic:** Remember user preferences, writing style
**Recommendation:**
```php
// Global user preferences in wp_usermeta
update_user_meta($user_id, '_wpaw_preferences', [
'tone' => 'professional',
'avoid_words' => ['leverage', 'synergy'],
'preferred_length' => 'medium',
'always_include' => ['code examples'],
]);
```
#### 4.2.3 Context-Aware Suggestions
**Current:** Agent only responds to commands
**Agentic:** Agent proactively suggests improvements
**Recommendation:**
- Analyze article on idle
- Suggest improvements in sidebar
- "I noticed paragraph 3 could be clearer. Want me to refine it?"
### 4.3 IDE-Like Features (Medium Priority)
#### 4.3.1 Keyboard Shortcuts
| Shortcut | Action |
|----------|--------|
| `Cmd+Enter` | Send message |
| `Cmd+Shift+P` | Command palette |
| `Cmd+/` | Quick refine selected block |
| `Cmd+G` | Generate from selection |
| `Escape` | Cancel current operation |
#### 4.3.2 Command Palette
```
┌─────────────────────────────────────────┐
│ > _ │
├─────────────────────────────────────────┤
│ 📝 Generate article from prompt │
│ ✏️ Refine selected block │
│ 📋 Create outline only │
│ 🔄 Regenerate current section │
│ 🌐 Enable web search │
│ ⚙️ Open settings │
└─────────────────────────────────────────┘
```
#### 4.3.3 Block Outline Panel
```
┌─────────────────────────────────────────┐
│ ARTICLE STRUCTURE │
├─────────────────────────────────────────┤
│ ▼ Introduction │
│ ├─ paragraph-1 │
│ └─ paragraph-2 │
│ ▼ Getting Started │
│ ├─ heading-2 │
│ ├─ paragraph-3 │
│ └─ code-1 │
│ ▼ Advanced Usage │
│ ├─ heading-3 │
│ └─ list-1 │
└─────────────────────────────────────────┘
```
### 4.4 UX Improvements (Lower Priority)
#### 4.4.1 Inline Refinement
**Current:** Must use sidebar for all refinements
**Improvement:** Click block → inline popover with quick actions
#### 4.4.2 Streaming Preview
**Current:** Content appears in editor directly
**Improvement:** Show in preview pane first, then "Apply All"
#### 4.4.3 Smart Suggestions Bar
Show contextual actions based on selection:
```
┌─────────────────────────────────────────┐
│ 💡 Make concise │ 🔄 Rephrase │ 📝 Expand │
└─────────────────────────────────────────┘
```
---
## Part 5: Technical Debt & Code Quality
### 5.1 Identified Issues
1. **`sidebar.js` is 4,359 lines** - Should be split into modules
2. **Mixed concerns** - UI, state, API calls in same file
3. **No TypeScript** - Type safety would prevent bugs
4. **Hardcoded strings** - Should use i18n throughout
### 5.2 Recommendations
1. **Modularize sidebar.js:**
- `hooks/useChat.js`
- `hooks/usePlan.js`
- `hooks/useRefinement.js`
- `components/ChatTab.js`
- `components/ConfigTab.js`
- `utils/blockHelpers.js`
2. **Add error boundaries** - React error boundaries for graceful failures
3. **Implement proper state management** - Consider Redux or Zustand
---
## Part 6: Prioritized Action Items
### Tier 1: Critical (Do First)
| Item | Effort | Impact | Status |
|------|--------|--------|--------|
| Add Undo for AI changes | Medium | High | ❌ Not Implemented |
| Add Accept/Reject workflow | Medium | High | ✅ Implemented (Apply/Cancel buttons) |
| Add Cmd+Enter to send | Low | Medium | ✅ Implemented (line 2326 sidebar.js) |
| Add diff preview for edit plans | Medium | High | ✅ Implemented (edit_plan type with before/after) |
> **Note:** Cross-verified on Jan 21, 2026. Only **Undo for AI changes** remains to be implemented in Tier 1.
### Tier 2: Important (Do Next)
| Item | Effort | Impact |
|------|--------|--------|
| Command palette (Cmd+Shift+P) | Medium | High |
| Per-action accept/reject in plans | Medium | Medium |
| Block outline panel | Medium | Medium |
| Global user preferences | Low | Medium |
### Tier 3: Nice to Have
| Item | Effort | Impact |
|------|--------|--------|
| Inline refinement popover | High | Medium |
| Streaming preview pane | High | Medium |
| Smart suggestions bar | Medium | Low |
| Full-auto mode | High | Low |
---
## Part 7: Conclusion
### What's Already Agentic ✅
1. **@mention system** - Best-in-class block targeting
2. **Slash commands** - IDE-like quick actions
3. **Clarification quiz** - Proactive context gathering
4. **Edit plan preview** - Shows intent before action
5. **Section tracking** - Maintains document structure
### What's Missing for True Agentic ❌
1. **Approval workflow** - Changes should be reviewable
2. **Undo/history** - Need to revert AI mistakes
3. **Autonomous execution** - Agent should complete tasks independently
4. **Learning/memory** - Should improve over time
5. **Keyboard-first UX** - Power users need shortcuts
### Final Recommendation
The plugin has **strong agentic bones** but needs the **safety net** features that make IDEs trustworthy:
1. **Immediate wins:** Keyboard shortcuts + Undo button
2. **Medium-term:** Accept/Reject workflow + Command palette
3. **Long-term:** Autonomous mode + Learning system
The goal should be: *"I can trust this agent to make changes because I can always review, approve, or revert."*
---
## Part 8: Proactive AI Suggestions (NEW REQUIREMENT)
### 8.1 Current State
**Problem:** Agent only responds to commands - purely reactive.
### 8.2 Target State
**Goal:** Agent proactively analyzes content and suggests improvements.
### 8.3 Implementation Specification
#### 8.3.1 Idle Analysis Trigger
```javascript
// Trigger analysis after user stops editing for N seconds
const IDLE_THRESHOLD_MS = 5000; // 5 seconds
let idleTimer = null;
const startIdleAnalysis = () => {
clearTimeout(idleTimer);
idleTimer = setTimeout(() => {
analyzeArticleForSuggestions();
}, IDLE_THRESHOLD_MS);
};
// Hook into editor changes
wp.data.subscribe(() => {
startIdleAnalysis();
});
```
#### 8.3.2 Suggestion Types
| Category | Example Suggestion |
|----------|--------------------|
| **Clarity** | "Paragraph 3 could be clearer. Want me to simplify it?" |
| **Flow** | "The transition between sections 2 and 3 feels abrupt." |
| **Depth** | "This section could use more examples or data." |
| **SEO** | "Consider adding keyword 'X' to heading 2." |
| **Structure** | "This article could benefit from a summary section." |
| **Engagement** | "Consider adding a question to engage readers here." |
#### 8.3.3 UI Component
```
┌─────────────────────────────────────────────────┐
│ 💡 Suggestion │
│ │
│ "I noticed paragraph 3 could be clearer. │
│ Want me to refine it?" │
│ │
│ [Apply] [Dismiss] [Don't show again] │
└─────────────────────────────────────────────────┘
```
#### 8.3.4 Backend Endpoint
```php
// New REST endpoint: /analyze-for-suggestions
public function analyze_for_suggestions() {
$blocks = $this->get_all_blocks();
$prompt = "Analyze this article and suggest 1-3 improvements...";
// Return structured suggestions
}
```
#### 8.3.5 User Preferences
- Toggle: "Enable proactive suggestions"
- Frequency: "Aggressive / Balanced / Minimal"
- Categories: Checkboxes for which suggestion types to show
---
## Part 9: SEO Specialist Capabilities (NEW REQUIREMENT)
### 9.1 Vision
Agentic Writer should not only write well but write **SEO-optimized content** that ranks.
### 9.2 SEO Feature Matrix
| Feature | Description | Priority |
|---------|-------------|----------|
| **Keyword Analysis** | Analyze target keyword, suggest density | High |
| **Keyword Placement** | Ensure keyword in title, H1, first paragraph | High |
| **Heading Structure** | Validate H1→H2→H3 hierarchy | High |
| **Meta Generation** | Auto-generate meta title & description | High |
| **Readability Score** | Flesch-Kincaid or similar | Medium |
| **Internal Linking** | Suggest links to other posts | Medium |
| **Image Alt Text** | Auto-generate SEO-friendly alt text | Medium |
| **Schema Markup** | Suggest FAQ, HowTo, Article schema | Medium |
| **Competitor Analysis** | Compare with top-ranking articles | Low |
| **SERP Preview** | Show how it will appear in Google | Low |
### 9.3 SEO Workflow Integration
#### 9.3.1 Pre-Writing Phase
```
┌─────────────────────────────────────────────────┐
│ 🎯 SEO Setup │
│ │
│ Target Keyword: [_______________] │
│ Secondary Keywords: [_______________] │
│ │
│ ☑ Analyze competition before writing │
│ ☑ Include keyword in title │
│ ☑ Suggest internal links │
│ │
│ [Analyze Competition] [Skip to Writing] │
└─────────────────────────────────────────────────┘
```
#### 9.3.2 During Writing (Real-time)
- **Keyword density indicator** in sidebar
- **Heading structure validator**
- **Reading time & word count**
- **Readability score (live)**
#### 9.3.3 Post-Writing (SEO Audit)
```
┌─────────────────────────────────────────────────┐
│ 📊 SEO Score: 78/100 │
│ │
│ ✅ Keyword in title │
│ ✅ Keyword in first paragraph │
│ ⚠️ Keyword density low (0.8%, target 1-2%) │
│ ❌ Missing meta description │
│ ❌ No internal links found │
│ ✅ Proper heading hierarchy │
│ ⚠️ Images missing alt text (2 of 3) │
│ │
│ [Fix All Issues] [Generate Meta] [Add Links] │
└─────────────────────────────────────────────────┘
```
### 9.4 SEO-Aware System Prompts
Modify the plan generation prompt to include SEO considerations:
```
You are an SEO-optimized content writer. When creating content:
1. KEYWORD PLACEMENT:
- Include target keyword in H1 and first 100 words
- Use keyword naturally 1-2% density
- Include semantic variations
2. STRUCTURE:
- Use proper heading hierarchy (H1→H2→H3)
- Include table of contents for long articles
- Use bullet points and numbered lists
- Keep paragraphs under 150 words
3. ENGAGEMENT:
- Start with a hook
- Use questions to engage readers
- Include actionable takeaways
4. TECHNICAL:
- Suggest descriptive image alt text
- Recommend internal link opportunities
- Optimize for featured snippets where applicable
```
### 9.5 Post Config Additions
```javascript
const seoConfig = {
target_keyword: '',
secondary_keywords: [],
enable_seo_mode: true,
keyword_density_target: 1.5, // percentage
min_word_count: 1500,
include_meta: true,
include_schema: false,
internal_linking: true,
};
```
### 9.6 New REST Endpoints
| Endpoint | Purpose |
|----------|--------|
| `/seo/analyze-keyword` | Get keyword difficulty, volume |
| `/seo/audit-content` | Full SEO audit of current content |
| `/seo/generate-meta` | Generate meta title/description |
| `/seo/suggest-links` | Find internal linking opportunities |
| `/seo/competitor-analysis` | Analyze top-ranking content |
---
## Part 10: AI Model Recommendations (NEW REQUIREMENT)
### 10.1 Purpose
Help users choose the **cheapest AND best** models for agentic workflows.
### 10.2 Model Tiers by Use Case
#### 10.2.1 Planning Phase (Fast, Cheap)
| Model | Cost (per 1M tokens) | Speed | Quality | Recommendation |
|-------|---------------------|-------|---------|----------------|
| `google/gemini-2.0-flash-exp` | ~$0.10 in / $0.40 out | ⚡ Very Fast | Good | **Best Value** |
| `google/gemini-flash-1.5` | ~$0.075 in / $0.30 out | ⚡ Very Fast | Good | Budget Option |
| `anthropic/claude-3-haiku` | ~$0.25 in / $1.25 out | Fast | Good | Reliable |
| `openai/gpt-4o-mini` | ~$0.15 in / $0.60 out | Fast | Good | Alternative |
#### 10.2.2 Execution Phase (Quality Critical)
| Model | Cost (per 1M tokens) | Speed | Quality | Recommendation |
|-------|---------------------|-------|---------|----------------|
| `anthropic/claude-sonnet-4` | ~$3 in / $15 out | Medium | Excellent | **Best for Writing** |
| `anthropic/claude-3.5-sonnet` | ~$3 in / $15 out | Medium | Excellent | Proven Quality |
| `openai/gpt-4o` | ~$2.50 in / $10 out | Medium | Excellent | Alternative |
| `google/gemini-pro-1.5` | ~$1.25 in / $5 out | Medium | Very Good | Cost-Conscious |
#### 10.2.3 Image Generation
| Model | Cost (per image) | Speed | Quality | Recommendation |
|-------|-----------------|-------|---------|----------------|
| `black-forest-labs/flux-schnell` | ~$0.003 | ⚡ Very Fast | Good | **Best Value** |
| `black-forest-labs/flux-1.1-pro` | ~$0.04 | Fast | Excellent | Premium |
| `openai/dall-e-3` | ~$0.04-0.08 | Medium | Excellent | Alternative |
### 10.3 Recommended Configurations
#### 10.3.1 Budget-Conscious Setup (~$0.05 per article)
```
Planning Model: google/gemini-2.0-flash-exp
Execution Model: google/gemini-pro-1.5
Image Model: black-forest-labs/flux-schnell
```
#### 10.3.2 Balanced Setup (~$0.15 per article)
```
Planning Model: google/gemini-2.0-flash-exp
Execution Model: anthropic/claude-3.5-sonnet
Image Model: black-forest-labs/flux-schnell
```
#### 10.3.3 Premium Quality Setup (~$0.30+ per article)
```
Planning Model: anthropic/claude-3-haiku
Execution Model: anthropic/claude-sonnet-4
Image Model: black-forest-labs/flux-1.1-pro
```
### 10.4 Model Selection UI
```
┌─────────────────────────────────────────────────┐
│ 🤖 Model Configuration │
│ │
│ Preset: [Budget ▾] [Balanced ▾] [Premium ▾] │
│ │
│ Planning Model: │
│ [google/gemini-2.0-flash-exp ▾] │
│ 💰 ~$0.10/1M tokens • ⚡ Fast │
│ │
│ Execution Model: │
│ [anthropic/claude-sonnet-4 ▾] │
│ 💰 ~$3/1M tokens • ✨ Best Quality │
│ │
│ Image Model: │
│ [black-forest-labs/flux-schnell ▾] │
│ 💰 ~$0.003/image • ⚡ Fast │
│ │
│ Estimated cost per article: ~$0.15 │
└─────────────────────────────────────────────────┘
```
### 10.5 Smart Model Suggestions
The plugin should analyze usage patterns and suggest:
1. **If budget is tight:**
> "You've spent $45 this month. Switch to Budget preset to save ~60%."
2. **If quality issues detected:**
> "Multiple refinements on recent articles. Consider upgrading execution model."
3. **If speed is priority:**
> "For faster generation, switch planning to Gemini Flash."
---
## Part 11: Updated Roadmap
### Phase 1: Complete Tier 1 ✅ COMPLETED
- [x] Cmd+Enter to send
- [x] Accept/Reject workflow (Apply/Cancel)
- [x] Diff preview for edit plans
- [x] **Undo for AI changes** (sidebar.js: aiUndoStack, pushUndoSnapshot, undoLastAiOperation)
- [x] **Budget tracker enhanced** (Cost tab with refresh, remaining display, warnings)
- [x] **Settings page revamp** (Modern card-based UI with preset configurations)
### Phase 2: SEO Foundation ✅ COMPLETED
- [x] Add SEO config fields (focus keyword, secondary keywords, meta description)
- [x] Integrate SEO considerations into system prompts (build_seo_context)
- [x] Add keyword density indicator (in SEO audit)
- [x] Add SEO audit endpoint (/seo-audit/{post_id})
- [x] Add meta generation (/generate-meta with AI)
### Phase 3: Proactive Suggestions (2-3 weeks)
- [ ] Implement idle detection
- [ ] Create suggestion analysis endpoint
- [ ] Add suggestion UI component
- [ ] Add user preferences for suggestions
### Phase 4: Model Recommendations ✅ COMPLETED
- [x] Add preset configurations (Budget, Balanced, Premium)
- [x] Add model selection UI with cost estimates
- [ ] Add smart suggestions based on usage
### Phase 5: Tier 2 Features (3-4 weeks)
- [ ] Command palette (Cmd+Shift+P)
- [ ] Per-action accept/reject in plans
- [ ] Block outline panel
- [ ] Global user preferences
---
**Report Updated:** January 22, 2026
**Implementation Status:** Phase 1, Phase 2 (SEO Foundation) & Phase 4 completed. Ready for Phase 3 (Proactive Suggestions).