@ryanstark24/sfgraph-core 1.4.0 → 1.6.0

package/dist/ingest/parse-worker.js

@@ -0,0 +1,100 @@
+/**
+ * Parse worker entry (spawned by `parsePool` from the compiled
+ * `parse-worker.js`). Loads the same parser registry as the main thread (the
+ * side-effect parser imports via parse-member, plus the YAML rule parsers),
+ * then parses members one at a time, in arrival order, with the same
+ * `parseMember` the serial path uses. Parser log calls are recorded and
+ * shipped back with the result. A result that is not plain data is not
+ * shipped (structured clone could change it); the main thread re-parses it.
+ *
+ * Raw `console.*` output from code running here (e.g. SFGRAPH_DEBUG_INGEST
+ * diagnostics inside a parser) is forwarded to the parent's stdout
+ * asynchronously: it is NOT ordered relative to main-thread output. The
+ * ingest's own `[trace] parse ←` lines are emitted on the main thread when
+ * each result is applied, in member order.
+ */
+import { parentPort, workerData } from "node:worker_threads";
+import { loadAllRules } from "../parsers/rules/_loader.js";
+import { parseMember } from "./parse-member.js";
+/** True when `v` is built only from primitives, plain objects and arrays. */
+export function isPlainData(v, depth = 0) {
+    if (v === null || v === undefined)
+        return true;
+    const t = typeof v;
+    if (t === "string" || t === "number" || t === "boolean")
+        return true;
+    if (t !== "object")
+        return false; // function, symbol, bigint
+    if (depth > 200)
+        return false;
+    if (Array.isArray(v)) {
+        if (Object.getPrototypeOf(v) !== Array.prototype)
+            return false;
+        for (const x of v)
+            if (!isPlainData(x, depth + 1))
+                return false;
+        return true;
+    }
+    const proto = Object.getPrototypeOf(v);
+    if (proto !== Object.prototype && proto !== null)
+        return false;
+    for (const k of Object.keys(v)) {
+        if (!isPlainData(v[k], depth + 1))
+            return false;
+    }
+    return true;
+}
+function plainOutcome(o) {
+    if (o.kind !== "parsed")
+        return true;
+    const r = o.result;
+    return (isPlainData(r.nodes) &&
+        isPlainData(r.edges) &&
+        (r.snippets === undefined || isPlainData(r.snippets)));
+}
+const port = parentPort;
+if (port) {
+    const { base } = workerData;
+    // Attach the listener first so no job can arrive before it; jobs wait on init.
+    const init = loadAllRules().then(() => undefined);
+    let chain = init;
+    port.on("message", (job) => {
+        chain = chain.then(async () => {
+            const logs = [];
+            const rec = (level) => (msg, meta) => {
+                logs.push(meta === undefined ? { level, msg } : { level, msg, meta });
+            };
+            const logger = {
+                debug: rec("debug"),
+                info: rec("info"),
+                warn: rec("warn"),
+                error: rec("error"),
+            };
+            const outcome = await parseMember(job.member.ref, job.member.content, base, logger);
+            let reply;
+            if (!plainOutcome(outcome) || !isPlainData(logs)) {
+                reply = { type: "fallback", seq: job.seq, reason: "result is not plain data" };
+                port.postMessage(reply);
+                return;
+            }
+            reply = { type: "done", seq: job.seq, outcome, logs };
+            try {
+                port.postMessage(reply);
+            }
+            catch (e) {
+                port.postMessage({
+                    type: "fallback",
+                    seq: job.seq,
+                    reason: e.message,
+                });
+            }
+        });
+    });
+    // A rule-load failure rejects `init`: crash so the pool falls back to the
+    // main thread (which reports the same failure) instead of parsing without
+    // the rule parsers.
+    init.then(() => port.postMessage({ type: "ready" }), (e) => {
+        throw e;
+    });
+}
+//# sourceMappingURL=parse-worker.js.map

package/dist/ingest/parse-worker.js.map

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

package/dist/ingest/profile.d.ts

