Commit History
-
Update README.md
Verified signaturea760fd7 -
Update README.md
Verified signature88214a2 -
Update README.md
Verified signature1d1b07e
-
Create README.md
Verified signaturef096f50 -
Delete README.md
Verified signaturedaf0f87
-
fix: correct stale top_k default in README config example (50→20)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>983b709
-
feat: switch to stable workhorse models (gpt-4.1, sonnet-4-6, gemini-2.5-flash)
- OpenAI: gpt-4.1 (default), gpt-4.1-mini, gpt-4.1-nano - Anthropic: claude-sonnet-4-6 (default), claude-haiku-4-5, claude-opus-4-6 - Gemini: gemini-2.5-flash (default), gemini-2.5-pro, gemini-2.0-flash - GPT-5/reasoning restricted-param handling preserved for manual config - README config example updated to match Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>6d5b557
-
docs: add citation section with BibTeX entry to README
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>3710279 -
fix: correct README examples to match actual NAVCO 2.0 data
- 250 campaigns (not 392), 1726 campaign-years, 57 columns - Success is binary 0/1 (not 3-point 1/2/3 scale) - Column is prim_method (not viol_camp) - Year range 1945-2006 (not 1945-2014) - Nonviolent after 2000: 8 out of 16 succeeded (not 14/31) - All campaigns: 111 succeeded out of 250 (not 392) - Nonviolent: 68 of 109 succeeded (62%, not 53%) - Added note explaining 53% comes from NAVCO 1.1 via publication - Updated file references to actual filenames (NAVCO v2.0.dta, NAVCO2JPRcodebook2013.pdf) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>5c8121f -
docs: README rewrite for social science audience
- Added "Why This Template" section with comparison to ChatGPT/Perplexity - Added "Who Is This For" table (researcher, PI, grant applicant, instructor, policy org, data repository) - Added "Sample Design Logic" section with grant-proposal-ready language: defense in depth, dual retrieval, schema enrichment, over-refusal prevention, and adaptation guide - Restructured Advantages into three groups: anti-hallucination (core differentiator), research capabilities, practical benefits - Emphasized anti-hallucination stack throughout as the selling point Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>575ba26 -
fix: pre-release audit round 12 — 33 bugs fixed across all tiers
Tier 1 (ship-blockers): - README/verifier layer count corrected to 7-layer/10-point - SQL keyword regex now strips quoted strings before checking - validate_citations counts unique sources, extracts from body only - Provider-specific error messages for all 3 LLM backends - Missing config error handling in ingest.py entry point Tier 2 (quality): - SQL injection: alphanumeric validation on interpolated values - LIKE wildcard escaping with ESCAPE clause - Fallback builds fresh keyword query instead of re-running failed SQL - NaN/NaT/inf filtering across all tabular readers - Merged docx table cells deduplicated via element identity - .env double-escaping fix in setup wizard - Verification LLM exceptions skip correction instead of triggering it - References check handles SQL and web sources - Dead pre-loop validate_citations removed - KB meta extension detection uses Path.suffix - QU prompt omits SQL fields when no schema available - Redundant collection.count() eliminated - Row padding f…fbd18c8
-
docs: rewrite README with NAVCO examples and clear pipeline walkthrough
- All examples now consistently use the NAVCO 2.0 (Nonviolent and Violent Campaigns and Outcomes) dataset as a running illustration - Added detailed "How It Works: The Full Pipeline" section with Step 0-5 walkthrough, tables, and ASCII diagram - Added multi-turn conversation example showing query understanding, SQL routing, pronoun resolution, and follow-up handling - Reorganized Table of Contents with anchor links to each pipeline step - Streamlined Advantages/Limitations and Troubleshooting sections Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>1b50825 -
docs: update README to reflect all improvements since initial release
- Updated model names (GPT-4.1, Claude 4.6, Gemini 2.5) - Added query understanding to What This Does section - Documented schema enrichment (codebook detection, LLM column descriptions) - Documented column statistics (unique counts, min/max, sample values) - Documented enhanced SQL injection protection (dangerous keyword blocklist) - Documented display query (dual-query for better response quality) - Documented data integrity (leading zero preservation) - Documented markdown fence handling for LLM-generated SQL - Documented provider-specific safety filter handling (Gemini) - Documented .env merge behavior in setup wizard - Updated troubleshooting for web UI config error handling - Added smart query understanding to Advantages section Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>b602534
-
Remove processing details for NAVCO 2.0 files
LIAN, Jie/JasonUnverified signature385a823 -
Update model selection information in README
LIAN, Jie/JasonUnverified signatureRemoved model selection table and added note about model costs.ccb1d27 -
Remove Chenoweth_Stephan_2011.pdf from README
LIAN, Jie/JasonUnverified signatureb4f6dd0 -
docs: update README with KB self-awareness section and fix missing connection note
- Add "KB Self-Awareness: The Meta Overview" section explaining how the chatbot knows what it knows and can answer meta-questions - Update "What This Does", "How It Works", key design principles, and Advantages to highlight KB awareness as a core capability - Add connection note to deterministic fallback overview for multi-dataset KBs (was specified in design but missing from implementation) - Add test assertion for connection note Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>864852c -
docs: update README and docker-compose for SQL layer
- Add SQL layer section documenting structured data queries - Update "What This Does", "How It Works", config reference, and ingestion example to reflect SQL routing and dual ingestion - Add sql_db/ volume mount to docker-compose.yml - Update dataset note, advantages, and limitations sections Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>a330410 -
fix: web UI history bug + wrong query after clarification + README update
Bug 1: app_web.py included the current user message in conversation history sent to query understanding, causing the question to appear twice in the prompt. Fixed by excluding the just-appended message. Bug 2: After clarification, verify_and_respond received only the original vague query instead of the combined (original + clarification). Fixed to use the combined query, consistent with CLI behavior. README: Updated "How It Works" flow to include query understanding step. Fixed retrieval config (top_k: 5 -> 50, added max_distance: 0.55). Added query_understanding config section. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>fc60784 -
feat: retrieve all relevant chunks using distance threshold
Instead of a fixed top_k count, retrieval now uses a distance threshold (max_distance=0.55). Queries up to 50 candidates from ChromaDB, then keeps only chunks with cosine distance below the threshold. This means: - Broad queries with lots of relevant docs get many chunks - Narrow queries with few matches get only the relevant ones - Irrelevant chunks are filtered out regardless of top_k New config field: retrieval.max_distance (default 0.55) top_k now acts as the candidate pool cap (default 50) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>0bb6123 -
fix: increase top_k to 10 and remove last [N] from verification prompt
Two fixes: 1. Increased default top_k from 5 to 10. With top_k=5, short queries like "China in 2024?" missed the relevant page (e.g., page 410) because generic intro pages ranked higher. More chunks = better chance of retrieving the right content. 2. Removed the last literal [N] from the verification prompt template (checklist item 1) to prevent any residual [N] in output. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>ca19369 -
fix: correct Python version range in Prerequisites section
Prerequisites said "Python 3.11 or later" but Python 3.14+ is not supported due to ChromaDB/Pydantic dependency compatibility. Updated to "Python 3.11–3.13" to match the installation instructions in Step 2. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>9699428 -
docs: add Python environment setup step with version compatibility note
Python 3.14+ is not supported due to ChromaDB/Pydantic compatibility. Recommend conda with Python 3.12; support 3.11--3.13. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>1bc8544 -
fix: remove broken ToC link and correct ZIP download folder name
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>33529b2 -
fix: update clone URL in README to match actual repo name
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>2e78285 -
Update repository URL in README
LIAN, Jie/JasonUnverified signature1dc0738 -
fix: correct example output — deduplicate sources and cite [3] in body
[1] and [3] were the same Chenoweth & Stephan 2011 paper (local vs web). Changed [3] to Nepstad (2011) and added a body citation for it. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>e46fdf2 -
Initial commit: RAG Research Chatbot Template
Citation-verified research assistant with 6-layer anti-hallucination stack, 15 file format readers, 3 LLM providers, and dual CLI/Web interfaces. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>0017280