@co-engram/core 0.1.2 → 0.1.4

package/dist/bootstrap/classify.d.ts

@@ -0,0 +1,73 @@
+/**
+ * dataRoot 路径分类与切换逻辑(CLI + viewer UI 共享)
+ *
+ * 从 `@co-engram/claude-code/cli.ts` 提取,让 viewer 的 PUT /api/config 也能安全地
+ * 修改 dataRoot。两入口共享同一份验证 + 初始化 + 写 bootstrap 逻辑,保证行为一致。
+ *
+ * @module @co-engram/core/bootstrap
+ */
+import type { Language } from "../i18n/index.js";
+/** 目标路径分类结果 */
+export type TargetPathClassification = "missing" | "empty" | "engram-warehouse" | "non-engram";
+/**
+ * 探测目标路径状态,返回分类结果
+ *
+ * 分类:
+ *   - 'missing':路径不存在
+ *   - 'empty':存在但完全空(可立即接管)
+ *   - 'engram-warehouse':已是 co-engram 仓库(有 .co-engram/config.json)
+ *   - 'non-engram':有其他文件,可能是用户用作他途
+ */
+export declare function classifyTargetPath(targetPath: string): TargetPathClassification;
+/**
+ * 初始化一个空的 team-memory 目录(创建 .co-engram/config.json)
+ *
+ * 用于首次切换到新 dataRoot 时。失败抛错。
+ */
+export declare function initializeEmptyWarehouse(targetPath: string, options?: {
+    readonly createdBy?: string;
+    readonly language?: Language;
+}): Promise<void>;
+/** applyDataRootChange 成功结果 */
+export interface ApplyDataRootSuccessResult {
+    readonly ok: true;
+    readonly dataRoot: string;
+    readonly classification: TargetPathClassification;
+    readonly initialized: boolean;
+}
+/** applyDataRootChange 失败结果 */
+export interface ApplyDataRootFailureResult {
+    readonly ok: false;
+    readonly error: string;
+    readonly reason: "non-engram" | "invalid" | "init-failed";
+    /**
+     * non-engram 失败时附带:目标目录里现有的文件/子目录名(最多 10 个)+ 总数。
+     * UI 用它给用户展示"将接管此目录,你的这些文件不会被改动",让用户二次确认。
+     */
+    readonly existingFiles?: readonly string[];
+    readonly existingCount?: number;
+}
+/** applyDataRootChange 结果 */
+export type ApplyDataRootResult = ApplyDataRootSuccessResult | ApplyDataRootFailureResult;
+/**
+ * 应用 dataRoot 变更:验证 + 初始化(若需) + 写 bootstrap config
+ *
+ * 用于 CLI `co-engram config data-root <path>` 和 viewer PUT /api/config。
+ *
+ * 行为:
+ *   - 'missing' / 'empty':mkdir + initializeEmptyWarehouse + writeBootstrap
+ *   - 'engram-warehouse':直接 writeBootstrap(不重新初始化,保留已有数据)
+ *   - 'non-engram' + force=true:mkdir + initializeEmptyWarehouse + writeBootstrap
+ *   - 'non-engram' + force=false:拒绝,返回 reason='non-engram'
+ *
+ * @param rawPath 用户输入的路径(相对或绝对)
+ * @param opts.force 是否强制接管非空非 co-engram 目录(UI 默认 false,CLI 支持 --force)
+ * @param opts.createdBy 可选,初始化空 warehouse 时的 defaultCreatedBy
+ * @param opts.language 可选,初始化空 warehouse 时的 language
+ */
+export declare function applyDataRootChange(rawPath: string, options?: {
+    readonly force?: boolean;
+    readonly createdBy?: string;
+    readonly language?: Language;
+}): Promise<ApplyDataRootResult>;
+//# sourceMappingURL=classify.d.ts.map

package/dist/bootstrap/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/bootstrap/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,eAAe;AACf,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,OAAO,GACP,kBAAkB,GAClB,YAAY,CAAC;AAEjB;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAc1B;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAO,GAC1E,OAAO,CAAC,IAAI,CAAC,CAef;AAED,+BAA+B;AAC/B,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,+BAA+B;AAC/B,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC;IAC1D;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,6BAA6B;AAC7B,MAAM,MAAM,mBAAmB,GAC3B,0BAA0B,GAC1B,0BAA0B,CAAC;AAE/B;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAO,GACpG,OAAO,CAAC,mBAAmB,CAAC,CA4D9B"}

