sf-intelligence 0.1.24 → 0.1.25

package/dist/index.js

@@ -964,6 +964,11 @@ var init_queries = __esm({
       if (options?.recordTriggered === true) {
         out += ` AND json_extract_string(properties_json, '$.triggerType') LIKE 'Record%'`;
       }
+      if (options?.descriptionPresence === "present") {
+        out += ` AND coalesce(json_extract_string(properties_json, '$.description'), '') <> ''`;
+      } else if (options?.descriptionPresence === "absent") {
+        out += ` AND coalesce(json_extract_string(properties_json, '$.description'), '') = ''`;
+      }
       return out;
     };
     parseProperties = (raw) => {
@@ -13056,8 +13061,22 @@ var init_enterprise_metadata = __esm({
       });
       return ok({ nodes: [node], edges: [...fieldRefEdges, ...childRefEdges, ...visibleToEdges] });
     };
-    extractReport = (path) => extractEnterpriseMetadata(path, { type: "Report", suffix: ".report-meta.xml" });
-    extractDashboard = (path) => extractEnterpriseMetadata(path, { type: "Dashboard", suffix: ".dashboard-meta.xml" });
+    extractReport = (path) => extractEnterpriseMetadata(path, {
+      type: "Report",
+      suffix: ".report-meta.xml",
+      // Reports carry a top-level <description> in source. Capture it so
+      // "which reports have no description" is answerable and get_component
+      // can surface the report's stated purpose. Omitted when absent — the
+      // "extracted, none present" signal (vs a not-modeled type).
+      extraProperties: ["description"]
+    });
+    extractDashboard = (path) => extractEnterpriseMetadata(path, {
+      type: "Dashboard",
+      suffix: ".dashboard-meta.xml",
+      // Dashboards carry a top-level <description>. Same capture rationale as
+      // Report — omitted when absent.
+      extraProperties: ["description"]
+    });
     extractListView = (path) => extractEnterpriseMetadata(path, {
       type: "ListView",
       suffix: ".listView-meta.xml",
@@ -13072,7 +13091,11 @@ var init_enterprise_metadata = __esm({
       // Daily Summer '22") that distinguishes versioned clones from each other.
       // Without this, makeNode always sets label: null and get_component has no
       // human-readable display name to surface in vault Markdown.
-      labelXmlElement: "label"
+      labelXmlElement: "label",
+      // ReportType XML carries a top-level <description> (nearly universal in
+      // source). Capture it so custom report types disclose their purpose and
+      // are queryable via missingDescription. Omitted when absent.
+      extraProperties: ["description"]
     });
     extractCustomPermission = (path) => extractEnterpriseMetadata(path, { type: "CustomPermission", suffix: ".customPermission-meta.xml" });
     FLEXIPAGE_PAGE_TYPES = /* @__PURE__ */ new Set([
@@ -13149,6 +13172,10 @@ var init_enterprise_metadata = __esm({
     extractPermissionSetGroup = (path) => extractEnterpriseMetadata(path, {
       type: "PermissionSetGroup",
       suffix: ".permissionsetgroup-meta.xml",
+      // PSGs carry a top-level <description>. Capture it so the group's stated
+      // purpose is surfaced and queryable via missingDescription. Omitted when
+      // absent.
+      extraProperties: ["description"],
       // A PSG's effective permissions are the UNION of its member permission
       // sets' grants, minus the muting permission set's. Capture both so the
       // permission analysis can flow god-mode / object grants through the group.
@@ -52665,7 +52692,19 @@ var init_list_components = __esm({
       /** Flow metadata: exact match on `properties.status` (e.g. Active). */
       status: z90.string().min(1).optional(),
       /** Flow metadata: keep only record-triggered flows (`triggerType` starts with Record). */
-      recordTriggered: coercedOptionalBoolean
+      recordTriggered: coercedOptionalBoolean,
+      /**
+       * Keep only components that LACK a description — `properties.description` is
+       * absent, null, or empty. Answers "which reports/objects/permission-sets have
+       * no description". Only trustworthy for a type whose extractor captures
+       * description; a type that carries no `<description>` in Salesforce source
+       * (ListView, CustomPermission, MutingPermissionSet, CustomMetadata records)
+       * will match ALL of its nodes — that means "this type has no description in
+       * source", not "the org failed to fill them in".
+       */
+      missingDescription: coercedOptionalBoolean,
+      /** Keep only components that HAVE a non-empty `properties.description`. */
+      hasDescription: coercedOptionalBoolean
     });
     listComponentsHandler = async (ctx, input2) => {
       if (input2.type === void 0) {
@@ -52674,6 +52713,13 @@ var init_list_components = __esm({
           message: "type is required for v0.1"
         });
       }
+      if (input2.missingDescription === true && input2.hasDescription === true) {
+        return err({
+          kind: "invalid-query",
+          message: "missingDescription and hasDescription are mutually exclusive \u2014 pass at most one."
+        });
+      }
+      const descriptionPresence = input2.missingDescription === true ? "absent" : input2.hasDescription === true ? "present" : void 0;
       const limit = input2.limit ?? LIST_DEFAULT_LIMIT2;
       const recordTriggered = input2.recordTriggered === true;
       const fingerprint = argsFingerprint({
@@ -52682,6 +52728,7 @@ var init_list_components = __esm({
         ...input2.triggerObject !== void 0 ? { triggerObject: input2.triggerObject } : {},
         ...input2.status !== void 0 ? { status: input2.status } : {},
         ...recordTriggered ? { recordTriggered: true } : {},
+        ...descriptionPresence !== void 0 ? { descriptionPresence } : {},
         ...Object.fromEntries(APEX_BOOLEAN_FILTERS.flatMap((k2) => input2[k2] !== void 0 ? [[k2, input2[k2]]] : []))
       });
       let offset = input2.offset ?? 0;
@@ -52712,7 +52759,8 @@ var init_list_components = __esm({
         ...input2.parentId !== void 0 ? { parentId: input2.parentId } : {},
         ...hasPropertyFilter ? { propertyEquals } : {},
         ...hasStringPropertyFilter ? { propertyStringEquals } : {},
-        ...recordTriggered ? { recordTriggered: true } : {}
+        ...recordTriggered ? { recordTriggered: true } : {},
+        ...descriptionPresence !== void 0 ? { descriptionPresence } : {}
       };
       const queryResult = await listNodesByType(ctx.graph, input2.type, {
         limit,
@@ -52745,7 +52793,7 @@ var init_list_components = __esm({
       const propertiesSlimmed = kept.some((n2) => n2.properties?.["propertiesTruncated"] === true);
       const hasMore = pageNodes.length === limit || trimmed;
       let retrievalHint;
-      if (offset === 0 && pageNodes.length === 0 && !hasPropertyFilter && !hasStringPropertyFilter && !recordTriggered) {
+      if (offset === 0 && pageNodes.length === 0 && !hasPropertyFilter && !hasStringPropertyFilter && !recordTriggered && descriptionPresence === void 0) {
         const cov = summarizeCoverage(ctx.manifest, [input2.type]);
         if (cov.notModeledTypes.includes(input2.type)) {
           retrievalHint = `No \`${input2.type}\` in the vault \u2014 this type is NOT modeled by the current build, so its absence means "not analyzed", never "none in the org".`;
@@ -69830,7 +69878,11 @@ var init_tools = __esm({
         hasFutureMethod: { type: "boolean" },
         hasInvocableMethod: { type: "boolean" },
         hasAuraEnabledMethod: { type: "boolean" },
-        isTest: { type: "boolean" }
+        isTest: { type: "boolean" },
+        // Description-presence filters. Answer "which <type> have no description".
+        // Only meaningful for a type whose extractor captures `<description>`.
+        missingDescription: { type: "boolean" },
+        hasDescription: { type: "boolean" }
       }
     });
     GET_SUBGRAPH_INPUT_SCHEMA = Object.freeze({
@@ -71698,7 +71750,7 @@ var init_tools = __esm({
       },
       {
         name: "sfi.list_components",
-        description: 'List components of a given type (optionally narrowed by parentId), sorted by id. Paginated via limit/offset; `hasMore` hints at additional pages (a truncated page returns a `nextCursor` to resume). Grant-heavy rows (Profile / PermissionSet, whose nodes carry tens of KB of declarative grants) are slimmed to scalar properties \u2014 each such row is marked `properties.propertiesTruncated: true` and the page carries a top-level `propertiesSlimmed: true` \u2014 so the whole inventory fits per page; fetch full detail per component via sfi.get_component. For `type: \'ApexClass\'`, optional boolean filters list interface/async/API implementers at the DB layer (correct pagination, not a post-filtered page): `isBatchable` / `isQueueable` / `isSchedulable` / `isRestResource` / `hasFutureMethod` / `hasInvocableMethod` / `hasAuraEnabledMethod` / `isTest` \u2014 e.g. `{ type: \'ApexClass\', isBatchable: true }` returns every Batchable class. When manifest coverage for the requested `type` is not `complete`, a structured `coverageCaveat` flags the inventory as potentially incomplete (scoped refresh, errored retrieve, not modeled) \u2014 including on non-empty pages. When the FIRST page is empty, a `retrievalHint` (FRESH-02) says WHY \u2014 "none in the org" (retrieved, none found) vs "not retrieved" (a scoped refresh skipped the type \u2014 run /sfi-refresh) vs "not modeled" \u2014 so an empty list is never a silent `[]` read as "the org has none". (The hint is suppressed when a boolean filter is active, since an empty filtered result is not a coverage gap.)',
+        description: 'List components of a given type (optionally narrowed by parentId), sorted by id. Paginated via limit/offset; `hasMore` hints at additional pages (a truncated page returns a `nextCursor` to resume). Grant-heavy rows (Profile / PermissionSet, whose nodes carry tens of KB of declarative grants) are slimmed to scalar properties \u2014 each such row is marked `properties.propertiesTruncated: true` and the page carries a top-level `propertiesSlimmed: true` \u2014 so the whole inventory fits per page; fetch full detail per component via sfi.get_component. For `type: \'ApexClass\'`, optional boolean filters list interface/async/API implementers at the DB layer (correct pagination, not a post-filtered page): `isBatchable` / `isQueueable` / `isSchedulable` / `isRestResource` / `hasFutureMethod` / `hasInvocableMethod` / `hasAuraEnabledMethod` / `isTest` \u2014 e.g. `{ type: \'ApexClass\', isBatchable: true }` returns every Batchable class. `missingDescription: true` (or `hasDescription: true`) filters to components that lack (or carry) a non-empty `properties.description`, with `totalCount` as the authoritative tally \u2014 only meaningful for a type whose extractor captures a source `<description>` (a type that carries none in source will match ALL of its nodes, meaning "no description in source", not "left blank"). When manifest coverage for the requested `type` is not `complete`, a structured `coverageCaveat` flags the inventory as potentially incomplete (scoped refresh, errored retrieve, not modeled) \u2014 including on non-empty pages. When the FIRST page is empty, a `retrievalHint` (FRESH-02) says WHY \u2014 "none in the org" (retrieved, none found) vs "not retrieved" (a scoped refresh skipped the type \u2014 run /sfi-refresh) vs "not modeled" \u2014 so an empty list is never a silent `[]` read as "the org has none". (The hint is suppressed when a boolean filter is active, since an empty filtered result is not a coverage gap.)',
         inputSchema: LIST_COMPONENTS_INPUT_SCHEMA
       },
       {
@@ -74635,7 +74687,7 @@ var init_package_version = __esm({
     "use strict";
     readCliPackageVersion = () => {
       if (true)
-        return "0.1.24";
+        return "0.1.25";
       for (const rel of ["../package.json", "../../package.json"]) {
         try {
           const raw = readFileSync3(fileURLToPath(new URL(rel, import.meta.url)), "utf8");
@@ -144559,7 +144611,7 @@ var makeShutdownOnce = (ctx) => {
 
 // dist/src/commands/demo.js
 init_refresh();
-var buildVersion = () => true ? "0.1.24" : "dev";
+var buildVersion = () => true ? "0.1.25" : "dev";
 var SHUTDOWN_SIGNALS2 = ["SIGINT", "SIGTERM"];
 var resolveDemoSource = () => {
   let dir = dirname21(fileURLToPath2(import.meta.url));
@@ -145544,7 +145596,7 @@ init_vault_git();
 init_watch();
 var readVersion = () => {
   if (true)
-    return "0.1.24";
+    return "0.1.25";
   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.24",
+  "version": "0.1.25",
   "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",

package/server.json

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