homelab-codex-ws/services/kb-query/tests/frontend/app.test.js
oskar a73a986bbe 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:49:36 +02:00

50 lines
2.2 KiB
JavaScript

// 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');
});