@lzehrung/codegraph-core 2.1.0

package/dist/parserBackend.d.ts

@@ -0,0 +1,57 @@
+export interface SyntaxPoint {
+    row: number;
+    column: number;
+}
+export interface ParserSyntaxNode {
+    readonly id?: number;
+    type: string;
+    text: string;
+    startIndex: number;
+    endIndex: number;
+    startPosition: SyntaxPoint;
+    endPosition: SyntaxPoint;
+    parent: ParserSyntaxNode | null;
+    namedChildren: ParserSyntaxNode[];
+    previousSibling?: ParserSyntaxNode | null;
+    previousNamedSibling?: ParserSyntaxNode | null;
+    child(index: number): ParserSyntaxNode | null;
+    childForFieldName(fieldName: string): ParserSyntaxNode | null;
+}
+export interface ParserSyntaxTree {
+    rootNode: ParserSyntaxNode & {
+        descendantForIndex(startIndex: number, endIndex: number): ParserSyntaxNode;
+        descendantForPosition(start: SyntaxPoint, end: SyntaxPoint): ParserSyntaxNode;
+    };
+    walk(): unknown;
+}
+export interface ParserLanguage {
+    readonly name?: string;
+}
+export interface QueryPoint {
+    row: number;
+    column: number;
+    index: number;
+}
+export interface QueryCapture {
+    name: string;
+    text: string;
+    nodeType: string;
+    start: QueryPoint;
+    end: QueryPoint;
+}
+export interface QueryMatch {
+    patternIndex: number;
+    captures: QueryCapture[];
+}
+export declare function __resetParserBackendModuleForTests(): void;
+export declare function isNonNativeParserAvailable(): boolean;
+export declare function isNonNativeParserUnavailableError(error: unknown): boolean;
+export declare function loadTreeSitterLanguage(packageName: string): ParserLanguage;
+export declare function loadTypeScriptGrammars(): {
+    typescript: ParserLanguage;
+    tsx: ParserLanguage;
+};
+export declare function parseWithLanguage(_source: string, _language: ParserLanguage): ParserSyntaxTree;
+export declare function isParserSyntaxTree(tree: unknown): tree is ParserSyntaxTree;
+export declare function executeQueryAsNativeMatches(_source: string, _language: ParserLanguage, _queryText: string, _tree?: ParserSyntaxTree): QueryMatch[];
+//# sourceMappingURL=parserBackend.d.ts.map

package/dist/parserBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parserBackend.d.ts","sourceRoot":"","sources":["../src/parserBackend.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,WAAW,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,oBAAoB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAC9C,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,GAAG;QAC3B,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC;QAC3E,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,gBAAgB,CAAC;KAC/E,CAAC;IACF,IAAI,IAAI,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AASD,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzE;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAE1E;AAED,wBAAgB,sBAAsB,IAAI;IACxC,UAAU,EAAE,cAAc,CAAC;IAC3B,GAAG,EAAE,cAAc,CAAC;CACrB,CAKA;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,gBAAgB,CAE9F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAE1E;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,gBAAgB,GACvB,UAAU,EAAE,CAEd"}

package/dist/parserBackend.js

@@ -0,0 +1,33 @@
+const NON_NATIVE_PARSER_UNAVAILABLE_PREFIX = "Non-native Tree-sitter parser is unavailable";
+const NON_NATIVE_PARSER_UNAVAILABLE_SUFFIX = "native parser is the only grammar backend";
+function createUnavailableError(feature) {
+    return new Error(`${NON_NATIVE_PARSER_UNAVAILABLE_PREFIX} for ${feature}; ${NON_NATIVE_PARSER_UNAVAILABLE_SUFFIX}`);
+}
+export function __resetParserBackendModuleForTests() {
+    // Kept for tests that reset parser backends between cases.
+}
+export function isNonNativeParserAvailable() {
+    return false;
+}
+export function isNonNativeParserUnavailableError(error) {
+    return error instanceof Error && error.message.includes(NON_NATIVE_PARSER_UNAVAILABLE_PREFIX);
+}
+export function loadTreeSitterLanguage(packageName) {
+    return { name: packageName };
+}
+export function loadTypeScriptGrammars() {
+    return {
+        typescript: { name: "tree-sitter-typescript/typescript" },
+        tsx: { name: "tree-sitter-typescript/tsx" },
+    };
+}
+export function parseWithLanguage(_source, _language) {
+    throw createUnavailableError("syntax-tree parsing");
+}
+export function isParserSyntaxTree(tree) {
+    return typeof tree === "object" && tree !== null && "rootNode" in tree && "walk" in tree;
+}
+export function executeQueryAsNativeMatches(_source, _language, _queryText, _tree) {
+    throw createUnavailableError("query execution");
+}
+//# sourceMappingURL=parserBackend.js.map