package/dist/bootstrap/classify.js

@@ -0,0 +1,134 @@
+/**
+ * dataRoot 路径分类与切换逻辑(CLI + viewer UI 共享)
+ *
+ * 从 `@co-engram/claude-code/cli.ts` 提取,让 viewer 的 PUT /api/config 也能安全地
+ * 修改 dataRoot。两入口共享同一份验证 + 初始化 + 写 bootstrap 逻辑,保证行为一致。
+ *
+ * @module @co-engram/core/bootstrap
+ */
+import { existsSync, mkdirSync, readdirSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { writeTeamMemoryConfig } from "../config/index.js";
+import { detectGitAuthor } from "../host/detect-git-author.js";
+import { DEFAULT_LANGUAGE } from "../i18n/index.js";
+import { writeBootstrapDataRoot } from "./index.js";
+/**
+ * 探测目标路径状态,返回分类结果
+ *
+ * 分类:
+ *   - 'missing':路径不存在
+ *   - 'empty':存在但完全空(可立即接管)
+ *   - 'engram-warehouse':已是 co-engram 仓库(有 .co-engram/config.json)
+ *   - 'non-engram':有其他文件,可能是用户用作他途
+ */
+export function classifyTargetPath(targetPath) {
+    if (!existsSync(targetPath))
+        return "missing";
+    let entries;
+    try {
+        entries = readdirSync(targetPath);
+    }
+    catch {
+        return "non-engram";
+    }
+    if (entries.length === 0)
+        return "empty";
+    const hasCoEngramConfig = existsSync(resolve(targetPath, ".co-engram", "config.json"));
+    if (hasCoEngramConfig)
+        return "engram-warehouse";
+    return "non-engram";
+}
+/**
+ * 初始化一个空的 team-memory 目录(创建 .co-engram/config.json)
+ *
+ * 用于首次切换到新 dataRoot 时。失败抛错。
+ */
+export async function initializeEmptyWarehouse(targetPath, options = {}) {
+    const createdBy = options.createdBy ??
+        detectGitAuthor() ??
+        process.env.USER ??
+        "unknown";
+    const language = options.language ?? DEFAULT_LANGUAGE;
+    mkdirSync(resolve(targetPath, ".co-engram"), { recursive: true });
+    await writeTeamMemoryConfig(targetPath, {
+        version: 1,
+        language,
+        defaultCreatedBy: createdBy,
+        createdAt: new Date().toISOString(),
+        initializedBy: "co-engram-cli",
+    });
+}
+/**
+ * 应用 dataRoot 变更:验证 + 初始化(若需) + 写 bootstrap config
+ *
+ * 用于 CLI `co-engram config data-root <path>` 和 viewer PUT /api/config。
+ *
+ * 行为:
+ *   - 'missing' / 'empty':mkdir + initializeEmptyWarehouse + writeBootstrap
+ *   - 'engram-warehouse':直接 writeBootstrap(不重新初始化,保留已有数据)
+ *   - 'non-engram' + force=true:mkdir + initializeEmptyWarehouse + writeBootstrap
+ *   - 'non-engram' + force=false:拒绝,返回 reason='non-engram'
+ *
+ * @param rawPath 用户输入的路径(相对或绝对)
+ * @param opts.force 是否强制接管非空非 co-engram 目录(UI 默认 false,CLI 支持 --force)
+ * @param opts.createdBy 可选,初始化空 warehouse 时的 defaultCreatedBy
+ * @param opts.language 可选,初始化空 warehouse 时的 language
+ */
+export async function applyDataRootChange(rawPath, options = {}) {
+    const trimmed = rawPath.trim();
+    if (!trimmed) {
+        return { ok: false, error: "Path is empty", reason: "invalid" };
+    }
+    const newPath = isAbsolute(trimmed) ? trimmed : resolve(trimmed);
+    const classification = classifyTargetPath(newPath);
+    if (classification === "non-engram" && !options.force) {
+        // 收集目录里现有的文件/子目录名(最多 10 个),让 UI 展示给用户。
+        // co-engram 接管时只在目录里创建 .co-engram/ 子目录,不会触碰这些文件;
+        // 但仍需让用户清楚地"看到自己在接管什么",二次确认后再 force=true 重发。
+        let existingFiles = [];
+        let existingCount = 0;
+        try {
+            const all = readdirSync(newPath);
+            existingCount = all.length;
+            existingFiles = all.slice(0, 10);
+        }
+        catch {
+            // 读失败就空数组返回,UI 仍可继续(基于 reason 给出二次确认)
+        }
+        return {
+            ok: false,
+            error: `Directory ${newPath} exists but is not a co-engram warehouse (no .co-engram/config.json). It may contain unrelated user data. Use --force (CLI) to take over.`,
+            reason: "non-engram",
+            existingFiles,
+            existingCount,
+        };
+    }
+    let initialized = false;
+    if (classification === "missing" ||
+        classification === "empty" ||
+        classification === "non-engram") {
+        mkdirSync(newPath, { recursive: true });
+        try {
+            await initializeEmptyWarehouse(newPath, {
+                ...(options.createdBy ? { createdBy: options.createdBy } : {}),
+                ...(options.language ? { language: options.language } : {}),
+            });
+            initialized = true;
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: `Failed to initialize warehouse: ${err instanceof Error ? err.message : String(err)}`,
+                reason: "init-failed",
+            };
+        }
+    }
+    await writeBootstrapDataRoot(newPath);
+    return {
+        ok: true,
+        dataRoot: newPath,
+        classification,
+        initialized,
+    };
+}
+//# sourceMappingURL=classify.js.map

