@amityco/social-plus-vise 0.14.18 → 0.14.19

package/CHANGELOG.md

@@ -4,6 +4,16 @@ 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

package/README.md

@@ -161,15 +161,15 @@ Aggregate: **98/99 expected feed capabilities** and **27/27 selected optional ca
 
 ### Current Release Validation
 
-Version 0.14.18 carries current release proof around the full feed-forward, product-expectation, 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 `feed.target-resolved`, `moderation.affordance-present`, `comments.thread-read-write`, and `chat.unread-visible` 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. |
+| **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

@@ -569,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",
@@ -581,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

@@ -793,7 +793,7 @@ const addComments = {
     validation: (platform) => [
         "comment target resolved",
         "no invented postId/commentId",
-        `${platform}.comments.target-resolved`,
+        "comments.target-resolved",
         "comments.thread-read-write",
         "moderation.affordance-present",
         "pagination.cursor-opaque",
@@ -1025,9 +1025,10 @@ const addChat = {
         ];
     },
     validation: (platform) => [
-        `${platform}.chat.channel-target-resolved`,
-        `${platform}.chat.message-observer-cleanup`,
-        `${platform}.chat.send-error-handling`,
+        "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",

package/dist/productExpectations.js

@@ -8,7 +8,12 @@ export const PRODUCT_EXPECTATION_TITLES = {
     "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",
@@ -163,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",
@@ -268,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",
@@ -293,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.18",
+  "version": "0.14.19",
   "description": "Skill-guided deterministic CLI for social.plus SDK integration assistance.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",