homelab-codex-ws/services/kb-query/tests/frontend/app.test.js

50 lines
2.2 KiB
JavaScript
Raw Normal View History

feat(kb-query): add search frontend (module 5 phase 4, plan §7, Krok 4) Krok 4 of the phase-4 plan done ahead of the local-embed-fallback step (Krok 2, deliberately deferred -- embed stays a plain SOLARIA call, per task instruction): one FastAPI process now serves both the /search API and the UI, no separate frontend build (plan §2 decision 4). - GET / renders a Jinja2 shell; app/static/app.js (vanilla, no build) and style.css are the whole client. Query -> /search, results grouped by envelope_id client-side (chunks sorted by dist, <details> fragments). - Colour thresholds per plan §7: dist<0.45 green, 0.45-0.55 yellow (still shown with a warning), >0.55 never rendered as an individual result; if a query ends up with nothing renderable, one "Brak odpowiedzi w KB" message replaces the list, carrying the best observed dist. - Paperless hits link out; gmail hits get a "kopiuj Message-ID" button (there's nothing to link to yet, plan §2 decision 3) plus header metadata. Cascade/flat toggle defaults to cascade. Footer shows sol_status, refreshed from /healthz on load and after each search. - /search gained additive summary/summary_tags fields (document_summary, haiku track) so the UI can show a document summary as each result group's header -- non-breaking, existing response shape untouched. - Tests: app/db.py + app/search.py unit tests (mocked DB/HTTP, no live deps) cover the new summary join; tests/test_frontend.py drives GET / and /static/* via TestClient without running the DB-requiring lifespan; tests/frontend/app.test.js (Node's built-in test runner, no framework) covers query-URL encoding, threshold colouring, and envelope grouping. - Verified live: docker build + container against kb-postgres@PIHA over LAN and Ollama@SOLARIA over Tailscale -- GET / (HTML), /static/app.js, /healthz, and /search (cascade + flat) all round-tripped correctly, including real summary/summary_tags data. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-22 16:39:46 +02:00
// Pure-function tests for app/static/app.js -- module 5 phase 4 §7 DoD: "test that frontend-JS
// correctly encodes the query" (no browser needed; the module guards its DOM-touching init()
// behind a `document`-only branch, so requiring it under plain Node is safe -- see the
// `typeof module` check at the bottom of app.js).
'use strict';
const test = require('node:test');
const assert = require('node:assert/strict');
const path = require('node:path');
const { buildSearchUrl, groupResults, distClass } = require(
path.join(__dirname, '..', '..', 'app', 'static', 'app.js')
);
test('buildSearchUrl percent-encodes special characters in the query', () => {
const url = buildSearchUrl('polisa OC & AC?', 'cascade');
assert.equal(url, '/search?q=polisa+OC+%26+AC%3F&mode=cascade');
});
test('buildSearchUrl encodes Polish diacritics', () => {
const url = buildSearchUrl('faktura zażółć', 'cascade');
assert.equal(url, '/search?q=faktura+za%C5%BC%C3%B3%C5%82%C4%87&mode=cascade');
});
test('buildSearchUrl carries mode=flat through untouched', () => {
const url = buildSearchUrl('faktura', 'flat');
assert.equal(url, '/search?q=faktura&mode=flat');
});
test('distClass applies the phase-3 thresholds (green <0.45, yellow 0.45-0.55, red >0.55)', () => {
assert.equal(distClass(0.1), 'dist-green');
assert.equal(distClass(0.449), 'dist-green');
assert.equal(distClass(0.45), 'dist-yellow');
assert.equal(distClass(0.55), 'dist-yellow');
assert.equal(distClass(0.551), 'dist-red');
});
test('groupResults groups chunks by envelope_id and sorts each group by dist', () => {
const results = [
{ envelope_id: 'paperless:1', source: 'paperless', dist: 0.4, chunk_index: 1, text: 'b', summary: 'S', summary_tags: [], link: 'https://x' },
{ envelope_id: 'paperless:1', source: 'paperless', dist: 0.2, chunk_index: 0, text: 'a', summary: 'S', summary_tags: [], link: 'https://x' },
{ envelope_id: 'gmail:1', source: 'gmail', dist: 0.3, chunk_index: 0, text: 'c', summary: null, summary_tags: [] },
];
const groups = groupResults(results);
assert.equal(groups.length, 2);
assert.equal(groups[0].envelopeId, 'paperless:1');
assert.deepEqual(groups[0].chunks.map((c) => c.chunk_index), [0, 1]);
assert.equal(groups[1].envelopeId, 'gmail:1');
});