=== TWCarter Prompt Builder ===
Tags: ai, prompt engineering, coaching, artificial intelligence, education
Requires at least: 7.0
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 3.2.2.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Interactive AI prompt coaching with clarification questions, voice input, privacy-conscious logging, and adaptive-memory foundations.

== Description ==

TWCarter Prompt Builder helps visitors improve how they communicate with AI. It is a coaching application rather than a general chatbot. The coach can ask focused clarification questions, explain how a stronger prompt works, and provide a ready-to-copy prompt for use in the visitor's preferred AI tool.

Current features include:

* Conversational prompt coaching with up to three clarification rounds.
* Recognition of prompts that are already strong enough to use.
* Browser microphone input when supported by the visitor's browser.
* A five-request daily visitor allowance with administrator exemption.
* Signed clarification sessions and short-lived preview authorization.
* Privacy-conscious operational activity logging.
* Optional conversation-text logging, disabled by default on new installations.
* Operations Center, activity viewer, AI Request Logs link, settings, and retention cleanup.
* Adaptive Memory Foundation with dedicated storage and version-history tables. Memory services are disabled by default and do not automatically save or retrieve user memories in this release.

TWCarter Prompt Builder preserves its educational purpose. Adaptive memory is being developed to personalize coaching without silently collecting visitor prompts or bypassing the coaching process.

== Required Plugins ==

TWCarter Prompt Builder requires the following WordPress plugins:

* AI
* AI Provider for OpenAI

The required plugins provide WordPress AI Client integration and the OpenAI provider connection. An OpenAI API key must be configured through the provider plugin before TWCarter Prompt Builder can generate AI-assisted coaching or preview results.

== External Services ==

TWCarter Prompt Builder uses an external AI service when a visitor submits a prompt for coaching or requests an Example Preview.

Prompt and coaching-session content needed to fulfill the request is sent through the WordPress AI Client to the configured OpenAI provider. OpenAI processes that content to generate the requested coaching response or preview. TWCarter Prompt Builder does not include its own OpenAI API key and does not send data to TWCarter Technology Consulting for AI processing.

Use of OpenAI is subject to OpenAI's applicable business/API terms and privacy practices. Site administrators are responsible for reviewing those terms and for configuring the OpenAI provider appropriately for their site.

OpenAI Services Agreement: https://openai.com/policies/services-agreement/

OpenAI Service Terms: https://openai.com/policies/service-terms/

OpenAI Privacy Policy: https://openai.com/policies/privacy-policy/

Browser speech recognition, when available, is provided by the visitor's browser and browser vendor. Visitors can always type instead of using voice input.

== Privacy ==

TWCarter Prompt Builder separates operational activity logging from conversation-text logging.

Operational activity can record events such as opening the coach, starting voice input, submitting a prompt, receiving a clarification, completing coaching, requesting a preview, encountering an error, or leaving before completion. Visitor identifiers are stored as anonymized hashes rather than full IP addresses.

Conversation-text logging is disabled by default on new installations. If a site administrator enables it, visitor prompt text and coach response text for completed AI interactions can be stored locally in the site's WordPress database for the configured retention period. The default retention period is 30 days. Administrators can disable conversation logging independently of operational activity logging.

Adaptive Memory is disabled by default. Version 3.2.2.6 does not automatically create memories, retrieve memories, reflect on a user's profile, create embeddings, or inject memories into AI requests.

Visitors should not enter confidential, sensitive, or secret information into TWCarter Prompt Builder.

Site administrators should update their site's privacy policy to describe their actual configuration and any external AI provider they enable.

== Installation ==

1. Install and activate the required AI and AI Provider for OpenAI plugins.
2. Configure the OpenAI provider and API credentials according to the provider plugin's instructions.
3. Upload and activate TWCarter Prompt Builder.
4. Open TWCarter Prompt Builder > Settings and review activity logging, conversation logging, retention, and token-price settings.
5. Open TWCarter Prompt Builder > Adaptive Memory and confirm that memory storage remains disabled unless you intentionally enable the storage service for development or future features.
6. Test the public AI Coaching page and verify the existing coaching workflow.

The plugin creates or upgrades its own database tables automatically using WordPress database-upgrade functions. No manual table creation is required.

== Frequently Asked Questions ==

= Does TWCarter Prompt Builder automatically save everything a visitor types? =

No. Conversation-text logging is disabled by default on new installations. Operational activity logging is separate and does not accept prompt text for browser activity events.

