@ohos-cpf/3rdloop 0.0.1 → 0.0.3

package/vendor/Server/CLI/opencode.js

@@ -1,5 +1,5 @@
-/**
- * OpenCodeCLI 快捷导出
- * 方便通过 import OpenCodeCLI from './cli/opencode.js' 引用
- */
-export { default } from './opencode/index.js';
+/**
+ * OpenCodeCLI 快捷导出
+ * 方便通过 import OpenCodeCLI from './cli/opencode.js' 引用
+ */
+export { default } from './opencode/index.js';

package/vendor/Server/DbUse/MessageArchive.js

@@ -1,61 +1,61 @@
-import StorageManager from './StorageManager.js';
-import SessionStore from './stores/SessionStore.js';
-
-/**
- * MessageArchive —— Session 对话消息存档服务（兼容门面）
- *
- * ⚠️ 本类现为 SessionStore 的薄代理，保留原构造签名与方法，使现有 CLI 适配器
- *    （OpenCodeCLI）的 `new MessageArchive()` 与 `this.archive.*`
- *    调用无需任何改动即可工作。
- *
- * 实际逻辑已迁入 stores/SessionStore.js，存储细节下沉到 adapters/ 层。
- * 新代码请直接使用 StorageManager + SessionStore（见 index.js 导出）。
- *
- * 原有存储布局保持不变：
- *   db/Session/
- *     ├── <sessionId>.jsonl        # 消息流（append-only）
- *     └── <sessionId>.meta.json    # 元信息
- */
-class MessageArchive {
-    /**
-     * @param {object} [options]
-     * @param {string} [options.baseDir] - 存档根目录（绝对路径）。默认相对本项目推导。
-     * @param {number} [options.stallThresholdMs] - 判定"卡死/停滞"的阈值，默认 5 分钟
-     * @param {StorageManager} [options.manager] - 已有的 StorageManager（复用根目录与实例缓存）
-     */
-    constructor(options = {}) {
-        const stallThresholdMs = options.stallThresholdMs ?? 5 * 60 * 1000;
-
-        // 复用传入的 manager，或自建一个（rootDir 兼容旧的 baseDir 指向 db/Session 的情形）
-        let manager = options.manager;
-        if (!manager) {
-            manager = new StorageManager(
-                options.baseDir
-                    ? { rootDir: options.baseDir }
-                    : {}
-            );
-        }
-
-        // 通过 manager 获取 Session 子域的 jsonl / json 适配器
-        this._store = new SessionStore({
-            jsonl: manager.jsonl('Session'),
-            json: manager.json('Session'),
-            stallThresholdMs
-        });
-    }
-
-    // ─── 代理到 SessionStore，保持原方法签名 ──────────────────────────────────
-
-    async readMeta(sessionId) { return this._store.readMeta(sessionId); }
-    async writeMeta(sessionId, meta) { return this._store.writeMeta(sessionId, meta); }
-    async patchMeta(sessionId, patch) { return this._store.patchMeta(sessionId, patch); }
-    async appendMessage(sessionId, message, opts) { return this._store.appendMessage(sessionId, message, opts); }
-    async appendMessages(sessionId, messages) { return this._store.appendMessages(sessionId, messages); }
-    async readMessages(sessionId) { return this._store.readMessages(sessionId); }
-    async readLastMessage(sessionId) { return this._store.readLastMessage(sessionId); }
-    async listSessions() { return this._store.listSessions(); }
-    async recordCheck(sessionId, current) { return this._store.recordCheck(sessionId, current); }
-    async deleteSession(sessionId) { return this._store.deleteSession(sessionId); }
-}
-
-export default MessageArchive;
+import StorageManager from './StorageManager.js';
+import SessionStore from './stores/SessionStore.js';
+
+/**
+ * MessageArchive —— Session 对话消息存档服务（兼容门面）
+ *
+ * ⚠️ 本类现为 SessionStore 的薄代理，保留原构造签名与方法，使现有 CLI 适配器
+ *    （OpenCodeCLI）的 `new MessageArchive()` 与 `this.archive.*`
+ *    调用无需任何改动即可工作。
+ *
+ * 实际逻辑已迁入 stores/SessionStore.js，存储细节下沉到 adapters/ 层。
+ * 新代码请直接使用 StorageManager + SessionStore（见 index.js 导出）。
+ *
+ * 原有存储布局保持不变：
+ *   db/Session/
+ *     ├── <sessionId>.jsonl        # 消息流（append-only）
+ *     └── <sessionId>.meta.json    # 元信息
+ */
+class MessageArchive {
+    /**
+     * @param {object} [options]
+     * @param {string} [options.baseDir] - 存档根目录（绝对路径）。默认相对本项目推导。
+     * @param {number} [options.stallThresholdMs] - 判定"卡死/停滞"的阈值，默认 5 分钟
+     * @param {StorageManager} [options.manager] - 已有的 StorageManager（复用根目录与实例缓存）
+     */
+    constructor(options = {}) {
+        const stallThresholdMs = options.stallThresholdMs ?? 5 * 60 * 1000;
+
+        // 复用传入的 manager，或自建一个（rootDir 兼容旧的 baseDir 指向 db/Session 的情形）
+        let manager = options.manager;
+        if (!manager) {
+            manager = new StorageManager(
+                options.baseDir
+                    ? { rootDir: options.baseDir }
+                    : {}
+            );
+        }
+
+        // 通过 manager 获取 Session 子域的 jsonl / json 适配器
+        this._store = new SessionStore({
+            jsonl: manager.jsonl('Session'),
+            json: manager.json('Session'),
+            stallThresholdMs
+        });
+    }
+
+    // ─── 代理到 SessionStore，保持原方法签名 ──────────────────────────────────
+
+    async readMeta(sessionId) { return this._store.readMeta(sessionId); }
+    async writeMeta(sessionId, meta) { return this._store.writeMeta(sessionId, meta); }
+    async patchMeta(sessionId, patch) { return this._store.patchMeta(sessionId, patch); }
+    async appendMessage(sessionId, message, opts) { return this._store.appendMessage(sessionId, message, opts); }
+    async appendMessages(sessionId, messages) { return this._store.appendMessages(sessionId, messages); }
+    async readMessages(sessionId) { return this._store.readMessages(sessionId); }
+    async readLastMessage(sessionId) { return this._store.readLastMessage(sessionId); }
+    async listSessions() { return this._store.listSessions(); }
+    async recordCheck(sessionId, current) { return this._store.recordCheck(sessionId, current); }
+    async deleteSession(sessionId) { return this._store.deleteSession(sessionId); }
+}
+
+export default MessageArchive;

