@tencentdb-agent-memory/memory-tencentdb/scripts/migrate-sqlite-to-tcvdb/dist/src/utils/manifest.js

Four-layer local memory system plugin for OpenClaw — auto-captures, structures, and profiles conversational knowledge using local LLM + SQLite vector search (L0→L1→L2→L3 pipeline)

/**
 * Manifest — self-describing metadata for a memory-tdai data directory.
 *
 * Lives at `<dataDir>/.metadata/manifest.json`.
 *
 * - **store**: written once on first successful store init; never overwritten.
 *   On subsequent starts the current config is compared against the persisted
 *   store binding — mismatches are logged at debug level (informational only).
 * - **seed**: written once when a seed run completes; null for live-runtime dirs.
 *
 * This file is informational / read-only from the user's perspective.
 * The plugin reads it on startup for consistency checks.
 */
import fs from "node:fs";
import path from "node:path";
// ============================
// Paths
// ============================
const METADATA_DIR = ".metadata";
const MANIFEST_FILE = "manifest.json";
export function manifestPath(dataDir) {
    return path.join(dataDir, METADATA_DIR, MANIFEST_FILE);
}
// ============================
// Read / Write
// ============================
/**
 * Read an existing manifest from disk. Returns `null` if not found or unparseable.
 */
export function readManifest(dataDir) {
    const p = manifestPath(dataDir);
    try {
        if (!fs.existsSync(p))
            return null;
        const raw = fs.readFileSync(p, "utf-8");
        return JSON.parse(raw);
    }
    catch {
        return null;
    }
}
/**
 * Write a manifest to disk (creates `.metadata/` if needed).
 */
export function writeManifest(dataDir, manifest) {
    const dir = path.join(dataDir, METADATA_DIR);
    fs.mkdirSync(dir, { recursive: true });
    fs.writeFileSync(manifestPath(dataDir), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
}
/**
 * Build a ManifestStoreInfo from the current store config snapshot.
 */
export function buildStoreInfo(snapshot) {
    const info = { type: snapshot.type };
    if (snapshot.type === "sqlite") {
        info.sqlite = { path: snapshot.sqlitePath ?? "vectors.db" };
    }
    else {
        info.tcvdb = {
            url: snapshot.tcvdbUrl,
            database: snapshot.tcvdbDatabase,
            alias: snapshot.tcvdbAlias || undefined,
        };
    }
    return info;
}
/**
 * Compare the persisted store binding against the current config.
 * Returns a list of human-readable mismatch descriptions (empty = all good).
 */
export function diffStoreBinding(persisted, current) {
    const diffs = [];
    if (persisted.type !== current.type) {
        diffs.push(`store type changed: ${persisted.type} → ${current.type}`);
        return diffs; // no point comparing fields across different types
    }
    if (persisted.type === "sqlite" && current.type === "sqlite") {
        if (persisted.sqlite?.path !== current.sqlite?.path) {
            diffs.push(`sqlite path changed: ${persisted.sqlite?.path} → ${current.sqlite?.path}`);
        }
    }
    if (persisted.type === "tcvdb" && current.type === "tcvdb") {
        if (persisted.tcvdb?.url !== current.tcvdb?.url) {
            diffs.push(`tcvdb url changed: ${persisted.tcvdb?.url} → ${current.tcvdb?.url}`);
        }
        if (persisted.tcvdb?.database !== current.tcvdb?.database) {
            diffs.push(`tcvdb database changed: ${persisted.tcvdb?.database} → ${current.tcvdb?.database}`);
        }
    }
    return diffs;
}