@opensip-cli/graph 0.1.0

package/dist/lang-adapter/edge-helpers.js

@@ -0,0 +1,120 @@
+/**
+ * Shared resolver helpers usable by any GraphLanguageAdapter.
+ *
+ * These tiny utilities used to live duplicated under each lang-*
+ * adapter (`appendEdge`, `pushCreationEdge`, the `MutableStats`
+ * counter shape). The duplicated-function-body rule flagged the
+ * duplication, which is correct — the bodies really are identical
+ * and the rule has no false-positive heuristic that would skip them.
+ *
+ * Putting these in lang-adapter/ keeps them on the contract layer:
+ * adapters already import types from `./types.js`, so importing one
+ * more helper is structurally consistent. The layering rules forbid
+ * lang-* adapters from importing each other but say nothing about
+ * lang-adapter/.
+ */
+// ── Edge-text truncation constants ────────────────────────────────
+//
+// `CallEdge.text` is contracted at "≤ 80 chars" (`types.ts:65-66`).
+// The producer-side promise was previously enforced by four files
+// each carrying their own magic numbers (80/77/70/67) — the 2026-05-23
+// audit (N-2) pulled them here so the contract literally lives next
+// to the helper that creates the edges.
+/** Maximum length of a `CallEdge.text` field. Per types.ts contract. */
+export const CALL_EDGE_TEXT_MAX = 80;
+/** Ellipsis appended to truncated edge text. */
+const CALL_EDGE_TRUNCATION_SUFFIX = '...';
+/** Maximum payload length when truncating: leaves room for the ellipsis. */
+const CALL_EDGE_TEXT_PAYLOAD_MAX = CALL_EDGE_TEXT_MAX - CALL_EDGE_TRUNCATION_SUFFIX.length;
+/** Prefix prepended to creation-edge text (`[creates] `). */
+export const CREATION_EDGE_PREFIX = '[creates] ';
+/**
+ * Maximum length of the inner source-text slice that gets prefixed
+ * with `[creates] ` to form a creation edge. The total edge text
+ * after prefixing is bounded by `CALL_EDGE_TEXT_MAX`.
+ */
+export const CREATION_EDGE_TEXT_MAX = CALL_EDGE_TEXT_MAX - CREATION_EDGE_PREFIX.length;
+const CREATION_EDGE_TEXT_PAYLOAD_MAX = CREATION_EDGE_TEXT_MAX - CALL_EDGE_TRUNCATION_SUFFIX.length;
+/**
+ * Truncate raw call-site source text to fit within `CallEdge.text`'s
+ * 80-char contract. Long strings get sliced and ellipsized; short
+ * strings pass through unchanged. Single source of truth for the
+ * truncation contract — adapters call this instead of inlining the
+ * length math.
+ */
+export function truncateForCallEdge(text) {
+    return text.length > CALL_EDGE_TEXT_MAX
+        ? `${text.slice(0, CALL_EDGE_TEXT_PAYLOAD_MAX)}${CALL_EDGE_TRUNCATION_SUFFIX}`
+        : text;
+}
+/**
+ * Truncate the inner source text used inside a creation edge so the
+ * `[creates] <text>` total stays within `CallEdge.text`'s 80-char
+ * contract. The prefix is added by `pushCreationEdge`.
+ */
+function truncateForCreationEdge(text) {
+    return text.length > CREATION_EDGE_TEXT_MAX
+        ? `${text.slice(0, CREATION_EDGE_TEXT_PAYLOAD_MAX)}${CALL_EDGE_TRUNCATION_SUFFIX}`
+        : text;
+}
+/**
+ * Append a CallEdge to the per-owner edge list, creating the list on
+ * first append. Trivial — but small functions deserve a single home.
+ */
+export function appendEdge(edgesByOwner, ownerHash, edge) {
+    const existing = edgesByOwner.get(ownerHash);
+    if (existing)
+        existing.push(edge);
+    else
+        edgesByOwner.set(ownerHash, [edge]);
+}
+/** Constructs a fresh {@link MutableStats} accumulator for edge resolver bookkeeping. */
+export function createMutableStats() {
+    const stats = {
+        totalCallSites: 0,
+        resolvedHigh: 0,
+        resolvedMedium: 0,
+        resolvedLow: 0,
+        unresolved: 0,
+        apply(edge) {
+            if (edge.to.length === 0) {
+                this.unresolved++;
+                return;
+            }
+            if (edge.confidence === 'high')
+                this.resolvedHigh++;
+            else if (edge.confidence === 'medium')
+                this.resolvedMedium++;
+            else
+                this.resolvedLow++;
+        },
+    };
+    return stats;
+}
+/**
+ * Append a synthetic creation edge — the parent owner contains an
+ * inline-callable child, so its enclosing scope's reachability flows
+ * to the child unconditionally. Static, high-confidence by
+ * construction.
+ *
+ * Parser-agnostic: the caller resolves the call site's {@link EdgePosition}
+ * (the only thing the helper needs from the adapter's node/file pair) and
+ * passes it in, so this helper never touches a parser-specific node shape.
+ * Bumps `totalCallSites` and `resolvedHigh` on the sink's stats.
+ */
+export function pushCreationEdge(pos, ownerHash, childHash, sink) {
+    const truncated = truncateForCreationEdge(pos.text);
+    const edge = {
+        to: [childHash],
+        line: pos.line,
+        column: pos.column,
+        resolution: 'static',
+        confidence: 'high',
+        text: `${CREATION_EDGE_PREFIX}${truncated}`,
+        discarded: false,
+    };
+    appendEdge(sink.edgesByOwner, ownerHash, edge);
+    sink.stats.totalCallSites++;
+    sink.stats.resolvedHigh++;
+}
+//# sourceMappingURL=edge-helpers.js.map

