@amityco/social-plus-vise 0.14.17 → 0.14.19

package/CHANGELOG.md

@@ -4,6 +4,26 @@ 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.19 — 2026-06-05
+
+### Changed
+- **Deeper product-first chat/comments surface:** comment target resolution, chat channel source, chat observer cleanup, chat send failure handling, chat channel shape, and TypeScript/React Native chat message ordering now surface through shared product expectation IDs while preserving exact platform `contractRuleId`/`validator.sensorId` evidence.
+- **Capability feed-forward expansion:** chat plans now preflight the new product expectations against bundled SDK surface facts before implementation, so agents see product-level expectations such as `chat.channel-target-resolved`, `chat.message-observer-cleanup`, and `chat.send-error-handling`.
+- **Validation checklist clarity:** add-comments and add-chat validation lists no longer expose platform-specific primary IDs for the promoted target/lifecycle/send/channel-shape checks.
+
+### Verified
+- Focused capability, product-flow, native-idiom, CLI, MCP, compliance, and rule-coverage suites passed. Product-flow now verifies plan and check output for the new shared chat/comment IDs with Android/TypeScript contract evidence.
+
+## 0.14.18 — 2026-06-05
+
+### Changed
+- **Broader product-first rule surface:** feed target resolution, feed UI states, feed pagination, UGC moderation affordances, post status filtering, opaque pagination cursors, and server-synced unread counts now surface through shared product expectation IDs while preserving the exact platform `contractRuleId`/`validator.sensorId` evidence.
+- **Capability feed-forward expansion:** the promoted feed/data expectations now participate in platform capability preflight where the bundled SDK surface proves support, so plans can show product-level expectations before implementation rather than only after `vise check`.
+- **Validation checklist clarity:** add-feed, add-comments, and add-chat plans now use product-level expectation IDs for the promoted shared behaviors instead of exposing platform-specific validator names as the primary checklist items.
+
+### Verified
+- Focused CLI, fixture, MCP, product-flow, agent-flow, capability, native-idiom, and rule-coverage suites passed. A local iOS `whoops` plan smoke confirmed the broader product ids with iOS sensor evidence.
+
 ## 0.14.17 — 2026-06-05
 
 ### Changed

package/README.md

@@ -161,16 +161,16 @@ Aggregate: **98/99 expected feed capabilities** and **27/27 selected optional ca
 
 ### Current Release Validation
 
-Version 0.14.12 adds current release proof around the full feed-forward and validation flow:
+Version 0.14.19 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 `comments.thread-read-write` stay platform-agnostic while check results retain concrete `contractRuleId` and `validator.sensorId` evidence. |
-| **Rule detection** | TP-track dashboard detects **311/311 seeded rule gaps (100.0%)** in the static corpus. |
-| **Packed-package smoke** | A real Antigravity agent smoke tested the 0.14.12 tarball, opted into surfaced plan questions, repaired selected optional poll capability sensors, and verified ambiguous shared comment attestations require exact contract rule IDs. |
+| **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. |
+| **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. |
 
 ### Supporting Proof
 

package/dist/capabilities.js

