@amityco/social-plus-vise 0.14.16 → 0.14.18

package/CHANGELOG.md

@@ -4,6 +4,27 @@ 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
+- **Product-first plan rules:** `vise plan` now shows shared product expectation IDs as primary `applicableRules[].rule_id` values when a rule is backed by platform-specific sensors, while preserving the exact `contract_rule_id`, `contract_rule_digest`, and `validator.sensorId` evidence needed for debugging and attestations.
+
+### Fixed
+- **Design rejection flow coverage:** the host-agent smoke now locks the behavior where `design_contract_confirmation=no` rejects the preview, withholds the design contract from feed-forward, asks for a replacement design source, and blocks `vise init` until that source is resolved.
+
+### Verified
+- Full `npm run validate` passed. A local iOS `whoops` plan smoke confirmed shared chat ids are public while iOS sensor ids remain as validator evidence.
+
 ## 0.14.16 — 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,93 @@
+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",
+    "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",
@@ -266,6 +355,9 @@ export function productFindingIdentity(sensorId) {
 export function publicProductRuleId(ruleId) {
     return productExpectationBindingForSensor(ruleId)?.expectationId ?? ruleId;
 }
+export function productExpectationTitle(expectationId) {
+    return PRODUCT_EXPECTATION_TITLES[expectationId];
+}
 export function findingMatchesId(finding, id) {
     return finding.ruleId === id || finding.sensorId === id;
 }

package/dist/tools/compliance.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { assessProjectCompleteness, assessProjectSelectedOptionalCapabilities, availableOptionalCapabilityIds, optionalCapabilityChecklist, platformCapabilityAvailability, selectedOptionalCapabilityIds, } from "../capabilities.js";
 import { getOutcomeDefinition, hasAnswer, planContextFor, resolveOutcome, } from "../outcomes.js";
-import { contractRuleCandidatesForPublicId, hasMultipleContractRuleCandidates, productExpectationBindingForSensor, publicProductRuleId, } from "../productExpectations.js";
+import { contractRuleCandidatesForPublicId, hasMultipleContractRuleCandidates, productExpectationBindingForSensor, productExpectationTitle, publicProductRuleId, } from "../productExpectations.js";
 import { objectInput, optionalBooleanField, optionalStringField, stringField, textResult } from "../types.js";
 import { packageVersion } from "../version.js";
 import { DESIGN_CONTRACT_CONFIRMATION_ANSWER_ID, buildDesignBrief, designContractConfirmationFromAnswers, designPreviewPath, readDesignContract, } from "./design.js";
@@ -476,6 +476,9 @@ function preferredPlatform(platforms) {
 export async function applicableComplianceRuleSummaries(outcome, platforms) {
     return (await applicableRules(outcome, platforms)).map(ruleRefForFile);
 }
+export async function applicableCompliancePlanRuleSummaries(outcome, platforms) {
+    return (await applicableRules(outcome, platforms)).map(ruleRefForPlan);
+}
 export async function checkCompliance(repoPath) {
     const repoRoot = path.resolve(repoPath);
     const compliance = await readCompliance(repoRoot);
@@ -932,6 +935,28 @@ function ruleRefForFile(rule) {
         title: rule.title,
     };
 }
+function ruleRefForPlan(rule) {
+    const publicRuleId = publicProductRuleId(rule.id);
+    const base = ruleRefForFile(rule);
+    if (publicRuleId === rule.id) {
+        return base;
+    }
+    const binding = productExpectationBindingForSensor(rule.id);
+    return {
+        ...base,
+        rule_id: publicRuleId,
+        public_rule_id: publicRuleId,
+        title: productExpectationTitle(publicRuleId) ?? rule.title,
+        contract_rule_id: rule.id,
+        contract_rule_digest: base.rule_digest,
+        validator: binding
+            ? {
+                platform: binding.platform,
+                sensorId: binding.sensorId,
+            }
+            : undefined,
+    };
+}
 // Benchmark-measured friction: agents looped on attest dialect for ~25 min/cell when docs and SDK
 // disagreed on exact invocation syntax (capability-matrix 2026-06, Row 5). Hand them the exact incantation.
 function attestHint(rule, compliance) {

package/dist/tools/integration.js

@@ -3,7 +3,7 @@ import path from "node:path";
 import { BROAD_SOCIAL_REGEX, DESIGN_REGEX, getOutcomeDefinition, hasAnswer, planContextFor, resolveOutcome, } from "../outcomes.js";
 import { objectInput, optionalStringField, stringField, textResult } from "../types.js";
 import { availableOptionalCapabilityIds, capabilityChecklist, optionalCapabilityChecklist, platformCapabilityAvailability, selectedOptionalCapabilityIds, } from "../capabilities.js";
-import { applicableComplianceRuleSummaries } from "./compliance.js";
+import { applicableCompliancePlanRuleSummaries } from "./compliance.js";
 import { DESIGN_CONTRACT_CONFIRMATION_ANSWER_ID, buildDesignBrief, designContractConfirmationFromAnswers, designPreviewPath, readDesignContract, } from "./design.js";
 import { sdkVersionGuidance } from "./sdkVersion.js";
 import { detectCommandSensors } from "./harness.js";
@@ -121,7 +121,7 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
         docs: definition.docs(platform).filter((doc) => doc.path !== "unknown"),
         surface: inspection.selectedSurface ? { path: inspection.selectedSurface.path, platforms: inspection.selectedSurface.platforms } : undefined,
         availableSurfaces: inspection.surfaces,
-        applicableRules: await applicableComplianceRuleSummaries(outcome, inspection.platforms),
+        applicableRules: await applicableCompliancePlanRuleSummaries(outcome, inspection.platforms),
         sensors: sensors.map((sensor) => ({ name: sensor.name, command: sensor.command, source: sensor.source })),
         stopConditions: composeStopConditions(ctx, definition.stopConditions(ctx), inspection.surfaces, surfacePath),
         evidencePolicy: "Every implementation step must cite at least one detected file, docs page, validator rule, or required user input. If evidence is missing, stop and ask the user instead of inventing details.",

package/package.json

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