@sage-protocol/cli 0.8.0 → 0.8.2

package/dist/cli/commands/library.js

@@ -490,323 +490,331 @@ QUICK START
       }
     });
 
-  // ===== Personal Library Commands (Three-Tier Model) =====
+  // ===== Personal/Vault Library Commands (Three-Tier Model) =====
   // These use SIWE auth and the worker API at /git/personal/:libraryId/*
 
-  const personal = new Command('personal')
-    .description('Personal library management (wallet-owned, no on-chain governance)');
+  function buildPersonalCommands({ name, label }) {
+    const personal = new Command(name)
+      .description(`${label} library management (wallet-owned, no on-chain governance)`);
+
+    personal
+      .command('create')
+      .description(`Create a ${label.toLowerCase()} library`)
+      .requiredOption('-n, --name <name>', 'Library name')
+      .option('-d, --description <desc>', 'Library description')
+      .option('--id <libraryId>', 'Custom library ID (default: slugified name)')
+      .option('--json', 'Output JSON', false)
+      .action(async (opts) => {
+        try {
+          const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
+          const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
 
-  personal
-    .command('create')
-    .description('Create a personal library')
-    .requiredOption('-n, --name <name>', 'Library name')
-    .option('-d, --description <desc>', 'Library description')
-    .option('--id <libraryId>', 'Custom library ID (default: slugified name)')
-    .option('--json', 'Output JSON', false)
-    .action(async (opts) => {
-      try {
-        const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
-        const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
+          ui.info(`Creating ${label.toLowerCase()} library...`);
 
-        ui.info('Creating personal library...');
+          // Get SIWE auth
+          const { signer } = await getSignerSession();
+          const walletAddress = await signer.getAddress();
+          const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
 
-        // Get SIWE auth
-        const { signer } = await getSignerSession();
-        const walletAddress = await signer.getAddress();
-        const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
-
-        // Initialize library via worker API
-        const response = await fetch(`${baseUrl}/git/personal/libraries`, {
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json',
-            'X-Wallet-Address': walletAddress,
-            'X-Wallet-Signature': signature,
-            'X-Wallet-Nonce': nonce,
-            'X-Wallet-Message': Buffer.from(message).toString('base64'),
-          },
-          body: JSON.stringify({
-            name: opts.name,
-            description: opts.description || '',
-            visibility: 'public',
-          }),
-        });
+          // Initialize library via worker API
+          const response = await fetch(`${baseUrl}/git/personal/libraries`, {
+            method: 'POST',
+            headers: {
+              'Content-Type': 'application/json',
+              'X-Wallet-Address': walletAddress,
+              'X-Wallet-Signature': signature,
+              'X-Wallet-Nonce': nonce,
+              'X-Wallet-Message': Buffer.from(message).toString('base64'),
+            },
+            body: JSON.stringify({
+              name: opts.name,
+              description: opts.description || '',
+              visibility: 'public',
+            }),
+          });
 
-        if (!response.ok) {
-          const error = await response.json().catch(() => ({ error: response.statusText }));
-          throw new Error(error.error || `Failed to create library: ${response.status}`);
-        }
+          if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(error.error || `Failed to create library: ${response.status}`);
+          }
 
-        const result = await response.json();
-        const libraryId = result.libraryId;
+          const result = await response.json();
+          const libraryId = result.libraryId;
 
-        if (opts.json) {
-          ui.json({ ...result, owner: walletAddress });
-        } else {
-          ui.success(`Personal library created: ${libraryId}`);
-          ui.keyValue([
-            ['Library ID', libraryId],
-            ['Name', result.name || opts.name],
-            ['Owner', walletAddress],
-          ]);
-        }
+          if (opts.json) {
+            ui.json({ ...result, owner: walletAddress });
+          } else {
+            ui.success(`${label} library created: ${libraryId}`);
+            ui.keyValue([
+              ['Library ID', libraryId],
+              ['Name', result.name || opts.name],
+              ['Owner', walletAddress],
+            ]);
+          }
 
-      } catch (e) {
-        handleCLIError('library:personal:create', e, { exit: true });
-      }
-    });
+        } catch (e) {
+          handleCLIError('library:personal:create', e, { exit: true });
+        }
+      });
 
