npm - jaspervault_cli - Versions diffs - 1.0.26 → 1.0.27 - Mend

jaspervault_cli 1.0.26 → 1.0.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/dist/src/templates/skill-body.d.ts CHANGED Viewed

@@ -4,6 +4,8 @@
  *   SKILL.md          — compact core rules + activation + intent table
  *   references/        — detailed docs loaded on demand by the agent
  *   scripts/           — helper scripts
+ *
+ * All content is read from skill-content/ directory (independent .md files).
  */
 /** ANSI Shadow style ASCII art banner (plain text, no ANSI colors) */
 export declare const BANNER: string;

package/dist/src/templates/skill-body.js CHANGED Viewed

@@ -4,6 +4,8 @@
  *   SKILL.md          — compact core rules + activation + intent table
  *   references/        — detailed docs loaded on demand by the agent
  *   scripts/           — helper scripts
+ *
+ * All content is read from skill-content/ directory (independent .md files).
  */
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
@@ -29,490 +31,26 @@ export const BANNER = `
   ⟐  Skill Installer
 `.trim();
 // ---------------------------------------------------------------------------
-// Core SKILL.md body — kept under 50 lines so critical rules stay prominent
+// Content directory — .md files live here, copied to dist/ at build time
 // ---------------------------------------------------------------------------