package/dist/lang-adapter/edge-helpers.js.map

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

package/dist/lang-adapter/registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Graph language-adapter registry — per-RunScope.
+ *
+ * Each `RunScope` owns its own adapter registry (Item 1 / D7). The
+ * graph tool's `contributeScope` hook constructs a fresh registry per CLI
+ * invocation and attaches it to `scope.graph.adapters`.
+ *
+ * Built on the kernel's unified `Registry<T>` with
+ * `duplicatePolicy: 'overwrite'` — re-registering an adapter with the
+ * same `id` overwrites the incumbent. That's intentional: a host
+ * application can swap an adapter in tests, and the file's prior
+ * incarnation documented this contract explicitly.
+ *
+ * Public API:
+ *   - `GraphAdapterRegistry`         — the registry class.
+ *   - `createAdapterRegistry()`      — factory used by `contributeScope`.
+ *   - `currentAdapterRegistry()`     — reads the scope-bound instance.
+ *   - `pickAdapter()`                — compatibility helper that routes the
+ *     scope-bound instance through GraphAdapterSelector.
+ */
+import { type Registerable } from '@opensip-cli/core';
+import type { GraphLanguageAdapter } from './types.js';
+export interface RegisterableAdapter extends Registerable {
+    readonly id: string;
+    readonly name: string;
+    readonly adapter: GraphLanguageAdapter;
+}
+/**
+ * Per-RunScope adapter registry. Wraps the kernel `Registry<T>` with
+ * the graph-specific `register` / `pick` surface.
+ */
+export declare class GraphAdapterRegistry {
+    private readonly inner;
+    /**
+     * Register an adapter by its `id`. Re-registering an adapter with
+     * the same `id` overwrites; that's intentional so a host application
+     * can swap an adapter in tests.
+     */
+    register(adapter: GraphLanguageAdapter): void;
+    clear(): void;
+    get size(): number;
+    getAll(): readonly RegisterableAdapter[];
+    getById(id: string): RegisterableAdapter | undefined;
+}
+/** Factory used by the graph tool's `contributeScope` hook. */
+export declare function createAdapterRegistry(): GraphAdapterRegistry;
+/**
+ * Read the current scope's graph adapter registry. Throws when no
+ * scope is active or when the graph subscope is missing — both
+ * indicate the caller is running outside the CLI's pre-action-hook (or
+ * the test fixture forgot to construct + enter a scope).
+ *
+ * @throws {Error} When called outside `runWithScope(...)`, or when the
+ *   active scope has no graph subscope.
+ */
+export declare function currentAdapterRegistry(): GraphAdapterRegistry;
+/** Pick the adapter for the current run. See `GraphAdapterRegistry.pick`. */
+export declare function pickAdapter(cwd?: string, language?: string): GraphLanguageAdapter;
+//# sourceMappingURL=registry.d.ts.map

