create-hedgeboard 1.0.0

package/index.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+
+/**
+ * create-hedgeboard
+ *
+ * Sets up a HedgeBoard workspace with your API key pre-configured.
+ *
+ * Usage:
+ *   npx create-hedgeboard --key YOUR_API_KEY
+ *   npx create-hedgeboard --key YOUR_API_KEY --dir ./my-workspace
+ */
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+
+// ---------------------------------------------------------------------------
+// Config
+// ---------------------------------------------------------------------------
+
+const API_BASE =
+    process.env.HEDGEBOARD_API_URL ||
+    "https://3oy6d0glul.execute-api.us-east-1.amazonaws.com/v1";
+
+// ---------------------------------------------------------------------------
+// CLI args
+// ---------------------------------------------------------------------------
+
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const opts = { key: "", dir: "./hedgeboard" };
+
+    for (let i = 0; i < args.length; i++) {
+        if ((args[i] === "--key" || args[i] === "-k") && args[i + 1]) {
+            opts.key = args[++i];
+        } else if ((args[i] === "--dir" || args[i] === "-d") && args[i + 1]) {
+            opts.dir = args[++i];
+        } else if (args[i] === "--help" || args[i] === "-h") {
+            console.log(`
+  create-hedgeboard — set up a HedgeBoard workspace
+
+  Usage:
+    npx create-hedgeboard --key YOUR_API_KEY
+    npx create-hedgeboard --key YOUR_API_KEY --dir ./my-workspace
+
+  Options:
+    --key, -k   Your HedgeBoard API key (required)
+    --dir, -d   Output directory (default: ./hedgeboard)
+    --help, -h  Show this help
+`);
+            process.exit(0);
+        }
+    }
+
+    if (!opts.key) {
+        console.error(
+            "Error: --key is required.\n" +
+            "  Get your API key at https://hedgeboard.com/dashboard\n\n" +
+            "  Usage: npx create-hedgeboard --key YOUR_API_KEY"
+        );
+        process.exit(1);
+    }
+
+    return opts;
+}
+
+// ---------------------------------------------------------------------------
+// HTTP helpers
+// ---------------------------------------------------------------------------
+
+function fetchBuffer(url, headers = {}) {
+    return new Promise((resolve, reject) => {
+        const get = (u) => {
+            const mod = u.startsWith("https") ? https : require("http");
+            mod.get(u, { headers }, (res) => {
+                if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                    return get(res.headers.location); // follow redirect
+                }
+                if (res.statusCode !== 200) {
+                    return reject(new Error(`HTTP ${res.statusCode}`));
+                }
+                const chunks = [];
+                res.on("data", (c) => chunks.push(c));
+                res.on("end", () => resolve(Buffer.concat(chunks)));
+                res.on("error", reject);
+            }).on("error", reject);
+        };
+        get(url);
+    });
+}
+
+// ---------------------------------------------------------------------------
+// ZIP extraction (pure JS, no dependencies)
+// ---------------------------------------------------------------------------
+
+function extractZip(zipBuffer, destDir) {
+    // Simple ZIP parser — handles DEFLATE and STORE methods
+    // For robustness in production, consider using a proper zip library
+    const { execSync } = require("child_process");
+    const tmpZip = path.join(require("os").tmpdir(), `hedgeboard-${Date.now()}.zip`);
+    fs.writeFileSync(tmpZip, zipBuffer);
+    fs.mkdirSync(destDir, { recursive: true });
+    execSync(`unzip -o -q "${tmpZip}" -d "${destDir}"`);
+    fs.unlinkSync(tmpZip);
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+    const { key, dir } = parseArgs();
+
+    console.log("\n  ╔══════════════════════════════════════╗");
+    console.log("  ║        create-hedgeboard             ║");
+    console.log("  ╚══════════════════════════════════════╝\n");
+
+    // 1. Validate API key
+    process.stdout.write("  → Validating API key... ");
+    try {
+        const brandData = await fetchBuffer(`${API_BASE}/brand?key=${key}`);
+        const brand = JSON.parse(brandData.toString());
+        if (brand.error) throw new Error(brand.error);
+        console.log("✓");
+    } catch (err) {
+        console.log("✗");
+        console.error(`\n  Error: Invalid API key. Check your key at https://hedgeboard.com/dashboard`);
+        process.exit(1);
+    }
+
+    // 2. Download toolkit
+    process.stdout.write("  → Downloading toolkit... ");
+    let zipBuffer;
+    try {
+        // Download the base toolkit from the HedgeBoard API
+        zipBuffer = await fetchBuffer(`${API_BASE}/toolkit`, {
+            "x-api-key": key,
+        });
+        console.log(`✓ (${(zipBuffer.length / 1024).toFixed(0)} KB)`);
+    } catch {
+        // Fallback: download directly from S3
+        try {
+            zipBuffer = await fetchBuffer(
+                "https://hedgeboard-sec-filings.s3.amazonaws.com/toolkit/hedgeboard-base.zip"
+            );
+            console.log(`✓ (${(zipBuffer.length / 1024).toFixed(0)} KB)`);
+        } catch (err) {
+            console.log("✗");
+            console.error("\n  Error: Failed to download toolkit. Check your internet connection.");
+            process.exit(1);
+        }
+    }
+
+    // 3. Extract
+    const absDir = path.resolve(dir);
+    process.stdout.write(`  → Extracting to ${absDir}... `);
+    try {
+        extractZip(zipBuffer, path.dirname(absDir));
+        // The ZIP contains hedgeboard/ so files land in the right place
+        console.log("✓");
+    } catch (err) {
+        console.log("✗");
+        console.error("\n  Error: Failed to extract toolkit.", err.message);
+        process.exit(1);
+    }
+
+    // 4. Write .env with the user's API key
+    const envPath = path.join(absDir, ".env");
+    fs.writeFileSync(
+        envPath,
+        `# HedgeBoard API\nHEDGEBOARD_API_KEY=${key}\nHEDGEBOARD_API_URL=${API_BASE}\n`
+    );
+
+    // 5. Done!
+    console.log("\n  ✅ HedgeBoard workspace ready!\n");
+    console.log("  Next steps:");
+    console.log(`    1. Open ${dir}/ in Claude Code`);
+    console.log(`    2. Ask: "Give me a company overview of Apple"`);
+    console.log("");
+}
+
+main().catch((err) => {
+    console.error("\n  Unexpected error:", err.message);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+    "name": "create-hedgeboard",
+    "version": "1.0.0",
+    "description": "Set up a HedgeBoard financial intelligence workspace",
+    "bin": {
+        "create-hedgeboard": "./index.js"
+    },
+    "keywords": [
+        "hedgeboard",
+        "finance",
+        "ai",
+        "claude",
+        "sec",
+        "edgar"
+    ],
+    "license": "MIT"
+}