Interview-ready pass: pin deps, fix stranded demo link, real eval numbers, CI - #1
Open
Ragh234 wants to merge 1 commit into
Open
Interview-ready pass: pin deps, fix stranded demo link, real eval numbers, CI#1Ragh234 wants to merge 1 commit into
Ragh234 wants to merge 1 commit into
Conversation
- requirements.txt was fully unpinned (13 deps including 6 tree-sitter grammar packages) -- this repo has a live Streamlit deployment, and an unpinned rebuild against a new tree-sitter core release is exactly what would take it down. Pinned to a verified-installable set. - The deployed Streamlit link was stranded mid-sentence inside the "How This Differs" section, between two code fences. Moved to a Live demo line under the title where it's actually visible. - Added a real Evaluation results table. The README described the harness (Hit Rate/Recall/Precision/MRR across 5 retrieval strategies) but never showed output. Ran it and added the table -- and reported it honestly: hybrid retrieval clearly beats either single-strategy baseline, but graph expansion and reranking don't show a measurable win on the current 5-question eval set. - MIT LICENSE, CI running the full test suite (all local -- FastEmbed embeddings, no API key needed). Verified: pytest -> 21 passed. python -m evaluation.run_evaluation -> the numbers now in the README's Evaluation section.
Ragh234
force-pushed
the
chore/interview-ready
branch
from
September 6, 2026 10:18
ca0ea0f to
8210680
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This repo's README was already detailed and technically credible, so the changes here are narrow — finishing touches, not a rewrite.
What changed
requirements.txt. All 13 deps were unpinned, including 6tree-sitter-*grammar packages, which are exactly the kind of dependency that breaks against a newtree-sittercore release. This repo has a live Streamlit deployment; an unpinned rebuild is what would take it down.LICENSE, CI running the full test suite (all local — FastEmbed embeddings, no API key needed).Verification
(3
test_vector_store.pycases failed locally on a Windows-specific temp-directory permission conflict in my sandbox, unrelated to this repo's code — re-running with--basetemppointed at a writable directory gave the clean 21/21 above. Not expected to occur on GitHub's Linux runners.)Deliberately not changed
No architecture or feature changes.
evaluation/run_evaluation.py's 5-question dataset is small enough that reranking's effect isn't distinguishable from noise — noted in the README as a natural next step rather than "fixed" by inflating the dataset myself.