-const SKILL_CORE_BODY = `
-Trade perpetual contracts on JasperVault via the \`jv\` CLI. No private key is ever required.
-## CRITICAL RULES (MUST FOLLOW — violations cause broken UX)
-1. **WalletConnect ONLY**: ALWAYS use \`jv vault setup\`. NEVER suggest \`jv vault init\` (private-key mode). NEVER ask the user to set \`PRIVATE_KEY\`.
-2. **QR Code Display**: When \`jv vault setup\` outputs JSON with a \`qrCodeUrl\` field, you MUST display the \`qrCodeUrl\` value as a clickable link to the user. This is the only QR code field in the output — there are no other QR representations.
-3. **Long-running Commands**: \`jv vault setup\` is a long-running command (up to 2 min) that will be auto-backgrounded. After it backgrounds you receive a \`sessionId\` and the first JSON output (QR code). Show the QR link to the user, then poll every 15 seconds with \`process poll\` using that \`sessionId\` until you see the second JSON line containing \`"success":true\` or the process exits. See [references/onboarding.md](references/onboarding.md) for the full step-by-step flow.
-4. **Real-time Prices**: NEVER guess or estimate prices. ALWAYS run \`jv price --symbol JBTC --pretty\` before any price-dependent operation (opening a position by asset quantity, calculating PnL).
-5. **PPO Auto-Cancellation**: When performing any position operation (reduce, close, add size) WITHOUT \`--ppo\`, the smart contract automatically cancels existing PPO hedge options. There is NO separate "cancel PPO" command. NEVER attempt a separate cancellation — it risks unintended position closures.
-6. **Standalone PPO Protection**: To add hedge protection to an **existing position**, use \`jv order protect --order-id <id> --symbol <symbol>\`. Do NOT use \`jv order create --ppo\` for this — that command ADDS POSITION SIZE. \`jv order create --ppo\` is ONLY for opening new positions or adding size with protection. See [references/trading.md](references/trading.md) for details.
-## Activation Behavior
-1. Check if vault is initialized: \`jv orders list --pretty\`
-2. If the command fails (exit code 1, or errors like "delegation key not found" / "vault not initialized" / "no profile"):
-   - Tell the user: "Your vault is not initialized yet. Let me set it up via WalletConnect — no private key needed."
-   - Immediately run \`jv vault setup --network jaspervault --timeout 120\`.
-   - Follow the QR code display instructions in [references/onboarding.md](references/onboarding.md).
-3. If the command succeeds → vault is ready. Proceed with the user's request.
-## Intent → Command Reference
-| User Intent | Command | Details |
-|-------------|---------|---------|
-| Initialize / connect wallet | \`jv vault setup\` | [references/onboarding.md](references/onboarding.md) |
-| Deposit tokens | \`jv deposit info\` + \`jv deposit poll\` | [references/onboarding.md](references/onboarding.md) |
-| Get current price | \`jv price --symbol JBTC --pretty\` | [references/trading.md](references/trading.md) |
-| Open position (market) | \`jv order create --side long/short ...\` | [references/trading.md](references/trading.md) |
-| Open position (limit) | \`jv order create ... --limit-price N\` | [references/trading.md](references/trading.md) |
-| Reduce / close position | opposite-side \`jv order create\` | [references/trading.md](references/trading.md) |
-| Set take-profit | \`jv tp set --order-id ID --price P\` | [references/trading.md](references/trading.md) |
-| Set stop-loss | \`jv sl set --order-id ID --price P\` | [references/trading.md](references/trading.md) |
-| Add PPO to existing position | \`jv order protect --order-id <id>\` | [references/trading.md](references/trading.md) |
-| Open/add-size with PPO | add \`--ppo\` to \`jv order create\` | [references/trading.md](references/trading.md) |
-| Cancel PPO / remove hedge | order without \`--ppo\` (auto-cancels) | [references/trading.md](references/trading.md) |
-| Query positions / portfolio | \`jv orders list --pretty\` | [references/queries.md](references/queries.md) |
-| Job execution status | \`jv job status <jobId>\` | [references/queries.md](references/queries.md) |
-| Manage limit orders | \`jv limit-order list/cancel\` | [references/queries.md](references/queries.md) |
-## Security
-- Never log or display private keys, signatures, or API keys.
-- The CLI signs orders via the delegation wallet in \`~/.jaspervault/keys.json\`.
-- Do NOT ask the user to set \`PRIVATE_KEY\`.
-`.trim();
-// ---------------------------------------------------------------------------
-// references/onboarding.md — WalletConnect init + deposit flow
-// ---------------------------------------------------------------------------
-const ONBOARDING_REFERENCE = `# WalletConnect Onboarding & Deposit
-## Vault Init via WalletConnect
-\`jv vault setup\` is a long-running command (up to 2 minutes). It will be auto-backgrounded by the exec tool. You MUST use \`process poll\` to retrieve the final result. Follow these three steps exactly:
-### Step 1: Run the command and show QR code
-\`\`\`bash
-jv vault setup --network jaspervault --timeout 120
-\`\`\`
-The command will be auto-backgrounded after ~10 seconds. You will receive:
-- A \`sessionId\` for the background session
-- The first JSON output containing the QR code
-First JSON output:
-\`\`\`json
-{"status":"awaiting_connection", "qrCodeUrl":"https://api.qrserver.com/v1/create-qr-code/?size=400x400&data=wc%3A...", "uri":"wc:...", "message":"Scan QR code or paste URI in wallet to connect"}
-\`\`\`
-Display the \`qrCodeUrl\` value as a clickable link so the user can open it and scan the QR code. Also provide the \`uri\` as a fallback:
-> Or open your wallet app → WalletConnect → paste this URI: \`wc:...\`
-### Step 2: Poll for completion
-After showing the QR code, poll the background session every 15 seconds using the \`sessionId\`:
-\`\`\`json
-{"tool":"process", "action":"poll", "sessionId":"<sessionId from step 1>"}
-\`\`\`
-Keep polling until you see the second JSON line in the output containing \`"success":true\`, or the process exits. Do NOT stop polling early — the user needs time to scan the QR code and approve the signature on their phone.
-### Step 3: Handle the result
-When polling returns the second JSON line:
-\`\`\`json
-{"success":true, "message":"Vault initialized successfully", ...}
-\`\`\`
-Tell the user: "Vault initialized successfully. You can now deposit and trade."
-If polling shows the process exited with an error or \`"success":false\`, report the error message to the user.
-The delegation wallet is saved to \`~/.jaspervault/keys.json\` and vault addresses to \`~/.jaspervault/profile.json\`. Subsequent commands use these automatically — no wallet interaction needed.
-## Deposit via WalletConnect (Optional)
-If the user wants to deposit:
-1. **Get unsigned transactions:**
-   \`\`\`bash
-   jv deposit info --wallet <walletAddress> --token jusdc --amount 100
-   \`\`\`
-2. **Output contains \`transactions\` array.** Each \`tx\` has \`to\`, \`data\`, \`value\`, \`chainId\`. Send each via WalletConnect \`eth_sendTransaction\` to the user's wallet. Execute in order (approve first if present, then transferRemote).
-3. **After transactions confirm**, poll for arrival:
-   \`\`\`bash
-   jv deposit poll --recipient <recipient> --token jusdc
-   \`\`\`
-   Use the \`recipient\` from step 1 output.
-4. Tell the user: "Deposit completed. Your tokens have arrived on JasperVault."
-`;
-// ---------------------------------------------------------------------------
-// references/trading.md — margin, orders, reduce/close, TP/SL, price
-// ---------------------------------------------------------------------------
-const TRADING_REFERENCE = `# Trading Commands
-## Getting Market Price
-MUST use before any price-dependent operation (opening position by asset quantity, calculating PnL).
-\`\`\`bash
-jv price --symbol JBTC --pretty
-jv price --symbol CBBTC --pretty
-\`\`\`
-Output:
-\`\`\`json
-{"symbol":"JBTC","price":"87295.123456","priceWei":"87295123456000000000000","source":"quote_center","timestamp":"2026-03-05T10:30:00.000Z"}
-\`\`\`
-Use the \`price\` field (human-readable USD value) for display and calculations. This command does NOT require vault initialization — it can be run anytime.
-## How \`--margin\` Works
-\`--margin\` = the **actual collateral (margin) in USDC** you deposit. The CLI internally multiplies by leverage to compute the notional position size.
-| Concept | Formula | Example |
-|---------|---------|---------|
-| Notional value | \`margin × leverage\` | 60 USDC × 50x = $3,000 |
-| Position size | \`notional / current_price\` | $3,000 / $70,000 = 0.0428 JBTC |
-### Translating user intent to \`--margin\`:
-| User says | Calculation | Pass to CLI |
-|-----------|-------------|-------------|
-| "long with $60 USDC margin at 50x" | already the margin | \`--margin 60\` |
-| "open a $3,000 notional position at 50x" | margin = 3000 / 50 = 60 | \`--margin 60\` |
-| "long 0.1 BTC at 50x" | margin = (0.1 × current_price) / 50 | \`--margin <result>\` |
-CRITICAL: When the user specifies an asset amount (e.g. "0.1 BTC"), you MUST first run \`jv price --symbol JBTC --pretty\` to get the current price, then compute \`notional = size × price\`, then \`margin = notional / leverage\`.
-## Creating Orders
-\`\`\`bash
-# Market order: Long JBTC, 60 USDC margin at 50x (= $3,000 notional)
-jv order create --side long --symbol JBTC --margin 60 --leverage 50 --network jaspervault
-# Market order: Short JBTC, 100 USDC margin at 50x (= $5,000 notional)
-jv order create --side short --symbol JBTC --margin 100 --leverage 50 --network jaspervault
-# Limit order: add --limit-price
-jv order create --side long --symbol JBTC --margin 60 --leverage 50 --limit-price 65000 --network jaspervault
-\`\`\`
-The CLI signs the order internally using the delegation wallet. No pre-signed payload required.
-On success, a market order returns \`jobId\`; a limit order returns \`limitOrderId\`.
-## Reducing / Closing a Position
-Create an **opposite-side order** with the margin portion you want to close. The system automatically detects existing positions and performs a partial close.
-1. Query current position: \`jv orders list --pretty\`
-2. Read the \`margin\` field directly from output (e.g. 60 USDC)
-3. To close half: \`close_margin = margin / 2\` (e.g. 30 USDC)
-4. Create opposite-side order with that margin value
-**Reduce LONG by half (30 USDC margin):**
-\`\`\`bash
-jv order create --side short --symbol JBTC --margin 30 --leverage 50 --network jaspervault
-\`\`\`
-**Close entire LONG (60 USDC margin):**
-\`\`\`bash
-jv order create --side short --symbol JBTC --margin 60 --leverage 50 --network jaspervault
-\`\`\`
-IMPORTANT: The \`--margin\` for reduction = the margin portion you want to close (read directly from \`jv orders list\` output \`margin\` field).
-## Setting Take-Profit
-\`\`\`bash
-jv tp set --order-id <orderId> --price <usdc_price> --symbol <symbol> --network jaspervault
-\`\`\`
-Example: \`jv tp set --order-id 99 --price 105000 --symbol JBTC --network jaspervault\`
-Returns \`limitOrderId\` on success.
-## Setting Stop-Loss
-\`\`\`bash
-jv sl set --order-id <orderId> --price <usdc_price> --symbol <symbol> --network jaspervault
-\`\`\`
-Example: \`jv sl set --order-id 99 --price 90000 --symbol JBTC --network jaspervault\`
-Returns \`limitOrderId\` on success.
-## PPO Hedge Protection
-There are TWO different commands depending on the scenario:
-| Scenario | Command | Backend Operation |
-|----------|---------|-------------------|
-| Add protection to **existing position** (no size change) | \`jv order protect --order-id <id>\` | CREATE_OPTION |
-| Open new position **with** protection | \`jv order create --ppo ...\` | CREATE_WITH_OPTION |
-| Add size to position **with** protection | \`jv order create --ppo ...\` (same side) | ADD_SIZE_OPTION |
-### Decision Rule (CRITICAL)
-**If the user ALREADY HAS a position and only wants to add/renew hedge protection — use \`jv order protect\`.** Do NOT use \`jv order create --ppo\` for this, as it will add unwanted position size.
-Only use \`jv order create --ppo\` when the user explicitly wants to open a new position or add size AND include protection at the same time.
-### Adding Protection to Existing Position
-\`\`\`bash
-jv order protect --order-id <id> --symbol <symbol> [options] --network jaspervault
-\`\`\`
-**Required**: \`--order-id\` (from \`jv orders list\`) and \`--symbol\`.
-**Options:**
-| Flag | Values | Default | Description |
-|------|--------|---------|-------------|
-| \`--ppo-expire\` | \`30m\` or \`8h\` | \`30m\` | Option duration |
-| \`--ppo-category\` | \`ATM\` or \`OTM\` | \`ATM\` | ATM = strike at market price; OTM = strike offset |
-| \`--ppo-tier\` | \`1-5\` | (required for OTM) | OTM offset: 1=0.1%, 2=0.2%, 3=0.3%, 4=0.4%, 5=0.5% |
-**Examples:**
-\`\`\`bash
-# ATM protection on existing order #99, 30 min (default)
-jv order protect --order-id 99 --symbol JBTC --network jaspervault
-# ATM protection, 8 hours
-jv order protect --order-id 99 --symbol JBTC --ppo-expire 8h --network jaspervault
-# OTM protection, tier 3
-jv order protect --order-id 99 --symbol JBTC --ppo-category OTM --ppo-tier 3 --network jaspervault
-\`\`\`
-**Typical flow:**
-1. \`jv orders list --pretty\` → find the order ID
-2. \`jv order protect --order-id <id> --symbol JBTC --network jaspervault\`
-### Opening/Adding Position WITH Protection
-Add \`--ppo\` to \`jv order create\` when creating a new position or adding size with simultaneous protection:
-\`\`\`bash
-# New position with ATM protection
-jv order create --side long --symbol JBTC --margin 60 --leverage 50 --ppo --network jaspervault
-# New position with 8h ATM protection
-jv order create --side long --symbol JBTC --margin 60 --leverage 50 --ppo --ppo-expire 8h --network jaspervault
-# New position with OTM protection
-jv order create --side long --symbol JBTC --margin 60 --leverage 50 --ppo --ppo-category OTM --ppo-tier 5 --network jaspervault
-\`\`\`
-### PPO Parameters (shared by both commands)
-| Flag | Values | Default | Description |
-|------|--------|---------|-------------|
-| \`--ppo-expire\` | \`30m\` or \`8h\` | \`30m\` | Option duration |
-| \`--ppo-category\` | \`ATM\` or \`OTM\` | \`ATM\` | ATM = strike at market price; OTM = strike offset |
-| \`--ppo-tier\` | \`1-5\` | (required for OTM) | OTM offset: 1=0.1%, 2=0.2%, 3=0.3%, 4=0.4%, 5=0.5% |
-**AI agent behavior when user wants OTM:**
-1. First run \`jv price --symbol JBTC --pretty\` to get current price
-2. Calculate strike for each tier based on position side:
-   - LONG (PUT hedge): \`strike = price × (1 - tier_ratio)\`
-   - SHORT (CALL hedge): \`strike = price × (1 + tier_ratio)\`
-3. Present options: "Tier 1: $87,208 (0.1%), Tier 2: $87,121 (0.2%), ..., Tier 5: $86,860 (0.5%)"
-4. User picks tier → use \`--ppo-tier N\`
-**Intent mapping:**
-- User says "加保护" / "开保护" / "对冲" / "hedge" / "protect" on an **existing position** → \`jv order protect --order-id <id>\`
-- User says "开仓 + 加保护" / "open with protection" → \`jv order create --ppo\`
-- User says "加仓 + 加保护" / "add size with protection" → \`jv order create --ppo\` (same side)
-- User says "8 hour" / "8小时" → \`--ppo-expire 8h\`
-- User says "OTM" / "价外" → \`--ppo-category OTM\`, then present tier options
-- User says "ATM" / "平价" or nothing → default ATM, 30 min
-- User says "取消PPO" / "cancel PPO" / "取消保护" / "关闭对冲" / "remove hedge" → perform a position operation WITHOUT \`--ppo\`; the existing hedge option is auto-cancelled by the contract
-## PPO Cancellation (IMPORTANT — read before any reduce/close/add with PPO)
-The smart contract **automatically cancels** existing PPO hedge options when you execute any position operation (reduce, close, add size) **without** the \`--ppo\` flag. There is **NO separate "cancel PPO" command**.
-| User Request | Correct Action | Commands |
-|--------------|---------------|----------|
-| "减仓一半 + 取消PPO" | Single reduce order without \`--ppo\` | \`jv order create --side <opposite> --margin <half> --leverage 50 --network jaspervault\` |
-| "加仓 + 取消PPO" | Single add-size order without \`--ppo\` | \`jv order create --side <same> --margin <amount> --leverage 50 --network jaspervault\` |
-| "平仓" (full close) | Close order without \`--ppo\` | \`jv order create --side <opposite> --margin <full> --leverage 50 --network jaspervault\` |
-| "减仓一半 + 保留PPO" | Reduce order WITH \`--ppo\` | \`jv order create --side <opposite> --margin <half> --leverage 50 --ppo --network jaspervault\` |
-**NEVER do this:**
-- Do NOT try to cancel PPO as a separate step after reducing/closing a position. There is no "cancel PPO" command, and attempting workarounds (e.g. sending an extra opposite-side order) will cause unintended position closures.
-- Do NOT send two orders when one suffices. "减仓 + 取消PPO" = ONE order without \`--ppo\`.
-`;
-// ---------------------------------------------------------------------------
-// references/queries.md — positions, job status, limit orders, output, errors
-// ---------------------------------------------------------------------------
-const QUERIES_REFERENCE = `# Queries, Output Interpretation & Error Handling
-## Querying Positions
-\`\`\`bash
-# List active positions (default — use for "current positions")
-jv orders list --pretty
-# Filter by side
-jv orders list --position-side LONG
-# Include closed/historical orders
-jv orders list --all --pretty
-# Filter by time range
-jv orders list --all --since 7d --pretty
-jv orders list --since 1w --pretty
-jv orders list --all --since 2025-01-01 --until 2025-01-31 --pretty
-# Get a specific position
-jv orders get <orderId>
-# Get overall statistics
-jv orders stats
-\`\`\`
-**Key output fields (human-readable, pre-converted from wei):**
-| Field | Description |
-|-------|-------------|
-| \`margin\` | Margin deposited in USDC (e.g. \`"60.000000"\`) |
-| \`size\` | Position size in underlying asset (e.g. \`"0.04386000"\` JBTC) |
-| \`entryPriceUsd\` | Entry price in USD (e.g. \`"68476.000000000000000000"\`) |
-| \`strikeAmountUsd\` | Strike amount in USD |
-| \`leverage\` | Leverage multiplier (e.g. \`"50"\`) |
-| \`createdTime\` | Creation time in ISO 8601 format |
-| \`positionSide\` | \`"LONG"\` or \`"SHORT"\` |
-| \`isActive\` | \`true\` = open position, \`false\` = closed |
-| \`id\` | Order ID (use for TP/SL commands) |
-To calculate notional from output: \`notional = margin × leverage\` (or \`size × current_price\`)
-**Pagination:** use \`--page\` and \`--limit\` (e.g. \`jv orders list --page 2 --limit 10\`).
-## Calculating Unrealized PnL
-When the user asks about profit/loss, portfolio value, or position health, you MUST fetch the current price first:
-| Step | Formula |
-|------|---------|
-| 1. Get current price | \`jv price --symbol JBTC --pretty\` → read \`price\` field |
-| 2. Get position data | \`jv orders list --pretty\` → read \`size\`, \`entryPriceUsd\`, \`margin\`, \`positionSide\` |
-| 3. Compute PnL (LONG) | \`unrealizedPnL = size × (currentPrice − entryPrice)\` |
-| 3. Compute PnL (SHORT) | \`unrealizedPnL = size × (entryPrice − currentPrice)\` |
-| 4. PnL percentage | \`pnlPercent = unrealizedPnL / margin × 100%\` |
-| 5. Effective leverage | \`leveragedPnlPercent = priceChangePercent × leverage\` |
-Example: LONG 0.0428 JBTC, entry $70,000, current $71,000, margin 60 USDC
-- PnL = 0.0428 × (71000 − 70000) = +$42.80
-- PnL% = 42.80 / 60 = +71.3%
-IMPORTANT: NEVER guess or estimate the current price. ALWAYS use \`jv price\` to get the real-time price.
-## Job Status
-\`\`\`bash
-jv job status <jobId> --pretty
-\`\`\`
-Key fields: \`status\` ("completed", "failed", "active", "waiting"), \`result.transactionHash\`, \`result.operationType\` (CREATE, ADD_SIZE, CLOSE_SIZE, etc.).
-## Market Order Output (IMPORTANT — two JSON lines)
-\`jv order create\` for market orders prints **two JSON lines sequentially**:
-**Line 1 — Order submitted:**
-\`\`\`json
-{"success":true,"orderType":"market","jobId":"MARKET_ORDER_xxx","statusUrl":"/api/job/status/...","streamUrl":"/api/job/stream/..."}
-\`\`\`
-**Line 2 — Execution result (auto-waits up to 60s):**
-\`\`\`json
-{"jobId":"MARKET_ORDER_xxx","status":"completed","transactionHash":"0x..."}
-\`\`\`
-**CRITICAL RULES after order execution:**
-1. If \`status === "completed"\` → the order IS executed. Do NOT retry or place another order.
-2. If \`status === "failed"\` → report the error.
-3. If \`status === "timeout"\` → use \`jv job status <jobId>\` to check later.
-4. The \`operation\` field (if present) contains raw on-chain data in wei format — do NOT try to interpret it.
-5. **To verify the actual position**, always run \`jv orders list --pretty\` and read the human-readable fields.
-6. Report to the user: "Order executed successfully. Tx: {transactionHash}. Let me check your updated position..." then run \`jv orders list --pretty\`.
-**Limit order output:**
-\`\`\`json
-{"success":true,"orderType":"limit","limitOrderId":"0x..."}
-\`\`\`
-Tell the user: "Limit order placed. ID: {limitOrderId}."
-## Managing Limit Orders
-\`\`\`bash
-# List limit orders for a wallet
-jv limit-order list --wallet <address>
-# Filter by status
-jv limit-order list --wallet <address> --status PENDING
-# Check a specific limit order
-jv limit-order status <limitOrderId>
-# Cancel a limit order
-jv limit-order cancel <limitOrderId>
-\`\`\`
-Possible statuses: PENDING, TRIGGERED, EXECUTING, COMPLETED, FAILED, EXPIRED, CANCELLED.
-## Error Handling
-| Exit Code | Meaning | Action |
-|-----------|---------|--------|
-| 1 | Configuration error (e.g. delegation key not found) | Run \`jv vault setup\` first |
-| 2 | Network/HTTP error | Tell user the service may be unreachable |
-| 3 | Business error (duplicate order, invalid params) | Read stderr, relay message |
-When an error occurs, stderr contains the error message. Never expose raw stack traces or internal URLs to the user.
-`;
-// ---------------------------------------------------------------------------
-// scripts/check-init.sh
-// ---------------------------------------------------------------------------
-const CHECK_INIT_SCRIPT = `#!/usr/bin/env bash
-# Quick vault initialization check — exits 0 if ready, non-zero otherwise
-jv orders list --pretty 2>/dev/null
-exit $?
-`;
+const CONTENT_DIR = join(__dirname, 'skill-content');
+function readContent(relativePath) {
+    return readFileSync(join(CONTENT_DIR, relativePath), 'utf-8');
+}
 // ---------------------------------------------------------------------------
 // Platform-specific frontmatter
 // ---------------------------------------------------------------------------
