@squadrules/mcp 5.0.0-beta.1 → 5.0.1

package/dist/services/vector-store/lancedb/LanceVectorRecordStore.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Embedded LanceDB record store.
+ *
+ * Satisfies the `IVectorRecordStore` port and the read/admin surface the tools
+ * reach through `qdrantService`, so a single instance can back both injected
+ * slots on the embedded path (selected by `isQdrantConfigured`). Reads,
+ * read-modify-write mutations, semantic search (JS cosine) and the markdown-to-
+ * points writers (`storeAdapter` / `storeArtifact`) are all implemented, reusing
+ * the backend-neutral parse/build helpers so the store matches the Qdrant path's
+ * contract. Search-ranking and train parity are validated against the Qdrant
+ * integration suite when the store is wired and exercised end-to-end.
+ */
+import type { Memory } from '../../../types/memory.js';
+import type { IVectorRecordStore } from '../IVectorRecordStore.js';
+import type { ArtifactResolveOutcome, GetMemoryOptions, LayerRecord, MemorySearchResult, SlugResolveOutcome, StoreAdapterOptions } from '../types.js';
+import type { StoreArtifactOptions } from '../../memory/store-adapter.js';
+export declare class LanceVectorRecordStore implements IVectorRecordStore {
+    private readonly engine;
+    private readonly reader;
+    private readonly mutator;
+    private readonly search;
+    private readonly writer;
+    private connectionPromise;
+    private connection;
+    init(): Promise<void>;
+    checkHealth(_timeoutMs?: number): Promise<boolean>;
+    getMemory(memoryUuid: string, _options?: GetMemoryOptions): Promise<Memory | null>;
+    getAdapterLayers(adapterId: string, extraSpaceIds?: string[]): Promise<LayerRecord[]>;
+    findFirstStepMemoryUuidBySlug(slug: string): Promise<SlugResolveOutcome>;
+    findArtifactMemoryUuidBySlug(slug: string): Promise<ArtifactResolveOutcome>;
+    scrollSpace(spaceId: string, options?: {
+        paginate?: boolean;
+        limit?: number;
+    }): Promise<LayerRecord[]>;
+    listAdapterArtifacts(adapterId: string): Promise<LayerRecord[]>;
+    findProtocolFooterLayers(refineSlug: string, createSlug: string): Promise<LayerRecord[]>;
+    getStoredAdapterVersion(slug: string): Promise<string | undefined>;
+    updateMemory(memoryUuid: string, patch: Record<string, unknown>): Promise<void>;
+    deleteMemory(memoryUuid: string): Promise<void>;
+    setPayloadOnLayers(layerIds: string[], patch: Record<string, unknown>): Promise<void>;
+    deleteAppSpaceBySlug(slug: string): Promise<void>;
+    deleteAppSpaceByAdapterId(adapterId: string): Promise<void>;
+    retrieveById(uuid: string): Promise<{
+        uuid: string;
+        payload: any;
+    } | null>;
+    getMemoryByUUID(uuid: string): Promise<any | null>;
+    findProtocolSteps(protocolId: string): Promise<Array<{
+        uuid: string;
+        protocol: unknown;
+        payload: Record<string, unknown>;
+    }>>;
+    findProtocolStep(domain: string, type: string, task: string, step: number): Promise<{
+        uuid: string;
+        payload: Record<string, unknown>;
+    } | null>;
+    updateQualityMetrics(id: string, metrics: any): Promise<void>;
+    updateQualityMetadata(id: string, qualityMetadata: {
+        step_quality_score: number;
+        step_quality: 'excellent' | 'high' | 'standard' | 'basic';
+    }): Promise<void>;
+    propagateRewardToAdapterHead(stepPointId: string, metricsUpdate: Record<string, unknown>): Promise<string | null>;
+    initialize(): Promise<void>;
+    createOrUpdateAlias(): Promise<void>;
+    getCollections(): Promise<Array<{
+        name?: string;
+    }>>;
+    dropCollection(): Promise<void>;
+    get collectionName(): string;
+    get qdrantUrl(): string;
+    get apiKey(): string | undefined;
+    searchMemories(query: string, limit: number, _collapse?: boolean): Promise<MemorySearchResult>;
+    searchAdapterTitlesBySimilarity(query: string, limit: number): Promise<MemorySearchResult>;
+    storeAdapter(docs: string[], llmModelId: string, options?: StoreAdapterOptions): Promise<Memory[]>;
+    storeArtifact(content: string, options: StoreArtifactOptions): Promise<Memory[]>;
+}
+//# sourceMappingURL=LanceVectorRecordStore.d.ts.map

