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

alpha_visualizer-1.3.1/.hypothesis/constants/ebf2f53d2c001658 → 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', 'alpha-forge', 'forge.yaml', '{', '}', '~']
+['1', 'FORGE_CONFIG', 'FORGE_NONINTERACTIVE', 'alpha-forge', 'eula', 'forge.yaml', 'no such command', '{', '}', '~']

alpha_visualizer-1.3.1/.hypothesis/constants/627d8d6963823a6c → 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.1']
+['1.3.2']

alpha_visualizer-1.3.1/.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.1 → alpha_visualizer-1.3.2}/CHANGELOG.md

@@ -11,6 +11,15 @@ 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 破壊的変更._
 
 
+## [1.3.1] - 2026-08-01
+
+
+### バグ修正
+
+- forge CLI の実行ファイル名を alpha-forge に修正して実行系機能を復旧 (#461)
+
+
+
 ## [1.3.0] - 2026-08-01
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpha-visualizer
-Version: 1.3.1
+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.1 → alpha_visualizer-1.3.2}/frontend/openapi.json

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

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

@@ -1,6 +1,6 @@
 [project]
 name = "alpha-visualizer"
-version = "1.3.1"
+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.1"
+current_version = "1.3.2"
 commit = true
 message = "chore: バージョン {new_version} にバンプ"
 tag = true

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

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

{alpha_visualizer-1.3.1 → 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.1 → 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.1 → 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.1 → alpha_visualizer-1.3.2}/src/alpha_visualizer/services/forge_cli.py

