jaspervault_cli 1.1.0 → 1.1.2

package/docs/USER_GUIDE.md

@@ -0,0 +1,276 @@
+# User Guide
+
+Complete reference for the JasperVault CLI (`jv`). This guide covers installation, wallet setup, trading operations, and advanced configuration.
+
+## Installation
+
+```bash
+npm install -g jaspervault_cli
+```
+
+Verify:
+
+```bash
+jv --version
+```
+
+**Requirements:** Node.js 18+
+
+## Wallet Setup
+
+Before trading, you need to initialize your vault. This creates an AA (Account Abstraction) wallet and a local delegation key.
+
+```bash
+jv enable --pretty
+```
+
+This opens a hosted web page where you connect your wallet (MetaMask, Rabby, etc.) and sign a delegation authorization. Your private key never leaves the browser.
+
+After setup completes, your delegation key and vault profile are saved to `~/.jaspervault/`. All subsequent commands use these automatically.
+
+## Deposits & Withdrawals
+
+Bridge assets between Base and JasperVault via Hyperlane.
+
+**Deposit:**
+
+```bash
+jv deposit --token usdc --amount 100 --pretty
+```
+
+**Withdraw:**
+
+```bash
+jv withdraw --token usdc --amount 100 --pretty
+```
+
+Both commands open a hosted web page for you to approve the transaction in your browser wallet.
+
+## Trading
+
+### Market Orders
+
+Execute immediately at current market price.
+
+```bash
+# Long BTC, 100 USDC margin, 50x leverage
+jv order create --side long --symbol JBTC --margin 100 --leverage 50
+
+# Short BTC, 50 USDC margin, 100x leverage
+jv order create --side short --symbol JBTC --margin 50 --leverage 100
+```
+
+Market orders return a `jobId`. The order typically confirms on-chain within seconds.
+
+### Limit Orders
+
+Execute when price reaches the target.
+
+```bash
+# Short BTC at $95,000
+jv order create --side short --symbol JBTC --margin 50 --leverage 100 --limit-price 95000
+```
+
+Limit orders return a `limitOrderId` and remain active until triggered, expired, or cancelled.
+
+### Close a Position
+
+Use `jv order close` for a **full** close. It reads the position's side, margin,
+symbol, and leverage on-chain and submits the reverse order for you — no need to
+look anything up first.
+
+```bash
+# Close a single position by order ID
+jv order close --order-id 99
+
+# Close every active position
+jv order close --all
+```
+
+Under the hood, JasperVault has no native close endpoint — closing is a
+reverse-side order with the same margin. `jv order close` just does that
+derivation for you.
+
+For a **partial** close, use `jv order create` directly with the opposite side
+and a smaller margin than the position:
+
+```bash
+# Partial close: reduce a LONG position by half (position has 100 USDC margin)
+jv order create --side short --symbol JBTC --margin 50
+```
+
+Check your positions any time with `jv orders list --pretty`.
+
+### Take-Profit & Stop-Loss
+
+```bash
+jv tp set --order-id 99 --price 105000 --symbol JBTC
+jv sl set --order-id 99 --price 88000 --symbol JBTC
+```
+
+## PPO Hedge Protection
+
+PPO (Perpetual Protection Option) is JasperVault's on-chain hedge option that protects leveraged positions against sudden price wicks and liquidation cascades.
+
+### Why PPO
+
+In leveraged perpetual trading, flash crashes and price wicks ("pin bars") can liquidate positions in seconds — even when the market quickly recovers. Traditional stop-loss orders execute *at* the wick price, locking in maximum loss. PPO solves this by attaching a real option contract to your position:
+
+- **Survives the wick** — the option payoff offsets unrealized loss, keeping your position alive through the spike
+- **No slippage** — peer-to-peer fully collateralized settlement on-chain, independent of orderbook depth or liquidity
+- **Auto hedge type** — LONG positions get PUT options, SHORT positions get CALL options (selected automatically)
+
+### Using PPO
+
+**Open a position with PPO:**
+
+```bash
+jv order create --side long --symbol JBTC --margin 100 --leverage 50 --ppo
+```
+
+**Add PPO to an existing position:**
+
+```bash
+jv order protect --order-id 42 --symbol JBTC
+```
+
+**Customize PPO parameters:**
+
+```bash
+jv order create --side long --symbol JBTC --margin 100 --leverage 50 \
+  --ppo --ppo-expire 8h --ppo-category OTM --ppo-tier 3
+```
+
+### PPO Parameters
+
+| Parameter | Options | Default | Description |
+|-----------|---------|---------|-------------|
+| `--ppo` | flag | off | Enable PPO protection |
+| `--ppo-category` | `ATM`, `OTM` | `ATM` | ATM = strike at current price; OTM = offset from current price |
+| `--ppo-tier` | `1`–`5` | — | OTM strike offset (0.1%–0.5%). Required when category is OTM |
+| `--ppo-expire` | `30m`, `8h` | `30m` | Option expiry duration |
+
+### OTM Tiers
+
+| Tier | Strike Offset | Use Case |
+|------|---------------|----------|
+| 1 | 0.1% | Tight protection, higher premium |
+| 2 | 0.2% | Balanced |
+| 3 | 0.3% | Moderate offset |
+| 4 | 0.4% | Wider offset, lower premium |
+| 5 | 0.5% | Maximum offset, lowest premium |
+
+### PPO Lifecycle
+
+- **Combine with any operation** — PPO can be added when opening, adding size, or setting TP/SL
+- **Auto-cancellation** — Executing any position operation *without* `--ppo` automatically cancels the existing PPO on that position
+- **Keep PPO on reduce** — Add `--ppo` when partially closing to maintain protection on the remaining position
+- **No separate cancel** — There is no "cancel PPO" command. To remove PPO, execute any position operation without the `--ppo` flag
+
+## Querying Data
+
+```bash
+# List active positions
+jv orders list --pretty
+
+# Get specific order details
+jv orders get <orderId> --pretty
+
+# Portfolio statistics
+jv orders stats --pretty
+
+# Real-time price
+jv price --symbol JBTC --pretty
+
+# Check market order execution status
+jv job status <jobId> --pretty
+```
+
+### Limit Order Management
+
+```bash
+# List limit orders
+jv limit-order list --wallet 0x... --status PENDING --pretty
+
+# Check status
+jv limit-order status <limitOrderId>
+
+# Cancel
+jv limit-order cancel <limitOrderId>
+```
+
+## AI Platform Integration
+
+Install JasperVault trading capabilities into your AI agent:
+
+```bash
+jv install --ai claude        # Claude Code (project-level)
+jv install --ai claude --global   # Claude Code (user-level)
+jv install --ai cursor        # Cursor (project-level)
+jv install --ai cursor --global   # Cursor (user-level)
+jv install --ai openclaw      # OpenClaw
+jv install                    # All platforms (global)
+```
+
+After installation, your AI can execute trades via MCP tools or skills. See the [OpenClaw Guide](OPENCLAW_GUIDE.md) for platform-specific setup details.
+
+## Configuration
+
+All environment variables are optional. The CLI works out of the box with sensible defaults.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `JV_API_URL` | Trading API endpoint | Production endpoint |
+| `JV_API_KEY` | Bearer token for API auth | — |
+| `JV_TIMEOUT` | Request timeout (ms) | 30000 |
+| `JV_DELEGATION_KEY` | Delegation wallet key | Auto-generated |
+| `BASE_HTTP_RPC_URL` | Base chain RPC (required) | — |
+| `JV_JASPERVAULT_RPC_URL` | JasperVault chain RPC | Built-in |
+| `JV_SUBGRAPH_URL` | Subgraph endpoint | Built-in |
+
+### Local Override Example
+
+```bash
+export JV_API_URL=http://localhost:3000
+```
+
+### Configuration Files
+
+| Path | Purpose |
+|------|---------|
+| `~/.jaspervault/keys.json` | Delegation wallet key (auto-generated) |
+| `~/.jaspervault/profile.json` | Vault addresses and type mappings |
+
+## Output Formats
+
+- **JSON** (default) — Machine-readable, suitable for scripting and piping
+- **Pretty** — Human-readable tables. Append `--pretty` to any command
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | Configuration error (missing params, invalid input) |
+| 2 | Network / HTTP error |
+| 3 | Business error (API-level rejection) |
+
+## Updates
+
+```bash
+jv update          # Check and install latest version
+```
+
+## FAQ
+
+**Q: Do I need to export my private key?**
+No. Browser signing keeps your keys in your wallet. Your private key never leaves the browser.
+
+**Q: How do I switch networks?**
+Set `JV_API_URL` to your target environment's API endpoint.
+
+**Q: Is my delegation key safe?**
+The delegation key is generated locally and stored in `~/.jaspervault/keys.json`. It can only execute trades within the scope authorized by your delegation signature. It cannot transfer or withdraw funds without additional browser signing.
+
+**Q: What trading pairs are available?**
+Currently BTC perpetuals (symbol: `JBTC`). Additional pairs will be added — check `jv price --symbol <symbol>` for availability.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaspervault_cli",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "JasperVault CLI for interacting with the JasperVault Manager API",
   "type": "module",
   "bin": {
@@ -19,7 +19,8 @@
   },
   "files": [
     "dist",
-    "config"
+    "config",
+    "docs"
   ],
   "keywords": [
     "jaspervault",

package/dist/src/commands/connect.d.ts

@@ -1,26 +0,0 @@
-import { SignClient } from '@walletconnect/sign-client';
-export declare function startHeartbeat(phase: string, message: string): {
-    stop: () => void;
-};
-export interface InitWcResult {
-    client: InstanceType<typeof SignClient>;
-    session: {
-        topic: string;
-        pairingTopic: string;
-        namespaces: Record<string, {
-            accounts: string[];
-        }>;
-    };
-    walletAddress: string;
-}
-export interface QrCodeOutput {
-    qrCodeUrl: string;
-}
-/**
- * Initialize WalletConnect SignClient, connect, show QR, wait for approval.
- * Returns client + session + walletAddress for further requests (e.g. eth_signTypedData_v4).
- */
-export declare function initWcAndConnect(opts: {
-    timeoutS: number;
-    onAwaiting?: (uri: string, qrCodes: QrCodeOutput) => void;
-}): Promise<InitWcResult>;

package/dist/src/commands/connect.js

@@ -1,93 +0,0 @@
-import * as fs from 'node:fs/promises';
-import { join } from 'node:path';
-import { SignClient } from '@walletconnect/sign-client';
-import QRCode from 'qrcode';
-import { exitWithError, EXIT_CODES } from '../utils/output.js';
-const DEFAULT_TIMEOUT_S = 120;
-const HEARTBEAT_INTERVAL_MS = 10_000;
-export function startHeartbeat(phase, message) {
-    const start = Date.now();
-    const timer = setInterval(() => {
-        const elapsed = Math.round((Date.now() - start) / 1000);
-        process.stderr.write(JSON.stringify({ status: 'waiting', phase, elapsed, message }) + '\n');
-    }, HEARTBEAT_INTERVAL_MS);
-    return { stop: () => clearInterval(timer) };
-}
-// Embedded project ID — users can override with WC_PROJECT_ID env var
-const DEFAULT_WC_PROJECT_ID = 'f47863c3ad29e5bae9cee8013ec05982';
-const WC_METADATA = {
-    name: 'JasperVault CLI',
-    description: 'JasperVault perpetual trading CLI',
-    url: 'https://jaspervault.io',
-    icons: [],
-};
-function getJvDir() {
-    return join(process.env.HOME || process.env.USERPROFILE || '', '.jaspervault');
-}
-function getQrCodePath() {
-    return join(getJvDir(), 'wc-qrcode.png');
-}
-function buildQrCodeUrl(data) {
-    return `https://api.qrserver.com/v1/create-qr-code/?size=400x400&data=${encodeURIComponent(data)}`;
-}
-/**
- * Initialize WalletConnect SignClient, connect, show QR, wait for approval.
- * Returns client + session + walletAddress for further requests (e.g. eth_signTypedData_v4).
- */
-export async function initWcAndConnect(opts) {
-    const projectId = process.env.WC_PROJECT_ID || DEFAULT_WC_PROJECT_ID;
-    let client;
-    try {
-        client = await SignClient.init({
-            projectId,
-            metadata: WC_METADATA,
-        });
-    }
-    catch (err) {
-        exitWithError(`Failed to initialize WalletConnect: ${err.message}`, EXIT_CODES.HTTP_ERROR);
-    }
-    const { uri, approval } = await client.connect({
-        optionalNamespaces: {
-            eip155: {
-                chains: ['eip155:8453', 'eip155:55531'],
-                methods: ['eth_signTypedData_v4', 'eth_sendTransaction'],
-                events: ['accountsChanged', 'chainChanged'],
-            },
-        },
-    });
-    if (!uri) {
-        exitWithError('WalletConnect did not return a pairing URI', EXIT_CODES.HTTP_ERROR);
-    }
-    await fs.mkdir(getJvDir(), { recursive: true });
-    const qrPath = getQrCodePath();
-    await QRCode.toFile(qrPath, uri, { width: 400, errorCorrectionLevel: 'M' });
-    const qrCodeUrl = buildQrCodeUrl(uri);
-    opts.onAwaiting?.(uri, { qrCodeUrl });
-    const heartbeat = startHeartbeat('wallet_scan', 'Waiting for wallet connection...');
-    const timeoutMs = opts.timeoutS * 1000;
-    let session;
-    try {
-        session = await Promise.race([
-            approval(),
-            new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), timeoutMs)),
-        ]);
-    }
-    catch (err) {
-        heartbeat.stop();
-        const msg = err.message;
-        if (msg === 'timeout') {
-            throw new Error(`Connection timed out after ${opts.timeoutS}s`);
-        }
-        throw new Error(`Connection rejected or failed: ${msg}`);
-    }
-    heartbeat.stop();
-    const accounts = Object.values(session.namespaces).flatMap((ns) => ns.accounts);
-    const firstAccount = accounts[0];
-    if (!firstAccount) {
-        exitWithError('No accounts returned from wallet', EXIT_CODES.BUSINESS_ERROR);
-    }
-    const parts = firstAccount.split(':');
-    const walletAddress = parts[2];
-    return { client, session, walletAddress };
-}
-//# sourceMappingURL=connect.js.map

