fix(downloads): restore hardened output scope release gates

Detect stale or foreign files in package-specific extraction directories before starting fresh work while excluding current and atomic ownership markers.

Keep recursive directory inspection confined to the start-conflict boundary and let archive cleanup prune empty package directories directly.

Register German-audio, auto-rename, collection, hybrid, and legacy fixtures through real complete PackageOutputScope records with current method signatures.

Verify plain stops only persist after active work drains, while update-restart parking keeps both its immediate checkpoint and final queued state.
This commit is contained in:
Sucukdeluxe
2026-08-22 18:24:50 +02:00
parent ea904aff79
commit 0d73f7e074
6 changed files with 155 additions and 78 deletions
+90 -46
View File
@@ -25,6 +25,7 @@ import { UnrestrictedLink } from "../src/main/realdebrid";
import { resetVideoToolingCache } from "../src/main/video-processor";
import { createDownloadHealthState, evaluateDownloadHealth } from "../src/main/download-health-monitor";
import type { AppSettings, DownloadItem, HistoryEntry, PackageEntry } from "../src/shared/types";
import { registerPackageCompleteOutputs } from "./helpers/package-output-scope";
const tempDirs: string[] = [];
const originalFetch = globalThis.fetch;
@@ -43,19 +44,6 @@ function writePackageOutputOwnerMarker(pkg: PackageEntry): void {
}));
}
function setExtractOutputRecords(pkg: PackageEntry, outputPaths: string[]): void {
pkg.outputProvenanceVersion = 1;
pkg.outputRecords = outputPaths.map((outputPath) => ({
version: 1,
archivePath: path.join(pkg.outputDir, "source.zip"),
entryPath: path.relative(pkg.extractDir, outputPath).replace(/\\/g, "/"),
outputPath,
state: "complete",
disposition: "written"
}));
pkg.outputCount = outputPaths.length;
}
describe("runWithLimitedConcurrency", () => {
it("processes the full batch without exceeding the configured worker count", async () => {
let active = 0;
@@ -7885,7 +7873,8 @@ describe("download manager", () => {
fs.writeFileSync(part2, Buffer.alloc(123, 0x62));
fs.writeFileSync(part3, Buffer.alloc(123, 0x63));
fs.writeFileSync(keep, "keep", "utf8");
fs.writeFileSync(path.join(extractDir, "episode.mkv"), "video", "utf8");
const episodePath = path.join(extractDir, "episode.mkv");
fs.writeFileSync(episodePath, "video", "utf8");
const session = emptySession();
const packageId = "legacy-old-pkg";
@@ -7905,10 +7894,11 @@ describe("download manager", () => {
createdAt,
updatedAt: createdAt
};
session.items[itemId] = {
id: itemId,
packageId,
url: "https://dummy/legacy-old",
registerPackageCompleteOutputs(session.packages[packageId], [episodePath]);
session.items[itemId] = {
id: itemId,
packageId,
url: "https://dummy/legacy-old",
provider: "realdebrid",
status: "completed",
retries: 0,
@@ -12077,7 +12067,7 @@ describe("download manager", () => {
createdAt,
updatedAt: createdAt
};
setExtractOutputRecords(session.packages[packageId], [
registerPackageCompleteOutputs(session.packages[packageId], [
path.join(extractDir, "episode.links.txt"),
path.join(extractDir, "sample", "sample.mkv")
]);
@@ -12166,7 +12156,7 @@ describe("download manager", () => {
updatedAt: createdAt
};
}
setExtractOutputRecords(session.packages[packageId], [extractedPath]);
registerPackageCompleteOutputs(session.packages[packageId], [extractedPath]);
const manager = new DownloadManager(
{
...defaultSettings(),
@@ -13183,7 +13173,7 @@ describe("download manager", () => {
createStoragePaths(path.join(root, "state"))
);
(manager as any).fileStabilizeMinAgeMs = 30_000;
setExtractOutputRecords(session.packages[packageId], [scenePath]);
registerPackageCompleteOutputs(session.packages[packageId], [scenePath]);
const expectedBase = "Test.Show.S02E05.Title.GERMAN.WS.720p.HDTV.x264-aWake";
const renamedLibPath = path.join(mkvLibraryDir, `${expectedBase}.mkv`);
@@ -13249,7 +13239,7 @@ describe("download manager", () => {
(manager as any).fileStabilizeMinAgeMs = 30_000;
const expectedBase = "Test.Show.S02E05.Title.GERMAN.WS.720p.HDTV.x264-aWake";
setExtractOutputRecords(session.packages[packageId], [path.join(epFolder, sceneName)]);
registerPackageCompleteOutputs(session.packages[packageId], [path.join(epFolder, sceneName)]);
await (manager as any).runDeferredPostExtraction(packageId, session.packages[packageId], 1, 0, true, 1);
expect(fs.existsSync(path.join(mkvLibraryDir, `${expectedBase}.mkv`))).toBe(true);
@@ -14979,9 +14969,10 @@ describe("download manager", () => {
downloadCompletedAt: 0
};
const [n1, n2] = await Promise.all([
(manager as any).autoRenameExtractedVideoFiles(extractDir, pkg),
(manager as any).autoRenameExtractedVideoFiles(extractDir, pkg)
const scope = registerPackageCompleteOutputs(pkg, episodes.map((ep) => path.join(extractDir, ep.folder, ep.file)));
const [n1, n2] = await Promise.all([
(manager as any).autoRenameExtractedVideoFiles(extractDir, scope, pkg),
(manager as any).autoRenameExtractedVideoFiles(extractDir, scope, pkg)
]);
expect(typeof n1).toBe("number");
@@ -15054,7 +15045,7 @@ describe("download manager", () => {
emptySession(),
createStoragePaths(path.join(root, "state"))
);
const pkg: any = {
const pkg: any = {
id: "overlap-pkg",
name: "Overlap.Test.S01.GERMAN.x264-aWake",
outputDir: path.join(root, "out", "Overlap.Test"),
@@ -15107,10 +15098,15 @@ describe("download manager", () => {
outputDir: path.join(root, "out", "Show"),
extractDir,
status: "completed", itemIds: [], cancelled: false, enabled: true, priority: "normal",
createdAt: 0, updatedAt: 0, downloadStartedAt: 0, downloadCompletedAt: 0
};
await (manager as any).collectMkvFilesToLibrary("movecomp-pkg", pkg);
createdAt: 0, updatedAt: 0, downloadStartedAt: 0, downloadCompletedAt: 0
};
registerPackageCompleteOutputs(pkg, [
path.join(epFolder, "Show.S01E01.GERMAN.x264-GROUP.mkv"),
path.join(epFolder, "Show.S01E01.GERMAN.x264-GROUP.srt"),
path.join(epFolder, "Show.S01E01.GERMAN.x264-GROUP.nfo")
]);
await (manager as any).collectMkvFilesToLibrary("movecomp-pkg", pkg);
const libFiles = fs.readdirSync(libDir);
expect(libFiles).toContain("Show.S01E01.GERMAN.x264-GROUP.mkv");
@@ -15134,16 +15130,22 @@ describe("download manager", () => {
emptySession(),
createStoragePaths(path.join(root, "state"))
);
const pkg: any = {
const pkg: any = {
id: "companion-pkg",
name: "Test.Show.S02.GERMAN.WS.720p.HDTV.x264-aWake",
outputDir: path.join(root, "out", "Test.Show.S02.GERMAN.WS.720p.HDTV.x264-aWake"),
extractDir,
status: "completed", itemIds: [], cancelled: false, enabled: true, priority: "normal",
createdAt: 0, updatedAt: 0, downloadStartedAt: 0, downloadCompletedAt: 0
};
const renamed = await (manager as any).autoRenameExtractedVideoFiles(extractDir, pkg);
createdAt: 0, updatedAt: 0, downloadStartedAt: 0, downloadCompletedAt: 0
};
const scope = registerPackageCompleteOutputs(pkg, [
path.join(epFolder, "awa-testshow02e05hd.mkv"),
path.join(epFolder, "awa-testshow02e05hd.srt"),
path.join(epFolder, "awa-testshow02e05hd.de.srt"),
path.join(epFolder, "awa-testshow02e05hd.nfo")
]);
const renamed = await (manager as any).autoRenameExtractedVideoFiles(extractDir, scope, pkg);
expect(renamed).toBe(1);
const expectedBase = "Test.Show.S02E05.Title.GERMAN.WS.720p.HDTV.x264-aWake";
const files = fs.readdirSync(epFolder);
@@ -15171,16 +15173,20 @@ describe("download manager", () => {
emptySession(),
createStoragePaths(path.join(root, "state"))
);
const pkg: any = {
const pkg: any = {
id: "collision-pkg",
name: "Test.Show.S02.GERMAN.WS.720p.HDTV.x264-aWake",
outputDir: path.join(root, "out", "Test.Show.S02.GERMAN.WS.720p.HDTV.x264-aWake"),
extractDir,
status: "completed", itemIds: [], cancelled: false, enabled: true, priority: "normal",
createdAt: 0, updatedAt: 0, downloadStartedAt: 0, downloadCompletedAt: 0
};
const renamed = await (manager as any).autoRenameExtractedVideoFiles(extractDir, pkg);
createdAt: 0, updatedAt: 0, downloadStartedAt: 0, downloadCompletedAt: 0
};
const scope = registerPackageCompleteOutputs(pkg, [
path.join(epFolder, "awa-testshow02e05hd.mkv"),
path.join(epFolder, "awa-testshow02e05hd.alt.mkv")
]);
const renamed = await (manager as any).autoRenameExtractedVideoFiles(extractDir, scope, pkg);
expect(renamed).toBe(2);
const expectedBase = "Test.Show.S02E05.Title.GERMAN.WS.720p.HDTV.x264-aWake";
const files = fs.readdirSync(epFolder).sort();
@@ -15253,7 +15259,7 @@ describe("start conflict guard + selective resume", () => {
expect(conflicts.map((c) => c.packageId)).not.toContain(packageId);
});
it("flags a fresh package when its package-specific extract dir already holds files and it has no completed items", async () => {
it("flags a fresh package when its package-specific extract dir already holds files and it has no completed items", async () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), "rd-startconflict-fresh-"));
tempDirs.push(root);
const storagePaths = createStoragePaths(path.join(root, "state"));
@@ -15279,11 +15285,49 @@ describe("start conflict guard + selective resume", () => {
session, storagePaths
);
const conflicts = await manager.getStartConflicts();
expect(conflicts.map((c) => c.packageId)).toContain(packageId);
});
it("start() holds excluded packages out of the run set and runs the rest", async () => {
const conflicts = await manager.getStartConflicts();
expect(conflicts.map((c) => c.packageId)).toContain(packageId);
});
it("does not flag a fresh package when its extract dir contains only current or atomic owner markers", async () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), "rd-startconflict-markers-"));
tempDirs.push(root);
const storagePaths = createStoragePaths(path.join(root, "state"));
initPackageLogs(storagePaths.baseDir);
initItemLogs(storagePaths.baseDir);
const session = emptySession();
const packageId = "pkg-marker-only";
const extractDir = path.join(root, "extract", "MarkerOnly");
const ownerId = crypto.randomUUID().toLowerCase();
fs.mkdirSync(extractDir, { recursive: true });
fs.writeFileSync(path.join(extractDir, ".rd-package-output-owner-v1.json"), JSON.stringify({
version: 1,
packageId,
generation: 1,
ownerId
}));
fs.writeFileSync(path.join(extractDir, `..rd-package-output-owner-v1.json.${crypto.randomUUID()}.tmp`), "{}");
session.packageOrder = [packageId];
session.packages[packageId] = {
id: packageId, name: "MarkerOnly",
outputDir: path.join(root, "downloads", "MarkerOnly"), extractDir,
status: "queued", itemIds: ["marker-pending"], cancelled: false, enabled: true,
outputOwnerId: ownerId, outputOwnerGeneration: 1, resultGeneration: 1,
createdAt: Date.now(), updatedAt: Date.now()
} as any;
session.items["marker-pending"] = makeItem("marker-pending", packageId, "queued", "marker.rar");
const manager = new DownloadManager(
{ ...defaultSettings(), token: "rd-token", outputDir: path.join(root, "downloads"), extractDir: path.join(root, "extract") },
session, storagePaths
);
const conflicts = await manager.getStartConflicts();
expect(conflicts.map((c) => c.packageId)).not.toContain(packageId);
});
it("start() holds excluded packages out of the run set and runs the rest", async () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), "rd-selective-resume-"));
tempDirs.push(root);
const storagePaths = createStoragePaths(path.join(root, "state"));