@opensip-cli/graph-typescript 0.1.0

package/dist/index.js

@@ -0,0 +1,346 @@
+// @fitness-ignore-file unbounded-memory -- reads single source files for parsing; per-file memory bounded by source size
+/**
+ * @opensip-cli/graph — TypeScript language adapter.
+ *
+ * Lands in PR 3 of plan docs/plans/10-graph-language-pluggability.md.
+ * Exposes `typescriptGraphAdapter`, the GraphLanguageAdapter
+ * implementation that wraps the existing TypeScript-specific
+ * walk/discover/edges machinery into the contract surface defined
+ * by `lang-adapter/types.ts`.
+ *
+ * The contract surface is intentionally small (six methods); each
+ * one delegates to the TypeScript-specific implementation and
+ * translates I/O shapes:
+ *
+ *   discoverFiles    → ./discover.ts:discoverFiles
+ *   parseProject     → ./parse.ts:parseProject
+ *   walkProject      → ./walk.ts:walkProgram, with CallSiteRecord
+ *                      translation (node/sourceFile → nodeRef/sourceFileRef)
+ *   resolveCallSites → ./edges.ts:resolveEdgesFromRecords
+ *   cacheKey         → ./cache-key.ts:cacheKey
+ *   ruleHints        → starter list of side-effect primitives + the
+ *                      `isTestFile` predicate previously inlined in walk.ts
+ *
+ * Files outside this subtree are forbidden from importing the
+ * TypeScript compiler API directly; the dep-cruiser rule
+ * `graph-no-typescript-import-outside-lang-typescript` enforces it.
+ */
+import { relative, sep } from 'node:path';
+import { ownerEdgeKey } from '@opensip-cli/graph';
+import ts from 'typescript';
+import { cacheKey as typescriptCacheKey } from './cache-key.js';
+import { discoverFiles as discoverTypescriptFiles } from './discover.js';
+import { methodTargetFile } from './edge-helpers/method-target.js';
+import { extractBoundaryCalls } from './edge-resolvers/boundary.js';
+import { resolveEdgesFromRecords, resolveEdgesSyntactic } from './edges.js';
+import { parseProject as parseTypescriptProject } from './parse.js';
+import { isTypescriptTestFile } from './test-file.js';
+import { walkProgram } from './walk.js';
+/**
+ * Starter list of well-known side-effect primitives for the
+ * no-side-effect-path rule. Names are textual prefixes a developer
+ * would actually write (e.g. `console.log(`).
+ *
+ * Conservative: high-precision, low-recall. Adapter authors may
+ * extend over time as the rule shows false negatives in practice.
+ */
+const TYPESCRIPT_SIDE_EFFECT_PRIMITIVES = [
+    'console.log',
+    'console.error',
+    'console.warn',
+    'console.info',
+    'console.debug',
+    'fs.writeFileSync',
+    'fs.appendFileSync',
+    'fs.unlinkSync',
+    'fs.mkdirSync',
+    'fs.rmSync',
+    'fs.renameSync',
+    'process.exit',
+    'process.kill',
+    'process.stdout.write',
+    'process.stderr.write',
+    'Math.random',
+    'Date.now',
+];
+const THROW_SYNTAX_REGEX = /\bthrow\s+(?:new\s+)?[A-Za-z_$]/;
+// ── Adapter façade ─────────────────────────────────────────────────
+function discoverFilesAdapter(input) {
+    const result = discoverTypescriptFiles({
+        projectDir: input.cwd,
+        tsConfigPath: input.configPathOverride,
+    });
+    return {
+        projectDirAbs: result.projectDirAbs,
+        files: result.files,
+        configPathAbs: result.tsConfigPathAbs,
+        compilerOptions: result.compilerOptions,
+    };
+}
+/**
+ * Yield the project's source files from either parsed-project tier. The
+ * walk is structural and mode-agnostic, so it consumes whichever shape
+ * the parse stage produced: exact mode pulls them from the `ts.Program`;
+ * fast mode pulls them from the standalone source-file map.
+ */
+function sourceFilesOf(project) {
+    return project.kind === 'fast' ? project.sourceFiles.values() : project.program.getSourceFiles();
+}
+function walkProjectAdapter(input) {
+    const walked = walkProgram({
+        sourceFiles: sourceFilesOf(input.project),
+        files: input.files,
+        projectDirAbs: input.projectDirAbs,
+    });
+    // Translate the TS-internal CallSiteRecord (node/sourceFile) into the
+    // contract's opaque shape (nodeRef/sourceFileRef). No data loss —
+    // the same handles flow back into resolveCallSites unchanged.
+    const callSites = walked.callSites.map((r) => ({
+        nodeRef: r.node,
+        sourceFileRef: r.sourceFile,
+        ownerHash: r.ownerHash,
+        kind: r.kind,
+        childHash: r.childHash,
+    }));
+    const dependencySites = walked.dependencySites.map((r) => ({
+        nodeRef: r.node,
+        sourceFileRef: r.sourceFile,
+        ownerHash: r.ownerHash,
+        specifier: r.specifier,
+        line: r.line,
+        column: r.column,
+    }));
+    return {
+        occurrences: walked.functions,
+        callSites,
+        dependencySites,
+        // Re-export facts are pure data (no AST handles) — passed straight through.
+        reExports: walked.reExports,
+        parseErrors: walked.parseErrors,
+    };
+}
+/**
+ * Translate the contract's opaque CallSiteRecord (nodeRef/sourceFileRef)
+ * back into the TS-internal shape (real ts.Node / ts.SourceFile handles)
+ * that the resolvers and the boundary extractor consume.
+ */
+function toTsCallSites(callSites) {
+    return callSites.map((r) => ({
+        node: r.nodeRef,
+        sourceFile: r.sourceFileRef,
+        ownerHash: r.ownerHash,
+        kind: r.kind,
+        childHash: r.childHash,
+    }));
+}
+async function resolveCallSitesAdapter(input) {
+    // Branch on the parsed-project tier BEFORE touching the checker. The
+    // fast tier has no `ts.Program`, so the exact (checker-backed) resolver
+    // cannot run on it.
+    const base = input.project.kind === 'fast'
+        ? await resolveCallSitesFast(input, input.project)
+        : await resolveCallSitesExact(input, input.project);
+    // Sharded build: also emit cross-boundary descriptors for calls that
+    // didn't land within this shard's own occurrences. Syntactic and
+    // mode-independent, so it runs identically for both tiers.
+    if (input.emitBoundaryCalls !== true)
+        return base;
+    // Cross-package METHOD calls need a TYPE-attested target file — supply a
+    // checker-backed resolver on the exact tier. The fast tier has no `ts.Program`,
+    // so method boundary calls are exact-tier only (the equivalence gate runs in
+    // exact mode); imported-function boundary calls stay tier-independent.
+    let resolveMethodTarget;
+    if (input.project.kind !== 'fast') {
+        const checker = input.project.program.getTypeChecker();
+        resolveMethodTarget = (node) => methodTargetFile(node, checker, input.projectDirAbs);
+    }
+    const boundaryCalls = extractBoundaryCalls(toTsCallSites(input.callSites), base.edgesByOwner, input.projectDirAbs, resolveMethodTarget);
+    return { ...base, boundaryCalls };
+}
+async function resolveCallSitesExact(input, project) {
+    const tsCallSites = toTsCallSites(input.callSites);
+    const result = await resolveEdgesFromRecords({
+        catalog: input.catalog,
+        program: project.program,
+        projectDirAbs: input.projectDirAbs,
+        callSites: tsCallSites,
+    });
+    // Phase 4 (DEC-498): resolve dependency sites if any. Translate
+    // back to the TS-specific shape (with real ts.Node handles) and
+    // run module resolution.
+    const dependenciesByOwner = input.dependencySites && input.dependencySites.length > 0
+        ? resolveDependencies(input.dependencySites.map((r) => ({
+            node: r.nodeRef,
+            sourceFile: r.sourceFileRef,
+            ownerHash: r.ownerHash,
+            specifier: r.specifier,
+            line: r.line,
+            column: r.column,
+        })), input.catalog, project.program, input.projectDirAbs)
+        : undefined;
+    return {
+        edgesByOwner: collectByOwner(result.catalog),
+        dependenciesByOwner,
+        stats: result.resolutionStats,
+    };
+}
+/**
+ * Fast-tier resolution entry. Resolves call edges syntactically — from
+ * callee names and the file's import graph — with NO type checker. The
+ * fast parse produced standalone source files (no `ts.Program`), so the
+ * semantic resolvers cannot run; `resolveEdgesSyntactic` works purely off
+ * the walked records and the catalog.
+ *
+ * Dependency (module-level import) edges are not emitted in fast mode —
+ * they remain an exact-tier feature, so `dependenciesByOwner` is omitted
+ * (the contract treats absence as "not emitted by this tier").
+ */
+async function resolveCallSitesFast(input, _project) {
+    const tsCallSites = toTsCallSites(input.callSites);
+    const result = await resolveEdgesSyntactic({
+        catalog: input.catalog,
+        projectDirAbs: input.projectDirAbs,
+        callSites: tsCallSites,
+    });
+    return {
+        edgesByOwner: collectByOwner(result.catalog),
+        stats: result.resolutionStats,
+    };
+}
+/**
+ * Build filePath → module-init bodyHash map from the catalog. Catalog
+ * occurrences carry project-relative filePath; only `module-init` kind
+ * occurrences participate (they're the receiver of import edges).
+ */
+function buildModuleInitIndex(catalog) {
+    const index = new Map();
+    for (const occs of Object.values(catalog.functions)) {
+        if (!occs)
+            continue;
+        for (const o of occs) {
+            if (o.kind === 'module-init') {
+                index.set(o.filePath, o.bodyHash);
+            }
+        }
+    }
+    return index;
+}
+/**
+ * Wrap `ts.sys` into a `ModuleResolutionHost`. Methods are bound
+ * through arrow functions to satisfy `@typescript-eslint/unbound-method`
+ * (arrow `this` is lexical / void). `useCaseSensitiveFileNames` is a
+ * boolean property on modern `ts.sys` — the function-vs-boolean branch
+ * in earlier code was unreachable dead-code (both branches returned the
+ * same value).
+ */
+function createModuleResolutionHost() {
+    return {
+        fileExists: (fileName) => ts.sys.fileExists(fileName),
+        readFile: (fileName, encoding) => ts.sys.readFile(fileName, encoding),
+        directoryExists: (directoryName) => ts.sys.directoryExists(directoryName),
+        getCurrentDirectory: () => ts.sys.getCurrentDirectory(),
+        getDirectories: (path) => ts.sys.getDirectories(path),
+        useCaseSensitiveFileNames: ts.sys.useCaseSensitiveFileNames,
+    };
+}
+/**
+ * Resolve a single import site to its target module-init bodyHash(es).
+ * Returns the empty array if the module resolves outside the catalog
+ * (e.g. external package, `.d.ts` declaration file) or fails to resolve
+ * at all — both treated as unresolved by downstream attribution.
+ */
+function resolveSiteTargets(site, compilerOptions, moduleResolutionHost, projectDirAbs, moduleInitByFilePath) {
+    const resolution = ts.resolveModuleName(site.specifier, site.sourceFile.fileName, compilerOptions, moduleResolutionHost);
+    if (resolution.resolvedModule === undefined)
+        return [];
+    // Convert absolute resolved path → project-relative POSIX path
+    const projectRel = relative(projectDirAbs, resolution.resolvedModule.resolvedFileName)
+        .split(sep)
+        .join('/');
+    const targetHash = moduleInitByFilePath.get(projectRel);
+    return targetHash === undefined ? [] : [targetHash];
+}
+/**
+ * Resolve TS import sites to target module-init bodyHashes. Imports
+ * resolving to a same-project source file map to that file's
+ * module-init occurrence; imports resolving to an external package or
+ * a `.d.ts` declaration file (outside the catalog) produce unresolved
+ * `DependencyEdge` entries with `to: []` and the raw specifier carried
+ * in `specifier` for downstream attribution.
+ *
+ * Phase 4 of opensip's substrate consolidation (DEC-498).
+ */
+function resolveDependencies(sites, catalog, program, projectDirAbs) {
+    const moduleInitByFilePath = buildModuleInitIndex(catalog);
+    const compilerOptions = program.getCompilerOptions();
+    const moduleResolutionHost = createModuleResolutionHost();
+    const out = new Map();
+    for (const site of sites) {
+        const to = resolveSiteTargets(site, compilerOptions, moduleResolutionHost, projectDirAbs, moduleInitByFilePath);
+        const edge = {
+            to,
+            line: site.line,
+            column: site.column,
+            specifier: site.specifier,
+        };
+        // Key per owner OCCURRENCE (module-init bodyHash + file) to match
+        // stitchEdges; module-init bodies can collide across trivial files.
+        const ownerKey = ownerEdgeKey(site.ownerHash, relative(projectDirAbs, site.sourceFile.fileName));
+        const existing = out.get(ownerKey);
+        if (existing === undefined) {
+            out.set(ownerKey, [edge]);
+        }
+        else {
+            existing.push(edge);
+        }
+    }
+    return out;
+}
+/**
+ * Build the `bodyHash → CallEdge[]` map the contract returns.
+ * `resolveEdgesFromRecords` writes edges onto a rebuilt catalog; the
+ * contract surface separates resolution from catalog mutation, so the
+ * orchestrator can stitch the edges into whatever catalog shape it owns.
+ */
+function collectByOwner(catalog) {
+    const out = new Map();
+    for (const arr of Object.values(catalog.functions)) {
+        if (!arr)
+            continue;
+        for (const o of arr) {
+            if (o.calls.length === 0)
+                continue;
+            out.set(ownerEdgeKey(o.bodyHash, o.filePath), o.calls);
+        }
+    }
+    return out;
+}
+export const typescriptGraphAdapter = {
+    id: 'typescript',
+    fileExtensions: ['.ts', '.tsx'],
+    displayName: 'TypeScript',
+    discoverFiles: discoverFilesAdapter,
+    parseProject: (input) => parseTypescriptProject(input),
+    walkProject: walkProjectAdapter,
+    resolveCallSites: resolveCallSitesAdapter,
+    cacheKey: typescriptCacheKey,
+    ruleHints: {
+        isTestFile: isTypescriptTestFile,
+        sideEffectPrimitives: TYPESCRIPT_SIDE_EFFECT_PRIMITIVES,
+        throwSyntaxRegex: THROW_SYNTAX_REGEX,
+    },
+};
+/**
+ * Discovery contract: external adapter packs export `adapter` (the
+ * GraphLanguageAdapter) and `metadata` (a small descriptor used by
+ * the CLI for diagnostics). The CLI bootstrap registers `adapter` into
+ * the adapter registry after a successful `import()`.
+ */
+export { typescriptGraphAdapter as adapter };
+export const metadata = {
+    id: typescriptGraphAdapter.id,
+    displayName: typescriptGraphAdapter.displayName,
+    fileExtensions: typescriptGraphAdapter.fileExtensions,
+};
+export { isTypescriptTestFile } from './test-file.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inventory-helpers/classify-visibility.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Classify a function/method's visibility — exported, module-local, private.
+ */
+import ts from 'typescript';
+import type { Visibility } from '@opensip-cli/graph';
+/**
+ * For a top-level function/variable: 'exported' if it has the export
+ * modifier (or is part of an export specifier); 'module-local'
+ * otherwise. Class members default to module-local unless explicitly
+ * private.
+ */
+export declare function classifyVisibility(node: ts.Node): Visibility;
+//# sourceMappingURL=classify-visibility.d.ts.map

