=== AI Editorial Desk for WP ===
Contributors: kawasakiaieditorialdesk
Tags: ai, editorial-workflow, content-audit, search-console, analytics
Requires at least: 6.8
Tested up to: 7.1.4
Requires PHP: 7.4
Stable tag: 0.11.51
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-assisted editorial operations for WordPress with human-controlled publishing.

== Description ==

AI Editorial Desk reviews your published content, site profile and available site signals to recommend the editorial task that deserves attention today. With Pro, you can request new-article and rewrite drafts using your site context, instructions and reference material.

Opening the dashboard does not start paid generation. You choose when to create a draft, check its content, and decide whether to publish, schedule or replace an article.

= Free features =

* Site-wide analysis, Site Status and one daily recommended task with its reasons.
* Optional read-only Google Search Console and Google Analytics signals.
* Automatic recommendation refresh when WordPress scheduling is enabled and running.
* Site profile, article rules, connections, diagnostics, history and safety status.
* Published Article Health observations for search, revenue, freshness, links, offers, distribution and technical state. These observations do not automatically repair articles.
* Read-only detection and counting of supported PrettyLinks and ThirstyAffiliates data.
* Optional read-only MCP integration, off by default and dependent on the required components.

Free does not include paid AI article or image generation. No OpenAI API key is needed to use Free analysis and recommendations.

= Pro features =

Pro adds human-started new-article drafts, rewrite drafts and cover generation. It uses your OpenAI connection; API charges are separate from the plugin license.

New articles are saved as editable, unpublished WordPress drafts. Cover generation is optional and separate from this text-first workflow. Review notes identify matters that need attention. A saved draft is not a guarantee of factual correctness or permission to publish.

Article rules include sentence breaks, approximate paragraph length, H2/H3/H4 headings, speech bubbles and icons, tables, charts and free-text instructions. Theme-specific presentation depends on the supported theme or adapter; editable standard blocks provide a fallback where available. Charts require supporting labels, values and units. Your selected language applies to the article; automatic translation or multilingual publication is not enabled by choosing a writing rule.

Optional reference files support common text/code formats, DOCX/XLSX/PPTX and bounded read-only ZIP inspection. Up to eight files can be attached. Archive members are not executed. Long material is handled within input limits; only selected excerpts are sent for writing, and the plugin does not claim that omitted material was read by the AI.

Pro also provides local Affiliate records, social-post draft preparation and human-approved PrettyLinks / ThirstyAffiliates imports. Import uses preview, approval and save/readback checks, with rollback of AI Editorial Desk-owned copies. It does not delete, rewrite or disable the source plugin or rewrite article content. Existing short URLs and shortcodes can still depend on that plugin. Social preparation does not provide direct social API posting.

Pro requires a valid entitlement for new premium generation. Pricing, billing cycle, currency, taxes, refund conditions and license terms are shown in the actual Freemius checkout or customer account.

== Installation ==

See docs/INSTALL.md for the Japanese setup and usage guide.

1. Back up WordPress files and the database before installation or updates.
2. Install and activate AI Editorial Desk in WordPress.
3. Open the plugin's Setup screen, describe your site and prepare the site analysis.
4. Connect Search Console and Analytics only if you want those optional read-only inputs.
5. Review Today's recommendation and its evidence. Enable automatic checks if wanted; they depend on WordPress scheduling and site operation.
6. For Pro, install the separate licensed Pro ZIP, configure your server-side OpenAI key, prepare the draft-writing user and set AI budgets before starting generation. Do not keep Free and Pro active together.

The documented server-side key name is MARR_OPENAI_API_KEY in wp-config.php or an environment variable. Use a dedicated project key and configure it through your hosting or server administration tools. Do not put a real key into an article, screenshot, support message or public file. The key is not stored in the plugin's normal WordPress settings database.

= Creating a draft with Pro =

Choose a recommendation or topic, review the proposed work and overlap with existing articles, and add any instructions or references. Check the model, estimated cost and configured limits before explicitly starting generation. The estimate or reserved limit is not a provider invoice. If paid API processing is stopped, review that setting separately before starting.

Wait for the saved draft, then reopen it in WordPress. Check the answer, sources, steps, links, formatting and any review notes. Publish or replace content only after your own review. AI-assisted factual checks are limited; do not invent evidence or treat a successful save as fact verification.

