@spfunctions/cli 1.7.14 → 1.7.17

package/dist/commands/context.d.ts

@@ -1,5 +1,6 @@
 export declare function contextCommand(id: string | undefined, opts: {
     json?: boolean;
+    share?: boolean;
     apiKey?: string;
     apiUrl?: string;
 }): Promise<void>;

package/dist/commands/context.js

@@ -4,6 +4,7 @@ exports.contextCommand = contextCommand;
 const client_js_1 = require("../client.js");
 const kalshi_js_1 = require("../kalshi.js");
 const utils_js_1 = require("../utils.js");
+const share_js_1 = require("../share.js");
 const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
 async function contextCommand(id, opts) {
     // ── Mode 1: No thesis ID → global market intelligence ─────────────────────
@@ -14,6 +15,10 @@ async function contextCommand(id, opts) {
             return;
         }
         const data = await res.json();
+        if (opts.share) {
+            await (0, share_js_1.shareOutput)('context', '', data);
+            return;
+        }
         if (opts.json) {
             console.log(JSON.stringify(data, null, 2));
             return;

package/dist/commands/edges.d.ts

@@ -13,6 +13,7 @@
  */
 interface EdgesOpts {
     json?: boolean;
+    share?: boolean;
     limit?: string;
     thesis?: string;
     minEdge?: string;

package/dist/commands/edges.js

@@ -17,6 +17,7 @@ exports.edgesCommand = edgesCommand;
 const client_js_1 = require("../client.js");
 const kalshi_js_1 = require("../kalshi.js");
 const utils_js_1 = require("../utils.js");
+const share_js_1 = require("../share.js");
 async function edgesCommand(opts) {
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
     const limit = parseInt(opts.limit || '20');
@@ -141,14 +142,19 @@ async function edgesCommand(opts) {
     }
     // Apply limit
     const display = merged.slice(0, limit);
-    // ── Step 6: JSON output ────────────────────────────────────────────────────
+    // ── Step 6: JSON / share output ────────────────────────────────────────────
+    const outputData = {
+        totalEdges: merged.length,
+        displayed: display.length,
+        thesesScanned: theses.length,
+        edges: display,
+    };
+    if (opts.share) {
+        await (0, share_js_1.shareOutput)('edges', '', outputData);
+        return;
+    }
     if (opts.json) {
-        console.log(JSON.stringify({
-            totalEdges: merged.length,
-            displayed: display.length,
-            thesesScanned: theses.length,
-            edges: display,
-        }, null, 2));
+        console.log(JSON.stringify(outputData, null, 2));
         return;
     }
     // ── Step 6: Pretty output ──────────────────────────────────────────────────

package/dist/commands/explore.d.ts

@@ -10,4 +10,5 @@
  */
 export declare function exploreCommand(slug?: string, opts?: {
     json?: boolean;
+    share?: boolean;
 }): Promise<void>;

package/dist/commands/explore.js

@@ -11,6 +11,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.exploreCommand = exploreCommand;
+const share_js_1 = require("../share.js");
 const BASE_URL = 'https://simplefunctions.dev';
 async function exploreCommand(slug, opts) {
     if (!slug) {
@@ -21,6 +22,10 @@ async function exploreCommand(slug, opts) {
             return;
         }
         const { theses } = await res.json();
+        if (opts?.share) {
+            await (0, share_js_1.shareOutput)('explore', '', { theses });
+            return;
+        }
         if (opts?.json) {
             console.log(JSON.stringify(theses, null, 2));
             return;

package/dist/commands/markets.d.ts

@@ -6,4 +6,5 @@
  */
 export declare function marketsCommand(opts?: {
     json?: boolean;
+    share?: boolean;
 }): Promise<void>;

package/dist/commands/markets.js

@@ -7,6 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.marketsCommand = marketsCommand;
+const share_js_1 = require("../share.js");
 const BASE_URL = 'https://simplefunctions.dev';
 async function marketsCommand(opts) {
     const res = await fetch(`${BASE_URL}/api/public/markets`);
@@ -15,6 +16,10 @@ async function marketsCommand(opts) {
         return;
     }
     const data = await res.json();
+    if (opts?.share) {
+        await (0, share_js_1.shareOutput)('markets', '', data);
+        return;
+    }
     if (opts?.json) {
         console.log(JSON.stringify(data, null, 2));
         return;

package/dist/commands/query.d.ts

@@ -10,5 +10,6 @@
  */
 export declare function queryCommand(q: string, opts?: {
     json?: boolean;
+    share?: boolean;
     limit?: string;
 }): Promise<void>;

package/dist/commands/query.js

@@ -11,7 +11,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.queryCommand = queryCommand;
-const BASE_URL = 'https://simplefunctions.dev';
+const share_js_1 = require("../share.js");
+const BASE_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
 async function queryCommand(q, opts) {
     const limit = opts?.limit || '10';
     const url = `${BASE_URL}/api/public/query?q=${encodeURIComponent(q)}&limit=${limit}`;
@@ -27,6 +28,10 @@ async function queryCommand(q, opts) {
         return;
     }
     const data = await res.json();
+    if (opts?.share) {
+        await (0, share_js_1.shareOutput)('query', q, data);
+        return;
+    }
     if (opts?.json) {
         console.log(JSON.stringify(data, null, 2));
         return;

package/dist/commands/scan.d.ts

@@ -3,6 +3,7 @@ interface ScanOpts {
     market?: string;
     venue?: string;
     json?: boolean;
+    share?: boolean;
     apiKey?: string;
     apiUrl?: string;
 }

package/dist/commands/scan.js

@@ -4,6 +4,7 @@ exports.scanCommand = scanCommand;
 const client_js_1 = require("../client.js");
 const polymarket_js_1 = require("../polymarket.js");
 const utils_js_1 = require("../utils.js");
+const share_js_1 = require("../share.js");
 // SF API base — scan goes through the server which holds the proxy key
 const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
 async function scanCommand(query, opts) {
@@ -18,7 +19,7 @@ async function scanCommand(query, opts) {
         return;
     }
     // Mode 3: keyword scan across all series + Polymarket
-    await keywordScan(query, opts.json, opts.venue || 'all');
+    await keywordScan(query, opts.json, opts.venue || 'all', opts.share);
 }
 async function showMarket(ticker, json) {
     console.log(`${utils_js_1.c.dim}Fetching market ${ticker}...${utils_js_1.c.reset}`);
@@ -80,7 +81,7 @@ async function showSeries(seriesTicker, json) {
         printMarketsTable(markets);
     }
 }
-async function keywordScan(query, json, venue = 'all') {
+async function keywordScan(query, json, venue = 'all', share) {
     // ── Polymarket search (runs in parallel with Kalshi) ───────────────────────
     const polyPromise = (venue === 'kalshi')
         ? Promise.resolve([])
@@ -154,6 +155,10 @@ async function keywordScan(query, json, venue = 'all') {
     }
     const combined = [...allMarkets, ...polyMarkets];
     combined.sort((a, b) => b.liquidity - a.liquidity);
+    if (share) {
+        await (0, share_js_1.shareOutput)('scan', query, combined);
+        return;
+    }
     if (json) {
         console.log(JSON.stringify(combined, null, 2));
         return;

package/dist/commands/watch.d.ts

@@ -0,0 +1,19 @@
+/**
+ * sf watch
+ *
+ * Push-mode monitoring. Polls GET /api/changes?since= for server-side
+ * detected market changes. No client-side diffing — the server handles
+ * change detection every 15 minutes via the scan-prices cron.
+ *
+ * Usage:
+ *   sf watch "gold"              — Watch gold-related changes
+ *   sf watch "iran oil"          — Watch iran/oil changes
+ *   sf watch                     — Watch all market changes
+ *   sf watch --json              — JSON change events for piping
+ */
+interface WatchOpts {
+    interval?: string;
+    json?: boolean;
+}
+export declare function watchCommand(query: string | undefined, opts: WatchOpts): Promise<void>;
+export {};

package/dist/commands/watch.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * sf watch
+ *
+ * Push-mode monitoring. Polls GET /api/changes?since= for server-side
+ * detected market changes. No client-side diffing — the server handles
+ * change detection every 15 minutes via the scan-prices cron.
+ *
+ * Usage:
+ *   sf watch "gold"              — Watch gold-related changes
+ *   sf watch "iran oil"          — Watch iran/oil changes
+ *   sf watch                     — Watch all market changes
+ *   sf watch --json              — JSON change events for piping
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchCommand = watchCommand;
+const utils_js_1 = require("../utils.js");
+const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
+async function watchCommand(query, opts) {
+    const intervalSec = parseInt(opts.interval || '60');
+    const intervalMs = intervalSec * 1000;
+    const isJson = opts.json || false;
+    if (!isJson) {
+        console.log();
+        console.log(`  ${utils_js_1.c.bold}sf watch${utils_js_1.c.reset}${query ? ` "${query}"` : ''}`);
+        console.log(`  ${utils_js_1.c.dim}Polling /api/changes every ${intervalSec}s · Ctrl+C to stop${utils_js_1.c.reset}`);
+        console.log();
+    }
+    let lastSeen = new Date().toISOString();
+    // Handle Ctrl+C gracefully
+    process.on('SIGINT', () => {
+        if (!isJson) {
+            console.log(`\n  ${utils_js_1.c.dim}Watch stopped.${utils_js_1.c.reset}\n`);
+        }
+        process.exit(0);
+    });
+    // First poll: show recent changes from last hour
+    try {
+        const initialSince = new Date(Date.now() - 60 * 60 * 1000).toISOString();
+        const changes = await fetchChanges(initialSince, query);
+        if (changes.length > 0) {
+            if (!isJson) {
+                console.log(`  ${utils_js_1.c.dim}${ts()} Recent changes (last hour):${utils_js_1.c.reset}`);
+            }
+            const deduped = dedupeByTitle(changes);
+            for (const change of deduped) {
+                if (isJson) {
+                    console.log(JSON.stringify(change));
+                }
+                else {
+                    printChange(change);
+                }
+            }
+            lastSeen = changes[0].detectedAt;
+        }
+        else if (!isJson) {
+            console.log(`  ${utils_js_1.c.dim}${ts()} No recent changes. Watching...${utils_js_1.c.reset}`);
+        }
+    }
+    catch (err) {
+        if (!isJson) {
+            console.error(`  ${utils_js_1.c.dim}${ts()} Error: ${err.message}${utils_js_1.c.reset}`);
+        }
+    }
+    // Polling loop
+    while (true) {
+        await sleep(intervalMs);
+        try {
+            const changes = await fetchChanges(lastSeen, query);
+            const deduped = isJson ? changes : dedupeByTitle(changes);
+            for (const change of deduped) {
+                if (isJson) {
+                    console.log(JSON.stringify(change));
+                }
+                else {
+                    printChange(change);
+                }
+            }
+            if (changes.length > 0) {
+                lastSeen = changes[0].detectedAt;
+            }
+            else if (!isJson) {
+                process.stdout.write(`  ${utils_js_1.c.dim}${ts()} · no new changes${utils_js_1.c.reset}\r`);
+            }
+        }
+        catch (err) {
+            if (!isJson) {
+                console.error(`  ${utils_js_1.c.dim}${ts()} Error: ${err.message}${utils_js_1.c.reset}`);
+            }
+        }
+    }
+}
+// Group same-title same-type changes into one line (e.g. 12 FaZe CEO contracts → 1 line)
+function dedupeByTitle(changes) {
+    const groups = new Map();
+    for (const c of changes) {
+        const key = `${c.changeType}:${c.title}`;
+        const existing = groups.get(key);
+        if (existing) {
+            existing.count++;
+        }
+        else {
+            groups.set(key, { count: 1, representative: c });
+        }
+    }
+    return Array.from(groups.values()).map(({ count, representative }) => {
+        if (count > 1) {
+            return { ...representative, title: `${representative.title} (${count} contracts)` };
+        }
+        return representative;
+    });
+}
+async function fetchChanges(since, query) {
+    let url = `${SF_API_URL}/api/changes?since=${encodeURIComponent(since)}&limit=50`;
+    if (query)
+        url += `&q=${encodeURIComponent(query)}`;
+    const res = await fetch(url);
+    if (!res.ok)
+        return [];
+    const data = await res.json();
+    return data.changes || [];
+}
+function printChange(change) {
+    const time = ts();
+    const venue = change.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` :
+        change.venue === 'polymarket' ? `\x1b[35mP\x1b[39m` :
+            change.venue === 'traditional' ? `${utils_js_1.c.dim}$${utils_js_1.c.reset}` : '·';
+    switch (change.changeType) {
+        case 'new_contract':
+            console.log(`  ${time} ${venue} ${utils_js_1.c.green}+ NEW${utils_js_1.c.reset}  ${change.afterPrice}¢  ${change.title}`);
+            break;
+        case 'removed_contract':
+            console.log(`  ${time} ${venue} ${utils_js_1.c.red}− GONE${utils_js_1.c.reset}  ${change.title}`);
+            break;
+        case 'price_move': {
+            if (change.venue === 'traditional') {
+                const sign = (change.delta || 0) > 0 ? '+' : '';
+                const color = (change.delta || 0) > 0 ? utils_js_1.c.green : utils_js_1.c.red;
+                const beforeDollars = ((change.beforePrice || 0) / 100).toFixed(0);
+                const afterDollars = ((change.afterPrice || 0) / 100).toFixed(0);
+                console.log(`  ${time} ${venue} ${color}${sign}${change.delta}¢${utils_js_1.c.reset}  $${beforeDollars}→$${afterDollars}  ${change.title}`);
+            }
+            else {
+                const sign = (change.delta || 0) > 0 ? '+' : '';
+                const color = (change.delta || 0) > 0 ? utils_js_1.c.green : utils_js_1.c.red;
+                console.log(`  ${time} ${venue} ${color}${sign}${change.delta}¢${utils_js_1.c.reset}  ${change.beforePrice}→${change.afterPrice}¢  ${change.title}`);
+            }
+            break;
+        }
+    }
+}
+function ts() {
+    return new Date().toLocaleTimeString('en-US', { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' });
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}

package/dist/index.js

@@ -29,6 +29,7 @@ const create_js_1 = require("./commands/create.js");
 const signal_js_1 = require("./commands/signal.js");
 const evaluate_js_1 = require("./commands/evaluate.js");
 const scan_js_1 = require("./commands/scan.js");
+const watch_js_1 = require("./commands/watch.js");
 const positions_js_1 = require("./commands/positions.js");
 const edges_js_1 = require("./commands/edges.js");
 const agent_js_1 = require("./commands/agent.js");
@@ -99,12 +100,18 @@ const GROUPED_HELP = `
   \x1b[36mscan\x1b[39m "keywords"            Search Kalshi + Polymarket
   \x1b[36mscan\x1b[39m --series TICKER       Browse a Kalshi series
   \x1b[36medges\x1b[39m [--json]             Top edges across all theses
+  \x1b[36mwatch\x1b[39m [query]              Watch for market changes (e.g. sf watch "gold")
   \x1b[36mwhatif\x1b[39m <id>                What-if scenario analysis
   \x1b[36mliquidity\x1b[39m [topic]          Orderbook liquidity scanner
   \x1b[36mbook\x1b[39m <ticker> [ticker2...]  Orderbook depth for specific markets
   \x1b[36mexplore\x1b[39m [slug]             Browse public theses
   \x1b[36mforecast\x1b[39m <event>           Market distribution (P50/P75/P90)
 
+\x1b[1mShare\x1b[22m  \x1b[2m(any command with --share generates a short URL)\x1b[22m
+  \x1b[36mscan\x1b[39m "gold" --share        Share scan results
+  \x1b[36mquery\x1b[39m "fed rate" --share   Share query results
+  \x1b[36mcontext\x1b[39m --share            Share global context snapshot
+
 \x1b[1mPortfolio\x1b[22m
   \x1b[36mpositions\x1b[39m                  Kalshi + Polymarket positions
   \x1b[36mbalance\x1b[39m                    Account balance
@@ -312,9 +319,10 @@ program
     .command('context [id]')
     .description('Context snapshot. With ID: thesis-specific. Without: global market snapshot (no auth)')
     .option('--json', 'Output raw JSON')
+    .option('--share', 'Share output via short URL')
     .action(async (id, opts, cmd) => {
     const g = cmd.optsWithGlobals();
-    await run(() => (0, context_js_1.contextCommand)(id, { json: opts.json, apiKey: g.apiKey, apiUrl: g.apiUrl }));
+    await run(() => (0, context_js_1.contextCommand)(id, { json: opts.json, share: opts.share, apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
 // ── sf create <thesis> ────────────────────────────────────────────────────────
 program
@@ -376,6 +384,7 @@ program
     .option('--market <ticker>', 'Get single market detail (e.g. KXWTIMAX-26DEC31-T140)')
     .option('--venue <venue>', 'Filter by venue: kalshi, polymarket, or all (default: all)')
     .option('--json', 'Output raw JSON')
+    .option('--share', 'Share output via short URL')
     .action(async (query, opts, cmd) => {
     const g = cmd.optsWithGlobals();
     const q = query || '';
@@ -388,15 +397,26 @@ program
         market: opts.market,
         venue: opts.venue,
         json: opts.json,
+        share: opts.share,
         apiKey: g.apiKey,
         apiUrl: g.apiUrl,
     }));
 });
+// ── sf watch [query] ─────────────────────────────────────────────────────────
+program
+    .command('watch [query]')
+    .description('Watch for market changes (e.g. sf watch "gold")')
+    .option('--interval <seconds>', 'Poll interval in seconds (default: 60)', '60')
+    .option('--json', 'JSON change events (for piping)')
+    .action(async (query, opts) => {
+    await run(() => (0, watch_js_1.watchCommand)(query, { interval: opts.interval, json: opts.json }));
+});
 // ── sf edges ──────────────────────────────────────────────────────────────────
 program
     .command('edges')
     .description('Top edges across all theses — what to trade now')
     .option('--json', 'JSON output for agents')
+    .option('--share', 'Share output via short URL')
     .option('--limit <n>', 'Max edges to show', '20')
     .option('--thesis <id>', 'Filter to a single thesis')
     .option('--min-edge <cents>', 'Minimum absolute edge size in cents')
@@ -406,6 +426,7 @@ program
     const g = cmd.optsWithGlobals();
     await run(() => (0, edges_js_1.edgesCommand)({
         json: opts.json,
+        share: opts.share,
         limit: opts.limit,
         thesis: opts.thesis,
         minEdge: opts.minEdge,
@@ -465,8 +486,9 @@ program
     .command('explore [slug]')
     .description('Browse public theses (no auth required)')
     .option('--json', 'JSON output')
+    .option('--share', 'Share output via short URL')
     .action(async (slug, opts) => {
-    await run(() => (0, explore_js_1.exploreCommand)(slug, { json: opts.json }));
+    await run(() => (0, explore_js_1.exploreCommand)(slug, { json: opts.json, share: opts.share }));
 });
 // ── sf dashboard ──────────────────────────────────────────────────────────────
 program
@@ -702,17 +724,19 @@ program
     .command('markets')
     .description('Traditional market snapshot — SPY, VIX, Treasury, Gold, Oil (no auth)')
     .option('--json', 'JSON output')
+    .option('--share', 'Share output via short URL')
     .action(async (opts) => {
-    await run(() => (0, markets_js_1.marketsCommand)({ json: opts.json }));
+    await run(() => (0, markets_js_1.marketsCommand)({ json: opts.json, share: opts.share }));
 });
 // ── sf query "question" ──────────────────────────────────────────────────────
 program
     .command('query <question>')
     .description('LLM-enhanced prediction market knowledge search (no auth required)')
     .option('--json', 'JSON output')
+    .option('--share', 'Share output via short URL')
     .option('--limit <n>', 'Max results per category (default 10)', '10')
     .action(async (question, opts) => {
-    await run(() => (0, query_js_1.queryCommand)(question, { json: opts.json, limit: opts.limit }));
+    await run(() => (0, query_js_1.queryCommand)(question, { json: opts.json, share: opts.share, limit: opts.limit }));
 });
 // ── sf telegram ──────────────────────────────────────────────────────────────
 program

package/dist/share.d.ts

@@ -0,0 +1,4 @@
+/**
+ * --share helper: POST CLI output to /api/share and print the URL.
+ */
+export declare function shareOutput(command: string, args: string, data: unknown): Promise<void>;

package/dist/share.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * --share helper: POST CLI output to /api/share and print the URL.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shareOutput = shareOutput;
+const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
+async function shareOutput(command, args, data) {
+    try {
+        const res = await fetch(`${SF_API_URL}/api/share`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ command, args, data }),
+        });
+        if (!res.ok) {
+            console.error(`Share failed: ${res.status}`);
+            return;
+        }
+        const { url } = await res.json();
+        console.log();
+        console.log(`  \x1b[36m${url}\x1b[39m`);
+        console.log();
+    }
+    catch (err) {
+        console.error(`Share failed: ${err.message}`);
+    }
+}

package/dist/skills/loader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Skill loader — reads .md files from the skills directory,
+ * parses frontmatter, and makes them available as slash commands.
+ */
+export interface Skill {
+    name: string;
+    trigger: string;
+    description: string;
+    author: string;
+    version: string;
+    category: string;
+    tags: string[];
+    toolsUsed: string[];
+    estimatedTime: string;
+    auto?: string;
+    prompt: string;
+    raw: string;
+}
+export declare function loadSkills(): Skill[];

package/dist/skills/loader.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Skill loader — reads .md files from the skills directory,
+ * parses frontmatter, and makes them available as slash commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSkills = loadSkills;
+const fs_1 = require("fs");
+const path_1 = require("path");
+function loadSkills() {
+    const skills = [];
+    // Built-in skills from cli/src/skills/
+    // __dirname works in CJS; resolve to src/skills regardless of whether running from dist/ or src/
+    const thisDir = __dirname;
+    const skillsDir = thisDir.includes('dist')
+        ? (0, path_1.join)(thisDir, '../../src/skills') // running from dist/skills/
+        : thisDir; // running from src/skills/
+    let files = [];
+    try {
+        files = (0, fs_1.readdirSync)(skillsDir).filter(f => f.endsWith('.md'));
+    }
+    catch {
+        return skills;
+    }
+    for (const file of files) {
+        try {
+            const raw = (0, fs_1.readFileSync)((0, path_1.join)(skillsDir, file), 'utf-8');
+            const skill = parseSkillFile(raw);
+            if (skill)
+                skills.push(skill);
+        }
+        catch { }
+    }
+    // User skills from ~/.sf/skills/ (future extensibility)
+    try {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        const userDir = (0, path_1.join)(home, '.sf', 'skills');
+        const userFiles = (0, fs_1.readdirSync)(userDir).filter(f => f.endsWith('.md'));
+        for (const file of userFiles) {
+            try {
+                const raw = (0, fs_1.readFileSync)((0, path_1.join)(userDir, file), 'utf-8');
+                const skill = parseSkillFile(raw);
+                if (skill)
+                    skills.push(skill);
+            }
+            catch { }
+        }
+    }
+    catch { }
+    return skills;
+}
+function parseSkillFile(raw) {
+    // Parse YAML frontmatter between --- delimiters
+    const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match)
+        return null;
+    const frontmatter = match[1];
+    const body = match[2].trim();
+    const meta = {};
+    for (const line of frontmatter.split('\n')) {
+        const m = line.match(/^(\w[\w_]*)\s*:\s*(.+)$/);
+        if (m)
+            meta[m[1]] = m[2].trim();
+    }
+    if (!meta.name || !meta.trigger)
+        return null;
+    // Extract the "Instructions" section as the prompt (everything after ## Instructions)
+    const instructionsMatch = body.match(/## Instructions\n([\s\S]*)$/i);
+    const prompt = instructionsMatch ? instructionsMatch[1].trim() : body;
+    // Parse array fields: [a, b, c]
+    const parseArray = (s) => (s || '').replace(/[\[\]]/g, '').split(',').map(x => x.trim()).filter(Boolean);
+    return {
+        name: meta.name,
+        trigger: meta.trigger,
+        description: meta.description || '',
+        author: meta.author || 'unknown',
+        version: meta.version || '1.0.0',
+        category: meta.category || 'general',
+        tags: parseArray(meta.tags),
+        toolsUsed: parseArray(meta.tools_used),
+        estimatedTime: meta.estimated_time || '',
+        auto: meta.auto,
+        prompt,
+        raw,
+    };
+}