:PROPERTIES:
:ID:       72ae9cc3-a79b-462f-ba66-8c4255ead6d2
:CREATED:  [2026-04-07 Tue 12:57]
:EDITED:   [2026-04-07 Tue 13:42]
:END:
#+TITLE: PROJECT: Zotero Org Import Tool (Universal Literate Note)
#+STARTUP: content
#+FILETAGS: :research:zettelkasten:zotero:import:psf:

* Overview
The *Zotero Org Import Tool* is a "makeshift" utility designed to bridge the gap between academic research management (Zotero) and the personal knowledge base (Org-mode). It focuses on two critical priorities: accurate linking to academic PDFs and creating persistent web snapshots for bookmarks.

* Phase A: Demand (PRD)
:PROPERTIES:
:STATUS: FROZEN
:END:

** 1. Purpose
Define the requirements for a high-fidelity import of research artifacts from Zotero to Org-mode.

** 2. User Needs
- *BibTeX/JSON Parsing:* Ingest Zotero libraries via standard export formats.
- *Attachment Linking:* Maintain durable links to local PDF attachments.
- *Web Persistence:* Generate local or service-based snapshots of imported URLs.
- *Org-Native Schema:* Map Zotero metadata fields to appropriate Org properties.

** 3. Success Criteria
*** TODO Successful parsing of Zotero JSON export
*** TODO Verification of direct PDF file links in Org headlines
*** TODO Snapshot generation for at least one web bookmark
*** TODO Automated :CREATED: property injection based on Zotero "Date Added"

* Phase B: Blueprint (PROTOCOL)
:PROPERTIES:
:STATUS: SIGNED
:END:

** 1. Architectural Intent
Interfaces for data transformation and snapshot retrieval. Source of truth is the Zotero SQLite database/export and the local filesystem.

** 2. Semantic Interfaces
#+begin_src bash
(defun zotero-import-library (export-path)
  "Parses the export and appends new entries to library.org.")

(defun zotero-resolve-attachment (zotero-key)
  "Locates the physical PDF associated with a Zotero record.")
#+end_src

* Phase D: Build (Implementation)
Current implementation status is "Demand Phase." Placeholder for future Lisp/Python logic.

* Phase E: Chaos (Verification)
Verification involves importing a test collection and ensuring all PDFs are openable and all web links have valid snapshots.
