connect

/connect

Intent. Take a note that exists but is poorly connected, and integrate it into the graph. Add inline [[wikilinks]] in its body where genuine connections exist; add inverse links from connected notes back to it; update MOC membership both ways.

When to invoke

• Just after /extract (composed by /learn)
• When you realise an old claim should link to newly-added work (use --bulk with a date-filtered glob)
• When /audit flags a note as orphaned

Behaviour

Forward pass — add links from this note to others

1. Read the target note: title, description, frontmatter, body.
2. Discover candidates via two channels in parallel:
   • Semantic search: qmd query with intent = the note's description, types lex and vec. Return top ~30 candidates.
   • Frontmatter walk: read the note's tags, methods, topics, supports, contradicts arrays. Walk those notes; collect their tags + neighbours (one hop).
3. Filter candidates. A connection is genuine when:
   • The target note's claim requires, follows from, qualifies, contradicts, or exemplifies the candidate
   • Or: the candidate is a method used in the target's evidence chain
   • Or: the candidate is a paper sourcing the target
   • Not genuine: "they share a topic", "they sound related", "they were co-extracted from the same source" (sibling-only)
4. Add inline [[wikilinks]] in the body where genuine connections fit, with surrounding prose explaining the relationship. Avoid bare-link lists — context phrases prefix every link.
5. Update structured frontmatter where the connection has a typed slot: supports, contradicts, methods arrays gain entries.

Backward pass — add links from others to this note

1. For each connected note from step 4: read it. Decide whether the inverse link belongs in its body. If yes, add it (with surrounding prose).
2. Update structured frontmatter on the connected notes if applicable (e.g. paper notes get the new claim in their claims: list — though /extract may have done this already).