@@ -427,6 +427,104 @@ export const OPTIONAL_CAPABILITIES = [
     },
 ];
 export const SHARED_PRODUCT_EXPECTATIONS = [
+    {
+        id: "feed.target-resolved",
+        label: "Resolved feed target",
+        outcomes: ["add-feed"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK feed target/query APIs",
+                symbols: [/\btargetId\b/i, /\btargetType\b/i, /\bgetUserFeed\b/i, /\bgetCommunityFeed\b/i, /\bgetGlobalFeed\b/i, /\bgetPosts\b/i, /\bqueryPosts\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "bind targetType and targetId to route params, auth context, or customer-owned selection state; do not invent literals",
+    },
+    {
+        id: "feed.ui-states-present",
+        label: "Feed loading/empty/error states",
+        outcomes: ["add-feed"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK feed collection/query APIs",
+                symbols: [/\bgetUserFeed\b/i, /\bgetCommunityFeed\b/i, /\bgetGlobalFeed\b/i, /\bgetPosts\b/i, /\bqueryPosts\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "render loading, empty, error, and data states around the feed collection instead of only the success path",
+    },
+    {
+        id: "feed.pagination-wired",
+        label: "Feed pagination",
+        outcomes: ["add-feed"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK pagination APIs",
+                symbols: [/\bnextPage\b/i, /\bnextPageToken\b/i, /\bloadMore\b/i, /\bonNextPage\b/i, /\bhasNext\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "wire load-more or automatic paging to the SDK collection; a fixed first page is incomplete",
+    },
+    {
+        id: "moderation.affordance-present",
+        label: "UGC moderation affordance",
+        outcomes: ["add-feed", "add-comments", "add-chat"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK moderation/reporting APIs",
+                symbols: [/\bflagPost\b/i, /\bflagComment\b/i, /\bflagMessage\b/i, /\breport\b/i, /\bmoderation\b/i, /\bblockUser\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "show report/flag/block/hide affordances on user-generated content, scoped to the surface being built",
+    },
+    {
+        id: "posts.status-filtered",
+        label: "Post status filtering",
+        outcomes: ["add-feed"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK post status/filter APIs",
+                symbols: [/\bstatus\b/i, /\bstatuses\b/i, /\bfeedType\b/i, /\bpublished\b/i, /\bincludeDeleted\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "filter post queries to published/non-deleted content so moderated or deleted posts do not leak into normal feeds",
+    },
+    {
+        id: "pagination.cursor-opaque",
+        label: "Opaque pagination cursors",
+        outcomes: ["add-feed", "add-comments", "add-chat"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK cursor pagination APIs",
+                symbols: [/\bnextPage\b/i, /\bnextPageToken\b/i, /\bloadMore\b/i, /\bonNextPage\b/i, /\bhasNext\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "pass SDK-provided cursor tokens or call SDK next-page helpers; never compute numeric page offsets",
+    },
+    {
+        id: "unread.server-synced",
+        label: "Server-synced unread counts",
+        outcomes: ["add-feed", "add-chat"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK unread state",
+                symbols: [/\bunreadCount\b/i, /\bChannelUnread\b/i, /\bobserveUserUnread\b/i, /\bgetUnread\w*\b/i, /\bgetTotalChannelUnread\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "source unread badges from the SDK stream instead of counting stale local arrays",
+    },
     {
         id: "feed.rich-post-rendering",
         label: "Rich post rendering",
@@ -471,6 +569,20 @@ export const SHARED_PRODUCT_EXPECTATIONS = [
         deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
         hint: "implement the selected rich composer paths or record an explicit text-only/rich-post scope decision",
     },
+    {
+        id: "comments.target-resolved",
+        label: "Resolved comment target",
+        outcomes: ["add-comments"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK comment target/query APIs",
+                symbols: [/\bgetComments\b/i, /\bqueryComments\b/i, /\bcreateComment\b/i, /\breferenceId\b/i, /\breferenceType\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "pass the parent post/story/custom entity id from navigation, props, or app state; do not invent postId/commentId literals",
+    },
     {
         id: "comments.thread-read-write",
         label: "Comment thread read/write",
@@ -483,6 +595,62 @@ export const SHARED_PRODUCT_EXPECTATIONS = [
         deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
         hint: "if comments are shown, pair the list with a composer and loading/error/empty states unless the surface is explicitly read-only",
     },
+    {
+        id: "chat.channel-target-resolved",
+        label: "Resolved chat channel",
+        outcomes: ["add-chat"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK channel query/create APIs",
+                symbols: [/\bChannelRepository\b/i, /\bgetChannels\b/i, /\bqueryChannels\b/i, /\bcreateChannel\b/i, /\bchannelId\b/i, /\bconversationId\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "resolve channelId/conversationId from SDK queries, user selection, routing, or app-owned creation flow; do not hardcode it",
+    },
+    {
+        id: "chat.message-observer-cleanup",
+        label: "Chat message observer cleanup",
+        outcomes: ["add-chat"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK message live query APIs",
+                symbols: [/\bMessageRepository\b/i, /\bgetMessages\b/i, /\bqueryMessages\b/i, /\bLiveCollection\b/i, /\bobserve\b/i, /\bsubscribe\b/i, /\bdispose\b/i, /\bunobserve\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "clean up message live collections/subscriptions on component unmount, view dismissal, or lifecycle disposal",
+    },
+    {
+        id: "chat.send-error-handling",
+        label: "Chat send failure handling",
+        outcomes: ["add-chat"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK message send/failure state APIs",
+                symbols: [/\bMessageRepository\b/i, /\bcreate\w*Message\b/i, /\bsendMessage\b/i, /\bsyncState\b/i, /\bdeleteFailedMessages\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "surface failed sends with error state, retry/delete affordances, or SDK failure cleanup instead of assuming optimistic success",
+    },
+    {
+        id: "chat.channel-shape-matched",
+        label: "Chat channel shape",
+        outcomes: ["add-chat"],
+        kind: "shared-expectation",
+        availability: [
+            {
+                label: "SDK channel type APIs",
+                symbols: [/\bchannelType\b/i, /\bChannelType\b/i, /\bAmityChannelType\b/i, /\bconversation\b/i, /\bcommunity\b/i, /\bbroadcast\b/i],
+            },
+        ],
+        deterministicPlatforms: ["android", "flutter", "ios", "typescript"],
+        hint: "match the SDK channel type to the selected chat shape: conversation for direct messages, community/group for shared channels, broadcast where applicable",
+    },
     {
         id: "chat.unread-visible",
         label: "Chat unread counts",

package/dist/outcomes.js

@@ -653,7 +653,13 @@ const addFeed = {
     validation: (platform) => [
         "feed target identified",
         "no invented communityId/targetId/feedId",
-        `${platform}.feed.target.literal`,
+        "feed.target-resolved",
+        "feed.ui-states-present",
+        "feed.pagination-wired",
+        "moderation.affordance-present",
+        "posts.status-filtered",
+        "pagination.cursor-opaque",
+        "unread.server-synced",
         "feed.rich-post-rendering",
         "feed.rich-post-composer-scope",
         "comments.thread-read-write",
@@ -787,9 +793,10 @@ const addComments = {
     validation: (platform) => [
         "comment target resolved",
         "no invented postId/commentId",
-        `${platform}.comments.target-resolved`,
+        "comments.target-resolved",
         "comments.thread-read-write",
-        `${platform}.comments.moderation-affordance-present`,
+        "moderation.affordance-present",
+        "pagination.cursor-opaque",
     ],
     stopConditions: (ctx) => filterStops(ctx.answers, [
         { id: "comment_target", text: "The comment target entity is unknown; do not invent postId, commentId, or parent entity references." },
@@ -1018,10 +1025,13 @@ const addChat = {
         ];
     },
     validation: (platform) => [
-        `${platform}.chat.channel-target-resolved`,
-        `${platform}.chat.message-observer-cleanup`,
-        `${platform}.chat.send-error-handling`,
-        `${platform}.chat.moderation-affordance-present`,
+        "chat.channel-target-resolved",
+        "chat.message-observer-cleanup",
+        "chat.send-error-handling",
+        "chat.channel-shape-matched",
+        "moderation.affordance-present",
+        "unread.server-synced",
+        "pagination.cursor-opaque",
         "chat.unread-visible",
         ...(platform === "android" || platform === "flutter" || platform === "ios" ? ["chat.message-order-explicit"] : []),
     ],

package/dist/productExpectations.js

@@ -1,12 +1,98 @@
 export const PRODUCT_EXPECTATION_TITLES = {
+    "feed.target-resolved": "Feed target comes from app state",
+    "feed.ui-states-present": "Feed renders loading, empty, and error states",
+    "feed.pagination-wired": "Feed pagination is wired",
+    "moderation.affordance-present": "UGC moderation affordance is present",
+    "posts.status-filtered": "Post queries filter unsafe statuses",
+    "pagination.cursor-opaque": "Pagination cursors stay opaque",
+    "unread.server-synced": "Unread counts use the server-synced stream",
     "feed.rich-post-rendering": "Feed renders rich post types",
     "feed.rich-post-composer-scope": "Feed composer surfaces rich post scope",
+    "comments.target-resolved": "Comment target comes from the parent entity",
     "comments.thread-read-write": "Comment threads support reading and creation",
+    "chat.channel-target-resolved": "Chat channel comes from app state",
+    "chat.message-observer-cleanup": "Chat message observers clean up on lifecycle end",
+    "chat.send-error-handling": "Chat send failures are handled",
+    "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",
     "profile.social-counts": "Profile social counts come from the SDK",
 };
+const platformBindings = (expectationId, sensorsByPlatform) => Object.entries(sensorsByPlatform).flatMap(([platform, sensors]) => (Array.isArray(sensors) ? sensors : [sensors]).map((sensorId) => ({
+    expectationId,
+    sensorId,
+    platform,
+})));
 export const PRODUCT_EXPECTATION_BINDINGS = [
+    ...platformBindings("feed.target-resolved", {
+        typescript: ["typescript.feed.target.literal", "typescript.feed.target-type-explicit"],
+        "react-native": ["react-native.feed.target.literal", "react-native.feed.target-type-explicit"],
+        android: ["android.feed.target.literal", "android.feed.target-type-explicit"],
+        flutter: ["flutter.feed.target.literal", "flutter.feed.target-type-explicit"],
+        ios: ["ios.feed.target.literal", "ios.feed.target-type-explicit"],
+    }),
+    ...platformBindings("feed.ui-states-present", {
+        typescript: "typescript.feed.ui-states-present",
+        "react-native": "react-native.feed.ui-states-present",
+        android: "android.feed.ui-states-present",
+        flutter: "flutter.feed.ui-states-present",
+        ios: "ios.feed.ui-states-present",
+    }),
+    ...platformBindings("feed.pagination-wired", {
+        typescript: "typescript.feed.pagination-wired",
+        "react-native": "react-native.feed.pagination-wired",
+        android: "android.feed.pagination-wired",
+        flutter: "flutter.feed.pagination-wired",
+        ios: "ios.feed.pagination-wired",
+    }),
+    ...platformBindings("moderation.affordance-present", {
+        typescript: [
+            "typescript.feed.moderation-affordance-present",
+            "typescript.comments.moderation-affordance-present",
+            "typescript.chat.moderation-affordance-present",
+        ],
+        "react-native": [
+            "react-native.feed.moderation-affordance-present",
+            "react-native.comments.moderation-affordance-present",
+            "react-native.chat.moderation-affordance-present",
+        ],
+        android: [
+            "android.feed.moderation-affordance-present",
+            "android.comments.moderation-affordance-present",
+            "android.chat.moderation-affordance-present",
+        ],
+        flutter: [
+            "flutter.feed.moderation-affordance-present",
+            "flutter.comments.moderation-affordance-present",
+            "flutter.chat.moderation-affordance-present",
+        ],
+        ios: [
+            "ios.feed.moderation-affordance-present",
+            "ios.comments.moderation-affordance-present",
+            "ios.chat.moderation-affordance-present",
+        ],
+    }),
+    ...platformBindings("posts.status-filtered", {
+        typescript: "typescript.posts.status-filter-applied",
+        "react-native": "react-native.posts.status-filter-applied",
+        android: "android.posts.status-filter-applied",
+        flutter: "flutter.posts.status-filter-applied",
+        ios: "ios.posts.status-filter-applied",
+    }),
+    ...platformBindings("pagination.cursor-opaque", {
+        typescript: "typescript.pagination.cursor-opaque",
+        "react-native": "react-native.pagination.cursor-opaque",
+        android: "android.pagination.cursor-opaque",
+        flutter: "flutter.pagination.cursor-opaque",
+        ios: "ios.pagination.cursor-opaque",
+    }),
+    ...platformBindings("unread.server-synced", {
+        typescript: "typescript.unread.subscribed-not-counted",
+        "react-native": "react-native.unread.subscribed-not-counted",
+        android: "android.unread.subscribed-not-counted",
+        flutter: "flutter.unread.subscribed-not-counted",
+        ios: "ios.unread.subscribed-not-counted",
+    }),
     {
         expectationId: "feed.rich-post-rendering",
         sensorId: "typescript.feed.post-datatype-handled",
@@ -82,6 +168,13 @@ export const PRODUCT_EXPECTATION_BINDINGS = [
         sensorId: "ios.feed.rich-post-composer-surfaced",
         platform: "ios",
     },
+    ...platformBindings("comments.target-resolved", {
+        typescript: "typescript.comments.target-resolved",
+        "react-native": "react-native.comments.target-resolved",
+        android: "android.comments.target-resolved",
+        flutter: "flutter.comments.target-resolved",
+        ios: "ios.comments.target-resolved",
+    }),
     {
         expectationId: "comments.thread-read-write",
         sensorId: "typescript.comments.query-has-limit",
@@ -187,6 +280,34 @@ export const PRODUCT_EXPECTATION_BINDINGS = [
         sensorId: "ios.comments.ui-states-present",
         platform: "ios",
     },
+    ...platformBindings("chat.channel-target-resolved", {
+        typescript: "typescript.chat.channel-target-resolved",
+        "react-native": "react-native.chat.channel-target-resolved",
+        android: "android.chat.channel-target-resolved",
+        flutter: "flutter.chat.channel-target-resolved",
+        ios: "ios.chat.channel-target-resolved",
+    }),
+    ...platformBindings("chat.message-observer-cleanup", {
+        typescript: "typescript.chat.message-observer-cleanup",
+        "react-native": "react-native.chat.message-observer-cleanup",
+        android: "android.chat.message-observer-cleanup",
+        flutter: "flutter.chat.message-observer-cleanup",
+        ios: "ios.chat.message-observer-cleanup",
+    }),
+    ...platformBindings("chat.send-error-handling", {
+        typescript: "typescript.chat.send-error-handling",
+        "react-native": "react-native.chat.send-error-handling",
+        android: "android.chat.send-error-handling",
+        flutter: "flutter.chat.send-error-handling",
+        ios: "ios.chat.send-error-handling",
+    }),
+    ...platformBindings("chat.channel-shape-matched", {
+        typescript: ["typescript.channel.type-matches-shape", "typescript.chat.channel-type-dm"],
+        "react-native": ["react-native.channel.type-matches-shape", "react-native.chat.channel-type-dm"],
+        android: "android.channel.type-matches-shape",
+        flutter: "flutter.channel.type-matches-shape",
+        ios: "ios.channel.type-matches-shape",
+    }),
     {
         expectationId: "chat.unread-visible",
         sensorId: "typescript.chat.unread-visible",
@@ -212,6 +333,16 @@ export const PRODUCT_EXPECTATION_BINDINGS = [
         sensorId: "ios.chat.unread-visible",
         platform: "ios",
     },
+    {
+        expectationId: "chat.message-order-explicit",
+        sensorId: "typescript.chat.sort-explicit",
+        platform: "typescript",
+    },
+    {
+        expectationId: "chat.message-order-explicit",
+        sensorId: "react-native.chat.sort-explicit",
+        platform: "react-native",
+    },
     {
         expectationId: "chat.message-order-explicit",
         sensorId: "android.chat.sort-explicit",

package/package.json

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