@@ -32,6 +32,18 @@ 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 開発ツール）のコマンド名でも
@@ -44,6 +56,25 @@ def resolve_forge_exe() -> str | 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]:
     """forge CLI サブプロセス用の環境変数を構築する。
 

{alpha_visualizer-1.3.1 → 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)

{alpha_visualizer-1.3.1 → alpha_visualizer-1.3.2}/tests/routers/test_maintenance.py

@@ -125,6 +125,40 @@ class TestOrphanRunsList:
 
         assert resp.status_code >= 400
 
+    def test_EULA未同意の場合は同意手順を案内する(
+        self, client_with_db: TestClient
+    ) -> None:
+        """forge は導入済みだが EULA に同意していないケース。
+
+        visualizer は stdin=DEVNULL で forge を起動するため同意プロンプトに
+        応答できず、Click が "Aborted!" だけを残して落ちる。この文字列は
+        利用者に何も伝えないので、ターミナルで同意するという次の一歩まで
+        示すメッセージに変換する。EULA は改訂のたびに再同意が必要になるため
+        初回導入時だけの問題ではない。
+        """
+        eula_stdout = (
+            "╭── AlphaForge エンドユーザー使用許諾契約 (EULA) — 初回起動時の確認 ──╮\n"
+            "│ 本ソフトウェアの利用には EULA への同意が必要です。                  │\n"
+            "╰────────────────────────────────────────────────────────────────────╯\n"
+            "EULA に同意しますか? [y/n] (n): "
+        )
+        with (
+            mock.patch("shutil.which", return_value="/usr/local/bin/alpha-forge"),
+            mock.patch(
+                "subprocess.run",
+                return_value=_proc(returncode=1, stdout=eula_stdout, stderr="\nAborted!"),
+            ),
+        ):
+            resp = client_with_db.get("/api/maintenance/orphan-runs")
+
+        assert resp.status_code >= 400
+        detail = resp.json()["detail"]
+        # 生の Click 出力をそのまま出していない
+        assert "Aborted!" not in detail
+        # 同意手順（実行すべきコマンド）まで示している
+        assert "EULA" in detail
+        assert "alpha-forge system doctor" in detail
+
     def test_forgeにサブコマンドが無い場合はアップデートを促すメッセージを返す(
         self, client_with_db: TestClient
     ) -> None:

{alpha_visualizer-1.3.1 → alpha_visualizer-1.3.2}/tests/routers/test_run.py

@@ -115,6 +115,35 @@ class TestRunRouter:
         assert detail.endswith("line-59")
         assert "line-9\n" not in detail
 
+    def test_run_eula_not_accepted_returns_guidance(
+        self, client_with_db: TestClient
+    ) -> None:
+        """EULA 未同意は生の "Aborted!" ではなく同意手順を案内する。
+
+        /api/run も maintenance と同じく stdin=DEVNULL で forge を起動するため
+        同意プロンプトに応答できない。プロンプト本体は stdout に出るので、
+        失敗時に stderr しか見ない実装では検出できない。
+        """
+        with (
+            mock.patch("shutil.which", return_value="/usr/local/bin/alpha-forge"),
+            mock.patch(
+                "subprocess.run",
+                return_value=_proc(
+                    returncode=1,
+                    stdout="EULA に同意しますか? [y/n] (n): ",
+                    stderr="\nAborted!",
+                ),
+            ),
+        ):
+            resp = client_with_db.post(
+                "/api/run",
+                json={"strategy_id": "test_strategy", "symbol": "AAPL"},
+            )
+        assert resp.status_code == 500
+        detail = resp.json()["detail"]
+        assert "Aborted!" not in detail
+        assert "alpha-forge system doctor" in detail
+
     def test_run_falls_back_to_db_when_stdout_not_json(
         self, client_with_db: TestClient
     ) -> None:

{alpha_visualizer-1.3.1 → alpha_visualizer-1.3.2}/tests/routers/test_strategy_save.py

@@ -93,3 +93,32 @@ class TestSaveStrategyParameters:
             )
         assert resp.status_code == 500
         assert "validation failed" in resp.json()["detail"]
+
+    def test_save_eula_not_accepted_returns_guidance(
+        self, client_with_strategies: TestClient
+    ) -> None:
+        """EULA 未同意は生の "Aborted!" ではなく同意手順を案内する。
+
+        パラメータ書き戻しも stdin=DEVNULL で forge を起動するため同意
+        プロンプトに応答できない。上の検証エラーと違い "Aborted!" は利用者に
+        何も伝えないので、そのまま表面化させてはいけない。
+        """
+        with (
+            mock.patch("shutil.which", return_value="/usr/local/bin/alpha-forge"),
+            mock.patch(
+                "subprocess.run",
+                return_value=_proc(
+                    returncode=1,
+                    stdout="EULA に同意しますか? [y/n] (n): ",
+                    stderr="\nAborted!",
+                ),
+            ),
+        ):
+            resp = client_with_strategies.post(
+                "/api/strategies/test_strategy/parameters",
+                json={"parameters": {"period": 30}},
+            )
+        assert resp.status_code == 500
+        detail = resp.json()["detail"]
+        assert "Aborted!" not in detail
+        assert "alpha-forge system doctor" in detail

alpha_visualizer-1.3.2/tests/services/test_forge_failure_translation.py

@@ -0,0 +1,60 @@
+"""forge の失敗出力を利用者向け案内へ変換する `translate_forge_failure` のテスト。
+
+生の Click 出力（"Aborted!" / "No such command"）をそのまま画面に出すと、
+利用者は次に何をすればよいか分からない。ここでは「どの失敗を、どの案内に
+写像するか」という意図を検証する。
+"""
+
+from __future__ import annotations
+
+from alpha_visualizer.services.forge_cli import (
+    FORGE_EULA_NOT_ACCEPTED_MESSAGE,
+    FORGE_SUBCOMMAND_NOT_FOUND_MESSAGE,
+    translate_forge_failure,
+)
+
+# EULA プロンプトは rich パネルとして **stdout** に出る。stderr 側には Click の
+# "Aborted!" しか載らないため、stderr だけを見る実装では検出できない。
+_EULA_STDOUT = """╭────── AlphaForge エンドユーザー使用許諾契約 (EULA) — 初回起動時の確認 ───────╮
+│ 本ソフトウェアの利用には EULA への同意が必要です。                           │
+╰──────────────────────────────────────────────────────────────────────────────╯
+EULA に同意しますか? [y/n] (n): """
+_EULA_STDERR = "\nAborted!"
+
+
+def test_EULA未同意を同意手順の案内に変換する() -> None:
+    """`stdin=DEVNULL` で起動する以上、同意プロンプトには絶対に応答できない。
+
+    利用者にとって "Aborted!" は何の情報も持たないので、ターミナルで同意する
+    という次の一歩まで示す。EULA は改訂のたびに再同意が必要になるため、
+    初回だけの問題ではない。
+    """
+    assert translate_forge_failure(_EULA_STDOUT, _EULA_STDERR) == (
+        FORGE_EULA_NOT_ACCEPTED_MESSAGE
+    )
+
+
+def test_stderrにEULAが出る実装差にも追随する() -> None:
+    """プロンプトの出力先が stdout / stderr のどちらでも検出する。
+
+    出力先は forge 側の実装詳細であり、visualizer が依存してよい契約ではない。
+    """
+    assert translate_forge_failure("", "EULA に同意しますか? [y/n]") == (
+        FORGE_EULA_NOT_ACCEPTED_MESSAGE
+    )
+
+
+def test_サブコマンド不在は更新案内に変換する() -> None:
+    """既存の変換（forge が古い）も同じ入口に集約されていること。"""
+    assert translate_forge_failure("", "Error: No such command 'prune-orphans'.") == (
+        FORGE_SUBCOMMAND_NOT_FOUND_MESSAGE
+    )
+
+
+def test_該当しない失敗はNoneを返す() -> None:
+    """変換できない失敗は握り潰さず、生の出力を呼び出し側に返させる。
+
+    ここで既定メッセージに丸めると、原因の分からない失敗が全部同じ文言になり
+    調査できなくなる。
+    """
+    assert translate_forge_failure("", "Traceback (most recent call last): ...") is None

{alpha_visualizer-1.3.1 → alpha_visualizer-1.3.2}/tests/services/test_jobs.py

@@ -138,6 +138,31 @@ class TestJobLifecycle:
         assert record.error is not None
         assert "strategy not found" in record.error
 
+    async def test_eula_not_accepted_job_reports_guidance(
+        self, tmp_path: pathlib.Path
+    ) -> None:
+        """EULA 未同意で落ちたジョブも同意手順を案内する。
+
+        ジョブ（optimize / WFT / backtest）も同期実行系と同じく
+        stdin=DEVNULL で forge を起動するため同意プロンプトに応答できない。
+        EULA プロンプトは stdout に出る一方、ジョブのログは stderr 由来なので、
+        ログ末尾だけを error にする実装では "Aborted!" しか残らない。
+        """
+        stub = _make_stub(
+            tmp_path,
+            'echo "EULA に同意しますか? [y/n] (n): "\n'
+            'echo "Aborted!" >&2\n'
+            "exit 1\n",
+        )
+        manager = _manager(tmp_path, stub)
+        job = await manager.create(kind="backtest", strategy_id="s1", symbol="AAPL")
+        record = await manager.wait_terminal(job.job_id, timeout=10)
+
+        assert record.status == "failed"
+        assert record.error is not None
+        assert "Aborted!" not in record.error
+        assert "alpha-forge system doctor" in record.error
+
     async def test_log_masks_home_directory(self, tmp_path: pathlib.Path) -> None:
         """ログ行のホームパスは ~ にマスクされる（/api/run と同じ漏洩対策）"""
         stub = _make_stub(tmp_path, 'echo "saved to $HOME/data/x.parquet" >&2\n')

{alpha_visualizer-1.3.1 → alpha_visualizer-1.3.2}/uv.lock

@@ -15,7 +15,7 @@ resolution-markers = [
 
 [[package]]
 name = "alpha-visualizer"
-version = "1.3.1"
+version = "1.3.2"
 source = { editable = "." }
 dependencies = [
     { name = "click" },