package/dist/lang-adapter/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/lang-adapter/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAInB;IAEH;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAI7C,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAGD,MAAM,IAAI,SAAS,mBAAmB,EAAE;IAIxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;CAGrD;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AAQD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,oBAAoB,CAmB7D;AAOD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAKjF"}

package/dist/lang-adapter/registry.js

@@ -0,0 +1,100 @@
+/**
+ * Graph language-adapter registry — per-RunScope.
+ *
+ * Each `RunScope` owns its own adapter registry (Item 1 / D7). The
+ * graph tool's `contributeScope` hook constructs a fresh registry per CLI
+ * invocation and attaches it to `scope.graph.adapters`.
+ *
+ * Built on the kernel's unified `Registry<T>` with
+ * `duplicatePolicy: 'overwrite'` — re-registering an adapter with the
+ * same `id` overwrites the incumbent. That's intentional: a host
+ * application can swap an adapter in tests, and the file's prior
+ * incarnation documented this contract explicitly.
+ *
+ * Public API:
+ *   - `GraphAdapterRegistry`         — the registry class.
+ *   - `createAdapterRegistry()`      — factory used by `contributeScope`.
+ *   - `currentAdapterRegistry()`     — reads the scope-bound instance.
+ *   - `pickAdapter()`                — compatibility helper that routes the
+ *     scope-bound instance through GraphAdapterSelector.
+ */
+import { Registry, currentScope } from '@opensip-cli/core';
+import { GraphAdapterSelector } from './selector.js';
+/**
+ * Per-RunScope adapter registry. Wraps the kernel `Registry<T>` with
+ * the graph-specific `register` / `pick` surface.
+ */
+export class GraphAdapterRegistry {
+    inner = new Registry({
+        module: 'graph:lang-adapter',
+        duplicatePolicy: 'overwrite',
+        evtPrefix: 'graph.lang_adapter.registry',
+    });
+    /**
+     * Register an adapter by its `id`. Re-registering an adapter with
+     * the same `id` overwrites; that's intentional so a host application
+     * can swap an adapter in tests.
+     */
+    register(adapter) {
+        this.inner.register({ id: adapter.id, name: adapter.id, adapter });
+    }
+    clear() {
+        this.inner.clear();
+    }
+    get size() {
+        return this.inner.size;
+    }
+    // @fitness-ignore-next-line batch-operation-limits -- in-memory adapter registry: getAll() returns the handful of registered language adapters, not an unbounded data-store query.
+    getAll() {
+        return this.inner.getAll();
+    }
+    getById(id) {
+        return this.inner.getById(id);
+    }
+}
+/** Factory used by the graph tool's `contributeScope` hook. */
+export function createAdapterRegistry() {
+    return new GraphAdapterRegistry();
+}
+// Adapter discovery is no longer driven through a module-level holder. The
+// generic capability loader (§5.3/§4.5) discovers graph-adapter packages per
+// run and routes each through the `graph-adapter` registrar into the CURRENT
+// scope's adapter registry (the CLI pre-action hook drives it). There is no
+// process-global discovered-adapters state.
+/**
+ * Read the current scope's graph adapter registry. Throws when no
+ * scope is active or when the graph subscope is missing — both
+ * indicate the caller is running outside the CLI's pre-action-hook (or
+ * the test fixture forgot to construct + enter a scope).
+ *
+ * @throws {Error} When called outside `runWithScope(...)`, or when the
+ *   active scope has no graph subscope.
+ */
+export function currentAdapterRegistry() {
+    const scope = currentScope();
+    if (!scope) {
+        throw new Error('graph: currentAdapterRegistry() called outside a RunScope. ' +
+            'Wrap the call site in runWithScope (production: pre-action-hook handles ' +
+            'this; tests: use makeTestScope + graphTool.contributeScope or construct a ' +
+            'registry directly).');
+    }
+    if (!scope.graph) {
+        throw new Error('graph: scope.graph is missing. The graph tool must be registered and ' +
+            'its contributeScope hook must run before adapter reads. (production: ' +
+            'bootstrap registers graphTool; tests: call graphTool.contributeScope() ' +
+            'after makeTestScope.)');
+    }
+    return scope.graph.adapters;
+}
+// ---------------------------------------------------------------------------
+// Scope-bound helper — `pickAdapter` routes through the current scope's
+// registry to select the adapter for the run.
+// ---------------------------------------------------------------------------
+/** Pick the adapter for the current run. See `GraphAdapterRegistry.pick`. */
+export function pickAdapter(cwd, language) {
+    return new GraphAdapterSelector(currentAdapterRegistry()).pick({
+        ...(cwd === undefined ? {} : { cwd }),
+        ...(language === undefined ? {} : { language }),
+    });
+}
+//# sourceMappingURL=registry.js.map

