@liangjie559567/ultrapower 6.0.0 → 7.0.2

package/dist/state/backup-manager.js

@@ -0,0 +1,174 @@
+/**
+ * 灾难恢复机制 - BackupManager
+ *
+ * 提供定期自动备份和 restore 命令
+ */
+import { existsSync, mkdirSync, copyFileSync, readdirSync, statSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { assertValidMode } from '../lib/validateMode.js';
+export class BackupManager {
+    directory;
+    maxBackups;
+    backupInterval;
+    backupTimer;
+    constructor(options) {
+        this.directory = options.directory;
+        this.maxBackups = options.maxBackups ?? 10;
+        this.backupInterval = options.backupInterval ?? 3600000; // 1 hour
+    }
+    /**
+     * 获取备份目录路径
+     */
+    getBackupDir() {
+        return join(this.directory, '.omc', 'backups');
+    }
+    /**
+     * 确保备份目录存在
+     */
+    ensureBackupDir() {
+        const backupDir = this.getBackupDir();
+        if (!existsSync(backupDir)) {
+            mkdirSync(backupDir, { recursive: true });
+        }
+    }
+    /**
+     * 获取状态文件路径
+     */
+    getStatePath(mode, sessionId) {
+        const validMode = assertValidMode(mode);
+        if (sessionId) {
+            return join(this.directory, '.omc', 'state', 'sessions', sessionId, `${validMode}-state.json`);
+        }
+        return join(this.directory, '.omc', 'state', `${validMode}-state.json`);
+    }
+    /**
+     * 创建备份
+     */
+    backup(mode, sessionId) {
+        try {
+            const statePath = this.getStatePath(mode, sessionId);
+            if (!existsSync(statePath)) {
+                return false;
+            }
+            this.ensureBackupDir();
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const backupName = sessionId
+                ? `${mode}-${sessionId}-${timestamp}.json`
+                : `${mode}-${timestamp}.json`;
+            const backupPath = join(this.getBackupDir(), backupName);
+            copyFileSync(statePath, backupPath);
+            this.cleanOldBackups(mode, sessionId);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 恢复备份
+     */
+    restore(mode, timestamp, sessionId) {
+        try {
+            const backupDir = this.getBackupDir();
+            if (!existsSync(backupDir)) {
+                return false;
+            }
+            const prefix = sessionId ? `${mode}-${sessionId}-` : `${mode}-`;
+            const backups = readdirSync(backupDir)
+                .filter(f => f.startsWith(prefix) && f.endsWith('.json'))
+                .sort()
+                .reverse();
+            if (backups.length === 0) {
+                return false;
+            }
+            let backupFile;
+            if (timestamp) {
+                backupFile = backups.find(f => f.includes(timestamp)) || backups[0];
+            }
+            else {
+                backupFile = backups[0]; // 最新备份
+            }
+            const backupPath = join(backupDir, backupFile);
+            const statePath = this.getStatePath(mode, sessionId);
+            const stateDir = join(this.directory, '.omc', 'state');
+            if (!existsSync(stateDir)) {
+                mkdirSync(stateDir, { recursive: true });
+            }
+            copyFileSync(backupPath, statePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 清理旧备份
+     */
+    cleanOldBackups(mode, sessionId) {
+        try {
+            const backupDir = this.getBackupDir();
+            const prefix = sessionId ? `${mode}-${sessionId}-` : `${mode}-`;
+            const backups = readdirSync(backupDir)
+                .filter(f => f.startsWith(prefix) && f.endsWith('.json'))
+                .map(f => ({
+                name: f,
+                path: join(backupDir, f),
+                time: statSync(join(backupDir, f)).mtime.getTime()
+            }))
+                .sort((a, b) => b.time - a.time);
+            // 删除超过最大数量的备份
+            backups.slice(this.maxBackups).forEach(backup => {
+                unlinkSync(backup.path);
+            });
+        }
+        catch {
+            // 清理失败不影响备份操作
+        }
+    }
+    /**
+     * 列出所有备份
+     */
+    listBackups(mode, sessionId) {
+        try {
+            const backupDir = this.getBackupDir();
+            if (!existsSync(backupDir)) {
+                return [];
+            }
+            let backups = readdirSync(backupDir).filter(f => f.endsWith('.json'));
+            if (mode) {
+                const prefix = sessionId ? `${mode}-${sessionId}-` : `${mode}-`;
+                backups = backups.filter(f => f.startsWith(prefix));
+            }
+            return backups.sort().reverse();
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 启动自动备份
+     */
+    startAutoBackup(modes) {
+        if (this.backupTimer) {
+            return;
+        }
+        this.backupTimer = setInterval(() => {
+            modes.forEach(mode => {
+                this.backup(mode);
+            });
+        }, this.backupInterval);
+    }
+    /**
+     * 停止自动备份
+     */
+    stopAutoBackup() {
+        if (this.backupTimer) {
+            clearInterval(this.backupTimer);
+            this.backupTimer = undefined;
+        }
+    }
+}
+export function createBackupManager(options) {
+    return new BackupManager(options);
+}
+//# sourceMappingURL=backup-manager.js.map

package/dist/state/backup-manager.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 统一状态管理层 - StateManager
+ *
+ * 提供统一接口，支持文件系统和 SQLite 后端，支持双写模式渐进迁移
+ */
+import type { ValidMode } from '../lib/validateMode.js';
+export interface StateManagerOptions {
+    mode: ValidMode;
+    directory: string;
+    backend?: 'file' | 'sqlite';
+    dualWrite?: boolean;
+}
+export declare class StateManager<T = Record<string, unknown>> {
+    private adapter;
+    private options;
+    constructor(options: StateManagerOptions);
+    read(sessionId?: string): T | null;
+    write(data: T, sessionId?: string): Promise<boolean>;
+    writeSync(data: T, sessionId?: string): boolean;
+    clear(sessionId?: string): boolean;
+    exists(sessionId?: string): boolean;
+    getPath(sessionId?: string): string;
+    list(): string[];
+}
+export declare function createStateManager<T = Record<string, unknown>>(options: StateManagerOptions): StateManager<T>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,EAAE,mBAAmB;IAMxC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAI5B,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAI/C,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAIlC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAInC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAInC,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CAAC,CAAC,CAAC,CAEjB"}

package/dist/state/index.js

@@ -0,0 +1,40 @@
+/**
+ * 统一状态管理层 - StateManager
+ *
+ * 提供统一接口，支持文件系统和 SQLite 后端，支持双写模式渐进迁移
+ */
+import { FileStateAdapter } from '../lib/state-adapter.js';
+export class StateManager {
+    adapter;
+    options;
+    constructor(options) {
+        this.options = options;
+        // 当前仅支持文件后端，SQLite 后端预留
+        this.adapter = new FileStateAdapter(options.mode, options.directory);
+    }
+    read(sessionId) {
+        return this.adapter.read(sessionId);
+    }
+    async write(data, sessionId) {
+        return this.adapter.write(data, sessionId);
+    }
+    writeSync(data, sessionId) {
+        return this.adapter.writeSync(data, sessionId);
+    }
+    clear(sessionId) {
+        return this.adapter.clear(sessionId);
+    }
+    exists(sessionId) {
+        return this.adapter.exists(sessionId);
+    }
+    getPath(sessionId) {
+        return this.adapter.getPath(sessionId);
+    }
+    list() {
+        return this.adapter.list();
+    }
+}
+export function createStateManager(options) {
+    return new StateManager(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAqB,MAAM,yBAAyB,CAAC;AAU9E,MAAM,OAAO,YAAY;IACf,OAAO,CAAkB;IACzB,OAAO,CAAsB;IAErC,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,wBAAwB;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC,SAAkB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAO,EAAE,SAAkB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,CAAC,IAAO,EAAE,SAAkB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,SAAkB;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,SAAkB;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,CAAC,SAAkB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAChC,OAA4B;IAE5B,OAAO,IAAI,YAAY,CAAI,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/state/migration/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 状态迁移工具
+ *
+ * 支持从旧版状态文件迁移到新的统一状态管理层
+ */
+import type { ValidMode } from '../../lib/validateMode.js';
+import { backupBeforeMigration, rollbackToBackup, verifyIntegrity, type BackupInfo } from './integrity.js';
+export interface MigrationResult {
+    success: boolean;
+    migratedModes: string[];
+    errors: Array<{
+        mode: string;
+        error: string;
+    }>;
+}
+/**
+ * 迁移单个模式的状态（带完整性保障）
+ */
+export declare function migrateMode(mode: ValidMode, directory: string): boolean;
+/**
+ * 备份状态文件
+ */
+export declare function backupState(mode: ValidMode, directory: string): boolean;
+export { backupBeforeMigration, rollbackToBackup, verifyIntegrity, type BackupInfo };
+//# sourceMappingURL=index.d.ts.map

package/dist/state/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/migration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3G,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAgCvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAcvE;AAED,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,CAAC"}

package/dist/state/migration/index.js

@@ -0,0 +1,61 @@
+/**
+ * 状态迁移工具
+ *
+ * 支持从旧版状态文件迁移到新的统一状态管理层
+ */
+import { existsSync, readFileSync, copyFileSync } from 'fs';
+import { join } from 'path';
+import { createStateManager } from '../index.js';
+import { backupBeforeMigration, rollbackToBackup, verifyIntegrity } from './integrity.js';
+/**
+ * 迁移单个模式的状态（带完整性保障）
+ */
+export function migrateMode(mode, directory) {
+    const legacyPath = join(directory, '.omc', 'state', `${mode}-state.json`);
+    if (!existsSync(legacyPath)) {
+        return true;
+    }
+    const backup = backupBeforeMigration(mode, directory);
+    try {
+        const content = readFileSync(legacyPath, 'utf-8');
+        const state = JSON.parse(content);
+        const manager = createStateManager({ mode, directory });
+        const success = manager.writeSync(state);
+        if (!success) {
+            if (backup)
+                rollbackToBackup(backup, mode, directory);
+            return false;
+        }
+        const integrity = verifyIntegrity(mode, directory);
+        if (!integrity.valid) {
+            if (backup)
+                rollbackToBackup(backup, mode, directory);
+            return false;
+        }
+        return true;
+    }
+    catch {
+        if (backup)
+            rollbackToBackup(backup, mode, directory);
+        return false;
+    }
+}
+/**
+ * 备份状态文件
+ */
+export function backupState(mode, directory) {
+    const statePath = join(directory, '.omc', 'state', `${mode}-state.json`);
+    if (!existsSync(statePath)) {
+        return true;
+    }
+    try {
+        const backupPath = `${statePath}.backup-${Date.now()}`;
+        copyFileSync(statePath, backupPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export { backupBeforeMigration, rollbackToBackup, verifyIntegrity };
+//# sourceMappingURL=index.js.map

package/dist/state/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/migration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAmB,MAAM,gBAAgB,CAAC;AAQ3G;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAe,EAAE,SAAiB;IAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;IAE1E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAElC,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,MAAM;gBAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YACtD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,MAAM;gBAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YACtD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,MAAM;YAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAe,EAAE,SAAiB;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;IAEzE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,GAAG,SAAS,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACvD,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAmB,CAAC"}

package/dist/state/migration/integrity.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 状态迁移完整性保障
+ */
+import type { ValidMode } from '../../lib/validateMode.js';
+export interface BackupInfo {
+    path: string;
+    timestamp: number;
+    checksum: string;
+}
+export interface IntegrityResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * 迁移前备份
+ */
+export declare function backupBeforeMigration(mode: ValidMode, directory: string): BackupInfo | null;
+/**
+ * 回滚到备份
+ */
+export declare function rollbackToBackup(backupInfo: BackupInfo, mode: ValidMode, directory: string): boolean;
+/**
+ * 验证状态完整性
+ */
+export declare function verifyIntegrity(mode: ValidMode, directory: string): IntegrityResult;
+/**
+ * 清理旧备份
+ */
+export declare function cleanupOldBackups(mode: ValidMode, directory: string, keepCount?: number): number;
+//# sourceMappingURL=integrity.d.ts.map

package/dist/state/migration/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../../src/state/migration/integrity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAcD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAsB3F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAapG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CA0BnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM,CAyBnG"}

package/dist/state/migration/integrity.js

@@ -0,0 +1,109 @@
+/**
+ * 状态迁移完整性保障
+ */
+import { existsSync, readFileSync, copyFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+/**
+ * 计算文件校验和
+ */
+function calculateChecksum(content) {
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        hash = ((hash << 5) - hash) + content.charCodeAt(i);
+        hash = hash & hash;
+    }
+    return hash.toString(16);
+}
+/**
+ * 迁移前备份
+ */
+export function backupBeforeMigration(mode, directory) {
+    const statePath = join(directory, '.omc', 'state', `${mode}-state.json`);
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(statePath, 'utf-8');
+        const timestamp = Date.now();
+        const backupPath = `${statePath}.backup-${timestamp}`;
+        copyFileSync(statePath, backupPath);
+        return {
+            path: backupPath,
+            timestamp,
+            checksum: calculateChecksum(content)
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 回滚到备份
+ */
+export function rollbackToBackup(backupInfo, mode, directory) {
+    const statePath = join(directory, '.omc', 'state', `${mode}-state.json`);
+    if (!existsSync(backupInfo.path)) {
+        return false;
+    }
+    try {
+        copyFileSync(backupInfo.path, statePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 验证状态完整性
+ */
+export function verifyIntegrity(mode, directory) {
+    const statePath = join(directory, '.omc', 'state', `${mode}-state.json`);
+    const errors = [];
+    if (!existsSync(statePath)) {
+        errors.push('State file does not exist');
+        return { valid: false, errors };
+    }
+    try {
+        const content = readFileSync(statePath, 'utf-8');
+        const state = JSON.parse(content);
+        if (!state.mode || state.mode !== mode) {
+            errors.push('Mode mismatch');
+        }
+        if (typeof state.active !== 'boolean') {
+            errors.push('Invalid active field');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    catch (error) {
+        errors.push(`Parse error: ${error instanceof Error ? error.message : 'unknown'}`);
+        return { valid: false, errors };
+    }
+}
+/**
+ * 清理旧备份
+ */
+export function cleanupOldBackups(mode, directory, keepCount = 5) {
+    const stateDir = join(directory, '.omc', 'state');
+    const pattern = `${mode}-state.json.backup-`;
+    try {
+        const { readdirSync } = require('fs');
+        const files = readdirSync(stateDir)
+            .filter((f) => f.startsWith(pattern))
+            .map((f) => ({
+            name: f,
+            path: join(stateDir, f),
+            timestamp: parseInt(f.replace(pattern, ''))
+        }))
+            .sort((a, b) => b.timestamp - a.timestamp);
+        let deleted = 0;
+        for (let i = keepCount; i < files.length; i++) {
+            unlinkSync(files[i].path);
+            deleted++;
+        }
+        return deleted;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=integrity.js.map

package/dist/state/migration/integrity.js.map

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

package/dist/tools/python-repl/index.d.ts

@@ -17,7 +17,7 @@ export declare const pythonReplTool: {
         queueTimeout: import("zod").ZodDefault<import("zod").ZodNumber>;
         projectDir: import("zod").ZodOptional<import("zod").ZodString>;
     }, "strip", import("zod").ZodTypeAny, {
-        action: "execute" | "interrupt" | "reset" | "get_state";
+        action: "interrupt" | "execute" | "reset" | "get_state";
         researchSessionID: string;
         executionTimeout: number;
         queueTimeout: number;
@@ -25,7 +25,7 @@ export declare const pythonReplTool: {
         executionLabel?: string | undefined;
         projectDir?: string | undefined;
     }, {
-        action: "execute" | "interrupt" | "reset" | "get_state";
+        action: "interrupt" | "execute" | "reset" | "get_state";
         researchSessionID: string;
         code?: string | undefined;
         executionLabel?: string | undefined;

package/dist/tools/python-repl/tool.d.ts

@@ -27,7 +27,7 @@ export declare const pythonReplSchema: z.ZodObject<{
     queueTimeout: z.ZodDefault<z.ZodNumber>;
     projectDir: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    action: "execute" | "interrupt" | "reset" | "get_state";
+    action: "interrupt" | "execute" | "reset" | "get_state";
     researchSessionID: string;
     executionTimeout: number;
     queueTimeout: number;
@@ -35,7 +35,7 @@ export declare const pythonReplSchema: z.ZodObject<{
     executionLabel?: string | undefined;
     projectDir?: string | undefined;
 }, {
-    action: "execute" | "interrupt" | "reset" | "get_state";
+    action: "interrupt" | "execute" | "reset" | "get_state";
     researchSessionID: string;
     code?: string | undefined;
     executionLabel?: string | undefined;

package/docs/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:6.0.0 -->
+<!-- OMC:VERSION:7.0.2 -->
 
 # ultrapower - Multi-Agent Orchestration 智能多 Agent 编排
 

package/docs/INSTALL.md

@@ -1,6 +1,6 @@
 # ultrapower 安装部署详细教程
 
-ultrapower v5.6.10 完整安装指南，覆盖从零开始到完全配置的所有步骤。
+ultrapower v7.0.2 完整安装指南，覆盖从零开始到完全配置的所有步骤。
 
 ---
 
@@ -102,7 +102,7 @@ git --version
 
 **预期输出：**
 ```
-✓ Installing ultrapower v5.6.10...
+✓ Installing ultrapower v7.0.2...
 ✓ Hooks registered: 39
 ✓ Agents loaded: 49
 ✓ Skills available: 71

package/docs/REFERENCE.md

@@ -1,4 +1,4 @@
-<!-- ultrapower v5.6.10 | updated: 2026-03-02 -->
+<!-- ultrapower v7.0.2 | updated: 2026-03-02 -->
 
 # ultrapower Reference — v5.5.33