Changeset 0.17.3 (#78)

docs/ARCHITECTURE.md

@@ -94,8 +94,15 @@ These invariants keep the workflow path open without building it prematurely:
 - **Channels**: Don't assume single-owner. If touching channel queries, keep
   room for `team_id`, `type` (beyond `direct`), and multi-participant access
   patterns alongside `user_id`.
-- **Notes**: Currently user-scoped. Future channel-scoped notes (attached to
-  a conversation, not a personal notebook) need a `channel_id` FK option.
+- **Notes**: User-scoped with `[[wikilink]]` bi-directional linking (v0.17.3).
+  The `note_links` junction table tracks directed edges between notes, with
+  `target_note_id` nullable for dangling links (unresolved references). Links
+  are extracted from content on save via regex, resolved by title match, and
+  re-resolved when new notes are created. The graph endpoint returns all nodes,
+  edges, and unresolved links for Canvas-based force-directed visualization.
+  Future channel-scoped notes (attached to a conversation) need a `channel_id`
+  FK option. `source_message_id` enables jump-to-source provenance from notes
+  back to the originating chat message.
 - **Personas**: Already team-scoped. Don't couple to "user picks from dropdown"
   — a workflow stage references a persona programmatically.
 - **Tool ExecutionContext**: Already carries `UserID` + `ChannelID`. Will need
@@ -153,9 +160,10 @@ server/
 │   ├── presets.go             # Persona CRUD (all scopes)
 │   ├── apiconfigs.go          # User provider config CRUD (BYOK)
 │   ├── teams.go               # Team management
-│   ├── notes.go               # Notes CRUD + search
+│   ├── notes.go               # Notes CRUD + search + graph + backlinks
 │   ├── knowledge.go           # Knowledge base management
 │   └── ...
+├── notelinks/                 # Wikilink extraction (regex → NoteLink structs)
 ├── knowledge/                 # KB chunking, embedding, search
 ├── providers/                 # LLM provider adapters
 │   ├── provider.go            # Provider interface
@@ -257,7 +265,8 @@ src/
 │   ├── settings-handlers.js    # User settings CRUD, command palette
 │   ├── tokens.js               # Input token counting + context budget
 │   ├── attachments.js          # File upload, paste-to-file, lightbox
-│   ├── notes.js                # Notes panel CRUD
+│   ├── notes.js                # Notes panel CRUD + graph + daily notes
+│   ├── note-graph.js           # Canvas force-directed graph visualization
 │   ├── knowledge.js            # Knowledge base UI
 │   └── __tests__/              # Node.js test suite (node --test)
 ├── editor/                     # CM6 source (compiled at build time)
@@ -267,7 +276,9 @@ src/
 │   ├── index.mjs               # Bundle entrypoint (window.CM)
 │   ├── chat-input.mjs          # Chat input factory (markdown, code blocks)
 │   ├── code-editor.mjs         # Code editor factory (syntax, keybindings)
-│   └── theme.mjs               # Switchboard + chat input themes
+│   ├── note-editor.mjs         # Note editor factory (markdown + wikilinks)
+│   ├── wikilink.mjs            # CM6 wikilink extension (parse, decorate, autocomplete)
+│   └── theme.mjs               # Switchboard + chat input + note editor themes
 └── vendor/                     # Vendored libraries (local + CDN fallback)
     ├── marked/                 # Markdown renderer
     ├── purify/                 # DOMPurify (XSS protection)
@@ -279,12 +290,14 @@ src/
 
 ### CM6 Integration
 
-The CodeMirror 6 bundle provides two factory functions exposed on `window.CM`:
+The CodeMirror 6 bundle provides three factory functions exposed on `window.CM`:
 
 **`CM.chatInput(target, opts)`** — Markdown-mode editor for the chat input area. Features: auto-growing height, Enter=send / Shift+Enter=newline, WYSIWYG fenced code block decorations (visual container with monospace font and accent border), inline code shortcut (Ctrl/Cmd+E), spell check. Always uses standard keybindings.
 
 **`CM.codeEditor(target, opts)`** — Full-featured code editor for the admin extension panel (JSON manifests, JavaScript scripts). Features: line numbers, bracket matching, search/replace, fold gutter, 10 bundled language modes. Supports Vim and Emacs keybindings via user preference (reconfigurable at runtime via compartments).
 
+**`CM.noteEditor(target, opts)`** — Rich markdown editor for the notes panel. Features: heading size rendering (h1–h3), blockquote styling, fenced code block decorations, `[[wikilink]]` autocomplete (triggered by `[[`), wikilink chip rendering (clickable, styled by link/transclusion type), search/replace. `onLink` callback for navigating to linked notes; `linkCompleter` async callback for autocomplete results.
+
 Both factories return a clean API: `getValue()`, `setValue()`, `focus()`, `destroy()`. The `ChatInput` abstraction in `chat.js` wraps the CM6 instance with a textarea fallback — all callsites use `ChatInput.getValue()` etc., never raw DOM access.
 
 **Graceful degradation**: Every integration point checks `window.CM` before using CM6. If the bundle fails to load (air-gapped without the build step, CDN issues), the app falls back to native `<textarea>` with zero breakage.