-function getOpenClawFrontmatter() {
-    return `---
-name: jasper-vault-cli
-description: "Trade perpetual contracts (perps) on JasperVault — open/close positions, set TP/SL, manage limit orders, deposit, and query portfolio via the \`jv\` CLI. Initialize wallet via WalletConnect QR scan (no private key needed). 在 JasperVault 上交易永续合约 — 做多做空、开仓平仓、止盈止损、限价单、持仓查询、充值，使用 WalletConnect 扫码初始化（无需私钥）。"
-trigger: "jaspervault|jasper vault|jasper trading|jv|jv trade|jv order|在jasper交易|jasper 交易|初始化钱包|连接钱包|开仓|平仓|做多|做空|止盈|止损|查看持仓|永续合约"
-tools: [shell, process]
-metadata:
-  openclaw:
-    requires:
-      bins:
-        - jv
----
-`;
-}
-function getClaudeFrontmatter() {
-    return `---
-name: jasper-vault-cli
-description: "Trade perpetual contracts (perps) on JasperVault — open/close positions, set TP/SL, manage limit orders, deposit, and query portfolio via the \`jv\` CLI. Initialize wallet via WalletConnect QR scan (no private key needed)."
----
-`;
+function getFrontmatter(platform) {
+    switch (platform) {
+        case 'openclaw':
+            return readContent('frontmatter/openclaw.md');
+        case 'claude':
+            return readContent('frontmatter/claude.md');
+        case 'cursor':
+            return ''; // Cursor uses no frontmatter, just the heading
+        default:
+            throw new Error(`Unknown platform: ${platform}`);
+    }
 }
 // ---------------------------------------------------------------------------
 // Public API
@@ -523,26 +61,21 @@ description: "Trade perpetual contracts (perps) on JasperVault — open/close po
  * @param platform - One of: openclaw, cursor, claude
  */
 export function buildSkillContent(platform) {
+    const coreBody = readContent('SKILL.core.md').replace(/\{\{CLI_VERSION\}\}/g, CLI_VERSION);
+    const frontmatter = getFrontmatter(platform);
     let skillMd;
-    switch (platform) {
-        case 'openclaw':
-            skillMd = getOpenClawFrontmatter() + '\n# JasperVault Trading Skill\n\n' + SKILL_CORE_BODY;
-            break;
-        case 'claude':
-            skillMd = getClaudeFrontmatter() + '\n# JasperVault Trading Skill\n\n' + SKILL_CORE_BODY;
-            break;
-        case 'cursor':
-            skillMd = '# jasper-vault-cli\n\n' + SKILL_CORE_BODY;
-            break;
-        default:
-            throw new Error(`Unknown platform: ${platform}`);
+    if (platform === 'cursor') {
+        skillMd = '# jasper-vault-cli\n\n' + coreBody;
+    }
+    else {
+        skillMd = frontmatter + '\n' + coreBody;
     }
     return {
         'SKILL.md': skillMd,
-        'references/onboarding.md': ONBOARDING_REFERENCE,
-        'references/trading.md': TRADING_REFERENCE,
-        'references/queries.md': QUERIES_REFERENCE,
-        'scripts/check-init.sh': CHECK_INIT_SCRIPT,
+        'references/onboarding.md': readContent('references/onboarding.md'),
+        'references/trading.md': readContent('references/trading.md'),
+        'references/queries.md': readContent('references/queries.md'),
+        'scripts/check-init.sh': readContent('scripts/check-init.sh'),
     };
 }
 //# sourceMappingURL=skill-body.js.map

package/dist/src/templates/skill-body.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"skill-body.js","sourceRoot":"","sources":["../../../src/templates/skill-body.ts"],"names":[],"mappings":"AAAA~~;;;;;;GAMG~~;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CACzC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAAE,OAAO,CAAC,CACzC,CAAC;AAEzB,sEAAsE;AACtE,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;wBAcE,WAAW;;CAElC,CAAC,IAAI,EAAE,CAAC;AAIT,8EAA8E;AAC9E,~~4EAA4E~~;~~AAC5E~~,8EAA8E;AAE9E,MAAM,~~eAAe~~,GAAG~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CvB~~,CAAC,~~IAAI~~,EAAE,CAAC~~;AAET~~,~~8EAA8E~~;~~AAC9E,+DAA+D;AAC/D~~,~~8EAA8E~~;~~AAE9E~~,~~MAAM~~,~~oBAAoB~~,~~GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkE5B~~,CAAC~~;AAEF~~,~~8EAA8E;AAC9E~~,~~qEAAqE;AACrE~~,~~8EAA8E;AAE9E~~,~~MAAM~~,~~iBAAiB~~,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwMzB,CAAC;~~AAEF~~,~~8EAA8E~~;~~AAC9E~~,8EAA8E;AAC9E,8EAA8E;AAE9E,~~MAAM~~,~~iBAAiB~~,~~GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+HzB,~~CAAC~~;AAEF~~,~~8EAA8E~~;~~AAC9E~~,~~wBAAwB~~;~~AACxB~~,~~8EAA8E~~;~~AAE9E~~,~~MAAM~~,~~iBAAiB~~,~~GAAG;;;;CAIzB~~,CAAC~~;AAEF~~,~~8EAA8E~~;~~AAC9E~~,~~gCAAgC~~;~~AAChC~~,~~8EAA8E~~;~~AAE9E~~,~~SAAS~~,~~sBAAsB~~;~~IAC7B~~,OAAO~~;;;;;;;;;;;CAWR~~,CAAC~~;AACF~~,CAAC;~~AAED~~,~~SAAS~~,~~oBAAoB;IAC3B~~,~~OAAO;;;;CAIR~~,CAAC;~~AACF~~,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,~~IAAI~~,~~OAAe~~,~~CAAC;IAEpB~~,~~QAAQ~~,~~QAAQ~~,~~EAAE~~,CAAC~~;QACjB~~,~~KAAK~~,~~UAAU;YACb,~~OAAO,~~GAAG~~,sBAAsB,EAAE,~~GAAG~~,~~mCAAmC~~,~~GAAG,eAAe,~~CAAC;~~YAC3F~~,MAAM~~;QACR~~,~~KAAK~~,~~QAAQ;YACX~~,~~OAAO~~,~~GAAG~~,~~oBAAoB~~,~~EAAE~~,~~GAAG~~,~~mCAAmC~~,~~GAAG~~,~~eAAe,~~CAAC;~~YACzF~~,~~MAAM;QACR~~,KAAK,QAAQ;~~YACX~~,OAAO,GAAG,wBAAwB,GAAG,~~eAAe~~,CAAC;~~YACrD~~,~~MAAM~~;~~QACR~~;~~YACE~~,~~MAAM~~,~~IAAI~~,~~KAAK~~,~~CAAC~~,~~qBAAqB~~,QAAQ,~~EAAE,~~CAAC~~,CAAC~~;~~IACrD~~,CAAC;IAED,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,0BAA0B,EAAE,~~oBAAoB~~;~~QAChD~~,uBAAuB,EAAE,~~iBAAiB~~;~~QAC1C~~,uBAAuB,EAAE,~~iBAAiB~~;~~QAC1C~~,uBAAuB,EAAE,~~iBAAiB~~;~~KAC3C~~,CAAC;AACJ,CAAC"}
1	+ {"version":3,"file":"skill-body.js","sourceRoot":"","sources":["../../../src/templates/skill-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CACzC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAAE,OAAO,CAAC,CACzC,CAAC;AAEzB,sEAAsE;AACtE,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;wBAcE,WAAW;;CAElC,CAAC,IAAI,EAAE,CAAC;AAIT,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAE9E,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAErD,SAAS,WAAW,CAAC,YAAoB;IACvC,OAAO,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,SAAS,cAAc,CAAC,QAAgB;IACtC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC,yBAAyB,CAAC,CAAC;QAChD,KAAK,QAAQ;YACX,OAAO,WAAW,CAAC,uBAAuB,CAAC,CAAC;QAC9C,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC,CAAC,+CAA+C;QAC5D;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;IAC3F,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,OAAe,CAAC;IACpB,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,GAAG,wBAAwB,GAAG,QAAQ,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,WAAW,GAAG,IAAI,GAAG,QAAQ,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,0BAA0B,EAAE,WAAW,CAAC,0BAA0B,CAAC;QACnE,uBAAuB,EAAE,WAAW,CAAC,uBAAuB,CAAC;QAC7D,uBAAuB,EAAE,WAAW,CAAC,uBAAuB,CAAC;QAC7D,uBAAuB,EAAE,WAAW,CAAC,uBAAuB,CAAC;KAC9D,CAAC;AACJ,CAAC"}

package/dist/src/templates/skill-content/SKILL.core.md ADDED Viewed

@@ -0,0 +1,51 @@
+# JasperVault Trading Skill
+Trade perpetual contracts on JasperVault via the `jv` CLI (v{{CLI_VERSION}}). No private key is ever required.
+## CRITICAL RULES (MUST FOLLOW — violations cause broken UX)
+1. **WalletConnect ONLY**: ALWAYS use `jv vault setup`. NEVER suggest `jv vault init` (private-key mode). NEVER ask the user to set `PRIVATE_KEY`.
+2. **QR Code Display**: When `jv vault setup` outputs JSON with a `qrCodeUrl` field, you MUST display the `qrCodeUrl` value as a clickable link to the user. This is the only QR code field in the output — there are no other QR representations.
+3. **Long-running Commands**: `jv vault setup` is a long-running command (up to 2 min) that will be auto-backgrounded. After it backgrounds you receive a `sessionId` and the first JSON output (QR code). Show the QR link to the user, then poll every 15 seconds with `process poll` using that `sessionId` until you see the second JSON line containing `"success":true` or the process exits. See [references/onboarding.md](references/onboarding.md) for the full step-by-step flow.
+4. **Real-time Prices**: NEVER guess or estimate prices. ALWAYS run `jv price --symbol JBTC --pretty` before any price-dependent operation (opening a position by asset quantity, calculating PnL).
+5. **PPO Auto-Cancellation**: When performing any position operation (reduce, close, add size) WITHOUT `--ppo`, the smart contract automatically cancels existing PPO hedge options. There is NO separate "cancel PPO" command. NEVER attempt a separate cancellation — it risks unintended position closures.
+6. **Standalone PPO Protection**: To add hedge protection to an **existing position**, use `jv order protect --order-id <id> --symbol <symbol>`. Do NOT use `jv order create --ppo` for this — that command ADDS POSITION SIZE. `jv order create --ppo` is ONLY for opening new positions or adding size with protection. See [references/trading.md](references/trading.md) for details.
+7. **Market Order Output**: `jv order create` (market) prints TWO JSON lines — first the submission, then the execution result (auto-waits up to 60s). If `status === "completed"`, the order IS executed. Do NOT retry or place another order. See [references/trading.md](references/trading.md).
+8. **Deposit via WalletConnect**: `jv deposit` auto-detects signing mode. Without `PRIVATE_KEY`, it uses WalletConnect (QR scan). Follow the same QR display rules as `jv vault setup`. See [references/onboarding.md](references/onboarding.md).
+## Activation Behavior
+1. Check if vault is initialized: `jv orders list --pretty`
+2. If the command fails (exit code 1, or errors like "delegation key not found" / "vault not initialized" / "no profile"):
+   - Tell the user: "Your vault is not initialized yet. Let me set it up via WalletConnect — no private key needed."
+   - Immediately run `jv vault setup --network jaspervault --timeout 120`.
+   - Follow the QR code display instructions in [references/onboarding.md](references/onboarding.md).
+3. If the command succeeds → vault is ready. Proceed with the user's request.
+## Intent → Command Reference
+| User Intent | Command | Details |
+|-------------|---------|---------|
+| Initialize / connect wallet | `jv vault setup` | [references/onboarding.md](references/onboarding.md) |
+| Deposit tokens from Base | `jv deposit --token <T> --amount <N>` | [references/onboarding.md](references/onboarding.md) |
+| Get current price | `jv price --symbol JBTC --pretty` | [references/queries.md](references/queries.md) |
+| Open position (market) | `jv order create --side long/short -m <usdc> --symbol JBTC` | [references/trading.md](references/trading.md) |
+| Open position (limit) | `jv order create ... --limit-price <N>` | [references/trading.md](references/trading.md) |
+| Reduce / close position | opposite-side `jv order create` | [references/trading.md](references/trading.md) |
+| Add size to position | same-side `jv order create` | [references/trading.md](references/trading.md) |
+| Set take-profit | `jv tp set --order-id <ID> --price <P> --symbol <S>` | [references/trading.md](references/trading.md) |
+| Set stop-loss | `jv sl set --order-id <ID> --price <P> --symbol <S>` | [references/trading.md](references/trading.md) |
+| Add PPO to existing position | `jv order protect --order-id <id> --symbol <S>` | [references/trading.md](references/trading.md) |
+| Open/add-size with PPO | add `--ppo` to `jv order create` | [references/trading.md](references/trading.md) |
+| Cancel PPO / remove hedge | order without `--ppo` (auto-cancels) | [references/trading.md](references/trading.md) |
+| Query positions / portfolio | `jv orders list --pretty` | [references/queries.md](references/queries.md) |
+| Get specific position | `jv orders get <orderId> --pretty` | [references/queries.md](references/queries.md) |
+| Portfolio statistics | `jv orders stats --pretty` | [references/queries.md](references/queries.md) |
+| Job execution status | `jv job status <jobId> --pretty` | [references/queries.md](references/queries.md) |
+| Manage limit orders | `jv limit-order list/status/cancel` | [references/queries.md](references/queries.md) |
+## Security
+- Never log or display private keys, signatures, or API keys.
+- The CLI signs orders via the delegation wallet in `~/.jaspervault/keys.json`.
+- Do NOT ask the user to set `PRIVATE_KEY`.

package/dist/src/templates/skill-content/frontmatter/claude.md ADDED Viewed

@@ -0,0 +1,4 @@
+---
+name: jasper-vault-cli
+description: "Trade perpetual contracts (perps) on JasperVault — open/close positions, set TP/SL, manage limit orders, deposit, and query portfolio via the `jv` CLI. Initialize wallet via WalletConnect QR scan (no private key needed)."
+---

package/dist/src/templates/skill-content/frontmatter/cursor.md ADDED Viewed

File without changes

package/dist/src/templates/skill-content/frontmatter/openclaw.md ADDED Viewed

@@ -0,0 +1,11 @@
+---
+name: jasper-vault-cli
+description: "Trade perpetual contracts (perps) on JasperVault — open/close positions, set TP/SL, manage limit orders, deposit, and query portfolio via the `jv` CLI. Initialize wallet via WalletConnect QR scan (no private key needed). 在 JasperVault 上交易永续合约 — 做多做空、开仓平仓、止盈止损、限价单、持仓查询、充值，使用 WalletConnect 扫码初始化（无需私钥）。"
+trigger: "jaspervault|jasper vault|jasper trading|jv|jv trade|jv order|在jasper交易|jasper 交易|初始化钱包|连接钱包|开仓|平仓|做多|做空|止盈|止损|查看持仓|永续合约"
+tools: [shell, process]
+metadata:
+  openclaw:
+    requires:
+      bins:
+        - jv
+---