@neuralis/brain-core 0.1.0 → 0.2.1

package/dist/scripts/embeddingLockV3.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The embedding-lock OFFLINE upgrade to format v3 (`pnpm neuralis:upgrade`,
+ * app STOPPED). The runtime reads only v3 and refuses a v1/v2 lock naming the
+ * command; the conversion lives here and nowhere the runtime imports.
+ *
+ *  - v1 (dimension-only, one collection) ⇒ dense generation 1 with the base
+ *    recipe — every client's document request was the base one when v1 locks
+ *    were written; a missing `apiModelId`/`createdAt` keeps the v1 reader's ''.
+ *  - v2 ⇒ the same dense generation, recipe and collection.
+ *  - a missing `provider` is taken from the registry row of `modelId`; an
+ *    unknown model is refused rather than guessed.
+ *  - a recorded v2 rebuild gains `phase: 'copying'` — v2 recorded a rebuild
+ *    only once its shadow existed.
+ *
+ * `dryRun` writes nothing. `apply` is idempotent (a v3 lock is left as it is)
+ * and re-reads its own result through the runtime reader. The ledger
+ * begin/complete around `apply` is the operator command's.
+ */
+import type { OfflineUpgradeContext, OfflineUpgradePlan } from '@neuralis/package-system/data';
+declare const embeddingLockV3: {
+    id: string;
+    kinds: {
+        kind: "brain-core/embedding-lock";
+        to: 3;
+    }[];
+    dryRun(ctx: OfflineUpgradeContext): Promise<OfflineUpgradePlan>;
+    apply(ctx: OfflineUpgradeContext): Promise<void>;
+};
+export default embeddingLockV3;
+//# sourceMappingURL=embeddingLockV3.d.ts.map

package/dist/scripts/embeddingLockV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddingLockV3.d.ts","sourceRoot":"","sources":["../../scripts/embeddingLockV3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAwB,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AA+CrH,QAAA,MAAM,eAAe;;;;;;gBAGD,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC;eAWpD,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAQxB,CAAC;eAElB,eAAe"}

package/dist/scripts/embeddingLockV3.js

