Micro SEO Operator

Live backend disconnectedConfigure MICRO_SEO_BACKEND_URL

Set MICRO_SEO_BACKEND_URL to enable live session, billing, provider, site, and job state branches.

ProjectOS mapping requiredLink site to ProjectOS project

Execution-capable approvals remain in mapping-required state until backend-core can map the Micro SEO site to a ProjectOS project.

Pending3712 low-risk ready

Approved11Waiting for apply

Needs PR6Code-level changes

Failed Verify4Needs follow-up

Approval queue37 waiting

Pending writes stay in review until a user explicitly approves, rejects, or requests changes.

Review low-risk recommendations first

Execution safetyApproval + snapshot required

Live writes without approval are disabled. Plugin changes create snapshots and PR changes verify previews.

Inspect write contract before apply

Rollback readinessSupported after apply

Applied CMS changes are snapshot-backed; GitHub PR changes remain reviewable and revertible in the repo.

Verify after every apply

Backend-core broker

ProjectOS PR execution job

Execution-capable approvals create a backend-core ecosystem job. Micro SEO stores the returned ecosystem_job_id and waits for ProjectOS lifecycle status instead of marking execution complete inline.

Recommendationrec-canonical-helper

StatusNot started

ecosystem_job_idWaiting for backend-core

Backend-core statusnot submitted

not_startedNot started
mapping_requiredProjectOS mapping required
ready_to_submitReady to submit
submitted_to_brokerSubmitted to broker
waiting_for_projectosWaiting for ProjectOS
runningRunning
pr_openedPR opened
needs_reviewNeeds review
failedFailed
completedCompleted

Production UI states

Readiness states to preserve when live APIs are connected

Design contract

These shared states document the user-facing contract for loading, empty, error, auth, provider, plan, sandbox, verification, and rollback paths before static scaffold screens are wired to live data.

Data lifecycle states

Every route should show users whether data is loading, absent, unavailable, or blocked by access.

loadingLoading

Skeleton cards and tables while provider, workspace, or report data is syncing.

All dashboard and module routes

emptyEmpty

First-run workspace guidance when no sites, providers, opportunities, approvals, backlinks, or reports exist.

Sites, integrations, opportunities, approvals, BacklinkBase, AI visibility, reports

errorError + retry

Recoverable provider/API failures with retry copy and support-safe diagnostics.

All provider-backed routes

unauthorizedUnauthorized

Backend-core session, workspace membership, and role denial states before showing SEO data.

All workspace-scoped routes

Commercial and provider states

Provider health, plan gates, sandbox boundaries, and entitlement limits must be visible before users can act.

disconnected_providerDisconnected provider

Google, WordPress, GitHub, Vercel, DataForSEO, and BacklinkBase disconnect/expired/rate-limited states.

Integrations plus dependent module routes

plan_limitPlan limit

Starter/Pro/Agency gates for sites, reports, provider syncs, users, credits, and automation rules.

Sites, reports, BacklinkBase, approvals, integrations

sandboxSandbox

BacklinkBase and destructive writes must identify sandbox versus production execution before approval.

BacklinkBase, approval queue, technical execution

Execution safety states

Approval, verification, and rollback states should stay visible through the full SEO change lifecycle.

verification_failedVerification failed

Applied changes that did not verify on preview/live HTML need retry and rollback affordances.

Approval queue, technical SEO, schema, WooCommerce SEO, reports

rollback_availableRollback available

WordPress snapshots, GitHub PR reversions, and backlink audit trails must stay tied to an approved action.

Approval queue, WordPress plugin actions, reports

Approval Queue queue

Current work

PriorityEntitySignalExecutorImpact

LowEpson 5050UBMeta description rewriteWordPress PluginCTR lift

MediumProjector categoryFAQ schema blockHybrid OperatorSERP enhancement

HighCanonical helperFrontend canonical mismatchGitHub PRIndexing protection

Safety

High-risk actions stay gated

Slug, canonical, robots, pricing, checkout, and backlink purchases always require approval.

Rollback

Snapshots before writes

Plugin-applied content changes create snapshots so the site can roll back safely.