package/dist/inventory-helpers/classify-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-visibility.d.ts","sourceRoot":"","sources":["../../src/inventory-helpers/classify-visibility.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,UAAU,CAK5D"}

package/dist/inventory-helpers/classify-visibility.js

@@ -0,0 +1,56 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collection (modifiers + export specifiers on a single declaration)
+/**
+ * Classify a function/method's visibility — exported, module-local, private.
+ */
+import ts from 'typescript';
+/**
+ * For a top-level function/variable: 'exported' if it has the export
+ * modifier (or is part of an export specifier); 'module-local'
+ * otherwise. Class members default to module-local unless explicitly
+ * private.
+ */
+export function classifyVisibility(node) {
+    const direct = directVisibility(node);
+    if (direct !== null)
+        return direct;
+    if (parentIsExportedVariableStatement(node))
+        return 'exported';
+    return 'module-local';
+}
+function directVisibility(node) {
+    /* v8 ignore next */
+    if (!ts.canHaveModifiers(node))
+        return null;
+    const modifiers = ts.getModifiers(node);
+    if (!modifiers)
+        return null;
+    for (const m of modifiers) {
+        if (m.kind === ts.SyntaxKind.PrivateKeyword)
+            return 'private';
+        if (m.kind === ts.SyntaxKind.ExportKeyword)
+            return 'exported';
+    }
+    return null;
+}
+function parentIsExportedVariableStatement(node) {
+    // Walk up to a VariableStatement and look for `export` modifier (handles
+    // `export const foo = () => {}`).
+    let parent = node.parent;
+    while (parent) {
+        if (ts.isVariableStatement(parent)) {
+            return hasExportModifier(parent);
+        }
+        // @fitness-ignore-next-line silent-early-returns -- boolean predicate (`parentIs…`): `false` IS the contract value meaning "no enclosing exported variable statement found"; the caller treats it as a normal classification result.
+        if (ts.isClassDeclaration(parent) || ts.isFunctionDeclaration(parent))
+            return false;
+        parent = parent.parent;
+    }
+    return false;
+}
+function hasExportModifier(node) {
+    const mods = ts.getModifiers(node);
+    if (!mods)
+        return false;
+    return mods.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+}
+//# sourceMappingURL=classify-visibility.js.map