package/dist/services/vector-store/lancedb/LanceVectorRecordStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanceVectorRecordStore.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/LanceVectorRecordStore.ts"],"names":[],"mappings":"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"}

package/dist/services/vector-store/lancedb/LanceVectorRecordStore.js

@@ -0,0 +1,136 @@
+import { getQdrantCollection } from '../../../config.js';
+import { logger } from '../../../utils/structured-logger.js';
+import { openLanceConnection } from '../lancedb-connection.js';
+import { LanceRecordEngine } from './lance-records-engine.js';
+import { LanceRecordReader } from './lance-records-reads.js';
+import { LanceRecordMutator } from './lance-records-mutations.js';
+import { LanceRecordSearch } from './lance-records-search.js';
+import { LanceRecordWriter } from './lance-records-writes.js';
+const COLLECTION_LABEL = getQdrantCollection('squadrules');
+export class LanceVectorRecordStore {
+    engine = new LanceRecordEngine();
+    reader = new LanceRecordReader(this.engine);
+    mutator = new LanceRecordMutator(this.engine);
+    search = new LanceRecordSearch(this.engine);
+    writer = new LanceRecordWriter(this.engine, this.search);
+    connectionPromise = null;
+    connection() {
+        if (!this.connectionPromise)
+            this.connectionPromise = openLanceConnection();
+        return this.connectionPromise;
+    }
+    // --- lifecycle ---
+    async init() {
+        await this.connection();
+        logger.info('[LanceVectorRecordStore] Embedded LanceDB record store ready');
+    }
+    async checkHealth(_timeoutMs) {
+        try {
+            await this.connection();
+            return true;
+        }
+        catch (error) {
+            logger.warn(`[LanceVectorRecordStore] health check failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    // --- reads (delegate) ---
+    async getMemory(memoryUuid, _options) {
+        return this.reader.getMemory(memoryUuid);
+    }
+    async getAdapterLayers(adapterId, extraSpaceIds) {
+        return this.reader.getAdapterLayers(adapterId, extraSpaceIds);
+    }
+    async findFirstStepMemoryUuidBySlug(slug) {
+        return this.reader.findFirstStepMemoryUuidBySlug(slug);
+    }
+    async findArtifactMemoryUuidBySlug(slug) {
+        return this.reader.findArtifactMemoryUuidBySlug(slug);
+    }
+    async scrollSpace(spaceId, options) {
+        return this.reader.scrollSpace(spaceId, options);
+    }
+    async listAdapterArtifacts(adapterId) {
+        return this.reader.listAdapterArtifacts(adapterId);
+    }
+    async findProtocolFooterLayers(refineSlug, createSlug) {
+        return this.reader.findProtocolFooterLayers(refineSlug, createSlug);
+    }
+    async getStoredAdapterVersion(slug) {
+        return this.reader.getStoredAdapterVersion(slug);
+    }
+    async updateMemory(memoryUuid, patch) {
+        return this.mutator.updateMemory(memoryUuid, patch);
+    }
+    async deleteMemory(memoryUuid) {
+        return this.mutator.deleteMemory(memoryUuid);
+    }
+    async setPayloadOnLayers(layerIds, patch) {
+        return this.mutator.setPayloadOnLayers(layerIds, patch);
+    }
+    async deleteAppSpaceBySlug(slug) {
+        return this.mutator.deleteAppSpaceBySlug(slug);
+    }
+    async deleteAppSpaceByAdapterId(adapterId) {
+        return this.mutator.deleteAppSpaceByAdapterId(adapterId);
+    }
+    // --- qdrantService read surface (delegate) ---
+    async retrieveById(uuid) {
+        return this.reader.retrieveById(uuid);
+    }
+    async getMemoryByUUID(uuid) {
+        return this.reader.getMemoryByUUID(uuid);
+    }
+    async findProtocolSteps(protocolId) {
+        return this.reader.findProtocolSteps(protocolId);
+    }
+    async findProtocolStep(domain, type, task, step) {
+        return this.reader.findProtocolStep(domain, type, task, step);
+    }
+    async updateQualityMetrics(id, metrics) {
+        return this.mutator.updateQualityMetrics(id, metrics);
+    }
+    async updateQualityMetadata(id, qualityMetadata) {
+        return this.mutator.updateQualityMetadata(id, qualityMetadata);
+    }
+    async propagateRewardToAdapterHead(stepPointId, metricsUpdate) {
+        return this.mutator.propagateRewardToAdapterHead(stepPointId, metricsUpdate);
+    }
+    // --- admin (embedded store has no aliases / server collections) ---
+    async initialize() {
+        await this.init();
+    }
+    async createOrUpdateAlias() {
+        logger.debug('[LanceVectorRecordStore] createOrUpdateAlias is a no-op on the embedded store');
+    }
+    async getCollections() {
+        return [];
+    }
+    async dropCollection() {
+        logger.debug('[LanceVectorRecordStore] dropCollection is a no-op on the embedded store');
+    }
+    get collectionName() {
+        return COLLECTION_LABEL;
+    }
+    get qdrantUrl() {
+        return 'embedded:lancedb';
+    }
+    get apiKey() {
+        return undefined;
+    }
+    // --- search (JS cosine) ---
+    async searchMemories(query, limit, _collapse) {
+        return this.search.searchMemories(query, limit);
+    }
+    async searchAdapterTitlesBySimilarity(query, limit) {
+        return this.search.searchAdapterTitlesBySimilarity(query, limit);
+    }
+    // --- writers (delegate) ---
+    async storeAdapter(docs, llmModelId, options) {
+        return this.writer.storeAdapter(docs, llmModelId, options);
+    }
+    async storeArtifact(content, options) {
+        return this.writer.storeArtifact(content, options);
+    }
+}
+//# sourceMappingURL=LanceVectorRecordStore.js.map

package/dist/services/vector-store/lancedb/LanceVectorRecordStore.js.map

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

package/dist/services/vector-store/lancedb/lance-records-engine.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Lance table engine for memory records.
+ *
+ * Owns the connection and the one `memory_records` table, exposing the small set
+ * of primitives the read/query/mutation layers are built on: open-or-create,
+ * atomic upsert of Qdrant-shaped points, filtered scans, retrieve-by-id (with
+ * vectors preserved for read-modify-write) and delete-by-filter. Reads before any
+ * write treat the absent table as empty (never create it), so a cold start does
+ * not touch disk for a read. Writes serialize on Lance MVCC via `withCommitRetry`.
+ */
+import type { LanceTable } from '../lancedb-connection.js';
+import { type LanceRecordRow, type QdrantPointLike } from './lance-records-schema.js';
+export declare class LanceRecordEngine {
+    private connectionPromise;
+    private getConnection;
+    /** Open the records table, or return null when nothing has been written yet. */
+    openTableIfPresent(): Promise<LanceTable | null>;
+    /** Open-or-create the records table, inferring the schema from a first row. */
+    ensureTableForWrite(firstRow: LanceRecordRow): Promise<LanceTable>;
+    /** Atomic upsert of Qdrant-shaped points (keyed by id) with commit retry. */
+    putPoints(points: QdrantPointLike[]): Promise<number>;
+    /** Replace rows wholesale for a set of ids after building new points. */
+    putRows(rows: LanceRecordRow[]): Promise<void>;
+    /** Scan rows matching a Qdrant-style filter, optionally capped. */
+    scroll(filter: {
+        must?: Array<Record<string, unknown>>;
+        must_not?: Array<Record<string, unknown>>;
+    }, limit?: number): Promise<LanceRecordRow[]>;
+    /** Retrieve a single raw row by id (carries vector columns for read-modify-write). */
+    retrieveRaw(id: string): Promise<LanceRecordRow | null>;
+    /** Delete rows matching a Qdrant-style filter. */
+    deleteByFilter(filter: {
+        must?: Array<Record<string, unknown>>;
+        must_not?: Array<Record<string, unknown>>;
+    }): Promise<void>;
+    /** Delete one row by id. */
+    deleteById(id: string): Promise<void>;
+    /** Rebuild and persist a row from a mutated Qdrant-shaped point. */
+    upsertPoint(point: QdrantPointLike): Promise<void>;
+}
+//# sourceMappingURL=lance-records-engine.d.ts.map

package/dist/services/vector-store/lancedb/lance-records-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-engine.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG5E,OAAO,EAAiC,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMrH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,iBAAiB,CAAyC;IAElE,OAAO,CAAC,aAAa;IAOrB,gFAAgF;IAC1E,kBAAkB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOtD,+EAA+E;IACzE,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IASxE,6EAA6E;IACvE,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB3D,yEAAyE;IACnE,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD,mEAAmE;IAC7D,MAAM,CACV,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,EAC5F,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,EAAE,CAAC;IAU5B,sFAAsF;IAChF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAW7D,kDAAkD;IAC5C,cAAc,CAClB,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,GAC3F,OAAO,CAAC,IAAI,CAAC;IAQhB,4BAA4B;IACtB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,oEAAoE;IAC9D,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzD"}

package/dist/services/vector-store/lancedb/lance-records-engine.js

@@ -0,0 +1,102 @@
+import { openLanceConnection } from '../lancedb-connection.js';
+import { withCommitRetry } from '../commit-retry.js';
+import { toRow, buildWhere, sqlLiteral } from './lance-records-schema.js';
+const RECORDS_TABLE = 'memory_records';
+/** Full scans use a generous limit; record counts per space are small. */
+const SCAN_LIMIT = 100_000;
+export class LanceRecordEngine {
+    connectionPromise = null;
+    getConnection() {
+        if (!this.connectionPromise) {
+            this.connectionPromise = openLanceConnection();
+        }
+        return this.connectionPromise;
+    }
+    /** Open the records table, or return null when nothing has been written yet. */
+    async openTableIfPresent() {
+        const connection = await this.getConnection();
+        const names = await connection.tableNames();
+        if (!names.includes(RECORDS_TABLE))
+            return null;
+        return connection.openTable(RECORDS_TABLE);
+    }
+    /** Open-or-create the records table, inferring the schema from a first row. */
+    async ensureTableForWrite(firstRow) {
+        const connection = await this.getConnection();
+        const names = await connection.tableNames();
+        if (names.includes(RECORDS_TABLE)) {
+            return connection.openTable(RECORDS_TABLE);
+        }
+        return connection.createTable(RECORDS_TABLE, [firstRow], { mode: 'create' });
+    }
+    /** Atomic upsert of Qdrant-shaped points (keyed by id) with commit retry. */
+    async putPoints(points) {
+        if (points.length === 0)
+            return 0;
+        const rows = points.map(toRow);
+        const table = await this.ensureTableForWrite(rows[0]);
+        await withCommitRetry(() => table
+            .mergeInsert('id')
+            .whenMatchedUpdateAll()
+            .whenNotMatchedInsertAll()
+            .execute(rows), `records-upsert:${rows.length}`);
+        return rows.length;
+    }
+    /** Replace rows wholesale for a set of ids after building new points. */
+    async putRows(rows) {
+        if (rows.length === 0)
+            return;
+        const table = await this.ensureTableForWrite(rows[0]);
+        await withCommitRetry(() => table
+            .mergeInsert('id')
+            .whenMatchedUpdateAll()
+            .whenNotMatchedInsertAll()
+            .execute(rows), `records-put:${rows.length}`);
+    }
+    /** Scan rows matching a Qdrant-style filter, optionally capped. */
+    async scroll(filter, limit) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return [];
+        const where = buildWhere(filter);
+        const query = table.query();
+        if (where)
+            query.where(where);
+        const rows = (await query.limit(limit ?? SCAN_LIMIT).toArray());
+        return rows;
+    }
+    /** Retrieve a single raw row by id (carries vector columns for read-modify-write). */
+    async retrieveRaw(id) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return null;
+        const rows = (await table
+            .query()
+            .where(`id = ${sqlLiteral(id)}`)
+            .limit(1)
+            .toArray());
+        return rows[0] ?? null;
+    }
+    /** Delete rows matching a Qdrant-style filter. */
+    async deleteByFilter(filter) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return;
+        const where = buildWhere(filter);
+        if (!where)
+            return;
+        await withCommitRetry(() => table.delete(where), 'records-delete');
+    }
+    /** Delete one row by id. */
+    async deleteById(id) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return;
+        await withCommitRetry(() => table.delete(`id = ${sqlLiteral(id)}`), `records-delete:${id}`);
+    }
+    /** Rebuild and persist a row from a mutated Qdrant-shaped point. */
+    async upsertPoint(point) {
+        await this.putPoints([point]);
+    }
+}
+//# sourceMappingURL=lance-records-engine.js.map

package/dist/services/vector-store/lancedb/lance-records-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-engine.js","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-engine.ts"],"names":[],"mappings":"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"}

package/dist/services/vector-store/lancedb/lance-records-mutations.d.ts

@@ -0,0 +1,22 @@
+import type { LanceRecordEngine } from './lance-records-engine.js';
+export declare class LanceRecordMutator {
+    private readonly engine;
+    constructor(engine: LanceRecordEngine);
+    private loadAccessibleRow;
+    updateMemory(id: string, updates: any): Promise<void>;
+    deleteMemory(id: string): Promise<void>;
+    updateQualityMetrics(id: string, metrics: any): Promise<void>;
+    updateQualityMetadata(id: string, qualityMetadata: {
+        step_quality_score: number;
+        step_quality: 'excellent' | 'high' | 'standard' | 'basic';
+    }): Promise<void>;
+    /** Resolve a completion layer's adapter head and propagate reward to it. */
+    propagateRewardToAdapterHead(stepPointId: string, metricsUpdate: Record<string, unknown>): Promise<string | null>;
+    /** Attach a payload patch (e.g. content hash) to a set of layer points. */
+    setPayloadOnLayers(layerIds: string[], patch: Record<string, unknown>): Promise<void>;
+    /** Delete app-space points matching a slug. */
+    deleteAppSpaceBySlug(slug: string): Promise<void>;
+    /** Delete app-space points matching an adapter id. */
+    deleteAppSpaceByAdapterId(adapterId: string): Promise<void>;
+}
+//# sourceMappingURL=lance-records-mutations.d.ts.map

package/dist/services/vector-store/lancedb/lance-records-mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-mutations.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-mutations.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAsCnE,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;YAExC,iBAAiB;IASzB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDrD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7D,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE;QAAE,kBAAkB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASlK,4EAA4E;IACtE,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BvH,2EAA2E;IACrE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3F,+CAA+C;IACzC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD,sDAAsD;IAChD,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQlE"}

package/dist/services/vector-store/lancedb/lance-records-mutations.js

@@ -0,0 +1,211 @@
+/**
+ * Lance mutation layer for memory records.
+ *
+ * Read-modify-write operations mirror their Qdrant counterparts (`memory-updates.ts`,
+ * `quality.ts`, `reward-propagation.ts` and the `store.ts` bulk payload/delete
+ * helpers) field for field: the same accessible-space gate, the same payload merge
+ * and retired-alias drop, the same `quality_metrics` accumulation and `attest_boost`
+ * formula, the same text-change → re-embed rule, and the same cache invalidation
+ * calls. Named vectors are preserved across the round-trip so an update never
+ * silently drops an embedding column.
+ */
+import { SQUADRULES_APP_SPACE_ID, MIN_ATTEST_RUNS, RUNS_FULL_CONFIDENCE, ATTEST_BOOST_MAX } from '../../../config.js';
+import { getSpaceContext, getTenantId } from '../../../utils/tenant-context.js';
+import { buildSpaceFilter } from '../../../utils/space-filter.js';
+import { SquadrulesError } from '../../../types/index.js';
+import { logger } from '../../../utils/structured-logger.js';
+import { embeddingService } from '../../embedding/service.js';
+import { redisCacheService } from '../../redis-cache.js';
+import { validateAndConvertId } from '../../qdrant/utils.js';
+import { toNumberArray } from './lance-records-schema.js';
+function payloadOf(row) {
+    return JSON.parse(row.payload);
+}
+function isAccessible(row) {
+    const spaceId = String(payloadOf(row)['space_id'] ?? SQUADRULES_APP_SPACE_ID);
+    const allowed = getSpaceContext().allowedSpaceIds;
+    return allowed.includes(spaceId) || spaceId === SQUADRULES_APP_SPACE_ID;
+}
+/** Pull the named dense vectors (+ bm25) out of a row so an update preserves them. */
+function vectorsFromRow(row) {
+    const vector = {};
+    for (const [key, value] of Object.entries(row)) {
+        const numbers = toNumberArray(value);
+        if (numbers)
+            vector[key] = numbers;
+    }
+    if (row.bm25_json) {
+        try {
+            vector['bm25'] = JSON.parse(row.bm25_json);
+        }
+        catch {
+            /* ignore malformed sparse blob */
+        }
+    }
+    return vector;
+}
+function computeAttestBoost(successCount, failureCount) {
+    const runs = successCount + failureCount;
+    if (runs < MIN_ATTEST_RUNS)
+        return 0;
+    const successRatio = runs > 0 ? successCount / runs : 0;
+    const confidence = Math.min(runs / RUNS_FULL_CONFIDENCE, 1);
+    return Math.min(ATTEST_BOOST_MAX * successRatio * confidence, ATTEST_BOOST_MAX);
+}
+export class LanceRecordMutator {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    async loadAccessibleRow(id, notFoundMessage) {
+        const validated = validateAndConvertId(id);
+        const row = await this.engine.retrieveRaw(validated);
+        if (!row || !isAccessible(row)) {
+            throw new SquadrulesError(notFoundMessage, 'MEMORY_NOT_FOUND', 404);
+        }
+        return row;
+    }
+    async updateMemory(id, updates) {
+        const tenantId = getTenantId();
+        const row = await this.loadAccessibleRow(id, `Memory with ID ${id} not found`);
+        const existingPayload = payloadOf(row);
+        let newQualityMetadata = existingPayload.quality_metadata;
+        const shouldRecalculate = updates.label || updates.text || updates.domain || updates.task || updates.type || updates.tags;
+        if (shouldRecalculate) {
+            const { modelStats } = await import('../../stats/model-stats.js');
+            const qualityMetadata = modelStats.calculateStepQualityMetadata(updates.label || existingPayload.label || '', updates.domain || existingPayload.domain || 'general', updates.task || existingPayload.task || 'general-task', updates.type || existingPayload.type || 'context', updates.tags || existingPayload.tags || []);
+            newQualityMetadata = { step_quality_score: qualityMetadata.step_quality_score, step_quality: qualityMetadata.step_quality };
+        }
+        const { description_short: _d, description_full: _f, ...safeUpdates } = updates ?? {};
+        const defaultSpaceId = getSpaceContext().defaultWriteSpaceId;
+        const updatedPayload = {
+            ...existingPayload,
+            space_id: existingPayload.space_id ?? defaultSpaceId,
+            ...safeUpdates,
+            updated_at: new Date().toISOString(),
+            modified_at: new Date().toISOString(),
+            modified_by: getSpaceContext().userId || 'system',
+            created_by: existingPayload.created_by ?? (getSpaceContext().userId || 'system'),
+            quality_metadata: newQualityMetadata
+        };
+        const vector = vectorsFromRow(row);
+        const textChanged = typeof updates?.text === 'string' && updates.text !== existingPayload.text;
+        if (textChanged) {
+            const embeddingResult = await embeddingService.generateEmbedding(updates.text);
+            const primaryName = `vs${embeddingResult.embedding.length}`;
+            for (const key of Object.keys(vector)) {
+                if (key.startsWith('vs'))
+                    delete vector[key];
+            }
+            vector[primaryName] = embeddingResult.embedding;
+        }
+        await this.engine.upsertPoint({ id: row.id, payload: updatedPayload, vector });
+        await redisCacheService.invalidateMemoryCacheStrict(row.id);
+        await redisCacheService.invalidateAfterUpdate();
+        logger.debug(`[LanceRecordMutator] updateMemory ${row.id} tenant=${tenantId}`);
+    }
+    async deleteMemory(id) {
+        const validated = validateAndConvertId(id);
+        const row = await this.engine.retrieveRaw(validated);
+        if (!row || !isAccessible(row)) {
+            throw new SquadrulesError(`Memory with ID ${id} not found`, 'MEMORY_NOT_FOUND', 404);
+        }
+        await this.engine.deleteById(validated);
+        await redisCacheService.invalidateMemoryCacheStrict(validated);
+        await redisCacheService.invalidateAfterUpdate();
+    }
+    async updateQualityMetrics(id, metrics) {
+        const row = await this.loadAccessibleRow(id, `Memory with ID ${id} not found for quality update`);
+        const existingPayload = payloadOf(row);
+        const currentMetrics = existingPayload.quality_metrics || {
+            retrievalCount: 0, successCount: 0, partialCount: 0, failureCount: 0,
+            lastRated: null, lastRater: null, qualityBonus: 0, usageContext: null,
+            implementation_stats: { total_attempts: 0, success_attempts: 0, model_success_rates: {}, confidence_level: 0, last_implementation_attempt: null },
+            healer_contributions: { total_healers: 0, total_improvements: 0, healer_bonus_distributed: 0, last_healed: null, healer_models: {} },
+            step_success_rates: {}
+        };
+        const updatedMetrics = {
+            ...currentMetrics,
+            ...metrics,
+            retrievalCount: currentMetrics.retrievalCount + (metrics.retrievalCount || 0),
+            successCount: currentMetrics.successCount + (metrics.successCount || 0),
+            partialCount: currentMetrics.partialCount + (metrics.partialCount || 0),
+            failureCount: currentMetrics.failureCount + (metrics.failureCount || 0),
+            qualityBonus: currentMetrics.qualityBonus + (metrics.qualityBonus || 0)
+        };
+        const attest_boost = computeAttestBoost(updatedMetrics.successCount ?? 0, updatedMetrics.failureCount ?? 0);
+        const spaceId = existingPayload.space_id ?? getSpaceContext().defaultWriteSpaceId;
+        const updatedPayload = { ...existingPayload, space_id: spaceId, quality_metrics: updatedMetrics, attest_boost, updated_at: new Date().toISOString() };
+        await this.engine.upsertPoint({ id: row.id, payload: updatedPayload, vector: vectorsFromRow(row) });
+    }
+    async updateQualityMetadata(id, qualityMetadata) {
+        const row = await this.loadAccessibleRow(id, `Memory with ID ${id} not found for quality metadata update`);
+        const existingPayload = payloadOf(row);
+        const updatedQualityMetadata = { ...(existingPayload.quality_metadata || {}), ...qualityMetadata };
+        const spaceId = existingPayload.space_id ?? getSpaceContext().defaultWriteSpaceId;
+        const updatedPayload = { ...existingPayload, space_id: spaceId, quality_metadata: updatedQualityMetadata, updated_at: new Date().toISOString() };
+        await this.engine.upsertPoint({ id: row.id, payload: updatedPayload, vector: vectorsFromRow(row) });
+    }
+    /** Resolve a completion layer's adapter head and propagate reward to it. */
+    async propagateRewardToAdapterHead(stepPointId, metricsUpdate) {
+        const stepRow = await this.engine.retrieveRaw(validateAndConvertId(stepPointId));
+        if (!stepRow || !isAccessible(stepRow))
+            return null;
+        const payload = payloadOf(stepRow);
+        const adapterId = payload['adapter']?.id;
+        if (!adapterId || typeof adapterId !== 'string')
+            return null;
+        const layerIndex = payload['adapter']?.layer_index;
+        if (layerIndex === 1)
+            return null;
+        const heads = await this.engine.scroll(buildSpaceFilter(getSpaceContext().allowedSpaceIds, {
+            must: [
+                { key: 'adapter.id', match: { value: adapterId } },
+                { key: 'adapter.layer_index', match: { value: 1 } }
+            ]
+        }), 1);
+        if (heads.length === 0) {
+            logger.warn(`[reward-propagation] Adapter head not found for adapter ${adapterId}, skip propagation`);
+            return null;
+        }
+        const adapterHeadId = heads[0].id;
+        await this.updateQualityMetrics(adapterHeadId, metricsUpdate);
+        try {
+            await redisCacheService.invalidateBeginCache();
+        }
+        catch (cacheErr) {
+            logger.warn(`[reward-propagation] Cache invalidation failed after adapter head update (adapterHeadId=${adapterHeadId}): ${cacheErr instanceof Error ? cacheErr.message : String(cacheErr)}`);
+        }
+        return adapterHeadId;
+    }
+    /** Attach a payload patch (e.g. content hash) to a set of layer points. */
+    async setPayloadOnLayers(layerIds, patch) {
+        const points = [];
+        for (const rawId of layerIds) {
+            const row = await this.engine.retrieveRaw(validateAndConvertId(rawId));
+            if (!row)
+                continue;
+            points.push({ id: row.id, payload: { ...payloadOf(row), ...patch }, vector: vectorsFromRow(row) });
+        }
+        await this.engine.putPoints(points);
+    }
+    /** Delete app-space points matching a slug. */
+    async deleteAppSpaceBySlug(slug) {
+        await this.engine.deleteByFilter({
+            must: [
+                { key: 'slug', match: { value: slug } },
+                { key: 'space_id', match: { value: SQUADRULES_APP_SPACE_ID } }
+            ]
+        });
+    }
+    /** Delete app-space points matching an adapter id. */
+    async deleteAppSpaceByAdapterId(adapterId) {
+        await this.engine.deleteByFilter({
+            must: [
+                { key: 'adapter.id', match: { value: adapterId } },
+                { key: 'space_id', match: { value: SQUADRULES_APP_SPACE_ID } }
+            ]
+        });
+    }
+}
+//# sourceMappingURL=lance-records-mutations.js.map