package/dist/lang-adapter/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/lang-adapter/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAUrD;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACd,KAAK,GAAG,IAAI,QAAQ,CAAsB;QACzD,MAAM,EAAE,oBAAoB;QAC5B,eAAe,EAAE,WAAW;QAC5B,SAAS,EAAE,6BAA6B;KACzC,CAAC,CAAC;IAEH;;;;OAIG;IACH,QAAQ,CAAC,OAA6B;QACpC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,mLAAmL;IACnL,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,oBAAoB,EAAE,CAAC;AACpC,CAAC;AAED,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,4CAA4C;AAE5C;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,0EAA0E;YAC1E,4EAA4E;YAC5E,qBAAqB,CACxB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,uEAAuE;YACvE,yEAAyE;YACzE,uBAAuB,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,wEAAwE;AACxE,8CAA8C;AAC9C,8EAA8E;AAE9E,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,GAAY,EAAE,QAAiB;IACzD,OAAO,IAAI,oBAAoB,CAAC,sBAAsB,EAAE,CAAC,CAAC,IAAI,CAAC;QAC7D,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QACrC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;KAChD,CAAC,CAAC;AACL,CAAC"}

package/dist/lang-adapter/selector.d.ts

@@ -0,0 +1,39 @@
+import type { GraphLanguageAdapter } from './types.js';
+/**
+ * Inputs that drive graph language-adapter selection: the project root to probe
+ * for language signals and an optional explicit language override.
+ */
+export interface GraphAdapterSelectionInput {
+    /** Project root to probe for language signals (defaults to the process cwd). */
+    readonly cwd?: string;
+    /** Explicit language override; when set, skips signal-based detection. */
+    readonly language?: string;
+}
+interface GraphAdapterRegistryReader {
+    readonly size: number;
+    getAll(): readonly {
+        readonly id: string;
+        readonly adapter: GraphLanguageAdapter;
+    }[];
+    getById(id: string): {
+        readonly adapter: GraphLanguageAdapter;
+    } | undefined;
+}
+/**
+ * Selects the graph language adapter for a run. Kept separate from
+ * GraphAdapterRegistry so registration/lookup and selection policy can evolve
+ * independently as more adapters land.
+ */
+export declare class GraphAdapterSelector {
+    private readonly registry;
+    constructor(registry: GraphAdapterRegistryReader);
+    pick(input?: GraphAdapterSelectionInput): GraphLanguageAdapter;
+    private pickImplicit;
+    private fallbackAdapter;
+    private warnNoMatchingAdapter;
+    private pickByFileDominance;
+    private countFilesPerAdapter;
+    private resolveTie;
+}
+export {};
+//# sourceMappingURL=selector.d.ts.map

package/dist/lang-adapter/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/lang-adapter/selector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,0BAA0B;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,IAAI,SAAS;QACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;KACxC,EAAE,CAAC;IACJ,OAAO,CAAC,EAAE,EAAE,MAAM,GACd;QACE,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;KACxC,GACD,SAAS,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,0BAA0B;IAEjE,IAAI,CAAC,KAAK,GAAE,0BAA+B,GAAG,oBAAoB;IAYlE,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,UAAU;CASnB"}

package/dist/lang-adapter/selector.js