package/dist/inventory-helpers/classify-visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-visibility.js","sourceRoot":"","sources":["../../src/inventory-helpers/classify-visibility.ts"],"names":[],"mappings":"AAAA,qIAAqI;AACrI;;GAEG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,iCAAiC,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IAC/D,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa;IACrC,oBAAoB;IACpB,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,cAAc;YAAE,OAAO,SAAS,CAAC;QAC9D,IAAI,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa;YAAE,OAAO,UAAU,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iCAAiC,CAAC,IAAa;IACtD,yEAAyE;IACzE,kCAAkC;IAClC,IAAI,MAAM,GAAwB,IAAI,CAAC,MAAM,CAAC;IAC9C,OAAO,MAAM,EAAE,CAAC;QACd,IAAI,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,qOAAqO;QACrO,IAAI,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACpF,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,IAA0B;IACnD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClE,CAAC"}

package/dist/inventory-helpers/extract-decorators.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extract decorator names from a TS class-member or class node.
+ */
+import ts from 'typescript';
+export declare function extractDecorators(node: ts.Node): readonly string[];
+//# sourceMappingURL=extract-decorators.d.ts.map

package/dist/inventory-helpers/extract-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-decorators.d.ts","sourceRoot":"","sources":["../../src/inventory-helpers/extract-decorators.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,SAAS,MAAM,EAAE,CAUlE"}

