agent-finance-cli 0.1.0

package/npm/resolve-binary.js

@@ -0,0 +1,38 @@
+const fs = require("node:fs");
+const path = require("node:path");
+
+const { executableName, localBuildBinary, platformPackageName } = require("./platform");
+
+function resolveBinary(options = {}) {
+  const root = path.resolve(__dirname, "..");
+  const packageName = platformPackageName();
+
+  if (packageName) {
+    try {
+      const packageJson = require.resolve(`${packageName}/package.json`, {
+        paths: [root],
+      });
+      const binary = path.join(path.dirname(packageJson), "bin", executableName());
+      if (fs.existsSync(binary)) {
+        return binary;
+      }
+    } catch (error) {
+      if (!isMissingPackage(error) && !options.silent) {
+        throw error;
+      }
+    }
+  }
+
+  const fallback = localBuildBinary(root);
+  if (fs.existsSync(fallback)) {
+    return fallback;
+  }
+
+  return undefined;
+}
+
+function isMissingPackage(error) {
+  return error && error.code === "MODULE_NOT_FOUND";
+}
+
+module.exports = { resolveBinary };

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "agent-finance-cli",
+  "version": "0.1.0",
+  "description": "AI Agent-first CLI for no-key financial market data and research context.",
+  "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/M4n5ter/agent-finance-cli.git"
+  },
+  "homepage": "https://github.com/M4n5ter/agent-finance-cli#readme",
+  "bugs": {
+    "url": "https://github.com/M4n5ter/agent-finance-cli/issues"
+  },
+  "bin": {
+    "agent-finance": "bin/agent-finance.js"
+  },
+  "files": [
+    "bin/",
+    "npm/",
+    "skills/",
+    "src/",
+    "Cargo.toml",
+    "Cargo.lock",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "scripts": {
+    "postinstall": "node npm/postinstall.js",
+    "prepack": "cargo fmt --check && cargo clippy --all-targets && cargo test --locked",
+    "check:npm": "node npm/check-package.js"
+  },
+  "optionalDependencies": {
+    "agent-finance-cli-darwin-arm64": "0.1.0",
+    "agent-finance-cli-darwin-x64": "0.1.0",
+    "agent-finance-cli-linux-arm64": "0.1.0",
+    "agent-finance-cli-linux-x64": "0.1.0",
+    "agent-finance-cli-win32-x64": "0.1.0"
+  },
+  "keywords": [
+    "finance",
+    "market-data",
+    "cli",
+    "ai-agent",
+    "yahoo-finance",
+    "sec-edgar"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/core-full.md

@@ -0,0 +1,74 @@
+# agent-finance full core skill
+
+Read this when you need the full command map for `agent-finance`.
+
+## Command Map
+
+```bash
+agent-finance skills list
+agent-finance skills get core
+agent-finance skills get price
+agent-finance skills get research-data
+agent-finance skills get providers
+agent-finance skills get history-indicators
+agent-finance skills get futures
+```
+
+## Price and Sessions
+
+```bash
+agent-finance price CRDO
+agent-finance price CRDO MRVL --json
+agent-finance sessions CRDO
+agent-finance sessions LITE --proxy-symbol LITEUSDT
+```
+
+`price` answers the default current-price question. `sessions` compares regular/pre/post/overnight/provider/proxy sources.
+
+## History and Indicators
+
+```bash
+agent-finance history CRDO --range 1mo --interval 1d
+agent-finance history CRDO --range 5d --interval 1m --session extended --adjustment raw --no-actions
+agent-finance history CRDO --range 1y --interval 1d --adjustment auto --repair
+agent-finance indicators CRDO MRVL --limit 120
+```
+
+Use history before making order, fill, stop-loss, take-profit, or intraday trend judgments. Indicators are summaries; they do not replace the bar path.
+
+## Research Data
+
+```bash
+agent-finance fundamentals CRDO
+agent-finance fundamentals CRDO --provider sec-edgar
+agent-finance fundamentals CRDO --provider robinhood
+agent-finance fundamentals CRDO --provider cnbc
+agent-finance analysis CRDO
+agent-finance options CRDO
+agent-finance options CRDO --provider robinhood --count 80
+agent-finance ownership CRDO
+agent-finance events CRDO --provider sec-edgar
+agent-finance news CRDO
+agent-finance read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
+agent-finance search "optical interconnect"
+agent-finance screen day_gainers
+```
+
+Research reports include sources, modules, coverage gaps, highlights, and raw payloads in JSON mode.
+
+## Providers and Proxy Data
+
+```bash
+agent-finance providers
+agent-finance providers --json
+agent-finance futures SPCXUSDT
+agent-finance futures LITEUSDT --json
+```
+
+Use `providers` as the source-of-truth coverage matrix. Binance futures / TradFi perps are derivative/proxy prices, not legal equity or broker-fill prices.
+
+## Network and Browser Boundaries
+
+The CLI respects `--proxy`, `AGENT_FINANCE_PROXY`, and standard proxy environment variables. It does not hardcode a local proxy.
+
+`read-url` is a text extraction fallback. For dynamic, login-gated, screenshot-sensitive, or noisy pages, open the original page with an available real browser tool such as agent-browser or opencli.

package/skills/core.md

@@ -0,0 +1,59 @@
+# agent-finance core skill
+
+This skill is printed by the `agent-finance` CLI. It is the first thing an AI Agent should read before using the tool.
+
+## Start Here
+
+```bash
+agent-finance skills list
+agent-finance skills get core --full
+agent-finance providers
+```
+
+## Default Workflow
+
+1. Current observable price:
+
+```bash
+agent-finance price CRDO
+agent-finance price CRDO --json
+```
+
+2. Precise session/provider split:
+
+```bash
+agent-finance sessions CRDO
+agent-finance sessions LITE --proxy-symbol LITEUSDT
+```
+
+3. History before a trading or order-quality conclusion:
+
+```bash
+agent-finance history LITE --interval 1d --range 1mo --adjustment auto --limit 30
+agent-finance history LITE --interval 1m --range 5d --session extended --adjustment raw --no-actions --limit 120
+```
+
+4. Research data:
+
+```bash
+agent-finance fundamentals CRDO
+agent-finance fundamentals CRDO --provider sec-edgar
+agent-finance analysis CRDO
+agent-finance options CRDO
+agent-finance ownership CRDO
+agent-finance events CRDO --provider sec-edgar
+agent-finance news CRDO
+agent-finance read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
+agent-finance search "optical interconnect"
+agent-finance screen day_gainers
+```
+
+## Rules
+
+- Use `price` for the default "what is the current price?" answer.
+- Use `sessions` when premarket, postmarket, overnight, BOATS, provider differences, or proxy prices matter.
+- Use both daily and minute history before judging fills, limit-order quality, stop placement, or intraday action.
+- Use `providers --json` when an Agent needs a machine-readable capability matrix.
+- Treat Binance futures / TradFi perps as proxy/derivative price discovery only.
+- `read-url` is a text extraction fallback, not a real browser. For dynamic, login-gated, screenshot-sensitive, or noisy pages, use an available browser tool such as agent-browser or opencli.
+- JSON output preserves structured fields for downstream computation. Human output is for quick inspection.

package/skills/futures.md

@@ -0,0 +1,18 @@
+# agent-finance futures and proxy skill
+
+Use this for Binance USD-M futures / TradFi perps such as `SPCXUSDT` and `LITEUSDT`.
+
+```bash
+agent-finance futures SPCXUSDT --funding-limit 8
+agent-finance futures LITEUSDT --funding-limit 8 --json
+```
+
+Fields:
+
+- `last_price`: latest 24h ticker trade price.
+- `mark_price`: risk and funding reference price.
+- `index_price`: index reference price.
+- `funding`: funding rate.
+- `open_interest`: open interest.
+
+Risk rule: proxy/perpetual contracts are derivatives. They are not the legal equity, pre-IPO ownership, or broker-fill price.

package/skills/history-indicators.md

@@ -0,0 +1,42 @@
+# agent-finance history and indicators skill
+
+## History
+
+```bash
+agent-finance history LITE --provider auto --interval 1d --range 1mo --limit 30
+agent-finance history LITE --interval 1m --range 5d --session extended --adjustment raw --no-actions --limit 200
+agent-finance history LITE --interval 1d --range 1y --adjustment auto --repair --limit 252
+agent-finance history AAPL --provider robinhood --interval 5m --range 1d --session extended --limit 80
+agent-finance history LITEUSDT --provider binance-futures --interval 1d --limit 30
+```
+
+## Intervals
+
+- Yahoo / Yahoo extended: `1m`, `2m`, `5m`, `15m`, `30m`, `60m`, `90m`, `1h`, `1d`, `5d`, `1wk`, `1mo`, `3mo`.
+- Robinhood: `5m`, `10m`, `1h`, `1d`, `1w`.
+- Stooq live: `1d`, `1w`, `1mo`.
+- Stooq bulk cache: `5m`, `1h` after explicit import.
+- Binance futures / TradFi proxy: `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `8h`, `12h`, `1d`, `3d`, `1w`, `1M`.
+
+When unsure:
+
+```bash
+agent-finance history --help
+agent-finance stooq sync --help
+```
+
+## Adjustments
+
+- `--adjustment auto`: adjust OHLC and close using adjusted close.
+- `--adjustment back`: adjust OHLC but keep raw close.
+- `--adjustment raw`: keep raw OHLC and expose adjusted close separately.
+- `--repair`: repair obvious 100x Yahoo price errors and mark repaired bars.
+
+## Indicators
+
+```bash
+agent-finance indicators LITE AAOI --provider auto --limit 120
+agent-finance indicators CRDO MRVL --session extended --interval 1m --range 5d --limit 200
+```
+
+Indicators are summaries. For fill quality, limit-order decisions, or intraday exits, inspect daily and minute bars directly.

package/skills/price.md

@@ -0,0 +1,40 @@
+# agent-finance price skill
+
+## Default Price
+
+Use `price` to answer "what is it trading at now?":
+
+```bash
+agent-finance price CRDO
+agent-finance price CRDO --json
+```
+
+The default output includes current observable price, session, provider, local timestamp, UTC fields in JSON, change from regular-market previous close, and regular-market open/high/low/volume when available.
+
+## Session Split
+
+Use `sessions` when the task asks about premarket, postmarket, overnight, BOATS, platform 24h prices, or provider disagreement:
+
+```bash
+agent-finance sessions CRDO
+agent-finance sessions LITE --proxy-symbol LITEUSDT
+```
+
+## Proxy Prices
+
+If a Binance TradFi / futures contract exists, add `--proxy-symbol`:
+
+```bash
+agent-finance sessions SPCX --proxy-symbol SPCXUSDT
+```
+
+Proxy prices are price-discovery and sentiment signals. They are not the legal equity, pre-IPO ownership, or broker-fill price.
+
+## Streaming
+
+```bash
+agent-finance stream CRDO --messages 5
+agent-finance watch CRDO --interval-seconds 15 --iterations 4
+```
+
+Use `watch` when WebSocket streaming is blocked by the local network.

package/skills/providers.md

@@ -0,0 +1,25 @@
+# agent-finance providers skill
+
+## Capability Matrix
+
+Always inspect provider coverage instead of guessing from provider names:
+
+```bash
+agent-finance providers
+agent-finance providers --json
+```
+
+## Provider Rules
+
+- Quotes: use `price SYMBOL` first. Only force a provider when cross-checking.
+- Session split: use `sessions SYMBOL`.
+- History: use `history --provider auto|yahoo|stooq|robinhood|binance-futures`.
+- Research: `fundamentals/events --provider auto` combines useful no-key sources when available.
+- SEC EDGAR is official for filings and XBRL facts, not market quotes, options, analyst estimates, or news aggregation.
+- Robinhood and CNBC are partial no-key sources; use them as cross-checks, not replacements for official filings or primary disclosures.
+- Stooq live can provide no-key daily/weekly/monthly history; intraday bulk data requires explicit imported ZIP cache.
+- Binance futures / TradFi perps are proxy/derivative instruments.
+
+## Browser Boundary
+
+The CLI uses HTTP requests with browser-like TLS behavior where possible, but it is not a full browser. Dynamic, login-gated, screenshot-sensitive, or noisy pages require a real browser tool.

package/skills/research-data.md

@@ -0,0 +1,34 @@
+# agent-finance research data skill
+
+## Commands
+
+```bash
+agent-finance fundamentals CRDO
+agent-finance fundamentals CRDO --provider sec-edgar
+agent-finance fundamentals CRDO --provider robinhood
+agent-finance fundamentals CRDO --provider cnbc
+agent-finance analysis CRDO
+agent-finance options CRDO
+agent-finance options CRDO --provider robinhood --count 80
+agent-finance ownership CRDO
+agent-finance events CRDO --provider sec-edgar
+agent-finance news CRDO
+agent-finance read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
+agent-finance search "optical interconnect"
+agent-finance screen most_actives
+```
+
+## Output Rules
+
+- Human mode prints a compact table.
+- `--json` preserves sources, modules, coverage gaps, highlights, and raw payloads.
+- `--raw` prints raw payloads in human mode.
+- `--refresh` skips cache.
+- `--cache-ttl-seconds <N>` changes non-price cache TTL.
+- `read-url --provider auto` tries direct/Jina/Defuddle readers and reports fallback errors.
+
+## Research Rules
+
+- Treat social media, search snippets, and extracted web text as leads until confirmed by primary sources.
+- Use SEC/company filings for official facts when available.
+- Use a real browser for dynamic, login-gated, table-layout-sensitive, or extraction-suspicious pages.