home-hosted 0.8.1 → 0.8.2

package/AGENTS.md

@@ -58,6 +58,8 @@ pnpm dev                           # tsx-watch panel :6000 + the stock UI's Vite
 pnpm dev --ui noc-console          # the same, for another UI; --port/--ui-port override
 pnpm run build                     # dist/cli.js + the stock UI (uis/stock/dist)
 pnpm run build:uis                 # every UI under uis/, zipped into uis/dist/ (release assets)
+pnpm run build:locales             # i18n/sheets/*.csv -> the git-ignored i18n/generated/*.json (also
+                                   #   runs on install and before every UI build)
 pnpm run quickcheck                # eslint + tsc + vue-tsc + the doc links — NOT the tests
 pnpm exec vitest run               # `pnpm test` is vitest in watch mode
 pnpm run check                     # ← THE GATE: quickcheck + vitest run --coverage. Run before every
@@ -123,7 +125,8 @@ These prevent defects if broken. The *why* for the non-obvious ones is in
   an old panel keeps serving, so a required field blanks the app.
 - **UIs move together.** A change to `uis/stock` — or to a shared contract it reads — lands in every
   other UI under `uis/`, and each altered UI raises its `ui.json` version; `scripts/stamp-uis.mjs`
-  **refuses** a commit that changed a shipped UI without raising it (`uis/<name>/test/**` is exempt).
+  **refuses** a commit that changed a shipped UI without raising it (a UI's `test/` and its own
+  `README.md` are exempt — neither is in the built asset).
   `src/shared/**` is a UI build input, so a runtime contract needs the bump too — the hook does not
   inspect that commit.
 - **Paths.** `dataRoot` is state, under `dataRoot/.hh`; `projectDir` is the base for relative entry

package/dist/cli.js

@@ -709,7 +709,7 @@ function parseBind(value) {
 	const parsed = bindSchema(value);
 	return parsed instanceof type.errors ? null : parsed;
 }
