@amityco/social-plus-vise 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to `@amityco/social-plus-vise` are documented in this file.
 
 The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 1.6.0 — 2026-07-06
+
+### Added
+- **Reactivity rules for the latest SDK features.** Three new live-collection rules guard features added in the recent SDK release: in-chat **message search** (`message-search.live-collection`, all platforms), **archived channels** (`channel-archive.live-collection`, all platforms), and the personalized **For-You feed** (`for-you-feed.live-collection`, TypeScript/React Native/Android/iOS). Each flags a results list rendered from a one-shot query instead of the reactive, paginated Live Collection, and stays silent on a correct reactive integration. For-You is not part of the Flutter public API, so a For-You request on Flutter now surfaces a platform-availability notice pointing to a community- or user-scoped feed instead.
+
+### Changed
+- **Refreshed the bundled SDK surface facts** for TypeScript, Android, iOS, and Flutter. `vise sdk-facts` and the symbol-anchored rules now reflect the current SDK symbols and models — including channel archiving, message search, For-You feed, and per-scope notification modes. The refresh is additive: no previously grounded symbol was removed, so existing rules keep resolving.
+- **Portable provenance in `vise sdk-surface:import`.** The importer normalizes the source paths recorded in the shipped surface facts, so they stay machine-independent regardless of local checkout layout.
+
 ## 1.5.0 — 2026-07-05
 
 ### Added

package/README.md

