alpha-visualizer 1.3.0__tar.gz → 1.3.2__tar.gz

alpha_visualizer-1.3.0/.hypothesis/constants/812d29a19e56a27b → alpha_visualizer-1.3.2/.hypothesis/constants/64f671cc8bd3c7e4

@@ -1,4 +1,4 @@
 # file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/services/forge_cli.py
 # hypothesis_version: 6.161.6
 
-['1', 'FORGE_CONFIG', 'FORGE_NONINTERACTIVE', 'forge', 'forge.yaml', '{', '}', '~']
+['1', 'FORGE_CONFIG', 'FORGE_NONINTERACTIVE', 'alpha-forge', 'eula', 'forge.yaml', 'no such command', '{', '}', '~']

alpha_visualizer-1.3.0/.hypothesis/constants/ac0d9ed38453cfd0 → alpha_visualizer-1.3.2/.hypothesis/constants/a143537c99265376

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

alpha_visualizer-1.3.0/.hypothesis/constants/04b2c2a699e215f4 → alpha_visualizer-1.3.2/.hypothesis/constants/e52ef865e1fc122f

@@ -1,4 +1,4 @@
 # file: /home/runner/work/alpha-visualizer/alpha-visualizer/src/alpha_visualizer/routers/maintenance.py
 # hypothesis_version: 6.161.6
 
-[400, 900, '--dry-run', '--json', '--strategy', '--vacuum', '-y', 'backtest', 'backtest_rows', 'bytes_after', 'bytes_before', 'count', 'deleted', 'engine', 'no such command', 'optimization_rows', 'orphans', 'prune-orphans', 'strategy_ids', 'total_bytes', 'vacuum_error']
+[400, 900, '--dry-run', '--json', '--strategy', '--vacuum', '-y', 'backtest', 'backtest_rows', 'bytes_after', 'bytes_before', 'count', 'deleted', 'engine', 'optimization_rows', 'orphans', 'prune-orphans', 'strategy_ids', 'total_bytes', 'vacuum_error']

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/CHANGELOG.md

@@ -11,7 +11,16 @@ alpha-visualizer の全バージョン変更履歴です。
 _(EN) Entries below are generated from Conventional Commits (Japanese). Group names: 新機能 = Features, バグ修正 = Bug fixes, リファクタリング = Refactoring, パフォーマンス改善 = Performance, ドキュメント = Docs, テスト = Tests, その他 = Chore. Breaking commits are tagged 破壊的変更._
 
 
