opentradex 0.1.0

package/src/index.mjs

@@ -0,0 +1,420 @@
+import { cpSync, copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { spawn, spawnSync } from "node:child_process";
+import { homedir } from "node:os";
+import path from "node:path";
+import process from "node:process";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const CONFIG_DIR = path.join(homedir(), ".opentradex");
+const CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
+const DEFAULT_WORKSPACE = path.join(homedir(), "opentradex");
+
+const PROJECT_TEMPLATE_ENTRIES = [
+  ".env.example",
+  ".gitignore",
+  "README.md",
+  "CLAUDE.md",
+  "SOUL.md",
+  "SPEC.md",
+  "SUBMISSION.md",
+  "architecture.excalidraw",
+  "architecture.png",
+  "main.py",
+  "requirements.txt",
+  "gossip",
+  "data",
+  "web"
+];
+
+const DEFAULT_ENV = {
+  KALSHI_API_KEY_ID: "",
+  KALSHI_PRIVATE_KEY_PATH: "",
+  KALSHI_USE_DEMO: "true",
+  APIFY_API_TOKEN: "",
+  BANKROLL: "30.00",
+  MIN_EDGE: "0.10",
+  MAX_POSITION_PCT: "0.30",
+  CYCLE_INTERVAL: "900",
+  LIVE_TRADING: "false"
+};
+
+export function getPackageRoot() {
+  return PACKAGE_ROOT;
+}
+
+export function getDefaultWorkspace() {
+  return DEFAULT_WORKSPACE;
+}
+
+export function readTradexConfig() {
+  return readJson(CONFIG_PATH, {});
+}
+
+export function writeTradexConfig(config) {
+  ensureDir(path.dirname(CONFIG_PATH));
+  writeFileSync(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+
+export function resolveWorkspace(workspace) {
+  const savedWorkspace = readTradexConfig().workspace;
+  return path.resolve(workspace || savedWorkspace || DEFAULT_WORKSPACE);
+}
+
+export function parseEnv(text) {
+  const values = {};
+
+  for (const rawLine of text.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) {
+      continue;
+    }
+
+    const separatorIndex = line.indexOf("=");
+    if (separatorIndex === -1) {
+      continue;
+    }
+
+    const key = line.slice(0, separatorIndex).trim();
+    const value = line.slice(separatorIndex + 1).trim();
+    values[key] = value.replace(/^"(.*)"$/, "$1");
+  }
+
+  return values;
+}
+
+export function buildEnv(overrides = {}) {
+  const env = { ...DEFAULT_ENV };
+
+  for (const [key, value] of Object.entries(overrides)) {
+    if (value === undefined || value === null) {
+      continue;
+    }
+    env[key] = String(value);
+  }
+
+  return env;
+}
+
+export function writeEnvFile(workspace, overrides = {}) {
+  const envPath = path.join(workspace, ".env");
+  const current = existsSync(envPath) ? parseEnv(readFileSync(envPath, "utf8")) : {};
+  const env = buildEnv({ ...current, ...overrides });
+
+  const lines = [
+    "# Generated by opentradex onboard",
+    "# Run `opentradex doctor` to verify your setup.",
+    "",
+    ...Object.entries(env).map(([key, value]) => `${key}=${value}`)
+  ];
+
+  writeFileSync(envPath, `${lines.join("\n")}\n`, "utf8");
+  return env;
+}
+
+export function ensureWorkspaceFiles(workspace, options = {}) {
+  ensureDir(workspace);
+
+  for (const entry of PROJECT_TEMPLATE_ENTRIES) {
+    const src = path.join(PACKAGE_ROOT, entry);
+    const dest = path.join(workspace, entry);
+
+    if (!existsSync(src)) {
+      continue;
+    }
+
+    if (statSync(src).isDirectory()) {
+      cpSync(src, dest, { recursive: true, force: Boolean(options.force) });
+      continue;
+    }
+
+    if (!existsSync(dest) || options.force) {
+      ensureDir(path.dirname(dest));
+      copyFileSync(src, dest);
+    }
+  }
+
+  ensureDir(path.join(workspace, "data"));
+}
+
+export function collectDoctor(workspaceArg) {
+  const workspace = resolveWorkspace(workspaceArg);
+  const envPath = path.join(workspace, ".env");
+  const env = existsSync(envPath) ? parseEnv(readFileSync(envPath, "utf8")) : {};
+  const config = readTradexConfig();
+  const liveTrading = String(env.LIVE_TRADING || "").toLowerCase() === "true";
+
+  return {
+    workspace,
+    checks: [
+      check("Node.js", commandWorks("node", ["-v"]), "Install Node.js 22+."),
+      check("npm", commandWorks("npm", ["-v"]), "Install npm or use the Node.js installer."),
+      check("Python", commandWorks("python", ["--version"]), "Install Python 3.11+."),
+      check("Claude CLI", commandWorks("claude", ["--version"]), "Install and sign in to Claude Code."),
+      check("Workspace", existsSync(path.join(workspace, "main.py")), "Run `opentradex onboard` to create a workspace."),
+      check(".env", existsSync(envPath), "Run `opentradex onboard` to generate `.env`."),
+      check("APIFY_API_TOKEN", Boolean(env.APIFY_API_TOKEN), "Add your Apify token for news scraping."),
+      check(
+        "Kalshi creds",
+        !liveTrading || (Boolean(env.KALSHI_API_KEY_ID) && Boolean(env.KALSHI_PRIVATE_KEY_PATH)),
+        "Set KALSHI_API_KEY_ID and KALSHI_PRIVATE_KEY_PATH for live trading."
+      ),
+      check("Saved workspace", Boolean(config.workspace), "Run `opentradex onboard` once so the CLI remembers your workspace.")
+    ]
+  };
+}
+
+export async function onboard(options = {}) {
+  const saved = readTradexConfig();
+  const interactive = process.stdin.isTTY && !options.yes;
+  const rl = interactive ? createInterface({ input: process.stdin, output: process.stdout }) : null;
+
+  try {
+    const workspace = path.resolve(
+      options.workspace ||
+        (interactive
+          ? await ask(rl, "Workspace directory", saved.workspace || DEFAULT_WORKSPACE)
+          : saved.workspace || DEFAULT_WORKSPACE)
+    );
+
+    const mode =
+      options.live ? "live" : options.paper ? "paper" : interactive ? await chooseMode(rl, saved.mode || "paper") : saved.mode || "paper";
+
+    const bankroll =
+      options.bankroll ??
+      (interactive ? await ask(rl, "Starting bankroll (USD)", String(saved.bankroll || DEFAULT_ENV.BANKROLL)) : saved.bankroll || DEFAULT_ENV.BANKROLL);
+
+    const interval =
+      options.interval ??
+      (interactive
+        ? await ask(rl, "Loop interval in seconds", String(saved.interval || DEFAULT_ENV.CYCLE_INTERVAL))
+        : saved.interval || DEFAULT_ENV.CYCLE_INTERVAL);
+
+    const installDeps =
+      options.install ?? (options.skipInstall ? false : interactive ? await confirm(rl, "Install Python and web dependencies now", true) : true);
+
+    const apifyToken =
+      options.apifyToken ??
+      (interactive ? await ask(rl, "Apify API token", saved.apifyToken || "") : saved.apifyToken || "");
+
+    const kalshiKeyId =
+      mode === "live"
+        ? options.kalshiKeyId ??
+          (interactive ? await ask(rl, "Kalshi API key id", saved.kalshiKeyId || "") : saved.kalshiKeyId || "")
+        : "";
+
+    const kalshiPrivateKeyPath =
+      mode === "live"
+        ? options.kalshiPrivateKeyPath ??
+          (interactive
+            ? await ask(rl, "Kalshi private key path", saved.kalshiPrivateKeyPath || "")
+            : saved.kalshiPrivateKeyPath || "")
+        : "";
+
+    const workspaceExists = existsSync(path.join(workspace, "main.py"));
+    if (interactive && workspaceExists && !(await confirm(rl, `Reuse existing workspace at ${workspace}`, true))) {
+      throw new Error("Onboarding cancelled.");
+    }
+
+    ensureWorkspaceFiles(workspace, { force: Boolean(options.force) });
+
+    const env = writeEnvFile(workspace, {
+      APIFY_API_TOKEN: apifyToken,
+      BANKROLL: Number(bankroll).toFixed(2),
+      CYCLE_INTERVAL: String(interval),
+      KALSHI_USE_DEMO: mode === "live" ? "false" : "true",
+      LIVE_TRADING: mode === "live" ? "true" : "false",
+      KALSHI_API_KEY_ID: kalshiKeyId,
+      KALSHI_PRIVATE_KEY_PATH: kalshiPrivateKeyPath
+    });
+
+    writeTradexConfig({
+      workspace,
+      mode,
+      bankroll: Number(bankroll).toFixed(2),
+      interval: Number(interval),
+      apifyToken,
+      kalshiKeyId,
+      kalshiPrivateKeyPath,
+      installedAt: new Date().toISOString()
+    });
+
+    if (installDeps) {
+      await runCommand("python", ["-m", "pip", "install", "-r", "requirements.txt"], { cwd: workspace });
+      await runCommand("npm", ["install"], { cwd: path.join(workspace, "web") });
+    }
+
+    return {
+      workspace,
+      mode,
+      env,
+      interval: Number(interval),
+      installDeps
+    };
+  } finally {
+    rl?.close();
+  }
+}
+
+export async function runTradingLoop(options = {}) {
+  const workspace = resolveWorkspace(options.workspace);
+  const config = readTradexConfig();
+  const args = ["main.py", "--loop"];
+
+  if (options.interval || config.interval) {
+    args.push("--interval", String(options.interval || config.interval));
+  }
+
+  if (options.rationale) {
+    args.push("--rationale", options.rationale);
+  }
+
+  await runCommand("python", args, { cwd: workspace });
+}
+
+export async function runSingleCycle(options = {}) {
+  const workspace = resolveWorkspace(options.workspace);
+  const args = ["main.py"];
+
+  if (options.rationale) {
+    args.push("--rationale", options.rationale);
+  }
+
+  if (options.prompt) {
+    args.push("--prompt", options.prompt);
+  }
+
+  await runCommand("python", args, { cwd: workspace });
+}
+
+export async function runDashboard(options = {}) {
+  const workspace = resolveWorkspace(options.workspace);
+  const webDir = path.join(workspace, "web");
+
+  if (options.install) {
+    await runCommand("npm", ["install"], { cwd: webDir });
+  }
+
+  await runCommand("npm", ["run", "dev"], { cwd: webDir });
+}
+
+export function formatDoctorReport(report) {
+  const lines = ["OpenTradex doctor", `workspace: ${report.workspace}`, ""];
+
+  for (const item of report.checks) {
+    lines.push(`${item.ok ? "[ok]" : "[warn]"} ${item.name}`);
+    if (!item.ok) {
+      lines.push(`  ${item.help}`);
+    }
+  }
+
+  return lines.join("\n");
+}
+
+function readJson(filePath, fallback) {
+  try {
+    return JSON.parse(readFileSync(filePath, "utf8"));
+  } catch {
+    return fallback;
+  }
+}
+
+function ensureDir(dirPath) {
+  mkdirSync(dirPath, { recursive: true });
+}
+
+function check(name, ok, help) {
+  return { name, ok, help };
+}
+
+function commandWorks(command, args) {
+  if (process.platform === "win32") {
+    const result = spawnSync("where.exe", [command], { stdio: "ignore" });
+    return !result.error && result.status === 0;
+  }
+
+  for (const candidate of getCommandCandidates(command)) {
+    const result = spawnSync(candidate, args, { stdio: "ignore" });
+    if (!result.error && result.status === 0) {
+      return true;
+    }
+  }
+  return false;
+}
+
+async function runCommand(command, args, options = {}) {
+  await new Promise((resolve, reject) => {
+    const spec = getSpawnSpec(command, args);
+    const child = spawn(spec.command, spec.args, {
+      cwd: options.cwd,
+      stdio: "inherit",
+      env: { ...process.env, ...(options.env || {}) }
+    });
+
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
+    });
+  });
+}
+
+async function ask(rl, label, fallback = "") {
+  const prompt = fallback ? `${label} [${fallback}]: ` : `${label}: `;
+  const answer = (await rl.question(prompt)).trim();
+  return answer || fallback;
+}
+
+async function confirm(rl, label, defaultYes = true) {
+  const hint = defaultYes ? "[Y/n]" : "[y/N]";
+  const answer = (await rl.question(`${label} ${hint}: `)).trim().toLowerCase();
+  if (!answer) {
+    return defaultYes;
+  }
+  return answer === "y" || answer === "yes";
+}
+
+async function chooseMode(rl, fallback) {
+  const answer = (await rl.question(`Trading mode [paper/live] (${fallback}): `)).trim().toLowerCase();
+  if (!answer) {
+    return fallback;
+  }
+  return answer === "live" ? "live" : "paper";
+}
+
+function getCommandCandidates(command) {
+  if (process.platform !== "win32") {
+    return [command];
+  }
+
+  if (command.includes(".")) {
+    return [command];
+  }
+
+  return [command, `${command}.cmd`, `${command}.exe`, `${command}.bat`];
+}
+
+function getSpawnCommand(command) {
+  if (process.platform === "win32" && command === "npm") {
+    return "npm.cmd";
+  }
+  return command;
+}
+
+function getSpawnSpec(command, args) {
+  if (process.platform === "win32" && command === "npm") {
+    return {
+      command: "cmd.exe",
+      args: ["/d", "/s", "/c", "npm", ...args]
+    };
+  }
+
+  return {
+    command: getSpawnCommand(command),
+    args
+  };
+}

package/web/AGENTS.md

@@ -0,0 +1,5 @@
+<!-- BEGIN:nextjs-agent-rules -->
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
+<!-- END:nextjs-agent-rules -->

package/web/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/web/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

package/web/components.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-nova",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

package/web/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/web/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;