@lemoncat7/dsh-partner 1.16.1 → 2.0.0

package/lib/storage/migrate-layout.js

@@ -0,0 +1,204 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, rm, rmdir } from 'node:fs/promises';
+import { dirname, join, relative, resolve, sep, isAbsolute } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { PartnerInboxStore } from '../notifications/store.js';
+import { AttachmentDeliveryService } from '../attachments/service.js';
+import { storageLayout } from './layout.js';
+import { atomicJson, syncDirectory } from './atomic.js';
+import { copyVerified, exists, safeTree, verifyDatabases } from './safe-files.js';
+import { SplitStatePersistence, privateStateOwners } from './split-state.js';
+import { storageConfigPath, readStorageConfig } from './bootstrap.js';
+import { legacyMemoryBackups } from './legacy-backups.js';
+import { prepareSourceArchive, cleanupArchivedSources } from './source-archive.js';
+/** Called only after every legacy writer has been stopped and drained. */
+export async function migrateLayout(statePath, root, state) {
+    statePath = resolve(statePath);
+    root = resolve(root);
+    const layout = storageLayout(statePath, root), journalPath = join(layout.legacyPublic, 'storage-migration.json');
+    const current = await readStorageConfig(statePath, root);
+    if (current.storageVersion === 1)
+        return { storageVersion: 1, backupPath: join(layout.legacyPublic, 'migration-backups', current.transactionId), retainedLegacy: true };
+    const oldJournal = await exists(journalPath) ? JSON.parse(await readFile(journalPath, 'utf8')) : undefined;
+    if (oldJournal) {
+        if (!/^[a-f0-9-]{36}$/.test(oldJournal.id) || !Array.isArray(oldJournal.owners))
+            throw Error('迁移恢复清单无效');
+        // Only remove this transaction's uncommitted generated targets, never old data.
+        for (const target of [layout.publicRoot, ...oldJournal.owners.map(id => layout.privateRoot(id))]) {
+            for (const path of [target, target + '.migrate-' + oldJournal.id])
+                if (await exists(path)) {
+                    await safeTree(path);
+                    if (path !== target && (await readdir(path)).length === 0) {
+                        await rmdir(path);
+                        continue;
+                    }
+                    const marker = JSON.parse(await readFile(join(path, 'migration-owner.json'), 'utf8'));
+                    if (marker.transactionId !== oldJournal.id)
+                        throw Error('迁移目标不是当前事务创建，拒绝覆盖');
+                    await rm(path, { recursive: true, force: false });
+                }
+        }
+    }
+    const id = randomUUID(), owners = new Set(privateStateOwners(state));
+    const inboxPath = join(layout.legacyPublic, 'partner-inbox.sqlite');
+    let notices = [];
+    if (await exists(inboxPath)) {
+        await safeTree(inboxPath);
+        const db = new DatabaseSync(inboxPath, { readOnly: true });
+        try {
+            notices = db.prepare('SELECT payload,read_at FROM notices').all().map(row => ({ ...JSON.parse(String(row.payload)), ...(row.read_at === null ? {} : { readAt: Number(row.read_at) }) }));
+        }
+        finally {
+            db.close();
+        }
+        for (const notice of notices)
+            if (notice.kind !== 'system')
+                owners.add(notice.companionId);
+        if (notices.length > 200)
+            throw Error('消息库超出预期保留数量，拒绝截断迁移');
+    }
+    const deliveryRoot = join(layout.legacyPublic, 'attachment-deliveries'), deliveryDb = join(deliveryRoot, 'deliveries.sqlite');
+    let deliveries = [];
+    if (await exists(deliveryDb)) {
+        await safeTree(deliveryRoot);
+        const db = new DatabaseSync(deliveryDb, { readOnly: true });
+        try {
+            deliveries = db.prepare('SELECT payload FROM deliveries').all().map(row => JSON.parse(String(row.payload)));
+        }
+        finally {
+            db.close();
+        }
+        for (const item of deliveries)
+            owners.add(item.companionId);
+    }
+    for (const owner of owners)
+        layout.privateRoot(owner);
+    const targets = [layout.publicRoot, ...[...owners].map(owner => layout.privateRoot(owner))];
+    const sources = [layout.legacySkills, deliveryRoot, ...[...owners].flatMap(owner => ['memory', 'concerns', 'memory-backup'].map(name => join(layout.legacyCompanion(owner), name)))];
+    for (const owner of owners)
+        for (const name of await legacyMemoryBackups(layout.legacyCompanion(owner)))
+            sources.push(join(layout.legacyCompanion(owner), name));
+    for (const target of targets)
+        for (const source of sources)
+            if (target === source || target.startsWith(source + sep) || source.startsWith(target + sep))
+                throw Error('迁移源与目标目录重叠，拒绝执行');
+    for (const target of targets) {
+        await safeTree(target);
+        if (await exists(target))
+            throw Error('目标目录已存在，拒绝覆盖：' + target);
+    }
+    const journal = { id, phase: 'copying', owners: [...owners] };
+    await atomicJson(journalPath, journal);
+    const staging = (path) => path + '.migrate-' + id;
+    const privateStage = (owner) => staging(layout.privateRoot(owner));
+    for (const target of targets) {
+        await mkdir(staging(target), { recursive: true, mode: 0o700 });
+        await atomicJson(join(staging(target), 'migration-owner.json'), { transactionId: id });
+    }
+    const backup = join(layout.legacyPublic, 'migration-backups', id);
+    await copyVerified(statePath, join(backup, 'state.json'));
+    await prepareSourceArchive(statePath, root, id, [...owners]);
+    // Original directories remain untouched and serve as the pre-upgrade backup.
+    await atomicJson(join(backup, 'sources.json'), { transactionId: id, workspaceRoot: root, retained: targets.slice(1).map((_, i) => layout.legacyCompanion(journal.owners[i])), publicSource: layout.legacyPublic });
+    for (const owner of owners) {
+        const source = layout.legacyCompanion(owner), target = privateStage(owner);
+        await copyVerified(join(source, 'memory'), join(target, 'memory'));
+        await copyVerified(join(source, 'concerns'), join(target, 'concerns'));
+        // Preserve legacy backups opaquely; never merge their contents into live memory.
+        for (const name of await legacyMemoryBackups(source))
+            await copyVerified(join(source, name), join(target, 'backups', 'legacy-memory', name));
+    }
+    await copyVerified(layout.legacySkills, join(staging(layout.publicRoot), 'skills'));
+    const next = structuredClone(state);
+    next.notificationDeliveries ??= [];
+    for (const skill of next.skills) {
+        const rel = relative(layout.legacySkills, resolve(skill.rootPath));
+        if (isAbsolute(rel) || rel === '..' || rel.startsWith('../') || rel.startsWith('..\\') || resolve(layout.legacySkills, rel) !== resolve(skill.rootPath))
+            throw Error('Skill 不在已登记的公共目录中');
+        skill.rootPath = join(layout.publicRoot, 'skills', rel);
+    }
+    const split = new SplitStatePersistence(staging(layout.publicRoot), privateStage);
+    await split.write(next);
+    if (JSON.stringify(await split.read()) !== JSON.stringify(next)) {
+        // Field/array order can change during partition; compare canonical state below.
+        if (canonical(await split.read()) !== canonical(next))
+            throw Error('公共和私有配置拆分校验失败');
+    }
+    const inbox = await PartnerInboxStore.openPartitioned(join(staging(layout.publicRoot), 'indexes', 'inbox.sqlite'), privateStage);
+    try {
+        for (const notice of notices) {
+            inbox.append(notice);
+            if (notice.readAt !== undefined)
+                inbox.markRead([notice.id], notice.readAt);
+        }
+    }
+    finally {
+        inbox.close();
+    }
+    const attachments = await AttachmentDeliveryService.openPartitioned(join(staging(layout.publicRoot), 'indexes', 'attachments'), privateStage);
+    try {
+        for (const item of deliveries) {
+            if (!/^[a-f0-9]{64}$/.test(item.id))
+                throw Error('附件迁移标识无效');
+            await safeTree(join(deliveryRoot, item.id));
+            await attachments.importExisting(item, await readFile(join(deliveryRoot, item.id)));
+        }
+    }
+    finally {
+        attachments.close();
+    }
+    for (const target of targets)
+        await verifyDatabases(staging(target));
+    for (const target of targets) {
+        await rename(staging(target), target);
+        await syncDirectory(dirname(target));
+    }
+    await atomicJson(journalPath, { ...journal, phase: 'installed' });
+    return { storageVersion: 1, backupPath: backup, retainedLegacy: true };
+}
+export async function verifyInstalledLayout(context) {
+    const layout = storageLayout(resolve(context.statePath), resolve(context.root));
+    const journal = JSON.parse(await readFile(join(layout.legacyPublic, 'storage-migration.json'), 'utf8'));
+    if (journal.phase !== 'installed')
+        throw Error('迁移尚未完成安装');
+    await new SplitStatePersistence(layout.publicRoot, layout.privateRoot).read();
+    for (const target of [layout.publicRoot, ...journal.owners.map(id => layout.privateRoot(id))]) {
+        const marker = JSON.parse(await readFile(join(target, 'migration-owner.json'), 'utf8'));
+        if (marker.transactionId !== journal.id)
+            throw Error('迁移目标标记不一致');
+        await verifyDatabases(target);
+    }
+}
+export async function commitLayoutVersion(context, expected, next) {
+    if (expected !== 0 || next !== 1)
+        throw Error('布局迁移版本无效');
+    const root = resolve(context.root), statePath = resolve(context.statePath), layout = storageLayout(statePath, root);
+    const current = await readStorageConfig(statePath, root);
+    if (current.storageVersion !== expected)
+        throw Error('迁移版本已被其他操作更新');
+    const journalPath = join(layout.legacyPublic, 'storage-migration.json');
+    const journal = JSON.parse(await readFile(journalPath, 'utf8'));
+    if (journal.phase !== 'installed')
+        throw Error('没有可提交的迁移');
+    await atomicJson(storageConfigPath(statePath), { storageVersion: next, transactionId: journal.id, workspaceRoot: root });
+    await atomicJson(journalPath, { ...journal, phase: 'committed' }).catch(() => { });
+    // Activation is durable. Cleanup failures must not be reported as a rollback.
+    try {
+        const cleanup = await cleanupArchivedSources(statePath, root, journal.id);
+        if (context.result) {
+            context.result.retainedLegacy = cleanup.pending > 0;
+            context.result.cleanupPending = cleanup.pending;
+        }
+    }
+    catch {
+        if (context.result) {
+            context.result.retainedLegacy = true;
+            context.result.cleanupPending = 1;
+        }
+    }
+}
+function canonical(value) {
+    const normalize = (v) => Array.isArray(v) ? v.map(normalize).sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b))) : v && typeof v === 'object' ? Object.fromEntries(Object.entries(v).filter(([, x]) => x !== undefined).sort(([a], [b]) => a.localeCompare(b)).map(([k, x]) => [k, normalize(x)])) : v;
+    return JSON.stringify(normalize(value));
+}
+//# sourceMappingURL=migrate-layout.js.map

