From 64b4025e7a4d606f7d335c0b93582738aea95a15 Mon Sep 17 00:00:00 2001 From: GeneAI Date: Fri, 1 May 2026 05:18:00 -0400 Subject: [PATCH] =?UTF-8?q?release:=20v0.10.0=20=E2=80=94=20template=20ali?= =?UTF-8?q?ases=20to=20close=20stemmer-induced=20retrieval=20gaps?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Snowball stemmer maps "planning" -> "plann" and never strips "-ness", which left attune-rag's KeywordRetriever unable to match queries like "plan a feature" against tool-planning.md or "staleness" against tool-doc-audit.md. The retriever already weights template-frontmatter aliases (1.5x), so adding targeted aliases is the documented mechanism for closing these gaps without touching the retriever or stemmer. Templates updated ----------------- - concepts/tool-planning.md - concepts/tool-bug-predict.md - concepts/tool-fix-test.md - references/tool-deep-review.md - references/tool-doc-audit.md Each gains an aliases: list covering the natural-language phrasings that the stemmer's behavior excluded — e.g. "plan a feature", "sprint planning", "stale documentation", "PR review before merging". Result: 9 previously-failing golden retrieval tests now pass; full attune-help suite stays green at 246 tests. No code changes. Co-Authored-By: Claude Sonnet 4.6 --- pyproject.toml | 2 +- src/attune_help/templates/concepts/tool-bug-predict.md | 1 + src/attune_help/templates/concepts/tool-fix-test.md | 1 + src/attune_help/templates/concepts/tool-planning.md | 1 + src/attune_help/templates/references/tool-deep-review.md | 1 + src/attune_help/templates/references/tool-doc-audit.md | 1 + uv.lock | 2 +- 7 files changed, 7 insertions(+), 2 deletions(-) diff --git a/pyproject.toml b/pyproject.toml index 4c6ce4d..4308c78 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "attune-help" -version = "0.9.1" +version = "0.10.0" description = "Lightweight help runtime with progressive depth and audience adaptation." readme = {file = "README.md", content-type = "text/markdown"} requires-python = ">=3.10" diff --git a/src/attune_help/templates/concepts/tool-bug-predict.md b/src/attune_help/templates/concepts/tool-bug-predict.md index d737ec2..488fbfa 100644 --- a/src/attune_help/templates/concepts/tool-bug-predict.md +++ b/src/attune_help/templates/concepts/tool-bug-predict.md @@ -2,6 +2,7 @@ type: concept name: tool-bug-predict tags: [security, bugs, scanning] +aliases: [risky code changes, identify files that break, runtime errors, spot bugs before deploy, risk assessment] source: plugin/skills/bug-predict/SKILL.md --- diff --git a/src/attune_help/templates/concepts/tool-fix-test.md b/src/attune_help/templates/concepts/tool-fix-test.md index c39f4f5..b32fb2d 100644 --- a/src/attune_help/templates/concepts/tool-fix-test.md +++ b/src/attune_help/templates/concepts/tool-fix-test.md @@ -2,6 +2,7 @@ type: concept name: tool-fix-test tags: [testing, debugging, fixes] +aliases: [CI pipeline failing, failing CI build, ci failure, fix failing pipeline, broken pipeline tests] source: plugin/skills/fix-test/SKILL.md --- diff --git a/src/attune_help/templates/concepts/tool-planning.md b/src/attune_help/templates/concepts/tool-planning.md index 8eae04b..094a54e 100644 --- a/src/attune_help/templates/concepts/tool-planning.md +++ b/src/attune_help/templates/concepts/tool-planning.md @@ -2,6 +2,7 @@ type: concept name: tool-planning tags: [planning, architecture, design] +aliases: [plan a feature, architect a feature, design new feature, sprint planning, scope work tasks, feature roadmap] source: plugin/skills/planning/SKILL.md --- diff --git a/src/attune_help/templates/references/tool-deep-review.md b/src/attune_help/templates/references/tool-deep-review.md index 20c6c1f..97ed597 100644 --- a/src/attune_help/templates/references/tool-deep-review.md +++ b/src/attune_help/templates/references/tool-deep-review.md @@ -4,6 +4,7 @@ subtype: tabular name: tool-deep-review category: tool tags: [mcp, tool, workflow] +aliases: [end-to-end review, PR review before merging, comprehensive code review, thorough review, deep dive review] source: src/attune/mcp/tool_schemas.py --- diff --git a/src/attune_help/templates/references/tool-doc-audit.md b/src/attune_help/templates/references/tool-doc-audit.md index 50ec6ea..5d124ff 100644 --- a/src/attune_help/templates/references/tool-doc-audit.md +++ b/src/attune_help/templates/references/tool-doc-audit.md @@ -4,6 +4,7 @@ subtype: tabular name: tool-doc-audit category: tool tags: [mcp, tool, workflow] +aliases: [stale documentation, stale docs, outdated documentation, find stale docs] source: src/attune/mcp/tool_schemas.py --- diff --git a/uv.lock b/uv.lock index b47815b..05df9f0 100644 --- a/uv.lock +++ b/uv.lock @@ -36,7 +36,7 @@ wheels = [ [[package]] name = "attune-help" -version = "0.9.0" +version = "0.10.0" source = { editable = "." } dependencies = [ { name = "python-frontmatter" },