sf-intelligence 0.1.1 → 0.1.4

package/dist/index.js

@@ -944,7 +944,7 @@ var init_resolve_index = __esm({
 });
 
 // ../graph/dist/src/resolve.js
-var DEFAULT_LIMIT, MAX_LIMIT, MIN_BASE, MATCHED_FLOOR, NONE_THRESHOLD, EXACT_THRESHOLD, EXACT_COVERAGE, CONTENDER_RATIO, LENGTH_RATIO_FLOOR, SYNONYM_SCORE, POP_K, COVERAGE_EXP, STRONG_ANCHOR, PARENT_MATCH_BONUS, TYPE_WEIGHT, typeWeight, scoreToken, rollupKind, buildEvidence, resolveComponents;
+var DEFAULT_LIMIT, MAX_LIMIT, MIN_BASE, MATCHED_FLOOR, NONE_THRESHOLD, EXACT_THRESHOLD, EXACT_COVERAGE, CONTENDER_RATIO, LENGTH_RATIO_FLOOR, SYNONYM_SCORE, POP_K, COVERAGE_EXP, STRONG_ANCHOR, TYPE_WEIGHT, typeWeight, scoreToken, rollupKind, buildEvidence, resolveComponents;
 var init_resolve = __esm({
   "../graph/dist/src/resolve.js"() {
     "use strict";
@@ -964,7 +964,6 @@ var init_resolve = __esm({
     POP_K = 0.08;
     COVERAGE_EXP = 0.5;
     STRONG_ANCHOR = 0.9;
-    PARENT_MATCH_BONUS = 1.1;
     TYPE_WEIGHT = {
       CustomObject: 1,
       CustomField: 0.95,
@@ -1092,6 +1091,7 @@ var init_resolve = __esm({
       const scored = [];
       const coverageById = /* @__PURE__ */ new Map();
       const wholeExactIds = /* @__PURE__ */ new Set();
+      const parentMatchedIds = /* @__PURE__ */ new Set();
       for (const c of pass1) {
         const matched = c.perToken.filter((t) => t.score >= MATCHED_FLOOR);
         if (matched.length === 0 && !c.wholeExact)
@@ -1106,13 +1106,15 @@ var init_resolve = __esm({
           continue;
         const type = c.node.type;
         const refs = c.node.inbound;
-        const score = base * typeWeight(type) * (1 + POP_K * Math.log10(1 + refs)) * (c.parentMatched ? PARENT_MATCH_BONUS : 1);
+        const score = base * typeWeight(type) * (1 + POP_K * Math.log10(1 + refs));
         const kind = c.wholeExact ? "exact" : rollupKind(matched);
         const nodeTokenSet = new Set(c.node.tokens);
         const matchedNodeTokens = new Set(matched.map((m) => m.matchedToken).filter((t) => nodeTokenSet.has(t)));
         coverageById.set(c.node.id, c.wholeExact ? 1 : matchedNodeTokens.size / c.node.tokens.length);
         if (c.wholeExact)
           wholeExactIds.add(c.node.id);
+        if (c.parentMatched)
+          parentMatchedIds.add(c.node.id);
         scored.push({
           id: c.node.id,
           type,
@@ -1134,6 +1136,10 @@ var init_resolve = __esm({
         const tierB = b.base >= EXACT_THRESHOLD ? 0 : 1;
         if (tierA !== tierB)
           return tierA - tierB;
+        const pmA = parentMatchedIds.has(a.id) ? 0 : 1;
+        const pmB = parentMatchedIds.has(b.id) ? 0 : 1;
+        if (pmA !== pmB)
+          return pmA - pmB;
         if (a.score !== b.score)
           return b.score - a.score;
         return a.id < b.id ? -1 : 1;
@@ -1145,7 +1151,7 @@ var init_resolve = __esm({
       if (top === void 0 || bestBase < NONE_THRESHOLD) {
         disposition = "none";
       } else {
-        const contenders = candidates.filter((c) => c.score >= top.score * CONTENDER_RATIO);
+        const contenders = candidates.filter((c) => c.score >= top.score * CONTENDER_RATIO || parentMatchedIds.has(c.id));
         const topCoverage = coverageById.get(top.id) ?? 0;
         disposition = top.base >= EXACT_THRESHOLD && contenders.length === 1 && topCoverage >= EXACT_COVERAGE ? "exact" : "ambiguous";
       }
@@ -21353,10 +21359,11 @@ var init_soe_payload_bounds = __esm({
     SOE_MAX_PAYLOAD_BYTES = 4e4;
     KEEP_ALL_AT_OR_BELOW = 4;
     sizeOf = (payload) => Buffer.byteLength(JSON.stringify(payload), "utf8");
-    enforceSoeByteBudget = (payload, steps) => {
+    enforceSoeByteBudget = (payload, containers) => {
       if (sizeOf(payload) <= SOE_MAX_PAYLOAD_BYTES) {
-        return { truncated: false, actionsOmitted: 0 };
+        return { truncated: false, actionsOmitted: 0, conditionalsTrimmed: 0, stepsOmitted: 0 };
       }
+      const steps = containers.flat();
       let totalOmitted = 0;
       const trimTo = (step3, keep) => {
         if (keep >= step3.actions.length)
@@ -21395,9 +21402,76 @@ var init_soe_payload_bounds = __esm({
           break;
         trimTo(target, Math.floor(target.actions.length / 2));
       }
-      return { truncated: totalOmitted > 0, actionsOmitted: totalOmitted };
+      let conditionalsTrimmed = 0;
+      for (let guard = 0; guard < 1e5; guard += 1) {
+        if (sizeOf(payload) <= SOE_MAX_PAYLOAD_BYTES)
+          break;
+        let target;
+        let targetBytes = 0;
+        for (const s of steps) {
+          const cond = s.conditional;
+          if (cond === void 0 || s.conditionalTruncated)
+            continue;
+          if (cond.expression === "" && cond.fieldRefs.length === 0)
+            continue;
+          const b = Buffer.byteLength(JSON.stringify(cond), "utf8");
+          if (target === void 0 || b > targetBytes) {
+            target = s;
+            targetBytes = b;
+          }
+        }
+        if (target === void 0)
+          break;
+        target.conditional = {
+          conditionContextId: target.conditional.conditionContextId,
+          expression: "",
+          fieldRefs: []
+        };
+        target.conditionalTruncated = true;
+        conditionalsTrimmed += 1;
+      }
+      let stepsOmitted = 0;
+      for (let guard = 0; guard < 1e6; guard += 1) {
+        if (sizeOf(payload) <= SOE_MAX_PAYLOAD_BYTES)
+          break;
+        let target;
+        let targetBytes = 0;
+        for (const c of containers) {
+          if (c.length <= 1)
+            continue;
+          const b = Buffer.byteLength(JSON.stringify(c), "utf8");
+          if (target === void 0 || b > targetBytes) {
+            target = c;
+            targetBytes = b;
+          }
+        }
+        if (target === void 0)
+          break;
+        target.pop();
+        stepsOmitted += 1;
+      }
+      return {
+        truncated: totalOmitted > 0 || conditionalsTrimmed > 0 || stepsOmitted > 0,
+        actionsOmitted: totalOmitted,
+        conditionalsTrimmed,
+        stepsOmitted
+      };
+    };
+    soeTruncationNote = (result) => {
+      const budgetKb = Math.round(SOE_MAX_PAYLOAD_BYTES / 1e3);
+      const parts = [];
+      if (result.actionsOmitted > 0) {
+        parts.push(`${result.actionsOmitted} per-step action edge(s) across the heaviest steps were omitted (see each step's \`actionsOmitted\`)`);
+      }
+      if (result.conditionalsTrimmed > 0) {
+        parts.push(`${result.conditionalsTrimmed} step condition(s) had their expression/fieldRefs dropped \u2014 the \`conditionContextId\` remains, fetch it with \`get_component\` for the full condition (see each step's \`conditionalTruncated\`)`);
+      }
+      if (result.stepsOmitted > 0) {
+        parts.push(`${result.stepsOmitted} trailing step(s) were dropped to fit (the tail-most async/post-save steps; \`summary.totalSteps\` still reports the true total) \u2014 query a single event with \`what_happens_on_save\` to see them all`);
+      }
+      const lead = result.stepsOmitted > 0 ? `Response trimmed to fit the ~${budgetKb} KB MCP response budget` : `Response trimmed to fit the ~${budgetKb} KB MCP response budget: every save-order STEP is present and in order, but`;
+      return `${lead} ${parts.join("; ")}. Query a single object/event for full detail.`;
     };
-    soeTruncationNote = (n) => `Response trimmed to fit the ~${Math.round(SOE_MAX_PAYLOAD_BYTES / 1e3)} KB MCP response budget: every save-order STEP is present and in order, but ${n} per-step action edge(s) across the heaviest steps were omitted (see each step's \`actionsOmitted\`). Query a single object/event or use \`get_edges\` on a specific step's component for its full action list.`;
   }
 });
 
@@ -21764,11 +21838,11 @@ var init_order_of_execution = __esm({
         byEvent,
         disclosure: composeSoeDisclosure(DISCLOSURE6, objectModeled)
       };
-      const allSteps = SOE_EVENTS.flatMap((event) => byEvent[event].soe);
-      const budget = enforceSoeByteBudget(data, allSteps);
+      const containers = SOE_EVENTS.map((event) => byEvent[event].soe);
+      const budget = enforceSoeByteBudget(data, containers);
       if (budget.truncated) {
         data.truncated = true;
-        data.disclosure = `${data.disclosure} ${soeTruncationNote(budget.actionsOmitted)}`;
+        data.disclosure = `${data.disclosure} ${soeTruncationNote(budget)}`;
       }
       return ok({
         data,
@@ -26611,10 +26685,10 @@ var init_what_happens_on_save = __esm({
         },
         disclosure: composeSoeDisclosure(DISCLOSURE7, objectModeled)
       };
-      const budget = enforceSoeByteBudget(data, soe);
+      const budget = enforceSoeByteBudget(data, [soe]);
       if (budget.truncated) {
         data.truncated = true;
-        data.disclosure = `${data.disclosure} ${soeTruncationNote(budget.actionsOmitted)}`;
+        data.disclosure = `${data.disclosure} ${soeTruncationNote(budget)}`;
       }
       return ok({
         data,
@@ -26627,6 +26701,23 @@ var init_what_happens_on_save = __esm({
   }
 });
 
+// ../mcp/dist/src/tools/phantom-node.js
+var phantomAwareNotFoundMessage;
+var init_phantom_node = __esm({
+  "../mcp/dist/src/tools/phantom-node.js"() {
+    "use strict";
+    init_src();
+    phantomAwareNotFoundMessage = async (ctx, id, kindLabel) => {
+      const inbound = await listEdges(ctx.graph, id, { direction: "in" });
+      const refs = inbound.ok ? inbound.value.length : 0;
+      if (refs === 0) {
+        return `no ${kindLabel} with id ${id}`;
+      }
+      return `\`${id}\` is referenced by ${refs} other component(s) in this org (e.g. code, tests, or permission grants) but its own ${kindLabel} definition was never retrieved into the vault \u2014 typically a managed-package component or one outside the retrieve scope. Run \`sfi refresh\` if it should be retrievable; otherwise treat it as external.`;
+    };
+  }
+});
+
 // ../mcp/dist/src/tools/what-if-change-method-signature.js
 import { z as z104 } from "zod";
 var APEX_CLASS_PREFIX9, DISCLOSURE8, whatIfChangeMethodSignatureInputSchema, readMethodName, isTestClass8, buildExplanation2, classifyCaller, aggregateVerdict4, compareImpacts, compareIds, collectCallers, collectCoveringTests, whatIfChangeMethodSignatureHandler;
@@ -26637,6 +26728,7 @@ var init_what_if_change_method_signature = __esm({
     init_src();
     init_coerce_id();
     init_coverage_trust();
+    init_phantom_node();
     APEX_CLASS_PREFIX9 = "ApexClass:";
     DISCLOSURE8 = "callers identified via the v1.4 apex-scanner are at heuristic confidence; dynamic dispatch via Type.forName + invoke is invisible. Test classes are identified by @isTest + naming convention (className + 'Test' suffix) and by coversTest edges; a test class that doesn't follow the naming convention and doesn't carry a @TestVisible-tagged covering reference may be missed.";
     whatIfChangeMethodSignatureInputSchema = z104.object({
@@ -26776,7 +26868,7 @@ var init_what_if_change_method_signature = __esm({
       if (nodeResult.value === null) {
         return err({
           kind: "component-not-found",
-          message: `no ApexClass with id ${classId}`,
+          message: await phantomAwareNotFoundMessage(ctx, classId, "ApexClass"),
           path: classId
         });
       }
@@ -46748,7 +46840,7 @@ var registerStatusCommand = (program) => {
 // dist/src/program.js
 var readVersion = () => {
   if (true)
-    return "0.1.1";
+    return "0.1.4";
   const pkgUrl = new URL("../../package.json", import.meta.url);
   const raw = readFileSync2(fileURLToPath(pkgUrl), "utf8");
   const parsed = JSON.parse(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sf-intelligence",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "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": "Apache-2.0",
   "homepage": "https://github.com/PranavNagrecha/Salesforce-Intelligence",
@@ -52,14 +52,14 @@
   "devDependencies": {
     "esbuild": "^0.28.0",
     "vitest": "^1.6.0",
-    "@sf-intelligence/mcp": "0.1.0",
-    "@sf-intelligence/core": "0.1.0",
-    "@sf-intelligence/contracts": "0.1.0",
-    "@sf-intelligence/patterns": "0.1.0",
     "@sf-intelligence/extractors": "0.1.0",
-    "@sf-intelligence/renderers": "0.1.0",
     "@sf-intelligence/graph": "0.1.0",
+    "@sf-intelligence/patterns": "0.1.0",
+    "@sf-intelligence/core": "0.1.0",
     "@sf-intelligence/vault": "0.1.0",
+    "@sf-intelligence/contracts": "0.1.0",
+    "@sf-intelligence/mcp": "0.1.0",
+    "@sf-intelligence/renderers": "0.1.0",
     "@sf-intelligence/tooling-api": "0.1.0"
   },
   "scripts": {