@lifestreamdynamics/vault-cli 1.0.0 → 1.1.0

package/dist/commands/sync.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { formatUptime } from '../utils/format.js';
@@ -30,7 +30,7 @@ export function registerSyncCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Initializing sync...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vault = await client.vaults.get(vaultId);
             const absPath = path.resolve(localPath);
             const mode = _opts.mode ?? 'sync';
@@ -144,7 +144,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
             const lastState = loadSyncState(config.id);
             out.startSpinner('Scanning local files...');
@@ -220,7 +220,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
             const lastState = loadSyncState(config.id);
             out.startSpinner('Scanning local files...');
@@ -296,7 +296,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
             const lastState = loadSyncState(config.id);
             out.startSpinner('Scanning...');
@@ -373,7 +373,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
             const pollInterval = parseInt(String(_opts.pollInterval ?? '30000'), 10);
             out.status(`Watching sync ${chalk.cyan(syncId.slice(0, 8))}...`);
@@ -447,7 +447,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const localFile = path.join(config.localPath, docPath);
             const state = loadSyncState(config.id);
             if (useVersion === 'local') {
@@ -501,8 +501,11 @@ export function registerSyncCommands(program) {
         const out = createOutput(flags);
         try {
             const logFile = _opts.logFile;
-            const pid = startDaemon(logFile);
+            const { pid, lingerWarning } = startDaemon(logFile);
             out.success('Daemon started', { pid, status: 'running' });
+            if (lingerWarning) {
+                out.warn(`Warning: ${lingerWarning}`);
+            }
         }
         catch (err) {
             handleError(out, err, 'Failed to start daemon');

package/dist/commands/teams.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerTeamCommands(program) {
@@ -12,7 +12,7 @@ export function registerTeamCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching teams...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const teamList = await client.teams.list();
             out.stopSpinner();
             out.list(teamList.map(t => ({ name: t.name, id: t.id, description: t.description || 'No description' })), {
@@ -37,7 +37,7 @@ export function registerTeamCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const team = await client.teams.get(teamId);
             out.stopSpinner();
             out.record({
@@ -66,7 +66,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const team = await client.teams.create({ name, description: _opts.description });
             out.success(`Team created: ${chalk.cyan(team.name)} (${team.id})`, { id: team.id, name: team.name });
         }
@@ -84,7 +84,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Updating team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const team = await client.teams.update(teamId, {
                 name: _opts.name,
                 description: _opts.description,
@@ -103,7 +103,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Deleting team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.teams.delete(teamId);
             out.success('Team deleted.', { id: teamId, deleted: true });
         }
@@ -121,7 +121,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching members...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const memberList = await client.teams.listMembers(teamId);
             out.stopSpinner();
             out.list(memberList.map(m => ({
@@ -154,7 +154,7 @@ EXAMPLES
         const role = String(_opts.role);
         out.startSpinner('Updating member role...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const member = await client.teams.updateMemberRole(teamId, userId, role);
             out.success(`Role updated to ${chalk.magenta(member.role)} for ${member.user.email}`, {
                 userId,
@@ -175,7 +175,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Removing member...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.teams.removeMember(teamId, userId);
             out.success('Member removed.', { teamId, userId, removed: true });
         }
@@ -191,7 +191,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Leaving team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.teams.leave(teamId);
             out.success('Left the team.', { teamId, left: true });
         }
@@ -209,7 +209,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching invitations...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const invitationList = await client.teams.listInvitations(teamId);
             out.stopSpinner();
             out.list(invitationList.map(inv => ({
@@ -242,7 +242,7 @@ EXAMPLES
         const role = String(_opts.role);
         out.startSpinner('Sending invitation...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const invitation = await client.teams.inviteMember(teamId, email, role);
             out.success(`Invited ${chalk.cyan(invitation.email)} as ${chalk.magenta(invitation.role)}`, {
                 id: invitation.id,
@@ -263,7 +263,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Revoking invitation...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.teams.revokeInvitation(teamId, invitationId);
             out.success('Invitation revoked.', { id: invitationId, revoked: true });
         }
@@ -281,7 +281,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching team vaults...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vaultList = await client.teams.listVaults(teamId);
             out.stopSpinner();
             out.list(vaultList.map(v => ({ name: String(v.name), slug: String(v.slug), description: String(v.description) || 'No description' })), {
@@ -308,7 +308,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating team vault...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vault = await client.teams.createVault(teamId, { name, description: _opts.description });
             out.success(`Team vault created: ${chalk.cyan(String(vault.name))}`, {
                 name: String(vault.name),

package/dist/commands/user.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { formatBytes } from '../utils/format.js';
@@ -12,7 +12,7 @@ export function registerUserCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching storage usage...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const storage = await client.user.getStorage();
             out.stopSpinner();
             if (flags.output === 'json') {

package/dist/commands/vaults.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { generateVaultKey } from '@lifestreamdynamics/vault-sdk';
@@ -13,7 +13,7 @@ export function registerVaultCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching vaults...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vaultList = await client.vaults.list();
             out.stopSpinner();
             out.list(vaultList.map(v => ({ name: v.name, slug: v.slug, encrypted: v.encryptionEnabled ? 'yes' : 'no', description: v.description || 'No description', id: v.id })), {
@@ -43,7 +43,7 @@ export function registerVaultCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching vault...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vault = await client.vaults.get(vaultId);
             out.stopSpinner();
             out.record({
@@ -75,7 +75,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating vault...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const isEncrypted = _opts.encrypted === true;
             const vault = await client.vaults.create({
                 name,

package/dist/commands/versions.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerVersionCommands(program) {
@@ -16,7 +16,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching versions...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const versionList = await client.documents.listVersions(vaultId, docPath);
             out.stopSpinner();
             out.list(versionList.map(v => ({
@@ -65,7 +65,7 @@ EXAMPLES
             return;
         }
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const version = await client.documents.getVersion(vaultId, docPath, versionNum);
             if (version.content === null) {
                 out.error('Version content is no longer available (expired or pruned)');
@@ -99,7 +99,7 @@ EXAMPLES
         }
         out.startSpinner('Computing diff...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const diff = await client.documents.diffVersions(vaultId, docPath, from, to);
             out.stopSpinner();
             if (flags.output === 'json') {
@@ -143,7 +143,7 @@ EXAMPLES
         }
         out.startSpinner(`Restoring to version ${versionNum}...`);
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const doc = await client.documents.restoreVersion(vaultId, docPath, versionNum);
             out.success(`Restored ${chalk.cyan(docPath)} to version ${versionNum}`, {
                 path: doc.path,
@@ -173,7 +173,7 @@ EXAMPLES
         }
         out.startSpinner(`Pinning version ${versionNum}...`);
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.documents.pinVersion(vaultId, docPath, versionNum);
             out.success(`Pinned version ${versionNum} of ${chalk.cyan(docPath)}`, {
                 path: docPath,
@@ -204,7 +204,7 @@ EXAMPLES
         }
         out.startSpinner(`Unpinning version ${versionNum}...`);
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.documents.unpinVersion(vaultId, docPath, versionNum);
             out.success(`Unpinned version ${versionNum} of ${chalk.cyan(docPath)}`, {
                 path: docPath,

package/dist/commands/webhooks.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerWebhookCommands(program) {
@@ -12,7 +12,7 @@ export function registerWebhookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching webhooks...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const webhookList = await client.webhooks.list(vaultId);
             out.stopSpinner();
             out.list(webhookList.map(wh => ({
@@ -50,7 +50,7 @@ export function registerWebhookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Creating webhook...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {
                 url,
                 events: String(_opts.events || 'create,update,delete').split(',').map((e) => e.trim()),
@@ -95,7 +95,7 @@ export function registerWebhookCommands(program) {
         }
         out.startSpinner('Updating webhook...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {};
             if (_opts.url)
                 params.url = String(_opts.url);
@@ -125,7 +125,7 @@ export function registerWebhookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Deleting webhook...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.webhooks.delete(vaultId, webhookId);
             out.success('Webhook deleted successfully', { id: webhookId, deleted: true });
         }
@@ -142,7 +142,7 @@ export function registerWebhookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching deliveries...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const deliveries = await client.webhooks.listDeliveries(vaultId, webhookId);
             out.stopSpinner();
             out.list(deliveries.map(d => ({

package/dist/config.d.ts

@@ -1,4 +1,5 @@
 import { type CredentialManager } from './lib/credential-manager.js';
+export declare const DEFAULT_API_URL = "https://vault.lifestreamdynamics.com";
 export interface CliConfig {
     apiUrl: string;
     apiKey?: string;

package/dist/config.js

@@ -4,6 +4,7 @@ import os from 'node:os';
 import { createCredentialManager } from './lib/credential-manager.js';
 const CONFIG_DIR = path.join(os.homedir(), '.lsvault');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+export const DEFAULT_API_URL = 'https://vault.lifestreamdynamics.com';
 // Singleton credential manager
 let _credentialManager;
 export function getCredentialManager() {
@@ -25,7 +26,7 @@ export function setCredentialManager(cm) {
  */
 export function loadConfig() {
     const config = {
-        apiUrl: process.env.LSVAULT_API_URL || 'http://localhost:4660',
+        apiUrl: process.env.LSVAULT_API_URL || DEFAULT_API_URL,
     };
     if (process.env.LSVAULT_API_KEY) {
         config.apiKey = process.env.LSVAULT_API_KEY;
@@ -48,7 +49,7 @@ export async function loadConfigAsync() {
     const cm = getCredentialManager();
     const secureCreds = await cm.getCredentials();
     const config = {
-        apiUrl: secureCreds.apiUrl || process.env.LSVAULT_API_URL || 'http://localhost:4660',
+        apiUrl: secureCreds.apiUrl || process.env.LSVAULT_API_URL || DEFAULT_API_URL,
     };
     // Load JWT tokens if available
     if (secureCreds.accessToken) {

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import { registerAuthCommands } from './commands/auth.js';
+import { registerMfaCommands } from './commands/mfa.js';
 import { registerVaultCommands } from './commands/vaults.js';
 import { registerDocCommands } from './commands/docs.js';
 import { registerSearchCommands } from './commands/search.js';
@@ -18,6 +19,8 @@ import { registerWebhookCommands } from './commands/webhooks.js';
 import { registerConfigCommands } from './commands/config.js';
 import { registerSyncCommands } from './commands/sync.js';
 import { registerVersionCommands } from './commands/versions.js';
+import { registerLinkCommands } from './commands/links.js';
+import { registerCalendarCommands } from './commands/calendar.js';
 const program = new Command();
 program
     .name('lsvault')
@@ -43,6 +46,7 @@ LEARN MORE
   lsvault <command> --help                   Show help for a command
   lsvault <command> <subcommand> --help      Show help for a subcommand`);
 registerAuthCommands(program);
+registerMfaCommands(program);
 registerVaultCommands(program);
 registerDocCommands(program);
 registerSearchCommands(program);
@@ -60,4 +64,6 @@ registerWebhookCommands(program);
 registerConfigCommands(program);
 registerSyncCommands(program);
 registerVersionCommands(program);
+registerLinkCommands(program);
+registerCalendarCommands(program);
 program.parse();

package/dist/lib/keychain.js

@@ -1,6 +1,8 @@
 const SERVICE_NAME = 'lifestream-vault-cli';
 const ACCOUNT_API_KEY = 'api-key';
 const ACCOUNT_API_URL = 'api-url';
+const ACCOUNT_ACCESS_TOKEN = 'access-token';
+const ACCOUNT_REFRESH_TOKEN = 'refresh-token';
 /**
  * Dynamically loads keytar. Returns null if unavailable (not installed or
  * native module fails to load, e.g. missing libsecret on Linux).
@@ -48,6 +50,12 @@ export function createKeychainBackend() {
                 const apiUrl = await kt.getPassword(SERVICE_NAME, ACCOUNT_API_URL);
                 if (apiUrl)
                     result.apiUrl = apiUrl;
+                const accessToken = await kt.getPassword(SERVICE_NAME, ACCOUNT_ACCESS_TOKEN);
+                if (accessToken)
+                    result.accessToken = accessToken;
+                const refreshToken = await kt.getPassword(SERVICE_NAME, ACCOUNT_REFRESH_TOKEN);
+                if (refreshToken)
+                    result.refreshToken = refreshToken;
             }
             catch {
                 // Keychain access failed silently
@@ -64,6 +72,12 @@ export function createKeychainBackend() {
             if (config.apiUrl) {
                 await kt.setPassword(SERVICE_NAME, ACCOUNT_API_URL, config.apiUrl);
             }
+            if (config.accessToken) {
+                await kt.setPassword(SERVICE_NAME, ACCOUNT_ACCESS_TOKEN, config.accessToken);
+            }
+            if (config.refreshToken) {
+                await kt.setPassword(SERVICE_NAME, ACCOUNT_REFRESH_TOKEN, config.refreshToken);
+            }
         },
         async clearCredentials() {
             const kt = await getKeytar();
@@ -77,6 +91,14 @@ export function createKeychainBackend() {
                 await kt.deletePassword(SERVICE_NAME, ACCOUNT_API_URL);
             }
             catch { /* ignore */ }
+            try {
+                await kt.deletePassword(SERVICE_NAME, ACCOUNT_ACCESS_TOKEN);
+            }
+            catch { /* ignore */ }
+            try {
+                await kt.deletePassword(SERVICE_NAME, ACCOUNT_REFRESH_TOKEN);
+            }
+            catch { /* ignore */ }
         },
     };
 }

package/dist/sync/daemon-worker.js

@@ -10,6 +10,8 @@ import { createRemotePoller } from './remote-poller.js';
 import { removePid } from './daemon.js';
 import { loadConfig } from '../config.js';
 import { LifestreamVaultClient } from '@lifestreamdynamics/vault-sdk';
+import { scanLocalFiles, scanRemoteFiles, computePushDiff, computePullDiff, executePush, executePull } from './engine.js';
+import { loadSyncState } from './state.js';
 const managed = [];
 function log(msg) {
     const ts = new Date().toISOString();
@@ -35,6 +37,66 @@ async function start() {
     }
     log(`Found ${configs.length} auto-sync configuration(s)`);
     const client = createClient();
+    // Startup reconciliation: catch changes made while daemon was stopped
+    for (const config of configs) {
+        try {
+            log(`Reconciling ${config.id.slice(0, 8)} (${config.mode} mode)...`);
+            const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
+            const lastState = loadSyncState(config.id);
+            const localFiles = scanLocalFiles(config.localPath, ignorePatterns);
+            const remoteFiles = await scanRemoteFiles(client, config.vaultId, ignorePatterns);
+            let pushed = 0;
+            let pulled = 0;
+            let deleted = 0;
+            if (config.mode === 'push' || config.mode === 'sync') {
+                const pushDiff = computePushDiff(localFiles, remoteFiles, lastState);
+                const pushOps = pushDiff.uploads.length + pushDiff.deletes.length;
+                if (pushOps > 0) {
+                    const result = await executePush(client, config, pushDiff);
+                    pushed = result.filesUploaded;
+                    deleted += result.filesDeleted;
+                    if (result.errors.length > 0) {
+                        for (const err of result.errors) {
+                            log(`  Push error: ${err.path}: ${err.error}`);
+                        }
+                    }
+                }
+            }
+            if (config.mode === 'pull' || config.mode === 'sync') {
+                const pullDiff = computePullDiff(localFiles, remoteFiles, lastState);
+                const pullOps = pullDiff.downloads.length + pullDiff.deletes.length;
+                if (pullOps > 0) {
+                    const result = await executePull(client, config, pullDiff);
+                    pulled = result.filesDownloaded;
+                    deleted += result.filesDeleted;
+                    if (result.errors.length > 0) {
+                        for (const err of result.errors) {
+                            log(`  Pull error: ${err.path}: ${err.error}`);
+                        }
+                    }
+                }
+            }
+            const total = pushed + pulled + deleted;
+            if (total > 0) {
+                const parts = [];
+                if (pushed > 0)
+                    parts.push(`${pushed} uploaded`);
+                if (pulled > 0)
+                    parts.push(`${pulled} downloaded`);
+                if (deleted > 0)
+                    parts.push(`${deleted} deleted`);
+                log(`Reconciled ${config.id.slice(0, 8)}: ${parts.join(', ')}`);
+            }
+            else {
+                log(`Reconciled ${config.id.slice(0, 8)}: up to date`);
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log(`Reconciliation failed for ${config.id.slice(0, 8)}: ${msg}`);
+            // Continue — still start the watcher even if reconciliation fails
+        }
+    }
     for (const config of configs) {
         try {
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);

package/dist/sync/daemon.d.ts

@@ -36,9 +36,17 @@ export declare function rotateLogIfNeeded(logFile?: string): void;
  * Start the daemon as a detached child process.
  * Returns the PID of the spawned process.
  */
-export declare function startDaemon(logFile?: string): number;
+export declare function startDaemon(logFile?: string): {
+    pid: number;
+    lingerWarning?: string;
+};
 /**
  * Stop the running daemon.
  */
 export declare function stopDaemon(): boolean;
+/**
+ * Check if systemd linger is enabled for the current user (Linux only).
+ * When linger is disabled, user services stop when the SSH session ends.
+ */
+export declare function checkLingerStatus(): 'enabled' | 'disabled' | 'unknown';
 export { DAEMON_DIR, PID_FILE, LOG_FILE };

package/dist/sync/daemon.js

@@ -150,7 +150,12 @@ export function startDaemon(logFile) {
     writePid(child.pid);
     child.unref();
     fs.closeSync(logFd);
-    return child.pid;
+    const result = { pid: child.pid };
+    const lingerStatus = checkLingerStatus();
+    if (lingerStatus === 'disabled') {
+        result.lingerWarning = 'systemd lingering is not enabled for your user. The daemon will stop when you log out. To fix:\n  sudo loginctl enable-linger $(whoami)';
+    }
+    return result;
 }
 /**
  * Stop the running daemon.
@@ -171,4 +176,20 @@ export function stopDaemon() {
         return false;
     }
 }
+/**
+ * Check if systemd linger is enabled for the current user (Linux only).
+ * When linger is disabled, user services stop when the SSH session ends.
+ */
+export function checkLingerStatus() {
+    if (process.platform !== 'linux')
+        return 'unknown';
+    try {
+        const username = os.userInfo().username;
+        const lingerFile = `/var/lib/systemd/linger/${username}`;
+        return fs.existsSync(lingerFile) ? 'enabled' : 'disabled';
+    }
+    catch {
+        return 'unknown';
+    }
+}
 export { DAEMON_DIR, PID_FILE, LOG_FILE };

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@lifestreamdynamics/vault-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Command-line interface for Lifestream Vault",
+  "engines": {
+    "node": ">=20"
+  },
   "type": "module",
   "bin": {
     "lsvault": "./dist/index.js"
@@ -41,7 +44,7 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@lifestreamdynamics/vault-sdk": "^1.0.0",
+    "@lifestreamdynamics/vault-sdk": "^1.1.0",
     "chalk": "^5.4.0",
     "chokidar": "^4.0.3",
     "commander": "^13.0.0",
@@ -53,10 +56,10 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@vitest/coverage-v8": "^2.0.0",
-    "@vitest/ui": "^2.0.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",
-    "vitest": "^2.0.0"
+    "vitest": "^4.0.18"
   }
 }