@@ -0,0 +1,100 @@
+/**
+ * The embedding-lock OFFLINE upgrade to format v3 (`pnpm neuralis:upgrade`,
+ * app STOPPED). The runtime reads only v3 and refuses a v1/v2 lock naming the
+ * command; the conversion lives here and nowhere the runtime imports.
+ *
+ *  - v1 (dimension-only, one collection) ⇒ dense generation 1 with the base
+ *    recipe — every client's document request was the base one when v1 locks
+ *    were written; a missing `apiModelId`/`createdAt` keeps the v1 reader's ''.
+ *  - v2 ⇒ the same dense generation, recipe and collection.
+ *  - a missing `provider` is taken from the registry row of `modelId`; an
+ *    unknown model is refused rather than guessed.
+ *  - a recorded v2 rebuild gains `phase: 'copying'` — v2 recorded a rebuild
+ *    only once its shadow existed.
+ *
+ * `dryRun` writes nothing. `apply` is idempotent (a v3 lock is left as it is)
+ * and re-reads its own result through the runtime reader. The ledger
+ * begin/complete around `apply` is the operator command's.
+ */
+import { readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { durableReplaceFile } from '@neuralis/package-system/data';
+import { EMBEDDING_LOCK_FORMAT } from '../src/store/dataFormats.js';
+import { EMBED_RECIPE_BASE, findEmbeddingModel } from '../src/embeddings/models.js';
+import { readLock } from '../src/embeddings/lock.js';
+function invalid(detail) {
+    return new Error(`EMBEDDING_LOCK_UPGRADE: ${detail}; the lock was not changed`);
+}
+async function convert(appRoot) {
+    const path = join(appRoot, 'config', 'embedding-lock.json');
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { path, from: null };
+        throw error;
+    }
+    const raw = JSON.parse(text);
+    if (raw.version === EMBEDDING_LOCK_FORMAT.version)
+        return { path, from: 3 };
+    if (raw.version !== 1 && raw.version !== 2)
+        throw invalid(`unknown version ${String(raw.version)}`);
+    const version = raw.version;
+    if (typeof raw.modelId !== 'string' || !raw.modelId)
+        throw invalid('modelId missing');
+    if (typeof raw.dimension !== 'number' || !Number.isInteger(raw.dimension) || raw.dimension <= 0)
+        throw invalid('dimension invalid');
+    if (typeof raw.collection !== 'string' || !raw.collection)
+        throw invalid('collection missing');
+    const generation = version === 1 ? 1 : raw.generation;
+    if (typeof generation !== 'number' || !Number.isInteger(generation) || generation < 1)
+        throw invalid('generation invalid');
+    const embedRecipe = version === 1 ? EMBED_RECIPE_BASE : raw.embedRecipe;
+    if (typeof embedRecipe !== 'string' || !embedRecipe)
+        throw invalid('embedRecipe missing');
+    const provider = typeof raw.provider === 'string' ? raw.provider : findEmbeddingModel(raw.modelId)?.provider;
+    if (!provider)
+        throw invalid(`provider of ${raw.modelId} unknown`);
+    const rebuild = raw.rebuild;
+    if (rebuild !== undefined && (typeof rebuild !== 'object' || rebuild === null || Array.isArray(rebuild)))
+        throw invalid('rebuild invalid');
+    const lock = {
+        version: 3, mode: 'dense', collection: raw.collection,
+        createdAt: typeof raw.createdAt === 'string' ? raw.createdAt : '',
+        generation, modelId: raw.modelId, provider: provider,
+        apiModelId: typeof raw.apiModelId === 'string' ? raw.apiModelId : '',
+        embedRecipe, dimension: raw.dimension,
+        ...(typeof raw.backfilledAt === 'string' ? { backfilledAt: raw.backfilledAt } : {}),
+        // The job resolver validates rebuild state; the upgrade only adds the v3 phase.
+        ...(rebuild ? { rebuild: { ...rebuild, phase: 'copying' } } : {}),
+    };
+    return { path, from: version, lock };
+}
+const embeddingLockV3 = {
+    id: 'embedding-lock-v3',
+    kinds: [{ kind: EMBEDDING_LOCK_FORMAT.kind, to: EMBEDDING_LOCK_FORMAT.version }],
+    async dryRun(ctx) {
+        const conversion = await convert(ctx.appRoot);
+        if (!('lock' in conversion)) {
+            return { files: [], summary: [conversion.from === null ? 'no embedding lock — nothing to convert' : 'embedding lock already v3'] };
+        }
+        const { lock } = conversion;
+        return {
+            files: [relative(ctx.home, conversion.path)],
+            summary: [`embedding lock v${conversion.from} → v3 (dense generation ${lock.generation}, collection ${lock.collection})`],
+        };
+    },
+    async apply(ctx) {
+        const conversion = await convert(ctx.appRoot);
+        if (!('lock' in conversion))
+            return;
+        await durableReplaceFile(conversion.path, JSON.stringify(conversion.lock, null, 2), { mode: 0o600 });
+        // The runtime reader is the oracle: what was written must read back as v3.
+        await readLock(ctx.appRoot);
+        ctx.log(`embedding lock v${conversion.from} → v3`);
+    },
+};
+export default embeddingLockV3;
+//# sourceMappingURL=embeddingLockV3.js.map

package/dist/scripts/embeddingLockV3.js.map

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

