Open source · AI & LLM

Embedding Metadata Auditor

Check embedding records for source identity, model version and expiry metadata.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

An offline, dependency-free checker for a JSON export of embedding metadata. It answers whether stored chunks still match the declared source digest and index contract, without loading a vector service or claiming that the underlying content is correct.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.

Run the checked-in example

node bin/embedding-metadata-auditor.mjs --input examples/compatible.json --now 2026-01-01T00:00:00.000Z
node bin/embedding-metadata-auditor.mjs --input examples/incompatible.json --now 2026-01-01T00:00:00.000Z
npm run check

Read the result

The first command exits 0, the second exits 1. Both print exactly one JSON report. Programmatic callers can import audit and TOOLID from src/index.mjs; inject now as an instant, Date, or clock function. The CLI defaults to its own clock, overridable with --now in canonical UTC millisecond format.

Scope

No embeddings are calculated, vectors validated, source files opened, index mutated, external account consulted, expiry renewed, or access authorization decided. This is an export consistency check, not a security grant or a claim about model behavior.