@ryanstark24/sfgraph-core 1.1.4 → 1.1.8

package/dist/analyze/test-coverage.d.ts

@@ -1,6 +1,4 @@
 import type { OrgId, QualifiedName } from "@ryanstark24/sfgraph-shared";
-import type { NodeFact } from "../domain/index.js";
 import type { GraphStore } from "../storage/interfaces.js";
-export declare function findTestsFor(store: GraphStore, orgId: OrgId, qname: QualifiedName): NodeFact[];
 export declare function hasTestCoverage(store: GraphStore, orgId: OrgId, qname: QualifiedName): boolean;
 //# sourceMappingURL=test-coverage.d.ts.map

package/dist/analyze/test-coverage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-coverage.d.ts","sourceRoot":"","sources":["../../src/analyze/test-coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,GAAG,QAAQ,EAAE,CAQ9F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAE9F"}
+{"version":3,"file":"test-coverage.d.ts","sourceRoot":"","sources":["../../src/analyze/test-coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAE9F"}

package/dist/analyze/test-coverage.js

@@ -1,14 +1,4 @@
 import { REL_TYPES } from "../domain/rel-types.js";
-export function findTestsFor(store, orgId, qname) {
-    const edges = store.listEdgesTo(orgId, qname, REL_TYPES.IS_TEST_FOR);
-    const out = [];
-    for (const e of edges) {
-        const n = store.getNode(orgId, e.srcQualifiedName);
-        if (n)
-            out.push(n);
-    }
-    return out;
-}
 export function hasTestCoverage(store, orgId, qname) {
     return store.listEdgesTo(orgId, qname, REL_TYPES.IS_TEST_FOR).length > 0;
 }

package/dist/analyze/test-coverage.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-coverage.js","sourceRoot":"","sources":["../../src/analyze/test-coverage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,KAAY,EAAE,KAAoB;IAChF,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACnD,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAiB,EAAE,KAAY,EAAE,KAAoB;IACnF,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"test-coverage.js","sourceRoot":"","sources":["../../src/analyze/test-coverage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,MAAM,UAAU,eAAe,CAAC,KAAiB,EAAE,KAAY,EAAE,KAAoB;IACnF,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3E,CAAC"}

package/dist/embedding/embed.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Standalone embedder. Lazy-imports @xenova/transformers (optionalDependency
+ * on @ryanstark24/sfgraph-core), uses the vendored MiniLM-L6 weights from
+ * @ryanstark24/sfgraph-models when no override is set, and gracefully falls
+ * back to zero-vectors when either is unavailable.
+ *
+ * Env overrides (also accepted by the ingest CLI):
+ *   SFGRAPH_EMBED_MODEL_PATH   absolute path to a model directory
+ *   SFGRAPH_EMBED_MODEL_ID     model id inside that dir (default: Xenova/all-MiniLM-L6-v2)
+ *   SFGRAPH_EMBED_MODEL_DIM    embedding dim (default: 384)
+ *
+ * Exported because callers outside the ingest pipeline (e.g. the MCP
+ * `find_similar` tool's free-text mode) need to embed ad-hoc strings.
+ * Until this lived as a module-private closure inside queue.ts, ad-hoc
+ * embeddings weren't possible.
+ */
+export interface EmbedOptions {
+    /** Override the default model path (otherwise @ryanstark24/sfgraph-models). */
+    modelPath?: string;
+    /** Override model id. */
+    modelId?: string;
+    /** Override embedding dimension. */
+    dim?: number;
+}
+export declare function embedTexts(texts: string[], opts?: EmbedOptions): Promise<Float32Array[]>;
+/** Convenience: embed a single string. Returns null when transformers/model
+ *  unavailable — distinct from a zero-vector so callers can distinguish
+ *  "the runtime can't embed" from "I embedded but the result happens to be
+ *  all zeros." */
+export declare function embedSingle(text: string, opts?: EmbedOptions): Promise<Float32Array | null>;
+//# sourceMappingURL=embed.d.ts.map

package/dist/embedding/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/embedding/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CA8CzB;AAED;;;kBAGkB;AAClB,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAoB9B"}

package/dist/embedding/embed.js

@@ -0,0 +1,69 @@
+const DEFAULT_MODEL_ID = "Xenova/all-MiniLM-L6-v2";
+const DEFAULT_DIM = 384;
+export async function embedTexts(texts, opts = {}) {
+    try {
+        const mod = (await import("@xenova/transformers"));
+        const { pipeline, env } = mod;
+        env.allowRemoteModels = false;
+        const envPath = opts.modelPath ?? process.env.SFGRAPH_EMBED_MODEL_PATH;
+        const modelId = opts.modelId ?? process.env.SFGRAPH_EMBED_MODEL_ID ?? DEFAULT_MODEL_ID;
+        const dim = opts.dim ??
+            (process.env.SFGRAPH_EMBED_MODEL_DIM
+                ? Number.parseInt(process.env.SFGRAPH_EMBED_MODEL_DIM, 10)
+                : DEFAULT_DIM);
+        if (envPath) {
+            env.localModelPath = envPath;
+        }
+        else {
+            try {
+                const models = (await import("@ryanstark24/sfgraph-models"));
+                if (models?.MODEL_DATA_DIR)
+                    env.localModelPath = models.MODEL_DATA_DIR;
+            }
+            catch {
+                /* models package optional */
+            }
+        }
+        const pipe = await pipeline("feature-extraction", modelId, {
+            quantized: true,
+            local_files_only: true,
+        });
+        const out = await pipe(texts, { pooling: "mean", normalize: true });
+        const results = [];
+        for (let i = 0; i < texts.length; i++) {
+            results.push(new Float32Array(out.data.slice(i * dim, (i + 1) * dim)));
+        }
+        return results;
+    }
+    catch {
+        return texts.map(() => new Float32Array(DEFAULT_DIM));
+    }
+}
+/** Convenience: embed a single string. Returns null when transformers/model
+ *  unavailable — distinct from a zero-vector so callers can distinguish
+ *  "the runtime can't embed" from "I embedded but the result happens to be
+ *  all zeros." */
+export async function embedSingle(text, opts = {}) {
+    try {
+        // Probe import directly so we can return null on missing runtime,
+        // without conflating that with "zero-vector fallback."
+        await import("@xenova/transformers");
+    }
+    catch {
+        return null;
+    }
+    const [vec] = await embedTexts([text], opts);
+    if (!vec)
+        return null;
+    // Heuristic: if every element is exactly 0, the model load failed silently
+    // inside embedTexts and we got the fallback. Surface that to the caller.
+    let allZero = true;
+    for (let i = 0; i < vec.length; i++) {
+        if (vec[i] !== 0) {
+            allZero = false;
+            break;
+        }
+    }
+    return allZero ? null : vec;
+}
+//# sourceMappingURL=embed.js.map

package/dist/embedding/embed.js.map

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

package/dist/embedding/index.d.ts

@@ -1,4 +1,6 @@
 export { EmbeddingQueue } from "./queue.js";
 export type { EmbeddingItem, EmbeddingQueueOpts, VectorSink } from "./queue.js";
 export { EMBED_DIM } from "./pool.js";
+export { embedTexts, embedSingle } from "./embed.js";
+export type { EmbedOptions } from "./embed.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/embedding/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/embedding/index.js

@@ -1,3 +1,4 @@
 export { EmbeddingQueue } from "./queue.js";
 export { EMBED_DIM } from "./pool.js";
+export { embedTexts, embedSingle } from "./embed.js";
 //# sourceMappingURL=index.js.map

package/dist/embedding/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/embedding/queue.js

@@ -68,55 +68,13 @@ export class EmbeddingQueue {
         }
     }
 }