-var bindSchema, workspaceIdSchema, workspaceSchema, workspaceCreateSchema, workspaceRenameSchema, portSchema, onPortConflictSchema, onPortConflictDefaultSchema, restartSchema, httpCheckSchema, resourcesSchema, healthSchema, stopSchema, bootstrapSchema, bootstrapOrNullSchema, labelOrNullSchema, logBufferLinesSchema, serverSchema, authSchema, telegramSchema, notificationsSchema, logsSchema, tlsSchema, hostSchema, ddnsRecordTypeSchema, ddnsAccountSchema, ddnsDomainSchema, ddnsIpv4Schema, ddnsIpv6Schema, ddnsConfigSchema, ddnsRecordStateSchema, ddnsRecordViewSchema, ddnsStatusSchema, ddnsProviderFieldSchema, ddnsProviderInfoSchema, ddnsViewSchema, ddnsCredentialsSchema, backupsSchema, controlSchema, defaultsSchema, restartPatchSchema, httpCheckPatchSchema, resourcesPatchSchema, healthPatchSchema, stopPatchSchema, authPatchSchema, telegramPatchSchema, notificationsPatchSchema, hostPatchSchema, backupsPatchSchema, logsPatchSchema, tlsPatchSchema, controlPatchSchema, defaultsPatchSchema, editableFields, serverPatchSchema, serverCreateSchema, nannySpecSchema, nannyExitSchema, nannyStateSchema, settingsPatchSchema, workspaceSettingsPatchSchema, authStatusSchema, tlsStatusSchema, proxyEngineSchema, proxyTargetSchema, proxyTlsModeSchema, proxyRouteSchema, proxyCertificateSchema, proxyCertificateStateSchema, proxyDns01Schema, proxyConfigSchema, proxyEngineSourceSchema, proxyEngineStatusSchema, proxyEngineInfoSchema, proxyRouteStatusSchema, proxyRouteViewSchema, proxyRunStateSchema, proxyStatusSchema, proxyCertificateViewSchema, proxyDnsAccountViewSchema, proxyViewSchema, proxyRoutePatchSchema, proxyPatchSchema, proxyCertificateUploadSchema, proxyEngineInstallSchema, telegramStatusSchema, telegramChatsSchema, notificationViewSchema, sessionViewSchema, loginSchema, passwordValueSchema, passwordSchema, serverStatusSchema, healthStateSchema, portStateSchema, logStreamSchema, logLineSchema, historyEventSchema, serverHistorySchema, processResourcesSchema, hostDiskSchema, hostViewSchema, backupFileSchema, backupEntrySchema, backupsViewSchema, restoreItemSchema, restorePlanSchema, backupCreateSchema, restoreRequestSchema, serverViewSchema, healthResponseSchema, controlViewSchema, uiMetaSchema, uiStatusSchema, workspaceViewSchema, appStateSchema, logQuerySchema, freePortResultSchema, logHistoryQuerySchema, logFileInfoSchema, logServerViewSchema, logServersViewSchema, notificationActionSchema, telegramTokenSchema, apiErrorSchema, tlsUploadSchema, settingsViewSchema, settingsSavedSchema, workspaceSettingsViewSchema, workspaceSettingsSavedSchema;
+var bindSchema, workspaceIdSchema, workspaceSchema, workspaceCreateSchema, workspaceRenameSchema, portSchema, onPortConflictSchema, onPortConflictDefaultSchema, restartSchema, httpCheckSchema, resourcesSchema, healthSchema, stopSchema, bootstrapSchema, bootstrapOrNullSchema, labelOrNullSchema, logBufferLinesSchema, serverSchema, authSchema, telegramSchema, notificationsSchema, logsSchema, tlsSchema, hostSchema, ddnsRecordTypeSchema, ddnsAccountSchema, ddnsDomainSchema, ddnsIpv4Schema, ddnsIpv6Schema, ddnsConfigSchema, ddnsRecordStateSchema, ddnsRecordViewSchema, ddnsStatusSchema, ddnsProviderFieldSchema, ddnsProviderInfoSchema, ddnsViewSchema, ddnsCredentialsSchema, backupsSchema, controlSchema, defaultsSchema, restartPatchSchema, httpCheckPatchSchema, resourcesPatchSchema, healthPatchSchema, stopPatchSchema, authPatchSchema, telegramPatchSchema, notificationsPatchSchema, hostPatchSchema, backupsPatchSchema, logsPatchSchema, tlsPatchSchema, controlPatchSchema, defaultsPatchSchema, editableFields, serverPatchSchema, serverCreateSchema, nannySpecSchema, nannyExitSchema, nannyStateSchema, settingsPatchSchema, workspaceSettingsPatchSchema, authStatusSchema, tlsStatusSchema, proxyEngineSchema, proxyTargetSchema, proxyTlsModeSchema, proxyRouteSchema, proxyCertificateSchema, proxyCertificateStateSchema, proxyDns01Schema, proxyConfigSchema, proxyEngineSourceSchema, proxyEngineStatusSchema, proxyEngineInfoSchema, proxyRouteStatusSchema, proxyRouteViewSchema, proxyRunStateSchema, proxyStatusSchema, proxyCertificateViewSchema, proxyDnsAccountViewSchema, proxyViewSchema, proxyRoutePatchSchema, proxyPatchSchema, proxyCertificateUploadSchema, proxyEngineInstallSchema, telegramStatusSchema, telegramChatsSchema, notificationViewSchema, sessionViewSchema, loginSchema, passwordValueSchema, passwordSchema, serverStatusSchema, healthStateSchema, portStateSchema, logStreamSchema, logLineSchema, historyEventSchema, serverHistorySchema, processResourcesSchema, hostDiskSchema, hostViewSchema, backupFileSchema, backupEntrySchema, backupsViewSchema, restoreItemSchema, restoreSkipSchema, restorePlanSchema, backupCreateSchema, restoreRequestSchema, serverViewSchema, healthResponseSchema, controlViewSchema, uiMetaSchema, uiStatusSchema, workspaceViewSchema, appStateSchema, logQuerySchema, freePortResultSchema, logHistoryQuerySchema, logFileInfoSchema, logServerViewSchema, logServersViewSchema, notificationActionSchema, telegramTokenSchema, apiErrorSchema, tlsUploadSchema, settingsViewSchema, settingsSavedSchema, workspaceSettingsViewSchema, workspaceSettingsSavedSchema;
 var init_contracts = __esmMin((() => {
 	bindSchema = type("\"local\" | \"lan\" | /^\\d{1,3}(?:\\.\\d{1,3}){3}$/");
 	workspaceIdSchema = type("/^[a-z0-9][a-z0-9_-]*$/");
@@ -1475,14 +1475,26 @@ maxRssBytes: "number.integer >= 0 = 0" }).onUndeclaredKey("reject");
 	backupEntrySchema = type({
 		/** `global:settings` | `global:secrets` | `global:tls` | `workspace:<id>`. */
 		"id": "string",
+		/**
+		* The panel's own English wording. Kept because it is what an older UI reads, and what a
+		* single-language UI wants; a translated UI prefers the `*Key` beside it.
+		*/
 		"label": "string",
+		/** A catalog key for `label`, with its placeholder values, so a UI can render its own language. */
+		"labelKey?": "string",
+		"labelParams?": "Record<string, string>",
 		"kind": "\"settings\" | \"secrets\" | \"tls\" | \"workspace\"",
 		"workspaceId?": "string",
 		"note": "string | null",
+		/** The same pair for `note`: the panel knows which reason it is, the UI knows the wording. */
+		"noteKey?": "string",
+		"noteParams?": "Record<string, string>",
 		/** What this entry would capture; a workspace carries several leaves. */
 		"items": type({
 			"id": "string",
 			"label": "string",
+			"labelKey?": "string",
+			"labelParams?": "Record<string, string>",
 			/** `settings`/`servers`/`secrets` for a workspace, `data` for a declared path. */
 			"kind": "\"settings\" | \"servers\" | \"secrets\" | \"data\"",
 			"path?": "string",
@@ -1490,6 +1502,8 @@ maxRssBytes: "number.integer >= 0 = 0" }).onUndeclaredKey("reject");
 			"origin?": "string",
 			"included": "boolean",
 			"note": "string | null",
+			"noteKey?": "string",
+			"noteParams?": "Record<string, string>",
 			"ignoreGenerated?": "boolean"
 		}).array()
 	});
