@remnic/core 9.69.55 → 9.69.57

package/dist/storage/tombstone-blocked-capture-index.d.ts

@@ -0,0 +1,93 @@
+import type { MemoryFile, MemoryFrontmatter } from "../types.js";
+import type { withHeldFileLock } from "../utils/serialize-mutations.js";
+import { type ContentHashIndexLockOptions } from "./content-hash-index.js";
+import type { OfflineSyncMemoryParser } from "./tombstone-blocked-capture-sync.js";
+export { buildExplicitCaptureDedupKey, isTombstoneBlockedCaptureWriteLockBusy, normalizeExplicitCaptureContent, } from "./tombstone-blocked-capture-mutation.js";
+export { parseTombstoneBlockedOfflineSyncMemory, type OfflineSyncMemoryParser, TombstoneBlockedCaptureIndexHost, } from "./tombstone-blocked-capture-sync.js";
+export type TombstoneBlockedCaptureIndexOptions = {
+    readonly stateDir: string;
+    readonly memoryDir: string;
+    readonly secureStoreKeyProvider: () => Buffer | null;
+    readonly secureStoreWriteKeyProvider: () => Buffer | null;
+    readonly lockOptions: () => ContentHashIndexLockOptions;
+    readonly readAllMemories: () => Promise<MemoryFile[]>;
+    readonly readAllColdMemories: () => Promise<MemoryFile[]>;
+    readonly parseMemory?: OfflineSyncMemoryParser;
+    readonly withHeldFileLock?: typeof withHeldFileLock;
+};
+/**
+ * Durable targeted deduplication for tombstone-blocked explicit captures.
+ *
+ * The active fact-hash index intentionally excludes blocked rows. This small
+ * companion index keeps the blocked identity visible without making every
+ * authoritative active-index miss scan the full corpus.
+ */
+export declare class TombstoneBlockedCaptureIndex {
+    private readonly options;
+    private index;
+    private loadPromise;
+    private refreshPromise;
+    private authoritative;
+    private readonly captureWriteLock;
+    constructor(options: TombstoneBlockedCaptureIndexOptions);
+    private createIndex;
+    private indexPath;
+    private rebuildMarkerPath;
+    private readRebuildMarkers;
+    private isAbandonedMarker;
+    private isProcessAlive;
+    private readProcessStartedAtMs;
+    private getClearableRebuildMarkerPaths;
+    private getRebuildMarkers;
+    private writeMarkerAtomically;
+    private markRebuildRequired;
+    private markRebuildCommitted;
+    private clearRebuildRequired;
+    private hasRebuildRequired;
+    private setAuthoritative;
+    private isBlocked;
+    private rebuild;
+    private hasPersistedIndexOrMarkers;
+    private getIndex;
+    withCaptureWriteLock<T>(task: () => Promise<T>, identity?: string | readonly string[]): Promise<T>;
+    withCaptureWriteLockHashes<T>(task: () => Promise<T>, identityHashes: readonly string[]): Promise<T>;
+    withCaptureWriteLockAndHashes<T>(task: () => Promise<T>, identity: string | readonly string[] | undefined, identityHashes: readonly string[]): Promise<T>;
+    private reload;
+    /** Return blocked-row membership and authority from one index snapshot. */
+    check(content: string, category: string, sourceConnector?: string): Promise<{
+        has: boolean;
+        authoritative: boolean;
+    }>;
+    /** Return whether a blocked row matches this explicit-capture identity. */
+    has(content: string, category: string, sourceConnector?: string): Promise<boolean>;
+    /** Return whether the in-memory index is safe to answer an authoritative miss. */
+    isAuthoritative(): Promise<boolean>;
+    /** Reserve durable rebuild intent before a blocked memory file is committed. */
+    prepareWrite(): Promise<string>;
+    /** Mark a prepared write committed once its memory file is durable. */
+    commitWrite(rebuildMarker: string): Promise<void>;
+    /** Drop a pending marker when the protected memory write never commits. */
+    discardWrite(rebuildMarker: string): Promise<void>;
+    /** Add a newly persisted blocked row to the durable targeted index. */
+    add(memory: MemoryFile, rebuildMarker?: string): Promise<void>;
+    /** Rebuild the index after a blocked row changes or is removed. */
+    rebuildIfLoaded(ownedMarker?: string): Promise<void>;
+    /** Rebuild when either side of a write is blocked and its identity changed. */
+    sync(before: MemoryFile, after: MemoryFile, rebuildMarker?: string): Promise<void>;
+    markUntrusted(): void;
+    private failOpen;
+    addWrittenMemory(pathname: string, frontmatter: MemoryFrontmatter, content: string, rebuildMarker?: string): Promise<void>;
+    rebuildAfterInvalidation(ownedMarker?: string): Promise<void>;
+    /**
+     * Drop an already-committed write marker without re-reading the corpus. The
+     * offline-sync mutation path commits its marker around the file write, then
+     * must clear it even when the write cannot have changed the blocked key set
+     * (neither side tombstone-blocked) — otherwise the marker lingers until some
+     * later rebuild clears it. Mirrors the tail of `add`/`sync`.
+     */
+    clearCommittedWriteMarker(rebuildMarker: string): Promise<void>;
+    syncUpdatedMemory(before: MemoryFile, frontmatter: MemoryFrontmatter, content: string, rebuildMarker?: string): Promise<void>;
+    syncUpdatedFrontmatter(before: MemoryFile, frontmatter: MemoryFrontmatter, rebuildMarker?: string): Promise<void>;
+    shouldRebuildAfterInvalidationForPath(filePath: string): boolean;
+}
+//# sourceMappingURL=tombstone-blocked-capture-index.d.ts.map

