pulseed 0.6.4 → 0.6.6

package/dist/platform/knowledge/types/embedding.js

@@ -8,7 +8,7 @@ export const EmbeddingConfigSchema = z.object({
 export const EmbeddingEntrySchema = z.object({
     id: z.string(),
     text: z.string(),
-    vector: z.array(z.number()),
+    vector: z.array(z.number().finite()),
     model: z.string(),
     created_at: z.string(),
     metadata: z.record(z.string(), z.unknown()).default({}),
@@ -16,7 +16,7 @@ export const EmbeddingEntrySchema = z.object({
 export const VectorSearchResultSchema = z.object({
     id: z.string(),
     text: z.string(),
-    similarity: z.number(),
+    similarity: z.number().finite(),
     metadata: z.record(z.string(), z.unknown()).default({}),
 });
 //# sourceMappingURL=embedding.js.map

package/dist/platform/knowledge/types/embedding.js.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.js","sourceRoot":"","sources":["../../../../src/platform/knowledge/types/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC"}
+{"version":3,"file":"embedding.js","sourceRoot":"","sources":["../../../../src/platform/knowledge/types/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC"}

package/dist/platform/knowledge/types/memory-lifecycle.d.ts

@@ -65,7 +65,7 @@ export declare const ShortTermEntrySchema: z.ZodObject<{
     data: Record<string, unknown>;
     tags: string[];
     embedding_id: string | null;
-    data_type: "observation" | "task" | "experience_log" | "strategy" | "knowledge";
+    data_type: "observation" | "task" | "knowledge" | "experience_log" | "strategy";
     loop_number: number;
     memory_tier: "core" | "recall" | "archival";
 }, {
@@ -73,7 +73,7 @@ export declare const ShortTermEntrySchema: z.ZodObject<{
     id: string;
     goal_id: string;
     data: Record<string, unknown>;
-    data_type: "observation" | "task" | "experience_log" | "strategy" | "knowledge";
+    data_type: "observation" | "task" | "knowledge" | "experience_log" | "strategy";
     loop_number: number;
     dimensions?: string[] | undefined;
     tags?: string[] | undefined;
@@ -542,7 +542,7 @@ export declare const CompressionResultSchema: z.ZodObject<{
     compressed_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     goal_id: string;
-    data_type: "observation" | "task" | "experience_log" | "strategy" | "knowledge";
+    data_type: "observation" | "task" | "knowledge" | "experience_log" | "strategy";
     entries_compressed: number;
     lessons_generated: number;
     statistics_updated: boolean;
@@ -554,7 +554,7 @@ export declare const CompressionResultSchema: z.ZodObject<{
     compressed_at: string;
 }, {
     goal_id: string;
-    data_type: "observation" | "task" | "experience_log" | "strategy" | "knowledge";
+    data_type: "observation" | "task" | "knowledge" | "experience_log" | "strategy";
     entries_compressed: number;
     lessons_generated: number;
     statistics_updated: boolean;

package/dist/platform/knowledge/vector-index-state-migration.d.ts

@@ -0,0 +1,14 @@
+import { type RuntimeControlDbStoreOptions } from "../../runtime/store/control-db/index.js";
+export interface VectorIndexLegacyImportReport {
+    vectorIndexFiles: number;
+    importedEntries: number;
+    skippedAlreadyImported: number;
+    retiredExistingTypedState: number;
+    blockedSources: Array<{
+        sourceKind: string;
+        sourcePath: string;
+        reason: string;
+    }>;
+}
+export declare function importLegacyVectorIndexState(baseDir: string, options?: RuntimeControlDbStoreOptions): Promise<VectorIndexLegacyImportReport>;
+//# sourceMappingURL=vector-index-state-migration.d.ts.map

package/dist/platform/knowledge/vector-index-state-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index-state-migration.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/vector-index-state-migration.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,yCAAyC,CAAC;AAQjD,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnF;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,6BAA6B,CAAC,CAoGxC"}

package/dist/platform/knowledge/vector-index-state-migration.js

@@ -0,0 +1,132 @@
+import { createHash } from "node:crypto";
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { openControlDatabase, } from "../../runtime/store/control-db/index.js";
+import { EmbeddingEntrySchema } from "../../base/types/embedding.js";
+import { VectorIndexStateStore } from "./vector-index-state-store.js";
+const MIGRATION_NAME = "knowledge-vector-graph-runtime-state";
+const MIGRATION_VERSION = 26;
+const LEGACY_VECTOR_INDEX_FILE = path.join("memory", "vector-index.json");
+export async function importLegacyVectorIndexState(baseDir, options = {}) {
+    const controlDb = options.controlDb ?? await openControlDatabase({
+        baseDir: options.controlBaseDir ?? baseDir,
+        dbPath: options.controlDbPath,
+    });
+    const report = {
+        vectorIndexFiles: 0,
+        importedEntries: 0,
+        skippedAlreadyImported: 0,
+        retiredExistingTypedState: 0,
+        blockedSources: [],
+    };
+    try {
+        const filePath = path.join(baseDir, LEGACY_VECTOR_INDEX_FILE);
+        let payload;
+        try {
+            payload = await readLegacyTextFile(filePath);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return report;
+            blockImport(baseDir, filePath, LEGACY_VECTOR_INDEX_FILE, controlDb, report, error);
+            return report;
+        }
+        report.vectorIndexFiles = 1;
+        let rawEntries;
+        try {
+            rawEntries = JSON.parse(payload.raw);
+        }
+        catch (error) {
+            blockImport(baseDir, filePath, LEGACY_VECTOR_INDEX_FILE, controlDb, report, error, payload.checksum, payload.mtimeMs);
+            return report;
+        }
+        if (!Array.isArray(rawEntries)) {
+            blockImport(baseDir, filePath, LEGACY_VECTOR_INDEX_FILE, controlDb, report, new Error("legacy vector index file must contain an array"), payload.checksum, payload.mtimeMs);
+            return report;
+        }
+        const store = new VectorIndexStateStore(baseDir, { ...options, controlDb });
+        for (const [index, item] of rawEntries.entries()) {
+            const parsed = EmbeddingEntrySchema.safeParse(item);
+            const sourceId = parsed.success ? parsed.data.id : `${LEGACY_VECTOR_INDEX_FILE}#${index}`;
+            if (!parsed.success) {
+                blockImport(baseDir, filePath, sourceId, controlDb, report, parsed.error, payload.checksum, payload.mtimeMs);
+                continue;
+            }
+            if (hasCompletedLegacyImport(controlDb, parsed.data.id)) {
+                report.skippedAlreadyImported += 1;
+                continue;
+            }
+            const existingEntry = await store.load(parsed.data.id);
+            if (existingEntry !== null) {
+                report.retiredExistingTypedState += 1;
+                controlDb.recordLegacyImport({
+                    sourceKind: "vector_index_entry",
+                    sourceId: parsed.data.id,
+                    sourcePath: path.relative(baseDir, filePath),
+                    sourceChecksum: payload.checksum,
+                    sourceMtimeMs: payload.mtimeMs,
+                    migrationName: MIGRATION_NAME,
+                    migrationVersion: MIGRATION_VERSION,
+                    status: "retired",
+                    details: { reason: "typed vector index entry already exists" },
+                });
+                continue;
+            }
+            await store.save(parsed.data);
+            report.importedEntries += 1;
+            controlDb.recordLegacyImport({
+                sourceKind: "vector_index_entry",
+                sourceId: parsed.data.id,
+                sourcePath: path.relative(baseDir, filePath),
+                sourceChecksum: payload.checksum,
+                sourceMtimeMs: payload.mtimeMs,
+                migrationName: MIGRATION_NAME,
+                migrationVersion: MIGRATION_VERSION,
+                status: "imported",
+                details: {
+                    model: parsed.data.model,
+                    created_at: parsed.data.created_at,
+                },
+            });
+        }
+        return report;
+    }
+    finally {
+        if (!options.controlDb)
+            controlDb.close();
+    }
+}
+async function readLegacyTextFile(filePath) {
+    const [raw, stat] = await Promise.all([
+        fsp.readFile(filePath, "utf8"),
+        fsp.stat(filePath),
+    ]);
+    return {
+        raw,
+        checksum: createHash("sha256").update(raw, "utf8").digest("hex"),
+        mtimeMs: stat.mtimeMs,
+    };
+}
+function blockImport(baseDir, filePath, sourceId, controlDb, report, error, checksum, mtimeMs) {
+    const reason = error instanceof Error ? error.message : String(error);
+    const sourcePath = path.relative(baseDir, filePath);
+    report.blockedSources.push({ sourceKind: "vector_index_entry", sourcePath, reason });
+    controlDb.recordLegacyImport({
+        sourceKind: "vector_index_entry",
+        sourceId,
+        sourcePath,
+        sourceChecksum: checksum ?? null,
+        sourceMtimeMs: mtimeMs ?? null,
+        migrationName: MIGRATION_NAME,
+        migrationVersion: MIGRATION_VERSION,
+        status: "blocked",
+        details: { reason },
+    });
+}
+function hasCompletedLegacyImport(controlDb, sourceId) {
+    return controlDb.listLegacyImports().some((record) => record.source_kind === "vector_index_entry"
+        && record.source_id === sourceId
+        && record.migration_name === MIGRATION_NAME
+        && record.status === "imported");
+}
+//# sourceMappingURL=vector-index-state-migration.js.map

package/dist/platform/knowledge/vector-index-state-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index-state-migration.js","sourceRoot":"","sources":["../../../src/platform/knowledge/vector-index-state-migration.ts"],"names":[],"mappings":"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"}

package/dist/platform/knowledge/vector-index-state-store.d.ts

@@ -0,0 +1,19 @@
+import { type RuntimeControlDbStoreOptions } from "../../runtime/store/control-db/index.js";
+import { type EmbeddingEntry } from "../../base/types/embedding.js";
+export interface VectorIndexStateStoreOptions extends RuntimeControlDbStoreOptions {
+}
+export declare class VectorIndexStateStore {
+    private readonly baseDir;
+    private readonly options;
+    private dbPromise;
+    constructor(baseDir: string, options?: VectorIndexStateStoreOptions);
+    save(entry: EmbeddingEntry): Promise<EmbeddingEntry>;
+    saveMany(entries: readonly EmbeddingEntry[]): Promise<EmbeddingEntry[]>;
+    load(entryId: string): Promise<EmbeddingEntry | null>;
+    list(): Promise<EmbeddingEntry[]>;
+    remove(entryId: string): Promise<boolean>;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+    private database;
+}
+//# sourceMappingURL=vector-index-state-store.d.ts.map

package/dist/platform/knowledge/vector-index-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index-state-store.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/vector-index-state-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE1F,MAAM,WAAW,4BAA6B,SAAQ,4BAA4B;CAAG;AAUrF,qBAAa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,SAAS,CAAyC;gBAGvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,4BAAiC;IAGvD,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA+BpD,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAkCvE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAarD,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAYjC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,QAAQ;CAUvB"}

package/dist/platform/knowledge/vector-index-state-store.js

@@ -0,0 +1,124 @@
+import { openControlDatabase, } from "../../runtime/store/control-db/index.js";
+import { EmbeddingEntrySchema } from "../../base/types/embedding.js";
+function parseJson(value) {
+    return JSON.parse(value);
+}
+function stringifyJson(value) {
+    return JSON.stringify(value);
+}
+export class VectorIndexStateStore {
+    baseDir;
+    options;
+    dbPromise = null;
+    constructor(baseDir, options = {}) {
+        this.baseDir = baseDir;
+        this.options = options;
+    }
+    async save(entry) {
+        const parsed = EmbeddingEntrySchema.parse(entry);
+        const db = await this.database();
+        db.transaction((sqlite) => {
+            sqlite.prepare(`
+        INSERT INTO vector_index_entries (
+          entry_id,
+          model,
+          created_at,
+          metadata_json,
+          vector_json,
+          entry_json
+        ) VALUES (?, ?, ?, json(?), json(?), json(?))
+        ON CONFLICT(entry_id) DO UPDATE SET
+          model = excluded.model,
+          created_at = excluded.created_at,
+          metadata_json = excluded.metadata_json,
+          vector_json = excluded.vector_json,
+          entry_json = excluded.entry_json
+      `).run(parsed.id, parsed.model, parsed.created_at, stringifyJson(parsed.metadata ?? {}), stringifyJson(parsed.vector), stringifyJson(parsed));
+        });
+        return parsed;
+    }
+    async saveMany(entries) {
+        const parsed = entries.map((entry) => EmbeddingEntrySchema.parse(entry));
+        const db = await this.database();
+        db.transaction((sqlite) => {
+            const statement = sqlite.prepare(`
+        INSERT INTO vector_index_entries (
+          entry_id,
+          model,
+          created_at,
+          metadata_json,
+          vector_json,
+          entry_json
+        ) VALUES (?, ?, ?, json(?), json(?), json(?))
+        ON CONFLICT(entry_id) DO UPDATE SET
+          model = excluded.model,
+          created_at = excluded.created_at,
+          metadata_json = excluded.metadata_json,
+          vector_json = excluded.vector_json,
+          entry_json = excluded.entry_json
+      `);
+            for (const entry of parsed) {
+                statement.run(entry.id, entry.model, entry.created_at, stringifyJson(entry.metadata ?? {}), stringifyJson(entry.vector), stringifyJson(entry));
+            }
+        });
+        return parsed;
+    }
+    async load(entryId) {
+        const db = await this.database();
+        return db.read((sqlite) => {
+            const row = sqlite.prepare(`
+        SELECT entry_json
+        FROM vector_index_entries
+        WHERE entry_id = ?
+      `).get(entryId);
+            if (!row)
+                return null;
+            return EmbeddingEntrySchema.parse(parseJson(row.entry_json));
+        });
+    }
+    async list() {
+        const db = await this.database();
+        return db.read((sqlite) => {
+            const rows = sqlite.prepare(`
+        SELECT entry_json
+        FROM vector_index_entries
+        ORDER BY created_at ASC, entry_id ASC
+      `).all();
+            return rows.map((row) => EmbeddingEntrySchema.parse(parseJson(row.entry_json)));
+        });
+    }
+    async remove(entryId) {
+        const db = await this.database();
+        return db.transaction((sqlite) => {
+            const result = sqlite.prepare(`
+        DELETE FROM vector_index_entries
+        WHERE entry_id = ?
+      `).run(entryId);
+            return result.changes > 0;
+        });
+    }
+    async clear() {
+        const db = await this.database();
+        db.transaction((sqlite) => {
+            sqlite.prepare("DELETE FROM vector_index_entries").run();
+        });
+    }
+    async close() {
+        if (this.options.controlDb || !this.dbPromise)
+            return;
+        const db = await this.dbPromise;
+        db.close();
+        this.dbPromise = null;
+    }
+    async database() {
+        if (this.options.controlDb) {
+            return this.options.controlDb;
+        }
+        this.dbPromise ??= openControlDatabase({
+            baseDir: this.options.controlBaseDir ?? this.baseDir,
+            dbPath: this.options.controlDbPath,
+        });
+        return this.dbPromise;
+    }
+}
+//# sourceMappingURL=vector-index-state-store.js.map

package/dist/platform/knowledge/vector-index-state-store.js.map

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

package/dist/platform/knowledge/vector-index.d.ts

@@ -1,14 +1,19 @@
 import type { IEmbeddingClient } from "./embedding-client.js";
 import type { EmbeddingEntry, VectorSearchResult } from "../../base/types/embedding.js";
+import type { RuntimeControlDbStoreOptions } from "../../runtime/store/control-db/index.js";
+export interface VectorIndexOptions extends RuntimeControlDbStoreOptions {
+}
 export declare class VectorIndex {
-    private readonly indexPath;
     private readonly embeddingClient;
     private readonly entries;
-    constructor(indexPath: string, embeddingClient: IEmbeddingClient);
+    private readonly stateStore;
+    constructor(legacyFilePath: string, embeddingClient: IEmbeddingClient, options?: VectorIndexOptions);
     /**
-     * Factory method: constructs a VectorIndex and loads existing data from disk.
+     * Factory method: constructs a VectorIndex and loads existing data from the typed store.
+     * The path argument is retained for compatibility; normal runtime does not read or write it.
      */
-    static create(indexPath: string, embeddingClient: IEmbeddingClient): Promise<VectorIndex>;
+    static create(legacyFilePath: string, embeddingClient: IEmbeddingClient, options?: VectorIndexOptions): Promise<VectorIndex>;
+    static createForControlDb(baseDir: string, embeddingClient: IEmbeddingClient, options?: VectorIndexOptions): Promise<VectorIndex>;
     /**
      * Embed text and add an entry to the index.
      */
@@ -59,7 +64,7 @@ export declare class VectorIndex {
      * Remove all entries from the index and persist.
      */
     clear(): Promise<void>;
-    _load(): Promise<boolean>;
-    private _save;
+    close(): Promise<void>;
+    _load(): Promise<void>;
 }
 //# sourceMappingURL=vector-index.d.ts.map

package/dist/platform/knowledge/vector-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/vector-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAIxF,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;gBAG/C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,gBAAgB;IAMpD;;OAEG;WACU,MAAM,CACjB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,gBAAgB,GAChC,OAAO,CAAC,WAAW,CAAC;IAUvB;;OAEG;IACG,GAAG,CACP,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,cAAc,CAAC;IAe1B;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,EAChB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKhC;;OAEG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,GAAE,MAAU,EAChB,SAAS,GAAE,MAAY,GACtB,kBAAkB,EAAE;IAmBvB;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIhD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIpD;;;;OAIG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAW,EACjB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAKxF;;OAEG;IACH,sBAAsB,CACpB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,GAAE,MAAW,EACjB,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAY/E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;YAmBjB,KAAK;CASpB"}
+{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/vector-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGxF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAG5F,MAAM,WAAW,kBAAmB,SAAQ,4BAA4B;CAAG;AAE3E,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,eAAe;IALlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;gBAGjD,cAAc,EAAE,MAAM,EACL,eAAe,EAAE,gBAAgB,EAClD,OAAO,GAAE,kBAAuB;IAMlC;;;OAGG;WACU,MAAM,CACjB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,gBAAgB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC;WAMV,kBAAkB,CAC7B,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,gBAAgB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC;IASvB;;OAEG;IACG,GAAG,CACP,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,cAAc,CAAC;IAe1B;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,EAChB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKhC;;OAEG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,GAAE,MAAU,EAChB,SAAS,GAAE,MAAY,GACtB,kBAAkB,EAAE;IAmBvB;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIhD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIpD;;;;OAIG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAW,EACjB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAKxF;;OAEG;IACH,sBAAsB,CACpB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,GAAE,MAAW,EACjB,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAY/E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}

package/dist/platform/knowledge/vector-index.js

@@ -1,27 +1,31 @@
-import * as fsp from "node:fs/promises";
 import * as path from "node:path";
 import { EmbeddingEntrySchema } from "../../base/types/embedding.js";
 import { cosineSimilarity } from "./embedding-client.js";
+import { VectorIndexStateStore } from "./vector-index-state-store.js";
 export class VectorIndex {
-    indexPath;
     embeddingClient;
     entries = new Map();
-    constructor(indexPath, embeddingClient) {
-        this.indexPath = indexPath;
+    stateStore;
+    constructor(legacyFilePath, embeddingClient, options = {}) {
         this.embeddingClient = embeddingClient;
-        // Sync loading removed. Use VectorIndex.create() for async load on construction,
-        // or call _load() manually after construction.
+        const baseDir = options.controlBaseDir ?? path.dirname(legacyFilePath);
+        this.stateStore = new VectorIndexStateStore(baseDir, options);
     }
     /**
-     * Factory method: constructs a VectorIndex and loads existing data from disk.
+     * Factory method: constructs a VectorIndex and loads existing data from the typed store.
+     * The path argument is retained for compatibility; normal runtime does not read or write it.
      */
-    static async create(indexPath, embeddingClient) {
-        const index = new VectorIndex(indexPath, embeddingClient);
-        const fileExisted = await index._load();
-        if (!fileExisted) {
-            // Persist empty index on first run so the file exists for next time
-            await index._save();
-        }
+    static async create(legacyFilePath, embeddingClient, options = {}) {
+        const index = new VectorIndex(legacyFilePath, embeddingClient, options);
+        await index._load();
+        return index;
+    }
+    static async createForControlDb(baseDir, embeddingClient, options = {}) {
+        const index = new VectorIndex(path.join(baseDir, "control.sqlite"), embeddingClient, {
+            ...options,
+            controlBaseDir: options.controlBaseDir ?? baseDir,
+        });
+        await index._load();
         return index;
     }
     /**
@@ -38,7 +42,7 @@ export class VectorIndex {
             metadata,
         });
         this.entries.set(id, entry);
-        await this._save();
+        await this.stateStore.save(entry);
         return entry;
     }
     /**
@@ -74,7 +78,7 @@ export class VectorIndex {
         const existed = this.entries.has(id);
         if (existed) {
             this.entries.delete(id);
-            await this._save();
+            await this.stateStore.remove(id);
         }
         return existed;
     }
@@ -124,35 +128,21 @@ export class VectorIndex {
      */
     async clear() {
         this.entries.clear();
-        await this._save();
+        await this.stateStore.clear();
+    }
+    async close() {
+        await this.stateStore.close();
     }
     async _load() {
+        this.entries.clear();
         try {
-            await fsp.access(this.indexPath);
-        }
-        catch {
-            return false;
-        }
-        try {
-            const raw = await fsp.readFile(this.indexPath, "utf-8");
-            const parsed = JSON.parse(raw);
-            for (const item of parsed) {
-                const entry = EmbeddingEntrySchema.parse(item);
+            for (const entry of await this.stateStore.list()) {
                 this.entries.set(entry.id, entry);
             }
         }
         catch {
-            // Corrupt or empty file — start fresh
+            // Corrupt typed rows or unavailable store: keep semantic search disabled for this instance.
         }
-        return true;
-    }
-    async _save() {
-        const dir = path.dirname(this.indexPath);
-        await fsp.mkdir(dir, { recursive: true });
-        const data = JSON.stringify(Array.from(this.entries.values()), null, 2);
-        const tmpPath = `${this.indexPath}.tmp`;
-        await fsp.writeFile(tmpPath, data, "utf-8");
-        await fsp.rename(tmpPath, this.indexPath);
     }
 }
 //# sourceMappingURL=vector-index.js.map

package/dist/platform/knowledge/vector-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"vector-index.js","sourceRoot":"","sources":["../../../src/platform/knowledge/vector-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,OAAO,WAAW;IAIH;IACA;IAJF,OAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IAElE,YACmB,SAAiB,EACjB,eAAiC;QADjC,cAAS,GAAT,SAAS,CAAQ;QACjB,oBAAe,GAAf,eAAe,CAAkB;QAElD,iFAAiF;QACjF,+CAA+C;IACjD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,SAAiB,EACjB,eAAiC;QAEjC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,oEAAoE;YACpE,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,EAAU,EACV,IAAY,EACZ,WAAoC,EAAE;QAEtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,KAAK,GAAmB,oBAAoB,CAAC,KAAK,CAAC;YACvD,EAAE;YACF,IAAI;YACJ,MAAM;YACN,KAAK,EAAE,WAAW;YAClB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,QAAQ;SACT,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAAe,CAAC,EAChB,YAAoB,GAAG;QAEvB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,WAAqB,EACrB,OAAe,CAAC,EAChB,YAAoB,GAAG;QAEvB,MAAM,OAAO,GAAyB,EAAE,CAAC;QAEzC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC;oBACX,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,UAAU;oBACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,OAAe,EAAE,EACjB,YAAoB,GAAG;QAEvB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,sBAAsB,CACpB,WAAqB,EACrB,OAAe,EAAE,EACjB,YAAoB,GAAG;QAEvB,MAAM,OAAO,GAAiF,EAAE,CAAC;QACjG,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;YACxD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,KAAK;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,MAAM,CAAC;QACxC,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;CACF"}
+{"version":3,"file":"vector-index.js","sourceRoot":"","sources":["../../../src/platform/knowledge/vector-index.ts"],"names":[],"mappings":"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"}

package/dist/platform/observation/capability-dependencies.d.ts

@@ -1,15 +1,16 @@
 import { StateManager } from "../../base/state/state-manager.js";
 import type { CapabilityDependency, CapabilityGap } from "../../base/types/capability.js";
+import { type CapabilityDependencyStateStorePort } from "../../runtime/store/capability-registry-state-store.js";
 export interface DependencyDeps {
     stateManager: StateManager;
+    capabilityDependencyStore?: CapabilityDependencyStateStorePort;
 }
 /**
- * Reads the capability dependency map from disk.
- * Returns an empty array if the file does not exist.
+ * Reads the capability dependency map from the typed capability registry store.
  */
 export declare function loadDependencies(deps: DependencyDeps): Promise<CapabilityDependency[]>;
 /**
- * Persists the dependency map to disk.
+ * Persists the dependency map to the typed capability registry store.
  */
 export declare function saveDependencies(deps: DependencyDeps, dependencies: CapabilityDependency[]): Promise<void>;
 /**

package/dist/platform/observation/capability-dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-dependencies.d.ts","sourceRoot":"","sources":["../../../src/platform/observation/capability-dependencies.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAQ1F,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAID;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAS5F;AAID;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhH;AAID;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CAUf;AAID;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAInG;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,CAgElF;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAqD9F;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,aAAa,EAAE,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CAqC1B"}
+{"version":3,"file":"capability-dependencies.d.ts","sourceRoot":"","sources":["../../../src/platform/observation/capability-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAEL,KAAK,kCAAkC,EACxC,MAAM,wDAAwD,CAAC;AAIhE,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,yBAAyB,CAAC,EAAE,kCAAkC,CAAC;CAChE;AAID;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAE5F;AAID;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhH;AAID;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CAUf;AAID;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAInG;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,CAgElF;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAqD9F;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,aAAa,EAAE,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CAqC1B"}

package/dist/platform/observation/capability-dependencies.js

@@ -1,27 +1,17 @@
-import { z } from "zod";
-// ─── Constants ───
-const DEPENDENCIES_PATH = "capability_dependencies.json";
+import { CapabilityRegistryStateStore, } from "../../runtime/store/capability-registry-state-store.js";
 // ─── loadDependencies ───
 /**
- * Reads the capability dependency map from disk.
- * Returns an empty array if the file does not exist.
+ * Reads the capability dependency map from the typed capability registry store.
  */
 export async function loadDependencies(deps) {
-    const raw = await deps.stateManager.readRaw(DEPENDENCIES_PATH);
-    if (raw === null) {
-        return [];
-    }
-    const parsed = z
-        .array(z.object({ capability_id: z.string(), depends_on: z.array(z.string()) }))
-        .safeParse(raw);
-    return parsed.success ? parsed.data : [];
+    return dependencyStore(deps).loadDependencies();
 }
 // ─── saveDependencies ───
 /**
- * Persists the dependency map to disk.
+ * Persists the dependency map to the typed capability registry store.
  */
 export async function saveDependencies(deps, dependencies) {
-    await deps.stateManager.writeRaw(DEPENDENCIES_PATH, dependencies);
+    await dependencyStore(deps).saveDependencies(dependencies);
 }
 // ─── addDependency ───
 /**
@@ -205,4 +195,7 @@ export async function getAcquisitionOrder(deps, gaps) {
         .filter((g) => g !== undefined);
     return [...independent, ...dependent];
 }
+function dependencyStore(deps) {
+    return deps.capabilityDependencyStore ?? new CapabilityRegistryStateStore(deps.stateManager.getBaseDir());
+}
 //# sourceMappingURL=capability-dependencies.js.map