package/dist/parserBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parserBackend.js","sourceRoot":"","sources":["../src/parserBackend.ts"],"names":[],"mappings":"AAoDA,MAAM,oCAAoC,GAAG,8CAA8C,CAAC;AAC5F,MAAM,oCAAoC,GAAG,2CAA2C,CAAC;AAEzF,SAAS,sBAAsB,CAAC,OAAe;IAC7C,OAAO,IAAI,KAAK,CAAC,GAAG,oCAAoC,QAAQ,OAAO,KAAK,oCAAoC,EAAE,CAAC,CAAC;AACtH,CAAC;AAED,MAAM,UAAU,kCAAkC;IAChD,2DAA2D;AAC7D,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,KAAc;IAC9D,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,sBAAsB;IAIpC,OAAO;QACL,UAAU,EAAE,EAAE,IAAI,EAAE,mCAAmC,EAAE;QACzD,GAAG,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,SAAyB;IAC1E,MAAM,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,UAAU,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,OAAe,EACf,SAAyB,EACzB,UAAkB,EAClB,KAAwB;IAExB,MAAM,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;AAClD,CAAC"}

package/dist/presentation/bounds.d.ts

@@ -0,0 +1,34 @@
+export type BoundedList<T> = {
+    items: T[];
+    omitted: number;
+};
+export declare const REVIEW_DEFAULT_CANDIDATE_TEST_LIMIT = 50;
+export declare const REVIEW_SUMMARY_CHANGED_FILE_LIMIT = 20;
+export declare const REVIEW_SUMMARY_SYMBOLS_PER_FILE_LIMIT = 5;
+export declare const REVIEW_SUMMARY_CANDIDATES_PER_CONFIDENCE_LIMIT = 8;
+export declare const REVIEW_SUMMARY_TASK_LIMIT = 8;
+export declare const AGENT_SEARCH_RESULT_LIMIT = 100;
+export declare const AGENT_SEARCH_RANK_REASONS_PER_RESULT_LIMIT = 6;
+export declare const AGENT_SEARCH_EVIDENCE_PER_RESULT_LIMIT = 5;
+export declare const AGENT_SEARCH_NEIGHBORS_PER_RESULT_LIMIT = 12;
+export declare const AGENT_SEARCH_FOLLOWUPS_PER_RESULT_LIMIT = 8;
+export declare const AGENT_SEARCH_FORMAT_REASON_LIMIT = 3;
+export declare const AGENT_EXPLAIN_DEFAULT_DEPENDENCY_LIMIT = 20;
+export declare const AGENT_EXPLAIN_DEFAULT_SNIPPET_LIMIT = 8;
+export declare const AGENT_EXPLAIN_DEFAULT_SYMBOL_LIMIT = 50;
+export declare const AGENT_EXPLAIN_DEFAULT_DUPLICATE_LIMIT = 5;
+export declare const AGENT_EXPLAIN_MAX_DEPENDENCY_LIMIT = 100;
+export declare const AGENT_EXPLAIN_MAX_SNIPPET_LIMIT = 50;
+export declare const AGENT_EXPLAIN_MAX_SYMBOL_LIMIT = 200;
+export declare const AGENT_EXPLAIN_MAX_DUPLICATE_LIMIT = 20;
+export declare const AGENT_EXPLAIN_FORMAT_SYMBOL_LIMIT = 8;
+export declare const AGENT_EXPLAIN_FORMAT_FOLLOWUP_LIMIT = 8;
+export declare const AGENT_EXPLAIN_FILE_SYMBOL_REF_LIMIT = 5;
+export declare const AGENT_EXPLAIN_CHANGED_FILE_LIMIT = 20;
+export declare const AGENT_EXPLAIN_REVIEW_TASK_LIMIT = 5;
+export declare const AGENT_EXPLAIN_CANDIDATE_TEST_LIMIT = 10;
+export declare const AGENT_EXPLAIN_REVIEW_CONTEXT_CANDIDATE_LIMIT = 5;
+export declare function boundList<T>(items: readonly T[], limit: number): BoundedList<T>;
+export declare function emptyBoundedList<T>(): BoundedList<T>;
+export declare function countOmitted(total: number, visible: number): number;
+//# sourceMappingURL=bounds.d.ts.map

