openplanr 1.25.2 → 2.0.0

package/dist/services/operate/measurement-schedule-service.js

@@ -0,0 +1,461 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { chmod, lstat, mkdir, open, readdir, readFile, rename, stat, unlink, } from 'node:fs/promises';
+import path from 'node:path';
+import { sha256CanonicalJson } from '../canonical-json.js';
+import { assertOperatePathCustody, assertOperateTreeCustody } from './path-custody.js';
+import { withOperateMutationLane } from './replay-safe-retry-service.js';
+export class MeasurementScheduleError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.code = code;
+        this.name = 'MeasurementScheduleError';
+    }
+}
+const SCHEDULE_ID = /^msch_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$/u;
+const HASH = /^sha256:[a-f0-9]{64}$/u;
+const CUSTODY_FILE = /^[a-f0-9]{64}\.schedule\.json$/u;
+const MAX_CUSTODY_FILES = 2_048;
+const MAX_CUSTODY_BYTES = 32 * 1024 * 1024;
+function fail(code, message, cause) {
+    throw new MeasurementScheduleError(code, message, cause);
+}
+function isMissing(cause) {
+    return cause?.code === 'ENOENT';
+}
+async function optionalStat(target) {
+    try {
+        return await stat(target);
+    }
+    catch (cause) {
+        if (isMissing(cause))
+            return null;
+        fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody metadata failed.', cause);
+    }
+}
+async function readLock(target) {
+    let value;
+    try {
+        value = JSON.parse(await readFile(target, 'utf8'));
+    }
+    catch (cause) {
+        if (isMissing(cause))
+            return null;
+        fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody lock is invalid.', cause);
+    }
+    if (!value ||
+        typeof value !== 'object' ||
+        Array.isArray(value) ||
+        typeof value.nonce !== 'string' ||
+        typeof value.expiresAt !== 'number') {
+        fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody lock is invalid.');
+    }
+    return value;
+}
+async function unlinkIfPresent(target) {
+    try {
+        await unlink(target);
+    }
+    catch (cause) {
+        if (isMissing(cause))
+            return;
+        fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody cleanup failed.', cause);
+    }
+}
+async function renameIfPresent(source, target) {
+    try {
+        await rename(source, target);
+        return true;
+    }
+    catch (cause) {
+        if (isMissing(cause))
+            return false;
+        fail('E_MEASUREMENT_SCHEDULE_LOCKED', 'Measurement custody lock recovery failed.', cause);
+    }
+}
+function exactKeys(value, expected) {
+    return JSON.stringify(Object.keys(value).sort()) === JSON.stringify([...expected].sort());
+}
+function record(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody is not one object.');
+    }
+    return value;
+}
+function schedule(value) {
+    return value;
+}
+function receipt(value) {
+    return value;
+}
+function custodyBody(schedules, receipts) {
+    return {
+        format: 'openplanr-measurement-schedule-custody',
+        version: 1,
+        schedules,
+        receipts,
+    };
+}
+function snapshot(custody) {
+    return Object.freeze({
+        schedule: structuredClone(custody.schedules.at(-1)),
+        receipt: custody.receipts.length === 0
+            ? null
+            : structuredClone(custody.receipts.at(-1)),
+    });
+}
+export class ProjectMeasurementScheduleStore {
+    #projectDir;
+    #root;
+    #contracts;
+    #now;
+    #lockTtlMs;
+    constructor(input) {
+        this.#projectDir = path.resolve(input.projectDir);
+        this.#root = path.join(this.#projectDir, '.planr', 'operate', 'measurement-schedules');
+        this.#contracts = input.contracts;
+        this.#now = input.now ?? Date.now;
+        this.#lockTtlMs = input.lockTtlMs ?? 30_000;
+        if (!Number.isSafeInteger(this.#lockTtlMs) ||
+            this.#lockTtlMs < 1_000 ||
+            this.#lockTtlMs > 300_000) {
+            fail('E_MEASUREMENT_SCHEDULE_INVALID', 'Measurement lock policy is invalid.');
+        }
+    }
+    async #ensureRoot() {
+        const options = {
+            code: 'E_MEASUREMENT_SCHEDULE_CUSTODY_UNSAFE',
+            message: 'Measurement custody cannot leave project-local Operate storage.',
+        };
+        await assertOperatePathCustody(this.#projectDir, this.#root, options);
+        await mkdir(this.#root, { recursive: true, mode: 0o700 });
+        await assertOperatePathCustody(this.#projectDir, this.#root, {
+            ...options,
+            requireDirectory: true,
+        });
+        await assertOperateTreeCustody(this.#projectDir, this.#root, options);
+        await chmod(this.#root, 0o700);
+    }
+    #paths(scheduleId) {
+        if (!SCHEDULE_ID.test(scheduleId)) {
+            fail('E_MEASUREMENT_SCHEDULE_INVALID', 'Measurement schedule identity is invalid.');
+        }
+        const id = createHash('sha256').update(scheduleId, 'utf8').digest('hex');
+        return {
+            data: path.join(this.#root, `${id}.schedule.json`),
+            lock: path.join(this.#root, `${id}.lock`),
+        };
+    }
+    async #withLock(scheduleId, work) {
+        await this.#ensureRoot();
+        const paths = this.#paths(scheduleId);
+        const nonce = randomBytes(32).toString('hex');
+        let handle;
+        return withOperateMutationLane(`${this.#root}:${scheduleId}`, async () => {
+            try {
+                try {
+                    handle = await open(paths.lock, 'wx', 0o600);
+                }
+                catch (cause) {
+                    if (cause.code !== 'EEXIST') {
+                        fail('E_MEASUREMENT_SCHEDULE_LOCKED', 'Measurement custody lock failed.', cause);
+                    }
+                    const metadata = await optionalStat(paths.lock);
+                    const observed = await readLock(paths.lock);
+                    if (metadata &&
+                        observed &&
+                        typeof observed.nonce === 'string' &&
+                        typeof observed.expiresAt === 'number' &&
+                        observed.expiresAt <= this.#now()) {
+                        const stale = `${paths.lock}.stale-${randomBytes(8).toString('hex')}`;
+                        const moved = await renameIfPresent(paths.lock, stale);
+                        if (moved) {
+                            const staleMetadata = await optionalStat(stale);
+                            if (!staleMetadata ||
+                                staleMetadata.dev !== metadata.dev ||
+                                staleMetadata.ino !== metadata.ino) {
+                                await rename(stale, paths.lock);
+                                fail('E_MEASUREMENT_SCHEDULE_LOCKED', 'Measurement custody changed during lock recovery.');
+                            }
+                            await unlinkIfPresent(stale);
+                        }
+                        try {
+                            handle = await open(paths.lock, 'wx', 0o600);
+                        }
+                        catch (cause) {
+                            if (cause.code !== 'EEXIST') {
+                                fail('E_MEASUREMENT_SCHEDULE_LOCKED', 'Measurement custody lock failed.', cause);
+                            }
+                        }
+                    }
+                    if (!handle) {
+                        fail('E_MEASUREMENT_SCHEDULE_LOCKED', 'Measurement custody is already in use.');
+                    }
+                }
+                await handle.writeFile(JSON.stringify({ nonce, expiresAt: this.#now() + this.#lockTtlMs }), 'utf8');
+                await handle.sync();
+                return await work(paths.data);
+            }
+            finally {
+                await handle?.close();
+                if (handle) {
+                    const current = await readLock(paths.lock);
+                    if (current?.nonce !== nonce) {
+                        fail('E_MEASUREMENT_SCHEDULE_LOCKED', 'Measurement custody lease was superseded.');
+                    }
+                    await unlinkIfPresent(paths.lock);
+                }
+            }
+        });
+    }
+    async #readPath(dataPath) {
+        let metadata;
+        try {
+            metadata = await lstat(dataPath);
+        }
+        catch (cause) {
+            if (cause.code === 'ENOENT')
+                return null;
+            fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody is unreadable.', cause);
+        }
+        if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size > MAX_CUSTODY_BYTES) {
+            fail('E_MEASUREMENT_SCHEDULE_CUSTODY_UNSAFE', 'Measurement custody file is unsafe.');
+        }
+        let parsed;
+        try {
+            parsed = record(JSON.parse(await readFile(dataPath, 'utf8')));
+        }
+        catch (cause) {
+            if (cause instanceof MeasurementScheduleError)
+                throw cause;
+            fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody bytes are invalid.', cause);
+        }
+        if (!exactKeys(parsed, ['format', 'version', 'schedules', 'receipts', 'recordHash']) ||
+            parsed.format !== 'openplanr-measurement-schedule-custody' ||
+            parsed.version !== 1 ||
+            !Array.isArray(parsed.schedules) ||
+            parsed.schedules.length < 1 ||
+            parsed.schedules.length > 10_001 ||
+            !Array.isArray(parsed.receipts) ||
+            parsed.receipts.length !== parsed.schedules.length - 1 ||
+            !HASH.test(String(parsed.recordHash))) {
+            fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody envelope is invalid.');
+        }
+        const schedules = parsed.schedules.map((value) => schedule(this.#contracts.validateSchedule(value)));
+        const scheduleId = schedules[0].scheduleId;
+        const receipts = parsed.receipts.map((value, index) => receipt(this.#contracts.validateReceipt(value, schedules[index], schedules[index + 1])));
+        if (schedules.some((value, index) => value.scheduleId !== scheduleId || value.generation !== index)) {
+            fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody history is invalid.');
+        }
+        const body = custodyBody(schedules, receipts);
+        if (parsed.recordHash !== sha256CanonicalJson(body)) {
+            fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement custody digest changed.');
+        }
+        return Object.freeze({ ...body, recordHash: parsed.recordHash });
+    }
+    async #writePath(dataPath, body) {
+        const value = {
+            ...body,
+            recordHash: sha256CanonicalJson(body),
+        };
+        const temporary = `${dataPath}.${randomBytes(8).toString('hex')}.tmp`;
+        let handle;
+        try {
+            handle = await open(temporary, 'wx', 0o600);
+            await handle.writeFile(`${JSON.stringify(value)}\n`, 'utf8');
+            await handle.sync();
+            await handle.close();
+            handle = undefined;
+            await rename(temporary, dataPath);
+            await chmod(dataPath, 0o600);
+        }
+        finally {
+            await handle?.close();
+            await unlinkIfPresent(temporary);
+        }
+    }
+    async read(scheduleId) {
+        return this.#withLock(scheduleId, async (dataPath) => {
+            const current = await this.#readPath(dataPath);
+            if (current && current.schedules[0].scheduleId !== scheduleId) {
+                fail('E_MEASUREMENT_SCHEDULE_CONFLICT', 'Measurement custody identity changed.');
+            }
+            return current ? snapshot(current) : null;
+        });
+    }
+    async list() {
+        await this.#ensureRoot();
+        const entries = await readdir(this.#root, { withFileTypes: true });
+        const files = entries.filter((entry) => CUSTODY_FILE.test(entry.name));
+        if (files.length > MAX_CUSTODY_FILES) {
+            fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement inventory is too large.');
+        }
+        const identities = [];
+        for (const entry of files.sort((left, right) => left.name.localeCompare(right.name))) {
+            if (!entry.isFile() || entry.isSymbolicLink()) {
+                fail('E_MEASUREMENT_SCHEDULE_CUSTODY_UNSAFE', 'Measurement inventory is unsafe.');
+            }
+            const current = await this.#readPath(path.join(this.#root, entry.name));
+            if (!current) {
+                fail('E_MEASUREMENT_SCHEDULE_CUSTODY_INVALID', 'Measurement inventory changed.');
+            }
+            identities.push(current.schedules[0].scheduleId);
+        }
+        return Object.freeze(identities.sort());
+    }
+    async mutate(scheduleId, mutation) {
+        return this.#withLock(scheduleId, async (dataPath) => {
+            const current = await this.#readPath(dataPath);
+            if (current && current.schedules[0].scheduleId !== scheduleId) {
+                fail('E_MEASUREMENT_SCHEDULE_CONFLICT', 'Measurement custody identity changed.');
+            }
+            const previous = current ? snapshot(current) : null;
+            const updated = await mutation(previous);
+            const nextSchedule = schedule(this.#contracts.validateSchedule(updated.stored.schedule));
+            if (nextSchedule.scheduleId !== scheduleId) {
+                fail('E_MEASUREMENT_SCHEDULE_CONFLICT', 'Measurement mutation changed its identity.');
+            }
+            if (!current) {
+                if (updated.initial) {
+                    const initial = schedule(this.#contracts.validateSchedule(updated.initial));
+                    if (initial.scheduleId !== scheduleId ||
+                        initial.generation !== 0 ||
+                        initial.state !== 'disabled' ||
+                        !updated.stored.receipt ||
+                        nextSchedule.generation !== 1) {
+                        fail('E_MEASUREMENT_SCHEDULE_CONFLICT', 'Measurement initialization is invalid.');
+                    }
+                    const nextReceipt = receipt(this.#contracts.validateReceipt(updated.stored.receipt, initial, nextSchedule));
+                    await this.#writePath(dataPath, custodyBody([initial, nextSchedule], [nextReceipt]));
+                    return updated.result;
+                }
+                if (updated.stored.receipt !== null || nextSchedule.generation !== 0) {
+                    fail('E_MEASUREMENT_SCHEDULE_CONFLICT', 'New measurement custody is not disabled.');
+                }
+                await this.#writePath(dataPath, custodyBody([nextSchedule], []));
+                return updated.result;
+            }
+            if (sha256CanonicalJson(previous) === sha256CanonicalJson(updated.stored)) {
+                return updated.result;
+            }
+            const prior = snapshot(current);
+            if (!updated.stored.receipt || nextSchedule.generation !== prior.schedule.generation + 1) {
+                fail('E_MEASUREMENT_SCHEDULE_CONFLICT', 'Measurement transition is not contiguous.');
+            }
+            const nextReceipt = receipt(this.#contracts.validateReceipt(updated.stored.receipt, prior.schedule, nextSchedule));
+            await this.#writePath(dataPath, custodyBody([...current.schedules, nextSchedule], [...current.receipts, nextReceipt]));
+            return updated.result;
+        });
+    }
+}
+export function measurementScheduleContracts(composition) {
+    return Object.freeze({
+        validateSchedule: (value) => composition.validateMeasurementSchedule(value),
+        validateReceipt: (value, previous, resulting) => composition.validateMeasurementScheduleReceipt(value, previous, resulting),
+        reduceSchedule: (current, transition, priorReceipt) => composition.reduceMeasurementSchedule(current, transition, priorReceipt),
+    });
+}
+export function createMeasurementScheduleService(dependencies) {
+    const { store, contracts } = dependencies;
+    const validated = (value) => schedule(contracts.validateSchedule(value));
+    async function load(scheduleId) {
+        const stored = await store.read(scheduleId);
+        if (!stored) {
+            throw new MeasurementScheduleError('E_MEASUREMENT_SCHEDULE_UNKNOWN', `No measurement schedule is stored for ${scheduleId}.`);
+        }
+        return stored;
+    }
+    async function transition(scheduleId, value, requiredType) {
+        if (requiredType && value.type !== requiredType) {
+            fail('E_MEASUREMENT_SCHEDULE_INVALID', `Measurement transition must be ${requiredType}.`);
+        }
+        return store.mutate(scheduleId, (current) => {
+            if (!current) {
+                fail('E_MEASUREMENT_SCHEDULE_UNKNOWN', `No measurement schedule is stored for ${scheduleId}.`);
+            }
+            const outcome = contracts.reduceSchedule(current.schedule, value, current.receipt ?? undefined);
+            return {
+                stored: { schedule: outcome.schedule, receipt: outcome.receipt },
+                result: outcome,
+            };
+        });
+    }
+    return {
+        preview(value) {
+            return validated(value);
+        },
+        async register(value) {
+            const candidate = validated(value);
+            return store.mutate(candidate.scheduleId, (current) => {
+                if (current) {
+                    if (current.schedule.scheduleHash === candidate.scheduleHash)
+                        return {
+                            stored: current,
+                            result: current.schedule,
+                        };
+                    fail('E_MEASUREMENT_SCHEDULE_EXISTS', `Measurement schedule ${candidate.scheduleId} is already stored.`);
+                }
+                return { stored: { schedule: candidate, receipt: null }, result: candidate };
+            });
+        },
+        async enable(value, transitionValue) {
+            const candidate = validated(value);
+            if (candidate.generation !== 0 || candidate.state !== 'disabled') {
+                fail('E_MEASUREMENT_SCHEDULE_INVALID', 'Measurement enable requires a disabled schedule.');
+            }
+            if (transitionValue.type !== 'enable' ||
+                transitionValue.expectedScheduleHash !== candidate.scheduleHash) {
+                fail('E_MEASUREMENT_SCHEDULE_CONFLICT', 'Measurement enable changed its previewed schedule.');
+            }
+            return store.mutate(candidate.scheduleId, (current) => {
+                const base = current ?? { schedule: candidate, receipt: null };
+                const outcome = contracts.reduceSchedule(base.schedule, transitionValue, base.receipt ?? undefined);
+                return {
+                    stored: { schedule: outcome.schedule, receipt: outcome.receipt },
+                    result: outcome,
+                    ...(current ? {} : { initial: candidate }),
+                };
+            });
+        },
+        async disable(scheduleId, transitionValue) {
+            return transition(scheduleId, transitionValue, 'disable');
+        },
+        async apply(scheduleId, transitionValue) {
+            return transition(scheduleId, transitionValue);
+        },
+        async read(scheduleId) {
+            return load(scheduleId);
+        },
+        async due(atIso, ownerActorId) {
+            const at = Date.parse(atIso);
+            if (!Number.isFinite(at)) {
+                throw new MeasurementScheduleError('E_MEASUREMENT_SCHEDULE_CLOCK_INVALID', 'Due evaluation requires one exact ISO timestamp.');
+            }
+            const found = [];
+            for (const scheduleId of await store.list()) {
+                const current = await store.read(scheduleId);
+                if (!current || (ownerActorId && current.schedule.ownerActorId !== ownerActorId))
+                    continue;
+                const { state, nextDueAt, nextEventIdentity } = current.schedule;
+                if (state !== 'enabled' || nextDueAt === null || nextEventIdentity === null)
+                    continue;
+                if (Date.parse(nextDueAt) <= at)
+                    found.push(current);
+            }
+            return Object.freeze(found.sort((left, right) => left.schedule.scheduleId.localeCompare(right.schedule.scheduleId)));
+        },
+    };
+}
+export function createProjectMeasurementScheduleService(projectDir, composition, options = {}) {
+    const contracts = measurementScheduleContracts(composition);
+    return createMeasurementScheduleService({
+        contracts,
+        store: new ProjectMeasurementScheduleStore({
+            projectDir,
+            contracts,
+            now: options.now,
+            lockTtlMs: options.lockTtlMs,
+        }),
+    });
+}
+//# sourceMappingURL=measurement-schedule-service.js.map

package/dist/services/operate/measurement-schedule-service.js.map

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

package/dist/services/operate/path-custody.d.ts

@@ -0,0 +1,16 @@
+type CustodyOptions = Readonly<{
+    code: string;
+    message: string;
+    requireDirectory?: boolean;
+    requireFile?: boolean;
+}>;
+/**
+ * Proves that every existing component below the canonical project root is a
+ * real directory/file rather than a symbolic-link redirect. Missing tail
+ * components are allowed so callers can validate both before and after create.
+ */
+export declare function assertOperatePathCustody(projectDir: string, target: string, options: CustodyOptions): Promise<void>;
+/** Reject every symbolic link or special entry already present below a private root. */
+export declare function assertOperateTreeCustody(projectDir: string, root: string, options: CustodyOptions): Promise<void>;
+export {};
+//# sourceMappingURL=path-custody.d.ts.map

package/dist/services/operate/path-custody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-custody.d.ts","sourceRoot":"","sources":["../../../src/services/operate/path-custody.ts"],"names":[],"mappings":"AAIA,KAAK,cAAc,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC,CAAC;AAeH;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED,wFAAwF;AACxF,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/services/operate/path-custody.js

@@ -0,0 +1,120 @@
+import { lstat, readdir, realpath } from 'node:fs/promises';
+import path from 'node:path';
+const TREE_CUSTODY_MAX_ATTEMPTS = 32;
+class TreeCustodyChangedError extends Error {
+    constructor() {
+        super('The Operate custody tree changed while it was being inspected.');
+        this.name = 'TreeCustodyChangedError';
+    }
+}
+function custodyError(options) {
+    return Object.assign(new Error(options.message), { code: options.code });
+}
+/**
+ * Proves that every existing component below the canonical project root is a
+ * real directory/file rather than a symbolic-link redirect. Missing tail
+ * components are allowed so callers can validate both before and after create.
+ */
+export async function assertOperatePathCustody(projectDir, target, options) {
+    const project = path.resolve(projectDir);
+    const selected = path.resolve(target);
+    const planrRoot = path.join(project, '.planr');
+    if (selected !== planrRoot && !selected.startsWith(`${planrRoot}${path.sep}`)) {
+        throw custodyError(options);
+    }
+    let canonicalProject;
+    try {
+        canonicalProject = await realpath(project);
+    }
+    catch {
+        throw custodyError(options);
+    }
+    const relative = path.relative(project, selected);
+    let current = canonicalProject;
+    const segments = relative.split(path.sep).filter(Boolean);
+    for (let index = 0; index < segments.length; index += 1) {
+        current = path.join(current, segments[index]);
+        let metadata;
+        try {
+            metadata = await lstat(current);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+        if (metadata.isSymbolicLink())
+            throw custodyError(options);
+        const isLeaf = index === segments.length - 1;
+        if ((!isLeaf && !metadata.isDirectory()) ||
+            (isLeaf && options.requireDirectory && !metadata.isDirectory()) ||
+            (isLeaf && options.requireFile && !metadata.isFile())) {
+            throw custodyError(options);
+        }
+        const canonical = await realpath(current);
+        if (canonical !== canonicalProject && !canonical.startsWith(`${canonicalProject}${path.sep}`)) {
+            throw custodyError(options);
+        }
+    }
+}
+/** Reject every symbolic link or special entry already present below a private root. */
+export async function assertOperateTreeCustody(projectDir, root, options) {
+    const walk = async (directory) => {
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new TreeCustodyChangedError();
+            }
+            throw error;
+        }
+        for (const entry of entries) {
+            const target = path.join(directory, entry.name);
+            let metadata;
+            try {
+                metadata = await lstat(target);
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    throw new TreeCustodyChangedError();
+                }
+                throw error;
+            }
+            if (metadata.isSymbolicLink())
+                throw custodyError(options);
+            if (metadata.isDirectory()) {
+                await walk(target);
+            }
+            else if (!metadata.isFile()) {
+                throw custodyError(options);
+            }
+        }
+    };
+    for (let attempt = 1; attempt <= TREE_CUSTODY_MAX_ATTEMPTS; attempt += 1) {
+        await assertOperatePathCustody(projectDir, root, options);
+        let rootMetadata;
+        try {
+            rootMetadata = await lstat(root);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+        if (rootMetadata.isSymbolicLink() || !rootMetadata.isDirectory())
+            throw custodyError(options);
+        try {
+            await walk(root);
+            return;
+        }
+        catch (error) {
+            if (!(error instanceof TreeCustodyChangedError))
+                throw error;
+            if (attempt === TREE_CUSTODY_MAX_ATTEMPTS)
+                throw custodyError(options);
+        }
+    }
+}
+//# sourceMappingURL=path-custody.js.map

package/dist/services/operate/path-custody.js.map

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

package/dist/services/operate/pinned-legacy-replay-runner.d.ts

@@ -0,0 +1,9 @@
+import type { OperateLegacyReplayProof } from './storage-layout.js';
+/**
+ * Reads the frozen Operate Store v3 custody format without importing the current
+ * Store, reducers, Protocol helpers, Git, network, or sibling workspaces. This
+ * proves exact durable bytes and indexes; it makes no claim that superseded
+ * result contracts can be reinterpreted by the current runtime.
+ */
+export declare function runPinnedLegacyReplayVerifier(projectDir: string): Promise<OperateLegacyReplayProof>;
+//# sourceMappingURL=pinned-legacy-replay-runner.d.ts.map

package/dist/services/operate/pinned-legacy-replay-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinned-legacy-replay-runner.d.ts","sourceRoot":"","sources":["../../../src/services/operate/pinned-legacy-replay-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AA+WpE;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,CAAC,CAsInC"}