sf-intelligence 0.1.16 → 0.1.17

package/dist/index.js

@@ -57375,6 +57375,7 @@ var init_synthesize_answer = __esm({
       let ungroundedAnnotationClaims;
       let grounded;
       let ungroundedAbsenceClaims;
+      const evidenceEmpty = source === void 0 || source === null || typeof source === "string" && source.trim().length === 0 || Array.isArray(source) && source.length === 0 || typeof source === "object" && !Array.isArray(source) && Object.keys(source).length === 0;
       if (input2.draft !== void 0) {
         const draftIds = [...new Set(input2.draft.match(CANONICAL_ID_INLINE) ?? [])];
         groundedIds = draftIds.filter((id) => out.ids.has(id)).sort();
@@ -57384,6 +57385,10 @@ var init_synthesize_answer = __esm({
         const absenceClaims = findAbsenceClaims(input2.draft);
         ungroundedAbsenceClaims = out.coverageIncomplete ? absenceClaims : [];
         grounded = ungroundedAbsenceClaims.length === 0;
+        if (evidenceEmpty) {
+          grounded = false;
+          out.caveats.unshift("GROUNDING NOT VERIFIED: no evidence was supplied in `input`, so the draft was not checked against any tool output. Do NOT present it as grounded \u2014 pass the prior sfi.* tool result(s) as `input` and retry.");
+        }
       }
       const qPrefix = input2.question !== void 0 && input2.question.trim().length > 0 ? `Q: ${input2.question.trim()} \u2014 ` : "";
       const summary = `${qPrefix}Grounded in the supplied tool output: ${citations.length} component(s) cited, ${out.bullets.length} key fact(s), ${out.caveats.length} caveat(s)` + (hallucinatedIds !== void 0 ? `, ${hallucinatedIds.length} ungrounded id(s) in the draft` : "") + // I3c: only appended when a draft is present AND the guard fired, so the
@@ -65081,7 +65086,7 @@ var init_tools = __esm({
       },
       {
         name: "sfi.synthesize_answer",
-        description: "Answer-layer grounding pass: turns the JSON returned by prior sfi.* tool call(s) into a structured, citation-grounded answer skeleton \u2014 `summary`, `bullets` (headline facts extracted from the input), `citations` (ONLY canonical ids present in the input, parsed to type + apiName), and `caveats` (honesty/limitation strings carried verbatim; an input reduced by the global response byte budget \u2014 a `responseBudget` truncation block \u2014 becomes an explicit caveat with the dropped/trimmed counts, so a synthesis over truncated data never reads absence as evidence). It also returns a grounded `evidence` skeleton \u2014 `finding` \u2192 `evidence` (the cited ids) \u2192 `likelyCause` \u2192 `recommendedFix` \u2192 `risk` \u2192 `nextAction` \u2014 where every field is lifted VERBATIM from the source tool output (a `reason`/`recommendation`/`nextStep`/caveat field) and is `null` when the source carried nothing for it, so the recommended action is never fabricated; `nextAction` falls back to the recommended fix, and `orphanComponentIds` flags any id mentioned inside a cause/fix/next string that is not independently cited (an ungrounded reference). Pass the source tool output as `input` (any JSON), optionally the user `question` (echoed into the summary), and optionally a `draft` narrative \u2014 when given, `hallucinatedIds` lists canonical ids in the draft that do NOT appear in the source so they can be removed before answering. `provenance` rolls the source output(s) trust provenance up into `{ stamp, sources }` (`offline_snapshot` / `live_org` / `hybrid` when the input fuses both / `mixed` / `null`) so the host can stamp where the answer came from and never let a vault claim read as a live one. Pure transform: reads ONLY `input`, never the graph or live org, so it can never add a fact it was not handed. Prose wording stays with the caller; this guarantees grounding, not sentences.",
+        description: "Answer-layer grounding pass: turns the JSON returned by prior sfi.* tool call(s) into a structured, citation-grounded answer skeleton \u2014 `summary`, `bullets` (headline facts extracted from the input), `citations` (ONLY canonical ids present in the input, parsed to type + apiName), and `caveats` (honesty/limitation strings carried verbatim; an input reduced by the global response byte budget \u2014 a `responseBudget` truncation block \u2014 becomes an explicit caveat with the dropped/trimmed counts, so a synthesis over truncated data never reads absence as evidence). It also returns a grounded `evidence` skeleton \u2014 `finding` \u2192 `evidence` (the cited ids) \u2192 `likelyCause` \u2192 `recommendedFix` \u2192 `risk` \u2192 `nextAction` \u2014 where every field is lifted VERBATIM from the source tool output (a `reason`/`recommendation`/`nextStep`/caveat field) and is `null` when the source carried nothing for it, so the recommended action is never fabricated; `nextAction` falls back to the recommended fix, and `orphanComponentIds` flags any id mentioned inside a cause/fix/next string that is not independently cited (an ungrounded reference). Pass the source tool output as `input` (any JSON), optionally the user `question` (echoed into the summary), and optionally a `draft` narrative \u2014 when given, `hallucinatedIds` lists canonical ids in the draft that do NOT appear in the source so they can be removed before answering. A `draft` supplied with an empty or missing `input` FAILS CLOSED to `grounded: false` with a caveat \u2014 grounding is never rubber-stamped when there is no evidence to check the draft against. `provenance` rolls the source output(s) trust provenance up into `{ stamp, sources }` (`offline_snapshot` / `live_org` / `hybrid` when the input fuses both / `mixed` / `null`) so the host can stamp where the answer came from and never let a vault claim read as a live one. Pure transform: reads ONLY `input`, never the graph or live org, so it can never add a fact it was not handed. Prose wording stays with the caller; this guarantees grounding, not sentences.",
         inputSchema: SYNTHESIZE_ANSWER_INPUT_SCHEMA
       },
       {
@@ -68015,7 +68020,7 @@ var init_package_version = __esm({
     "use strict";
     readCliPackageVersion = () => {
       if (true)
-        return "0.1.16";
+        return "0.1.17";
       for (const rel of ["../package.json", "../../package.json"]) {
         try {
           const raw = readFileSync3(fileURLToPath(new URL(rel, import.meta.url)), "utf8");
@@ -137915,7 +137920,7 @@ var makeShutdownOnce = (ctx) => {
 
 // dist/src/commands/demo.js
 init_refresh();
-var buildVersion = () => true ? "0.1.16" : "dev";
+var buildVersion = () => true ? "0.1.17" : "dev";
 var SHUTDOWN_SIGNALS2 = ["SIGINT", "SIGTERM"];
 var resolveDemoSource = () => {
   let dir = dirname21(fileURLToPath2(import.meta.url));
@@ -138889,7 +138894,7 @@ init_vault_git();
 init_watch();
 var readVersion = () => {
   if (true)
-    return "0.1.16";
+    return "0.1.17";
   const pkgUrl = new URL("../../package.json", import.meta.url);
   const raw = readFileSync6(fileURLToPath3(pkgUrl), "utf8");
   const parsed = JSON.parse(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sf-intelligence",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Offline-first, MCP-first knowledge base for a Salesforce org. Ask about your org's metadata, dependencies, permissions, and automation — grounded in real retrieved metadata. Ships the sfi CLI and an MCP server.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://salesforce-intelligence.pages.dev",
@@ -66,16 +66,16 @@
   "devDependencies": {
     "esbuild": "^0.28.0",
     "vitest": "^1.6.0",
+    "@sf-intelligence/contracts": "0.1.0",
     "@sf-intelligence/extractors": "0.1.0",
+    "@sf-intelligence/core": "0.1.0",
     "@sf-intelligence/graph": "0.1.0",
     "@sf-intelligence/parsers": "0.1.0",
-    "@sf-intelligence/core": "0.1.0",
-    "@sf-intelligence/patterns": "0.1.0",
-    "@sf-intelligence/renderers": "0.1.0",
     "@sf-intelligence/tooling-api": "0.1.0",
     "@sf-intelligence/vault": "0.1.0",
+    "@sf-intelligence/renderers": "0.1.0",
     "@sf-intelligence/mcp": "0.1.0",
-    "@sf-intelligence/contracts": "0.1.0"
+    "@sf-intelligence/patterns": "0.1.0"
   },
   "scripts": {
     "build": "tsc --build && node build.mjs",

package/server.json

@@ -7,13 +7,13 @@
     "url": "https://github.com/PranavNagrecha/Salesforce-Intelligence",
     "source": "github"
   },
-  "version": "0.1.16",
+  "version": "0.1.17",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "sf-intelligence",
-      "version": "0.1.16",
+      "version": "0.1.17",
       "transport": {
         "type": "stdio"
       },