b1b6692382
Eval na pelnym korpusie 2026-08-06 (187 025 zembedowanych chunkow mailowych
w HNSW) dal PASS: kryterium 1 (regresja paperless) bez degradacji zadnego
istniejacego hitu we flat ani w hybrid, mailowe hit@3 5/5. Koszt hybrydy to
jedno dodatkowe zapytanie SQL na wyszukiwanie. Surowe wyniki:
eval-http-2026-08-06.json / eval-direct-2026-08-06.json w ~/kb/mail/ingest-logs
na PIHA (niecommitowane, artefakt runu).
- app/main.py: Query("cascade") -> Query("hybrid"); pattern bez zmian, wiec
jawne ?mode=cascade i ?mode=flat dzialaja dokladnie jak dotad.
- app/static/app.js: przy odznaczonym "tryb flat (debug)" UI nie wysyla juz
parametru mode w ogole -- dziedziczy default API. Default zdefiniowany
w jednym miejscu (serwer), nie zduplikowany w JS.
- testy: nowa klasa TestSearchEndpointModeDefault (TestClient bez lifespan,
fake pool/router) sprawdza kontrakt HTTP -- brak mode => tor hybrid
(weryfikowany po obecnosci koperty gmail osiagalnej wylacznie galezia
hybrid, nie po samej etykiecie), jawne mode=flat / mode=cascade => stare
tory, nieznany mode => 422. Frontend: buildSearchUrl pomija mode gdy brak.
- docs: kb/services/kb-query.md (tabela trybow + endpoint + przyklad
odpowiedzi + opis przelacznika w UI), env.example/service.yaml (komentarze
SUMMARY_MODEL; default mode nie jest konfigurowalny przez env),
kb/phases/kb-m5-faza-mailowa.md (DoD (d) SPELNIONE 2026-08-06 + wzmianki
w Kroku 3, Wyniku bramki, decyzjach Etapu B i tabeli planu).
Weryfikacja: pytest services/kb-query -> 46 passed; node --test
tests/frontend/app.test.js -> 6/6; docker build OK + smoke run (uvicorn
startuje, bez KB_DSN swiadomie konczy sie RuntimeError z env.example).
Deploy NIE wykonany -- operator wdraza z mastera na PIHA po mergu.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
57 lines
2.6 KiB
JavaScript
57 lines
2.6 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');
|
|
});
|
|
|
|
// Toggle unchecked (the normal case) sends no mode at all -- the UI inherits the API
|
|
// default (hybrid since 2026-08-06), instead of pinning a second copy of it in JS.
|
|
test('buildSearchUrl omits mode entirely when none is given', () => {
|
|
assert.equal(buildSearchUrl('faktura', null), '/search?q=faktura');
|
|
assert.equal(buildSearchUrl('faktura'), '/search?q=faktura');
|
|
});
|
|
|
|
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');
|
|
});
|