@amityco/social-plus-vise 0.14.17 → 0.14.18

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.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.18 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. |
+| **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. |
-| **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. |
+| **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",

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",
@@ -789,7 +795,8 @@ const addComments = {
         "no invented postId/commentId",
         `${platform}.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." },
@@ -1021,7 +1028,9 @@ const addChat = {
         `${platform}.chat.channel-target-resolved`,
         `${platform}.chat.message-observer-cleanup`,
         `${platform}.chat.send-error-handling`,
-        `${platform}.chat.moderation-affordance-present`,
+        "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,4 +1,11 @@
 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.thread-read-write": "Comment threads support reading and creation",
@@ -6,7 +13,81 @@ export const PRODUCT_EXPECTATION_TITLES = {
     "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",

package/package.json

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