package/lib/storage/migrate-layout.js.map

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

package/lib/storage/migrations/index.d.ts

@@ -0,0 +1,3 @@
+export { migrationPath, runMigrationPath } from './registry.js';
+export declare const storageMigrations: readonly [import("./registry.js").StorageMigration<import("../migrate-layout.js").LayoutMigrationContext>];
+//# sourceMappingURL=index.d.ts.map

package/lib/storage/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/migrations/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC/D,eAAO,MAAM,iBAAiB,4GAAoB,CAAA"}

package/lib/storage/migrations/index.js

@@ -0,0 +1,4 @@
+import { v0ToV1 } from './v0-to-v1.js';
+export { migrationPath, runMigrationPath } from './registry.js';
+export const storageMigrations = [v0ToV1];
+//# sourceMappingURL=index.js.map

package/lib/storage/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAU,CAAA"}

package/lib/storage/migrations/registry.d.ts

@@ -0,0 +1,19 @@
+/** A version is a complete public + private layout transition, never one
+ * companion. The coordinator supplies the exclusive gate and durable journal.
+ */
+export interface StorageMigration<Context> {
+    id: string;
+    from: number;
+    to: number;
+    title: string;
+    /** Absent while a step is inspection-only; do not expose an execute button. */
+    execute?: (context: Context) => Promise<void>;
+    verify?: (context: Context) => Promise<void>;
+}
+export declare function migrationPath<Context>(steps: readonly StorageMigration<Context>[], from: number, to: number): StorageMigration<Context>[];
+/** The caller must hold its runtime write gate throughout. On any error stop:
+ * reopen the persisted version/journal before retrying (including commit errors).
+ * This runner does not guess whether a failed commit reached durable storage.
+ */
+export declare function runMigrationPath<Context>(steps: readonly StorageMigration<Context>[], from: number, to: number, context: Context, commitVersion: (expected: number, next: number, migrationId: string) => Promise<void>): Promise<void>;
+//# sourceMappingURL=registry.d.ts.map

