Connect Stage

Find related notes via semantic search (qmd) and weave forward/backward links.

See references/pipeline.md for stage definitions and status flow. See references/connecting.md for the connection discovery algorithm.

Input

A routed note with status: routed.

Process

1. Check qmd availability:

   which qmd

If not available, log "Skipped connections: qmd not available", set status: connected, and return.

1. Extract query terms from the note's title and body

1. Run semantic search:

   qmd query "{terms}" -c {collection} -n 15 --json

1. Filter and rank per references/connecting.md:

• Remove self
• Remove already-linked notes
• Remove daily notes
• Remove low-relevance results (below 30%)

1. If candidates found, present to human (when called by orchestrator):

• Show candidates with scores and snippets
• Let user multi-select which to connect

1. For selected connections:

• Add ## Related section to the note with wiki-links
• Offer backlink weaving for notes that have See Also/Related/TK sections

1. Update status to connected

Output

• Note with ## Related section added (if connections found)
• status: connected

Constraints

• Graceful skip if qmd unavailable (always log that it was skipped)
• The note being processed won't be in qmd's index yet. Search FROM its content, not for it.
• Don't add connections the user didn't approve
• Backlink weaving is optional (offer, don't force)