# ClaimPrism v0.10.1

ClaimPrism is a WordPress/WooCommerce **Claim Intelligence & Governance** product for environmental marketing claims. It detects wording that may need human review and, in Pro, adds the operational workflow to review, evidence, monitor and govern those claims over time.

ClaimPrism provides risk screening and workflow support. It does **not** certify claims, determine legal compliance or replace legal advice.

## Product workflow

ClaimPrism is evolving around the lifecycle:

`Detected → Evidence required → In review → Approved → Monitoring → Re-review`

The current 0.10.1 commercial baseline already includes the detection, review, evidence, monitoring and governance foundations needed for that workflow.

## Free edition

The Free edition provides a useful core product without a purchase:

- scans supported WooCommerce products, WordPress pages and posts;
- checks titles, descriptions, common SEO metadata and image alt text;
- detects environmental-marketing, carbon-neutrality, offsetting, future-performance and sustainability-label signals in six languages;
- shows prioritized findings and source context;
- supports resumable full-store scans and live re-checks on supported saved content;
- includes first-run onboarding and post-scan guidance;
- explains the Pro value path without hiding Free scan results.

## ClaimPrism Pro

Pro extends detection into an operational governance workflow:

- persistent review states, reviewer assignment, internal notes and append-only review history;
- scalable review filtering, 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 drill-down;
- scheduled scans and 7 / 30 / 90 day operational review reports;
- dedicated ClaimPrism Reviewer and ClaimPrism Manager roles;
- persistent Governed Claim identity and lifecycle metadata;
- Review/Evidence aggregate views without duplicating source-of-truth data;
- Claim Graph usage intelligence across known claim usages;
- Approved Claim Library read model;
- deterministic Semantic Drift signals;
- precise Claim Source Location resolution;
- controlled approved-wording reuse proposals;
- dedicated Claim Governance workspace.

`Approved` and drift states are internal governance signals, not legal/compliance verdicts.

## Getting started

See [`docs/GETTING-STARTED.md`](docs/GETTING-STARTED.md) for the customer workflow from installation and first scan through Pro Review, Evidence, Monitoring and Claim Governance.

Quick install:

1. Install a generated ClaimPrism ZIP from **WordPress Admin > Plugins > Add New > Upload Plugin**.
2. Activate ClaimPrism.
3. Open **WooCommerce > ClaimPrism** when WooCommerce is installed, or **Tools > ClaimPrism** otherwise.
4. Run the first scan and review the dashboard guidance.

## Free and Pro distribution

ClaimPrism uses one premium source codebase. Freemius generates the WordPress.org-compliant Free package and the licensed Pro package during deployment. Premium-only implementation must remain behind Freemius premium-code boundaries; the Free build must remain useful without a purchase.

The Freemius SDK is installed through Composer and bundled into distributable ZIPs. No Freemius secret key belongs in source control.

The WordPress.org-submitted `0.6.0` package remains frozen while under review unless the WordPress Plugins Team explicitly requests a change.

## Local development

Requires PHP 7.4 or newer, Composer 2 and Node.js 20.18 or newer.

```bash
composer install --no-dev
npm install
npm run dev
```

Run the WordPress Playground integration suite with:

```bash
npm test
```

Repository CI packages the plugin and runs:

- WordPress + WooCommerce integration tests;
- official WordPress Plugin Check.

## Technical structure

- `claimprism.php`: Freemius bootstrap, plugin coordination, hooks and scheduling.
- `composer.json`: pinned Freemius SDK dependency.
- `includes/`: scanner, admin UI and premium-only workflow/governance modules.
- `assets/`: WordPress admin/editor assets and ZEODEC UI styling.
- `docs/GETTING-STARTED.md`: customer-facing onboarding and workflow guide.
- `docs/PRODUCT_STATE.md`: current validated product state.
- `docs/ARCHITECTURE.md`: architecture and domain boundaries.
- `docs/ROADMAP.md`: product roadmap and Commercial 1.0 direction.
- `docs/EXTENSIONS.md`: supported extension hooks and premium-code boundary.
- `docs/TEAM-ROLES-0.10.0.md`: Team & Roles capability model.

## Architecture direction

WordPress/WooCommerce is the first connector, not the permanent product boundary. The long-term platform direction is to build cumulative value around:

1. Regulatory Knowledge Graph.
2. Customer Claim Graph.
3. Decision / approval history.
4. Workflow integrations.

The current commercial focus is **Commercial 1.0 readiness**: make the existing product understandable, shippable and supportable before expanding into Evidence Strength, Jurisdiction or other Phase 2 intelligence engines.
