Interface HnswPersistedMeta

Public legacy v1 metadata shape retained for source compatibility. Current production persistence writes an internal v4 immutable-generation pointer; an on-disk v1 fixed-bin record is explicitly rebuilt on first load.

Historical v1 records were stored at <file>.meta.json next to <file>.bin. Consumers may continue using this exported type, but it is not the internal v4 disk-write authority.

interface HnswPersistedMeta {
    dim: number;
    formatVersion: 1;
    rowsByLabel: Record<
        string,
        {
            chunk_index: number;
            kind: "md"
            | "pdf";
            line_end: number;
            line_start: number;
            rel_path: string;
            text_preview: string;
        },
    >;
    signature: string;
    size: number;
    writtenAt: string;
}

Index

Properties

dim formatVersion rowsByLabel signature size writtenAt

Properties

dim

dim: number

Embedder dim — must match the corpus the index will be queried with.

formatVersion

formatVersion: 1

rowsByLabel

rowsByLabel: Record<
    string,
    {
        chunk_index: number;
        kind: "md"
        | "pdf";
        line_end: number;
        line_start: number;
        rel_path: string;
        text_preview: string;
    },
>

Row label → source-row snapshot retained for persistence diagnostics and watcher graph maintenance. Search output must rehydrate labels through EmbedDb.getSearchRowsByIds(); this sidecar preview is never an egress authority. JSON-friendly and deliberately receipt-free for format v1.

signature

signature: string

Embed-db signature at write time — when this differs from the current embed-db's signature, the persisted index is stale and should be rebuilt. The database signature binds current receipt-backed rowcount, exact live labels, dimension, model, quantization, schema, source receipts, row metadata, raw vector bytes, and quarantine markers.

size

size: number

Vector count at write time.

writtenAt

writtenAt: string

ISO timestamp of the write — informational.

Interface HnswPersistedMeta

Index

Properties

Properties

dim

formatVersion

rowsByLabel

signature

size

writtenAt

Settings

On This Page