=== Cheetah AI Site Architect ===
Contributors: dirt-daubers
Tags: ai, theme setup, site builder, abilities api, gutenberg
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create reviewable and reversible Cheetah Wireframe site plans with the provider-agnostic WordPress AI Client.

== Description ==

Cheetah AI Site Architect adds an Appearance > AI Site Architect workflow for Cheetah Wireframe 2.2.0 or newer.

The plugin can propose:

* Safe theme settings exposed by the theme's typed configuration bridge.
* New pages composed from portable core WordPress blocks.
* A static homepage and primary navigation menu.
* Draft-first or immediate publishing workflows.

Every plan is shown for human review. The administrator must click "Approve and apply immediately" before any site changes occur. Applied plans can be rolled back from the change history.

The plugin never edits theme files, accepts executable code from a model, or stores provider API keys. Provider credentials remain managed by WordPress under Settings > Connectors.

== Installation ==

1. Install and activate WordPress 7.0 or newer.
2. Install and activate Cheetah Wireframe 2.2.0 or newer.
3. Install and activate this plugin.
4. Install a compatible AI provider plugin and configure it under Settings > Connectors.
5. Open Appearance > AI Site Architect.

== Privacy and external services ==

When an administrator generates a plan, the plugin sends the entered request plus a bounded snapshot of the site's name, description, language, existing page titles/slugs/statuses, active theme settings, and whether WooCommerce is active to the AI provider selected by WordPress. It does not send page or post bodies, passwords, connector credentials, user records, orders, or customer information.

Data handling and retention depend on the AI provider the site administrator configures. Review that provider's terms and privacy policy before use.

== Frequently Asked Questions ==

= Does the plugin include an AI provider? =

No. WordPress Core supplies the provider-agnostic AI Client and Connectors screen. A compatible provider plugin must be installed and configured separately.

= Can AI edit PHP, CSS, JavaScript, or theme templates? =

No. It can propose only allowlisted theme settings and content structures defined by the plugin.

= Does applying a plan overwrite existing pages? =

No. A page with a matching slug is reused for navigation and homepage selection, but its title, content, status, and template are not overwritten.

= What does rollback restore? =

Rollback restores safe theme settings, homepage options, blog-page selection, and menu locations recorded before approval. Pages created by the plan are moved to Trash and the generated navigation menu is deleted. Reused pages are left untouched.

== Changelog ==

= 1.1.0 =
* Added bounded child-theme, bbPress, and DIY Support Agent context.
* Added trusted extension hooks for site snapshots and planning context.
* Preserved the existing allowlisted settings, review, apply, and rollback boundaries.

= 1.0.0 =
* Initial release.
* WordPress 7.0 AI Client and Settings > Connectors integration.
* Structured site planning, review, immediate apply, history, and rollback.
* Typed Abilities API integration for future agent and MCP adapters.
