=== ClaimPrism ===
Contributors: parsec66, freemius
Tags: woocommerce, compliance, green claims, sustainability, ecommerce
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.10.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Detect environmental marketing claims that may need human review, then organize the workflow to review, evidence, monitor and govern them over time.

== Description ==

ClaimPrism is a local-first risk-screening and claim-governance tool for WordPress and WooCommerce.

The Free edition scans supported products, pages, posts, common SEO metadata and image alt text for deterministic environmental-marketing risk signals, then prioritizes findings for human review. It includes first-run onboarding, resumable full-store scans and clear post-scan guidance.

ClaimPrism Pro extends detection into an operational governance workflow with:

* persistent review states, reviewer assignment, internal notes and append-only review history;
* scalable review filters, bulk review actions and workflow-aware CSV export;
* Evidence Repository with supporting references, notes and review/expiry dates;
* scan monitoring with New / Recurring / Removed classification and history;
* scheduled scans and operational review reports;
* dedicated Reviewer and Manager roles;
* stable Governed Claim identity and lifecycle metadata;
* Claim Graph usage intelligence across known claim usages;
* Approved Claim Library views;
* deterministic Semantic Drift signals;
* precise Claim Source Location context;
* controlled approved-wording reuse proposals;
* a dedicated Claim Governance workspace combining lifecycle, usages, review/evidence context, approved wording and monitoring signals.

ClaimPrism follows an internal governance lifecycle:

Detected -> Evidence required -> In review -> Approved -> Monitoring -> Re-review

These are workflow states. ClaimPrism does not certify claims, determine legal compliance or provide legal advice. Automated findings can include false positives and always require human review.

= Privacy =

Claim scanning remains local to WordPress and scanned content is not sent to an external ClaimPrism analysis service. ClaimPrism uses the Freemius SDK for optional usage opt-in, licensing, account management, updates and checkout. The SDK presents the applicable consent and account controls in WordPress before optional telemetry is enabled.

== Installation ==

1. Upload the `claimprism` folder to `/wp-content/plugins/` or install its ZIP package.
2. Activate ClaimPrism.
3. In WooCommerce, open WooCommerce > ClaimPrism. Without WooCommerce, use Tools > ClaimPrism.
4. Follow the first-run guidance and select "Scan store now" or "Run your first scan".
5. Review detected findings. Pro users can continue into Review, Evidence, Monitoring and Claim Governance workflows.

== Frequently Asked Questions ==

= Does ClaimPrism guarantee compliance? =

No. ClaimPrism is an automated risk-screening and workflow tool. Legal assessment depends on the exact claim, evidence, presentation, jurisdiction and surrounding circumstances.

= What does the Free edition do? =

The Free edition provides the core scan and prioritization experience so you can identify supported environmental marketing signals that may deserve human attention. It remains useful without a purchase.

= What does ClaimPrism Pro add? =

Pro adds the operational workflow around findings: reviewer assignment, review history, evidence management, monitoring, scheduled scans, reports, team roles and the Claim Governance workspace for managing governed claims and their known usages over time.

= Does an Approved claim mean ClaimPrism has certified it? =

No. Approved is an internal governance state recorded by the user's workflow. It is not a certification or legal-compliance verdict.

= Is catalog content sent to Freemius? =

No. Claim scanning is performed locally. Freemius handles product telemetry only after the applicable opt-in, plus licensing, account, update and purchase functions.

== Changelog ==

= 0.10.0 =
* Add dedicated ClaimPrism Reviewer and ClaimPrism Manager WordPress roles with narrowly scoped ClaimPrism capabilities.
* Add persistent Governed Claim identity and lifecycle metadata around detected claim usages.
* Add Review/Evidence aggregate views and Claim Graph usage intelligence without duplicating source-of-truth workflow data.
* Add Approved Claim Library, deterministic Semantic Drift signals and controlled approved-wording reuse proposals.
* Add precise Claim Source Location resolution for supported WordPress/WooCommerce source fields.
* Add the dedicated Pro Claim Governance workspace exposing lifecycle, usages, review/evidence context, approved wording and drift signals.
* Align the main dashboard and Claim Governance workspace to the dark ZEODEC visual system.
* Add first-run onboarding, Free-to-Pro value communication and improved post-scan empty-state guidance.
* Preserve Free/Pro boundaries and non-certification wording throughout the commercial workflow.

