@ryanstark24/sfgraph-core 1.4.0 → 1.6.0

package/dist/extractors/live-org/capabilities.js

@@ -1,3 +1,4 @@
+import { isOrgRejection, withRetry } from "./retry.js";
 export const VLOCITY_NAMESPACE_CANDIDATES = [
     "vlocity_cmt",
     "vlocity_ins",
@@ -45,16 +46,55 @@ async function safeToolingQuery(conn, soql) {
         return null;
     }
 }
-async function describeExists(conn, name, useTooling = false) {
+/** The describe failed because the object is not in this org (or the user
+ *  cannot see it) — a definite "no", not a transient failure. */
+function isAbsent(e) {
+    if (isOrgRejection(e))
+        return true;
+    const msg = e instanceof Error
+        ? `${e.errorCode ?? ""} ${e.message}`
+        : String(e);
+    return /NOT_FOUND|does not exist|no such/i.test(msg);
+}
+/** Retries for a transient describe failure (backoff per retry.ts). */
+const PROBE_RETRIES = 2;
+/**
+ * Probe whether `name` is describable. Absence → false. Any other failure
+ * (timeout, reset, 5xx) is retried; if it still fails the probe is recorded
+ * in `errors` (and reported false). Previously every error mapped to false,
+ * so a probe timeout silently removed the whole vlocity / omnistudio source.
+ */
+async function describeExists(conn, name, useTooling, source, errors) {
+    const root = useTooling ? conn.tooling : conn;
     try {
-        const root = useTooling ? conn.tooling : conn;
-        await withCapsTimeout(root.sobject(name).describe(), `describe ${name}`);
+        await withRetry(async () => {
+            try {
+                await withCapsTimeout(root.sobject(name).describe(), `describe ${name}`);
+            }
+            catch (e) {
+                // Absence is an answer, not a failure: stop retrying.
+                if (isAbsent(e))
+                    throw new AbsentError();
+                throw e;
+            }
+        }, { retries: PROBE_RETRIES });
         return true;
     }
-    catch {
+    catch (e) {
+        if (e instanceof AbsentError)
+            return false;
+        errors.push({ probe: name, source, error: e instanceof Error ? e.message : String(e) });
         return false;
     }
 }
+/** Internal marker: the probed object does not exist. Classified as an org
+ *  rejection (INVALID_TYPE in the message) so withRetry does not retry it. */
+class AbsentError extends Error {
+    constructor() {
+        super("INVALID_TYPE: probed object absent");
+        this.name = "AbsentError";
+    }
+}
 /** Probe a Salesforce org for installed packages, features, and source-tracking support. */
 export async function probeCapabilities(conn) {
     // Organization metadata
@@ -68,13 +108,17 @@ export async function probeCapabilities(conn) {
                 namespaces.push(r.NamespacePrefix);
         }
     }
-    const vlocityProbes = await Promise.all(VLOCITY_NAMESPACE_CANDIDATES.map((ns) => describeExists(conn, `${ns}__DRBundle__c`)));
+    const probeErrors = [];
+    const vlocityProbes = await Promise.all(VLOCITY_NAMESPACE_CANDIDATES.map((ns) => describeExists(conn, `${ns}__DRBundle__c`, false, "vlocity", probeErrors)));
     const vlocityNamespaces = VLOCITY_NAMESPACE_CANDIDATES.filter((_ns, i) => vlocityProbes[i]);
     const [omnistudioOncore, agentforce, experienceCloud, sourceTracking] = await Promise.all([
-        describeExists(conn, "OmniProcess"),
-        describeExists(conn, "GenAiPlanner", true),
-        describeExists(conn, "Network"),
-        describeExists(conn, "SourceMember", true),
+        describeExists(conn, "OmniProcess", false, "omnistudio", probeErrors),
+        // These gate no bulk-retrieve source (sourceTracking only picks
+        // incremental vs full; false → full, the safe direction), but their
+        // failures are still reported.
+        describeExists(conn, "GenAiPlanner", true, null, probeErrors),
+        describeExists(conn, "Network", false, null, probeErrors),
+        describeExists(conn, "SourceMember", true, null, probeErrors),
     ]);
     return {
         detectedNamespaces: namespaces,
@@ -85,6 +129,7 @@ export async function probeCapabilities(conn) {
         agentforce,
         experienceCloud,
         sourceTracking,
+        ...(probeErrors.length > 0 ? { probeErrors } : {}),
     };
 }
 //# sourceMappingURL=capabilities.js.map

package/dist/extractors/live-org/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/extractors/live-org/capabilities.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,aAAa;IACb,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,sEAAsE;IACtE,uEAAuE;IACvE,oEAAoE;IACpE,0DAA0D;IAC1D,gEAAgE;IAChE,YAAY;CACJ,CAAC;AAkBX,0EAA0E;AAC1E,yEAAyE;AACzE,yEAAyE;AACzE,qEAAqE;AACrE,6CAA6C;AAC7C,MAAM,qBAAqB,GAAG,MAAM,CAAC;AACrC,KAAK,UAAU,eAAe,CAAI,CAAa,EAAE,KAAa;IAC5D,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,CAAC,GAAG,UAAU,CAClB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,KAAK,aAAa,qBAAqB,KAAK,CAAC,CAAC,EAC3F,qBAAqB,CACtB,CAAC;QACF,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,EAAE,EAAE;YACJ,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,EACD,CAAC,CAAC,EAAE,EAAE;YACJ,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAS,EAAE,IAAY;IAC9C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAE5E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAS,EAAE,IAAY;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAEtF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAS,EAAE,IAAY,EAAE,UAAU,GAAG,KAAK;IACvE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAS;IAC/C,wBAAwB;IACxB,MAAM,SAAS,CAAC,IAAI,EAAE,kEAAkE,CAAC,CAAC;IAE1F,2CAA2C;IAC3C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,4CAA4C,CAAC,CAAC;IACxF,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAA8C,EAAE,CAAC;YACpE,IAAI,CAAC,CAAC,eAAe;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,4BAA4B,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CACrF,CAAC;IACF,MAAM,iBAAiB,GAAa,4BAA4B,CAAC,MAAM,CACrE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAC7B,CAAC;IAEF,MAAM,CAAC,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxF,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC;QACnC,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC;QAC1C,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC;QAC/B,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC;KAC3C,CAAC,CAAC;IAEH,OAAO;QACL,kBAAkB,EAAE,UAAU;QAC9B,iBAAiB;QACjB,aAAa,EAAE,iBAAiB,CAAC,MAAM,GAAG,CAAC;QAC3C,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC;QACrD,gBAAgB;QAChB,UAAU;QACV,eAAe;QACf,cAAc;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/extractors/live-org/capabilities.ts"],"names":[],"mappings":"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"}

package/dist/extractors/live-org/extractors/apex.d.ts

@@ -1,5 +1,15 @@
 import type { RawMember } from "../../interfaces/metadata-source.js";
-export declare function iterApex(conn: any): AsyncIterable<RawMember>;
-/** Re-fetch a single Apex member by name (used for incremental updates). */
+import { type RetryOptions } from "../retry.js";
+/** Options for {@link iterApex} (page-fetch retry tuning; tests pass
+ *  `retryBackoffMs: 0`). */
+export type IterApexOptions = RetryOptions;
+export declare function iterApex(conn: any, options?: IterApexOptions): AsyncIterable<RawMember>;
+/**
+ * Re-fetch a single Apex member by name. Not called by the live ingest today
+ * (incremental mode does not re-fetch content); kept on the public surface
+ * (`iterOneApex`) and built with the same envelope as {@link iterApex} —
+ * managed-body stub, metaXml and `shadowsManaged` — so adopting it cannot
+ * flip a node's hash or drop the attribute (review M2).
+ */
 export declare function iterOne(conn: any, name: string): Promise<RawMember | null>;
 //# sourceMappingURL=apex.d.ts.map

package/dist/extractors/live-org/extractors/apex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apex.d.ts","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/apex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAiErE,wBAAuB,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,aAAa,CAAC,SAAS,CAAC,CAsEnE;AAED,4EAA4E;AAC5E,wBAAsB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA2BhF"}
+{"version":3,"file":"apex.d.ts","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/apex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,aAAa,CAAC;AAuH9E;4BAC4B;AAC5B,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAqB3C,wBAAuB,QAAQ,CAC7B,IAAI,EAAE,GAAG,EACT,OAAO,GAAE,eAAoB,GAC5B,aAAa,CAAC,SAAS,CAAC,CA4F1B;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA4BhF"}

package/dist/extractors/live-org/extractors/apex.js

@@ -1,6 +1,10 @@
 import { METADATA_CATEGORY } from "../../../domain/index.js";
 import { scheduleQuery, soqlWithTimeout } from "../rate-limit.js";
+import { drainSoqlPages, querySoqlAll } from "../retry.js";
 const APEX_CLASS_SOQL = "SELECT Id, Name, Body, NamespacePrefix, LastModifiedDate, ApiVersion, Status FROM ApexClass";
+/** Light listing (no Body) used to find local/managed name collisions before
+ *  the body drain starts. */
+const APEX_CLASS_NAMES_SOQL = "SELECT Name, NamespacePrefix FROM ApexClass";
 const APEX_TRIGGER_SOQL = "SELECT Id, Name, Body, NamespacePrefix, LastModifiedDate, ApiVersion, Status, TableEnumOrId FROM ApexTrigger";
 /**
  * Build the minimal `<*MetaXml>` envelope the parser would otherwise get
@@ -9,19 +13,71 @@ const APEX_TRIGGER_SOQL = "SELECT Id, Name, Body, NamespacePrefix, LastModifiedD
  * channel — without this, live-ingested Apex nodes always had
  * apiVersion: null, while filesystem-ingested ones had the real value.
  */
-function buildApexMetaXml(outerTag, row) {
+function buildApexMetaXml(outerTag, row, shadowsManaged = []) {
     const av = row.ApiVersion;
     const status = row.Status;
-    if (av == null && !status)
+    if (av == null && !status && shadowsManaged.length === 0)
         return undefined;
     const parts = [`<?xml version="1.0" encoding="UTF-8"?>`, `<${outerTag}>`];
     if (av != null)
         parts.push(`  <apiVersion>${String(av)}</apiVersion>`);
     if (status)
         parts.push(`  <status>${status}</status>`);
+    // sfgraph extension (not a Salesforce field): managed-package namespaces
+    // whose same-named class this local class shadows in the graph.
+    for (const ns of shadowsManaged)
+        parts.push(`  <shadowsManaged>${ns}</shadowsManaged>`);
     parts.push(`</${outerTag}>`);
     return parts.join("\n");
 }
+function indexApexNames(rows) {
+    const idx = { local: new Set(), managed: new Map() };
+    for (const r of rows) {
+        if (!r?.Name)
+            continue;
+        const key = r.Name.toLowerCase();
+        if (!r.NamespacePrefix)
+            idx.local.add(key);
+        else {
+            const set = idx.managed.get(key) ?? new Set();
+            set.add(r.NamespacePrefix);
+            idx.managed.set(key, set);
+        }
+    }
+    return idx;
+}
+/** Body to emit: managed-package bodies are redacted by the org, so they are
+ *  stubbed to "" unless SFGRAPH_INCLUDE_MANAGED=1. */
+function includeManagedBodies() {
+    return process.env.SFGRAPH_INCLUDE_MANAGED === "1";
+}
+function stubBody(r, includeManaged) {
+    return r.NamespacePrefix && !includeManaged ? "" : (r.Body ?? "");
+}
+/** The RawMember shape for an ApexClass / ApexTrigger row. Shared by
+ *  {@link iterApex} and {@link iterOne} so both produce byte-identical
+ *  content (and therefore the same node hash). */
+function apexMember(type, r, includeManaged, shadows = []) {
+    return {
+        ref: {
+            category: type === "ApexClass" ? METADATA_CATEGORY.APEX_CLASS : METADATA_CATEGORY.APEX_TRIGGER,
+            memberType: type,
+            memberName: r.Name,
+            lastModifiedAt: r.LastModifiedDate ?? null,
+            sourceUri: `sf://tooling/${type}/${r.Name}`,
+            namespace: r.NamespacePrefix ?? null,
+        },
+        // JSON envelope so adaptParserInput can forward metaXml (containing
+        // apiVersion + Status) alongside the body. Plain-body content from
+        // the filesystem path still parses correctly via the adapter's
+        // shape detection.
+        content: JSON.stringify({
+            body: stubBody(r, includeManaged),
+            metaXml: buildApexMetaXml(type, r, shadows),
+            ...(r.NamespacePrefix && !includeManaged ? { managed: true } : {}),
+        }),
+    };
+}
 /**
  * Drain a Tooling SOQL query across ALL pages. `conn.tooling.query` returns at
  * most one page (200 rows); without following `nextRecordsUrl` via `queryMore`
@@ -29,102 +85,117 @@ function buildApexMetaXml(outerTag, row) {
  * (7k+ classes) that dropped ~97% of the source, and that first page is
  * dominated by managed-package classes whose body is stubbed, so almost
  * nothing parsed. Streams rows so we never hold the whole (body-heavy) result
- * set in memory at once.
+ * set in memory at once. Each page fetch is re-tried with backoff; a page that
+ * still fails throws "drain truncated after N rows" (see retry.ts).
  */
-async function* drainToolingQuery(conn, soql, label) {
-    let result = await scheduleQuery(() => soqlWithTimeout(conn.tooling.query(soql), label));
-    while (result) {
-        for (const r of (result.records ?? []))
-            yield r;
-        if (result.done || !result.nextRecordsUrl || typeof conn.tooling.queryMore !== "function") {
-            break;
-        }
-        result = await scheduleQuery(() => soqlWithTimeout(conn.tooling.queryMore(result.nextRecordsUrl), `${label} more`));
-    }
+function drainToolingQuery(conn, soql, label, opts) {
+    return drainSoqlPages(conn.tooling, soql, label, scheduleQuery, opts);
 }
-export async function* iterApex(conn) {
+export async function* iterApex(conn, options = {}) {
+    const drainOpts = options;
     // For managed-package Apex, Body comes back redacted (empty / "(hidden)") —
     // parsing it produces nothing useful. We still emit the node (so calling
     // code's edges resolve to a real target) with an empty body, which the
     // parser turns into a bare node. Set SFGRAPH_INCLUDE_MANAGED=1 to keep the
     // redacted Body instead.
-    const includeManaged = process.env.SFGRAPH_INCLUDE_MANAGED === "1";
-    const stubBody = (r) => r.NamespacePrefix && !includeManaged ? "" : (r.Body ?? "");
-    // Classes and triggers are drained independently and fail-soft: a failure
-    // fetching one must not drop the other (an unhandled jsforce rejection also
-    // crashes node 24+, hence the per-stream try/catch).
+    const includeManaged = includeManagedBodies();
+    // Classes and triggers are drained independently: a failure fetching one
+    // must not drop the other (an unhandled jsforce rejection also crashes
+    // node 24+, hence the per-stream try/catch). But a failure must NOT be
+    // swallowed — a partial drain used to log "apex ✓" with skips=0 (large live org:
+    // 3,600 of 7,662 classes). The first failure is re-thrown after both
+    // streams ran, so the bulk-retrieve failSoft wrapper records an `apex` skip
+    // while keeping every row already yielded.
+    const failures = [];
+    // Local wins over managed (same name => same qname). A light Name /
+    // NamespacePrefix listing tells us up front which names collide, so a
+    // managed row is dropped whichever order the drain returns the rows in,
+    // and the local row carries `shadowsManaged`. If the listing fails, the
+    // drain still runs: managed rows are held back until the drain ends and
+    // only emitted when no local class of that name was seen, and the
+    // listing failure is surfaced with the others.
+    let names = null;
     try {
-        for await (const r of drainToolingQuery(conn, APEX_CLASS_SOQL, "tooling ApexClass")) {
-            const metaXml = buildApexMetaXml("ApexClass", r);
-            yield {
-                ref: {
-                    category: METADATA_CATEGORY.APEX_CLASS,
-                    memberType: "ApexClass",
-                    memberName: r.Name,
-                    lastModifiedAt: r.LastModifiedDate ?? null,
-                    sourceUri: `sf://tooling/ApexClass/${r.Name}`,
-                    namespace: r.NamespacePrefix ?? null,
-                },
-                // JSON envelope so adaptParserInput can forward metaXml (containing
-                // apiVersion + Status) alongside the body. Plain-body content from
-                // the filesystem path still parses correctly via the adapter's
-                // shape detection.
-                content: JSON.stringify({
-                    body: stubBody(r),
-                    metaXml,
-                    ...(r.NamespacePrefix && !includeManaged ? { managed: true } : {}),
-                }),
-            };
+        names = indexApexNames(await querySoqlAll(conn.tooling, APEX_CLASS_NAMES_SOQL, "tooling ApexClass names", scheduleQuery, drainOpts));
+    }
+    catch (e) {
+        failures.push(e);
+    }
+    const classMember = (r, shadows = []) => apexMember("ApexClass", r, includeManaged, shadows);
+    const seenLocal = new Set();
+    const heldManaged = [];
+    let classDrainComplete = false;
+    try {
+        for await (const r of drainToolingQuery(conn, APEX_CLASS_SOQL, "tooling ApexClass", drainOpts)) {
+            const key = r.Name.toLowerCase();
+            if (r.NamespacePrefix) {
+                if (names?.local.has(key) || seenLocal.has(key))
+                    continue; // shadowed
+                if (!names)
+                    heldManaged.push(r);
+                else
+                    yield classMember(r);
+                continue;
+            }
+            seenLocal.add(key);
+            yield classMember(r, [...(names?.managed.get(key) ?? [])].sort());
         }
+        classDrainComplete = true;
     }
-    catch {
-        /* fail-soft: skip ApexClass on fetch failure, still try triggers */
+    catch (e) {
+        failures.push(e);
+    }
+    // Held managed rows (listing failed) are only safe to emit once the body
+    // drain finished: after a truncated drain a local class of the same name
+    // may sit on an unfetched page, and the managed stub would overwrite it
+    // (review M1). The failure is re-thrown below, so the `apex` skip makes
+    // `--retry-skipped` fetch them.
+    if (classDrainComplete) {
+        for (const r of heldManaged) {
+            if (!seenLocal.has(r.Name.toLowerCase()))
+                yield classMember(r);
+        }
     }
     try {
-        for await (const r of drainToolingQuery(conn, APEX_TRIGGER_SOQL, "tooling ApexTrigger")) {
-            const metaXml = buildApexMetaXml("ApexTrigger", r);
-            yield {
-                ref: {
-                    category: METADATA_CATEGORY.APEX_TRIGGER,
-                    memberType: "ApexTrigger",
-                    memberName: r.Name,
-                    lastModifiedAt: r.LastModifiedDate ?? null,
-                    sourceUri: `sf://tooling/ApexTrigger/${r.Name}`,
-                    namespace: r.NamespacePrefix ?? null,
-                },
-                content: JSON.stringify({
-                    body: stubBody(r),
-                    metaXml,
-                    ...(r.NamespacePrefix && !includeManaged ? { managed: true } : {}),
-                }),
-            };
+        for await (const r of drainToolingQuery(conn, APEX_TRIGGER_SOQL, "tooling ApexTrigger", drainOpts)) {
+            yield apexMember("ApexTrigger", r, includeManaged);
         }
     }
-    catch {
-        /* fail-soft: skip ApexTrigger on fetch failure */
+    catch (e) {
+        failures.push(e);
+    }
+    if (failures.length > 0) {
+        throw new Error(failures.map((f) => f.message).join("; "), { cause: failures[0] });
     }
 }
-/** Re-fetch a single Apex member by name (used for incremental updates). */
+/**
+ * Re-fetch a single Apex member by name. Not called by the live ingest today
+ * (incremental mode does not re-fetch content); kept on the public surface
+ * (`iterOneApex`) and built with the same envelope as {@link iterApex} —
+ * managed-body stub, metaXml and `shadowsManaged` — so adopting it cannot
+ * flip a node's hash or drop the attribute (review M2).
+ */
 export async function iterOne(conn, name) {
-    const escaped = name.replace(/'/g, "\\'");
-    const tryQuery = async (soql, type) => {
+    const escaped = name.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+    const includeManaged = includeManagedBodies();
+    const fetchRows = async (soql, type) => {
         const res = (await scheduleQuery(() => soqlWithTimeout(conn.tooling.query(soql), `tooling ${type} ${name}`)));
-        const r = res?.records?.[0];
-        if (!r)
-            return null;
-        return {
-            ref: {
-                category: type === "ApexClass" ? METADATA_CATEGORY.APEX_CLASS : METADATA_CATEGORY.APEX_TRIGGER,
-                memberType: type,
-                memberName: r.Name,
-                lastModifiedAt: r.LastModifiedDate ?? null,
-                sourceUri: `sf://tooling/${type}/${r.Name}`,
-                namespace: r.NamespacePrefix ?? null,
-            },
-            content: r.Body ?? "",
-        };
+        return res?.records ?? [];
     };
-    return ((await tryQuery(`${APEX_CLASS_SOQL} WHERE Name = '${escaped}' LIMIT 1`, "ApexClass")) ??
-        (await tryQuery(`${APEX_TRIGGER_SOQL} WHERE Name = '${escaped}' LIMIT 1`, "ApexTrigger")));
+    // Every class with this name (local + managed namespaces; at most a
+    // handful). NULLS FIRST puts the local class first; the pick below does
+    // not rely on the ordering.
+    const classRows = await fetchRows(`${APEX_CLASS_SOQL} WHERE Name = '${escaped}' ORDER BY NamespacePrefix NULLS FIRST`, "ApexClass");
+    const local = classRows.find((r) => !r.NamespacePrefix);
+    if (local) {
+        const shadows = [
+            ...new Set(classRows.map((r) => r.NamespacePrefix).filter((ns) => !!ns)),
+        ].sort();
+        return apexMember("ApexClass", local, includeManaged, shadows);
+    }
+    if (classRows[0])
+        return apexMember("ApexClass", classRows[0], includeManaged);
+    const trig = (await fetchRows(`${APEX_TRIGGER_SOQL} WHERE Name = '${escaped}' LIMIT 1`, "ApexTrigger"))[0];
+    return trig ? apexMember("ApexTrigger", trig, includeManaged) : null;
 }
 //# sourceMappingURL=apex.js.map

package/dist/extractors/live-org/extractors/apex.js.map

@@ -1 +1 @@
-{"version":3,"file":"apex.js","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/apex.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apex.js","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/apex.ts"],"names":[],"mappings":"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"}

package/dist/extractors/live-org/extractors/custom-settings.d.ts

@@ -1,3 +1,4 @@
 import type { RawMember } from "../../interfaces/metadata-source.js";
-export declare function iterCustomSettings(conn: any, orgId: string): AsyncIterable<RawMember>;
+import { type RetryOptions } from "../retry.js";
+export declare function iterCustomSettings(conn: any, orgId: string, retryOpts?: RetryOptions): AsyncIterable<RawMember>;
 //# sourceMappingURL=custom-settings.d.ts.map

package/dist/extractors/live-org/extractors/custom-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-settings.d.ts","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/custom-settings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAqCrE,wBAAuB,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CA2D5F"}
+{"version":3,"file":"custom-settings.d.ts","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/custom-settings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAEL,KAAK,YAAY,EAKlB,MAAM,aAAa,CAAC;AAoCrB,wBAAuB,kBAAkB,CACvC,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,YAAiB,GAC3B,aAAa,CAAC,SAAS,CAAC,CAmE1B"}

package/dist/extractors/live-org/extractors/custom-settings.js

@@ -1,5 +1,6 @@
 import { METADATA_CATEGORY } from "../../../domain/index.js";
 import { scheduleData, scheduleQuery, soqlWithTimeout } from "../rate-limit.js";
+import { isOrgRejection, querySoqlAll, throwIfIncomplete, withRetry, } from "../retry.js";
 const SYS_FIELDS = new Set([
     "Id",
     "attributes",
@@ -13,29 +14,37 @@ const SYS_FIELDS = new Set([
 /** FIELDS(ALL) requires a row bound ≤ 200. Custom settings rarely exceed that
  *  except hierarchy settings with a row per profile/user; we cap and note it. */
 const ROW_CAP = 200;
-export async function* iterCustomSettings(conn, orgId) {
+export async function* iterCustomSettings(conn, orgId, retryOpts = {}) {
     let entities = [];
     try {
-        const res = (await scheduleQuery(() => soqlWithTimeout(conn.tooling.query("SELECT QualifiedApiName FROM EntityDefinition WHERE IsCustomSetting = true"), "tooling EntityDefinition IsCustomSetting")));
-        entities = res?.records ?? [];
+        // Drain every page and retry: a truncated discovery silently loses
+        // custom settings.
+        entities = await querySoqlAll(conn.tooling, "SELECT QualifiedApiName FROM EntityDefinition WHERE IsCustomSetting = true", "tooling EntityDefinition IsCustomSetting", scheduleQuery, retryOpts);
     }
     catch (e) {
         // EntityDefinition unavailable (some scratch orgs) — nothing to do.
-        console.log(`ingest:   custom-settings discovery failed: ${e.message?.slice(0, 160) ?? String(e)}`);
-        return;
+        // Anything else (timeouts, connection loss) must surface as a skip.
+        if (isOrgRejection(e))
+            return;
+        throw e;
     }
+    const failures = [];
     for (const ent of entities) {
         const obj = ent.QualifiedApiName;
         if (!obj)
             continue;
         let rows = [];
         try {
-            const res = (await scheduleData(() => soqlWithTimeout(conn.query(`SELECT FIELDS(ALL) FROM ${obj} LIMIT ${ROW_CAP}`), `data ${obj} (custom-setting rows)`)));
+            // LIMIT ROW_CAP (200) fits in one page, so no queryMore needed.
+            const res = (await withRetry(() => scheduleData(() => soqlWithTimeout(conn.query(`SELECT FIELDS(ALL) FROM ${obj} LIMIT ${ROW_CAP}`), `data ${obj} (custom-setting rows)`)), retryOpts));
             rows = res?.records ?? [];
         }
-        catch {
-            // Object may be empty, inaccessible, or non-queryable — skip silently;
-            // the schema node still exists from the object extractor.
+        catch (e) {
+            // Inaccessible / non-queryable objects have no rows to capture; the
+            // schema node still exists from the object extractor. Transient
+            // failures are recorded and surfaced after the loop.
+            if (!isOrgRejection(e))
+                failures.push({ name: obj, error: e });
             continue;
         }
         if (rows.length === 0)
@@ -62,5 +71,6 @@ export async function* iterCustomSettings(conn, orgId) {
             content: JSON.stringify({ name: obj, rows: cleaned, rowCount: rows.length }),
         };
     }
+    throwIfIncomplete("custom-settings", failures);
 }
 //# sourceMappingURL=custom-settings.js.map

package/dist/extractors/live-org/extractors/custom-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-settings.js","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/custom-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAqBhF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,IAAI;IACJ,YAAY;IACZ,gBAAgB;IAChB,aAAa;IACb,aAAa;IACb,kBAAkB;IAClB,kBAAkB;IAClB,WAAW;CACZ,CAAC,CAAC;AAEH;iFACiF;AACjF,MAAM,OAAO,GAAG,GAAG,CAAC;AAEpB,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CAAC,IAAS,EAAE,KAAa;IAChE,IAAI,QAAQ,GAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,aAAa,CAAC,GAAG,EAAE,CACpC,eAAe,CACb,IAAI,CAAC,OAAO,CAAC,KAAK,CAChB,4EAA4E,CAC7E,EACD,0CAA0C,CAC3C,CACF,CAAqC,CAAC;QACvC,QAAQ,GAAG,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,oEAAoE;QACpE,OAAO,CAAC,GAAG,CACT,+CAAgD,CAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAClG,CAAC;QACF,OAAO;IACT,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,IAAI,GAAmC,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,MAAM,YAAY,CAAC,GAAG,EAAE,CACnC,eAAe,CACb,IAAI,CAAC,KAAK,CAAC,2BAA2B,GAAG,UAAU,OAAO,EAAE,CAAC,EAC7D,QAAQ,GAAG,wBAAwB,CACpC,CACF,CAAwD,CAAC;YAC1D,IAAI,GAAG,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,0DAA0D;YAC1D,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAChC,oEAAoE;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;oBAAE,SAAS;gBAC1D,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACb,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;QACH,MAAM;YACJ,GAAG,EAAE;gBACH,QAAQ,EAAE,iBAAiB,CAAC,cAAc;gBAC1C,UAAU,EAAE,eAAe;gBAC3B,UAAU,EAAE,GAAG;gBACf,cAAc,EAAE,IAAI;gBACpB,SAAS,EAAE,QAAQ,KAAK,kBAAkB,GAAG,EAAE;gBAC/C,SAAS,EAAE,IAAI;aAChB;YACD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"custom-settings.js","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/custom-settings.ts"],"names":[],"mappings":"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"}

package/dist/extractors/live-org/extractors/flow.d.ts

@@ -1,9 +1,10 @@
 import type { RawMember } from "../../interfaces/metadata-source.js";
+import { type RetryOptions } from "../retry.js";
 /**
  * Streams Flow metadata reads through a sliding-window. Each batch yields
  * records as soon as it returns instead of waiting for all batches — keeps
  * failSoft's inactivity timer happy on orgs with many flows where the
  * full-collect pattern was breaching the 180s no-yield ceiling.
  */
-export declare function iterFlow(conn: any): AsyncIterable<RawMember>;
+export declare function iterFlow(conn: any, retryOpts?: RetryOptions): AsyncIterable<RawMember>;
 //# sourceMappingURL=flow.d.ts.map

package/dist/extractors/live-org/extractors/flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/flow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAqBrE;;;;;GAKG;AACH,wBAAuB,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,aAAa,CAAC,SAAS,CAAC,CAiDnE"}
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../../src/extractors/live-org/extractors/flow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAOrE,OAAO,EAEL,KAAK,YAAY,EAIlB,MAAM,aAAa,CAAC;AAerB;;;;;GAKG;AACH,wBAAuB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,GAAE,YAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA4DjG"}

package/dist/extractors/live-org/extractors/flow.js

@@ -1,6 +1,7 @@
 import { XMLBuilder } from "fast-xml-parser";
 import { METADATA_CATEGORY } from "../../../domain/index.js";
 import { METADATA_LIST_TIMEOUT_MS, readMetadataBatchAdaptive, scheduleMetadata, withTimeout, } from "../rate-limit.js";
+import { catchInto, throwIfIncomplete, withRetry, } from "../retry.js";
 const BATCH = 10;
 const xml = new XMLBuilder({
     ignoreAttributes: false,
@@ -13,8 +14,15 @@ const xml = new XMLBuilder({
  * failSoft's inactivity timer happy on orgs with many flows where the
  * full-collect pattern was breaching the 180s no-yield ceiling.
  */
-export async function* iterFlow(conn) {
-    const list = (await scheduleMetadata(() => withTimeout(conn.metadata.list([{ type: "Flow" }]), METADATA_LIST_TIMEOUT_MS, "metadata.list Flow")));
+export async function* iterFlow(conn, retryOpts = {}) {
+    // Flows the adaptive reader gave up on; re-thrown at the end so failSoft
+    // records a `flow` skip naming them (previously dropped silently).
+    const failures = [];
+    const onFailed = (names, error) => {
+        for (const name of names)
+            failures.push({ name, error });
+    };
+    const list = (await withRetry(() => scheduleMetadata(() => withTimeout(conn.metadata.list([{ type: "Flow" }]), METADATA_LIST_TIMEOUT_MS, "metadata.list Flow")), retryOpts));
     const items = Array.isArray(list) ? list : [];
     const batches = [];
     for (let i = 0; i < items.length; i += BATCH)
@@ -29,7 +37,7 @@ export async function* iterFlow(conn) {
         const p = (async () => ({
             idx,
             batch,
-            records: await readMetadataBatchAdaptive(conn, "Flow", batch),
+            records: await readMetadataBatchAdaptive(conn, "Flow", batch, 0, onFailed),
         }))();
         inFlight.set(idx, p);
     };
@@ -61,5 +69,6 @@ export async function* iterFlow(conn) {
             };
         }
     }
+    throwIfIncomplete("flow", failures);
 }
 //# sourceMappingURL=flow.js.map