@brainmcp/brainmcp 0.1.12 → 0.1.14

package/dist/runtime/retention.js

@@ -0,0 +1,175 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getBrainHome, assertNotSymlink, resolveStateDir } from './storage.js';
+import { listQueueItems, removeQueueItem } from './queue.js';
+import { isProcessAlive } from './lock.js';
+const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
+const FOURTEEN_DAYS_MS = 14 * 24 * 60 * 60 * 1000;
+const FIVE_MB_BYTES = 5 * 1024 * 1024;
+function listOwnedJsonFiles(directory, accepts) {
+    if (!fs.existsSync(directory))
+        return [];
+    assertNotSymlink(directory);
+    return fs.readdirSync(directory).flatMap((entry) => {
+        if (!accepts(entry))
+            return [];
+        const filePath = path.join(directory, entry);
+        try {
+            const stat = fs.lstatSync(filePath);
+            return stat.isFile() && !stat.isSymbolicLink() ? [filePath] : [];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+export function previewCapturePurge(baseDir) {
+    const stateDir = resolveStateDir(baseDir);
+    return {
+        queueItems: listOwnedJsonFiles(path.join(stateDir, 'queue'), (name) => name.endsWith('.json')).length,
+        sessionLedgers: listOwnedJsonFiles(path.join(stateDir, 'sessions'), (name) => name.endsWith('.json')).length,
+        orientationCacheFiles: listOwnedJsonFiles(path.join(stateDir, 'cache'), (name) => name.startsWith('orient-') && name.endsWith('.json')).length,
+    };
+}
+/** Delete only BrainMCP-owned queue, session-ledger, and orientation-cache files. */
+export function purgeCaptureLocalState(baseDir) {
+    const stateDir = resolveStateDir(baseDir);
+    const groups = [
+        listOwnedJsonFiles(path.join(stateDir, 'queue'), (name) => name.endsWith('.json')),
+        listOwnedJsonFiles(path.join(stateDir, 'sessions'), (name) => name.endsWith('.json')),
+        listOwnedJsonFiles(path.join(stateDir, 'cache'), (name) => name.startsWith('orient-') && name.endsWith('.json')),
+    ];
+    const removed = {
+        queueItems: 0,
+        sessionLedgers: 0,
+        orientationCacheFiles: 0,
+    };
+    const keys = ['queueItems', 'sessionLedgers', 'orientationCacheFiles'];
+    groups.forEach((files, index) => {
+        for (const filePath of files) {
+            try {
+                fs.unlinkSync(filePath);
+                removed[keys[index]] += 1;
+            }
+            catch {
+                // Report only confirmed deletions; callers can preview again if needed.
+            }
+        }
+    });
+    return removed;
+}
+/**
+ * Safely prunes expired queue items, old session ledgers, stale locks, and trims logs (AHI-058).
+ * Never touches active credentials or installed runtime files.
+ */
+export function pruneLocalState(options) {
+    const baseDir = resolveStateDir(options?.baseDir ?? getBrainHome());
+    const now = options?.now ?? Date.now();
+    const maxQueueAge = options?.maxQueueAgeMs ?? SEVEN_DAYS_MS;
+    const maxSessionAge = options?.maxSessionAgeMs ?? FOURTEEN_DAYS_MS;
+    const maxLogSize = options?.maxLogSizeBytes ?? FIVE_MB_BYTES;
+    let prunedQueueCount = 0;
+    let prunedSessionCount = 0;
+    let prunedLockCount = 0;
+    let logRotated = false;
+    // 1. Prune queue items
+    try {
+        const items = listQueueItems(baseDir);
+        for (const item of items) {
+            const createdAtMs = new Date(item.createdAt).getTime();
+            if (now - createdAtMs > maxQueueAge || item.status === 'delivered') {
+                if (removeQueueItem(item.digestId, baseDir)) {
+                    prunedQueueCount += 1;
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore pruning errors
+    }
+    // 2. Prune old session files
+    const sessionsDir = path.join(baseDir, 'sessions');
+    if (fs.existsSync(sessionsDir)) {
+        try {
+            assertNotSymlink(sessionsDir);
+            const sessionFiles = fs.readdirSync(sessionsDir);
+            for (const file of sessionFiles) {
+                if (!file.endsWith('.json'))
+                    continue;
+                const filePath = path.join(sessionsDir, file);
+                try {
+                    const stat = fs.lstatSync(filePath);
+                    if (!stat.isSymbolicLink() && now - stat.mtimeMs > maxSessionAge) {
+                        fs.unlinkSync(filePath);
+                        prunedSessionCount += 1;
+                    }
+                }
+                catch {
+                    // Ignore
+                }
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // 3. Prune stale locks (> 1 hour old or definitely dead)
+    const locksDir = path.join(baseDir, 'locks');
+    if (fs.existsSync(locksDir)) {
+        try {
+            assertNotSymlink(locksDir);
+            const lockFiles = fs.readdirSync(locksDir);
+            for (const file of lockFiles) {
+                if (!file.endsWith('.lock'))
+                    continue;
+                const filePath = path.join(locksDir, file);
+                try {
+                    const stat = fs.lstatSync(filePath);
+                    if (!stat.isSymbolicLink() && now - stat.mtimeMs > 60 * 1000) {
+                        try {
+                            if (isProcessAlive(JSON.parse(fs.readFileSync(filePath, 'utf8')).pid))
+                                continue;
+                        }
+                        catch { /* Old malformed locks have no owner to protect. */ }
+                        fs.unlinkSync(filePath);
+                        prunedLockCount += 1;
+                    }
+                }
+                catch {
+                    // Ignore
+                }
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // 4. Rotate or truncate runtime log if exceeding size
+    const logFile = path.join(baseDir, 'logs', 'runtime.log');
+    if (fs.existsSync(logFile)) {
+        try {
+            assertNotSymlink(logFile);
+            const stat = fs.lstatSync(logFile);
+            if (!stat.isSymbolicLink() && stat.size > maxLogSize) {
+                // Truncate keeping the last 1MB
+                const keepBytes = 1024 * 1024;
+                const buffer = Buffer.alloc(keepBytes);
+                const fd = fs.openSync(logFile, 'r');
+                fs.readSync(fd, buffer, 0, keepBytes, stat.size - keepBytes);
+                fs.closeSync(fd);
+                fs.writeFileSync(logFile, buffer, { mode: 0o600 });
+                logRotated = true;
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return {
+        prunedQueueCount,
+        prunedSessionCount,
+        prunedLockCount,
+        logRotated,
+    };
+}
+//# sourceMappingURL=retention.js.map

package/dist/runtime/retention.js.map

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

package/dist/runtime/session.d.ts

@@ -0,0 +1,68 @@
+import { type SessionLedgerRecord, type QueueItemRecord } from '../lib/cli-contracts.js';
+import { enqueueCaptureItem } from './queue.js';
+export interface BrainToolExecutionResult {
+    isWriteBack: boolean;
+    actionKind?: 'proposal_created' | 'proposal_applied' | 'idempotent' | 'tags_updated' | 'other_write';
+    status?: string;
+    proposalId?: string;
+    note?: string;
+}
+/**
+ * Parse structured Brain tool results to distinguish proposal created/applied/idempotent
+ * from failed calls and digest capture (AHI-056).
+ */
+export declare function parseBrainToolResult(toolName: string, toolResult: unknown): BrainToolExecutionResult;
+export declare function getSessionLedgerPath(sessionKey: string, baseDir?: string): string;
+export declare function loadSessionLedger(sessionKey: string, baseDir?: string): SessionLedgerRecord;
+export declare function saveSessionLedger(sessionKey: string, ledger: SessionLedgerRecord, baseDir?: string): void;
+/**
+ * Return the most recently active valid session ledger without creating one.
+ * Manual capture uses this bounded local record instead of inventing content or
+ * opening host transcript files.
+ */
+export declare function loadMostRecentSessionLedger(baseDir?: string, projectKey?: string): SessionLedgerRecord | null;
+export interface RecordEventInput {
+    sessionKey: string;
+    baseDir?: string;
+    isMeaningful?: boolean;
+    editedPath?: string;
+    prompt?: string;
+    assistantSummary?: string;
+    model?: string;
+    /** Persist prompt text only after capture + includePrompts consent (AHI-D02). */
+    persistPrompts?: boolean;
+    toolResult?: {
+        toolName: string;
+        result: unknown;
+    };
+    deliveryId?: string;
+    now?: string;
+    captureRevision?: number;
+    projectKey?: string;
+    workspaceId?: string;
+}
+/**
+ * Updates session ledger under session lock maintaining monotonic sequence counters (AHI-055).
+ */
+export declare function recordSessionEvent(input: RecordEventInput): Promise<SessionLedgerRecord>;
+/** Mark a queued slice without creating another lifecycle event sequence. */
+export declare function markSessionCaptured(input: {
+    sessionKey: string;
+    digestId: string;
+    capturedThroughSequence: number;
+    baseDir?: string;
+    now?: string;
+}): Promise<SessionLedgerRecord>;
+/** Reserve a sequence and enqueue it in the same local critical section. */
+export declare function queueSessionCapture(input: {
+    sessionKey: string;
+    capturedThroughSequence: number;
+    baseDir?: string;
+    item: Parameters<typeof enqueueCaptureItem>[0];
+}): Promise<QueueItemRecord | null>;
+export declare function markSessionNudged(input: {
+    sessionKey: string;
+    nudgedThroughSequence: number;
+    baseDir?: string;
+    now?: string;
+}): Promise<SessionLedgerRecord>;

package/dist/runtime/session.js

@@ -0,0 +1,283 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { SESSION_LEDGER_SCHEMA_VERSION, validateSessionLedgerRecord, scrubSecrets, } from '../lib/cli-contracts.js';
+import { enqueueCaptureItem, listQueueItems } from './queue.js';
+import { canEnqueueCapture } from './flush.js';
+import { ensureDirectory0700, writeAtomic0600, readSafeJson, resolveStateDir } from './storage.js';
+import { withSessionLock } from './lock.js';
+/**
+ * Parse structured Brain tool results to distinguish proposal created/applied/idempotent
+ * from failed calls and digest capture (AHI-056).
+ */
+export function parseBrainToolResult(toolName, toolResult) {
+    toolName = toolName.replace(/^mcp__brain__/, '').replace(/^mcp__brainmcp__/, '');
+    if (!toolName || !toolResult) {
+        return { isWriteBack: false };
+    }
+    // Digest capture or read operations NEVER count as graph write-back
+    if (toolName === 'brain_session_digest' ||
+        toolName === 'brain_digest_pending' ||
+        toolName === 'brain_digest_complete' ||
+        toolName.includes('read') ||
+        toolName.includes('overview') ||
+        toolName.includes('search') ||
+        toolName.includes('list')) {
+        return { isWriteBack: false };
+    }
+    let resultObj = toolResult;
+    if (typeof toolResult === 'string') {
+        try {
+            resultObj = JSON.parse(toolResult);
+        }
+        catch {
+            // Plain text output is not structured tool result
+            return { isWriteBack: false };
+        }
+    }
+    if (typeof resultObj !== 'object' || resultObj === null) {
+        return { isWriteBack: false };
+    }
+    // If MCP call returned isError or error field
+    if (resultObj.isError || resultObj.error) {
+        return { isWriteBack: false, status: 'error' };
+    }
+    // Current MCP results wrap the payload in structuredContent/data. Some
+    // hosts expose the serialized text-content fallback instead.
+    if (resultObj.structuredContent)
+        return parseBrainToolResult(toolName, resultObj.structuredContent);
+    if (resultObj.kind === 'tool_error')
+        return { isWriteBack: false, status: 'error' };
+    if (resultObj.data && typeof resultObj.data === 'object')
+        return parseBrainToolResult(toolName, resultObj.data);
+    if (Array.isArray(resultObj.content)) {
+        for (const block of resultObj.content.slice(0, 8)) {
+            if (block?.type !== 'text' || typeof block.text !== 'string')
+                continue;
+            const parsed = parseBrainToolResult(toolName, block.text);
+            if (parsed.isWriteBack)
+                return parsed;
+        }
+        return { isWriteBack: false };
+    }
+    // Handle brain_change_propose / brain_remember / brain_amend
+    if (toolName === 'brain_change_propose' ||
+        toolName === 'brain_remember' ||
+        toolName === 'brain_amend' ||
+        toolName === 'brain_tags_set') {
+        const proposal = resultObj.proposal ?? resultObj;
+        const status = proposal.status ?? resultObj.status;
+        const proposalId = proposal.id ?? resultObj.id ?? resultObj.proposalId;
+        if (status === 'applied' && proposalId) {
+            const isIdempotent = Boolean(resultObj.idempotentReplay || resultObj.idempotent || proposal.idempotent);
+            return {
+                isWriteBack: true,
+                actionKind: isIdempotent ? 'idempotent' : 'proposal_applied',
+                status: 'applied',
+                proposalId,
+            };
+        }
+        if (proposalId && (status === 'pending' || status === 'pending_review' || status === 'review_required' || status === 'queued')) {
+            return {
+                isWriteBack: true,
+                actionKind: 'proposal_created',
+                status: 'pending_review',
+                proposalId,
+                note: 'Proposal created awaiting review',
+            };
+        }
+        if (status === 'rejected' || status === 'failed') {
+            return { isWriteBack: false, status };
+        }
+        // Default if proposal created with an ID
+        if (proposalId) {
+            return {
+                isWriteBack: true,
+                actionKind: 'proposal_created',
+                proposalId,
+                status: status ?? 'created',
+            };
+        }
+    }
+    return { isWriteBack: false };
+}
+export function getSessionLedgerPath(sessionKey, baseDir) {
+    const sessionsDir = path.join(resolveStateDir(baseDir), 'sessions');
+    ensureDirectory0700(sessionsDir);
+    const safeKey = sessionKey.replace(/[^a-zA-Z0-9_-]/g, '_');
+    return path.join(sessionsDir, `${safeKey}.json`);
+}
+export function loadSessionLedger(sessionKey, baseDir) {
+    const filePath = getSessionLedgerPath(sessionKey, baseDir);
+    const existing = readSafeJson(filePath, validateSessionLedgerRecord);
+    if (existing) {
+        return existing;
+    }
+    const now = new Date().toISOString();
+    return {
+        version: SESSION_LEDGER_SCHEMA_VERSION,
+        sessionKey,
+        createdAt: now,
+        lastEventAt: now,
+        eventSequence: 0,
+        editedPaths: [],
+        deliveryIds: [],
+    };
+}
+export function saveSessionLedger(sessionKey, ledger, baseDir) {
+    const filePath = getSessionLedgerPath(sessionKey, baseDir);
+    writeAtomic0600(filePath, JSON.stringify(ledger, null, 2));
+}
+/**
+ * Return the most recently active valid session ledger without creating one.
+ * Manual capture uses this bounded local record instead of inventing content or
+ * opening host transcript files.
+ */
+export function loadMostRecentSessionLedger(baseDir, projectKey) {
+    const sessionsDir = path.join(resolveStateDir(baseDir), 'sessions');
+    if (!fs.existsSync(sessionsDir))
+        return null;
+    const directory = fs.lstatSync(sessionsDir);
+    if (directory.isSymbolicLink() || !directory.isDirectory()) {
+        throw new Error(`Security violation: ${sessionsDir} is not a safe session directory`);
+    }
+    let latest = null;
+    let latestAt = Number.NEGATIVE_INFINITY;
+    for (const entry of fs.readdirSync(sessionsDir).slice(0, 1_000)) {
+        if (!entry.endsWith('.json'))
+            continue;
+        const filePath = path.join(sessionsDir, entry);
+        try {
+            const ledger = readSafeJson(filePath, validateSessionLedgerRecord);
+            if (!ledger)
+                continue;
+            if (projectKey && ledger.projectKey !== projectKey)
+                continue;
+            const timestamp = Date.parse(ledger.lastEventAt);
+            const comparable = Number.isFinite(timestamp) ? timestamp : fs.lstatSync(filePath).mtimeMs;
+            if (comparable > latestAt) {
+                latest = ledger;
+                latestAt = comparable;
+            }
+        }
+        catch {
+            // A malformed, unsafe, or stale entry must not block other valid ledgers.
+        }
+    }
+    return latest;
+}
+/**
+ * Updates session ledger under session lock maintaining monotonic sequence counters (AHI-055).
+ */
+export async function recordSessionEvent(input) {
+    return withSessionLock(input.sessionKey, async () => {
+        const ledger = loadSessionLedger(input.sessionKey, input.baseDir);
+        const timestamp = input.now ?? new Date().toISOString();
+        if (input.captureRevision !== undefined && (ledger.captureRevision !== input.captureRevision || ledger.workspaceId !== input.workspaceId)) {
+            ledger.prompts = [];
+            ledger.editedPaths = [];
+            ledger.assistantSummary = undefined;
+            ledger.model = undefined;
+            ledger.lastCapturedSequence = ledger.eventSequence;
+            ledger.captureRevision = input.captureRevision;
+            ledger.workspaceId = input.workspaceId;
+        }
+        // Monotonic sequence bump
+        ledger.eventSequence += 1;
+        ledger.lastEventAt = timestamp;
+        if (input.projectKey)
+            ledger.projectKey = input.projectKey;
+        if (input.editedPath && !ledger.editedPaths.includes(input.editedPath)) {
+            if (ledger.editedPaths.length >= 100) {
+                ledger.editedPaths.shift();
+            }
+            ledger.editedPaths.push(input.editedPath);
+        }
+        if (input.prompt && input.persistPrompts) {
+            if (!ledger.prompts)
+                ledger.prompts = [];
+            if (ledger.prompts.length >= 50) {
+                ledger.prompts.shift();
+            }
+            ledger.prompts.push(scrubSecrets(input.prompt).slice(0, 1000));
+        }
+        if (input.assistantSummary?.trim()) {
+            ledger.assistantSummary = scrubSecrets(input.assistantSummary.trim()).slice(0, 4000);
+        }
+        if (input.model?.trim()) {
+            ledger.model = input.model.trim().slice(0, 120);
+        }
+        if (input.deliveryId && !ledger.deliveryIds.includes(input.deliveryId)) {
+            ledger.deliveryIds.push(input.deliveryId);
+            ledger.deliveryIds = ledger.deliveryIds.slice(-100);
+        }
+        if (input.isMeaningful) {
+            ledger.lastMeaningfulAt = timestamp;
+            ledger.lastMeaningfulSequence = Math.max(ledger.lastMeaningfulSequence ?? 0, ledger.eventSequence);
+        }
+        // Check tool result for structured Brain write-back (AHI-056)
+        if (input.toolResult) {
+            const parsed = parseBrainToolResult(input.toolResult.toolName, input.toolResult.result);
+            if (parsed.isWriteBack) {
+                ledger.lastSuccessfulWriteBackAt = timestamp;
+                ledger.lastSuccessfulWriteBackSequence = Math.max(ledger.lastSuccessfulWriteBackSequence ?? 0, ledger.eventSequence);
+            }
+        }
+        saveSessionLedger(input.sessionKey, ledger, input.baseDir);
+        return ledger;
+    }, { baseDir: input.baseDir, timeoutMs: 250 });
+}
+/** Mark a queued slice without creating another lifecycle event sequence. */
+export async function markSessionCaptured(input) {
+    return withSessionLock(input.sessionKey, async () => {
+        const ledger = loadSessionLedger(input.sessionKey, input.baseDir);
+        ledger.lastCapturedAt = input.now ?? new Date().toISOString();
+        ledger.lastCapturedSequence = Math.max(ledger.lastCapturedSequence ?? 0, input.capturedThroughSequence);
+        if (!ledger.deliveryIds.includes(input.digestId))
+            ledger.deliveryIds.push(input.digestId);
+        ledger.deliveryIds = ledger.deliveryIds.slice(-100);
+        saveSessionLedger(input.sessionKey, ledger, input.baseDir);
+        return ledger;
+    }, { baseDir: input.baseDir });
+}
+/** Reserve a sequence and enqueue it in the same local critical section. */
+export async function queueSessionCapture(input) {
+    return withSessionLock(input.sessionKey, () => withSessionLock('capture-queue', () => {
+        const ledger = loadSessionLedger(input.sessionKey, input.baseDir);
+        if ((ledger.lastCapturedSequence ?? 0) >= input.capturedThroughSequence)
+            return null;
+        // Deterministic UUID makes a crash between enqueue and ledger save retry
+        // the same server idempotency key without resetting an existing delivery.
+        const hash = createHash('sha256').update(JSON.stringify([input.sessionKey, input.capturedThroughSequence,
+            input.item.authorizationId, input.item.consentRevision, input.item.workspaceId])).digest('hex');
+        const digestId = `${hash.slice(0, 8)}-${hash.slice(8, 12)}-4${hash.slice(13, 16)}-8${hash.slice(17, 20)}-${hash.slice(20, 32)}`;
+        let item = listQueueItems(input.baseDir).find((queued) => queued.digestId === digestId);
+        if (!item) {
+            if (!canEnqueueCapture(input.baseDir))
+                return null;
+            let digestText = input.item.digestText;
+            try {
+                const payload = JSON.parse(digestText);
+                if (payload && typeof payload === 'object' && 'clientDigestId' in payload)
+                    digestText = JSON.stringify({ ...payload, clientDigestId: digestId });
+            }
+            catch { /* A bounded plain-text digest is also valid. */ }
+            item = enqueueCaptureItem({ ...input.item, digestId, digestText }, input.baseDir);
+        }
+        ledger.lastCapturedAt = item.createdAt;
+        ledger.lastCapturedSequence = input.capturedThroughSequence;
+        ledger.deliveryIds = [...ledger.deliveryIds, item.digestId].slice(-100);
+        saveSessionLedger(input.sessionKey, ledger, input.baseDir);
+        return item;
+    }, { baseDir: input.baseDir, timeoutMs: 250 }), { baseDir: input.baseDir, timeoutMs: 250 });
+}
+export async function markSessionNudged(input) {
+    return withSessionLock(input.sessionKey, async () => {
+        const ledger = loadSessionLedger(input.sessionKey, input.baseDir);
+        ledger.lastNudgedAt = input.now ?? new Date().toISOString();
+        ledger.lastNudgedSequence = Math.max(ledger.lastNudgedSequence ?? 0, input.nudgedThroughSequence);
+        saveSessionLedger(input.sessionKey, ledger, input.baseDir);
+        return ledger;
+    }, { baseDir: input.baseDir });
+}
+//# sourceMappingURL=session.js.map

package/dist/runtime/session.js.map

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

package/dist/runtime/storage.d.ts

@@ -0,0 +1,32 @@
+import { type PreferencesRecord } from '../lib/cli-contracts.js';
+export declare const CURRENT_ACCOUNT_SCHEMA_VERSION = 1;
+export declare const SERVICE_ACCOUNT_ID = "service";
+export declare const ACCOUNTS_DIR_NAME = "accounts";
+export declare const CURRENT_ACCOUNT_FILENAME = "current.json";
+export interface CurrentAccountRecord {
+    version: typeof CURRENT_ACCOUNT_SCHEMA_VERSION;
+    accountId: string;
+    updatedAt: string;
+}
+export declare function getBrainHome(): string;
+export declare function sanitizeAccountId(accountId: string): string;
+export declare function getCurrentAccountPath(brainHome?: string): string;
+export declare function validateCurrentAccountRecord(data: unknown): CurrentAccountRecord;
+export declare function getCurrentAccountId(brainHome?: string): string | null;
+export declare function getAccountStateDir(brainHome: string, accountId: string): string;
+/**
+ * Per-account state directory when `current.json` is present.
+ * Without a current account, callers keep using the brain home (legacy layout and tests).
+ */
+export declare function resolveStateDir(brainHome?: string): string;
+export declare function switchCurrentAccount(brainHome: string, accountId: string): string;
+export declare function clearCurrentAccount(brainHome: string): void;
+export declare function migrateLegacyFlatState(brainHome: string, accountId: string): string[];
+export declare function activateAccount(brainHome: string, accountId: string): string;
+export declare function ensureDirectory0700(dirPath: string): void;
+export declare function assertNotSymlink(targetPath: string): void;
+export declare function writeAtomic0600(filePath: string, content: string): void;
+export declare function readSafeJson<T>(filePath: string, validator?: (data: unknown) => T): T | null;
+export declare function getPreferencesPath(baseDir?: string): string;
+export declare function readPreferences(baseDir?: string): PreferencesRecord | null;
+export declare function writePreferences(prefs: PreferencesRecord, baseDir?: string): void;