Skip to content

Yamlink 0.7.0 — "Sugar"

Choose a tag to compare

View all tags
@javierigaciorm javierigaciorm released this 30 Jun 19:47
v0.7.0
20c568a

Sugar (0.7.0) — Five surfaces, one engine

Sugar takes the first step into Yamlink, a VS Code extension, to a platform, an engine. The same vault engine now runs in five places: the VS Code extension, a full CLI, a local HTTP API, a keyboard-driven terminal workspace (Conduit), and an LSP server for any editor. Every surface reads and writes the same vault, shares the same intelligence layer, and appends to the same mutation log.

Conduit

yamlink with no arguments opens Conduit — a full keyboard-driven terminal workspace for your vault. Nine screens accessible by number key: Briefing [1], Query [2], Navigator [3], Explorer [4], Health [5], Search [6], Graph [7], Diff [8], Radar [9]. Press | to split into two independent panes sharing one live vault connection.

From Explorer: edit frontmatter (e), create notes (n), delete (D), build wikilinks (l), multi-select with bulk ops, open a full Markdown reading view (v), peek note detail without leaving the screen (p), view mutation history (H), and traverse the graph with ]/[. Quick Capture (c) is available from any screen. Spatial bookmarks (m0–m9) and saved contexts (S/R) persist across sessions. Type any character from a non-input screen to trigger Warp — a live ranked fuzzy finder across notes, types, and commands.

Briefing opens with a compact session delta: what changed since you were last here.

CLI

24 commands covering the full headless vault loop. --json everywhere. CI-safe.

build · query · report · briefing · health · validate · doctor · search · diff · create · rename · set · link · mutations · on · graph · schema · status · watch · serve · export · init · completions · conduit

Notable additions:

  • yamlink set <id> <field> <value> — write a frontmatter field directly. --dry-run previews, --clear removes.
  • yamlink link <id> <field> <target> — set a relation field. Validates the target exists. --append for multi-value fields.
  • yamlink on <event> -- <script> — vault automation hooks. Fires a shell script on matching mutation events with full context in env vars.
  • yamlink completions bash|zsh — shell completion script.

Local API

yamlink serve exposes the vault as a REST API on 127.0.0.1.

Read: GET /api/nodes, /api/nodes/:id, /api/search, /api/query, /api/graph, /api/tasks, /api/mutations, /api/health, /api/schema, /api/diff, /api/intelligence/note, /api/intelligence/arc, /api/intelligence/fieldCategory

Write: POST /api/nodes, POST /api/nodes/bulk, PATCH /api/nodes/:id, PATCH /api/nodes/bulk, DELETE /api/nodes/:id

Events: GET /api/events — Server-Sent Events stream. Every mutation and every rebuild pushed live. Every response carries X-Yamlink-Generation so clients know when their data is stale.

LSP

yamlink serve --lsp starts a JSON-RPC 2.0 server over stdio — 25 handlers across completion, hover, inlay hints, semantic tokens, definition, references, document symbols, workspace symbols, rename, code actions, diagnostics, and formatting. Neovim, Zed, Helix, and Emacs users get vault-ranked wikilink completion, hover cards, broken link diagnostics, and exact-line block reference navigation.

VS Code

Block and section references. Every heading, task, blockquote, and footnote now has a stable block ID (h-{slug}, t{n}-{hash}, q{n}-{hash}, fn-{id}). note#Heading links to a section. note^block-id links to a specific task, quote, or footnote. Six commands give cursor-aware single-keystroke access — no picker needed when your cursor is already on the block. Go-to-definition lands on the exact source line. Hover shows the block's content. Completion surfaces the full block index with type labels and line numbers.

Visual Query Builder. Yamlink: Query Builder — a View → Shape → Preview flow with type, column, filter, sort, and layout controls. Shows the exact generated !view text and live sample rows before inserting. Table, matrix, bar, and scatter layouts.

Note Outline panel. Section tree with per-heading metadata: anchor link count, task count, body mention count, word count. Current-section tracking as you scroll. Ctrl+Alt+↑/↓ for sibling section jumps. Search and filter. Section references copyable directly from the tree.

Chart views. Any !view result can be visualized as a bar chart (with group-by field picker) or scatter plot (auto-selects first two numeric or date fields as axes).

Live Note mode. Yamlink: Open Live Note — a compact rendered sidecar synced with the active note while you write in source. Frontmatter fields, headings, and !view blocks are clickable back to their source line.

Home panel rework. Two-tab layout: Home (continue-working notes, task groups, activity feed, nudge cards) and Stats (activity heatmap with hover tooltips, type distribution donut, link density histogram, lifecycle state bar, weekly growth sparkline).

Task notifications. VS Code popups for overdue and due-today tasks, deduped by vault state. Per-vault settings for type, frequency, and count.

Vault Projections. 90-day structural forecast in Vault Health and Home: Growth, Stale Pressure, and Structure Direction lanes with type-family breakdowns and scenario modeling.

Intelligence

  • Behavioral priors feed live inference — recent relation edits bias completion ranking in real time
  • Outcome calibration: accepted completions write completion_accepted events; the classifier boosts confidence on that field for subsequent interactions
  • Cluster emergence detection: groups of notes with identical field signatures surfaced as proposed schema candidates, with a one-click "Create schema from cluster" action
  • Arc prediction: likely-missing fields ranked by vault frequency and calibration history, with one-click insertion from the Note Report
  • All static archetype tables removed — intelligence is fully vault-derived; a zero-history vault starts silent and grows more specific over time

Imports

First-pass importers for Obsidian, Notion, Roam Research, and Evernote. Post-import cleanup actions for IDs and wikilinks.

Import feedback wanted. Real export files vary more than synthetic tests can cover. If something came out wrong, open a thread in GitHub Discussions with your platform and what you saw.

Under the hood

  • x-graph cluster aggregation at zoom < 0.22 for vaults with 400+ nodes; incremental layout fast-path for small graph changes
  • VaultService shared write coordinator — API, CLI, and LSP all serialize through mutate() for consistent rebuild, mutation log, and generation bump
  • Vault Health trend arrows on broken links and orphan nodes
  • note_touched events on body-only saves so Note Report History no longer freezes on content edits
  • 1972 tests, 0 failures
Assets 2
Loading