@amityco/social-plus-vise 1.6.0 → 1.8.0

package/dist/tools/sensors.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { objectInput, optionalNumberField, optionalStringField, stringField, textResult } from "../types.js";
 import { detectCommandSensors } from "./harness.js";
 import { inspectProject } from "./project.js";
+const maxCapturedOutputChars = 8000;
 export const runSensorsTool = {
     name: "run_sensors",
     description: "Run detected project command sensors, such as build/typecheck/test, with a timeout and structured results.",
@@ -48,8 +49,29 @@ export const runSensorsTool = {
         const include = stringArrayField(args, "include");
         const root = path.resolve(repoPath);
         const inspection = await inspectProject(root, optionalStringField(args, "surfacePath"));
+        if (!inspection.scanCoverage.complete) {
+            return textResult({
+                status: "incomplete-analysis",
+                surfacePath: inspection.selectedSurface?.path,
+                targetPlatforms: inspection.platforms,
+                scanCoverage: inspection.scanCoverage,
+                reason: "Vise could not inspect the complete project inventory, so detected sensors may be incomplete. Narrow the run with --surface/--surface-path.",
+            });
+        }
         const detectedSensors = await detectCommandSensors(inspection.effectiveRoot, inspection.platforms);
         const selectedSensors = include.length > 0 ? detectedSensors.filter((sensor) => include.includes(sensor.name)) : detectedSensors;
+        const unmatched = include.filter((requestedName) => !detectedSensors.some((sensor) => sensor.name === requestedName));
+        if (unmatched.length > 0) {
+            return textResult({
+                status: "invalid-selection",
+                surfacePath: inspection.selectedSurface?.path,
+                targetPlatforms: inspection.platforms,
+                requested: include,
+                unmatched,
+                available: detectedSensors.map((sensor) => sensor.name),
+                reason: `No detected sensor matched: ${unmatched.join(", ")}. Explicit --include selections are strict.`,
+            });
+        }
         if (dryRun) {
             return textResult({
                 status: "dry-run",
@@ -91,35 +113,56 @@ async function runSensor(cwd, sensor, timeoutMs) {
         };
     }
     return new Promise((resolve) => {
-        let stdout = "";
-        let stderr = "";
+        const stdout = { value: "", omitted: 0 };
+        const stderr = { value: "", omitted: 0 };
+        let environmentProbeTail = "";
+        let matchedEnvironmentSkip;
         let settled = false;
         const child = spawn(command, args, {
             cwd,
             shell: false,
             env: process.env,
+            detached: process.platform !== "win32",
         });
+        const observeEnvironmentOutput = (chunk) => {
+            if (!matchedEnvironmentSkip && sensor.environmentSkips?.length) {
+                const probe = `${environmentProbeTail}${chunk}`;
+                matchedEnvironmentSkip = sensor.environmentSkips.find(({ pattern }) => {
+                    try {
+                        return new RegExp(pattern, "i").test(probe);
+                    }
+                    catch {
+                        return false;
+                    }
+                });
+                environmentProbeTail = probe.slice(-4096);
+            }
+        };
         const timeout = setTimeout(() => {
             if (settled) {
                 return;
             }
             settled = true;
-            child.kill("SIGTERM");
+            terminateProcessTree(child);
             resolve({
                 name: sensor.name,
                 command: sensor.command,
                 status: "timed-out",
                 durationMs: Date.now() - startedAt,
-                stdout: truncate(stdout),
-                stderr: truncate(stderr),
+                stdout: capturedOutput(stdout),
+                stderr: capturedOutput(stderr),
                 reason: sensor.timeoutReason ?? `Timed out after ${timeoutMs}ms.`,
             });
         }, timeoutMs);
         child.stdout?.on("data", (chunk) => {
-            stdout += chunk.toString("utf8");
+            const text = chunk.toString("utf8");
+            captureOutput(stdout, text);
+            observeEnvironmentOutput(text);
         });
         child.stderr?.on("data", (chunk) => {
-            stderr += chunk.toString("utf8");
+            const text = chunk.toString("utf8");
+            captureOutput(stderr, text);
+            observeEnvironmentOutput(text);
         });
         child.on("error", (error) => {
             if (settled) {
@@ -127,12 +170,13 @@ async function runSensor(cwd, sensor, timeoutMs) {
             }
             settled = true;
             clearTimeout(timeout);
+            captureOutput(stderr, error.message);
             resolve({
                 name: sensor.name,
                 command: sensor.command,
                 status: "failed",
                 durationMs: Date.now() - startedAt,
-                stderr: truncate(error.message),
+                stderr: capturedOutput(stderr),
                 reason: "Failed to start sensor command.",
             });
         });
@@ -142,29 +186,18 @@ async function runSensor(cwd, sensor, timeoutMs) {
             }
             settled = true;
             clearTimeout(timeout);
-            if (exitCode !== 0 && sensor.environmentSkips?.length) {
-                const combinedOutput = `${stdout}\n${stderr}`;
-                const environmentSkip = sensor.environmentSkips.find(({ pattern }) => {
-                    try {
-                        return new RegExp(pattern, "i").test(combinedOutput);
-                    }
-                    catch {
-                        return false;
-                    }
+            if (exitCode !== 0 && matchedEnvironmentSkip) {
+                resolve({
+                    name: sensor.name,
+                    command: sensor.command,
+                    status: "skipped",
+                    exitCode,
+                    durationMs: Date.now() - startedAt,
+                    stdout: capturedOutput(stdout),
+                    stderr: capturedOutput(stderr),
+                    reason: matchedEnvironmentSkip.reason,
                 });
-                if (environmentSkip) {
-                    resolve({
-                        name: sensor.name,
-                        command: sensor.command,
-                        status: "skipped",
-                        exitCode,
-                        durationMs: Date.now() - startedAt,
-                        stdout: truncate(stdout),
-                        stderr: truncate(stderr),
-                        reason: environmentSkip.reason,
-                    });
-                    return;
-                }
+                return;
             }
             resolve({
                 name: sensor.name,
@@ -172,8 +205,8 @@ async function runSensor(cwd, sensor, timeoutMs) {
                 status: exitCode === 0 ? "passed" : "failed",
                 exitCode,
                 durationMs: Date.now() - startedAt,
-                stdout: truncate(stdout),
-                stderr: truncate(stderr),
+                stdout: capturedOutput(stdout),
+                stderr: capturedOutput(stderr),
             });
         });
     });
@@ -209,9 +242,42 @@ function stringArrayField(input, field) {
     }
     return value.filter((item) => typeof item === "string" && item.trim() !== "");
 }
-function truncate(value, maxLength = 8000) {
-    if (value.length <= maxLength) {
-        return value;
+function captureOutput(output, chunk) {
+    const remaining = Math.max(0, maxCapturedOutputChars - output.value.length);
+    output.value += chunk.slice(0, remaining);
+    output.omitted += Math.max(0, chunk.length - remaining);
+}
+function capturedOutput(output) {
+    if (output.omitted === 0) {
+        return output.value;
     }
-    return `${value.slice(0, maxLength)}\n[truncated ${value.length - maxLength} chars]`;
+    return `${output.value}\n[truncated ${output.omitted} chars]`;
+}
+function terminateProcessTree(child) {
+    if (!child.pid) {
+        child.kill("SIGTERM");
+        return;
+    }
+    if (process.platform === "win32") {
+        const killer = spawn("taskkill", ["/pid", String(child.pid), "/T", "/F"], {
+            stdio: "ignore",
+            windowsHide: true,
+        });
+        killer.unref();
+        return;
+    }
+    try {
+        process.kill(-child.pid, "SIGTERM");
+    }
+    catch {
+        child.kill("SIGTERM");
+    }
+    const forceKill = setTimeout(() => {
+        try {
+            process.kill(-child.pid, "SIGKILL");
+        }
+        catch {
+        }
+    }, 1000);
+    forceKill.unref();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/social-plus-vise",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Skill-guided deterministic CLI for social.plus SDK integration assistance.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -22,7 +22,7 @@
     "ai-coding"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"

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

@@ -103,6 +103,12 @@
           "minLength": 1,
           "description": "Installable social.plus block id for this object. Source of truth for blockIdForObject. Omitted when the object has a surface but no dedicated block (e.g. forum, story). Absent on app-layer/in-development objects."
         },
+        "sdkCapabilities": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "description": "SDK capability ids from Vise's sdk-facts table (vise/src/tools/sdkFacts.ts CAPABILITIES) that ground this object. Declared only when the id exists and `vise sdk-facts` proves it on the TypeScript surface — never guessed; omit when no proven mapping exists (e.g. story, app-layer objects). Consumed by the social.plus blocks catalog gap-report so draft block requests carry proven capability ids instead of a TODO(human) marker."
+        },
         "availability": { "$ref": "#/$defs/availability" }
       }
     },

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

@@ -2,17 +2,17 @@
   "schemaVersion": "0.1.0",
   "status": "seeded",
   "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": "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": "feed", "name": "Feed", "description": "A stream of social posts or updates.", "category": "content", "surface": "feed", "block": "feed", "sdkCapabilities": ["posts"] },
+    { "id": "comment", "name": "Comment", "description": "A response thread attached to content or an object.", "category": "participation", "surface": "comments", "block": "comments", "sdkCapabilities": ["comments"] },
+    { "id": "forum", "name": "Forum", "description": "A structured discussion space optimized for topics and knowledge.", "category": "knowledge", "surface": "feed", "sdkCapabilities": ["posts"] },
+    { "id": "community", "name": "Community", "description": "A persistent group identity around people, content, or purpose.", "category": "identity", "surface": "community", "block": "community", "sdkCapabilities": ["community"] },
+    { "id": "creator", "name": "Creator", "description": "A person or entity that owns an audience relationship.", "category": "identity", "surface": "profile", "block": "profile", "sdkCapabilities": ["users"] },
+    { "id": "profile", "name": "Profile", "description": "A user or creator identity surface with social relationship signals.", "category": "identity", "surface": "profile", "block": "profile", "sdkCapabilities": ["users"] },
+    { "id": "chat", "name": "Chat", "description": "Direct or group conversation.", "category": "conversation", "surface": "chat", "block": "chat", "sdkCapabilities": ["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": "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": "livestream", "name": "Livestream", "description": "Real-time video or audio participation.", "category": "live", "surface": "livestream", "block": "livestream", "sdkCapabilities": ["livestream"] },
+    { "id": "event", "name": "Event", "description": "A scheduled social moment.", "category": "live", "surface": "notifications", "block": "events", "sdkCapabilities": ["events"] },
+    { "id": "rsvp", "name": "RSVP", "description": "A user's intent to attend or participate in an event.", "category": "commitment", "surface": "notifications", "block": "events", "sdkCapabilities": ["events"] },
     { "id": "challenge", "name": "Challenge", "description": "A time-bounded task or contest.", "category": "participation", "availability": "in-development" },
     { "id": "mission", "name": "Mission", "description": "A guided objective that encourages progression.", "category": "progression", "availability": "in-development" },
     { "id": "reward", "name": "Reward", "description": "A benefit or acknowledgement earned through behavior.", "category": "incentive", "availability": "in-development" },
@@ -21,6 +21,6 @@
     { "id": "leaderboard", "name": "Leaderboard", "description": "Ranked comparison between participants.", "category": "competition", "availability": "in-development" },
     { "id": "knowledge", "name": "Knowledge", "description": "Reusable question, answer, guide, or expertise content.", "category": "knowledge" },
     { "id": "prediction", "name": "Prediction", "description": "A user's forecast or choice about a future outcome.", "category": "participation" },
-    { "id": "notification", "name": "Notification", "description": "A timely signal that brings users back to an engagement moment.", "category": "activation", "surface": "notifications", "block": "notifications" }
+    { "id": "notification", "name": "Notification", "description": "A timely signal that brings users back to an engagement moment.", "category": "activation", "surface": "notifications", "block": "notifications", "sdkCapabilities": ["notification-tray"] }
   ]
 }

package/sdk-surface/manifest.json

@@ -63,13 +63,13 @@
     "typescript": {
       "status": "extracted",
       "file": "models.typescript.json",
-      "bytes": 35400,
-      "sha256": "cdd531fe0904d1815f72760450b1c6610be3f72b4c2e1ba80011456c17ab1a6b",
+      "bytes": 102455,
+      "sha256": "8ba407b1d3f0228e6af4a0c5e99e8031950e106295bc64bf5dd67c600a9681e5",
       "fieldsGrounding": "names-and-types",
-      "modelCount": 6,
+      "modelCount": 14,
       "extractor": "vise-ts-model-extractor",
       "extractorVersion": "0.1.0",
-      "extractedAt": "2026-07-06T05:09:06.557Z"
+      "extractedAt": "2026-07-08T06:54:23.130Z"
     },
     "android": {
       "status": "extracted",