-  personal
-    .command('list')
-    .description('List your personal libraries')
-    .option('--json', 'Output JSON', false)
-    .action(async (opts) => {
-      try {
-        const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
-        const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
+    personal
+      .command('list')
+      .description(`List your ${label.toLowerCase()} libraries`)
+      .option('--json', 'Output JSON', false)
+      .action(async (opts) => {
+        try {
+          const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
+          const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
 
-        const { signer } = await getSignerSession();
-        const walletAddress = await signer.getAddress();
-        const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
-
-        const response = await fetch(`${baseUrl}/git/personal/libraries`, {
-          method: 'GET',
-          headers: {
-            'X-Wallet-Address': walletAddress,
-            'X-Wallet-Signature': signature,
-            'X-Wallet-Nonce': nonce,
-            'X-Wallet-Message': Buffer.from(message).toString('base64'),
-          },
-        });
+          const { signer } = await getSignerSession();
+          const walletAddress = await signer.getAddress();
+          const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
 
-        if (!response.ok) {
-          const error = await response.json().catch(() => ({ error: response.statusText }));
-          throw new Error(error.error || `Failed to list libraries: ${response.status}`);
-        }
+          const response = await fetch(`${baseUrl}/git/personal/libraries`, {
+            method: 'GET',
+            headers: {
+              'X-Wallet-Address': walletAddress,
+              'X-Wallet-Signature': signature,
+              'X-Wallet-Nonce': nonce,
+              'X-Wallet-Message': Buffer.from(message).toString('base64'),
+            },
+          });
 
-        const result = await response.json();
-        const libraries = result.libraries || [];
+          if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(error.error || `Failed to list libraries: ${response.status}`);
+          }
 
-        if (opts.json) {
-          ui.json(libraries);
-        } else if (libraries.length === 0) {
-          ui.info('No personal libraries found.');
-          ui.output('Create one with: sage library personal create --name "My Library"');
-        } else {
-          ui.header('Personal Libraries');
-          for (const lib of libraries) {
-            ui.output(`  ${lib.libraryId}: ${lib.name || '(unnamed)'}`);
+          const result = await response.json();
+          const libraries = result.libraries || [];
+
+          if (opts.json) {
+            ui.json(libraries);
+          } else if (libraries.length === 0) {
+            ui.info(`No ${label.toLowerCase()} libraries found.`);
+            ui.output(`Create one with: sage library ${name} create --name "My Library"`);
+          } else {
+            ui.header(`${label} Libraries`);
+            for (const lib of libraries) {
+              ui.output(`  ${lib.libraryId}: ${lib.name || '(unnamed)'}`);
+            }
           }
+
+        } catch (e) {
+          handleCLIError('library:personal:list', e, { exit: true });
         }
+      });
 
-      } catch (e) {
-        handleCLIError('library:personal:list', e, { exit: true });
-      }
-    });
+    personal
+      .command('info')
+      .description(`Show ${label.toLowerCase()} library info`)
+      .argument('<libraryId>', 'Library ID')
+      .option('--json', 'Output JSON', false)
+      .action(async (libraryId, opts) => {
+        try {
+          const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
+          const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
 
-  personal
-    .command('info')
-    .description('Show personal library info')
-    .argument('<libraryId>', 'Library ID')
-    .option('--json', 'Output JSON', false)
-    .action(async (libraryId, opts) => {
-      try {
-        const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
-        const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
+          const { signer } = await getSignerSession();
+          const walletAddress = await signer.getAddress();
+          const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
 
-        const { signer } = await getSignerSession();
-        const walletAddress = await signer.getAddress();
-        const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
-
-        const response = await fetch(`${baseUrl}/git/personal/${encodeURIComponent(libraryId)}`, {
-          method: 'GET',
-          headers: {
-            'X-Wallet-Address': walletAddress,
-            'X-Wallet-Signature': signature,
-            'X-Wallet-Nonce': nonce,
-            'X-Wallet-Message': Buffer.from(message).toString('base64'),
-          },
-        });
+          const response = await fetch(`${baseUrl}/git/personal/${encodeURIComponent(libraryId)}`, {
+            method: 'GET',
+            headers: {
+              'X-Wallet-Address': walletAddress,
+              'X-Wallet-Signature': signature,
+              'X-Wallet-Nonce': nonce,
+              'X-Wallet-Message': Buffer.from(message).toString('base64'),
+            },
+          });
 
-        if (!response.ok) {
-          const error = await response.json().catch(() => ({ error: response.statusText }));
-          throw new Error(error.error || `Library not found: ${response.status}`);
-        }
+          if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(error.error || `Library not found: ${response.status}`);
+          }
 
-        const result = await response.json();
+          const result = await response.json();
 
-        if (opts.json) {
-          ui.json(result);
-        } else {
-          ui.header(`Personal Library: ${libraryId}`);
-          ui.keyValue([
-            ['Name', result.name || '(unnamed)'],
-            ['Description', result.description || '(none)'],
-            ['Owner', result.owner || walletAddress],
-            ['Created', result.createdAt ? new Date(result.createdAt).toISOString() : 'unknown'],
-          ]);
+          if (opts.json) {
+            ui.json(result);
+          } else {
+            ui.header(`${label} Library: ${libraryId}`);
+            ui.keyValue([
+              ['Name', result.name || '(unnamed)'],
+              ['Description', result.description || '(none)'],
+              ['Owner', result.owner || walletAddress],
+              ['Created', result.createdAt ? new Date(result.createdAt).toISOString() : 'unknown'],
+            ]);
+          }
+
+        } catch (e) {
+          handleCLIError('library:personal:info', e, { exit: true });
         }
+      });
 
-      } catch (e) {
-        handleCLIError('library:personal:info', e, { exit: true });
-      }
-    });
+    personal
+      .command('push')
+      .description(`Push files to a ${label.toLowerCase()} library`)
+      .argument('<libraryId>', 'Library ID')
+      .option('--from-dir <path>', 'Directory to push (default: .)', '.')
+      .option('-m, --message <msg>', 'Commit message', 'Update library')
+      .option('--json', 'Output JSON', false)
+      .action(async (libraryId, opts) => {
+        try {
+          const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
+          const IPFSManager = require('../ipfs-manager');
+          const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
 
-  personal
-    .command('push')
-    .description('Push files to a personal library')
-    .argument('<libraryId>', 'Library ID')
-    .option('--from-dir <path>', 'Directory to push (default: .)', '.')
-    .option('-m, --message <msg>', 'Commit message', 'Update library')
-    .option('--json', 'Output JSON', false)
-    .action(async (libraryId, opts) => {
-      try {
-        const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
-        const IPFSManager = require('../ipfs-manager');
-        const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
+          const { signer } = await getSignerSession();
+          const walletAddress = await signer.getAddress();
+          const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
 
-        const { signer } = await getSignerSession();
-        const walletAddress = await signer.getAddress();
-        const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
+          // Scan directory for files
+          const scanDir = path.isAbsolute(opts.fromDir)
+            ? opts.fromDir
+            : path.join(process.cwd(), opts.fromDir);
 
-        // Scan directory for files
-        const scanDir = path.isAbsolute(opts.fromDir)
-          ? opts.fromDir
-          : path.join(process.cwd(), opts.fromDir);
+          ui.info(`Scanning ${scanDir}...`);
+          const files = scanDirectory(scanDir);
 
-        ui.info(`Scanning ${scanDir}...`);
-        const files = scanDirectory(scanDir);
+          if (files.length === 0) {
+            ui.warn('No .md files found to push');
+            return;
+          }
 
-        if (files.length === 0) {
-          ui.warn('No .md files found to push');
-          return;
-        }
+          ui.success(`Found ${files.length} file(s)`);
 
-        ui.success(`Found ${files.length} file(s)`);
+          // Upload files to IPFS
+          ui.info('Uploading to IPFS...');
+          const ipfs = new IPFSManager();
+          await ipfs.initialize();
 
-        // Upload files to IPFS
-        ui.info('Uploading to IPFS...');
-        const ipfs = new IPFSManager();
-        await ipfs.initialize();
+          for (const f of files) {
+            const content = fs.readFileSync(f.path, 'utf8');
+            f.cid = await ipfs.uploadText(content, path.basename(f.path));
+            f.files = [path.relative(scanDir, f.path)];
+          }
 
-        for (const f of files) {
-          const content = fs.readFileSync(f.path, 'utf8');
-          f.cid = await ipfs.uploadText(content, path.basename(f.path));
-          f.files = [path.relative(scanDir, f.path)];
-        }
+          // Build manifest
+          const manifest = buildManifest(libraryId, '', files);
+          let manifestCID;
+          if (typeof ipfs.uploadRawJson === 'function') {
+            const result = await ipfs.uploadRawJson(manifest, { name: 'manifest.json' });
+            manifestCID = result.cid;
+          } else {
+            manifestCID = await ipfs.uploadJson(manifest, 'manifest.json');
+          }
 
-        // Build manifest
-        const manifest = buildManifest(libraryId, '', files);
-        let manifestCID;
-        if (typeof ipfs.uploadRawJson === 'function') {
-          const result = await ipfs.uploadRawJson(manifest, { name: 'manifest.json' });
-          manifestCID = result.cid;
-        } else {
-          manifestCID = await ipfs.uploadJson(manifest, 'manifest.json');
-        }
+          ui.success(`Manifest: ${manifestCID}`);
 
-        ui.success(`Manifest: ${manifestCID}`);
-
-        // Push to library via worker API
-        ui.info('Pushing to library...');
-        const response = await fetch(`${baseUrl}/git/personal/${encodeURIComponent(libraryId)}/push`, {
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json',
-            'X-Wallet-Address': walletAddress,
-            'X-Wallet-Signature': signature,
-            'X-Wallet-Nonce': nonce,
-            'X-Wallet-Message': Buffer.from(message).toString('base64'),
-          },
-          body: JSON.stringify({
-            ref: 'refs/heads/main',
-            message: opts.message,
-            manifestCid: manifestCID,
-            author: {
-              name: walletAddress.slice(0, 10),
-              address: walletAddress,
+          // Push to library via worker API
+          ui.info('Pushing to library...');
+          const response = await fetch(`${baseUrl}/git/personal/${encodeURIComponent(libraryId)}/push`, {
+            method: 'POST',
+            headers: {
+              'Content-Type': 'application/json',
+              'X-Wallet-Address': walletAddress,
+              'X-Wallet-Signature': signature,
+              'X-Wallet-Nonce': nonce,
+              'X-Wallet-Message': Buffer.from(message).toString('base64'),
             },
-          }),
-        });
+            body: JSON.stringify({
+              ref: 'refs/heads/main',
+              message: opts.message,
+              manifestCid: manifestCID,
+              author: {
+                name: walletAddress.slice(0, 10),
+                address: walletAddress,
+              },
+            }),
+          });
 
-        if (!response.ok) {
-          const error = await response.json().catch(() => ({ error: response.statusText }));
-          throw new Error(error.error || `Push failed: ${response.status}`);
-        }
+          if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(error.error || `Push failed: ${response.status}`);
+          }
 
-        const result = await response.json();
+          const result = await response.json();
 
-        if (opts.json) {
-          ui.json({ libraryId, manifestCID, ...result });
-        } else {
-          ui.success(`Pushed to ${libraryId}`);
-          ui.keyValue([
-            ['Commit', result.commitHash || result.oid || 'created'],
-            ['Manifest CID', manifestCID],
-            ['Files', `${files.length}`],
-          ]);
+          if (opts.json) {
+            ui.json({ libraryId, manifestCID, ...result });
+          } else {
+            ui.success(`Pushed to ${libraryId}`);
+            ui.keyValue([
+              ['Commit', result.commitHash || result.oid || 'created'],
+              ['Manifest CID', manifestCID],
+              ['Files', `${files.length}`],
+            ]);
+          }
+
+        } catch (e) {
+          handleCLIError('library:personal:push', e, { exit: true });
         }
+      });
 
-      } catch (e) {
-        handleCLIError('library:personal:push', e, { exit: true });
-      }
-    });
+    personal
+      .command('delete')
+      .description(`Delete a ${label.toLowerCase()} library`)
+      .argument('<libraryId>', 'Library ID')
+      .option('--json', 'Output JSON', false)
+      .option('--force', 'Skip confirmation')
+      .action(async (libraryId, opts) => {
+        try {
+          const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
+          const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
+
+          if (!opts.force && !process.env.SAGE_FORCE) {
+            const readline = require('readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const answer = await new Promise((resolve) => {
+              rl.question(`Delete library "${libraryId}"? This cannot be undone. (y/N) `, resolve);
+            });
+            rl.close();
+            if (answer.toLowerCase() !== 'y') {
+              ui.info('Aborted.');
+              return;
+            }
+          }
 
-  personal
-    .command('delete')
-    .description('Delete a personal library')
-    .argument('<libraryId>', 'Library ID')
-    .option('--json', 'Output JSON', false)
-    .option('--force', 'Skip confirmation')
-    .action(async (libraryId, opts) => {
-      try {
-        const { getSignerSession, getSiweAuth } = require('../utils/cli-session');
-        const baseUrl = process.env.SAGE_IPFS_WORKER_URL || 'https://api.sageprotocol.io';
-
-        if (!opts.force && !process.env.SAGE_FORCE) {
-          const readline = require('readline');
-          const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-          const answer = await new Promise((resolve) => {
-            rl.question(`Delete library "${libraryId}"? This cannot be undone. (y/N) `, resolve);
+          const { signer } = await getSignerSession();
+          const walletAddress = await signer.getAddress();
+          const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
+
+          const response = await fetch(`${baseUrl}/git/personal/${encodeURIComponent(libraryId)}`, {
+            method: 'DELETE',
+            headers: {
+              'X-Wallet-Address': walletAddress,
+              'X-Wallet-Signature': signature,
+              'X-Wallet-Nonce': nonce,
+              'X-Wallet-Message': Buffer.from(message).toString('base64'),
+            },
           });
-          rl.close();
-          if (answer.toLowerCase() !== 'y') {
-            ui.info('Aborted.');
-            return;
+
+          if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(error.error || `Delete failed: ${response.status}`);
           }
-        }
 
-        const { signer } = await getSignerSession();
-        const walletAddress = await signer.getAddress();
-        const { signature, message, nonce } = await getSiweAuth(signer, baseUrl);
-
-        const response = await fetch(`${baseUrl}/git/personal/${encodeURIComponent(libraryId)}`, {
-          method: 'DELETE',
-          headers: {
-            'X-Wallet-Address': walletAddress,
-            'X-Wallet-Signature': signature,
-            'X-Wallet-Nonce': nonce,
-            'X-Wallet-Message': Buffer.from(message).toString('base64'),
-          },
-        });
+          if (opts.json) {
+            ui.json({ deleted: true, libraryId });
+          } else {
+            ui.success(`Deleted library: ${libraryId}`);
+          }
 
-        if (!response.ok) {
-          const error = await response.json().catch(() => ({ error: response.statusText }));
-          throw new Error(error.error || `Delete failed: ${response.status}`);
+        } catch (e) {
+          handleCLIError('library:personal:delete', e, { exit: true });
         }
+      });
 
-        if (opts.json) {
-          ui.json({ deleted: true, libraryId });
-        } else {
-          ui.success(`Deleted library: ${libraryId}`);
-        }
+    return personal;
+  }
 
-      } catch (e) {
-        handleCLIError('library:personal:delete', e, { exit: true });
-      }
-    });
+  const personal = buildPersonalCommands({ name: 'personal', label: 'Personal' });
+  const vault = buildPersonalCommands({ name: 'vault', label: 'Vault' });
 
   cmd.addCommand(personal);
+  cmd.addCommand(vault);
 
   return cmd;
 };