@amityco/social-plus-vise 0.14.19 → 0.14.20

package/CHANGELOG.md

@@ -4,6 +4,17 @@ 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).
 
+## 0.14.20 — 2026-06-05
+
+### Changed
+- **Product-first community/follow/notification flow:** community, follow/social-graph, and in-app notification plans now surface shared product expectation IDs before implementation, backed by platform capability preflight.
+- **Community deterministic bindings:** community avatar, community display-name, and role-gated moderator action findings now report shared IDs (`community.avatar-from-sdk`, `community.display-name-from-sdk`, `moderation.role-gated-action`) while retaining exact platform `contractRuleId`/`validator.sensorId` evidence.
+- **Attestation fallback for non-deterministic product expectations:** community target/live/privacy, follow target/live/model, and notification tray/seen/preferences expectations are offered when bundled SDK facts show the surface exists, with `attestation-needed` status until dedicated deterministic sensors exist.
+- **Availability-aware notification guidance:** `vise plan` now withholds unavailable notification tray/mark-seen capabilities from Flutter while still surfacing notification preferences, and withholds notification preferences from TypeScript/React Native where bundled facts do not expose notification settings APIs.
+
+### Verified
+- Full `npm run validate` passed, including package E2E and pack dry-run for `@amityco/social-plus-vise@0.14.20`. Product-flow now verifies community/follow/notification plan feed-forward, unavailable notification capability reporting, and exact Android sensor evidence for promoted community/moderation expectations.
+
 ## 0.14.19 — 2026-06-05
 
 ### Changed

package/README.md

@@ -161,14 +161,14 @@ Aggregate: **98/99 expected feed capabilities** and **27/27 selected optional ca
 
 ### Current Release Validation
 
-Version 0.14.19 carries current release proof around the full feed-forward, product-expectation, and validation flow:
+Version 0.14.20 carries current release proof around the full feed-forward, product-expectation, and validation flow:
 
 | Surface | What was validated |
 |---|---|
 | **Product flow** | Local end-to-end smoke covers design extraction, plan feed-forward, blocking intake, answered init, capability check, design conformance, and sensor discovery. |
 | **Plan questions** | Plans surface blocking questions such as `feature_surface` and `design_contract_confirmation`, plus optional choices such as `feed_optional_capabilities`. |
 | **Capability-to-sensor flow** | Vise checks platform support, matches the prompt to available capabilities, offers supported features as questions, records answers, and turns selected answers into sensors in `vise check`. |
-| **Shared product expectations** | Public IDs such as `feed.target-resolved`, `comments.target-resolved`, `comments.thread-read-write`, `chat.channel-target-resolved`, `chat.send-error-handling`, and `chat.unread-visible` stay platform-agnostic while check results retain concrete `contractRuleId` and `validator.sensorId` evidence. |
+| **Shared product expectations** | Public IDs such as `feed.target-resolved`, `comments.thread-read-write`, `chat.channel-target-resolved`, `community.avatar-from-sdk`, `community.display-name-from-sdk`, `moderation.role-gated-action`, `follow.relationship-live`, `profile.social-counts`, and `notifications.tray-live` stay platform-agnostic while check results retain concrete `contractRuleId` and `validator.sensorId` evidence when deterministic sensors exist. |
 | **Rule detection** | TP-track dashboard detects **321/321 seeded rule gaps (100.0%)** in the static corpus. |
 | **Packed-package smoke** | Packed-package and host-agent smokes exercise the release tarball path, surfaced plan questions, selected optional capability sensors, rejected design confirmation handling, and exact contract-rule evidence for shared product expectations. |
 

package/dist/capabilities.js

@@ -688,6 +688,132 @@ export const SHARED_PRODUCT_EXPECTATIONS = [
         deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
         hint: "declare first-created/newest-created order in the SDK query or a clearly named UI sort so the thread cannot be reversed by defaults",
     },