@@ -1507,27 +1521,45 @@ maxRssBytes: "number.integer >= 0 = 0" }).onUndeclaredKey("reject");
 		/** A backup entry or leaf id (`workspace:<id>:servers`, `data:<path>`, ...). */
 		"id": "string",
 		"label": "string",
+		"labelKey?": "string",
+		"labelParams?": "Record<string, string>",
 		"kind": "\"settings\" | \"secrets\" | \"servers\" | \"tls\" | \"data\"",
 		"workspaceId?": "string",
 		/** false when the current instance does not declare it, or it is not in the archive. */
 		"restorable": "boolean",
 		/** Echo of the request's selection, so the checkboxes round-trip. */
 		"selected": "boolean",
-		"note": "string | null"
+		"note": "string | null",
+		"noteKey?": "string",
+		"noteParams?": "Record<string, string>"
+	});
+	restoreSkipSchema = type({
+		"label": "string",
+		"labelKey?": "string",
+		"labelParams?": "Record<string, string>",
+		/** A catalog key for the parenthesis, e.g. `not selected`; absent when there is none. */
+		"reasonKey?": "string",
+		"reasonParams?": "Record<string, string>"
 	});
 	restorePlanSchema = type({
-		dryRun: "boolean",
-		encrypted: "boolean",
+		"dryRun": "boolean",
+		"encrypted": "boolean",
 		/** The archive needs a password (none or a wrong one was supplied). */
-		needsPassword: "boolean",
-		items: restoreItemSchema.array(),
-		applied: type("string[]"),
-		skipped: type("string[]"),
+		"needsPassword": "boolean",
+		"items": restoreItemSchema.array(),
+		"applied": type("string[]"),
+		/**
+		* The ids `applied` names, so a UI resolves each through `items` and renders its own label.
+		* `applied` itself stays: it is what a UI with one language reads.
+		*/
+		"appliedIds?": type("string[]"),
+		"skipped": type("string[]"),
+		"skippedItems?": restoreSkipSchema.array(),
 		/** Only the panel's own listener needs a restart; its servers are re-read live. */
-		restartRequired: "boolean",
+		"restartRequired": "boolean",
 		/** The panel re-read the restored config within this same restore. */
-		reloaded: "boolean",
-		error: "string?"
+		"reloaded": "boolean",
+		"error": "string?"
 	});
 	backupCreateSchema = type({
 		/** Optional: encrypts the archive. Never stored. */
@@ -13666,11 +13698,15 @@ function resolveBackupPaths(servers, includePaths = [], vars) {
 			ignoreGenerated: entry.ignoreGenerated
 		};
 		const note = parent.path === entry.path ? `already declared by ${parent.origin}` : `covered by ${parent.path}`;
+		const noteKey = parent.path === entry.path ? "settings.backup.noteAlreadyDeclared" : "settings.backup.noteCovered";
+		const noteParams = parent.path === entry.path ? { origin: parent.origin } : { path: parent.path };
 		return {
 			path: entry.path,
 			origin: entry.origin,
 			included: false,
 			note,
+			noteKey,
+			noteParams,
 			ignoreGenerated: entry.ignoreGenerated
 		};
 	});
