get-tbd 0.1.25 → 0.1.27

package/dist/bin.mjs

@@ -6710,6 +6710,18 @@ const IssueKind = enumType([
 	"chore"
 ]);
 /**
+* Maximum issue title length before detail belongs in the description body.
+*/
+const ISSUE_TITLE_MAX_LENGTH = 500;
+/**
+* Maximum issue body section length to keep issue files practical to review and sync.
+*/
+const ISSUE_BODY_MAX_LENGTH = 5e4;
+/**
+* Issue title text as persisted in issue files.
+*/
+const IssueTitle = stringType().min(1).max(ISSUE_TITLE_MAX_LENGTH);
+/**
 * Priority: 0 (highest/critical) to 4 (lowest).
 */
 const Priority = numberType().int().min(0).max(4);
@@ -6743,12 +6755,12 @@ const Dependency = objectType({
 */
 const IssueSchema = BaseEntity.extend({
 	type: literalType("is"),
-	title: stringType().min(1).max(500),
+	title: IssueTitle,
 	kind: IssueKind.default("task"),
 	status: IssueStatus.default("open"),
 	priority: Priority.default(2),
-	description: stringType().max(5e4).nullable().optional(),
-	notes: stringType().max(5e4).nullable().optional(),
+	description: stringType().max(ISSUE_BODY_MAX_LENGTH).nullable().optional(),
+	notes: stringType().max(ISSUE_BODY_MAX_LENGTH).nullable().optional(),
 	spec_path: stringType().nullable().optional(),
 	assignee: stringType().nullable().optional(),
 	labels: arrayType(stringType()).default([]),
@@ -13735,6 +13747,18 @@ const ordering = {
 * IMPORTANT: Always use these utilities instead of raw yaml package functions.
 * This ensures consistent formatting and proper error handling across the codebase.
 */
+var yaml_utils_exports = /* @__PURE__ */ __exportAll({
+	MergeConflictError: () => MergeConflictError,
+	YAML_STRINGIFY_OPTIONS: () => YAML_STRINGIFY_OPTIONS,
+	YAML_STRINGIFY_OPTIONS_COMPACT: () => YAML_STRINGIFY_OPTIONS_COMPACT,
+	detectDuplicateYamlKeys: () => detectDuplicateYamlKeys,
+	hasMergeConflictMarkers: () => hasMergeConflictMarkers,
+	parseYamlToleratingDuplicateKeys: () => parseYamlToleratingDuplicateKeys,
+	parseYamlWithConflictDetection: () => parseYamlWithConflictDetection,
+	sortKeys: () => sortKeys,
+	stringifyYaml: () => stringifyYaml,
+	stringifyYamlCompact: () => stringifyYamlCompact
+});
 /**
 * Serialize data to YAML with readable formatting.
 *
@@ -14033,7 +14057,7 @@ function serializeIssue(issue) {
 * Package version, derived from git at build time.
 * Format: X.Y.Z for releases, X.Y.Z-dev.N.hash for dev builds.
 */
-const VERSION$1 = "0.1.25";
+const VERSION$1 = "0.1.27";
 
 //#endregion
 //#region src/cli/lib/version.ts
@@ -99037,6 +99061,7 @@ async function initWorktree(baseDir, remote = "origin", syncBranch = SYNC_BRANCH
 		await writeFile(join(dataSyncPath, "meta.yml"), "schema_version: 1\n");
 		await writeFile(join(dataSyncPath, "issues", ".gitkeep"), "");
 		await writeFile(join(dataSyncPath, "mappings", ".gitkeep"), "");
+		await writeFile(join(dataSyncPath, "mappings", ".gitattributes"), "ids.yml merge=union\n");
 		await git("-C", worktreePath, "add", ".");
 		await git("-C", worktreePath, "commit", "--no-verify", "-m", "Initialize tbd-sync branch");
 		return {
@@ -99274,9 +99299,16 @@ async function migrateDataToWorktree(baseDir, removeSource = false) {
 		await mkdir(correctMappingsPath, { recursive: true });
 		for (const file of issueFiles) await cp(join(wrongIssuesPath, file), join(correctIssuesPath, file));
 		for (const file of mappingFiles) if (file === "ids.yml") {
-			const { loadIdMapping, mergeIdMappings, saveIdMapping } = await Promise.resolve().then(() => id_mapping_exports);
-			const sourceMapping = await loadIdMapping(wrongPath);
-			await saveIdMapping(correctPath, mergeIdMappings(await loadIdMapping(correctPath), sourceMapping));
+			const { readFile } = await import("node:fs/promises");
+			const { loadIdMapping, mergeIdMappings, saveIdMapping, resolveIdMappingConflicts } = await Promise.resolve().then(() => id_mapping_exports);
+			const sourceMapping = resolveIdMappingConflicts(await readFile(join(wrongMappingsPath, file), "utf-8"));
+			let targetMapping;
+			try {
+				targetMapping = resolveIdMappingConflicts(await readFile(join(correctMappingsPath, file), "utf-8"));
+			} catch {
+				targetMapping = await loadIdMapping(correctPath);
+			}
+			await saveIdMapping(correctPath, mergeIdMappings(targetMapping, sourceMapping));
 		} else await cp(join(wrongMappingsPath, file), join(correctMappingsPath, file));
 		const totalFiles = issueFiles.length + mappingFiles.length;
 		await git("-C", worktreePath, "add", "-A");
@@ -99706,6 +99738,29 @@ function formatDebugId(internalId, mapping, prefix = "tbd") {
 	return `${formatDisplayId(internalId, mapping, prefix)} (${internalId})`;
 }
 
+//#endregion
+//#region src/utils/zod-error-utils.ts
+/**
+* Helpers for rendering Zod errors without relying on object inspection.
+*/
+/**
+* Format a ZodError as concise path-qualified messages for CLI output.
+*/
+function formatZodError(error) {
+	const messages = error.issues.map((issue) => {
+		return `${issue.path.length > 0 ? issue.path.join(".") : "<root>"}: ${issue.message}`;
+	});
+	return messages.length > 0 ? messages.join("; ") : error.message;
+}
+/**
+* Format unknown thrown values as safe strings for warnings and diagnostics.
+*/
+function formatUnknownError(error) {
+	if (error instanceof ZodError) return formatZodError(error);
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+
 //#endregion
 //#region src/file/storage.ts
 /**
@@ -99717,6 +99772,10 @@ function formatDebugId(internalId, mapping, prefix = "tbd") {
 * See: tbd-design.md §3.2 Storage Layer
 */
 /**
+* Maximum issue files read concurrently to avoid exhausting file descriptors in large repos.
+*/
+const ISSUE_READ_BATCH_SIZE = 200;
+/**
 * Get the path to an issue file.
 */
 function getIssuePath(baseDir, id) {
@@ -99734,7 +99793,8 @@ async function readIssue(baseDir, id) {
 * Uses atomic write to prevent corruption.
 */
 async function writeIssue(baseDir, issue) {
-	await writeFile(getIssuePath(baseDir, issue.id), serializeIssue(issue));
+	const validIssue = IssueSchema.parse(issue);
+	await writeFile(getIssuePath(baseDir, validIssue.id), serializeIssue(validIssue));
 }
 /**
 * List all issues in the worktree.
@@ -99742,7 +99802,8 @@ async function writeIssue(baseDir, issue) {
 *
 * Uses parallel file reading for better performance with many issues.
 */
-async function listIssues(baseDir) {
+async function listIssues(baseDir, options = {}) {
+	const warnOnInvalid = options.warnOnInvalid ?? true;
 	const issuesDir = join(baseDir, "issues");
 	let files;
 	try {
@@ -99751,10 +99812,9 @@ async function listIssues(baseDir) {
 		return [];
 	}
 	const mdFiles = files.filter((f) => f.endsWith(".md"));
-	const BATCH_SIZE = 200;
 	const issues = [];
-	for (let i = 0; i < mdFiles.length; i += BATCH_SIZE) {
-		const batch = mdFiles.slice(i, i + BATCH_SIZE);
+	for (let i = 0; i < mdFiles.length; i += ISSUE_READ_BATCH_SIZE) {
+		const batch = mdFiles.slice(i, i + ISSUE_READ_BATCH_SIZE);
 		const fileContents = await Promise.all(batch.map(async (file) => {
 			const filePath = join(issuesDir, file);
 			try {
@@ -99762,25 +99822,38 @@ async function listIssues(baseDir) {
 					file,
 					content: await readFile(filePath, "utf-8")
 				};
-			} catch {
+			} catch (error) {
 				return {
 					file,
-					content: null
+					error: formatUnknownError(error)
 				};
 			}
 		}));
-		for (const { file, content } of fileContents) {
-			if (content === null) continue;
+		for (const result of fileContents) {
+			if ("error" in result) {
+				reportInvalidIssueFile({
+					file: result.file,
+					reason: `failed to read file: ${result.error}`
+				}, warnOnInvalid, options.onInvalidIssue);
+				continue;
+			}
 			try {
-				const issue = parseIssue(content);
+				const issue = parseIssue(result.content);
 				issues.push(issue);
 			} catch (error) {
-				console.warn(`Skipping invalid issue file: ${file}`, error);
+				reportInvalidIssueFile({
+					file: result.file,
+					reason: formatUnknownError(error)
+				}, warnOnInvalid, options.onInvalidIssue);
 			}
 		}
 	}
 	return issues;
 }
+function reportInvalidIssueFile(invalidIssue, warnOnInvalid, onInvalidIssue) {
+	onInvalidIssue?.(invalidIssue);
+	if (warnOnInvalid) console.warn(`Skipping invalid issue file: ${invalidIssue.file}: ${invalidIssue.reason}`);
+}
 
 //#endregion
 //#region src/utils/lockfile.ts
@@ -99877,7 +99950,7 @@ async function withLockfile(lockPath, fn, options) {
 		acquired = true;
 		break;
 	} catch (error) {
-		if (error.code !== "EEXIST") break;
+		if (error.code !== "EEXIST") throw error;
 		try {
 			const lockStat = await stat(lockPath);
 			if (Date.now() - lockStat.mtimeMs > staleMs) {
@@ -100003,6 +100076,7 @@ var id_mapping_exports = /* @__PURE__ */ __exportAll({
 	mergeIdMappings: () => mergeIdMappings,
 	parseIdMappingFromYaml: () => parseIdMappingFromYaml,
 	reconcileMappings: () => reconcileMappings,
+	resolveIdMappingConflicts: () => resolveIdMappingConflicts,
 	resolveToInternalId: () => resolveToInternalId,
 	saveIdMapping: () => saveIdMapping
 });
@@ -100266,6 +100340,43 @@ function mergeIdMappings(local, remote) {
 	}
 	return merged;
 }
+/**
+* Resolve merge conflicts in ids.yml content by extracting both sides and merging.
+*
+* ids.yml is a sorted key-value YAML map where entries are append-only.
+* The most common merge conflict is both sides adding non-overlapping keys,
+* which is trivially auto-resolvable by keeping all entries from both sides.
+*
+* @param content - Raw file content that may contain git merge conflict markers
+* @returns Merged IdMapping with entries from both sides
+*/
+function resolveIdMappingConflicts(content) {
+	if (!hasMergeConflictMarkers(content)) return parseIdMappingFromYaml(content);
+	const lines = content.split("\n");
+	const oursLines = [];
+	const theirsLines = [];
+	let inConflict = "none";
+	for (const line of lines) {
+		if (line.startsWith("<<<<<<< ")) {
+			inConflict = "ours";
+			continue;
+		}
+		if (line === "=======" && inConflict === "ours") {
+			inConflict = "theirs";
+			continue;
+		}
+		if (line.startsWith(">>>>>>> ") && inConflict === "theirs") {
+			inConflict = "none";
+			continue;
+		}
+		if (inConflict === "none") {
+			oursLines.push(line);
+			theirsLines.push(line);
+		} else if (inConflict === "ours") oursLines.push(line);
+		else theirsLines.push(line);
+	}
+	return mergeIdMappings(parseIdMappingFromYaml(oursLines.join("\n")), parseIdMappingFromYaml(theirsLines.join("\n")));
+}
 
 //#endregion
 //#region src/lib/priority.ts
@@ -100458,6 +100569,22 @@ async function resolveAndValidatePath(inputPath, projectRoot, cwd) {
 	return resolved;
 }
 
+//#endregion
+//#region src/cli/lib/issue-input-validation.ts
+/**
+* CLI validation helpers for user-provided issue fields.
+*/
+/**
+* Validate a CLI-provided issue title with actionable user-facing errors.
+*/
+function validateIssueTitle(title, options) {
+	if (options.rejectBlank ? title.trim().length === 0 : title.length === 0) throw new ValidationError(options.emptyMessage);
+	if (title.length > ISSUE_TITLE_MAX_LENGTH) throw new ValidationError(`Title is too long (${title.length} chars, max ${ISSUE_TITLE_MAX_LENGTH}). Move detail into the description body.`);
+	const result = IssueTitle.safeParse(title);
+	if (!result.success) throw new ValidationError(`Invalid title: ${formatZodError(result.error)}`);
+	return title;
+}
+
 //#endregion
 //#region src/cli/commands/create.ts
 /**
@@ -100469,6 +100596,10 @@ var CreateHandler = class extends BaseCommand {
 	async run(title, options) {
 		const tbdRoot = await requireInit();
 		if (!title && !options.fromFile) throw new ValidationError("Title is required. Use: tbd create \"Issue title\"");
+		const validatedTitle = title === void 0 ? void 0 : validateIssueTitle(title, {
+			emptyMessage: "Title is required. Use: tbd create \"Issue title\"",
+			rejectBlank: true
+		});
 		const kind = this.parseKind(options.type ?? "task");
 		const priority = this.validatePriority(options.priority ?? "2");
 		let description = options.description;
@@ -100485,7 +100616,7 @@ var CreateHandler = class extends BaseCommand {
 			throw new ValidationError(getPathErrorMessage(error));
 		}
 		if (this.checkDryRun("Would create issue", {
-			title,
+			title: validatedTitle,
 			kind,
 			priority,
 			spec: specPath,
@@ -100517,7 +100648,7 @@ var CreateHandler = class extends BaseCommand {
 				type: "is",
 				id,
 				version: 1,
-				title,
+				title: validatedTitle,
 				kind,
 				status: "open",
 				priority,
@@ -100549,9 +100680,9 @@ var CreateHandler = class extends BaseCommand {
 		this.output.data({
 			id: displayId,
 			internalId: id,
-			title
+			title: validatedTitle
 		}, () => {
-			this.output.success(`Created ${displayId}: ${title}`);
+			this.output.success(`Created ${displayId}: ${validatedTitle}`);
 		});
 	}
 	parseKind(value) {
@@ -101036,10 +101167,7 @@ function matchesSpecPath(storedPath, queryPath) {
 	if (!normalizedStored || !normalizedQuery) return false;
 	if (normalizedStored === normalizedQuery) return true;
 	if (normalizedStored.endsWith("/" + normalizedQuery)) return true;
-	const storedFilename = basename(normalizedStored);
-	const queryFilename = basename(normalizedQuery);
-	if (!normalizedQuery.includes("/") && storedFilename === normalizedQuery) return true;
-	if (!normalizedQuery.includes("/") && storedFilename === queryFilename) return true;
+	if (!normalizedQuery.includes("/") && basename(normalizedStored) === normalizedQuery) return true;
 	return false;
 }
 /**
@@ -101370,7 +101498,10 @@ var UpdateHandler = class extends BaseCommand {
 			}
 			try {
 				const { frontmatter, description, notes } = parseMarkdownWithFrontmatter(content);
-				if (typeof frontmatter.title === "string") updates.title = frontmatter.title;
+				if (typeof frontmatter.title === "string") updates.title = validateIssueTitle(frontmatter.title, {
+					emptyMessage: "Title cannot be empty",
+					rejectBlank: true
+				});
 				if (typeof frontmatter.status === "string") {
 					const result = IssueStatus.safeParse(frontmatter.status);
 					if (result.success) updates.status = result.data;
@@ -101401,10 +101532,10 @@ var UpdateHandler = class extends BaseCommand {
 			}
 			return updates;
 		}
-		if (options.title !== void 0) {
-			if (!options.title.trim()) throw new ValidationError("Title cannot be empty");
-			updates.title = options.title;
-		}
+		if (options.title !== void 0) updates.title = validateIssueTitle(options.title, {
+			emptyMessage: "Title cannot be empty",
+			rejectBlank: true
+		});
 		if (options.status) {
 			const result = IssueStatus.safeParse(options.status);
 			if (!result.success) throw new ValidationError(`Invalid status: ${options.status}`);
@@ -102384,7 +102515,7 @@ async function fetchWithGhFallback(url, options) {
 * See: docs/project/specs/active/plan-2026-01-26-configurable-doc-cache-sync.md
 */
 /** Prefix for internal bundled doc sources */
-const INTERNAL_PREFIX = "internal:";
+const INTERNAL_SOURCE_PREFIX = "internal:";
 /**
 * Syncs documentation files from configured sources.
 *
@@ -102417,7 +102548,7 @@ var DocSync = class {
 	* // => { type: 'url', location: 'https://...' }
 	*/
 	parseSource(source) {
-		if (source.startsWith(INTERNAL_PREFIX)) return {
+		if (source.startsWith(INTERNAL_SOURCE_PREFIX)) return {
 			type: "internal",
 			location: source.slice(9)
 		};
@@ -102596,7 +102727,7 @@ async function generateDefaultDocCacheConfig() {
 			const entries = await readdir(fullDir, { withFileTypes: true });
 			for (const entry of entries) if (entry.isFile() && entry.name.endsWith(".md")) {
 				const relativePath = `${prefix}/${entry.name}`;
-				config[relativePath] = `${INTERNAL_PREFIX}${relativePath}`;
+				config[relativePath] = `${INTERNAL_SOURCE_PREFIX}${relativePath}`;
 			}
 		} catch {}
 	}
@@ -102633,8 +102764,6 @@ function isDocsStale(lastSyncAt, autoSyncHours) {
 	const lastSync = new Date(lastSyncAt).getTime();
 	return (Date.now() - lastSync) / (1e3 * 60 * 60) >= autoSyncHours;
 }
-/** Prefix for internal bundled doc sources */
-const INTERNAL_SOURCE_PREFIX = "internal:";
 /**
 * Check if an internal bundled doc exists.
 *
@@ -103459,6 +103588,19 @@ var SyncHandler = class extends BaseCommand {
 			} catch {
 				this.output.debug("Remote sync branch does not exist yet");
 			}
+			{
+				const { access, writeFile } = await import("node:fs/promises");
+				const attrPath = join(this.dataSyncDir, "mappings", ".gitattributes");
+				try {
+					await access(attrPath);
+				} catch {
+					await writeFile(attrPath, "ids.yml merge=union\n");
+					await git("-C", worktreePath, "add", attrPath);
+					try {
+						await git("-C", worktreePath, "commit", "--no-verify", "-m", "chore: add merge=union for ids.yml");
+					} catch {}
+				}
+			}
 			if (behindCommits > 0) {
 				let headBeforeMerge = "";
 				try {
@@ -103503,7 +103645,8 @@ var SyncHandler = class extends BaseCommand {
 						const remoteIdsContent = await git("show", `${remote}/${syncBranch}:${DATA_SYNC_DIR}/mappings/ids.yml`);
 						if (remoteIdsContent) {
 							conflictRemoteMapping = parseIdMappingFromYaml(remoteIdsContent);
-							const localMapping = await loadIdMapping(this.dataSyncDir);
+							const { readFile } = await import("node:fs/promises");
+							const localMapping = resolveIdMappingConflicts(await readFile(join(this.dataSyncDir, "mappings", "ids.yml"), "utf-8"));
 							const mergedMapping = mergeIdMappings(localMapping, conflictRemoteMapping);
 							await saveIdMapping(this.dataSyncDir, mergedMapping);
 							this.output.debug(`Merged ID mappings: ${localMapping.shortToUlid.size} local + ${conflictRemoteMapping.shortToUlid.size} remote = ${mergedMapping.shortToUlid.size} total`);
@@ -104601,6 +104744,7 @@ var DoctorHandler = class extends BaseCommand {
 	cwd = "";
 	config = null;
 	issues = [];
+	invalidIssueFiles = [];
 	async run(options) {
 		const tbdRoot = await requireInit();
 		this.cwd = tbdRoot;
@@ -104609,7 +104753,11 @@ var DoctorHandler = class extends BaseCommand {
 			this.config = await readConfig(this.cwd);
 		} catch {}
 		try {
-			this.issues = await listIssues(this.dataSyncDir);
+			this.invalidIssueFiles = [];
+			this.issues = await listIssues(this.dataSyncDir, {
+				warnOnInvalid: false,
+				onInvalidIssue: (invalidIssue) => this.invalidIssueFiles.push(invalidIssue)
+			});
 		} catch {}
 		const statusInfo = await this.gatherStatusInfo();
 		const statsInfo = await this.gatherStatsInfo();
@@ -104619,16 +104767,21 @@ var DoctorHandler = class extends BaseCommand {
 		healthChecks.push(await this.checkIssuesDirectory());
 		healthChecks.push(this.checkOrphanedDependencies(this.issues));
 		healthChecks.push(this.checkDuplicateIds(this.issues));
+		healthChecks.push(await this.checkIdMappingConflicts(options.fix));
 		healthChecks.push(await this.checkIdMappingDuplicates(options.fix));
 		healthChecks.push(await this.checkTempFiles(options.fix));
-		healthChecks.push(this.checkIssueValidity(this.issues));
+		healthChecks.push(this.checkIssueValidity(this.issues, this.invalidIssueFiles));
 		healthChecks.push(await this.checkWorktree(options.fix));
 		const dataLocationResult = await this.checkDataLocation(options.fix);
 		healthChecks.push(dataLocationResult);
 		if (dataLocationResult.status === "ok" && dataLocationResult.message?.includes("migrated")) {
 			this.dataSyncDir = await resolveDataSyncDir(this.cwd);
 			try {
-				this.issues = await listIssues(this.dataSyncDir);
+				this.invalidIssueFiles = [];
+				this.issues = await listIssues(this.dataSyncDir, {
+					warnOnInvalid: false,
+					onInvalidIssue: (invalidIssue) => this.invalidIssueFiles.push(invalidIssue)
+				});
 			} catch {}
 		}
 		const parsedMaxHistory = options.maxHistory ? parseInt(options.maxHistory, 10) : 50;
@@ -104831,6 +104984,58 @@ var DoctorHandler = class extends BaseCommand {
 		};
 	}
 	/**
+	* Check 5b: Merge conflict markers in ids.yml.
+	*
+	* After a failed git merge during sync, ids.yml may retain unresolved
+	* conflict markers (<<<<<<< / ======= / >>>>>>>). This blocks all tbd
+	* commands since YAML parsing throws MergeConflictError.
+	*
+	* For ids.yml, both sides are simple key-value pairs that are append-only,
+	* so the resolution is trivial: keep all entries from both sides.
+	*
+	* With --fix, extracts both sides, merges them, and re-saves.
+	*/
+	async checkIdMappingConflicts(fix) {
+		const mappingPath = join(this.dataSyncDir, "mappings", "ids.yml");
+		let content;
+		try {
+			content = await readFile(mappingPath, "utf-8");
+		} catch {
+			return {
+				name: "ID mapping conflicts",
+				status: "ok"
+			};
+		}
+		const { hasMergeConflictMarkers } = await Promise.resolve().then(() => yaml_utils_exports);
+		if (!hasMergeConflictMarkers(content)) return {
+			name: "ID mapping conflicts",
+			status: "ok"
+		};
+		if (fix && !this.checkDryRun("Resolve merge conflicts in ids.yml")) try {
+			const { resolveIdMappingConflicts, saveIdMapping } = await Promise.resolve().then(() => id_mapping_exports);
+			const resolved = resolveIdMappingConflicts(content);
+			await saveIdMapping(this.dataSyncDir, resolved);
+			return {
+				name: "ID mapping conflicts",
+				status: "ok",
+				message: `resolved merge conflicts (${resolved.shortToUlid.size} entries)`
+			};
+		} catch (error) {
+			return {
+				name: "ID mapping conflicts",
+				status: "error",
+				message: `failed to resolve conflicts: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+		return {
+			name: "ID mapping conflicts",
+			status: "error",
+			message: "ids.yml contains unresolved merge conflict markers",
+			fixable: true,
+			suggestion: "Run: tbd doctor --fix to auto-resolve"
+		};
+	}
+	/**
 	* Check for duplicate keys in the ID mapping file (ids.yml).
 	*
 	* After a git merge conflict resolution that keeps entries from both sides,
@@ -104919,8 +105124,12 @@ var DoctorHandler = class extends BaseCommand {
 			suggestion: "Run: tbd doctor --fix"
 		};
 	}
-	checkIssueValidity(issues) {
+	checkIssueValidity(issues, invalidIssueFiles) {
 		const invalid = [];
+		for (const invalidIssueFile of invalidIssueFiles) invalid.push({
+			id: invalidIssueFile.file,
+			reason: invalidIssueFile.reason
+		});
 		for (const issue of issues) {
 			const issueId = issue.id ?? "unknown";
 			if (!issue.id) {
@@ -104970,7 +105179,8 @@ var DoctorHandler = class extends BaseCommand {
 		return {
 			name: "Issue validity",
 			status: "error",
-			message: `${invalid.length} invalid issue(s)`,
+			message: `${invalid.length} invalid issue file(s)`,
+			path: join(CONFIG_DIR, "issues"),
 			details: invalid.map((i) => `${i.id}: ${i.reason}`),
 			suggestion: "Manually fix or delete invalid issue files"
 		};