-## [unreleased]
+## [1.3.1] - 2026-08-01
+
+
+### バグ修正
+
+- forge CLI の実行ファイル名を alpha-forge に修正して実行系機能を復旧 (#461)
+
+
+
+## [1.3.0] - 2026-08-01
 
 
 ### CI/CD
@@ -28,12 +37,27 @@ _(EN) Entries below are generated from Conventional Commits (Japanese). Group na
 - UI 文言の平易化・統一（snake_case 露出/独自用語/CLI 前提文言/表記ゆれ） (#439)
 
 
+- PyPI メタデータを更新（Production/Stable・Python 3.12–3.14・Doc URL 英語入口） (#457)
+
+
+- API 境界の小粒改善（strategy_id 規約統一・/health の mask_home・WFO/Optimize 遅延フェッチ） (#456)
+
+
+- CodeQL py/empty-except 指摘に対応（フォールバック意図のコメントを明記） (#459)
+
+
+- audit-licenses の DEV_ONLY を新 dev 依存に追従し THIRDPARTY_LICENSES.txt を再生成 (#460)
+
+
 
 ### ドキュメント
 
 - README に同梱サンプルの導線・Live/Ideas スクショ・FAQ リンクを追加する (#410)
 
 
+- CHANGELOG からリリース作業ノイズを除外し破壊的変更の履歴と英語注記を追加 (#458)
+
+
 
 ### バグ修正
 
@@ -187,6 +211,9 @@ _(EN) Entries below are generated from Conventional Commits (Japanese). Group na
 - 最適化ビューにパラメータ重要度（Spearman 順位相関）バーを追加 (#454)
 
 
+- 取引一覧の行クリックで該当期間へチャートジャンプ（共有 viewport + 概要タブ切替） (#455)
+
+
 
 ## [1.2.2] - 2026-07-29
 

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpha-visualizer
-Version: 1.3.0
+Version: 1.3.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

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/frontend/openapi.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "alpha-visualizer",
     "description": "AlphaForge バックテスト結果の Web 可視化ツール",
-    "version": "1.3.0"
+    "version": "1.3.2"
   },
   "paths": {
     "/api/results": {

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/frontend/src/lib/__tests__/errorMessage.test.ts

@@ -68,11 +68,13 @@ describe('extractApiErrorDetail (issue #301)', () => {
 
 describe('messageForApiErrorCode (issue #358)', () => {
   const raw =
-    'API 503: {"detail":"forge コマンドが見つかりません。AlphaForge を導入してください / forge command not found in PATH. Install AlphaForge — https://alforgelabs.com","code":"forge_cli_not_found"}'
+    'API 503: {"detail":"alpha-forge コマンドが見つかりません。AlphaForge を導入してください / alpha-forge command not found in PATH. Install AlphaForge — https://alforgelabs.com","code":"forge_cli_not_found"}'
 
   it('maps forge_cli_not_found to a single-language message (ja)', () => {
     const msg = messageForApiErrorCode(raw, 'ja')
-    expect(msg).toContain('forge コマンドが見つかりません')
+    // PATH 上の実行ファイル名は `alpha-forge`（v0.5.0 で `forge` から改名）。
+    // 存在しない `forge` を名指しすると、ユーザーが誤った名前で PATH を確認する。
+    expect(msg).toContain('alpha-forge コマンドが見つかりません')
     expect(msg).not.toContain('not found in PATH')
     expect(msg).toContain('https://alforgelabs.com')
   })

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/frontend/src/lib/errorMessage.ts

@@ -72,8 +72,8 @@ export function messageForApiErrorCode(
   const code = extractApiErrorCode(raw)
   if (code === 'forge_cli_not_found') {
     return L(
-      'forge コマンドが見つかりません。AlphaForge を導入してください — https://alforgelabs.com',
-      'forge command not found in PATH. Install AlphaForge — https://alforgelabs.com',
+      'alpha-forge コマンドが見つかりません。AlphaForge を導入してください — https://alforgelabs.com',
+      'alpha-forge command not found in PATH. Install AlphaForge — https://alforgelabs.com',
     )
   }
   return null

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/frontend/src/pages/__tests__/MaintenancePage.test.tsx

@@ -63,7 +63,7 @@ describe('MaintenancePage error normalization (review: Important 1)', () => {
     // サーバーの detail は curl 利用者向けに日英連結のままだが、UI では
     // 機械可読 code から表示言語のみの文言へ写像する（issue #358）。
     const rawMessage =
-      'API 503: {"detail":"forge コマンドが見つかりません。AlphaForge を導入してください / forge command not found in PATH. Install AlphaForge — https://alforgelabs.com","code":"forge_cli_not_found"}'
+      'API 503: {"detail":"alpha-forge コマンドが見つかりません。AlphaForge を導入してください / alpha-forge command not found in PATH. Install AlphaForge — https://alforgelabs.com","code":"forge_cli_not_found"}'
     vi.mocked(api.listOrphanRuns).mockRejectedValue(
       new ApiError(rawMessage, 503, '/api/maintenance/orphan-runs'),
     )
@@ -76,7 +76,7 @@ describe('MaintenancePage error normalization (review: Important 1)', () => {
 
     const alert = await waitFor(() => screen.getByRole('alert'))
     // 表示言語（既定 ja）の文言だけが出る（日英連結を出さない）
-    expect(alert.textContent).toContain('forge コマンドが見つかりません')
+    expect(alert.textContent).toContain('alpha-forge コマンドが見つかりません')
     expect(alert.textContent).not.toContain('not found in PATH')
     // AlphaForge への導線 URL は維持する
     expect(alert.textContent).toContain('alforgelabs.com')

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "alpha-visualizer"
-version = "1.3.0"
+version = "1.3.2"
 description = "Web visualization tool for AlphaForge backtest results"
 readme = "README.md"
 license = "Apache-2.0"
@@ -93,7 +93,7 @@ dev = [
 ]
 
 [tool.bumpversion]
-current_version = "1.3.0"
+current_version = "1.3.2"
 commit = true
 message = "chore: バージョン {new_version} にバンプ"
 tag = true

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/src/alpha_visualizer/__init__.py

@@ -1,3 +1,3 @@
 """alpha-visualizer: AlphaForge バックテスト結果の Web 可視化ツール"""
 
-__version__ = "1.3.0"
+__version__ = "1.3.2"

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/src/alpha_visualizer/routers/maintenance.py

@@ -27,11 +27,11 @@ from alpha_visualizer.schemas.maintenance import (
 )
 from alpha_visualizer.services.forge_cli import (
     FORGE_NOT_FOUND_MESSAGE,
-    FORGE_SUBCOMMAND_NOT_FOUND_MESSAGE,
     build_forge_env,
     mask_home,
     parse_json_lenient,
     resolve_forge_exe,
+    translate_forge_failure,
 )
 
 logger = logging.getLogger(__name__)
@@ -65,12 +65,12 @@ def _run_forge(argv: list[str], forge_cfg: ForgeConfig, timeout: int) -> dict[st
 
     if proc.returncode != 0:
         # 空一覧を返して「掃除済み」と誤読させてはいけない
+        # 既知の失敗（EULA 未同意 / forge が古くサブコマンドを持たない）は、
+        # 生の Click 出力ではなく次の一歩を示す案内に変換する。
+        guidance = translate_forge_failure(proc.stdout or "", proc.stderr or "")
+        if guidance is not None:
+            raise ExternalProcessError(guidance)
         raw = proc.stderr or proc.stdout or ""
-        # forge は導入済みだがバージョンが古く prune-orphans を持たないケース。
-        # Click が出す生の "No such command 'xxx'." をそのまま見せず、更新を
-        # 促す導線付きメッセージに変換する（判定は大文字小文字を無視）。
-        if "no such command" in raw.lower():
-            raise ExternalProcessError(FORGE_SUBCOMMAND_NOT_FOUND_MESSAGE)
         detail = mask_home(raw.strip())
         raise ExternalProcessError(f"forge が異常終了しました（exit {proc.returncode}）: {detail}")
 

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/src/alpha_visualizer/routers/run.py

@@ -38,6 +38,7 @@ from alpha_visualizer.services.forge_cli import (
     mask_home,
     parse_json_lenient,
     resolve_forge_exe,
+    translate_forge_failure,
 )
 
 logger = logging.getLogger(__name__)
@@ -187,6 +188,11 @@ def _run_backtest_guarded(
         ) from exc
 
     if proc.returncode != 0:
+        # 既知の失敗（EULA 未同意等）は生の Click 出力ではなく次の一歩を示す
+        # 案内に変換する。プロンプト本体は stdout に出るため両方を渡す。
+        guidance = translate_forge_failure(proc.stdout or "", proc.stderr or "")
+        if guidance is not None:
+            raise ExternalProcessError(guidance)
         # 成功時 log_tail と同じ末尾丸め＋ホームパスマスクを通し、
         # 長大なトレースバックでレスポンスが膨らまないようにする。
         detail = (

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/src/alpha_visualizer/routers/strategies.py

@@ -52,6 +52,7 @@ from alpha_visualizer.services.forge_cli import (
     build_forge_env,
     mask_home,
     resolve_forge_exe,
+    translate_forge_failure,
 )
 from alpha_visualizer.services.tuning import build_duplicate_file, build_override_file
 
@@ -404,7 +405,11 @@ def _delegate_forge_strategy_save(
     log_tail = mask_home("\n".join(tail_lines)) if tail_lines else None
 
     if proc.returncode != 0:
-        raise ExternalProcessError(log_tail or failure_message)
+        # 既知の失敗（EULA 未同意等）は生の Click 出力ではなく次の一歩を示す
+        # 案内に変換する。forge の検証エラーは従来どおりそのまま表面化させる
+        # （スキーマの SSoT は forge 側にあるため）。
+        guidance = translate_forge_failure(proc.stdout or "", proc.stderr or "")
+        raise ExternalProcessError(guidance or log_tail or failure_message)
     return log_tail
 
 

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/src/alpha_visualizer/services/forge_cli.py

@@ -16,8 +16,8 @@ from alpha_visualizer.forge_config import ForgeConfig
 # forge 未導入ユーザーが実行系機能に触れた瞬間は AlphaForge 導入意欲が
 # 最も高い接点なので、インストール先への導線を必ず含める。
 FORGE_NOT_FOUND_MESSAGE = (
-    "forge コマンドが見つかりません。AlphaForge を導入してください"
-    " / forge command not found in PATH. Install AlphaForge"
+    "alpha-forge コマンドが見つかりません。AlphaForge を導入してください"
+    " / alpha-forge command not found in PATH. Install AlphaForge"
     " — https://alforgelabs.com"
 )
 
@@ -32,9 +32,47 @@ FORGE_SUBCOMMAND_NOT_FOUND_MESSAGE = (
 )
 
 
+# forge は導入済みだが EULA に同意していないケース。forge は同意プロンプトを
+# 対話で出すが、visualizer は stdin=DEVNULL で起動するため応答できず Click が
+# Abort する（stderr は "Aborted!" のみで、利用者には何も伝わらない）。EULA は
+# 改訂のたびに再同意が必要になるので、初回導入時だけの問題ではない。
+FORGE_EULA_NOT_ACCEPTED_MESSAGE = (
+    "AlphaForge の使用許諾契約（EULA）に同意していないため実行できません。"
+    "ターミナルで `alpha-forge system doctor` を実行し、EULA に同意してください"
+    " / AlphaForge EULA has not been accepted. Run `alpha-forge system doctor`"
+    " in a terminal and accept the EULA"
+)
+
+
+#: AlphaForge CLI の実行ファイル名。v0.5.0 で ``forge`` から改名され、インストーラ
+#: （alforge-labs/install.sh）は旧 ``forge`` symlink を削除する。旧名へのフォール
+#: バックは張らない — ``forge`` は Foundry（Solidity 開発ツール）のコマンド名でも
+#: あり、無関係なバイナリへ backtest 引数を渡す事故のほうが重い。
+FORGE_EXE_NAME = "alpha-forge"
+
+
 def resolve_forge_exe() -> str | None:
-    """PATH 上の forge 実行ファイルを解決する（無ければ None）。"""
-    return shutil.which("forge")
+    """PATH 上の alpha-forge 実行ファイルを解決する（無ければ None）。"""
+    return shutil.which(FORGE_EXE_NAME)
+
+
+def translate_forge_failure(stdout: str, stderr: str) -> str | None:
+    """forge の失敗出力を、利用者が次の一歩を踏める案内へ変換する。
+
+    該当パターンが無ければ ``None`` を返す。呼び出し側は生の出力にフォール
+    バックすること（ここで既定文言に丸めると、原因不明の失敗がすべて同じ
+    メッセージになり調査できなくなる）。
+
+    stdout / stderr を両方受け取るのは、EULA プロンプトが rich パネルとして
+    stdout に出る一方、Click の "Aborted!" は stderr に出るため。どちらか
+    片方だけを見る実装では取りこぼす。
+    """
+    haystack = f"{stdout}\n{stderr}".lower()
+    if "eula" in haystack:
+        return FORGE_EULA_NOT_ACCEPTED_MESSAGE
+    if "no such command" in haystack:
+        return FORGE_SUBCOMMAND_NOT_FOUND_MESSAGE
+    return None
 
 
 def build_forge_env(forge_cfg: ForgeConfig) -> dict[str, str]:

{alpha_visualizer-1.3.0 → alpha_visualizer-1.3.2}/src/alpha_visualizer/services/jobs.py

@@ -34,6 +34,7 @@ from alpha_visualizer.services.forge_cli import (
     mask_home,
     parse_json_lenient,
     resolve_forge_exe,
+    translate_forge_failure,
 )
 
 logger = logging.getLogger(__name__)
@@ -629,10 +630,17 @@ class JobManager:
             await self._finish(record, "cancelled", returncode=proc.returncode)
             return
 
+        stdout_text = stdout_buf.decode("utf-8", errors="replace")
+
         if proc.returncode != 0:
+            # 既知の失敗（EULA 未同意等）は次の一歩を示す案内に変換する。
+            # ログ（stderr 由来）だけでは EULA プロンプト本体を拾えないため、
+            # stdout も合わせて判定する。
             _, tail = self.log_since(record.job_id, max(0, record.log_seq - 5))
+            log_text = "\n".join(tail)
             error = (
-                "\n".join(tail)
+                translate_forge_failure(stdout_text, log_text)
+                or log_text
                 or "ジョブの実行に失敗しました / Job execution failed"
             )
             await self._finish(
@@ -640,7 +648,6 @@ class JobManager:
             )
             return
 
-        stdout_text = stdout_buf.decode("utf-8", errors="replace")
         data = parse_json_lenient(stdout_text)
         result = _compact_result(data) if data is not None else None
         await self._finish(record, "succeeded", returncode=0, result=result)