@@ -13927,7 +13963,9 @@ var init_backups = __esmMin((() => {
 				needsPassword: false,
 				items: [],
 				applied: [],
+				appliedIds: [],
 				skipped: [],
+				skippedItems: [],
 				restartRequired: false,
 				reloaded: false
 			};
@@ -13970,7 +14008,13 @@ var init_backups = __esmMin((() => {
 					names: entries.map((entry) => entry.name),
 					...password === null ? {} : { password }
 				});
-				for (const name of extracted.skipped) plan.skipped.push(`${name} (symbolic link, skipped)`);
+				for (const name of extracted.skipped) {
+					plan.skipped.push(`${name} (symbolic link, skipped)`);
+					plan.skippedItems.push({
+						label: name,
+						reasonKey: "settings.restore.reasonSymbolicLink"
+					});
+				}
 				const manifestPath = path.join(staging, MANIFEST);
 				if (!fs.existsSync(manifestPath)) return {
 					...plan,
@@ -13987,6 +14031,13 @@ var init_backups = __esmMin((() => {
 							selected: false
 						});
 						plan.skipped.push(`${item.label}${item.note === null ? "" : ` (${item.note})`}`);
+						plan.skippedItems.push({
+							label: item.label,
+							...item.labelKey === void 0 ? {} : { labelKey: item.labelKey },
+							...item.labelParams === void 0 ? {} : { labelParams: item.labelParams },
+							reasonKey: item.noteKey ?? "settings.restore.reasonUnrestorable",
+							...item.noteParams === void 0 ? {} : { reasonParams: item.noteParams }
+						});
 						return;
 					}
 					const selected = selectedIds === null || selectedIds.has(item.id) || aliases.some((alias) => selectedIds.has(alias));
@@ -13995,14 +14046,30 @@ var init_backups = __esmMin((() => {
 						selected
 					});
 					if (selected) actions.set(item.id, apply);
-					else plan.skipped.push(`${item.label} (not selected)`);
+					else {
+						plan.skipped.push(`${item.label} (not selected)`);
+						plan.skippedItems.push({
+							label: item.label,
+							...item.labelKey === void 0 ? {} : { labelKey: item.labelKey },
+							...item.labelParams === void 0 ? {} : { labelParams: item.labelParams },
+							reasonKey: "settings.restore.reasonNotSelected"
+						});
+					}
 				};
 				const settingsText = readText(path.join(staging, "global", "settings.json"));
 				const parsedGlobal = readableGlobalSettings(settingsText) ? parseGlobalSettings(JSON.parse(settingsText)).config : null;
-				if (settingsText !== null && parsedGlobal === null) plan.skipped.push("Global settings (the archive's settings are not valid)");
+				if (settingsText !== null && parsedGlobal === null) {
+					plan.skipped.push("Global settings (the archive's settings are not valid)");
+					plan.skippedItems.push({
+						label: "Global settings",
+						labelKey: "settings.backup.entryGlobalSettings",
+						reasonKey: "settings.restore.reasonInvalidSettings"
+					});
+				}
 				if (parsedGlobal !== null && settingsText !== null) addItem({
 					id: "global:settings",
 					label: "Global settings",
+					labelKey: "settings.backup.entryGlobalSettings",
 					kind: "settings",
 					restorable: true,
 					note: null
@@ -14013,6 +14080,7 @@ var init_backups = __esmMin((() => {
 				if (globalSecrets !== null) addItem({
 					id: "global:secrets",
 					label: "Global secrets (password, API token)",
+					labelKey: "settings.backup.entryGlobalSecrets",
 					kind: "secrets",
 					restorable: true,
 					note: null
@@ -14025,6 +14093,7 @@ var init_backups = __esmMin((() => {
 					addItem({
 						id: "global:tls",
 						label: "TLS certificate",
+						labelKey: "settings.backup.entryTlsCertificate",
 						kind: "tls",
 						restorable: true,
 						note: null
@@ -14070,10 +14139,16 @@ var init_backups = __esmMin((() => {
 							addItem({
 								id: `workspace:${id}:${suffix}`,
 								label: `${id}: ${label}`,
+								labelKey: "settings.backup.restoreItemLabel",
+								labelParams: {
+									workspace: id,
+									item: suffix
+								},
 								kind: suffix,
 								workspaceId: id,
 								restorable: false,
-								note: "unknown workspace"
+								note: "unknown workspace",
+								noteKey: "settings.backup.noteUnknownWorkspace"
 							}, null);
 						}
 						continue;
@@ -14082,6 +14157,11 @@ var init_backups = __esmMin((() => {
 						if (readableWorkspaceSettings(settings)) addItem({
 							id: `workspace:${id}:settings`,
 							label: `${workspace.label}: Settings`,
+							labelKey: "settings.backup.restoreItemLabel",
+							labelParams: {
+								workspace: workspace.label,
+								item: "settings"
+							},
 							kind: "settings",
 							workspaceId: id,
 							restorable: true,
@@ -14089,7 +14169,18 @@ var init_backups = __esmMin((() => {
 						}, () => {
 							writeFileAtomic(workspace.settingsPath, settings);
 						});
-						else plan.skipped.push(`${workspace.label}: Settings (the archive's settings are not valid)`);
+						else {
+							plan.skipped.push(`${workspace.label}: Settings (the archive's settings are not valid)`);
+							plan.skippedItems.push({
+								label: `${workspace.label}: Settings`,
+								labelKey: "settings.backup.restoreItemLabel",
+								labelParams: {
+									workspace: workspace.label,
+									item: "settings"
+								},
+								reasonKey: "settings.restore.reasonInvalidSettings"
+							});
+						}
 					}
 					if (servers !== null) {
 						const parsed = readableServersFile(servers);
@@ -14098,6 +14189,11 @@ var init_backups = __esmMin((() => {
 							addItem({
 								id: `workspace:${id}:servers`,
 								label: `${workspace.label}: Servers`,
+								labelKey: "settings.backup.restoreItemLabel",
+								labelParams: {
+									workspace: workspace.label,
+									item: "servers"
+								},
 								kind: "servers",
 								workspaceId: id,
 								restorable: true,
@@ -14105,11 +14201,27 @@ var init_backups = __esmMin((() => {
 							}, () => {
 								writeFileAtomic(workspace.serversPath, servers);
 							});
-						} else plan.skipped.push(`${workspace.label}: Servers (the archive's servers are not valid)`);
+						} else {
+							plan.skipped.push(`${workspace.label}: Servers (the archive's servers are not valid)`);
+							plan.skippedItems.push({
+								label: `${workspace.label}: Servers`,
+								labelKey: "settings.backup.restoreItemLabel",
+								labelParams: {
+									workspace: workspace.label,
+									item: "servers"
+								},
+								reasonKey: "settings.restore.reasonInvalidServers"
+							});
+						}
 					}
 					if (secrets !== null) addItem({
 						id: `workspace:${id}:secrets`,
 						label: `${workspace.label}: Secrets`,
+						labelKey: "settings.backup.restoreItemLabel",
+						labelParams: {
+							workspace: workspace.label,
+							item: "secrets"
+						},
 						kind: "secrets",
 						workspaceId: id,
 						restorable: true,
@@ -14179,21 +14291,27 @@ var init_backups = __esmMin((() => {
 						const declaredByBackup = archiveAll.some((candidate) => candidate.origin === origin && (workspace === void 0 || candidate.workspace === workspace));
 						addItem({
 							...base,
-							note: declaredByBackup ? "declared by the backup's config, which is not being restored" : "not declared by this config, nor by the backup"
+							note: declaredByBackup ? "declared by the backup's config, which is not being restored" : "not declared by this config, nor by the backup",
+							noteKey: declaredByBackup ? "settings.backup.noteDeclaredByBackup" : "settings.backup.noteNotDeclared"
 						}, null, aliases);
 						continue;
 					}
 					if (!fs.existsSync(from)) {
 						addItem({
 							...base,
-							note: "missing from the archive"
+							note: "missing from the archive",
+							noteKey: "settings.backup.noteMissingFromArchive"
 						}, null, aliases);
 						continue;
 					}
 					addItem({
 						...base,
 						restorable: true,
-						note: target.path === archivedPath ? null : `restored from ${archivedPath}`
+						...target.path === archivedPath ? { note: null } : {
+							note: `restored from ${archivedPath}`,
+							noteKey: "settings.backup.noteRestoredFrom",
+							noteParams: { path: archivedPath }
+						}
 					}, () => fs.cpSync(from, target.path, {
 						recursive: true,
 						force: true,
@@ -14207,12 +14325,14 @@ var init_backups = __esmMin((() => {
 				}
 				if (!options.confirm) {
 					plan.applied = [...actions.keys()].map((id) => labelOf(plan, id));
+					plan.appliedIds = [...actions.keys()];
 					return plan;
 				}
 				for (const [id, apply] of actions) {
 					apply();
 					plan.applied.push(labelOf(plan, id));
 				}
+				plan.appliedIds = [...actions.keys()];
 				if (this.options.onRestored !== void 0 && [...actions.keys()].some((id) => RELOADABLE.test(id))) {
 					plan.reloaded = true;
 					this.options.onRestored();
@@ -14239,26 +14359,36 @@ var init_backups = __esmMin((() => {
 		}
 		/** Selectable entries: the three global slices, then one per workspace. */
 		entries(sources) {
+			const missing = (path, key) => {
+				const absent = this.missingNote(path);
+				return absent === null ? { note: null } : {
+					note: absent,
+					noteKey: key
+				};
+			};
 			const entries = [
 				{
 					id: "global:settings",
 					label: "Global settings",
+					labelKey: "settings.backup.entryGlobalSettings",
 					kind: "settings",
-					note: this.missingNote(sources.globalSettingsPath),
+					...missing(sources.globalSettingsPath, "settings.backup.noteMissing"),
 					items: []
 				},
 				{
 					id: "global:secrets",
 					label: "Global secrets (password, API token)",
+					labelKey: "settings.backup.entryGlobalSecrets",
 					kind: "secrets",
-					note: this.missingNote(sources.globalSecretsPath),
+					...missing(sources.globalSecretsPath, "settings.backup.noteMissing"),
 					items: []
 				},
 				{
 					id: "global:tls",
 					label: "TLS certificate",
+					labelKey: "settings.backup.entryTlsCertificate",
 					kind: "tls",
-					note: this.missingNote(sources.tlsDir),
+					...missing(sources.tlsDir, "settings.backup.noteMissing"),
 					items: []
 				}
 			];
@@ -14274,27 +14404,37 @@ var init_backups = __esmMin((() => {
 		}
 		workspaceItems(workspace, includePaths) {
 			const id = workspace.id;
+			const note = (path) => {
+				const absent = this.missingNote(path);
+				return absent === null ? { note: null } : {
+					note: absent,
+					noteKey: "settings.backup.noteMissing"
+				};
+			};
 			const items = [
 				{
 					id: `workspace:${id}:settings`,
 					label: "Settings",
+					labelKey: "settings.backup.leafSettings",
 					kind: "settings",
 					included: true,
-					note: this.missingNote(workspace.settingsPath)
+					...note(workspace.settingsPath)
 				},
 				{
 					id: `workspace:${id}:servers`,
 					label: "Servers",
+					labelKey: "settings.backup.leafServers",
 					kind: "servers",
 					included: true,
-					note: this.missingNote(workspace.serversPath)
+					...note(workspace.serversPath)
 				},
 				{
 					id: `workspace:${id}:secrets`,
 					label: "Secrets",
+					labelKey: "settings.backup.leafSecrets",
 					kind: "secrets",
 					included: true,
-					note: this.missingNote(workspace.secretsPath)
+					...note(workspace.secretsPath)
 				}
 			];
 			for (const declared of this.declaredData(workspace.servers, includePaths)) items.push({
@@ -14305,6 +14445,8 @@ var init_backups = __esmMin((() => {
 				origin: declared.origin,
 				included: declared.included,
 				note: declared.note,
+				...declared.noteKey === void 0 ? {} : { noteKey: declared.noteKey },
+				...declared.noteParams === void 0 ? {} : { noteParams: declared.noteParams },
 				ignoreGenerated: declared.ignoreGenerated
 			});
 			return items;
@@ -14320,7 +14462,8 @@ var init_backups = __esmMin((() => {
 				if (entry.included && isInside(entry.path, archiveDir)) return {
 					...entry,
 					included: false,
-					note: "contains the backup directory"
+					note: "contains the backup directory",
+					noteKey: "settings.backup.noteContainsBackupDir"
 				};
 				return entry;
 			});