alpha-visualizer 0.7.1__tar.gz → 0.7.2__tar.gz

{alpha_visualizer-0.7.1 → alpha_visualizer-0.7.2}/.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "latest"
+          version: "0.11.19"
 
       - name: Set up Python
         run: uv python install 3.12
@@ -64,6 +64,50 @@ jobs:
       - name: Bundle size check (size-limit)
         run: pnpm run size
 
+  # issue #225: wheel / sdist に frontend の static/ が同梱されることを PR 時点で検証する。
+  # （static/ は .gitignore 管理のため hatchling の既定挙動では除外される。
+  #   pyproject の force-include 設定が欠落・破損していないかをここで検出する）
+  packaging:
+    name: Packaging (wheel/sdist contain static)
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.11.19"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          version: 11
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+          cache-dependency-path: frontend/pnpm-lock.yaml
+
+      - name: Install pnpm dependencies
+        working-directory: frontend
+        run: pnpm install --frozen-lockfile
+
+      - name: Build frontend
+        working-directory: frontend
+        run: pnpm run build
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - name: Verify build artifacts contain frontend assets
+        run: uv run python scripts/verify_build_artifacts.py dist/
+
   openapi-types:
     name: OpenAPI types drift check
     runs-on: ubuntu-latest
@@ -74,7 +118,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "latest"
+          version: "0.11.19"
 
       - name: Set up Python
         run: uv python install 3.12
@@ -120,7 +164,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "latest"
+          version: "0.11.19"
 
       - name: Set up Python
         run: uv python install 3.12
@@ -128,12 +172,22 @@ jobs:
       - name: Install Python dependencies
         run: uv sync --all-extras
 
+      # SQLite DB はヘッダに書き込みライブラリのバージョンを記録するため、
+      # バイナリ git diff ではなく SQL ダンプの論理比較で検証する（#223）。
+      - name: Snapshot committed fixture DB
+        run: cp frontend/e2e/fixtures/forge/data/results/backtest_results.db /tmp/committed_fixture.db
+
       - name: Regenerate E2E fixture
         run: uv run python tests/fixtures/build_e2e_fixture.py
 
       - name: Verify fixture is committed
         run: |
-          if ! git diff --exit-code frontend/e2e/fixtures/; then
+          if ! uv run python scripts/compare_sqlite_dump.py /tmp/committed_fixture.db frontend/e2e/fixtures/forge/data/results/backtest_results.db; then
+            echo "::error::E2E fixture DB is out of date (logical dump differs)."
+            echo "Run 'uv run python tests/fixtures/build_e2e_fixture.py' locally and commit the changes."
+            exit 1
+          fi
+          if ! git diff --exit-code -- frontend/e2e/fixtures/ ':(exclude)frontend/e2e/fixtures/forge/data/results/backtest_results.db'; then
             echo "::error::E2E fixture is out of date."
             echo "Run 'uv run python tests/fixtures/build_e2e_fixture.py' locally and commit the changes."
             exit 1
@@ -149,7 +203,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "latest"
+          version: "0.11.19"
 
       - name: Set up Python
         run: uv python install 3.12
@@ -157,12 +211,21 @@ jobs:
       - name: Install Python dependencies
         run: uv sync --all-extras
 
+      # SQLite DB はバイナリ比較ではなく SQL ダンプの論理比較で検証する（#223）。
+      - name: Snapshot committed samples DB
+        run: cp samples/sample-forge/data/results/backtest_results.db /tmp/committed_samples.db
+
       - name: Regenerate OSS sample dataset
         run: uv run python samples/build_samples.py
 
       - name: Verify sample-forge is committed (determinism)
         run: |
-          if ! git diff --exit-code samples/sample-forge/; then
+          if ! uv run python scripts/compare_sqlite_dump.py /tmp/committed_samples.db samples/sample-forge/data/results/backtest_results.db; then
+            echo "::error::samples/sample-forge/ DB is out of date (logical dump differs)."
+            echo "Run 'uv run python samples/build_samples.py' locally and commit the changes."
+            exit 1
+          fi
+          if ! git diff --exit-code -- samples/sample-forge/ ':(exclude)samples/sample-forge/data/results/backtest_results.db'; then
             echo "::error::samples/sample-forge/ is out of date."
             echo "Run 'uv run python samples/build_samples.py' locally and commit the changes."
             exit 1