package/dist/src/commands/connect.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/commands/connect.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/init.d.ts

@@ -1,4 +0,0 @@
-import { Command } from 'commander';
-export declare const PLATFORMS: readonly ["openclaw", "cursor", "claude", "all"];
-export type Platform = (typeof PLATFORMS)[number];
-export declare function registerInitCommand(program: Command): void;

package/dist/src/commands/init.js

@@ -1,114 +0,0 @@
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { homedir } from 'node:os';
-import { BANNER, buildSkillContent } from '../templates/skill-body.js';
-export const PLATFORMS = ['openclaw', 'cursor', 'claude', 'all'];
-const SKILL_DIR = 'jasper-vault-cli';
-function getTargetPath(platform, global) {
-    const home = homedir();
-    const cwd = process.cwd();
-    switch (platform) {
-        case 'openclaw':
-            return [path.join(home, '.openclaw', 'skills', SKILL_DIR)];
-        case 'cursor':
-            return global
-                ? [path.join(home, '.cursor', 'skills', SKILL_DIR)]
-                : [path.join(cwd, '.cursor', 'skills', SKILL_DIR)];
-        case 'claude':
-            return global
-                ? [path.join(home, '.claude', 'skills', SKILL_DIR)]
-                : [path.join(cwd, '.claude', 'skills', SKILL_DIR)];
-        case 'all':
-            return [
-                path.join(home, '.openclaw', 'skills', SKILL_DIR),
-                path.join(cwd, '.cursor', 'skills', SKILL_DIR),
-                path.join(cwd, '.claude', 'skills', SKILL_DIR),
-            ];
-        default:
-            throw new Error(`Unknown platform: ${platform}`);
-    }
-}
-function getPlatformFromPath(pathStr) {
-    if (pathStr.includes('.openclaw'))
-        return 'openclaw';
-    if (pathStr.includes('.cursor'))
-        return 'cursor';
-    if (pathStr.includes('.claude'))
-        return 'claude';
-    throw new Error(`Cannot determine platform from path: ${pathStr}`);
-}
-function getPlatformDisplayName(p) {
-    return p === 'openclaw' ? 'OpenClaw' : p === 'cursor' ? 'Cursor' : 'Claude Code';
-}
-export function registerInitCommand(program) {
-    program
-        .command('init')
-        .description('Install JasperVault skill to AI platform (OpenClaw, Cursor, Claude Code)')
-        .requiredOption('--ai <platform>', `Target platform: ${PLATFORMS.join(', ')}`)
-        .option('--global', 'Install to user home directory (cursor/claude only)')
-        .option('--force', 'Overwrite existing skill files without prompting')
-        .action(async (opts) => {
-        const platform = opts.ai;
-        if (!PLATFORMS.includes(platform)) {
-            process.stderr.write(`Error: Invalid platform "${platform}". Use one of: ${PLATFORMS.join(', ')}\n`);
-            process.exit(1);
-        }
-        const globalFlag = opts.global ?? false;
-        const force = opts.force ?? false;
-        const targetPaths = getTargetPath(platform, globalFlag);
-        process.stdout.write(BANNER + '\n\n');
-        const results = [];
-        for (const targetDir of targetPaths) {
-            const skillPlatform = platform === 'all' ? getPlatformFromPath(targetDir) : platform;
-            const platDisplay = getPlatformDisplayName(skillPlatform);
-            try {
-                const skillMdPath = path.join(targetDir, 'SKILL.md');
-                const exists = await fs
-                    .access(skillMdPath)
-                    .then(() => true)
-                    .catch(() => false);
-                if (exists && !force) {
-                    process.stderr.write(`Error: Skill already exists at ${targetDir}\n` +
-                        'Use --force to overwrite.\n');
-                    process.exit(1);
-                }
-                const files = buildSkillContent(skillPlatform);
-                let fileCount = 0;
-                for (const [relPath, content] of Object.entries(files)) {
-                    const filePath = path.join(targetDir, relPath);
-                    await fs.mkdir(path.dirname(filePath), { recursive: true });
-                    await fs.writeFile(filePath, content, 'utf8');
-                    fileCount++;
-                }
-                // Make scripts executable
-                const scriptsDir = path.join(targetDir, 'scripts');
-                const scriptsDirExists = await fs
-                    .access(scriptsDir)
-                    .then(() => true)
-                    .catch(() => false);
-                if (scriptsDirExists) {
-                    const scriptFiles = await fs.readdir(scriptsDir);
-                    for (const sf of scriptFiles) {
-                        if (sf.endsWith('.sh')) {
-                            await fs.chmod(path.join(scriptsDir, sf), 0o755);
-                        }
-                    }
-                }
-                results.push({ path: targetDir, platform: platDisplay, fileCount });
-            }
-            catch (err) {
-                process.stderr.write(`Error installing to ${platDisplay}: ${err.message}\n`);
-                process.exit(1);
-            }
-        }
-        process.stdout.write('\n  ✓ Skill installed successfully!\n\n' +
-            results
-                .map((r) => `  Platform:  ${r.platform}\n  Location:  ${r.path}\n  Files:     ${r.fileCount} (SKILL.md + references/ + scripts/)`)
-                .join('\n\n') +
-            '\n\n  Next steps:\n' +
-            '    1. First-time setup:  jv vault setup --network jaspervault\n' +
-            '    2. (Optional) Override API URL for local debugging:  export JV_API_URL=http://localhost:3000\n' +
-            '    3. Start using jv commands or let your AI agent call them\n');
-    });
-}
-//# sourceMappingURL=init.js.map

