v0.2.0 — search_judgments + prawomocny heuristic + cross-ref pass

Highlights

New MCP tool: search_judgments

FTS5-backed search over (sygnatura, sygnatura_norm, podstawa_prawna, sad). Diacritic-insensitive (unicode61 remove_diacritics=2). Polish-aware stem prefix expansion — tokens ≥5 chars ending in a Polish nominative vowel are trimmed before the *, so Warszawa finds Warszawie and apelacyjny finds apelacyjna.

input:  { query: string; instancja?: Instancja; limit?: number }
output: { query, instancja, total_returned, matches: JudgmentMatch[], disclaimer }

prawomocny heuristic

SA / SN / NSA / TK / TSUE → 1 by construction. SR / SO backfilled by cross-ref pass when an in-corpus appellate oddala references them.

Cross-reference pass

For every appellate row, scan its textContent for sygn. akt X patterns; look up the lower-court signature in the corpus and backfill uchylony_przez + prawomocny deterministically.

On v0.2.0 corpus

• 1272 judgments (2012-02-27 → 2026-05-06)
• 96 prawomocny by instance (every SA, deterministic)
• 19 prawomocny by cross-ref (SR/SO whose appeal was dismissed in-corpus)
• 0 uchylony_przez — narrow-domain expected behaviour; see README "Limity"
• DB size 1.17 MB · lookup 0.05–2.3 ms

Verification

• vitest run — 66 / 66 green
• MCP stdio JSON-RPC smoke — 7 / 7 scenarios pass (initialize, tools/list, verify_signature × FOUND/NOT_FOUND/AMBIGUOUS, search_judgments × natural query + instancja filter)

Install

Direct from GitHub release:

npm install https://github.com/woladi/sententim/releases/download/v0.2.0/sententim-0.2.0.tgz

Claude Code (after npm publish):

claude mcp add sententim -- npx sententim-mcp

npm publish status

⚠️ npm publish was attempted from the maintainer machine but the ~/.npmrc token returned 401. Publishing to the public registry is gated on a fresh auth token:

npm login                          # interactive
# or
NPM_TOKEN=<fresh> npm publish --access public --provenance=false

The package name sententim is currently unclaimed on npm (verified 2026-06-04).