Version 1.7.1 Detailed Release Notes

🎵 Grateful Dead Chatbot – Version 1.7.1 Release Notes

Release Date: January 6, 2026 Plugin Version: 1.7.1 Package Size: 241 KB

What’s New in Version 1.7.1

🎵 Major Feature: Comprehensive Song Title Disambiguation System

Version 1.7.1 introduces a sophisticated disambiguation system to handle the 34 Grateful Dead original songs that share titles with songs by other artists. This ensures users always get accurate information about which version of a song is being discussed.

🚀 Key Features

1. Song Title Disambiguation

34 Grateful Dead songs now have detailed disambiguation rules

High Confusion Risk Songs (8):

The chatbot provides special handling for these commonly confused songs:

1. “Loser”Distinguishes GD’s Garcia/Hunter version from Beck’s 1993 hit

2. “Fire on the Mountain”Clarifies GD’s Hart/Hunter version vs. Marshall Tucker Band’s 1975 original

3. “Comes a Time”Differentiates GD’s Garcia/Hunter song from Neil Young’s 1978 hit

4. “Eyes of the World”Distinguishes from Fleetwood Mac and Rainbow versions

5. “Friend of the Devil”Clarifies among Bob Dylan, Tom Petty, and Mumford & Sons covers

6. “Dark Star”Differentiates from Crosby, Stills & Nash’s song

7. “Scarlet Begonias”Distinguishes from Sublime’s popular cover

8. “Candyman”Clarifies vs. Christina Aguilera’s 2007 pop hit

Additional 26 Songs with Moderate Confusion Risk:

Alabama Getaway, Althea, Bertha, Bird Song, Black Peter, Box of Rain, Brokedown Palace, Brown Eyed Women, Casey Jones, Cassidy, China Cat Sunflower, China Doll, Crazy Fingers, Days Between, Deal, Dire Wolf, Estimated Prophet, Feel Like a Stranger, Franklin’s Tower, He’s Gone, Jack Straw, Looks Like Rain, Ripple, Stella Blue, Sugar Magnolia, Sugaree

2. Smart Disambiguation Logic

✅ Default Behavior

Ambiguous song titles automatically default to the Grateful Dead version (appropriate for a GD-focused chatbot)

🧠 Context-Aware Recognition

Recognizes when users specifically ask about non-GD versions based on:

Artist names mentioned
Date references
Album context
Lyrical references

💬 Proactive Clarification

For high-confusion songs, the chatbot acknowledges other versions exist and helps users understand which version is being discussed

🔑 Key Identifiers

Each song includes: writers, first performance date, album, key lyrics, and musical style to distinguish versions

3. New Context Files

Two comprehensive disambiguation files added to the system:

📁 File 1: Detailed Guide

grateful_dead_disambiguation_guide.md

541 lines

Detailed disambiguation for all 34 songs
Full information: writers, dates, albums, key identifiers
Specific disambiguation phrases to use
Lists of other artists with same song titles

📊 File 2: Quick Reference

Grateful Dead Songs with Duplicate Titles - Summary List.md

141 lines

Quick reference table of all 34 songs
High/moderate confusion risk categorization
Songwriting partnerships summary
Key albums reference

4. Enhanced System Implementation

New Method: load_disambiguation_guides()

Automatically loads both disambiguation files into system prompt
Includes usage instructions and practical examples for the AI
Disambiguation rules inject before main knowledge base for priority handling

📊 Statistics

Songs with duplicate titles covered

17.2%

Of all GD originals (34 of 198 songs)

~682

Lines of disambiguation content

High-risk songs with special handling

Moderate-risk songs

🎯 Real-World Examples

Example 1: Ambiguous Query

User: “Tell me about Loser”

Chatbot: Discusses the Grateful Dead’s “Loser” (Garcia/Hunter, 1970), mentions Beck also has a famous song with that title

Example 2: Specific Artist Query

User: “When did Neil Young release Comes a Time?”

Chatbot: Recognizes they mean Neil Young’s version (1978), not the GD song

Example 3: Historical Context

User: “Fire on the Mountain history”

Chatbot: Clarifies the GD version (Hart/Hunter, 1977), notes Marshall Tucker Band’s version came first (1975)

🔧 Technical Details

System Prompt Enhancement

Disambiguation content is loaded in this order:

Accuracy Guardrails
Location Rules
Bahr Gallery Override
🎵 SONG TITLE DISAMBIGUATION RULES ← NEW in 1.7.1
Grateful Dead Knowledge Base

Accuracy Architecture Updated

Total disambiguated terms: 159+ (was 125+)
Total categories: 20 (was 19)
New category: “Duplicate Song Titles”

🔄 Changelog Summary

Added ✨

Comprehensive song title disambiguation system (34 songs)
grateful_dead_disambiguation_guide.md context file
Grateful Dead Songs with Duplicate Titles - Summary List.md context file
load_disambiguation_guides() method in class-claude-api.php
“Comes a Time” disambiguation to main knowledge base
Enhanced documentation in ACCURACY-SYSTEMS.html

Improved 🚀

AI understanding of songwriting partnerships
Query handling for song writers, dates, and albums
Recognition of when user asks about non-GD versions
Overall disambiguation system (159+ terms across 20 categories)

Fixed 🐛

Potential misattribution of duplicate song titles
Ambiguity in responses about songs with same titles as other artists

🎸 About This Release

Version 1.7.1 represents a significant enhancement to the chatbot’s accuracy and usability. By addressing the challenge of duplicate song titles, we ensure users receive clear, unambiguous information about Grateful Dead songs while acknowledging the broader musical landscape.

The disambiguation system was carefully researched, covering 17.2% of all Grateful Dead original compositions – a substantial portion of their catalog that shares titles with other artists’ works. This release demonstrates our ongoing commitment to accuracy, user experience, and comprehensive Grateful Dead knowledge.