Fixed(cli):

- `ls` and `mirror` commands now provide informative feedback when no documents are found or filters skip all files, resolving the issue where they would exit silently (#860).
- The command-line argument `vault` has been renamed to a more appropriate name, `databaseDir`.
- The `mirror` command now accepts a `vault` directory, which specifies the location where the actual files are stored. For compatibility reasons, the previous behaviour is still supported.

Co-authored-by: Copilot <copilot@github.com>

src/apps/cli/commands/utils.unit.spec.ts

@@ -1,29 +1,33 @@
 import * as path from "path";
 import { describe, expect, it } from "vitest";
-import { toVaultRelativePath } from "./utils";
+import { toDatabaseRelativePath } from "./utils";
 
-describe("toVaultRelativePath", () => {
-    const vaultPath = path.resolve("/tmp/livesync-vault");
+describe("toDatabaseRelativePath", () => {
+    const databasePath = path.resolve("/tmp/livesync-vault");
 
     it("rejects absolute paths outside vault", () => {
-        expect(() => toVaultRelativePath("/etc/passwd", vaultPath)).toThrow("outside of the local database directory");
+        expect(() => toDatabaseRelativePath("/etc/passwd", databasePath)).toThrow(
+            "outside of the local database directory"
+        );
     });
 
     it("normalizes leading slash for absolute path inside vault", () => {
-        const absoluteInsideVault = path.join(vaultPath, "notes", "foo.md");
-        expect(toVaultRelativePath(absoluteInsideVault, vaultPath)).toBe("notes/foo.md");
+        const absoluteInsideVault = path.join(databasePath, "notes", "foo.md");
+        expect(toDatabaseRelativePath(absoluteInsideVault, databasePath)).toBe("notes/foo.md");
     });
 
     it("normalizes Windows-style separators", () => {
-        expect(toVaultRelativePath("notes\\daily\\2026-03-12.md", vaultPath)).toBe("notes/daily/2026-03-12.md");
+        expect(toDatabaseRelativePath("notes\\daily\\2026-03-12.md", databasePath)).toBe("notes/daily/2026-03-12.md");
     });
 
     it("returns vault-relative path for another absolute path inside vault", () => {
-        const absoluteInsideVault = path.join(vaultPath, "docs", "inside.md");
-        expect(toVaultRelativePath(absoluteInsideVault, vaultPath)).toBe("docs/inside.md");
+        const absoluteInsideVault = path.join(databasePath, "docs", "inside.md");
+        expect(toDatabaseRelativePath(absoluteInsideVault, databasePath)).toBe("docs/inside.md");
     });
 
     it("rejects relative path traversal that escapes vault", () => {
-        expect(() => toVaultRelativePath("../escape.md", vaultPath)).toThrow("outside of the local database directory");
+        expect(() => toDatabaseRelativePath("../escape.md", databasePath)).toThrow(
+            "outside of the local database directory"
+        );
     });
 });