=== LucidPen – AI Writing Assistant for Journaling, Prayer, and Reflection ===
Contributors: enigtech
Tags: AI writing, prayer, blog, reflection, AI
Requires at least: 5.6
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn your thoughts into heartfelt prayers and reflections with gentle, guided AI writing — right inside WordPress.

== Description ==

**LucidPen helps you turn your thoughts into meaningful words — with the gentle guidance of AI.**

Whether you're praying, journaling after outdoor activities, reflecting on your day, or simply processing your emotions, LucidPen walks you through interactive prompts to help you create thoughtful, structured drafts — right in your WordPress dashboard.

🧘‍♀️ **Perfect for:**
- Prayer and devotional writing
- Daily journaling
- Outdoor activity or travel reflections
- Free-form personal introspection

🧠 **Included Assistants:**
- 🛐 **Prayer Assistant** – Based on the ACTS model (Adoration, Confession, Thanksgiving, Supplication). Helps you express each part of your prayer clearly and authentically.
- ✍️ **Blog Coach** – A friendly interviewer that guides you through your message, tone, goals, and structure before generating a full post draft.

🧩 **Coming Soon:**
- 📓 **Reflection Journal** – A faith-centered journaling assistant for daily check-ins and spiritual growth.

== Features ==

- Interactive, chat-style writing flow
- Lightweight and modular architecture
- Built-in assistant switching with a growing library
- Supports user-supplied OpenAI or Azure OpenAI API keys
- No third-party tracking — content stays on your site
- Local encryption for AI-generated text

== Want More? ==

LucidPen is designed for personal and spiritual writing. For professional or work-related writing, stay tuned for **LucidPen Business**, featuring:

- 📄 Assistants for reviews, proposals, and promotion cases
- 📥 Export to PDF or Word
- 🎯 Format, tone, and goal customization
- 🔐 Built-in hosted AI access (no setup needed)

== Installation ==

1. Upload the plugin to `/wp-content/plugins/lucidpen`, or install it via the Plugin Directory.
2. Activate the plugin through the “Plugins” screen.
3. Navigate to **Settings → LucidPen** to configure your preferences.
4. The default slug for the Prayer Assistant is `/prayers`.
5. The default slug for the Blog Assistant is `/blogs`.
6. You can change these slugs in the **Settings → LucidPen** panel.

== Privacy ==

LucidPen does not include tracking, telemetry, or advertising code, and does not send data to EnigTech’s own servers unless you explicitly choose to use optional hosted services.

When using the AI Assistants (Prayer, Blog Coach, Reflection Journal), the text you write is securely transmitted to an **AI text-generation service** to generate contextual writing suggestions. The plugin supports two possible configurations:

1. **User-provided API Key (Default Behavior)**
   - Requests are sent directly from your WordPress site to the **Microsoft Azure OpenAI Service** or the **OpenAI API** endpoint you specify.
   - The text you write (your prompts and assistant replies) is transmitted over HTTPS.
   - No personal identifiers (such as your name, email, or user ID) are sent unless you include them in your content.
   - The AI-generated response is returned to your WordPress site and **encrypted locally** before saving.
   - The encryption key is stored securely in your WordPress user profile and never leaves your site.

2. **Optional Hosted Model (if enabled)**
   - If you enable EnigTech’s optional hosted AI models, API requests are routed through EnigTech’s secure proxy endpoint to simplify setup.
   - The proxy only relays text and model parameters; it does not store, log, or analyze any user data.

All generated content is stored locally as a post on your WordPress site, under your full control.
You can edit or delete your content at any time. LucidPen never shares, republishes, or analyzes user data.

== External Services ==

LucidPen connects to the following external APIs to provide AI-assisted writing functionality:

= 1. Microsoft Azure OpenAI Service =
   - **Purpose:** Generates AI-assisted writing suggestions and responses.
   - **Data Sent:** Text entered by the user in the left panel (Prayer Guide or AI Interviewer) and AI-generated intermediate content.
   **LucidPen does *not* send any text entered in the right panel** (post title or main post content).
   - **When:** Only when the user clicks "Submit Your Response" or "Let AI (Re-)Compose."
   - **Transmission:** Secure HTTPS requests sent directly from your WordPress site.
   - **Privacy Policy:** https://privacy.microsoft.com/en-us/privacystatement
   - **Service Terms:** https://azure.microsoft.com/en-us/support/legal/

= 2. OpenAI API (if configured by the user) =
   - **Purpose:** Alternative AI text-generation endpoint.
   - **Data Sent:** Same as above.
   - **When:** Same as above.
   - **Privacy Policy:** https://openai.com/privacy
   - **Terms of Use:** https://openai.com/policies/terms-of-use

= 3. EnigTech LLC (optional hosted service) =
   - **Purpose:** Provides a hosted proxy endpoint for users who prefer not to configure their own API keys.
   - **Data Sent:** Same as above.
   - **When:** Same as above.
   - **Privacy Policy:** https://lucidpen.enigtech.com/privacy
   - **Terms of Service:** https://lucidpen.enigtech.com/terms

LucidPen discloses all external service connections transparently and ensures that users retain full control over their data and content.


== Data Retention ==

- Generated drafts are saved locally as WordPress posts.
- Encryption keys remain stored in each user’s profile meta.
- No user data, credentials, or API keys are ever transmitted to EnigTech or any analytics service.

== Add-ons and Extensions ==

LucidPen supports modular assistants and is built for extensibility.

Planned add-ons include:
- Custom assistant builder (visual interface)
- Hosted AI key integration (no API setup required)
- Assistant packs: travel logs, seasonal reflection, goal planning

== Screenshots ==

1. Prayer Assistant – ACTS model in action
2. Daily journaling / Blog entry assistant
3. Assistant selection screen
4. Settings panel with OpenAI key and upgrade info

== Frequently Asked Questions ==

= Do I need an OpenAI or Azure account? =
Only if you want to use AI features. LucidPen allows you to use your own API key for OpenAI or Azure OpenAI. A hosted option (no setup required) is coming soon.

= Can I use this for professional writing? =
LucidPen is focused on personal and spiritual use. LucidPen Business (coming soon) will target professional use cases such as reviews, proposals, and promotions.

= Is my writing sent externally or stored elsewhere? =
No. Your drafts remain on your WordPress site. If you use your own API key, requests go directly to OpenAI or Azure OpenAI.

= Can I create my own assistants? =
Soon! A visual assistant template builder is planned for a future release.

== Changelog ==

= 1.1.2 =
* Removed non-permitted development files from the Freemius SDK directory
* Added fully documented "External Services" section to readme.txt
* Enabled Freemius WordPress.org compatibility mode (`is_org_compliant`)
* Replaced the short `ec` prefix with a unique plugin-specific prefix across constants, options, transients, classes, and JS globals
* Improved option naming to avoid naming collisions
* General cleanup and preparation for WordPress.org compliance review

= 1.1.0 =
* Improved documentation for external services
* Added encryption for AI responses
* Enhanced settings for custom API endpoints
* Stability and compliance updates

= 1.0.0 =
* Initial public release
* Includes Prayer, Blog Coach, and Hiking Log assistants
* Modular assistant system
* OpenAI API key support

== Ownership ==

LucidPen is developed and maintained by **EnigTech LLC**, a U.S.-based software development studio.

Website: https://lucidpen.enigtech.com
Support: support@enigtech.com
Contact: https://lucidpen.enigtech.com/contact
