@opensip-cli/graph-adapter-common 0.1.0

package/dist/__tests__/parse-from-adapter.test.js

@@ -0,0 +1,93 @@
+/**
+ * Behavior tests for `createParseProjectFromAdapter`.
+ *
+ * The driver is deliberately decoupled from any one grammar: it accepts a
+ * `LanguageAdapter<ParsedFile>` and only ever touches `adapter.id`,
+ * `adapter.parse(source, path)`, and the returned `parsed.tree.rootNode.hasError`
+ * flag. These tests drive it with a tiny fake adapter (the same `as never`
+ * fake-node harness the sibling tests use) plus real temp source files, and
+ * assert the real I-7 contract: every file either lands in `project.files`
+ * with its source threaded through, or surfaces in `parseErrors` — and a
+ * `hasError` tree is kept as a partial parse AND recorded as an error.
+ */
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createParseProjectFromAdapter } from '../parse-from-adapter.js';
+// A fake parsed tree whose only observed field is `rootNode.hasError`. The
+// driver also threads `source` straight through, so we keep it on the object.
+const mkParsed = (source, hasError) => ({ source, tree: { rootNode: { hasError } } });
+/**
+ * A minimal `LanguageAdapter<ParsedFile>` that records every `parse` call and
+ * flags any file whose source contains `BROKEN` as `hasError`. This is enough
+ * to exercise both sides of the `hasError` branch with real on-disk files.
+ */
+const makeFakeAdapter = () => {
+    const calls = [];
+    const adapter = {
+        id: 'fake',
+        parse(source, path) {
+            calls.push({ source, path });
+            return mkParsed(source, source.includes('BROKEN'));
+        },
+    };
+    return { adapter, calls };
+};
+describe('createParseProjectFromAdapter', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'gac-pfa-'));
+    });
+    afterEach(() => {
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('parses each file via the adapter, threading source through, no errors for clean files', () => {
+        const a = join(dir, 'a.txt');
+        const b = join(dir, 'b.txt');
+        writeFileSync(a, 'alpha-source', 'utf8');
+        writeFileSync(b, 'beta-source', 'utf8');
+        const { adapter, calls } = makeFakeAdapter();
+        const parseProject = createParseProjectFromAdapter(adapter);
+        const out = parseProject({ projectDirAbs: dir, files: [a, b], resolutionMode: 'exact' });
+        expect(out.parseErrors).toEqual([]);
+        expect(out.project.files.size).toBe(2);
+        // The adapter was asked to parse each file's real on-disk content.
+        expect(calls).toEqual([
+            { source: 'alpha-source', path: a },
+            { source: 'beta-source', path: b },
+        ]);
+        // The parsed file holds the original source text for later body slicing.
+        expect(out.project.files.get(a)?.source).toBe('alpha-source');
+        expect(out.project.files.get(b)?.source).toBe('beta-source');
+    });
+    it('records a parseError (project-relative path) when the tree reports hasError, keeping the partial tree', () => {
+        const good = join(dir, 'good.txt');
+        const bad = join(dir, 'bad.txt');
+        writeFileSync(good, 'fine', 'utf8');
+        writeFileSync(bad, 'BROKEN tree', 'utf8');
+        const { adapter } = makeFakeAdapter();
+        const parseProject = createParseProjectFromAdapter(adapter);
+        const out = parseProject({
+            projectDirAbs: dir,
+            files: [good, bad],
+            resolutionMode: 'exact',
+        });
+        // hasError is recorded as an error...
+        expect(out.parseErrors).toHaveLength(1);
+        expect(out.parseErrors[0]?.filePath).toBe('bad.txt');
+        expect(out.parseErrors[0]?.message).toContain('partial tree retained');
+        // ...but the partial tree is still retained in the project.
+        expect(out.project.files.has(bad)).toBe(true);
+        expect(out.project.files.has(good)).toBe(true);
+        expect(out.project.files.size).toBe(2);
+    });
+    it('returns an empty project for an empty file list', () => {
+        const { adapter } = makeFakeAdapter();
+        const parseProject = createParseProjectFromAdapter(adapter);
+        const out = parseProject({ projectDirAbs: dir, files: [], resolutionMode: 'exact' });
+        expect(out.project.files.size).toBe(0);
+        expect(out.parseErrors).toEqual([]);
+    });
+});
+//# sourceMappingURL=parse-from-adapter.test.js.map