@@ -0,0 +1,140 @@
+import { ConfigurationError, logger } from '@opensip-cli/core';
+import { globSync } from 'glob';
+/**
+ * Selects the graph language adapter for a run. Kept separate from
+ * GraphAdapterRegistry so registration/lookup and selection policy can evolve
+ * independently as more adapters land.
+ */
+export class GraphAdapterSelector {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    pick(input = {}) {
+        const language = input.language?.trim();
+        if (language !== undefined && language.length > 0) {
+            const entry = this.registry.getById(language);
+            if (entry !== undefined)
+                return entry.adapter;
+            throw new ConfigurationError(`graph: language adapter '${language}' is not registered. Install @opensip-cli/graph-${language} or list it under plugins.graphAdapters in opensip-cli.config.yml.`);
+        }
+        return this.pickImplicit(input.cwd);
+    }
+    pickImplicit(cwd) {
+        if (this.registry.size === 0) {
+            throw new ConfigurationError('graph: no language adapter is registered. Graph adapters ship as ' +
+                'separate packages (@opensip-cli/graph-typescript, -python, ' +
+                '-rust, -go, -java) and are auto-discovered from node_modules. ' +
+                "Install the adapter for your project's language, or list it under " +
+                'plugins.graphAdapters in opensip-cli.config.yml.');
+        }
+        if (this.registry.size === 1) {
+            const only = this.registry.getAll()[0];
+            if (!only)
+                throw new ConfigurationError('graph: registry corrupted');
+            return only.adapter;
+        }
+        if (cwd !== undefined && cwd.length > 0) {
+            const dominant = this.pickByFileDominance(cwd);
+            if (dominant)
+                return dominant;
+            this.warnNoMatchingAdapter(cwd);
+        }
+        return this.fallbackAdapter();
+    }
+    fallbackAdapter() {
+        const ts = this.registry.getById('typescript');
+        if (ts !== undefined)
+            return ts.adapter;
+        /* v8 ignore start */
+        const ids = this.registry
+            .getAll()
+            .map((r) => r.id)
+            .sort();
+        const id = ids[0];
+        if (!id)
+            throw new ConfigurationError('graph: registry corrupted');
+        const entry = this.registry.getById(id);
+        if (!entry)
+            throw new ConfigurationError('graph: registry corrupted');
+        return entry.adapter;
+        /* v8 ignore stop */
+    }
+    warnNoMatchingAdapter(cwd) {
+        logger.warn({
+            evt: 'graph.lang_adapter.no_match',
+            module: 'graph:lang-adapter',
+            msg: 'No installed graph adapter matched any source files under the ' +
+                'target; falling back to TypeScript, which may yield an empty ' +
+                'result. If this project is in another language, install its ' +
+                'adapter (e.g. @opensip-cli/graph-go, @opensip-cli/graph-java) ' +
+                'or list it under plugins.graphAdapters in opensip-cli.config.yml.',
+            registered: this.registry.getAll().map((entry) => entry.id),
+            cwd,
+        });
+    }
+    pickByFileDominance(cwd) {
+        const counts = this.countFilesPerAdapter(cwd);
+        const best = findMaxCount(counts);
+        if (!best)
+            return undefined;
+        const tied = collectTies(counts, best.count);
+        if (tied.length > 1)
+            return this.resolveTie(tied);
+        return this.registry.getById(best.id)?.adapter;
+    }
+    countFilesPerAdapter(cwd) {
+        const counts = new Map();
+        for (const entry of this.registry.getAll()) {
+            const adapter = entry.adapter;
+            if (adapter.fileExtensions.length === 0)
+                continue;
+            let total = 0;
+            for (const ext of adapter.fileExtensions) {
+                const trimmed = ext.startsWith('.') ? ext.slice(1) : ext;
+                const matches = globSync(`**/*.${trimmed}`, {
+                    cwd,
+                    ignore: [...COUNT_EXCLUDES],
+                    nodir: true,
+                    follow: false,
+                });
+                total += matches.length;
+            }
+            counts.set(adapter.id, total);
+        }
+        return counts;
+    }
+    resolveTie(tied) {
+        const preference = ['typescript', 'python', 'rust'];
+        for (const pref of preference) {
+            if (tied.includes(pref))
+                return this.registry.getById(pref)?.adapter;
+        }
+        /* v8 ignore next 2 */
+        const sorted = [...tied].sort();
+        return this.registry.getById(sorted[0] ?? '')?.adapter;
+    }
+}
+const COUNT_EXCLUDES = [
+    '**/.venv/**',
+    '**/venv/**',
+    '**/__pycache__/**',
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/target/**',
+];
+function findMaxCount(counts) {
+    let best = null;
+    for (const [id, count] of counts) {
+        if (count === 0)
+            continue;
+        if (best === null || count > best.count)
+            best = { id, count };
+    }
+    return best;
+}
+function collectTies(counts, target) {
+    return [...counts.entries()].filter(([, c]) => c === target).map(([id]) => id);
+}
+//# sourceMappingURL=selector.js.map

package/dist/lang-adapter/selector.js.map

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