-/** Default embedder: lazy-imports @xenova/transformers, returns zero-vectors on failure.
- *
- * Honors SFGRAPH_EMBED_MODEL_PATH / SFGRAPH_EMBED_MODEL_ID / SFGRAPH_EMBED_MODEL_DIM
- * env vars so users can BYO model without touching the package. When unset,
- * falls back to the vendored MiniLM L6 v2 shipped by @ryanstark24/sfgraph-models.
- */
+// Ingest's batched embedder is now a thin wrapper around the shared
+// `embedTexts` function exported from ./embed.ts. The function used to be a
+// closure here; pulling it out means the MCP `find_similar` tool (and any
+// future ad-hoc embedding caller) gets the same pipeline + same env-var
+// overrides, with no risk of drift.
 async function defaultEmbed(texts) {
-    try {
-        // @xenova/transformers is declared as an optionalDependency on this
-        // package so consumers who don't need embeddings can skip the WASM
-        // runtime. Use a plain dynamic import (no string cast) — when the
-        // optional dep is missing, the import rejects and we fall through to
-        // the zero-vector fallback below.
-        const mod = (await import("@xenova/transformers"));
-        const { pipeline, env } = mod;
-        env.allowRemoteModels = false;
-        const envPath = process.env.SFGRAPH_EMBED_MODEL_PATH;
-        const modelId = process.env.SFGRAPH_EMBED_MODEL_ID ?? "Xenova/all-MiniLM-L6-v2";
-        const dim = process.env.SFGRAPH_EMBED_MODEL_DIM
-            ? Number.parseInt(process.env.SFGRAPH_EMBED_MODEL_DIM, 10)
-            : 384;
-        if (envPath) {
-            env.localModelPath = envPath;
-        }
-        else {
-            try {
-                const models = (await import("@ryanstark24/sfgraph-models"));
-                if (models?.MODEL_DATA_DIR)
-                    env.localModelPath = models.MODEL_DATA_DIR;
-            }
-            catch {
-                /* models package optional */
-            }
-        }
-        const pipe = await pipeline("feature-extraction", modelId, {
-            quantized: true,
-            local_files_only: true,
-        });
-        const out = await pipe(texts, { pooling: "mean", normalize: true });
-        const results = [];
-        for (let i = 0; i < texts.length; i++) {
-            results.push(new Float32Array(out.data.slice(i * dim, (i + 1) * dim)));
-        }
-        return results;
-    }
-    catch {
-        // Transformers (or model) not present — return zero vectors so caller can
-        // still upsert placeholder embeddings if desired. Ingest must not crash.
-        return texts.map(() => new Float32Array(384));
-    }
+    const { embedTexts } = await import("./embed.js");
+    return embedTexts(texts);
 }
 //# sourceMappingURL=queue.js.map