package/dist/__tests__/parse-from-adapter.test.js.map

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

package/dist/__tests__/run-walk.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Behavior tests for the shared `runWalk` driver.
+ *
+ * `runWalk` owns the `walkProject` skeleton: it allocates the three output
+ * sinks, filters `input.files` to those actually present in the parsed
+ * project, sorts them for I-1 determinism, runs the adapter's per-file
+ * `walkFile` inside a try/catch, and folds any throw into a project-relative
+ * `ParseError`. These tests assert each of those contracts with a fake
+ * `walkFile` that records what it sees and pushes into the supplied sinks.
+ */
+export {};
+//# sourceMappingURL=run-walk.test.d.ts.map

package/dist/__tests__/run-walk.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-walk.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/run-walk.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/run-walk.test.js

@@ -0,0 +1,183 @@
+/**
+ * Behavior tests for the shared `runWalk` driver.
+ *
+ * `runWalk` owns the `walkProject` skeleton: it allocates the three output
+ * sinks, filters `input.files` to those actually present in the parsed
+ * project, sorts them for I-1 determinism, runs the adapter's per-file
+ * `walkFile` inside a try/catch, and folds any throw into a project-relative
+ * `ParseError`. These tests assert each of those contracts with a fake
+ * `walkFile` that records what it sees and pushes into the supplied sinks.
+ */
+import { describe, expect, it } from 'vitest';
+import { buildNameIndex, record, runWalk } from '../walk.js';
+// A parsed file is opaque to runWalk (only walkFile reads it), so a tagged
+// stub suffices.
+const mkFile = (tag) => ({ tag });
+const occ = (name, hash) => ({
+    bodyHash: hash,
+    bodySize: 1,
+    simpleName: name,
+    qualifiedName: name,
+    filePath: 'x',
+    line: 1,
+    column: 0,
+    endLine: 1,
+    kind: 'function-declaration',
+    params: [],
+    returnType: null,
+    enclosingClass: null,
+    decorators: [],
+    visibility: 'private',
+    inTestFile: false,
+    definedInGenerated: false,
+    calls: [],
+});
+const callSite = (ownerHash) => ({
+    nodeRef: {},
+    sourceFileRef: {},
+    ownerHash,
+    kind: 'call',
+});
+const depSite = (specifier, ownerHash) => ({
+    nodeRef: {},
+    sourceFileRef: {},
+    ownerHash,
+    specifier,
+    line: 1,
+    column: 0,
+});
+describe('runWalk', () => {
+    it('visits parsed files in sorted order, threading sinks + projectDir into walkFile', () => {
+        const files = new Map([
+            ['/proj/b.go', mkFile('b')],
+            ['/proj/a.go', mkFile('a')],
+        ]);
+        const input = {
+            project: { files },
+            projectDirAbs: '/proj',
+            // Deliberately out of order — runWalk must sort for determinism.
+            files: ['/proj/b.go', '/proj/a.go'],
+        };
+        const seen = [];
+        const out = runWalk({
+            input,
+            walkFile: (absPath, file, projectDirAbs, sinks) => {
+                seen.push({ path: absPath, projectDirAbs });
+                // Push one of each record kind so we can assert the sinks flow through.
+                record(sinks.occurrences, occ(`fn-${file.tag}`, `h-${absPath}`));
+                sinks.callSites.push(callSite(`h-${absPath}`));
+                sinks.dependencySites.push(depSite('./dep', `h-${absPath}`));
+            },
+        });
+        // Sorted: a.go before b.go.
+        expect(seen.map((s) => s.path)).toEqual(['/proj/a.go', '/proj/b.go']);
+        expect(seen.every((s) => s.projectDirAbs === '/proj')).toBe(true);
+        // Sinks flowed back out into WalkOutput.
+        expect(out.occurrences['fn-a']?.[0]?.bodyHash).toBe('h-/proj/a.go');
+        expect(out.occurrences['fn-b']?.[0]?.bodyHash).toBe('h-/proj/b.go');
+        expect(out.callSites).toHaveLength(2);
+        expect(out.dependencySites).toHaveLength(2);
+        expect(out.parseErrors).toEqual([]);
+    });
+    it('filters out requested files that are not in the parsed project', () => {
+        const files = new Map([['/proj/a.go', mkFile('a')]]);
+        const input = {
+            project: { files },
+            projectDirAbs: '/proj',
+            files: ['/proj/a.go', '/proj/missing.go'],
+        };
+        const visited = [];
+        runWalk({
+            input,
+            walkFile: (absPath) => {
+                visited.push(absPath);
+            },
+        });
+        expect(visited).toEqual(['/proj/a.go']);
+    });
+    it('records a project-relative ParseError when walkFile throws an Error', () => {
+        const files = new Map([['/proj/pkg/bad.go', mkFile('bad')]]);
+        const input = {
+            project: { files },
+            projectDirAbs: '/proj',
+            files: ['/proj/pkg/bad.go'],
+        };
+        const out = runWalk({
+            input,
+            walkFile: () => {
+                throw new Error('boom');
+            },
+        });
+        expect(out.parseErrors).toHaveLength(1);
+        expect(out.parseErrors[0]?.filePath).toBe('pkg/bad.go');
+        expect(out.parseErrors[0]?.message).toBe('boom');
+        // The walk still returns the (empty) sinks rather than aborting.
+        expect(out.callSites).toEqual([]);
+    });
+    it('stringifies a non-Error throw value in the ParseError message', () => {
+        const files = new Map([['/proj/a.go', mkFile('a')]]);
+        const input = {
+            project: { files },
+            projectDirAbs: '/proj',
+            files: ['/proj/a.go'],
+        };
+        const out = runWalk({
+            input,
+            walkFile: () => {
+                // eslint-disable-next-line @typescript-eslint/only-throw-error -- exercising the non-Error branch
+                throw 'plain-string-failure';
+            },
+        });
+        expect(out.parseErrors[0]?.message).toBe('plain-string-failure');
+    });
+    it('skips an entry whose project map claims `has` but returns no value from `get` (defensive guard)', () => {
+        // A Map-like whose has/get disagree for one key — the exact inconsistency
+        // the `if (!file) continue;` guard defends against (e.g. a concurrently
+        // mutated map). The driver must skip it without throwing.
+        const real = new Map([['/proj/a.go', mkFile('a')]]);
+        const inconsistent = {
+            has: (k) => k === '/proj/a.go' || k === '/proj/ghost.go',
+            get: (k) => real.get(k),
+        };
+        const input = {
+            project: { files: inconsistent },
+            projectDirAbs: '/proj',
+            files: ['/proj/a.go', '/proj/ghost.go'],
+        };
+        const visited = [];
+        const out = runWalk({
+            input,
+            walkFile: (absPath) => {
+                visited.push(absPath);
+            },
+        });
+        // ghost.go passed the `has` filter but `get` returned undefined → skipped.
+        expect(visited).toEqual(['/proj/a.go']);
+        expect(out.parseErrors).toEqual([]);
+    });
+});
+describe('buildNameIndex — empty / sparse occurrence slots', () => {
+    it('skips a name whose occurrence list is empty (no entry created)', () => {
+        // A real name mapping to an empty array must NOT produce a map entry,
+        // since there are no bodyHashes to resolve against.
+        const functions = {
+            foo: [occ('foo', 'h1')],
+            bar: [], // empty → length 0 → not indexed
+        };
+        const idx = buildNameIndex(functions);
+        expect(idx.get('foo')).toEqual(['h1']);
+        expect(idx.has('bar')).toBe(false);
+    });
+    it('skips a falsy occurrence slot (defensive `!occs` guard)', () => {
+        // A sparse/undefined slot (e.g. from a holey record) must be skipped
+        // rather than throwing on iteration.
+        const functions = {
+            foo: [occ('foo', 'h1')],
+            missing: undefined,
+        };
+        const idx = buildNameIndex(functions);
+        expect(idx.get('foo')).toEqual(['h1']);
+        expect(idx.has('missing')).toBe(false);
+    });
+});
+//# sourceMappingURL=run-walk.test.js.map