Article rules can be saved as defaults or selected for an individual article. A rules preview does not save an article or call paid AI. Changes to defaults do not rewrite existing drafts or alter already-approved work.

= Images and draft editing =

Pro can add one generated cover to an eligible editable unpublished draft that has no featured image, after a separate cost confirmation. This does not regenerate the article or replace an existing cover. Check the image and alternative text before publication. If the draft changes during generation, the image is retained for a separate attachment confirmation.

Use the WordPress editor to correct saved drafts. AI regeneration of saved automatic-research or fixed-reference new-article drafts is currently unsupported; do not repeatedly start generation to edit those drafts.

= If processing stops =

Read the message and history first. Check your provider connection, API balance or rate limit, configured budget and paid-stop setting. If a request or save result is uncertain, preserve the existing draft and records and do not submit the same operation again. Use diagnostics or support to establish the current state. Disabling certificate verification or resetting cost history is not a recovery step.

Paid OpenAI requests require OpenSSL, valid certificate verification and direct PHP TLS streams. Proxy-only or cURL-only hosting may stop before sending. Ask your hosting provider about a reported connection requirement. Relevant write operations require transaction-safe database tables; the plugin does not convert table engines automatically.

== Frequently Asked Questions ==

= Does Free create or publish articles automatically? =

No. Free provides analysis and recommendations. Automatic daily checks do not start paid article or image generation.

= Does Pro publish automatically? =

No. Generation is started by a person and creates review drafts. Publishing, scheduling, replacement and deletion remain human decisions.

= How do I install Pro from Free? =

Back up the site, obtain the licensed Pro ZIP from your Freemius customer account, deactivate Free, and upload and activate Pro in WordPress. The Free account-return screen provides the manual installation route; it does not start an automatic installation countdown.

= Do I need Google Search Console or Google Analytics? =

No. Both are optional read-only evidence sources. WordPress content remains available for analysis without them.

= Are AI API fees included? =

No. You need your own supported OpenAI connection and available API usage. Provider charges are separate from the plugin license and follow the provider's pricing and terms.

= What happens if a Pro license expires? =

New premium generation stops when valid entitlement cannot be confirmed. Existing posts, drafts, settings and history are not deleted merely because a license expires. Update and support rights depend on your purchased license terms.

= Does every theme support the same layout? =

No. Standard WordPress blocks are supported by the available output route. Theme-specific bubbles, icons and other presentation depend on the theme or adapter. Review the saved result on your site, including a narrow screen.

== Privacy and external services ==

Additional bundled service details are in docs/THIRD-PARTY-SERVICES.md.

Product-improvement sharing is OFF by default and requires separate administrator consent for the fixed COMDECIS receiver described below; local collection, support diagnostics and Freemius consent do not enable it. Support diagnostics are sent only after an administrator presses the send button. The allowlisted snapshot excludes article bodies and API credentials; the receiver returns a receipt ID and uses encrypted-at-rest storage with a default 90-day retention window.

External services may be used depending on edition and configuration:

