learnharness/tests/settings-resolution.test.ts

/**
 * Tests for the resolution layer (settings-storage wave, 2026-09-19):
 * core/settings-resolution.ts — the delta→concrete projection. The factory
 * layer is threaded in as a parameter (core stays pure; server/stores.ts
 * threads config.ts's MODELS), so these tests use a small synthetic pin.
 */

import assert from "node:assert/strict";
import { describe, it } from "node:test";
import {
	extractionEnabled,
	graphContextEnabled,
	resolveModelSpec,
	resolveSettings,
} from "../src/core/settings-resolution.ts";
import { BACKGROUND_MODEL_ROLES, type UserSettings } from "../src/core/settings.ts";

const FACTORY_PINS = Object.fromEntries(
	BACKGROUND_MODEL_ROLES.map((role, i) => [
		role,
		{ model: `factory/model-${i}`, effort: i % 2 === 0 ? "low" : "off" },
	]),
) as Record<(typeof BACKGROUND_MODEL_ROLES)[number], { model: string; effort: "low" | "off" }>;

describe("resolveSettings", () => {
	it("null record (first boot): every knob lands on its factory default", () => {
		const eff = resolveSettings(null, FACTORY_PINS);
		assert.deepEqual(eff.general, { autoUpdate: true });
		assert.deepEqual(eff.chat, {}); // BYOK: no default model, ever
		assert.deepEqual(eff.agent.tools, {});
		assert.deepEqual(eff.agent.prompts, {});
		for (const role of BACKGROUND_MODEL_ROLES) {
			assert.equal(eff.agent.models[role].id, FACTORY_PINS[role].model);
			assert.equal(eff.agent.models[role].provider, "openrouter");
			assert.equal(eff.agent.models[role].thinkingLevel, FACTORY_PINS[role].effort);
		}
		assert.equal(eff.appearance.mode, "dark");
		assert.equal(eff.appearance.background, null);
		assert.equal(eff.appearance.fontFamily, null);
		assert.equal(eff.appearance.proseFontSize, 16);
		assert.equal(eff.appearance.sessionNameSerif, true);
		assert.equal(eff.appearance.mdRendering.headingWeight, 900);
		assert.deepEqual(eff.graph, { enabled: true, embedding: true, clustering: true, labeling: true });
	});

	it("explicit record values win over every factory default", () => {
		const record: UserSettings = {
			version: 1,
			general: { autoUpdate: false },
			chat: { thinkingLevel: "high" },
			agent: {
				models: { researcher: { model: { provider: "openrouter", id: "qwen/qwen3.8-flash" } } },
				tools: { research: false },
				prompts: { "system-prompt.md": true },
			},
			appearance: { mode: "light", proseFontSize: 20, mdRendering: { headingWeight: 600 } },
			graph: { enabled: false },
		};
		const eff = resolveSettings(record, FACTORY_PINS);
		assert.equal(eff.general.autoUpdate, false);
		assert.deepEqual(eff.chat, { thinkingLevel: "high" });
		assert.deepEqual(eff.agent.models.researcher, {
			provider: "openrouter",
			id: "qwen/qwen3.8-flash",
			thinkingLevel: "low", // thinking NOT overridden → factory effort
		});
		assert.deepEqual(eff.agent.tools, { research: false });
		assert.deepEqual(eff.agent.prompts, { "system-prompt.md": true });
		assert.equal(eff.appearance.mode, "light");
		assert.equal(eff.appearance.proseFontSize, 20);
		assert.equal(eff.appearance.mdRendering.headingWeight, 600);
		// graph: enabled=false explicit; absent rungs stay factory-on (stored
		// but inert — the ladder grays them out in the UI).
		assert.deepEqual(eff.graph, { enabled: false, embedding: true, clustering: true, labeling: true });
	});

	it("partial role override: thinkingLevel alone swaps the budget, model stays pinned", () => {
		const eff = resolveSettings(
			{ version: 1, agent: { models: { extractor: { thinkingLevel: "medium" } } } },
			FACTORY_PINS,
		);
		const extractor = FACTORY_PINS.extractor;
		assert.deepEqual(eff.agent.models.extractor, {
			provider: "openrouter",
			id: extractor.model,
			thinkingLevel: "medium",
		});
		// sibling roles untouched
		assert.equal(eff.agent.models.researcher.thinkingLevel, FACTORY_PINS.researcher.effort);
	});

	it("resolveModelSpec is field-independent per override aspect", () => {
		assert.deepEqual(
			resolveModelSpec("labeler", { model: { provider: "other", id: "x" } }, FACTORY_PINS),
			{ provider: "other", id: "x", thinkingLevel: FACTORY_PINS.labeler.effort },
		);
		assert.deepEqual(resolveModelSpec("labeler", {}, FACTORY_PINS), {
			provider: "openrouter",
			id: FACTORY_PINS.labeler.model,
			thinkingLevel: FACTORY_PINS.labeler.effort,
		});
	});
});

describe("the graph channel gates (the wave's seam honoring)", () => {
	it("WRITE channel (extraction): dies with the master switch only", () => {
		assert.equal(extractionEnabled({ enabled: true, embedding: true, clustering: true, labeling: true }), true);
		assert.equal(extractionEnabled({ enabled: true, embedding: false, clustering: false, labeling: false }), true);
		assert.equal(extractionEnabled({ enabled: false, embedding: true, clustering: true, labeling: true }), false);
	});

	it("READ channel (graph-context): needs master AND the embedding rung", () => {
		assert.equal(graphContextEnabled({ enabled: true, embedding: true, clustering: false, labeling: false }), true);
		assert.equal(graphContextEnabled({ enabled: true, embedding: false, clustering: true, labeling: true }), false);
		assert.equal(graphContextEnabled({ enabled: false, embedding: true, clustering: true, labeling: true }), false);
	});

	it("both gates ride resolveSettings' factory defaults (all on → both open)", () => {
		const eff = resolveSettings(null, FACTORY_PINS);
		assert.equal(extractionEnabled(eff.graph), true);
		assert.equal(graphContextEnabled(eff.graph), true);
		const off = resolveSettings({ version: 1, graph: { enabled: false } }, FACTORY_PINS);
		assert.equal(extractionEnabled(off.graph), false);
		assert.equal(graphContextEnabled(off.graph), false);
	});
});