@@ -177,7 +240,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "latest"
+          version: "0.11.19"
 
       - name: Set up Python
         run: uv python install 3.12

{alpha_visualizer-0.7.1 → alpha_visualizer-0.7.2}/.github/workflows/lighthouse.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "latest"
+          version: "0.11.19"
 
       - name: Set up Python
         run: uv python install 3.12

{alpha_visualizer-0.7.1 → alpha_visualizer-0.7.2}/.github/workflows/release.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v7
         with:
-          version: "latest"
+          version: "0.11.19"
 
       - name: Set up Python
         run: uv python install 3.12
@@ -58,5 +58,10 @@ jobs:
       - name: Build
         run: uv build
 
+      # issue #225: v0.7.1 で wheel に static/ が同梱されないまま公開された事故の再発防止。
+      # 公開前に wheel / sdist の中身を検証し、欠落していたらリリースを止める。
+      - name: Verify build artifacts contain frontend assets (issue #225)
+        run: uv run python scripts/verify_build_artifacts.py dist/
+
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

alpha_visualizer-0.7.2/.hypothesis/constants/296b8092179c9f55

@@ -0,0 +1,4 @@
+# file: /home/runner/work/alpha-visualizer/alpha-visualizer/scripts/compare_sqlite_dump.py
+# hypothesis_version: 6.155.1
+
+['__main__']

alpha_visualizer-0.7.1/.hypothesis/constants/94f1f85ed364d969 → alpha_visualizer-0.7.2/.hypothesis/constants/65993953f7ccf191

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

{alpha_visualizer-0.7.1 → alpha_visualizer-0.7.2}/CHANGELOG.md

@@ -5,6 +5,51 @@ alpha-visualizer の全バージョン変更履歴です。
 > **License Change Notice (v0.6.0+):** v0.6.0 以降、ライセンスは MIT から Apache-2.0 に変更されました。v0.5.0 以前のリリースは引き続き MIT ライセンスです。詳細は [LICENSE](LICENSE) を参照してください。
 
 
+## [0.7.1] - 2026-06-02
+
+
+### CI/CD
+
+- **deps**: bump idna from 3.13 to 3.15 (#203)
+
+
+- **deps**: Python の Dependabot を pip から uv エコシステムへ切替 (#213)
+
+
+
+### その他
+
+- **deps-dev**: bump @types/node from 25.7.0 to 25.9.1 in /frontend (#207)
+
+
+- **deps**: bump sqlalchemy from 2.0.49 to 2.0.50 (#214)
+
+
+- **deps-dev**: bump ruff from 0.15.12 to 0.15.15 (#216)
+
+
+- **deps**: bump fastapi from 0.136.1 to 0.136.3 (#217)
+
+
+- **deps-dev**: bump hypothesis from 6.152.4 to 6.155.1 (#218)
+
+
+- **deps**: bump pandas from 3.0.2 to 3.0.3 (#215)
+
+
+- **deps-dev**: bump @vitejs/plugin-react in /frontend (#208)
+
+
+- バージョン 0.7.1 にバンプ
+
+
+
+### ドキュメント
+
+- CHANGELOG を v0.7.0 に更新
+
+
+
 ## [0.7.0] - 2026-05-30
 
 

{alpha_visualizer-0.7.1 → alpha_visualizer-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpha-visualizer
-Version: 0.7.1
+Version: 0.7.2
 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
@@ -104,6 +104,10 @@ alpha-vis serve --no-open
 |---|---|
 | ![Detail](docs/screenshots/ja/detail.png) | ![Compare](docs/screenshots/ja/compare.png) |
 
+**Compare — 戦略間相関ヒートマップ**
+
+![相関ヒートマップ](docs/screenshots/ja/compare-heatmap.png)
+
 | Optimize | Strategy 構造 |
 |---|---|
 | ![Optimize](docs/screenshots/ja/optimize.png) | ![Strategy](docs/screenshots/ja/strategy.png) |

{alpha_visualizer-0.7.1 → alpha_visualizer-0.7.2}/README.en.md

@@ -71,6 +71,10 @@ If `alpha-vis serve --forge-dir /path/to/A` seems to be reading a different DB t
 |---|---|
 | ![Detail](docs/screenshots/en/detail.png) | ![Compare](docs/screenshots/en/compare.png) |
 
+**Compare — Strategy correlation heatmap**
+
+![Correlation heatmap](docs/screenshots/en/compare-heatmap.png)
+
 | Optimize | Strategy structure |
 |---|---|
 | ![Optimize](docs/screenshots/en/optimize.png) | ![Strategy](docs/screenshots/en/strategy.png) |

{alpha_visualizer-0.7.1 → alpha_visualizer-0.7.2}/README.md

@@ -71,6 +71,10 @@ alpha-vis serve --no-open
 |---|---|
 | ![Detail](docs/screenshots/ja/detail.png) | ![Compare](docs/screenshots/ja/compare.png) |
 
+**Compare — 戦略間相関ヒートマップ**
+
+![相関ヒートマップ](docs/screenshots/ja/compare-heatmap.png)
+
 | Optimize | Strategy 構造 |
 |---|---|
 | ![Optimize](docs/screenshots/ja/optimize.png) | ![Strategy](docs/screenshots/ja/strategy.png) |

alpha_visualizer-0.7.2/frontend/e2e/screenshots/capture.spec.ts

@@ -0,0 +1,211 @@
+import { expect, test, type Locator, type Page } from '@playwright/test'
+import { mkdir } from 'node:fs/promises'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import {
+  clearViewerSettings,
+  gotoBrowse,
+  gotoCompare,
+  gotoDetail,
+  switchLanguage,
+  type Lang,
+} from '../helpers/locators'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+/**
+ * README / alforge-labs サイト掲載用スクリーンショットを ja/en 両言語で撮影する。
+ * 出力先: <repo-root>/docs/screenshots/{ja,en}/<name>.png
+ *
+ * playwright.screenshots.config.ts から実行することを想定。
+ *
+ * 撮影方針（issue: README スクショ撮り直し）:
+ * - 「アピールしたい主役（チャート・構造）」がヘッダー/メトリクスで切れないよう、
+ *   グリッド掲載分（detail/compare/optimize/strategy）は showcase コンポーネントを
+ *   element 単位でタイトにクロップする。
+ * - hero（browse）はコンテキスト維持のため縦長 viewport でヘッダー＋銘柄アトラスを収める。
+ */
+
+const STRATEGY_ID = 'sma_cross'
+// 最適化（パラメータ感度散布図）はトライアル列を持つ戦略でないと空になる。
+// フィクスチャでは rsi_reversal が 20 トライアルの scatter データを持つ
+// （sma_cross は WFO 形式・momo_breakout は最適化データ無し）。
+const OPTIMIZE_STRATEGY_ID = 'rsi_reversal'
+const COMPARE_IDS = ['sma_cross', 'rsi_reversal', 'momo_breakout'] as const
+
+const SCREENSHOT_DIR = resolve(__dirname, '../../../docs/screenshots')
+
+// チャート/キャンバス（visx・lightweight-charts）の描画が落ち着くまでの待機（ms）。
+const CHART_SETTLE_MS = 500
+
+async function ensureDir(filePath: string): Promise<void> {
+  await mkdir(dirname(filePath), { recursive: true })
+}
+
+async function settle(page: Page): Promise<void> {
+  // データ取得・チャート描画が落ち着くのを待つ
+  await page.waitForLoadState('networkidle')
+  await page.waitForTimeout(CHART_SETTLE_MS)
+}
+
+/**
+ * visx / lightweight-charts は ResizeObserver で遅延測定されるため、
+ * スクロール直後は要素高さが潰れていることがある。高さが下限以上で
+ * 安定するまでポーリングしてからクロップする。
+ */
+async function waitForStableHeight(target: Locator, minHeight: number): Promise<void> {
+  let last = -1
+  for (let i = 0; i < 25; i += 1) {
+    const box = await target.boundingBox()
+    const height = box?.height ?? 0
+    if (height >= minHeight && height === last) {
+      return
+    }
+    last = height
+    await target.page().waitForTimeout(150)
+  }
+}
+
+/**
+ * ページ全体ではなく、訴求対象の要素そのものをタイトにクロップして撮る。
+ * ヘッダー・メトリクス・タブで主役が切れる問題を回避する。
+ *
+ * 実装メモ: visx の ParentSize 系チャート（OptimizeScatter / CorrelationHeatmap 等）は
+ * 親要素が可視領域内に無いと width=0 で描画されない。`Locator.screenshot()` は要素を
+ * 分割スクロールして撮るため off-screen 部分のチャートが潰れる。そこで縦長 viewport に
+ * 要素全体を収めて描画させ、boundingBox を clip した `page.screenshot()` で撮る。
+ */
+async function captureElement(
+  page: Page,
+  lang: Lang,
+  name: string,
+  target: Locator,
+  minHeight = 200,
+): Promise<void> {
+  const filePath = resolve(SCREENSHOT_DIR, lang, `${name}.png`)
+  await ensureDir(filePath)
+  // 想定要素（最大 strategy-screen ≈ 1100px）が丸ごと収まる高さにする。
+  await page.setViewportSize({ width: 1440, height: 1800 })
+  await target.evaluate((el) => el.scrollIntoView({ block: 'center', behavior: 'instant' }))
+  await target.waitFor({ state: 'visible' })
+  // visx ParentSize は mount 時に width=0 で測れていることがあるため、
+  // 可視化後に resize を発火させて再測定を促す。
+  await page.evaluate(() => window.dispatchEvent(new Event('resize')))
+  await settle(page)
+  await waitForStableHeight(target, minHeight)
+  const box = await target.boundingBox()
+  if (!box) {
+    throw new Error(`boundingBox を取得できませんでした: ${name}`)
+  }
+  await page.screenshot({ path: filePath, clip: box })
+}
+
+/**
+ * hero など、アプリのコンテキストを保ったまま縦長 viewport で撮る。
+ */
+async function captureViewport(
+  page: Page,
+  lang: Lang,
+  name: string,
+  height: number,
+): Promise<void> {
+  const filePath = resolve(SCREENSHOT_DIR, lang, `${name}.png`)
+  await ensureDir(filePath)
+  await page.setViewportSize({ width: 1440, height })
+  await page.evaluate(() => window.scrollTo(0, 0))
+  await settle(page)
+  await page.screenshot({ path: filePath })
+}
+
+async function setLang(page: Page, lang: Lang): Promise<void> {
+  if (lang === 'ja') {
+    return
+  }
+  await switchLanguage(page, lang)
+  // 言語切替直後はテキストの再描画があるので少し待つ
+  await page.waitForLoadState('networkidle')
+}
+
+async function openDetailTab(page: Page, ja: string, en: string, lang: Lang): Promise<void> {
+  const name = lang === 'ja' ? ja : en
+  const tab = page.getByRole('tab', { name, exact: true })
+  // click() は要素の出現（actionability）を待つため、goto 直後でも取りこぼさない。
+  await tab.click()
+  // タブが実際に選択状態へ切り替わったことを確認してから本文ロードを待つ。
+  await expect(tab).toHaveAttribute('aria-selected', 'true')
+  await page.waitForLoadState('networkidle')
+}
+
+test.describe.serial('README / docs 用スクリーンショット撮影', () => {
+  for (const lang of ['ja', 'en'] as const) {
+    test.describe(`lang=${lang}`, () => {
+      test.beforeEach(async ({ page }) => {
+        await clearViewerSettings(page)
+      })
+
+      // hero: ヘッダー＋銘柄アトラスが収まる縦長 viewport
+      test('browse', async ({ page }) => {
+        await gotoBrowse(page)
+        await setLang(page, lang)
+        await captureViewport(page, lang, 'browse', 1180)
+      })
+
+      // detail: 「エクイティ vs Buy&Hold」カード（タイトル＋チャート）をクロップ
+      test('detail', async ({ page }) => {
+        await gotoDetail(page, STRATEGY_ID)
+        await setLang(page, lang)
+        // backtest-equity-chart の親 div = セクションラベル＋エクイティチャート
+        const equitySection = page.getByTestId('backtest-equity-chart').locator('..')
+        await captureElement(page, lang, 'detail', equitySection, 280)
+      })
+
+      // strategy: 戦略構造カード群（パラメータ／指標／ルール）
+      test('detail-strategy', async ({ page }) => {
+        await gotoDetail(page, STRATEGY_ID)
+        await setLang(page, lang)
+        await openDetailTab(page, '戦略構成', 'Strategy', lang)
+        await captureElement(page, lang, 'strategy', page.getByTestId('strategy-screen'))
+      })
+
+      // optimize: 最適化トライアル分析（パラメータ感度散布図＋上位トライアル）
+      test('detail-optimize', async ({ page }) => {
+        await gotoDetail(page, OPTIMIZE_STRATEGY_ID)
+        await setLang(page, lang)
+        await openDetailTab(page, '最適化', 'Optimize', lang)
+        await captureElement(page, lang, 'optimize', page.getByTestId('optimize-screen'), 400)
+      })
+
+      // compare（主）: 正規化エクイティ＋指標比較
+      test('compare', async ({ page }) => {
+        await gotoCompare(page, COMPARE_IDS)
+        await setLang(page, lang)
+        await captureElement(page, lang, 'compare', page.getByTestId('compare-main-grid'))
+      })
+
+      // compare（相関ヒートマップ）: README 採用検討用に別撮り
+      test('compare-heatmap', async ({ page }) => {
+        await gotoCompare(page, COMPARE_IDS)
+        await setLang(page, lang)
+        await captureElement(
+          page,
+          lang,
+          // testid はラベル div に付くため、親 Card（ラベル＋説明＋ヒートマップ本体）を撮る
+          'compare-heatmap',
+          page.getByTestId('correlation-heatmap-card').locator('..'),
+          240,
+        )
+      })
+
+      // ideas: 既存どおりページ全体（README 未掲載）
+      test('ideas', async ({ page }) => {
+        await page.goto('/ideas')
+        await setLang(page, lang)
+        const filePath = resolve(SCREENSHOT_DIR, lang, 'ideas.png')
+        await ensureDir(filePath)
+        await settle(page)
+        await page.screenshot({ path: filePath })
+      })
+    })
+  }
+})

{alpha_visualizer-0.7.1 → alpha_visualizer-0.7.2}/frontend/src/api/types.ts

@@ -334,6 +334,21 @@ export interface IdeaItem {
 
 // ===== Live (issue #57) =====
 
+/**
+ * position ベース combine portfolio の live metrics
+ * （backend ``services/live.py`` の ``position_detail`` 互換）。
+ *
+ * ``max_drawdown_pct`` / ``volatility_pct`` は **正値**（大きいほど悪い）。
+ * trade 単位の ``LiveSummary.max_drawdown_pct``（負値）と符号規約が異なる点に注意。
+ */
+export interface LivePositionMetrics {
+  total_return_pct?: number | null
+  cagr_pct?: number | null
+  sharpe_ratio?: number | null
+  max_drawdown_pct?: number | null
+  volatility_pct?: number | null
+}
+
 /** LiveSummary: backend 側は ``LiveSection.summary: dict[str, unknown]`` のため手書き。 */
 export interface LiveSummary {
   strategy_id: string
@@ -351,6 +366,16 @@ export interface LiveSummary {
   total_commission?: number
   max_drawdown_pct?: number
   symbols?: string[]
+  /** 'position' = combine portfolio（``live_position_summaries`` 由来、#221） */
+  kind?: 'strategy' | 'position'
+  portfolio_id?: string | null
+  metrics?: LivePositionMetrics | null
+  backtest_metrics?: LivePositionMetrics | null
+  /** ``[[ISO 日時, equity 値], ...]`` の日次系列 */
+  equity?: [string, number][]
+  receipts_count?: number | null
+  sub_strategies?: string[]
+  updated_at?: string | null
 }
 
 /** LiveTrade: ``side: 'long' | 'short'`` に narrow（生成型は string）。 */