gloomberb 0.1.0

package/README.md

@@ -0,0 +1,153 @@
+# Gloomberb Terminal
+
+A Bloomberg-inspired stock portfolio tracker for your terminal. Built with [OpenTUI](https://github.com/msmps/opentui) + React + Bun.
+
+```
++--[ GLOOMBERB TERMINAL ]----------[ 15:42:03 ]--[ USD ]--+
+|                          |                               |
+| [Main Portfolio|Tech WL] | [Overview|Financials|Chart]   |
+| -------------------------|                               |
+| TICKER  PRICE   CHG%  PE | AAPL - Apple Inc.            |
+| AAPL   $189.50 +1.2% 29 | Price: $189.50  (+$2.24)     |
+|>MSFT   $420.10 -0.3% 35 | ▁▂▃▄▅▆▅▄▅▆▇▆▅▆▇▆▅▆▇█▇▆▇    |
+| GOOGL  $175.80 +0.8% 25 | MCap: $2.91T  P/E: 29.1     |
+| NVDA   $875.30 +2.1% 62 | Revenue: $391B  FCF: $112B   |
++---[ Ctrl+P search | Tab switch | q quit ]---------------+
+```
+
+## Features
+
+- **Two-panel Bloomberg layout** with amber-on-black theme
+- **Yahoo Finance integration** for real-time quotes, fundamentals, and 5-year price history
+- **Markdown-based storage** - one `.md` file per ticker with YAML frontmatter, perfect for LLM agents
+- **Multiple portfolios & watchlists** with configurable columns
+- **Plugin architecture** - everything is a plugin, including core panes and broker integrations
+- **Prefix command bar** (`Ctrl+P`) for fast keyboard-driven workflow
+- **Multi-currency** support with cached exchange rates
+- **ASCII stock charts** using braille characters with price/time axes
+- **Editable notes** per ticker, saved to markdown
+- **Interactive Brokers** integration via Flex Queries
+- **Local-first** - all data stays on your machine (SQLite cache + markdown files)
+
+## Quick Start
+
+```bash
+# Install dependencies
+bun install
+
+# Run
+bun dev
+```
+
+On first launch, data is stored in `~/gloomberb-data/`. Each ticker gets its own markdown file:
+
+```markdown
+---
+ticker: AAPL
+exchange: NASDAQ
+currency: USD
+name: Apple Inc.
+sector: Technology
+portfolios:
+  - main
+watchlists:
+  - tech
+---
+
+## Notes
+
+Strong services growth. Watch for Vision Pro adoption.
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Ctrl+P` or `` ` `` | Open command bar |
+| `Tab` | Switch between left/right panels |
+| `j` / `k` | Navigate ticker list |
+| `h` / `l` | Switch tabs |
+| `r` | Refresh selected ticker |
+| `Shift+R` | Refresh all tickers |
+| `Ctrl+,` | Open settings |
+| `q` | Quit |
+
+## Command Bar Prefixes
+
+The command bar uses a prefix system for fast actions:
+
+| Prefix | Action |
+|--------|--------|
+| `T <query>` | Search Yahoo Finance for a ticker |
+| `AW` | Add current ticker to watchlist |
+| `AP` | Add current ticker to portfolio |
+| `RW` | Remove from watchlist |
+| `RP` | Remove from portfolio |
+| `NP` | New portfolio |
+| `NW` | New watchlist |
+| `R` | Refresh current ticker |
+| `RA` | Refresh all |
+| `IB` | Import from Interactive Brokers |
+| `S` | Open settings |
+
+## Architecture
+
+Everything is a plugin. Core features use the same `GloomPlugin` interface as external extensions.
+
+```
+src/
+  plugins/
+    registry.ts          # OpenTUI slot-based plugin system
+    pane-manager.ts      # Customizable pane layout
+    builtin/
+      portfolio-list.tsx # Left pane (portfolios + watchlists)
+      ticker-detail.tsx  # Right pane (overview, financials, chart, notes)
+      ibkr-flex.tsx      # IBKR Flex Query broker plugin
+      manual-entry.tsx   # Manual position entry
+  sources/
+    yahoo-finance.ts     # Yahoo Finance client with retry + caching
+  data/
+    markdown-store.ts    # Ticker markdown file read/write
+    sqlite-cache.ts      # Bun SQLite cache for Yahoo data
+```
+
+### Plugin Slots
+
+Plugins can extend the UI through defined slots:
+
+- `detail:tab` / `detail:section` - Add tabs or sections to the detail pane
+- `list:column` - Custom columns in the ticker list
+- `command:extra` / `command:preset` - Extend the command bar
+- `status:widget` - Status bar widgets
+- `config:section` - Settings page sections
+- `data:post-refresh` / `data:enricher` - Hook into data lifecycle
+
+### Planned Plugins
+
+- News feed pane
+- Chat component
+- Option chain viewer
+- Analyst ratings
+- Tweet/social scanner
+- Crypto feeds
+- Custom columns (conviction score, etc.)
+- Live stock feeds
+
+## Data Storage
+
+| Data | Storage | Why |
+|------|---------|-----|
+| Ticker metadata, positions, notes | Markdown files | Agent-readable, version-controllable |
+| Yahoo Finance cache | SQLite (`bun:sqlite`) | Fast TTL-based lookup |
+| Exchange rates | SQLite | Cached with 1hr TTL |
+| Price history | SQLite | Large dataset, bad fit for markdown |
+| App config | `config.json` | User settings |
+
+## Requirements
+
+- [Bun](https://bun.sh) runtime
+- A terminal with true color support
+
+## License
+
+MIT

package/install.mjs

@@ -0,0 +1,69 @@
+import { createWriteStream, chmodSync, mkdirSync, existsSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import https from "https";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Skip when running in the source repo (dev install)
+const pkg = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf-8"));
+if (pkg.dependencies) process.exit(0);
+const REPO = "vincelwt/gloomberb";
+
+const platform = process.platform;
+const arch = process.arch;
+
+const osMap = { darwin: "darwin", linux: "linux" };
+const archMap = { arm64: "arm64", x64: "x64" };
+
+const os = osMap[platform];
+let cpu = archMap[arch];
+
+if (!os || !cpu) {
+  console.error(`Unsupported platform: ${platform}-${arch}`);
+  process.exit(1);
+}
+
+// macOS x64 uses arm64 binary (runs via Rosetta 2)
+if (os === "darwin" && cpu === "x64") {
+  cpu = "arm64";
+}
+
+const asset = `gloomberb-${os}-${cpu}`;
+const binDir = join(__dirname, "bin");
+const binPath = join(binDir, "gloomberb");
+
+if (!existsSync(binDir)) {
+  mkdirSync(binDir, { recursive: true });
+}
+
+const url = `https://github.com/${REPO}/releases/latest/download/${asset}`;
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    https.get(url, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return download(res.headers.location).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`Download failed: HTTP ${res.statusCode}`));
+      }
+      const file = createWriteStream(binPath);
+      res.pipe(file);
+      file.on("finish", () => {
+        file.close();
+        chmodSync(binPath, 0o755);
+        resolve();
+      });
+      file.on("error", reject);
+    }).on("error", reject);
+  });
+}
+
+console.log(`Downloading ${asset}...`);
+download(url)
+  .then(() => console.log("gloomberb installed successfully."))
+  .catch((err) => {
+    console.error("Failed to download gloomberb binary:", err.message);
+    process.exit(1);
+  });

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "gloomberb",
+  "version": "0.1.0",
+  "description": "Bloomberg-style stock portfolio tracker for the terminal",
+  "module": "src/index.tsx",
+  "type": "module",
+  "bin": {
+    "gloomberb": "bin/gloomberb"
+  },
+  "files": [
+    "bin",
+    "install.mjs"
+  ],
+  "scripts": {
+    "dev": "bun run --watch src/index.tsx",
+    "build": "bun run scripts/build.ts",
+    "build:all": "bun run scripts/build.ts --all",
+    "postinstall": "node install.mjs"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vincelwt/gloomberb"
+  },
+  "keywords": [
+    "terminal",
+    "tui",
+    "stocks",
+    "portfolio",
+    "bloomberg",
+    "finance"
+  ],
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@opentui-ui/dialog": "^0.1.2",
+    "@opentui/core": "^0.1.90",
+    "@opentui/react": "^0.1.90",
+    "gray-matter": "^4.0.3",
+    "react": "^19.2.4",
+    "yahoo-finance2": "^3.13.2"
+  }
+}