Discovery Log

Discovery Log

Record how a paper was discovered — the optional discovery: block in a citation sidecar's frontmatter (SOURCE-TRACKING schema). The read views by-source / by-curator (#1492) consume this.

How to run

aiwg corpus discovery-log --ref REF-640 --surface x-account --via "x.com/@askalphaxiv" --curator PROF-S-askalphaxiv          # dry-run (prints the block)
aiwg corpus discovery-log --ref REF-640 --surface x-account --via "x.com/@askalphaxiv" --curator PROF-S-askalphaxiv --write  # splice into the sidecar
aiwg corpus discovery-log --ref REF-641 --surface x-search --write    # surface only, no curator

• Adds or replaces the discovery: block in the sidecar frontmatter, preserving the rest of the file. Dry-run unless --write.
• --surface (required) vocab: x-account | x-search | x-bookmarks | x-foryou | x-following | rss | newsletter | web | referral | direct.
• --curator (optional) is a PROF-S- id; set it only when the source came through a named, repeatable curator. Omit for direct/search-found papers (curator-id: null). The block is OPTIONAL by design — absence is never an error.

Distinct from radar sources-searched (surfaces queried during a freshness refresh): discovery records where a paper was originally found.

Triggers

• "log how we found REF-XXX"
• "record the discovery source for this paper"
• "set the curator for REF-XXX"
• /discovery-log

References

• @$AIWG_ROOT/src/artifacts/corpus-tools/discovery-log.ts — implementation
• curator-status / curator-init skills; @$AIWG_ROOT/agentic/code/frameworks/research-complete/docs/source-tracking.md — schema