@iwonz/ywtc 4.0.0 → 4.1.0

package/dist/domain.d.ts

@@ -82,6 +82,12 @@ export declare class DestinationRevisionConflictError extends Error {
     readonly objectId: string;
     constructor(objectType: 'page' | 'comment', objectId: string, options?: ErrorOptions);
 }
+export type OwnershipConflictReason = 'duplicate-source-mapping' | 'immutable-id-mismatch' | 'ambiguous-ownership-candidates';
+export declare class DestinationOwnershipConflictError extends Error {
+    readonly reason: OwnershipConflictReason;
+    readonly candidateIds: string[];
+    constructor(reason: OwnershipConflictReason, candidateIds: string[], message: string, options?: ErrorOptions);
+}
 export interface UploadedResource {
     id: string;
     name: string;
@@ -175,7 +181,7 @@ export interface SourceStatusExclusion {
     depth?: number;
     discoveredFromId?: string;
     metadataComplete?: boolean;
-    reason: 'source-status';
+    reason: 'source-status' | 'inventory-drift';
     status?: string;
 }
 export interface DescendantDiscovery {
@@ -289,7 +295,7 @@ export interface HierarchyGap {
     pageId: string;
     missingParentId?: string;
     selectedParentId: string;
-    reason: 'unavailable' | 'source-status';
+    reason: 'unavailable' | 'source-status' | 'inventory-drift';
 }
 export interface SourceSelection {
     requestedStatus: SourceStatus;
@@ -335,6 +341,14 @@ export interface NormalizedNode {
         sectionType?: 'single' | 'two_equal' | 'two_left_sidebar' | 'two_right_sidebar' | 'three_equal' | 'three_with_sidebars' | 'unsupported';
     };
 }
+export type TransformationNoticeKind = 'normalization' | 'adaptation' | 'degradation';
+export interface TransformationNotice {
+    code: string;
+    kind: TransformationNoticeKind;
+    message: string;
+    objectId?: string;
+    verification?: string;
+}
 export interface NormalizedDocument {
     root: NormalizedNode;
     raw: string;
@@ -342,6 +356,8 @@ export interface NormalizedDocument {
     references: NormalizedReference[];
     warnings: string[];
     normalizations: string[];
+    adaptations: string[];
+    notices: TransformationNotice[];
     degraded: boolean;
     semanticallyEmpty: boolean;
     metrics: {
@@ -349,6 +365,7 @@ export interface NormalizedDocument {
         images: number;
         tables: number;
         codeBlocks: number;
+        preservedExternalReferences: number;
     };
 }
 export interface RenderContext {
@@ -365,7 +382,10 @@ export interface RenderedDocument {
     body: string;
     warnings: string[];
     normalizations: string[];
+    adaptations: string[];
+    notices: TransformationNotice[];
     degraded: boolean;
     representedReferences: number;
+    preservedExternalReferences: number;
 }
 export declare function assertTransferCapabilities(source: SourceAdapter, destination: DestinationAdapter | undefined, scope: TransferScope, sourceStatus?: SourceStatus, comments?: boolean): void;

package/dist/domain.js

@@ -18,6 +18,16 @@ export class DestinationRevisionConflictError extends Error {
         this.name = 'DestinationRevisionConflictError';
     }
 }
+export class DestinationOwnershipConflictError extends Error {
+    reason;
+    candidateIds;
+    constructor(reason, candidateIds, message, options) {
+        super(message, options);
+        this.reason = reason;
+        this.candidateIds = candidateIds;
+        this.name = 'DestinationOwnershipConflictError';
+    }
+}
 export function assertTransferCapabilities(source, destination, scope, sourceStatus = 'all', comments = true) {
     const missing = [];
     if (!source.capabilities.readPages)

package/dist/domain.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAiFA,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAE3C;IACA;IAFX,YACW,KAAa,EACb,MAAc,EACvB,OAAsB;QAEtB,KAAK,CAAC,+CAA+C,KAAK,GAAG,EAAE,OAAO,CAAC,CAAC;QAJ/D,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;QAIvB,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IAE9C;IACA;IAFX,YACW,UAA8B,EAC9B,QAAgB,EACzB,OAAsB;QAEtB,KAAK,CAAC,eAAe,UAAU,IAAI,QAAQ,uBAAuB,EAAE,OAAO,CAAC,CAAC;QAJpE,eAAU,GAAV,UAAU,CAAoB;QAC9B,aAAQ,GAAR,QAAQ,CAAQ;QAIzB,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAgQD,MAAM,UAAU,0BAA0B,CACxC,MAAqB,EACrB,WAA2C,EAC3C,KAAoB,EACpB,eAA6B,KAAK,EAClC,QAAQ,GAAG,IAAI;IAEf,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,CAAC;IACvF,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,aAAa;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,CAAC;IACnH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,aAAa;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,CAAC;IAC/F,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,CAAC;IAClH,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,cAAc;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,mBAAmB,CAAC,CAAC;IAC1H,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,iBAAiB,CAAC,CAAC;IACtH,IAAI,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,wCAAwC,CAAC,CAAC;IACxI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClH,MAAM,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,YAAY,KAAK,KAAK,CAAC;IAC1G,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,sCAAsC,YAAY,gBAAgB,KAAK,wDAAwD,CAAC,CAAC;IACzL,CAAC;AACH,CAAC"}
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"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"}

package/dist/exclusive-lease.d.ts

@@ -0,0 +1,14 @@
+interface LeaseMetadata {
+    pid: number;
+    hostname: string;
+    startedAt: string;
+    purpose: string;
+    target: string;
+}
+export interface ExclusiveLease {
+    filename: string;
+    metadata: LeaseMetadata;
+    release(): Promise<void>;
+}
+export declare function acquireExclusiveLease(filename: string, purpose: string, target: string): Promise<ExclusiveLease>;
+export {};

package/dist/exclusive-lease.js

@@ -0,0 +1,87 @@
+import { hostname } from 'node:os';
+import { mkdir, open, readFile, unlink } from 'node:fs/promises';
+import path from 'node:path';
+function localProcessIsAlive(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+async function existingLease(filename) {
+    try {
+        const value = JSON.parse(await readFile(filename, 'utf8'));
+        if (typeof value.pid !== 'number'
+            || typeof value.hostname !== 'string'
+            || typeof value.startedAt !== 'string'
+            || typeof value.purpose !== 'string'
+            || typeof value.target !== 'string')
+            return undefined;
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isProvablyStale(metadata) {
+    return metadata?.hostname === hostname() && !localProcessIsAlive(metadata.pid);
+}
+export async function acquireExclusiveLease(filename, purpose, target) {
+    await mkdir(path.dirname(filename), { recursive: true, mode: 0o700 });
+    const metadata = { pid: process.pid, hostname: hostname(), startedAt: new Date().toISOString(), purpose, target };
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        let created = false;
+        try {
+            const handle = await open(filename, 'wx', 0o600);
+            created = true;
+            try {
+                await handle.writeFile(`${JSON.stringify(metadata, null, 2)}\n`);
+            }
+            finally {
+                await handle.close();
+            }
+            let released = false;
+            return {
+                filename,
+                metadata,
+                async release() {
+                    if (released)
+                        return;
+                    released = true;
+                    const current = await existingLease(filename);
+                    if (current?.pid === metadata.pid && current.hostname === metadata.hostname && current.startedAt === metadata.startedAt) {
+                        await unlink(filename).catch((error) => {
+                            if (error.code !== 'ENOENT')
+                                throw error;
+                        });
+                    }
+                },
+            };
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST') {
+                if (created)
+                    await unlink(filename).catch(() => undefined);
+                throw error;
+            }
+            const current = await existingLease(filename);
+            if (attempt === 0 && isProvablyStale(current)) {
+                await unlink(filename).catch((unlinkError) => {
+                    if (unlinkError.code !== 'ENOENT')
+                        throw unlinkError;
+                });
+                continue;
+            }
+            const detail = current
+                ? `PID ${current.pid} on ${current.hostname}, started ${current.startedAt}`
+                : 'the lock metadata is unreadable and cannot be proven active';
+            throw new Error(`Another ${purpose} is active for "${target}" (${detail}). Wait for it to finish or remove the lock only after proving that process is no longer running.`);
+        }
+    }
+    throw new Error(`Could not acquire ${purpose} lock for "${target}"`);
+}
+//# sourceMappingURL=exclusive-lease.js.map

package/dist/exclusive-lease.js.map

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

package/dist/filesystem-export.d.ts

@@ -15,6 +15,8 @@ export interface ExportManifestPage {
     }>;
     degraded: boolean;
     warnings: string[];
+    adaptations: string[];
+    preservedExternalReferences: number;
     comments: {
         status: CommentTransferStatus;
         threads: number;

package/dist/filesystem-export.js

@@ -1,6 +1,6 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { createWriteStream } from 'node:fs';
-import { access, mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { access, mkdir, readFile, readdir, rename, rm, rmdir, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { pipeline } from 'node:stream/promises';
 import { ZipArchive } from '@archiver/archiver';
@@ -9,6 +9,7 @@ import { z } from 'zod';
 import { appendGridSnapshots, normalizePageContent, renderMarkdown, renderStaticHtml, setSourceResourceBinding, sourceResourceBindings } from './content-model.js';
 import { commentAttachmentUses, createCommentArchiveZip, renderCommentArchive } from './comments.js';
 import { DestinationNameAllocator } from './resource-reconciliation.js';
+import { acquireExclusiveLease } from './exclusive-lease.js';
 const manifestPageSchema = z.object({
     sourceCanonicalId: z.string(),
     sourceUrl: z.string(),
@@ -23,6 +24,8 @@ const manifestPageSchema = z.object({
     }).strict()),
     degraded: z.boolean(),
     warnings: z.array(z.string()),
+    adaptations: z.array(z.string()),
+    preservedExternalReferences: z.number().int().nonnegative(),
     comments: z.object({
         status: z.enum(['planned', 'complete', 'partial', 'failed', 'conflict', 'stale', 'skipped']),
         threads: z.number().int().nonnegative(),
@@ -155,6 +158,8 @@ export class FilesystemExporter {
                 resources: [],
                 degraded: false,
                 warnings: [],
+                adaptations: [],
+                preservedExternalReferences: 0,
                 comments: {
                     status: input.commentsEnabled === false ? 'skipped' : 'planned',
                     threads: input.commentsByPage?.get(page.canonicalId)?.threads.length ?? 0,
@@ -167,186 +172,202 @@ export class FilesystemExporter {
             }));
             return { directory: input.directory, manifest, warnings, errors };
         }
-        const parent = path.dirname(input.directory);
-        const staging = path.join(parent, `.${path.basename(input.directory)}.ywtc-staging-${randomUUID().slice(0, 8)}`);
-        await mkdir(parent, { recursive: true, mode: 0o700 });
-        await mkdir(staging, { recursive: false, mode: 0o700 });
-        let backup;
+        const lease = await acquireExclusiveLease(`${input.directory}.ywtc.lock`, 'ywtc filesystem export', input.directory);
         try {
-            const sourcePages = new Map(input.graph.pages.map((page) => [page.canonicalId, page]));
-            const queue = new PQueue({ concurrency: this.concurrency });
-            const resourceMapByPage = new Map();
-            const resourcesByPage = new Map();
-            const commentBodies = new Map();
-            await Promise.all(input.graph.pages.map((page) => queue.add(async () => {
-                if (input.signal?.aborted)
-                    throw input.signal.reason ?? new Error('Export cancelled');
-                const resources = input.resourcesByPage?.get(page.canonicalId) ?? await this.source.listResources(page);
-                resourcesByPage.set(page.canonicalId, resources);
-                const pageResources = sourceResourceBindings(page, resources);
-                const nameAllocator = new DestinationNameAllocator();
-                const manifestResources = [];
-                const downloadedByResource = new Map();
-                for (const resource of resources.filter((item) => item.kind !== 'grid')) {
-                    const name = nameAllocator.allocate(resource);
-                    const relative = `attachments/${stableSegment(page)}/${name}`;
-                    const destination = path.join(staging, relative);
-                    await mkdir(path.dirname(destination), { recursive: true });
-                    const downloaded = await this.source.downloadResource(resource, destination);
-                    downloadedByResource.set(resource.id, downloaded);
-                    setSourceResourceBinding(pageResources, page, resources, resource, { kind: 'file', path: relative, name });
-                    manifestResources.push({ name, path: relative, size: downloaded.size, sha256: downloaded.sha256 });
-                    input.onItem?.(`attachment ${name}`);
-                }
-                resourceMapByPage.set(page.canonicalId, pageResources);
-                const inventory = input.commentsByPage?.get(page.canonicalId);
-                let comments = {
-                    status: input.commentsEnabled === false ? 'skipped' : inventory?.status === 'failed' ? 'failed' : 'complete',
-                    threads: inventory?.threads.length ?? 0,
-                    comments: inventory?.comments ?? 0,
-                    participants: inventory?.participants ?? 0,
-                    attachments: inventory?.attachments ?? 0,
-                    bytes: inventory?.knownBytes ?? 0,
-                    ...(inventory?.fingerprint ? { fingerprint: inventory.fingerprint } : {}),
-                    ...(inventory?.error ? { error: inventory.error } : {}),
-                };
-                if (input.commentsEnabled !== false && inventory?.status === 'complete' && inventory.fingerprint) {
-                    try {
-                        const resourceById = new Map(resources.map((resource) => [resource.id, resource]));
-                        const files = commentAttachmentUses(inventory).flatMap((use) => {
-                            const id = use.reference.resourceId;
-                            const resource = id ? resourceById.get(id) : undefined;
-                            const downloaded = id ? downloadedByResource.get(id) : undefined;
-                            return resource && downloaded ? [{
-                                    commentId: use.commentId,
-                                    reference: use.reference.href,
-                                    originalName: resource.preferredName ?? resource.name,
-                                    ...downloaded,
-                                }] : [];
-                        });
-                        const zip = await createCommentArchiveZip({
-                            pageKey: page.id,
-                            fingerprint: inventory.fingerprint,
-                            files,
-                            destinationDirectory: path.join(staging, 'attachments', stableSegment(page)),
-                        });
-                        const archivePath = zip ? path.relative(staging, zip.path).split(path.sep).join('/') : undefined;
-                        const names = new Map();
-                        if (zip) {
-                            const byHash = new Map(zip.files.map((entry) => [entry.sha256, entry.archiveName]));
-                            for (const [resourceId, downloaded] of downloadedByResource) {
-                                const name = byHash.get(downloaded.sha256);
-                                if (name)
-                                    names.set(resourceId, name);
+            const parent = path.dirname(input.directory);
+            const staging = path.join(parent, `.${path.basename(input.directory)}.ywtc-staging-${randomUUID().slice(0, 8)}`);
+            await mkdir(parent, { recursive: true, mode: 0o700 });
+            await mkdir(staging, { recursive: false, mode: 0o700 });
+            let backup;
+            try {
+                const sourcePages = new Map(input.graph.pages.map((page) => [page.canonicalId, page]));
+                const queue = new PQueue({ concurrency: this.concurrency });
+                const resourceMapByPage = new Map();
+                const resourcesByPage = new Map();
+                const commentBodies = new Map();
+                await Promise.all(input.graph.pages.map((page) => queue.add(async () => {
+                    if (input.signal?.aborted)
+                        throw input.signal.reason ?? new Error('Export cancelled');
+                    const resources = input.resourcesByPage?.get(page.canonicalId) ?? await this.source.listResources(page);
+                    resourcesByPage.set(page.canonicalId, resources);
+                    const pageResources = sourceResourceBindings(page, resources);
+                    const nameAllocator = new DestinationNameAllocator();
+                    const manifestResources = [];
+                    const downloadedByResource = new Map();
+                    for (const resource of resources.filter((item) => item.kind !== 'grid')) {
+                        const name = nameAllocator.allocate(resource);
+                        const relative = `attachments/${stableSegment(page)}/${name}`;
+                        const destination = path.join(staging, relative);
+                        await mkdir(path.dirname(destination), { recursive: true });
+                        const downloaded = await this.source.downloadResource(resource, destination);
+                        downloadedByResource.set(resource.id, downloaded);
+                        setSourceResourceBinding(pageResources, page, resources, resource, { kind: 'file', path: relative, name });
+                        manifestResources.push({ name, path: relative, size: downloaded.size, sha256: downloaded.sha256 });
+                        input.onItem?.(`attachment ${name}`);
+                    }
+                    resourceMapByPage.set(page.canonicalId, pageResources);
+                    const inventory = input.commentsByPage?.get(page.canonicalId);
+                    let comments = {
+                        status: input.commentsEnabled === false ? 'skipped' : inventory?.status === 'failed' ? 'failed' : 'complete',
+                        threads: inventory?.threads.length ?? 0,
+                        comments: inventory?.comments ?? 0,
+                        participants: inventory?.participants ?? 0,
+                        attachments: inventory?.attachments ?? 0,
+                        bytes: inventory?.knownBytes ?? 0,
+                        ...(inventory?.fingerprint ? { fingerprint: inventory.fingerprint } : {}),
+                        ...(inventory?.error ? { error: inventory.error } : {}),
+                    };
+                    if (input.commentsEnabled !== false && inventory?.status === 'complete' && inventory.fingerprint) {
+                        try {
+                            const resourceById = new Map(resources.map((resource) => [resource.id, resource]));
+                            const files = commentAttachmentUses(inventory).flatMap((use) => {
+                                const id = use.reference.resourceId;
+                                const resource = id ? resourceById.get(id) : undefined;
+                                const downloaded = id ? downloadedByResource.get(id) : undefined;
+                                return resource && downloaded ? [{
+                                        commentId: use.commentId,
+                                        reference: use.reference.href,
+                                        originalName: resource.preferredName ?? resource.name,
+                                        ...downloaded,
+                                    }] : [];
+                            });
+                            const zip = await createCommentArchiveZip({
+                                pageKey: page.id,
+                                fingerprint: inventory.fingerprint,
+                                files,
+                                destinationDirectory: path.join(staging, 'attachments', stableSegment(page)),
+                            });
+                            const archivePath = zip ? path.relative(staging, zip.path).split(path.sep).join('/') : undefined;
+                            const names = new Map();
+                            if (zip) {
+                                const byHash = new Map(zip.files.map((entry) => [entry.sha256, entry.archiveName]));
+                                for (const [resourceId, downloaded] of downloadedByResource) {
+                                    const name = byHash.get(downloaded.sha256);
+                                    if (name)
+                                        names.set(resourceId, name);
+                                }
                             }
+                            const pageFile = pagePaths.get(page.canonicalId);
+                            commentBodies.set(page.canonicalId, renderCommentArchive(inventory, input.format, {
+                                sourceUrl: page.url,
+                                ...(zip && archivePath ? { archiveName: zip.name, archiveHref: relativeHref(pageFile, archivePath) } : {}),
+                                attachmentNames: names,
+                            }));
+                            comments = {
+                                ...comments,
+                                status: inventory.warnings.length ? 'partial' : 'complete',
+                                ...(zip && archivePath ? { archiveName: zip.name, archivePath, bytes: zip.size } : {}),
+                                ...(inventory.warnings.length ? { error: inventory.warnings.join('; ') } : {}),
+                            };
+                        }
+                        catch (error) {
+                            const message = error instanceof Error ? error.message : String(error);
+                            comments = { ...comments, status: 'failed', error: message };
                         }
+                    }
+                    manifest.pages.push({
+                        sourceCanonicalId: page.canonicalId,
+                        sourceUrl: page.url,
+                        title: page.title,
+                        path: pagePaths.get(page.canonicalId),
+                        ...(page.projectedParentId ? { parentId: page.projectedParentId } : {}),
+                        resources: manifestResources,
+                        degraded: false,
+                        warnings: [],
+                        adaptations: [],
+                        preservedExternalReferences: 0,
+                        comments,
+                    });
+                })));
+                const children = new Map();
+                for (const page of input.graph.pages) {
+                    const parentId = page.projectedParentId ?? '__root__';
+                    const siblings = children.get(parentId) ?? [];
+                    siblings.push(page);
+                    children.set(parentId, siblings);
+                }
+                const navigationFor = (currentPath) => {
+                    const renderItems = (parentId) => `<ul>${(children.get(parentId) ?? []).map((page) => {
                         const pageFile = pagePaths.get(page.canonicalId);
-                        commentBodies.set(page.canonicalId, renderCommentArchive(inventory, input.format, {
-                            sourceUrl: page.url,
-                            ...(zip && archivePath ? { archiveName: zip.name, archiveHref: relativeHref(pageFile, archivePath) } : {}),
-                            attachmentNames: names,
-                        }));
-                        comments = {
-                            ...comments,
-                            status: inventory.warnings.length ? 'partial' : 'complete',
-                            ...(zip && archivePath ? { archiveName: zip.name, archivePath, bytes: zip.size } : {}),
-                            ...(inventory.warnings.length ? { error: inventory.warnings.join('; ') } : {}),
-                        };
+                        const active = pageFile === currentPath ? ' aria-current="page"' : '';
+                        const title = page.title.replaceAll('&', '&amp;').replaceAll('<', '&lt;');
+                        return `<li><a${active} href="${relativeHref(currentPath, pageFile)}">${title}</a>${renderItems(page.canonicalId)}</li>`;
+                    }).join('')}</ul>`;
+                    return renderItems('__root__');
+                };
+                for (const page of input.graph.pages) {
+                    const fullPage = input.loadPage ? await input.loadPage(page) : page;
+                    const relative = pagePaths.get(page.canonicalId);
+                    const resources = resourcesByPage.get(page.canonicalId) ?? [];
+                    const document = input.loadDocument
+                        ? await input.loadDocument(page)
+                        : appendGridSnapshots(normalizePageContent(fullPage), resources);
+                    const pages = new Map([...pagePaths].map(([id, file]) => [id, { path: file, title: sourcePages.get(id)?.title ?? id }]));
+                    const context = {
+                        pages,
+                        resources: resourceMapByPage.get(page.canonicalId) ?? new Map(),
+                        sourcePages,
+                        currentPageId: page.canonicalId,
+                        currentPath: relative,
+                    };
+                    const rendered = input.format === 'html' ? await renderStaticHtml(document, context) : await renderMarkdown(document, context);
+                    const output = input.format === 'html'
+                        ? htmlPage(page.title, navigationFor(relative), `${rendered.body}${commentBodies.get(page.canonicalId) ?? ''}`, relativeHref(relative, 'assets/site.css'))
+                        : `# ${page.title}\n\n${rendered.body}${commentBodies.has(page.canonicalId) ? `\n\n## Комментарии\n\n${commentBodies.get(page.canonicalId)}` : ''}`;
+                    await mkdir(path.dirname(path.join(staging, relative)), { recursive: true });
+                    await writeFile(path.join(staging, relative), output, { mode: 0o600 });
+                    const manifestPage = manifest.pages.find((item) => item.sourceCanonicalId === page.canonicalId);
+                    manifestPage.degraded = rendered.notices.some((notice) => notice.kind === 'degradation');
+                    manifestPage.warnings.push(...rendered.warnings);
+                    manifestPage.adaptations.push(...rendered.adaptations);
+                    manifestPage.preservedExternalReferences = rendered.preservedExternalReferences;
+                    warnings.push(...rendered.warnings.map((warning) => `${page.title}: ${warning}`));
+                    if (manifestPage.degraded) {
+                        const snapshot = `_source/${stableSegment(page)}.${page.rawFormat === 'yfm' ? 'yfm' : 'storage.xml'}`;
+                        await mkdir(path.dirname(path.join(staging, snapshot)), { recursive: true });
+                        await writeFile(path.join(staging, snapshot), fullPage.rawContent, { mode: 0o600 });
+                    }
+                    input.onItem?.(`page ${page.title}`);
+                }
+                manifest.pages.sort((left, right) => left.path.localeCompare(right.path));
+                if (input.format === 'html') {
+                    await mkdir(path.join(staging, 'assets'), { recursive: true });
+                    await writeFile(path.join(staging, 'assets/site.css'), SITE_CSS, { mode: 0o600 });
+                }
+                await writeFile(path.join(staging, '.ywtc-export.json'), `${JSON.stringify(manifest, null, 2)}\n`, { mode: 0o600 });
+                await verifyGeneratedTree(staging, manifest);
+                if (await exists(input.directory)) {
+                    const selected = await stat(input.directory);
+                    const empty = selected.isDirectory() && (await readdir(input.directory)).length === 0;
+                    if (!selected.isDirectory() || (!empty && !(await managedManifest(input.directory, input.identity)))) {
+                        throw new Error(`Refusing to replace unmanaged destination "${input.directory}". Choose an empty path or a directory with a matching .ywtc-export.json.`);
+                    }
+                    if (empty) {
+                        await rmdir(input.directory);
                     }
-                    catch (error) {
-                        const message = error instanceof Error ? error.message : String(error);
-                        comments = { ...comments, status: 'failed', error: message };
+                    else {
+                        backup = `${input.directory}.backup-${timestamp()}`;
+                        await rename(input.directory, backup);
                     }
                 }
-                manifest.pages.push({
-                    sourceCanonicalId: page.canonicalId,
-                    sourceUrl: page.url,
-                    title: page.title,
-                    path: pagePaths.get(page.canonicalId),
-                    ...(page.projectedParentId ? { parentId: page.projectedParentId } : {}),
-                    resources: manifestResources,
-                    degraded: false,
-                    warnings: [],
-                    comments,
-                });
-            })));
-            const children = new Map();
-            for (const page of input.graph.pages) {
-                const parentId = page.projectedParentId ?? '__root__';
-                const siblings = children.get(parentId) ?? [];
-                siblings.push(page);
-                children.set(parentId, siblings);
-            }
-            const navigationFor = (currentPath) => {
-                const renderItems = (parentId) => `<ul>${(children.get(parentId) ?? []).map((page) => {
-                    const pageFile = pagePaths.get(page.canonicalId);
-                    const active = pageFile === currentPath ? ' aria-current="page"' : '';
-                    const title = page.title.replaceAll('&', '&amp;').replaceAll('<', '&lt;');
-                    return `<li><a${active} href="${relativeHref(currentPath, pageFile)}">${title}</a>${renderItems(page.canonicalId)}</li>`;
-                }).join('')}</ul>`;
-                return renderItems('__root__');
-            };
-            for (const page of input.graph.pages) {
-                const fullPage = input.loadPage ? await input.loadPage(page) : page;
-                const relative = pagePaths.get(page.canonicalId);
-                const resources = resourcesByPage.get(page.canonicalId) ?? [];
-                const document = input.loadDocument
-                    ? await input.loadDocument(page)
-                    : appendGridSnapshots(normalizePageContent(fullPage), resources);
-                const pages = new Map([...pagePaths].map(([id, file]) => [id, { path: file, title: sourcePages.get(id)?.title ?? id }]));
-                const context = {
-                    pages,
-                    resources: resourceMapByPage.get(page.canonicalId) ?? new Map(),
-                    sourcePages,
-                    currentPageId: page.canonicalId,
-                    currentPath: relative,
-                };
-                const rendered = input.format === 'html' ? await renderStaticHtml(document, context) : await renderMarkdown(document, context);
-                const output = input.format === 'html'
-                    ? htmlPage(page.title, navigationFor(relative), `${rendered.body}${commentBodies.get(page.canonicalId) ?? ''}`, relativeHref(relative, 'assets/site.css'))
-                    : `# ${page.title}\n\n${rendered.body}${commentBodies.has(page.canonicalId) ? `\n\n## Комментарии\n\n${commentBodies.get(page.canonicalId)}` : ''}`;
-                await mkdir(path.dirname(path.join(staging, relative)), { recursive: true });
-                await writeFile(path.join(staging, relative), output, { mode: 0o600 });
-                const manifestPage = manifest.pages.find((item) => item.sourceCanonicalId === page.canonicalId);
-                manifestPage.degraded = rendered.degraded;
-                manifestPage.warnings.push(...rendered.warnings);
-                warnings.push(...rendered.warnings.map((warning) => `${page.title}: ${warning}`));
-                if (rendered.degraded) {
-                    const snapshot = `_source/${stableSegment(page)}.${page.rawFormat === 'yfm' ? 'yfm' : 'storage.xml'}`;
-                    await mkdir(path.dirname(path.join(staging, snapshot)), { recursive: true });
-                    await writeFile(path.join(staging, snapshot), fullPage.rawContent, { mode: 0o600 });
+                try {
+                    await rename(staging, input.directory);
                 }
-                input.onItem?.(`page ${page.title}`);
-            }
-            manifest.pages.sort((left, right) => left.path.localeCompare(right.path));
-            if (input.format === 'html') {
-                await mkdir(path.join(staging, 'assets'), { recursive: true });
-                await writeFile(path.join(staging, 'assets/site.css'), SITE_CSS, { mode: 0o600 });
-            }
-            await writeFile(path.join(staging, '.ywtc-export.json'), `${JSON.stringify(manifest, null, 2)}\n`, { mode: 0o600 });
-            await verifyGeneratedTree(staging, manifest);
-            if (await exists(input.directory)) {
-                const selected = await stat(input.directory);
-                if (!selected.isDirectory() || !(await managedManifest(input.directory, input.identity))) {
-                    throw new Error(`Refusing to replace unmanaged destination "${input.directory}". Choose an empty path or a directory with a matching .ywtc-export.json.`);
+                catch (error) {
+                    if (backup && !(await exists(input.directory)))
+                        await rename(backup, input.directory);
+                    throw error;
                 }
-                backup = `${input.directory}.backup-${timestamp()}`;
-                await rename(input.directory, backup);
-            }
-            try {
-                await rename(staging, input.directory);
+                const archive = input.archive ? await createArchive(input.directory) : undefined;
+                return { directory: input.directory, ...(archive ? { archive } : {}), ...(backup ? { backup } : {}), manifest, warnings, errors };
             }
             catch (error) {
-                if (backup && !(await exists(input.directory)))
-                    await rename(backup, input.directory);
+                await rm(staging, { recursive: true, force: true });
                 throw error;
             }
-            const archive = input.archive ? await createArchive(input.directory) : undefined;
-            return { directory: input.directory, ...(archive ? { archive } : {}), ...(backup ? { backup } : {}), manifest, warnings, errors };
         }
-        catch (error) {
-            await rm(staging, { recursive: true, force: true });
-            throw error;
+        finally {
+            await lease.release();
         }
     }
 }