package/dist/presentation/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../src/presentation/bounds.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,mCAAmC,KAAK,CAAC;AACtD,eAAO,MAAM,iCAAiC,KAAK,CAAC;AACpD,eAAO,MAAM,qCAAqC,IAAI,CAAC;AACvD,eAAO,MAAM,8CAA8C,IAAI,CAAC;AAChE,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,0CAA0C,IAAI,CAAC;AAC5D,eAAO,MAAM,sCAAsC,IAAI,CAAC;AACxD,eAAO,MAAM,uCAAuC,KAAK,CAAC;AAC1D,eAAO,MAAM,uCAAuC,IAAI,CAAC;AACzD,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,eAAO,MAAM,sCAAsC,KAAK,CAAC;AACzD,eAAO,MAAM,mCAAmC,IAAI,CAAC;AACrD,eAAO,MAAM,kCAAkC,KAAK,CAAC;AACrD,eAAO,MAAM,qCAAqC,IAAI,CAAC;AACvD,eAAO,MAAM,kCAAkC,MAAM,CAAC;AACtD,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,iCAAiC,KAAK,CAAC;AACpD,eAAO,MAAM,iCAAiC,IAAI,CAAC;AACnD,eAAO,MAAM,mCAAmC,IAAI,CAAC;AACrD,eAAO,MAAM,mCAAmC,IAAI,CAAC;AACrD,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,eAAO,MAAM,kCAAkC,KAAK,CAAC;AACrD,eAAO,MAAM,4CAA4C,IAAI,CAAC;AAE9D,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAM/E;AAED,wBAAgB,gBAAgB,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAKpD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/presentation/bounds.js

@@ -0,0 +1,43 @@
+export const REVIEW_DEFAULT_CANDIDATE_TEST_LIMIT = 50;
+export const REVIEW_SUMMARY_CHANGED_FILE_LIMIT = 20;
+export const REVIEW_SUMMARY_SYMBOLS_PER_FILE_LIMIT = 5;
+export const REVIEW_SUMMARY_CANDIDATES_PER_CONFIDENCE_LIMIT = 8;
+export const REVIEW_SUMMARY_TASK_LIMIT = 8;
+export const AGENT_SEARCH_RESULT_LIMIT = 100;
+export const AGENT_SEARCH_RANK_REASONS_PER_RESULT_LIMIT = 6;
+export const AGENT_SEARCH_EVIDENCE_PER_RESULT_LIMIT = 5;
+export const AGENT_SEARCH_NEIGHBORS_PER_RESULT_LIMIT = 12;
+export const AGENT_SEARCH_FOLLOWUPS_PER_RESULT_LIMIT = 8;
+export const AGENT_SEARCH_FORMAT_REASON_LIMIT = 3;
+export const AGENT_EXPLAIN_DEFAULT_DEPENDENCY_LIMIT = 20;
+export const AGENT_EXPLAIN_DEFAULT_SNIPPET_LIMIT = 8;
+export const AGENT_EXPLAIN_DEFAULT_SYMBOL_LIMIT = 50;
+export const AGENT_EXPLAIN_DEFAULT_DUPLICATE_LIMIT = 5;
+export const AGENT_EXPLAIN_MAX_DEPENDENCY_LIMIT = 100;
+export const AGENT_EXPLAIN_MAX_SNIPPET_LIMIT = 50;
+export const AGENT_EXPLAIN_MAX_SYMBOL_LIMIT = 200;
+export const AGENT_EXPLAIN_MAX_DUPLICATE_LIMIT = 20;
+export const AGENT_EXPLAIN_FORMAT_SYMBOL_LIMIT = 8;
+export const AGENT_EXPLAIN_FORMAT_FOLLOWUP_LIMIT = 8;
+export const AGENT_EXPLAIN_FILE_SYMBOL_REF_LIMIT = 5;
+export const AGENT_EXPLAIN_CHANGED_FILE_LIMIT = 20;
+export const AGENT_EXPLAIN_REVIEW_TASK_LIMIT = 5;
+export const AGENT_EXPLAIN_CANDIDATE_TEST_LIMIT = 10;
+export const AGENT_EXPLAIN_REVIEW_CONTEXT_CANDIDATE_LIMIT = 5;
+export function boundList(items, limit) {
+    const boundedItems = items.slice(0, limit);
+    return {
+        items: boundedItems,
+        omitted: countOmitted(items.length, boundedItems.length),
+    };
+}
+export function emptyBoundedList() {
+    return {
+        items: [],
+        omitted: 0,
+    };
+}
+export function countOmitted(total, visible) {
+    return Math.max(0, total - visible);
+}
+//# sourceMappingURL=bounds.js.map