package/dist/scripts/vectorProofV1.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The vector-proof OFFLINE upgrade (`pnpm neuralis:upgrade`, app STOPPED,
+ * Qdrant UP). A point written before the embedding proof existed carries no
+ * `embedding_status`; the runtime reads only proven points, so the proof is
+ * written here, once, and nowhere the runtime imports.
+ *
+ * Per point without `embedding_status` (tombstones aside — they are never
+ * embedded again):
+ *  - ADOPTED (`current`) when the active lock is dense, the point holds a
+ *    stored vector stamped with the active marker (`embed_model`), and its own
+ *    inline text answers the embedding input (`nodeEmbeddingInputHash`): the
+ *    write path that predates the proof stored exactly the text it embedded
+ *    beside the vector, so the proof is that text's hash under the active
+ *    generation. No re-embed. EXCEPT a point whose write said its vector was
+ *    not built (`version.sync.status: 'unindexed'`): that write kept the OLD
+ *    vector under the NEW `content_hash`, and a later sync of the unchanged
+ *    file could put the new text back beside it — so its text is no proof.
+ *  - otherwise the embedding audit's own verdict (`runQueuedEmbedding`): a
+ *    stored vector it cannot prove is `stale`, no vector is `missing`. The
+ *    operator's embedding catch-up re-embeds those.
+ *
+ * Every write is a payload PATCH (`set_payload` — never an overwrite, never a
+ * vector write), so a stored vector is never dropped. `dryRun` counts and
+ * writes nothing; `apply` is idempotent — a second run finds no unproven point.
+ *
+ * Cost: every unproven point is written ONCE — an adopted one by its own
+ * operation (its hash is its own), the stale and the missing ones of a page by
+ * one operation each — so Qdrant re-indexes each point once whatever the
+ * batching. What the batching decides is the request count and the waits: a
+ * page's batch is sent unwaited, and only the LAST batch waits. An unwaited
+ * batch is acknowledged at Qdrant's write-ahead log and may still fail after
+ * the acknowledgement, so the closing exact count of unproven points is the
+ * proof: a run that leaves any fails, and the next run resumes them (+1 count
+ * per apply). The client holds at most one unsent batch per page, and every
+ * page costs at least three round-trips before it sends. The
+ * scroll offset is the next point id, so a page never reads a point an
+ * unwaited write still holds. Progress is logged every `PROGRESS_EVERY` points.
+ * The ledger begin/complete around `apply` is the operator command's. Module
+ * order matters only through `apply`: `embedding-lock-v3` < `vector-proof-v1`,
+ * so the lock this reads at apply is already v3.
+ */
+import type { OfflineUpgradeModule } from '@neuralis/package-system/data';
+/** The Qdrant calls this upgrade makes — the real client satisfies it, a test passes a fake. */
+export type VectorProofClient = {
+    collectionExists(collection: string): Promise<{
+        exists: boolean;
+    }>;
+    count(collection: string, args: {
+        filter: unknown;
+        exact: boolean;
+    }): Promise<{
+        count: number;
+    }>;
+    scroll(collection: string, args: {
+        filter: unknown;
+        limit: number;
+        offset?: string | number;
+        with_payload: boolean | string[];
+        with_vector: boolean;
+    }): Promise<{
+        points: Array<{
+            id: string | number;
+            payload?: Record<string, unknown> | null;
+        }>;
+        next_page_offset?: string | number | null | Record<string, unknown>;
+    }>;
+    retrieve(collection: string, args: {
+        ids: Array<string | number>;
+        with_payload: string[];
+        with_vector: boolean;
+    }): Promise<Array<{
+        id: string | number;
+        payload?: Record<string, unknown> | null;
+    }>>;
+    batchUpdate(collection: string, args: {
+        wait: boolean;
+        operations: unknown[];
+    }): Promise<unknown>;
+};
+export type VectorProofDeps = {
+    /** Lazily built: an in-memory install never constructs a client. */
+    client(): VectorProofClient;
+    /** `BRAIN_INFRA_MODE` as the runtime reads it — `inmemory` persists no vector. */
+    infraMode(): 'inmemory' | 'local' | 'real';
+    now(): string;
+};
+export declare function createVectorProofUpgrade(deps: VectorProofDeps): OfflineUpgradeModule;
+declare const vectorProofV1: OfflineUpgradeModule;
+export default vectorProofV1;
+//# sourceMappingURL=vectorProofV1.d.ts.map

package/dist/scripts/vectorProofV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorProofV1.d.ts","sourceRoot":"","sources":["../../scripts/vectorProofV1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,KAAK,EAAyB,oBAAoB,EAAsB,MAAM,+BAA+B,CAAC;AAWrH,gGAAgG;AAChG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE;QAC/B,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;KAClH,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;SAAE,CAAC,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACvK,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IACrM,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnG,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,oEAAoE;IACpE,MAAM,IAAI,iBAAiB,CAAC;IAC5B,kFAAkF;IAClF,SAAS,IAAI,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IAC3C,GAAG,IAAI,MAAM,CAAC;CACf,CAAC;AAiCF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAqHpF;AAED,QAAA,MAAM,aAAa,sBAIjB,CAAC;eAEY,aAAa"}

package/dist/scripts/vectorProofV1.js