package/dist/embedding/queue.js.map

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

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

@@ -1,4 +1,6 @@
 export { wrapConnectionReadOnly } from "./read-only-proxy.js";
+export { startLivenessProbe } from "./liveness.js";
+export type { LivenessProbeHandle, LivenessProbeOptions } from "./liveness.js";
 export { ReadOnlyViolationError } from "./errors.js";
 export { resolveOrg, resolveDefaultOrgAlias, safeOrgInfo } from "./auth.js";
 export type { ResolvedOrg, ResolveOrgDeps } from "./auth.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extractors/live-org/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,UAAU,EACV,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extractors/live-org/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,UAAU,EACV,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

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

@@ -1,4 +1,5 @@
 export { wrapConnectionReadOnly } from "./read-only-proxy.js";
+export { startLivenessProbe } from "./liveness.js";
 export { ReadOnlyViolationError } from "./errors.js";
 export { resolveOrg, resolveDefaultOrgAlias, safeOrgInfo } from "./auth.js";
 export { probeCapabilities } from "./capabilities.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extractors/live-org/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,UAAU,EACV,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extractors/live-org/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,UAAU,EACV,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Background connection-liveness probe.
+ *
+ * The dead-socket failure mode reproduces cleanly on corporate VPNs / NATs
+ * with idle eviction: jsforce's HTTP socket goes half-open, every
+ * outstanding request hangs forever, and the only escape is the per-call
+ * 60s `withTimeout` wrap inside each extractor. That works — the run
+ * doesn't wedge — but the user-visible experience is "10 sources each
+ * fail with timeout errors, ingest finishes with a giant skip list, no
+ * obvious cause." This probe makes the cause obvious.
+ *
+ * Every `intervalMs` we call `conn.identity()` (the cheapest jsforce
+ * request: a single REST hit to `/services/oauth2/userinfo`). If it
+ * succeeds, the connection is alive; we reset the failure counter and
+ * keep going. If it times out or rejects, we increment a counter; once
+ * `consecutiveFailures >= maxFailures` we declare the connection dead,
+ * log a prominent warning, and fire `onDead` once.
+ *
+ * We do NOT abort the ingest. Aborting mid-flight would need an AbortSignal
+ * threaded through every extractor — too invasive for marginal benefit
+ * given the per-call timeouts already cap exposure. The probe's value is
+ * SIGNALLING: the user sees "ingest: ⚠ connection lost — surviving
+ * extractors will time out within ~60s" and knows to re-run from a fresh
+ * terminal, instead of guessing at pool tuning.
+ */
+export interface LivenessProbeOptions {
+    intervalMs?: number;
+    identityTimeoutMs?: number;
+    maxFailures?: number;
+    onDead?: (failureReason: string) => void;
+    /** Override the logger; falls back to console. Tests inject silent. */
+    log?: (line: string) => void;
+}
+export interface LivenessProbeHandle {
+    stop(): void;
+    isDead(): boolean;
+    failureCount(): number;
+}
+export declare function startLivenessProbe(conn: {
+    identity: () => Promise<unknown>;
+}, options?: LivenessProbeOptions): LivenessProbeHandle;
+//# sourceMappingURL=liveness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liveness.d.ts","sourceRoot":"","sources":["../../../src/extractors/live-org/liveness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,uEAAuE;IACvE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,OAAO,CAAC;IAClB,YAAY,IAAI,MAAM,CAAC;CACxB;AA2BD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EAC1C,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CA2DrB"}

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

