@amityco/social-plus-vise 1.4.6 → 1.6.0

package/dist/tools/integration.js

@@ -4,7 +4,7 @@ import { BROAD_SOCIAL_REGEX, DESIGN_REGEX, getOutcomeDefinition, hasAnswer, plan
 import { objectInput, optionalStringField, stringField, textResult } from "../types.js";
 import { availableOptionalCapabilityIds, capabilityChecklist, optionalCapabilityChecklist, platformCapabilityAvailability, selectedOptionalCapabilityIds, slimCapabilityAvailability, slimCapabilityItem, } from "../capabilities.js";
 import { applicableCompliancePlanRuleSummaries } from "./compliance.js";
-import { DESIGN_CONTRACT_CONFIRMATION_ANSWER_ID, buildDesignBrief, designContractConfirmationFromAnswers, designPreviewPath, readDesignContract, readDesignProfile, buildDesignReviewLoop, } from "./design.js";
+import { DESIGN_CONTRACT_CONFIRMATION_ANSWER_ID, buildDesignBrief, designContractConfirmationFromAnswers, designPreviewPath, readDesignContract, readDesignProfile, readDesignProfileDiagnostic, buildDesignReviewLoop, } from "./design.js";
 import { sdkVersionGuidance } from "./sdkVersion.js";
 import { detectCommandSensors } from "./harness.js";
 import { inspectProject } from "./project.js";
@@ -65,8 +65,8 @@ function answersFromInput(raw) {
 }
 async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}) {
     const repoRoot = path.resolve(repoPath);
+    const flow = await readFlowState(repoRoot);
     if (!hasAnswer(answers, "solution_path")) {
-        const flow = await readFlowState(repoRoot);
         const confirmedPath = flow?.request === request && flow.blueprint?.confirmed_digest ? flow.blueprint?.path ?? null : null;
         if (confirmedPath) {
             answers = { ...answers, solution_path: confirmedPath };
@@ -75,7 +75,7 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
     const inspection = await inspectProject(repoRoot, surfacePath);
     const root = inspection.effectiveRoot;
     const storedCreativeSelection = await readCreativeSelection(repoRoot);
-    const creativeSelection = storedCreativeSelection && creativeSelectionAppliesToRequest(storedCreativeSelection, request)
+    const creativeSelection = storedCreativeSelection && creativeSelectionAppliesToRequest(storedCreativeSelection, request, flow)
         ? storedCreativeSelection
         : undefined;
     const creativeContext = creativeSelection ? creativeContextForPlan(creativeSelection) : undefined;
@@ -113,7 +113,10 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
     const designReview = designReviewGuidance(repoRoot, designContract, answers);
     const acceptedDesignContract = designReview.status === "accepted" ? designContract : null;
     const designProfile = acceptedDesignContract ? await readDesignProfile(repoRoot) : null;
-    const designBrief = acceptedDesignContract ? buildDesignBrief(acceptedDesignContract, designProfile) : undefined;
+    const designProfileDiagnostic = acceptedDesignContract && !designProfile ? await readDesignProfileDiagnostic(repoRoot) : undefined;
+    const designBrief = acceptedDesignContract
+        ? buildDesignBrief(acceptedDesignContract, designProfile, designProfileDiagnostic?.reason)
+        : undefined;
     const designReviewLoop = designProfile
         ? solutionPath.recommendation === "uikit"
             ? {
@@ -179,6 +182,20 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
         uikitGuidedUnknown: platformDetected && outcome === "unknown" && Boolean(uikitCustomization),
         creativeSelected: Boolean(creativeSelection),
     }));
+    const experienceBundle = !creativeSelection && !socialWorkplan && outcome !== "unknown" ? experienceBundleFor(request) : undefined;
+    const experienceHint = experienceBundle
+        ? {
+            status: "consider-experience-expansion",
+            detectedExperience: experienceBundle.id,
+            variantId: experienceBundle.variantId,
+            companionSurfaces: experienceBundle.surfaces.map((surface) => surface.id),
+            routeTo: "vise creative",
+            message: `This request reads as a fuller "${experienceBundle.id}" experience (usually ${experienceBundle.surfaces
+                .map((surface) => surface.id)
+                .join(", ")}), but it classified to a single ${outcome} surface. ADVISORY: before building a lone surface, run ` +
+                `\`vise creative . --request "<intent>"\`, review the candidate experiences, and accept one if it fits — then \`vise workplan\` governs the multi-surface journey. Skipping is fine for a deliberately single-surface build; this never gates \`vise check\`.`,
+        }
+        : undefined;
     return {
         outcome,
         platform,
@@ -191,6 +208,7 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
         creativeContext,
         uxHarness: uxHarnessContext,
         socialWorkplan,
+        ...(experienceHint ? { experienceHint } : {}),
         capabilityAvailability: slimCapabilityAvailability(capabilityAvailability),
         designReview,
         decisionsRequired,
@@ -312,7 +330,7 @@ function crossPlatformImplementationSteps(platform, packageJsonText) {
             {
                 step: "React Native target-discovery handoff: bridge only local API key/user/region config through ignored native build config; never bridge communityId, postId, channelId, targetId, or feedId. Resolve those from SDK search/list/create results or host navigation/app state, then pass the returned SDK object/id through normal React state. Treat native config bridge and native module output as unproven until a release/debug runtime smoke shows non-empty config, no `NativeModule: AsyncStorage is null` or `NativeModule.RNCNetInfo is null` log, and an established SDK session; a screen that says credentials/config are missing is failed populated proof even if BuildConfig and TypeScript checks pass. Record runtime proof in evidence/notes, not end-user UI: do not render `CLIENT`, `SESSION`, `RUNTIME`, SDK, env, region, setup/readiness-debug labels, visible runtime/probe/status panels, or hidden no-op controls in the product screen.",
                 evidence: [
-                    "requiredInputs.concrete feed target",
+                    "requiredInputs.feed source and post creation target",
                     "runtimeReadiness.targetDiscovery",
                     "runtimeReadiness.runtimeProof",
                 ],
@@ -632,17 +650,32 @@ function uxHarnessImplementationRules(context) {
         ...context.implementationGuidance,
     ];
 }
-function creativeSelectionAppliesToRequest(selection, request) {
+function creativeSelectionAppliesToRequest(selection, request, flow) {
     const normalizedRequest = normalizeCreativeRequest(request);
     const original = normalizeCreativeRequest(selection.source.request);
     const planRequest = normalizeCreativeRequest(selection.implementationContext.planRequest);
     if (!normalizedRequest || !original) {
         return false;
     }
+    const requestedOutcome = resolveOutcome(request, {});
+    if (omittedCreativeOutcomeSet(flow).has(requestedOutcome)) {
+        return false;
+    }
     return (normalizedRequest === original ||
         normalizedRequest === planRequest ||
         normalizedRequest.includes(original) ||
-        original.includes(normalizedRequest));
+        original.includes(normalizedRequest) ||
+        (Boolean(selection.selectedVariant?.id) && creativeSelectionOutcomeSet(selection).has(requestedOutcome)));
+}
+function omittedCreativeOutcomeSet(flow) {
+    return new Set((flow?.blueprint?.omitted ?? []).map((item) => item.outcome).filter((outcome) => typeof outcome === "string"));
+}
+function creativeSelectionOutcomeSet(selection) {
+    const outcomes = new Set();
+    for (const hint of selection.implementationContext.surfaceHints ?? []) {
+        outcomes.add(hint.outcome);
+    }
+    return outcomes;
 }
 function normalizeCreativeRequest(value) {
     return value.toLowerCase().replace(/[^a-z0-9\s]+/g, " ").replace(/\s+/g, " ").trim();

package/dist/tools/project.js

@@ -71,6 +71,8 @@ async function inspectRoot(root) {
         ["flutter", "pubspec.yaml", "Flutter/Dart package manifest"],
         ["ios", "Podfile", "CocoaPods project manifest"],
         ["ios", "Package.swift", "Swift package manifest"],
+        ["ios", "project.yml", "xcodegen project manifest"],
+        ["ios", "project.yaml", "xcodegen project manifest"],
         ["typescript", "package.json", "JavaScript or TypeScript package manifest"],
         ["typescript", "tsconfig.json", "TypeScript project config"],
     ];
@@ -470,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));
@@ -599,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));
@@ -730,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));
@@ -1860,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`;
@@ -2014,6 +2218,8 @@ function validateFollowStatusSubscription(root, platform, sourceContent) {
             /\bobserve\s*\{/.test(checkContent) ||
             /\bdoOnNext\b/.test(checkContent) ||
             /\.subscribe\s*\(/.test(checkContent) ||
+            /\$snapshot\b/.test(checkContent) ||
+            /\.sink\s*[({]/.test(checkContent) ||
             /getFollowInfo\s*\([^()]*,/.test(checkContent) ||
             /\/\/\s*vise:\s*one-shot follow status intentional/i.test(content))
             continue;
@@ -3158,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));
@@ -3737,7 +3946,7 @@ function validateUnreadSubscribedNotCounted(root, platform, sourceContent) {
         if (/\.filter\s*\(\s*[^)]*!\s*[^)]*isRead\s*[^)]*\)\s*\.\s*length/.test(checkContent) ||
             /\.where\s*\(\s*[^)]*!\s*[^)]*isRead\s*[^)]*\)\s*\.\s*length/.test(checkContent) ||
             /\.count\s*\(\s*[^)]*!\s*[^)]*\.isRead\s*\)/.test(checkContent) ||
-            /unreadCount\s*=\s*[^;]*\bfilter\b/.test(checkContent)) {
+            /unreadCount\s*=\s*[^;\n]*\bfilter\b/.test(checkContent)) {
             hasManualCount = true;
             if (!firstManualCountFile) {
                 firstManualCountFile = (typeof filename === 'string' && root) ? (filename.startsWith(root) ? filename.slice(root.length).replace(/^\//, '') : filename) : filename;
@@ -3786,10 +3995,10 @@ function validateNotificationsPreferencesConfigured(root, platform, sourceConten
     return findings;
 }
 function isNonUiSourceFile(filename) {
-    const base = path.basename(filename).replace(/\.(kt|swift|dart|tsx?|jsx?)$/i, "");
-    if (/(?:Application|Manager|Repository|Repo|Service|DataSource|Datasource|Provider|Client|Store|Mapper|Interactor|UseCase|Bloc|Cubit|Notifier|Mock|Fake|Stub|Test|Tests|Spec)$/.test(base))
+    const base = path.basename(filename).replace(/\.(kt|kts|java|swift|dart|tsx?|jsx?)$/i, "");
+    if (/(?:Application|Manager|Repository|Repo|Service|DataSource|Datasource|Provider|Client|Store|Mapper|Interactor|UseCase|Bloc|Cubit|Notifier|Gateway|ViewModel|Mock|Fake|Stub|Test|Tests|Spec)$/.test(base))
         return true;
-    if (/_(?:manager|repository|repo|service|data_source|datasource|provider|client|store|mapper|interactor|use_case|usecase|bloc|cubit|notifier|mock|fake|stub|test|spec)$/i.test(base))
+    if (/_(?:manager|repository|repo|service|data_source|datasource|provider|client|store|mapper|interactor|use_case|usecase|bloc|cubit|notifier|gateway|view_model|viewmodel|mock|fake|stub|test|spec)$/i.test(base))
         return true;
     if (/^(?:store|stores|repository|repositories|repo|repos|service|services|datasource|datasources|provider|providers|client|clients|interactor|interactors|usecase|usecases|bloc|cubit|notifier|api|mapper)$/i.test(base))
         return true;
@@ -3797,6 +4006,36 @@ function isNonUiSourceFile(filename) {
         return true;
     return false;
 }
+function viseGuardAssertionTrusted(comment, sourceContent, realGuardTest) {
+    const fileTokens = comment.match(/\b[A-Za-z_][\w]*\.(?:swift|kt|kts|java|dart|tsx?|jsx?)\b/g) ?? [];
+    if (fileTokens.length === 0)
+        return true;
+    const wanted = new Set(fileTokens);
+    for (const [file, content] of sourceContent) {
+        if (wanted.has(path.basename(file)) && realGuardTest(file, content))
+            return true;
+    }
+    return false;
+}
+function hasRealBanGuard(content) {
+    const banUseSurface = content.replace(/\b(?:export\s+)?(?:default\s+)?(?:async\s+)?(?:function|fun|func|const|let|var|val)\s+\w*[Bb]an\w*\b/g, " ");
+    return (/\bis\w*Ban(?:ned)?\b/.test(banUseSurface) ||
+        /\b\w*[Ii]sBanned\b/.test(banUseSurface) ||
+        /isCurrentUserBannedFromCommunity/.test(content) ||
+        /community\.bannedUserIds\.(?:contains|includes)/i.test(content) ||
+        /channel\.isMuted/.test(content) ||
+        /member\.isMuted/.test(content) ||
+        /user\.banState/.test(content));
+}
+function hasRealOwnershipGuard(stripped) {
+    return (/\bisAuthor\b/.test(stripped) ||
+        /\bisOwner\b/.test(stripped) ||
+        /postedUserId\s*===?=?\s*\w+/.test(stripped) ||
+        /\w+\s*===?=?\s*[\w.]*postedUserId\b/.test(stripped) ||
+        /creator\s*\??\.\s*userId\s*===?=?/.test(stripped) ||
+        /\buserId\s*===?\s*[\w.]*(?:currentUser|currentUserId)\b/.test(stripped) ||
+        /\b(?:currentUser|currentUserId)[\w.]*\s*===?\s*[\w.]*\buserId\b/.test(stripped));
+}
 function validateUserBanStateRespected(root, platform, sourceContent) {
     const findings = [];
     const ruleId = platform + '.user.ban-state-respected';
@@ -3818,7 +4057,10 @@ function validateUserBanStateRespected(root, platform, sourceContent) {
             /channel\.isMuted/.test(text) ||
             /member\.isMuted/.test(text) ||
             /user\.banState/.test(text) ||
-            /\/\/\s*vise:\s*ban state checked at/i.test(text);
+            (() => {
+                const m = text.match(/\/\/\s*vise:\s*ban state checked\b[^\n]*/i);
+                return m ? viseGuardAssertionTrusted(m[0], sourceContent, (_f, c) => hasRealBanGuard(c)) : false;
+            })();
         if (!hasBanCheck) {
             findings.push(finding(ruleId, "warning", "File " + rel + " renders an interaction action without checking ban state.", rel, "Banned users still see post-create, like, comment, or send-message buttons, which fail on the server. To avoid poor UX and support tickets, check the ban state before showing these actions."));
         }
@@ -3884,7 +4126,10 @@ function validateModerationRoleGatedAction(root, platform, sourceContent) {
             /creator\s*\??\.\s*userId\s*===?=?/.test(stripped) ||
             /\buserId\s*===?\s*[\w.]*(?:currentUser|currentUserId)\b/.test(stripped) ||
             /\b(?:currentUser|currentUserId)[\w.]*\s*===?\s*[\w.]*\buserId\b/.test(stripped) ||
-            /\/\/\s*vise:\s*owner action\b/i.test(text);
+            (() => {
+                const m = text.match(/\/\/\s*vise:\s*owner action\b[^\n]*/i);
+                return m ? viseGuardAssertionTrusted(m[0], sourceContent, (f, c) => hasRealOwnershipGuard(commentStripped(f, platform, c))) : false;
+            })();
         if (hasModOnlyAction && !hasRoleCheck) {
             findings.push(finding(ruleId, "warning", "File " + rel + " invokes a moderator-only action (ban/mute) without a role check.", rel, "Ban/mute require the moderator role and fail on the server otherwise. Gate the action behind a role check (e.g. currentUser.roles.includes('moderator'), or client.hasPermission(...))."));
         }
@@ -3986,7 +4231,7 @@ function validatePostBodyRendered(root, platform, sourceContent) {
         typescript: /\bpost\s*\??\.\s*(?:text|description|caption)\b|\bpost\s*\??\.\s*data[\s\S]{0,140}\b(?:text|description|caption)\b|\b(?:render|format|get|build)(?:Post)?(?:Body|Text|Description|Caption)\s*\(\s*post\s*\)|<\s*(?:PostBody|PostText|PostDescription|PostContent)\b[^>]*\bpost=/i,
         "react-native": /\bpost\s*\??\.\s*(?:text|description|caption)\b|\bpost\s*\??\.\s*data[\s\S]{0,140}\b(?:text|description|caption)\b|\b(?:render|format|get|build)(?:Post)?(?:Body|Text|Description|Caption)\s*\(\s*post\s*\)|<\s*(?:PostBody|PostText|PostDescription|PostContent)\b[^>]*\bpost=/i,
         flutter: /\bpost\s*\.\s*(?:text|description|caption)\b|\bpost\s*\.\s*getData\s*<|\bAmityTextPost\b|\bAmityPostData\b|\b(?:postBody|postText|postDescription|postCaption)\s*\(\s*post\s*\)/i,
-        ios: /\bpost\s*\.\s*(?:text|description|caption)\b|\bpost\s*\.\s*getData\(\)\s*as\?[\s\S]{0,80}\bAmityPost\.Data\.TEXT\b|\bgetText\s*\(\s*\)|\b(?:postBody|postText|postDescription|postCaption)\s*\(\s*post\s*\)/i,
+        ios: /\bpost\s*\.\s*(?:text|description|caption)\b|\bpost\s*\.\s*postData\b|\bpost\s*\.\s*data\s*\??\s*\[\s*["']text["']\s*\]|\bpost\s*\.\s*getData\(\)\s*as\?[\s\S]{0,80}\bAmityPost\.Data\.TEXT\b|\bgetText\s*\(\s*\)|\b(?:postBody|postText|postDescription|postCaption)\s*\(\s*post\s*\)/i,
         android: /\bpost\s*\.\s*(?:text|description|caption)\b|\bpost\s*\.\s*getData\(\)\s*as\??[\s\S]{0,80}\bAmityPost\.Data\.TEXT\b|\bAmityPost\.Data\.TEXT\b|\bgetText\s*\(\s*\)|\b(?:postBody|postText|postDescription|postCaption)\s*\(\s*post\s*\)/i,
     };
     const uiPat = uiTextPat[platform] ?? uiTextPat.typescript;
@@ -4521,7 +4766,7 @@ function validateFeedTargetTypeExplicit(root, platform, sourceContent) {
     const findings = [];
     const ruleId = `${platform}.feed.target-type-explicit`;
     const TARGET_TYPE_PATTERNS = [
-        /targetType\s*[:=\(]\s*(?:co\.amity\.android\.sdk\.)?(AmityPostTargetType\.|TargetType\.|\.community|\.user|\.my_feed|\.COMMUNITY|\.USER|\.MY_FEED|"COMMUNITY"|"USER"|"MY_FEED"|'COMMUNITY'|'USER'|'MY_FEED')/i
+        /targetType\s*[:=\(]\s*(?:co\.amity\.android\.sdk\.)?(AmityPostTargetType\.|TargetType\.|\.community|\.user|\.global|\.my_feed|\.COMMUNITY|\.USER|\.GLOBAL|\.MY_FEED|"community"|"user"|"global"|"my_feed"|"COMMUNITY"|"USER"|"GLOBAL"|"MY_FEED"|'community'|'user'|'global'|'my_feed'|'COMMUNITY'|'USER'|'GLOBAL'|'MY_FEED')/i
     ];
     for (const [filename, text] of sourceContent) {
         const rel = relativeFile(root, filename);
@@ -4538,14 +4783,16 @@ function validateFeedTargetTypeExplicit(root, platform, sourceContent) {
             while ((ttm = g.exec(text)) !== null) {
                 const window = text.slice(Math.max(0, ttm.index - 180), ttm.index + 180);
                 const isReadQuery = /\b(?:feedType|sortBy)\s*:/.test(window) && !/\bdataType\s*:/.test(window);
+                const targetTypeExpression = text.slice(ttm.index, Math.min(text.length, ttm.index + 100));
+                const invalidWriteTarget = /targetType\s*[:=\(][^,)\n}]*\b(?:global|my_feed)\b/i.test(targetTypeExpression);
                 const targetIdDynamic = /\btargetId\s*:\s*[A-Za-z_$]/.test(window);
-                if (!isReadQuery && !targetIdDynamic) {
+                if (!isReadQuery && (invalidWriteTarget || !targetIdDynamic)) {
                     flagged = true;
                     break;
                 }
             }
             if (flagged) {
-                findings.push(finding(ruleId, "warning", `A createPost call sets a literal targetType but its targetId is not bound to a dynamic value (route param, auth context, or prop).`, rel, "Feed targets must be bound to the intake-resolved target — the community ID from route params, the user ID from auth context, or a prop passed from the caller. Do not leave targetType as a free variable or default enum value: the intent is to wire it to 'requiredInputs.concrete feed target', not simply to avoid a literal. If this is intentional, add comment // vise: target-type rationale — <reason>."));
+                findings.push(finding(ruleId, "warning", `A createPost call uses an invalid or unbound targetType/targetId pair.`, rel, "Feed targets must be bound to the intake-resolved read/write target — the community ID from route params, the user ID from auth context, or a prop passed from the caller. Do not use global as a createPost target, and do not leave targetType as a free variable or default enum value. If this is intentional, add comment // vise: target-type rationale — <reason>."));
                 break;
             }
         }