@@ -0,0 +1,220 @@
+/**
+ * The vector-proof OFFLINE upgrade (`pnpm neuralis:upgrade`, app STOPPED,
+ * Qdrant UP). A point written before the embedding proof existed carries no
+ * `embedding_status`; the runtime reads only proven points, so the proof is
+ * written here, once, and nowhere the runtime imports.
+ *
+ * Per point without `embedding_status` (tombstones aside — they are never
+ * embedded again):
+ *  - ADOPTED (`current`) when the active lock is dense, the point holds a
+ *    stored vector stamped with the active marker (`embed_model`), and its own
+ *    inline text answers the embedding input (`nodeEmbeddingInputHash`): the
+ *    write path that predates the proof stored exactly the text it embedded
+ *    beside the vector, so the proof is that text's hash under the active
+ *    generation. No re-embed. EXCEPT a point whose write said its vector was
+ *    not built (`version.sync.status: 'unindexed'`): that write kept the OLD
+ *    vector under the NEW `content_hash`, and a later sync of the unchanged
+ *    file could put the new text back beside it — so its text is no proof.
+ *  - otherwise the embedding audit's own verdict (`runQueuedEmbedding`): a
+ *    stored vector it cannot prove is `stale`, no vector is `missing`. The
+ *    operator's embedding catch-up re-embeds those.
+ *
+ * Every write is a payload PATCH (`set_payload` — never an overwrite, never a
+ * vector write), so a stored vector is never dropped. `dryRun` counts and
+ * writes nothing; `apply` is idempotent — a second run finds no unproven point.
+ *
+ * Cost: every unproven point is written ONCE — an adopted one by its own
+ * operation (its hash is its own), the stale and the missing ones of a page by
+ * one operation each — so Qdrant re-indexes each point once whatever the
+ * batching. What the batching decides is the request count and the waits: a
+ * page's batch is sent unwaited, and only the LAST batch waits. An unwaited
+ * batch is acknowledged at Qdrant's write-ahead log and may still fail after
+ * the acknowledgement, so the closing exact count of unproven points is the
+ * proof: a run that leaves any fails, and the next run resumes them (+1 count
+ * per apply). The client holds at most one unsent batch per page, and every
+ * page costs at least three round-trips before it sends. The
+ * scroll offset is the next point id, so a page never reads a point an
+ * unwaited write still holds. Progress is logged every `PROGRESS_EVERY` points.
+ * The ledger begin/complete around `apply` is the operator command's. Module
+ * order matters only through `apply`: `embedding-lock-v3` < `vector-proof-v1`,
+ * so the lock this reads at apply is already v3.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { VECTOR_PROOF_FORMAT } from '../src/store/dataFormats.js';
+import { readLock } from '../src/embeddings/lock.js';
+import { embedModelMarker } from '../src/embeddings/models.js';
+import { nodeEmbeddingInputHash } from '../src/usecases/syncPointWrites.js';
+import { getQdrantClient } from '../src/vector/qdrantClient.js';
+import { baseCollection } from '../src/vector/QdrantVectorIndex.js';
+import { inferInfraModeFromEnv } from '../src/wiring.js';
+import { getBrainConfigNumber } from '../src/config/env.js';
+/** A point with no `embedding_status` yet, ignoring tombstones. */
+const UNPROVEN = {
+    must: [{ is_empty: { key: 'embedding_status' } }],
+    must_not: [{ key: 'status', match: { value: 'deleted' } }],
+};
+const SCAN_FIELDS = ['embed_model', 'modality', 'recovery_only', 'category'];
+const INPUT_FIELDS = ['content', 'filename', 'category', 'modality', 'page', 'content_hash'];
+/** The write path's own word that the stored vector was NOT built from the point's content. */
+const UNINDEXED = { key: 'version.sync.status', match: { value: 'unindexed' } };
+/** Inline text travels in batches this small (a parent stores up to ~200 k chars). */
+const CONTENT_BATCH = 32;
+/** One progress line per this many points marked, plus the closing tally. */
+const PROGRESS_EVERY = 10_000;
+/** The dry run's word on what the apply costs the vector database. */
+const APPLY_COST = 'the apply marks every vector point once with its embedding proof (no re-embed); the vector database is busy for a few minutes on a large index';
+/** The collection the runtime serves: the lock's (any lock version names one), else the base. */
+async function servingCollection(appRoot) {
+    try {
+        const raw = JSON.parse(await readFile(join(appRoot, 'config', 'embedding-lock.json'), 'utf8'));
+        if (typeof raw.collection === 'string' && raw.collection)
+            return raw.collection;
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    return baseCollection();
+}
+function offsetOf(next) {
+    return typeof next === 'string' || typeof next === 'number' ? next : undefined;
+}
+export function createVectorProofUpgrade(deps) {
+    const plan = async (ctx) => {
+        if (deps.infraMode() === 'inmemory')
+            return null;
+        const collection = await servingCollection(ctx.appRoot);
+        const client = deps.client();
+        if (!(await client.collectionExists(collection)).exists)
+            return { collection, unproven: 0 };
+        return { collection, unproven: (await client.count(collection, { filter: UNPROVEN, exact: true })).count };
+    };
+    return {
+        id: 'vector-proof-v1',
+        kinds: [{ kind: VECTOR_PROOF_FORMAT.kind, to: VECTOR_PROOF_FORMAT.version }],
+        async dryRun(ctx) {
+            let found;
+            try {
+                found = await plan(ctx);
+            }
+            catch (error) {
+                return {
+                    files: [],
+                    summary: [],
+                    blockers: {
+                        lines: [`vector index · the Qdrant server did not answer (${error instanceof Error ? error.message : String(error)})`],
+                        remedy: 'start Qdrant with the app still stopped (`docker compose up -d qdrant`, or the Qdrant binary), then run the command again',
+                    },
+                };
+            }
+            if (!found)
+                return { files: [], summary: ['no persistent vector index (BRAIN_INFRA_MODE=inmemory) — nothing to prove'] };
+            return {
+                files: [],
+                summary: [found.unproven === 0
+                        ? `vector index ${found.collection}: every point already carries its embedding proof`
+                        : `vector index ${found.collection}: ${found.unproven} point(s) without an embedding proof — the ones whose stored vector and inline text match the active generation are adopted, the rest are marked for the embedding catch-up`,
+                    ...(found.unproven === 0 ? [] : [APPLY_COST])],
+            };
+        },
+        async apply(ctx) {
+            if (deps.infraMode() === 'inmemory')
+                return;
+            const lock = await readLock(ctx.appRoot);
+            const collection = lock?.collection ?? baseCollection();
+            const client = deps.client();
+            if (!(await client.collectionExists(collection)).exists)
+                return;
+            const marker = lock?.mode === 'dense' ? embedModelMarker(lock.modelId, lock.dimension, lock.embedRecipe) : undefined;
+            const limit = Math.max(1, Math.floor(getBrainConfigNumber('vectorHealthBatchSize', undefined, 256)));
+            const total = (await client.count(collection, { filter: UNPROVEN, exact: true })).count;
+            const started = Date.now();
+            let adopted = 0;
+            let stale = 0;
+            let missing = 0;
+            let marked = 0;
+            let reported = 0;
+            let unsent = null;
+            const send = async (wait) => {
+                if (!unsent)
+                    return;
+                await client.batchUpdate(collection, { wait, operations: unsent });
+                unsent = null;
+            };
+            let offset;
+            do {
+                const page = await client.scroll(collection, { filter: UNPROVEN, limit, ...(offset !== undefined ? { offset } : {}), with_payload: SCAN_FIELDS, with_vector: false });
+                const ids = page.points.map((point) => point.id);
+                if (ids.length === 0)
+                    break;
+                const withVector = new Set((await client.scroll(collection, {
+                    filter: { must: [{ has_id: ids }, { has_vector: '' }] }, limit: ids.length, with_payload: false, with_vector: false,
+                })).points.map((point) => String(point.id)));
+                // Adoption candidates: a vector stamped with the active marker, text (not media), searchable.
+                const markerMatched = marker === undefined ? [] : page.points.filter((point) => withVector.has(String(point.id))
+                    && point.payload?.embed_model === marker && !point.payload?.modality && point.payload?.recovery_only !== true);
+                const unindexed = markerMatched.length === 0 ? new Set() : new Set((await client.scroll(collection, {
+                    filter: { must: [{ has_id: markerMatched.map((point) => point.id) }, UNINDEXED] },
+                    limit: markerMatched.length, with_payload: false, with_vector: false,
+                })).points.map((point) => String(point.id)));
+                const candidates = markerMatched.filter((point) => !unindexed.has(String(point.id)));
+                const proofs = new Map();
+                for (let i = 0; i < candidates.length; i += CONTENT_BATCH) {
+                    const batch = candidates.slice(i, i + CONTENT_BATCH).map((point) => point.id);
+                    for (const point of await client.retrieve(collection, { ids: batch, with_payload: INPUT_FIELDS, with_vector: false })) {
+                        const payload = (point.payload ?? {});
+                        if (typeof payload.content !== 'string')
+                            continue;
+                        const hash = nodeEmbeddingInputHash(payload);
+                        if (hash)
+                            proofs.set(String(point.id), hash);
+                    }
+                }
+                const now = deps.now();
+                const operations = [];
+                const staleIds = [];
+                const missingIds = [];
+                for (const point of page.points) {
+                    const hash = proofs.get(String(point.id));
+                    if (hash && lock?.mode === 'dense') {
+                        operations.push({ set_payload: { points: [point.id], payload: {
+                                    embedding_status: 'current', embedding_input_hash: hash, embedding_generation: lock.generation, embedding_updated_at: now,
+                                } } });
+                    }
+                    else if (withVector.has(String(point.id)))
+                        staleIds.push(point.id);
+                    else
+                        missingIds.push(point.id);
+                }
+                if (staleIds.length)
+                    operations.push({ set_payload: { points: staleIds, payload: { embedding_status: 'stale' } } });
+                if (missingIds.length)
+                    operations.push({ set_payload: { points: missingIds, payload: { embedding_status: 'missing' } } });
+                await send(false);
+                unsent = operations;
+                adopted += proofs.size;
+                stale += staleIds.length;
+                missing += missingIds.length;
+                marked += page.points.length;
+                if (marked - reported >= PROGRESS_EVERY) {
+                    reported = marked;
+                    ctx.log(`vector index ${collection}: ${marked} / ${total} points marked (${Math.round((Date.now() - started) / 1000)} s)`);
+                }
+                offset = offsetOf(page.next_page_offset);
+            } while (offset !== undefined);
+            await send(true);
+            const left = (await client.count(collection, { filter: UNPROVEN, exact: true })).count;
+            if (left > 0)
+                throw new Error(`vector index ${collection}: ${left} point(s) still carry no embedding proof — run the command again`);
+            ctx.log(`vector index ${collection}: ${adopted} adopted, ${stale} stale, ${missing} missing (${Math.round((Date.now() - started) / 1000)} s)`);
+        },
+    };
+}
+const vectorProofV1 = createVectorProofUpgrade({
+    client: () => getQdrantClient(),
+    infraMode: () => inferInfraModeFromEnv(),
+    now: () => new Date().toISOString(),
+});
+export default vectorProofV1;
+//# sourceMappingURL=vectorProofV1.js.map

package/dist/scripts/vectorProofV1.js.map

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

package/dist/src/config/env.d.ts

@@ -138,6 +138,17 @@ export declare function resolveTargetEmbeddingShape(): {
     info: EmbeddingModelInfo;
     dimension: number;
 };
+/** Embedding intent is a live config read; disabled means zero model/key resolution. */
+export declare function embeddingEnabled(): boolean;
+export declare class EmbeddingDisabledError extends Error {
+    readonly code: 'embedding_disabled';
+    constructor();
+}
+export declare class EmbeddingMetadataOnlyError extends Error {
+    readonly code: 'embedding_metadata_only';
+    constructor();
+}
+export declare function requireEmbeddingEnabled(): void;
 /** The generation identity a model + dimension writes (what a lock records). */
 export declare function generationFor(info: EmbeddingModelInfo, dimension: number): EmbeddingGeneration;
 /**
@@ -166,4 +177,14 @@ export declare function resolveActiveEmbeddingShape(): Promise<{
  */
 export declare function resolveActiveEmbeddingConfig(): Promise<ResolvedEmbeddingConfig>;
 export declare function clearNeuralisEnvCache(): void;
+export type EmbeddingUnavailableReason = 'network' | 'timeout' | 'credentials' | 'rate_limit' | 'quota' | 'provider' | 'model_missing';
+/** Provider availability is separate from malformed input/output and local authorization. */
+export declare class EmbeddingUnavailableError extends Error {
+    readonly reason: EmbeddingUnavailableReason;
+    readonly status?: number | undefined;
+    readonly code: 'embedding_unavailable';
+    constructor(reason: EmbeddingUnavailableReason, status?: number | undefined);
+}
+export declare function embeddingHttpUnavailable(status: number): EmbeddingUnavailableError | undefined;
+export declare function embeddingTransportUnavailable(error: unknown): EmbeddingUnavailableError | undefined;
 //# sourceMappingURL=env.d.ts.map

package/dist/src/config/env.d.ts.map

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

package/dist/src/config/env.js

@@ -249,6 +249,22 @@ export function resolveTargetEmbeddingShape() {
     }
     return { info, dimension };
 }