package/vendor/Server/DbUse/StorageManager.js

@@ -1,107 +1,107 @@
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import JsonAdapter from './adapters/JsonAdapter.js';
-import JsonlAdapter from './adapters/JsonlAdapter.js';
-import SqliteAdapter from './adapters/SqliteAdapter.js';
-import FileAdapter from './adapters/FileAdapter.js';
-
-/**
- * StorageManager —— 统一存储管理器
- *
- * 职责：
- *   1. 集中解析存储根目录（db/），所有适配器共享同一根，避免路径散落。
- *   2. 按子域（subDir）创建并缓存适配器实例，同一子域复用同一实例。
- *   3. 提供工厂方法 get(type, subDir)，对上层 Store 屏蔽适配器构造细节。
- *   4. 统一生命周期管理（closeAll）。
- *
- * 分层关系：
- *   ┌─────────────────────────────────────────────┐
- *   │  Store 层 (SessionStore / TaskStepStore)    │  业务语义
- *   ├─────────────────────────────────────────────┤
- *   │  StorageManager                             │  工厂/注册表/根目录
- *   ├─────────────────────────────────────────────┤
- *   │  Adapter 层 (Json/Jsonl/Sqlite/File)        │  存储格式实现
- *   └─────────────────────────────────────────────┘
- *
- * 扩展方式：
- *   - 新增存储格式：实现 BaseAdapter 子类 → 注册到 _ADAPTERS → Manager 自动可用
- *   - 新增业务存储：实现 Store，依赖 Manager.get() 获取适配器，不感知格式
- */
-class StorageManager {
-    /**
-     * @param {object} [options]
-     * @param {string} [options.rootDir] - 存储根目录绝对路径。默认 workspace 根下 db/
-     */
-    constructor(options = {}) {
-        if (options.rootDir) {
-            this.rootDir = options.rootDir;
-        } else {
-            // 本文件 (Server/DbUse/) 上溯 3 层到 workspace 根 → db/
-            const here = dirname(fileURLToPath(import.meta.url));
-            this.rootDir = join(here, '..', '..', '..', 'db');
-        }
-        /** @type {Map<string, import('./adapters/BaseAdapter.js').default>} */
-        this._instances = new Map();
-    }
-
-    static get _ADAPTERS() {
-        return {
-            json: JsonAdapter,
-            jsonl: JsonlAdapter,
-            sqlite: SqliteAdapter,
-            file: FileAdapter
-        };
-    }
-
-    /**
-     * 获取（或创建）指定类型与子域的适配器实例。
-     * 同一 (type, subDir) 复用同一实例。
-     *
-     * @param {'json'|'jsonl'|'sqlite'|'file'} type - 适配器类型
-     * @param {string} subDir - 根目录下的子域（如 'Session'、'TaskStep'、'Artifacts'）
-     * @param {object} [adapterOpts] - 传递给适配器的额外选项
-     * @returns {import('./adapters/BaseAdapter.js').default}
-     */
-    get(type, subDir, adapterOpts = {}) {
-        const AdapterClass = StorageManager._ADAPTERS[type];
-        if (!AdapterClass) {
-            throw new Error(
-                `未知的存储类型: "${type}"，可选: ${Object.keys(StorageManager._ADAPTERS).join(', ')}`
-            );
-        }
-        const cacheKey = `${type}:${subDir}`;
-        let instance = this._instances.get(cacheKey);
-        if (!instance) {
-            instance = new AdapterClass({
-                baseDir: this.rootDir,
-                subDir,
-                ...adapterOpts
-            });
-            this._instances.set(cacheKey, instance);
-        }
-        return instance;
-    }
-
-    /** 便捷方法 */
-    json(subDir, opts) { return this.get('json', subDir, opts); }
-    jsonl(subDir, opts) { return this.get('jsonl', subDir, opts); }
-    sqlite(subDir, opts) { return this.get('sqlite', subDir, opts); }
-    file(subDir, opts) { return this.get('file', subDir, opts); }
-
-    /**
-     * 关闭所有适配器（释放数据库连接等）。
-     */
-    async closeAll() {
-        const tasks = [];
-        for (const instance of this._instances.values()) {
-            if (typeof instance.close === 'function') {
-                tasks.push(Promise.resolve(instance.close()).catch(() => {}));
-            }
-        }
-        await Promise.all(tasks);
-        this._instances.clear();
-    }
-}
-
-export default StorageManager;
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import JsonAdapter from './adapters/JsonAdapter.js';
+import JsonlAdapter from './adapters/JsonlAdapter.js';
+import SqliteAdapter from './adapters/SqliteAdapter.js';
+import FileAdapter from './adapters/FileAdapter.js';
+
+/**
+ * StorageManager —— 统一存储管理器
+ *
+ * 职责：
+ *   1. 集中解析存储根目录（db/），所有适配器共享同一根，避免路径散落。
+ *   2. 按子域（subDir）创建并缓存适配器实例，同一子域复用同一实例。
+ *   3. 提供工厂方法 get(type, subDir)，对上层 Store 屏蔽适配器构造细节。
+ *   4. 统一生命周期管理（closeAll）。
+ *
+ * 分层关系：
+ *   ┌─────────────────────────────────────────────┐
+ *   │  Store 层 (SessionStore / TaskStepStore)    │  业务语义
+ *   ├─────────────────────────────────────────────┤
+ *   │  StorageManager                             │  工厂/注册表/根目录
+ *   ├─────────────────────────────────────────────┤
+ *   │  Adapter 层 (Json/Jsonl/Sqlite/File)        │  存储格式实现
+ *   └─────────────────────────────────────────────┘
+ *
+ * 扩展方式：
+ *   - 新增存储格式：实现 BaseAdapter 子类 → 注册到 _ADAPTERS → Manager 自动可用
+ *   - 新增业务存储：实现 Store，依赖 Manager.get() 获取适配器，不感知格式
+ */
+class StorageManager {
+    /**
+     * @param {object} [options]
+     * @param {string} [options.rootDir] - 存储根目录绝对路径。默认 workspace 根下 db/
+     */
+    constructor(options = {}) {
+        if (options.rootDir) {
+            this.rootDir = options.rootDir;
+        } else {
+            // 本文件 (Server/DbUse/) 上溯 3 层到 workspace 根 → db/
+            const here = dirname(fileURLToPath(import.meta.url));
+            this.rootDir = join(here, '..', '..', '..', 'db');
+        }
+        /** @type {Map<string, import('./adapters/BaseAdapter.js').default>} */
+        this._instances = new Map();
+    }
+
+    static get _ADAPTERS() {
+        return {
+            json: JsonAdapter,
+            jsonl: JsonlAdapter,
+            sqlite: SqliteAdapter,
+            file: FileAdapter
+        };
+    }
+
+    /**
+     * 获取（或创建）指定类型与子域的适配器实例。
+     * 同一 (type, subDir) 复用同一实例。
+     *
+     * @param {'json'|'jsonl'|'sqlite'|'file'} type - 适配器类型
+     * @param {string} subDir - 根目录下的子域（如 'Session'、'TaskStep'、'Artifacts'）
+     * @param {object} [adapterOpts] - 传递给适配器的额外选项
+     * @returns {import('./adapters/BaseAdapter.js').default}
+     */
+    get(type, subDir, adapterOpts = {}) {
+        const AdapterClass = StorageManager._ADAPTERS[type];
+        if (!AdapterClass) {
+            throw new Error(
+                `未知的存储类型: "${type}"，可选: ${Object.keys(StorageManager._ADAPTERS).join(', ')}`
+            );
+        }
+        const cacheKey = `${type}:${subDir}`;
+        let instance = this._instances.get(cacheKey);
+        if (!instance) {
+            instance = new AdapterClass({
+                baseDir: this.rootDir,
+                subDir,
+                ...adapterOpts
+            });
+            this._instances.set(cacheKey, instance);
+        }
+        return instance;
+    }
+
+    /** 便捷方法 */
+    json(subDir, opts) { return this.get('json', subDir, opts); }
+    jsonl(subDir, opts) { return this.get('jsonl', subDir, opts); }
+    sqlite(subDir, opts) { return this.get('sqlite', subDir, opts); }
+    file(subDir, opts) { return this.get('file', subDir, opts); }
+
+    /**
+     * 关闭所有适配器（释放数据库连接等）。
+     */
+    async closeAll() {
+        const tasks = [];
+        for (const instance of this._instances.values()) {
+            if (typeof instance.close === 'function') {
+                tasks.push(Promise.resolve(instance.close()).catch(() => {}));
+            }
+        }
+        await Promise.all(tasks);
+        this._instances.clear();
+    }
+}
+
+export default StorageManager;