package/dist/storage/tombstone-blocked-capture-index.d.ts.map

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

package/dist/storage/tombstone-blocked-capture-mutation.d.ts

@@ -0,0 +1,53 @@
+import { withHeldFileLock } from "../utils/serialize-mutations.js";
+import type { MemoryFile, MemoryFrontmatter } from "../types.js";
+import type { CasRevisionTransaction } from "./cas-revision-store.js";
+export declare function isTombstoneBlockedCaptureWriteLockBusy(error: unknown): boolean;
+export declare function normalizeExplicitCaptureContent(value: string): string;
+export declare function buildExplicitCaptureDedupKey(content: string, category: string, sourceConnector: string | undefined): string;
+export declare function buildCapturePathLockIdentity(pathname: string): string;
+export declare function captureIdentityHash(memory: MemoryFile): string;
+export type TombstoneBlockedCaptureWriteLockOptions = {
+    readonly stateDir: string;
+    readonly withHeldFileLock?: typeof withHeldFileLock;
+};
+export declare class TombstoneBlockedCaptureWriteLock {
+    private readonly options;
+    private readonly context;
+    constructor(options: TombstoneBlockedCaptureWriteLockOptions);
+    private captureWriteLockPathForHash;
+    private withSingleCaptureWriteLock;
+    private withPhysicalCaptureWriteLocks;
+    withCaptureWriteLock<T>(task: () => Promise<T>, identity?: string | readonly string[]): Promise<T>;
+    withCaptureWriteLockHashes<T>(task: () => Promise<T>, identityHashes: readonly string[]): Promise<T>;
+    withCaptureWriteLockAndHashes<T>(task: () => Promise<T>, identity: string | readonly string[] | undefined, identityHashes: readonly string[]): Promise<T>;
+    private withCaptureWriteLocks;
+}
+export type TombstoneBlockedMutationHost = {
+    readCurrent: () => Promise<MemoryFile | null>;
+    isBlocked: (memory: MemoryFile | null) => boolean;
+    isQueuedReview: (memory: MemoryFile | null) => boolean;
+    memoryIdentity: (memory: MemoryFile) => string;
+    prepareWrite: () => Promise<string>;
+    commitWrite: (marker: string) => Promise<void>;
+    discardWrite: (marker: string) => Promise<void>;
+    markUntrusted: () => void;
+    writeStorageSecureFile: (pathname: string, fileContent: string) => Promise<void>;
+    withCaptureWriteLock: (task: () => Promise<void>, identity: string | readonly string[]) => Promise<void>;
+    logWarning: (message: string) => void;
+    beginDurableMemoryRevision?: (pathname: string, expectedContent?: string | Buffer | null) => Promise<CasRevisionTransaction | undefined>;
+};
+export type TombstoneBlockedMutation = {
+    blocked: boolean;
+    pathname: string;
+    fileContent: string;
+    identity: string | readonly string[];
+    updateIndex: (rebuildMarker?: string, current?: MemoryFile | null) => Promise<void>;
+    beforeIndexUpdate?: () => Promise<void>;
+    coordinate?: boolean;
+    shouldMintRevision?: (current: MemoryFile | null) => boolean;
+};
+export declare function runTombstoneBlockedMutation(host: TombstoneBlockedMutationHost, mutation: TombstoneBlockedMutation): Promise<string | undefined>;
+export declare function tombstoneBlocked(frontmatter: MemoryFrontmatter): boolean;
+export declare function isQueuedReviewFrontmatter(frontmatter: MemoryFrontmatter): boolean;
+export declare function isQueuedReviewMemory(memory: MemoryFile | null): memory is MemoryFile;
+//# sourceMappingURL=tombstone-blocked-capture-mutation.d.ts.map