package/dist/bootstrap/classify.js.map

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

package/dist/bootstrap/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Bootstrap 配置:dataRoot 的单一权威入口
+ *
+ * 设计动机:
+ *   co-engram 启动时需要先找到 dataRoot,但 dataRoot 内的 `.co-engram/config.json`
+ *   又保存了大部分配置 —— "鸡生蛋" 问题。本模块解决这个悖论:
+ *
+ *   - **bootstrap 配置文件位置固定**:`~/.co-engram/config.json`(用户 home 下,
+ *     不在 dataRoot 内),只保存 dataRoot 一个字段
+ *   - **单一权威入口**:用户通过 `co-engram config data-root <path>` CLI 命令修改
+ *   - **不再支持 env / openclaw.json / viewer UI 修改 dataRoot**(避免多处入口造成混乱)
+ *
+ * 解析优先级:
+ *   1. `~/.co-engram/config.json:dataRoot`(权威)
+ *   2. `$HOME/team-memory`(默认 fallback)
+ *
+ * 异常处理:
+ *   - bootstrap 文件不存在 → fallback 到默认 + warning(首次运行场景)
+ *   - bootstrap 文件损坏 → 备份后重建 + warning
+ *   - dataRoot 字段缺失 → fallback 到默认 + warning
+ *
+ * @module @co-engram/core/bootstrap
+ */
+/** bootstrap 配置文件名 */
+export declare const BOOTSTRAP_CONFIG_FILENAME = "config.json";
+/** bootstrap 配置目录(用户 home 下,固定) */
+export declare function getBootstrapDir(): string;
+/** bootstrap 配置文件完整路径 */
+export declare function getBootstrapConfigPath(): string;
+/** 默认 dataRoot fallback */
+export declare function getDefaultDataRoot(): string;
+/** bootstrap 配置 schema */
+export interface BootstrapConfig {
+    /** schema 版本 */
+    readonly version: 1;
+    /** 数据根目录(绝对路径) */
+    readonly dataRoot: string;
+}
+/** resolve 结果来源标签 */
+export type BootstrapSource = "bootstrap-config" | "default" | "repaired";
+/** resolve 结果 */
+export interface BootstrapResolveResult {
+    /** 解析后的 dataRoot(绝对路径) */
+    readonly dataRoot: string;
+    /** 来源 */
+    readonly source: BootstrapSource;
+    /** 用户可读的 warning 列表(stderr 输出用) */
+    readonly warnings: readonly string[];
+}
+/**
+ * 解析当前 dataRoot
+ *
+ * 调用方:mcp-server / openclaw plugin-entry 启动时调用一次,
+ * 拿到 dataRoot 后再 loadAndSelfHealConfig 加载完整配置。
+ */
+export declare function resolveBootstrapDataRoot(): Promise<BootstrapResolveResult>;
+/**
+ * 写入 bootstrap dataRoot(CLI 调用)
+ *
+ * 创建父目录,完整覆盖文件。
+ */
+export declare function writeBootstrapDataRoot(dataRoot: string): Promise<void>;
+/**
+ * 读取 bootstrap dataRoot(同步,无错误抛出)
+ *
+ * CLI 显示当前值时使用。文件不存在或损坏返回 undefined。
+ */
+export declare function readBootstrapDataRootSync(): string | undefined;
+/** 同步 resolve 结果来源标签 */
+export type BootstrapSourceSync = "bootstrap-config" | "default" | "repaired";
+/** 同步 resolve 结果(用于 OpenClaw 等要求 register 同步的宿主) */
+export interface BootstrapResolveSyncResult {
+    /** 解析后的 dataRoot(绝对路径) */
+    readonly dataRoot: string;
+    /** 来源 */
+    readonly source: BootstrapSourceSync;
+    /** 用户可读的 warning 列表(stderr 输出用) */
+    readonly warnings: readonly string[];
+}
+/**
+ * 同步解析当前 dataRoot
+ *
+ * OpenClaw 1.8+ 要求 plugin register() 同步完成,无法 await 异步 fs,
+ * 这里用 readFileSync 替代。功能与 resolveBootstrapDataRoot 等价,
+ * 但损坏文件时不做备份重建(只读 + warning)—— 重建由下次 CLI 调用完成。
+ */
+export declare function resolveBootstrapDataRootSync(): BootstrapResolveSyncResult;
+export * from "./classify.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/bootstrap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bootstrap/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,sBAAsB;AACtB,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD,mCAAmC;AACnC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,yBAAyB;AACzB,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,2BAA2B;AAC3B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,0BAA0B;AAC1B,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAqB;AACrB,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,SAAS,GACT,UAAU,CAAC;AAEf,iBAAiB;AACjB,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,SAAS;IACT,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAgDhF;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,SAAS,CAa9D;AAED,wBAAwB;AACxB,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,SAAS,GACT,UAAU,CAAC;AAEf,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,SAAS;IACT,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,IAAI,0BAA0B,CAuCzE;AAGD,cAAc,eAAe,CAAC"}