package/vendor/Server/DbUse/adapters/BaseAdapter.js

@@ -1,94 +1,94 @@
-import { promises as fs } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-/**
- * BaseAdapter —— 所有存储适配器的抽象基类
- *
- * 职责：
- *   1. 统一根目录解析（相对路径 → 绝对路径）。
- *   2. 提供目录确保、路径拼接工具方法。
- *   3. 声明子类必须实现的接口契约（子类不实现则抛 NotImplemented）。
- *
- * 设计原则：
- *   - 高内聚：每种存储格式（JSON/JSONL/SQLite/File）的读写细节封装在各自适配器。
- *   - 低耦合：Store 层只依赖适配器接口，不感知具体格式；适配器之间互不依赖。
- *   - 可扩展：新增存储格式只需新增一个 Adapter 子类，无需改动 Store 与 Manager。
- */
-class BaseAdapter {
-    /**
-     * @param {object} options
-     * @param {string} [options.baseDir]  - 该适配器的工作根目录（绝对路径）
-     * @param {string} [options.subDir]   - 根目录下的子目录名（如 'Session'、'TaskStep'）
-     */
-    constructor(options = {}) {
-        this.subDir = options.subDir || '';
-        if (options.baseDir) {
-            this.baseDir = options.baseDir;
-        } else {
-            // 默认：本文件 (Server/DbUse/adapters/) 上溯 4 层到 workspace 根 → db/
-            const here = dirname(fileURLToPath(import.meta.url));
-            this.baseDir = join(here, '..', '..', '..', '..', 'db');
-        }
-        this.rootDir = this.subDir ? join(this.baseDir, this.subDir) : this.baseDir;
-        this._ensureDirPromise = null;
-    }
-
-    // ─── 工具方法 ──────────────────────────────────────────────────────────────
-
-    /**
-     * 确保工作目录存在（幂等，并发安全）。
-     * @returns {Promise<string>} 目录绝对路径
-     */
-    async ensureDir() {
-        if (!this._ensureDirPromise) {
-            this._ensureDirPromise = fs.mkdir(this.rootDir, { recursive: true }).then(() => {
-                this._ensureDirPromise = null;
-                return this.rootDir;
-            }).catch(err => {
-                this._ensureDirPromise = null;
-                throw err;
-            });
-        }
-        return this._ensureDirPromise;
-    }
-
-    /** 拼接工作目录下的路径 */
-    path(...segments) {
-        return join(this.rootDir, ...segments);
-    }
-
-    /** 同步版路径拼接（供 SQLite 等 sync 场景使用） */
-    pathSync(...segments) {
-        return join(this.rootDir, ...segments);
-    }
-
-    // ─── 子类必须实现的接口契约 ────────────────────────────────────────────────
-    // 以下方法默认抛出 NotImplementedError，子类按需覆盖。
-
-    async read(/* key */) {
-        throw new Error(`${this.constructor.name}.read() 未实现`);
-    }
-
-    async write(/* key, data */) {
-        throw new Error(`${this.constructor.name}.write() 未实现`);
-    }
-
-    async delete(/* key */) {
-        throw new Error(`${this.constructor.name}.delete() 未实现`);
-    }
-
-    async list() {
-        throw new Error(`${this.constructor.name}.list() 未实现`);
-    }
-
-    /**
-     * 返回适配器类型标识，用于日志与注册表。
-     * @returns {string}
-     */
-    get type() {
-        return 'base';
-    }
-}
-
-export default BaseAdapter;
+import { promises as fs } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/**
+ * BaseAdapter —— 所有存储适配器的抽象基类
+ *
+ * 职责：
+ *   1. 统一根目录解析（相对路径 → 绝对路径）。
+ *   2. 提供目录确保、路径拼接工具方法。
+ *   3. 声明子类必须实现的接口契约（子类不实现则抛 NotImplemented）。
+ *
+ * 设计原则：
+ *   - 高内聚：每种存储格式（JSON/JSONL/SQLite/File）的读写细节封装在各自适配器。
+ *   - 低耦合：Store 层只依赖适配器接口，不感知具体格式；适配器之间互不依赖。
+ *   - 可扩展：新增存储格式只需新增一个 Adapter 子类，无需改动 Store 与 Manager。
+ */
+class BaseAdapter {
+    /**
+     * @param {object} options
+     * @param {string} [options.baseDir]  - 该适配器的工作根目录（绝对路径）
+     * @param {string} [options.subDir]   - 根目录下的子目录名（如 'Session'、'TaskStep'）
+     */
+    constructor(options = {}) {
+        this.subDir = options.subDir || '';
+        if (options.baseDir) {
+            this.baseDir = options.baseDir;
+        } else {
+            // 默认：本文件 (Server/DbUse/adapters/) 上溯 4 层到 workspace 根 → db/
+            const here = dirname(fileURLToPath(import.meta.url));
+            this.baseDir = join(here, '..', '..', '..', '..', 'db');
+        }
+        this.rootDir = this.subDir ? join(this.baseDir, this.subDir) : this.baseDir;
+        this._ensureDirPromise = null;
+    }
+
+    // ─── 工具方法 ──────────────────────────────────────────────────────────────
+
+    /**
+     * 确保工作目录存在（幂等，并发安全）。
+     * @returns {Promise<string>} 目录绝对路径
+     */
+    async ensureDir() {
+        if (!this._ensureDirPromise) {
+            this._ensureDirPromise = fs.mkdir(this.rootDir, { recursive: true }).then(() => {
+                this._ensureDirPromise = null;
+                return this.rootDir;
+            }).catch(err => {
+                this._ensureDirPromise = null;
+                throw err;
+            });
+        }
+        return this._ensureDirPromise;
+    }
+
+    /** 拼接工作目录下的路径 */
+    path(...segments) {
+        return join(this.rootDir, ...segments);
+    }
+
+    /** 同步版路径拼接（供 SQLite 等 sync 场景使用） */
+    pathSync(...segments) {
+        return join(this.rootDir, ...segments);
+    }
+
+    // ─── 子类必须实现的接口契约 ────────────────────────────────────────────────
+    // 以下方法默认抛出 NotImplementedError，子类按需覆盖。
+
+    async read(/* key */) {
+        throw new Error(`${this.constructor.name}.read() 未实现`);
+    }
+
+    async write(/* key, data */) {
+        throw new Error(`${this.constructor.name}.write() 未实现`);
+    }
+
+    async delete(/* key */) {
+        throw new Error(`${this.constructor.name}.delete() 未实现`);
+    }
+
+    async list() {
+        throw new Error(`${this.constructor.name}.list() 未实现`);
+    }
+
+    /**
+     * 返回适配器类型标识，用于日志与注册表。
+     * @returns {string}
+     */
+    get type() {
+        return 'base';
+    }
+}
+
+export default BaseAdapter;