@@ -0,0 +1,27 @@
+export interface IngestProfileMember {
+    qname: string;
+    label: string;
+    bytes: number;
+    parseMs: number;
+    writeMs: number;
+}
+export interface IngestProfiler {
+    /** False for the shared no-op; callers can skip building records. */
+    readonly enabled: boolean;
+    member(rec: IngestProfileMember): void;
+    /**
+     * A phase record. `ms` is the phase's DURATION, except when `sinceStart` is
+     * set: then `ms` is a timestamp, the time from ingest start to that point
+     * (`graph-ready`, `embeddings`), and the record carries `sinceStart: true`.
+     * Tools that sum phase durations must skip `sinceStart` records.
+     */
+    phase(name: string, ms: number, sinceStart?: boolean): void;
+    close(): void;
+}
+/**
+ * Opt-in ingest profiler. Active only when SFGRAPH_INGEST_PROFILE names a file;
+ * otherwise returns a shared no-op. Records are buffered and appended as JSONL
+ * every 500 records and on close.
+ */
+export declare function createIngestProfiler(env?: Record<string, string | undefined>): IngestProfiler;
+//# sourceMappingURL=profile.d.ts.map

package/dist/ingest/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/ingest/profile.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5D,KAAK,IAAI,IAAI,CAAC;CACf;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,cAAc,CAiChB"}

package/dist/ingest/profile.js

@@ -0,0 +1,48 @@
+import { appendFileSync, writeFileSync } from "node:fs";
+const FLUSH_EVERY = 500;
+const NOOP = { enabled: false, member() { }, phase() { }, close() { } };
+/**
+ * Opt-in ingest profiler. Active only when SFGRAPH_INGEST_PROFILE names a file;
+ * otherwise returns a shared no-op. Records are buffered and appended as JSONL
+ * every 500 records and on close.
+ */
+export function createIngestProfiler(env = process.env) {
+    const file = env.SFGRAPH_INGEST_PROFILE;
+    if (!file)
+        return NOOP;
+    let buf = [];
+    try {
+        writeFileSync(file, "");
+    }
+    catch {
+        return NOOP;
+    }
+    const flush = () => {
+        if (buf.length === 0)
+            return;
+        const out = `${buf.join("\n")}\n`;
+        buf = [];
+        try {
+            appendFileSync(file, out);
+        }
+        catch {
+            // profiling must never break ingest
+        }
+    };
+    const push = (rec) => {
+        buf.push(JSON.stringify(rec));
+        if (buf.length >= FLUSH_EVERY)
+            flush();
+    };
+    return {
+        enabled: true,
+        member(rec) {
+            push({ t: "member", ...rec });
+        },
+        phase(name, ms, sinceStart) {
+            push(sinceStart ? { t: "phase", name, ms, sinceStart: true } : { t: "phase", name, ms });
+        },
+        close: flush,
+    };
+}
+//# sourceMappingURL=profile.js.map

package/dist/ingest/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/ingest/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAwBxD,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,IAAI,GAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAI,CAAC,EAAE,KAAK,KAAI,CAAC,EAAE,KAAK,KAAI,CAAC,EAAE,CAAC;AAErF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,IAAI,GAAG,GAAG,CAAC,sBAAsB,CAAC;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,GAAG,GAAa,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7B,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,GAAG,GAAG,EAAE,CAAC;QACT,IAAI,CAAC;YACH,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,GAAY,EAAQ,EAAE;QAClC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,MAAM,IAAI,WAAW;YAAE,KAAK,EAAE,CAAC;IACzC,CAAC,CAAC;IACF,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,CAAC,GAAG;YACR,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU;YACxB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,KAAK,EAAE,KAAK;KACb,CAAC;AACJ,CAAC"}

package/dist/ingest/resolver-gates.d.ts

@@ -0,0 +1,12 @@
+import type { OrgId } from "@ryanstark24/sfgraph-shared";
+import type { ApexRefResolveResult } from "../parsers/apex/ref-resolver.js";
+import type { GraphStore } from "../storage/interfaces.js";
+/**
+ * The result resolveApexReferences would return when it has nothing to do:
+ * no node carries any of its input attributes (so it emits no edge) and no
+ * edge of its rel types carries its owner tag (so it prunes nothing). Its
+ * only other output, `dynamicSoqlFieldsSkipped`, is summed the same way.
+ * Null when that cannot be shown (or the store lacks the probes): run it.
+ */
+export declare function apexRefNoWorkResult(store: GraphStore, orgId: OrgId): ApexRefResolveResult | null;
+//# sourceMappingURL=resolver-gates.d.ts.map

