4658089e21
126 plikow (md, yaml, sh, py) odwolywalo sie do sciezek sprzed migracji.
15 markdown-linkow [..](..) -> policzona sciezka WZGLEDNA wobec pliku
odsylajacego (wczesniej czesc z nich byla repo-root-relative i nie
rozwiazywala sie z katalogu, w ktorym lezala)
200 odwolan tekstowych (backticki, proza, yaml, importy w kodzie)
-> nowa sciezka repo-root-relative, zgodnie z konwencja repo
5 linkow rodzenstwa (gole nazwy plikow, np. "](DEPLOY.md)") — dzialaly
tylko w starym katalogu; przeliczone recznie
Objete m.in.: CLAUDE.md (scripts/onboard/README.md -> kb/runbooks/
node-onboarding-tool.md, docs/backlog.md -> kb/phases/backlog.md),
README.md, .claude/skills/, 20 session logow, kod jobow.
Ostatnie 5 odwolan pochodzi z tresci wciagnietej rebasem z origin/master
(session log 2026-07-31, override node-agenta na SOLARII, dwie pozycje
backlogu) — wskazywaly na docs/incidents/, docs/kb/modules/ i
services/narty27/README.md sprzed migracji.
Dodany wzajemny link miedzy kb/services/control-plane.md (stub kodu)
a kb/subsystems/control-plane.md (opis, deprecated) — dwa dokumenty o tym
samym systemie, latwe do pomylenia.
Weryfikacja na 790 plikach: 0 odwolan do starych sciezek,
0 martwych linkow markdown. Lint OKF: 190/190 plikow ZGODNE.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
74 lines
3.2 KiB
Python
74 lines
3.2 KiB
Python
"""`/search` core -- module 5 phase 4 (kb/phases/kb-m5-faza4.md §4). Kept decoupled
|
|
from FastAPI so it can be unit-tested with fake `conn`/`session`/`router` objects, the same
|
|
style as `kb_retrieval`'s own tests, instead of needing a live DB/Ollama behind a TestClient.
|
|
|
|
Response shape (plan §4 exactly): `{"query", "mode", "sol_status", "results": [...]}`, each
|
|
result carrying `dist` un-filtered -- the 0.45/0.55 colour thresholds (plan §7) are a frontend
|
|
concern (Krok 4, out of this step's scope), never applied server-side.
|
|
|
|
`summary`/`summary_tags` (document_summary, haiku track) are an additive field added in Krok 4
|
|
for the frontend's per-envelope result header (plan §7) -- `None`/`[]` when the envelope has no
|
|
summary for `summary_model` yet.
|
|
|
|
Krok 2 (aktywny fallback, plan §5): the query embedding no longer happens inside
|
|
`kb_retrieval.cascade_query`/`flat_query`/`hybrid_query` -- it goes through
|
|
`app.embed_router.EmbedRouter` (SOLARIA primary -> PIHA fallback state machine) and the
|
|
resulting vector feeds the same `*_retrieve` functions those wrappers call. Two additive
|
|
consequences for the response: `sol_status` now reports the router's real world view ("down"
|
|
while serving from the fallback -- the frontend already renders that as "offline (fallback
|
|
embed)"), and `embed_backend` names which backend actually embedded THIS query (task spec:
|
|
needed to debug result quality per backend).
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import aiohttp
|
|
import asyncpg
|
|
|
|
from kb_retrieval.embed import _vector_literal # same private-import convention as kb_retrieval.retrieval
|
|
from kb_retrieval.retrieval import cascade_retrieve, flat_retrieve, hybrid_retrieve
|
|
|
|
from app.db import fetch_envelopes, fetch_summaries
|
|
from app.embed_router import EmbedRouter
|
|
from app.links import build_result
|
|
|
|
|
|
async def run_search(
|
|
conn: asyncpg.Connection,
|
|
session: aiohttp.ClientSession,
|
|
router: EmbedRouter,
|
|
query_text: str,
|
|
mode: str,
|
|
summary_model: str,
|
|
) -> dict:
|
|
embedding, backend = await router.embed(session, query_text)
|
|
query_vector = _vector_literal(embedding)
|
|
|
|
if mode == "flat":
|
|
chunks = await flat_retrieve(conn, query_vector)
|
|
elif mode == "hybrid":
|
|
chunks = (await hybrid_retrieve(conn, query_vector, summary_model))["chunks"]
|
|
else:
|
|
chunks = (await cascade_retrieve(conn, query_vector, summary_model))["chunks"]
|
|
|
|
envelope_ids = sorted({c["envelope_id"] for c in chunks})
|
|
envelopes = await fetch_envelopes(conn, envelope_ids)
|
|
summaries = await fetch_summaries(conn, envelope_ids, summary_model)
|
|
|
|
results = []
|
|
for chunk in chunks:
|
|
result = build_result(chunk, envelopes.get(chunk["envelope_id"]))
|
|
summary = summaries.get(chunk["envelope_id"])
|
|
result["summary"] = summary["summary"] if summary else None
|
|
result["summary_tags"] = summary["tags"] if summary else []
|
|
results.append(result)
|
|
|
|
return {
|
|
"query": query_text,
|
|
"mode": mode,
|
|
# "up" iff the primary (SOLARIA) embedded this very query -- the fallback path
|
|
# implies the router just observed the primary down (probe or mid-embed failure).
|
|
"sol_status": "up" if backend == router.primary.name else "down",
|
|
"embed_backend": backend,
|
|
"results": results,
|
|
}
|