Function getTaskPath

src/utils/task-path.ts:148–195

(taskId: string, core?: Core | TaskPathContext)

 * For numeric-only IDs, automatically detects the prefix from existing files.
 */
export async function getTaskPath(taskId: string, core?: Core | TaskPathContext): Promise<string | null> {
	const coreInstance = core || new Core(process.cwd());

	// Extract prefix from the taskId
	const detectedPrefix = extractAnyPrefix(taskId);

	// If prefix is detected, search only for that prefix
	if (detectedPrefix) {
		const globPattern = buildGlobPattern(detectedPrefix);
		try {
			const files = await Array.fromAsync(
				new Bun.Glob(globPattern).scan({ cwd: coreInstance.filesystem.tasksDir, followSymlinks: true }),
			);
			const taskFile = findMatchingFile(files, taskId, detectedPrefix);
			if (taskFile) {
				return join(coreInstance.filesystem.tasksDir, taskFile);
			}
		} catch {
			// Fall through to return null
		}
		return null;
	}

	// For numeric-only IDs, scan all .md files and find one matching the number
	try {
		const allFiles = await Array.fromAsync(
			new Bun.Glob("*.md").scan({ cwd: coreInstance.filesystem.tasksDir, followSymlinks: true }),
		);

		// Look for a file matching this numeric ID with any prefix
		// Pattern: <prefix>-<number> - <title>.md (e.g., "back-358 - Title.md")
		const numericPart = taskId.trim();
		for (const file of allFiles) {
			// Extract prefix from filename and check if numeric part matches
			const filePrefix = extractAnyPrefix(file);
			if (filePrefix) {
				const fileBody = extractTaskBodyFromFilename(file, filePrefix);
				if (fileBody && numericPartsEqual(numericPart, fileBody)) {
					return join(coreInstance.filesystem.tasksDir, file);
				}
			}
		}

		return null;
	} catch {
		return null;
	}
}

/**
 * Helper to find a matching file from a list of files