Commit d3ee2703b98 for woocommerce

commit d3ee2703b985b4df5458d298cab28c16dff4348e
Author: AnnaMag <AnnaMag@users.noreply.github.com>
Date:   Fri Nov 20 23:32:31 2026 +0100

    Agent readiness: 18 Nov content review, second round (#71119)

    * Agent readiness: 18 Nov content review, second round

    Fix first starts each issue with what it affects. The scan note, the
    preview details line and the product description fix follow the review.
    The store share card groups its items by where they live, and items the
    scan couldn't read aren't counted as not shared.

    * Agent readiness: impact line, share groups and badge wrap on Sales readiness

    Shows the impact line in bold, the share card's groups and Not checked
    yet items, and keeps the Required badge with the title's last word.

    * Keep a title's last character with its badge, and count one checked item in the singular.

    A title without spaces keeps its last character with the Required badge, so
    the badge no longer wraps onto a line of its own. The share card's count
    uses _n(), so one checked item reads "shares 0 of 1".

    * Keep only the last character with the badge when the last word is Chinese, Japanese or Korean

    A title like "AI に商品情報を読み取れるようにする" has a space, but the Japanese after it
    has none, so holding it all with the badge stopped it from wrapping.

    * Agent readiness: don't claim discovery covered every product page

    * Fix Store API checkout PHPStan failures on trunk

diff --git a/plugins/woocommerce/changelog/update-agent-readiness-copy-round-2 b/plugins/woocommerce/changelog/update-agent-readiness-copy-round-2
new file mode 100644
index 00000000000..0458d291272
--- /dev/null
+++ b/plugins/woocommerce/changelog/update-agent-readiness-copy-round-2
@@ -0,0 +1,4 @@
+Significance: patch
+Type: dev
+Comment: AI sales readiness copy from the 18 Nov content review, behind the agent_readiness feature flag; nothing ships to merchants.
+
diff --git a/plugins/woocommerce/client/admin/client/sales-readiness/components/check-row.tsx b/plugins/woocommerce/client/admin/client/sales-readiness/components/check-row.tsx
index 3a02a82f55c..637c2bfb551 100644
--- a/plugins/woocommerce/client/admin/client/sales-readiness/components/check-row.tsx
+++ b/plugins/woocommerce/client/admin/client/sales-readiness/components/check-row.tsx
@@ -105,6 +105,39 @@ interface RowProps {
 	srState?: string;
 }

+/** Scripts that wrap between characters rather than at spaces: Chinese, Japanese and Korean. */
+const CJK = /[\u3040-\u30ff\u3400-\u9fff\uac00-\ud7af\uf900-\ufaff]/;
+
+/**
+ * A title whose badge stays with its last word, so a long title wraps without leaving the badge on a
+ * line of its own.
+ */
+const TitleWithBadge = ( {
+	title,
+	badge,
+}: {
+	title: string;
+	badge: ViewBadge;
+} ) => {
+	// The last word stays with the badge. Text after the last space that has no spaces of its own, such
+	// as one word or Japanese, keeps only its last character there, so the rest can still wrap.
+	const afterSpace = title.lastIndexOf( ' ' ) + 1;
+	const lastChar = title.length - ( Array.from( title ).pop()?.length ?? 0 );
+	const split =
+		afterSpace && ! CJK.test( title.slice( afterSpace ) )
+			? afterSpace
+			: lastChar;
+	return (
+		<>
+			{ title.slice( 0, split ) }
+			<span className="wc-sales-readiness-row__title-end">
+				{ title.slice( split ) }
+				<Badge intent={ badge.intent }>{ badge.text }</Badge>
+			</span>
+		</>
+	);
+};
+
 /**
  * A row's frame: marker, title with its badge, whatever goes under the title, then the action.
  */
@@ -128,9 +161,10 @@ export const Row = ( {
 		<Stack direction="column" className="wc-sales-readiness-row__body">
 			<Text variant="body-md" className="wc-sales-readiness-row__title">
 				{ srState && <VisuallyHidden>{ srState } </VisuallyHidden> }
-				{ title }
-				{ badge && (
-					<Badge intent={ badge.intent }>{ badge.text }</Badge>
+				{ badge ? (
+					<TitleWithBadge title={ title } badge={ badge } />
+				) : (
+					title
 				) }
 			</Text>
 			{ children }
diff --git a/plugins/woocommerce/client/admin/client/sales-readiness/components/fix-first.tsx b/plugins/woocommerce/client/admin/client/sales-readiness/components/fix-first.tsx
index 44dcd505c74..66ff0c99c86 100644
--- a/plugins/woocommerce/client/admin/client/sales-readiness/components/fix-first.tsx
+++ b/plugins/woocommerce/client/admin/client/sales-readiness/components/fix-first.tsx
@@ -37,8 +37,8 @@ function groupByTier( items: FixFirstData[ 'items' ] ): TierGroup[] {
 }

 /**
- * The Fix first items under a heading per tier: what each group of issues stops. A product item's
- * line starts with its share of sales.
+ * The Fix first items under a heading per tier: what each group of issues stops. An item's line
+ * starts with what it affects, in bold.
  */
 export const FixFirstList = ( {
 	items,
@@ -86,11 +86,17 @@ export const FixFirstList = ( {
 							}
 							srState={ item.tier + ':' }
 						>
-							{ item.why && (
+							{ ( item.impact || item.why ) && (
 								<Text
 									variant="body-sm"
 									className="wc-sales-readiness__muted"
 								>
+									{ item.impact && (
+										<strong className="wc-sales-readiness__impact">
+											{ item.impact }
+										</strong>
+									) }
+									{ item.impact && item.why && ' ' }
 									{ item.why }
 								</Text>
 							) }
diff --git a/plugins/woocommerce/client/admin/client/sales-readiness/components/section-card.tsx b/plugins/woocommerce/client/admin/client/sales-readiness/components/section-card.tsx
index 0a86a633897..09193ae6eb9 100644
--- a/plugins/woocommerce/client/admin/client/sales-readiness/components/section-card.tsx
+++ b/plugins/woocommerce/client/admin/client/sales-readiness/components/section-card.tsx
@@ -198,6 +198,15 @@ export const SectionCard = ( { section }: { section: Section } ) => {
 	);
 };

+const declaredState = ( found: boolean | null ) => {
+	if ( found === null ) {
+		return __( 'Not checked yet:', 'woocommerce' );
+	}
+	return found
+		? __( 'Found:', 'woocommerce' )
+		: __( 'Not found:', 'woocommerce' );
+};
+
 /**
  * Protocols and files the store serves to agents: information, never pass or fail, so the card
  * starts closed and opens on its header to list them.
@@ -231,20 +240,33 @@ export const DeclaredCard = ( { declared }: { declared: Declared } ) => (
 			>
 				{ declared.text }
 			</Text>
-			<ul className="wc-sales-readiness-list">
-				{ declared.items.map( ( item ) => (
-					<Row
-						key={ item.name }
-						done={ item.found }
-						title={ item.name }
-						srState={
-							item.found
-								? __( 'Found:', 'woocommerce' )
-								: __( 'Not found:', 'woocommerce' )
-						}
-					/>
+			<div className="wc-sales-readiness-fix-first-groups">
+				{ declared.groups.map( ( group ) => (
+					<div
+						key={ group.title }
+						className="wc-sales-readiness-tier-group"
+					>
+						<div className="wc-sales-readiness-tier">
+							<Text
+								variant="heading-sm"
+								className="wc-sales-readiness-card__label"
+							>
+								{ group.title }
+							</Text>
+						</div>
+						<ul className="wc-sales-readiness-list">
+							{ group.items.map( ( item ) => (
+								<Row
+									key={ item.name }
+									done={ item.found === true }
+									title={ item.name }
+									srState={ declaredState( item.found ) }
+								/>
+							) ) }
+						</ul>
+					</div>
 				) ) }
-			</ul>
+			</div>
 		</CollapsibleCard.Content>
 	</CollapsibleCard.Root>
 );
diff --git a/plugins/woocommerce/client/admin/client/sales-readiness/sales-readiness.scss b/plugins/woocommerce/client/admin/client/sales-readiness/sales-readiness.scss
index bc9ca58bafd..c9a968f3cea 100644
--- a/plugins/woocommerce/client/admin/client/sales-readiness/sales-readiness.scss
+++ b/plugins/woocommerce/client/admin/client/sales-readiness/sales-readiness.scss
@@ -84,6 +84,12 @@ body:has(.wc-sales-readiness) {
 		color: var(--wc-sr-muted);
 	}

+	// What a Fix first issue affects, in bold before its line.
+	&__impact {
+		color: var(--wpds-color-foreground-content-neutral);
+		font-weight: 600;
+	}
+
 	// No orphans: balance the last line of text.
 	:is(p, .components-text, [class*="__body-"]) {
 		text-wrap: pretty;
@@ -276,13 +282,18 @@ body:has(.wc-sales-readiness) {
 	// The badge follows the title's last word, so a long title wraps without leaving it on a line of its own.
 	&__title {
 		display: block;
-		margin-block-end: -2px;
 		font-weight: 600;

-		> span {
-			display: inline-flex;
-			margin-inline-start: var(--wpds-dimension-gap-sm);
-			vertical-align: middle;
+		// The badge is taller than the 20px line, so it overlaps the line by 2px each side instead of adding a gap.
+		&-end {
+			white-space: nowrap;
+
+			> span {
+				display: inline-flex;
+				margin-block: -2px;
+				margin-inline-start: var(--wpds-dimension-gap-sm);
+				vertical-align: middle;
+			}
 		}
 	}

diff --git a/plugins/woocommerce/client/admin/client/sales-readiness/test/check-row.test.tsx b/plugins/woocommerce/client/admin/client/sales-readiness/test/check-row.test.tsx
index 2fe63f8543b..394b6cbf739 100644
--- a/plugins/woocommerce/client/admin/client/sales-readiness/test/check-row.test.tsx
+++ b/plugins/woocommerce/client/admin/client/sales-readiness/test/check-row.test.tsx
@@ -29,6 +29,50 @@ const renderRow = ( data: CheckRowData ) =>
 	);

 describe( 'CheckRow', () => {
+	it( 'keeps the badge with the title’s last word, so it never wraps onto a line of its own', () => {
+		const { container } = renderRow(
+			row( {
+				title: 'Publish your refund and returns policy page',
+				badge: { intent: 'low', text: 'Required' },
+			} )
+		);
+
+		const end = container.querySelector(
+			'.wc-sales-readiness-row__title-end'
+		);
+		expect( end ).toHaveTextContent( 'pageRequired' );
+		expect(
+			container.querySelector( '.wc-sales-readiness-row__title' )
+		).toHaveTextContent(
+			'Publish your refund and returns policy pageRequired'
+		);
+	} );
+
+	it.each( [
+		'Payments',
+		'返品ポリシーのページを公開する',
+		'AI に商品情報を読み取れるようにする',
+	] )(
+		'keeps the last character with the badge when the last word has no spaces, so a long one can still wrap: %s',
+		( title ) => {
+			const { container } = renderRow(
+				row( {
+					title,
+					badge: { intent: 'low', text: 'Required' },
+				} )
+			);
+
+			expect(
+				container.querySelector( '.wc-sales-readiness-row__title-end' )
+			).toHaveTextContent(
+				new RegExp( '^' + Array.from( title ).pop() + 'Required$' )
+			);
+			expect(
+				container.querySelector( '.wc-sales-readiness-row__title' )
+			).toHaveTextContent( title + 'Required' );
+		}
+	);
+
 	it( 'links the name of a tool in the found line, and keeps the text around it', () => {
 		const { container } = renderRow(
 			row( {
diff --git a/plugins/woocommerce/client/admin/client/sales-readiness/test/fix-first.test.tsx b/plugins/woocommerce/client/admin/client/sales-readiness/test/fix-first.test.tsx
index f0eecc5b72c..6e1409f2976 100644
--- a/plugins/woocommerce/client/admin/client/sales-readiness/test/fix-first.test.tsx
+++ b/plugins/woocommerce/client/admin/client/sales-readiness/test/fix-first.test.tsx
@@ -44,6 +44,27 @@ describe( 'FixFirstList', () => {
 		);
 		expect( screen.getAllByText( 'Required' ) ).toHaveLength( 1 );
 	} );
+
+	it( 'starts an item’s line with what it affects, in bold', () => {
+		render(
+			<FixFirstList
+				items={ [
+					{
+						...item( 'missing_images', 'Needed to list products' ),
+						impact: 'Affects 38% of your sales.',
+						why: 'AI shopping apps need a main image to list a product.',
+					},
+				] }
+				surface="page"
+			/>
+		);
+
+		const impact = screen.getByText( 'Affects 38% of your sales.' );
+		expect( impact.tagName ).toBe( 'STRONG' );
+		expect( impact.parentElement ).toHaveTextContent(
+			'Affects 38% of your sales. AI shopping apps need a main image to list a product.'
+		);
+	} );
 } );

 describe( 'FixFirstCard', () => {
diff --git a/plugins/woocommerce/client/admin/client/sales-readiness/test/section-card.test.tsx b/plugins/woocommerce/client/admin/client/sales-readiness/test/section-card.test.tsx
index 74fdfd931f4..8f8500034e9 100644
--- a/plugins/woocommerce/client/admin/client/sales-readiness/test/section-card.test.tsx
+++ b/plugins/woocommerce/client/admin/client/sales-readiness/test/section-card.test.tsx
@@ -7,7 +7,7 @@ import userEvent from '@testing-library/user-event';
 /**
  * Internal dependencies
  */
-import { SectionCard } from '../components/section-card';
+import { DeclaredCard, SectionCard } from '../components/section-card';
 import type { CheckRow, RowState, Section } from '../types';

 jest.mock( '../tracks', () => ( { trackReadiness: jest.fn() } ) );
@@ -111,3 +111,43 @@ describe( 'SectionCard', () => {
 		).toHaveAttribute( 'href', '#new' );
 	} );
 } );
+
+describe( 'DeclaredCard', () => {
+	it( 'lists items under their group, and says which were found, not found or not checked', async () => {
+		const { container } = render(
+			<DeclaredCard
+				declared={ {
+					title: 'What does your store share with AI assistants?',
+					badge: { intent: 'none', text: 'Optional' },
+					text: 'These are other files and code that some AI assistants use to learn about your store.',
+					groups: [
+						{
+							title: 'Files in your root folder',
+							items: [
+								{ name: 'ai.txt usage file', found: true },
+								{ name: 'AGENTS.md', found: false },
+							],
+						},
+						{
+							title: 'Not checked yet',
+							items: [ { name: 'TDMRep', found: null } ],
+						},
+					],
+				} }
+			/>
+		);
+
+		await userEvent.click(
+			screen.getByText( 'What does your store share with AI assistants?' )
+		);
+
+		const groups = container.querySelectorAll(
+			'.wc-sales-readiness-tier-group'
+		);
+		expect( groups ).toHaveLength( 2 );
+		expect( groups[ 0 ] ).toHaveTextContent( 'Files in your root folder' );
+		expect( groups[ 0 ] ).toHaveTextContent( 'Found: ai.txt usage file' );
+		expect( groups[ 0 ] ).toHaveTextContent( 'Not found: AGENTS.md' );
+		expect( groups[ 1 ] ).toHaveTextContent( 'Not checked yet: TDMRep' );
+	} );
+} );
diff --git a/plugins/woocommerce/client/admin/client/sales-readiness/types.ts b/plugins/woocommerce/client/admin/client/sales-readiness/types.ts
index a339c04c386..7c493eb7e18 100644
--- a/plugins/woocommerce/client/admin/client/sales-readiness/types.ts
+++ b/plugins/woocommerce/client/admin/client/sales-readiness/types.ts
@@ -44,6 +44,8 @@ export interface FixFirstItem {
 	/** Shown beside the tier heading: Required for the Required tier. */
 	badge: ViewBadge | null;
 	title: string;
+	/** Shown in bold before `why`: "Affects 38% of your sales.", or "Affects your whole store.". */
+	impact?: string | null;
 	why: string;
 	link: ViewLink | null;
 }
@@ -79,7 +81,12 @@ export interface Declared {
 	title: string;
 	badge: ViewBadge;
 	text: string;
-	items: { name: string; found: boolean }[];
+	/** Items under where they live: root folder, standard addresses, page code, extra details, not checked yet. */
+	groups: {
+		title: string;
+		/** `found` is null for an item the scan couldn't read. */
+		items: { name: string; found: boolean | null }[];
+	}[];
 }

 export interface ShoppingCard {
diff --git a/plugins/woocommerce/src/Internal/AgentReadiness/DeclaredToAgents.php b/plugins/woocommerce/src/Internal/AgentReadiness/DeclaredToAgents.php
index 45c32145e66..91a8a3da110 100644
--- a/plugins/woocommerce/src/Internal/AgentReadiness/DeclaredToAgents.php
+++ b/plugins/woocommerce/src/Internal/AgentReadiness/DeclaredToAgents.php
@@ -24,14 +24,14 @@ class DeclaredToAgents {
 	public function all( StoreResponses $responses ): array {
 		$responses->home_page();
 		$items = array();
-		foreach ( $this->files() as $id => $file ) {
+		foreach ( self::files() as $id => $file ) {
 			$items[] = array(
 				'id'    => $id,
 				'name'  => $file[0],
 				'found' => self::file_served( $responses, $file[1] ),
 			);
 		}
-		foreach ( $this->documents() as $id => $document ) {
+		foreach ( self::documents() as $id => $document ) {
 			$items[] = array(
 				'id'    => $id,
 				'name'  => $document[0],
@@ -72,6 +72,27 @@ class DeclaredToAgents {
 		return $items;
 	}

+	/**
+	 * Where an item lives, for grouping on the page: 'root' for a file in the site's root folder,
+	 * 'address' for one under /.well-known, 'code' for page markup, 'extra' for anything else.
+	 *
+	 * @since 11.4.0
+	 *
+	 * @param string $id Item id.
+	 */
+	public static function group( string $id ): string {
+		foreach ( array_merge( self::files(), self::documents() ) as $key => $item ) {
+			if ( $key === $id ) {
+				return 0 === strpos( $item[1], '/.well-known/' ) ? 'address' : 'root';
+			}
+		}
+		if ( 'mcp-server-card' === $id ) {
+			return 'address';
+		}
+		$code = array( 'sameas-links', 'site-search-action', 'webmcp-forms-schema', 'markdown-alternate-link', 'code-block-language', 'editorial-metadata', 'site-search-autocomplete' );
+		return in_array( $id, $code, true ) ? 'code' : 'extra';
+	}
+
 	/**
 	 * WooCommerce's llms.txt status, null without its llms.txt fallback (woocommerce #70741).
 	 *
@@ -106,7 +127,7 @@ class DeclaredToAgents {
 	 *
 	 * @return array<string, array{0:string,1:string}> Name and path from the host root.
 	 */
-	private function files(): array {
+	private static function files(): array {
 		return array(
 			'ai-txt'       => array( __( 'ai.txt usage file', 'woocommerce' ), '/ai.txt' ),
 			'sitemap-md'   => array( __( 'Markdown sitemap', 'woocommerce' ), '/sitemap.md' ),
@@ -123,7 +144,7 @@ class DeclaredToAgents {
 	 *
 	 * @return array<string, array{0:string,1:string,2:callable(array<mixed>):bool}> Name, path from the host root, and test.
 	 */
-	private function documents(): array {
+	private static function documents(): array {
 		$has = static fn( string ...$keys ): callable => static fn( array $document ): bool => array() === array_diff( $keys, array_keys( array_filter( $document ) ) );
 		return array(
 			'api-catalog'              => array( __( 'API catalog', 'woocommerce' ), '/.well-known/api-catalog', $has( 'linkset' ) ),
diff --git a/plugins/woocommerce/src/Internal/AgentReadiness/ReadinessCheckPage.php b/plugins/woocommerce/src/Internal/AgentReadiness/ReadinessCheckPage.php
index 25b495348c5..bdbb1a6cbd4 100644
--- a/plugins/woocommerce/src/Internal/AgentReadiness/ReadinessCheckPage.php
+++ b/plugins/woocommerce/src/Internal/AgentReadiness/ReadinessCheckPage.php
@@ -270,9 +270,9 @@ class ReadinessCheckPage implements RegisterHooksInterface {
 			$available = (int) ( $report['available'] ?? 0 );
 			$truncated = $available > ProductScan::PRODUCT_LIMIT
 				/* translators: 1: number of products checked, 2: number of products in the store. */
-				? sprintf( __( 'Checked the %1$s products you changed most recently, out of %2$s.', 'woocommerce' ), number_format_i18n( ProductScan::PRODUCT_LIMIT ), number_format_i18n( $available ) )
+				? sprintf( __( 'Product checks covered the %1$s products you updated most recently, out of %2$s. Store conditions covered your whole store. Product details, and some Search and discovery checks, still sample product pages.', 'woocommerce' ), number_format_i18n( ProductScan::PRODUCT_LIMIT ), number_format_i18n( $available ) )
 				/* translators: %s: number of products checked. Reports from before the total was stored. */
-				: sprintf( __( 'Checked the %s products you changed most recently.', 'woocommerce' ), number_format_i18n( ProductScan::PRODUCT_LIMIT ) );
+				: sprintf( __( 'Product checks covered the %s products you updated most recently. Store conditions covered your whole store. Product details, and some Search and discovery checks, still sample product pages.', 'woocommerce' ), number_format_i18n( ProductScan::PRODUCT_LIMIT ) );
 		}
 		return array(
 			'title'        => __( 'AI sales readiness', 'woocommerce' ),
@@ -659,7 +659,7 @@ class ReadinessCheckPage implements RegisterHooksInterface {
 	 *
 	 * @param array<int, array{id:string,ok:bool|null,blocks:string,group?:string,level:string,name:string,label?:string,why:string,fix:string,fix_url:string,conflict?:bool,pending?:bool,seen_at?:string}> $checks Store checks shown on the page.
 	 * @param array<string, mixed>                                                                                                                                                                           $report Stored report.
-	 * @return array<int, array{id:string,tier:int,title:string,why:string,link:array{href:string,text:string}|null,share:float|null,rank:float,count:int}>
+	 * @return array<int, array{id:string,tier:int,title:string,why:string,link:array{href:string,text:string}|null,share:float|null,store:bool,rank:float,count:int}>
 	 */
 	private function fix_first_items( array $checks, array $report ): array {
 		$required = array();
@@ -680,6 +680,7 @@ class ReadinessCheckPage implements RegisterHooksInterface {
 				'why'   => $copy['text'],
 				'link'  => self::fix_link( $copy['url'], $copy['link'] ?? '' ),
 				'share' => null,
+				'store' => true,
 				// A store-wide issue affects every product, so it ranks as all sales.
 				'rank'  => 1.0,
 				'count' => PHP_INT_MAX,
@@ -707,6 +708,7 @@ class ReadinessCheckPage implements RegisterHooksInterface {
 				'why'   => $issue['why'],
 				'link'  => self::products_link( $count, (string) ( $check['id'] ?? '' ), $linked ),
 				'share' => $share,
+				'store' => false,
 				'rank'  => $rank,
 				'count' => 0.0 < $rank ? $count : $count * max( 1, $apps ),
 			);
@@ -719,12 +721,12 @@ class ReadinessCheckPage implements RegisterHooksInterface {

 	/**
 	 * The Fix first card: items under a heading for what each group of issues stops, with a line on
-	 * how it is ranked. A product issue's line starts with its share of sales. With nothing to fix,
+	 * how it is ranked. Each issue says in bold what it affects. With nothing to fix,
 	 * there is no card, as in the design.
 	 *
 	 * @param array<int, array{id:string,ok:bool|null,blocks:string,group?:string,level:string,name:string,label?:string,why:string,fix:string,fix_url:string,conflict?:bool,pending?:bool,seen_at?:string}> $checks Store checks shown on the page.
 	 * @param array<string, mixed>                                                                                                                                                                           $report Stored report.
-	 * @return array{title:string,ranking:string,link:array{href:string,text:string}|null,items:array<int, array{id:string,tier:string,badge:array{intent:string,text:string}|null,title:string,why:string,link:array{href:string,text:string}|null}>}|null
+	 * @return array{title:string,ranking:string,link:array{href:string,text:string}|null,items:array<int, array{id:string,tier:string,badge:array{intent:string,text:string}|null,title:string,impact:string|null,why:string,link:array{href:string,text:string}|null}>}|null
 	 */
 	private function fix_first( array $checks, array $report ): ?array {
 		$items = $this->fix_first_items( $checks, $report );
@@ -736,24 +738,19 @@ class ReadinessCheckPage implements RegisterHooksInterface {
 			2 => __( 'Needed to list products', 'woocommerce' ),
 			3 => __( 'Helps shoppers find products', 'woocommerce' ),
 		);
-		$days  = (int) ( is_array( $report['sales'] ?? null ) ? ( $report['sales']['days'] ?? 0 ) : 0 );
-		$first = true;
-		$list  = array();
+		// Store-wide issues say so only when the card compares sales; the ranking line gives the period.
+		$by_sales = array() !== array_filter( $items, static fn( array $item ): bool => ( $item['share'] ?? 0.0 ) > 0.0 );
+		$list     = array();
 		foreach ( $items as $item ) {
-			$why = $item['why'];
-			if ( null !== $item['share'] ) {
-				// The first share says over which period; the rest only give the share.
-				$why   = trim( self::sales_text( $item['share'], $first ? $days : 0 ) . ' ' . $why );
-				$first = false;
-			}
 			$list[] = array(
-				'id'    => $item['id'],
-				'tier'  => $tiers[ $item['tier'] ],
+				'id'     => $item['id'],
+				'tier'   => $tiers[ $item['tier'] ],
 				// The same Required badge as the AI shopping Setup checklist, so this tier stands out.
-				'badge' => 0 === $item['tier'] ? self::badge_data( self::required_badge() ) : null,
-				'title' => $item['title'],
-				'why'   => $why,
-				'link'  => $item['link'],
+				'badge'  => 0 === $item['tier'] ? self::badge_data( self::required_badge() ) : null,
+				'title'  => $item['title'],
+				'impact' => null !== $item['share'] ? self::sales_impact( $item['share'] ) : ( $by_sales && $item['store'] && 0 !== $item['tier'] ? __( 'Affects your whole store.', 'woocommerce' ) : null ),
+				'why'    => $item['why'],
+				'link'   => $item['link'],
 			);
 		}
 		return array(
@@ -802,36 +799,19 @@ class ReadinessCheckPage implements RegisterHooksInterface {
 	}

 	/**
-	 * "18% of your sales in the last 90 days.", or "18% of your sales." without the period.
+	 * What a product issue costs in sales, shown in bold before its line: "Affects 18% of your sales.".
 	 *
 	 * @param float $share Share of sales, from 0 to 1.
-	 * @param int   $days  Days the share covers, or 0 to leave the period out.
 	 */
-	private static function sales_text( float $share, int $days ): string {
+	private static function sales_impact( float $share ): string {
 		if ( 0.0 === $share ) {
-			/* translators: %d: number of days. */
-			return $days > 0 ? sprintf( __( 'No sales in the last %d days.', 'woocommerce' ), $days ) : __( 'No sales.', 'woocommerce' );
-		}
-		if ( $days > 0 ) {
-			/* translators: 1: share of sales, such as 18%, 2: number of days. */
-			return sprintf( __( '%1$s of your sales in the last %2$d days.', 'woocommerce' ), self::percent( $share ), $days );
+			return __( 'These products had no recent sales.', 'woocommerce' );
 		}
-		/* translators: %s: share of sales, such as 18%. */
-		return sprintf( __( '%s of your sales.', 'woocommerce' ), self::percent( $share ) );
-	}
-
-
-	/**
-	 * A share as a whole percentage; under 1% but above none reads "under 1%".
-	 *
-	 * @param float $share Share from 0 to 1.
-	 */
-	private static function percent( float $share ): string {
-		if ( $share > 0 && $share < 0.005 ) {
-			return __( 'under 1%', 'woocommerce' );
+		if ( $share < 0.005 ) {
+			return __( 'Affects less than 1% of your sales.', 'woocommerce' );
 		}
-		/* translators: %s: a whole number percentage. */
-		return sprintf( __( '%s%%', 'woocommerce' ), number_format_i18n( (int) round( $share * 100 ) ) );
+		/* translators: %s: a whole number, such as 18. */
+		return sprintf( __( 'Affects %s%% of your sales.', 'woocommerce' ), number_format_i18n( (int) round( $share * 100 ) ) );
 	}

 	/**
@@ -913,23 +893,49 @@ class ReadinessCheckPage implements RegisterHooksInterface {

 	/**
 	 * Protocols and files the store serves to agents, as information, never pass or fail: how many were
-	 * found, then every item. Null with no items in the report.
+	 * found, then every item under where it lives. Items the scan couldn't read are under Not checked yet.
+	 * Null with no items in the report.
 	 *
 	 * @param array $items Items from the report.
-	 * @return array{title:string,badge:array{intent:string,text:string},text:string,items:array<int, array{name:string,found:bool}>}|null
+	 * @return array{title:string,badge:array{intent:string,text:string},text:string,groups:array<int, array{title:string,items:array<int, array{name:string,found:bool|null}>}>}|null
 	 */
 	private static function declared( array $items ): ?array {
 		$items = array_values( array_filter( $items, 'is_array' ) );
 		if ( array() === $items ) {
 			return null;
 		}
-		$found = array_filter( $items, static fn( array $item ): bool => true === ( $item['found'] ?? null ) );
-		$text  = sprintf(
-			/* translators: %s: how many items were found, such as "Found 4 of 33". */
-			__( 'Optional files that some AI assistants look for. You don’t need to fix anything. %s.', 'woocommerce' ),
-			/* translators: 1: number of items found, 2: number of items looked for. */
-			sprintf( __( 'Found %1$s of %2$s', 'woocommerce' ), number_format_i18n( count( $found ) ), number_format_i18n( count( $items ) ) )
+		$titles = array(
+			'root'    => __( 'Files in your root folder', 'woocommerce' ),
+			'address' => __( 'Files at standard addresses', 'woocommerce' ),
+			'code'    => __( 'In your page code', 'woocommerce' ),
+			'extra'   => __( 'Extra details for AI assistants', 'woocommerce' ),
+			'unknown' => __( 'Not checked yet', 'woocommerce' ),
 		);
+		$groups = array_fill_keys( array_keys( $titles ), array() );
+		foreach ( $items as $item ) {
+			$found              = $item['found'] ?? null;
+			$group              = null === $found ? 'unknown' : DeclaredToAgents::group( (string) ( $item['id'] ?? '' ) );
+			$groups[ $group ][] = array(
+				'name'  => (string) ( $item['name'] ?? '' ),
+				'found' => null === $found ? null : true === $found,
+			);
+		}
+		$found   = count( array_filter( $items, static fn( array $item ): bool => true === ( $item['found'] ?? null ) ) );
+		$checked = count( $items ) - count( $groups['unknown'] );
+		// The count covers the items the scan could read, so a store in coming soon mode isn't told it shares none.
+		$text = 0 === $checked
+			? __( 'These are other files and code that some AI assistants use to learn about your store. None are required, so there’s nothing to fix.', 'woocommerce' )
+			: sprintf(
+				/* translators: 1: number of items found, 2: number of items checked. */
+				_n(
+					'These are other files and code that some AI assistants use to learn about your store. Your store shares %1$s of %2$s. None are required, so there’s nothing to fix.',
+					'These are other files and code that some AI assistants use to learn about your store. Your store shares %1$s of these %2$s. None are required, so there’s nothing to fix.',
+					$checked,
+					'woocommerce'
+				),
+				number_format_i18n( $found ),
+				number_format_i18n( $checked )
+			);
 		// Served llms.txt caches guidance for a few minutes for anonymous requests, so a fresh
 		// policy/MCP/UCP change can briefly look missing until that cache expires.
 		foreach ( $items as $item ) {
@@ -939,15 +945,20 @@ class ReadinessCheckPage implements RegisterHooksInterface {
 			}
 		}
 		return array(
-			'title' => __( 'What does your store share with AI assistants?', 'woocommerce' ),
-			'badge' => self::badge_data( array( 'off', __( 'Optional', 'woocommerce' ) ) ),
-			'text'  => $text,
-			'items' => array_map(
-				static fn( array $item ): array => array(
-					'name'  => (string) ( $item['name'] ?? '' ),
-					'found' => true === ( $item['found'] ?? null ),
-				),
-				$items
+			'title'  => __( 'What does your store share with AI assistants?', 'woocommerce' ),
+			'badge'  => self::badge_data( array( 'off', __( 'Optional', 'woocommerce' ) ) ),
+			'text'   => $text,
+			'groups' => array_values(
+				array_filter(
+					array_map(
+						static fn( string $key ): array => array(
+							'title' => $titles[ $key ],
+							'items' => $groups[ $key ],
+						),
+						array_keys( $titles )
+					),
+					static fn( array $group ): bool => array() !== $group['items']
+				)
 			),
 		);
 	}
diff --git a/plugins/woocommerce/src/Internal/AgentReadiness/ReadinessCopy.php b/plugins/woocommerce/src/Internal/AgentReadiness/ReadinessCopy.php
index 5b4804f5ea6..2358729167f 100644
--- a/plugins/woocommerce/src/Internal/AgentReadiness/ReadinessCopy.php
+++ b/plugins/woocommerce/src/Internal/AgentReadiness/ReadinessCopy.php
@@ -27,6 +27,28 @@ final class ReadinessCopy {
 	public const NAMED_MAX = 3;


+	/**
+	 * The preview details found line for the page that lacks them: the home page, a product page, or both.
+	 *
+	 * @param string $missing 'home', 'product' or 'both' (StoreOutputChecks::open_graph_missing()).
+	 * @param string $product Name of the product whose page failed, or '' when unknown.
+	 */
+	private static function open_graph_found( string $missing, string $product ): string {
+		if ( 'home' === $missing ) {
+			return __( 'Your home page doesn’t have preview details, which AI assistants use to show it as a card.', 'woocommerce' );
+		}
+		if ( 'both' === $missing ) {
+			return '' === $product
+				? __( 'Your home page and a product page don’t have preview details, which AI assistants use to show them as cards.', 'woocommerce' )
+				/* translators: %s: product name. */
+				: sprintf( __( 'Your home page and the %s page don’t have preview details, which AI assistants use to show them as cards.', 'woocommerce' ), $product );
+		}
+		return '' === $product
+			? __( 'A product page doesn’t have preview details, which AI assistants use to show it as a card.', 'woocommerce' )
+			/* translators: %s: product name. */
+			: sprintf( __( 'The %s page doesn’t have preview details, which AI assistants use to show it as a card.', 'woocommerce' ), $product );
+	}
+
 	/**
 	 * The found line of a page check that names the product whose page failed, with %s for its name. Null for a check without one.
 	 *
@@ -101,6 +123,9 @@ final class ReadinessCopy {
 			/* translators: %s: store name. */
 			$check[4] = sprintf( __( 'Make # %s the first line of the file. Do this in your SEO plugin’s llms.txt settings, or in the llms.txt file in your site’s root folder.', 'woocommerce' ), $store_name );
 		}
+		if ( 'open_graph_tags' === $id && '' !== $source ) {
+			$check[3] = self::open_graph_found( $source, $product );
+		}
 		if ( 'llms_txt_links_resolve' === $id ) {
 			if ( '' !== $link ) {
 				/* translators: %s: the broken link without https://, such as example.com/old-sale. */
@@ -221,7 +246,8 @@ final class ReadinessCopy {
 				return self::product(
 					/* translators: %s: names of up to three products, such as "Blue hoodie and Red cap", or number of products. */
 					self::title( $count, $names, _n( 'Add a description to %s', 'Add a description to %s', $count, 'woocommerce' ), __( 'Add a description to a product', 'woocommerce' ), sprintf( _n( 'Add a description to %s product', 'Add a description to %s products', $count, 'woocommerce' ), $n ) ),
-					__( 'AI shopping apps use the description to explain a product to shoppers.', 'woocommerce' )
+					__( 'AI shopping apps use the description to explain a product to shoppers.', 'woocommerce' ),
+					_n( 'Add a main or short description to your product.', 'Add a main or short description to your products.', $count, 'woocommerce' )
 				);
 			case 'uncategorised':
 				return self::product(
@@ -372,7 +398,7 @@ final class ReadinessCopy {
 				__( 'Add preview details to your pages', 'woocommerce' ),
 				__( 'These details, also called Open Graph tags, let AI assistants show your pages as a card with a title and image.', 'woocommerce' ),
 				__( 'Some pages don’t have preview details. AI assistants use these to show a page as a card with a title and image.', 'woocommerce' ),
-				__( 'Most SEO plugins can add them in their social or sharing settings, where they’re often called Open Graph tags.', 'woocommerce' ),
+				__( 'Most SEO plugins can add them, often as Open Graph tags in their social settings.', 'woocommerce' ),
 			),
 			'open_graph_from_core'           => array(
 				__( 'Product pages keep WooCommerce’s preview details', 'woocommerce' ),
diff --git a/plugins/woocommerce/src/Internal/AgentReadiness/StoreOutputChecks.php b/plugins/woocommerce/src/Internal/AgentReadiness/StoreOutputChecks.php
index 24231beb336..20bd7e4de8b 100644
--- a/plugins/woocommerce/src/Internal/AgentReadiness/StoreOutputChecks.php
+++ b/plugins/woocommerce/src/Internal/AgentReadiness/StoreOutputChecks.php
@@ -107,6 +107,11 @@ class StoreOutputChecks {
 			if ( 'llms_txt_present' === $check['id'] ) {
 				$source = $this->llms_txt_source( $responses, $ok );
 			}
+			if ( 'open_graph_tags' === $check['id'] && false === $ok ) {
+				// Which page lacks the tags picks the found line: home, product or both. A failing product page is named.
+				$source = self::open_graph_missing( $responses );
+				$failed = 'home' === $source ? null : $responses->product();
+			}
 			$seen_at = $conflict ? self::seen_at( (string) ( $check['seen_at'] ?? '' ), $responses ) : '';
 			if ( 'llms_txt_links_resolve' === $check['id'] && false === $ok ) {
 				// Where the file comes from picks the fix, and the broken link is named.
@@ -137,6 +142,22 @@ class StoreOutputChecks {
 		return $results;
 	}

+	/**
+	 * Which page the Open Graph check failed on: 'home', 'product' or 'both'. The product page is the
+	 * one in focus, the sample's first that failed.
+	 *
+	 * @param StoreResponses $responses Store responses.
+	 */
+	private static function open_graph_missing( StoreResponses $responses ): string {
+		$missing = static fn( ?array $page ): bool => null !== $page && ! ( self::has_open_graph( $page['body'], 'og:title' ) && self::has_open_graph( $page['body'], 'og:image' ) );
+		$home    = $missing( $responses->home_page() );
+		$product = $missing( $responses->product_page() );
+		if ( $home && $product ) {
+			return 'both';
+		}
+		return $home ? 'home' : 'product';
+	}
+
 	/**
 	 * Run a check on each product page of the sample, up to the first one that fails. A check that
 	 * doesn't read a product page runs once. Passes when a page passed and none failed, null when
diff --git a/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/AgenticCommerceSettingsTest.php b/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/AgenticCommerceSettingsTest.php
index 00ca9f6b3d0..ec8bc81e294 100644
--- a/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/AgenticCommerceSettingsTest.php
+++ b/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/AgenticCommerceSettingsTest.php
@@ -802,6 +802,21 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {
 						'name'  => 'TDMRep',
 						'found' => null,
 					),
+					array(
+						'id'    => 'api-catalog',
+						'name'  => 'API catalog',
+						'found' => false,
+					),
+					array(
+						'id'    => 'sameas-links',
+						'name'  => 'sameAs links',
+						'found' => false,
+					),
+					array(
+						'id'    => 'markdown-pages',
+						'name'  => 'Markdown pages',
+						'found' => false,
+					),
 				),
 			)
 		);
@@ -809,26 +824,22 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {
 		$view = $this->view();

 		$this->assertSame( 'What does your store share with AI assistants?', $view['declared']['title'] );
-		$this->assertSame( 'Optional files that some AI assistants look for. You don’t need to fix anything. Found 1 of 3.', $view['declared']['text'] );
+		$this->assertSame( 'These are other files and code that some AI assistants use to learn about your store. Your store shares 1 of these 5. None are required, so there’s nothing to fix.', $view['declared']['text'] );
 		$this->assertSame( 'Optional', $view['declared']['badge']['text'] );
 		$this->assertSame(
 			array(
-				array(
-					'name'  => 'ai.txt usage file',
-					'found' => true,
-				),
-				array(
-					'name'  => 'AGENTS.md',
-					'found' => false,
-				),
-				array(
-					'name'  => 'TDMRep',
-					'found' => false,
-				),
+				'Files in your root folder'       => array( 'ai.txt usage file', 'AGENTS.md' ),
+				'Files at standard addresses'     => array( 'API catalog' ),
+				'In your page code'               => array( 'sameAs links' ),
+				'Extra details for AI assistants' => array( 'Markdown pages' ),
+				'Not checked yet'                 => array( 'TDMRep' ),
 			),
-			$view['declared']['items'],
-			'Every item, found or not'
+			array_column( array_map( static fn( array $group ): array => array( $group['title'], array_column( $group['items'], 'name' ) ), $view['declared']['groups'] ), 1, 0 ),
+			'Every item, found or not, under where it lives; an item the scan couldn\'t read is under Not checked yet'
 		);
+		$groups = array_column( $view['declared']['groups'], 'items', 'title' );
+		$this->assertSame( array( true, false ), array_column( $groups['Files in your root folder'], 'found' ) );
+		$this->assertNull( $groups['Not checked yet'][0]['found'], 'Not checked is neither found nor missing' );

 		$report             = get_option( 'woocommerce_agent_readiness_report' );
 		$report['declared'] = array(
@@ -874,7 +885,23 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {
 			)
 		);

-		$this->assertStringContainsString( 'You don’t need to fix anything. Found 0 of 1.', $this->view()['declared']['text'] );
+		$this->assertStringContainsString( 'Your store shares 0 of 1.', $this->view()['declared']['text'] );
+
+		update_option(
+			'woocommerce_agent_readiness_report',
+			array(
+				'generated_at' => gmdate( 'c' ),
+				'store_checks' => array(),
+				'declared'     => array(
+					array(
+						'id'    => 'ai-txt',
+						'name'  => 'ai.txt usage file',
+						'found' => null,
+					),
+				),
+			)
+		);
+		$this->assertStringNotContainsString( 'shares', $this->view()['declared']['text'], 'With nothing checked, as in coming soon mode, there is no count' );

 		update_option(
 			'woocommerce_agent_readiness_report',
@@ -925,14 +952,14 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {

 		$fix_first = $this->view()['fix_first'];
 		$this->assertSame( array( 'missing_images', 'missing_brand' ), array_column( $fix_first['items'], 'id' ), 'An issue whose count changed since the check keeps the rank its sales gave it' );
-		$this->assertStringNotContainsString( 'of your sales', $fix_first['items'][0]['why'], 'Its share is not shown, since it was measured on other products' );
-		$this->assertStringStartsWith( '1% of your sales in the last 90 days.', $fix_first['items'][1]['why'], 'The first share shown says the period' );
+		$this->assertNull( $fix_first['items'][0]['impact'], 'Its share is not shown, since it was measured on other products' );
+		$this->assertSame( 'Affects 1% of your sales.', $fix_first['items'][1]['impact'] );

 		$report['checks'][0]['sales_share'] = 0.0;
 		update_option( AgentReadiness::REPORT_OPTION, $report );
 		$fix_first = $this->view()['fix_first'];
 		$this->assertSame( 'Ranked by how many products and AI apps each issue affects.', $fix_first['ranking'], 'No issue on the card sold anything, so sales did not decide the order' );
-		$this->assertStringStartsWith( 'No sales in the last 90 days.', $fix_first['items'][1]['why'] );
+		$this->assertSame( 'These products had no recent sales.', $fix_first['items'][1]['impact'] );
 	}

 	/**
@@ -1035,9 +1062,10 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {
 		);
 		$this->assertSame( array( 'Required for AI shopping', 'Needed to list products', 'Needed to list products', 'Helps shoppers find products' ), array_column( $fix_first['items'], 'tier' ) );
 		$this->assertSame( array( 'Required', null, null, null ), array_map( static fn( array $item ): ?string => $item['badge']['text'] ?? null, $fix_first['items'] ), 'Only the Required heading has a badge' );
-		$this->assertArrayNotHasKey( 'impact', $fix_first['items'][1], 'The share of sales is in the line, so no badge repeats it' );
-		$this->assertSame( '18% of your sales in the last 90 days. AI shopping apps need a main image to list a product.', $fix_first['items'][1]['why'], 'The first share says over which period, then why the issue matters' );
-		$this->assertSame( '5% of your sales. ChatGPT only lists products that have a brand. In Google and Copilot, a brand makes products easier to find.', $fix_first['items'][2]['why'], 'The next ones give only the share' );
+		$this->assertSame( 'Affects 18% of your sales.', $fix_first['items'][1]['impact'], 'What the issue affects is shown in bold before its line' );
+		$this->assertSame( 'AI shopping apps need a main image to list a product.', $fix_first['items'][1]['why'], 'The line is why the issue matters; the ranking line gives the period' );
+		$this->assertSame( 'Affects 5% of your sales.', $fix_first['items'][2]['impact'] );
+		$this->assertNull( $fix_first['items'][0]['impact'], 'A Required step has its badge instead' );
 		$this->assertNotEmpty( $fix_first['items'][0]['link']['text'] ?? '', 'A setup step links to where to fix it' );
 		$this->assertSame(
 			array(
@@ -1051,13 +1079,13 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {
 		$report['checks'][1]['sales_share'] = 0.0;
 		update_option( AgentReadiness::REPORT_OPTION, $report );
 		$json = wp_json_encode( $this->view() );
-		$this->assertStringContainsString( 'No sales. ChatGPT only lists products that have a brand.', $json, 'Products that sold nothing in the period say so, not 0%' );
+		$this->assertStringContainsString( '"impact":"These products had no recent sales."', $json, 'Products that sold nothing in the period say so, not 0%' );
 		$this->assertStringNotContainsString( '"0% of', $json );
 		$report['checks'][1]['sales_share'] = 0.003;
 		update_option( AgentReadiness::REPORT_OPTION, $report );
 		$view = $this->view();
-		$this->assertStringContainsString( 'under 1% of your sales', wp_json_encode( $view['fix_first'] ), 'A share under 1% is not rounded to 0%' );
-		$this->assertStringNotContainsString( 'under 1%', wp_json_encode( $view['sections'] ), 'Shares are in Fix first only, not on the product card' );
+		$this->assertStringContainsString( 'Affects less than 1% of your sales.', wp_json_encode( $view['fix_first'] ), 'A share under 1% is not rounded to 0%' );
+		$this->assertStringNotContainsString( 'less than 1%', wp_json_encode( $view['sections'] ), 'Shares are in Fix first only, not on the product card' );

 		$report['sales'] = null;
 		foreach ( $report['checks'] as &$row ) {
@@ -1070,6 +1098,7 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {
 		$this->assertSame( 'Turn on Analytics to see which fixes affect the most sales.', $fix_first['link']['text'] );
 		$this->assertStringContainsString( 'tab=advanced&section=features', $fix_first['link']['href'], 'The link opens the Features settings, where Analytics is turned on' );
 		$this->assertStringNotContainsString( 'of your sales', wp_json_encode( $fix_first ) );
+		$this->assertStringNotContainsString( 'whole store', wp_json_encode( $fix_first ), 'Without sales to compare, store-wide issues don\'t say so' );

 		$report['sales'] = array(
 			'days'   => 90,
@@ -1279,7 +1308,16 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {

 		$items = $this->view()['fix_first']['items'];
 		$this->assertSame( 'store_wide label', $items[0]['title'], 'It keeps every product off, so it ranks as all sales' );
-		$this->assertStringStartsWith( '90% of your sales', $items[1]['why'], 'The product issue below it gives its share in the line' );
+		$this->assertSame( 'Affects 90% of your sales.', $items[1]['impact'], 'The product issue below it gives its share' );
+		$this->assertSame( 'Needed to list products', $items[0]['tier'] );
+		$this->assertSame( 'Affects your whole store.', $items[0]['impact'], 'A store-wide issue outside Required says it affects the whole store' );
+
+		$report                             = get_option( AgentReadiness::REPORT_OPTION );
+		$report['checks'][0]['sales_share'] = 0.0;
+		update_option( AgentReadiness::REPORT_OPTION, $report );
+		$fix_first = $this->view()['fix_first'];
+		$this->assertSame( 'Ranked by how many products and AI apps each issue affects.', $fix_first['ranking'], 'No product issue sold anything' );
+		$this->assertNull( $fix_first['items'][0]['impact'], 'so the card does not compare sales, and the store-wide issue says nothing about them' );
 	}

 	/**
@@ -1437,14 +1475,14 @@ class AgenticCommerceSettingsTest extends WC_Unit_Test_Case {
 		$stored['truncated'] = true;
 		update_option( AgentReadiness::REPORT_OPTION, $stored );
 		$this->assertSame(
-			sprintf( 'Checked the %s products you changed most recently.', number_format_i18n( ProductScan::PRODUCT_LIMIT ) ),
+			sprintf( 'Product checks covered the %s products you updated most recently. Store conditions covered your whole store. Product details, and some Search and discovery checks, still sample product pages.', number_format_i18n( ProductScan::PRODUCT_LIMIT ) ),
 			$this->view()['checked_note'],
 			'A report without the total keeps the short note'
 		);
 		$stored['available'] = 8400;
 		update_option( AgentReadiness::REPORT_OPTION, $stored );
 		$this->assertSame(
-			sprintf( 'Checked the %s products you changed most recently, out of 8,400.', number_format_i18n( ProductScan::PRODUCT_LIMIT ) ),
+			sprintf( 'Product checks covered the %s products you updated most recently, out of 8,400. Store conditions covered your whole store. Product details, and some Search and discovery checks, still sample product pages.', number_format_i18n( ProductScan::PRODUCT_LIMIT ) ),
 			$this->view()['checked_note'],
 			'With the total from the same scan'
 		);
diff --git a/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/ReadinessCopyTest.php b/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/ReadinessCopyTest.php
index 9944a35d53a..a0fe456b899 100644
--- a/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/ReadinessCopyTest.php
+++ b/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/ReadinessCopyTest.php
@@ -124,6 +124,27 @@ class ReadinessCopyTest extends WC_Unit_Test_Case {
 		$this->assertSame( '', ReadinessCopy::product_check( 'missing_brand', 1 )['fix'] ?? '' );
 	}

+	/**
+	 * @testdox The preview details found line names the page without them: the home page, a product page, or both, with the product's name when known.
+	 */
+	public function test_open_graph_found_names_the_page(): void {
+		$found = static fn( string $source, string $product = '' ): string => ReadinessCopy::store_check( 'open_graph_tags', $source, $product )['found'];
+		$this->assertSame( 'Your home page doesn’t have preview details, which AI assistants use to show it as a card.', $found( 'home' ) );
+		$this->assertSame( 'The Blue hoodie page doesn’t have preview details, which AI assistants use to show it as a card.', $found( 'product', 'Blue hoodie' ) );
+		$this->assertSame( 'A product page doesn’t have preview details, which AI assistants use to show it as a card.', $found( 'product' ) );
+		$this->assertSame( 'Your home page and the Blue hoodie page don’t have preview details, which AI assistants use to show them as cards.', $found( 'both', 'Blue hoodie' ) );
+		$this->assertStringStartsWith( 'Some pages don’t have preview details.', $found( '' ), 'An older report without the page keeps the general line' );
+		$this->assertSame( 'Most SEO plugins can add them, often as Open Graph tags in their social settings.', ReadinessCopy::store_check( 'open_graph_tags', 'home' )['fix'] );
+	}
+
+	/**
+	 * @testdox The description fix line matches the number of products.
+	 */
+	public function test_description_fix_line(): void {
+		$this->assertSame( 'Add a main or short description to your product.', ReadinessCopy::product_check( 'missing_product_text', 1 )['fix'] );
+		$this->assertSame( 'Add a main or short description to your products.', ReadinessCopy::product_check( 'missing_product_text', 4 )['fix'] );
+	}
+
 	/**
 	 * @testdox The image size line names Google, the only AI app with the rule, and no date: rules.json moves it to can't be listed when the rule starts.
 	 */
diff --git a/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/ServedOutputChecksTest.php b/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/ServedOutputChecksTest.php
index be1b8b39a7a..08e62e8f8d6 100644
--- a/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/ServedOutputChecksTest.php
+++ b/plugins/woocommerce/tests/php/src/Internal/AgentReadiness/ServedOutputChecksTest.php
@@ -180,6 +180,27 @@ class ServedOutputChecksTest extends WC_Unit_Test_Case {
 		);
 	}

+	/**
+	 * @testdox A failing Open Graph check records which page lacks the tags: the home page, the product page, which it names, or both.
+	 */
+	public function test_open_graph_names_the_page_without_tags(): void {
+		$store = $this->good_store();
+		$cases = array(
+			'home'    => array( self::page( '', '', false ), $store[ $this->product_path() ][1] ),
+			'product' => array( $store['/'][1], self::page( '', '', false ) ),
+			'both'    => array( self::page( '', '', false ), self::page( '', '', false ) ),
+		);
+		foreach ( $cases as $source => $pages ) {
+			$store['/']                     = array( 200, $pages[0] );
+			$store[ $this->product_path() ] = array( 200, $pages[1] );
+			$this->serve( $store );
+			$check = array_column( $this->sut->all(), null, 'id' )['open_graph_tags'];
+			$this->assertFalse( $check['ok'], $source );
+			$this->assertSame( $source, $check['source'], $source );
+			$this->assertSame( 'home' === $source ? 0 : $this->product->get_id(), $check['product'], 'The product is named when its page lacks the tags: ' . $source );
+		}
+	}
+
 	/**
 	 * @testdox llms.txt without a heading fails the format check; a broken store link fails, an unreachable or blocked one is couldn't check, and a blocked llms.txt is too.
 	 */