@@ -0,0 +1,76 @@
+const DEFAULTS = {
+    intervalMs: 30_000,
+    identityTimeoutMs: 10_000,
+    maxFailures: 2,
+};
+/** Race a promise against a setTimeout; reject if the promise doesn't
+ *  settle within `ms`. Kept local so this module has no dependency on
+ *  rate-limit.ts's withTimeout (which would create a circular ref). */
+function withDeadline(p, ms, label) {
+    return new Promise((resolve, reject) => {
+        const t = setTimeout(() => reject(new Error(`${label} deadline (${ms}ms)`)), ms);
+        p.then((v) => {
+            clearTimeout(t);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(t);
+            reject(e);
+        });
+    });
+}
+export function startLivenessProbe(conn, options = {}) {
+    const intervalMs = options.intervalMs ?? DEFAULTS.intervalMs;
+    const identityTimeoutMs = options.identityTimeoutMs ?? DEFAULTS.identityTimeoutMs;
+    const maxFailures = options.maxFailures ?? DEFAULTS.maxFailures;
+    const log = options.log ?? ((line) => console.log(line));
+    let consecutiveFailures = 0;
+    let dead = false;
+    let firedDead = false;
+    let stopped = false;
+    const tick = async () => {
+        if (stopped || dead)
+            return;
+        try {
+            await withDeadline(conn.identity(), identityTimeoutMs, "liveness identity()");
+            // Success — reset counter. Don't log on success or we'd flood.
+            consecutiveFailures = 0;
+        }
+        catch (e) {
+            consecutiveFailures += 1;
+            const reason = e?.message ?? String(e);
+            // Soft warning at the first failure, escalation at the threshold.
+            // The intermediate state ("1 of 2 failures") is real signal that
+            // something's wrong even before we're sure.
+            if (consecutiveFailures < maxFailures) {
+                log(`ingest: [liveness] probe failed (${consecutiveFailures}/${maxFailures}): ${reason.slice(0, 120)}`);
+            }
+            else if (!firedDead) {
+                dead = true;
+                firedDead = true;
+                log("");
+                log(`ingest: ⚠ CONNECTION LOST — ${consecutiveFailures} consecutive identity() probes failed. Surviving extractors will fail within ~60s as their per-call timeouts trip. The ingest will finish with a skip list. Re-run \`sfgraph ingest --org <alias> --retry-skipped\` from a fresh terminal once connectivity is restored.`);
+                log("");
+                options.onDead?.(reason);
+            }
+        }
+    };
+    // Fire-and-forget interval. The first tick fires after intervalMs (not
+    // immediately) — startup is when the connection is freshest and we
+    // don't want to add latency to ingest's first API calls by racing
+    // identity() against probeCapabilities().
+    const timer = setInterval(() => {
+        void tick();
+    }, intervalMs);
+    // Don't keep the event loop alive on this timer alone; the ingest's
+    // own keep-alive sentinel handles that.
+    timer.unref?.();
+    return {
+        stop: () => {
+            stopped = true;
+            clearInterval(timer);
+        },
+        isDead: () => dead,
+        failureCount: () => consecutiveFailures,
+    };
+}
+//# sourceMappingURL=liveness.js.map

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

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

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from "./telemetry/index.js";
 export * from "./extractors/live-org/index.js";
 export * from "./storage/index.js";
 export * from "./ingest/index.js";