package/dist/storage/tombstone-blocked-capture-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstone-blocked-capture-mutation.d.ts","sourceRoot":"","sources":["../../src/storage/tombstone-blocked-capture-mutation.ts"],"names":[],"mappings":"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"}

package/dist/storage/tombstone-blocked-capture-sync.d.ts

@@ -0,0 +1,96 @@
+import type { MemoryFile, MemoryFrontmatter } from "../types.js";
+import type { CasRevisionTransaction } from "./cas-revision-store.js";
+import { TombstoneBlockedCaptureIndex } from "./tombstone-blocked-capture-index.js";
+import type { TombstoneBlockedCaptureIndexOptions } from "./tombstone-blocked-capture-index.js";
+type StreamedOfflineSyncIdentity = {
+    identityHash: string;
+};
+export type OfflineSyncMemoryParser = (filePath: string, content: Buffer) => MemoryFile | null;
+export declare function parseTombstoneBlockedOfflineSyncMemory(filePath: string, content: Buffer, memoryDir: string, parseFrontmatter: (raw: string) => {
+    frontmatter: MemoryFrontmatter;
+    content: string;
+} | null, normalizeFrontmatterForPath: (frontmatter: MemoryFrontmatter, pathRel: string, content?: string) => MemoryFrontmatter, toMemoryPathRel: (baseDir: string, filePath: string) => string): MemoryFile | null;
+export declare abstract class TombstoneBlockedCaptureIndexHost {
+    private tombstoneBlockedCaptureIndex;
+    protected abstract tombstoneBlockedCaptureIndexOptions(): TombstoneBlockedCaptureIndexOptions;
+    protected abstract writeStorageSecureFile(filePath: string, content: string | Buffer, forceEncrypt?: boolean): Promise<void>;
+    protected abstract assertManagedStoragePath(filePath: string, method: string): string;
+    protected abstract notifyCatalogWriteForPath(filePath: string): void;
+    protected abstract readMemoryByPath(filePath: string): Promise<MemoryFile | null>;
+    protected abstract invalidateAllMemoriesCache(): void;
+    protected abstract invalidateKnowledgeIndexCache(): void;
+    protected abstract invalidateColdMemoriesCache(): void;
+    protected abstract bumpArtifactWriteVersion(): number;
+    protected abstract bumpMemoryStatusVersion(): void;
+    protected abstract bumpMemoryCorpusVersion(): void;
+    protected abstract markFactHashIndexNotAuthoritative(): void;
+    /** #2837: durable unlink plus deletion-revision record, WITHOUT the CAS
+     * shard sweep — the concrete {@link deleteManagedStorageFile} composes the
+     * two so every deletion funnel (invalidation, maintenance purge, archive
+     * move, offline sync) sweeps. */
+    protected abstract deleteManagedStorageFileDurable(filePath: string, deletionMtimeMs?: number | null): Promise<boolean>;
+    protected abstract writeManagedStorageFile(filePath: string, write: () => Promise<void>): Promise<void>;
+    /** #2813 (P1 C, #2807): reserve the target's next durable CAS revision
+     * token as a two-phase receipt transaction — a PENDING write-ahead
+     * marker under the mutation's path lock, published COMMITTED only after
+     * the durable file write lands. Receipt identity lives in the per-target
+     * sidecar, never in public `frontmatter.updated`. The default host keeps
+     * no receipt identity; StorageManager records it. */
+    protected beginDurableMemoryRevision(_pathname: string, _expectedContent?: string | Buffer | null): Promise<CasRevisionTransaction | undefined>;
+    /** #2837 (shard cleanup): after a managed memory file is durably deleted,
+     * sweep its per-target CAS receipt shard so orphan shards cannot grow
+     * forever. The sweep runs under the shard's own lock and is best-effort —
+     * the memory file is already gone, so a sweep failure logs and never
+     * fails the delete. The sweeper is a second CasRevisionHost over the same
+     * memory dir; the host is stateless and every mutation serializes through
+     * the sidecar's file locks, so it shares the same shard files
+     * StorageManager's own host operates on. */
+    private deletedMemoryShardSweeper;
+    protected deleteManagedStorageFile(filePath: string, deletionMtimeMs?: number | null): Promise<boolean>;
+    private writeStorageSecureFileChunks;
+    protected getTombstoneBlockedCaptureIndex(): TombstoneBlockedCaptureIndex;
+    withTombstoneBlockedCaptureWriteLock<T>(task: () => Promise<T>, identity?: string | readonly string[]): Promise<T>;
+    /** Read selected memories while their mutation locks remain held. */
+    readMemorySnapshotsIfUnchanged(expected: readonly MemoryFile[]): Promise<MemoryFile[] | null>;
+    withMemorySnapshotsIfUnchanged<T>(expected: readonly MemoryFile[], task: (memories: MemoryFile[]) => Promise<T>): Promise<T | null>;
+    protected withTombstoneBlockedCaptureWriteLockAndHashes<T>(task: () => Promise<T>, identity: string | readonly string[] | undefined, identityHashes: readonly string[]): Promise<T>;
+    private writeTombstoneBlockedMutation;
+    protected writeTombstoneBlockedMemory(pathname: string, fileContent: string, frontmatter: MemoryFrontmatter, content: string, beforeIndexUpdate?: () => Promise<void>): Promise<void>;
+    protected withTombstoneBlockedMemoryPathLock<T>(pathname: string, task: (current: MemoryFile | null) => Promise<T>, additionalPathnames?: readonly string[]): Promise<T>;
+    protected writeTombstoneBlockedChunk(pathname: string, fileContent: string, frontmatter: MemoryFrontmatter, content: string, findDuplicate: () => Promise<MemoryFile | null>, afterWrite: (current: MemoryFile | null) => Promise<void>): Promise<string>;
+    protected writeTombstoneBlockedUpdate(before: MemoryFile, fileContent: string, frontmatter: MemoryFrontmatter, content: string, beforeIndexUpdate?: () => Promise<void>): Promise<string | undefined>;
+    protected writeTombstoneBlockedFrontmatter(before: MemoryFile, fileContent: string, frontmatter: MemoryFrontmatter, beforeIndexUpdate?: () => Promise<void>): Promise<string | undefined>;
+    private isTombstoneBlockedMemory;
+    private offlineSyncMemoryIdentity;
+    private isDuplicateTombstoneBlockedOfflineSync;
+    private invalidateAfterOfflineSyncMutation;
+    protected runTombstoneBlockedArchive(memory: MemoryFile, task: (current: MemoryFile, markDurable: () => void) => Promise<string | null>): Promise<string | null>;
+    protected runTombstoneBlockedInvalidation(memory: MemoryFile, task: (current: MemoryFile, rebuildMarker: string | undefined, markDurable: () => void) => Promise<boolean>, propagateErrors?: boolean, coordinate?: boolean): Promise<boolean>;
+    deleteMemoryForMaintenance(memory: MemoryFile, shouldDelete?: (current: MemoryFile) => boolean): Promise<MemoryFile | null>;
+    protected runTombstoneBlockedOfflineSyncMutation(target: string, after: MemoryFile | null, write: () => Promise<boolean | void>, coordinate?: boolean, streamedIdentity?: StreamedOfflineSyncIdentity): Promise<void>;
+    protected writeTombstoneBlockedOfflineSyncFile(target: string, content: Buffer): Promise<void>;
+    private prepareTombstoneBlockedOfflineSyncChunks;
+    private describeStagedOfflineSyncChunks;
+    private computeStagedOfflineSyncIdentity;
+    private readStagedOfflineSyncChunks;
+    protected writeTombstoneBlockedOfflineSyncFileChunks(target: string, chunks: AsyncIterable<Buffer>): Promise<void>;
+    writeOfflineSyncFile(filePath: string, content: Buffer): Promise<void>;
+    writeOfflineSyncFileChunks(filePath: string, chunks: AsyncIterable<Buffer>): Promise<void>;
+    /**
+     * Opaque replicated bytes can restore legacy memory references or entity
+     * relationship targets. Other sync traffic must not request reconciliation.
+     */
+    private requestSyncReconcileIfMigrationPath;
+    deleteOfflineSyncFile(filePath: string, deletionMtimeMs?: number | null): Promise<void>;
+    protected deleteTombstoneBlockedOfflineSyncFile(target: string, deletionMtimeMs?: number | null): Promise<void>;
+    checkTombstoneBlockedExplicitCapture(...args: [string, string, string?]): Promise<{
+        has: boolean;
+        authoritative: boolean;
+    }>;
+    hasTombstoneBlockedExplicitCapture(...args: [string, string, string?]): Promise<boolean>;
+    isTombstoneBlockedExplicitCaptureIndexAuthoritative(): Promise<boolean>;
+    protected rebuildTombstoneBlockedCaptureAfterInvalidationForPath(filePath: string, ownedMarker?: string): Promise<void>;
+    protected rebuildTombstoneBlockedCaptureAfterInvalidation(ownedMarker?: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=tombstone-blocked-capture-sync.d.ts.map

package/dist/storage/tombstone-blocked-capture-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstone-blocked-capture-sync.d.ts","sourceRoot":"","sources":["../../src/storage/tombstone-blocked-capture-sync.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAUtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAShG,KAAK,2BAA2B,GAAG;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AA2IF,MAAM,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAC;AAE/F,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;IAAE,WAAW,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC7F,2BAA2B,EAAE,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,iBAAiB,EACrH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAC7D,UAAU,GAAG,IAAI,CAQnB;AAED,8BAAsB,gCAAgC;IACpD,OAAO,CAAC,4BAA4B,CAA6C;IACjF,SAAS,CAAC,QAAQ,CAAC,mCAAmC,IAAI,mCAAmC;IAC7F,SAAS,CAAC,QAAQ,CAAC,sBAAsB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,IAAI,CAAC;IAChB,SAAS,CAAC,QAAQ,CAAC,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IACrF,SAAS,CAAC,QAAQ,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IACpE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IACjF,SAAS,CAAC,QAAQ,CAAC,0BAA0B,IAAI,IAAI;IACrD,SAAS,CAAC,QAAQ,CAAC,6BAA6B,IAAI,IAAI;IACxD,SAAS,CAAC,QAAQ,CAAC,2BAA2B,IAAI,IAAI;IACtD,SAAS,CAAC,QAAQ,CAAC,wBAAwB,IAAI,MAAM;IACrD,SAAS,CAAC,QAAQ,CAAC,uBAAuB,IAAI,IAAI;IAClD,SAAS,CAAC,QAAQ,CAAC,uBAAuB,IAAI,IAAI;IAClD,SAAS,CAAC,QAAQ,CAAC,iCAAiC,IAAI,IAAI;IAC5D;;;qCAGiC;IACjC,SAAS,CAAC,QAAQ,CAAC,+BAA+B,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IACvH,SAAS,CAAC,QAAQ,CAAC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEvG;;;;;yDAKqD;cACrC,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAIrJ;;;;;;;gDAO4C;IAC5C,OAAO,CAAC,yBAAyB,CAAgC;cAEjD,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAU/F,4BAA4B;IAY1C,SAAS,CAAC,+BAA+B,IAAI,4BAA4B;IAMnE,oCAAoC,CAAC,CAAC,EAC1C,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GACpC,OAAO,CAAC,CAAC,CAAC;IAIb,qEAAqE;IAC/D,8BAA8B,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAI7F,8BAA8B,CAAC,CAAC,EACpC,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;cAsBJ,6CAA6C,CAAC,CAAC,EAC7D,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,EAChD,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAAC,CAAC,CAAC;YAIC,6BAA6B;cAqC3B,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;cAeA,kCAAkC,CAAC,CAAC,EAClD,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAChD,mBAAmB,GAAE,SAAS,MAAM,EAAO,GAC1C,OAAO,CAAC,CAAC,CAAC;cAwBG,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,EAC/C,UAAU,EAAE,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GACxD,OAAO,CAAC,MAAM,CAAC;cA8BF,2BAA2B,CACzC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;cAuBd,gCAAgC,CAC9C,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,iBAAiB,EAC9B,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAmB9B,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,yBAAyB;YAOnB,sCAAsC;YAgCtC,kCAAkC;cAoChC,0BAA0B,CACxC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC7E,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;cAwBT,+BAA+B,CAC7C,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,EAC3G,eAAe,UAAQ,EACvB,UAAU,UAAQ,GACjB,OAAO,CAAC,OAAO,CAAC;IAyDb,0BAA0B,CAC9B,MAAM,EAAE,UAAU,EAClB,YAAY,GAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAoB,GAC1D,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;cA2Bb,sCAAsC,CACpD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAAG,IAAI,EACxB,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EACpC,UAAU,UAAQ,EAClB,gBAAgB,CAAC,EAAE,2BAA2B,GAC7C,OAAO,CAAC,IAAI,CAAC;cAyEA,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAUtF,wCAAwC;YAkExC,+BAA+B;YA8B/B,gCAAgC;YA6D/B,2BAA2B;cAW1B,0CAA0C,CACxD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAsBV,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhG;;;OAGG;YACW,mCAAmC;IAM3C,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;cAM7E,qCAAqC,CACnD,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAC9B,OAAO,CAAC,IAAI,CAAC;IASV,oCAAoC,CACxC,GAAG,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GACjC,OAAO,CAAC;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAI9C,kCAAkC,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxF,mDAAmD,IAAI,OAAO,CAAC,OAAO,CAAC;cAI7D,sDAAsD,CACpE,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;cAMA,+CAA+C,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrG"}

package/dist/storage/tombstone-migration-sources.d.ts

@@ -0,0 +1,24 @@
+import type { TombstoneStoreOptions } from "../lifecycle/tombstones.js";
+import type { MemoryFile } from "../types.js";
+/**
+ * Deps injected by `StorageManager.buildTombstoneStore` so this module owns no
+ * storage-god-file imports (issue #1533 ratchet).
+ */
+export interface TombstoneMigrationSourceDeps {
+    /** On-disk tombstone ledger path; its mtime scopes both caches below. */
+    tombstonesPath: () => string;
+    collectTombstoneMigrationPaths: () => Promise<string[]>;
+    readParsedMemoriesFromPaths: (filePaths: string[], batchSize?: number) => Promise<MemoryFile[]>;
+    storedContentIdentityCandidates: (content: string) => string[];
+}
+/**
+ * Build the `sourceContentsForMemoryIds` callback `TombstoneStore` uses to
+ * verify pre-Unicode rows against their retired source memories. The corpus
+ * path snapshot and the resolved source-content map are memoized for one
+ * ledger revision only (issue #2367): a peer process can create and retire a
+ * legacy-format memory after this snapshot, and the staleness reload must
+ * resolve the new row against a FRESH path list — otherwise the row stays
+ * unverified (withheld from the lookup tiers) until restart.
+ */
+export declare function createTombstoneMigrationSourceContents(deps: TombstoneMigrationSourceDeps): NonNullable<TombstoneStoreOptions["sourceContentsForMemoryIds"]>;
+//# sourceMappingURL=tombstone-migration-sources.d.ts.map

package/dist/storage/tombstone-migration-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstone-migration-sources.d.ts","sourceRoot":"","sources":["../../src/storage/tombstone-migration-sources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yEAAyE;IACzE,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,8BAA8B,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,2BAA2B,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAChG,+BAA+B,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CAChE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,4BAA4B,GACjC,WAAW,CAAC,qBAAqB,CAAC,4BAA4B,CAAC,CAAC,CA6DlE"}

package/dist/storage/windowed-memory-read.d.ts

@@ -0,0 +1,28 @@
+import type { MemoryFile } from "../types.js";
+import type { MemoryReadStore } from "./memory-read-store.js";
+export interface WindowedMemoryReadOptions {
+    maxMemories?: number;
+    batchSize?: number;
+    updatedAfter?: Date;
+    /** Require candidate paths so malformed files can be reported by governance. */
+    includeMalformedPaths?: boolean;
+}
+export interface WindowedMemoryReadResult {
+    memories: MemoryFile[];
+    filePaths: string[];
+}
+type WindowedMemoryReadStore = Pick<MemoryReadStore, "readMemoriesWindow">;
+type HotMemoryCache = {
+    enabled: boolean;
+    baseDir: string;
+    corpusVersion: number;
+    cacheKeyId: string;
+    ttlMs?: number;
+};
+/**
+ * Serve the briefing-only updatedAfter shape from the warm corpus cache, then
+ * delegate all other window reads to MemoryReadStore.
+ */
+export declare function readWindowedMemories(store: WindowedMemoryReadStore, options: WindowedMemoryReadOptions, hotCache: HotMemoryCache, rememberMemorySnapshots: (memories: MemoryFile[]) => MemoryFile[]): Promise<WindowedMemoryReadResult>;
+export {};
+//# sourceMappingURL=windowed-memory-read.d.ts.map

package/dist/storage/windowed-memory-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowed-memory-read.d.ts","sourceRoot":"","sources":["../../src/storage/windowed-memory-read.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,gFAAgF;IAChF,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,KAAK,uBAAuB,GAAG,IAAI,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;AAE3E,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,yBAAyB,EAClC,QAAQ,EAAE,cAAc,EACxB,uBAAuB,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,GAChE,OAAO,CAAC,wBAAwB,CAAC,CAkCnC"}

package/dist/storage-contract/harness.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Issue #1533 — Storage contract test harness.
+ *
+ * Shared fixture helpers for the storage public-surface contract suite AND
+ * the #1522 catalog-touch fitness test (both live under `storage-contract/`
+ * per the issue's coordination note: "build both on ONE shared harness so the
+ * write-entry-point enumeration lives in exactly one place").
+ *
+ * Every helper creates a fresh temp directory and returns a `cleanup` that
+ * tears it down — tests never share state. `StorageManager.clearAllStaticCaches()`
+ * is called on setup and teardown so the module-level caches (readAllMemories
+ * in-flight, version sentinels, secure-store entity cache) do not leak between
+ * tests.
+ */
+import { StorageManager } from "../storage.js";
+import { NamespaceStorageRouter } from "../namespaces/storage.js";
+import type { PluginConfig } from "../types.js";
+/** Clear every module-level cache so tests start from a known-empty state. */
+export declare function resetStaticCaches(): void;
+/**
+ * Create a StorageManager backed by a fresh temp directory.
+ *
+ * Returns the manager, the on-disk base directory, and a `cleanup` that removes
+ * the directory and clears static caches. Callers MUST call `cleanup` in a
+ * `try/finally` (or via `node:test`'s `t.after`).
+ */
+export declare function makeStorage(prefix?: string): Promise<{
+    storage: StorageManager;
+    baseDir: string;
+    cleanup: () => Promise<void>;
+}>;
+/**
+ * Build a minimal valid memory markdown body for raw seeding (bypasses
+ * writeMemory so the test controls exact on-disk bytes).
+ */
+export declare function rawMemoryMarkdown(id: string, category: string, content: string, extra?: Record<string, string>): string;
+/**
+ * Seed a raw markdown file at a path relative to `baseDir`. Used when a test
+ * needs to control exact placement (e.g. a specific category dir + date nest)
+ * without going through `writeMemory`.
+ */
+export declare function seedRawFile(baseDir: string, relPath: string, content: string): Promise<string>;
+/**
+ * Minimal PluginConfig for NamespaceStorageRouter tests. Only the fields the
+ * router reads are populated; the rest default to values that keep the router
+ * in the namespaces-enabled mode the tests exercise.
+ */
+export declare function makeNamespaceConfig(memoryDir: string, overrides?: Record<string, unknown>): PluginConfig;
+/**
+ * Create a NamespaceStorageRouter over a fresh temp dir with namespaces
+ * enabled. Returns the router, the memory dir, and a cleanup.
+ */
+export declare function makeNamespaceRouter(overrides?: Partial<PluginConfig>): Promise<{
+    router: NamespaceStorageRouter;
+    memoryDir: string;
+    config: PluginConfig;
+    cleanup: () => Promise<void>;
+}>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/storage-contract/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/storage-contract/harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,MAAM,SAA6B,GAClC,OAAO,CAAC;IACT,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC,CAcD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,MAAM,CAiBR;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACtC,YAAY,CASd;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACpC,OAAO,CAAC;IACT,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC,CAcD"}

package/dist/storage-guards.d.ts

@@ -1,20 +1,19 @@
-declare const PROJECTION_LEDGER_LAG_WARN_THRESHOLD_EVENTS = 100;
-declare function assertMemoryFrontmatterId(fm: {
+export declare const PROJECTION_LEDGER_LAG_WARN_THRESHOLD_EVENTS = 100;
+export declare function assertMemoryFrontmatterId(fm: {
     id: string;
     category?: string;
     created?: string;
     entityRef?: string;
 }): void;
-interface ProjectionLedgerLagTelemetry {
+export interface ProjectionLedgerLagTelemetry {
     projectedEvents: number;
     currentLedgerEvents: number;
     deltaEvents: number;
     warnThresholdEvents?: number;
 }
-declare function warnProjectionFallback(memoryDir: string, consumer: string, detail?: () => string | undefined, ledgerLag?: ProjectionLedgerLagTelemetry): null;
+export declare function warnProjectionFallback(memoryDir: string, consumer: string, detail?: () => string | undefined, ledgerLag?: ProjectionLedgerLagTelemetry): null;
 /** @internal Test seam (#2119): clear the fallback-warn rate-limit dedup map so
  *  a focused test can prove the once-per-interval spam suppression from a clean
  *  slate regardless of prior tests in the same process. */
-declare function __resetProjectionFallbackWarnSuppressionForTest(): void;
-
-export { PROJECTION_LEDGER_LAG_WARN_THRESHOLD_EVENTS, type ProjectionLedgerLagTelemetry, __resetProjectionFallbackWarnSuppressionForTest, assertMemoryFrontmatterId, warnProjectionFallback };
+export declare function __resetProjectionFallbackWarnSuppressionForTest(): void;
+//# sourceMappingURL=storage-guards.d.ts.map

package/dist/storage-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-guards.d.ts","sourceRoot":"","sources":["../src/storage-guards.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,2CAA2C,MAAM,CAAC;AAG/D,wBAAgB,yBAAyB,CACvC,EAAE,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E,IAAI,CAWN;AAED,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,EACjC,SAAS,CAAC,EAAE,4BAA4B,GACvC,IAAI,CA2BN;AAED;;2DAE2D;AAC3D,wBAAgB,+CAA+C,IAAI,IAAI,CAEtE"}

package/dist/storage-paths.d.ts

@@ -1,9 +1,8 @@
-declare function encodeStoragePathSegment(value: string, fallback?: string): string;
-declare function storagePathHash(value: string): string;
-declare function encodeStoragePathSegmentWithHash(value: string, fallback?: string): string;
-declare function isSafeLegacyPathSegment(value: string): boolean;
-declare function isPathInsideStorageRoot(rootAbs: string, targetAbs: string): boolean;
-declare function resolvePathInsideStorageRoot(root: string, ...parts: string[]): string;
-declare function resolveSafeStoragePath(root: string, ...parts: string[]): Promise<string>;
-
-export { encodeStoragePathSegment, encodeStoragePathSegmentWithHash, isPathInsideStorageRoot, isSafeLegacyPathSegment, resolvePathInsideStorageRoot, resolveSafeStoragePath, storagePathHash };
+export declare function encodeStoragePathSegment(value: string, fallback?: string): string;
+export declare function storagePathHash(value: string): string;
+export declare function encodeStoragePathSegmentWithHash(value: string, fallback?: string): string;
+export declare function isSafeLegacyPathSegment(value: string): boolean;
+export declare function isPathInsideStorageRoot(rootAbs: string, targetAbs: string): boolean;
+export declare function resolvePathInsideStorageRoot(root: string, ...parts: string[]): string;
+export declare function resolveSafeStoragePath(root: string, ...parts: string[]): Promise<string>;
+//# sourceMappingURL=storage-paths.d.ts.map

package/dist/storage-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-paths.d.ts","sourceRoot":"","sources":["../src/storage-paths.ts"],"names":[],"mappings":"AAIA,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,CAOpF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,CAG5F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAQ9D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOnF;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,GAAG,KAAK,EAAE,MAAM,EAAE,GACjB,MAAM,CAOR;AAwDD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,GAAG,KAAK,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,MAAM,CAAC,CAMjB"}