package/dist/ingest/resolver-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver-gates.d.ts","sourceRoot":"","sources":["../../src/ingest/resolver-gates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAoC3D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,oBAAoB,GAAG,IAAI,CA+BhG"}

package/dist/ingest/resolver-gates.js

@@ -0,0 +1,53 @@
+import { REL_TYPES } from "../domain/index.js";
+import { APEX_REF_RESOLVER } from "../parsers/apex/ref-resolver.js";
+/** resolveApexReferences' node labels (its PATH_LABELS; ApexMethod / TestMethod / ApexClass are subsets). */
+const APEX_REF_LABELS = ["ApexMethod", "TestMethod", "ApexClass", "ApexTrigger"];
+/** The node attributes resolveApexReferences derives edges from. */
+const APEX_REF_INPUTS = [
+    "apexRelationshipPaths",
+    "apexChildRelationships",
+    "apexFieldNameLiterals",
+    "testTargetCandidates",
+];
+/** Rel types of the edges it emits (and so may have to prune). */
+const APEX_REF_RELS = [
+    REL_TYPES.READS_FIELD,
+    REL_TYPES.WRITES_FIELD,
+    REL_TYPES.REFERENCES,
+    REL_TYPES.IS_TEST_FOR,
+];
+/**
+ * The result resolveApexReferences would return when it has nothing to do:
+ * no node carries any of its input attributes (so it emits no edge) and no
+ * edge of its rel types carries its owner tag (so it prunes nothing). Its
+ * only other output, `dynamicSoqlFieldsSkipped`, is summed the same way.
+ * Null when that cannot be shown (or the store lacks the probes): run it.
+ */
+export function apexRefNoWorkResult(store, orgId) {
+    const s = store;
+    if (typeof s.anyNodeAttributesContain !== "function" ||
+        typeof s.anyEdgeAttributesContain !== "function" ||
+        typeof s.sumPositiveNodeAttribute !== "function") {
+        return null;
+    }
+    // Substring probes: a key name anywhere in the JSON text counts as input.
+    const keys = APEX_REF_INPUTS.map((k) => JSON.stringify(k));
+    if (s.anyNodeAttributesContain(orgId, APEX_REF_LABELS, keys))
+        return null;
+    if (s.anyEdgeAttributesContain(orgId, APEX_REF_RELS, JSON.stringify(APEX_REF_RESOLVER))) {
+        return null;
+    }
+    return {
+        pathsResolved: 0,
+        pathsUnresolved: 0,
+        childRelationshipsResolved: 0,
+        childRelationshipsUnresolved: 0,
+        testTargetsResolved: 0,
+        testTargetsUnresolved: 0,
+        fieldLiteralsResolved: 0,
+        fieldLiteralsUnresolved: 0,
+        dynamicSoqlFieldsSkipped: s.sumPositiveNodeAttribute(orgId, APEX_REF_LABELS, "dynamicSoqlFieldsSkipped"),
+        edgesEmitted: 0,
+    };
+}
+//# sourceMappingURL=resolver-gates.js.map

package/dist/ingest/resolver-gates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver-gates.js","sourceRoot":"","sources":["../../src/ingest/resolver-gates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAoBpE,6GAA6G;AAC7G,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AAC1F,oEAAoE;AACpE,MAAM,eAAe,GAAG;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,uBAAuB;IACvB,sBAAsB;CACd,CAAC;AACX,kEAAkE;AAClE,MAAM,aAAa,GAAG;IACpB,SAAS,CAAC,WAAW;IACrB,SAAS,CAAC,YAAY;IACtB,SAAS,CAAC,UAAU;IACpB,SAAS,CAAC,WAAW;CACb,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAiB,EAAE,KAAY;IACjE,MAAM,CAAC,GAAG,KAA+B,CAAC;IAC1C,IACE,OAAO,CAAC,CAAC,wBAAwB,KAAK,UAAU;QAChD,OAAO,CAAC,CAAC,wBAAwB,KAAK,UAAU;QAChD,OAAO,CAAC,CAAC,wBAAwB,KAAK,UAAU,EAChD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,0EAA0E;IAC1E,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,wBAAwB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,IAAI,CAAC,CAAC,wBAAwB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,eAAe,EAAE,CAAC;QAClB,0BAA0B,EAAE,CAAC;QAC7B,4BAA4B,EAAE,CAAC;QAC/B,mBAAmB,EAAE,CAAC;QACtB,qBAAqB,EAAE,CAAC;QACxB,qBAAqB,EAAE,CAAC;QACxB,uBAAuB,EAAE,CAAC;QAC1B,wBAAwB,EAAE,CAAC,CAAC,wBAAwB,CAClD,KAAK,EACL,eAAe,EACf,0BAA0B,CAC3B;QACD,YAAY,EAAE,CAAC;KAChB,CAAC;AACJ,CAAC"}