package/dist/inventory-helpers/extract-decorators.js

@@ -0,0 +1,33 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collection (decorators on a single class member; small N by language spec)
+/**
+ * Extract decorator names from a TS class-member or class node.
+ */
+import ts from 'typescript';
+/* v8 ignore start */
+export function extractDecorators(node) {
+    const out = [];
+    // ts.canHaveDecorators is the modern accessor; fall back to legacy decorators on older AST shapes.
+    const decorators = ts.canHaveDecorators(node) ? ts.getDecorators(node) : undefined;
+    if (decorators) {
+        for (const d of decorators) {
+            out.push(decoratorName(d));
+        }
+    }
+    return out;
+}
+function decoratorName(d) {
+    const expr = d.expression;
+    if (ts.isCallExpression(expr)) {
+        return expressionName(expr.expression);
+    }
+    return expressionName(expr);
+}
+function expressionName(expr) {
+    if (ts.isIdentifier(expr))
+        return expr.text;
+    if (ts.isPropertyAccessExpression(expr))
+        return expr.name.text;
+    return expr.getText();
+}
+/* v8 ignore stop */
+//# sourceMappingURL=extract-decorators.js.map

package/dist/inventory-helpers/extract-decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-decorators.js","sourceRoot":"","sources":["../../src/inventory-helpers/extract-decorators.ts"],"names":[],"mappings":"AAAA,6IAA6I;AAC7I;;GAEG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,qBAAqB;AACrB,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,mGAAmG;IACnG,MAAM,UAAU,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,CAAe;IACpC,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC;IAC1B,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,cAAc,CAAC,IAAmB;IACzC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC/D,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;AACxB,CAAC;AACD,oBAAoB"}

