jfl 0.0.0

package/dist/utils/x402-client.js

@@ -0,0 +1,265 @@
+/**
+ * x402 Payment Client for JFL
+ *
+ * Handles x402 micropayments for JFL Day Pass ($5/day)
+ * Based on httpcat-cli implementation
+ */
+import { privateKeyToAccount } from 'viem/accounts';
+import { randomBytes } from 'crypto';
+import Conf from 'conf';
+const config = new Conf({ projectName: 'jfl' });
+// Network configuration
+const USE_TESTNET = process.env.JFL_TESTNET === 'true' || process.env.NODE_ENV !== 'production';
+const NETWORK_CONFIG = {
+    testnet: {
+        caip2: 'eip155:84532',
+        chainId: 84532,
+        usdcAddress: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+        usdcName: 'USDC',
+    },
+    mainnet: {
+        caip2: 'eip155:8453',
+        chainId: 8453,
+        usdcAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        usdcName: 'USD Coin',
+    },
+};
+function getNetwork() {
+    return USE_TESTNET ? NETWORK_CONFIG.testnet : NETWORK_CONFIG.mainnet;
+}
+// JFL API endpoints
+const JFL_API_URL = process.env.JFL_API_URL || 'https://api.jfl.run';
+// Day Pass cost: $5 = 5,000,000 (6 decimals)
+const DAY_PASS_COST = BigInt(5_000_000);
+const DAY_PASS_COST_HEX = '0x4c4b40'; // 5,000,000 in hex
+/**
+ * Create x402 client with signing capability
+ */
+export function createX402Client(privateKey) {
+    const signer = privateKeyToAccount(privateKey);
+    const network = getNetwork();
+    return {
+        signer,
+        network,
+        address: signer.address,
+        /**
+         * Create EIP-712 payment signature for x402
+         */
+        async createPaymentSignature(requirements) {
+            // Generate unique nonce (critical for each payment)
+            const nonceBytes = randomBytes(32);
+            const nonce = `0x${nonceBytes.toString('hex').padStart(64, '0')}`;
+            // Timing windows
+            const validAfter = Math.floor(Date.now() / 1000) - 30; // 30s in past
+            const validBefore = validAfter + 330; // 5 minutes total
+            // Amount handling
+            let valueHex;
+            if (requirements.maxAmountRequired.startsWith('0x')) {
+                valueHex = requirements.maxAmountRequired;
+            }
+            else {
+                valueHex = `0x${BigInt(requirements.maxAmountRequired).toString(16)}`;
+            }
+            // EIP-712 domain
+            const domain = {
+                name: network.usdcName,
+                version: '2',
+                chainId: network.chainId,
+                verifyingContract: network.usdcAddress,
+            };
+            // EIP-712 types for TransferWithAuthorization (EIP-3009)
+            const types = {
+                TransferWithAuthorization: [
+                    { name: 'from', type: 'address' },
+                    { name: 'to', type: 'address' },
+                    { name: 'value', type: 'uint256' },
+                    { name: 'validAfter', type: 'uint256' },
+                    { name: 'validBefore', type: 'uint256' },
+                    { name: 'nonce', type: 'bytes32' },
+                ],
+            };
+            // Sign authorization
+            const signature = await signer.signTypedData({
+                domain,
+                types,
+                primaryType: 'TransferWithAuthorization',
+                message: {
+                    from: signer.address,
+                    to: requirements.payTo,
+                    value: BigInt(valueHex),
+                    validAfter: BigInt(validAfter),
+                    validBefore: BigInt(validBefore),
+                    nonce: nonce,
+                },
+            });
+            // Build x402 V2 payment payload
+            const paymentPayload = {
+                x402Version: 2,
+                scheme: 'exact',
+                network: network.caip2,
+                payload: {
+                    signature: signature,
+                    authorization: {
+                        from: signer.address,
+                        to: requirements.payTo,
+                        value: valueHex,
+                        validAfter: validAfter.toString(),
+                        validBefore: validBefore.toString(),
+                        nonce: nonce,
+                    },
+                },
+            };
+            // Encode as base64 for header
+            return Buffer.from(JSON.stringify(paymentPayload)).toString('base64');
+        },
+        /**
+         * Make x402 request with payment handling
+         */
+        async request(url, options = {}) {
+            // Initial request without payment
+            const initialResponse = await fetch(url, {
+                ...options,
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...options.headers,
+                },
+            });
+            // Check for 402 Payment Required
+            if (initialResponse.status === 402) {
+                // Parse payment requirements
+                const paymentRequiredHeader = initialResponse.headers.get('payment-required') ||
+                    initialResponse.headers.get('Payment-Required');
+                let requirements = null;
+                if (paymentRequiredHeader) {
+                    const decoded = Buffer.from(paymentRequiredHeader, 'base64').toString('utf-8');
+                    const headerData = JSON.parse(decoded);
+                    if (headerData.accepts && Array.isArray(headerData.accepts)) {
+                        requirements = headerData.accepts[0];
+                    }
+                    else if (headerData.network && headerData.maxAmountRequired) {
+                        requirements = headerData;
+                    }
+                }
+                if (!requirements) {
+                    // Try to parse from body
+                    const responseText = await initialResponse.text();
+                    const paymentInfo = JSON.parse(responseText);
+                    requirements = paymentInfo.accepts?.[0];
+                }
+                if (!requirements) {
+                    throw new Error('Could not parse payment requirements from 402 response');
+                }
+                // Create payment signature
+                const paymentHeader = await this.createPaymentSignature(requirements);
+                // Retry with payment
+                await new Promise((resolve) => setTimeout(resolve, 500));
+                return fetch(url, {
+                    ...options,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'PAYMENT-SIGNATURE': paymentHeader,
+                        ...options.headers,
+                    },
+                });
+            }
+            return initialResponse;
+        },
+    };
+}
+/**
+ * Check if user has valid day pass
+ */
+export function getDayPass() {
+    const dayPass = config.get('dayPass');
+    if (!dayPass)
+        return null;
+    // Check if expired (day passes are valid for 24 hours)
+    const now = Date.now();
+    if (now > dayPass.expiresAt) {
+        // Expired, clear it
+        config.delete('dayPass');
+        return null;
+    }
+    return dayPass;
+}
+/**
+ * Save day pass after successful payment
+ */
+export function saveDayPass(leaseId, userAddress) {
+    const now = Date.now();
+    const dayPass = {
+        leaseId,
+        userAddress,
+        paidAt: now,
+        expiresAt: now + 24 * 60 * 60 * 1000, // 24 hours
+    };
+    config.set('dayPass', dayPass);
+    return dayPass;
+}
+/**
+ * Check if user needs to pay for today
+ */
+export function needsPayment() {
+    const dayPass = getDayPass();
+    return !dayPass;
+}
+/**
+ * Get time remaining on day pass
+ */
+export function getDayPassTimeRemaining() {
+    const dayPass = getDayPass();
+    if (!dayPass)
+        return null;
+    const remaining = dayPass.expiresAt - Date.now();
+    if (remaining <= 0)
+        return null;
+    const hours = Math.floor(remaining / (60 * 60 * 1000));
+    const minutes = Math.floor((remaining % (60 * 60 * 1000)) / (60 * 1000));
+    return { hours, minutes };
+}
+/**
+ * Purchase day pass via x402
+ */
+export async function purchaseDayPass(privateKey) {
+    const client = createX402Client(privateKey);
+    const network = getNetwork();
+    // Call JFL API to purchase day pass
+    const response = await client.request(`${JFL_API_URL}/v1/daypass/purchase`, {
+        method: 'POST',
+        body: JSON.stringify({
+            userAddress: client.address,
+            network: network.caip2,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Failed to purchase day pass: ${error}`);
+    }
+    const result = await response.json();
+    // Save and return day pass
+    return saveDayPass(result.leaseId, client.address);
+}
+/**
+ * Verify day pass with JFL API
+ */
+export async function verifyDayPass(dayPass) {
+    try {
+        const response = await fetch(`${JFL_API_URL}/v1/daypass/verify`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                leaseId: dayPass.leaseId,
+                userAddress: dayPass.userAddress,
+            }),
+        });
+        if (!response.ok)
+            return false;
+        const result = await response.json();
+        return result.valid === true;
+    }
+    catch {
+        // If API is down, trust local day pass if not expired
+        return Date.now() < dayPass.expiresAt;
+    }
+}
+//# sourceMappingURL=x402-client.js.map

package/dist/utils/x402-client.js.map

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "jfl",
+  "version": "0.0.0",
+  "description": "Just Fucking Launch - CLI for AI-powered GTM and development",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "jfl": "dist/index.js",
+    "jfl-context-hub-mcp": "dist/mcp/context-hub-mcp.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "template",
+    "clawdbot-skill",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx --watch src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "ai",
+    "claude",
+    "gtm",
+    "go-to-market",
+    "launch",
+    "cli",
+    "productivity",
+    "startup",
+    "marketing",
+    "x402",
+    "crypto"
+  ],
+  "author": "Alec Taggart <402goose@users.noreply.github.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/402goose/jfl-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/402goose/jfl-cli/issues"
+  },
+  "homepage": "https://jfl.run",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "@scure/bip32": "^2.0.1",
+    "@scure/bip39": "^2.0.1",
+    "@x402/core": "^2.2.0",
+    "@x402/evm": "^2.2.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "conf": "^12.0.0",
+    "httpcat-cli": "^0.3.3",
+    "inquirer": "^9.2.14",
+    "node-global-key-listener": "^0.3.0",
+    "open": "^10.0.0",
+    "ora": "^8.0.1",
+    "viem": "^2.44.4",
+    "ws": "^8.16.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * JFL CLI Postinstall Script
+ *
+ * Installs bundled tools that enhance the JFL experience:
+ * - ralph-tui: AI agent loop orchestrator for autonomous task execution
+ *
+ * These tools require Bun runtime. If Bun is not installed,
+ * we'll show instructions but continue (tools are optional).
+ */
+
+import { execSync, spawnSync } from "child_process";
+import { platform } from "os";
+
+const TOOLS = [
+  {
+    name: "ralph-tui",
+    package: "ralph-tui",
+    description: "AI agent loop orchestrator",
+    requiresBun: true,
+  },
+];
+
+function hasBun() {
+  try {
+    execSync("bun --version", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function hasCommand(cmd) {
+  try {
+    execSync(`which ${cmd}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function installWithBun(pkg) {
+  try {
+    console.log(`  Installing ${pkg}...`);
+    execSync(`bun install -g ${pkg}`, { stdio: "inherit" });
+    return true;
+  } catch (error) {
+    console.error(`  Failed to install ${pkg}: ${error.message}`);
+    return false;
+  }
+}
+
+function main() {
+  console.log("\n🚀 JFL CLI - Setting up bundled tools...\n");
+
+  const bunInstalled = hasBun();
+
+  if (!bunInstalled) {
+    console.log("⚠️  Bun runtime not found.");
+    console.log("   Some JFL tools (like ralph-tui) require Bun.");
+    console.log("");
+    console.log("   Install Bun:");
+    if (platform() === "win32") {
+      console.log('   powershell -c "irm bun.sh/install.ps1 | iex"');
+    } else {
+      console.log("   curl -fsSL https://bun.sh/install | bash");
+    }
+    console.log("");
+    console.log("   Then run: jfl update");
+    console.log("");
+    return;
+  }
+
+  console.log("✅ Bun runtime detected\n");
+
+  for (const tool of TOOLS) {
+    if (tool.requiresBun && !bunInstalled) {
+      console.log(`⏭️  Skipping ${tool.name} (requires Bun)`);
+      continue;
+    }
+
+    // Check if already installed
+    if (hasCommand(tool.name)) {
+      console.log(`✅ ${tool.name} already installed`);
+      continue;
+    }
+
+    console.log(`📦 Installing ${tool.name} - ${tool.description}`);
+    const success = installWithBun(tool.package);
+
+    if (success) {
+      console.log(`✅ ${tool.name} installed successfully\n`);
+    } else {
+      console.log(`⚠️  ${tool.name} installation failed (optional)\n`);
+    }
+  }
+
+  console.log("🎉 JFL CLI setup complete!\n");
+  console.log("Available tools:");
+  console.log("  jfl          - Main CLI");
+  if (hasCommand("ralph-tui")) {
+    console.log("  ralph-tui    - AI agent loop orchestrator");
+  }
+  console.log("");
+
+  // Check for Clawdbot integration
+  if (hasCommand("clawdbot")) {
+    console.log("🦞 Clawdbot detected!");
+    console.log("");
+    console.log("Add JFL to Telegram/Slack/Discord:");
+    console.log("  jfl clawdbot install");
+    console.log("");
+  }
+}
+
+main();

package/scripts/test-onboarding.sh

@@ -0,0 +1,121 @@
+#!/bin/bash
+# Test JFL onboarding flow in isolated environment
+
+set -e
+
+TEST_DIR="/tmp/jfl-test-$(date +%s)"
+CONFIG_BACKUP="$HOME/.config/jfl.backup-$(date +%s)"
+
+echo "🧪 JFL Test Mode"
+echo ""
+echo "This will:"
+echo "  1. Backup your current JFL config"
+echo "  2. Clear config for fresh onboarding"
+echo "  3. Create test directory: $TEST_DIR"
+echo "  4. Launch JFL"
+echo "  5. Restore your config when done"
+echo ""
+read -p "Continue? (y/n) " -n 1 -r
+echo
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo "Cancelled."
+    exit 0
+fi
+
+# Backup current config
+if [ -d "$HOME/.config/jfl" ]; then
+    echo "📦 Backing up config to $CONFIG_BACKUP"
+    mv "$HOME/.config/jfl" "$CONFIG_BACKUP"
+fi
+
+# Create test directory
+echo "📁 Creating test directory: $TEST_DIR"
+mkdir -p "$TEST_DIR"
+cd "$TEST_DIR"
+
+# Cleanup function
+cleanup() {
+    echo ""
+    echo "🧹 Cleaning up..."
+
+    # Check for created GitHub repos in test directory
+    CREATED_REPOS=()
+    if [ -d "$TEST_DIR" ]; then
+        # Find any directories with .git in them (product repos)
+        for dir in "$TEST_DIR"/*/product; do
+            if [ -d "$dir/.git" ]; then
+                # Get repo name from git remote
+                cd "$dir" 2>/dev/null || continue
+                REPO_URL=$(git remote get-url origin 2>/dev/null || echo "")
+                if [[ -n "$REPO_URL" ]]; then
+                    # Extract owner/repo from URL
+                    # Handles both SSH (git@github.com:owner/repo.git) and HTTPS (https://github.com/owner/repo.git)
+                    REPO_FULL=$(echo "$REPO_URL" | sed -E 's#^(https://|git@)github\.com[:/]##' | sed 's/\.git$//')
+                    CREATED_REPOS+=("$REPO_FULL")
+                fi
+            fi
+        done
+    fi
+
+    # Ask about deleting GitHub repos
+    if [ ${#CREATED_REPOS[@]} -gt 0 ]; then
+        echo ""
+        echo "Found ${#CREATED_REPOS[@]} test repo(s) on GitHub:"
+        for repo in "${CREATED_REPOS[@]}"; do
+            echo "  - $repo"
+        done
+        echo ""
+        read -p "Delete these repos from GitHub? (y/n) " -n 1 -r
+        echo
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            for repo in "${CREATED_REPOS[@]}"; do
+                echo "Deleting $repo from GitHub..."
+                if gh repo delete "$repo" --yes 2>/dev/null; then
+                    echo "  ✓ Deleted: $repo"
+                else
+                    echo "  ⚠️  Failed to delete: $repo (may need to delete manually)"
+                fi
+            done
+        else
+            echo "Repos kept on GitHub"
+        fi
+    fi
+
+    # Remove test config
+    rm -rf "$HOME/.config/jfl"
+
+    # Restore original config
+    if [ -d "$CONFIG_BACKUP" ]; then
+        echo "📦 Restoring config from $CONFIG_BACKUP"
+        mv "$CONFIG_BACKUP" "$HOME/.config/jfl"
+    fi
+
+    # Ask about test directory
+    echo ""
+    read -p "Delete test directory $TEST_DIR? (y/n) " -n 1 -r
+    echo
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        rm -rf "$TEST_DIR"
+        echo "✓ Test directory deleted"
+    else
+        echo "Test directory kept at: $TEST_DIR"
+    fi
+
+    echo ""
+    echo "✓ Restored to normal state"
+}
+
+# Set trap to cleanup on exit
+trap cleanup EXIT INT TERM
+
+# Show environment
+echo ""
+echo "🎯 Test Environment Ready"
+echo "   Config: Fresh (backed up to $CONFIG_BACKUP)"
+echo "   Directory: $TEST_DIR"
+echo ""
+echo "Starting JFL..."
+echo ""
+
+# Launch JFL
+jfl