feat(vscode): add "Mount Note" and fix tree-view for file entries

Split mounting into two commands — "Mount Folder" (directory-only) and
"Mount Note" (file search via `listFiles`) — for a cleaner Quick Pick
UX.  Fix `#getRootChildren` to use `tracker.stat()` instead of
hardcoding all root entries as directories, with fallback to directory
on stat failure.  Filter file entries from workspace folder creation
since VSCode requires directory URIs.

Bump version to 0.1.4.

Assisted-by: Claude

Author: otaviof

packages/vscode/README.md

@@ -9,7 +9,7 @@ Browse, search, and edit your [Obsidian](https://obsidian.md) vault directly in
 
 ## Features
 
-- **Mount vault folders** into the Explorer tree view
+- **Mount vault folders or individual notes** into the Explorer tree view
 - **Browse and read** Markdown files through the `obs://` virtual file system
 - **Edit existing files** with writes going directly to the vault on disk
 - **Wikilink navigation**, click `[[links]]` in Markdown to jump between notes (resolves to `file://` paths for seamless navigation in workspace folders)
@@ -28,7 +28,8 @@ Available via the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`):
 | Command | Description |
 |---------|-------------|
 | `Obsidian VFS: Mount Folder` | Pick a top-level vault folder and add it to the Explorer tree view |
-| `Obsidian VFS: Unmount Folder` | Remove a mounted vault folder from the tree view |
+| `Obsidian VFS: Mount Note` | Search vault notes and add one to the Explorer tree view |
+| `Obsidian VFS: Unmount Entry` | Remove a mounted vault entry from the tree view |
 | `Obsidian VFS: Open in Obsidian` | Open the active vault file in the Obsidian app (works from both `obs://` and `file://` documents) |
 | `Obsidian VFS: Search Notes` | Quick Pick search across all vault Markdown files |
 | `Obsidian VFS: Copy Path` | Copy the active file's `obs://` URI to the clipboard (`Shift+Alt+Cmd+C` on `obs://` files) |
@@ -42,7 +43,7 @@ Configure via **Settings UI** or `settings.json`:
 | `obsidianVFS.cliPath` | `string` | `"obsidian"` | Path to the Obsidian CLI binary |
 | `obsidianVFS.timeoutMs` | `number` | `10000` | CLI operation timeout in milliseconds |
 | `obsidianVFS.treeViewTitle` | `string` | `""` | Custom title for the Explorer tree view (defaults to `obs://<vault>`) |
-| `obsidianVFS.autoMount` | `string[]` | `[]` | Vault-relative folders to display in the Explorer tree view on activation |
+| `obsidianVFS.autoMount` | `string[]` | `[]` | Vault-relative paths (folders or notes) to display in the Explorer tree view on activation |
 | `obsidianVFS.explorer` | `boolean` | `true` | Show the Obsidian VFS tree view in the Explorer sidebar |
 | `obsidianVFS.statusBar` | `boolean` | `true` | Show vault name and mode in the status bar |
 | `obsidianVFS.workspace` | `boolean` | `true` | Add the vault as a workspace folder for Explorer browsing (see below) |

packages/vscode/package.json

@@ -2,7 +2,7 @@
   "name": "obsidian-vfs",
   "displayName": "Obsidian VFS",
   "description": "Browse, search, and edit your Obsidian vault directly in VSCode via a virtual file system (obs://)",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "private": true,
   "publisher": "otaviof",
   "engines": {
@@ -36,9 +36,13 @@
         "command": "obsidianVFS.mount",
         "title": "Obsidian VFS: Mount Folder"
       },
+      {
+        "command": "obsidianVFS.mountNote",
+        "title": "Obsidian VFS: Mount Note"
+      },
       {
         "command": "obsidianVFS.unmount",
-        "title": "Obsidian VFS: Unmount Folder"
+        "title": "Obsidian VFS: Unmount Entry"
       },
       {
         "command": "obsidianVFS.openInObsidian",
@@ -72,7 +76,7 @@
     "viewsWelcome": [
       {
         "view": "obsidianVFS",
-        "contents": "No vault folders mounted.\n[Mount Folder](command:obsidianVFS.mount)"
+        "contents": "No vault entries mounted.\n[Mount Folder](command:obsidianVFS.mount)\n[Mount Note](command:obsidianVFS.mountNote)"
       }
     ],
     "menus": {
@@ -108,7 +112,7 @@
             "type": "string"
           },
           "default": [],
-          "description": "Vault-relative folders to display in the Explorer tree view and workspace folders"
+          "description": "Vault-relative paths (folders or files) to display in the Explorer tree view and workspace folders"
         },
         "obsidianVFS.explorer": {
           "type": "boolean",

packages/vscode/src/commands.test.ts

@@ -47,18 +47,22 @@ describe("registerCommands", () => {
     vi.clearAllMocks();
   });
 
-  it("registers five commands", () => {
+  it("registers six commands", () => {
     const ctx = fakeContext();
     const tracker = mockTracker();
     const tree = fakeTreeProvider();
     const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
     registerCommands(ctx as never, tracker, tree as never, channel);
 
-    expect(vscode.commands.registerCommand).toHaveBeenCalledTimes(5);
+    expect(vscode.commands.registerCommand).toHaveBeenCalledTimes(6);
     expect(vscode.commands.registerCommand).toHaveBeenCalledWith(
       "obsidianVFS.mount",
       expect.any(Function),
     );
+    expect(vscode.commands.registerCommand).toHaveBeenCalledWith(
+      "obsidianVFS.mountNote",
+      expect.any(Function),
+    );
     expect(vscode.commands.registerCommand).toHaveBeenCalledWith(
       "obsidianVFS.unmount",
       expect.any(Function),
@@ -277,6 +281,173 @@ describe("mount command", () => {
   });
 });
 
+describe("mountNote command", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("shows Quick Pick with vault notes and updates config", async () => {
+    mockReadAutoMount.mockReturnValue([]);
+    const { update } = setupConfigMock();
+
+    const tracker = mockTracker({
+      listFiles: vi.fn().mockResolvedValue({
+        ok: true,
+        value: ["docs/overview.md", "notes/todo.md"],
+      }),
+    });
+
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    vi.mocked(vscode.window.showQuickPick).mockResolvedValueOnce({
+      label: "overview",
+      description: "docs/overview.md",
+    });
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.mountNote")![1] as () => Promise<void>;
+    await handler();
+
+    expect(vscode.window.showQuickPick).toHaveBeenCalledWith(
+      [
+        { label: "overview", description: "docs/overview.md" },
+        { label: "todo", description: "notes/todo.md" },
+      ],
+      expect.objectContaining({ matchOnDescription: true }),
+    );
+    expect(update).toHaveBeenCalledWith(
+      "autoMount",
+      ["docs/overview.md"],
+      vscode.ConfigurationTarget.Workspace,
+    );
+    expect(tree.refresh).toHaveBeenCalled();
+  });
+
+  it("excludes already-mounted notes from Quick Pick", async () => {
+    mockReadAutoMount.mockReturnValue(["docs/overview.md"]);
+    setupConfigMock();
+
+    const tracker = mockTracker({
+      listFiles: vi.fn().mockResolvedValue({
+        ok: true,
+        value: ["docs/overview.md", "notes/todo.md"],
+      }),
+    });
+
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    vi.mocked(vscode.window.showQuickPick).mockResolvedValueOnce({
+      label: "todo",
+      description: "notes/todo.md",
+    });
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.mountNote")![1] as () => Promise<void>;
+    await handler();
+
+    expect(vscode.window.showQuickPick).toHaveBeenCalledWith(
+      [{ label: "todo", description: "notes/todo.md" }],
+      expect.objectContaining({ matchOnDescription: true }),
+    );
+  });
+
+  it("does nothing when user cancels Quick Pick", async () => {
+    mockReadAutoMount.mockReturnValue([]);
+    const { update } = setupConfigMock();
+
+    const tracker = mockTracker({
+      listFiles: vi.fn().mockResolvedValue({
+        ok: true,
+        value: ["notes/todo.md"],
+      }),
+    });
+
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    vi.mocked(vscode.window.showQuickPick).mockResolvedValueOnce(undefined);
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.mountNote")![1] as () => Promise<void>;
+    await handler();
+
+    expect(update).not.toHaveBeenCalled();
+  });
+
+  it("does nothing when listFiles returns empty", async () => {
+    const tracker = mockTracker({
+      listFiles: vi.fn().mockResolvedValue({ ok: true, value: [] }),
+    });
+
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.mountNote")![1] as () => Promise<void>;
+    await handler();
+
+    expect(vscode.window.showQuickPick).not.toHaveBeenCalled();
+  });
+
+  it("does nothing when all notes already mounted", async () => {
+    mockReadAutoMount.mockReturnValue(["docs/overview.md", "notes/todo.md"]);
+
+    const tracker = mockTracker({
+      listFiles: vi.fn().mockResolvedValue({
+        ok: true,
+        value: ["docs/overview.md", "notes/todo.md"],
+      }),
+    });
+
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.mountNote")![1] as () => Promise<void>;
+    await handler();
+
+    expect(vscode.window.showQuickPick).not.toHaveBeenCalled();
+  });
+
+  it("does nothing when listFiles returns error", async () => {
+    const tracker = mockTracker({
+      listFiles: vi.fn().mockResolvedValue({
+        ok: false,
+        error: { code: "CLI_ERROR", message: "failed" },
+      }),
+    });
+
+    const ctx = fakeContext();
+    const tree = fakeTreeProvider();
+    const channel = { appendLine: vi.fn(), dispose: vi.fn() } as never;
+    registerCommands(ctx as never, tracker, tree as never, channel);
+
+    const handler = vi
+      .mocked(vscode.commands.registerCommand)
+      .mock.calls.find((c) => c[0] === "obsidianVFS.mountNote")![1] as () => Promise<void>;
+    await handler();
+
+    expect(vscode.window.showQuickPick).not.toHaveBeenCalled();
+  });
+});
+
 describe("unmount command", () => {
   beforeEach(() => {
     vi.clearAllMocks();
@@ -322,7 +493,7 @@ describe("unmount command", () => {
     await unmountHandler();
 
     expect(vscode.window.showInformationMessage).toHaveBeenCalledWith(
-      "No Obsidian VFS folders mounted",
+      "No Obsidian VFS entries mounted",
     );
   });
 

packages/vscode/src/commands.ts

@@ -34,16 +34,48 @@ async function mountCommand(
   treeProvider.refresh();
 }
 
-/** Remove a folder from `obsidianVFS.autoMount` and refresh the tree. */
+/** Add a single note to `obsidianVFS.autoMount` and refresh the tree. */
+async function mountNoteCommand(
+  tracker: LocalIndexTracker,
+  treeProvider: VaultTreeDataProvider,
+): Promise<void> {
+  const result = await tracker.listFiles();
+  if (!result.ok || result.value.length === 0) return;
+
+  const mounted = new Set(readAutoMount());
+  const available = result.value.filter((f) => !mounted.has(f));
+  if (available.length === 0) return;
+
+  const items = available.map((filePath) => ({
+    // Safe: split("/") always returns at least one element
+    label: filePath.replace(/\.md$/i, "").split("/").pop()!,
+    description: filePath,
+  }));
+
+  const picked = await vscode.window.showQuickPick(items, {
+    placeHolder: "Select a vault note to mount",
+    matchOnDescription: true,
+  });
+  if (!picked?.description) return;
+
+  const updated = [...mounted, picked.description];
+  await vscode.workspace
+    .getConfiguration("obsidianVFS")
+    .update("autoMount", updated, vscode.ConfigurationTarget.Workspace);
+
+  treeProvider.refresh();
+}
+
+/** Remove an entry from `obsidianVFS.autoMount` and refresh the tree. */
 async function unmountCommand(treeProvider: VaultTreeDataProvider): Promise<void> {
   const mounted = readAutoMount();
   if (mounted.length === 0) {
-    await vscode.window.showInformationMessage("No Obsidian VFS folders mounted");
+    await vscode.window.showInformationMessage("No Obsidian VFS entries mounted");
     return;
   }
 
   const picked = await vscode.window.showQuickPick(mounted, {
-    placeHolder: "Select a folder to unmount",
+    placeHolder: "Select an entry to unmount",
   });
   if (!picked) return;
 
@@ -128,6 +160,9 @@ export function registerCommands(
 ): void {
   context.subscriptions.push(
     vscode.commands.registerCommand("obsidianVFS.mount", () => mountCommand(tracker, treeProvider)),
+    vscode.commands.registerCommand("obsidianVFS.mountNote", () =>
+      mountNoteCommand(tracker, treeProvider),
+    ),
     vscode.commands.registerCommand("obsidianVFS.unmount", () => unmountCommand(treeProvider)),
     vscode.commands.registerCommand("obsidianVFS.openInObsidian", () =>
       openInObsidianCommand(tracker, outputChannel),