package/dist/bootstrap/index.js

@@ -0,0 +1,158 @@
+/**
+ * Bootstrap 配置:dataRoot 的单一权威入口
+ *
+ * 设计动机:
+ *   co-engram 启动时需要先找到 dataRoot,但 dataRoot 内的 `.co-engram/config.json`
+ *   又保存了大部分配置 —— "鸡生蛋" 问题。本模块解决这个悖论:
+ *
+ *   - **bootstrap 配置文件位置固定**:`~/.co-engram/config.json`(用户 home 下,
+ *     不在 dataRoot 内),只保存 dataRoot 一个字段
+ *   - **单一权威入口**:用户通过 `co-engram config data-root <path>` CLI 命令修改
+ *   - **不再支持 env / openclaw.json / viewer UI 修改 dataRoot**(避免多处入口造成混乱)
+ *
+ * 解析优先级:
+ *   1. `~/.co-engram/config.json:dataRoot`(权威)
+ *   2. `$HOME/team-memory`(默认 fallback)
+ *
+ * 异常处理:
+ *   - bootstrap 文件不存在 → fallback 到默认 + warning(首次运行场景)
+ *   - bootstrap 文件损坏 → 备份后重建 + warning
+ *   - dataRoot 字段缺失 → fallback 到默认 + warning
+ *
+ * @module @co-engram/core/bootstrap
+ */
+import { readFile, writeFile, mkdir, rename } from "node:fs/promises";
+import { readFileSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+/** bootstrap 配置文件名 */
+export const BOOTSTRAP_CONFIG_FILENAME = "config.json";
+/** bootstrap 配置目录(用户 home 下,固定) */
+export function getBootstrapDir() {
+    return join(process.env.HOME ?? "/tmp", ".co-engram");
+}
+/** bootstrap 配置文件完整路径 */
+export function getBootstrapConfigPath() {
+    return join(getBootstrapDir(), BOOTSTRAP_CONFIG_FILENAME);
+}
+/** 默认 dataRoot fallback */
+export function getDefaultDataRoot() {
+    return join(process.env.HOME ?? "/tmp", "team-memory");
+}
+/**
+ * 解析当前 dataRoot
+ *
+ * 调用方:mcp-server / openclaw plugin-entry 启动时调用一次,
+ * 拿到 dataRoot 后再 loadAndSelfHealConfig 加载完整配置。
+ */
+export async function resolveBootstrapDataRoot() {
+    const path = getBootstrapConfigPath();
+    const defaultRoot = getDefaultDataRoot();
+    const warnings = [];
+    if (!existsSync(path)) {
+        // 首次运行 / 配置被删除:fallback 到默认,提示用户运行 CLI 配置
+        warnings.push(`Bootstrap config not found at ${path}. Using default ${defaultRoot}. Run 'co-engram config data-root <path>' to change.`);
+        return { dataRoot: defaultRoot, source: "default", warnings };
+    }
+    let raw;
+    try {
+        const content = await readFile(path, "utf-8");
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === "object" && parsed.version === 1) {
+            raw = parsed;
+        }
+    }
+    catch {
+        // JSON 损坏:备份后重建
+    }
+    if (raw === undefined) {
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        const backupPath = `${path}.broken.${ts}`;
+        try {
+            await rename(path, backupPath);
+        }
+        catch {
+            // 备份失败不阻塞
+        }
+        await writeBootstrapDataRoot(defaultRoot);
+        warnings.push(`Bootstrap config at ${path} was corrupt; backed up to ${backupPath}. Using default ${defaultRoot}.`);
+        return { dataRoot: defaultRoot, source: "repaired", warnings };
+    }
+    const dataRoot = raw.dataRoot?.trim();
+    if (!dataRoot) {
+        warnings.push(`Bootstrap config at ${path} has no dataRoot field; using default ${defaultRoot}.`);
+        return { dataRoot: defaultRoot, source: "default", warnings };
+    }
+    return { dataRoot, source: "bootstrap-config", warnings };
+}
+/**
+ * 写入 bootstrap dataRoot(CLI 调用)
+ *
+ * 创建父目录,完整覆盖文件。
+ */
+export async function writeBootstrapDataRoot(dataRoot) {
+    const path = getBootstrapConfigPath();
+    const config = { version: 1, dataRoot };
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+/**
+ * 读取 bootstrap dataRoot(同步,无错误抛出)
+ *
+ * CLI 显示当前值时使用。文件不存在或损坏返回 undefined。
+ */
+export function readBootstrapDataRootSync() {
+    const path = getBootstrapConfigPath();
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const content = readFileSync(path, "utf-8");
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === "object" && parsed.version === 1) {
+            return parsed.dataRoot?.trim() || undefined;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 同步解析当前 dataRoot
+ *
+ * OpenClaw 1.8+ 要求 plugin register() 同步完成,无法 await 异步 fs,
+ * 这里用 readFileSync 替代。功能与 resolveBootstrapDataRoot 等价,
+ * 但损坏文件时不做备份重建(只读 + warning)—— 重建由下次 CLI 调用完成。
+ */
+export function resolveBootstrapDataRootSync() {
+    const path = getBootstrapConfigPath();
+    const defaultRoot = getDefaultDataRoot();
+    const warnings = [];
+    if (!existsSync(path)) {
+        warnings.push(`Bootstrap config not found at ${path}. Using default ${defaultRoot}. Run 'co-engram config data-root <path>' to change.`);
+        return { dataRoot: defaultRoot, source: "default", warnings };
+    }
+    let parsed;
+    try {
+        const content = readFileSync(path, "utf-8");
+        parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== "object" || parsed.version !== 1) {
+            parsed = undefined;
+        }
+    }
+    catch {
+        parsed = undefined;
+    }
+    if (parsed === undefined) {
+        warnings.push(`Bootstrap config at ${path} is corrupt or unreadable. Using default ${defaultRoot}. Run 'co-engram config data-root <path>' to repair.`);
+        return { dataRoot: defaultRoot, source: "repaired", warnings };
+    }
+    const dataRoot = parsed.dataRoot?.trim();
+    if (!dataRoot) {
+        warnings.push(`Bootstrap config at ${path} has no dataRoot field; using default ${defaultRoot}.`);
+        return { dataRoot: defaultRoot, source: "default", warnings };
+    }
+    return { dataRoot, source: "bootstrap-config", warnings };
+}
+// 共享 dataRoot 切换逻辑(CLI + viewer UI 都用)
+export * from "./classify.js";
+//# sourceMappingURL=index.js.map

package/dist/bootstrap/index.js.map

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