package/dist/inventory-helpers/extract-params.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Extract Param[] from a TS function-shaped node.
+ */
+import ts from 'typescript';
+import type { Param } from '@opensip-cli/graph';
+export declare function extractParams(node: ts.SignatureDeclaration | ts.FunctionLikeDeclaration): readonly Param[];
+//# sourceMappingURL=extract-params.d.ts.map

package/dist/inventory-helpers/extract-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-params.d.ts","sourceRoot":"","sources":["../../src/inventory-helpers/extract-params.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,EAAE,CAAC,oBAAoB,GAAG,EAAE,CAAC,uBAAuB,GACzD,SAAS,KAAK,EAAE,CAUlB"}

package/dist/inventory-helpers/extract-params.js

@@ -0,0 +1,28 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collection (parameters on a single function declaration)
+/**
+ * Extract Param[] from a TS function-shaped node.
+ */
+import ts from 'typescript';
+export function extractParams(node) {
+    const params = [];
+    for (const p of node.parameters) {
+        params.push({
+            name: extractName(p.name),
+            optional: p.questionToken !== undefined || p.initializer !== undefined,
+            rest: p.dotDotDotToken !== undefined,
+        });
+    }
+    return params;
+}
+/* v8 ignore start */
+function extractName(name) {
+    if (ts.isIdentifier(name))
+        return name.text;
+    if (ts.isObjectBindingPattern(name))
+        return '{...}';
+    if (ts.isArrayBindingPattern(name))
+        return '[...]';
+    return '<param>';
+}
+/* v8 ignore stop */
+//# sourceMappingURL=extract-params.js.map

