@zvec/zvec-grep 0.1.2 → 0.1.3

package/dist/engine/service/root.js

@@ -3,8 +3,8 @@ import { dirname, join, resolve } from "node:path";
 export const ZVEC_GREP_DIR = ".zvec-grep";
 export const ANONYMOUS_COLLECTION_NAME = "__anonymous__";
 export const ANONYMOUS_COLLECTION_DIR = "index";
-const REGISTRY_FILE = "registry.json";
-const COLLECTION_FILE = "collection.json";
+const COLLECTIONS_ZVEC = "collections.zvec";
+const ENTITIES_ZVEC = "index.zvec";
 export function resolveZvecGrepRoot(root) {
     return resolve(root ?? process.cwd());
 }
@@ -24,10 +24,16 @@ export function anonymousIndexLocation(root) {
     };
 }
 export function findNearestAnonymousIndex(start) {
+    return findNearestAnonymousLocation(start, hasAnonymousIndex);
+}
+export function findNearestAnonymousWorkspace(start) {
+    return findNearestAnonymousLocation(start, hasAnonymousMetadata);
+}
+function findNearestAnonymousLocation(start, predicate) {
     let current = resolve(start);
     while (true) {
         const location = anonymousIndexLocation(current);
-        if (hasAnonymousIndex(location)) {
+        if (predicate(location)) {
             return location;
         }
         const parent = dirname(current);
@@ -37,8 +43,11 @@ export function findNearestAnonymousIndex(start) {
         current = parent;
     }
 }
+export function hasAnonymousMetadata(location) {
+    return existsSync(join(location.home, COLLECTIONS_ZVEC));
+}
 export function hasAnonymousIndex(location) {
-    return existsSync(join(location.home, REGISTRY_FILE))
-        && existsSync(join(location.collectionPath, COLLECTION_FILE));
+    return existsSync(join(location.home, COLLECTIONS_ZVEC))
+        && existsSync(join(location.collectionPath, ENTITIES_ZVEC));
 }
 //# sourceMappingURL=root.js.map

package/dist/engine/service/root.js.map

@@ -1 +1 @@
-{"version":3,"file":"root.js","sourceRoot":"","sources":["../../../src/engine/service/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGnD,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAGhD,MAAM,aAAa,GAAG,eAAe,CAAC;AACtC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAW1C,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,OAAO,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACxC,CAAC;AAGD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC;AAGD,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC;AAC7D,CAAC;AAGD,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC;QACjC,cAAc,EAAE,yBAAyB;QACzC,cAAc,EAAE,uBAAuB,CAAC,YAAY,CAAC;KACtD,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAAC,QAAgC;IAChE,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;WAChD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../../src/engine/service/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGnD,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAGhD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAC5C,MAAM,aAAa,GAAG,YAAY,CAAC;AAWnC,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,OAAO,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACxC,CAAC;AAGD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC;AAGD,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC;AAC7D,CAAC;AAGD,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC;QACjC,cAAc,EAAE,yBAAyB;QACzC,cAAc,EAAE,uBAAuB,CAAC,YAAY,CAAC;KACtD,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO,4BAA4B,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;AAChE,CAAC;AAGD,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,OAAO,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;AACnE,CAAC;AAGD,SAAS,4BAA4B,CACnC,KAAa,EACb,SAAwD;IAExD,IAAI,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,oBAAoB,CAAC,QAAgC;IACnE,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAC3D,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAAC,QAAgC;IAChE,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;WACnD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/engine/service/structure-enrichment.d.ts

@@ -0,0 +1,8 @@
+import type { ZvecGrepStructureEnrichmentDiagnostics, ZvecGrepContextItem } from "./types.js";
+export declare const RG_STRUCTURE_ENRICH_FILE_LIMIT = 100;
+type StructureEnrichmentResult = {
+    items: ZvecGrepContextItem[];
+    diagnostics: ZvecGrepStructureEnrichmentDiagnostics;
+};
+export declare function enrichLexicalItemsWithStructure(root: string, items: readonly ZvecGrepContextItem[], fileLimit?: number): Promise<StructureEnrichmentResult>;
+export {};

package/dist/engine/service/structure-enrichment.js

@@ -0,0 +1,174 @@
+import { readFile, stat } from "node:fs/promises";
+import { relative } from "node:path";
+import { CodeExtractor } from "../extraction/code/extractor.js";
+import { MarkdownExtractor } from "../extraction/markdown/extractor.js";
+import { detectFileType } from "../files/file-type.js";
+import { normalizePath, toDisplayPath } from "../utils/path.js";
+import { sha256Text } from "../utils/hash.js";
+export const RG_STRUCTURE_ENRICH_FILE_LIMIT = 100;
+const STRUCTURE_ENRICH_COLLECTION_ID = "__rg_structure__";
+const STRUCTURE_ENRICH_MAX_FILE_SIZE_BYTES = 1 * 1024 * 1024;
+export async function enrichLexicalItemsWithStructure(root, items, fileLimit = RG_STRUCTURE_ENRICH_FILE_LIMIT) {
+    const matchedFiles = uniqueLexicalFilePaths(items);
+    const selectedFiles = new Set(matchedFiles.slice(0, fileLimit));
+    const fragmentsByFile = new Map();
+    const extractors = [
+        new CodeExtractor(),
+        new MarkdownExtractor(),
+    ];
+    let parsedFiles = 0;
+    for (const absolutePath of selectedFiles) {
+        const fragments = await parseStructuralFragments(root, absolutePath, extractors);
+        fragmentsByFile.set(absolutePath, fragments);
+        if (fragments !== null) {
+            parsedFiles++;
+        }
+    }
+    let enrichedItems = 0;
+    const enrichedFiles = new Set();
+    const enriched = items.map((item) => {
+        if (item.kind !== "lexical_match") {
+            return item;
+        }
+        const fragments = fragmentsByFile.get(normalizePath(item.file.absolutePath));
+        if (!fragments || fragments.length === 0) {
+            return item;
+        }
+        const matchRange = lexicalMatchRange(item);
+        if (!matchRange) {
+            return item;
+        }
+        const container = smallestContainingFragment(fragments, matchRange);
+        if (!container) {
+            return item;
+        }
+        enrichedItems++;
+        enrichedFiles.add(item.file.absolutePath);
+        const contextContainer = {
+            entityId: container.group ?? container.id,
+            range: container.range,
+            metadata: container.metadata,
+        };
+        return {
+            ...item,
+            metadata: container.metadata ?? item.metadata,
+            container: contextContainer,
+        };
+    });
+    return {
+        items: enriched,
+        diagnostics: {
+            source: "structural_extraction",
+            fileLimit,
+            matchedFiles: matchedFiles.length,
+            parsedFiles,
+            enrichedFiles: enrichedFiles.size,
+            enrichedItems,
+            skippedFiles: Math.max(0, matchedFiles.length - parsedFiles),
+            truncated: matchedFiles.length > fileLimit,
+        },
+    };
+}
+function uniqueLexicalFilePaths(items) {
+    const seen = new Set();
+    const paths = [];
+    for (const item of items) {
+        if (item.kind !== "lexical_match") {
+            continue;
+        }
+        const absolutePath = normalizePath(item.file.absolutePath);
+        if (!seen.has(absolutePath)) {
+            seen.add(absolutePath);
+            paths.push(absolutePath);
+        }
+    }
+    return paths;
+}
+async function parseStructuralFragments(root, absolutePath, extractors) {
+    try {
+        const file = await fileInfoForStructure(root, absolutePath);
+        if (!file) {
+            return null;
+        }
+        const text = await readFile(absolutePath, "utf8");
+        const source = {
+            kind: "text",
+            file,
+            text,
+        };
+        const extractor = extractors.find((candidate) => candidate.supports(source));
+        return extractor ? await extractor.extract(source) : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function fileInfoForStructure(root, absolutePath) {
+    const info = await stat(absolutePath).catch(() => null);
+    if (!info || !info.isFile() || info.size <= 0 || info.size > STRUCTURE_ENRICH_MAX_FILE_SIZE_BYTES) {
+        return null;
+    }
+    const detected = detectFileType(absolutePath);
+    if (!detected || !isStructurallyEnrichableFile(detected)) {
+        return null;
+    }
+    return {
+        id: makeStructureFileId(absolutePath),
+        collectionId: STRUCTURE_ENRICH_COLLECTION_ID,
+        absolutePath: normalizePath(absolutePath),
+        relativePath: toDisplayPath(relative(root, absolutePath) || "."),
+        rootPath: root,
+        sizeBytes: info.size,
+        lastModifiedTime: info.mtimeMs,
+        kind: detected.kind,
+        format: detected.format,
+    };
+}
+function isStructurallyEnrichableFile(file) {
+    return file.kind === "code"
+        || (file.kind === "text" && file.format === "markdown");
+}
+function lexicalMatchRange(item) {
+    const range = item.excerptRange ?? item.range;
+    return range.kind === "text" ? range : null;
+}
+function smallestContainingFragment(fragments, matchRange) {
+    let best = null;
+    for (const fragment of fragments) {
+        if (!textRangeContains(fragment.range, matchRange)) {
+            continue;
+        }
+        if (!best || compareFragmentContainer(fragment, best) < 0) {
+            best = fragment;
+        }
+    }
+    return best;
+}
+function textRangeContains(outer, inner) {
+    return outer.kind === "text"
+        && outer.startLine <= inner.startLine
+        && outer.endLine >= inner.endLine;
+}
+function compareFragmentContainer(left, right) {
+    const leftRange = left.range;
+    const rightRange = right.range;
+    const leftLines = leftRange.kind === "text" ? leftRange.endLine - leftRange.startLine : Number.MAX_SAFE_INTEGER;
+    const rightLines = rightRange.kind === "text" ? rightRange.endLine - rightRange.startLine : Number.MAX_SAFE_INTEGER;
+    return leftLines - rightLines
+        || fragmentSpecificityScore(right) - fragmentSpecificityScore(left)
+        || left.id.localeCompare(right.id);
+}
+function fragmentSpecificityScore(fragment) {
+    const metadata = fragment.metadata;
+    if (!metadata) {
+        return 0;
+    }
+    if (metadata.kind === "code") {
+        return metadata.symbolName ? 2 : 1;
+    }
+    return metadata.heading ? 1 : 0;
+}
+function makeStructureFileId(absolutePath) {
+    return sha256Text(`${STRUCTURE_ENRICH_COLLECTION_ID}\0${normalizePath(absolutePath)}`);
+}
+//# sourceMappingURL=structure-enrichment.js.map

package/dist/engine/service/structure-enrichment.js.map

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

package/dist/engine/service/types.d.ts

@@ -1,5 +1,5 @@
 import type { EmbeddingModel } from "../models/embeddings.js";
-import type { CodeSymbolType, CollectionIndexStatus, CollectionInfo, Content, EntityMetadata, IndexProgress, IndexResult, Range, RootPath, SearchPlanRoute, SearchHitTrace, SearchMatchedBy } from "../types.js";
+import type { CodeSymbolType, CollectionIndexPolicy, CollectionIndexStatus, CollectionInfo, Content, EntityMetadata, IndexProgress, IndexResult, Range, RootPath, SearchPlanRoute, SearchHitTrace, SearchMatchedBy, TimingEntry } from "../types.js";
 export type CreateZvecGrepOptions = {
     root?: string;
     home?: string;
@@ -12,7 +12,7 @@ export type CreateZvecGrepOptions = {
     embeddingParallelism?: number;
     defaultEmbedding?: boolean;
 };
-export type ZvecGrepInitOptions = {
+export type ZvecGrepIndexOptions = {
     root?: string;
     rootPaths?: readonly (string | RootPath)[];
     rebuild?: boolean;
@@ -27,10 +27,11 @@ export type ZvecGrepInfoOptions = {
 };
 export type ZvecGrepInfoResult = {
     root: string;
-    initialized: boolean;
+    indexed: boolean;
+    indexPolicy: CollectionIndexPolicy | "undecided";
     home: string;
     indexPath: string;
-    source: "index" | "uninitialized";
+    source: "index" | "unindexed";
     collection?: CollectionInfo;
     status?: CollectionIndexStatus | null;
     suggestion?: string;
@@ -77,6 +78,11 @@ export type ZvecGrepContextFile = {
     rootPath?: string;
 };
 export type ZvecGrepContextItemKind = "indexed_entity" | "lexical_match";
+export type ZvecGrepContextContainer = {
+    entityId: string;
+    range: Range;
+    metadata?: EntityMetadata;
+};
 export type ZvecGrepContextItem = {
     kind: ZvecGrepContextItemKind;
     rank: number;
@@ -91,6 +97,7 @@ export type ZvecGrepContextItem = {
     matchedBy: SearchMatchedBy | "lexical";
     metadata?: EntityMetadata;
     entityId?: string;
+    container?: ZvecGrepContextContainer;
     trace?: SearchHitTrace;
 };
 export type ZvecGrepContextCollection = {
@@ -109,6 +116,16 @@ export type ZvecGrepLexicalFallbackDiagnostics = {
     limit?: number;
     truncated: boolean;
 };
+export type ZvecGrepStructureEnrichmentDiagnostics = {
+    source: "structural_extraction";
+    fileLimit: number;
+    matchedFiles: number;
+    parsedFiles: number;
+    enrichedFiles: number;
+    enrichedItems: number;
+    skippedFiles: number;
+    truncated: boolean;
+};
 export type ZvecGrepIndexDiagnostics = {
     hitsReturned: number;
     routes: readonly {
@@ -121,6 +138,8 @@ export type ZvecGrepContextDiagnostics = {
     emptyReason?: "no_matches" | "no_searchable_files" | "index_unavailable" | "search_failed";
     index?: ZvecGrepIndexDiagnostics;
     fallback?: ZvecGrepLexicalFallbackDiagnostics;
+    structure?: ZvecGrepStructureEnrichmentDiagnostics;
+    timings?: readonly TimingEntry[];
 };
 export type ZvecGrepContextResult = {
     query: string;
@@ -149,7 +168,8 @@ export type ZvecGrepCollections = {
 export type ZvecGrep = {
     readonly root: string;
     readonly collections: ZvecGrepCollections;
-    init(options?: ZvecGrepInitOptions): Promise<IndexResult>;
+    index(options?: ZvecGrepIndexOptions): Promise<IndexResult>;
+    disableIndex(options?: ZvecGrepInfoOptions): Promise<ZvecGrepInfoResult>;
     info(options?: ZvecGrepInfoOptions): Promise<ZvecGrepInfoResult>;
     context(options: ZvecGrepContextOptions): Promise<ZvecGrepContextResult>;
     close(): Promise<void>;