@@ -142,65 +142,41 @@ Vise can ingest your aesthetic from an HTML/CSS prototype (`vise design extract`
 
 ## Evidence
 
-We put Vise through the same brownfield social.plus integration twice per platform — once through the **governed Vise workflow**, once from a structured checklist with **Vise switched off** (the control) — and ran the whole thing with two coding agents: first **OpenAI Codex GPT-5.4**, then **Claude Sonnet 5** on a hardened protocol. Vise led on all five platform families with both agents. But the two headline gaps are **not** equally solid, and **neither raw average is the number to stand behind**.
+We put Vise through the same brownfield social.plus integration twice per platform — once through the **governed Vise workflow**, once from a structured checklist with **Vise switched off** (the control) — across five platform families, on a live tenant with no mocking. The precise, uniform benchmark is **Claude Sonnet 5**; we cross-checked the direction with a second agent, **OpenAI Codex GPT-5.4**. Read the direction, not the decimals.
 
-> **Three different numbers appear below. They measure different things:**
-> - **+29.1** — Sonnet 5 *full weighted composite*. Includes the +90 definitional capability axis, so it is **not** the earned lift.
-> - **+12.1** — Sonnet 5 *credible-only* (capability axis removed, four fair dimensions re-weighted to 100%). **This is the number we stand behind.**
-> - **+23 to +31** — cross-model convergence deltas. **Still raw composites** (capability-inflated). They prove the lift points the **same direction** across agents — not its magnitude.
+### Anchor: Claude Sonnet 5, per platform
 
-> All deltas are computed on **unrounded** composites, so hand-subtracting the rounded scores in a table can differ by 0.1 (e.g. 83.0 − 70.8 reads as ~12.2, but the exact delta is +12.1).
+Composite score, 0–100 shared scale; every control built and launched.
 
-### Per-platform head-to-head
+| Platform | Fixture | Vise | no-Vise | Δ |
+|---|---|--:|--:|--:|
+| Web | PULSE / pulse-studio | 88.3 | 56.8 | **+31.5** |
+| React Native | Arena Fit | 89.7 | 62.1 | **+27.6** |
+| iOS | Luminary Club | 77.5 | 48.0 | **+29.5** |
+| Android | MarketPulse | 77.5 | 50.1 | **+27.4** |
+| Flutter | Fieldhouse | 78.0 | 48.5 | **+29.5** |
+| **Average** | 5 fixtures | **82.2** | **53.1** | **+29.1** |
 
-Composite score, 0–100 shared scale. Failed Codex controls (watchdog-killed before launch) are marked; those cells deflate the Codex control and inflate its gap.
-
-| Platform | Fixture | Sonnet 5 Vise | Sonnet 5 no-Vise | Sonnet Δ | Codex Vise | Codex no-Vise | Codex Δ |
-|---|---|--:|--:|--:|--:|--:|--:|
-| Web | PULSE / pulse-studio | 88.3 | 56.8 | **+31.5** | 91.4 | 65.6 | **+25.8** |
-| React Native | Arena Fit | 89.7 | 62.1 | **+27.6** | 90.3 | 67.3 | **+23.0** |
-| iOS | Luminary Club | 77.5 | 48.0 | +29.5 | 90.1 | 43.0 ⚠︎ | +47.1 ⚠︎ |
-| Android | MarketPulse / market-pulse | 77.5 | 50.1 | +27.4 | 94.3 | 31.2 ❌ | +63.1 ❌ |
-| Flutter | Fieldhouse | 78.0 | 48.5 | +29.5 | 92.8 | 33.0 ❌ | +59.8 ❌ |
-| **Average** | 5 fixtures | **82.2** | **53.1** | **+29.1** | 91.8 | 48.0 | ~~+43.8~~ |
-
-- ❌ **Control failed before launch.** Flutter's no-Vise control deleted `lib/main.dart` and was watchdog-terminated (33.0); Android's was depressed by an instrument failure (31.2). Both deflate the control and inflate the Codex gap.
-- ⚠︎ **Control ran low but launched.** Codex iOS no-Vise reached only 43.0 — the lowest launched control in either set — on the earlier harness.
-
-### Averages: anchor on the clean run
-
-- **Claude Sonnet 5 — anchor (+29.1).** Hardened protocol; **all 5 controls built and launched**. This is the clean, conservative headline. It still carries the +90 definitional axis, so the earned lift is +12.1 credible-only.
-- **OpenAI Codex GPT-5.4 — caveated (~~+43.8~~).** Earlier, less-hardened harness; 2 of 5 controls failed before launch and iOS ran low. That larger gap is **inflated** and is not comparable to the Sonnet number.
-
-### The cross-model signal: where both controls launched, the agents agree
-
-On the only two platforms where the Codex control actually built and launched — **Web** and **React Native** — the two agents' deltas land within ~5 points of each other:
-
-- **Web:** Codex **+25.8** ≈ Sonnet 5 **+31.5** (agree within 5.7 pts)
-- **React Native:** Codex **+23.0** ≈ Sonnet 5 **+27.6** (agree within 4.6 pts)
-
-**Read these as raw composites, not the real-world lift.** Each Vise delta here still embeds the +90 definitional capability axis. So the convergence proves the lift points the **same direction** across two independent agents — it does **not** say the earned magnitude is +23–31. For the earned magnitude, use the credible-only number below. (iOS is left out of this window because the Codex iOS control ran low — the same reason its average is caveated.)
-
-### The credible-only lift: +12.1
-
-Drop the Vise-definitional capability axis (the control scores 0 there **by construction**) and re-weight the remaining four dimensions to 100%:
+That **+29.1** full composite still carries the **+90 definitional capability axis** (the control scores 0 there **by construction**). Drop it and re-weight the four fair dimensions to 100%:
 
 | | Vise | no-Vise | Δ |
 |---|--:|--:|--:|
 | Full weighted composite (incl. capability axis) | 82.2 | 53.1 | +29.1 |
-| **Credible-only composite (capability axis removed)** | **83.0** | **70.8** | **+12.1** |
+| **Credible-only (capability axis removed)** | **83.0** | **70.8** | **+12.1** |
+
+**+12.1 is the number to stand behind.** It comes from **Product outcome +17.6** and **Design integration +15.8** (the credible wins); **Runtime hygiene is a near-tie (+1.9** — build/launch cleanliness, which a capable agent clears either way; on Android the checklist control actually built cleaner — this is *not* SDK-rule compliance, see below); **Efficiency +11.7 is a scorer *budget* metric** (the governed arm is **slower** in real time, ~2.7× on web); **Capability activation +90 is definitional**, kept out of the headline. (Deltas use unrounded composites, so hand-subtracting rounded cells can differ by 0.1.)
+
+> **Why the hygiene dimension is near-parity — and why that isn't the whole story.** The scorer's `correctness` dimension measures *runtime hygiene* (build, launch, no crashes/secrets/hardcoded IDs), which strong agents clear with or without Vise. It is **not** SDK-rule compliance — the thing the 400+ deterministic rules govern. That is measured directly by a separate **compliance-findings** metric (`vise validate` on both arms' produced source): an ungoverned control carries real rule violations a smoke test never surfaces, and its runtime symptoms already show up as the product-outcome gap above.
 
-(The +12.1 is the delta of the unrounded composites; hand-subtracting the rounded 83.0 − 70.8 reads as ~12.2.)
+### Cross-check: OpenAI Codex GPT-5.4 (directional)
 
-Where the +12.1 comes from (Sonnet 5): **Product outcome +17.6** and **Design integration +15.8** are the credible wins; **Correctness is a near-tie (+1.9** — on Android the checklist control actually built cleaner); **Efficiency +11.7 is a scorer *budget* metric, not wall-clock** — the governed arm is **slower** in real time (~2.7× the control on web); **Capability activation +90 is definitional**, kept out of the headline.
+The same A/B run with Codex points the same way — **Vise ahead on every platform**. Codex's exact figures are **directional, not precise**: its no-Vise controls are high-variance — on Android a single control has read anywhere from **+63** (an unlucky, instrument-affected run on the earlier harness) down to **+27** (clean). Run cleanly on the hardened harness (Android and iOS N=3; Flutter one clean launch, the rest watchdog-blocked), Codex's controls land ~65 and its lift settles around **+25–30**, converging with Sonnet's. Honest cross-model read: **both agents show Vise winning by ~+25–30 once controls are run cleanly.** We anchor on Sonnet because it is the uniform, current-harness run; Codex is cross-model confirmation of direction.
 
 ### Methodology & caveats
 
 - **Vise is the deterministic CLI under test, not an AI model.** Each arm runs the same coding agent on the same brownfield fixture, live tenant, no mocking.
-- **Scoring weights:** capability activation 25% (definitional), product outcome 25%, design integration 20%, correctness 20%, efficiency 10%. The credible-only composite drops the capability axis and re-weights the other four to 100%.
-- **Deltas use unrounded scores.** Displayed scores are rounded to one decimal, so a hand-subtraction of two table cells can differ from the stated delta by 0.1.
-- **Two runs, protocol hardened between them.** Codex GPT-5.4 (Medium) ran late June 2026 on the first, less-hardened harness; Claude Sonnet 5 ran early July 2026 on the current hardened protocol. Because the harness changed, the two agents' controls are **not directly comparable** — which is exactly why the cross-model view is limited to the two platforms where both controls launched.
-- **n = 1 per arm, directional.** July 2026 product-evidence runs on representative fixtures — **not a third-party audit**. For a formal comparison, keep each Vise / no-Vise pair on the same model and reasoning setting.
+- **Scoring weights:** capability activation 25% (definitional), product outcome 25%, design integration 20%, runtime hygiene 20% (the scorer's `correctness` key — build/launch cleanliness, not SDK-rule compliance), efficiency 10%. A separate **compliance-findings** metric (`vise validate` on both arms) measures SDK-rule adherence directly. The credible-only composite drops the capability axis and re-weights the other four to 100%.
+- **Small-N, directional.** Controls are n = 1–3 per arm, so neither model is a precise second measurement, and the two are not directly comparable (Codex ran on an earlier harness). The runtime-signal scorer that could over-credit a rendered-but-broken shell is now gated. July 2026 product-evidence runs on representative fixtures — **not a third-party audit**. For a formal comparison, keep each Vise / no-Vise pair on the same model and reasoning setting.
 
 <sub>Cursor, Claude, Codex, GitHub Copilot, VS Code, and other product names are trademarks of their respective owners; social.plus is not affiliated with or endorsed by them.</sub>
 

package/dist/outcomes.js

@@ -63,6 +63,16 @@ export const PLATFORM_FEATURE_GAPS = [
         sdkSource: "use-cases/social/livestream/go-live-and-room-management",
         guidance: "Room-based livestreaming — broadcasting, going live, and room management (RoomRepository.createRoom / getRoom / getRooms / stopRoom) — is NOT in the social.plus Flutter SDK; it is available on the iOS, Android, and TypeScript/web SDKs. The Flutter SDK exposes only the DEPRECATED legacy Stream API (StreamRepository.getStream) for VIEWING existing stream posts — there is no Room API in Dart, so do not invent RoomRepository / createRoom. Options: (a) build the broadcast/host livestream experience on a supported platform (iOS, Android, or TypeScript/web), (b) on Flutter, render an existing legacy stream post read-only via StreamRepository.getStream(streamId) (deprecated — exposes title/status/isLive only), or (c) embed a web livestream view.",
     },
+    {
+        feature: "For-You (personalized) feed",
+        match: /\bfor[\s-]?you\b|personali[sz]ed\s+feed|curated\s+feed|recommend\w*\s+feed/i,
+        exclude: /\brecommend\w*\s+(?:communit|user|friend|people|member)\w*/i,
+        unavailableOn: ["flutter"],
+        availableOn: ["typescript", "ios", "android"],
+        objectIds: ["for-you"],
+        sdkSource: "social-plus-sdk/social/content-management/posts/retrieve/for-you-feed",
+        guidance: "The social.plus Flutter SDK does not expose the For-You (personalized) feed — getForYouFeed / getForYouFeedSetting are available on the iOS, Android, and TypeScript/web SDKs only. Do not invent a getForYouFeed in Dart. Options: (a) build the For-You surface on a supported platform (iOS, Android, or TypeScript/web), (b) on Flutter, render a community-scoped or user-scoped feed (getCommunityFeed / getUserFeed) or the global feed instead, or (c) call a server-side recommendation API from your backend and surface results through your own endpoint.",
+    },
 ];
 export function platformFeatureGapsFor(request, platform) {
     return PLATFORM_FEATURE_GAPS.filter((gap) => gap.unavailableOn.includes(platform) &&

package/dist/tools/compliance.js

@@ -2300,6 +2300,9 @@ export const FILE_SCOPABLE_SENSOR_SUFFIXES = new Set([
     "live-collection.api-mismatch",
     "story.live-collection",
     "search.live-collection",
+    "message-search.live-collection",
+    "channel-archive.live-collection",
+    "for-you-feed.live-collection",
     "notification-tray.live-collection",
     "event.live-collection",
     "blocked-users.live-collection",

package/dist/tools/project.js

@@ -472,6 +472,9 @@ async function validateAndroid(root) {
     findings.push(...validateLiveCollectionApiMismatch(root, "android", sourceContent));
     findings.push(...validateStories(root, "android", sourceContent));
     findings.push(...validateSearch(root, "android", sourceContent));
+    findings.push(...validateMessageSearch(root, "android", sourceContent));
+    findings.push(...validateChannelArchive(root, "android", sourceContent));
+    findings.push(...validateForYouFeed(root, "android", sourceContent));
     findings.push(...validateNotificationTray(root, "android", sourceContent));
     findings.push(...validateMembershipList(root, "android", sourceContent));
     findings.push(...validateEvents(root, "android", sourceContent));
@@ -601,6 +604,8 @@ async function validateFlutter(root) {
     findings.push(...validateLiveCollectionApiMismatch(root, "flutter", dartContent));
     findings.push(...validateStories(root, "flutter", dartContent));
     findings.push(...validateSearch(root, "flutter", dartContent));
+    findings.push(...validateMessageSearch(root, "flutter", dartContent));
+    findings.push(...validateChannelArchive(root, "flutter", dartContent));
     findings.push(...validateMembershipList(root, "flutter", dartContent));
     findings.push(...validateBlockedUsers(root, "flutter", dartContent));
     findings.push(...validatePollVoteStatusGuard(root, "flutter", dartContent));
@@ -732,6 +737,9 @@ async function validateTypeScript(root, platform) {
     findings.push(...validateLiveCollectionApiMismatch(root, platform, sourceContent));
     findings.push(...validateStories(root, platform, sourceContent));
     findings.push(...validateSearch(root, platform, sourceContent));
+    findings.push(...validateMessageSearch(root, platform, sourceContent));
+    findings.push(...validateChannelArchive(root, platform, sourceContent));
+    findings.push(...validateForYouFeed(root, platform, sourceContent));
     findings.push(...validateNotificationTray(root, platform, sourceContent));
     findings.push(...validateMembershipList(root, platform, sourceContent));
     findings.push(...validateEvents(root, platform, sourceContent));
@@ -1862,6 +1870,200 @@ function validateSearch(root, platform, sourceContent) {
     }
     return findings;
 }
+function validateMessageSearch(root, platform, sourceContent) {
+    const findings = [];
+    const ruleId = `${platform}.message-search.live-collection`;
+    const MESSAGE_SEARCH_QUERY_PATTERNS = [
+        /\bsearchMessages?\b/,
+        /\bAmityMessageSearchQuery\b/,
+        /\bAmityMessageSearchOptions\b/,
+        /\bSearchMessageBuilder\b/,
+        /\bSearchMessageLiveCollection\b/,
+    ];
+    const LIST_UI_PATTERNS = [
+        /\bmap\s*\(/,
+        /\bFlatList\b/,
+        /\bListView\b/,
+        /\bRecyclerView\b/,
+        /\bLazyColumn\b/,
+        /\bLazyRow\b/,
+        /\bLazyVerticalGrid\b/,
+        /\bLazyVerticalStaggeredGrid\b/,
+        /\bForEach\b/,
+        /\bList\s*\(/,
+        /\bsubmitList\b/,
+        /\btableView\b/,
+        /\bcollectionView\b/
+    ];
+    const REACTIVE_MARKERS = [
+        /\bgetLiveCollection\b/,
+        /\bobserve\b/,
+        /\bobserveOnce\b/,
+        /\blisten\b/,
+        /\bonData\b/,
+        /\bStreamBuilder\b/,
+        /\bLiveData\b/,
+        /\bMutableLiveData\b/,
+        /\bMediatorLiveData\b/,
+        /collectAsState/,
+        /observeAsState/,
+        /Amity\w*Flow\b/,
+        /\bPagingData\b/,
+        /LazyPagingItems/,
+        /collectAsLazyPagingItems/,
+        /\.on\s*\(\s*['"]data[A-Z]/,
+        /\$snapshots\b/,
+        /\bPagingController\b/,
+        /\bgetPagingData\b/,
+        /\bsearchMessages?\s*\(\s*\{[^{}]*\}\s*,\s*(?:\w+|\([^)]*\)\s*=>|function\b|async\b)/,
+        /\/\/\s*vise:\s*one-shot query/i
+    ];
+    for (const [file, content] of sourceContent) {
+        const rel = relativeFile(root, file);
+        if (path.basename(file).endsWith('.d.ts'))
+            continue;
+        const hasSearchQuery = MESSAGE_SEARCH_QUERY_PATTERNS.some((p) => p.test(content));
+        if (hasSearchQuery) {
+            const hasListUI = LIST_UI_PATTERNS.some((p) => p.test(content));
+            if (hasListUI) {
+                const reactiveSurface = commentStripped(file, platform, content);
+                const hasReactivity = /\/\/\s*vise:\s*one-shot query/i.test(content) || REACTIVE_MARKERS.some((p) => p.test(reactiveSurface));
+                if (!hasReactivity) {
+                    findings.push(finding(ruleId, "warning", `A message search (searchMessage/searchMessages) renders a list but no reactive/paginated markers (observe, the (params, callback) live form, PagingData, PagingController) were found in the same file.`, rel, "Render message-search results from the reactive, paginated Search Message LiveCollection so the list live-updates and pages. Use the live callback (TS/RN: searchMessage(params, callback)), observe the collection (iOS searchMessages(options:) + .observe / Android AmityMessageSearchQuery PagingData), or wire a PagingController with SearchMessageLiveCollection (Flutter). If a one-shot single-page search is truly intended, add comment // vise: one-shot query."));
+                }
+            }
+        }
+    }
+    return findings;
+}
+function validateChannelArchive(root, platform, sourceContent) {
+    const findings = [];
+    const ruleId = `${platform}.channel-archive.live-collection`;
+    const ARCHIVE_QUERY_PATTERNS = [
+        /\bgetArchivedChannels\b/,
+        /\bgetArchivedChannelIds\b/,
+    ];
+    const LIST_UI_PATTERNS = [
+        /\bmap\s*\(/,
+        /\bFlatList\b/,
+        /\bListView\b/,
+        /\bRecyclerView\b/,
+        /\bLazyColumn\b/,
+        /\bLazyRow\b/,
+        /\bLazyVerticalGrid\b/,
+        /\bLazyVerticalStaggeredGrid\b/,
+        /\bForEach\b/,
+        /\bList\s*\(/,
+        /\bsubmitList\b/,
+        /\btableView\b/,
+        /\bcollectionView\b/
+    ];
+    const REACTIVE_MARKERS = [
+        /\bgetLiveCollection\b/,
+        /\bobserve\b/,
+        /\bobserveOnce\b/,
+        /\blisten\b/,
+        /\bonData\b/,
+        /\bStreamBuilder\b/,
+        /\bLiveData\b/,
+        /\bMutableLiveData\b/,
+        /\bMediatorLiveData\b/,
+        /collectAsState/,
+        /observeAsState/,
+        /Amity\w*Flow\b/,
+        /\bPagingData\b/,
+        /LazyPagingItems/,
+        /collectAsLazyPagingItems/,
+        /\.on\s*\(\s*['"]data[A-Z]/,
+        /\$snapshots\b/,
+        /\bPagingController\b/,
+        /\bgetPagingData\b/,
+        /\bgetArchivedChannels\s*\(\s*\{[^{}]*\}\s*,\s*(?:\w+|\([^)]*\)\s*=>|function\b|async\b)/,
+        /\/\/\s*vise:\s*one-shot query/i
+    ];
+    for (const [file, content] of sourceContent) {
+        const rel = relativeFile(root, file);
+        if (path.basename(file).endsWith('.d.ts'))
+            continue;
+        const hasArchiveQuery = ARCHIVE_QUERY_PATTERNS.some((p) => p.test(content));
+        if (hasArchiveQuery) {
+            const hasListUI = LIST_UI_PATTERNS.some((p) => p.test(content));
+            if (hasListUI) {
+                const reactiveSurface = commentStripped(file, platform, content);
+                const hasReactivity = /\/\/\s*vise:\s*one-shot query/i.test(content) || REACTIVE_MARKERS.some((p) => p.test(reactiveSurface));
+                if (!hasReactivity) {
+                    findings.push(finding(ruleId, "warning", `An archived-channels view (getArchivedChannels / getArchivedChannelIds) renders a list but no reactive markers (observe, the (params, callback) live form, PagingData, PagingController) were found in the same file.`, rel, "Render the archived-channels view from the getArchivedChannels LiveCollection (subscribe via its callback / observe and re-render on updates, dispose on unmount) rather than a one-shot getArchivedChannelIds fetch, so the list updates as channels are archived or unarchived. If a one-shot snapshot is truly intended, add comment // vise: one-shot query."));
+                }
+            }
+        }
+    }
+    return findings;
+}
+function validateForYouFeed(root, platform, sourceContent) {
+    const findings = [];
+    if (platform === "flutter")
+        return findings;
+    const ruleId = `${platform}.for-you-feed.live-collection`;
+    const FORYOU_QUERY_PATTERNS = [
+        /\bgetForYouFeed\b/,
+    ];
+    const LIST_UI_PATTERNS = [
+        /\bmap\s*\(/,
+        /\bFlatList\b/,
+        /\bListView\b/,
+        /\bRecyclerView\b/,
+        /\bLazyColumn\b/,
+        /\bLazyRow\b/,
+        /\bLazyVerticalGrid\b/,
+        /\bLazyVerticalStaggeredGrid\b/,
+        /\bForEach\b/,
+        /\bList\s*\(/,
+        /\bsubmitList\b/,
+        /\btableView\b/,
+        /\bcollectionView\b/
+    ];
+    const REACTIVE_MARKERS = [
+        /\bgetLiveCollection\b/,
+        /\bobserve\b/,
+        /\bobserveOnce\b/,
+        /\blisten\b/,
+        /\bonData\b/,
+        /\bStreamBuilder\b/,
+        /\bLiveData\b/,
+        /\bMutableLiveData\b/,
+        /\bMediatorLiveData\b/,
+        /collectAsState/,
+        /observeAsState/,
+        /Amity\w*Flow\b/,
+        /\bPagingData\b/,
+        /LazyPagingItems/,
+        /collectAsLazyPagingItems/,
+        /\.on\s*\(\s*['"]data[A-Z]/,
+        /\$snapshots\b/,
+        /\bPagingController\b/,
+        /\bgetPagingData\b/,
+        /\bgetForYouFeed\s*\(\s*\{[^{}]*\}\s*,\s*(?:\w+|\([^)]*\)\s*=>|function\b|async\b)/,
+        /\bgetForYouFeed\s*\(\s*(?:\([^)]*\)\s*=>|\w+\s*=>|function\b|async\b)/,
+        /\/\/\s*vise:\s*one-shot query/i
+    ];
+    for (const [file, content] of sourceContent) {
+        const rel = relativeFile(root, file);
+        if (path.basename(file).endsWith('.d.ts'))
+            continue;
+        const hasForYouQuery = FORYOU_QUERY_PATTERNS.some((p) => p.test(content));
+        if (hasForYouQuery) {
+            const hasListUI = LIST_UI_PATTERNS.some((p) => p.test(content));
+            if (hasListUI) {
+                const reactiveSurface = commentStripped(file, platform, content);
+                const hasReactivity = /\/\/\s*vise:\s*one-shot query/i.test(content) || REACTIVE_MARKERS.some((p) => p.test(reactiveSurface));
+                if (!hasReactivity) {
+                    findings.push(finding(ruleId, "warning", `A For-You feed (getForYouFeed) renders a list but no reactive markers (observe, the (params, callback) live form, PagingData, PagingController) were found in the same file.`, rel, "Query the personalized feed via getForYouFeed and OBSERVE it as a live collection (subscribe / .observe / PagingData — never a one-shot fetch-and-map), so the feed updates as ranking and freshness change. Gate on getForYouFeedSetting and, when disabled, fall back to the global feed rather than rendering empty. If a one-shot snapshot is truly intended, add comment // vise: one-shot query."));
+                }
+            }
+        }
+    }
+    return findings;
+}
 function validateNotificationTray(root, platform, sourceContent) {
     const findings = [];
     const ruleId = `${platform}.notification-tray.live-collection`;
@@ -3162,6 +3364,9 @@ async function validateIos(root) {
     findings.push(...validateLiveCollectionApiMismatch(root, "ios", swiftContent));
     findings.push(...validateStories(root, "ios", swiftContent));
     findings.push(...validateSearch(root, "ios", swiftContent));
+    findings.push(...validateMessageSearch(root, "ios", swiftContent));
+    findings.push(...validateChannelArchive(root, "ios", swiftContent));
+    findings.push(...validateForYouFeed(root, "ios", swiftContent));
     findings.push(...validateNotificationTray(root, "ios", swiftContent));
     findings.push(...validateMembershipList(root, "ios", swiftContent));
     findings.push(...validateEvents(root, "ios", swiftContent));