package/dist/inventory-helpers/extract-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-params.js","sourceRoot":"","sources":["../../src/inventory-helpers/extract-params.ts"],"names":[],"mappings":"AAAA,2HAA2H;AAC3H;;GAEG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,MAAM,UAAU,aAAa,CAC3B,IAA0D;IAE1D,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;YACzB,QAAQ,EAAE,CAAC,CAAC,aAAa,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS;YACtE,IAAI,EAAE,CAAC,CAAC,cAAc,KAAK,SAAS;SACrC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qBAAqB;AACrB,SAAS,WAAW,CAAC,IAAoB;IACvC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IACpD,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,OAAO,SAAS,CAAC;AACnB,CAAC;AACD,oBAAoB"}

package/dist/inventory-helpers/hash-body.d.ts

@@ -0,0 +1,43 @@
+/**
+ * hashFunctionBody — content-keyed identity for a function declaration.
+ *
+ * Used by stage 1 (catalog construction) and stage 2
+ * (find-catalog-entry) and cache invalidation. Per spec §2.2 / DRY-2:
+ * "same body in two files → same hash; body changed by one character →
+ * new hash."
+ */
+import type ts from 'typescript';
+/**
+ * Result of normalizing + hashing a function body. `size` is the
+ * length of the normalized text in characters; rules use it to skip
+ * trivial wrappers whose duplication is structural, not actionable.
+ */
+export interface BodyDigest {
+    readonly hash: string;
+    readonly size: number;
+}
+/**
+ * Compute the bodyHash for a function-shaped node (declaration,
+ * expression, arrow, method, etc.). The text is normalized — comments
+ * stripped, whitespace collapsed — so cosmetic edits don't churn the
+ * hash.
+ */
+export declare function hashFunctionBody(node: ts.Node, sourceFile: ts.SourceFile): string;
+/**
+ * Like `hashFunctionBody`, but also returns the normalized size.
+ *
+ * Uses `sourceFile.text.slice(...)` instead of `node.getText(sourceFile)`
+ * to avoid the per-call AST walk that materializes a fresh string.
+ * V8 implements substring as a slice into the parent string when the
+ * source buffer is large, so this is also lower-allocation. The two
+ * paths produce identical content for the same node (both span from
+ * `getStart()` to `getEnd()`).
+ */
+export declare function digestFunctionBody(node: ts.Node, sourceFile: ts.SourceFile): BodyDigest;
+/**
+ * Hash a synthetic body string (used by module-init.ts which
+ * synthesizes a body from top-level statements).
+ */
+export declare function hashSyntheticBody(input: string): string;
+export declare function digestSyntheticBody(input: string): BodyDigest;
+//# sourceMappingURL=hash-body.d.ts.map

