Function parsePiConfig

packages/pi-plugin/src/config/index.ts:173–279

(
	rawConfig: Record<string, unknown>,
	recoveredTopLevelKeys: string[] = [],
)

}

function parsePiConfig(
	rawConfig: Record<string, unknown>,
	recoveredTopLevelKeys: string[] = [],
): {
	config: MagicContextConfig;
	warnings: string[];
} {
	const preMigrationWarnings: string[] = [];
	const agentMigrated = migrateLegacyAgentEnabledInMemory(
		rawConfig,
		preMigrationWarnings,
	);
	// Relocate graduated experimental.* keys (temporal_awareness, caveman →
	// top-level; auto_search, git_commit_indexing → memory.*; user_memories,
	// pin_key_files → dreamer.*). Shared with OpenCode so both harnesses preserve
	// a user's opt-in/opt-out across the upgrade.
	const migrated = migrateDreamerV2(
		migrateLegacyExperimental(agentMigrated, preMigrationWarnings),
		preMigrationWarnings,
	);
	const parsed = MagicContextConfigSchema.safeParse(migrated);
	if (parsed.success) {
		return { config: parsed.data, warnings: preMigrationWarnings };
	}

	const defaults = MagicContextConfigSchema.parse({});
	const errorPaths = new Set<string>();
	// Per top-level key, the FULL error paths — so we can prune only the invalid
	// nested leaf instead of the whole block (mirrors OpenCode config recovery).
	const issuePathsByKey = new Map<string, PropertyKey[][]>();
	for (const issue of parsed.error.issues) {
		const topKey = issue.path[0];
		if (topKey !== undefined) {
			const key = String(topKey);
			errorPaths.add(key);
			const paths = issuePathsByKey.get(key) ?? [];
			paths.push([...issue.path]);
			issuePathsByKey.set(key, paths);
		}
	}

	const patched: Record<string, unknown> = { ...migrated };
	const warnings: string[] = [...preMigrationWarnings];

	for (const key of errorPaths) {
		recoveredTopLevelKeys.push(key);
		const isAgentConfig =
			key === "historian" || key === "dreamer" || key === "sidekick";

		if (isAgentConfig) {
			delete patched[key];
			warnings.push(
				`"${key}": invalid agent configuration, ignoring. Check your magic-context.jsonc.`,
			);
			continue;
		}

		// Object-valued key: prune ONLY invalid nested leaves, keep valid siblings