The Collaboratory Librarian
Abstract
The Macroscope Collaboratory Librarian was instantiated in early April 2026 as a catalog system for Dr. Hamilton's personal library, initially handling 1,311 books imported from BookBuddy. The system uses a polymorphic supertable design (`catalog_items` with type-specific extension tables) that was always intended to accommodate multiple media types: books, academic documents, videos, TV shows. A parallel system, the Quotes Explorer (`quotes_db`), had been built separately in late 2025 with a more mature tag architecture — normalized tag definitions, a many-to-many junction table with provenance tracking, AI-assisted bulk and conversational tagging, and a Three.js semantic explorer that visualizes tag co-occurrence as a navigable 3D topology.
This technical note documents the architectural decision to consolidate the Quotes system into the Librarian as a first-class catalog item type, to adopt the Quotes tag architecture as the universal classification backbone for all item types, to build a tiered tag enrichment pipeline modeled on the Collaboratory's existing `classify_document` worker, and to generalize the semantic explorer from a quotes-only visualization into a catalog-wide research instrument with scope filtering and external source integration.
The core insight is that a personal knowledge collection — books, papers, quotes, films — is not a set of independent inventories but a single intellectual topology. A tag like "mycorrhizal networks" should connect a book on the shelf, a quote from Suzanne Simard, an academic paper in the archive, and a Semantic Scholar result from the broader literature. The unified catalog makes this possible. The tag pipeline makes it accurate. The semantic explorer makes it navigable.
---
Keywords
- generation.
Access
AI Collaboration Disclosure
This technical note was developed collaboratively with Claude (Anthropic, claude-opus-4-6) via Cowork. Claude contributed to architectural analysis, schema design, pipeline specification, and document drafting. The author takes full responsibility for the content, accuracy, and conclusions.
Human review: fullCite This Document
BibTeX
Permanent URL: https://canemah.org/archive/document.php?id=CNL-TN-2026-051