@amityco/social-plus-vise 1.2.0 → 1.4.0

package/dist/tools/sdkFacts.js

@@ -174,9 +174,16 @@ export async function getSdkFacts(options) {
         notes: [
             "Symbol facts are existence-only: Vise confirms public symbols in the normalized SDK surface, but semantic correctness and idiomatic usage still require rules, docs, and sensors.",
             modelFacts.facts
-                ? `Field-level model facts are extraction-grounded (${modelFacts.facts.fieldsGrounding}) by ${modelFacts.facts.extraction.extractor}; names-only grounding means the source proves field names but no types.`
+                ? `Field-level model facts are extraction-grounded (${modelFacts.facts.fieldsGrounding}) by ${modelFacts.facts.extraction.extractor}.${modelFacts.facts.fieldsGrounding === "names-only"
+                    ? " names-only grounding means the source proves field names but no types."
+                    : ""}`
                 : "No field-level model facts for this platform snapshot: model claims stay symbol-only (absence over fabrication).",
             "Remote SP_SDK_SURFACE_URL resolution is recorded in the manifest for a future online snapshot source; this MVP uses local override/env/bundled directories only.",
+            ...(platform !== "typescript"
+                ? [
+                    `Capability anchors are authored TypeScript-first at this MVP, so capabilities is empty for ${platform}. This means capability mapping is not yet available on ${platform} — it does NOT mean the SDK lacks the feature. The symbol and model facts above are extracted from the ${platform} surface and remain authoritative.`,
+                ]
+                : []),
         ],
     };
     if (options.includeSymbols) {

package/dist/tools/smoke.js

@@ -0,0 +1,134 @@
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { objectInput, optionalStringField, stringField, textResult } from "../types.js";
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function loadedCount(state) {
+    const match = state.match(/^loaded\b[\s\S]*?\bcount\s*=\s*(\d+)/i);
+    return match ? Number(match[1]) : null;
+}
+export function assessSmokeLog(logText, surfaces) {
+    const results = surfaces.map((surface) => {
+        const re = new RegExp(`VISE_SMOKE\\s+surface=${escapeRegExp(surface.id)}\\s+state=(.+)`, "g");
+        let match;
+        let last;
+        while ((match = re.exec(logText)) !== null)
+            last = match[1].trim();
+        if (last === undefined) {
+            return {
+                surface: surface.id,
+                state: "(no signal)",
+                verdict: "fail",
+                reason: "surface never emitted a VISE_SMOKE state — it did not mount, or the log marker is not wired",
+            };
+        }
+        const isLoaded = /^loaded\b/.test(last);
+        const isResolved = isLoaded || /^empty\b/.test(last);
+        const expect = surface.expect ?? "resolved";
+        const count = loadedCount(last);
+        const ok = expect === "populated" ? isLoaded && count !== null && count > 0 : isResolved;
+        if (ok)
+            return { surface: surface.id, state: last, verdict: "pass" };
+        let reason;
+        if (/^error/.test(last)) {
+            reason = "query errored before the session was ready (session-establish race) — drive it off a reactive readiness signal and retry the transient 'logging in' error";
+        }
+        else if (/^loading/.test(last)) {
+            reason = "surface never left loading — the query was created before the session was ready and did not recover";
+        }
+        else if (expect === "populated" && isLoaded && count === null) {
+            reason = "expected populated proof but the loaded state did not include count=N — emit the visible SDK item count";
+        }
+        else if (expect === "populated" && isLoaded) {
+            reason = `expected populated proof with count > 0 but loaded count=${count}`;
+        }
+        else if (expect === "populated") {
+            reason = "expected populated (loaded) but the surface resolved empty — verify data is present";
+        }
+        else {
+            reason = `surface did not reach a resolved state (state=${last})`;
+        }
+        return { surface: surface.id, state: last, verdict: "fail", reason };
+    });
+    return { results, passed: results.length > 0 && results.every((r) => r.verdict === "pass") };
+}
+async function loadSmokeConfig(repoRoot) {
+    const file = path.join(repoRoot, "sp-vise", "smoke.json");
+    try {
+        const raw = await fs.readFile(file, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed.surfaces))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function smokeCaptureHelp() {
+    return [
+        "Create `sp-vise/smoke.json` with the mounted collection surfaces, for example `{ \"platform\": \"android\", \"surfaces\": [{ \"id\": \"feed\", \"expect\": \"populated\" }] }`.",
+        "Emit `VISE_SMOKE surface=<id> state=loading|empty|loaded count=N|error:<message>` from the real SDK query lifecycle; `expect: \"populated\"` requires loaded count=N with N > 0.",
+        "Android: clear logcat before launch, cold-launch, wait for resolution, then `adb logcat -d -v time | grep VISE_SMOKE > sp-vise/evidence/runtime-smoke.log`.",
+        "iOS: after `simctl launch`, run `xcrun simctl spawn <device> log show --style compact --last 3m --predicate 'eventMessage CONTAINS \"VISE_SMOKE\"' > sp-vise/evidence/runtime-smoke.log`.",
+        "Then run `vise smoke . --log sp-vise/evidence/runtime-smoke.log` and rerun `vise check --ci`.",
+    ].join(" ");
+}
+export const smokeTool = {
+    name: "smoke",
+    description: "Assess a captured runtime mount-smoke log (VISE_SMOKE markers) into a pass/fail verdict and record runtime-smoke evidence. Catches the session-establish race that static check cannot.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            repoPath: { type: "string", description: "Absolute or relative path to the customer repository root." },
+            logPath: {
+                type: "string",
+                description: "Path to a captured runtime log containing `VISE_SMOKE surface=<id> state=<…>` markers (produced by the platform capture harness, e.g. bench/ios-runtime-smoke.sh, cold-launching into each collection surface).",
+            },
+            surface: { type: "string", description: "Optional: assess only this surface id from smoke.json." },
+        },
+        required: ["repoPath", "logPath"],
+        additionalProperties: false,
+    },
+    async call(input) {
+        const args = objectInput(input);
+        const repoRoot = path.resolve(stringField(args, "repoPath"));
+        const logPath = path.resolve(repoRoot, stringField(args, "logPath"));
+        const only = optionalStringField(args, "surface");
+        const config = await loadSmokeConfig(repoRoot);
+        if (!config) {
+            return textResult({
+                status: "no-config",
+                note: `No sp-vise/smoke.json found. ${smokeCaptureHelp()}`,
+            });
+        }
+        let logText;
+        try {
+            logText = await fs.readFile(logPath, "utf8");
+        }
+        catch {
+            return textResult({ status: "no-log", note: `Could not read captured log at ${logPath}. ${smokeCaptureHelp()}` });
+        }
+        const surfaces = only ? config.surfaces.filter((s) => s.id === only) : config.surfaces;
+        if (surfaces.length === 0) {
+            return textResult({ status: "no-surfaces", note: only ? `Surface '${only}' is not declared in smoke.json.` : "smoke.json declares no surfaces." });
+        }
+        const assessment = assessSmokeLog(logText, surfaces);
+        try {
+            const evidenceDir = path.join(repoRoot, "sp-vise", "evidence");
+            await fs.mkdir(evidenceDir, { recursive: true });
+            await fs.writeFile(path.join(evidenceDir, "runtime-smoke.json"), JSON.stringify({ passed: assessment.passed, platform: config.platform, results: assessment.results }, null, 2));
+        }
+        catch {
+        }
+        return textResult({
+            status: assessment.passed ? "passed" : "failed",
+            platform: config.platform,
+            results: assessment.results,
+            ...(assessment.passed
+                ? {}
+                : { note: "Runtime mount-smoke FAILED — at least one collection surface did not reach a resolved state on cold-launch (session-establish race). This is invisible to `vise check`." }),
+        });
+    },
+};