package/dist/__tests__/run-walk.test.js.map

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

package/dist/body-digest.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared body-digest leaf primitives.
+ *
+ * The per-language comment strippers (`stripGoComments`,
+ * `stripRustComments` with nested block comments + char-vs-lifetime
+ * heuristic, `stripPythonComments` + docstring strip, Java's stripper)
+ * stay in each adapter's `body-digest.ts` — they are genuinely
+ * language-specific. Only the byte-identical `skipToEndOfLine` primitive
+ * (scan from `start` to the next newline) is shared here; each adapter's
+ * `digestXBody = hashBody(normalizeWhitespace(stripXComments(text)))`
+ * wiring and its `digestSyntheticBody` alias remain adapter-owned.
+ */
+/** Advance from `start` to the index of the next `\n` (or end of text). */
+export declare function skipToEndOfLine(text: string, start: number): number;
+/**
+ * Skip a NON-nesting C-style block comment: from `start` (just past the
+ * opening `/*`), scan to and past the first `*\/`. Returns the index
+ * immediately after the closing delimiter, or end-of-text if unterminated.
+ *
+ * This is the Go / Java / C-style form, where block comments do NOT nest.
+ * Languages whose block comments DO nest (e.g. Rust's `/* /* *\/ *\/`)
+ * need their own depth-tracking variant and must not use this one.
+ */
+export declare function skipBlockComment(text: string, start: number): number;
+//# sourceMappingURL=body-digest.d.ts.map

package/dist/body-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-digest.d.ts","sourceRoot":"","sources":["../src/body-digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQpE"}

package/dist/body-digest.js

@@ -0,0 +1,39 @@
+/**
+ * Shared body-digest leaf primitives.
+ *
+ * The per-language comment strippers (`stripGoComments`,
+ * `stripRustComments` with nested block comments + char-vs-lifetime
+ * heuristic, `stripPythonComments` + docstring strip, Java's stripper)
+ * stay in each adapter's `body-digest.ts` — they are genuinely
+ * language-specific. Only the byte-identical `skipToEndOfLine` primitive
+ * (scan from `start` to the next newline) is shared here; each adapter's
+ * `digestXBody = hashBody(normalizeWhitespace(stripXComments(text)))`
+ * wiring and its `digestSyntheticBody` alias remain adapter-owned.
+ */
+/** Advance from `start` to the index of the next `\n` (or end of text). */
+export function skipToEndOfLine(text, start) {
+    let i = start;
+    while (i < text.length && text[i] !== '\n')
+        i++;
+    return i;
+}
+/**
+ * Skip a NON-nesting C-style block comment: from `start` (just past the
+ * opening `/*`), scan to and past the first `*\/`. Returns the index
+ * immediately after the closing delimiter, or end-of-text if unterminated.
+ *
+ * This is the Go / Java / C-style form, where block comments do NOT nest.
+ * Languages whose block comments DO nest (e.g. Rust's `/* /* *\/ *\/`)
+ * need their own depth-tracking variant and must not use this one.
+ */
+export function skipBlockComment(text, start) {
+    let i = start;
+    while (i < text.length) {
+        if (text.slice(i, i + 2) === '*/')
+            return i + 2;
+        i++;
+    }
+    /* v8 ignore next */
+    return i;
+}
+//# sourceMappingURL=body-digest.js.map

package/dist/body-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-digest.js","sourceRoot":"","sources":["../src/body-digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,CAAC,EAAE,CAAC;IAChD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAa;IAC1D,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAChD,CAAC,EAAE,CAAC;IACN,CAAC;IACD,oBAAoB;IACpB,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cache-key.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared config-fingerprint helpers for the tree-sitter adapters'
+ * `cacheKey`.
+ *
+ * `hashConfig(configPathAbs)` is byte-identical in graph-go / graph-java /
+ * graph-rust: it returns the literal `no-config` when no anchor exists,
+ * `missing:<path>` / `unreadable:<path>` sentinels on fs failure, and the
+ * first 16 hex chars of the sha256 of the manifest content otherwise. Per
+ * contract invariant I-6 it is a pure function of the config content.
+ *
+ * `makeConfigCacheKey({ prefix })` returns the trivial
+ * `cacheKey(input) => `${prefix}-${hashConfig(...)}`` used by go/java/rust
+ * (with prefixes `go-` / `java-` / `rs-`). Python keeps its own
+ * `cache-key.ts` but imports `hashConfig` from here and layers its
+ * `requires-python` extraction on top (DEC-4).
+ */
+import type { CacheKeyInput } from '@opensip-cli/graph';
+/**
+ * Fingerprint a language config file's content.
+ *
+ *   - `undefined` / empty path → `'no-config'`
+ *   - path does not exist      → `'missing:<path>'`
+ *   - read fails               → `'unreadable:<path>'`
+ *   - otherwise                → first 16 hex of sha256(content)
+ */
+export declare function hashConfig(configPathAbs: string | undefined): string;
+/**
+ * Builds a `cacheKey` that emits `${prefix}-${hashConfig(configPathAbs)}`.
+ * Per I-8 the prefix must be distinct per adapter (`go-`, `java-`, `rs-`).
+ */
+export declare function makeConfigCacheKey(options: {
+    readonly prefix: string;
+}): (input: CacheKeyInput) => string;
+//# sourceMappingURL=cache-key.d.ts.map

package/dist/cache-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.d.ts","sourceRoot":"","sources":["../src/cache-key.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAcpE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,CAKnC"}

package/dist/cache-key.js

@@ -0,0 +1,54 @@
+// @fitness-ignore-file unbounded-memory -- reads a single language manifest (go.mod / Cargo.toml / pom.xml / pyproject.toml); bounded by standard project metadata
+/**
+ * Shared config-fingerprint helpers for the tree-sitter adapters'
+ * `cacheKey`.
+ *
+ * `hashConfig(configPathAbs)` is byte-identical in graph-go / graph-java /
+ * graph-rust: it returns the literal `no-config` when no anchor exists,
+ * `missing:<path>` / `unreadable:<path>` sentinels on fs failure, and the
+ * first 16 hex chars of the sha256 of the manifest content otherwise. Per
+ * contract invariant I-6 it is a pure function of the config content.
+ *
+ * `makeConfigCacheKey({ prefix })` returns the trivial
+ * `cacheKey(input) => `${prefix}-${hashConfig(...)}`` used by go/java/rust
+ * (with prefixes `go-` / `java-` / `rs-`). Python keeps its own
+ * `cache-key.ts` but imports `hashConfig` from here and layers its
+ * `requires-python` extraction on top (DEC-4).
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+/**
+ * Fingerprint a language config file's content.
+ *
+ *   - `undefined` / empty path → `'no-config'`
+ *   - path does not exist      → `'missing:<path>'`
+ *   - read fails               → `'unreadable:<path>'`
+ *   - otherwise                → first 16 hex of sha256(content)
+ */
+export function hashConfig(configPathAbs) {
+    if (configPathAbs === undefined || configPathAbs.length === 0) {
+        return 'no-config';
+    }
+    if (!existsSync(configPathAbs)) {
+        return `missing:${configPathAbs}`;
+    }
+    try {
+        const content = readFileSync(configPathAbs, 'utf8');
+        return createHash('sha256').update(content).digest('hex').slice(0, 16);
+    }
+    catch {
+        /* v8 ignore next */
+        return `unreadable:${configPathAbs}`;
+    }
+}
+/**
+ * Builds a `cacheKey` that emits `${prefix}-${hashConfig(configPathAbs)}`.
+ * Per I-8 the prefix must be distinct per adapter (`go-`, `java-`, `rs-`).
+ */
+export function makeConfigCacheKey(options) {
+    const { prefix } = options;
+    return function cacheKey(input) {
+        return `${prefix}-${hashConfig(input.configPathAbs)}`;
+    };
+}
+//# sourceMappingURL=cache-key.js.map

package/dist/cache-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.js","sourceRoot":"","sources":["../src/cache-key.ts"],"names":[],"mappings":"AAAA,mKAAmK;AACnK;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAInD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,aAAiC;IAC1D,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,WAAW,aAAa,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;QACpB,OAAO,cAAc,aAAa,EAAE,CAAC;IACvC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAElC;IACC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,OAAO,SAAS,QAAQ,CAAC,KAAoB;QAC3C,OAAO,GAAG,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC"}

package/dist/discover.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared file-discovery scaffolding for the tree-sitter graph adapters.
+ *
+ * The discover template is byte-identical across graph-go / graph-java /
+ * graph-python / graph-rust save four data inputs:
+ *
+ *   - `extension`         — the source-file extension to glob (`.go`, …).
+ *   - `excludedDirGlobs`  — vendored / build-output / VCS dirs to skip.
+ *   - `configCandidates`  — the ordered config-file precedence list
+ *                           (resolved-deps first, e.g. `['go.sum','go.mod']`).
+ *   - `languageId`        — the `graph:discover:<id>` log tag.
+ *
+ * `createDiscover` closes over those and returns the adapter's
+ * `discoverFiles(input): DiscoverOutput`. The collect loop, the symlink
+ * realpath/dedup/sort normalization (so I-9 referential transparency
+ * holds), and the `DiscoverOutput` assembly are shared verbatim.
+ */
+import type { DiscoverInput, DiscoverOutput } from '@opensip-cli/graph';
+/** Per-language inputs to the shared discover template. */
+export interface TreeSitterDiscoverConfig {
+    /** Source-file extension WITHOUT the leading dot, e.g. `'go'`, `'py'`. */
+    readonly extension: string;
+    /** Directory globs to exclude from the recursive source-file walk. */
+    readonly excludedDirGlobs: readonly string[];
+    /**
+     * Ordered config-file precedence list (resolved-deps first). The first
+     * candidate that exists at the project root becomes the cacheKey anchor.
+     */
+    readonly configCandidates: readonly string[];
+    /** Log-tag suffix for `graph:discover:<languageId>`. */
+    readonly languageId: string;
+}
+/** Builds the adapter's `discoverFiles` from per-language config. */
+export declare function createDiscover(config: TreeSitterDiscoverConfig): (input: DiscoverInput) => DiscoverOutput;
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAExE,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,wBAAwB,GAC/B,CAAC,KAAK,EAAE,aAAa,KAAK,cAAc,CAkC1C"}

package/dist/discover.js

@@ -0,0 +1,114 @@
+// @fitness-ignore-file error-handling-quality -- realpathSync probe for symlink dedup; exception → fall through with the original path (file might be in a symlinked dir or have been unlinked), already marked v8-ignore as effectively unreachable on real input.
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collection (source directories within a single project root)
+/**
+ * Shared file-discovery scaffolding for the tree-sitter graph adapters.
+ *
+ * The discover template is byte-identical across graph-go / graph-java /
+ * graph-python / graph-rust save four data inputs:
+ *
+ *   - `extension`         — the source-file extension to glob (`.go`, …).
+ *   - `excludedDirGlobs`  — vendored / build-output / VCS dirs to skip.
+ *   - `configCandidates`  — the ordered config-file precedence list
+ *                           (resolved-deps first, e.g. `['go.sum','go.mod']`).
+ *   - `languageId`        — the `graph:discover:<id>` log tag.
+ *
+ * `createDiscover` closes over those and returns the adapter's
+ * `discoverFiles(input): DiscoverOutput`. The collect loop, the symlink
+ * realpath/dedup/sort normalization (so I-9 referential transparency
+ * holds), and the `DiscoverOutput` assembly are shared verbatim.
+ */
+import { existsSync, realpathSync } from 'node:fs';
+import { resolve, sep } from 'node:path';
+import { logger } from '@opensip-cli/core';
+import { glob } from 'glob';
+/** Builds the adapter's `discoverFiles` from per-language config. */
+export function createDiscover(config) {
+    const { extension, excludedDirGlobs, configCandidates, languageId } = config;
+    const module = `graph:discover:${languageId}`;
+    const pattern = `**/*.${extension}`;
+    return function discoverFiles(input) {
+        logger.info({
+            evt: 'graph.discover.start',
+            module,
+            projectDir: input.cwd,
+        });
+        const projectDirAbs = normalizeProjectDir(input.cwd);
+        const configPathAbs = resolveConfigPath(projectDirAbs, input.configPathOverride, configCandidates);
+        const files = collectFiles(projectDirAbs, pattern, excludedDirGlobs);
+        logger.info({
+            evt: 'graph.discover.complete',
+            module,
+            projectDir: projectDirAbs,
+            configPath: configPathAbs ?? '(none)',
+            fileCount: files.length,
+        });
+        const out = configPathAbs === undefined
+            ? { projectDirAbs, files }
+            : { projectDirAbs, files, configPathAbs };
+        return out;
+    };
+}
+/* v8 ignore start */
+function normalizeProjectDir(projectDir) {
+    const abs = resolve(projectDir);
+    try {
+        return realpathSync(abs);
+    }
+    catch {
+        return abs;
+    }
+}
+/* v8 ignore stop */
+function resolveConfigPath(projectDirAbs, override, configCandidates) {
+    if (override !== undefined && override.length > 0) {
+        const abs = resolve(projectDirAbs, override);
+        return existsSync(abs) ? realpathOrPath(abs) : abs;
+    }
+    for (const candidate of configCandidates) {
+        const path = resolve(projectDirAbs, candidate);
+        if (existsSync(path))
+            return realpathOrPath(path);
+    }
+    return undefined;
+}
+/* v8 ignore start */
+function realpathOrPath(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+/* v8 ignore stop */
+function collectFiles(projectDirAbs, pattern, excludedDirGlobs) {
+    const matches = glob.sync(pattern, {
+        cwd: projectDirAbs,
+        absolute: true,
+        ignore: [...excludedDirGlobs],
+        nodir: true,
+        follow: false,
+        dot: false,
+    });
+    const seen = new Set();
+    const out = [];
+    for (const m of matches) {
+        let real = m;
+        /* v8 ignore start */
+        try {
+            real = realpathSync(m);
+        }
+        catch {
+            // fall through with original
+        }
+        /* v8 ignore stop */
+        const key = real.split(sep).join('/');
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(real);
+    }
+    out.sort();
+    return out;
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA,oQAAoQ;AACpQ,+HAA+H;AAC/H;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAmB5B,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAC5B,MAAgC;IAEhC,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC7E,MAAM,MAAM,GAAG,kBAAkB,UAAU,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,QAAQ,SAAS,EAAE,CAAC;IAEpC,OAAO,SAAS,aAAa,CAAC,KAAoB;QAChD,MAAM,CAAC,IAAI,CAAC;YACV,GAAG,EAAE,sBAAsB;YAC3B,MAAM;YACN,UAAU,EAAE,KAAK,CAAC,GAAG;SACtB,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,aAAa,GAAG,iBAAiB,CACrC,aAAa,EACb,KAAK,CAAC,kBAAkB,EACxB,gBAAgB,CACjB,CAAC;QACF,MAAM,KAAK,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAErE,MAAM,CAAC,IAAI,CAAC;YACV,GAAG,EAAE,yBAAyB;YAC9B,MAAM;YACN,UAAU,EAAE,aAAa;YACzB,UAAU,EAAE,aAAa,IAAI,QAAQ;YACrC,SAAS,EAAE,KAAK,CAAC,MAAM;SACxB,CAAC,CAAC;QAEH,MAAM,GAAG,GACP,aAAa,KAAK,SAAS;YACzB,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE;YAC1B,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC;AAED,qBAAqB;AACrB,SAAS,mBAAmB,CAAC,UAAkB;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AACD,oBAAoB;AAEpB,SAAS,iBAAiB,CACxB,aAAqB,EACrB,QAA4B,EAC5B,gBAAmC;IAEnC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,qBAAqB;AACrB,SAAS,cAAc,CAAC,CAAS;IAC/B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AACD,oBAAoB;AAEpB,SAAS,YAAY,CACnB,aAAqB,EACrB,OAAe,EACf,gBAAmC;IAEnC,MAAM,OAAO,GAAa,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;QAC3C,GAAG,EAAE,aAAa;QAClB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC,GAAG,gBAAgB,CAAC;QAC7B,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,IAAI,GAAW,CAAC,CAAC;QACrB,qBAAqB;QACrB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,oBAAoB;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC"}