+/** Embedding intent is a live config read; disabled means zero model/key resolution. */
+export function embeddingEnabled() {
+    return getBrainConfigBoolean('embeddingEnabled', undefined, true);
+}
+export class EmbeddingDisabledError extends Error {
+    code = 'embedding_disabled';
+    constructor() { super('EMBEDDING_DISABLED'); this.name = 'EmbeddingDisabledError'; }
+}
+export class EmbeddingMetadataOnlyError extends Error {
+    code = 'embedding_metadata_only';
+    constructor() { super('EMBEDDING_METADATA_ONLY: activate a dense generation explicitly'); this.name = 'EmbeddingMetadataOnlyError'; }
+}
+export function requireEmbeddingEnabled() {
+    if (!embeddingEnabled())
+        throw new EmbeddingDisabledError();
+}
 /** The generation identity a model + dimension writes (what a lock records). */
 export function generationFor(info, dimension) {
     return {
@@ -270,6 +286,7 @@ export function generationFor(info, dimension) {
  * REGRESSION (owner decision 2026-08-03); the `embeddingPlatformScope` guard pins it.
  */
 export async function resolveEmbeddingConfigFor(info, dimension) {
+    requireEmbeddingEnabled();
     const provider = brainConfigProvider;
     let apiKey;
     if (info.credentialId) {
@@ -317,9 +334,12 @@ export async function resolveEmbeddingConfigFor(info, dimension) {
  * when the locked model is gone.
  */
 export async function resolveActiveEmbeddingShape() {
+    requireEmbeddingEnabled();
     const lock = await getActiveLock(resolveNeuralisHome().appRoot);
     if (!lock)
         return resolveTargetEmbeddingShape();
+    if (lock.mode === 'metadata')
+        throw new EmbeddingMetadataOnlyError();
     const info = resolveEmbeddingModel(lock.modelId);
     if (!info)
         throw new ActiveEmbeddingModelUnresolvableError(lock.modelId);
@@ -336,4 +356,39 @@ export async function resolveActiveEmbeddingConfig() {
 export function clearNeuralisEnvCache() {
     cachedEnv = null;
 }
+/** Provider availability is separate from malformed input/output and local authorization. */
+export class EmbeddingUnavailableError extends Error {
+    reason;
+    status;
+    code = 'embedding_unavailable';
+    constructor(reason, status) {
+        super(`EMBEDDING_UNAVAILABLE:${reason}${status === undefined ? '' : `:${status}`}`);
+        this.reason = reason;
+        this.status = status;
+        this.name = 'EmbeddingUnavailableError';
+    }
+}
+export function embeddingHttpUnavailable(status) {
+    if (status === 401 || status === 403)
+        return new EmbeddingUnavailableError('credentials', status);
+    // 402 Payment Required: the account is out of credit (Gemini "prepayment depleted"); only a top-up drains it.
+    if (status === 402)
+        return new EmbeddingUnavailableError('quota', status);
+    if (status === 429)
+        return new EmbeddingUnavailableError('rate_limit', status);
+    if (status >= 500 && status < 600)
+        return new EmbeddingUnavailableError('provider', status);
+    return undefined;
+}
+export function embeddingTransportUnavailable(error) {
+    if (error instanceof Error && error.name === 'TimeoutError')
+        return new EmbeddingUnavailableError('timeout');
+    if (error instanceof TypeError) {
+        const cause = error.cause;
+        const code = cause && typeof cause === 'object' && 'code' in cause ? cause.code : undefined;
+        if (error.message === 'fetch failed' || typeof code === 'string' && ['UND_ERR_SOCKET', 'ECONNRESET', 'ECONNREFUSED', 'ETIMEDOUT', 'ENOTFOUND', 'EAI_AGAIN'].includes(code))
+            return new EmbeddingUnavailableError('network');
+    }
+    return undefined;
+}
 //# sourceMappingURL=env.js.map