package/dist/parsers/apex/arity-resolver.d.ts

@@ -13,9 +13,13 @@ import type { ParseContext } from "../contract.js";
  *   - zero overloads → original edge left in place so the dangling-edge audit
  *     surfaces it (managed-package targets, typos, third-party imports).
  *
- * The new edges carry `resolvedBy:"arity-resolver"` in their attributes so
- * downstream consumers can distinguish resolver-emitted edges from
- * extractor-emitted ones.
+ * The new edges carry `arityResolvedFrom: "<the (?) qname>"` so consumers can
+ * tell them from extractor-emitted ones. Deliberately NOT `resolvedBy`:
+ * member reconcile exempts `resolvedBy` edges, and these must stay owned by
+ * their source method. When the caller is re-parsed, reconcile drops the
+ * resolved edge (the parser re-emits only the `(?)` placeholder), and this
+ * pass re-derives it if the call still exists — so a deleted call never
+ * leaves a stale CALLS edge behind (audit corecorr-09).
  */
 export interface ArityResolveOpts {
     orgId: OrgId | string;
@@ -25,6 +29,15 @@ export interface ArityResolveOpts {
     /** Maximum stranded edges to inspect per call (safety valve for huge orgs).
      *  Default Number.POSITIVE_INFINITY. */
     limit?: number;
+    /**
+     * Task 11c (delta ingest): inspect only the stranded edges FROM `srcs`
+     * (re-parsed members) plus those whose target class is in `classNames`
+     * (classes that gained or lost methods). Unset: every stranded edge.
+     */
+    scope?: {
+        srcs: ReadonlySet<string>;
+        classNames: ReadonlySet<string>;
+    };
 }
 export interface ArityResolveResult {
     /** Stranded edges examined. */

package/dist/parsers/apex/arity-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arity-resolver.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/arity-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,GAAG,EAAE,YAAY,CAAC;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;4CACwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AA6BD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,GACrB,kBAAkB,CAyGpB"}
+{"version":3,"file":"arity-resolver.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/arity-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,GAAG,EAAE,YAAY,CAAC;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;4CACwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACxE;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AA0DD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,GACrB,kBAAkB,CA2GpB"}

package/dist/parsers/apex/arity-resolver.js

@@ -19,6 +19,33 @@ function parseResolved(qname) {
         arity: Number.parseInt(m[3] ?? "0", 10),
     };
 }
+function scopedStranded(store, orgId, scope) {
+    const out = [];
+    const seen = new Set();
+    const add = (e) => {
+        const dst = String(e.dstQualifiedName);
+        if (!parseStranded(dst))
+            return;
+        const k = `${e.relType}|${String(e.srcQualifiedName).toLowerCase()}|${dst.toLowerCase()}`;
+        if (seen.has(k))
+            return;
+        seen.add(k);
+        out.push(e);
+    };
+    for (const src of scope.srcs) {
+        for (const e of store.listEdgesFrom(orgId, asQualifiedName(src)))
+            add(e);
+    }
+    for (const cls of scope.classNames) {
+        // LIKE: `_` is a wildcard and matching is case-insensitive; the exact
+        // class is confirmed below.
+        for (const e of store.listEdgesByDstLike(orgId, `ApexMethod:${cls}.%(?)`)) {
+            if (parseStranded(String(e.dstQualifiedName))?.className.toLowerCase() === cls.toLowerCase())
+                add(e);
+        }
+    }
+    return out;
+}
 export function resolveApexMethodArity(store, opts) {
     const orgId = typeof opts.orgId === "string" ? asOrgId(opts.orgId) : opts.orgId;
     // ---- Build the index of real ApexMethod nodes -------------------------
@@ -38,7 +65,9 @@ export function resolveApexMethodArity(store, opts) {
         index.set(parsed.className, byMethod);
     }
     // ---- Find stranded edges ---------------------------------------------
-    const stranded = store.listEdgesByDstLike(orgId, STRANDED_PATTERN, undefined, opts.limit);
+    const stranded = opts.scope
+        ? scopedStranded(store, orgId, opts.scope)
+        : store.listEdgesByDstLike(orgId, STRANDED_PATTERN, undefined, opts.limit);
     const result = {
         scanned: stranded.length,
         resolved: 0,
@@ -68,7 +97,7 @@ export function resolveApexMethodArity(store, opts) {
                 const e = makeEdge(opts.ctx, String(edge.srcQualifiedName), edge.relType, String(cand.qualifiedName), {
                     ...edge.attributes,
                     unresolvedArity: undefined,
-                    resolvedBy: "arity-resolver",
+                    arityResolvedFrom: dst,
                     ambiguous: candidates.length > 1,
                     overloadCount: candidates.length,
                 });

package/dist/parsers/apex/arity-resolver.js.map

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

package/dist/parsers/apex/ast-extractor.d.ts

@@ -21,6 +21,7 @@
  */
 import type { EdgeFact } from "../../domain/index.js";
 import type { ParseContext } from "../contract.js";
+import type { ApexRelationshipPath } from "./class.js";
 export interface AstExtractorOpts {
     ctx: ParseContext;
     classQname: string;
@@ -33,6 +34,9 @@ export interface AstExtraction {
     diagnostics: string[];
     /** Per-method-name → arity, mostly used by tests. */
     methodArities: Map<string, number>;
+    /** Per method qname: dotted SOQL relationship fields (`Account.Name`) for
+     *  the post-merge resolver (parsers/apex/ref-resolver.ts). */
+    relationshipPaths: Map<string, ApexRelationshipPath[]>;
 }
 /**
  * Public entry point. Walks the parsed compilationUnit and returns edges.

package/dist/parsers/apex/ast-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast-extractor.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/ast-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,YAAY,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,sEAAsE;IACtE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAieD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAmCnF"}
+{"version":3,"file":"ast-extractor.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/ast-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,YAAY,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,sEAAsE;IACtE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;kEAC8D;IAC9D,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;CACxD;AA4hBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAsCnF"}

package/dist/parsers/apex/ast-extractor.js

@@ -46,6 +46,32 @@ function findDescendants(root, rule) {
     }
     return out;
 }
+/** Descendants of `root` with rule `rule`, not entering `stop` rules below
+ *  `root` (a nested subquery has its own FROM object). */
+function findOwnDescendants(root, rule, stop) {
+    const out = [];
+    const visit = (n, top) => {
+        const r = ruleName(n);
+        if (!top && stop.has(r))
+            return;
+        if (r === rule)
+            out.push(n);
+        const c = getChildCount(n);
+        for (let i = 0; i < c; i++) {
+            const ch = getChild(n, i);
+            if (ch)
+                visit(ch, false);
+        }
+    };
+    visit(root, true);
+    return out;
+}
+const SUBQUERY_RULES = new Set(["QueryContext", "SubQueryContext"]);
+const SELECT_SKIP_RULES = new Set([
+    "QueryContext",
+    "SubQueryContext",
+    "SoqlFunctionContext",
+]);
 function findAncestor(node, rule, root) {
     // antlr4ts attaches `parent` for parsing, but we conservatively assume
     // it may not be available across versions. Walk the tree top-down to map
@@ -202,11 +228,21 @@ function nodesInsideLoops(methodDecl, ruleNames) {
     }
     return out;
 }
-function extractSoqlEdges(methodDecl, scope, ctx, edges, diag) {
-    const queriesInLoop = nodesInsideLoops(methodDecl, ["QueryContext"]);
+function extractSoqlEdges(methodDecl, scope, ctx, edges, diag, paths) {
+    const queriesInLoop = nodesInsideLoops(methodDecl, ["QueryContext", "SubQueryContext"]);
     // SoqlLiteral wraps Query; both surface FromNameList. Use Query to get
-    // selectList + fromNameList in one place.
-    for (const q of findDescendants(methodDecl, "QueryContext")) {
+    // selectList + fromNameList in one place. A WHERE semi-join
+    // (`Id IN (SELECT AccountId FROM Contact)`) is a SubQuery with its own FROM
+    // object; select-list subqueries (`(SELECT Id FROM Contacts)`) name a
+    // child relationship, not an object, and are not walked.
+    const queries = new Set(findDescendants(methodDecl, "QueryContext"));
+    for (const q of [...queries]) {
+        const where = q.whereClause?.();
+        if (where)
+            for (const sq of findDescendants(where, "SubQueryContext"))
+                queries.add(sq);
+    }
+    for (const q of queries) {
         const fromList = q.fromNameList?.();
         if (!fromList)
             continue;
@@ -239,33 +275,49 @@ function extractSoqlEdges(methodDecl, scope, ctx, edges, diag) {
                 ...(inLoop ? { inLoop: true } : {}),
             }));
         }
-        // SELECT-list fields → READS_FIELD on the *first* FROM object (good enough
-        // when the query has a single root; subqueries are walked separately).
+        // Fields of the query's own FROM object → READS_FIELD on the *first* FROM
+        // object: the SELECT list (aggregate arguments aside) and the WHERE /
+        // GROUP BY / ORDER BY operands. Subqueries are walked separately. Dotted
+        // relationship fields (`Account.Name`) are not fields of this object:
+        // they are recorded as paths for the post-merge resolver.
         const primary = fromObjects[0];
         if (!primary)
             continue;
-        const selectList = q.selectList?.();
-        if (!selectList)
-            continue;
-        for (const fn of findDescendants(selectList, "FieldNameContext")) {
+        const fieldNodes = [];
+        const selectList = q.selectList?.() ?? q.subFieldList?.();
+        if (selectList)
+            fieldNodes.push(...findOwnDescendants(selectList, "FieldNameContext", SELECT_SKIP_RULES));
+        for (const clause of [
+            q.whereClause?.(),
+            q.groupByClause?.(),
+            q.orderByClause?.(),
+        ]) {
+            if (clause)
+                fieldNodes.push(...findOwnDescendants(clause, "FieldNameContext", SUBQUERY_RULES));
+        }
+        const seen = new Set();
+        for (const fn of fieldNodes) {
             const path = nodeText(fn).trim();
             if (!path || !SOQL_FIELD_NAME_RE.test(path))
                 continue;
-            // `Name` → CustomField:Account.Name
-            // `Account.Name` (parent traversal) → CustomField:Account.Name (the leaf)
-            // `Owner.Profile.Name` → emit READS_FIELD for the trailing field only;
-            //   parent traversal is a separate concern we don't try to resolve here.
-            const parts = path.split(".");
-            const fieldName = parts[parts.length - 1] ?? "";
-            const target = parts.length > 1 ? parts.slice(0, -1).join(".") : primary;
-            if (!fieldName)
+            if (seen.has(path.toLowerCase()))
+                continue;
+            seen.add(path.toLowerCase());
+            if (path.includes(".")) {
+                if (!paths.some((p) => p.object === primary && p.path.toLowerCase() === path.toLowerCase()))
+                    paths.push({ object: primary, path, rel: REL_TYPES.READS_FIELD });
                 continue;
-            edges.push(makeEdge(ctx, scope.qname, REL_TYPES.READS_FIELD, `CustomField:${stripNs(target, ctx.namespace)}.${fieldName}`));
+            }
+            edges.push(makeEdge(ctx, scope.qname, REL_TYPES.READS_FIELD, `CustomField:${stripNs(primary, ctx.namespace)}.${path}`));
         }
     }
     // Detect SOSL — `[FIND ...]` shows up as SoslLiteral.
-    if (findDescendants(methodDecl, "SoslLiteralContext").length > 0) {
-        edges.push(makeEdge(ctx, scope.qname, REL_TYPES.EXECUTES_SOSL, "SOSL:*"));
+    const sosl = findDescendants(methodDecl, "SoslLiteralContext");
+    if (sosl.length > 0) {
+        // T15 I-5: stamped inLoop when any SOSL literal sits in a loop body.
+        const inLoop = nodesInsideLoops(methodDecl, ["SoslLiteralContext"]);
+        const attrs = sosl.some((n) => inLoop.has(n)) ? { inLoop: true } : {};
+        edges.push(makeEdge(ctx, scope.qname, REL_TYPES.EXECUTES_SOSL, "SOSL:*", attrs));
     }
 }
 function extractDmlEdges(methodDecl, scope, ctx, edges) {
@@ -323,12 +375,20 @@ function extractDottedFieldRefs(methodDecl, scope, ctx, edges) {
         const sobj = scope.vars.get(recvText);
         if (!sobj)
             continue;
-        // Strip Apex `__c` from the captured field name to match how CustomField
-        // qnames are stored (CustomField:Account.Foo, not CustomField:Account.Foo__c).
-        const normalized = fieldName.endsWith("__c") ? fieldName.slice(0, -3) : fieldName;
-        edges.push(makeEdge(ctx, scope.qname, REL_TYPES.READS_FIELD, `CustomField:${stripNs(sobj, ctx.namespace)}.${normalized}`));
+        // Keep the API name verbatim (`Foo__c`): CustomField qnames are
+        // `CustomField:<Object>.<Field API name>`, same as the SOQL select-list path.
+        edges.push(makeEdge(ctx, scope.qname, REL_TYPES.READS_FIELD, `CustomField:${stripNs(sobj, ctx.namespace)}.${fieldName}`));
     }
 }
+function hasVarCI(vars, name) {
+    if (vars.has(name))
+        return true;
+    const lower = name.toLowerCase();
+    for (const k of vars.keys())
+        if (k.toLowerCase() === lower)
+            return true;
+    return false;
+}
 function extractMethodCalls(methodDecl, scope, effectiveName, ctx, edges) {
     // Static-style call `Foo.bar(args)` materializes as DotExpression whose
     // tail is DotMethodCall — capture the receiver id and the method id.
@@ -347,9 +407,12 @@ function extractMethodCalls(methodDecl, scope, effectiveName, ctx, edges) {
             continue;
         if (recv === effectiveName)
             continue;
+        // A capitalised local/param (`Prefix.trim()`) is an instance call.
+        if (hasVarCI(scope.vars, recv))
+            continue;
         const exprList = dmc.expressionList?.();
         const arity = countDirectArgs(exprList);
-        edges.push(makeEdge(ctx, scope.qname, REL_TYPES.CALLS, `ApexMethod:${stripNs(recv, ctx.namespace)}.${methodId}(${arity})`, { resolvedBy: "ast" }));
+        edges.push(makeEdge(ctx, scope.qname, REL_TYPES.CALLS, `ApexMethod:${stripNs(recv, ctx.namespace)}.${methodId}(${arity})`, { callResolution: "ast" }));
     }
     // `new Foo(args)` → INSTANCE_OF with real arity.
     for (const creator of findDescendants(methodDecl, "CreatorContext")) {
@@ -369,7 +432,7 @@ function extractMethodCalls(methodDecl, scope, effectiveName, ctx, edges) {
             : 0;
         edges.push(makeEdge(ctx, scope.qname, REL_TYPES.INSTANCE_OF, `ApexClass:${stripNs(bare, ctx.namespace)}`, {
             arity,
-            resolvedBy: "ast",
+            callResolution: "ast",
         }));
     }
 }
@@ -400,6 +463,7 @@ export function extractFromAst(tree, opts) {
     const edges = [];
     const diagnostics = [];
     const methodArities = new Map();
+    const relationshipPaths = new Map();
     const root = tree;
     const classDecls = findDescendants(root, "ClassDeclarationContext");
     for (const cd of classDecls) {
@@ -423,12 +487,15 @@ export function extractFromAst(tree, opts) {
             const qname = paramQname(opts.effectiveName, methodName, arity);
             const scope = { qname, vars: new Map() };
             indexLocalsAndParams(md, scope);
-            extractSoqlEdges(md, scope, opts.ctx, edges, diagnostics);
+            const paths = relationshipPaths.get(qname) ?? [];
+            extractSoqlEdges(md, scope, opts.ctx, edges, diagnostics, paths);
+            if (paths.length > 0)
+                relationshipPaths.set(qname, paths);
             extractDmlEdges(md, scope, opts.ctx, edges);
             extractDottedFieldRefs(md, scope, opts.ctx, edges);
             extractMethodCalls(md, scope, opts.effectiveName, opts.ctx, edges);
         }
     }
-    return { edges, diagnostics, methodArities };
+    return { edges, diagnostics, methodArities, relationshipPaths };
 }
 //# sourceMappingURL=ast-extractor.js.map