Function loadPiConfigDetailed

packages/pi-plugin/src/config/index.ts:443–566

(
	opts: LoadPiConfigOptions = {},
)

}

export function loadPiConfigDetailed(
	opts: LoadPiConfigOptions = {},
): LoadPiConfigResultDetailed {
	const cwd = opts.cwd ?? process.cwd();
	const loadedFiles: LoadedConfigFile[] = [];
	const warnings: string[] = [];
	const legacySources = resolveLegacyConfigSources(cwd);
	const harnessLegacy = resolveLegacyConfigSourcesForHarness(cwd, "pi");

	const projectPath = resolveFirstExisting(getProjectConfigPaths(cwd));
	const projectLegacyFallback = projectPath
		? null
		: resolvePiLegacyFallback(harnessLegacy.project);
	const projectReadPath = projectPath ?? projectLegacyFallback?.path;
	if (projectReadPath) {
		const loaded = loadConfigFile(projectReadPath, "project");
		if (loaded) loadedFiles.push(loaded);
	}
	const legacyProjectUnmigrated =
		!projectPath &&
		!projectLegacyFallback &&
		legacySources.project.some((source) => existsSync(source.path));

	const userPath = resolveFirstExisting(getUserConfigPaths());
	const userLegacyFallback = userPath
		? null
		: resolvePiLegacyFallback(harnessLegacy.user);
	const userReadPath = userPath ?? userLegacyFallback?.path;
	if (userReadPath) {
		const loaded = loadConfigFile(userReadPath, "user");
		if (loaded) loadedFiles.push(loaded);
	}
	const legacyUserUnmigrated =
		!userPath &&
		!userLegacyFallback &&
		legacySources.user.some((source) => existsSync(source.path));

	if (userLegacyFallback) {
		warnings.push(
			`[user config] reading legacy config from ${userLegacyFallback.path} until migration completes; run \`npx @cortexkit/magic-context doctor\` to consolidate into the shared CortexKit location.`,
		);
	} else if (legacyUserUnmigrated) {
		warnings.push(
			"[user config] legacy Magic Context config exists but the shared CortexKit config is absent; embedding registration is paused until config migration completes.",
		);
	}

	if (projectLegacyFallback) {
		warnings.push(
			`[project config] reading legacy config from ${projectLegacyFallback.path} until migration completes; run \`npx @cortexkit/magic-context doctor\` to consolidate into the shared CortexKit location.`,
		);
	} else if (legacyProjectUnmigrated) {
		warnings.push(
			"[project config] legacy Magic Context config exists but the shared CortexKit config is absent; embedding registration is paused until config migration completes.",
		);
	}

	let rawConfig: Record<string, unknown> = {};