package/lib/storage/migrations/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/storage/migrations/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7C;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAiBzI;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7O"}

package/lib/storage/migrations/registry.js

@@ -0,0 +1,40 @@
+export function migrationPath(steps, from, to) {
+    if (![from, to].every(version => Number.isSafeInteger(version) && version >= 0))
+        throw Error('迁移版本必须是非负整数');
+    if (from > to)
+        throw Error('不支持自动降级数据目录');
+    const bySource = new Map();
+    const ids = new Set();
+    for (const step of steps) {
+        if (!step.id || ids.has(step.id) || bySource.has(step.from))
+            throw Error('迁移版本注册重复');
+        if (!Number.isSafeInteger(step.from) || step.from < 0 || step.to !== step.from + 1)
+            throw Error('迁移必须逐版本递增');
+        ids.add(step.id);
+        bySource.set(step.from, step);
+    }
+    const result = [];
+    for (let version = from; version < to; version++) {
+        const step = bySource.get(version);
+        if (!step)
+            throw Error(`缺少 v${version} → v${version + 1} 迁移脚本`);
+        result.push(step);
+    }
+    return result;
+}
+/** The caller must hold its runtime write gate throughout. On any error stop:
+ * reopen the persisted version/journal before retrying (including commit errors).
+ * This runner does not guess whether a failed commit reached durable storage.
+ */
+export async function runMigrationPath(steps, from, to, context, commitVersion) {
+    const path = migrationPath(steps, from, to);
+    // Refuse incomplete chains before touching even the first step.
+    if (path.some(step => !step.execute || !step.verify))
+        throw Error('迁移链尚未全部实现，拒绝执行');
+    for (const step of path) {
+        await step.execute(context);
+        await step.verify(context);
+        await commitVersion(step.from, step.to, step.id);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/lib/storage/migrations/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/storage/migrations/registry.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,aAAa,CAAU,KAA2C,EAAE,IAAY,EAAE,EAAU;IAC1G,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;QAAE,MAAM,KAAK,CAAC,aAAa,CAAC,CAAA;IAC3G,IAAI,IAAI,GAAG,EAAE;QAAE,MAAM,KAAK,CAAC,aAAa,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqC,CAAA;IAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,KAAK,CAAC,UAAU,CAAC,CAAA;QACpF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC;YAAE,MAAM,KAAK,CAAC,WAAW,CAAC,CAAA;QAC5G,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACjD,CAAC;IACD,MAAM,MAAM,GAAgC,EAAE,CAAA;IAC9C,KAAK,IAAI,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,KAAK,CAAC,OAAO,OAAO,OAAO,OAAO,GAAG,CAAC,OAAO,CAAC,CAAA;QAC/D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAU,KAA2C,EAAE,IAAY,EAAE,EAAU,EAAE,OAAgB,EAAE,aAAqF;IAC5N,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;IAC3C,gEAAgE;IAChE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAA;IACnF,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,OAAQ,CAAC,OAAO,CAAC,CAAA;QAC5B,MAAM,IAAI,CAAC,MAAO,CAAC,OAAO,CAAC,CAAA;QAC3B,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IAClD,CAAC;AACH,CAAC"}

package/lib/storage/migrations/v0-to-v1.d.ts

@@ -0,0 +1,5 @@
+import type { StorageMigration } from './registry.js';
+import { type LayoutMigrationContext } from '../migrate-layout.js';
+/** Owns only the v0 -> v1 transition. Later layouts get separate modules. */
+export declare const v0ToV1: StorageMigration<LayoutMigrationContext>;
+//# sourceMappingURL=v0-to-v1.d.ts.map

package/lib/storage/migrations/v0-to-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v0-to-v1.d.ts","sourceRoot":"","sources":["../../../src/storage/migrations/v0-to-v1.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAwC,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAExG,6EAA6E;AAC7E,eAAO,MAAM,MAAM,EAAE,gBAAgB,CAAC,sBAAsB,CAO3D,CAAA"}

package/lib/storage/migrations/v0-to-v1.js

@@ -0,0 +1,11 @@
+import { migrateLayout, verifyInstalledLayout } from '../migrate-layout.js';
+/** Owns only the v0 -> v1 transition. Later layouts get separate modules. */
+export const v0ToV1 = {
+    id: 'v0-to-v1-private-public-layout',
+    from: 0,
+    to: 1,
+    title: '公共数据归档与伙伴 .partner 私有目录',
+    execute: async (context) => { context.result = await migrateLayout(context.statePath, context.root, context.state); },
+    verify: verifyInstalledLayout,
+};
+//# sourceMappingURL=v0-to-v1.js.map

package/lib/storage/migrations/v0-to-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v0-to-v1.js","sourceRoot":"","sources":["../../../src/storage/migrations/v0-to-v1.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAA+B,MAAM,sBAAsB,CAAA;AAExG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,MAAM,GAA6C;IAC9D,EAAE,EAAE,gCAAgC;IACpC,IAAI,EAAE,CAAC;IACP,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,yBAAyB;IAChC,OAAO,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE,GAAG,OAAO,CAAC,MAAM,GAAC,MAAM,aAAa,CAAC,OAAO,CAAC,SAAS,EAAC,OAAO,CAAC,IAAI,EAAC,OAAO,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC;IAC9G,MAAM,EAAE,qBAAqB;CAC9B,CAAA"}

package/lib/storage/notice.d.ts

@@ -0,0 +1,4 @@
+import type { PartnerInboxStore } from '../notifications/store.js';
+/** Startup-only, local system notice. No model, channel delivery or directory scan. */
+export declare function syncStorageNotice(inbox: PartnerInboxStore, current: number, target: number): void;
+//# sourceMappingURL=notice.d.ts.map

package/lib/storage/notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notice.d.ts","sourceRoot":"","sources":["../../src/storage/notice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAElE,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASjG"}

package/lib/storage/notice.js

@@ -0,0 +1,13 @@
+/** Startup-only, local system notice. No model, channel delivery or directory scan. */
+export function syncStorageNotice(inbox, current, target) {
+    const id = `system:storage-migration:${target}`;
+    const pending = current < target;
+    const previous = inbox.snapshot().items.filter(item => item.kind === 'system' && item.action === 'storage-migration');
+    inbox.remove(previous.filter(item => !pending || item.id !== id).map(item => item.id));
+    if (!pending)
+        return;
+    inbox.append({ id, kind: 'system', action: 'storage-migration', companionId: '', companionName: '伙伴插件',
+        title: '需要升级数据目录',
+        summary: `当前存储版本 **${current}**，可升级到 **${target}**。\n\n升级会整理公共数据及各伙伴的私有目录。请先备份，再进入「设置 → 基本设置 → 升级迁移」检查并确认。\n\n**不会自动迁移**，点击下方「前往升级迁移」打开设置。`, createdAt: Date.now() });
+}
+//# sourceMappingURL=notice.js.map

package/lib/storage/notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notice.js","sourceRoot":"","sources":["../../src/storage/notice.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,KAAwB,EAAE,OAAe,EAAE,MAAc;IACzF,MAAM,EAAE,GAAG,4BAA4B,MAAM,EAAE,CAAA;IAC/C,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,mBAAmB,CAAC,CAAA;IACrH,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IACtF,IAAI,CAAC,OAAO;QAAE,OAAM;IACpB,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM;QACpG,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,YAAY,OAAO,aAAa,MAAM,4FAA4F,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;AACzK,CAAC"}

package/lib/storage/preflight.d.ts

@@ -0,0 +1,40 @@
+import type { PartnerState } from '../domain.js';
+export interface StorageCheckItem {
+    label: string;
+    source: string;
+    target: string;
+    files: number;
+    bytes: number;
+    exists: boolean;
+}
+export interface StorageInspection {
+    currentVersion: number;
+    targetVersion: number;
+    migrationAvailable: boolean;
+    consistentSnapshot: false;
+    items: StorageCheckItem[];
+    blockers: string[];
+    notices: string[];
+    checkedAt: number;
+    steps: {
+        id: string;
+        from: number;
+        to: number;
+        title: string;
+        available: boolean;
+    }[];
+}
+/** Read-only inventory. Never opens SQLite or reads config/credential payloads.
+ * Live sizes are estimates; the eventual migration must recheck under a gate.
+ */
+export declare class StoragePreflight {
+    private readonly statePath;
+    private readonly root;
+    private readonly version;
+    private readonly snapshot;
+    private pending;
+    constructor(statePath: string, root: string, version: number, snapshot: () => PartnerState);
+    inspect(): Promise<StorageInspection>;
+    private scan;
+}
+//# sourceMappingURL=preflight.d.ts.map

package/lib/storage/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/storage/preflight.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAKhD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;CAChB;AACD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,kBAAkB,EAAE,KAAK,CAAA;IACzB,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CACrF;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAEf,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAU,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAU,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAD1I,OAAO,CAAC,OAAO,CAAwC;gBAC1B,SAAS,EAAE,MAAM,EAAmB,IAAI,EAAE,MAAM,EAAmB,OAAO,EAAE,MAAM,EAAmB,QAAQ,EAAE,MAAM,YAAY;IAE9J,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;YAOvB,IAAI;CAmFnB"}

package/lib/storage/preflight.js

@@ -0,0 +1,208 @@
+import { access, lstat, readdir, readFile, statfs } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { storageLayout, storageVersion, TARGET_STORAGE_VERSION } from './layout.js';
+import { migrationPath, storageMigrations } from './migrations/index.js';
+import { legacyMemoryBackups } from './legacy-backups.js';
+/** Read-only inventory. Never opens SQLite or reads config/credential payloads.
+ * Live sizes are estimates; the eventual migration must recheck under a gate.
+ */
+export class StoragePreflight {
+    statePath;
+    root;
+    version;
+    snapshot;
+    pending;
+    constructor(statePath, root, version, snapshot) {
+        this.statePath = statePath;
+        this.root = root;
+        this.version = version;
+        this.snapshot = snapshot;
+    }
+    inspect() {
+        if (this.pending)
+            return this.pending;
+        const work = this.scan().finally(() => { if (this.pending === work)
+            this.pending = undefined; });
+        this.pending = work;
+        return work;
+    }
+    async scan() {
+        const state = this.snapshot();
+        const layout = storageLayout(resolve(this.statePath), resolve(this.root));
+        const result = {
+            currentVersion: storageVersion(this.version), targetVersion: TARGET_STORAGE_VERSION,
+            migrationAvailable: this.version < TARGET_STORAGE_VERSION, consistentSnapshot: false, items: [], blockers: [],
+            steps: migrationPath(storageMigrations, this.version, TARGET_STORAGE_VERSION).map(step => ({ id: step.id, from: step.from, to: step.to, title: step.title, available: !!step.execute && !!step.verify })),
+            notices: ['检查不会修改配置或数据库；运行中的文件数量与大小仅作预估。', '版本由迁移流程维护，请勿手动修改；公共和私有数据全部校验后才提交版本。', '凭据、宿主会话与知识库正文不搬动；工作文件和记录文档保持原位。'], checkedAt: Date.now(),
+        };
+        if (this.version === TARGET_STORAGE_VERSION) {
+            result.notices.push(`已使用新版公共目录：${layout.publicRoot}`);
+            return result;
+        }
+        let recoveryId;
+        try {
+            const journal = JSON.parse(await readFile(join(layout.legacyPublic, 'storage-migration.json'), 'utf8'));
+            if (typeof journal.id === 'string')
+                recoveryId = journal.id;
+        }
+        catch (error) {
+            if (!missing(error))
+                result.blockers.push('迁移恢复记录无法读取');
+        }
+        let budget = 50_000;
+        const inspectTree = async (path, device) => {
+            if (--budget < 0)
+                throw Error('文件数量超过检查上限，请先核对目录范围');
+            let entry;
+            try {
+                entry = await lstat(path);
+            }
+            catch (error) {
+                if (missing(error))
+                    return { exists: false, files: 0, bytes: 0 };
+                throw error;
+            }
+            if (entry.isSymbolicLink())
+                throw Error('包含符号链接，需人工确认');
+            if (device !== undefined && entry.dev !== device)
+                throw Error('跨文件系统目录，需人工确认');
+            if (entry.isFile()) {
+                await access(path, constants.R_OK);
+                return { exists: true, files: 1, bytes: entry.size };
+            }
+            if (!entry.isDirectory())
+                throw Error('包含特殊文件，需人工确认');
+            let files = 0, bytes = 0;
+            for (const child of await readdir(path)) {
+                const value = await inspectTree(join(path, child), entry.dev);
+                files += value.files;
+                bytes += value.bytes;
+            }
+            return { exists: true, files, bytes };
+        };
+        const inspect = async (label, source, target) => {
+            try {
+                await assertAncestors(source);
+                const value = await inspectTree(source);
+                result.items.push({ label, source, target, ...value });
+            }
+            catch (error) {
+                result.blockers.push(`${label}：${safeError(error)}`);
+            }
+        };
+        const targets = [layout.publicRoot];
+        await inspect('公共配置（待拆分私有字段）', resolve(this.statePath), join(layout.publicRoot, 'state'));
+        await inspect('Skill 安装库', layout.legacySkills, join(layout.publicRoot, 'skills'));
+        await inspect('消息索引（待按伙伴拆分）', join(layout.legacyPublic, 'partner-inbox.sqlite'), join(layout.publicRoot, 'indexes'));
+        await inspect('附件交付（待按伙伴拆分）', join(layout.legacyPublic, 'attachment-deliveries'), join(layout.publicRoot, 'indexes'));
+        const seen = new Set();
+        for (const companion of state.companions) {
+            if (seen.has(companion.id)) {
+                result.blockers.push('伙伴 ID 重复，不能迁移');
+                continue;
+            }
+            seen.add(companion.id);
+            let source, target;
+            try {
+                source = layout.legacyCompanion(companion.id);
+                target = layout.privateRoot(companion.id);
+            }
+            catch {
+                result.blockers.push('伙伴 ID 无效，不能迁移');
+                continue;
+            }
+            targets.push(target);
+            await inspect(`${companion.name} · 记忆`, join(source, 'memory'), join(target, 'memory'));
+            await inspect(`${companion.name} · 关注`, join(source, 'concerns'), join(target, 'concerns'));
+            try {
+                for (const name of await legacyMemoryBackups(source)) {
+                    await inspect(`${companion.name} · ${name}`, join(source, name), join(target, 'backups', 'legacy-memory', name));
+                    result.notices.push(`${companion.name} · ${name} 原样归档，不合并到当前记忆`);
+                }
+            }
+            catch (error) {
+                if (!missing(error))
+                    result.blockers.push(`${companion.name} · 备份检查：${safeError(error)}`);
+            }
+        }
+        const total = result.items.reduce((sum, item) => sum + item.bytes, 0);
+        for (const target of targets) {
+            try {
+                await assertAncestors(target);
+                let ancestor = target;
+                try {
+                    await lstat(target);
+                    let owned = false;
+                    if (recoveryId)
+                        try {
+                            const marker = JSON.parse(await readFile(join(target, 'migration-owner.json'), 'utf8'));
+                            owned = marker.transactionId === recoveryId;
+                        }
+                        catch { }
+                    if (!owned)
+                        result.blockers.push(`目标目录已存在，不允许覆盖：${target}`);
+                    else
+                        result.notices.push(`发现未提交的迁移，可安全重试：${target}`);
+                }
+                catch (error) {
+                    if (!missing(error))
+                        throw error;
+                }
+                while (true) {
+                    try {
+                        await lstat(ancestor);
+                        break;
+                    }
+                    catch (error) {
+                        if (!missing(error))
+                            throw error;
+                        ancestor = dirname(ancestor);
+                    }
+                }
+                await access(ancestor, constants.W_OK | constants.X_OK);
+                const fs = await statfs(ancestor);
+                // Deliberately conservative until an exact per-volume copy plan exists.
+                if (fs.bavail * fs.bsize < total * 3)
+                    result.blockers.push(`目标磁盘可用空间不足（含完整备份）：${target}`);
+            }
+            catch (error) {
+                result.blockers.push(`目标目录 ${target}：${safeError(error)}`);
+            }
+        }
+        result.notices.push(`已识别 ${state.companions.length} 位伙伴；私有配置还需从公共 state.json 按归属拆分，不是整份复制到每个伙伴。`);
+        result.migrationAvailable = result.blockers.length === 0;
+        return result;
+    }
+}
+async function assertAncestors(path) {
+    const paths = [];
+    for (let current = resolve(path);;) {
+        paths.push(current);
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    for (const current of paths.reverse()) {
+        try {
+            if ((await lstat(current)).isSymbolicLink())
+                throw Error('路径含符号链接，需人工确认');
+        }
+        catch (error) {
+            if (missing(error))
+                return;
+            throw error;
+        }
+    }
+}
+function missing(error) { return error?.code === 'ENOENT'; }
+function safeError(error) {
+    const code = error?.code;
+    if (code === 'EACCES' || code === 'EPERM')
+        return '目录读写权限不足';
+    if (code)
+        return `文件检查失败（${code}）`;
+    return error instanceof Error ? error.message : '检查失败';
+}
+//# sourceMappingURL=preflight.js.map