agent-finance-cli-linux-arm64 0.4.0 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-finance-cli-linux-arm64",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Prebuilt linux/arm64 binary for agent-finance.",
   "license": "MIT OR Apache-2.0",
   "repository": {

package/skill-data/core/SKILL.md

@@ -21,7 +21,7 @@ For an interactive live cockpit, use:
 agent-finance tui --symbols AAPL,CRDO,BTCUSDT
 ```
 
-Prefer structured `market ... --json` commands for agent data collection. The TUI is an interactive cockpit for live monitoring and guided exploration, with quote, history, crypto evidence, research, Polymarket, provider health, task log, mouse focus, docked-column drag resize, floating-corner resize, close/restore panel controls, and an executable command palette; it is not a machine extraction surface.
+Prefer structured `market ... --json` commands for agent data collection. The TUI is an interactive cockpit for live monitoring and guided exploration, with quote, history, crypto evidence, research, Polymarket, provider health, task log, mouse focus, docked-column drag resize, floating-corner resize, close/restore panel controls, an executable command palette, and an OHLCV chart workbench with draft-only ticket fills, single-leg protective ticket drafts, and draft-only protective OCO planning slots from selected reference lines; it is not a machine extraction surface.
 The TUI persists watchlist and layout state to TOML by default; use `--no-persist` for one-off sessions.
 
 ## Task Router
@@ -34,6 +34,7 @@ agent-finance skills get crypto
 agent-finance skills get prediction-markets
 agent-finance skills get providers
 agent-finance skills get profile
+agent-finance skills get tui
 ```
 
 Load a narrow skill before task-specific commands. Use `skills get core --full` when you need the extended command map.
@@ -121,6 +122,7 @@ agent-finance audit export --json
 - Use both daily and minute history before judging fills, limit-order quality, stop placement, or intraday action.
 - Use `market providers --json` for a machine-readable capability matrix.
 - Use `capabilities --json` for the unified terminal surface, including account/order/transfer/futures-state safety boundaries.
+- Use `skills get tui` before relying on the interactive cockpit, chart workbench, account overlays, selected reference line copy, protective chart drafts, or chart-guided draft ticket workflow.
 - Treat crypto as 24/7 market data. Use Binance/Coinbase/OKX/CoinGecko through capability-first crypto commands, then force providers only for cross-checking.
 - Spot is crypto spot; USD-M futures / TradFi perps are derivatives and proxy instruments.
 - Treat Polymarket as quantifiable prediction-market sentiment and event-probability evidence only; it is not an equity quote or primary-source fact.

package/skill-data/core/references/command-map.md

@@ -13,12 +13,25 @@ agent-finance skills get providers
 agent-finance skills get crypto
 agent-finance skills get prediction-markets
 agent-finance skills get history-indicators
+agent-finance skills get tui
 agent-finance tui --symbols AAPL,CRDO,BTCUSDT
 ```
 
-Use the TUI as an interactive cockpit for live monitoring and guided exploration across quote, history, crypto evidence, research, Polymarket, provider health, task log, mouse focus, docked-column drag resize, floating-corner resize, close/restore panel controls, and an executable command palette. Use structured `market ... --json` commands when an agent needs parseable data.
+Use the TUI as an interactive cockpit for live monitoring and guided exploration across quote, history, crypto evidence, research, Polymarket, provider health, task log, mouse focus, docked-column drag resize, floating-corner resize, close/restore panel controls, executable command palette, and the OHLCV chart workbench. Load `skills get tui` before relying on chart workbench interactions. Use structured `market ... --json` commands when an agent needs parseable data.
 It persists watchlist and layout state to TOML by default; add `--no-persist` for disposable sessions.
 
+## TUI Chart Workbench
+
+```bash
+agent-finance tui --symbols CRDO,LITE,AAOI --chart-preset auto
+agent-finance tui --symbols BTC/USDT,ETH/USDT --chart-preset 1d
+agent-finance skills get tui
+```
+
+Focus History and press `z` for the full chart workbench. Use hover for crosshair and O/H/L/C/V tooltip, wheel to zoom, drag to zoom into a selected window, `h`/`l` or arrows to move the cursor, `j`/`k` to select visible reference lines, `Enter` to copy the selected reference line price into the order ticket draft, `[`/`]` to zoom, number preset actions to switch chart range, and command palette actions for refresh, preset switching, reset zoom, overlay toggles, copying chart reference prices to the order ticket, preparing single-leg stop-loss or take-profit ticket drafts, and adding selected reference lines to the draft-only protective OCO plan.
+
+The chart can show OHLCV candles, volume, MA20, MA50, VWAP, current price, previous close, day open/high/low, open-order lines, and position entry lines when the provider and local snapshots provide those fields. Clicking a chart price fills a draft ticket only; it must still pass stage, review, risk, and live confirmation before any signed exchange write.
+
 ## Price and Sessions
 
 ```bash

package/skill-data/tui/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: tui
+description: Use the agent-finance terminal cockpit for live watchlists, OHLCV candlestick workbench, chart presets, mouse/keyboard navigation, provider status, account overlays, and draft-only trading workflows.
+---
+
+# agent-finance TUI skill
+
+Use the TUI when the task is live monitoring, visual comparison, chart-guided investigation, or cautious trade preparation. Use structured `market ... --json` commands when another agent needs parseable data.
+
+## Launch
+
+```bash
+agent-finance tui --symbols AAPL,CRDO,BTCUSDT
+agent-finance tui --symbols CRDO,LITE,AAOI --chart-preset auto
+agent-finance tui --symbols BTC/USDT,ETH/USDT --chart-preset 1d
+agent-finance tui --symbols CRDO --profile default
+agent-finance tui --symbols CRDO --no-persist
+```
+
+The TUI persists the watchlist, focused panel, docked panel set, column layout, floating panes, refresh cadence, chart preset, and provider preferences to TOML unless `--no-persist` is used.
+
+## Chart Workbench
+
+- Focus the History panel and press `z` to enter or leave the full chart workbench.
+- The chart uses OHLCV candles when the provider returns open/high/low/close data.
+- If only close prices are available, treat the chart as degraded and verify the provider/session before drawing trading conclusions.
+- The workbench shows volume, MA20, MA50, VWAP, current price, previous close, day open, day high, day low, open-order lines, and position entry lines when the local snapshots contain them.
+- Visible reference lines are selectable trading aids. Use `j` / `k` to select a line such as current price, previous close, day open, day high, day low, an open order, or a position entry; press `Enter` to copy that line price into the order ticket draft.
+- The command palette can turn the selected chart reference line into a single-leg stop-loss or take-profit ticket draft. It can also add selected reference lines into the ticket's protective OCO draft slots. OCO draft slots are planning state only; they do not stage, submit, or bypass the existing ticket review flow.
+- The title and warnings are part of the evidence: read provider, session, interval, range, fetched time, and fallback notes before acting.
+- Chart presets are provider-aware. Crypto auto starts from a 24h/1m view; aggregator-style providers can be reduced to a coarser provider window such as 7d/provider-auto-7d, so rely on the displayed source line rather than the preset label alone.
+
+## Mouse
+
+- Hover a candle column for crosshair and O/H/L/C/V tooltip.
+- Wheel inside the History chart to zoom the time window.
+- Drag across the chart to zoom into the selected window.
+- Click a chart price to fill the order ticket reference price. This only edits a draft; it must still pass stage, review, risk, and live confirmation before any exchange write.
+- Use mouse focus, panel close/restore controls, docked-column drag resize, and floating-corner resize for layout work.
+
+## Keyboard
+
+- `h` / `l` or left / right moves the chart cursor.
+- `j` / `k` or down / up cycles through visible price, order, and position reference lines.
+- `Enter` copies the selected reference line price into the order ticket draft. It does not stage, submit, or enable live writes.
+- `[` / `]` zooms the chart window.
+- Number preset actions switch chart ranges.
+- `r` refreshes history for the selected symbol.
+- Open the command palette to search chart actions such as preset changes, chart refresh, reset zoom, toggle overlays, copying the selected chart reference price to the ticket, preparing single-leg stop-loss or take-profit drafts, and adding selected reference lines to the protective OCO draft.
+
+## Trading Boundary
+
+The chart can prepare an order ticket but must not submit anything by itself. For signed workflows, load:
+
+```bash
+agent-finance skills get profile --full
+```
+
+Then use the profile, intent, risk, confirmation, and audit path. Live writes are gated separately from chart exploration.
+
+## Evidence Rules
+
+- For trading, stop-loss, take-profit, or limit-order decisions, inspect both daily and minute history.
+- Do not mix chart providers silently. If a provider falls back or maps a preset to another interval/range, record the actual provider and request shape.
+- Treat account/order/position overlays as local snapshot evidence. If the account snapshot is stale, refresh it before relying on the overlay.
+- Use `market price`, `market sessions`, and `market history --json` to capture structured evidence after visual TUI exploration.