connect

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:

``bash 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:

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

1. Filter and rank per references/connecting.md:
2. Remove self
3. Remove already-linked notes
4. Remove daily notes
5. Remove low-relevance results (below 30%)

1. If candidates found, present to human (when called by orchestrator):
2. Show candidates with scores and snippets
3. Let user multi-select which to connect

1. For selected connections:
2. Add ## Related section to the note with wiki-links
3. 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)