=== VividHarbor AI Assistant ===
Contributors: vividstackanchorai
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

An AI chatbot grounded only in your content — secure, no API keys, multilingual, customizable, and auto-synced to your website.

== Description ==

VividHarbor AI Assistant adds a smart chatbot to your WordPress site that is grounded in **your content** — so answers stay specific to you instead of generic AI filler. Feed it knowledge two ways, and it uses them together: upload documents (.txt) and/or sync your published website Pages (manually or automatically). Style it, control who can use it, and manage everything from one simple admin portal. No API keys. No complex setup.

**What makes it different**

- **Grounded in your content** — Uses your uploaded documents and your website Pages as its source, so replies stay on-topic and specific to your business.
- **Two ways to add knowledge, used together** — Upload .txt files and/or sync your website Pages. Use either or both; overlapping content is de-duplicated for you automatically.
- **Automatic website sync** — Publish, edit, or delete a Page and your chatbot updates within seconds. Manual "Sync now" and periodic full re-checks are included on paid plans. No server cron setup required.
- **No API keys, one-click connect** — No model keys, no developer setup.
- **Multilingual** — Detects and replies in your visitor's language automatically.
- **On-brand** — Customize colors, welcome message, widget position, and behavior from the admin portal.
- **Secure and controlled** — Domain allowlisting, traffic controls, and per-plan usage limits protect your site and your budget.
- **Built-in insights** — See top customer topics and suggested improvements in the analytics dashboard (paid plans).

**How it works**

1. Install the plugin and click "Create your Chatbot."
2. Verify your email and choose a plan (free trial available).
3. Add your content — upload a .txt file and/or sync your website Pages in one click.
4. Add the Chatbot Widget block to a page, or turn it on site-wide.
5. Your assistant is live, answering visitors day and night.

= External services =

This plugin relies on external services operated by Vividstack to provide chatbot functionality.

Service name: Vividstack Admin Portal and Widget Service
- Service endpoint(s):
  - https://admin.vividstack.dev
  - https://widget.vividstack.dev/widget.js
- Purpose:
  - Connect your WordPress site to your Vividstack tenant
  - Retrieve chatbot/widget configuration
  - Send your selected website Page content for chatbot knowledge (only when you click Sync or enable automatic sync)
  - Load the frontend widget script and render the chatbot experience
- Data sent:
  - Site domain/host during connection and allowlist setup
  - Tenant and widget configuration identifiers
  - Optional chatbot display settings (title, welcome text, dimensions)
  - Published Page content you choose to sync (title, URL, and text)
- Data purpose:
  - Authenticate tenant connection
  - Enforce domain allowlisting
  - Ground chatbot answers in your content and deliver widget configuration
- Data handling details:
  - Privacy Policy: https://vividstack.dev/privacy
  - Terms of Service: https://vividstack.dev/terms

== Installation ==

1. Install and activate the plugin.
2. In wp-admin, open **VividHarbor AI Assistant** (left sidebar).
3. Click **Create your Chatbot** and follow the prompts.
4. Add your site to the allowlist.
5. Add content: upload a .txt file and/or click **Sync website content** to pull in your published Pages.
6. Add a **Chatbot Widget** block to any page (or enable site-wide). Publish.

== Frequently Asked Questions ==

= Do I need an API key? =
No. The plugin handles authentication automatically when you connect — there are no model or API keys to manage.

= How does the chatbot learn my content? =
Two ways, and it uses them together: upload .txt files, and/or sync your published website Pages. You can re-sync anytime; paid plans can also sync automatically on a schedule.

= Will syncing my website create duplicates? =
No. Re-syncing updates pages that changed and removes pages you've deleted, with automatic de-duplication — so uploaded files and website content work side by side cleanly.

= What file formats can I upload? =
Currently .txt files. PDF and more formats are coming soon.

= Is automatic website sync available on all plans? =
Manual "Sync now" is available on every paid plan. Scheduled automatic syncing is included on paid plans; the free trial supports manual preview only.

= Why is my chatbot not loading? =
Ensure you:
- Completed the "Create your Chatbot" flow.
- Added your site to the allowlist.
- Published a page with the Chatbot Widget block (or enabled site-wide display).

= Is there a free trial? =
Yes. New users get a free trial with a limited monthly message allowance to test the chatbot.

== Changelog ==

= 0.2.2 =
- New: Automatic sync now updates the chatbot as soon as you publish, edit, or delete a Page — no waiting on a schedule, and no host cron setup required.
- New: Automatic page updates are capped per day by your plan (default 20) so heavy editing days stay predictable; further changes are picked up on the next full re-check.
- Improved: Full website re-checks remain as a safety net for changes made outside the editor.
- Fixed: Sync timestamps now display in your site's timezone instead of UTC.
- Fixed: Backend rate-limit messages are no longer shown as sync failures.

= 0.2.1 =
- Fixed: Automatic website sync could silently stop on sites where WordPress scheduled tasks do not run reliably (for example when a full-page cache serves visitors). Overdue syncs now run on their own.
- Fixed: Automatic sync stayed switched off after deactivating and reactivating the plugin, even though the setting still appeared enabled.
- Improved: The sync panel now reports when a sync is overdue and surfaces the reason when an automatic sync fails.

= 0.2.0 =
- New: Sync your website Pages into the chatbot — manual "Sync now" on every paid plan, plus scheduled automatic syncing on paid plans.
- New: Clearer content setup — uploaded files and website content are used together and automatically de-duplicated.
- Improved: Onboarding copy and admin dashboard guidance.
- Compatibility: Tested up to WordPress 7.0.

= 0.1.1 =
- Compliance-focused admin notice scope update and metadata alignment for review.

= 0.1.0 =
- Initial release: one-click setup, Gutenberg block, multi-lingual support.
