Skip to content

StyleGallery 0.1.12: one stylegallery CLI with BM25F search, Korean aliases, section reads, and a retrieval gate - #60

Merged
changeroa merged 7 commits into
mainfrom
feat/search-0112
Oct 19, 2026
Merged

changeroa merged 7 commits into
mainfrom
feat/search-0112

Conversation

@changeroa

Copy link
Copy Markdown
Owner

What

  • CLI: stylegallery is the only command: search, read (--outline, --section), context, resolve, claims, discover, retrieve, help/--help, version/--version. The sg bin is removed (it collides with ast-grep). sg-material, stylegallery-material, and stylegallery-material-mcp print a rename notice and delegate in 0.1.12 only. stylegallery-mcp gains search and read tools.
  • Search v3: BM25F over title, aliases, description, questions, path, headings, and body. Hangul 2-grams come only from Korean aliases, questions, and titles. Adds an optional query_en. Readable ids sg:<domain>/<slug> (hash ids in --detailed). Schema 3.0 results carry a verbatim snippet and the next read command. Offline and deterministic, no embeddings.
  • Metadata: frontmatter aliases and questions for all 46 patterns (through pattern-data and the generator) and 29 other docs.
  • Eval: 75 questions (19 Korean or mixed, 19 must-pass, 15 held out from alias writing).
  • CI: search-eval.yml runs the search tests and search-eval.mjs --gate.
  • Release: version 0.1.12, log entry, regenerated material registry and extension inventories.

Scores (legacy ranker on the original corpus -> search v3)

before after
Hit@3 0.573 0.933
Hit@5 0.613 0.973
MRR 0.510 0.876
nDCG@5 0.482 0.863
must-pass 14/19 19/19
Korean Hit@5 0.105 1.000
held-out Hit@5 0.533 0.867

The aliases were written with the first 60 questions in view, so those scores are optimistic. The 15 held-out questions are the honest measure.

consumer_reference: not_applicable (retrieval tooling and search metadata; no consumer-reference record is selected)

iyen added 7 commits October 19, 2026 15:58
…version

Drop the sg bin (it collides with ast-grep). sg-material, stylegallery-material,
and stylegallery-material-mcp print a rename notice and delegate for 0.1.12.
The main MCP server gains search and read tools.
…eline

Hit@3/5, MRR, nDCG@5, and a must-pass gate. Baseline (legacy ranker):
Hit@5 0.633, nDCG@5 0.517, must-pass 14/19, Korean Hit@5 0.133.
Pattern aliases live in scripts/pattern-data.mjs and generate into pattern docs;
hand-written recipes, guides, motion, design-engineering, platform, and expression
docs carry them directly. Add 15 held-out questions written after the aliases and
re-record the pre-change baseline on the original corpus (75 questions).
…ery_en

Light -ing/-ed stemming, section-local snippets, and documented field weights.
After: Hit@5 0.973, nDCG@5 0.863, must-pass 19/19, Korean Hit@5 1.0,
held-out Hit@5 0.867.
…l gate

search-eval.yml runs the search tests and search-eval --gate on every pull
request: every must-pass question in the top 5, Hit@5 and nDCG@5 within 0.02
of eval/search/scores.json. A Korean 2-gram-only match needs half the query's
2-grams. The v1 documentation baseline records the renamed commands.
@changeroa
changeroa merged commit d207417 into main Oct 19, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant