mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-08-08 08:12:20 +03:00
* docs(compression): design spec for the unified compression config panel
Engine-centric central panel (single source for master + per-engine on/off + level),
default pipeline derived from the engines map; Combos page owns named ordered pipelines +
active-profile selection; per-engine pages keep only detailed config. Phased: (1) core
consolidation + Model A migration, (2) named profiles + active selector, (3) per-request
x-omniroute-compression header.
* docs(compression): Phase 1 implementation plan for the unified config panel
12 TDD tasks: engine catalog, engines map + activeComboId, deriveDefaultPlan,
migration 102 + backfill, resolveCompressionPlan, runtime wiring, API, default-combo
shim, the engine-grid panel, consolidation, menu. Ends with a recap + the pending
follow-ups (Phase 2 named profiles/active selector, Phase 3 header, deferred items).
* feat(compression): engine catalog metadata (levels, single-mode, order)
* feat(compression): add engines map + activeComboId to CompressionConfig
* feat(compression): deriveDefaultPlan (engines map -> mode/pipeline)
Pure function that converts a per-engine EngineToggle map + masterEnabled
flag into a { mode, stackedPipeline } plan: off when master is off or no
engines on; single-mode when exactly one single-mode engine is enabled;
stacked (sorted by stackPriority) otherwise.
* feat(compression): persist+backfill engines map and activeComboId (migration 102)
* feat(compression): resolveCompressionPlan precedence resolver (header>override>active>default)
* feat(compression): selectCompressionStrategy uses resolveCompressionPlan
* feat(api): settings/compression carries engines map + activeComboId
Extends compressionSettingsUpdateSchema with engines (Record<string,{enabled:boolean,level?:string}>)
and activeComboId (string|null) so the PUT route accepts and persists these fields.
GET already returns the full getCompressionSettings() object which includes both fields.
TDD: added route round-trip tests (PUT+GET) for engines, activeComboId, null clear,
and schema rejection of invalid engines shape.
* refactor(compression): default-combo route is a read-only shim (default derived from engines)
* feat(dashboard): engine-grid compression panel (single source for on/off + level)
* refactor(dashboard): remove duplicate compression toggles; per-engine pages keep only detailed config
* feat(compression): unified panel menu order + derived-pipeline integration coverage
* fix(compression): import ENGINE_IDS via types re-export so it resolves under vitest
The bare "@omniroute/open-sse/.../engineCatalog.ts" specifier resolves under tsc/tsx
but not under vitest's MCP config: Vite externalizes a brand-new open-sse module to
Node, which can't load the .ts subpath. types.ts is already in Vite's graph, so route
ENGINE_IDS through its re-export. Fixes 3 failing MCP vitest suites (cacheTools,
dbHealthTool, essentialTools).
* fix(compression): engines map drives dispatch only when explicitly panel-saved
Code-review finding: the legacy seeded default combo (present on every install via
migration 042/043) was silently overriding a panel-configured engines map — the
default-combo block in chatCore set compressionComboApplied=true, skipping the
engines-map override, so an operator's panel toggles were ignored.
Gate the engines-map path on a new runtime-only CompressionConfig.enginesExplicit
(true when a stored engines row exists). Panel-saved installs: the engines map is
authoritative (deriveDefaultPlanFromConfig + new enginesMapDerivesStackedPipeline
guard the chatCore default-combo block). Legacy/backfilled installs: the map is
display-only and dispatch stays on the historical defaultMode/default-combo path —
zero behaviour change until the operator opts in via the panel.
Also documents why resolveCacheAwareConfig's getCacheAwareStrategy(config.defaultMode)
arg is safe (skipSystemPrompt is mode-independent).
* docs(compression): add MDX frontmatter + escape inline brace to fix fumadocs build
docs/compression/**/*.md is compiled as MDX by the Next build (fumadocs,
source.config.ts). The two planning docs lacked the required `title`
frontmatter (build error: 'title: expected string, received undefined') and the
design doc had a bare {rtk,caveman} that MDX parsed as a JSX expression. Adds
frontmatter matching the sibling docs and backticks the brace. Fixes the
dast-smoke build step.
93 lines
3.6 KiB
TypeScript
93 lines
3.6 KiB
TypeScript
import { describe, it } from "node:test";
|
|
import assert from "node:assert/strict";
|
|
|
|
// Import the sidebar constants we need to verify
|
|
import {
|
|
HIDEABLE_SIDEBAR_ITEM_IDS,
|
|
COMPRESSION_CONTEXT_GROUP,
|
|
} from "../../../src/shared/constants/sidebarVisibility";
|
|
|
|
const ENGINE_IDS = [
|
|
"context-headroom",
|
|
"context-session-dedup",
|
|
"context-ccr",
|
|
"context-llmlingua",
|
|
] as const;
|
|
|
|
describe("HIDEABLE_SIDEBAR_ITEM_IDS includes all 4 engine items", () => {
|
|
for (const id of ENGINE_IDS) {
|
|
it(`includes "${id}"`, () => {
|
|
assert.ok(
|
|
(HIDEABLE_SIDEBAR_ITEM_IDS as readonly string[]).includes(id),
|
|
`Expected HIDEABLE_SIDEBAR_ITEM_IDS to include "${id}"`
|
|
);
|
|
});
|
|
}
|
|
});
|
|
|
|
describe("COMPRESSION_CONTEXT_GROUP contains all 4 engine items", () => {
|
|
const itemIds = COMPRESSION_CONTEXT_GROUP.items.map((item) => item.id);
|
|
const itemMap = new Map(COMPRESSION_CONTEXT_GROUP.items.map((item) => [item.id, item]));
|
|
|
|
for (const id of ENGINE_IDS) {
|
|
it(`contains item with id "${id}"`, () => {
|
|
assert.ok(itemIds.includes(id as (typeof itemIds)[number]), `Missing item "${id}"`);
|
|
});
|
|
}
|
|
|
|
it('headroom has href "/dashboard/context/headroom" and labelFallback "Headroom"', () => {
|
|
const item = itemMap.get("context-headroom");
|
|
assert.ok(item, "context-headroom item not found");
|
|
assert.equal(item.href, "/dashboard/context/headroom");
|
|
assert.equal(item.labelFallback, "Headroom");
|
|
});
|
|
|
|
it('session-dedup has href "/dashboard/context/session-dedup" and labelFallback "Session Dedup"', () => {
|
|
const item = itemMap.get("context-session-dedup");
|
|
assert.ok(item, "context-session-dedup item not found");
|
|
assert.equal(item.href, "/dashboard/context/session-dedup");
|
|
assert.equal(item.labelFallback, "Session Dedup");
|
|
});
|
|
|
|
it('ccr has href "/dashboard/context/ccr" and labelFallback "CCR"', () => {
|
|
const item = itemMap.get("context-ccr");
|
|
assert.ok(item, "context-ccr item not found");
|
|
assert.equal(item.href, "/dashboard/context/ccr");
|
|
assert.equal(item.labelFallback, "CCR");
|
|
});
|
|
|
|
it('llmlingua has href "/dashboard/context/llmlingua" and labelFallback "LLMLingua"', () => {
|
|
const item = itemMap.get("context-llmlingua");
|
|
assert.ok(item, "context-llmlingua item not found");
|
|
assert.equal(item.href, "/dashboard/context/llmlingua");
|
|
assert.equal(item.labelFallback, "LLMLingua");
|
|
});
|
|
|
|
it("4 engine items appear after context-rtk and before compression-studio", () => {
|
|
// Unified-panel order: Settings → Combos → per-engine pages → Studio.
|
|
const ids = itemIds as string[];
|
|
const rtkIdx = ids.indexOf("context-rtk");
|
|
const studioIdx = ids.indexOf("compression-studio");
|
|
assert.ok(rtkIdx !== -1, "context-rtk not found");
|
|
assert.ok(studioIdx !== -1, "compression-studio not found");
|
|
|
|
for (const id of ENGINE_IDS) {
|
|
const idx = ids.indexOf(id);
|
|
assert.ok(idx > rtkIdx, `${id} should appear after context-rtk`);
|
|
assert.ok(idx < studioIdx, `${id} should appear before compression-studio`);
|
|
}
|
|
});
|
|
|
|
it("group order is Settings → Combos → engines → Studio", () => {
|
|
const ids = itemIds as string[];
|
|
assert.equal(ids[0], "context-settings", "Settings must be first");
|
|
assert.equal(ids[1], "context-combos", "Combos must be second");
|
|
assert.equal(ids[ids.length - 1], "compression-studio", "Studio must be last");
|
|
// Combos precedes every per-engine page.
|
|
const combosIdx = ids.indexOf("context-combos");
|
|
for (const id of ["context-caveman", "context-rtk", ...ENGINE_IDS]) {
|
|
assert.ok(ids.indexOf(id) > combosIdx, `${id} should appear after context-combos`);
|
|
}
|
|
});
|
|
});
|