package/dist/src/commands/init.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/skill.d.ts

@@ -1,4 +0,0 @@
-import { Command } from 'commander';
-export declare const PLATFORMS: readonly ["openclaw", "cursor", "claude", "all"];
-export type Platform = (typeof PLATFORMS)[number];
-export declare function registerSkillCommand(program: Command): void;

package/dist/src/commands/skill.js

@@ -1,117 +0,0 @@
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { homedir } from 'node:os';
-import { BANNER, buildSkillContent } from '../templates/skill-body.js';
-export const PLATFORMS = ['openclaw', 'cursor', 'claude', 'all'];
-const SKILL_DIR = 'jasper-vault-cli';
-function getTargetPath(platform, global) {
-    const home = homedir();
-    const cwd = process.cwd();
-    switch (platform) {
-        case 'openclaw':
-            return [path.join(home, '.openclaw', 'skills', SKILL_DIR)];
-        case 'cursor':
-            return global
-                ? [path.join(home, '.cursor', 'skills', SKILL_DIR)]
-                : [path.join(cwd, '.cursor', 'skills', SKILL_DIR)];
-        case 'claude':
-            return global
-                ? [path.join(home, '.claude', 'skills', SKILL_DIR)]
-                : [path.join(cwd, '.claude', 'skills', SKILL_DIR)];
-        case 'all':
-            return [
-                path.join(home, '.openclaw', 'skills', SKILL_DIR),
-                path.join(cwd, '.cursor', 'skills', SKILL_DIR),
-                path.join(cwd, '.claude', 'skills', SKILL_DIR),
-            ];
-        default:
-            throw new Error(`Unknown platform: ${platform}`);
-    }
-}
-function getPlatformFromPath(pathStr) {
-    if (pathStr.includes('.openclaw'))
-        return 'openclaw';
-    if (pathStr.includes('.cursor'))
-        return 'cursor';
-    if (pathStr.includes('.claude'))
-        return 'claude';
-    throw new Error(`Cannot determine platform from path: ${pathStr}`);
-}
-function getPlatformDisplayName(p) {
-    return p === 'openclaw' ? 'OpenClaw' : p === 'cursor' ? 'Cursor' : 'Claude Code';
-}
-export function registerSkillCommand(program) {
-    const skill = program
-        .command('skill')
-        .description('Manage JasperVault AI skills');
-    skill
-        .command('install')
-        .description('Install JasperVault skill to AI platform (OpenClaw, Cursor, Claude Code)')
-        .requiredOption('--ai <platform>', `Target platform: ${PLATFORMS.join(', ')}`)
-        .option('--global', 'Install to user home directory (cursor/claude only)')
-        .option('--force', 'Overwrite existing skill files without prompting')
-        .action(async (opts) => {
-        const platform = opts.ai;
-        if (!PLATFORMS.includes(platform)) {
-            process.stderr.write(`Error: Invalid platform "${platform}". Use one of: ${PLATFORMS.join(', ')}\n`);
-            process.exit(1);
-        }
-        const globalFlag = opts.global ?? false;
-        const force = opts.force ?? false;
-        const targetPaths = getTargetPath(platform, globalFlag);
-        process.stdout.write(BANNER + '\n\n');
-        const results = [];
-        for (const targetDir of targetPaths) {
-            const skillPlatform = platform === 'all' ? getPlatformFromPath(targetDir) : platform;
-            const platDisplay = getPlatformDisplayName(skillPlatform);
-            try {
-                const skillMdPath = path.join(targetDir, 'SKILL.md');
-                const exists = await fs
-                    .access(skillMdPath)
-                    .then(() => true)
-                    .catch(() => false);
-                if (exists && !force) {
-                    process.stderr.write(`Error: Skill already exists at ${targetDir}\n` +
-                        'Use --force to overwrite.\n');
-                    process.exit(1);
-                }
-                const files = buildSkillContent(skillPlatform);
-                let fileCount = 0;
-                for (const [relPath, content] of Object.entries(files)) {
-                    const filePath = path.join(targetDir, relPath);
-                    await fs.mkdir(path.dirname(filePath), { recursive: true });
-                    await fs.writeFile(filePath, content, 'utf8');
-                    fileCount++;
-                }
-                // Make scripts executable
-                const scriptsDir = path.join(targetDir, 'scripts');
-                const scriptsDirExists = await fs
-                    .access(scriptsDir)
-                    .then(() => true)
-                    .catch(() => false);
-                if (scriptsDirExists) {
-                    const scriptFiles = await fs.readdir(scriptsDir);
-                    for (const sf of scriptFiles) {
-                        if (sf.endsWith('.sh')) {
-                            await fs.chmod(path.join(scriptsDir, sf), 0o755);
-                        }
-                    }
-                }
-                results.push({ path: targetDir, platform: platDisplay, fileCount });
-            }
-            catch (err) {
-                process.stderr.write(`Error installing to ${platDisplay}: ${err.message}\n`);
-                process.exit(1);
-            }
-        }
-        process.stdout.write('\n  ✓ Skill installed successfully!\n\n' +
-            results
-                .map((r) => `  Platform:  ${r.platform}\n  Location:  ${r.path}\n  Files:     ${r.fileCount} (SKILL.md + references/ + scripts/)`)
-                .join('\n\n') +
-            '\n\n  Next steps:\n' +
-            '    1. First-time setup:  jv vault setup --network jaspervault\n' +
-            '    2. (Optional) Override API URL for local debugging:  export JV_API_URL=http://localhost:3000\n' +
-            '    3. Start using jv commands or let your AI agent call them\n');
-    });
-}
-//# sourceMappingURL=skill.js.map