+export * from "./embedding/index.js";
 export type { MetadataSource, MemberRef, RawMember, } from "./extractors/interfaces/metadata-source.js";
 export { FilesystemMetadataSource } from "./extractors/filesystem/index.js";
 export * as render from "./render/mermaid/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,YAAY,EACV,cAAc,EACd,SAAS,EACT,SAAS,GACV,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,YAAY,EACV,cAAc,EACd,SAAS,EACT,SAAS,GACV,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -3,6 +3,7 @@ export * from "./telemetry/index.js";
 export * from "./extractors/live-org/index.js";
 export * from "./storage/index.js";
 export * from "./ingest/index.js";
+export * from "./embedding/index.js";
 export { FilesystemMetadataSource } from "./extractors/filesystem/index.js";
 export * as render from "./render/mermaid/index.js";
 export * as analyze from "./analyze/index.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAMlC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,sEAAsE;AACtE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AAMrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,sEAAsE;AACtE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,0BAA0B,CAAC"}

package/dist/ingest/live-ingest.d.ts

@@ -71,5 +71,4 @@ export interface LiveIngestResult {
     danglingEdges: number;
 }
 export declare function liveIngest(opts: LiveIngestOpts): Promise<LiveIngestResult>;
-export declare function rethrowAsIngestError(e: unknown, ctx: string): never;
 //# sourceMappingURL=live-ingest.d.ts.map

