Function loadPluginConfigDetailed

packages/plugin/src/config/index.ts:441–570

(directory: string)

}

export function loadPluginConfigDetailed(directory: string): LoadResultDetailed {
    const userDetected = detectConfigFile(getUserConfigBasePath());
    const projectDetected = detectConfigFile(getProjectConfigBasePath(directory));
    // Both-harness sources drive the GC-suppression signal; this-harness sources
    // (OpenCode) drive the non-destructive read fallback when the base is absent.
    const legacySources = resolveLegacyConfigSources(directory);
    const harnessLegacy = resolveLegacyConfigSourcesForHarness(directory, "opencode");

    // When the CortexKit base is absent (migration refused on a differing
    // OpenCode/Pi pair, or hasn't run), read THIS harness's own legacy file
    // instead of falling to schema defaults that would silently re-enable
    // features the user disabled.
    const userLegacyFallback =
        userDetected.format === "none"
            ? resolveLegacyReadFallback(harnessLegacy.user)
            : { source: null };
    const projectLegacyFallback =
        projectDetected.format === "none"
            ? resolveLegacyReadFallback(harnessLegacy.project)
            : { source: null };

    // "Unmigrated" (→ untrusted, GC suppressed) ONLY when the base is absent,
    // some legacy config exists, AND we did NOT read this harness's own legacy.
    // If we read our own legacy the config is real → trusted. If only the OTHER
    // harness's legacy exists we fell to defaults → keep GC suppressed so a
    // default-config start can't reap the other harness's embedding vectors.
    const legacyUserUnmigrated =
        userDetected.format === "none" &&
        !userLegacyFallback.source &&
        legacySources.user.some((source) => existsSync(source.path));
    const legacyProjectUnmigrated =
        projectDetected.format === "none" &&
        !projectLegacyFallback.source &&
        legacySources.project.some((source) => existsSync(source.path));

    const userLoaded =
        userDetected.format !== "none"
            ? loadConfigFileDetailed(userDetected.path, "user")
            : userLegacyFallback.source
              ? loadConfigFileDetailed(userLegacyFallback.source.path, "user")
              : null;
    const projectLoaded =
        projectDetected.format !== "none"
            ? loadConfigFileDetailed(projectDetected.path, "project")
            : projectLegacyFallback.source
              ? loadConfigFileDetailed(projectLegacyFallback.source.path, "project")
              : null;

    const allWarnings: string[] = [];
    let mergedRaw: Record<string, unknown> = {};

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