= 0.9.0 =
* Add Pro scan monitoring with first seen, last seen, recurrence counts, active/removed state and New / Recurring / Removed classification.
* Add scan-run history and comparison summaries plus finding-level monitoring filters and history drill-down.
* Add a Pro Evidence Repository with external references, WordPress media attachments, internal notes and expiry/review-date status.
* Add configurable Pro scheduled scans with Disabled, Daily, Weekly and Every 30 days frequencies plus preferred local hour.
* Add 7 / 30 / 90 day Pro Review Reports with protected CSV export covering finding changes, review state and evidence due/expiry metrics.
* Add protected bulk review actions for status and reviewer changes while preserving internal notes and append-only audit history.
* Replace the 100-row in-memory Pro queue with database-backed filtering/counting and 50-row pagination across the complete findings set.
* Keep all new commercial workflow modules behind Freemius premium-only boundaries and extend automated regression coverage.

= 0.8.0 =
* Add a Pro review workflow with persistent Open, In review, Resolved and Accepted states keyed to finding fingerprints so review state survives rescans.
* Add internal reviewer notes, WordPress-user assignment and append-only review history with actor and timestamp.
* Add Pro queue filters for status, priority, reviewer, content type, rule and free-text search, preserving active filters after review updates.
* Add workflow-aware filtered Pro CSV export including status, reviewer, internal note and review timestamp while retaining spreadsheet-injection protection.
* Add Free/Pro package regression, upgrade-persistence and workflow coverage; WordPress + WooCommerce integration tests and official Plugin Check pass on the generated package.

= 0.7.7 =
* Resume interrupted background scans after plugin reactivation and retry safely after lock contention.
* Keep background scan scheduling idempotent across repeated starts and multi-batch progression.
* Clear stale continuation events when scans finish and start completed scans again with fresh counters and content totals.
* Expand automated regression coverage for scan persistence, Free/Pro boundaries, upgrade safety and release metadata alignment.

= 0.7.6 =
* Make WordPress.org Plugin Check annotations resilient to Freemius Free-package preprocessing.
* Preserve translator guidance and narrow scanner/Freemius exceptions in the generated Free build.

= 0.7.5 =
* Make the Freemius premium-only CSV export guard compiler-safe for Free-package generation.
* Keep direct CSV export requests denied without a Pro entitlement.

= 0.7.4 =
* Harden database-table initialization so Plugin Check demo-content preparation does not trigger missing-table errors.
* Document Freemius bootstrap naming exceptions for WordPress coding standards.
* Include composer.json in the WordPress.org-shaped CI build and align the generated test package version.

= 0.7.3 =
* Default Freemius pricing and checkout to EUR.
* Show annual plan totals instead of monthly equivalents on the pricing page.
* Keep Freemius pricing pages under the WordPress Tools menu.

= 0.7.2 =
* Harden the CSV entitlement boundary for Freemius-generated Free and Pro packages.
* Add an automated regression test for direct CSV export access without Pro.

= 0.7.0 =
* Integrate Freemius SDK 2.13.4 at the start of the main plugin bootstrap.
* Add Free-to-Pro activation conflict handling and licensed distribution metadata.
* Protect CSV review-report export behind an active ClaimPrism Pro entitlement.
* Bundle the pinned SDK into CI test and WordPress.org-shaped build artifacts.

= 0.6.0 =
* Rebrand the plugin as ClaimPrism before its first public WordPress.org submission.
* Align the public plugin slug, text domain, REST namespace, extension hooks and development tooling with the ClaimPrism name.
