fix: coerce claudeCodeStatus/Version null→undefined for AppCommandsConfig

Uses the existing check_claude_cli Tauri command to detect the claude
binary at app startup and shows a status badge — green/neutral when
found, orange warning when missing with a click-to-install link.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.claude/commands/laputa-next-task.md

@@ -7,8 +7,12 @@ Priority order: **To Rework** first, then **Open** (sorted by Todoist priority p
 ## Steps
 
 1. Fetch tasks from To Rework (`6g6QqvR9rRpvJWvv`), then Open (`6g3XjWR832hVHhCM`)
-2. Sort each section by priority (p1 highest)
-3. Take the first available task
+2. **Sort by priority — this is mandatory.** Todoist returns tasks in arbitrary order. You must sort them yourself:
+   - Todoist priority field: `4` = p1 (urgent), `3` = p2, `2` = p3, `1` = p4
+   - Sort descending by `priority` field (4 first, 1 last)
+   - To Rework tasks always come before Open tasks regardless of priority
+   - **Never pick a p3/p4 task if a p1/p2 task exists in the same section**
+3. Take the first task from the sorted list
 4. Move it to In Progress (`6g3XjWjfmJFcGgHM`) via Todoist API:
 
 ```bash

.codescene-thresholds

@@ -1,2 +1,2 @@
-HOTSPOT_THRESHOLD=9.72
-AVERAGE_THRESHOLD=9.34
+HOTSPOT_THRESHOLD=9.56
+AVERAGE_THRESHOLD=9.33

CLAUDE.md

@@ -107,6 +107,27 @@ Default to `demo-vault-v2/`. If you must use `~/Laputa/` for testing: **never co
 2. Design in light mode. Create `design/<slug>.pen` for the task
 3. On completion: merge frames into `ui-design.pen`, delete `design/<slug>.pen`
 
+### UI components — mandatory rules
+
+**Always use shadcn/ui components.** Never use raw HTML form elements (`<input>`, `<select>`, `<button>`, native `<input type="date">`, etc.) for user-facing UI. Every interactive element must use the shadcn/ui equivalent:
+
+| Need | Use |
+|---|---|
+| Text input | `Input` from shadcn/ui |
+| Dropdown/select | `Select` from shadcn/ui |
+| Date picker | `Calendar` + `Popover` from shadcn/ui (NOT native `<input type="date">`) |
+| Button | `Button` from shadcn/ui |
+| Autocomplete/combobox | Reuse existing combobox components from the app (check `src/components/`) |
+| Wikilink picker | Reuse the wikilink autocomplete component already used in the editor and Properties panel |
+| Emoji picker | Reuse the emoji picker component already used for note/type icons |
+| Color picker | Reuse the color swatch picker used for type customization |
+| Toggle/switch | `Switch` or `ToggleGroup` from shadcn/ui |
+| Dialog/modal | `Dialog` from shadcn/ui |
+
+**When in doubt:** search `src/components/` for an existing component that does what you need before building a new one. The app already has many reusable pieces — use them.
+
+**Visual language:** all new UI must feel native to Laputa. Take inspiration from `ui-design.pen` and existing components. If something looks like a browser default, it's wrong.
+
 ---
 
 ## 4. Reference

docs/ABSTRACTIONS.md

@@ -551,15 +551,11 @@ Managed by `useSettings` hook and `SettingsPanel` component.
 
 ---
 
-## Update Channels & Feature Flags
-
-### Settings
-- **`update_channel`** — `"stable"` (default/null) or `"canary"`. Stored in `Settings` struct, configurable in Settings panel under "Updates" section.
+## Updates & Feature Flags
 
 ### Hooks
-- **`useUpdater(channel?)`** — Checks for updates. For stable: uses Tauri updater plugin. For canary: fetches `latest-canary.json` and opens release page for download.
+- **`useUpdater()`** — Checks for updates using the Tauri updater plugin. Automatic download and install.
 - **`useFeatureFlag(flag)`** — Returns boolean for a named feature flag. Checks `localStorage` override (`ff_<name>`), then falls back to compile-time default. Type-safe via `FeatureFlagName` union.
 
 ### CI/CD
 - **`.github/workflows/release.yml`** — Stable builds from `main`. Produces `latest.json` on GitHub Pages.
-- **`.github/workflows/release-canary.yml`** — Canary builds from `canary` branch. Produces `latest-canary.json` on GitHub Pages. Releases are marked as prerelease.

docs/ARCHITECTURE.md

@@ -798,37 +798,25 @@ sequenceDiagram
 
 **Architecture:**
 - **Rust:** `sentry` crate initialized in `lib.rs::setup()` via `telemetry::init_sentry_from_settings()`
-- **JS:** `@sentry/browser` + `posthog-js` initialized lazily by `useTelemetry` hook
+- **JS:** `@sentry/react` + `posthog-js` initialized lazily by `useTelemetry` hook
 - **Settings:** `telemetry_consent`, `crash_reporting_enabled`, `analytics_enabled`, `anonymous_id` in `Settings` struct
 - **Consent:** `TelemetryConsentDialog` shown when `telemetry_consent === null`
 
-### Update Channels (Stable / Canary)
+### Updates
 
-Laputa supports two release channels:
+Laputa uses the Tauri updater plugin for automatic updates:
 
-- **Stable** (default): builds from `main` branch, published as full GitHub Releases
-- **Canary**: builds from `canary` branch, published as pre-release GitHub Releases
+- Builds from `main` branch are published as GitHub Releases
+- `latest.json` is published to GitHub Pages for the updater plugin
+- `useUpdater()` hook checks for updates automatically and supports download + install
 
-```mermaid
-flowchart LR
-    main["main branch"] -->|push| stable["Stable build<br/>latest.json"]
-    canary["canary branch"] -->|push| canaryBuild["Canary build<br/>latest-canary.json"]
-    stable --> ghPages["GitHub Pages"]
-    canaryBuild --> ghPages
-    ghPages -->|"update_channel = stable"| stableUsers["Stable users<br/>(auto-update via plugin)"]
-    ghPages -->|"update_channel = canary"| canaryUsers["Canary users<br/>(fetch + manual download)"]
-```
+### Feature Flags (PostHog + Release Channels)
 
-**How it works:**
-- Both channels publish to GitHub Pages: `latest.json` (stable) and `latest-canary.json` (canary)
-- `update_channel` is stored in `Settings` (`settings.json`), configurable in Settings panel
-- **Stable**: uses the Tauri updater plugin with automatic download and install
-- **Canary**: `useUpdater` hook fetches `latest-canary.json` via HTTP, compares versions, and opens the GitHub release page for manual download
-- Canary versions use semver prerelease: `0.YYYYMMDD.N-canary`
+Feature flags are backed by PostHog and evaluated per release channel:
 
-### Feature Flags (Local V1)
-
-Feature flags use a local-only system with no external dependencies:
+- **Alpha**: all features always enabled (no PostHog lookup)
+- **Beta**: sees features where the PostHog flag targets `release_channel = beta`
+- **Stable** (default): sees features where the flag targets `release_channel = stable`
 
 ```typescript
 import { useFeatureFlag } from './hooks/useFeatureFlag'
@@ -838,18 +826,14 @@ const enabled = useFeatureFlag('example_flag') // boolean
 
 **Resolution order:**
 1. `localStorage` override: key `ff_<name>` with value `"true"` or `"false"`
-2. Compile-time default in `FLAG_DEFAULTS` map
+2. `isFeatureEnabled(flag)` in `telemetry.ts` → checks release channel, then PostHog, then hardcoded defaults
 
 **How to add a new flag:**
 1. Add the flag name to the `FeatureFlagName` union type in `src/hooks/useFeatureFlag.ts`
-2. Set its default in the `FLAG_DEFAULTS` record
+2. Create the flag on PostHog dashboard with rollout rules per channel
 3. Use `useFeatureFlag('your_flag')` in components
 
-**Design decisions:**
-- No remote fetching, no PostHog dependency — zero privacy concerns
-- `localStorage` overrides allow dev/QA testing without rebuilding
-- Type-safe flag names via TypeScript union type
-- API surface is compatible with future migration to remote flags
+Release channel is selectable in Settings (alpha / beta / stable) and passed to PostHog as a person property via `identify()`. See ADR-0042.
 
 ## Platform Support — iOS / iPadOS (Prototype)
 

docs/adr/0042-posthog-release-channels-feature-flags.md

@@ -0,0 +1,37 @@
+---
+type: ADR
+id: "0042"
+title: "PostHog-based release channels and feature flags"
+status: active
+date: 2026-04-03
+supersedes: "0017"
+---
+## Context
+
+ADR-0017 introduced canary/stable update channels with localStorage-based feature flags. This worked for local development but lacked remote flag management — promoting a feature from beta to stable required a code change and rebuild.
+
+## Decision
+
+**Replace localStorage feature flags with PostHog-based feature flags, evaluated per release channel (alpha/beta/stable). The release channel is a user-selectable setting; PostHog flag rules determine which features are visible for each channel.**
+
+- **Alpha**: all features always enabled (no PostHog lookup needed, works offline)
+- **Beta**: sees features where the PostHog flag targets `release_channel = beta`
+- **Stable** (default): sees features where the PostHog flag targets `release_channel = stable`
+- Promotion = flipping a PostHog flag on the dashboard. Zero code changes, zero rebuilds.
+- `isFeatureEnabled(flagKey)` in `telemetry.ts` is the single evaluation point.
+- localStorage overrides (`ff_<name>`) still work for dev/QA testing (checked first).
+- Offline: PostHog caches flags in localStorage; alpha always works; first-launch-no-network falls back to hardcoded defaults.
+
+## Options considered
+
+* **Option A**: Keep localStorage-only flags (ADR-0017) — no server dependency, but no remote management.
+* **Option B** (chosen): PostHog feature flags — we already use PostHog for analytics, so no new dependency. Remote flag management, per-channel targeting, gradual rollouts via PostHog dashboard.
+* **Option C**: Dedicated feature flag service (LaunchDarkly, Unleash) — more powerful but adds a new vendor dependency.
+
+## Consequences
+
+* `release_channel` added to Settings (persisted via Tauri backend, not vault).
+* `useTelemetry` passes `release_channel` as a PostHog person property on identify.
+* `isFeatureEnabled()` checks channel → PostHog → hardcoded defaults.
+* `useFeatureFlag` hook updated to delegate to `isFeatureEnabled` (after localStorage override check).
+* ADR-0017 is superseded — the canary update channel remains, but feature gating moves from localStorage to PostHog.

getting-started-vault/.gitignore

@@ -0,0 +1,3 @@
+.DS_Store
+*.swp
+*.swo

getting-started-vault/CLAUDE.md

@@ -0,0 +1,89 @@
+# CLAUDE.md — Laputa Vault Guide
+
+This file explains how Laputa vaults work so you can create and edit notes correctly.
+
+## Note structure
+
+Every note is a markdown file with YAML frontmatter:
+
+```yaml
+---
+title: My Note Title        # required — do NOT use H1 in the body
+is_a: TypeName              # the note's type (must match a type file in the vault)
+status: Active              # example property
+url: https://example.com   # example property
+belongs_to: "[[Other Note]]"  # relationship via wikilink
+related_to:
+  - "[[Note A]]"
+  - "[[Note B]]"
+---
+
+Body content in markdown. No H1 — the title is in the frontmatter.
+```
+
+**Key rules:**
+- `title` is the note's display name — never use `# H1` in the body
+- `is_a` must match the `title` of an existing type file
+- Properties are any YAML key-value pairs in the frontmatter
+- System properties are prefixed with `_` (e.g. `_pinned`, `_organized`, `_icon`) — don't show these to users
+
+## Types
+
+A type is a note with `is_a: Type` in the frontmatter. It lives in the vault root:
+
+```yaml
+---
+title: Book
+is_a: Type
+_icon: BookOpen          # Phosphor icon name
+_color: "#8b5cf6"        # hex color for sidebar
+---
+Description of the type.
+```
+
+To create a new type: create a markdown file with `is_a: Type`.
+
+## Relationships
+
+Relationships are frontmatter properties whose values are wikilinks:
+
+```yaml
+belongs_to: "[[Project Name]]"
+related_to:
+  - "[[Note A]]"
+  - "[[Note B]]"
+has:
+  - "[[Child Note]]"
+```
+
+Standard names: `belongs_to`, `related_to`, `has`. Custom names are allowed.
+
+## Wikilinks
+
+Syntax: `[[Note Title]]` or `[[filename]]`. Used for relationships and inline references.
+
+## Views
+
+Saved filters stored as `.view.json` in the `views/` folder:
+
+```json
+{
+  "title": "Active Notes",
+  "filters": [
+    {"property": "is_a", "operator": "equals", "value": "Note"},
+    {"property": "status", "operator": "equals", "value": "Active"}
+  ],
+  "sort": {"property": "title", "direction": "asc"}
+}
+```
+
+## What you can do on this vault
+
+- Create/edit notes with correct frontmatter
+- Create new type files
+- Add or modify relationships between notes
+- Create/edit views in `views/`
+- Change `_icon` and `_color` on type files
+- Edit `CLAUDE.md` (this file)
+
+**Do not** modify app configuration files — those are local to each installation.

getting-started-vault/ai-and-git.md

@@ -0,0 +1,27 @@
+---
+title: AI and Git
+is_a: Note
+belongs_to: "[[Getting Started]]"
+---
+
+## Claude Code
+
+Laputa integrates with [Claude Code](https://docs.anthropic.com/claude-code) — Anthropic's CLI agent. If you have `claude` installed, you can ask it to operate directly on your vault:
+
+```
+claude "Create a note for the book Zero to One by Peter Thiel, with a rating and a topic"
+```
+
+Claude understands Laputa's format (frontmatter, types, wikilinks, relationships) and creates or edits files accordingly. Your vault's `CLAUDE.md` file gives it full context.
+
+## Git sync
+
+Your vault is a Git repository. Every save in Laputa is tracked as a file change. Use the **Changes** view in the sidebar to see what's modified, commit with a message, and push to a remote.
+
+```bash
+# From inside your vault folder
+git remote add origin https://github.com/you/my-vault.git
+git push -u origin main
+```
+
+After that, Laputa can push and pull directly from the app.

getting-started-vault/capturing-people-and-meetings.md

@@ -0,0 +1,38 @@
+---
+title: Capturing People and Meetings
+is_a: Note
+related_to: "[[Personal Knowledge Management]]"
+author: "[[Luca Rossi]]"
+date: 2025-01-28
+---
+
+The Person type is one of the most useful in my vault. Here's how I use it.
+
+## One note per person
+
+Every person I interact with meaningfully gets a Person note. Not just colleagues — also people I meet at conferences, authors whose work I follow, collaborators I might reach out to.
+
+A minimal Person note looks like this:
+
+```yaml
+---
+title: Matteo Cellini
+is_a: Person
+role: Head of Partnerships
+related_to: "[[Refactoring Newsletter]]"
+---
+```
+
+The body holds context: how we met, what they're working on, anything I want to remember.
+
+## Meetings as connections
+
+When I have a meeting, I create a note for it and link everyone present via `related_to`. This means every Person note accumulates backlinks over time — a natural history of interactions without any manual effort.
+
+## Finding things later
+
+The power comes when you need to remember something. Open a person's note, look at their backlinks — you see every meeting, every shared project, every note that mentioned them. It's the closest thing I've found to having a good memory.
+
+## The pattern
+
+Person notes are intentionally sparse upfront. I add context as I interact with people. A note that starts as just a name and a role grows into something genuinely useful over months.

getting-started-vault/getting-started.md

@@ -0,0 +1,6 @@
+---
+title: Getting Started
+is_a: Topic
+---
+
+This topic groups all the onboarding notes for Laputa. Start with [[Welcome to Laputa]] for an overview, then explore each note at your own pace.

getting-started-vault/how-i-organize-my-vault.md

@@ -0,0 +1,31 @@
+---
+title: How I Organize My Vault
+is_a: Note
+related_to: "[[Personal Knowledge Management]]"
+author: "[[Luca Rossi]]"
+date: 2025-01-15
+---
+
+My vault follows a structure loosely inspired by PARA, adapted to how I actually think and work.
+
+## The four types I use
+
+**Projects** — things with a clear outcome and an end date. Building a feature, writing an article, preparing a talk. Projects are active or done, never vague.
+
+**Responsibilities** — areas I own ongoing, with no end date. Newsletter, health, finances, team. A Responsibility never "completes" — it just gets better or worse.
+
+**Topics** — concepts, ideas, and subjects I care about. Personal Knowledge Management, Software Architecture, Cycling Training. Topics are the intellectual threads that run through everything else.
+
+**People** — anyone I interact with meaningfully. Each person has a note with context, how we met, what we've worked on together.
+
+## How they connect
+
+A Project `belongs_to` a Responsibility. A note `related_to` a Topic. A meeting note `related_to` the people who attended. Over time, these connections turn a flat list of files into something closer to how memory actually works.
+
+## Events
+
+I also sync calendar events into my vault as Event notes — one note per meeting or important event, linked to the people present. [[Luca Rossi]]'s AI assistant Brian handles this automatically via a cron job.
+
+## The rule I follow
+
+If I create a note and don't connect it to anything within a day or two, it goes to Inbox and stays there until I organize it. The Inbox is the queue — not a dumping ground.

getting-started-vault/luca-rossi.md

@@ -0,0 +1,20 @@
+---
+title: Luca Rossi
+is_a: Person
+role: Founder
+website: https://refactoring.fm
+twitter: https://twitter.com/lucaronin
+related_to:
+  - "[[Personal Knowledge Management]]"
+  - "[[Getting Started]]"
+---
+
+Creator of Laputa and founder of [Refactoring](https://refactoring.fm), a newsletter about engineering leadership and software craft for senior engineers and engineering leaders.
+
+Luca built Laputa to solve his own problem: after years of using Notion, Roam, and Obsidian, he wanted a knowledge base that was truly his — plain files, real version control, and AI that can operate on the vault directly.
+
+Some of his writing on how he thinks about knowledge management:
+- [[How I Organize My Vault]]
+- [[Why Plain Files]]
+- [[Syncing Calendar Events into Laputa]]
+- [[Capturing People and Meetings]]

getting-started-vault/note.md

@@ -0,0 +1,8 @@
+---
+title: Note
+is_a: Type
+_icon: FileText
+_color: "#6366f1"
+---
+
+A Note is a general-purpose document — ideas, references, meeting notes, or anything that doesn't fit a more specific type.

getting-started-vault/person.md

@@ -0,0 +1,8 @@
+---
+title: Person
+is_a: Type
+_icon: UserCircle
+_color: "#f59e0b"
+---
+
+A Person is someone you interact with — colleagues, collaborators, mentors, or friends.

getting-started-vault/personal-knowledge-management.md

@@ -0,0 +1,17 @@
+---
+title: Personal Knowledge Management
+is_a: Topic
+---
+
+Personal Knowledge Management (PKM) is the practice of collecting, organizing, and connecting the information you encounter — notes, ideas, references, and people — so it becomes a durable personal asset.
+
+Laputa is designed as a PKM tool. Unlike traditional note-taking apps, it treats your notes as a graph of interconnected entities: types give structure, wikilinks create connections, views let you slice through the graph from different angles.
+
+## How Luca uses Laputa for PKM
+
+These notes describe the actual system behind this vault — written by [[Luca Rossi]] as examples you can learn from and adapt:
+
+- [[How I Organize My Vault]] — the structure: Projects, Responsibilities, Topics, People
+- [[Syncing Calendar Events into Laputa]] — turning meetings into connected knowledge
+- [[Capturing People and Meetings]] — building a useful network of Person notes
+- [[Why Plain Files]] — why markdown + Git beats proprietary tools

getting-started-vault/sidebar-and-navigation.md

@@ -0,0 +1,32 @@
+---
+title: Sidebar and Navigation
+is_a: Note
+belongs_to: "[[Getting Started]]"
+---
+
+## Main sections
+
+- **Inbox** — notes you haven't organized yet. A note leaves the Inbox when you mark it as "organized" using the ✓ button in the breadcrumb bar.
+- **All Notes** — every note in your vault
+- **Archive** — notes you've finished with but want to keep
+- **Trash** — deleted notes, recoverable for 30 days
+
+## Types section
+
+Below the main sections, the sidebar lists your custom types (Note, Topic, Person, and any you create). Click a type to see all notes of that type.
+
+Use the sliders icon next to **TYPES** to show or hide types from the sidebar. Use the **+** to create a new type.
+
+## Favorites
+
+Star any note to pin it to the top of the sidebar. Click the ⭐ icon in the breadcrumb bar at the top of the editor, or use **Cmd+K → Favorite**.
+
+## Keyboard shortcuts
+
+| Action | Shortcut |
+|--------|----------|
+| Quick open | Cmd+P |
+| Command palette | Cmd+K |
+| New note | Cmd+N |
+| Settings | Cmd+, |
+| Search | Cmd+F |

getting-started-vault/syncing-calendar-events.md

@@ -0,0 +1,36 @@
+---
+title: Syncing Calendar Events into Laputa
+is_a: Note
+related_to: "[[Personal Knowledge Management]]"
+author: "[[Luca Rossi]]"
+date: 2025-02-10
+---
+
+One pattern I've found genuinely useful: every significant meeting or event gets a note in my vault.
+
+## How it works
+
+My AI assistant Brian runs a cron job that checks my calendar daily. For each meeting, it creates (or updates) an Event note in my vault with the relevant metadata — title, date, attendees — and links each attendee to their Person note.
+
+The result: every person I meet has a trail of events in their backlinks. I can open [[Luca Rossi]]'s note and immediately see every meeting we've had, what was discussed, what followed.
+
+## What an Event note looks like
+
+```yaml
+---
+title: 1:1 with Matteo — Jan 10
+is_a: Event
+date: 2025-01-10
+related_to:
+  - "[[Matteo Cellini]]"
+  - "[[Refactoring Newsletter]]"
+---
+```
+
+The body holds notes from the meeting — decisions, action items, context.
+
+## Why this matters
+
+Without this, meetings exist only in my calendar and my memory. With it, they become searchable, connected knowledge. A year later I can search "Matteo sponsorship" and find the exact conversation where we made a decision.
+
+You don't need a cron job to do this — you can create Event notes manually. The pattern is what matters.

getting-started-vault/topic.md

@@ -0,0 +1,8 @@
+---
+title: Topic
+is_a: Type
+_icon: Hash
+_color: "#10b981"
+---
+
+A Topic is a subject or area of interest that groups related notes together.

getting-started-vault/types-properties-relationships.md

@@ -0,0 +1,47 @@
+---
+title: Types, Properties and Relationships
+is_a: Note
+belongs_to: "[[Getting Started]]"
+---
+
+## Types
+
+A **type** is a category for your notes — Person, Project, Topic, Book, or anything you invent. Each type gets its own icon, color, and section in the sidebar.
+
+Create a type by adding a markdown file with `is_a: Type` in the frontmatter:
+
+```yaml
+---
+title: Book
+is_a: Type
+_icon: BookOpen
+_color: "#8b5cf6"
+---
+```
+
+Then tag any note with `is_a: Book` to classify it as a book.
+
+## Properties
+
+Properties are any key-value pairs in the frontmatter:
+
+```yaml
+rating: 4
+status: Active
+url: https://example.com
+```
+
+They appear in the **Inspector** panel on the right. Click "+ Add property" to add one.
+
+## Relationships
+
+Relationships are properties whose values are wikilinks to other notes:
+
+```yaml
+belongs_to: "[[Some Project]]"
+related_to:
+  - "[[Note A]]"
+  - "[[Note B]]"
+```
+
+Standard relationships: `belongs_to`, `related_to`, `has`. You can define your own.

getting-started-vault/using-the-editor.md

@@ -0,0 +1,38 @@
+---
+title: Using the Editor
+is_a: Note
+belongs_to: "[[Getting Started]]"
+---
+
+Laputa uses a rich markdown editor. Every note has two parts: **frontmatter** and **body**.
+
+## Frontmatter
+
+The YAML block at the top (between `---`) stores metadata:
+
+```yaml
+---
+title: My Note
+is_a: Note
+status: Active
+belongs_to: "[[Some Project]]"
+---
+```
+
+- `title` — the note's display name (no H1 needed in the body)
+- `is_a` — the type of the note
+- Any other key becomes a property visible in the Inspector
+
+## Body
+
+Write in standard markdown: headings, lists, checkboxes, code blocks, bold, italic.
+
+## Wikilinks
+
+Type `[[` anywhere to search and link to another note:
+
+```
+See also [[What is Laputa]] for context.
+```
+
+Wikilinks create relationships between notes and power the graph view and backlinks panel.

getting-started-vault/views-and-search.md

@@ -0,0 +1,23 @@
+---
+title: Views and Search
+is_a: Note
+belongs_to: "[[Getting Started]]"
+---
+
+## Search
+
+Press **Cmd+P** to open the Quick Open palette and jump to any note by name.
+
+Use the search bar in the sidebar to filter notes by text.
+
+## Command Palette
+
+Press **Cmd+K** to open the Command Palette — your shortcut to every action in Laputa: create a note, change a type, toggle a view, run a command.
+
+## Views
+
+Views are saved filters that show a subset of your vault. Create a view to answer questions like "all active projects" or "notes tagged design".
+
+Click the **+** next to VIEWS in the sidebar to create a new view. Set filters by type, status, property value, or body content.
+
+Views are saved as `.view.json` files in your vault's `views/` folder — they travel with your vault via Git.

getting-started-vault/views/active-projects.yml

@@ -0,0 +1,12 @@
+name: Active Projects
+icon: rocket-launch
+color: purple
+sort: "modified:desc"
+filters:
+  all:
+    - field: type
+      op: equals
+      value: Project
+    - field: Status
+      op: equals
+      value: Active

getting-started-vault/welcome.md

@@ -0,0 +1,37 @@
+---
+title: Welcome to Laputa
+is_a: Note
+belongs_to: "[[Getting Started]]"
+_pinned: true
+---
+
+Welcome to Laputa — your personal knowledge base, stored as plain markdown files and versioned with Git.
+
+This vault is your starting point. It contains real notes you can read, edit, and use as a model for your own.
+
+## Start here
+
+**Step 1 — Learn the basics**
+Read these three notes in order:
+1. [[What is Laputa]] — the philosophy (2 min)
+2. [[Using the Editor]] — how notes work (3 min)
+3. [[Types, Properties and Relationships]] — how to structure knowledge (3 min)
+
+**Step 2 — Explore the app**
+4. [[Sidebar and Navigation]] — Inbox, Favorites, types
+5. [[Views and Search]] — Cmd+K, Cmd+P, saved views
+
+**Step 3 — See it in action**
+Browse the [[Personal Knowledge Management]] topic to see how [[Luca Rossi]], Laputa's creator, actually uses the app — with real notes about his system, his workflows, and why he built it this way.
+
+**Step 4 — Make it yours**
+Try editing this note. Create a new note (Cmd+N). Add a type. Connect two notes with a `[[wikilink]]`.
+
+---
+
+**Step 5 — AI and Git**
+Read [[AI and Git]] to learn how to use Claude Code to operate on your vault, and how to sync it with GitHub.
+
+---
+
+*This vault was created by [[Luca Rossi]]. You own it — edit everything.*

getting-started-vault/what-is-laputa.md

@@ -0,0 +1,15 @@
+---
+title: What is Laputa
+is_a: Note
+belongs_to: "[[Getting Started]]"
+---
+
+Laputa is a personal knowledge base built on three principles:
+
+**Plain files.** Every note is a markdown file on your filesystem. No proprietary database, no lock-in. You can open, edit, and search your notes with any text editor.
+
+**Git as sync.** Your vault is a Git repository. Version history, branching, and remote sync come for free. Use GitHub, GitLab, or any remote.
+
+**Structure without rigidity.** Notes have types, properties, and relationships — but they're just YAML frontmatter. The structure lives in the file, not in a schema.
+
+Laputa is designed to grow with you. Start with a few notes, add types as patterns emerge, connect ideas with wikilinks. Over time, your vault becomes a map of how you think.

getting-started-vault/why-plain-files.md

@@ -0,0 +1,31 @@
+---
+title: Why Plain Files
+is_a: Note
+related_to: "[[Personal Knowledge Management]]"
+author: "[[Luca Rossi]]"
+date: 2024-11-05
+---
+
+I've used Notion, Roam, Bear, and Obsidian at different points. I kept switching. Here's what I eventually decided and why.
+
+## The problem with databases
+
+Notion stores your knowledge in a proprietary database. It's great for collaboration and structured data, but your notes are not really yours — they live in Notion's servers, in Notion's format. Export is lossy and awkward.
+
+## The problem with sync-only tools
+
+Obsidian keeps your files local, which I respect. But the sync story is fragile, and the plugin ecosystem means your setup is fragile too. I've lost time to broken plugins more than once.
+
+## What I wanted
+
+- Files I own, in a format that will be readable in 20 years
+- Version history that actually works (not "version history" as a feature — real Git history)
+- The ability to use AI to operate on my vault, which requires the AI to be able to read and write files
+
+Markdown + Git gives me all three.
+
+## Laputa's bet
+
+Laputa is built on the same bet: your notes are files, your vault is a Git repo, and the app is just a great interface on top of that. If Laputa disappears tomorrow, your notes are still there, still readable, still version-controlled.
+
+That's the kind of tool I wanted to build — and use.

package.json

@@ -42,7 +42,7 @@
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-tabs": "^1.1.13",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "@sentry/browser": "^10.45.0",
+    "@sentry/react": "^10.47.0",
     "@tailwindcss/vite": "^4.1.18",
     "@tauri-apps/api": "^2.10.1",
     "@tauri-apps/plugin-dialog": "^2.6.0",

patches/@blocknote__core@0.46.2.patch

@@ -0,0 +1,13 @@
+diff --git a/dist/defaultBlocks-DE5GNdJH.js b/dist/defaultBlocks-DE5GNdJH.js
+index b2761001278486a8b2ac1d10c82420b4994e96d9..fbf4f2f450ed1351d64adeb16263ceacf9ee393c 100644
+--- a/dist/defaultBlocks-DE5GNdJH.js
++++ b/dist/defaultBlocks-DE5GNdJH.js
+@@ -2761,7 +2761,7 @@ const B = new Ze("SuggestionMenuPlugin"), _n = k(({ editor: e }) => {
+             if (a === s) {
+               const c = r.state.doc;
+               for (const l of t) {
+-                const u = l.length > 1 ? c.textBetween(a - l.length, a) + i : i;
++                const u = l.length > 1 ? c.textBetween(a - (l.length - 1), a) + i : i;
+                 if (l === u)
+                   return r.dispatch(r.state.tr.insertText(i)), r.dispatch(
+                     r.state.tr.setMeta(B, {

pnpm-lock.yaml

@@ -4,6 +4,11 @@ settings:
   autoInstallPeers: true
   excludeLinksFromLockfile: false
 
+patchedDependencies:
+  '@blocknote/core@0.46.2':
+    hash: 9a6d8a53058a8b6127326d40e8188f6b132b9b9e364b87e88e1c9aa3a1867aec
+    path: patches/@blocknote__core@0.46.2.patch
+
 importers:
 
   .:
@@ -13,7 +18,7 @@ importers:
         version: 0.78.0(zod@4.3.6)
       '@blocknote/core':
         specifier: ^0.46.2
-        version: 0.46.2(@types/hast@3.0.4)(highlight.js@11.11.1)(lowlight@3.3.0)
+        version: 0.46.2(patch_hash=9a6d8a53058a8b6127326d40e8188f6b132b9b9e364b87e88e1c9aa3a1867aec)(@types/hast@3.0.4)(highlight.js@11.11.1)(lowlight@3.3.0)
       '@blocknote/mantine':
         specifier: ^0.46.2
         version: 0.46.2(@floating-ui/dom@1.7.5)(@mantine/core@8.3.14(@mantine/hooks@8.3.14(react@19.2.4))(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@mantine/hooks@8.3.14(react@19.2.4))(@mantine/utils@6.0.22(react@19.2.4))(@types/hast@3.0.4)(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(highlight.js@11.11.1)(lowlight@3.3.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
@@ -77,9 +82,9 @@ importers:
       '@radix-ui/react-tooltip':
         specifier: ^1.2.8
         version: 1.2.8(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
-      '@sentry/browser':
-        specifier: ^10.45.0
-        version: 10.45.0
+      '@sentry/react':
+        specifier: ^10.47.0
+        version: 10.47.0(react@19.2.4)
       '@tailwindcss/vite':
         specifier: ^4.1.18
         version: 4.1.18(vite@7.3.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.30.2))
@@ -1785,30 +1790,36 @@ packages:
     cpu: [x64]
     os: [win32]
 
-  '@sentry-internal/browser-utils@10.45.0':
-    resolution: {integrity: sha512-ZPZpeIarXKScvquGx2AfNKcYiVNDA4wegMmjyGVsTA2JPmP0TrJoO3UybJS6KGDeee8V3I3EfD/ruauMm7jOFQ==}
+  '@sentry-internal/browser-utils@10.47.0':
+    resolution: {integrity: sha512-bVFRAeJWMBcBCvJKIFCMJ1/yQToL4vPGqfmlnDZeypcxkqUDKQ/Y3ziLHXoDL2sx0lagcgU2vH1QhCQ67Aujjw==}
     engines: {node: '>=18'}
 
-  '@sentry-internal/feedback@10.45.0':
-    resolution: {integrity: sha512-vCSurazFVq7RUeYiM5X326jA5gOVrWYD6lYX2fbjBOMcyCEhDnveNxMT62zKkZDyNT/jyD194nz/cjntBUkyWA==}
+  '@sentry-internal/feedback@10.47.0':
+    resolution: {integrity: sha512-pdvMmi4dQpX5S/vAAzrhHPIw3T3HjUgDNgUiCBrlp7N9/6zGO2gNPhUnNekP+CjgI/z0rvf49RLqlDenpNrMOg==}
     engines: {node: '>=18'}
 
-  '@sentry-internal/replay-canvas@10.45.0':
-    resolution: {integrity: sha512-nvq/AocdZTuD7y0KSiWi3gVaY0s5HOFy86mC/v1kDZmT/jsBAzN5LDkk/f1FvsWma1peqQmpUqxvhC+YIW294Q==}
+  '@sentry-internal/replay-canvas@10.47.0':
+    resolution: {integrity: sha512-A5OY8friSe6g8WAK4L8IeOPiEd9D3Ps40DzRH5j2f6SUja0t90mKMvHRcRf8zq0d4BkdB+JM7tjOkwxpuv8heA==}
     engines: {node: '>=18'}
 
-  '@sentry-internal/replay@10.45.0':
-    resolution: {integrity: sha512-vjosRoGA1bzhVAEO1oce+CsRdd70quzBeo7WvYqpcUnoLe/Rv8qpOMqWX3j26z7XfFHMExWQNQeLxmtYOArvlw==}
+  '@sentry-internal/replay@10.47.0':
+    resolution: {integrity: sha512-ScdovxP7hJxgMt70+7hFvwT02GIaIUAxdEM/YPsayZBeCoAukPW8WiwztJfoKtsfPyKJ5A6f0H3PIxTPcA9Row==}
     engines: {node: '>=18'}
 
-  '@sentry/browser@10.45.0':
-    resolution: {integrity: sha512-e/a8UMiQhqqv706McSIcG6XK+AoQf9INthi2pD+giZfNRTzXTdqHzUT5OIO5hg8Am6eF63nDJc+vrYNPhzs51Q==}
+  '@sentry/browser@10.47.0':
+    resolution: {integrity: sha512-rC0agZdxKA5XWfL4VwPOr/rJMogXDqZgnVzr93YWpFn9DMZT/7LzxSJVPIJwRUjx3bFEby3PcTa3YaX7pxm1AA==}
     engines: {node: '>=18'}
 
-  '@sentry/core@10.45.0':
-    resolution: {integrity: sha512-s69UXxvefeQxuZ5nY7/THtTrIEvJxNVCp3ns4kwoCw1qMpgpvn/296WCKVmM7MiwnaAdzEKnAvLAwaxZc2nM7Q==}
+  '@sentry/core@10.47.0':
+    resolution: {integrity: sha512-nsYRAx3EWezDut+Zl+UwwP07thh9uY7CfSAi2whTdcJl5hu1nSp2z8bba7Vq/MGbNLnazkd3A+GITBEML924JA==}
     engines: {node: '>=18'}
 
+  '@sentry/react@10.47.0':
+    resolution: {integrity: sha512-ZtJV6xxF8jUVE9e3YQUG3Do0XapG1GjniyLyqMPgN6cNvs/HaRJODf7m60By+VGqcl5XArEjEPTvx8CdPUXDfA==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      react: ^16.14.0 || 17.x || 18.x || 19.x
+
   '@shikijs/types@3.22.0':
     resolution: {integrity: sha512-491iAekgKDBFE67z70Ok5a8KBMsQ2IJwOWw3us/7ffQkIBCyOQfm/aNwVMBUriP02QshIfgHCBSIYAl3u2eWjg==}
 
@@ -4455,7 +4466,7 @@ snapshots:
 
   '@bcoe/v8-coverage@1.0.2': {}
 
-  '@blocknote/core@0.46.2(@types/hast@3.0.4)(highlight.js@11.11.1)(lowlight@3.3.0)':
+  '@blocknote/core@0.46.2(patch_hash=9a6d8a53058a8b6127326d40e8188f6b132b9b9e364b87e88e1c9aa3a1867aec)(@types/hast@3.0.4)(highlight.js@11.11.1)(lowlight@3.3.0)':
     dependencies:
       '@emoji-mart/data': 1.2.1
       '@handlewithcare/prosemirror-inputrules': 0.1.4(prosemirror-model@1.25.4)(prosemirror-state@1.4.4)(prosemirror-view@1.41.6)
@@ -4507,7 +4518,7 @@ snapshots:
 
   '@blocknote/mantine@0.46.2(@floating-ui/dom@1.7.5)(@mantine/core@8.3.14(@mantine/hooks@8.3.14(react@19.2.4))(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@mantine/hooks@8.3.14(react@19.2.4))(@mantine/utils@6.0.22(react@19.2.4))(@types/hast@3.0.4)(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(highlight.js@11.11.1)(lowlight@3.3.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)':
     dependencies:
-      '@blocknote/core': 0.46.2(@types/hast@3.0.4)(highlight.js@11.11.1)(lowlight@3.3.0)
+      '@blocknote/core': 0.46.2(patch_hash=9a6d8a53058a8b6127326d40e8188f6b132b9b9e364b87e88e1c9aa3a1867aec)(@types/hast@3.0.4)(highlight.js@11.11.1)(lowlight@3.3.0)
       '@blocknote/react': 0.46.2(@floating-ui/dom@1.7.5)(@types/hast@3.0.4)(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(highlight.js@11.11.1)(lowlight@3.3.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       '@mantine/core': 8.3.14(@mantine/hooks@8.3.14(react@19.2.4))(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       '@mantine/hooks': 8.3.14(react@19.2.4)
@@ -4529,7 +4540,7 @@ snapshots:
 
   '@blocknote/react@0.46.2(@floating-ui/dom@1.7.5)(@types/hast@3.0.4)(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(highlight.js@11.11.1)(lowlight@3.3.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)':
     dependencies:
-      '@blocknote/core': 0.46.2(@types/hast@3.0.4)(highlight.js@11.11.1)(lowlight@3.3.0)
+      '@blocknote/core': 0.46.2(patch_hash=9a6d8a53058a8b6127326d40e8188f6b132b9b9e364b87e88e1c9aa3a1867aec)(@types/hast@3.0.4)(highlight.js@11.11.1)(lowlight@3.3.0)
       '@emoji-mart/data': 1.2.1
       '@floating-ui/react': 0.27.17(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       '@floating-ui/utils': 0.2.10
@@ -5941,33 +5952,39 @@ snapshots:
   '@rollup/rollup-win32-x64-msvc@4.57.1':
     optional: true
 
-  '@sentry-internal/browser-utils@10.45.0':
+  '@sentry-internal/browser-utils@10.47.0':
     dependencies:
-      '@sentry/core': 10.45.0
+      '@sentry/core': 10.47.0
 
-  '@sentry-internal/feedback@10.45.0':
+  '@sentry-internal/feedback@10.47.0':
     dependencies:
-      '@sentry/core': 10.45.0
+      '@sentry/core': 10.47.0
 
-  '@sentry-internal/replay-canvas@10.45.0':
+  '@sentry-internal/replay-canvas@10.47.0':
     dependencies:
-      '@sentry-internal/replay': 10.45.0
-      '@sentry/core': 10.45.0
+      '@sentry-internal/replay': 10.47.0
+      '@sentry/core': 10.47.0
 
-  '@sentry-internal/replay@10.45.0':
+  '@sentry-internal/replay@10.47.0':
     dependencies:
-      '@sentry-internal/browser-utils': 10.45.0
-      '@sentry/core': 10.45.0
+      '@sentry-internal/browser-utils': 10.47.0
+      '@sentry/core': 10.47.0
 
-  '@sentry/browser@10.45.0':
+  '@sentry/browser@10.47.0':
     dependencies:
-      '@sentry-internal/browser-utils': 10.45.0
-      '@sentry-internal/feedback': 10.45.0
-      '@sentry-internal/replay': 10.45.0
-      '@sentry-internal/replay-canvas': 10.45.0
-      '@sentry/core': 10.45.0
+      '@sentry-internal/browser-utils': 10.47.0
+      '@sentry-internal/feedback': 10.47.0
+      '@sentry-internal/replay': 10.47.0
+      '@sentry-internal/replay-canvas': 10.47.0
+      '@sentry/core': 10.47.0
 
-  '@sentry/core@10.45.0': {}
+  '@sentry/core@10.47.0': {}
+
+  '@sentry/react@10.47.0(react@19.2.4)':
+    dependencies:
+      '@sentry/browser': 10.47.0
+      '@sentry/core': 10.47.0
+      react: 19.2.4
 
   '@shikijs/types@3.22.0':
     dependencies:

pnpm-workspace.yaml

@@ -3,3 +3,6 @@ packages:
 
 ignoredBuiltDependencies:
   - esbuild
+
+patchedDependencies:
+  '@blocknote/core@0.46.2': patches/@blocknote__core@0.46.2.patch

src-tauri/src/commands/vault.rs

@@ -101,6 +101,23 @@ pub fn create_vault_folder(vault_path: String, folder_name: String) -> Result<St
     Ok(folder_name)
 }
 
+#[tauri::command]
+pub fn create_empty_vault(target_path: String) -> Result<String, String> {
+    let path = expand_tilde(&target_path).into_owned();
+    let vault_dir = std::path::Path::new(&path);
+
+    std::fs::create_dir_all(vault_dir)
+        .map_err(|e| format!("Failed to create vault directory: {}", e))?;
+
+    crate::git::init_repo(&path)?;
+
+    Ok(vault_dir
+        .canonicalize()
+        .unwrap_or_else(|_| vault_dir.to_path_buf())
+        .to_string_lossy()
+        .to_string())
+}
+
 #[tauri::command]
 pub fn create_getting_started_vault(target_path: Option<String>) -> Result<String, String> {
     let path = match target_path {

src-tauri/src/lib.rs

@@ -170,6 +170,7 @@ pub fn run() {
             commands::github_device_flow_poll,
             commands::github_get_user,
             commands::search_vault,
+            commands::create_empty_vault,
             commands::create_getting_started_vault,
             commands::check_vault_exists,
             commands::get_default_vault_path,

src-tauri/src/settings.rs

@@ -13,7 +13,7 @@ pub struct Settings {
     pub crash_reporting_enabled: Option<bool>,
     pub analytics_enabled: Option<bool>,
     pub anonymous_id: Option<String>,
-    pub update_channel: Option<String>,
+    pub release_channel: Option<String>,
 }
 
 fn settings_path() -> Result<PathBuf, String> {
@@ -63,8 +63,8 @@ fn save_settings_at(path: &PathBuf, settings: Settings) -> Result<(), String> {
             .anonymous_id
             .map(|k| k.trim().to_string())
             .filter(|k| !k.is_empty()),
-        update_channel: settings
-            .update_channel
+        release_channel: settings
+            .release_channel
             .map(|k| k.trim().to_string())
             .filter(|k| !k.is_empty()),
     };
@@ -136,7 +136,6 @@ mod tests {
         assert!(s.crash_reporting_enabled.is_none());
         assert!(s.analytics_enabled.is_none());
         assert!(s.anonymous_id.is_none());
-        assert!(s.update_channel.is_none());
     }
 
     #[test]

src-tauri/src/vault/entry.rs

@@ -75,6 +75,10 @@ pub struct VaultEntry {
     /// Only includes strings, numbers, and booleans — arrays/objects are excluded.
     #[serde(default)]
     pub properties: HashMap<String, serde_json::Value>,
+    /// Properties to display as chips in the note list for this Type's notes.
+    /// Configured via `_list_properties_display` in the type file's frontmatter.
+    #[serde(rename = "listPropertiesDisplay", default)]
+    pub list_properties_display: Vec<String>,
     /// File kind: "markdown", "text", or "binary".
     /// Determines how the frontend renders and opens the file.
     #[serde(rename = "fileKind", default = "default_file_kind")]

src-tauri/src/vault/frontmatter.rs

@@ -55,6 +55,8 @@ pub(crate) struct Frontmatter {
     pub favorite: Option<bool>,
     #[serde(rename = "_favorite_index", default)]
     pub favorite_index: Option<i64>,
+    #[serde(rename = "_list_properties_display", default)]
+    pub list_properties_display: Option<Vec<String>>,
 }
 
 /// Custom deserializer for boolean fields that may arrive as strings.
@@ -169,6 +171,7 @@ fn parse_frontmatter(data: &HashMap<String, serde_json::Value>) -> Frontmatter {
         "status",
         "_favorite",
         "_favorite_index",
+        "_list_properties_display",
     ];
     let filtered: serde_json::Map<String, serde_json::Value> = data
         .iter()
@@ -205,6 +208,7 @@ const SKIP_KEYS: &[&str] = &[
     "status",
     "_favorite",
     "_favorite_index",
+    "_list_properties_display",
 ];
 
 /// Extract all wikilink-containing fields from raw YAML frontmatter.

src-tauri/src/vault/mod.rs

@@ -117,6 +117,7 @@ pub fn parse_md_file(path: &Path, git_dates: Option<(u64, u64)>) -> Result<Vault
         visible: frontmatter.visible,
         favorite: frontmatter.favorite.unwrap_or(false),
         favorite_index: frontmatter.favorite_index,
+        list_properties_display: frontmatter.list_properties_display.unwrap_or_default(),
         word_count,
         outgoing_links,
         properties,

src-tauri/src/vault/mod_tests.rs

@@ -1457,6 +1457,40 @@ fn test_scan_vault_folders_flat_vault() {
     assert!(folders.is_empty(), "flat vault has no visible folders");
 }
 
+// --- list_properties_display tests ---
+
+#[test]
+fn test_parse_list_properties_display() {
+    let dir = TempDir::new().unwrap();
+    let content =
+        "---\ntype: Type\n_list_properties_display:\n  - rating\n  - genre\n---\n# Movies\n";
+    let entry = parse_test_entry(&dir, "movies.md", content);
+    assert_eq!(entry.list_properties_display, vec!["rating", "genre"]);
+}
+
+#[test]
+fn test_parse_list_properties_display_absent_defaults_empty() {
+    let dir = TempDir::new().unwrap();
+    let content = "---\ntype: Type\n---\n# Books\n";
+    let entry = parse_test_entry(&dir, "books.md", content);
+    assert!(entry.list_properties_display.is_empty());
+}
+
+#[test]
+fn test_list_properties_display_not_in_properties_or_relationships() {
+    let dir = TempDir::new().unwrap();
+    let content = "---\ntype: Type\n_list_properties_display:\n  - rating\n---\n# Movies\n";
+    let entry = parse_test_entry(&dir, "movies.md", content);
+    assert!(
+        !entry.properties.contains_key("_list_properties_display"),
+        "_list_properties_display must not leak into properties map"
+    );
+    assert!(
+        !entry.relationships.contains_key("_list_properties_display"),
+        "_list_properties_display must not leak into relationships map"
+    );
+}
+
 // Frontmatter update/delete tests are in frontmatter.rs
 // save_image tests are in vault/image.rs
 // purge_trash tests are in vault/trash.rs

src-tauri/src/vault/views.rs

@@ -142,9 +142,58 @@ pub struct ViewFile {
     pub definition: ViewDefinition,
 }
 
-/// Scan all `.yml` files from `vault_path/.laputa/views/` and return parsed views.
+/// Migrate views from `.laputa/views/` to `views/` in the vault root (one-time).
+pub fn migrate_views(vault_path: &Path) {
+    let old_dir = vault_path.join(".laputa").join("views");
+    if !old_dir.is_dir() {
+        return;
+    }
+
+    let entries = match fs::read_dir(&old_dir) {
+        Ok(e) => e,
+        Err(_) => return,
+    };
+
+    let yml_files: Vec<_> = entries
+        .flatten()
+        .filter(|e| e.path().extension().and_then(|ext| ext.to_str()) == Some("yml"))
+        .collect();
+
+    if yml_files.is_empty() {
+        return;
+    }
+
+    let new_dir = vault_path.join("views");
+    if fs::create_dir_all(&new_dir).is_err() {
+        log::warn!("Failed to create views/ directory for migration");
+        return;
+    }
+
+    for entry in yml_files {
+        let src = entry.path();
+        let dst = new_dir.join(entry.file_name());
+        if !dst.exists() {
+            if let Err(e) = fs::rename(&src, &dst) {
+                log::warn!("Failed to migrate view {:?}: {}", src, e);
+            } else {
+                log::info!("Migrated view {:?} → {:?}", src, dst);
+            }
+        }
+    }
+
+    // Clean up old directory if empty
+    if fs::read_dir(&old_dir)
+        .map(|mut d| d.next().is_none())
+        .unwrap_or(false)
+    {
+        let _ = fs::remove_dir(&old_dir);
+    }
+}
+
+/// Scan all `.yml` files from `vault_path/views/` and return parsed views.
 pub fn scan_views(vault_path: &Path) -> Vec<ViewFile> {
-    let views_dir = vault_path.join(".laputa").join("views");
+    migrate_views(vault_path);
+    let views_dir = vault_path.join("views");
     if !views_dir.is_dir() {
         return Vec::new();
     }
@@ -180,7 +229,7 @@ pub fn scan_views(vault_path: &Path) -> Vec<ViewFile> {
     views
 }
 
-/// Save a view definition as YAML to `vault_path/.laputa/views/{filename}`.
+/// Save a view definition as YAML to `vault_path/views/{filename}`.
 pub fn save_view(
     vault_path: &Path,
     filename: &str,
@@ -189,7 +238,7 @@ pub fn save_view(
     if !filename.ends_with(".yml") {
         return Err("Filename must end with .yml".to_string());
     }
-    let views_dir = vault_path.join(".laputa").join("views");
+    let views_dir = vault_path.join("views");
     fs::create_dir_all(&views_dir)
         .map_err(|e| format!("Failed to create views directory: {}", e))?;
     let yaml = serde_yaml::to_string(definition)
@@ -198,9 +247,9 @@ pub fn save_view(
         .map_err(|e| format!("Failed to write view file: {}", e))
 }
 
-/// Delete a view file at `vault_path/.laputa/views/{filename}`.
+/// Delete a view file at `vault_path/views/{filename}`.
 pub fn delete_view(vault_path: &Path, filename: &str) -> Result<(), String> {
-    let path = vault_path.join(".laputa").join("views").join(filename);
+    let path = vault_path.join("views").join(filename);
     fs::remove_file(&path).map_err(|e| format!("Failed to delete view: {}", e))
 }
 
@@ -599,7 +648,7 @@ filters:
     #[test]
     fn test_scan_views_reads_yml_files() {
         let dir = tempfile::TempDir::new().unwrap();
-        let views_dir = dir.path().join(".laputa").join("views");
+        let views_dir = dir.path().join("views");
         fs::create_dir_all(&views_dir).unwrap();
 
         let yaml_a = "name: Alpha\nfilters:\n  all:\n    - field: type\n      op: equals\n      value: Note\n";
@@ -617,6 +666,26 @@ filters:
         assert_eq!(views[1].definition.name, "Beta");
     }
 
+    #[test]
+    fn test_migrate_views_from_old_location() {
+        let dir = tempfile::TempDir::new().unwrap();
+        let old_dir = dir.path().join(".laputa").join("views");
+        fs::create_dir_all(&old_dir).unwrap();
+
+        let yaml = "name: Migrated\nfilters:\n  all:\n    - field: type\n      op: equals\n      value: Note\n";
+        fs::write(old_dir.join("test.yml"), yaml).unwrap();
+
+        // scan_views should trigger migration and find the view
+        let views = scan_views(dir.path());
+        assert_eq!(views.len(), 1);
+        assert_eq!(views[0].definition.name, "Migrated");
+
+        // File should now be in new location
+        assert!(dir.path().join("views").join("test.yml").exists());
+        // Old file should be gone
+        assert!(!old_dir.join("test.yml").exists());
+    }
+
     #[test]
     fn test_save_and_read_view() {
         let dir = tempfile::TempDir::new().unwrap();
@@ -645,6 +714,30 @@ filters:
         assert_eq!(views.len(), 0);
     }
 
+    #[test]
+    fn test_save_and_read_view_with_emoji_icon() {
+        let dir = tempfile::TempDir::new().unwrap();
+
+        let def = ViewDefinition {
+            name: "Monday".to_string(),
+            icon: Some("🗂️".to_string()),
+            color: None,
+            sort: None,
+            filters: FilterGroup::All(vec![FilterNode::Condition(FilterCondition {
+                field: "type".to_string(),
+                op: FilterOp::Equals,
+                value: Some(serde_yaml::Value::String("Project".to_string())),
+            })]),
+        };
+
+        save_view(dir.path(), "monday.yml", &def).unwrap();
+
+        let views = scan_views(dir.path());
+        assert_eq!(views.len(), 1);
+        assert_eq!(views[0].definition.name, "Monday");
+        assert_eq!(views[0].definition.icon.as_deref(), Some("🗂️"));
+    }
+
     #[test]
     fn test_wikilink_stem_matching() {
         let yaml = r#"

src/App.test.tsx

@@ -69,7 +69,7 @@ const mockCommandResults: Record<string, unknown> = {
   get_modified_files: [],
   get_note_content: mockAllContent['/vault/project/test.md'] || '',
   get_file_history: [],
-  get_settings: { openai_key: null, google_key: null, github_token: null, github_username: null, auto_pull_interval_minutes: null, telemetry_consent: true, crash_reporting_enabled: null, analytics_enabled: null, anonymous_id: null, update_channel: null },
+  get_settings: { openai_key: null, google_key: null, github_token: null, github_username: null, auto_pull_interval_minutes: null, telemetry_consent: true, crash_reporting_enabled: null, analytics_enabled: null, anonymous_id: null, release_channel: null },
   git_pull: { status: 'up_to_date', message: 'Already up to date', updatedFiles: [], conflictFiles: [] },
   save_settings: null,
   check_vault_exists: true,

src/App.tsx

@@ -1,4 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
+import type { VaultEntry } from './types'
 import { Sidebar } from './components/Sidebar'
 import { NoteList } from './components/NoteList'
 import { Editor } from './components/Editor'
@@ -18,6 +19,7 @@ import { WelcomeScreen } from './components/WelcomeScreen'
 import { TelemetryConsentDialog } from './components/TelemetryConsentDialog'
 import { useTelemetry } from './hooks/useTelemetry'
 import { useMcpStatus } from './hooks/useMcpStatus'
+import { useClaudeCodeStatus } from './hooks/useClaudeCodeStatus'
 import { useVaultLoader } from './hooks/useVaultLoader'
 import { useSettings } from './hooks/useSettings'
 import { useNoteActions } from './hooks/useNoteActions'
@@ -57,6 +59,7 @@ import { openNoteInNewWindow } from './utils/openNoteWindow'
 import { isNoteWindow, getNoteWindowParams } from './utils/windowMode'
 import { GitRequiredModal } from './components/GitRequiredModal'
 import { RenameDetectedBanner, type DetectedRename } from './components/RenameDetectedBanner'
+import { trackEvent } from './lib/telemetry'
 import './App.css'
 
 // Type declarations for mock content storage and test overrides
@@ -75,7 +78,7 @@ function App() {
   const noteWindowParams = useMemo(() => isNoteWindow() ? getNoteWindowParams() : null, [])
   const [selection, setSelection] = useState<SidebarSelection>(DEFAULT_SELECTION)
   const [noteListFilter, setNoteListFilter] = useState<NoteListFilter>('open')
-  const [inboxPeriod, setInboxPeriod] = useState<InboxPeriod>('month')
+  const inboxPeriod: InboxPeriod = 'all'
   const handleSetSelection = useCallback((sel: SidebarSelection) => {
     setSelection(sel)
     setNoteListFilter('open')
@@ -118,7 +121,16 @@ function App() {
   useVaultConfig(resolvedPath)
   const { settings, loaded: settingsLoaded, saveSettings } = useSettings()
   useTelemetry(settings, settingsLoaded)
+
+  const vaultOpenedRef = useRef('')
+  useEffect(() => {
+    if (vault.entries.length > 0 && gitRepoState !== 'checking' && resolvedPath !== vaultOpenedRef.current) {
+      vaultOpenedRef.current = resolvedPath
+      trackEvent('vault_opened', { has_git: gitRepoState === 'ready' ? 1 : 0, note_count: vault.entries.length })
+    }
+  }, [vault.entries.length, gitRepoState, resolvedPath])
   const { mcpStatus, installMcp } = useMcpStatus(resolvedPath, setToastMessage)
+  const { status: claudeCodeStatus, version: claudeCodeVersion } = useClaudeCodeStatus()
 
   const autoSync = useAutoSync({
     vaultPath: resolvedPath,
@@ -327,19 +339,38 @@ function App() {
     setToastMessage(`Type "${name}" created`)
   }, [notes])
 
-  const handleCreateView = useCallback(async (definition: import('./types').ViewDefinition) => {
-    const filename = definition.name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '') + '.yml'
+  const handleCreateOrUpdateView = useCallback(async (definition: import('./types').ViewDefinition) => {
+    const editing = dialogs.editingView
+    const filename = editing
+      ? editing.filename
+      : definition.name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '') + '.yml'
     const target = isTauri() ? invoke : mockInvoke
     await target('save_view_cmd', { vaultPath: resolvedPath, filename, definition })
+    trackEvent(editing ? 'view_updated' : 'view_created')
     await vault.reloadViews()
-    setToastMessage(`View "${definition.name}" created`)
+    // Update vault entries so the .yml file appears in FOLDERS immediately
+    const filePath = resolvedPath + '/views/' + filename
+    try {
+      const entry = await target<VaultEntry>('reload_vault_entry', { path: filePath })
+      if (editing) { vault.updateEntry(filePath, entry) } else { vault.addEntry(entry) }
+    } catch { /* non-critical — will appear after next vault reload */ }
+    vault.reloadFolders()
+    setToastMessage(editing ? `View "${definition.name}" updated` : `View "${definition.name}" created`)
     handleSetSelection({ kind: 'view', filename })
-  }, [resolvedPath, vault, handleSetSelection])
+  }, [resolvedPath, vault, handleSetSelection, dialogs.editingView])
+
+  const handleEditView = useCallback((filename: string) => {
+    const view = vault.views.find((v) => v.filename === filename)
+    if (view) dialogs.openEditView(filename, view.definition)
+  }, [vault.views, dialogs])
 
   const handleDeleteView = useCallback(async (filename: string) => {
     const target = isTauri() ? invoke : mockInvoke
     await target('delete_view_cmd', { vaultPath: resolvedPath, filename })
     await vault.reloadViews()
+    // Remove the .yml file from vault entries so it disappears from FOLDERS immediately
+    vault.removeEntry(resolvedPath + '/views/' + filename)
+    vault.reloadFolders()
     if (selection.kind === 'view' && selection.filename === filename) {
       handleSetSelection({ kind: 'filter', filter: 'all' })
     }
@@ -347,7 +378,7 @@ function App() {
   }, [resolvedPath, vault, selection, handleSetSelection])
 
   const availableFields = useMemo(() => {
-    const builtIn = ['type', 'status', 'title', 'favorite']
+    const builtIn = ['type', 'status', 'title', 'favorite', 'body']
     if (!vault.entries?.length) return builtIn
     const customFields = new Set<string>()
     for (const e of vault.entries) {
@@ -383,7 +414,7 @@ function App() {
   const zoom = useZoom()
   const buildNumber = useBuildNumber()
 
-  const { status: updateStatus, actions: updateActions } = useUpdater(settings.update_channel)
+  const { status: updateStatus, actions: updateActions } = useUpdater()
 
   const handleCheckForUpdates = useCallback(async () => {
     if (updateStatus.state === 'downloading') {
@@ -453,6 +484,8 @@ function App() {
     vaultCount: vaultSwitcher.allVaults.length,
     mcpStatus,
     onInstallMcp: installMcp,
+    claudeCodeStatus: claudeCodeStatus ?? undefined,
+    claudeCodeVersion: claudeCodeVersion ?? undefined,
     onEmptyTrash: deleteActions.handleEmptyTrash,
     trashedCount: deleteActions.trashedCount,
     onReloadVault: vault.reloadVault,
@@ -535,7 +568,7 @@ function App() {
         {sidebarVisible && (
           <>
             <div className="app__sidebar" style={{ width: layout.sidebarWidth }}>
-              <Sidebar entries={vault.entries} folders={vault.folders} views={vault.views} selection={selection} onSelect={handleSetSelection} onSelectNote={notes.handleSelectNote} onSelectFavorite={notes.handleSelectNote} onReorderFavorites={entryActions.handleReorderFavorites} onCreateType={notes.handleCreateNoteImmediate} onCreateNewType={dialogs.openCreateType} onCustomizeType={entryActions.handleCustomizeType} onUpdateTypeTemplate={entryActions.handleUpdateTypeTemplate} onReorderSections={entryActions.handleReorderSections} onRenameSection={entryActions.handleRenameSection} onToggleTypeVisibility={entryActions.handleToggleTypeVisibility} onCreateFolder={handleCreateFolder} onCreateView={dialogs.openCreateView} onDeleteView={handleDeleteView} inboxCount={inboxCount} />
+              <Sidebar entries={vault.entries} folders={vault.folders} views={vault.views} selection={selection} onSelect={handleSetSelection} onSelectNote={notes.handleSelectNote} onSelectFavorite={notes.handleSelectNote} onReorderFavorites={entryActions.handleReorderFavorites} onCreateType={notes.handleCreateNoteImmediate} onCreateNewType={dialogs.openCreateType} onCustomizeType={entryActions.handleCustomizeType} onUpdateTypeTemplate={entryActions.handleUpdateTypeTemplate} onReorderSections={entryActions.handleReorderSections} onRenameSection={entryActions.handleRenameSection} onToggleTypeVisibility={entryActions.handleToggleTypeVisibility} onCreateFolder={handleCreateFolder} onCreateView={dialogs.openCreateView} onEditView={handleEditView} onDeleteView={handleDeleteView} inboxCount={inboxCount} />
             </div>
             <ResizeHandle onResize={layout.handleSidebarResize} />
           </>
@@ -546,7 +579,7 @@ function App() {
               {selection.kind === 'filter' && selection.filter === 'pulse' ? (
                 <PulseView vaultPath={resolvedPath} onOpenNote={vaultBridge.handlePulseOpenNote} sidebarCollapsed={!sidebarVisible} onExpandSidebar={() => setViewMode('all')} />
               ) : (
-                <NoteList entries={vault.entries} selection={selection} selectedNote={activeTab?.entry ?? null} noteListFilter={noteListFilter} onNoteListFilterChange={setNoteListFilter} inboxPeriod={inboxPeriod} onInboxPeriodChange={setInboxPeriod} modifiedFiles={vault.modifiedFiles} modifiedFilesError={vault.modifiedFilesError} getNoteStatus={vault.getNoteStatus} sidebarCollapsed={!sidebarVisible} onSelectNote={notes.handleSelectNote} onReplaceActiveTab={notes.handleReplaceActiveTab} onCreateNote={notes.handleCreateNoteImmediate} onBulkArchive={bulkActions.handleBulkArchive} onBulkTrash={bulkActions.handleBulkTrash} onBulkRestore={bulkActions.handleBulkRestore} onBulkDeletePermanently={deleteActions.handleBulkDeletePermanently} onEmptyTrash={deleteActions.handleEmptyTrash} onUpdateTypeSort={notes.handleUpdateFrontmatter} updateEntry={vault.updateEntry} onOpenInNewWindow={handleOpenEntryInNewWindow} views={vault.views} />
+                <NoteList entries={vault.entries} selection={selection} selectedNote={activeTab?.entry ?? null} noteListFilter={noteListFilter} onNoteListFilterChange={setNoteListFilter} inboxPeriod={inboxPeriod} modifiedFiles={vault.modifiedFiles} modifiedFilesError={vault.modifiedFilesError} getNoteStatus={vault.getNoteStatus} sidebarCollapsed={!sidebarVisible} onSelectNote={notes.handleSelectNote} onReplaceActiveTab={notes.handleReplaceActiveTab} onCreateNote={notes.handleCreateNoteImmediate} onBulkArchive={bulkActions.handleBulkArchive} onBulkTrash={bulkActions.handleBulkTrash} onBulkRestore={bulkActions.handleBulkRestore} onBulkDeletePermanently={deleteActions.handleBulkDeletePermanently} onEmptyTrash={deleteActions.handleEmptyTrash} onUpdateTypeSort={notes.handleUpdateFrontmatter} updateEntry={vault.updateEntry} onOpenInNewWindow={handleOpenEntryInNewWindow} views={vault.views} />
               )}
             </div>
             <ResizeHandle onResize={layout.handleNoteListResize} />
@@ -608,13 +641,13 @@ function App() {
       </div>
       <UpdateBanner status={updateStatus} actions={updateActions} />
       <RenameDetectedBanner renames={detectedRenames} onUpdate={handleUpdateWikilinks} onDismiss={handleDismissRenames} />
-      <StatusBar noteCount={vault.entries.length} modifiedCount={vault.modifiedFiles.length} vaultPath={vaultSwitcher.vaultPath} vaults={vaultSwitcher.allVaults} onSwitchVault={vaultSwitcher.switchVault} onOpenSettings={dialogs.openSettings} onOpenLocalFolder={vaultSwitcher.handleOpenLocalFolder} onConnectGitHub={dialogs.openGitHubVault} onClickPending={() => handleSetSelection({ kind: 'filter', filter: 'changes' })} onClickPulse={() => handleSetSelection({ kind: 'filter', filter: 'pulse' })} onCommitPush={commitFlow.openCommitDialog} isGitVault={!vault.modifiedFilesError} hasGitHub={!!settings.github_token} syncStatus={autoSync.syncStatus} lastSyncTime={autoSync.lastSyncTime} conflictCount={autoSync.conflictFiles.length} lastCommitInfo={autoSync.lastCommitInfo} remoteStatus={autoSync.remoteStatus} onTriggerSync={autoSync.triggerSync} onPullAndPush={autoSync.pullAndPush} onOpenConflictResolver={conflictFlow.handleOpenConflictResolver} zoomLevel={zoom.zoomLevel} onZoomReset={zoom.zoomReset} buildNumber={buildNumber} onCheckForUpdates={handleCheckForUpdates} onRemoveVault={vaultSwitcher.removeVault} mcpStatus={mcpStatus} onInstallMcp={installMcp} />
+      <StatusBar noteCount={vault.entries.length} modifiedCount={vault.modifiedFiles.length} vaultPath={vaultSwitcher.vaultPath} vaults={vaultSwitcher.allVaults} onSwitchVault={vaultSwitcher.switchVault} onOpenSettings={dialogs.openSettings} onOpenLocalFolder={vaultSwitcher.handleOpenLocalFolder} onConnectGitHub={dialogs.openGitHubVault} onClickPending={() => handleSetSelection({ kind: 'filter', filter: 'changes' })} onClickPulse={() => handleSetSelection({ kind: 'filter', filter: 'pulse' })} onCommitPush={commitFlow.openCommitDialog} isGitVault={!vault.modifiedFilesError} hasGitHub={!!settings.github_token} syncStatus={autoSync.syncStatus} lastSyncTime={autoSync.lastSyncTime} conflictCount={autoSync.conflictFiles.length} lastCommitInfo={autoSync.lastCommitInfo} remoteStatus={autoSync.remoteStatus} onTriggerSync={autoSync.triggerSync} onPullAndPush={autoSync.pullAndPush} onOpenConflictResolver={conflictFlow.handleOpenConflictResolver} zoomLevel={zoom.zoomLevel} onZoomReset={zoom.zoomReset} buildNumber={buildNumber} onCheckForUpdates={handleCheckForUpdates} onRemoveVault={vaultSwitcher.removeVault} mcpStatus={mcpStatus} onInstallMcp={installMcp} claudeCodeStatus={claudeCodeStatus} claudeCodeVersion={claudeCodeVersion} />
       <Toast message={toastMessage} onDismiss={() => setToastMessage(null)} />
       <QuickOpenPalette open={dialogs.showQuickOpen} entries={vault.entries} onSelect={notes.handleSelectNote} onClose={dialogs.closeQuickOpen} />
       <CommandPalette open={dialogs.showCommandPalette} commands={commands} onClose={dialogs.closeCommandPalette} />
       <SearchPanel open={dialogs.showSearch} vaultPath={resolvedPath} entries={vault.entries} onSelectNote={notes.handleSelectNote} onClose={dialogs.closeSearch} />
       <CreateTypeDialog open={dialogs.showCreateTypeDialog} onClose={dialogs.closeCreateType} onCreate={handleCreateType} />
-      <CreateViewDialog open={dialogs.showCreateViewDialog} onClose={dialogs.closeCreateView} onCreate={handleCreateView} availableFields={availableFields} valueSuggestions={valueSuggestionsForField} />
+      <CreateViewDialog open={dialogs.showCreateViewDialog} onClose={dialogs.closeCreateView} onCreate={handleCreateOrUpdateView} availableFields={availableFields} valueSuggestions={valueSuggestionsForField} entries={vault.entries} editingView={dialogs.editingView?.definition ?? null} />
       <CommitDialog open={commitFlow.showCommitDialog} modifiedCount={vault.modifiedFiles.length} suggestedMessage={suggestedCommitMessage} onCommit={commitFlow.handleCommitPush} onClose={commitFlow.closeCommitDialog} />
       <ConflictResolverModal
         open={dialogs.showConflictResolver}
@@ -662,6 +695,7 @@ function WelcomeView({ onboarding }: { onboarding: OnboardingState }) {
         missingPath={state.status === 'vault-missing' ? state.vaultPath : undefined}
         defaultVaultPath={state.defaultPath}
         onCreateVault={onboarding.handleCreateVault}
+        onCreateNewVault={onboarding.handleCreateNewVault}
         onOpenFolder={onboarding.handleOpenFolder}
         creating={onboarding.creating}
         error={onboarding.error}

src/components/CreateViewDialog.test.tsx

@@ -0,0 +1,92 @@
+import { render, screen, fireEvent } from '@testing-library/react'
+import { describe, it, expect, vi } from 'vitest'
+import { CreateViewDialog } from './CreateViewDialog'
+import type { ViewDefinition } from '../types'
+
+describe('CreateViewDialog', () => {
+  const defaultProps = {
+    open: true,
+    onClose: vi.fn(),
+    onCreate: vi.fn(),
+    availableFields: ['type', 'status', 'title'],
+  }
+
+  it('shows "Create View" title in create mode', () => {
+    render(<CreateViewDialog {...defaultProps} />)
+    expect(screen.getByText('Create View')).toBeInTheDocument()
+    expect(screen.getByText('Create')).toBeInTheDocument()
+  })
+
+  it('shows "Edit View" title when editingView is provided', () => {
+    const editingView: ViewDefinition = {
+      name: 'Active Projects',
+      icon: '🚀',
+      color: null,
+      sort: null,
+      filters: { all: [{ field: 'type', op: 'equals', value: 'Project' }] },
+    }
+    render(<CreateViewDialog {...defaultProps} editingView={editingView} />)
+    expect(screen.getByText('Edit View')).toBeInTheDocument()
+    expect(screen.getByText('Save')).toBeInTheDocument()
+  })
+
+  it('pre-populates name field in edit mode', () => {
+    const editingView: ViewDefinition = {
+      name: 'Active Projects',
+      icon: '🚀',
+      color: null,
+      sort: null,
+      filters: { all: [{ field: 'type', op: 'equals', value: 'Project' }] },
+    }
+    render(<CreateViewDialog {...defaultProps} editingView={editingView} />)
+    const input = screen.getByPlaceholderText(/Active Projects|Reading List/i)
+    expect(input).toHaveValue('Active Projects')
+  })
+
+  it('preserves emoji icon when editing a view', () => {
+    const onCreate = vi.fn()
+    const editingView: ViewDefinition = {
+      name: 'Monday',
+      icon: '🗂️',
+      color: null,
+      sort: null,
+      filters: { all: [{ field: 'type', op: 'equals', value: 'Project' }] },
+    }
+    render(<CreateViewDialog {...defaultProps} onCreate={onCreate} editingView={editingView} />)
+    // Submit the form without changing anything
+    fireEvent.submit(screen.getByText('Save').closest('form')!)
+    expect(onCreate).toHaveBeenCalledWith(
+      expect.objectContaining({ icon: '🗂️' })
+    )
+  })
+
+  it('passes selected emoji icon when creating a view', () => {
+    const onCreate = vi.fn()
+    render(<CreateViewDialog {...defaultProps} onCreate={onCreate} />)
+    const input = screen.getByPlaceholderText(/Active Projects|Reading List/i)
+    fireEvent.change(input, { target: { value: 'Test View' } })
+    // Open emoji picker and select an emoji
+    fireEvent.click(screen.getByTitle('Pick icon'))
+    expect(screen.getByTestId('emoji-picker')).toBeInTheDocument()
+    const emojiButtons = screen.getAllByTestId('emoji-option')
+    fireEvent.click(emojiButtons[0])
+    // Submit the form
+    fireEvent.click(screen.getByText('Create'))
+    expect(onCreate).toHaveBeenCalledTimes(1)
+    const definition = onCreate.mock.calls[0][0] as ViewDefinition
+    expect(definition.icon).not.toBeNull()
+    expect(typeof definition.icon).toBe('string')
+    expect(definition.icon!.length).toBeGreaterThan(0)
+  })
+
+  it('passes null icon when no emoji is selected', () => {
+    const onCreate = vi.fn()
+    render(<CreateViewDialog {...defaultProps} onCreate={onCreate} />)
+    const input = screen.getByPlaceholderText(/Active Projects|Reading List/i)
+    fireEvent.change(input, { target: { value: 'No Icon View' } })
+    fireEvent.submit(screen.getByText('Create').closest('form')!)
+    expect(onCreate).toHaveBeenCalledWith(
+      expect.objectContaining({ icon: null })
+    )
+  })
+})

src/components/CreateViewDialog.tsx

@@ -4,7 +4,7 @@ import { Button } from '@/components/ui/button'
 import { Input } from '@/components/ui/input'
 import { FilterBuilder } from './FilterBuilder'
 import { EmojiPicker } from './EmojiPicker'
-import type { FilterGroup, ViewDefinition } from '../types'
+import type { FilterGroup, ViewDefinition, VaultEntry } from '../types'
 
 interface CreateViewDialogProps {
   open: boolean
@@ -13,9 +13,13 @@ interface CreateViewDialogProps {
   availableFields: string[]
   /** Returns known values for a given field (for autocomplete). */
   valueSuggestions?: (field: string) => string[]
+  /** Vault entries for wikilink autocomplete in filter value fields. */
+  entries?: VaultEntry[]
+  /** When provided, the dialog operates in edit mode with pre-populated fields. */
+  editingView?: ViewDefinition | null
 }
 
-export function CreateViewDialog({ open, onClose, onCreate, availableFields, valueSuggestions }: CreateViewDialogProps) {
+export function CreateViewDialog({ open, onClose, onCreate, availableFields, valueSuggestions, entries, editingView }: CreateViewDialogProps) {
   const [name, setName] = useState('')
   const [icon, setIcon] = useState('')
   const [showEmojiPicker, setShowEmojiPicker] = useState(false)
@@ -23,16 +27,23 @@ export function CreateViewDialog({ open, onClose, onCreate, availableFields, val
     all: [{ field: 'type', op: 'equals', value: '' }],
   })
   const inputRef = useRef<HTMLInputElement>(null)
+  const isEditing = !!editingView
 
   useEffect(() => {
     if (open) {
-      setName('') // eslint-disable-line react-hooks/set-state-in-effect -- reset on dialog open
-      setIcon('') // eslint-disable-line react-hooks/set-state-in-effect -- reset on dialog open
+      if (editingView) {
+        setName(editingView.name) // eslint-disable-line react-hooks/set-state-in-effect -- populate on dialog open
+        setIcon(editingView.icon ?? '') // eslint-disable-line react-hooks/set-state-in-effect -- populate on dialog open
+        setFilters(editingView.filters) // eslint-disable-line react-hooks/set-state-in-effect -- populate on dialog open
+      } else {
+        setName('') // eslint-disable-line react-hooks/set-state-in-effect -- reset on dialog open
+        setIcon('') // eslint-disable-line react-hooks/set-state-in-effect -- reset on dialog open
+        setFilters({ all: [{ field: availableFields[0] ?? 'type', op: 'equals', value: '' }] }) // eslint-disable-line react-hooks/set-state-in-effect -- reset on dialog open
+      }
       setShowEmojiPicker(false) // eslint-disable-line react-hooks/set-state-in-effect -- reset on dialog open
-      setFilters({ all: [{ field: availableFields[0] ?? 'type', op: 'equals', value: '' }] }) // eslint-disable-line react-hooks/set-state-in-effect -- reset on dialog open
       setTimeout(() => inputRef.current?.focus(), 50)
     }
-  }, [open, availableFields])
+  }, [open, availableFields, editingView])
 
   const handleSubmit = (e: React.FormEvent) => {
     e.preventDefault()
@@ -60,11 +71,11 @@ export function CreateViewDialog({ open, onClose, onCreate, availableFields, val
 
   return (
     <Dialog open={open} onOpenChange={(isOpen) => { if (!isOpen) onClose() }}>
-      <DialogContent showCloseButton={false} className="sm:max-w-[520px]">
+      <DialogContent showCloseButton={false} className="flex max-h-[80vh] flex-col sm:max-w-[600px]">
         <DialogHeader>
-          <DialogTitle>Create View</DialogTitle>
+          <DialogTitle>{isEditing ? 'Edit View' : 'Create View'}</DialogTitle>
         </DialogHeader>
-        <form onSubmit={handleSubmit} className="space-y-4">
+        <form onSubmit={handleSubmit} className="flex min-h-0 flex-1 flex-col gap-4">
           <div className="flex gap-2">
             <div className="w-16 space-y-1.5 relative">
               <label className="text-xs font-medium text-muted-foreground">Icon</label>
@@ -90,18 +101,19 @@ export function CreateViewDialog({ open, onClose, onCreate, availableFields, val
               />
             </div>
           </div>
-          <div className="space-y-1.5">
+          <div className="min-h-0 flex-1 space-y-1.5 overflow-y-auto">
             <label className="text-xs font-medium text-muted-foreground">Filters</label>
             <FilterBuilder
               group={filters}
               onChange={setFilters}
               availableFields={availableFields}
               valueSuggestions={valueSuggestions}
+              entries={entries}
             />
           </div>
           <DialogFooter>
             <Button type="button" variant="outline" onClick={onClose}>Cancel</Button>
-            <Button type="submit" disabled={!name.trim()}>Create</Button>
+            <Button type="submit" disabled={!name.trim()}>{isEditing ? 'Save' : 'Create'}</Button>
           </DialogFooter>
         </form>
       </DialogContent>

src/components/DynamicPropertiesPanel.test.tsx

@@ -93,17 +93,6 @@ describe('DynamicPropertiesPanel', () => {
     expect(screen.getByText('Note')).toBeInTheDocument()
   })
 
-  it('renders word count', () => {
-    render(
-      <DynamicPropertiesPanel
-        entry={makeEntry()}
-        content="---\ntitle: Test\n---\nOne two three four"
-        frontmatter={{}}
-      />
-    )
-    expect(screen.getByText('Words')).toBeInTheDocument()
-  })
-
   it('renders status as colored pill', () => {
     render(
       <DynamicPropertiesPanel
@@ -391,17 +380,6 @@ describe('DynamicPropertiesPanel', () => {
     })
   })
 
-  it('renders modified date', () => {
-    render(
-      <DynamicPropertiesPanel
-        entry={makeEntry({ modifiedAt: 1700000000 })}
-        content=""
-        frontmatter={{}}
-      />
-    )
-    expect(screen.getByText('Modified')).toBeInTheDocument()
-  })
-
   it('opens status dropdown on click and selects a status', () => {
     render(
       <DynamicPropertiesPanel
@@ -536,69 +514,6 @@ describe('DynamicPropertiesPanel', () => {
   })
 
   describe('editable vs read-only distinction', () => {
-    it('renders Info section header', () => {
-      render(
-        <DynamicPropertiesPanel
-          entry={makeEntry()}
-          content=""
-          frontmatter={{}}
-        />
-      )
-      expect(screen.getByText('Info')).toBeInTheDocument()
-    })
-
-    it('renders Modified and Words in read-only Info section', () => {
-      render(
-        <DynamicPropertiesPanel
-          entry={makeEntry({ modifiedAt: 1700000000 })}
-          content="---\ntitle: Test\n---\nOne two three"
-          frontmatter={{}}
-        />
-      )
-      const readOnlyRows = screen.getAllByTestId('readonly-property')
-      const labels = readOnlyRows.map(row => row.querySelector('span')?.textContent)
-      expect(labels).toContain('Modified')
-      expect(labels).toContain('Words')
-    })
-
-    it('renders Created date in Info section', () => {
-      render(
-        <DynamicPropertiesPanel
-          entry={makeEntry({ createdAt: 1700000000 })}
-          content=""
-          frontmatter={{}}
-        />
-      )
-      const readOnlyRows = screen.getAllByTestId('readonly-property')
-      const labels = readOnlyRows.map(row => row.querySelector('span')?.textContent)
-      expect(labels).toContain('Created')
-    })
-
-    it('renders file size in Info section', () => {
-      render(
-        <DynamicPropertiesPanel
-          entry={makeEntry({ fileSize: 4300 })}
-          content=""
-          frontmatter={{}}
-        />
-      )
-      expect(screen.getByText('Size')).toBeInTheDocument()
-      expect(screen.getByText('4.2 KB')).toBeInTheDocument()
-    })
-
-    it('shows em dash for null timestamps in Info section', () => {
-      render(
-        <DynamicPropertiesPanel
-          entry={makeEntry({ modifiedAt: null, createdAt: null })}
-          content=""
-          frontmatter={{}}
-        />
-      )
-      // Two em dashes for null Modified and Created
-      const dashes = screen.getAllByText('\u2014')
-      expect(dashes.length).toBeGreaterThanOrEqual(2)
-    })
-
     it('editable properties have hover styling via data-testid', () => {
       render(
         <DynamicPropertiesPanel
@@ -616,52 +531,6 @@ describe('DynamicPropertiesPanel', () => {
         expect(row.className).toContain('hover:bg-muted')
       })
     })
-
-    it('read-only rows do not have hover styling', () => {
-      render(
-        <DynamicPropertiesPanel
-          entry={makeEntry()}
-          content=""
-          frontmatter={{}}
-        />
-      )
-      const readOnlyRows = screen.getAllByTestId('readonly-property')
-      readOnlyRows.forEach(row => {
-        expect(row.className).not.toContain('hover:bg-muted')
-      })
-    })
-
-    it('formats file sizes correctly', () => {
-      // Small file — bytes
-      const { rerender } = render(
-        <DynamicPropertiesPanel
-          entry={makeEntry({ fileSize: 500 })}
-          content=""
-          frontmatter={{}}
-        />
-      )
-      expect(screen.getByText('500 B')).toBeInTheDocument()
-
-      // KB range
-      rerender(
-        <DynamicPropertiesPanel
-          entry={makeEntry({ fileSize: 2048 })}
-          content=""
-          frontmatter={{}}
-        />
-      )
-      expect(screen.getByText('2.0 KB')).toBeInTheDocument()
-
-      // MB range
-      rerender(
-        <DynamicPropertiesPanel
-          entry={makeEntry({ fileSize: 1048576 })}
-          content=""
-          frontmatter={{}}
-        />
-      )
-      expect(screen.getByText('1.0 MB')).toBeInTheDocument()
-    })
   })
 
   describe('property row 50/50 layout', () => {
@@ -680,8 +549,54 @@ describe('DynamicPropertiesPanel', () => {
         expect(row.className).toContain('grid-cols-2')
       })
     })
+  })
 
-    it('uses CSS grid with two equal columns on read-only rows', () => {
+  describe('suggested property slots', () => {
+    it('shows Status/Date/URL slots when no properties exist and onAddProperty provided', () => {
+      render(
+        <DynamicPropertiesPanel
+          entry={makeEntry()}
+          content=""
+          frontmatter={{}}
+          onAddProperty={onAddProperty}
+        />
+      )
+      const slots = screen.getAllByTestId('suggested-property')
+      expect(slots.length).toBe(3)
+      expect(screen.getByText('Status')).toBeInTheDocument()
+      expect(screen.getByText('Date')).toBeInTheDocument()
+      expect(screen.getByText('URL')).toBeInTheDocument()
+    })
+
+    it('hides Status slot when Status property already exists', () => {
+      render(
+        <DynamicPropertiesPanel
+          entry={makeEntry()}
+          content=""
+          frontmatter={{ Status: 'Active' }}
+          onAddProperty={onAddProperty}
+          onUpdateProperty={onUpdateProperty}
+        />
+      )
+      const slots = screen.getAllByTestId('suggested-property')
+      expect(slots.length).toBe(2)
+      expect(screen.queryAllByText('Status').some(el => el.closest('[data-testid="suggested-property"]'))).toBe(false)
+    })
+
+    it('hides all slots when all suggested properties exist', () => {
+      render(
+        <DynamicPropertiesPanel
+          entry={makeEntry()}
+          content=""
+          frontmatter={{ Status: 'Active', Date: '2024-01-01', URL: 'https://example.com' }}
+          onAddProperty={onAddProperty}
+          onUpdateProperty={onUpdateProperty}
+        />
+      )
+      expect(screen.queryByTestId('suggested-property')).not.toBeInTheDocument()
+    })
+
+    it('does not show slots when onAddProperty is not provided', () => {
       render(
         <DynamicPropertiesPanel
           entry={makeEntry()}
@@ -689,11 +604,20 @@ describe('DynamicPropertiesPanel', () => {
           frontmatter={{}}
         />
       )
-      const readOnlyRows = screen.getAllByTestId('readonly-property')
-      readOnlyRows.forEach(row => {
-        expect(row.className).toContain('grid')
-        expect(row.className).toContain('grid-cols-2')
-      })
+      expect(screen.queryByTestId('suggested-property')).not.toBeInTheDocument()
+    })
+
+    it('calls onAddProperty when clicking a suggested slot', () => {
+      render(
+        <DynamicPropertiesPanel
+          entry={makeEntry()}
+          content=""
+          frontmatter={{}}
+          onAddProperty={onAddProperty}
+        />
+      )
+      fireEvent.click(screen.getByText('Status'))
+      expect(onAddProperty).toHaveBeenCalledWith('Status', '')
     })
   })
 

src/components/DynamicPropertiesPanel.tsx

@@ -1,3 +1,4 @@
+import { useMemo, useCallback } from 'react'
 import type { VaultEntry } from '../types'
 import type { FrontmatterValue } from './Inspector'
 import type { ParsedFrontmatter } from '../utils/frontmatter'
@@ -6,7 +7,6 @@ import { getEffectiveDisplayMode, detectPropertyType } from '../utils/propertyTy
 import { SmartPropertyValueCell, DisplayModeSelector } from './PropertyValueCells'
 import { TypeSelector } from './TypeSelector'
 import { AddPropertyForm } from './AddPropertyForm'
-import { countWords } from '../utils/wikilinks'
 import type { PropertyDisplayMode } from '../utils/propertyTypes'
 
 function toSentenceCase(key: string): string {
@@ -22,20 +22,6 @@ export function containsWikilinks(value: FrontmatterValue): boolean {
   return false
 }
 
-function formatDate(timestamp: number | null): string {
-  if (!timestamp) return '\u2014'
-  const d = new Date(timestamp * 1000)
-  return d.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' })
-}
-
-function formatFileSize(bytes: number): string {
-  if (bytes < 1024) return `${bytes} B`
-  const kb = bytes / 1024
-  if (kb < 1024) return `${kb.toFixed(1)} KB`
-  const mb = kb / 1024
-  return `${mb.toFixed(1)} MB`
-}
-
 function PropertyRow({ propKey, value, editingKey, displayMode, autoMode, vaultStatuses, vaultTags, onStartEdit, onSave, onSaveList, onUpdate, onDelete, onDisplayModeChange }: {
   propKey: string; value: FrontmatterValue; editingKey: string | null
   displayMode: PropertyDisplayMode; autoMode: PropertyDisplayMode
@@ -68,15 +54,6 @@ function PropertyRow({ propKey, value, editingKey, displayMode, autoMode, vaultS
   )
 }
 
-function InfoRow({ label, value }: { label: string; value: string }) {
-  return (
-    <div className="grid min-w-0 grid-cols-2 items-center gap-2 px-1.5" data-testid="readonly-property">
-      <span className="min-w-0 truncate text-[12px] text-muted-foreground">{label}</span>
-      <span className="min-w-0 truncate text-right text-[12px]" style={{ color: 'var(--text-muted)' }}>{value}</span>
-    </div>
-  )
-}
-
 function AddPropertyButton({ onClick, disabled }: { onClick: () => void; disabled: boolean }) {
   return (
     <button
@@ -89,26 +66,29 @@ function AddPropertyButton({ onClick, disabled }: { onClick: () => void; disable
   )
 }
 
-function NoteInfoSection({ entry, wordCount }: { entry: VaultEntry; wordCount: number }) {
+const SUGGESTED_PROPERTIES = ['Status', 'Date', 'URL'] as const
+
+function SuggestedPropertySlot({ label, onAdd }: { label: string; onAdd: () => void }) {
   return (
-    <div className="border-t border-border pt-3">
-      <h4 className="font-mono-overline mb-2 text-muted-foreground">Info</h4>
-      <div className="flex flex-col gap-1.5">
-        <InfoRow label="Modified" value={formatDate(entry.modifiedAt)} />
-        <InfoRow label="Created" value={formatDate(entry.createdAt)} />
-        <InfoRow label="Words" value={String(wordCount)} />
-        <InfoRow label="Size" value={formatFileSize(entry.fileSize)} />
-      </div>
-    </div>
+    <button
+      className="grid min-h-7 min-w-0 grid-cols-2 items-center gap-2 rounded border-none bg-transparent px-1.5 outline-none transition-colors hover:bg-muted focus:bg-muted focus:ring-1 focus:ring-primary cursor-pointer"
+      tabIndex={0}
+      onClick={onAdd}
+      onKeyDown={e => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); onAdd() } }}
+      data-testid="suggested-property"
+    >
+      <span className="min-w-0 truncate text-[12px] text-muted-foreground/50">{label}</span>
+      <span className="min-w-0 truncate text-right text-[12px] text-muted-foreground/30">{'\u2014'}</span>
+    </button>
   )
 }
 
 export function DynamicPropertiesPanel({
-  entry, content, frontmatter, entries,
+  entry, frontmatter, entries,
   onUpdateProperty, onDeleteProperty, onAddProperty, onNavigate,
 }: {
   entry: VaultEntry
-  content: string | null
+  content?: string | null
   frontmatter: ParsedFrontmatter
   entries?: VaultEntry[]
   onUpdateProperty?: (key: string, value: FrontmatterValue) => void
@@ -122,7 +102,23 @@ export function DynamicPropertiesPanel({
     handleSaveValue, handleSaveList, handleAdd, handleDisplayModeChange,
   } = usePropertyPanelState({ entries, entryIsA: entry.isA, frontmatter, onUpdateProperty, onDeleteProperty, onAddProperty })
 
-  const wordCount = countWords(content ?? '')
+  const existingKeys = useMemo(() => {
+    const keys = new Set(propertyEntries.map(([k]) => k.toLowerCase()))
+    // Also check full frontmatter for relationship keys that are filtered out of propertyEntries
+    for (const k of Object.keys(frontmatter)) keys.add(k.toLowerCase())
+    return keys
+  }, [propertyEntries, frontmatter])
+
+  const missingSuggested = onAddProperty
+    ? SUGGESTED_PROPERTIES.filter(p => !existingKeys.has(p.toLowerCase()))
+    : []
+
+  const handleSuggestedAdd = useCallback((key: string) => {
+    if (!onAddProperty) return
+    onAddProperty(key, '')
+    // Auto-focus the new property value
+    setTimeout(() => setEditingKey(key), 0)
+  }, [onAddProperty, setEditingKey])
 
   return (
     <div className="flex flex-col gap-3">
@@ -140,12 +136,14 @@ export function DynamicPropertiesPanel({
             onDisplayModeChange={handleDisplayModeChange}
           />
         ))}
+        {missingSuggested.map(key => (
+          <SuggestedPropertySlot key={key} label={key} onAdd={() => handleSuggestedAdd(key)} />
+        ))}
       </div>
       {showAddDialog
         ? <AddPropertyForm onAdd={handleAdd} onCancel={() => setShowAddDialog(false)} vaultStatuses={vaultStatuses} />
         : <AddPropertyButton onClick={() => setShowAddDialog(true)} disabled={!onAddProperty} />
       }
-      <NoteInfoSection entry={entry} wordCount={wordCount} />
     </div>
   )
 }

src/components/Editor.css

@@ -333,6 +333,10 @@
   letter-spacing: var(--headings-h1-letter-spacing, -0.015em);
   color: var(--foreground);
   padding: 0;
+  resize: none;
+  overflow: hidden;
+  font-family: inherit;
+  field-sizing: content;
 }
 
 .title-field__input::placeholder {

src/components/EmojiPicker.tsx

@@ -71,6 +71,7 @@ export function EmojiPicker({ onSelect, onClose }: EmojiPickerProps) {
             <div className="grid grid-cols-8 gap-0.5">
               {searchResults.map(entry => (
                 <button
+                  type="button"
                   key={entry.emoji}
                   className="flex h-8 w-8 items-center justify-center rounded text-xl transition-colors hover:bg-accent"
                   onClick={() => handleSelect(entry.emoji)}
@@ -98,6 +99,7 @@ export function EmojiPicker({ onSelect, onClose }: EmojiPickerProps) {
                 <div className="grid grid-cols-8 gap-0.5">
                   {emojis.map(entry => (
                     <button
+                      type="button"
                       key={entry.emoji}
                       className="flex h-8 w-8 items-center justify-center rounded text-xl transition-colors hover:bg-accent"
                       onClick={() => handleSelect(entry.emoji)}

src/components/FilterBuilder.test.tsx

@@ -0,0 +1,213 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { render, screen, fireEvent } from '@testing-library/react'
+import { FilterBuilder } from './FilterBuilder'
+import type { FilterGroup, VaultEntry } from '../types'
+
+const makeEntry = (overrides: Partial<VaultEntry> = {}): VaultEntry => ({
+  path: '/vault/note/test.md',
+  filename: 'test.md',
+  title: 'Test Note',
+  isA: 'Note',
+  aliases: [],
+  belongsTo: [],
+  relatedTo: [],
+  status: 'Active',
+  owner: null,
+  cadence: null,
+  archived: false,
+  trashed: false,
+  trashedAt: null,
+  modifiedAt: 1700000000,
+  createdAt: 1700000000,
+  fileSize: 100,
+  snippet: '',
+  wordCount: 0,
+  relationships: {},
+  icon: null,
+  color: null,
+  order: null,
+  ...overrides,
+})
+
+const entries: VaultEntry[] = [
+  makeEntry({ path: '/vault/project/alpha.md', filename: 'alpha.md', title: 'Alpha Project', isA: 'Project' }),
+  makeEntry({ path: '/vault/person/luca.md', filename: 'luca.md', title: 'Luca', isA: 'Person' }),
+  makeEntry({ path: '/vault/topic/ai.md', filename: 'ai.md', title: 'AI Research', isA: 'Topic' }),
+  makeEntry({ path: '/vault/note/plain.md', filename: 'plain.md', title: 'Plain Note', isA: null }),
+  makeEntry({ path: '/vault/person/alice.md', filename: 'alice.md', title: 'Alice Smith', isA: 'Person', aliases: ['Alice'] }),
+  makeEntry({ path: '/vault/trashed.md', filename: 'trashed.md', title: 'Trashed Note', isA: null, trashed: true }),
+]
+
+describe('FilterBuilder wikilink autocomplete', () => {
+  const onChange = vi.fn()
+
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  function renderWithEntries(group?: FilterGroup) {
+    const defaultGroup: FilterGroup = {
+      all: [{ field: 'title', op: 'contains', value: '' }],
+    }
+    return render(
+      <FilterBuilder
+        group={group ?? defaultGroup}
+        onChange={onChange}
+        availableFields={['type', 'status', 'title']}
+        entries={entries}
+      />,
+    )
+  }
+
+  it('renders value input with wikilink support when entries are provided', () => {
+    renderWithEntries()
+    expect(screen.getByTestId('filter-value-input')).toBeInTheDocument()
+  })
+
+  it('does not show dropdown for plain text input', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: 'hello' }],
+    })
+    expect(screen.queryByTestId('wikilink-dropdown')).not.toBeInTheDocument()
+  })
+
+  it('shows dropdown when value starts with [[', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: '[[Al' }],
+    })
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.focus(input)
+    expect(screen.getByTestId('wikilink-dropdown')).toBeInTheDocument()
+    expect(screen.getByText('Alpha Project')).toBeInTheDocument()
+    expect(screen.getByText('Alice Smith')).toBeInTheDocument()
+  })
+
+  it('does not show dropdown for short queries after [[', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: '[[A' }],
+    })
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.focus(input)
+    expect(screen.queryByTestId('wikilink-dropdown')).not.toBeInTheDocument()
+  })
+
+  it('inserts [[note-title]] when a note is selected', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: '[[Alpha' }],
+    })
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.focus(input)
+    fireEvent.click(screen.getByText('Alpha Project'))
+    expect(onChange).toHaveBeenCalledWith(
+      expect.objectContaining({
+        all: [{ field: 'title', op: 'contains', value: '[[Alpha Project]]' }],
+      }),
+    )
+  })
+
+  it('navigates dropdown with arrow keys and selects with Enter', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: '[[Al' }],
+    })
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.focus(input)
+    fireEvent.keyDown(input, { key: 'ArrowDown' })
+    const selected = document.querySelector('.wikilink-menu__item--selected')
+    expect(selected).toBeTruthy()
+    fireEvent.keyDown(input, { key: 'Enter' })
+    expect(onChange).toHaveBeenCalled()
+  })
+
+  it('closes dropdown on Escape', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: '[[Al' }],
+    })
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.focus(input)
+    expect(screen.getByTestId('wikilink-dropdown')).toBeInTheDocument()
+    fireEvent.keyDown(input, { key: 'Escape' })
+    expect(screen.queryByTestId('wikilink-dropdown')).not.toBeInTheDocument()
+  })
+
+  it('excludes trashed notes from autocomplete', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: '[[Trashed' }],
+    })
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.focus(input)
+    expect(screen.queryByText('Trashed Note')).not.toBeInTheDocument()
+  })
+
+  it('matches on aliases', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: '[[Alice' }],
+    })
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.focus(input)
+    expect(screen.getByText('Alice Smith')).toBeInTheDocument()
+  })
+
+  it('shows type badge for typed entries', () => {
+    const personType = makeEntry({
+      path: '/vault/person.md', filename: 'person.md', title: 'Person',
+      isA: 'Type', color: 'yellow', icon: 'user',
+    })
+    const entriesWithType = [...entries, personType]
+    render(
+      <FilterBuilder
+        group={{ all: [{ field: 'title', op: 'contains', value: '[[Luca' }] }}
+        onChange={onChange}
+        availableFields={['type', 'status', 'title']}
+        entries={entriesWithType}
+      />,
+    )
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.focus(input)
+    expect(screen.getByText('Person')).toBeInTheDocument()
+  })
+
+  it('opens dropdown on typing [[ in input', () => {
+    renderWithEntries({
+      all: [{ field: 'title', op: 'contains', value: '[[Al' }],
+    })
+    const input = screen.getByTestId('filter-value-input')
+    // Simulate the user typing [[ — dropdown opens when value starts with [[
+    fireEvent.change(input, { target: { value: '[[Al' } })
+    // The internal open state is set by onChange, verified via focus re-trigger
+    fireEvent.focus(input)
+    expect(screen.getByTestId('wikilink-dropdown')).toBeInTheDocument()
+  })
+
+  it('plain text without [[ still works as regular input', () => {
+    renderWithEntries()
+    const input = screen.getByTestId('filter-value-input')
+    fireEvent.change(input, { target: { value: 'some text' } })
+    expect(screen.queryByTestId('wikilink-dropdown')).not.toBeInTheDocument()
+    expect(onChange).toHaveBeenCalled()
+  })
+
+  it('falls back to plain input when no entries are provided', () => {
+    render(
+      <FilterBuilder
+        group={{ all: [{ field: 'title', op: 'contains', value: '' }] }}
+        onChange={onChange}
+        availableFields={['type', 'status', 'title']}
+      />,
+    )
+    const input = screen.getByPlaceholderText('value')
+    expect(input).toBeInTheDocument()
+    expect(input).not.toHaveAttribute('data-testid', 'filter-value-input')
+  })
+
+  it('shows body field in field dropdown separated from property fields', () => {
+    render(
+      <FilterBuilder
+        group={{ all: [{ field: 'body', op: 'contains', value: 'test' }] }}
+        onChange={vi.fn()}
+        availableFields={['type', 'status', 'body']}
+      />,
+    )
+    // Body field should be selected as the current value
+    expect(screen.getByText('body')).toBeInTheDocument()
+  })
+})

src/components/FilterBuilder.tsx

@@ -1,7 +1,12 @@
-import { useId } from 'react'
+import { useState, useRef, useMemo, useEffect, useCallback } from 'react'
 import { Plus, X } from '@phosphor-icons/react'
 import { Button } from '@/components/ui/button'
-import type { FilterCondition, FilterOp, FilterGroup, FilterNode } from '../types'
+import { Input } from '@/components/ui/input'
+import { Select, SelectContent, SelectItem, SelectSeparator, SelectTrigger, SelectValue } from '@/components/ui/select'
+import type { FilterCondition, FilterOp, FilterGroup, FilterNode, VaultEntry } from '../types'
+import { buildTypeEntryMap, getTypeColor, getTypeLightColor } from '../utils/typeColors'
+import { getTypeIcon } from './NoteItem'
+import './WikilinkSuggestionMenu.css'
 
 const OPERATORS: { value: FilterOp; label: string }[] = [
   { value: 'equals', label: 'equals' },
@@ -15,6 +20,7 @@ const OPERATORS: { value: FilterOp; label: string }[] = [
 ]
 
 const NO_VALUE_OPS = new Set<FilterOp>(['is_empty', 'is_not_empty'])
+const DATE_OPS = new Set<FilterOp>(['before', 'after'])
 
 function isFilterGroup(node: FilterNode): node is FilterGroup {
   return 'all' in node || 'any' in node
@@ -32,98 +38,351 @@ function setGroupChildren(mode: 'all' | 'any', children: FilterNode[]): FilterGr
   return mode === 'all' ? { all: children } : { any: children }
 }
 
-/** Combobox-style field input with datalist autocomplete. */
-function FieldInput({ value, fields, onChange }: {
+const CONTENT_FIELDS = new Set(['body'])
+
+function FieldSelect({ value, fields, onChange }: {
   value: string
   fields: string[]
   onChange: (v: string) => void
 }) {
-  const id = useId()
+  const isCustom = value !== '' && !fields.includes(value)
+  const propertyFields = fields.filter(f => !CONTENT_FIELDS.has(f))
+  const contentFields = fields.filter(f => CONTENT_FIELDS.has(f))
   return (
-    <>
-      <input
-        list={id}
-        className="h-8 rounded-md border border-input bg-background px-2 text-sm flex-1 min-w-0"
-        value={value}
-        onChange={(e) => onChange(e.target.value)}
-        placeholder="field"
-      />
-      <datalist id={id}>
-        {fields.map((f) => <option key={f} value={f} />)}
-      </datalist>
-    </>
+    <Select value={value} onValueChange={onChange}>
+      <SelectTrigger
+        size="sm"
+        className="h-8 min-w-[100px] flex-1 gap-1 border-input bg-background px-2 text-sm shadow-none"
+      >
+        <SelectValue placeholder="field" />
+      </SelectTrigger>
+      <SelectContent position="popper">
+        {isCustom && <SelectItem value={value}>{value}</SelectItem>}
+        {propertyFields.map((f) => (
+          <SelectItem key={f} value={f}>{f}</SelectItem>
+        ))}
+        {contentFields.length > 0 && (
+          <>
+            <SelectSeparator />
+            {contentFields.map((f) => (
+              <SelectItem key={f} value={f}>{f}</SelectItem>
+            ))}
+          </>
+        )}
+      </SelectContent>
+    </Select>
   )
 }
 
-/** Combobox-style value input with autocomplete for known values. */
-function ValueInput({ value, suggestions, onChange }: {
+function OperatorSelect({ value, onChange }: {
+  value: FilterOp
+  onChange: (v: FilterOp) => void
+}) {
+  return (
+    <Select value={value} onValueChange={(v) => onChange(v as FilterOp)}>
+      <SelectTrigger
+        size="sm"
+        className="h-8 shrink-0 gap-1 border-input bg-background px-2 text-sm shadow-none"
+        style={{ minWidth: 120 }}
+      >
+        <SelectValue />
+      </SelectTrigger>
+      <SelectContent position="popper">
+        {OPERATORS.map((o) => (
+          <SelectItem key={o.value} value={o.value}>{o.label}</SelectItem>
+        ))}
+      </SelectContent>
+    </Select>
+  )
+}
+
+const MAX_WIKILINK_RESULTS = 10
+const MIN_WIKILINK_QUERY = 2
+
+function entryMatchesQuery(e: VaultEntry, lowerQuery: string): boolean {
+  return e.title.toLowerCase().includes(lowerQuery) ||
+    e.aliases.some(a => a.toLowerCase().includes(lowerQuery))
+}
+
+function toWikilinkMatch(e: VaultEntry, typeEntryMap: Record<string, VaultEntry>) {
+  const isA = e.isA
+  const te = typeEntryMap[isA ?? '']
+  const noteType = isA || undefined
+  return {
+    title: e.title,
+    noteType,
+    typeColor: noteType ? getTypeColor(isA, te?.color) : undefined,
+    typeLightColor: noteType ? getTypeLightColor(isA, te?.color) : undefined,
+    TypeIcon: noteType ? getTypeIcon(isA, te?.icon) : undefined,
+  }
+}
+
+function matchWikilinkEntries(entries: VaultEntry[], typeEntryMap: Record<string, VaultEntry>, query: string) {
+  if (query.length < MIN_WIKILINK_QUERY) return []
+  const lowerQuery = query.toLowerCase()
+  return entries
+    .filter(e => !e.trashed && entryMatchesQuery(e, lowerQuery))
+    .slice(0, MAX_WIKILINK_RESULTS)
+    .map(e => toWikilinkMatch(e, typeEntryMap))
+}
+
+type WikilinkMatch = ReturnType<typeof toWikilinkMatch>
+
+function extractWikilinkQuery(value: string): string | null {
+  return value.startsWith('[[') ? value.slice(2).replace(/]]$/, '') : null
+}
+
+function useOutsideClick(refs: React.RefObject<HTMLElement | null>[], onClose: () => void) {
+  useEffect(() => {
+    const handler = (e: MouseEvent) => {
+      const target = e.target as Node
+      if (refs.every(r => !r.current?.contains(target))) onClose()
+    }
+    document.addEventListener('mousedown', handler)
+    return () => document.removeEventListener('mousedown', handler)
+  }, [refs, onClose])
+}
+
+function WikilinkDropdown({ matches, selectedIndex, onSelect, onHover, menuRef }: {
+  matches: WikilinkMatch[]
+  selectedIndex: number
+  onSelect: (title: string) => void
+  onHover: (index: number) => void
+  menuRef: React.RefObject<HTMLDivElement | null>
+}) {
+  return (
+    <div
+      className="wikilink-menu"
+      ref={menuRef}
+      style={{ position: 'absolute', top: '100%', left: 0, right: 0, marginTop: 2, zIndex: 50 }}
+      data-testid="wikilink-dropdown"
+    >
+      {matches.map((item, index) => (
+        <div
+          key={item.title}
+          className={`wikilink-menu__item${index === selectedIndex ? ' wikilink-menu__item--selected' : ''}`}
+          onMouseDown={e => e.preventDefault()}
+          onClick={() => onSelect(item.title)}
+          onMouseEnter={() => onHover(index)}
+        >
+          <span className="wikilink-menu__title" style={{ display: 'flex', alignItems: 'center', gap: 6 }}>
+            {item.TypeIcon && <item.TypeIcon width={14} height={14} style={{ color: item.typeColor, flexShrink: 0 }} />}
+            {item.title}
+          </span>
+          {item.noteType && (
+            <span className="wikilink-menu__type" style={{ color: item.typeColor, backgroundColor: item.typeLightColor, borderRadius: 9999, padding: '1px 8px' }}>
+              {item.noteType}
+            </span>
+          )}
+        </div>
+      ))}
+    </div>
+  )
+}
+
+function useWikilinkMatches(entries: VaultEntry[], value: string, open: boolean) {
+  const typeEntryMap = useMemo(() => buildTypeEntryMap(entries), [entries])
+  const wikilinkQuery = extractWikilinkQuery(value)
+  return useMemo(
+    () => (open && wikilinkQuery !== null) ? matchWikilinkEntries(entries, typeEntryMap, wikilinkQuery) : [],
+    [entries, typeEntryMap, wikilinkQuery, open],
+  )
+}
+
+function useScrollSelectedIntoView(menuRef: React.RefObject<HTMLDivElement | null>, selectedIndex: number) {
+  useEffect(() => {
+    if (selectedIndex < 0 || !menuRef.current) return
+    const el = menuRef.current.children[selectedIndex] as HTMLElement | undefined
+    el?.scrollIntoView?.({ block: 'nearest' })
+  }, [selectedIndex, menuRef])
+}
+
+function useDropdownKeyboard(
+  matches: WikilinkMatch[],
+  open: boolean,
+  onSelect: (title: string) => void,
+  onClose: () => void,
+) {
+  const [selectedIndex, setSelectedIndex] = useState(-1)
+
+  const resetIndex = useCallback(() => setSelectedIndex(-1), [])
+
+  const handleKeyDown = useCallback((e: React.KeyboardEvent) => {
+    if (!open || matches.length === 0) return
+    if (e.key === 'ArrowDown') {
+      e.preventDefault()
+      setSelectedIndex(i => (i + 1) % matches.length)
+    } else if (e.key === 'ArrowUp') {
+      e.preventDefault()
+      setSelectedIndex(i => (i <= 0 ? matches.length - 1 : i - 1))
+    } else if (e.key === 'Enter' && selectedIndex >= 0) {
+      e.preventDefault()
+      onSelect(matches[selectedIndex].title)
+    } else if (e.key === 'Escape') {
+      e.preventDefault()
+      onClose()
+    }
+  }, [open, matches, selectedIndex, onSelect, onClose])
+
+  return { selectedIndex, setSelectedIndex, resetIndex, handleKeyDown }
+}
+
+function WikilinkValueInput({ value, entries, onChange }: {
   value: string
-  suggestions: string[]
+  entries: VaultEntry[]
   onChange: (v: string) => void
 }) {
-  const id = useId()
+  const [open, setOpen] = useState(false)
+  const inputRef = useRef<HTMLInputElement>(null)
+  const menuRef = useRef<HTMLDivElement>(null)
+
+  const matches = useWikilinkMatches(entries, value, open)
+
+  const handleSelect = useCallback((title: string) => {
+    onChange(`[[${title}]]`)
+    setOpen(false)
+  }, [onChange])
+
+  const closeMenu = useCallback(() => setOpen(false), [])
+  useOutsideClick([inputRef, menuRef], closeMenu)
+
+  const { selectedIndex, setSelectedIndex, resetIndex, handleKeyDown } =
+    useDropdownKeyboard(matches, open, handleSelect, closeMenu)
+
+  useScrollSelectedIntoView(menuRef, selectedIndex)
+
+  const handleChange = useCallback((e: React.ChangeEvent<HTMLInputElement>) => {
+    onChange(e.target.value)
+    setOpen(e.target.value.startsWith('[['))
+    resetIndex()
+  }, [onChange, resetIndex])
+
   return (
-    <>
-      <input
-        list={id}
-        className="h-8 rounded-md border border-input bg-background px-2 text-sm flex-1 min-w-0"
+    <div style={{ position: 'relative' }} className="flex-1 min-w-0">
+      <Input
+        ref={inputRef}
+        className="h-8 w-full text-sm"
         placeholder="value"
         value={value}
-        onChange={(e) => onChange(e.target.value)}
+        onChange={handleChange}
+        onFocus={() => { if (value.startsWith('[[')) setOpen(true) }}
+        onKeyDown={handleKeyDown}
+        data-testid="filter-value-input"
       />
-      <datalist id={id}>
-        {suggestions.map((s) => <option key={s} value={s} />)}
-      </datalist>
-    </>
+      {open && matches.length > 0 && (
+        <WikilinkDropdown
+          matches={matches}
+          selectedIndex={selectedIndex}
+          onSelect={handleSelect}
+          onHover={setSelectedIndex}
+          menuRef={menuRef}
+        />
+      )}
+    </div>
   )
 }
 
-function FilterRow({ condition, fields, valueSuggestions, onUpdate, onRemove }: {
+function ValueInput({ value, suggestions, isDateOp, entries, onChange }: {
+  value: string
+  suggestions: string[]
+  isDateOp: boolean
+  entries: VaultEntry[]
+  onChange: (v: string) => void
+}) {
+  if (isDateOp) {
+    return (
+      <Input
+        type="date"
+        className="h-8 flex-1 min-w-0 text-sm"
+        value={value}
+        onChange={(e) => onChange(e.target.value)}
+      />
+    )
+  }
+
+  if (suggestions.length > 0) {
+    return (
+      <Select value={value} onValueChange={onChange}>
+        <SelectTrigger
+          size="sm"
+          className="h-8 flex-1 min-w-0 gap-1 border-input bg-background px-2 text-sm shadow-none"
+        >
+          <SelectValue placeholder="value" />
+        </SelectTrigger>
+        <SelectContent position="popper">
+          {value !== '' && !suggestions.includes(value) && (
+            <SelectItem value={value}>{value}</SelectItem>
+          )}
+          {suggestions.map((s) => (
+            <SelectItem key={s} value={s}>{s}</SelectItem>
+          ))}
+        </SelectContent>
+      </Select>
+    )
+  }
+
+  if (entries.length > 0) {
+    return <WikilinkValueInput value={value} entries={entries} onChange={onChange} />
+  }
+
+  return (
+    <Input
+      className="h-8 flex-1 min-w-0 text-sm"
+      placeholder="value"
+      value={value}
+      onChange={(e) => onChange(e.target.value)}
+    />
+  )
+}
+
+function FilterRow({ condition, fields, entries, valueSuggestions, onUpdate, onRemove }: {
   condition: FilterCondition
   fields: string[]
+  entries: VaultEntry[]
   valueSuggestions: (field: string) => string[]
   onUpdate: (c: FilterCondition) => void
   onRemove: () => void
 }) {
   const suggestions = valueSuggestions(condition.field)
+  const isDateOp = DATE_OPS.has(condition.op)
   return (
     <div className="flex items-center gap-1.5">
-      <FieldInput
+      <FieldSelect
         value={condition.field}
         fields={fields}
         onChange={(v) => onUpdate({ ...condition, field: v })}
       />
-      <select
-        className="h-8 rounded-md border border-input bg-background px-2 text-sm shrink-0"
+      <OperatorSelect
         value={condition.op}
-        onChange={(e) => onUpdate({ ...condition, op: e.target.value as FilterOp })}
-      >
-        {OPERATORS.map((o) => (
-          <option key={o.value} value={o.value}>{o.label}</option>
-        ))}
-      </select>
+        onChange={(op) => onUpdate({ ...condition, op })}
+      />
       {!NO_VALUE_OPS.has(condition.op) && (
         <ValueInput
           value={String(condition.value ?? '')}
           suggestions={suggestions}
+          isDateOp={isDateOp}
+          entries={entries}
           onChange={(v) => onUpdate({ ...condition, value: v })}
         />
       )}
-      <button
+      <Button
         type="button"
-        className="flex-shrink-0 rounded p-1 text-muted-foreground hover:text-foreground"
+        variant="ghost"
+        size="sm"
+        className="h-8 w-8 shrink-0 p-0 text-muted-foreground hover:text-foreground"
         onClick={onRemove}
         title="Remove filter"
       >
         <X size={14} />
-      </button>
+      </Button>
     </div>
   )
 }
 
-function FilterGroupView({ group, fields, valueSuggestions, depth, onChange, onRemove }: {
+function FilterGroupView({ group, fields, entries, valueSuggestions, depth, onChange, onRemove }: {
   group: FilterGroup
   fields: string[]
+  entries: VaultEntry[]
   valueSuggestions: (field: string) => string[]
   depth: number
   onChange: (g: FilterGroup) => void
@@ -159,26 +418,30 @@ function FilterGroupView({ group, fields, valueSuggestions, depth, onChange, onR
   return (
     <div className={depth > 0 ? 'ml-3 border-l-2 border-border pl-3 py-1' : ''}>
       <div className="flex items-center gap-2 mb-2">
-        <button
+        <Button
           type="button"
-          className="rounded-full border border-input bg-muted px-2.5 py-0.5 text-[11px] font-medium text-foreground cursor-pointer hover:bg-accent transition-colors"
+          variant="outline"
+          size="sm"
+          className="h-6 rounded-full px-2.5 text-[11px] font-medium"
           onClick={toggleMode}
           title={`Switch to ${mode === 'all' ? 'OR' : 'AND'}`}
         >
           {mode === 'all' ? 'AND' : 'OR'}
-        </button>
+        </Button>
         <span className="text-[11px] text-muted-foreground">
           {mode === 'all' ? 'Match all conditions' : 'Match any condition'}
         </span>
         {onRemove && (
-          <button
+          <Button
             type="button"
-            className="ml-auto rounded p-0.5 text-muted-foreground hover:text-foreground"
+            variant="ghost"
+            size="sm"
+            className="ml-auto h-6 w-6 p-0 text-muted-foreground hover:text-foreground"
             onClick={onRemove}
             title="Remove group"
           >
             <X size={12} />
-          </button>
+          </Button>
         )}
       </div>
       <div className="space-y-2">
@@ -188,6 +451,7 @@ function FilterGroupView({ group, fields, valueSuggestions, depth, onChange, onR
               key={i}
               group={child}
               fields={fields}
+              entries={entries}
               valueSuggestions={valueSuggestions}
               depth={depth + 1}
               onChange={(g) => updateChild(i, g)}
@@ -198,6 +462,7 @@ function FilterGroupView({ group, fields, valueSuggestions, depth, onChange, onR
               key={i}
               condition={child}
               fields={fields}
+              entries={entries}
               valueSuggestions={valueSuggestions}
               onUpdate={(c) => updateChild(i, c)}
               onRemove={() => removeChild(i)}
@@ -223,16 +488,19 @@ export interface FilterBuilderProps {
   availableFields: string[]
   /** Returns known values for a given field (for autocomplete). */
   valueSuggestions?: (field: string) => string[]
+  /** Vault entries for wikilink autocomplete in value fields. */
+  entries?: VaultEntry[]
 }
 
 const defaultSuggestions = () => [] as string[]
 
-export function FilterBuilder({ group, onChange, availableFields, valueSuggestions }: FilterBuilderProps) {
+export function FilterBuilder({ group, onChange, availableFields, valueSuggestions, entries }: FilterBuilderProps) {
   const fields = availableFields.length > 0 ? availableFields : ['type']
   return (
     <FilterGroupView
       group={group}
       fields={fields}
+      entries={entries ?? []}
       valueSuggestions={valueSuggestions ?? defaultSuggestions}
       depth={0}
       onChange={onChange}

src/components/FolderTree.tsx

@@ -8,6 +8,8 @@ interface FolderTreeProps {
   selection: SidebarSelection
   onSelect: (selection: SidebarSelection) => void
   onCreateFolder?: (name: string) => void
+  collapsed?: boolean
+  onToggle?: () => void
 }
 
 function FolderItem({
@@ -72,8 +74,9 @@ function FolderItem({
   )
 }
 
-export const FolderTree = memo(function FolderTree({ folders, selection, onSelect, onCreateFolder }: FolderTreeProps) {
-  const [sectionCollapsed, setSectionCollapsed] = useState(false)
+export const FolderTree = memo(function FolderTree({ folders, selection, onSelect, onCreateFolder, collapsed: externalCollapsed, onToggle }: FolderTreeProps) {
+  const [internalCollapsed, setInternalCollapsed] = useState(false)
+  const sectionCollapsed = externalCollapsed ?? internalCollapsed
   const [expanded, setExpanded] = useState<Record<string, boolean>>({})
   const [isCreating, setIsCreating] = useState(false)
   const [newFolderName, setNewFolderName] = useState('')
@@ -99,12 +102,12 @@ export const FolderTree = memo(function FolderTree({ folders, selection, onSelec
   if (folders.length === 0 && !isCreating) return null
 
   return (
-    <div style={{ padding: '8px 0' }}>
+    <div style={{ padding: '4px 6px' }}>
       {/* Header */}
       <button
         className="flex w-full cursor-pointer select-none items-center justify-between border-none bg-transparent text-muted-foreground"
         style={{ padding: '6px 14px 6px 16px' }}
-        onClick={() => setSectionCollapsed((v) => !v)}
+        onClick={() => onToggle ? onToggle() : setInternalCollapsed((v) => !v)}
       >
         <div className="flex items-center gap-1">
           {sectionCollapsed ? <CaretRight size={12} /> : <CaretDown size={12} />}
@@ -114,7 +117,7 @@ export const FolderTree = memo(function FolderTree({ folders, selection, onSelec
           <Plus
             size={12}
             className="text-muted-foreground hover:text-foreground"
-            onClick={(e) => { e.stopPropagation(); setIsCreating(true); setSectionCollapsed(false) }}
+            onClick={(e) => { e.stopPropagation(); setIsCreating(true); if (sectionCollapsed && onToggle) onToggle(); else if (sectionCollapsed) setInternalCollapsed(false) }}
             data-testid="create-folder-btn"
           />
         )}

src/components/Inspector.tsx

@@ -6,7 +6,7 @@ import { SlidersHorizontal, X, Sparkle, WarningCircle, PencilSimple } from '@pho
 import { Separator } from './ui/separator'
 import { parseFrontmatter, detectFrontmatterState } from '../utils/frontmatter'
 import { DynamicPropertiesPanel } from './DynamicPropertiesPanel'
-import { DynamicRelationshipsPanel, BacklinksPanel, ReferencedByPanel, GitHistoryPanel, InstancesPanel } from './InspectorPanels'
+import { DynamicRelationshipsPanel, BacklinksPanel, ReferencedByPanel, GitHistoryPanel, InstancesPanel, NoteInfoPanel } from './InspectorPanels'
 import { wikilinkTarget } from '../utils/wikilink'
 import type { ReferencedByItem, BacklinkItem } from './InspectorPanels'
 
@@ -189,7 +189,7 @@ export function Inspector({
               {fmState === 'valid' ? (
                 <>
                   <DynamicPropertiesPanel
-                    entry={entry} content={content} frontmatter={frontmatter}
+                    entry={entry} frontmatter={frontmatter}
                     entries={entries}
                     onUpdateProperty={onUpdateFrontmatter ? handleUpdateProperty : undefined}
                     onDeleteProperty={onDeleteProperty ? handleDeleteProperty : undefined}
@@ -213,6 +213,8 @@ export function Inspector({
               )}
               {backlinks.length > 0 && <Separator />}
               <BacklinksPanel backlinks={backlinks} onNavigate={onNavigate} />
+              <Separator />
+              <NoteInfoPanel entry={entry} content={content} />
               {gitHistory.length > 0 && <Separator />}
               <GitHistoryPanel commits={gitHistory} onViewCommitDiff={onViewCommitDiff} />
             </>

src/components/InspectorPanels.test.tsx

@@ -139,7 +139,7 @@ describe('DynamicRelationshipsPanel', () => {
     expect(screen.getByText('Luca')).toBeInTheDocument()
   })
 
-  it('renders + Link existing button when onAddProperty provided', () => {
+  it('renders + Add relationship button when onAddProperty provided', () => {
     render(
       <DynamicRelationshipsPanel
         typeEntryMap={{}}
@@ -149,7 +149,7 @@ describe('DynamicRelationshipsPanel', () => {
         onAddProperty={onAddProperty}
       />
     )
-    expect(screen.getByText('+ Link existing')).toBeInTheDocument()
+    expect(screen.getByText('+ Add relationship')).toBeInTheDocument()
   })
 
   it('opens add relationship form when button clicked', () => {
@@ -162,7 +162,7 @@ describe('DynamicRelationshipsPanel', () => {
         onAddProperty={onAddProperty}
       />
     )
-    fireEvent.click(screen.getByText('+ Link existing'))
+    fireEvent.click(screen.getByText('+ Add relationship'))
     expect(screen.getByPlaceholderText('Relationship name')).toBeInTheDocument()
     expect(screen.getByPlaceholderText('Note title')).toBeInTheDocument()
   })
@@ -177,7 +177,7 @@ describe('DynamicRelationshipsPanel', () => {
         onAddProperty={onAddProperty}
       />
     )
-    fireEvent.click(screen.getByText('+ Link existing'))
+    fireEvent.click(screen.getByText('+ Add relationship'))
     fireEvent.change(screen.getByPlaceholderText('Relationship name'), { target: { value: 'Related to' } })
     fireEvent.change(screen.getByPlaceholderText('Note title'), { target: { value: 'AI' } })
     fireEvent.click(screen.getByText('Add'))
@@ -194,9 +194,55 @@ describe('DynamicRelationshipsPanel', () => {
         onAddProperty={onAddProperty}
       />
     )
-    fireEvent.click(screen.getByText('+ Link existing'))
+    fireEvent.click(screen.getByText('+ Add relationship'))
     fireEvent.click(screen.getByText('Cancel'))
-    expect(screen.getByText('+ Link existing')).toBeInTheDocument()
+    expect(screen.getByText('+ Add relationship')).toBeInTheDocument()
+  })
+
+  describe('suggested relationship slots', () => {
+    it('shows Belongs to/Related to/Has slots when no relationships exist', () => {
+      render(
+        <DynamicRelationshipsPanel
+          typeEntryMap={{}}
+          frontmatter={{}}
+          entries={entries}
+          onNavigate={onNavigate}
+          onAddProperty={onAddProperty}
+        />
+      )
+      const slots = screen.getAllByTestId('suggested-relationship')
+      expect(slots.length).toBe(3)
+      expect(screen.getByText('Belongs to')).toBeInTheDocument()
+      expect(screen.getByText('Related to')).toBeInTheDocument()
+      expect(screen.getByText('Has')).toBeInTheDocument()
+    })
+
+    it('hides slot when relationship already exists', () => {
+      render(
+        <DynamicRelationshipsPanel
+          typeEntryMap={{}}
+          frontmatter={{ 'Belongs to': '[[Project Alpha]]' }}
+          entries={entries}
+          onNavigate={onNavigate}
+          onAddProperty={onAddProperty}
+        />
+      )
+      const slots = screen.getAllByTestId('suggested-relationship')
+      expect(slots.length).toBe(2)
+      expect(screen.queryAllByText('Belongs to').every(el => !el.closest('[data-testid="suggested-relationship"]'))).toBe(true)
+    })
+
+    it('does not show slots when onAddProperty not provided', () => {
+      render(
+        <DynamicRelationshipsPanel
+          typeEntryMap={{}}
+          frontmatter={{}}
+          entries={entries}
+          onNavigate={onNavigate}
+        />
+      )
+      expect(screen.queryByTestId('suggested-relationship')).not.toBeInTheDocument()
+    })
   })
 
   it('dims archived entries', () => {
@@ -591,7 +637,7 @@ describe('DynamicRelationshipsPanel', () => {
           onCreateAndOpenNote={onCreateAndOpenNote}
         />
       )
-      fireEvent.click(screen.getByText('+ Link existing'))
+      fireEvent.click(screen.getByText('+ Add relationship'))
       fireEvent.change(screen.getByPlaceholderText('Relationship name'), { target: { value: 'Mentions' } })
       const noteInput = screen.getByPlaceholderText('Note title')
       fireEvent.focus(noteInput)
@@ -610,7 +656,7 @@ describe('DynamicRelationshipsPanel', () => {
           onCreateAndOpenNote={onCreateAndOpenNote}
         />
       )
-      fireEvent.click(screen.getByText('+ Link existing'))
+      fireEvent.click(screen.getByText('+ Add relationship'))
       fireEvent.change(screen.getByPlaceholderText('Relationship name'), { target: { value: 'Mentions' } })
       const noteInput = screen.getByPlaceholderText('Note title')
       fireEvent.focus(noteInput)

src/components/InspectorPanels.tsx

@@ -5,3 +5,4 @@ export { ReferencedByPanel } from './inspector/ReferencedByPanel'
 export type { ReferencedByItem } from './inspector/ReferencedByPanel'
 export { GitHistoryPanel } from './inspector/GitHistoryPanel'
 export { InstancesPanel } from './inspector/InstancesPanel'
+export { NoteInfoPanel } from './inspector/NoteInfoPanel'

src/components/NoteItem.test.tsx

@@ -0,0 +1,118 @@
+import { render, screen } from '@testing-library/react'
+import { describe, it, expect, vi } from 'vitest'
+import { NoteItem } from './NoteItem'
+import type { VaultEntry } from '../types'
+
+vi.mock('../mock-tauri', () => ({ isTauri: () => false, mockInvoke: vi.fn() }))
+
+function makeEntry(overrides: Partial<VaultEntry> = {}): VaultEntry {
+  return {
+    path: '/vault/test.md', filename: 'test.md', title: 'Test Note',
+    isA: 'Movie', aliases: [], belongsTo: [], relatedTo: [],
+    status: null, archived: false, trashed: false, trashedAt: null,
+    modifiedAt: 1700000000, createdAt: null, fileSize: 100,
+    snippet: 'A snippet', wordCount: 50,
+    relationships: {}, icon: null, color: null, order: null,
+    sidebarLabel: null, template: null, sort: null, view: null,
+    visible: null, favorite: false, favoriteIndex: null,
+    outgoingLinks: [], properties: {},
+    listPropertiesDisplay: [],
+    ...overrides,
+  }
+}
+
+function makeTypeEntry(overrides: Partial<VaultEntry> = {}): VaultEntry {
+  return makeEntry({
+    path: '/vault/movie.md', filename: 'movie.md', title: 'Movie',
+    isA: 'Type', listPropertiesDisplay: [],
+    ...overrides,
+  })
+}
+
+const noop = vi.fn()
+
+describe('NoteItem property chips', () => {
+  it('renders property chips when type has listPropertiesDisplay', () => {
+    const entry = makeEntry({
+      properties: { rating: 4, genre: 'Drama' },
+    })
+    const typeEntry = makeTypeEntry({ listPropertiesDisplay: ['rating', 'genre'] })
+
+    render(
+      <NoteItem entry={entry} isSelected={false} noteStatus="clean"
+        typeEntryMap={{ Movie: typeEntry }} onClickNote={noop} />
+    )
+
+    expect(screen.getByTestId('property-chips')).toBeInTheDocument()
+    expect(screen.getByText('4')).toBeInTheDocument()
+    expect(screen.getByText('Drama')).toBeInTheDocument()
+  })
+
+  it('does not render chips when listPropertiesDisplay is empty', () => {
+    const entry = makeEntry({ properties: { rating: 4 } })
+    const typeEntry = makeTypeEntry({ listPropertiesDisplay: [] })
+
+    render(
+      <NoteItem entry={entry} isSelected={false} noteStatus="clean"
+        typeEntryMap={{ Movie: typeEntry }} onClickNote={noop} />
+    )
+
+    expect(screen.queryByTestId('property-chips')).not.toBeInTheDocument()
+  })
+
+  it('skips chips for missing properties', () => {
+    const entry = makeEntry({ properties: { rating: 4 } })
+    const typeEntry = makeTypeEntry({ listPropertiesDisplay: ['rating', 'genre'] })
+
+    render(
+      <NoteItem entry={entry} isSelected={false} noteStatus="clean"
+        typeEntryMap={{ Movie: typeEntry }} onClickNote={noop} />
+    )
+
+    expect(screen.getByText('4')).toBeInTheDocument()
+    expect(screen.queryByText('genre')).not.toBeInTheDocument()
+  })
+
+  it('renders relationship values as display labels', () => {
+    const entry = makeEntry({
+      relationships: { Director: ['[[spielberg|Steven Spielberg]]'] },
+    })
+    const typeEntry = makeTypeEntry({ listPropertiesDisplay: ['Director'] })
+
+    render(
+      <NoteItem entry={entry} isSelected={false} noteStatus="clean"
+        typeEntryMap={{ Movie: typeEntry }} onClickNote={noop} />
+    )
+
+    expect(screen.getByText('Steven Spielberg')).toBeInTheDocument()
+  })
+
+  it('shows hostname for URL properties', () => {
+    const entry = makeEntry({
+      properties: { url: 'https://www.example.com/page/123' },
+    })
+    const typeEntry = makeTypeEntry({ listPropertiesDisplay: ['url'] })
+
+    render(
+      <NoteItem entry={entry} isSelected={false} noteStatus="clean"
+        typeEntryMap={{ Movie: typeEntry }} onClickNote={noop} />
+    )
+
+    expect(screen.getByText('www.example.com')).toBeInTheDocument()
+  })
+
+  it('does not render chips for binary files', () => {
+    const entry = makeEntry({
+      fileKind: 'binary',
+      properties: { rating: 4 },
+    })
+    const typeEntry = makeTypeEntry({ listPropertiesDisplay: ['rating'] })
+
+    render(
+      <NoteItem entry={entry} isSelected={false} noteStatus="clean"
+        typeEntryMap={{ Movie: typeEntry }} onClickNote={noop} />
+    )
+
+    expect(screen.queryByTestId('property-chips')).not.toBeInTheDocument()
+  })
+})

src/components/NoteItem.tsx

@@ -10,6 +10,7 @@ import { getTypeColor, getTypeLightColor } from '../utils/typeColors'
 import { resolveIcon } from '../utils/iconRegistry'
 import { relativeDate, getDisplayDate } from '../utils/noteListHelpers'
 import { isEmoji } from '../utils/emoji'
+import { wikilinkDisplay } from '../utils/wikilink'
 
 const TYPE_ICON_MAP: Record<string, ComponentType<SVGAttributes<SVGSVGElement>>> = {
   Project: Wrench,
@@ -85,6 +86,59 @@ function StateBadge({ archived, trashed }: { archived: boolean; trashed: boolean
   return null
 }
 
+function formatChipValue(value: unknown): string | null {
+  if (value === null || value === undefined || value === '') return null
+  const s = String(value)
+  // URL: show only hostname
+  try {
+    if (s.startsWith('http://') || s.startsWith('https://')) return new URL(s).hostname
+  } catch { /* not a URL */ }
+  return s.length > 40 ? s.slice(0, 37) + '…' : s
+}
+
+function resolveChipValues(entry: VaultEntry, propName: string): string[] {
+  // Check relationships first (wikilink values)
+  const relKey = Object.keys(entry.relationships).find((k) => k.toLowerCase() === propName.toLowerCase())
+  if (relKey) {
+    return entry.relationships[relKey].map((ref) => wikilinkDisplay(ref)).filter(Boolean)
+  }
+  // Check scalar properties
+  const propKey = Object.keys(entry.properties).find((k) => k.toLowerCase() === propName.toLowerCase())
+  if (!propKey) return []
+  const val = entry.properties[propKey]
+  if (Array.isArray(val)) return val.map((v) => formatChipValue(v)).filter((v): v is string => v !== null)
+  const formatted = formatChipValue(val)
+  return formatted ? [formatted] : []
+}
+
+function PropertyChips({ entry, displayProps }: { entry: VaultEntry; displayProps: string[] }) {
+  const chips = useMemo(() => {
+    const result: { key: string; values: string[] }[] = []
+    for (const prop of displayProps) {
+      const values = resolveChipValues(entry, prop)
+      if (values.length > 0) result.push({ key: prop, values })
+    }
+    return result
+  }, [entry, displayProps])
+
+  if (chips.length === 0) return null
+
+  return (
+    <div className="mt-1 flex flex-wrap gap-1" data-testid="property-chips">
+      {chips.map(({ key, values }) =>
+        values.map((v, i) => (
+          <span
+            key={`${key}-${i}`}
+            className="inline-block max-w-full truncate rounded-md bg-muted px-1.5 py-0.5 text-[10px] text-muted-foreground"
+          >
+            {v}
+          </span>
+        ))
+      )}
+    </div>
+  )
+}
+
 function noteItemStyle(isSelected: boolean, isMultiSelected: boolean, typeColor: string, typeLightColor: string): React.CSSProperties {
   const base: React.CSSProperties = { padding: isSelected && !isMultiSelected ? '14px 16px 14px 13px' : '14px 16px' }
   if (isMultiSelected) base.backgroundColor = 'color-mix(in srgb, var(--accent-blue) 10%, transparent)'
@@ -153,6 +207,9 @@ export function NoteItem({ entry, isSelected, isMultiSelected = false, isHighlig
           {entry.snippet}
         </div>
       )}
+      {!isBinary && te?.listPropertiesDisplay && te.listPropertiesDisplay.length > 0 && (
+        <PropertyChips entry={entry} displayProps={te.listPropertiesDisplay} />
+      )}
       {!isBinary && (entry.trashed && entry.trashedAt
         ? <TrashDateLine entry={entry} />
         : <div className="mt-0.5 text-[10px] text-muted-foreground">{relativeDate(getDisplayDate(entry))}</div>

src/components/NoteList.tsx

@@ -1,7 +1,7 @@
 import { useState, useMemo, useCallback, useEffect, memo } from 'react'
 import type { VaultEntry, SidebarSelection, ModifiedFile, NoteStatus, InboxPeriod, ViewFile } from '../types'
 import type { NoteListFilter } from '../utils/noteListHelpers'
-import { countByFilter, countAllByFilter, countInboxByPeriod } from '../utils/noteListHelpers'
+import { countByFilter, countAllByFilter } from '../utils/noteListHelpers'
 import { NoteItem } from './NoteItem'
 import { prefetchNoteContent } from '../hooks/useTabManagement'
 import { BulkActionBar } from './BulkActionBar'
@@ -9,7 +9,6 @@ import { useMultiSelect } from '../hooks/useMultiSelect'
 import { useNoteListKeyboard } from '../hooks/useNoteListKeyboard'
 import { NoteListHeader } from './note-list/NoteListHeader'
 import { FilterPills } from './note-list/FilterPills'
-import { InboxFilterPills } from './note-list/InboxFilterPills'
 import { EntityView, ListView } from './note-list/NoteListViews'
 import { DeletedNotesBanner } from './note-list/TrashWarningBanner'
 import { routeNoteClick, toggleSetMember, resolveHeaderTitle } from './note-list/noteListUtils'
@@ -44,7 +43,7 @@ interface NoteListProps {
   views?: ViewFile[]
 }
 
-function NoteListInner({ entries, selection, selectedNote, noteListFilter, onNoteListFilterChange, inboxPeriod = 'month', onInboxPeriodChange, modifiedFiles, modifiedFilesError, getNoteStatus, sidebarCollapsed, onSelectNote, onReplaceActiveTab, onCreateNote, onBulkArchive, onBulkTrash, onBulkRestore, onBulkDeletePermanently, onEmptyTrash, onUpdateTypeSort, updateEntry, onOpenInNewWindow, views }: NoteListProps) {
+function NoteListInner({ entries, selection, selectedNote, noteListFilter, onNoteListFilterChange, inboxPeriod = 'all', modifiedFiles, modifiedFilesError, getNoteStatus, sidebarCollapsed, onSelectNote, onReplaceActiveTab, onCreateNote, onBulkArchive, onBulkTrash, onBulkRestore, onBulkDeletePermanently, onEmptyTrash, onUpdateTypeSort, updateEntry, onOpenInNewWindow, views }: NoteListProps) {
   const { modifiedPathSet, modifiedSuffixes, resolvedGetNoteStatus } = useModifiedFilesState(modifiedFiles, getNoteStatus)
 
   const isSectionGroup = selection.kind === 'sectionGroup'
@@ -59,11 +58,6 @@ function NoteListInner({ entries, selection, selectedNote, noteListFilter, onNot
     [entries, isSectionGroup, isAllNotesView, isFolderView, selection],
   )
 
-  const inboxCounts = useMemo(
-    () => isInboxView ? countInboxByPeriod(entries) : { week: 0, month: 0, quarter: 0, all: 0 },
-    [entries, isInboxView],
-  )
-
   const { listSort, listDirection, customProperties, handleSortChange, sortPrefs, typeDocument } = useNoteListSort({ entries, selection, modifiedPathSet, modifiedSuffixes, subFilter, inboxPeriod: isInboxView ? inboxPeriod : undefined, onUpdateTypeSort, updateEntry })
   const { search, setSearch, query, searchVisible, toggleSearch } = useNoteListSearch()
   const [collapsedGroups, setCollapsedGroups] = useState<Set<string>>(new Set())
@@ -106,7 +100,7 @@ function NoteListInner({ entries, selection, selectedNote, noteListFilter, onNot
 
   return (
     <div className="flex flex-col select-none overflow-hidden border-r border-border bg-card text-foreground" style={{ height: '100%' }}>
-      <NoteListHeader title={title} typeDocument={typeDocument} isEntityView={isEntityView} isTrashView={isTrashView} trashCount={searched.length} listSort={listSort} listDirection={listDirection} customProperties={customProperties} sidebarCollapsed={sidebarCollapsed} searchVisible={searchVisible} search={search} onSortChange={handleSortChange} onCreateNote={handleCreateNote} onOpenType={onReplaceActiveTab} onToggleSearch={toggleSearch} onSearchChange={setSearch} onEmptyTrash={onEmptyTrash} />
+      <NoteListHeader title={title} typeDocument={typeDocument} isEntityView={isEntityView} isTrashView={isTrashView} trashCount={searched.length} listSort={listSort} listDirection={listDirection} customProperties={customProperties} sidebarCollapsed={sidebarCollapsed} searchVisible={searchVisible} search={search} isSectionGroup={isSectionGroup} entries={entries} onSortChange={handleSortChange} onCreateNote={handleCreateNote} onOpenType={onReplaceActiveTab} onToggleSearch={toggleSearch} onSearchChange={setSearch} onEmptyTrash={onEmptyTrash} onUpdateTypeProperty={onUpdateTypeSort} />
       <div className="relative flex flex-1 flex-col overflow-hidden outline-none" style={{ minHeight: 0 }} tabIndex={0} onKeyDown={noteListKeyboard.handleKeyDown} onFocus={noteListKeyboard.handleFocus} data-testid="note-list-container">
         <div className="flex-1 overflow-hidden" style={{ minHeight: 0 }}>
           {entitySelection ? (
@@ -117,7 +111,6 @@ function NoteListInner({ entries, selection, selectedNote, noteListFilter, onNot
         </div>
         {isChangesView && deletedCount > 0 && <DeletedNotesBanner count={deletedCount} />}
         {showFilterPills && <FilterPills active={noteListFilter} counts={filterCounts} onChange={onNoteListFilterChange} position="bottom" />}
-        {isInboxView && onInboxPeriodChange && <InboxFilterPills active={inboxPeriod} counts={inboxCounts} onChange={onInboxPeriodChange} position="bottom" />}
       </div>
       {multiSelect.isMultiSelecting && (
         <BulkActionBar count={multiSelect.selectedPaths.size} isTrashView={isTrashView} isArchivedView={isArchivedView} onArchive={handleBulkArchive} onTrash={handleBulkTrash} onRestore={handleBulkRestore} onDeletePermanently={handleBulkDeletePermanently} onUnarchive={handleBulkUnarchive} onClear={multiSelect.clear} />

src/components/RawEditorView.tsx

@@ -1,4 +1,5 @@
 import { useRef, useState, useCallback, useEffect, useMemo } from 'react'
+import { trackEvent } from '../lib/telemetry'
 import type { EditorView } from '@codemirror/view'
 import { preFilterWikilinks, deduplicateByPath, MIN_QUERY_LENGTH } from '../utils/wikilinkSuggestions'
 import { attachClickHandlers, enrichSuggestionItems } from '../utils/suggestionEnrichment'
@@ -136,6 +137,7 @@ export function RawEditorView({ content, path, entries, onContentChange, onSave,
       changes: { from: 0, to: doc.length, insert: newText },
       selection: { anchor: newCursor },
     })
+    trackEvent('wikilink_inserted')
     setAutocomplete(null)
 
     if (debounceRef.current) clearTimeout(debounceRef.current)

src/components/SettingsPanel.test.tsx

@@ -28,7 +28,7 @@ const emptySettings: Settings = {
   crash_reporting_enabled: null,
   analytics_enabled: null,
   anonymous_id: null,
-  update_channel: null,
+  release_channel: null,
 }
 
 const populatedSettings: Settings = {
@@ -41,7 +41,7 @@ const populatedSettings: Settings = {
   crash_reporting_enabled: null,
   analytics_enabled: null,
   anonymous_id: null,
-  update_channel: null,
+  release_channel: null,
 }
 
 describe('SettingsPanel', () => {
@@ -405,56 +405,6 @@ describe('SettingsPanel', () => {
     })
   })
 
-  describe('Update channel section', () => {
-    it('renders the update channel dropdown', () => {
-      render(
-        <SettingsPanel open={true} settings={emptySettings} onSave={onSave} onClose={onClose} />
-      )
-      expect(screen.getByTestId('settings-update-channel')).toBeInTheDocument()
-      expect(screen.getByText('Updates')).toBeInTheDocument()
-    })
-
-    it('defaults to stable when update_channel is null', () => {
-      render(
-        <SettingsPanel open={true} settings={emptySettings} onSave={onSave} onClose={onClose} />
-      )
-      const select = screen.getByTestId('settings-update-channel') as HTMLSelectElement
-      expect(select.value).toBe('stable')
-    })
-
-    it('reflects canary setting', () => {
-      const canarySettings: Settings = { ...emptySettings, update_channel: 'canary' }
-      render(
-        <SettingsPanel open={true} settings={canarySettings} onSave={onSave} onClose={onClose} />
-      )
-      const select = screen.getByTestId('settings-update-channel') as HTMLSelectElement
-      expect(select.value).toBe('canary')
-    })
-
-    it('saves update_channel when changed to canary', () => {
-      render(
-        <SettingsPanel open={true} settings={emptySettings} onSave={onSave} onClose={onClose} />
-      )
-      fireEvent.change(screen.getByTestId('settings-update-channel'), { target: { value: 'canary' } })
-      fireEvent.click(screen.getByTestId('settings-save'))
-
-      expect(onSave).toHaveBeenCalledWith(expect.objectContaining({
-        update_channel: 'canary',
-      }))
-    })
-
-    it('saves null when channel is stable (default)', () => {
-      render(
-        <SettingsPanel open={true} settings={emptySettings} onSave={onSave} onClose={onClose} />
-      )
-      fireEvent.click(screen.getByTestId('settings-save'))
-
-      expect(onSave).toHaveBeenCalledWith(expect.objectContaining({
-        update_channel: null,
-      }))
-    })
-  })
-
   describe('Privacy & Telemetry section', () => {
     it('renders crash reporting and analytics toggles', () => {
       render(

src/components/SettingsPanel.tsx

@@ -2,6 +2,7 @@ import { useState, useRef, useCallback, useEffect } from 'react'
 import { X, Eye, EyeSlash, GithubLogo, SignOut } from '@phosphor-icons/react'
 import { GitHubDeviceFlow } from './GitHubDeviceFlow'
 import type { Settings } from '../types'
+import { trackEvent } from '../lib/telemetry'
 
 interface SettingsPanelProps {
   open: boolean
@@ -124,7 +125,7 @@ function SettingsPanelInner({ settings, onSave, onClose }: Omit<SettingsPanelPro
   const [githubToken, setGithubToken] = useState(settings.github_token)
   const [githubUsername, setGithubUsername] = useState(settings.github_username)
   const [pullInterval, setPullInterval] = useState(settings.auto_pull_interval_minutes ?? 5)
-  const [updateChannel, setUpdateChannel] = useState(settings.update_channel ?? 'stable')
+  const [releaseChannel, setReleaseChannel] = useState(settings.release_channel ?? 'stable')
   const [crashReporting, setCrashReporting] = useState(settings.crash_reporting_enabled ?? false)
   const [analytics, setAnalytics] = useState(settings.analytics_enabled ?? false)
   const panelRef = useRef<HTMLDivElement>(null)
@@ -148,10 +149,14 @@ function SettingsPanelInner({ settings, onSave, onClose }: Omit<SettingsPanelPro
     crash_reporting_enabled: crashReporting,
     analytics_enabled: analytics,
     anonymous_id: (crashReporting || analytics) ? (settings.anonymous_id ?? crypto.randomUUID()) : settings.anonymous_id,
-    update_channel: updateChannel === 'stable' ? null : updateChannel,
-  }), [openaiKey, googleKey, githubToken, githubUsername, pullInterval, updateChannel, crashReporting, analytics, settings.telemetry_consent, settings.anonymous_id])
+    release_channel: releaseChannel === 'stable' ? null : releaseChannel,
+  }), [openaiKey, googleKey, githubToken, githubUsername, pullInterval, releaseChannel, crashReporting, analytics, settings.telemetry_consent, settings.anonymous_id])
 
   const handleSave = () => {
+    const prevAnalytics = settings.analytics_enabled ?? false
+    const newAnalytics = analytics
+    if (!prevAnalytics && newAnalytics) trackEvent('telemetry_opted_in')
+    if (prevAnalytics && !newAnalytics) trackEvent('telemetry_opted_out')
     onSave(buildSettings())
     onClose()
   }
@@ -199,7 +204,7 @@ function SettingsPanelInner({ settings, onSave, onClose }: Omit<SettingsPanelPro
           githubToken={githubToken ?? null} githubUsername={githubUsername ?? null}
           onGitHubConnected={handleGitHubConnected} onGitHubDisconnect={handleGitHubDisconnect}
           pullInterval={pullInterval} setPullInterval={setPullInterval}
-          updateChannel={updateChannel} setUpdateChannel={setUpdateChannel}
+          releaseChannel={releaseChannel} setReleaseChannel={setReleaseChannel}
           crashReporting={crashReporting} setCrashReporting={setCrashReporting}
           analytics={analytics} setAnalytics={setAnalytics}
         />
@@ -234,7 +239,7 @@ interface SettingsBodyProps {
   onGitHubConnected: (token: string, username: string) => void
   onGitHubDisconnect: () => void
   pullInterval: number; setPullInterval: (v: number) => void
-  updateChannel: string; setUpdateChannel: (v: string) => void
+  releaseChannel: string; setReleaseChannel: (v: string) => void
   crashReporting: boolean; setCrashReporting: (v: boolean) => void
   analytics: boolean; setAnalytics: (v: boolean) => void
 }
@@ -298,23 +303,24 @@ function SettingsBody(props: SettingsBodyProps) {
       <div style={{ height: 1, background: 'var(--border)' }} />
 
       <div>
-        <div style={{ fontSize: 13, fontWeight: 600, color: 'var(--foreground)', marginBottom: 4 }}>Updates</div>
+        <div style={{ fontSize: 13, fontWeight: 600, color: 'var(--foreground)', marginBottom: 4 }}>Release Channel</div>
         <div style={{ fontSize: 12, color: 'var(--muted-foreground)', lineHeight: 1.5 }}>
-          Canary builds include the latest features but may be less stable. Restart required after changing.
+          Controls which features are visible. Alpha users see all features. Beta/Stable see features as they are promoted.
         </div>
       </div>
 
       <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
-        <label style={{ fontSize: 12, fontWeight: 500, color: 'var(--foreground)' }}>Update channel</label>
+        <label style={{ fontSize: 12, fontWeight: 500, color: 'var(--foreground)' }}>Release channel</label>
         <select
-          value={props.updateChannel}
-          onChange={(e) => props.setUpdateChannel(e.target.value)}
+          value={props.releaseChannel}
+          onChange={(e) => props.setReleaseChannel(e.target.value)}
           className="border border-border bg-transparent text-foreground rounded"
           style={{ fontSize: 13, padding: '8px 10px', outline: 'none', fontFamily: 'inherit' }}
-          data-testid="settings-update-channel"
+          data-testid="settings-release-channel"
         >
           <option value="stable">Stable</option>
-          <option value="canary">Canary (pre-release)</option>
+          <option value="beta">Beta</option>
+          <option value="alpha">Alpha (bleeding edge)</option>
         </select>
       </div>
 

src/components/Sidebar.test.tsx

@@ -958,4 +958,55 @@ describe('Sidebar', () => {
       expect(onSelect).toHaveBeenCalledWith({ kind: 'filter', filter: 'favorites' })
     })
   })
+
+  describe('group separators', () => {
+    it('TYPES header and its entries share the same border-b container (no separator inside group)', () => {
+      render(<Sidebar entries={mockEntries} selection={defaultSelection} onSelect={() => {}} />)
+      const sectionsHeader = screen.getByText('TYPES')
+      const projectsSection = screen.getByText('Projects')
+      // Walk up from TYPES header to find the border-b container
+      const borderContainer = sectionsHeader.closest('.border-b')
+      expect(borderContainer).not.toBeNull()
+      // The section entry should be inside the same border-b container
+      expect(borderContainer!.contains(projectsSection)).toBe(true)
+    })
+  })
+
+  describe('view edit button', () => {
+    const mockViews = [
+      {
+        filename: 'active-projects.yml',
+        definition: {
+          name: 'Active Projects',
+          icon: '🚀',
+          color: null,
+          sort: null,
+          filters: { all: [{ field: 'type', op: 'equals' as const, value: 'Project' }] },
+        },
+      },
+    ]
+
+    it('renders edit button for each view item when onEditView is provided', () => {
+      render(
+        <Sidebar entries={mockEntries} selection={defaultSelection} onSelect={() => {}} views={mockViews} onEditView={() => {}} onDeleteView={() => {}} />
+      )
+      expect(screen.getByTitle('Edit view')).toBeInTheDocument()
+    })
+
+    it('does not render edit button when onEditView is not provided', () => {
+      render(
+        <Sidebar entries={mockEntries} selection={defaultSelection} onSelect={() => {}} views={mockViews} onDeleteView={() => {}} />
+      )
+      expect(screen.queryByTitle('Edit view')).not.toBeInTheDocument()
+    })
+
+    it('calls onEditView with correct filename when clicked', () => {
+      const onEditView = vi.fn()
+      render(
+        <Sidebar entries={mockEntries} selection={defaultSelection} onSelect={() => {}} views={mockViews} onEditView={onEditView} onDeleteView={() => {}} />
+      )
+      fireEvent.click(screen.getByTitle('Edit view'))
+      expect(onEditView).toHaveBeenCalledWith('active-projects.yml')
+    })
+  })
 })

src/components/Sidebar.tsx

@@ -12,7 +12,7 @@ import {
 } from '@dnd-kit/sortable'
 import { CSS } from '@dnd-kit/utilities'
 import {
-  FileText, Trash, Archive, CaretLeft, Tray, CaretRight, CaretDown, Plus, Funnel,
+  FileText, Trash, Archive, CaretLeft, Tray, CaretRight, CaretDown, Plus, Funnel, PencilSimple,
 } from '@phosphor-icons/react'
 import { isEmoji } from '../utils/emoji'
 import { arrayMove } from '@dnd-kit/sortable'
@@ -40,6 +40,7 @@ interface SidebarProps {
   onReorderFavorites?: (orderedPaths: string[]) => void
   views?: ViewFile[]
   onCreateView?: () => void
+  onEditView?: (filename: string) => void
   onDeleteView?: (filename: string) => void
   folders?: FolderNode[]
   onCreateFolder?: (name: string) => void
@@ -71,6 +72,32 @@ function useSidebarSections(entries: VaultEntry[]) {
   return { typeEntryMap, allSectionGroups, visibleSections, sectionIds }
 }
 
+const SIDEBAR_COLLAPSED_KEY = 'laputa:sidebar-collapsed'
+
+type SidebarGroupKey = 'favorites' | 'views' | 'sections' | 'folders'
+
+function loadCollapsedState(): Record<SidebarGroupKey, boolean> {
+  try {
+    const raw = localStorage.getItem(SIDEBAR_COLLAPSED_KEY)
+    if (raw) return JSON.parse(raw)
+  } catch { /* ignore */ }
+  return { favorites: false, views: false, sections: false, folders: false }
+}
+
+function useSidebarCollapsed() {
+  const [collapsed, setCollapsed] = useState<Record<SidebarGroupKey, boolean>>(loadCollapsedState)
+
+  const toggle = useCallback((key: SidebarGroupKey) => {
+    setCollapsed((prev) => {
+      const next = { ...prev, [key]: !prev[key] }
+      localStorage.setItem(SIDEBAR_COLLAPSED_KEY, JSON.stringify(next))
+      return next
+    })
+  }, [])
+
+  return { collapsed, toggle }
+}
+
 function useEntryCounts(entries: VaultEntry[]) {
   return useMemo(() => {
     let active = 0, archived = 0, trashed = 0
@@ -163,14 +190,15 @@ function SortableFavoriteItem({ entry, isActive, onSelect }: {
   )
 }
 
-function FavoritesSection({ entries, selection, onSelect, onSelectNote, onReorder }: {
+function FavoritesSection({ entries, selection, onSelect, onSelectNote, onReorder, collapsed, onToggle }: {
   entries: VaultEntry[]
   selection: SidebarSelection
   onSelect: (sel: SidebarSelection) => void
   onSelectNote?: (entry: VaultEntry) => void
   onReorder?: (orderedPaths: string[]) => void
+  collapsed: boolean
+  onToggle: () => void
 }) {
-  const [collapsed, setCollapsed] = useState(false)
   const favorites = useMemo(
     () => entries
       .filter((e) => e.favorite && !e.archived && !e.trashed)
@@ -196,11 +224,11 @@ function FavoritesSection({ entries, selection, onSelect, onSelectNote, onReorde
   if (favorites.length === 0) return null
 
   return (
-    <div style={{ padding: '4px 6px 0' }}>
+    <div style={{ padding: '0 6px' }}>
       <button
         className="flex w-full cursor-pointer select-none items-center justify-between border-none bg-transparent text-muted-foreground"
-        style={{ padding: '6px 14px 6px 16px' }}
-        onClick={() => setCollapsed((v) => !v)}
+        style={{ padding: '8px 14px 8px 16px' }}
+        onClick={onToggle}
       >
         <div className="flex items-center gap-1">
           {collapsed ? <CaretRight size={12} /> : <CaretDown size={12} />}
@@ -304,7 +332,7 @@ export const Sidebar = memo(function Sidebar({
   entries, selection, onSelect,
   onCustomizeType, onUpdateTypeTemplate, onReorderSections, onRenameSection,
   onToggleTypeVisibility, onSelectFavorite, onReorderFavorites,
-  views = [], onCreateView, onDeleteView,
+  views = [], onCreateView, onEditView, onDeleteView,
   folders = [], onCreateFolder, inboxCount = 0, onCollapse,
 }: SidebarProps) {
   const [customizeTarget, setCustomizeTarget] = useState<string | null>(null)
@@ -377,6 +405,11 @@ export const Sidebar = memo(function Sidebar({
     renamingType, renameInitialValue, onRenameSubmit: handleRenameSubmit, onRenameCancel: cancelRename,
   }
 
+  const { collapsed: groupCollapsed, toggle: toggleGroup } = useSidebarCollapsed()
+
+  const hasFavorites = entries.some((e) => e.favorite && !e.archived && !e.trashed)
+  const hasViews = views.length > 0 || !!onCreateView
+
   return (
     <aside className="flex h-full flex-col overflow-hidden border-r border-[var(--sidebar-border)] bg-sidebar text-sidebar-foreground">
       <SidebarTitleBar onCollapse={onCollapse} />
@@ -390,64 +423,108 @@ export const Sidebar = memo(function Sidebar({
         </div>
 
         {/* Favorites */}
-        <FavoritesSection entries={entries} selection={selection} onSelect={onSelect} onSelectNote={onSelectFavorite} onReorder={onReorderFavorites} />
-
-        {/* Views */}
-        {(views.length > 0 || onCreateView) && (
-          <div style={{ padding: '4px 6px' }}>
-            <div className="flex w-full select-none items-center justify-between" style={{ padding: '4px 16px' }}>
-              <span className="text-[11px] font-medium text-muted-foreground">Views</span>
-              {onCreateView && (
-                <button className="flex shrink-0 cursor-pointer items-center justify-center rounded border-none bg-transparent p-0 text-muted-foreground transition-colors hover:text-foreground" style={{ width: 20, height: 20 }} onClick={onCreateView} aria-label="Create view" title="Create view">
-                  <Plus size={14} />
-                </button>
-              )}
-            </div>
-            {views.map((v) => (
-              <div key={v.filename} className="group relative">
-                <NavItem
-                  icon={Funnel}
-                  label={v.definition.name}
-                  isActive={isSelectionActive(selection, { kind: 'view', filename: v.filename })}
-                  onClick={() => onSelect({ kind: 'view', filename: v.filename })}
-                  compact
-                />
-                {onDeleteView && (
-                  <button
-                    className="absolute right-2 top-1/2 -translate-y-1/2 rounded p-0.5 text-muted-foreground opacity-0 transition-opacity hover:text-destructive group-hover:opacity-100"
-                    onClick={(e) => { e.stopPropagation(); onDeleteView(v.filename) }}
-                    title="Delete view"
-                  >
-                    <Trash size={12} />
-                  </button>
-                )}
-              </div>
-            ))}
+        {hasFavorites && (
+          <div className="border-b border-border">
+            <FavoritesSection entries={entries} selection={selection} onSelect={onSelect} onSelectNote={onSelectFavorite} onReorder={onReorderFavorites} collapsed={groupCollapsed.favorites} onToggle={() => toggleGroup('favorites')} />
           </div>
         )}
 
-        {/* Sections header + visibility popover */}
-        <div ref={customizeRef} style={{ position: 'relative', padding: '4px 6px 0' }}>
-          <div className="flex w-full select-none items-center justify-between" style={{ padding: '4px 16px' }}>
-            <span className="text-[11px] font-medium text-muted-foreground">Sections</span>
-            <button className="flex shrink-0 cursor-pointer items-center justify-center rounded border-none bg-transparent p-0 text-muted-foreground transition-colors hover:text-foreground" style={{ width: 20, height: 20 }} onClick={() => setShowCustomize((v) => !v)} aria-label="Customize sections" title="Customize sections">
-              <SlidersHorizontal size={14} />
+        {/* Views */}
+        {hasViews && (
+          <div className="border-b border-border" style={{ padding: '0 6px' }}>
+            <button
+              className="flex w-full cursor-pointer select-none items-center justify-between border-none bg-transparent text-muted-foreground"
+              style={{ padding: '8px 14px 8px 16px' }}
+              onClick={() => toggleGroup('views')}
+            >
+              <div className="flex items-center gap-1">
+                {groupCollapsed.views ? <CaretRight size={12} /> : <CaretDown size={12} />}
+                <span className="text-[10px] font-semibold" style={{ letterSpacing: 0.5 }}>VIEWS</span>
+              </div>
+              {onCreateView && (
+                <Plus
+                  size={12}
+                  className="text-muted-foreground hover:text-foreground"
+                  onClick={(e) => { e.stopPropagation(); onCreateView() }}
+                />
+              )}
             </button>
+            {!groupCollapsed.views && (
+              <div style={{ paddingBottom: 4 }}>
+                {views.map((v) => (
+                  <div key={v.filename} className="group relative">
+                    <NavItem
+                      icon={Funnel}
+                      emoji={v.definition.icon}
+                      label={v.definition.name}
+                      isActive={isSelectionActive(selection, { kind: 'view', filename: v.filename })}
+                      onClick={() => onSelect({ kind: 'view', filename: v.filename })}
+                    />
+                    <div className="absolute right-2 top-1/2 flex -translate-y-1/2 items-center gap-0.5 opacity-0 transition-opacity group-hover:opacity-100">
+                      {onEditView && (
+                        <button
+                          className="rounded p-0.5 text-muted-foreground hover:text-foreground"
+                          onClick={(e) => { e.stopPropagation(); onEditView(v.filename) }}
+                          title="Edit view"
+                        >
+                          <PencilSimple size={12} />
+                        </button>
+                      )}
+                      {onDeleteView && (
+                        <button
+                          className="rounded p-0.5 text-muted-foreground hover:text-destructive"
+                          onClick={(e) => { e.stopPropagation(); onDeleteView(v.filename) }}
+                          title="Delete view"
+                        >
+                          <Trash size={12} />
+                        </button>
+                      )}
+                    </div>
+                  </div>
+                ))}
+              </div>
+            )}
           </div>
-          {showCustomize && <VisibilityPopover sections={allSectionGroups} isSectionVisible={isSectionVisible} onToggle={toggleVisibility} />}
+        )}
+
+        {/* Sections header + entries */}
+        <div className="border-b border-border">
+          <div ref={customizeRef} style={{ position: 'relative', padding: '0 6px' }}>
+            <button
+              className="flex w-full cursor-pointer select-none items-center justify-between border-none bg-transparent text-muted-foreground"
+              style={{ padding: '8px 14px 8px 16px' }}
+              onClick={() => toggleGroup('sections')}
+            >
+              <div className="flex items-center gap-1">
+                {groupCollapsed.sections ? <CaretRight size={12} /> : <CaretDown size={12} />}
+                <span className="text-[10px] font-semibold" style={{ letterSpacing: 0.5 }}>TYPES</span>
+              </div>
+              <span
+                role="button"
+                title="Customize sections"
+                aria-label="Customize sections"
+                onClick={(e) => { e.stopPropagation(); setShowCustomize((v) => !v) }}
+              >
+                <SlidersHorizontal size={12} className="text-muted-foreground hover:text-foreground" />
+              </span>
+            </button>
+            {showCustomize && <VisibilityPopover sections={allSectionGroups} isSectionVisible={isSectionVisible} onToggle={toggleVisibility} />}
+          </div>
+
+          {/* Sortable section groups */}
+          {!groupCollapsed.sections && (
+            <DndContext sensors={sensors} collisionDetection={closestCenter} onDragEnd={handleDragEnd}>
+              <SortableContext items={sectionIds} strategy={verticalListSortingStrategy}>
+                {visibleSections.map((g) => (
+                  <SortableSection key={g.type} group={g} sectionProps={sectionProps} />
+                ))}
+              </SortableContext>
+            </DndContext>
+          )}
         </div>
 
-        {/* Sortable section groups */}
-        <DndContext sensors={sensors} collisionDetection={closestCenter} onDragEnd={handleDragEnd}>
-          <SortableContext items={sectionIds} strategy={verticalListSortingStrategy}>
-            {visibleSections.map((g) => (
-              <SortableSection key={g.type} group={g} sectionProps={sectionProps} />
-            ))}
-          </SortableContext>
-        </DndContext>
-
         {/* Folder tree */}
-        <FolderTree folders={folders} selection={selection} onSelect={onSelect} onCreateFolder={onCreateFolder} />
+        <FolderTree folders={folders} selection={selection} onSelect={onSelect} onCreateFolder={onCreateFolder} collapsed={groupCollapsed.folders} onToggle={() => toggleGroup('folders')} />
       </nav>
 
       <ContextMenuOverlay pos={contextMenuPos} type={contextMenuType} innerRef={contextMenuRef} onOpenCustomize={(type) => { closeContextMenu(); setCustomizeTarget(type) }} onStartRename={handleStartRename} />

src/components/SidebarParts.tsx

@@ -1,7 +1,7 @@
 import { type ComponentType, useState, useEffect, useRef } from 'react'
 import type { SidebarSelection } from '../types'
 import { cn } from '@/lib/utils'
-import { getTypeColor } from '../utils/typeColors'
+import { getTypeColor, getTypeLightColor } from '../utils/typeColors'
 import { type IconProps } from '@phosphor-icons/react'
 
 export interface SectionGroup {
@@ -26,8 +26,9 @@ export function isSelectionActive(current: SidebarSelection, check: SidebarSelec
 
 // --- NavItem ---
 
-export function NavItem({ icon: Icon, label, count, isActive, activeClassName = 'bg-primary/10 text-primary', badgeClassName, badgeStyle, activeBadgeClassName, activeBadgeStyle, onClick, disabled, disabledTooltip, compact }: {
+export function NavItem({ icon: Icon, emoji, label, count, isActive, activeClassName = 'bg-primary/10 text-primary', badgeClassName, badgeStyle, activeBadgeClassName, activeBadgeStyle, onClick, disabled, disabledTooltip, compact }: {
   icon: ComponentType<IconProps>
+  emoji?: string | null
   label: string
   count?: number
   isActive?: boolean
@@ -46,11 +47,14 @@ export function NavItem({ icon: Icon, label, count, isActive, activeClassName =
   const padding = compact ? '4px 16px' : '6px 16px'
   const resolvedBadgeClass = isActive && activeBadgeClassName ? activeBadgeClassName : badgeClassName
   const resolvedBadgeStyle = isActive && activeBadgeClassName ? activeBadgeStyle : badgeStyle
+  const iconEl = emoji
+    ? <span style={{ fontSize: iconSize, lineHeight: 1, width: iconSize, textAlign: 'center' }}>{emoji}</span>
+    : <Icon size={iconSize} weight={isActive ? 'fill' : 'regular'} />
 
   if (disabled) {
     return (
       <div className="flex select-none items-center gap-2 rounded text-foreground" style={{ padding, borderRadius: 4, opacity: 0.4, cursor: 'not-allowed' }} title={disabledTooltip ?? "Coming soon"}>
-        <Icon size={iconSize} />
+        {iconEl}
         <span className={cn("flex-1 font-medium", textClass)}>{label}</span>
       </div>
     )
@@ -61,7 +65,7 @@ export function NavItem({ icon: Icon, label, count, isActive, activeClassName =
       style={{ padding, borderRadius: 4 }}
       onClick={onClick}
     >
-      <Icon size={iconSize} weight={isActive ? 'fill' : 'regular'} />
+      {iconEl}
       <span className={cn("flex-1 font-medium", textClass)}>{label}</span>
       {count !== undefined && count > 0 && (
         <span className={cn("flex items-center justify-center", resolvedBadgeClass)} style={{ height: compact ? 18 : 20, borderRadius: 9999, padding: '0 6px', fontSize: 10, ...resolvedBadgeStyle }}>
@@ -94,11 +98,13 @@ export function SectionContent({
 }: SectionContentProps) {
   const { label, type, Icon, customColor } = group
   const sectionColor = getTypeColor(type, customColor)
+  const sectionLightColor = getTypeLightColor(type, customColor)
 
   return (
     <SectionHeader
       label={label} type={type} Icon={Icon}
       sectionColor={sectionColor}
+      sectionLightColor={sectionLightColor}
       itemCount={itemCount}
       isActive={isSelectionActive(selection, { kind: 'sectionGroup', type })}
       onSelect={() => onSelect({ kind: 'sectionGroup', type })}
@@ -142,9 +148,9 @@ function InlineRenameInput({ initialValue, onSubmit, onCancel }: {
   )
 }
 
-function SectionHeader({ label, type, Icon, sectionColor, itemCount, isActive, onSelect, onContextMenu, dragHandleProps, isRenaming, renameInitialValue, onRenameSubmit, onRenameCancel }: {
+function SectionHeader({ label, type, Icon, sectionColor, sectionLightColor, itemCount, isActive, onSelect, onContextMenu, dragHandleProps, isRenaming, renameInitialValue, onRenameSubmit, onRenameCancel }: {
   label: string; type: string; Icon: ComponentType<IconProps>
-  sectionColor: string; itemCount: number; isActive: boolean
+  sectionColor: string; sectionLightColor: string; itemCount: number; isActive: boolean
   onSelect: () => void; onContextMenu: (e: React.MouseEvent) => void
   dragHandleProps?: Record<string, unknown>
   isRenaming?: boolean; renameInitialValue?: string
@@ -152,14 +158,14 @@ function SectionHeader({ label, type, Icon, sectionColor, itemCount, isActive, o
 }) {
   return (
     <div
-      className={cn("group/section flex cursor-pointer select-none items-center justify-between rounded transition-colors", isActive ? "bg-secondary" : "hover:bg-accent")}
-      style={{ padding: '6px 8px 6px 16px', borderRadius: 4, gap: 4 }}
+      className={cn("group/section flex cursor-pointer select-none items-center justify-between rounded transition-colors", !isActive && "hover:bg-accent")}
+      style={{ padding: '6px 8px 6px 16px', borderRadius: 4, gap: 4, ...(isActive ? { background: sectionLightColor } : {}) }}
       {...dragHandleProps}
       onClick={() => { if (!isRenaming) onSelect() }}
       onContextMenu={isRenaming ? undefined : onContextMenu}
     >
       <div className="flex min-w-0 flex-1 items-center" style={{ gap: 4 }}>
-        <Icon size={16} style={{ color: sectionColor, flexShrink: 0 }} />
+        <Icon size={16} weight={isActive ? 'fill' : 'regular'} style={{ color: sectionColor, flexShrink: 0 }} />
         {isRenaming && onRenameSubmit && onRenameCancel ? (
           <InlineRenameInput
             key={`rename-${type}`}
@@ -168,11 +174,14 @@ function SectionHeader({ label, type, Icon, sectionColor, itemCount, isActive, o
             onCancel={onRenameCancel}
           />
         ) : (
-          <span className="text-[13px] font-medium text-foreground" style={{ marginLeft: 4 }}>{label}</span>
+          <span className="text-[13px] font-medium" style={{ marginLeft: 4, color: isActive ? sectionColor : undefined }}>{label}</span>
         )}
       </div>
       {itemCount > 0 && (
-        <span className="flex items-center justify-center text-muted-foreground" style={{ height: 20, borderRadius: 9999, padding: '0 6px', fontSize: 10, background: 'var(--muted)' }}>
+        <span
+          className={cn("flex items-center justify-center", !isActive && "text-muted-foreground")}
+          style={{ height: 20, borderRadius: 9999, padding: '0 6px', fontSize: 10, ...(isActive ? { background: sectionColor, color: 'white' } : { background: 'var(--muted)' }) }}
+        >
           {itemCount}
         </span>
       )}

src/components/SingleEditorView.tsx

@@ -1,4 +1,5 @@
 import { useEffect, useCallback, useMemo, useRef } from 'react'
+import { trackEvent } from '../lib/telemetry'
 import { useCreateBlockNote, SuggestionMenuController } from '@blocknote/react'
 import { BlockNoteView } from '@blocknote/mantine'
 import { useEditorTheme } from '../hooks/useTheme'
@@ -87,6 +88,7 @@ export function SingleEditorView({ editor, entries, onNavigateWikilink, onChange
       { type: 'wikilink' as const, props: { target } },
       " ",
     ])
+    trackEvent('wikilink_inserted')
   }, [editor])
 
   const getWikilinkItems = useCallback(async (query: string): Promise<WikilinkSuggestionItem[]> => {

src/components/StatusBar.test.tsx

@@ -352,4 +352,42 @@ describe('StatusBar', () => {
     expect(screen.queryByTestId('status-commit-push')).not.toBeInTheDocument()
   })
 
+  it('shows Claude Code badge when installed', () => {
+    render(<StatusBar noteCount={100} vaultPath="/Users/luca/Laputa" vaults={vaults} onSwitchVault={vi.fn()} claudeCodeStatus="installed" claudeCodeVersion="1.0.20" />)
+    const badge = screen.getByTestId('status-claude-code')
+    expect(badge).toBeInTheDocument()
+    expect(screen.getByText('Claude Code')).toBeInTheDocument()
+    expect(badge.getAttribute('title')).toBe('Claude Code 1.0.20')
+  })
+
+  it('shows Claude Code missing badge with warning when missing', () => {
+    render(<StatusBar noteCount={100} vaultPath="/Users/luca/Laputa" vaults={vaults} onSwitchVault={vi.fn()} claudeCodeStatus="missing" />)
+    const badge = screen.getByTestId('status-claude-code')
+    expect(badge).toBeInTheDocument()
+    expect(screen.getByText('Claude Code missing')).toBeInTheDocument()
+    expect(badge.getAttribute('title')).toBe('Claude Code not found — click to install')
+  })
+
+  it('opens install URL when clicking missing Claude Code badge', () => {
+    render(<StatusBar noteCount={100} vaultPath="/Users/luca/Laputa" vaults={vaults} onSwitchVault={vi.fn()} claudeCodeStatus="missing" />)
+    fireEvent.click(screen.getByTestId('status-claude-code'))
+    expect(openExternalUrl).toHaveBeenCalledWith('https://docs.anthropic.com/en/docs/claude-code')
+  })
+
+  it('opens install URL on Enter key for missing Claude Code badge', () => {
+    render(<StatusBar noteCount={100} vaultPath="/Users/luca/Laputa" vaults={vaults} onSwitchVault={vi.fn()} claudeCodeStatus="missing" />)
+    fireEvent.keyDown(screen.getByTestId('status-claude-code'), { key: 'Enter' })
+    expect(openExternalUrl).toHaveBeenCalledWith('https://docs.anthropic.com/en/docs/claude-code')
+  })
+
+  it('hides Claude Code badge when status is checking', () => {
+    render(<StatusBar noteCount={100} vaultPath="/Users/luca/Laputa" vaults={vaults} onSwitchVault={vi.fn()} claudeCodeStatus="checking" />)
+    expect(screen.queryByTestId('status-claude-code')).not.toBeInTheDocument()
+  })
+
+  it('hides Claude Code badge when no claudeCodeStatus prop provided', () => {
+    render(<StatusBar noteCount={100} vaultPath="/Users/luca/Laputa" vaults={vaults} onSwitchVault={vi.fn()} />)
+    expect(screen.queryByTestId('status-claude-code')).not.toBeInTheDocument()
+  })
+
 })

src/components/StatusBar.tsx

@@ -1,8 +1,9 @@
 import { useState, useRef, useEffect } from 'react'
-import { Package, RefreshCw, FileText, Bell, Settings, FolderOpen, Check, Github, AlertTriangle, Loader2, GitCommitHorizontal, X, Cpu, ArrowDown, GitBranch } from 'lucide-react'
+import { Package, RefreshCw, FileText, Bell, Settings, FolderOpen, Check, Github, AlertTriangle, Loader2, GitCommitHorizontal, X, Cpu, ArrowDown, GitBranch, Terminal } from 'lucide-react'
 import { GitDiff, Pulse } from '@phosphor-icons/react'
 import type { GitRemoteStatus, LastCommitInfo, SyncStatus } from '../types'
 import type { McpStatus } from '../hooks/useMcpStatus'
+import type { ClaudeCodeStatus } from '../hooks/useClaudeCodeStatus'
 import { openExternalUrl } from '../utils/url'
 
 export interface VaultOption {
@@ -40,6 +41,8 @@ interface StatusBarProps {
   onRemoveVault?: (path: string) => void
   mcpStatus?: McpStatus
   onInstallMcp?: () => void
+  claudeCodeStatus?: ClaudeCodeStatus
+  claudeCodeVersion?: string | null
 }
 
 function VaultMenuIcon({ isActive, unavailable }: { isActive: boolean; unavailable: boolean }) {
@@ -436,7 +439,44 @@ function McpBadge({ status, onInstall }: { status: McpStatus; onInstall?: () =>
   )
 }
 
-export function StatusBar({ noteCount, modifiedCount = 0, vaultPath, vaults, onSwitchVault, onOpenSettings, onOpenLocalFolder, onConnectGitHub, onClickPending, onClickPulse, onCommitPush, isGitVault = false, hasGitHub, syncStatus = 'idle', lastSyncTime = null, conflictCount = 0, lastCommitInfo, remoteStatus, onTriggerSync, onPullAndPush, onOpenConflictResolver, zoomLevel = 100, onZoomReset, buildNumber, onCheckForUpdates, onRemoveVault, mcpStatus, onInstallMcp }: StatusBarProps) {
+const CLAUDE_INSTALL_URL = 'https://docs.anthropic.com/en/docs/claude-code'
+
+function ClaudeCodeBadge({ status, version }: { status: ClaudeCodeStatus; version?: string | null }) {
+  if (status === 'checking') return null
+  const isMissing = status === 'missing'
+  const tooltip = isMissing
+    ? 'Claude Code not found — click to install'
+    : `Claude Code${version ? ` ${version}` : ''}`
+  return (
+    <>
+      <span style={SEP_STYLE}>|</span>
+      <span
+        role={isMissing ? 'button' : undefined}
+        tabIndex={isMissing ? 0 : undefined}
+        onClick={isMissing ? () => openExternalUrl(CLAUDE_INSTALL_URL) : undefined}
+        onKeyDown={isMissing ? (e) => { if (e.key === 'Enter') openExternalUrl(CLAUDE_INSTALL_URL) } : undefined}
+        style={{
+          ...ICON_STYLE,
+          color: isMissing ? 'var(--accent-orange)' : 'var(--muted-foreground)',
+          cursor: isMissing ? 'pointer' : 'default',
+          padding: '2px 4px',
+          borderRadius: 3,
+          background: 'transparent',
+        }}
+        title={tooltip}
+        data-testid="status-claude-code"
+        onMouseEnter={isMissing ? (e) => { e.currentTarget.style.background = 'var(--hover)' } : undefined}
+        onMouseLeave={isMissing ? (e) => { e.currentTarget.style.background = 'transparent' } : undefined}
+      >
+        <Terminal size={13} />
+        {isMissing ? 'Claude Code missing' : 'Claude Code'}
+        {isMissing && <AlertTriangle size={10} style={{ marginLeft: 2 }} />}
+      </span>
+    </>
+  )
+}
+
+export function StatusBar({ noteCount, modifiedCount = 0, vaultPath, vaults, onSwitchVault, onOpenSettings, onOpenLocalFolder, onConnectGitHub, onClickPending, onClickPulse, onCommitPush, isGitVault = false, hasGitHub, syncStatus = 'idle', lastSyncTime = null, conflictCount = 0, lastCommitInfo, remoteStatus, onTriggerSync, onPullAndPush, onOpenConflictResolver, zoomLevel = 100, onZoomReset, buildNumber, onCheckForUpdates, onRemoveVault, mcpStatus, onInstallMcp, claudeCodeStatus, claudeCodeVersion }: StatusBarProps) {
   const [, setTick] = useState(0)
   useEffect(() => {
     const id = setInterval(() => setTick((t) => t + 1), 30_000)
@@ -464,6 +504,7 @@ export function StatusBar({ noteCount, modifiedCount = 0, vaultPath, vaults, onS
         <ConflictBadge count={conflictCount} onClick={onOpenConflictResolver} />
         <PulseBadge onClick={onClickPulse} disabled={!isGitVault} />
         {mcpStatus && <McpBadge status={mcpStatus} onInstall={onInstallMcp} />}
+        {claudeCodeStatus && <ClaudeCodeBadge status={claudeCodeStatus} version={claudeCodeVersion} />}
       </div>
       <div style={{ display: 'flex', alignItems: 'center', gap: 12, flexShrink: 0 }}>
         <span style={ICON_STYLE}><FileText size={13} />{noteCount.toLocaleString()} notes</span>

src/components/TitleField.test.tsx

@@ -36,8 +36,12 @@ describe('TitleField', () => {
     expect(input).toHaveValue('Keep This')
   })
 
-  it('shows filename indicator when slug differs from current filename', () => {
+  it('shows filename indicator when slug differs and title is focused', () => {
     render(<TitleField title="My Note" filename="wrong-name.md" onTitleChange={() => {}} />)
+    // Not shown when unfocused
+    expect(screen.queryByTestId('title-field-filename')).not.toBeInTheDocument()
+    // Shown when focused
+    fireEvent.focus(screen.getByTestId('title-field-input'))
     expect(screen.getByTestId('title-field-filename')).toHaveTextContent('my-note.md')
   })
 
@@ -117,18 +121,48 @@ describe('TitleField', () => {
     expect(input).toHaveValue('Untitled note')
   })
 
-  it('shows vault-relative path for notes in subdirectories', () => {
+  it('shows vault-relative path (without .md) only when title is focused', () => {
     render(<TitleField title="ADR" filename="0001-tauri-stack.md" notePath="/Users/luca/Laputa/docs/adr/0001-tauri-stack.md" vaultPath="/Users/luca/Laputa" onTitleChange={() => {}} />)
-    expect(screen.getByTestId('title-field-path')).toHaveTextContent('docs/adr/0001-tauri-stack.md')
+    // Path hidden by default
+    expect(screen.queryByTestId('title-field-path')).not.toBeInTheDocument()
+    // Focus title → path appears
+    fireEvent.focus(screen.getByTestId('title-field-input'))
+    expect(screen.getByTestId('title-field-path')).toHaveTextContent('docs/adr/0001-tauri-stack')
+    // No bare filename shown when path is visible
+    expect(screen.queryByTestId('title-field-filename')).not.toBeInTheDocument()
   })
 
-  it('hides path for notes at vault root', () => {
+  it('hides path on blur', () => {
+    render(<TitleField title="ADR" filename="0001-tauri-stack.md" notePath="/Users/luca/Laputa/docs/adr/0001-tauri-stack.md" vaultPath="/Users/luca/Laputa" onTitleChange={() => {}} />)
+    const input = screen.getByTestId('title-field-input')
+    fireEvent.focus(input)
+    expect(screen.getByTestId('title-field-path')).toBeInTheDocument()
+    fireEvent.blur(input)
+    expect(screen.queryByTestId('title-field-path')).not.toBeInTheDocument()
+  })
+
+  it('hides path for notes at vault root even when focused', () => {
     render(<TitleField title="Root Note" filename="root-note.md" notePath="/Users/luca/Laputa/root-note.md" vaultPath="/Users/luca/Laputa" onTitleChange={() => {}} />)
+    fireEvent.focus(screen.getByTestId('title-field-input'))
     expect(screen.queryByTestId('title-field-path')).not.toBeInTheDocument()
   })
 
   it('hides path when vaultPath is not provided', () => {
     render(<TitleField title="Note" filename="note.md" onTitleChange={() => {}} />)
+    fireEvent.focus(screen.getByTestId('title-field-input'))
     expect(screen.queryByTestId('title-field-path')).not.toBeInTheDocument()
   })
+
+  it('resolves vault-relative path when paths differ by symlink prefix', () => {
+    // vaultPath uses symlink /Users/luca/... but notePath is canonical /Volumes/Jupiter/...
+    render(<TitleField title="ADR" filename="0001-tauri-stack.md" notePath="/Volumes/Jupiter/Workspace/laputa-app/demo-vault-v2/docs/adr/0001-tauri-stack.md" vaultPath="/Users/luca/Workspace/laputa-app/demo-vault-v2" onTitleChange={() => {}} />)
+    fireEvent.focus(screen.getByTestId('title-field-input'))
+    expect(screen.getByTestId('title-field-path')).toHaveTextContent('docs/adr/0001-tauri-stack')
+  })
+
+  it('handles vaultPath with trailing slash', () => {
+    render(<TitleField title="ADR" filename="0001-tauri-stack.md" notePath="/Users/luca/Laputa/docs/adr/0001-tauri-stack.md" vaultPath="/Users/luca/Laputa/" onTitleChange={() => {}} />)
+    fireEvent.focus(screen.getByTestId('title-field-input'))
+    expect(screen.getByTestId('title-field-path')).toHaveTextContent('docs/adr/0001-tauri-stack')
+  })
 })

src/components/TitleField.tsx

@@ -62,10 +62,36 @@ function useOptimisticTitle(title: string, onTitleChange: (t: string) => void) {
  * Displays the title as an editable field and shows the resulting filename below.
  */
 export function TitleField({ title, filename, editable = true, notePath, vaultPath, onTitleChange }: TitleFieldProps) {
-  const inputRef = useRef<HTMLInputElement>(null)
+  const inputRef = useRef<HTMLTextAreaElement>(null)
+  const [isFocused, setIsFocused] = useState(false)
   const { value, isEditing, handleFocus, commitTitle, revert, setEdit } =
     useOptimisticTitle(title, onTitleChange)
 
+  // Auto-resize textarea to fit content (fallback for browsers without field-sizing: content)
+  const autoResize = useCallback(() => {
+    const el = inputRef.current
+    if (!el) return
+    el.style.height = 'auto'
+    el.style.height = el.scrollHeight + 'px'
+  }, [])
+
+  useEffect(() => {
+    autoResize()
+    // Schedule a second measurement after the browser has painted, to catch
+    // cases where scrollHeight is stale on the first read (e.g. tab switch).
+    const id = requestAnimationFrame(autoResize)
+    return () => cancelAnimationFrame(id)
+  }, [value, autoResize])
+
+  // Re-measure when container width changes (text may re-wrap)
+  useEffect(() => {
+    const el = inputRef.current
+    if (!el) return
+    const ro = new ResizeObserver(autoResize)
+    ro.observe(el)
+    return () => ro.disconnect()
+  }, [autoResize])
+
   useEffect(() => {
     const handler = (e: Event) => {
       const detail = (e as CustomEvent).detail
@@ -91,23 +117,38 @@ export function TitleField({ title, filename, editable = true, notePath, vaultPa
 
   const expectedSlug = slugify(value.trim() || title)
   const currentStem = filename.replace(/\.md$/, '')
-  const showFilename = isEditing || currentStem !== expectedSlug
 
   // Compute vault-relative path (only for notes in subdirectories)
-  const relativePath = notePath && vaultPath
-    ? notePath.replace(vaultPath + '/', '')
-    : null
-  const showRelativePath = relativePath && relativePath.includes('/')
+  const relativePath = (() => {
+    if (!notePath || !vaultPath) return null
+    const vp = vaultPath.replace(/\/+$/, '')
+    const np = notePath.replace(/\.md$/, '')
+    if (np.startsWith(vp + '/')) return np.slice(vp.length + 1)
+    // Fallback: match by vault directory name for symlink-resolved paths
+    const vaultName = vp.split('/').pop()
+    if (!vaultName) return null
+    const segments = np.split('/')
+    const idx = segments.lastIndexOf(vaultName)
+    if (idx >= 0) return segments.slice(idx + 1).join('/')
+    return null
+  })()
+  const isSubdirectory = relativePath != null && relativePath.includes('/')
+
+  // Show path only when title is focused and note is in a subdirectory
+  const showRelativePath = isFocused && isSubdirectory
+  // Show filename hint when slug differs, but only when focused (not always)
+  const showFilename = isFocused && !showRelativePath && (isEditing || currentStem !== expectedSlug)
 
   return (
     <div className="title-field" data-testid="title-field">
-      <input
+      <textarea
         ref={inputRef}
         className="title-field__input"
         value={value}
-        onChange={e => setEdit(e.target.value)}
-        onFocus={handleFocus}
-        onBlur={commitTitle}
+        rows={1}
+        onChange={e => { setEdit(e.target.value); autoResize() }}
+        onFocus={() => { setIsFocused(true); handleFocus() }}
+        onBlur={() => { setIsFocused(false); commitTitle() }}
         onKeyDown={handleKeyDown}
         disabled={!editable}
         placeholder="Untitled"

src/components/WelcomeScreen.test.tsx

@@ -6,6 +6,7 @@ const defaultProps = {
   mode: 'welcome' as const,
   defaultVaultPath: '~/Documents/Laputa',
   onCreateVault: vi.fn(),
+  onCreateNewVault: vi.fn(),
   onOpenFolder: vi.fn(),
   creating: false,
   error: null,
@@ -19,19 +20,26 @@ describe('WelcomeScreen', () => {
       expect(screen.getByText(/Wiki-linked knowledge management/)).toBeInTheDocument()
     })
 
-    it('shows create vault and open folder buttons', () => {
+    it('shows all three option buttons', () => {
       render(<WelcomeScreen {...defaultProps} />)
-      expect(screen.getByTestId('welcome-create-vault')).toHaveTextContent('Create Getting Started vault')
-      expect(screen.getByTestId('welcome-open-folder')).toHaveTextContent('Open an existing folder')
+      expect(screen.getByTestId('welcome-create-new')).toHaveTextContent('Create a new vault')
+      expect(screen.getByTestId('welcome-open-folder')).toHaveTextContent('Open existing vault')
+      expect(screen.getByTestId('welcome-create-vault')).toHaveTextContent('Get started with a template')
     })
 
-    it('shows default vault path hint', () => {
+    it('shows default vault path in template option description', () => {
       render(<WelcomeScreen {...defaultProps} />)
-      expect(screen.getByText(/will be created in/)).toBeInTheDocument()
       expect(screen.getByText(/~\/Documents\/Laputa/)).toBeInTheDocument()
     })
 
-    it('calls onCreateVault when create button is clicked', () => {
+    it('calls onCreateNewVault when create new button is clicked', () => {
+      const onCreateNewVault = vi.fn()
+      render(<WelcomeScreen {...defaultProps} onCreateNewVault={onCreateNewVault} />)
+      fireEvent.click(screen.getByTestId('welcome-create-new'))
+      expect(onCreateNewVault).toHaveBeenCalledOnce()
+    })
+
+    it('calls onCreateVault when template button is clicked', () => {
       const onCreateVault = vi.fn()
       render(<WelcomeScreen {...defaultProps} onCreateVault={onCreateVault} />)
       fireEvent.click(screen.getByTestId('welcome-create-vault'))
@@ -45,15 +53,16 @@ describe('WelcomeScreen', () => {
       expect(onOpenFolder).toHaveBeenCalledOnce()
     })
 
-    it('disables buttons while creating', () => {
+    it('disables all buttons while creating', () => {
       render(<WelcomeScreen {...defaultProps} creating={true} />)
-      expect(screen.getByTestId('welcome-create-vault')).toBeDisabled()
+      expect(screen.getByTestId('welcome-create-new')).toBeDisabled()
       expect(screen.getByTestId('welcome-open-folder')).toBeDisabled()
+      expect(screen.getByTestId('welcome-create-vault')).toBeDisabled()
     })
 
-    it('shows loading text while creating', () => {
+    it('shows loading text on template button while creating', () => {
       render(<WelcomeScreen {...defaultProps} creating={true} />)
-      expect(screen.getByTestId('welcome-create-vault')).toHaveTextContent('Creating vault…')
+      expect(screen.getByTestId('welcome-create-vault')).toHaveTextContent(/Creating vault/)
     })
 
     it('shows error message when error is set', () => {
@@ -90,15 +99,10 @@ describe('WelcomeScreen', () => {
       expect(screen.getByText('~/Laputa')).toBeInTheDocument()
     })
 
-    it('shows "Choose a different folder" instead of "Open an existing folder"', () => {
+    it('shows "Choose a different folder" instead of "Open existing vault"', () => {
       render(<WelcomeScreen {...missingProps} />)
       expect(screen.getByTestId('welcome-open-folder')).toHaveTextContent('Choose a different folder')
     })
-
-    it('does not show vault path hint in vault-missing mode', () => {
-      render(<WelcomeScreen {...missingProps} />)
-      expect(screen.queryByText(/will be created in/)).not.toBeInTheDocument()
-    })
   })
 
   describe('data-testid', () => {

src/components/WelcomeScreen.tsx

@@ -1,11 +1,12 @@
 import { useState } from 'react'
-import { FolderOpen, Plus, AlertTriangle, Loader2 } from 'lucide-react'
+import { FolderOpen, Plus, AlertTriangle, Loader2, Rocket } from 'lucide-react'
 
 interface WelcomeScreenProps {
   mode: 'welcome' | 'vault-missing'
   missingPath?: string
   defaultVaultPath: string
   onCreateVault: () => void
+  onCreateNewVault: () => void
   onOpenFolder: () => void
   creating: boolean
   error: string | null
@@ -64,43 +65,42 @@ const DIVIDER_STYLE: React.CSSProperties = {
   background: 'var(--border)',
 }
 
-const PRIMARY_BTN_STYLE: React.CSSProperties = {
+const OPTION_BTN_STYLE: React.CSSProperties = {
   width: '100%',
-  height: 44,
-  borderRadius: 8,
-  border: 'none',
-  background: 'var(--primary)',
-  color: 'white',
-  fontSize: 14,
-  fontWeight: 600,
-  cursor: 'pointer',
-  display: 'flex',
-  alignItems: 'center',
-  justifyContent: 'center',
-  gap: 8,
-}
-
-const SECONDARY_BTN_STYLE: React.CSSProperties = {
-  width: '100%',
-  height: 44,
   borderRadius: 8,
   border: '1px solid var(--border)',
   background: 'var(--background)',
-  color: 'var(--foreground)',
-  fontSize: 14,
-  fontWeight: 500,
   cursor: 'pointer',
   display: 'flex',
   alignItems: 'center',
-  justifyContent: 'center',
-  gap: 8,
+  gap: 14,
+  padding: '14px 16px',
+  textAlign: 'left',
+  transition: 'background 0.15s',
 }
 
-const HINT_STYLE: React.CSSProperties = {
+const OPTION_ICON_STYLE: React.CSSProperties = {
+  width: 36,
+  height: 36,
+  borderRadius: 8,
+  display: 'flex',
+  alignItems: 'center',
+  justifyContent: 'center',
+  flexShrink: 0,
+}
+
+const OPTION_LABEL_STYLE: React.CSSProperties = {
+  fontSize: 14,
+  fontWeight: 600,
+  color: 'var(--foreground)',
+  margin: 0,
+}
+
+const OPTION_DESC_STYLE: React.CSSProperties = {
   fontSize: 12,
   color: 'var(--muted-foreground)',
-  textAlign: 'center',
   margin: 0,
+  marginTop: 2,
 }
 
 const PATH_BADGE_STYLE: React.CSSProperties = {
@@ -118,10 +118,44 @@ const ERROR_STYLE: React.CSSProperties = {
   margin: 0,
 }
 
-export function WelcomeScreen({ mode, missingPath, defaultVaultPath, onCreateVault, onOpenFolder, creating, error }: WelcomeScreenProps) {
-  const [hoverPrimary, setHoverPrimary] = useState(false)
-  const [hoverSecondary, setHoverSecondary] = useState(false)
+interface OptionButtonProps {
+  icon: React.ReactNode
+  iconBg: string
+  label: string
+  description: string
+  onClick: () => void
+  disabled: boolean
+  loading?: boolean
+  testId: string
+}
 
+function OptionButton({ icon, iconBg, label, description, onClick, disabled, loading, testId }: OptionButtonProps) {
+  const [hover, setHover] = useState(false)
+  return (
+    <button
+      style={{
+        ...OPTION_BTN_STYLE,
+        background: hover ? 'var(--sidebar)' : 'var(--background)',
+        opacity: disabled ? 0.7 : 1,
+      }}
+      onClick={onClick}
+      disabled={disabled}
+      onMouseEnter={() => setHover(true)}
+      onMouseLeave={() => setHover(false)}
+      data-testid={testId}
+    >
+      <div style={{ ...OPTION_ICON_STYLE, background: iconBg }}>
+        {loading ? <Loader2 size={18} className="animate-spin" style={{ color: 'var(--muted-foreground)' }} /> : icon}
+      </div>
+      <div>
+        <p style={OPTION_LABEL_STYLE}>{loading ? 'Creating vault\u2026' : label}</p>
+        <p style={OPTION_DESC_STYLE}>{description}</p>
+      </div>
+    </button>
+  )
+}
+
+export function WelcomeScreen({ mode, missingPath, defaultVaultPath, onCreateVault, onCreateNewVault, onOpenFolder, creating, error }: WelcomeScreenProps) {
   const isWelcome = mode === 'welcome'
 
   return (
@@ -134,7 +168,7 @@ export function WelcomeScreen({ mode, missingPath, defaultVaultPath, onCreateVau
           }}
         >
           {isWelcome
-            ? <span style={{ fontSize: 28, color: 'var(--accent-blue)' }}>✦</span>
+            ? <span style={{ fontSize: 28, color: 'var(--accent-blue)' }}>&#10022;</span>
             : <AlertTriangle size={28} style={{ color: 'var(--accent-orange)' }} />
           }
         </div>
@@ -161,45 +195,40 @@ export function WelcomeScreen({ mode, missingPath, defaultVaultPath, onCreateVau
 
         <div style={DIVIDER_STYLE} />
 
-        <div style={{ width: '100%', display: 'flex', flexDirection: 'column', gap: 12 }}>
-          <button
-            style={{
-              ...PRIMARY_BTN_STYLE,
-              opacity: creating ? 0.7 : hoverPrimary ? 0.9 : 1,
-            }}
-            onClick={onCreateVault}
+        <div style={{ width: '100%', display: 'flex', flexDirection: 'column', gap: 10 }}>
+          <OptionButton
+            icon={<Plus size={18} style={{ color: 'var(--accent-blue)' }} />}
+            iconBg="var(--accent-blue-light, #EBF4FF)"
+            label="Create a new vault"
+            description="Start fresh in a folder you choose"
+            onClick={onCreateNewVault}
             disabled={creating}
-            onMouseEnter={() => setHoverPrimary(true)}
-            onMouseLeave={() => setHoverPrimary(false)}
-            data-testid="welcome-create-vault"
-          >
-            {creating ? <Loader2 size={16} className="animate-spin" /> : <Plus size={16} />}
-            {creating ? 'Creating vault…' : 'Create Getting Started vault'}
-          </button>
+            testId="welcome-create-new"
+          />
 
-          <button
-            style={{
-              ...SECONDARY_BTN_STYLE,
-              background: hoverSecondary ? 'var(--sidebar)' : 'var(--background)',
-            }}
+          <OptionButton
+            icon={<FolderOpen size={18} style={{ color: 'var(--accent-green)' }} />}
+            iconBg="var(--accent-green-light, #E8F5E9)"
+            label={isWelcome ? 'Open existing vault' : 'Choose a different folder'}
+            description="Point to a folder you already have"
             onClick={onOpenFolder}
             disabled={creating}
-            onMouseEnter={() => setHoverSecondary(true)}
-            onMouseLeave={() => setHoverSecondary(false)}
-            data-testid="welcome-open-folder"
-          >
-            <FolderOpen size={16} />
-            {isWelcome ? 'Open an existing folder' : 'Choose a different folder'}
-          </button>
+            testId="welcome-open-folder"
+          />
+
+          <OptionButton
+            icon={<Rocket size={18} style={{ color: 'var(--accent-purple)' }} />}
+            iconBg="var(--accent-purple-light, #F3E8FF)"
+            label="Get started with a template"
+            description={`A ready-made vault to explore first \u2014 ${defaultVaultPath}`}
+            onClick={onCreateVault}
+            disabled={creating}
+            loading={creating}
+            testId="welcome-create-vault"
+          />
         </div>
 
         {error && <p style={ERROR_STYLE} data-testid="welcome-error">{error}</p>}
-
-        {isWelcome && !error && (
-          <p style={HINT_STYLE}>
-            The Getting Started vault will be created in {defaultVaultPath}
-          </p>
-        )}
       </div>
     </div>
   )

src/components/inspector/NoteInfoPanel.test.tsx

@@ -0,0 +1,81 @@
+import { describe, it, expect } from 'vitest'
+import { render, screen } from '@testing-library/react'
+import { NoteInfoPanel } from './NoteInfoPanel'
+import type { VaultEntry } from '../../types'
+
+function makeEntry(overrides: Partial<VaultEntry> = {}): VaultEntry {
+  return {
+    path: '/vault/test.md', filename: 'test.md', title: 'Test', isA: 'Note',
+    aliases: [], outgoingLinks: [], relationships: {}, tags: [],
+    modifiedAt: 1700000000, createdAt: 1700000000, fileSize: 1024,
+    icon: null, color: null, archived: false, trashed: false, favorite: false,
+    ...overrides,
+  }
+}
+
+describe('NoteInfoPanel', () => {
+  it('renders Info section header with icon', () => {
+    render(<NoteInfoPanel entry={makeEntry()} content="" />)
+    expect(screen.getByText('Info')).toBeInTheDocument()
+  })
+
+  it('renders Modified and Words in read-only Info section', () => {
+    render(<NoteInfoPanel entry={makeEntry({ modifiedAt: 1700000000 })} content="---\ntitle: Test\n---\nOne two three" />)
+    const readOnlyRows = screen.getAllByTestId('readonly-property')
+    const labels = readOnlyRows.map(row => row.querySelector('span')?.textContent)
+    expect(labels).toContain('Modified')
+    expect(labels).toContain('Words')
+  })
+
+  it('renders Created date', () => {
+    render(<NoteInfoPanel entry={makeEntry({ createdAt: 1700000000 })} content="" />)
+    const readOnlyRows = screen.getAllByTestId('readonly-property')
+    const labels = readOnlyRows.map(row => row.querySelector('span')?.textContent)
+    expect(labels).toContain('Created')
+  })
+
+  it('renders file size', () => {
+    render(<NoteInfoPanel entry={makeEntry({ fileSize: 4300 })} content="" />)
+    expect(screen.getByText('Size')).toBeInTheDocument()
+    expect(screen.getByText('4.2 KB')).toBeInTheDocument()
+  })
+
+  it('shows em dash for null timestamps', () => {
+    render(<NoteInfoPanel entry={makeEntry({ modifiedAt: null, createdAt: null })} content="" />)
+    const dashes = screen.getAllByText('\u2014')
+    expect(dashes.length).toBeGreaterThanOrEqual(2)
+  })
+
+  it('read-only rows do not have hover styling', () => {
+    render(<NoteInfoPanel entry={makeEntry()} content="" />)
+    const readOnlyRows = screen.getAllByTestId('readonly-property')
+    readOnlyRows.forEach(row => {
+      expect(row.className).not.toContain('hover:bg-muted')
+    })
+  })
+
+  it('formats file sizes correctly', () => {
+    const { rerender } = render(<NoteInfoPanel entry={makeEntry({ fileSize: 500 })} content="" />)
+    expect(screen.getByText('500 B')).toBeInTheDocument()
+
+    rerender(<NoteInfoPanel entry={makeEntry({ fileSize: 2048 })} content="" />)
+    expect(screen.getByText('2.0 KB')).toBeInTheDocument()
+
+    rerender(<NoteInfoPanel entry={makeEntry({ fileSize: 1048576 })} content="" />)
+    expect(screen.getByText('1.0 MB')).toBeInTheDocument()
+  })
+
+  it('uses CSS grid with two equal columns on read-only rows', () => {
+    render(<NoteInfoPanel entry={makeEntry()} content="" />)
+    const readOnlyRows = screen.getAllByTestId('readonly-property')
+    readOnlyRows.forEach(row => {
+      expect(row.className).toContain('grid')
+      expect(row.className).toContain('grid-cols-2')
+    })
+  })
+
+  it('renders word count from content', () => {
+    render(<NoteInfoPanel entry={makeEntry()} content="---\ntitle: Test\n---\nOne two three four" />)
+    expect(screen.getByText('Words')).toBeInTheDocument()
+  })
+})

src/components/inspector/NoteInfoPanel.tsx

@@ -0,0 +1,44 @@
+import type { VaultEntry } from '../../types'
+import { Info } from '@phosphor-icons/react'
+import { countWords } from '../../utils/wikilinks'
+
+function formatDate(timestamp: number | null): string {
+  if (!timestamp) return '\u2014'
+  const d = new Date(timestamp * 1000)
+  return d.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' })
+}
+
+function formatFileSize(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`
+  const kb = bytes / 1024
+  if (kb < 1024) return `${kb.toFixed(1)} KB`
+  const mb = kb / 1024
+  return `${mb.toFixed(1)} MB`
+}
+
+function InfoRow({ label, value }: { label: string; value: string }) {
+  return (
+    <div className="grid min-w-0 grid-cols-2 items-center gap-2 px-1.5" data-testid="readonly-property">
+      <span className="min-w-0 truncate text-[12px] text-muted-foreground">{label}</span>
+      <span className="min-w-0 truncate text-right text-[12px]" style={{ color: 'var(--text-muted)' }}>{value}</span>
+    </div>
+  )
+}
+
+export function NoteInfoPanel({ entry, content }: { entry: VaultEntry; content: string | null }) {
+  const wordCount = countWords(content ?? '')
+  return (
+    <div>
+      <h4 className="font-mono-overline mb-2 flex items-center gap-1 text-muted-foreground">
+        <Info size={12} className="shrink-0" />
+        Info
+      </h4>
+      <div className="flex flex-col gap-1.5">
+        <InfoRow label="Modified" value={formatDate(entry.modifiedAt)} />
+        <InfoRow label="Created" value={formatDate(entry.createdAt)} />
+        <InfoRow label="Words" value={String(wordCount)} />
+        <InfoRow label="Size" value={formatFileSize(entry.fileSize)} />
+      </div>
+    </div>
+  )
+}

src/components/inspector/RelationshipsPanel.tsx

@@ -342,7 +342,7 @@ function AddRelationshipForm({ entries, onAddProperty, onCreateAndOpenNote }: {
 
   if (!showForm) {
     return (
-      <button className="mt-2 w-full border border-border bg-transparent text-center text-muted-foreground" style={{ borderRadius: 6, padding: '6px 12px', fontSize: 12, cursor: 'pointer' }} onClick={() => { setShowForm(true); setTimeout(() => keyInputRef.current?.focus(), 0) }}>+ Link existing</button>
+      <button className="mt-2 w-full border border-border bg-transparent text-center text-muted-foreground" style={{ borderRadius: 6, padding: '6px 12px', fontSize: 12, cursor: 'pointer' }} onClick={() => { setShowForm(true); setTimeout(() => keyInputRef.current?.focus(), 0) }}>+ Add relationship</button>
     )
   }
 
@@ -390,7 +390,44 @@ function updateRefsForAddition(refs: string[], noteTitle: string): FrontmatterVa
 
 function DisabledLinkButton() {
   return (
-    <button className="mt-2 w-full border border-border bg-transparent text-center text-muted-foreground" style={{ borderRadius: 6, padding: '6px 12px', fontSize: 12, opacity: 0.5, cursor: 'not-allowed' }} disabled>+ Link existing</button>
+    <button className="mt-2 w-full border border-border bg-transparent text-center text-muted-foreground" style={{ borderRadius: 6, padding: '6px 12px', fontSize: 12, opacity: 0.5, cursor: 'not-allowed' }} disabled>+ Add relationship</button>
+  )
+}
+
+const SUGGESTED_RELATIONSHIPS = ['Belongs to', 'Related to', 'Has'] as const
+
+function SuggestedRelationshipSlot({ label, entries, onAdd, onCreateAndOpenNote }: {
+  label: string
+  entries: VaultEntry[]
+  onAdd: (noteTitle: string) => void
+  onCreateAndOpenNote?: (title: string) => Promise<boolean>
+}) {
+  const [active, setActive] = useState(false)
+
+  if (active) {
+    return (
+      <div className="mb-2.5">
+        <span className="font-mono-overline mb-1 block text-muted-foreground/50">{label}</span>
+        <InlineAddNote
+          entries={entries}
+          onAdd={(noteTitle) => { onAdd(noteTitle); setActive(false) }}
+          onCreateAndOpenNote={onCreateAndOpenNote}
+        />
+      </div>
+    )
+  }
+
+  return (
+    <button
+      className="mb-2.5 flex w-full cursor-pointer items-center gap-2 rounded border-none bg-transparent px-0 py-1 text-left outline-none transition-colors hover:bg-muted focus:bg-muted focus:ring-1 focus:ring-primary"
+      tabIndex={0}
+      onClick={() => setActive(true)}
+      onKeyDown={e => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); setActive(true) } }}
+      data-testid="suggested-relationship"
+    >
+      <span className="font-mono-overline text-muted-foreground/50">{label}</span>
+      <span className="text-[12px] text-muted-foreground/30">{'\u2014'}</span>
+    </button>
   )
 }
 
@@ -422,6 +459,15 @@ export function DynamicRelationshipsPanel({ frontmatter, entries, typeEntryMap,
 
   const canEdit = !!onUpdateProperty && !!onDeleteProperty
 
+  const existingRelKeys = useMemo(
+    () => new Set(relationshipEntries.map(g => g.key.toLowerCase())),
+    [relationshipEntries],
+  )
+
+  const missingSuggestedRels = onAddProperty
+    ? SUGGESTED_RELATIONSHIPS.filter(r => !existingRelKeys.has(r.toLowerCase()))
+    : []
+
   return (
     <div>
       {relationshipEntries.map(({ key, refs }) => (
@@ -432,6 +478,15 @@ export function DynamicRelationshipsPanel({ frontmatter, entries, typeEntryMap,
           onCreateAndOpenNote={canEdit ? onCreateAndOpenNote : undefined}
         />
       ))}
+      {missingSuggestedRels.map(label => (
+        <SuggestedRelationshipSlot
+          key={label}
+          label={label}
+          entries={entries}
+          onAdd={(noteTitle) => onAddProperty!(label, `[[${noteTitle}]]`)}
+          onCreateAndOpenNote={onCreateAndOpenNote}
+        />
+      ))}
       {onAddProperty
         ? <AddRelationshipForm entries={entries} onAddProperty={onAddProperty} onCreateAndOpenNote={onCreateAndOpenNote} />
         : <DisabledLinkButton />

src/components/note-list/InboxFilterPills.tsx

@@ -11,7 +11,6 @@ interface InboxFilterPillsProps {
 const PILLS: { value: InboxPeriod; label: string }[] = [
   { value: 'week', label: 'Week' },
   { value: 'month', label: 'Month' },
-  { value: 'quarter', label: 'Quarter' },
   { value: 'all', label: 'All' },
 ]
 

src/components/note-list/ListPropertiesPopover.tsx

@@ -0,0 +1,142 @@
+import { useState, useMemo, useCallback } from 'react'
+import { SlidersHorizontal, DotsSixVertical } from '@phosphor-icons/react'
+import { Popover, PopoverTrigger, PopoverContent } from '@/components/ui/popover'
+import type { VaultEntry } from '../../types'
+import {
+  DndContext, closestCenter, KeyboardSensor, PointerSensor,
+  useSensor, useSensors, type DragEndEvent,
+} from '@dnd-kit/core'
+import {
+  SortableContext, sortableKeyboardCoordinates, useSortable, verticalListSortingStrategy,
+  arrayMove,
+} from '@dnd-kit/sortable'
+import { CSS } from '@dnd-kit/utilities'
+
+interface ListPropertiesPopoverProps {
+  typeDocument: VaultEntry
+  entries: VaultEntry[]
+  onSave: (path: string, key: string, value: string[] | null) => void
+}
+
+/** Collect all available property/relationship keys from notes of this type. */
+function collectAvailableProperties(entries: VaultEntry[], typeName: string): string[] {
+  const keys = new Set<string>()
+  for (const entry of entries) {
+    if (entry.isA !== typeName) continue
+    for (const k of Object.keys(entry.properties)) keys.add(k)
+    for (const k of Object.keys(entry.relationships)) keys.add(k)
+  }
+  // Sort alphabetically for stable ordering
+  return [...keys].sort((a, b) => a.localeCompare(b))
+}
+
+function SortablePropertyItem({ id, checked, onToggle }: { id: string; checked: boolean; onToggle: (key: string) => void }) {
+  const { attributes, listeners, setNodeRef, transform, transition } = useSortable({ id })
+  const style = { transform: CSS.Transform.toString(transform), transition }
+
+  return (
+    <div
+      ref={setNodeRef}
+      style={style}
+      className="flex items-center gap-2 rounded px-1 py-1 hover:bg-muted"
+      data-testid={`list-prop-item-${id}`}
+    >
+      <button
+        type="button"
+        className="flex shrink-0 cursor-grab items-center text-muted-foreground active:cursor-grabbing"
+        {...attributes}
+        {...listeners}
+      >
+        <DotsSixVertical size={14} />
+      </button>
+      <label className="flex flex-1 cursor-pointer items-center gap-2 text-[13px]">
+        <input
+          type="checkbox"
+          checked={checked}
+          onChange={() => onToggle(id)}
+          className="accent-primary"
+          style={{ width: 14, height: 14 }}
+        />
+        <span className="truncate">{id}</span>
+      </label>
+    </div>
+  )
+}
+
+export function ListPropertiesPopover({ typeDocument, entries, onSave }: ListPropertiesPopoverProps) {
+  const [open, setOpen] = useState(false)
+  const currentDisplay = typeDocument.listPropertiesDisplay ?? []
+
+  const availableProperties = useMemo(
+    () => collectAvailableProperties(entries, typeDocument.title),
+    [entries, typeDocument.title],
+  )
+
+  // Merge: selected props first (in order), then unselected alphabetically
+  const orderedItems = useMemo(() => {
+    const selected = currentDisplay.filter((p) => availableProperties.includes(p))
+    const unselected = availableProperties.filter((p) => !selected.includes(p))
+    return [...selected, ...unselected]
+  }, [currentDisplay, availableProperties])
+
+  const selectedSet = useMemo(() => new Set(currentDisplay), [currentDisplay])
+
+  const sensors = useSensors(
+    useSensor(PointerSensor, { activationConstraint: { distance: 5 } }),
+    useSensor(KeyboardSensor, { coordinateGetter: sortableKeyboardCoordinates }),
+  )
+
+  const handleToggle = useCallback((key: string) => {
+    const newSelected = selectedSet.has(key)
+      ? currentDisplay.filter((k) => k !== key)
+      : [...currentDisplay, key]
+    onSave(typeDocument.path, '_list_properties_display', newSelected.length > 0 ? newSelected : null)
+  }, [selectedSet, currentDisplay, typeDocument.path, onSave])
+
+  const handleDragEnd = useCallback((event: DragEndEvent) => {
+    const { active, over } = event
+    if (!over || active.id === over.id) return
+
+    // Only reorder within selected items
+    const selected = currentDisplay.filter((p) => availableProperties.includes(p))
+    const oldIndex = selected.indexOf(String(active.id))
+    const newIndex = selected.indexOf(String(over.id))
+    if (oldIndex === -1 || newIndex === -1) return
+
+    const reordered = arrayMove(selected, oldIndex, newIndex)
+    onSave(typeDocument.path, '_list_properties_display', reordered)
+  }, [currentDisplay, availableProperties, typeDocument.path, onSave])
+
+  if (availableProperties.length === 0) return null
+
+  return (
+    <Popover open={open} onOpenChange={setOpen}>
+      <PopoverTrigger asChild>
+        <button
+          className="flex items-center text-muted-foreground transition-colors hover:text-foreground"
+          title="Configure list properties"
+          data-testid="list-properties-btn"
+        >
+          <SlidersHorizontal size={16} />
+        </button>
+      </PopoverTrigger>
+      <PopoverContent align="end" className="w-56 p-2" data-testid="list-properties-popover">
+        <div className="mb-2 px-1 text-[11px] font-medium text-muted-foreground">
+          Show in note list
+        </div>
+        <DndContext sensors={sensors} collisionDetection={closestCenter} onDragEnd={handleDragEnd}>
+          <SortableContext items={orderedItems} strategy={verticalListSortingStrategy}>
+            {orderedItems.map((key) => (
+              <SortablePropertyItem
+                key={key}
+                id={key}
+                checked={selectedSet.has(key)}
+                onToggle={handleToggle}
+              />
+            ))}
+          </SortableContext>
+        </DndContext>
+      </PopoverContent>
+    </Popover>
+  )
+}

src/components/note-list/NoteListHeader.tsx

@@ -4,8 +4,9 @@ import type { SortOption, SortDirection } from '../../utils/noteListHelpers'
 import { Input } from '@/components/ui/input'
 import { useDragRegion } from '../../hooks/useDragRegion'
 import { SortDropdown } from '../SortDropdown'
+import { ListPropertiesPopover } from './ListPropertiesPopover'
 
-export function NoteListHeader({ title, typeDocument, isEntityView, isTrashView, trashCount, listSort, listDirection, customProperties, sidebarCollapsed, searchVisible, search, onSortChange, onCreateNote, onOpenType, onToggleSearch, onSearchChange, onEmptyTrash }: {
+export function NoteListHeader({ title, typeDocument, isEntityView, isTrashView, trashCount, listSort, listDirection, customProperties, sidebarCollapsed, searchVisible, search, isSectionGroup, entries, onSortChange, onCreateNote, onOpenType, onToggleSearch, onSearchChange, onEmptyTrash, onUpdateTypeProperty }: {
   title: string
   typeDocument: VaultEntry | null
   isEntityView: boolean
@@ -17,12 +18,15 @@ export function NoteListHeader({ title, typeDocument, isEntityView, isTrashView,
   sidebarCollapsed?: boolean
   searchVisible: boolean
   search: string
+  isSectionGroup?: boolean
+  entries?: VaultEntry[]
   onSortChange: (groupLabel: string, option: SortOption, direction: SortDirection) => void
   onCreateNote: () => void
   onOpenType: (entry: VaultEntry) => void
   onToggleSearch: () => void
   onSearchChange: (value: string) => void
   onEmptyTrash?: () => void
+  onUpdateTypeProperty?: (path: string, key: string, value: string | number | boolean | string[] | null) => void
 }) {
   const { onMouseDown: onDragMouseDown } = useDragRegion()
   return (
@@ -41,6 +45,9 @@ export function NoteListHeader({ title, typeDocument, isEntityView, isTrashView,
           <button className="flex items-center text-muted-foreground transition-colors hover:text-foreground" onClick={onToggleSearch} title="Search notes">
             <MagnifyingGlass size={16} />
           </button>
+          {isSectionGroup && typeDocument && entries && onUpdateTypeProperty && (
+            <ListPropertiesPopover typeDocument={typeDocument} entries={entries} onSave={onUpdateTypeProperty} />
+          )}
           {isTrashView && trashCount > 0 && (
             <button
               className="flex items-center text-destructive transition-colors hover:text-destructive/80"

src/hooks/commands/typeCommands.ts

@@ -18,7 +18,12 @@ export function pluralizeType(type: string): string {
 export function extractVaultTypes(entries: VaultEntry[]): string[] {
   const typeSet = new Set<string>()
   for (const e of entries) {
-    if (e.isA && e.isA !== 'Type' && !e.trashed) typeSet.add(e.isA)
+    if (e.trashed) continue
+    if (e.isA === 'Type' && e.title) {
+      typeSet.add(e.title)
+    } else if (e.isA && e.isA !== 'Type') {
+      typeSet.add(e.isA)
+    }
   }
   if (typeSet.size === 0) return DEFAULT_TYPES
   return Array.from(typeSet).sort()

src/hooks/frontmatterOps.ts

@@ -15,6 +15,7 @@ const ENTRY_DELETE_MAP: Record<string, Partial<VaultEntry>> = {
   order: { order: null },
   template: { template: null }, sort: { sort: null }, visible: { visible: null },
   _favorite: { favorite: false }, _favorite_index: { favoriteIndex: null },
+  _list_properties_display: { listPropertiesDisplay: [] },
 }
 
 /** Check if a string contains a wikilink pattern `[[...]]`. */
@@ -64,6 +65,7 @@ export function frontmatterToEntryPatch(
     visible: { visible: value === false ? false : null },
     _favorite: { favorite: Boolean(value) },
     _favorite_index: { favoriteIndex: typeof value === 'number' ? value : null },
+    _list_properties_display: { listPropertiesDisplay: Array.isArray(value) ? value.map(String) : [] },
   }
   // Also update the relationships map for wikilink-containing values
   const wikilinks = value != null ? extractWikilinks(value) : []

src/hooks/useAppCommands.ts

@@ -55,6 +55,8 @@ interface AppCommandsConfig {
   vaultCount?: number
   mcpStatus?: string
   onInstallMcp?: () => void
+  claudeCodeStatus?: string
+  claudeCodeVersion?: string
   onEmptyTrash?: () => void
   trashedCount?: number
   onReloadVault?: () => void

src/hooks/useAppKeyboard.ts

@@ -1,5 +1,6 @@
 import { useEffect } from 'react'
 import type { ViewMode } from './useViewMode'
+import { trackEvent } from '../lib/telemetry'
 
 interface KeyboardActions {
   onQuickOpen: () => void
@@ -104,6 +105,7 @@ export function useAppKeyboard({
       // Cmd+Shift+F: full-text search (distinct from Cmd+F browser find)
       if ((e.metaKey || e.ctrlKey) && e.shiftKey && e.key === 'f') {
         e.preventDefault()
+        trackEvent('search_used')
         onSearch()
         return
       }

src/hooks/useAutoSync.ts

@@ -2,6 +2,7 @@ import { useCallback, useEffect, useRef, useState } from 'react'
 import { invoke } from '@tauri-apps/api/core'
 import { isTauri, mockInvoke } from '../mock-tauri'
 import type { GitPullResult, GitPushResult, GitRemoteStatus, LastCommitInfo, SyncStatus } from '../types'
+import { trackEvent } from '../lib/telemetry'
 
 const DEFAULT_INTERVAL_MS = 5 * 60_000
 
@@ -219,5 +220,10 @@ export function useAutoSync({
   const pausePull = useCallback(() => { pauseRef.current = true }, [])
   const resumePull = useCallback(() => { pauseRef.current = false }, [])
 
-  return { syncStatus, lastSyncTime, conflictFiles, lastCommitInfo, remoteStatus, triggerSync: performPull, pullAndPush, pausePull, resumePull, handlePushRejected }
+  const triggerSync = useCallback(() => {
+    trackEvent('sync_triggered')
+    performPull()
+  }, [performPull])
+
+  return { syncStatus, lastSyncTime, conflictFiles, lastCommitInfo, remoteStatus, triggerSync, pullAndPush, pausePull, resumePull, handlePushRejected }
 }

src/hooks/useClaudeCodeStatus.test.ts

@@ -0,0 +1,63 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { renderHook, waitFor } from '@testing-library/react'
+import { useClaudeCodeStatus } from './useClaudeCodeStatus'
+
+vi.mock('@tauri-apps/api/core', () => ({
+  invoke: vi.fn(),
+}))
+
+vi.mock('../mock-tauri', () => ({
+  isTauri: () => false,
+  mockInvoke: vi.fn(),
+}))
+
+const { mockInvoke } = await import('../mock-tauri') as { mockInvoke: ReturnType<typeof vi.fn> }
+
+describe('useClaudeCodeStatus', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  it('starts in checking state and resolves to installed', async () => {
+    mockInvoke.mockImplementation((cmd: string) => {
+      if (cmd === 'check_claude_cli') return Promise.resolve({ installed: true, version: '1.0.20' })
+      return Promise.resolve(null)
+    })
+
+    const { result } = renderHook(() => useClaudeCodeStatus())
+
+    expect(result.current.status).toBe('checking')
+
+    await waitFor(() => {
+      expect(result.current.status).toBe('installed')
+      expect(result.current.version).toBe('1.0.20')
+    })
+  })
+
+  it('resolves to missing when claude is not installed', async () => {
+    mockInvoke.mockImplementation((cmd: string) => {
+      if (cmd === 'check_claude_cli') return Promise.resolve({ installed: false, version: null })
+      return Promise.resolve(null)
+    })
+
+    const { result } = renderHook(() => useClaudeCodeStatus())
+
+    await waitFor(() => {
+      expect(result.current.status).toBe('missing')
+      expect(result.current.version).toBeNull()
+    })
+  })
+
+  it('resolves to missing on error', async () => {
+    mockInvoke.mockImplementation((cmd: string) => {
+      if (cmd === 'check_claude_cli') return Promise.reject(new Error('failed'))
+      return Promise.resolve(null)
+    })
+
+    const { result } = renderHook(() => useClaudeCodeStatus())
+
+    await waitFor(() => {
+      expect(result.current.status).toBe('missing')
+    })
+  })
+})

src/hooks/useClaudeCodeStatus.ts

@@ -0,0 +1,41 @@
+import { useEffect, useState } from 'react'
+import { invoke } from '@tauri-apps/api/core'
+import { isTauri, mockInvoke } from '../mock-tauri'
+
+export type ClaudeCodeStatus = 'checking' | 'installed' | 'missing'
+
+interface ClaudeCliResult {
+  installed: boolean
+  version: string | null
+}
+
+function tauriCall<T>(command: string): Promise<T> {
+  return isTauri() ? invoke<T>(command) : mockInvoke<T>(command)
+}
+
+/**
+ * Checks once on mount whether the `claude` CLI binary is available.
+ * Returns a status suitable for the status bar badge.
+ */
+export function useClaudeCodeStatus(): { status: ClaudeCodeStatus; version: string | null } {
+  const [status, setStatus] = useState<ClaudeCodeStatus>('checking')
+  const [version, setVersion] = useState<string | null>(null)
+
+  useEffect(() => {
+    let cancelled = false
+
+    tauriCall<ClaudeCliResult>('check_claude_cli')
+      .then((result) => {
+        if (cancelled) return
+        setStatus(result.installed ? 'installed' : 'missing')
+        setVersion(result.version ?? null)
+      })
+      .catch(() => {
+        if (!cancelled) setStatus('missing')
+      })
+
+    return () => { cancelled = true }
+  }, [])
+
+  return { status, version }
+}

src/hooks/useCommandRegistry.test.ts

@@ -192,6 +192,33 @@ describe('extractVaultTypes', () => {
     ] as never[]
     expect(extractVaultTypes(entries)).toEqual(['Event', 'Person', 'Project', 'Note'])
   })
+
+  it('includes types from Type definition entries', () => {
+    const entries = [
+      { path: '/book.md', title: 'Book', isA: 'Type', trashed: false },
+    ] as never[]
+    const types = extractVaultTypes(entries)
+    expect(types).toContain('Book')
+  })
+
+  it('includes types from both definitions and instances', () => {
+    const entries = [
+      { path: '/book.md', title: 'Book', isA: 'Type', trashed: false },
+      { path: '/hp.md', title: 'Harry Potter', isA: 'Book', trashed: false },
+      { path: '/person.md', title: 'Person', isA: 'Type', trashed: false },
+    ] as never[]
+    const types = extractVaultTypes(entries)
+    expect(types).toContain('Book')
+    expect(types).toContain('Person')
+    expect(types).toHaveLength(2)
+  })
+
+  it('excludes trashed Type definition entries', () => {
+    const entries = [
+      { path: '/book.md', title: 'Book', isA: 'Type', trashed: true },
+    ] as never[]
+    expect(extractVaultTypes(entries)).toEqual(['Event', 'Person', 'Project', 'Note'])
+  })
 })
 
 describe('groupSortKey', () => {

src/hooks/useCommitFlow.ts

@@ -1,5 +1,6 @@
 import { useCallback, useState } from 'react'
 import type { GitPushResult } from '../types'
+import { trackEvent } from '../lib/telemetry'
 
 interface CommitFlowConfig {
   savePending: () => Promise<void | boolean>
@@ -25,6 +26,7 @@ export function useCommitFlow({ savePending, loadModifiedFiles, commitAndPush, s
       await savePending()
       const result = await commitAndPush(message)
       if (result.status === 'ok') {
+        trackEvent('commit_made')
         setToastMessage('Committed and pushed')
       } else if (result.status === 'rejected') {
         setToastMessage('Committed, but push rejected — remote has new commits. Pull first.')

src/hooks/useDeleteActions.ts

@@ -2,6 +2,7 @@ import { useCallback, useMemo, useState } from 'react'
 import { invoke } from '@tauri-apps/api/core'
 import { isTauri, mockInvoke } from '../mock-tauri'
 import type { VaultEntry } from '../types'
+import { trackEvent } from '../lib/telemetry'
 
 interface ConfirmDeleteState {
   title: string
@@ -50,7 +51,10 @@ export function useDeleteActions({
       onConfirm: async () => {
         setConfirmDelete(null)
         const ok = await deleteNoteFromDisk(path)
-        if (ok) setToastMessage('Note permanently deleted')
+        if (ok) {
+          trackEvent('note_deleted')
+          setToastMessage('Note permanently deleted')
+        }
       },
     })
   }, [deleteNoteFromDisk, setToastMessage])

src/hooks/useDialogs.ts

@@ -1,4 +1,5 @@
 import { useState, useCallback } from 'react'
+import type { ViewDefinition } from '../types'
 
 export function useDialogs() {
   const [showCreateTypeDialog, setShowCreateTypeDialog] = useState(false)
@@ -10,6 +11,7 @@ export function useDialogs() {
   const [showSearch, setShowSearch] = useState(false)
   const [showConflictResolver, setShowConflictResolver] = useState(false)
   const [showCreateViewDialog, setShowCreateViewDialog] = useState(false)
+  const [editingView, setEditingView] = useState<{ filename: string; definition: ViewDefinition } | null>(null)
 
   const openCreateType = useCallback(() => setShowCreateTypeDialog(true), [])
   const closeCreateType = useCallback(() => setShowCreateTypeDialog(false), [])
@@ -26,8 +28,12 @@ export function useDialogs() {
   const closeSearch = useCallback(() => setShowSearch(false), [])
   const openConflictResolver = useCallback(() => setShowConflictResolver(true), [])
   const closeConflictResolver = useCallback(() => setShowConflictResolver(false), [])
-  const openCreateView = useCallback(() => setShowCreateViewDialog(true), [])
-  const closeCreateView = useCallback(() => setShowCreateViewDialog(false), [])
+  const openCreateView = useCallback(() => { setEditingView(null); setShowCreateViewDialog(true) }, [])
+  const closeCreateView = useCallback(() => { setShowCreateViewDialog(false); setEditingView(null) }, [])
+  const openEditView = useCallback((filename: string, definition: ViewDefinition) => {
+    setEditingView({ filename, definition })
+    setShowCreateViewDialog(true)
+  }, [])
 
   return {
     showCreateTypeDialog, openCreateType, closeCreateType,
@@ -38,6 +44,6 @@ export function useDialogs() {
     showGitHubVault, openGitHubVault, closeGitHubVault,
     showSearch, openSearch, closeSearch,
     showConflictResolver, openConflictResolver, closeConflictResolver,
-    showCreateViewDialog, openCreateView, closeCreateView,
+    showCreateViewDialog, openCreateView, closeCreateView, editingView, openEditView,
   }
 }

src/hooks/useEntryActions.ts

@@ -1,6 +1,7 @@
 import { useCallback } from 'react'
 import type { VaultEntry } from '../types'
 import type { FrontmatterOpOptions } from './frontmatterOps'
+import { trackEvent } from '../lib/telemetry'
 
 interface EntryActionsConfig {
   entries: VaultEntry[]
@@ -32,6 +33,7 @@ export function useEntryActions({
     // Optimistic: update UI immediately, write to disk async with rollback on failure
     const trashedAt = Date.now() / 1000
     updateEntry(path, { trashed: true, trashedAt })
+    trackEvent('note_trashed')
     setToastMessage('Note moved to trash')
     const now = new Date().toISOString().slice(0, 10)
     try {
@@ -64,6 +66,7 @@ export function useEntryActions({
     await onBeforeAction?.(path)
     // Optimistic: update UI immediately, write to disk async with rollback on failure
     updateEntry(path, { archived: true })
+    trackEvent('note_archived')
     setToastMessage('Note archived')
     try {
       await handleUpdateFrontmatter(path, '_archived', true, { silent: true })
@@ -129,6 +132,7 @@ export function useEntryActions({
     const entry = entries.find((e) => e.path === path)
     if (!entry) return
     if (entry.favorite) {
+      trackEvent('note_unfavorited')
       updateEntry(path, { favorite: false, favoriteIndex: null })
       try {
         await handleDeleteProperty(path, '_favorite', { silent: true })
@@ -139,6 +143,7 @@ export function useEntryActions({
         setToastMessage('Failed to unfavorite — rolled back')
       }
     } else {
+      trackEvent('note_favorited')
       const maxIndex = entries.filter((e) => e.favorite).reduce((max, e) => Math.max(max, e.favoriteIndex ?? 0), 0)
       const newIndex = maxIndex + 1
       updateEntry(path, { favorite: true, favoriteIndex: newIndex })

src/hooks/useFeatureFlag.ts

@@ -1,19 +1,15 @@
 /**
- * Local feature flag hook (V1 — no remote fetching).
+ * Feature flag hook backed by PostHog + release channels.
  *
  * Flags are resolved in order:
  *   1. localStorage override (`ff_<name>`) — for dev/QA testing
- *   2. Compile-time defaults in FLAG_DEFAULTS
- *
- * To add a new flag: add its name to the FeatureFlagName union and
- * set its default in FLAG_DEFAULTS.
+ *   2. PostHog feature flags (evaluated by release channel)
+ *   3. Alpha channel always returns true (sees all features)
  */
 
-export type FeatureFlagName = 'example_flag'
+import { isFeatureEnabled } from '../lib/telemetry'
 
-const FLAG_DEFAULTS: Record<FeatureFlagName, boolean> = {
-  example_flag: false,
-}
+export type FeatureFlagName = 'example_flag'
 
 export function useFeatureFlag(flag: FeatureFlagName): boolean {
   try {
@@ -22,5 +18,5 @@ export function useFeatureFlag(flag: FeatureFlagName): boolean {
   } catch {
     // localStorage may be unavailable in some contexts
   }
-  return FLAG_DEFAULTS[flag] ?? false
+  return isFeatureEnabled(flag)
 }

src/hooks/useNoteActions.test.ts

@@ -401,6 +401,16 @@ describe('frontmatterToEntryPatch', () => {
     },
   )
 
+  it('maps _list_properties_display update to listPropertiesDisplay array', () => {
+    const result = frontmatterToEntryPatch('update', '_list_properties_display', ['rating', 'genre'])
+    expect(result.patch).toEqual({ listPropertiesDisplay: ['rating', 'genre'] })
+  })
+
+  it('maps _list_properties_display delete to empty array', () => {
+    const result = frontmatterToEntryPatch('delete', '_list_properties_display')
+    expect(result.patch).toEqual({ listPropertiesDisplay: [] })
+  })
+
   it('returns empty patch for unknown key on delete, with relationship removal', () => {
     const result = frontmatterToEntryPatch('delete', 'unknown_key')
     expect(result.patch).toEqual({})

src/hooks/useNoteCreation.ts

@@ -3,6 +3,7 @@ import { invoke } from '@tauri-apps/api/core'
 import { isTauri, addMockEntry } from '../mock-tauri'
 import type { VaultEntry } from '../types'
 import { resolveEntry } from '../utils/wikilink'
+import { trackEvent } from '../lib/telemetry'
 
 export interface NewEntryParams {
   path: string
@@ -19,7 +20,7 @@ export function buildNewEntry({ path, slug, title, type, status }: NewEntryParam
     aliases: [], belongsTo: [], relatedTo: [],
     status, archived: false, trashed: false, trashedAt: null,
     modifiedAt: now, createdAt: now, fileSize: 0,
-    snippet: '', wordCount: 0, relationships: {}, icon: null, color: null, order: null, outgoingLinks: [], sidebarLabel: null, template: null, sort: null, view: null, visible: null, properties: {}, favorite: false, favoriteIndex: null,
+    snippet: '', wordCount: 0, relationships: {}, icon: null, color: null, order: null, outgoingLinks: [], sidebarLabel: null, template: null, sort: null, view: null, visible: null, properties: {}, favorite: false, favoriteIndex: null, listPropertiesDisplay: [],
   }
 }
 
@@ -250,6 +251,7 @@ export function useNoteCreation(config: NoteCreationConfig, tabDeps: CreationTab
   const handleCreateNote = useCallback((title: string, type: string) => {
     const template = resolveTemplate(entries, type)
     persistNew(resolveNewNote(title, type, config.vaultPath, template))
+    trackEvent('note_created', { has_type: type !== 'Note' ? 1 : 0, creation_path: 'plus_button' })
   }, [entries, persistNew, config.vaultPath])
 
   const handleCreateNoteImmediate = useCallback((type?: string) => {
@@ -257,6 +259,7 @@ export function useNoteCreation(config: NoteCreationConfig, tabDeps: CreationTab
       entries, vaultPath: config.vaultPath, pendingNames: pendingNamesRef.current,
       openTabWithContent, addEntry, trackUnsaved: config.trackUnsaved, markContentPending: config.markContentPending,
     }, type)
+    trackEvent('note_created', { has_type: type ? 1 : 0, creation_path: type ? 'type_section' : 'cmd_n' })
   }, [entries, openTabWithContent, addEntry, config.vaultPath, config.trackUnsaved, config.markContentPending])
 
   const handleCreateNoteForRelationship = useCallback((title: string): Promise<boolean> => {
@@ -269,7 +272,10 @@ export function useNoteCreation(config: NoteCreationConfig, tabDeps: CreationTab
 
   const handleOpenDailyNote = useCallback(() => openDailyNote(entries, handleSelectNote, persistNew, config.vaultPath), [entries, handleSelectNote, persistNew, config.vaultPath])
 
-  const handleCreateType = useCallback((typeName: string) => persistNew(resolveNewType(typeName, config.vaultPath)), [persistNew, config.vaultPath])
+  const handleCreateType = useCallback((typeName: string) => {
+    persistNew(resolveNewType(typeName, config.vaultPath))
+    trackEvent('type_created')
+  }, [persistNew, config.vaultPath])
 
   /** Create a Type entry file silently (no tab opened). Adds to state and persists to disk. */
   const createTypeEntrySilent = useCallback(async (typeName: string): Promise<VaultEntry> => {

src/hooks/useOnboarding.test.ts

@@ -131,6 +131,50 @@ describe('useOnboarding', () => {
     expect(result.current.state.status).toBe('welcome')
   })
 
+  it('handleCreateNewVault picks folder, creates empty vault, and transitions to ready', async () => {
+    mockInvokeFn.mockImplementation(async (cmd: string, args?: Record<string, unknown>) => {
+      if (cmd === 'get_default_vault_path') return '/mock/Documents/Getting Started'
+      if (cmd === 'check_vault_exists') return false
+      if (cmd === 'create_empty_vault') return (args as { targetPath: string }).targetPath
+      return null
+    })
+    vi.mocked(pickFolder).mockResolvedValue('/new/vault')
+
+    const { result } = renderHook(() => useOnboarding('/vault/missing'))
+
+    await waitFor(() => {
+      expect(result.current.state.status).toBe('welcome')
+    })
+
+    await act(async () => {
+      await result.current.handleCreateNewVault()
+    })
+
+    expect(result.current.state).toEqual({ status: 'ready', vaultPath: '/new/vault' })
+    expect(localStorage.getItem('laputa_welcome_dismissed')).toBe('1')
+  })
+
+  it('handleCreateNewVault does nothing when picker is cancelled', async () => {
+    mockInvokeFn.mockImplementation(async (cmd: string) => {
+      if (cmd === 'get_default_vault_path') return '/mock/Documents/Getting Started'
+      if (cmd === 'check_vault_exists') return false
+      return null
+    })
+    vi.mocked(pickFolder).mockResolvedValue(null)
+
+    const { result } = renderHook(() => useOnboarding('/vault/missing'))
+
+    await waitFor(() => {
+      expect(result.current.state.status).toBe('welcome')
+    })
+
+    await act(async () => {
+      await result.current.handleCreateNewVault()
+    })
+
+    expect(result.current.state.status).toBe('welcome')
+  })
+
   it('handleOpenFolder opens folder picker and transitions to ready', async () => {
     mockInvokeFn.mockImplementation(async (cmd: string) => {
       if (cmd === 'get_default_vault_path') return '/mock/Documents/Getting Started'

src/hooks/useOnboarding.ts

@@ -78,6 +78,22 @@ export function useOnboarding(initialVaultPath: string) {
     }
   }, [])
 
+  const handleCreateNewVault = useCallback(async () => {
+    try {
+      const path = await pickFolder('Choose where to create your vault')
+      if (!path) return
+      setCreating(true)
+      setError(null)
+      const vaultPath = await tauriCall<string>('create_empty_vault', { targetPath: path })
+      markDismissed()
+      setState({ status: 'ready', vaultPath })
+    } catch (err) {
+      setError(typeof err === 'string' ? err : `Failed to create vault: ${err}`)
+    } finally {
+      setCreating(false)
+    }
+  }, [])
+
   const handleOpenFolder = useCallback(async () => {
     try {
       const path = await pickFolder('Open vault folder')
@@ -94,5 +110,5 @@ export function useOnboarding(initialVaultPath: string) {
     setState({ status: 'ready', vaultPath: initialVaultPath })
   }, [initialVaultPath])
 
-  return { state, creating, error, handleCreateVault, handleOpenFolder, handleDismiss }
+  return { state, creating, error, handleCreateVault, handleCreateNewVault, handleOpenFolder, handleDismiss }
 }

src/hooks/useRawMode.ts

@@ -1,5 +1,6 @@
 import { useState, useCallback, useEffect } from 'react'
 import { getVaultConfig, updateVaultConfigField, subscribeVaultConfig } from '../utils/vaultConfigStore'
+import { trackEvent } from '../lib/telemetry'
 
 interface UseRawModeParams {
   activeTabPath: string | null
@@ -32,6 +33,7 @@ export function useRawMode({ activeTabPath, onFlushPending, onBeforeRawEnd }: Us
   const rawMode = rawEnabled && activeTabPath !== null
 
   const handleToggleRaw = useCallback(async () => {
+    trackEvent('raw_mode_toggled')
     if (rawEnabled) {
       onBeforeRawEnd?.()
       setRawEnabled(false)

src/hooks/useSettings.test.ts

@@ -14,7 +14,7 @@ const defaultSettings: Settings = {
   crash_reporting_enabled: null,
   analytics_enabled: null,
   anonymous_id: null,
-  update_channel: null,
+  release_channel: null,
 }
 
 const savedSettings: Settings = {
@@ -27,7 +27,7 @@ const savedSettings: Settings = {
   crash_reporting_enabled: null,
   analytics_enabled: null,
   anonymous_id: null,
-  update_channel: null,
+  release_channel: null,
 }
 
 let mockSettingsStore: Settings = { ...defaultSettings }
@@ -91,7 +91,7 @@ describe('useSettings', () => {
       crash_reporting_enabled: null,
       analytics_enabled: null,
       anonymous_id: null,
-      update_channel: null,
+      release_channel: null,
     }
 
     await act(async () => {

src/hooks/useSettings.ts

@@ -17,7 +17,7 @@ const EMPTY_SETTINGS: Settings = {
   crash_reporting_enabled: null,
   analytics_enabled: null,
   anonymous_id: null,
-  update_channel: null,
+  release_channel: null,
 }
 
 export function useSettings() {

src/hooks/useTelemetry.test.ts

@@ -13,13 +13,15 @@ vi.mock('../lib/telemetry', () => ({
   teardownSentry: () => mockTeardownSentry(),
   initPostHog: (...args: unknown[]) => mockInitPostHog(...args),
   teardownPostHog: () => mockTeardownPostHog(),
+  updatePostHogIdentify: vi.fn(),
+  setReleaseChannel: vi.fn(),
 }))
 
 const baseSettings: Settings = {
   openai_key: null, google_key: null,
   github_token: null, github_username: null, auto_pull_interval_minutes: null,
   telemetry_consent: null, crash_reporting_enabled: null,
-  analytics_enabled: null, anonymous_id: null, update_channel: null,
+  analytics_enabled: null, anonymous_id: null, release_channel: null,
 }
 
 describe('useTelemetry', () => {
@@ -50,7 +52,7 @@ describe('useTelemetry', () => {
     renderHook(() =>
       useTelemetry({ ...baseSettings, analytics_enabled: true, anonymous_id: 'test-uuid' }, true)
     )
-    expect(mockInitPostHog).toHaveBeenCalledWith('test-uuid')
+    expect(mockInitPostHog).toHaveBeenCalledWith('test-uuid', 'stable')
   })
 
   it('tears down Sentry when crash reporting is disabled after being enabled', () => {

src/hooks/useTelemetry.ts

@@ -1,7 +1,7 @@
 import { useEffect, useRef } from 'react'
 import { invoke } from '@tauri-apps/api/core'
 import { isTauri, mockInvoke } from '../mock-tauri'
-import { initSentry, teardownSentry, initPostHog, teardownPostHog } from '../lib/telemetry'
+import { initSentry, teardownSentry, initPostHog, teardownPostHog, updatePostHogIdentify, setReleaseChannel } from '../lib/telemetry'
 import type { Settings } from '../types'
 
 function tauriCall(command: string): Promise<void> {
@@ -29,13 +29,18 @@ export function useTelemetry(settings: Settings, loaded: boolean): void {
       tauriCall('reinit_telemetry').catch(() => {})
     }
 
+    const channel = settings.release_channel ?? 'stable'
+    setReleaseChannel(channel)
+
     if (analyticsEnabled && id && !prevAnalytics.current) {
-      initPostHog(id)
+      initPostHog(id, channel)
     } else if (!analyticsEnabled && prevAnalytics.current) {
       teardownPostHog()
+    } else if (analyticsEnabled && id) {
+      updatePostHogIdentify(channel)
     }
 
     prevCrash.current = crashEnabled
     prevAnalytics.current = analyticsEnabled
-  }, [loaded, settings.crash_reporting_enabled, settings.analytics_enabled, settings.anonymous_id])
+  }, [loaded, settings.crash_reporting_enabled, settings.analytics_enabled, settings.anonymous_id, settings.release_channel])
 }

src/hooks/useUpdater.test.ts

@@ -25,11 +25,6 @@ vi.mock('@tauri-apps/plugin-process', () => ({
   relaunch: (...args: unknown[]) => mockRelaunch(...args),
 }))
 
-const mockGetVersion = vi.fn().mockResolvedValue('0.20260101.1')
-vi.mock('@tauri-apps/api/app', () => ({
-  getVersion: () => mockGetVersion(),
-}))
-
 import { isTauri } from '../mock-tauri'
 
 describe('useUpdater', () => {
@@ -205,42 +200,6 @@ describe('useUpdater', () => {
     expect(mockDownload).toHaveBeenCalled()
   })
 
-  describe('canary channel', () => {
-    it('fetches latest-canary.json when channel is canary', async () => {
-      vi.mocked(isTauri).mockReturnValue(true)
-      mockGetVersion.mockResolvedValue('0.20260101.1')
-
-      const mockFetch = vi.mocked(globalThis.fetch)
-      mockFetch.mockResolvedValueOnce(new Response(JSON.stringify({
-        version: '0.20260325.99-canary',
-        notes: 'Canary build',
-        platforms: {
-          'darwin-aarch64': {
-            url: 'https://github.com/refactoringhq/laputa-app/releases/download/v0.20260325.99-canary/laputa.app.tar.gz',
-            signature: 'sig123',
-          },
-        },
-      }), { status: 200 }))
-
-      const { result } = renderHook(() => useUpdater('canary'))
-
-      let checkResult: string | undefined
-      await act(async () => {
-        checkResult = await result.current.actions.checkForUpdates()
-      })
-
-      expect(checkResult).toBe('available')
-      expect(result.current.status).toEqual({
-        state: 'available',
-        version: '0.20260325.99-canary',
-        notes: 'Canary build',
-      })
-      expect(mockFetch).toHaveBeenCalledWith(
-        'https://refactoringhq.github.io/laputa-app/latest-canary.json'
-      )
-    })
-  })
-
   describe('checkForUpdates (manual)', () => {
     it('returns up-to-date when no update is available', async () => {
       vi.mocked(isTauri).mockReturnValue(true)

src/hooks/useUpdater.ts

@@ -3,7 +3,6 @@ import { isTauri } from '../mock-tauri'
 import { openExternalUrl } from '../utils/url'
 
 const RELEASE_NOTES_URL = 'https://refactoringhq.github.io/laputa-app/'
-const CANARY_ENDPOINT = 'https://refactoringhq.github.io/laputa-app/latest-canary.json'
 
 export type UpdateStatus =
   | { state: 'idle' }
@@ -21,45 +20,14 @@ export interface UpdateActions {
   dismiss: () => void
 }
 
-interface CanaryRelease {
-  version: string
-  notes: string
-  platforms: Record<string, { url: string; signature: string }>
-}
-
-async function checkCanaryUpdate(): Promise<{ version: string; notes: string; downloadUrl: string } | null> {
-  const response = await fetch(CANARY_ENDPOINT)
-  if (!response.ok) return null
-
-  const data = await response.json() as CanaryRelease
-  const { getVersion } = await import('@tauri-apps/api/app')
-  const currentVersion = await getVersion()
-
-  if (data.version === currentVersion) return null
-
-  const platform = data.platforms['darwin-aarch64']
-  const downloadUrl = platform?.url?.replace(/\.tar\.gz$/, '').replace(/\.app$/, '') ?? ''
-
-  return { version: data.version, notes: data.notes, downloadUrl }
-}
-
-export function useUpdater(channel: string | null = null): { status: UpdateStatus; actions: UpdateActions } {
+export function useUpdater(): { status: UpdateStatus; actions: UpdateActions } {
   const [status, setStatus] = useState<UpdateStatus>({ state: 'idle' })
   const updateRef = useRef<unknown>(null)
-  const canaryUrlRef = useRef<string | null>(null)
 
   const checkForUpdates = useCallback(async (): Promise<UpdateCheckResult> => {
     if (!isTauri()) return 'up-to-date'
 
     try {
-      if (channel === 'canary') {
-        const canary = await checkCanaryUpdate()
-        if (!canary) return 'up-to-date'
-        canaryUrlRef.current = canary.downloadUrl
-        setStatus({ state: 'available', version: canary.version, notes: canary.notes })
-        return 'available'
-      }
-
       const { check } = await import('@tauri-apps/plugin-updater')
       const update = await check()
       if (!update) return 'up-to-date'
@@ -75,7 +43,7 @@ export function useUpdater(channel: string | null = null): { status: UpdateStatu
       console.warn('[updater] Failed to check for updates')
       return 'error'
     }
-  }, [channel])
+  }, [])
 
   useEffect(() => {
     if (!isTauri()) return
@@ -84,12 +52,6 @@ export function useUpdater(channel: string | null = null): { status: UpdateStatu
   }, [checkForUpdates])
 
   const startDownload = useCallback(async () => {
-    // Canary: open the GitHub release page for manual download
-    if (canaryUrlRef.current) {
-      openExternalUrl(canaryUrlRef.current)
-      return
-    }
-
     const update = updateRef.current as {
       version: string
       downloadAndInstall: (cb: (event: { event: string; data?: { contentLength?: number; chunkLength?: number } }) => void) => Promise<void>

src/hooks/useVaultSwitcher.test.ts

@@ -353,6 +353,28 @@ describe('useVaultSwitcher', () => {
     })
   })
 
+  describe('default vault path', () => {
+    it('does not contain CI runner paths', () => {
+      // Regression: production builds must never bake in the CI runner's absolute path
+      expect(DEFAULT_VAULTS[0].path).not.toContain('/Users/runner/')
+      expect(DEFAULT_VAULTS[0].path).not.toContain('/home/runner/')
+    })
+
+    it('keeps persisted active vault when one exists', async () => {
+      const persistedPath = '/Users/luca/MyVault'
+      mockVaultListStore = {
+        vaults: [{ label: 'My Vault', path: persistedPath }],
+        active_vault: persistedPath,
+        hidden_defaults: [],
+      }
+
+      const { result } = renderHook(() => useVaultSwitcher({ onSwitch, onToast }))
+      await waitFor(() => { expect(result.current.loaded).toBe(true) })
+
+      expect(result.current.vaultPath).toBe(persistedPath)
+    })
+  })
+
   describe('isGettingStartedHidden', () => {
     it('is false by default', async () => {
       const { result } = renderHook(() => useVaultSwitcher({ onSwitch, onToast }))

src/hooks/useVaultSwitcher.ts

@@ -4,15 +4,20 @@ import { isTauri, mockInvoke } from '../mock-tauri'
 import { pickFolder } from '../utils/vault-dialog'
 import { loadVaultList, saveVaultList } from '../utils/vaultListStore'
 import type { VaultOption } from '../components/StatusBar'
+import { trackEvent } from '../lib/telemetry'
 
 export type { PersistedVaultList } from '../utils/vaultListStore'
 
 export const GETTING_STARTED_LABEL = 'Getting Started'
 
-declare const __DEMO_VAULT_PATH__: string
+declare const __DEMO_VAULT_PATH__: string | undefined
+
+/** Build-time demo vault path (dev only). In production Tauri builds this is
+ *  undefined and the real path is resolved at runtime via get_default_vault_path. */
+const STATIC_DEFAULT_PATH = typeof __DEMO_VAULT_PATH__ !== 'undefined' ? __DEMO_VAULT_PATH__ : ''
 
 export const DEFAULT_VAULTS: VaultOption[] = [
-  { label: GETTING_STARTED_LABEL, path: typeof __DEMO_VAULT_PATH__ !== 'undefined' ? __DEMO_VAULT_PATH__ : '/Users/luca/Workspace/laputa-app/demo-vault-v2' },
+  { label: GETTING_STARTED_LABEL, path: STATIC_DEFAULT_PATH },
 ]
 
 interface UseVaultSwitcherOptions {
@@ -31,14 +36,20 @@ function tauriCall<T>(command: string, args: Record<string, unknown>): Promise<T
 /** Manages vault path, extra vaults, switching, cloning, and local folder opening.
  *  Vault list and active vault are persisted via Tauri backend to survive app updates. */
 export function useVaultSwitcher({ onSwitch, onToast }: UseVaultSwitcherOptions) {
-  const [vaultPath, setVaultPath] = useState(DEFAULT_VAULTS[0].path)
+  const [vaultPath, setVaultPath] = useState(STATIC_DEFAULT_PATH)
   const [extraVaults, setExtraVaults] = useState<VaultOption[]>([])
   const [hiddenDefaults, setHiddenDefaults] = useState<string[]>([])
   const [loaded, setLoaded] = useState(false)
+  const [defaultPath, setDefaultPath] = useState(STATIC_DEFAULT_PATH)
+
+  const defaultVaults: VaultOption[] = useMemo(
+    () => [{ label: GETTING_STARTED_LABEL, path: defaultPath }],
+    [defaultPath],
+  )
 
   const visibleDefaults = useMemo(
-    () => DEFAULT_VAULTS.filter(v => !hiddenDefaults.includes(v.path)),
-    [hiddenDefaults],
+    () => defaultVaults.filter(v => !hiddenDefaults.includes(v.path)),
+    [defaultVaults, hiddenDefaults],
   )
   const allVaults = useMemo(
     () => [...visibleDefaults, ...extraVaults],
@@ -46,8 +57,8 @@ export function useVaultSwitcher({ onSwitch, onToast }: UseVaultSwitcherOptions)
   )
 
   const isGettingStartedHidden = useMemo(
-    () => hiddenDefaults.includes(DEFAULT_VAULTS[0].path),
-    [hiddenDefaults],
+    () => hiddenDefaults.includes(defaultPath),
+    [hiddenDefaults, defaultPath],
   )
 
   const onSwitchRef = useRef(onSwitch)
@@ -59,13 +70,26 @@ export function useVaultSwitcher({ onSwitch, onToast }: UseVaultSwitcherOptions)
   useEffect(() => {
     let cancelled = false
     loadVaultList()
-      .then(({ vaults, activeVault, hiddenDefaults: hidden }) => {
+      .then(async ({ vaults, activeVault, hiddenDefaults: hidden }) => {
         if (cancelled) return
         setExtraVaults(vaults)
         setHiddenDefaults(hidden)
         if (activeVault) {
           setVaultPath(activeVault)
           onSwitchRef.current()
+        } else if (!STATIC_DEFAULT_PATH) {
+          // Production build: resolve the Getting Started path at runtime
+          try {
+            const runtimePath = await tauriCall<string>('get_default_vault_path', {})
+            if (!cancelled && runtimePath) {
+              setDefaultPath(runtimePath)
+              setVaultPath(runtimePath)
+              // Keep the module-level export in sync for external consumers
+              DEFAULT_VAULTS[0] = { label: GETTING_STARTED_LABEL, path: runtimePath }
+            }
+          } catch {
+            // In mock/test mode, command may not exist
+          }
         }
       })
       .catch(err => console.warn('Failed to load vault list:', err))
@@ -91,6 +115,7 @@ export function useVaultSwitcher({ onSwitch, onToast }: UseVaultSwitcherOptions)
   }, [])
 
   const switchVault = useCallback((path: string) => {
+    trackEvent('vault_switched')
     setVaultPath(path)
     onSwitchRef.current()
   }, [])
@@ -114,7 +139,7 @@ export function useVaultSwitcher({ onSwitch, onToast }: UseVaultSwitcherOptions)
   }, [addAndSwitch])
 
   const removeVault = useCallback((path: string) => {
-    const isDefault = DEFAULT_VAULTS.some(v => v.path === path)
+    const isDefault = defaultVaults.some(v => v.path === path)
     if (isDefault) {
       setHiddenDefaults(prev => prev.includes(path) ? prev : [...prev, path])
     } else {
@@ -125,7 +150,7 @@ export function useVaultSwitcher({ onSwitch, onToast }: UseVaultSwitcherOptions)
     setVaultPath(currentPath => {
       if (currentPath !== path) return currentPath
       const remaining = [
-        ...DEFAULT_VAULTS.filter(v => v.path !== path && !(isDefault ? [] : hiddenDefaults).includes(v.path)),
+        ...defaultVaults.filter(v => v.path !== path && !(isDefault ? [] : hiddenDefaults).includes(v.path)),
         ...extraVaults.filter(v => v.path !== path),
       ]
       if (remaining.length > 0) {
@@ -135,26 +160,26 @@ export function useVaultSwitcher({ onSwitch, onToast }: UseVaultSwitcherOptions)
       return currentPath
     })
 
-    const vault = [...DEFAULT_VAULTS, ...extraVaults].find(v => v.path === path)
+    const vault = [...defaultVaults, ...extraVaults].find(v => v.path === path)
     onToastRef.current(`Vault "${vault?.label ?? labelFromPath(path)}" removed from list`)
-  }, [extraVaults, hiddenDefaults])
+  }, [defaultVaults, extraVaults, hiddenDefaults])
 
   const restoreGettingStarted = useCallback(async () => {
-    const defaultPath = DEFAULT_VAULTS[0].path
+    const gsPath = defaultPath
     // Un-hide the Getting Started vault
-    setHiddenDefaults(prev => prev.filter(p => p !== defaultPath))
+    setHiddenDefaults(prev => prev.filter(p => p !== gsPath))
     // Try to create the vault if it doesn't exist on disk
     try {
-      const exists = await tauriCall<boolean>('check_vault_exists', { path: defaultPath })
+      const exists = await tauriCall<boolean>('check_vault_exists', { path: gsPath })
       if (!exists) {
-        await tauriCall<string>('create_getting_started_vault', { targetPath: defaultPath })
+        await tauriCall<string>('create_getting_started_vault', { targetPath: gsPath })
       }
     } catch {
       // In mock/test mode, creation may fail — that's fine
     }
-    switchVault(defaultPath)
+    switchVault(gsPath)
     onToastRef.current('Getting Started vault restored')
-  }, [switchVault])
+  }, [defaultPath, switchVault])
 
   return {
     vaultPath, allVaults, switchVault, handleVaultCloned, handleOpenLocalFolder, loaded,