package/dist/ingest/live-ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-ingest.d.ts","sourceRoot":"","sources":["../../src/ingest/live-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,KAAK,EAAiC,MAAM,6BAA6B,CAAC;AACnG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAO1D,OAAO,qBAAqB,CAAC;AAG7B,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAc,MAAM,gCAAgC,CAAC;AAEnG,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,wCAAwC,CAAC;AAIjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,oFAAoF;IACpF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gEAAgE;IAChE,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,yEAAyE;IACzE,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,oDAAoD;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;CACvB;AAmLD,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuhBhF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAGnE"}
+{"version":3,"file":"live-ingest.d.ts","sourceRoot":"","sources":["../../src/ingest/live-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAmB,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAO1D,OAAO,qBAAqB,CAAC;AAG7B,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAc,MAAM,gCAAgC,CAAC;AAEnG,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,wCAAwC,CAAC;AAQjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,oFAAoF;IACpF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gEAAgE;IAChE,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,yEAAyE;IACzE,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,oDAAoD;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;CACvB;AAmLD,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwiBhF"}

package/dist/ingest/live-ingest.js

@@ -1,4 +1,4 @@
-import { ErrorCode, SfgraphError, asQualifiedName } from "@ryanstark24/sfgraph-shared";
+import { asQualifiedName } from "@ryanstark24/sfgraph-shared";
 import { resolveApexMethodArity } from "../parsers/apex/arity-resolver.js";
 import { resolveCrossFlavor } from "../parsers/cross-flavor-resolver.js";
 import { resolveFlowApexMethods } from "../parsers/flow/invocable-resolver.js";
@@ -12,6 +12,7 @@ import { resolveOrg } from "../extractors/live-org/auth.js";
 import { bulkRetrieve } from "../extractors/live-org/bulk-retrieve.js";
 import { probeCapabilities } from "../extractors/live-org/capabilities.js";
 import { iterChanges } from "../extractors/live-org/source-member.js";
+import { startLivenessProbe, } from "../extractors/live-org/liveness.js";
 import { dataPool, metadataPool, toolingPool } from "../extractors/live-org/rate-limit.js";
 import { loadAllRules } from "../parsers/rules/_loader.js";
 const NOOP_LOG = {
@@ -374,6 +375,7 @@ export async function liveIngest(opts) {
         const debug = process.env.SFGRAPH_DEBUG_INGEST === "1";
         let heartbeatTimer = null;
         let keepAlive = null;
+        let livenessProbe = null;
         // Track signal handlers we register so we can remove them in finally.
         // Without this, every invocation of liveIngest in debug mode leaked one
         // listener per signal (SIGTERM/SIGINT/SIGUSR2), eventually triggering
@@ -394,6 +396,19 @@ export async function liveIngest(opts) {
             // and Node will happily exit(0) on a perfectly healthy pending Promise
             // if no ref'd handle is left.
             keepAlive = setInterval(() => { }, 60_000);
+            // Background liveness probe. Polls conn.identity() every 30s with a
+            // 10s deadline; after two consecutive failures it logs a prominent
+            // "CONNECTION LOST" warning so the user knows why surviving
+            // extractors are about to time out one by one. We intentionally do
+            // NOT abort the ingest from here — per-call 60s timeouts (added in
+            // 1.1.3) already cap exposure, and aborting mid-flight would need
+            // an AbortSignal threaded through every extractor for marginal
+            // benefit. The probe's job is observability, not control flow.
+            // Disable via SFGRAPH_NO_LIVENESS_PROBE=1 for hermetic test runs
+            // where the mock connection has no identity() implementation.
+            if (process.env.SFGRAPH_NO_LIVENESS_PROBE !== "1") {
+                livenessProbe = startLivenessProbe(resolved.conn);
+            }
             // Wall-clock heartbeat — always on. Without this, silent phases (where
             // all in-window sources are awaiting Bottleneck-queued metadata reads
             // without yielding) look indistinguishable from a hung process. The
@@ -506,6 +521,7 @@ export async function liveIngest(opts) {
                 clearInterval(heartbeatTimer);
             if (keepAlive)
                 clearInterval(keepAlive);
+            livenessProbe?.stop();
             for (const h of installedSignalHandlers)
                 process.off(h.sig, h.fn);
         }
@@ -696,9 +712,4 @@ export async function liveIngest(opts) {
         danglingEdges,
     };
 }
-export function rethrowAsIngestError(e, ctx) {
-    if (e instanceof SfgraphError)
-        throw e;
-    throw new SfgraphError(ErrorCode.E_SF_INGEST, `${ctx}: ${e.message ?? String(e)}`);
-}
 //# sourceMappingURL=live-ingest.js.map