package/dist/inventory-helpers/hash-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-body.d.ts","sourceRoot":"","sources":["../../src/inventory-helpers/hash-body.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,CAEjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,UAAU,CAIvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAG7D"}

package/dist/inventory-helpers/hash-body.js

@@ -0,0 +1,52 @@
+/**
+ * hashFunctionBody — content-keyed identity for a function declaration.
+ *
+ * Used by stage 1 (catalog construction) and stage 2
+ * (find-catalog-entry) and cache invalidation. Per spec §2.2 / DRY-2:
+ * "same body in two files → same hash; body changed by one character →
+ * new hash."
+ */
+import { createHash } from 'node:crypto';
+import { stripComments } from '@opensip-cli/lang-typescript';
+/**
+ * Compute the bodyHash for a function-shaped node (declaration,
+ * expression, arrow, method, etc.). The text is normalized — comments
+ * stripped, whitespace collapsed — so cosmetic edits don't churn the
+ * hash.
+ */
+export function hashFunctionBody(node, sourceFile) {
+    return digestFunctionBody(node, sourceFile).hash;
+}
+/**
+ * Like `hashFunctionBody`, but also returns the normalized size.
+ *
+ * Uses `sourceFile.text.slice(...)` instead of `node.getText(sourceFile)`
+ * to avoid the per-call AST walk that materializes a fresh string.
+ * V8 implements substring as a slice into the parent string when the
+ * source buffer is large, so this is also lower-allocation. The two
+ * paths produce identical content for the same node (both span from
+ * `getStart()` to `getEnd()`).
+ */
+export function digestFunctionBody(node, sourceFile) {
+    const text = sourceFile.text.slice(node.getStart(sourceFile), node.getEnd());
+    const normalized = normalizeWhitespace(stripComments(text));
+    return { hash: sha256(normalized), size: normalized.length };
+}
+/**
+ * Hash a synthetic body string (used by module-init.ts which
+ * synthesizes a body from top-level statements).
+ */
+export function hashSyntheticBody(input) {
+    return digestSyntheticBody(input).hash;
+}
+export function digestSyntheticBody(input) {
+    const normalized = normalizeWhitespace(stripComments(input));
+    return { hash: sha256(normalized), size: normalized.length };
+}
+function normalizeWhitespace(s) {
+    return s.replaceAll(/\s+/g, ' ').trim();
+}
+function sha256(s) {
+    return createHash('sha256').update(s, 'utf8').digest('hex');
+}
+//# sourceMappingURL=hash-body.js.map

package/dist/inventory-helpers/hash-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-body.js","sourceRoot":"","sources":["../../src/inventory-helpers/hash-body.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAc7D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa,EAAE,UAAyB;IACvE,OAAO,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa,EAAE,UAAyB;IACzE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,mBAAmB,CAAC,CAAS;IACpC,OAAO,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC"}