+    {
+        id: "community.target-resolved",
+        label: "Resolved community target",
+        outcomes: ["add-community"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK community query/target APIs",
+                symbols: [/\bcommunityId\b/i, /\bCommunityRepository\b/i, /\bgetCommunity\b/i, /\bqueryCommunities\b/i, /\bgetCommunities\b/i, /\bAmityCommunity\b/i],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "resolve communityId from route params, user selection, SDK query, or a create flow; do not invent or hardcode it",
+    },
+    {
+        id: "community.members-live",
+        label: "Live community/member lists",
+        outcomes: ["add-community"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK community/member live APIs",
+                symbols: [/\bCommunityLiveCollection\b/i, /\bCommunityMemberLiveCollection\b/i, /\bgetMembers\b/i, /\bsearchMembers\b/i, /\bgetLiveCollection\b/i, /\blisten\b/i, /\bobserve\b/i],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "query communities and members through the SDK live collection/listener idiom, with lifecycle cleanup",
+    },
+    {
+        id: "community.privacy-flow-explicit",
+        label: "Community privacy/join flow",
+        outcomes: ["add-community"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK join/leave and join-request APIs",
+                symbols: [/\bjoinCommunity\b/i, /\bleaveCommunity\b/i, /\bjoinRequest\b/i, /\bJoinRequest\b/i, /\bCommunityType\b/i, /\bMembershipAcceptanceType\b/i],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "handle public instant-join and private join-request states explicitly instead of assuming one community privacy model",
+    },
+    {
+        id: "community.avatar-from-sdk",
+        label: "Community avatar from SDK",
+        outcomes: ["add-feed", "add-comments", "add-community"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK avatar fields/accessors",
+                symbols: [/\bAmityCommunity\b/i, /\bAmity\.Community\b/i, /\bavatar\b/i, /\bavatarImage\b/i, /\bgetAvatar\b/i, /\bfileUrl\b/i, /\bfileURL\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "render the SDK avatar URL when present and fall back to initials only when no SDK avatar exists",
+    },
+    {
+        id: "community.display-name-from-sdk",
+        label: "Community display name from SDK",
+        outcomes: ["add-feed", "add-comments", "add-community"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK community display name",
+                symbols: [/\bdisplayName\b/i, /\bgetDisplayName\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "render community.displayName or the platform equivalent; do not show raw community IDs as names",
+    },
+    {
+        id: "moderation.role-gated-action",
+        label: "Role-gated moderator actions",
+        outcomes: ["add-community", "add-moderation"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK role or member-moderation APIs",
+                symbols: [/\baddRole\b/i, /\bremoveRole\b/i, /\bbanMember\b/i, /\bremoveMember\b/i, /\broles?\b/i, /\bpermissions\b/i, /\bmoderation\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "gate moderator-only role, ban, remove, mute, approve, or decline actions behind SDK role/permission state",
+    },
+    {
+        id: "follow.target-resolved",
+        label: "Resolved follow target",
+        outcomes: ["add-follow"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK user relationship target APIs",
+                symbols: [/\buserId\b/i, /\btargetUserId\b/i, /\bUserRepository\b/i, /\bfollow\b/i, /\bunfollow\b/i, /\bgetFollowInfo\b/i],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "resolve the target userId from route params, selected profile, or current user context; do not invent it",
+    },
+    {
+        id: "follow.relationship-live",
+        label: "Live follow relationship",
+        outcomes: ["add-follow"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK follower/following live APIs",
+                symbols: [/\bFollowerLiveCollection\b/i, /\bFollowingLiveCollection\b/i, /\bgetFollowers\b/i, /\bgetFollowings\b/i, /\bgetLiveCollection\b/i, /\blisten\b/i, /\bonFollow/i],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "keep follow state and follower/following lists live through SDK subscriptions or live collections, with cleanup",
+    },
+    {
+        id: "follow.model-explicit",
+        label: "Follow approval model",
+        outcomes: ["add-follow"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK follow status/request APIs",
+                symbols: [/\bFollowStatus\b/i, /\bFollowStatusFilter\b/i, /\bpending\b/i, /\bacceptMyFollower\b/i, /\bdeclineMyFollower\b/i],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "make automatic follow vs pending approval explicit, including accept/decline states where the SDK exposes them",
+    },
     {
         id: "profile.social-counts",
         label: "Profile follower/following counts",
@@ -709,6 +835,54 @@ export const SHARED_PRODUCT_EXPECTATIONS = [
         deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
         hint: "if follower/following labels are rendered, source the counts or lists from the SDK instead of placeholders",
     },
+    {
+        id: "notifications.tray-live",
+        label: "Live notification tray",
+        outcomes: ["add-notifications"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK notification tray APIs",
+                symbols: [/\bnotificationTray\b/i, /\bNotificationTray\b/i, /\bgetNotificationTrayItems\b/i, /\bgetNotificationTraySeen\b/i],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "observe the in-app notification tray/list or seen object through the SDK; do not treat it as push setup",
+    },
+    {
+        id: "notifications.mark-seen",
+        label: "Notification seen state",
+        outcomes: ["add-notifications"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK tray seen/mark-seen APIs",
+                symbols: [/\bmarkTraySeen\b/i, /\bmarkItemsSeen\b/i, /\bmarkSeen\b/i, /\bNotificationTraySeen\b/i],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "call the SDK mark-seen API so tray badges clear server-side after the user opens the notification surface",
+    },
+    {
+        id: "notifications.preferences-respected",
+        label: "Notification preferences",
+        outcomes: ["add-notifications"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK notification settings/preferences APIs",
+                symbols: [
+                    /\bAmity(?:Channel|Community|User)Notifications?Manager\.getSettings\b/i,
+                    /\bAmity(?:Channel|Community|User)Notification\.getSettings\b/i,
+                    /\bAmitySocialClient\.getSettings\b/i,
+                    /\bnotificationRepository\.getSettings\b/i,
+                    /\bnotifications\(\)\.getSettings\b/i,
+                ],
+            },
+        ],
+        deterministicPlatforms: [],
+        hint: "when settings are in scope, read or respect SDK notification preferences rather than showing hardcoded toggles",
+    },
 ];
 function availabilityDefinitionsFor(outcome) {
     return [

package/dist/outcomes.js

@@ -903,6 +903,7 @@ const addModeration = {
         `${platform}.moderation.block-or-mute-state-applied`,
         `${platform}.moderation.hidden-content-rendering-present`,
         `${platform}.moderation.confirmation-ux-present`,
+        "moderation.role-gated-action",
     ],
     stopConditions: (ctx) => filterStops(ctx.answers, [
         { id: "moderation_target", text: "The moderation target content types are unknown." },
@@ -1156,10 +1157,12 @@ const addCommunity = {
         ];
     },
     validation: () => [
-        "community membership uses a Live Collection (not a one-shot query)",
-        "join/leave handles public vs private (join-request) flows",
-        "no invented communityId",
-        "community/member observer cleaned up on lifecycle end",
+        "community.target-resolved",
+        "community.members-live",
+        "community.privacy-flow-explicit",
+        "community.avatar-from-sdk",
+        "community.display-name-from-sdk",
+        "moderation.role-gated-action",
         "validate_setup",
         "run_sensors",
     ],
@@ -1275,11 +1278,10 @@ const addFollow = {
         ];
     },
     validation: () => [
-        "follower/following lists use a Live Collection (not a one-shot query)",
-        "follow model handled (automatic vs follow-request approval)",
+        "follow.target-resolved",
+        "follow.relationship-live",
+        "follow.model-explicit",
         "profile.social-counts",
-        "no invented userId",
-        "relationship observer cleaned up on lifecycle end",
         "validate_setup",
         "run_sensors",
     ],
@@ -1373,9 +1375,9 @@ const addNotifications = {
         ];
     },
     validation: () => [
-        "notification tray observed as a Live Object/Collection (not a one-shot query)",
-        "tray/items marked seen so the unseen count clears server-side",
-        "tray observer cleaned up on lifecycle end",
+        "notifications.tray-live",
+        "notifications.mark-seen",
+        "notifications.preferences-respected",
         "this is in-app tray, not push setup",
         "validate_setup",
         "run_sensors",

package/dist/productExpectations.js

@@ -16,7 +16,19 @@ export const PRODUCT_EXPECTATION_TITLES = {
     "chat.channel-shape-matched": "Chat channel type matches the requested shape",
     "chat.unread-visible": "Chat unread counts are visible",
     "chat.message-order-explicit": "Chat message order is explicit",
+    "community.target-resolved": "Community target comes from app state",
+    "community.members-live": "Community and member lists stay live",
+    "community.privacy-flow-explicit": "Community privacy flow is explicit",
+    "community.avatar-from-sdk": "Community avatars come from the SDK",
+    "community.display-name-from-sdk": "Community display names come from the SDK",
+    "moderation.role-gated-action": "Moderator-only actions are role gated",
+    "follow.target-resolved": "Follow target comes from app state",
+    "follow.relationship-live": "Follow relationships stay live",
+    "follow.model-explicit": "Follow approval model is explicit",
     "profile.social-counts": "Profile social counts come from the SDK",
+    "notifications.tray-live": "Notification tray is observed live",
+    "notifications.mark-seen": "Notification seen state clears server-side",
+    "notifications.preferences-respected": "Notification preferences are respected",
 };
 const platformBindings = (expectationId, sensorsByPlatform) => Object.entries(sensorsByPlatform).flatMap(([platform, sensors]) => (Array.isArray(sensors) ? sensors : [sensors]).map((sensorId) => ({
     expectationId,
@@ -358,6 +370,27 @@ export const PRODUCT_EXPECTATION_BINDINGS = [
         sensorId: "ios.chat.sort-explicit",
         platform: "ios",
     },
+    ...platformBindings("community.avatar-from-sdk", {
+        typescript: "typescript.community.avatar-from-sdk",
+        "react-native": "react-native.community.avatar-from-sdk",
+        android: "android.community.avatar-from-sdk",
+        flutter: "flutter.community.avatar-from-sdk",
+        ios: "ios.community.avatar-from-sdk",
+    }),
+    ...platformBindings("community.display-name-from-sdk", {
+        typescript: "typescript.community.display-name-from-sdk",
+        "react-native": "react-native.community.display-name-from-sdk",
+        android: "android.community.display-name-from-sdk",
+        flutter: "flutter.community.display-name-from-sdk",
+        ios: "ios.community.display-name-from-sdk",
+    }),
+    ...platformBindings("moderation.role-gated-action", {
+        typescript: "typescript.moderation.role-gated-action",
+        "react-native": "react-native.moderation.role-gated-action",
+        android: "android.moderation.role-gated-action",
+        flutter: "flutter.moderation.role-gated-action",
+        ios: "ios.moderation.role-gated-action",
+    }),
     {
         expectationId: "profile.social-counts",
         sensorId: "typescript.profile.social-counts-from-sdk",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/social-plus-vise",
-  "version": "0.14.19",
+  "version": "0.14.20",
   "description": "Skill-guided deterministic CLI for social.plus SDK integration assistance.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",

package/rules/feed.yaml

@@ -2595,6 +2595,7 @@
         "outcomes": [
           "add-feed",
           "add-comments",
+          "add-community",
           "validate-setup"
         ]
       },
@@ -2632,6 +2633,7 @@
         "outcomes": [
           "add-feed",
           "add-comments",
+          "add-community",
           "validate-setup"
         ]
       },
@@ -2669,6 +2671,7 @@
         "outcomes": [
           "add-feed",
           "add-comments",
+          "add-community",
           "validate-setup"
         ]
       },
@@ -2706,6 +2709,7 @@
         "outcomes": [
           "add-feed",
           "add-comments",
+          "add-community",
           "validate-setup"
         ]
       },
@@ -2743,6 +2747,7 @@
         "outcomes": [
           "add-feed",
           "add-comments",
+          "add-community",
           "validate-setup"
         ]
       },
@@ -2837,7 +2842,7 @@
       "rationale": "Using a raw communityId as a displayName fallback (e.g. when passing only the ID in navigation state) shows a UUID to users instead of the community's actual name.",
       "applies_when": {
         "platforms": ["typescript"],
-        "outcomes": ["add-feed", "add-comments", "validate-setup"]
+        "outcomes": ["add-feed", "add-comments", "add-community", "validate-setup"]
       },
       "enforcement": {
         "deterministic": [
@@ -2961,7 +2966,7 @@
       "rationale": "Using a raw communityId as a displayName fallback (e.g. when passing only the ID in navigation state) shows a UUID to users instead of the community's actual name.",
       "applies_when": {
         "platforms": ["react-native"],
-        "outcomes": ["add-feed", "add-comments", "validate-setup"]
+        "outcomes": ["add-feed", "add-comments", "add-community", "validate-setup"]
       },
       "enforcement": {
         "deterministic": [
@@ -3085,7 +3090,7 @@
       "rationale": "Using a raw communityId as a displayName fallback (e.g. when passing only the ID in navigation state) shows a UUID to users instead of the community's actual name.",
       "applies_when": {
         "platforms": ["flutter"],
-        "outcomes": ["add-feed", "add-comments", "validate-setup"]
+        "outcomes": ["add-feed", "add-comments", "add-community", "validate-setup"]
       },
       "enforcement": {
         "deterministic": [
@@ -3178,7 +3183,7 @@
       "rationale": "Using a raw communityId as a displayName fallback (e.g. when passing only the ID in navigation state) shows a UUID to users instead of the community's actual name.",
       "applies_when": {
         "platforms": ["ios"],
-        "outcomes": ["add-feed", "add-comments", "validate-setup"]
+        "outcomes": ["add-feed", "add-comments", "add-community", "validate-setup"]
       },
       "enforcement": {
         "deterministic": [
@@ -3302,7 +3307,7 @@
       "rationale": "Using a raw communityId as a displayName fallback (e.g. when passing only the ID in navigation state) shows a UUID to users instead of the community's actual name.",
       "applies_when": {
         "platforms": ["android"],
-        "outcomes": ["add-feed", "add-comments", "validate-setup"]
+        "outcomes": ["add-feed", "add-comments", "add-community", "validate-setup"]
       },
       "enforcement": {
         "deterministic": [

package/rules/moderation.yaml

@@ -733,6 +733,7 @@
           "typescript"
         ],
         "outcomes": [
+          "add-community",
           "add-moderation",
           "validate-setup"
         ]
@@ -769,6 +770,7 @@
           "react-native"
         ],
         "outcomes": [
+          "add-community",
           "add-moderation",
           "validate-setup"
         ]
@@ -805,6 +807,7 @@
           "android"
         ],
         "outcomes": [
+          "add-community",
           "add-moderation",
           "validate-setup"
         ]
@@ -841,6 +844,7 @@
           "flutter"
         ],
         "outcomes": [
+          "add-community",
           "add-moderation",
           "validate-setup"
         ]
@@ -877,6 +881,7 @@
           "ios"
         ],
         "outcomes": [
+          "add-community",
           "add-moderation",
           "validate-setup"
         ]