alpha-visualizer 0.3.0__tar.gz → 0.4.0__tar.gz

{alpha_visualizer-0.3.0 → alpha_visualizer-0.4.0}/.github/workflows/lighthouse.yml

@@ -54,20 +54,20 @@ jobs:
         working-directory: frontend
         run: pnpm run build
 
-      - name: Start vis serve
+      - name: Start alpha-vis serve
         run: |
-          uv run vis serve \
+          uv run alpha-vis serve \
             --forge-dir frontend/e2e/fixtures/forge \
             --port 8123 &
           # 起動待機（最大 30 秒）
           for i in $(seq 1 30); do
             if curl -fsS http://127.0.0.1:8123/health > /dev/null 2>&1; then
-              echo "vis serve is up"
+              echo "alpha-vis serve is up"
               exit 0
             fi
             sleep 1
           done
-          echo "::error::vis serve did not start within 30s"
+          echo "::error::alpha-vis serve did not start within 30s"
           exit 1
 
       - name: Run Lighthouse CI

alpha_visualizer-0.3.0/.hypothesis/constants/069853a4f8389a49 → alpha_visualizer-0.4.0/.hypothesis/constants/11405f641e79317e

@@ -1,4 +1,4 @@
 # file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/forge_config.py
 # hypothesis_version: 6.152.4
 
-['FORGE_CONFIG', 'backtest_results.db', 'data', 'db_filename', 'forge.yaml', 'ideas', 'ideas.json', 'ideas_path', 'live', 'output_path', 'path', 'report', 'results', 'strategies', 'strategies.db', 'use_db', 'utf-8']
+['FORGE_CONFIG', 'backtest_results.db', 'data', 'db_filename', 'forge.yaml', 'historical', 'ideas', 'ideas.json', 'ideas_path', 'live', 'output_path', 'path', 'report', 'results', 'storage_path', 'strategies', 'strategies.db', 'use_db', 'utf-8']

alpha_visualizer-0.4.0/.hypothesis/constants/14f71fc9be9bf497

@@ -0,0 +1,4 @@
+# file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/services/backtest.py
+# hypothesis_version: 6.152.4
+
+[0.0, 1.0, 100.0, '+00:00', '-', '1d', 'Z', 'aggregates', 'annual_returns', 'avg_holding_days', 'build_detail', 'buy_hold_curve', 'buy_hold_equity', 'cagr_pct', 'calmar_ratio', 'compute_drawdown', 'daily_returns', 'date', 'dates', 'direction', 'drawdown', 'end', 'entry_date', 'entry_price', 'equity', 'equity_curve', 'exit_date', 'exit_price', 'filter_by_since', 'holding_days', 'id', 'index', 'is_cutoff', 'is_metrics', 'label_names', 'long', 'mae_pct', 'max_drawdown_pct', 'metrics', 'mfe_pct', 'monthly_returns', 'n_states', 'oos_metrics', 'oos_start', 'parse_dt', 'per_trade_mae_pct', 'per_trade_mfe_pct', 'period', 'periods', 'pnl', 'profit_factor', 'regime_breakdown', 'regime_series', 'return_pct', 'row_to_dict', 'run_at', 'run_id', 'shape_annual_returns', 'shape_equity', 'shape_regime_series', 'shape_trades', 'sharpe_ratio', 'short', 'signal', 'sl_price', 'sortino_ratio', 'split_metrics', 'start', 'states', 'strategy_id', 'strategy_name', 'summarize_row', 'symbol', 'timeframe', 'total_return_pct', 'total_trades', 'tp_price', 'trade_analysis', 'trades', 'value', 'values', 'win_rate_pct']

alpha_visualizer-0.4.0/.hypothesis/constants/4720ae237de2a683

@@ -0,0 +1,4 @@
+# file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/services/historical.py
+# hypothesis_version: 6.152.4
+
+['\x00', '%Y-%m-%d', '%Y-%m-%dT%H:%M:%S', '..', '/', 'Close', 'High', 'Low', 'Open', 'Volume', '\\', 'close', 'coerce', 'high', 'low', 'open', 'symbol が空です', 'time', 'volume']

alpha_visualizer-0.4.0/.hypothesis/constants/4726660442f99a00

@@ -0,0 +1,4 @@
+# file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/schemas/historical.py
+# hypothesis_version: 6.152.4
+
+['allow']

alpha_visualizer-0.3.0/.hypothesis/constants/7b2b6a48db4df50a → alpha_visualizer-0.4.0/.hypothesis/constants/6d12ac81de32365c