* **Freemius** — optional SDK opt-in for Free plus Pro licensing/account management, checkout, and premium updates. Free users can skip data-sharing opt-in and keep using Free features. Pro licensing and updates require Freemius communication. Privacy: https://freemius.com/privacy/ Terms: https://freemius.com/terms/
* **Google Search Console / Google Analytics** — optional read-only site metrics used as editorial evidence. Terms: https://policies.google.com/terms Privacy: https://policies.google.com/privacy
* **OpenAI** — used only by applicable human-started Pro AI workflows. An administrator may also explicitly retrieve one server-bound accepted research response for diagnostics, using the saved connection and response ID; this does not start another generation or resume the stopped run. When reference files are attached, the plugin keeps the original out of its own persistent file storage, stores a bounded extracted snapshot with the Run, and may send extracted content only after the user starts the applicable workflow. API charges are separate. Services Agreement: https://openai.com/policies/services-agreement/ Privacy: https://openai.com/policies/privacy-policy/
* **Automatic article source retrieval / Google Public DNS** — human-started automatic new-article generation separates public research from private-context writing. Research sends the requested title and bounded public questions to OpenAI; private site context is included only in the tool-free writer request. Only public HTTPS documents actually observed in that research may be fetched. New human-review workflows approved from 0.11.34 use the WordPress safe HTTP API with TLS verification enabled, unsafe-URL checks, no redirects, finite size/time limits, and no cookies or authentication supplied by this plugin. WordPress and the site's configuration manage DNS, proxies and outbound policy; this route does not make a separate Google Public DNS request or claim public-IP pinning. Its receipt records the requested API policy and returned response, not an independent wire-level TLS/IP observation. Existing legacy workflow contracts retain the cURL public-IP-pinned route, which queries https://dns.google/resolve using the observed public source hostname and normal connection IP, without sending the document path/query, private corpus, credentials or cookies to that DNS service. Neither route automatically retries an interrupted source fetch. Google Public DNS privacy: https://developers.google.com/speed/public-dns/privacy
* **European Central Bank (ECB) Data Portal** — optional and off by default. If an administrator enables reference exchange-rate retrieval in Pro cost settings, the site requests public ECB data for display-only USD/JPY conversion; budget enforcement remains USD-denominated. API: https://data.ecb.europa.eu/help/api/overview Data protection: https://www.ecb.europa.eu/services/data-protection/privacy-statements/html/index.en.html
* **MCP clients** — optional and off by default. When enabled, only allowlisted read-only editorial information is exposed; no publish, replace, delete, settings-write, budget-write, or unconditional paid-generation authority is granted.
* **COMDECIS improvement receiver** — optional, separate administrator consent and OFF by default. Sends only strict aggregate reports to https://aieditorialdesk.com/wp-json/comdecis-feedback/v1/ . Reports have 13 fixed metadata/counter fields and at most eight integer counter categories; no articles, URLs, emails, IPs, user IDs, licenses, cookies or authentication values are included in the JSON. A dedicated random sender key is kept on this site, separate from support/Freemius/WordPress authentication. Public enrollment is a pseudonymous scope binding, not proof of purchaser identity. Raw aggregates cover at most 30 days; minimal replay-prevention hashes remain after expiry/deletion. Stop prevents new admission and queues erasure, while an already-admitted request may finish; offline erasure is not confirmed. Hosting access logs may retain connection metadata. Privacy: https://aieditorialdesk.com/contact-privacy/ Terms: https://aieditorialdesk.com/purchase-terms/
* **AI Editorial Desk diagnostics service** — manual Free/Pro support reporting after an administrator presses send. Payload: the allowlisted diagnostics-v2 snapshot, optional short note, and up to three user-selected PNG/JPEG/WebP screenshots. No screen is captured automatically. The structured snapshot excludes article bodies, API keys, Google secrets, email addresses, WordPress passwords, and wp-config.php; image contents are not automatically redacted. Endpoint: https://diagnostics.aieditorialdesk.com/api/v1/diagnostics . The receiver returns a receipt ID, encrypts payloads at rest, and uses a default 90-day retention window. Service privacy and terms: https://aieditorialdesk.com/ai-editorial-desk-diagnostics-service-privacy-terms/

Deactivation or uninstall does not delete published posts. Current uninstall behavior intentionally retains AI Editorial Desk settings, history, and dedicated tables to avoid accidental loss.

== Build and source ==

See docs/SOURCE-BUILD.md for bundled source/build information.

This package includes readable plugin PHP/JavaScript, Composer manifests, and source/build references for bundled third-party assets. See docs/SOURCE-BUILD.md. Freemius Deployment creates the actual Free/Premium pair; Premium runtime files are excluded from the generated Free package.

== Changelog ==

= 0.11.51 =
* Protect optional read-only MCP connections and recover oversized legacy session metadata.
* Keep unavailable Google metrics distinct from measured zero values.
* Limit optional MCP integration to one coherent official Adapter 0.6.1, with default-off and private-ability boundaries retained.

= 0.11.50 =
* Reuse supported FAQ and list-box presentation from site examples, with user preferences and a standard-block fallback.
* Protect initial rewrite copies using the content actually saved by WordPress.
* Preserve full cover headlines with improved Japanese and English word boundaries for new images.
* Reconcile outline and declared internal-link metadata with the validated article body.

= 0.11.49 =
* Use Japanese or English for generated FAQ and reference headings in articles of those languages.
* Improve writing guidance for direct answers, ordered steps and preserving source conditions.
* Preserve article formatting choices and editable draft output.
* Improve administrator diagnostics for saved writing results without starting another AI generation or changing an article.
