Skip to content

ENG-432: Build bibliography database with live linking#80

Open
madeleinesong wants to merge 5 commits intomainfrom
eng-432-bibliography-database-live-linking
Open

ENG-432: Build bibliography database with live linking#80
madeleinesong wants to merge 5 commits intomainfrom
eng-432-bibliography-database-live-linking

Conversation

@madeleinesong
Copy link
Copy Markdown
Collaborator

Summary

  • Adds a persistent JSON-backed bibliography database (BibliographyDB) that tracks read/cited/relevant status per reference, citation network links, and verification state
  • Provides query functions (search, filter_by_status, filter_by_tag, filter_by_phase, lookup_by_arxiv, lookup_by_doi) for literature review and writing workflows
  • Updates the bibliographer agent to check the database for duplicates before adding citations and persist verification results
  • Updates the literature reviewer agent with instructions to load/update the database during reviews
  • Updates the bibliography template to document the database-backed workflow (version 2)
  • Exports all new types from the paper package __init__.py

Test plan

  • 54 new tests in tests/test_bibliography_db.py covering persistence, entry management, status tracking, live linking, queries, statistics, and export
  • All 93 bibliography-related tests pass (39 existing + 54 new)
  • Pre-existing test failure in test_paper_compiler_regressions.py is unrelated (also fails on main)

Closes ENG-432

🤖 Generated with Claude Code

JSON-backed BibliographyDB that tracks read/cited/relevant status per
reference, supports citation network linking, and provides query functions
for literature review and writing workflows. Includes 54 tests covering
persistence, entry management, status tracking, live linking, queries,
statistics, and export to CitationSource.
Adds BibEntry, BibliographyDB, BibliographyDBStats, ReadStatus,
RelevanceLevel, VerificationStatus, load_bibliography_db, and
save_bibliography_db to the paper package's public API.
Template now references the persistent bibliography-db.json file and
documents how each agent (bibliographer, literature-reviewer, paper-writer,
referee) interacts with the database through its query and update APIs.
Bumps template_version to 2.
Adds bibliography database documentation to the agent's file protocol,
citation workflow, and locate_bibliography steps. The agent now checks
the database for duplicates before adding citations and persists all
verification results to bibliography-db.json.
…on (ENG-432)

Adds a bibliography_database section documenting how the literature
reviewer should check the database before starting a review, update
entries during the review, and record citation/related links between
surveyed papers.
@madeleinesong madeleinesong force-pushed the eng-432-bibliography-database-live-linking branch from 08999fd to 514e38e Compare April 6, 2026 17:05
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