@@ -1,4 +1,4 @@
 # file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/__init__.py
 # hypothesis_version: 6.152.4
 
-['0.3.0']
+['0.4.0']

alpha_visualizer-0.4.0/.hypothesis/constants/ab4df659c6b192db

@@ -0,0 +1,4 @@
+# file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/routers/historical.py
+# hypothesis_version: 6.152.4
+
+['/historical/{symbol}', '1d', 'bars', 'interval', 'router', 'symbol']

{alpha_visualizer-0.3.0 → alpha_visualizer-0.4.0}/CHANGELOG.md

@@ -3,6 +3,33 @@
 alpha-visualizer の全バージョン変更履歴です。
 
 
+## [0.4.0] - 2026-05-17
+
+### Features
+
+- **TradingView lightweight-charts による「シグナル時系列」セクションを `StrategyScreen` に新規追加** (#191, #186, #197)
+  - OHLC ローソク + entry / exit markers (long/short × win/loss で 4 色分け) + SL / TP / entry の priceLine（focus trade は open trade 優先、無ければ最新 closed）
+  - regime 切替点に circle marker（`?tv=1` ON 時、`BacktestDetail.regime_series` 経由）
+  - `chart.takeScreenshot()` による PNG export ハンドル
+  - feature flag `?tv=1` OFF 時は実験機能 placeholder
+  - Storybook 6 stories（AtelierClosedTrades / LabOpenTrade / SLHit / TPHit / DenseMarkers / WithRegime）
+- **OHLC 時系列 API** `GET /api/historical/{symbol}?interval=1d&start=&end=` を追加 (#189)
+  - `{symbol}_{interval}.parquet` を読んで lightweight-charts 互換の bars 配列を返す
+  - `ForgeConfig.historical_dir` を `forge.yaml` の `data.storage_path` から解決（既定 `<forge_dir>/data/historical`）
+  - 依存 `pyarrow>=15.0` を追加
+- **`schemas/results.Trade` に `exit_price` / `sl_price` / `tp_price` を追加** (#189)
+  - alpha-forge の `_calc_trade_list` 拡張（ysakae/alpha-forge#751）の出力を透過 pickup
+- **frontend `api.getHistorical(symbol, interval, range?)` と `useStrategyHistorical(symbol)` フック追加** (#190)
+  - `useFetchByKey` ベースの薄いラッパー、interval 切替時の再 fetch にも対応
+
+### Fixes
+
+- **trades のソースを `metrics_json.trades` 優先に切替** (#198)
+  - alpha-forge は trades を 2 経路で保存（`metrics_json.trades` は snake_case、`trades_json` 列は vectorbt records_readable の PascalCase）
+  - 旧実装は PascalCase 列のみ参照しており `shape_trades` が値を読めず、実 backtest 結果で entry/exit markers / exit_price / sl_price / tp_price が常に機能しなかった
+  - snake_case → PascalCase の優先順位で解決し、新規・既存両方の backtest 結果で markers / priceLine が描画されるよう修正
+
+
 ## [0.3.0] - 2026-05-16
 
 ### ⚠️  Breaking Changes

{alpha_visualizer-0.3.0 → alpha_visualizer-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpha-visualizer
-Version: 0.3.0
+Version: 0.4.0
 Summary: Web visualization tool for AlphaForge backtest results
 Project-URL: Homepage, https://github.com/alforge-labs/alpha-visualizer
 Project-URL: Repository, https://github.com/alforge-labs/alpha-visualizer
@@ -23,6 +23,7 @@ Requires-Python: >=3.12
 Requires-Dist: click>=8.1
 Requires-Dist: fastapi>=0.115
 Requires-Dist: pandas>=2.0
+Requires-Dist: pyarrow>=15.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.0
 Requires-Dist: sqlalchemy>=2.0

{alpha_visualizer-0.3.0 → alpha_visualizer-0.4.0}/frontend/e2e/fixtures/forge/forge.yaml

@@ -7,3 +7,5 @@ strategies:
   use_db: false
 ideas:
   ideas_path: ./data/ideas
+data:
+  storage_path: ./data/historical

alpha_visualizer-0.4.0/frontend/e2e/screenshots/strategy-signal-tv.spec.ts

@@ -0,0 +1,49 @@
+import { test } from '@playwright/test'
+import { mkdir } from 'node:fs/promises'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { clearViewerSettings } from '../helpers/locators'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+/**
+ * issue #191 — StrategyScreen の `<SignalChartCard>` (TV candlestick + markers + priceLine)
+ * を `?tv=1` で有効化して撮影。
+ *
+ * 出力先: <repo-root>/docs/screenshots/{ja,en}/strategy-signal-tv.png
+ */
+
+const STRATEGY_ID = 'sma_cross'
+const SCREENSHOT_DIR = resolve(__dirname, '../../../docs/screenshots')
+
+async function ensureDir(filePath: string): Promise<void> {
+  await mkdir(dirname(filePath), { recursive: true })
+}
+
+test.describe.serial('StrategySignalChartTV スクリーンショット', () => {
+  for (const lang of ['ja', 'en'] as const) {
+    test(`strategy-signal-tv (${lang})`, async ({ page }) => {
+      await clearViewerSettings(page)
+      const suffix = `?tv=1${lang === 'en' ? '&lang=en' : ''}`
+      await page.goto(`/detail/${STRATEGY_ID}${suffix}`)
+      await page.waitForLoadState('networkidle')
+
+      // Strategy タブをクリックして SignalChartCard を表示させる
+      const tabName = lang === 'ja' ? '戦略構成' : 'Strategy'
+      const tab = page.getByRole('tab', { name: tabName }).first()
+      if (await tab.count()) {
+        await tab.click()
+      }
+
+      // SignalChartCard の chart コンテナを待つ
+      await page.locator('[data-testid="strategy-signal-chart-tv"]').waitFor()
+      // チャート描画完了の余裕（lightweight-charts の Canvas 初期化）
+      await page.waitForTimeout(300)
+
+      const out = resolve(SCREENSHOT_DIR, lang, 'strategy-signal-tv.png')
+      await ensureDir(out)
+      await page.screenshot({ path: out })
+    })
+  }
+})

{alpha_visualizer-0.3.0 → alpha_visualizer-0.4.0}/frontend/openapi.json

@@ -502,6 +502,89 @@
         }
       }
     },
+    "/api/historical/{symbol}": {
+      "get": {
+        "summary": "Get Historical",
+        "description": "指定 symbol × interval の OHLC ローソク足を返す。\n\n404: historical_dir 不在 or parquet ファイル不在\n400: symbol が不正、または start/end の形式不正",
+        "operationId": "get_historical_api_historical__symbol__get",
+        "parameters": [
+          {
+            "name": "symbol",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "title": "Symbol"
+            }
+          },
+          {
+            "name": "interval",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "pattern": "^(1m|2m|5m|15m|30m|60m|90m|1h|4h|1d|5d|1wk|1mo|3mo)$",
+              "default": "1d",
+              "title": "Interval"
+            }
+          },
+          {
+            "name": "start",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Start"
+            }
+          },
+          {
+            "name": "end",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "End"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HistoricalResponse"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/health": {
       "get": {
         "summary": "Health",
@@ -844,6 +927,34 @@
         "type": "object",
         "title": "HTTPValidationError"
       },
+      "HistoricalResponse": {
+        "properties": {
+          "symbol": {
+            "type": "string",
+            "title": "Symbol"
+          },
+          "interval": {
+            "type": "string",
+            "title": "Interval"
+          },
+          "bars": {
+            "items": {
+              "$ref": "#/components/schemas/OhlcBar"
+            },
+            "type": "array",
+            "title": "Bars"
+          }
+        },
+        "additionalProperties": true,
+        "type": "object",
+        "required": [
+          "symbol",
+          "interval",
+          "bars"
+        ],
+        "title": "HistoricalResponse",
+        "description": "OHLC 時系列のレスポンスエンベロープ。\n\n`bars` 配列に加えて symbol / interval を返すことで、フロント側で\n複数 symbol のキャッシュを取り違えないよう識別子を付与する。"
+      },
       "Idea": {
         "properties": {
           "idea_id": {
@@ -1300,6 +1411,52 @@
         "title": "LiveTrade",
         "description": "live trades JSON を正規化した 1 件。"
       },
+      "OhlcBar": {
+        "properties": {
+          "time": {
+            "type": "string",
+            "title": "Time"
+          },
+          "open": {
+            "type": "number",
+            "title": "Open"
+          },
+          "high": {
+            "type": "number",
+            "title": "High"
+          },
+          "low": {
+            "type": "number",
+            "title": "Low"
+          },
+          "close": {
+            "type": "number",
+            "title": "Close"
+          },
+          "volume": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Volume"
+          }
+        },
+        "additionalProperties": true,
+        "type": "object",
+        "required": [
+          "time",
+          "open",
+          "high",
+          "low",
+          "close"
+        ],
+        "title": "OhlcBar",
+        "description": "1 本のローソク足 (open / high / low / close + volume)。\n\n`time` は ISO 8601 文字列（日足は ``YYYY-MM-DD``、intraday は\n``YYYY-MM-DDTHH:MM:SS``）。`volume` は無いカラムの parquet では None。"
+      },
       "OptimizationHistoryEntry": {
         "properties": {
           "trial": {
@@ -1924,6 +2081,39 @@
             "title": "Entry Price",
             "default": 0.0
           },
+          "exit_price": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Exit Price"
+          },
+          "sl_price": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Sl Price"
+          },
+          "tp_price": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Tp Price"
+          },
           "return_pct": {
             "type": "number",
             "title": "Return Pct",
@@ -1957,7 +2147,7 @@
           "direction"
         ],
         "title": "Trade",
-        "description": "``BacktestDetail.trades`` の 1 件。"
+        "description": "``BacktestDetail.trades`` の 1 件。\n\n``exit_price`` / ``sl_price`` / ``tp_price`` は TradingView lightweight-charts\nの markers / priceLine 表示用に追加されたフィールド (#189)。\nalpha-forge 側が値を出力していない場合 ``None`` のままになる。"
       },
       "ValidationError": {
         "properties": {

{alpha_visualizer-0.3.0 → alpha_visualizer-0.4.0}/frontend/playwright.config.ts

@@ -32,7 +32,7 @@ export default defineConfig({
     // FORGE_CONFIG が外部 forge.yaml を指しているとフィクスチャが上書きされるので明示クリア。
     // --forge-config も併せて明示することで二重に保護する。
     command:
-      'env FORGE_CONFIG= uv run vis serve --forge-dir frontend/e2e/fixtures/forge --forge-config frontend/e2e/fixtures/forge/forge.yaml --host 127.0.0.1 --port 8123 --no-open',
+      'env FORGE_CONFIG= uv run alpha-vis serve --forge-dir frontend/e2e/fixtures/forge --forge-config frontend/e2e/fixtures/forge/forge.yaml --host 127.0.0.1 --port 8123 --no-open',
     url: `${BASE_URL}/health`,
     cwd: '..',
     reuseExistingServer: !process.env.CI,

{alpha_visualizer-0.3.0 → alpha_visualizer-0.4.0}/frontend/playwright.screenshots.config.ts

@@ -5,7 +5,7 @@ const BASE_URL = `http://127.0.0.1:${PORT}`
 
 /**
  * README / alforge-labs サイト掲載用スクリーンショット撮影専用 config。
- * 既存の e2e フィクスチャを流用して `vis serve` を自動起動し、
+ * 既存の e2e フィクスチャを流用して `alpha-vis serve` を自動起動し、
  * `e2e/screenshots/capture.spec.ts` から各画面を順次撮影する。
  *
  * 出力先: ../docs/screenshots/{ja,en}/<page>.png
@@ -32,7 +32,7 @@ export default defineConfig({
   ],
   webServer: {
     command:
-      'env FORGE_CONFIG= uv run vis serve --forge-dir frontend/e2e/fixtures/forge --forge-config frontend/e2e/fixtures/forge/forge.yaml --host 127.0.0.1 --port 8124 --no-open',
+      'env FORGE_CONFIG= uv run alpha-vis serve --forge-dir frontend/e2e/fixtures/forge --forge-config frontend/e2e/fixtures/forge/forge.yaml --host 127.0.0.1 --port 8124 --no-open',
     url: `${BASE_URL}/health`,
     cwd: '..',
     reuseExistingServer: !process.env.CI,

alpha_visualizer-0.4.0/frontend/src/api/__tests__/client.test.ts

@@ -0,0 +1,101 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { ApiError, api } from '../client'
+import type { HistoricalResponse } from '../types'
+
+/**
+ * `api.getHistorical` の URL 構築と response handling を検証する。
+ * fetch を vi.spyOn で乗っ取り、呼び出し URL と返却値を直接アサートする。
+ */
+describe('api.getHistorical', () => {
+  const sampleResponse: HistoricalResponse = {
+    symbol: 'SPY',
+    interval: '1d',
+    bars: [
+      { time: '2025-01-02', open: 400, high: 405, low: 399, close: 403.5, volume: 1_000_000 },
+    ],
+  }
+
+  let fetchSpy: ReturnType<typeof vi.spyOn>
+
+  beforeEach(() => {
+    fetchSpy = vi.spyOn(globalThis, 'fetch')
+  })
+
+  afterEach(() => {
+    fetchSpy.mockRestore()
+  })
+
+  function mockJsonResponse(body: unknown, status = 200): void {
+    fetchSpy.mockResolvedValueOnce(
+      new Response(JSON.stringify(body), {
+        status,
+        headers: { 'Content-Type': 'application/json' },
+      }),
+    )
+  }
+
+  it('既定 interval=1d で /api/historical/{symbol}?interval=1d を呼ぶ', async () => {
+    mockJsonResponse(sampleResponse)
+
+    const result = await api.getHistorical('SPY')
+
+    expect(fetchSpy).toHaveBeenCalledTimes(1)
+    const url = String(fetchSpy.mock.calls[0]?.[0])
+    expect(url).toBe('/api/historical/SPY?interval=1d')
+    expect(result).toEqual(sampleResponse)
+  })
+
+  it('interval を指定するとクエリに反映される', async () => {
+    mockJsonResponse(sampleResponse)
+
+    await api.getHistorical('AAPL', '1h')
+
+    const url = String(fetchSpy.mock.calls[0]?.[0])
+    expect(url).toBe('/api/historical/AAPL?interval=1h')
+  })
+
+  it('range の start/end がクエリに乗る', async () => {
+    mockJsonResponse(sampleResponse)
+
+    await api.getHistorical('SPY', '1d', { start: '2024-01-02', end: '2024-03-25' })
+
+    const url = String(fetchSpy.mock.calls[0]?.[0])
+    expect(url).toBe(
+      '/api/historical/SPY?interval=1d&start=2024-01-02&end=2024-03-25',
+    )
+  })
+
+  it('range の start のみでも end が無ければ start のみ乗る', async () => {
+    mockJsonResponse(sampleResponse)
+
+    await api.getHistorical('SPY', '1d', { start: '2024-01-02' })
+
+    const url = String(fetchSpy.mock.calls[0]?.[0])
+    expect(url).toBe('/api/historical/SPY?interval=1d&start=2024-01-02')
+  })
+
+  it('symbol に special 文字が含まれていれば encode される', async () => {
+    mockJsonResponse(sampleResponse)
+
+    await api.getHistorical('CL=F')
+
+    const url = String(fetchSpy.mock.calls[0]?.[0])
+    expect(url).toBe('/api/historical/CL%3DF?interval=1d')
+  })
+
+  it('404 のとき ApiError を throw する', async () => {
+    mockJsonResponse({ detail: 'not found' }, 404)
+
+    const err = await api.getHistorical('UNKNOWN').then(
+      () => {
+        throw new Error('expected getHistorical to reject')
+      },
+      (e: unknown) => e,
+    )
+    expect(err).toBeInstanceOf(ApiError)
+    expect(err).toMatchObject({
+      status: 404,
+      url: '/api/historical/UNKNOWN?interval=1d',
+    })
+  })
+})

{alpha_visualizer-0.3.0 → alpha_visualizer-0.4.0}/frontend/src/api/client.ts

@@ -1,4 +1,4 @@
-import type { BacktestDetail, IdeaItem, LiveDetailResponse, LiveListItem, OptimizeResult, StrategyComparison, StrategyDetail, StrategyListItem, StrategyRun, WFOResult } from './types'
+import type { BacktestDetail, HistoricalResponse, IdeaItem, LiveDetailResponse, LiveListItem, OptimizeResult, StrategyComparison, StrategyDetail, StrategyListItem, StrategyRun, WFOResult } from './types'
 
 const API_BASE = '/api'
 
@@ -98,6 +98,21 @@ export const api = {
     const qs = runId ? `?run_id=${encodeURIComponent(runId)}` : ''
     return request<LiveDetailResponse>(`/live/${encodeURIComponent(strategyId)}${qs}`)
   },
+
+  // OHLC 時系列（#189 で backend に追加）。
+  // backend の /api/historical/{symbol} を呼び lightweight-charts 互換の bars を取得する。
+  getHistorical: (
+    symbol: string,
+    interval: string = '1d',
+    range?: { start?: string; end?: string },
+  ): Promise<HistoricalResponse> => {
+    const params = new URLSearchParams({ interval })
+    if (range?.start) params.set('start', range.start)
+    if (range?.end) params.set('end', range.end)
+    return request<HistoricalResponse>(
+      `/historical/${encodeURIComponent(symbol)}?${params.toString()}`,
+    )
+  },
 }
 
 export { ApiError }