Checkpoint peering identity and opt-in discovery

scraper/lib/publisher.js

@@ -10,6 +10,7 @@ const { cleanPart, chapterFolder, assertInside } = require('./names');
 const { sizeFromBuffer, imageSize } = require('../../library');
 const { directionFields } = require('../../reading-direction');
 const { mergeImportedMetadata } = require('./metadata-merge');
+const { normalizeWorkIdentity } = require('./work-identity');
 
 const token = () => crypto.randomBytes(5).toString('hex');
 // Staging is a recovery asset, not disposable garbage. Legacy stages without an
@@ -204,7 +205,16 @@ async function publishManifest(manifest, options = {}) {
   const isNew = !mangaDir;
   const finalName = cleanPart(manifest.series.folder || manifest.series.title);
   const finalDir = assertInside(libraryRoot, path.join(libraryRoot, finalName));
-  if (!mangaDir && await exists(finalDir)) throw new Error(`Folder already belongs to another work: ${finalDir}`);
+  if (!mangaDir && await exists(finalDir)) {
+    const existing = await readMetadata(path.join(finalDir, 'manga.json'));
+    const incomingIdentity = normalizeWorkIdentity(manifest.series.metadata?.['x-work-identity']);
+    const existingIdentity = normalizeWorkIdentity(existing['x-work-identity']);
+    if (incomingIdentity && existingIdentity && incomingIdentity.kind === existingIdentity.kind
+      && incomingIdentity.value === existingIdentity.value) {
+      throw new Error(`Work identity matches the existing “${existing.title || finalName}” folder, but its source association was not resolved. Review the existing manga target; no files were overwritten.`);
+    }
+    throw new Error(`A library folder named “${finalName}” already exists, but this download could not be safely matched to it. No files were overwritten. Choose the existing manga as the target or review its work identity before syncing.`);
+  }
   mangaDir = mangaDir || path.join(libraryRoot, `.staging-mcscraper-resume-${digest([finalName, [...sourceUrls].sort()])}`);
   await fsp.mkdir(mangaDir, { recursive: true, mode: 0o755 });
   const http = options.httpClient || new SlowHttp(options.http || manifest.http || {});