Second Brain documentation

ADR 0100 – Copier le lien d'un nœud

Accepté (2026-10-17, vague 3 du document d'idées)

← Toutes les décisions

ADR 0100 – Copier le lien d’un nœud

Statut : Accepté (2026-10-17, vague 3 du document d’idées)

Pour coller un nœud dans un courriel, un chat ou une autre note, il faut une adresse stable et, pour une note Markdown, un lien prêt à l’emploi.

Décision

  • URL stable : l’adresse de la fiche, <origine>/nodes/<id>. Elle ne dépend ni de l’onglet, ni de la session, ni du titre (qui peut changer). Aucun nouvel endpoint, aucun état serveur.
  • Lien Markdown : [Titre](url). Les crochets et barres obliques inverses du titre sont échappés, les espaces multiples réduits, un titre vide devient « Nœud » ; une parenthèse fermante de l’URL est encodée.
  • Points d’entrée : le menu de l’onglet (bouton « ⋯ », clic droit ou touche Menu : « Copier le lien », « Copier le lien Markdown ») et la palette Ctrl+K, qui propose les deux commandes pour le nœud affiché (saisie vide, ou « copier », « lien », « markdown »).
  • Confirmation et repli : la copie passe par l’API asynchrone du presse-papiers, puis par execCommand('copy') ; une confirmation discrète (« Lien copié », 2,5 s) s’affiche dans la barre de messages existante. Si les deux sont refusés, une boîte native présélectionne le lien pour une copie au clavier.
  • Logique pure dans core/links/node-link.ts (URL, Markdown, copie) ; aucun nom de type ni d’aspect.

Alternatives écartées

  • Lien wiki [[Titre]] : propre à cette application, inutilisable ailleurs ; le lien Markdown fonctionne partout.
  • Lien court : demanderait une table et un endpoint pour un gain minime.