package/dist/tools/uxHarness.js

@@ -111,6 +111,7 @@ export function uxHarnessPlanContext(harness, outcome) {
         antiPatterns,
         implementationGuidance: [
             `Preserve the selected variant's UX pattern(s): ${harness.uxPatterns.map((pattern) => pattern.name).join(", ") || "(none)"}.`,
+            "Keep Vise, SDK, intake, scope, dogfood, and auth/debug vocabulary in implementation notes, evidence, or dev-only diagnostics; visible app copy should use the host product's language.",
             ...expectations.slice(0, 6).map((expectation) => `${expectation.title}: ${expectation.guidance}`),
             ...(antiPatterns.length > 0
                 ? [`Avoid these UX anti-patterns: ${antiPatterns.slice(0, 4).map((item) => item.warning).join("; ")}.`]
@@ -142,6 +143,7 @@ export async function assessUxHarness(effectiveRoot, harness, outcome) {
         };
     }
     const corpus = await collectSourceCorpus(effectiveRoot);
+    const copyRisks = productionCopyRisksFor(corpus);
     const assessed = expectations.map((expectation) => {
         const evidence = evidenceFor(expectation, corpus);
         return {
@@ -158,7 +160,10 @@ export async function assessUxHarness(effectiveRoot, harness, outcome) {
         acc[item.status] = (acc[item.status] ?? 0) + 1;
         return acc;
     }, {});
-    const status = assessed.some((item) => item.status === "needs-review" && item.priority === "high")
+    if (copyRisks.length > 0) {
+        summary["copy-risk"] = copyRisks.length;
+    }
+    const status = copyRisks.length > 0 || assessed.some((item) => item.status === "needs-review" && item.priority === "high")
         ? "needs-review"
         : "evidence-found";
     return {
@@ -166,9 +171,10 @@ export async function assessUxHarness(effectiveRoot, harness, outcome) {
         harnessPath: "sp-vise/ux-harness.json",
         advisoryOnly: advisoryOnlyText(),
         assessedExpectations: assessed,
+        ...(copyRisks.length > 0 ? { copyRisks } : {}),
         summary,
         nextStep: status === "needs-review"
-            ? "Review UX Harness needs-review items with the user or host agent. They are advisory and do not affect `vise check` exit codes."
+            ? "Review UX Harness needs-review items and production-copy risks with the user or host agent. They are advisory and do not affect `vise check` exit codes."
             : "UX Harness advisory evidence was found. Keep reviewing visually before claiming production UX quality.",
     };
 }
@@ -224,13 +230,13 @@ async function readCreativeSelectionSidecar(repoRoot) {
         raw = await readFile(filePath, "utf8");
     }
     catch {
-        throw new Error(`Unable to read ${rel}. Run \`vise creative accept . --variant <id>\` first.`);
+        throw new Error(`Unable to read ${rel}. Run \`vise creative accept . --variant <id> --rationale "<why>" --confidence high\` first.`);
     }
     try {
         return JSON.parse(raw);
     }
     catch {
-        throw new Error(`${rel} is present but could not be parsed (corrupt JSON). Re-run \`vise creative accept . --variant <id>\` to regenerate it.`);
+        throw new Error(`${rel} is present but could not be parsed (corrupt JSON). Re-run \`vise creative accept . --variant <id> --rationale "<why>" --confidence high\` to regenerate it.`);
     }
 }
 async function writeUxHarness(repoRoot, harness) {
@@ -331,6 +337,7 @@ function surfaceIdForOutcome(outcome) {
 async function collectSourceCorpus(root) {
     const filesByHint = new Map();
     const chunks = [];
+    const corpusFiles = [];
     const files = await sourceFiles(root);
     for (const file of files) {
         const text = await readFile(file, "utf8").catch(() => "");
@@ -339,6 +346,7 @@ async function collectSourceCorpus(root) {
         }
         const lower = text.toLowerCase();
         chunks.push(lower);
+        corpusFiles.push({ path: repoRelativePath(root, file), lower });
         for (const hint of UX_EVIDENCE_HINTS) {
             if (!lower.includes(hint)) {
                 continue;
@@ -349,7 +357,7 @@ async function collectSourceCorpus(root) {
             filesByHint.set(hint, existing);
         }
     }
-    return { text: chunks.join("\n"), filesByHint };
+    return { text: chunks.join("\n"), filesByHint, files: corpusFiles };
 }
 async function sourceFiles(root) {
     const result = [];
@@ -395,6 +403,32 @@ function evidenceFor(expectation, corpus) {
     }
     return { hints, files: [...files].sort().slice(0, 8) };
 }
+function productionCopyRisksFor(corpus) {
+    const filesByTerm = new Map();
+    for (const file of corpus.files) {
+        for (const term of PRODUCTION_COPY_RISK_TERMS) {
+            if (!file.lower.includes(term)) {
+                continue;
+            }
+            const existing = filesByTerm.get(term) ?? new Set();
+            existing.add(file.path);
+            filesByTerm.set(term, existing);
+        }
+    }
+    const riskyTerms = [...filesByTerm.keys()].sort();
+    if (riskyTerms.length === 0) {
+        return [];
+    }
+    return [
+        {
+            status: "needs-review",
+            title: "Visible app copy may expose Vise planning or debug vocabulary",
+            terms: riskyTerms,
+            files: [...new Set(riskyTerms.flatMap((term) => [...(filesByTerm.get(term) ?? [])]))].sort().slice(0, 12),
+            guidance: "Rewrite customer-visible labels and descriptions into the host product language, and move SDK/session/scope/dogfood details to comments, handoff notes, or dev-only diagnostics.",
+        },
+    ];
+}
 function projectSummary(inspection) {
     return {
         repoRoot: inspection.repoRoot,
@@ -475,11 +509,12 @@ const UX_PATTERN_PRESETS = {
         expectations: [
             expectation("embedded-feed-context", "Feed appears near the host context it supports", "high", ["feed"], "Place the feed close to the product, content, home, or detail context it enriches.", ["feed", "postrepository", "targetid", "targettype", "communityid", "userid"]),
             expectation("embedded-feed-composer-scope", "Feed composer or read-only scope is explicit", "high", ["feed"], "If creation is in scope, expose a composer with clear target scope; otherwise state that the feed is read-only.", ["composer", "createpost", "readonly", "read only", "postrepository.createpost"]),
+            expectation("embedded-feed-post-body", "Post cards render the body content", "high", ["feed"], "Render each post's normal body/description/caption when present instead of making postId or counts the primary card content. A title field is optional; do not require metadata/custom title payloads just to satisfy rendering.", ["post.data.text", "gettext", "description", "caption", "postbody", "postcontent"]),
             expectation("embedded-feed-rich-post-rendering", "Rich post types render as rich content when in scope", "medium", ["feed"], "If the feed includes image, video, file, poll, or shared parent-child posts, render them as rich content with media/poll/quoted UI and loading/fallback states instead of flattening every post to plain text. The deterministic feed.rich-post-rendering sensor (parent-child-rendered / post-datatype-handled) provides platform evidence.", ["getimageinfo", "getfileinfo", "fileinfo", "imageinfo", "getpoll", "poll", "parent", "children", "mediarepository", "thumbnail"]),
             expectation("embedded-feed-rich-post-create", "Composer surfaces rich post create affordances when in scope", "medium", ["feed"], "If image, file, or poll creation is in scope, surface those affordances in the composer rather than only a plain text input. The deterministic feed.rich-post-composer-scope sensor provides platform evidence.", ["imagepicker", "pickimage", "mediapicker", "createpoll", "create poll", "addimage", "imageupload", "attachimage"]),
         ],
         tradeoffs: ["Fits existing journeys without adding navigation", "Can be overlooked if buried too far below primary content"],
-        antiPatterns: ["Feed disconnected from the host object", "Composer creates into an unclear target", "Rich posts (image/video/poll/parent-child) flattened to plain text", "Composer limited to text when richer creation is in scope"],
+        antiPatterns: ["Feed disconnected from the host object", "Composer creates into an unclear target", "Vise/intake/debug labels exposed as visible product copy", "Rich posts (image/video/poll/parent-child) flattened to plain text", "Composer limited to text when richer creation is in scope"],
     },
     "contextual-comment-tray": {
         expectations: [
@@ -547,3 +582,16 @@ const UX_PATTERN_PRESETS = {
     },
 };
 const UX_EVIDENCE_HINTS = Array.from(new Set(Object.values(UX_PATTERN_PRESETS).flatMap((preset) => preset.expectations.flatMap((expectation) => expectation.evidenceHints)))).sort();
+const PRODUCTION_COPY_RISK_TERMS = [
+    "composer scope",
+    "current signed-in social plus",
+    "dev/testing",
+    "dogfood",
+    "engagement scope",
+    "feed target resolved",
+    "post type scope",
+    "resolved against",
+    "sdk path",
+    "social plus user feed",
+    "target: your current social plus",
+].sort();

package/dist/uikitCustomization.js

@@ -4,7 +4,7 @@ const SIGNALS = [
         level: "dynamic-ui",
         label: "Minimal, server-driven brand or theme updates",
         strength: "strong",
-        pattern: /\b(dynamic ui|remote config|network config|syncNetworkConfig|without (?:an? )?(?:app )?(?:release|update|rebuild)|real[-\s]?time theme|brand colors?|theme tokens?|palette|console[-\s]?driven)\b/i,
+        pattern: /\b(dynamic ui|remote config|network config|syncNetworkConfig|without (?:an? )?(?:app )?(?:release|update|rebuild)|(?:with no|no)\s+(?:an? )?(?:app )?(?:release|rebuild|re-?deploy(?:ment)?|deploy)|real[-\s]?time theme|brand colors?|theme tokens?|palette|console[-\s]?driven)\b/i,
     },
     {
         id: "component-styling",
@@ -39,7 +39,7 @@ const SIGNALS = [
         level: "sdk-custom-ui",
         label: "Custom UI beyond UIKit's customization model",
         strength: "strong",
-        pattern: /\b(totally different ui|brand[-\s]?new ui|bespoke ui|unique ui|complete design freedom|build from scratch|hand[-\s]?rolled)\b/i,
+        pattern: /\b(totally different ui|brand[-\s]?new ui|bespoke ui|unique ui|complete design freedom|build from scratch|hand[-\s]?rolled)\b|\b(?:our|my|their|its|your)\s+own\s+(?:\w+\s+){0,2}?(?:component(?:\s+tree)?|components?|screens?|widgets?|ui)\b/i,
     },
     {
         id: "basic-theme",
@@ -71,6 +71,10 @@ const SOURCE_EVIDENCE = [
     "Local UIKit source study: Web provider exposes configs, pageBehavior, syncNetworkConfig, and localization props; React Native, Android, and Flutter repos use config files plus behavior managers/providers.",
 ];
 const FEATURE_CAPABILITY = /\b(livestream(?:ing)?|live[-\s]?stream(?:ing)?|video call(?:ing|s)?|voice call(?:ing|s)?|video chat|broadcast(?:ing)?|go live)\b/i;
+const SERVER_DRIVEN_ORIGIN = /\b(remote config|network config|syncNetworkConfig|real[-\s]?time theme|server[-\s]?driven|(?:without|with no|no)\s+(?:an? )?(?:app )?(?:release|rebuild|re-?deploy(?:ment)?|deploy)|update(?:d|s)? remotely|remotely (?:update|change|configure|manage)\w*)\b/i;
+const BUNDLED_CONFIG_ORIGIN = /\b(config\.json|uikit\.config|bundled config|config file)\b/i;
+const THEME_TOKEN_STYLING = /\b(primary_color|preferred_theme|dark mode|light mode|brand colors?|palette|theme)\b/i;
+const STRUCTURAL_STYLING = /\b((?:hide|remove)\b|exclu(?:de|des|ded|ding|sion|sions)|button text|icons?|page id|component id|element id|reactions?|feature flags?)\b/i;
 export function recommendUIKitCustomization(args) {
     const answers = args.answers ?? {};
     const request = typeof args.request === "string" ? args.request : "";
@@ -84,7 +88,8 @@ export function recommendUIKitCustomization(args) {
     const solutionNeedsUIKitAttention = args.solutionPath?.recommendation === "uikit" ||
         args.solutionPath?.recommendation === "hybrid" ||
         args.solutionPath?.recommendation === "needs-decision";
-    if (!explicitAnswer && args.solutionPath?.recommendation === "sdk") {
+    const sp = args.solutionPath;
+    if (!explicitAnswer && sp?.recommendation === "sdk" && (sp.signals.sdk.length > 0 || !hasCustomizationSignal)) {
         return undefined;
     }
     if (!explicitAnswer && !unrecognizedExplicitAnswer && (!hasCustomizationSignal || sdkCustomUiOnly) && !solutionNeedsUIKitAttention) {
@@ -94,7 +99,7 @@ export function recommendUIKitCustomization(args) {
     const matchedLevels = levelsFromMatches(matches);
     const answeredLevel = explicitAnswer;
     const recommendedLevel = answeredLevel
-        ?? (unrecognizedExplicitAnswer || featureCapabilityOnly ? "needs-decision" : chooseRecommendedLevel(matches, args.solutionPath));
+        ?? (unrecognizedExplicitAnswer || featureCapabilityOnly ? "needs-decision" : chooseRecommendedLevel(matches, request, args.solutionPath));
     const additionalLevels = matchedLevels.filter((level) => level !== recommendedLevel);
     const status = statusFor(recommendedLevel, matchedLevels, args.solutionPath, explicitAnswer, unrecognizedExplicitAnswer);
     const confidence = confidenceFor({ explicitAnswer, matches, recommendedLevel, status, solutionPath: args.solutionPath, unrecognizedExplicitAnswer });
@@ -127,9 +132,11 @@ export function recommendUIKitCustomization(args) {
         advisoryOnly: "This is advisory UIKit customization guidance. It does not change outcome classification, compliance rules, sidecar schema, or `vise check` exit codes.",
     };
 }
+const NEGATED_CUSTOM_CODE = /\b(?:do not|don'?t|dont|won'?t|wont|can'?t|cant|cannot|no|without|not|never|avoid|skip)\b(?:\s+\w+){0,3}?\s+(?:run\s+)?custom\s+(?:code|handler|action)\b/gi;
 function collectSignals(request) {
+    const cleaned = request.replace(NEGATED_CUSTOM_CODE, " ");
     return SIGNALS.flatMap((signal) => {
-        const match = request.match(signal.pattern);
+        const match = cleaned.match(signal.pattern);
         if (!match?.[0]) {
             return [];
         }
@@ -162,7 +169,7 @@ function levelsFromMatches(matches) {
         "sdk-custom-ui",
     ].filter((level) => matches.some((match) => match.level === level));
 }
-function chooseRecommendedLevel(matches, solutionPath) {
+function chooseRecommendedLevel(matches, request, solutionPath) {
     const matchedLevels = levelsFromMatches(matches);
     const strongLevels = levelsFromMatches(matches.filter((match) => match.strength === "strong"));
     const pool = strongLevels.length > 0 ? strongLevels : matchedLevels;
@@ -175,6 +182,14 @@ function chooseRecommendedLevel(matches, solutionPath) {
     if (pool.includes("behavior-overrides")) {
         return "behavior-overrides";
     }
+    if (pool.includes("dynamic-ui") &&
+        pool.includes("component-styling") &&
+        SERVER_DRIVEN_ORIGIN.test(request) &&
+        !BUNDLED_CONFIG_ORIGIN.test(request) &&
+        THEME_TOKEN_STYLING.test(request) &&
+        !STRUCTURAL_STYLING.test(request)) {
+        return "dynamic-ui";
+    }
     if (pool.includes("component-styling")) {
         return "component-styling";
     }
@@ -317,6 +332,7 @@ function platformGuidanceFor(platform) {
     return [
         "Web/TypeScript UIKit: pass local config through `AmityUIKitProvider configs`, enable `syncNetworkConfig` for Dynamic UI, pass `pageBehavior` for navigation/action overrides, and use the `localization` prop for locale bundles or string overrides.",
         "Web source anchors: `Amity-Social-Cloud-UIKit-Web/readme.md`, `src/v4/core/providers/AmityUIKitProvider.tsx`, `src/v4/core/providers/CustomizationProvider`, `src/v4/core/providers/PageBehaviorProvider.tsx`, and `src/v4/constants/customization.ts`.",
+        "Web/TypeScript UIKit install caveats (npm + bundler): (1) the published UIKit (`@amityco/ui-kit-open-source`) has peer-dependency ranges that conflict with `@amityco/ts-sdk`, so `npm install` may need `--legacy-peer-deps`; (2) it pulls `react-intl`, which requires `tslib` — install `tslib` explicitly, or a modern bundler (Vite 8 / rolldown, esbuild) hard-fails the build with an unresolved `tslib`; (3) a partial `configs` theme can trip the exported `ConfigurableThemeValue` type (it expects the full color-slot set) — provide all slots or cast. These are install/build-time only and do not affect compliance.",
     ];
 }
 function labelForLevel(level) {

package/dist/version.js

@@ -1,9 +1,9 @@
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+export const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 function readPackageMetadata() {
-    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageJsonPath = path.resolve(moduleDir, "..", "package.json");
+    const packageJsonPath = path.join(packageRoot, "package.json");
     const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8"));
     if (typeof parsed.name !== "string" || typeof parsed.version !== "string") {
         throw new Error(`Invalid package metadata in ${packageJsonPath}.`);
@@ -17,3 +17,7 @@ const packageMetadata = readPackageMetadata();
 export const packageName = packageMetadata.name;
 export const packageVersion = packageMetadata.version;
 export const packageUserAgent = `social-plus-vise/${packageVersion}`;
+export function detectBuildSource(root) {
+    return existsSync(path.join(root, "src")) ? "local" : "published";
+}
+export const buildSource = detectBuildSource(packageRoot);

package/package.json

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

package/packages/intelligence/catalog/catalog.schema.json

@@ -95,7 +95,7 @@
           "description": "Free vocabulary today (the guard does not enum it). Current values: content, participation, knowledge, identity, conversation, live, commitment, progression, incentive, recognition, competition, activation."
         },
         "surface": {
-          "enum": ["feed", "comments", "chat", "profile", "community", "notifications"],
+          "enum": ["feed", "livestream", "comments", "chat", "profile", "community", "notifications"],
           "description": "UI surface this object is placed on. Present only on SDK-backed objects (its presence is what makes an object SOCIAL_PLUS_OBJECTS). Source of truth for outcomesForObjects/surfaceIdsForObjects/CREATIVE_SURFACE_HINTS, derived in src/intelligence/placement.ts. The surface set is closed (each is bound to an Outcome in code) — adding a new surface is an engine decision, not a catalog edit."
         },
         "block": {

package/packages/intelligence/catalog/experience-objects.json

@@ -4,13 +4,13 @@
   "items": [
     { "id": "feed", "name": "Feed", "description": "A stream of social posts or updates.", "category": "content", "surface": "feed", "block": "feed" },
     { "id": "comment", "name": "Comment", "description": "A response thread attached to content or an object.", "category": "participation", "surface": "comments", "block": "comments" },
-    { "id": "forum", "name": "Forum", "description": "A structured discussion space optimized for topics and knowledge.", "category": "knowledge", "surface": "community" },
+    { "id": "forum", "name": "Forum", "description": "A structured discussion space optimized for topics and knowledge.", "category": "knowledge", "surface": "feed" },
     { "id": "community", "name": "Community", "description": "A persistent group identity around people, content, or purpose.", "category": "identity", "surface": "community", "block": "community" },
     { "id": "creator", "name": "Creator", "description": "A person or entity that owns an audience relationship.", "category": "identity", "surface": "profile", "block": "profile" },
     { "id": "profile", "name": "Profile", "description": "A user or creator identity surface with social relationship signals.", "category": "identity", "surface": "profile", "block": "profile" },
     { "id": "chat", "name": "Chat", "description": "Direct or group conversation.", "category": "conversation", "surface": "chat", "block": "chat" },
     { "id": "story", "name": "Story", "description": "Ephemeral or sequenced media updates.", "category": "content", "surface": "feed" },
-    { "id": "livestream", "name": "Livestream", "description": "Real-time video or audio participation.", "category": "live", "surface": "feed", "block": "livestream" },
+    { "id": "livestream", "name": "Livestream", "description": "Real-time video or audio participation.", "category": "live", "surface": "livestream", "block": "livestream" },
     { "id": "event", "name": "Event", "description": "A scheduled social moment.", "category": "live", "surface": "notifications", "block": "events" },
     { "id": "rsvp", "name": "RSVP", "description": "A user's intent to attend or participate in an event.", "category": "commitment", "surface": "notifications", "block": "events" },
     { "id": "challenge", "name": "Challenge", "description": "A time-bounded task or contest.", "category": "participation", "availability": "in-development" },

package/packages/intelligence/catalog/variants.json

@@ -127,6 +127,30 @@
       "uxPatternIds": ["dedicated-community-tab", "event-center"],
       "tradeoffs": ["serves fitness retention today on shipped primitives, without gamification", "competition/streak mechanics arrive when social.plus gamification ships"],
       "whenToChoose": "Choose for a fitness or wellness community on shipped primitives: group classes, live workout sessions, an events calendar, and a space for peer accountability with member profiles. Best when retention comes from showing up together, with no competition or streak/points mechanics."
+    },
+    {
+      "id": "messaging-first",
+      "name": "Messaging First",
+      "description": "Make real-time conversation the primary social surface: 1:1 and group messaging with an inbox as the home base.",
+      "businessGoalIds": ["participation", "retention"],
+      "archetypeIds": ["enterprise", "gaming", "media-streaming", "education"],
+      "solutionPatternIds": ["peer-support", "live-participation"],
+      "experienceObjectIds": ["chat", "profile", "notification", "community"],
+      "uxPatternIds": ["inbox-first-chat"],
+      "tradeoffs": ["fastest path to daily active conversation and retention", "needs presence/notification investment and moderation for direct messages"],
+      "whenToChoose": "Choose when direct conversation is the primary destination: 1:1 and group chat, messaging/DMs, an inbox or threads as the home surface, real-time presence and typing. Best when people come to talk to each other rather than to browse a feed."
+    },
+    {
+      "id": "social-graph-first",
+      "name": "Social Graph First",
+      "description": "Make following people and creators the backbone: rich profiles and a follow/unfollow graph that powers a personalized following feed.",
+      "businessGoalIds": ["creator-growth", "retention", "participation"],
+      "archetypeIds": ["creator", "media-streaming", "fitness", "loyalty"],
+      "solutionPatternIds": ["audience-ownership", "recognition"],
+      "experienceObjectIds": ["profile", "creator", "feed", "notification"],
+      "uxPatternIds": ["profile-social-header"],
+      "tradeoffs": ["personalized, relationship-driven distribution that compounds with each follow", "cold-start risk until users follow enough accounts to fill the following feed"],
+      "whenToChoose": "Choose when the follow relationship is the backbone of the experience: user and creator profiles, follow/unfollow, a personalized following feed, and follower-driven notifications. Best when distribution should come from who you follow rather than from a single shared community feed."
     }
   ]
 }

package/rules/event.yaml

@@ -5,6 +5,7 @@
     {
       "id": "typescript.event.live-collection",
       "version": 1,
+      "symbol_anchored": { "platform": "typescript", "types": ["EventRepository"], "members": ["getEvents"], "basis": "names-only" },
       "title": "TypeScript event calendars / attendee lists should use the reactive Event LiveCollection",
       "severity": "warning",
       "rationale": "Event calendars (getEvents) and attendee/RSVP lists (getRSVPs) are Live Collections — rsvpCount and the going/not-going roster update as people RSVP. A one-shot fetch (no callback) renders a list that never updates. Pass the live callback: EventRepository.getEvents(params, callback).",
@@ -18,6 +19,7 @@
     {
       "id": "android.event.live-collection",
       "version": 1,
+      "symbol_anchored": { "platform": "android", "types": ["AmityEventRepository"], "members": ["getEvents"], "basis": "names-only" },
       "title": "Android event calendars / attendee lists should use the reactive Event LiveCollection",
       "severity": "warning",
       "rationale": "Event calendars (getEvents) and attendee/RSVP lists (getRSVPs) are Live Collections — rsvpCount and the going/not-going roster update as people RSVP. A one-shot fetch renders a list that never updates. Observe the collection instead (PagingData via .doOnNext { ... }.subscribe(), or getRSVPs(...).observe()).",
@@ -31,6 +33,7 @@
     {
       "id": "ios.event.live-collection",
       "version": 1,
+      "symbol_anchored": { "platform": "ios", "types": ["AmityEventRepository"], "members": ["getEvents"], "basis": "names-only" },
       "title": "iOS event calendars / attendee lists should use the reactive Event LiveCollection",
       "severity": "warning",
       "rationale": "Event calendars (getEvents) and attendee/RSVP lists (getRSVPs) are Live Collections — rsvpCount and the going/not-going roster update as people RSVP. A one-shot snapshot renders a list that never updates. Observe the collection instead: getEvents(...).observe { ... } / getRSVPs(...).observe { ... }.",