package/dist/presentation/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../../src/presentation/bounds.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,mCAAmC,GAAG,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AACpD,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,8CAA8C,GAAG,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,MAAM,CAAC,MAAM,0CAA0C,GAAG,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,uCAAuC,GAAG,EAAE,CAAC;AAC1D,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,CAAC;AACzD,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,kCAAkC,GAAG,EAAE,CAAC;AACrD,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,kCAAkC,GAAG,GAAG,CAAC;AACtD,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAClD,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAClD,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AACpD,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,CAAC;AACnD,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,kCAAkC,GAAG,EAAE,CAAC;AACrD,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC,CAAC;AAE9D,MAAM,UAAU,SAAS,CAAI,KAAmB,EAAE,KAAa;IAC7D,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,CAAC;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAAe;IACzD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/presets.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Session preset helpers for common Codegraph workflows.
+ *
+ * These presets remain part of the library session API and preconfigure
+ * build options plus timeout and incremental defaults for:
+ * - code-review
+ * - ci-fast
+ * - development
+ * - production
+ */
+import { type BuildOptions } from "./indexer/types.js";
+export type PresetName = "code-review" | "ci-fast" | "development" | "production";
+export type SessionPresetOptions = {
+    buildOptions?: BuildOptions;
+    timeout?: number;
+    incremental?: boolean;
+};
+/**
+ * Session presets
+ */
+export declare const SESSION_PRESETS: Record<PresetName, SessionPresetOptions>;
+/**
+ * Get session options for a preset
+ */
+export declare function getSessionPreset(preset: PresetName, root: string): SessionPresetOptions & {
+    root: string;
+};
+/**
+ * Merge preset with custom options
+ */
+export declare function mergePreset<T extends Record<string, unknown>>(preset: T, custom?: Partial<T>): T;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC;AAElF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAoDF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,oBAAoB,CAwBpE,CAAC;AAUF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAS1G;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAoBhG"}

package/dist/presets.js

