sf-intelligence 0.1.10 → 0.1.11

package/dist/index.js

@@ -59448,7 +59448,7 @@ var init_package_version = __esm({
     "use strict";
     readCliPackageVersion = () => {
       if (true)
-        return "0.1.10";
+        return "0.1.11";
       for (const rel of ["../package.json", "../../package.json"]) {
         try {
           const raw = readFileSync3(fileURLToPath(new URL(rel, import.meta.url)), "utf8");
@@ -126240,6 +126240,7 @@ __export(refresh_exports, {
   buildFolderedReportManifest: () => buildFolderedReportManifest,
   buildRefreshPulse: () => buildRefreshPulse,
   classifyForDemandRetrieve: () => classifyForDemandRetrieve,
+  classifyRetrieveError: () => classifyRetrieveError,
   computeChangeSummary: () => computeChangeSummary,
   countLandedReportMembers: () => countLandedReportMembers,
   formatDemandRetrieveSummary: () => formatDemandRetrieveSummary,
@@ -126250,17 +126251,20 @@ __export(refresh_exports, {
   markDemandQueueDrains: () => markDemandQueueDrains,
   objectsToExpandManifest: () => objectsToExpandManifest,
   registerRefreshCommand: () => registerRefreshCommand,
+  retrieveWithFallback: () => retrieveWithFallback,
   runDemandRetrieve: () => runDemandRetrieve,
   runRefresh: () => runRefresh,
   runSfRetrieveSmartReports: () => runSfRetrieveSmartReports,
-  selectManifestTypes: () => selectManifestTypes
+  selectManifestTypes: () => selectManifestTypes,
+  splitTypeBatch: () => splitTypeBatch,
+  summarizeRetrieveFailures: () => summarizeRetrieveFailures
 });
 import { exec } from "node:child_process";
 import { appendFile as appendFile4, mkdir as mkdir12, readdir as readdir6, readFile as readFile79, rename as rename6, rm as rm5, stat as stat10, writeFile as writeFile11 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
 import { join as join26, resolve as resolve4 } from "node:path";
 import { promisify as promisify4 } from "node:util";
-var execAsync, SF_API_VERSION2, EMPTY_COUNTS, EMPTY_SKIPPED, failed, PACKAGE_VERSION, extractCachePath, loadExtractCache, saveExtractCache, applyApexAstEdges, runRefresh, preserveFactsForSideBuild, aggregateFailuresByType, buildCoverageEntries2, decoratePendingCoverage, decorateReportsCapCoverage, countGraphTotals, fullRebuild, importGraph, persistResolveIndexBestEffort, runWithOpenGraph, appendRefreshHistory, appendRiskScores, writeOnboardingDoc, writeOrgCard, diffCounts, sumCounts, metricCounts, signedDelta, findAnnotationOrphans, buildRefreshPulse, computeChangeSummary, TOOLING_API_ENRICHED_TYPES, runToolingApiEnrichment, loadVaultConfig, METADATA_API_NAME2, toApiName, SF_MAX_BUFFER, STANDARD_OBJECTS_TO_MODEL, manifestMembersForType, appendStandardObjectDescribeFields, AUTOMATION_EDGE_TYPES, objectsToExpandManifest, buildPackageXml, getOrgSupportedTypes, selectManifestTypes, runSfRetrieve, computeReconciledTypes, runSfRetrieveObjects, buildFolderedReportManifest, REPORT_META_SUFFIXES, REPORT_DIR_MARKERS, countLandedReportMembers, collectReportMetaFiles, runSfRetrieveFolderedReports, reportsCap, runSfRetrieveSmartReports, formatFailure, formatBlock, formatChangeSummary, formatRefreshSummary, formatReportsCapSummary, SKIPPED_TOP_N, KNOWN_UNMODELED_SKIP_DIRS, formatSkippedWarning, formatToolingApiSummary, demandCoverageStatusOf, DEMAND_REFUSAL_REASON, classifyForDemandRetrieve, markDemandQueueDrains, runDemandRetrieve, formatDemandRetrieveSummary, registerRefreshCommand;
+var execAsync, SF_API_VERSION2, EMPTY_COUNTS, EMPTY_SKIPPED, failed, PACKAGE_VERSION, extractCachePath, loadExtractCache, saveExtractCache, applyApexAstEdges, runRefresh, preserveFactsForSideBuild, aggregateFailuresByType, buildCoverageEntries2, decoratePendingCoverage, decorateReportsCapCoverage, countGraphTotals, fullRebuild, importGraph, persistResolveIndexBestEffort, runWithOpenGraph, appendRefreshHistory, appendRiskScores, writeOnboardingDoc, writeOrgCard, diffCounts, sumCounts, metricCounts, signedDelta, findAnnotationOrphans, buildRefreshPulse, computeChangeSummary, TOOLING_API_ENRICHED_TYPES, runToolingApiEnrichment, loadVaultConfig, METADATA_API_NAME2, toApiName, SF_MAX_BUFFER, STANDARD_OBJECTS_TO_MODEL, manifestMembersForType, appendStandardObjectDescribeFields, AUTOMATION_EDGE_TYPES, objectsToExpandManifest, buildPackageXml, getOrgSupportedTypes, selectManifestTypes, classifyRetrieveError, splitTypeBatch, firstErrorLine, summarizeRetrieveFailures, retrieveWithFallback, retrieveTypeBatch, runSfRetrieve, computeReconciledTypes, runSfRetrieveObjects, buildFolderedReportManifest, REPORT_META_SUFFIXES, REPORT_DIR_MARKERS, countLandedReportMembers, collectReportMetaFiles, runSfRetrieveFolderedReports, reportsCap, runSfRetrieveSmartReports, formatFailure, formatBlock, formatChangeSummary, formatRefreshSummary, formatReportsCapSummary, SKIPPED_TOP_N, KNOWN_UNMODELED_SKIP_DIRS, formatSkippedWarning, formatToolingApiSummary, demandCoverageStatusOf, DEMAND_REFUSAL_REASON, classifyForDemandRetrieve, markDemandQueueDrains, runDemandRetrieve, formatDemandRetrieveSummary, registerRefreshCommand;
 var init_refresh = __esm({
   "dist/src/commands/refresh.js"() {
     "use strict";
@@ -126437,6 +126441,7 @@ var init_refresh = __esm({
       });
       let pullManifestTypes = null;
       let sourceReconcileDeleted = 0;
+      let retrieveFailures = [];
       if (!opts.noPull) {
         const priorManifest = await loadManifest(configResult.value.vaultRoot);
         const priorComponentCount = priorManifest.ok ? Object.values(priorManifest.value.components ?? {}).reduce((a2, b2) => a2 + (typeof b2 === "number" ? b2 : 0), 0) : null;
@@ -126453,9 +126458,13 @@ var init_refresh = __esm({
           return failed(started, pulled.error, []);
         pullManifestTypes = pulled.value.manifestTypes;
         sourceReconcileDeleted = pulled.value.deletedCount;
+        retrieveFailures = pulled.value.failures;
         if (sourceReconcileDeleted > 0) {
           progress(`Reconciled source: removed ${sourceReconcileDeleted} stale file(s) deleted in the org.`);
         }
+        if (retrieveFailures.length > 0) {
+          progress(`Partial retrieve: ${retrieveFailures.length} metadata type(s) failed and were skipped \u2014 the vault is built from what landed. ${summarizeRetrieveFailures(retrieveFailures)}`);
+        }
       }
       progress("Extracting components from retrieved source...");
       const prevCache = opts.incremental ? await loadExtractCache(paths.meta) : void 0;
@@ -126552,6 +126561,7 @@ var init_refresh = __esm({
         opts,
         requestedTypes,
         snapshotOnRefresh: configResult.value.snapshotOnRefresh,
+        retrieveFailures,
         ...reconciledTypes !== null ? { reconciledTypes } : {},
         ...apexAstStats !== void 0 ? { apexAstStats } : {},
         ...reportsCapStats !== void 0 ? { reportsCapStats } : {}
@@ -126805,11 +126815,12 @@ var init_refresh = __esm({
           return failed(started, `countGraphTotals: ${counted.error}`, walked.failures, EMPTY_COUNTS, walked.skippedDirectories);
         }
         return {
-          status: walked.failures.length === 0 ? "success" : "partial",
+          status: walked.failures.length === 0 && args.retrieveFailures.length === 0 ? "success" : "partial",
           counts: counted.value,
           skippedDirectories: walked.skippedDirectories,
           errors: walked.failures,
           durationMs: Date.now() - started,
+          ...args.retrieveFailures.length > 0 ? { retrieveFailures: args.retrieveFailures } : {},
           ...toolingApiSummary !== void 0 ? { toolingApi: toolingApiSummary } : {},
           ...args.reportsCapStats !== void 0 ? { reportsCap: args.reportsCapStats } : {}
         };
@@ -126954,11 +126965,12 @@ var init_refresh = __esm({
         }
       }
       return {
-        status: walked.failures.length === 0 ? "success" : "partial",
+        status: walked.failures.length === 0 && args.retrieveFailures.length === 0 ? "success" : "partial",
         counts,
         skippedDirectories: walked.skippedDirectories,
         errors: walked.failures,
         durationMs: Date.now() - started,
+        ...args.retrieveFailures.length > 0 ? { retrieveFailures: args.retrieveFailures } : {},
         ...changeSummary !== void 0 ? { changeSummary } : {},
         ...pulse !== void 0 ? { pulse } : {},
         ...toolingApiSummary !== void 0 ? { toolingApi: toolingApiSummary } : {},
@@ -127380,6 +127392,76 @@ ${card.body}
         dropped: candidates.filter((type) => !orgTypes.has(toApiName(type)))
       };
     };
+    classifyRetrieveError = (message) => {
+      const GLOBAL_SIGNALS = [
+        /no authorization|not authorized|no auth information|expired access\/refresh token|invalid[_ ]grant/i,
+        /org ?login|sfdx[_ ]?login|requires? you to (?:re-?)?authenticate|session expired/i,
+        /does not contain a valid salesforce dx project/i,
+        /enotfound|etimedout|econnrefused|enetunreach|getaddrinfo|socket hang up|network error|unable to connect|connection timed out/i,
+        /no default (?:environment|org)|no target-?org|no org configured|requires a target org/i
+      ];
+      return GLOBAL_SIGNALS.some((re2) => re2.test(message)) ? "global" : "per-type";
+    };
+    splitTypeBatch = (types) => {
+      const mid = Math.floor(types.length / 2);
+      return [types.slice(0, mid), types.slice(mid)];
+    };
+    firstErrorLine = (error) => (error.split("\n")[0] ?? error).trim();
+    summarizeRetrieveFailures = (failures) => {
+      if (failures.length === 0)
+        return "";
+      const uniqueReasons = new Set(failures.map((f2) => firstErrorLine(f2.error)));
+      if (uniqueReasons.size === 1) {
+        const [reason] = [...uniqueReasons];
+        const [first] = failures;
+        return failures.length === 1 && first !== void 0 ? `${first.type}: ${reason}` : reason ?? "";
+      }
+      return failures.map((f2) => `${f2.type} (${firstErrorLine(f2.error)})`).join("; ");
+    };
+    retrieveWithFallback = async (allTypes, retrieveBatch) => {
+      const succeeded = [];
+      const failures = [];
+      let deletedCount = 0;
+      const attempt = async (types) => {
+        if (types.length === 0)
+          return;
+        const result = await retrieveBatch(types);
+        if (result.ok) {
+          succeeded.push(...types);
+          deletedCount += result.value.deletedCount;
+          return;
+        }
+        if (types.length === 1 || classifyRetrieveError(result.error) === "global") {
+          for (const type of types)
+            failures.push({ type, error: result.error });
+          return;
+        }
+        const [left, right] = splitTypeBatch(types);
+        await attempt(left);
+        await attempt(right);
+      };
+      await attempt(allTypes);
+      return { succeeded, deletedCount, failures };
+    };
+    retrieveTypeBatch = async (targetOrg, sourceDir, types) => {
+      const stamp = `${Date.now()}-${types.length}-${types[0] ?? "batch"}`;
+      const manifestPath = join26(tmpdir2(), `sfi-refresh-package-${stamp}.xml`);
+      const retrieveDir = join26(tmpdir2(), `sfi-retrieve-${stamp}`);
+      await writeFile11(manifestPath, buildPackageXml(types), "utf8");
+      try {
+        await execAsync(`sf project retrieve start --manifest "${manifestPath}" --target-org "${targetOrg}" --output-dir "${retrieveDir}"`, { maxBuffer: SF_MAX_BUFFER });
+        const reconcile = await reconcileSourceDeletions(sourceDir, retrieveDir, new Set(types));
+        await syncAuthoritativeRetrieveIntoSource(sourceDir, retrieveDir);
+        return ok({ deletedCount: reconcile.deletedCount });
+      } catch (cause) {
+        return err(cause instanceof Error ? cause.message : String(cause));
+      } finally {
+        await rm5(manifestPath, { force: true }).catch(() => {
+        });
+        await rm5(retrieveDir, { recursive: true, force: true }).catch(() => {
+        });
+      }
+    };
     runSfRetrieve = async (targetOrg, sourceDir, requestedTypes) => {
       const orgTypes = await getOrgSupportedTypes(targetOrg);
       if (orgTypes === null) {
@@ -127395,22 +127477,15 @@ ${card.body}
       if (manifestTypes.length === 0) {
         return err(`No retrievable metadata types for ${targetOrg} after intersecting with the org's describe.`);
       }
-      const manifestPath = join26(tmpdir2(), `sfi-refresh-package-${Date.now()}.xml`);
-      const retrieveDir = join26(tmpdir2(), `sfi-retrieve-${Date.now()}`);
-      await writeFile11(manifestPath, buildPackageXml(manifestTypes), "utf8");
-      try {
-        await execAsync(`sf project retrieve start --manifest "${manifestPath}" --target-org "${targetOrg}" --output-dir "${retrieveDir}"`, { maxBuffer: SF_MAX_BUFFER });
-        const reconcile = await reconcileSourceDeletions(sourceDir, retrieveDir, new Set(manifestTypes));
-        await syncAuthoritativeRetrieveIntoSource(sourceDir, retrieveDir);
-        return ok({ manifestTypes, deletedCount: reconcile.deletedCount });
-      } catch (cause) {
-        return err(`sf project retrieve failed: ${cause instanceof Error ? cause.message : String(cause)}`);
-      } finally {
-        await rm5(manifestPath, { force: true }).catch(() => {
-        });
-        await rm5(retrieveDir, { recursive: true, force: true }).catch(() => {
-        });
+      const outcome = await retrieveWithFallback(manifestTypes, (types) => retrieveTypeBatch(targetOrg, sourceDir, types));
+      if (outcome.succeeded.length === 0) {
+        return err(`sf project retrieve failed: ${summarizeRetrieveFailures(outcome.failures)}`);
       }
+      return ok({
+        manifestTypes: outcome.succeeded,
+        deletedCount: outcome.deletedCount,
+        failures: outcome.failures
+      });
     };
     computeReconciledTypes = (pullManifestTypes, sourceRoot, failures) => {
       if (pullManifestTypes === null || pullManifestTypes.length === 0)
@@ -127699,6 +127774,9 @@ ${typesXml}
       if (result.errors.length > 0) {
         lines.push("", `Errors (${result.errors.length}):`, ...result.errors.map(formatFailure));
       }
+      if (result.retrieveFailures !== void 0 && result.retrieveFailures.length > 0) {
+        lines.push("", `Partial retrieve \u2014 ${result.retrieveFailures.length} metadata type(s) skipped (the org may have rejected them; the vault is built from what landed):`, ...result.retrieveFailures.map((f2) => `  ${f2.type}: ${firstErrorLine(f2.error)}`));
+      }
       if (result.fatalError !== void 0) {
         lines.push("", `Fatal: ${result.fatalError}`);
       }
@@ -128960,6 +129038,14 @@ var registerStatusCommand = (program) => {
 // dist/src/commands/doctor.js
 var execAsync2 = promisify5(exec2);
 var DEFAULT_VAULT_ROOT2 = "org-kb";
+var parseSfCliVersion = (versionLine) => {
+  const m2 = /(\d+)\.(\d+)\.(\d+)/.exec(versionLine);
+  if (m2 === null)
+    return null;
+  return [Number(m2[1]), Number(m2[2]), Number(m2[3])];
+};
+var isLegacySfdxToolbelt = (versionLine) => /sfdx-cli\//i.test(versionLine);
+var formatVersion = (v2) => v2.join(".");
 var summarizeRouteGaps = async (logFile) => {
   let raw;
   try {
@@ -129031,6 +129117,15 @@ var runDoctor = async (opts) => {
       }
     }
   }
+  if (sfDetail !== null && isLegacySfdxToolbelt(sfDetail)) {
+    const parsed = parseSfCliVersion(sfDetail);
+    checks.push({
+      name: "Salesforce CLI version",
+      status: "warn",
+      detail: `legacy sfdx-cli${parsed !== null ? ` ${formatVersion(parsed)}` : ""} detected \u2014 it predates \`sf project retrieve start\` (used by refresh) and cannot drive a vault refresh`,
+      fix: "Install the modern unified CLI: npm install --global @salesforce/cli@latest"
+    });
+  }
   if (sfOnPath) {
     checks.push({ name: "Salesforce CLI", status: "pass", detail: sfDetail ?? "installed" });
   } else if (sfDetail !== null) {
@@ -129578,11 +129673,20 @@ init_dist();
 init_src7();
 init_src2();
 import { execFile as execFile4 } from "node:child_process";
-import { stat as stat14 } from "node:fs/promises";
+import { readFile as readFile83, stat as stat14 } from "node:fs/promises";
 import { resolve as resolve10 } from "node:path";
 import { promisify as promisify7 } from "node:util";
 var DEFAULT_VAULT_ROOT4 = "org-kb";
 var SHUTDOWN_SIGNALS = ["SIGINT", "SIGTERM"];
+var readBoundOrg = async (configPath) => {
+  try {
+    const raw = await readFile83(configPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return typeof parsed.targetOrg === "string" ? parsed.targetOrg : null;
+  } catch {
+    return null;
+  }
+};
 var nodeExecFile3 = promisify7(execFile4);
 var defaultListOrgs = async () => {
   try {
@@ -129608,11 +129712,12 @@ var defaultListOrgs = async () => {
   }
 };
 var prepareMcp = async (opts) => {
-  const vaultRoot = resolve10(opts.cwd, DEFAULT_VAULT_ROOT4);
+  const vaultRoot = opts.vaultRoot !== void 0 ? resolve10(opts.cwd, opts.vaultRoot) : resolve10(opts.cwd, DEFAULT_VAULT_ROOT4);
   const paths = vaultPaths(vaultRoot);
   if (!await pathExists6(paths.config)) {
     const orgs = await (opts.listOrgs ?? defaultListOrgs)();
-    const base = "No vault. Run `sfi init` followed by `sfi refresh`.";
+    const where = opts.vaultRoot !== void 0 ? ` at ${vaultRoot}` : "";
+    const base = `No vault${where}. Run \`sfi init\` followed by \`sfi refresh\`, or point \`sfi mcp --vault <path>\` at an existing org-kb.`;
     const hint = orgs.length > 0 ? ` You are authenticated to ${orgs.length} org(s): ${orgs.slice(0, 8).join(", ")}${orgs.length > 8 ? ", \u2026" : ""}. Run \`sfi init\` to pick the one you want and build its knowledge base \u2014 live answers attach to a vault's org, so the product never guesses which of your orgs to query.` : "";
     return err({ kind: "no-vault", message: base + hint });
   }
@@ -129620,7 +129725,13 @@ var prepareMcp = async (opts) => {
   if (!ctxResult.ok) {
     return err({ kind: "buildContext-failed", message: ctxResult.error.message });
   }
-  return ok({ ctx: ctxResult.value, server: createServer(ctxResult.value) });
+  const targetOrg = await readBoundOrg(paths.config);
+  return ok({
+    ctx: ctxResult.value,
+    server: createServer(ctxResult.value),
+    vaultRoot,
+    targetOrg
+  });
 };
 var pathExists6 = async (path) => {
   try {
@@ -129632,14 +129743,19 @@ var pathExists6 = async (path) => {
 };
 var isEnoent5 = (cause) => typeof cause === "object" && cause !== null && "code" in cause && cause.code === "ENOENT";
 var registerMcpCommand = (program) => {
-  program.command("mcp").description("Run the MCP server backing the org-kb vault").action(async () => {
-    const prepared = await prepareMcp({ cwd: process.cwd() });
+  program.command("mcp").description("Run the MCP server backing the org-kb vault").option("--vault <path>", "Serve a specific org-kb vault instead of ./org-kb (bind a project to the right org)").action(async (cmdOpts) => {
+    const prepared = await prepareMcp({
+      cwd: process.cwd(),
+      ...cmdOpts.vault !== void 0 ? { vaultRoot: cmdOpts.vault } : {}
+    });
     if (!prepared.ok) {
       process.stderr.write(`sfi mcp: ${prepared.error.message}
 `);
       process.exit(1);
     }
-    const { ctx, server } = prepared.value;
+    const { ctx, server, vaultRoot, targetOrg } = prepared.value;
+    process.stderr.write(`sfi mcp: serving vault ${vaultRoot}${targetOrg !== null ? ` (org: ${targetOrg})` : " (no targetOrg in config)"}
+`);
     const shutdownOnce = makeShutdownOnce(ctx);
     for (const signal of SHUTDOWN_SIGNALS) {
       process.on(signal, () => {
@@ -129916,7 +130032,7 @@ init_vault_git();
 init_watch();
 var readVersion = () => {
   if (true)
-    return "0.1.10";
+    return "0.1.11";
   const pkgUrl = new URL("../../package.json", import.meta.url);
   const raw = readFileSync5(fileURLToPath2(pkgUrl), "utf8");
   const parsed = JSON.parse(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sf-intelligence",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "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",
@@ -51,11 +51,11 @@
     "@sf-intelligence/core": "0.1.0",
     "@sf-intelligence/extractors": "0.1.0",
     "@sf-intelligence/mcp": "0.1.0",
-    "@sf-intelligence/parsers": "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/patterns": "0.1.0",
+    "@sf-intelligence/parsers": "0.1.0",
     "@sf-intelligence/graph": "0.1.0"
   },
   "scripts": {