= Does Adaptive Memory automatically remember visitors? =

No. Version 3.2.2.6 provides the storage and version-history foundation only. Automatic memory creation, retrieval, reflection, embeddings, prompt injection, and member-facing memory controls are intentionally deferred.

= Does the plugin require OpenAI? =

The current coaching workflow uses the WordPress AI Client with the AI Provider for OpenAI plugin. The administrator must configure that provider and its API credentials.

= Can visitors use voice input? =

When the browser supports speech recognition and microphone permission is granted, visitors can dictate their request. Typing remains available at all times.

== Changelog ==

= 3.2.2.7 =
* Updated the Plugin URI to the current TWCarter AI Coaching page.
* No functional changes.

= 3.2.2.6 =
* Renamed the plugin to TWCarter Prompt Builder to meet WordPress.org naming requirements.
* Set the requested WordPress.org repository slug and text domain to twcarter-prompt-builder.
* No functional changes.


= 3.2.2.5 =
* Renamed the plugin to TWCarter Prompt Builder and set the WordPress.org text domain and requested slug to twcarter-prompt-builder.
* Kept third-party WordPress admin notices out of the branded Operations Center hero by restoring a standard page-heading anchor outside the hero.
* Removed the redundant AI Request Logs / TWCarter Prompt Builder Activity explainer panel from the bottom of the Operations Center.
* Changed Today's Activity to display the WordPress-configured local timezone abbreviation instead of UTC.

= 3.2.2.4 =
* Strengthened the coaching boundary so naturally stated goals are always converted into reusable prompts instead of being completed as the underlying task.
* Reserved task execution for the explicit Example Preview / Check the Result function.
* Standardized active front-end and admin HTML, CSS, and JavaScript identifiers on the twcprco prefix for the TWCarter Prompt Builder product transition.
* Replaced the mechanically generated “Your TWCarter Prompt Buildering” result heading with the clearer “Your Improved Prompt.”
* Completed a user-facing branding copy review following live functional testing.

= 3.2.2 =
* Began the product-identity transition from the original TWC Prompt Coach name.
* Prepared the plugin for a distinctive WordPress.org name and slug.
* Standardized plugin declarations, hooks, options, cache groups, REST namespace, asset handles, classes, constants, and functions on the unique TWCPRCO/twcprco prefix.
* Preserved existing activity and adaptive-memory database tables so upgrades retain previously logged data.
* Preserved the existing activity and adaptive-memory database table names so upgrade testing can retain prior logged data.

= 3.2.1 =
* Remediated official Plugin Check findings for admin nonce handling, custom-table query preparation, and database-read caching.
* Centralized activity and memory database reads behind service methods with WordPress object-cache support and cache invalidation after writes.
* Prepared the plugin for WordPress.org submission review.
* Removed the private Update URI so WordPress.org can manage repository updates if the plugin is accepted.
* Rewrote the readme for the current product, dependencies, installation flow, privacy model, and external OpenAI service disclosure.
* Changed conversation-text logging to disabled by default on new installations. Existing administrator settings are preserved during upgrades.
* Expanded WordPress internationalization support for public error messages, front-end interface strings, memory-service messages, and administration labels.
* Retained Adaptive Memory as disabled by default with no automatic memory capture or prompt injection.

= 3.2.0 =
* Added the Adaptive Memory Foundation.
* Added dedicated memory and memory-version-history database tables.
* Added WordPress user ownership support and episodic, semantic, and reflective memory types.
* Added memory CRUD/versioning service architecture and an administrator inspection page.
* Kept automatic memory creation, retrieval, reflection, embeddings, prompt injection, and member-facing memory controls disabled and deferred.

= 3.1.4 =
* Updated TWCarter Prompt Builder operational behavior and release baseline before the Adaptive Memory development line.

= 3.1.0 =
* Added the TWCarter Prompt Builder Operations Center framework with system status, activity, cost summaries, quick actions, and recent events.

= 3.0.4 =
* Added business-oriented session fields and estimated token/cost reporting.

= 3.0.3 =
* Separated technical AI Request Logs from privacy-conscious TWCarter Prompt Builder Activity events.

= 3.0.2 =
* Improved voice-input error guidance and accessible status messages.

= 3.0.1 =
* Improved voice startup diagnostics and microphone-error reporting.

= 3.0.0 =
* Added automatic activity-table creation, schema tracking, logging settings, retention cleanup, dashboard, and activity viewer.