@@ -0,0 +1,127 @@
+/**
+ * Session preset helpers for common Codegraph workflows.
+ *
+ * These presets remain part of the library session API and preconfigure
+ * build options plus timeout and incremental defaults for:
+ * - code-review
+ * - ci-fast
+ * - development
+ * - production
+ */
+import {} from "./indexer/types.js";
+import { isPlainRecord } from "./util/guards.js";
+/**
+ * Internal build option presets used by the public session presets.
+ */
+const SESSION_BUILD_PRESETS = {
+    "code-review": {
+        cache: "disk",
+        cacheStrict: true,
+        useBloomFilters: true,
+        threads: 8,
+        graph: {
+            fast: false,
+            resolveNodeModules: false,
+        },
+    },
+    "ci-fast": {
+        cache: "memory",
+        cacheStrict: false,
+        useBloomFilters: true,
+        threads: 4,
+        graph: {
+            fast: true,
+            resolveNodeModules: false,
+        },
+    },
+    development: {
+        cache: "memory",
+        cacheStrict: false,
+        useBloomFilters: true,
+        threads: 8,
+        graph: {
+            fast: false,
+            resolveNodeModules: false,
+        },
+    },
+    production: {
+        cache: "disk",
+        cacheStrict: true,
+        useBloomFilters: true,
+        threads: 16,
+        graph: {
+            fast: false,
+            resolveNodeModules: false,
+            dynamicImportHeuristics: false,
+        },
+    },
+};
+/**
+ * Session presets
+ */
+export const SESSION_PRESETS = {
+    "code-review": {
+        buildOptions: SESSION_BUILD_PRESETS["code-review"],
+        timeout: 30 * 60 * 1000,
+        incremental: true,
+    },
+    "ci-fast": {
+        buildOptions: SESSION_BUILD_PRESETS["ci-fast"],
+        timeout: 10 * 60 * 1000,
+        incremental: false,
+    },
+    development: {
+        buildOptions: SESSION_BUILD_PRESETS["development"],
+        timeout: 60 * 60 * 1000,
+        incremental: true,
+    },
+    production: {
+        buildOptions: SESSION_BUILD_PRESETS["production"],
+        timeout: 2 * 60 * 60 * 1000,
+        incremental: true,
+    },
+};
+function cloneBuildOptions(options) {
+    if (!options)
+        return undefined;
+    return {
+        ...options,
+        ...(options.graph ? { graph: { ...options.graph } } : {}),
+    };
+}
+/**
+ * Get session options for a preset
+ */
+export function getSessionPreset(preset, root) {
+    const sessionPreset = SESSION_PRESETS[preset];
+    const buildOptions = cloneBuildOptions(sessionPreset.buildOptions);
+    return {
+        root,
+        ...(sessionPreset.timeout !== undefined ? { timeout: sessionPreset.timeout } : {}),
+        ...(sessionPreset.incremental !== undefined ? { incremental: sessionPreset.incremental } : {}),
+        ...(buildOptions ? { buildOptions } : {}),
+    };
+}
+/**
+ * Merge preset with custom options
+ */
+export function mergePreset(preset, custom) {
+    if (!custom)
+        return preset;
+    const merged = { ...preset };
+    const presetRecord = preset;
+    for (const key of Object.keys(custom)) {
+        const customValue = custom[key];
+        const presetValue = presetRecord[key];
+        if (customValue === undefined)
+            continue;
+        if (isPlainRecord(customValue) && isPlainRecord(presetValue)) {
+            merged[key] = { ...presetValue, ...customValue };
+        }
+        else {
+            merged[key] = customValue;
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

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

package/dist/query/parser.d.ts

@@ -0,0 +1,33 @@
+import { type SymbolNodeKind } from "../graphs/symbol-graph.js";
+export type SymbolQuery = {
+    text?: string;
+    nameIncludes?: string;
+    fileIncludes?: string;
+    docstringIncludes?: string;
+    kinds?: SymbolNodeKind[];
+};
+export type GraphQuery = {
+    kind: "mostCalledMethods";
+    limit: number;
+} | {
+    kind: "dependencyChain";
+    className: string;
+} | {
+    kind: "controllersMostEndpoints";
+    limit: number;
+} | {
+    kind: "classesImplementing";
+    interfaceName: string;
+} | {
+    kind: "affectedFunctionsForModule";
+    modulePath: string;
+} | {
+    kind: "highestComplexityClasses";
+    limit: number;
+} | {
+    kind: "highestComplexityFunctions";
+    limit: number;
+};
+export declare function parseSymbolQuery(input: string): SymbolQuery;
+export declare function parseGraphQuery(input: string): GraphQuery | null;
+//# sourceMappingURL=parser.d.ts.map

package/dist/query/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/query/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAQ1D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAwC3D;AAeD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA0ChE"}

package/dist/query/parser.js

@@ -0,0 +1,104 @@
+import {} from "../graphs/symbol-graph.js";
+const tokenize = (input) => input.match(/[^\s"]+:"[^"]+"|"[^"]+"|\S+/g)?.map((token) => token.trim()) ?? [];
+const normalizeToken = (token) => token.startsWith('"') && token.endsWith('"') ? token.slice(1, -1) : token;
+export function parseSymbolQuery(input) {
+    const query = {};
+    const residual = [];
+    for (const raw of tokenize(input)) {
+        const token = normalizeToken(raw);
+        const idx = token.indexOf(":");
+        if (idx <= 0) {
+            if (token)
+                residual.push(token);
+            continue;
+        }
+        const key = token.slice(0, idx).toLowerCase();
+        let value = token.slice(idx + 1);
+        if (value.startsWith('"') && value.endsWith('"')) {
+            value = value.slice(1, -1);
+        }
+        if (!value)
+            continue;
+        if (key === "kind" || key === "kinds") {
+            const kinds = value
+                .split(",")
+                .map((k) => k.trim())
+                .filter(Boolean);
+            if (kinds.length)
+                query.kinds = kinds;
+            continue;
+        }
+        if (key === "name") {
+            query.nameIncludes = value;
+            continue;
+        }
+        if (key === "file") {
+            query.fileIncludes = value;
+            continue;
+        }
+        if (key === "doc" || key === "docstring") {
+            query.docstringIncludes = value;
+            continue;
+        }
+        residual.push(token);
+    }
+    if (residual.length)
+        query.text = residual.join(" ");
+    return query;
+}
+const normalizePhrase = (value) => value
+    .trim()
+    .replace(/^["']|["']$/g, "")
+    .replace(/^the\s+/i, "");
+const parseLimit = (input, fallback) => {
+    const match = /(?:top|most)\s+(\d+)/i.exec(input);
+    if (!match)
+        return fallback;
+    const limit = Number(match[1]);
+    return Number.isFinite(limit) && limit > 0 ? limit : fallback;
+};
+export function parseGraphQuery(input) {
+    const text = input.trim();
+    const lower = text.toLowerCase();
+    if (lower.includes("most called methods")) {
+        return { kind: "mostCalledMethods", limit: parseLimit(text, 10) };
+    }
+    if (lower.includes("dependency chain")) {
+        const match = /dependency chain for (.+?) class/i.exec(text);
+        if (!match)
+            return null;
+        return {
+            kind: "dependencyChain",
+            className: normalizePhrase(match[1] ?? ""),
+        };
+    }
+    if (lower.includes("controllers have the most endpoints")) {
+        return { kind: "controllersMostEndpoints", limit: parseLimit(text, 10) };
+    }
+    if (lower.includes("implement") && lower.includes("interface")) {
+        const match = /implement(?:s)? (.+?) interface/i.exec(text);
+        if (!match)
+            return null;
+        return {
+            kind: "classesImplementing",
+            interfaceName: normalizePhrase(match[1] ?? ""),
+        };
+    }
+    if (lower.includes("affected") && lower.includes("module")) {
+        const match = /change (?:this )?module\s+["']?([^"']+)["']?/i.exec(text) ?? /module\s+["']?([^"']+)["']?/i.exec(text);
+        if (!match)
+            return null;
+        return {
+            kind: "affectedFunctionsForModule",
+            modulePath: normalizePhrase(match[1] ?? ""),
+        };
+    }
+    if (lower.includes("highest complexity") && lower.includes("function")) {
+        return { kind: "highestComplexityFunctions", limit: parseLimit(text, 10) };
+    }
+    if (lower.includes("highest complexity")) {
+        return { kind: "highestComplexityClasses", limit: parseLimit(text, 10) };
+    }
+    return null;
+}
+//# sourceMappingURL=parser.js.map

package/dist/query/parser.js.map

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

package/dist/query/symbols.d.ts

@@ -0,0 +1,15 @@
+import { type SymbolGraph, type SymbolNode, type SymbolEdge } from "../graphs/symbol-graph.js";
+import type { SymbolQuery } from "./parser.js";
+export declare function querySymbols(sg: SymbolGraph, query: SymbolQuery): SymbolNode[];
+export type NeighborQuery = {
+    symbolId: string;
+    direction?: "out" | "in" | "both";
+    maxDepth?: number;
+    edgeLabels?: string[];
+};
+export type NeighborResult = {
+    nodes: SymbolNode[];
+    edges: SymbolEdge[];
+};
+export declare function querySymbolNeighbors(sg: SymbolGraph, query: NeighborQuery): NeighborResult;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/query/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/query/symbols.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,UAAU,EAAE,CAa9E;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,cAAc,CAqD1F"}

package/dist/query/symbols.js

@@ -0,0 +1,78 @@
+import {} from "../graphs/symbol-graph.js";
+const includesFolded = (value, needle) => {
+    if (!value)
+        return false;
+    return value.toLowerCase().includes(needle.toLowerCase());
+};
+export function querySymbols(sg, query) {
+    const textNeedle = query.text?.trim();
+    return [...sg.nodes.values()].filter((node) => {
+        if (query.kinds && !query.kinds.includes(node.kind))
+            return false;
+        if (query.nameIncludes && !includesFolded(node.name, query.nameIncludes))
+            return false;
+        if (query.fileIncludes && !includesFolded(node.file, query.fileIncludes))
+            return false;
+        if (query.docstringIncludes && !includesFolded(node.docstring, query.docstringIncludes))
+            return false;
+        if (textNeedle) {
+            const haystack = [node.name, node.file, node.docstring].filter(Boolean).join(" ");
+            if (!includesFolded(haystack, textNeedle))
+                return false;
+        }
+        return true;
+    });
+}
+export function querySymbolNeighbors(sg, query) {
+    const direction = query.direction ?? "both";
+    const maxDepth = typeof query.maxDepth === "number" && query.maxDepth >= 0 ? query.maxDepth : 1;
+    const labelFilter = query.edgeLabels?.length ? new Set(query.edgeLabels) : null;
+    const outgoing = new Map();
+    const incoming = new Map();
+    for (const edge of sg.edges) {
+        if (labelFilter && (!edge.label || !labelFilter.has(edge.label)))
+            continue;
+        const outList = outgoing.get(edge.from) ?? [];
+        outList.push(edge);
+        outgoing.set(edge.from, outList);
+        const inList = incoming.get(edge.to) ?? [];
+        inList.push(edge);
+        incoming.set(edge.to, inList);
+    }
+    const visited = new Set();
+    const frontier = [{ id: query.symbolId, depth: 0 }];
+    visited.add(query.symbolId);
+    const edgeSet = new Set();
+    let frontierIndex = 0;
+    while (frontierIndex < frontier.length) {
+        const current = frontier[frontierIndex++];
+        if (!current || current.depth >= maxDepth)
+            continue;
+        const expandOut = direction === "out" || direction === "both";
+        const expandIn = direction === "in" || direction === "both";
+        if (expandOut) {
+            for (const edge of outgoing.get(current.id) ?? []) {
+                const key = `${edge.from}->${edge.to}::${edge.label ?? ""}`;
+                edgeSet.add(key);
+                if (!visited.has(edge.to)) {
+                    visited.add(edge.to);
+                    frontier.push({ id: edge.to, depth: current.depth + 1 });
+                }
+            }
+        }
+        if (expandIn) {
+            for (const edge of incoming.get(current.id) ?? []) {
+                const key = `${edge.from}->${edge.to}::${edge.label ?? ""}`;
+                edgeSet.add(key);
+                if (!visited.has(edge.from)) {
+                    visited.add(edge.from);
+                    frontier.push({ id: edge.from, depth: current.depth + 1 });
+                }
+            }
+        }
+    }
+    const edges = sg.edges.filter((edge) => edgeSet.has(`${edge.from}->${edge.to}::${edge.label ?? ""}`));
+    const nodes = [...visited].map((id) => sg.nodes.get(id)).filter((node) => !!node);
+    return { nodes, edges };
+}
+//# sourceMappingURL=symbols.js.map

package/dist/query/symbols.js.map

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

package/dist/query.d.ts

@@ -0,0 +1,3 @@
+export { parseGraphQuery, parseSymbolQuery, type GraphQuery, type SymbolQuery } from "./query/parser.js";
+export { querySymbolNeighbors, querySymbols, type NeighborQuery, type NeighborResult } from "./query/symbols.js";
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/query.js

@@ -0,0 +1,3 @@
+export { parseGraphQuery, parseSymbolQuery } from "./query/parser.js";
+export { querySymbolNeighbors, querySymbols } from "./query/symbols.js";
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAqC,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAA2C,MAAM,oBAAoB,CAAC"}