alpha-visualizer 0.1.0__tar.gz → 0.2.0__tar.gz

alpha_visualizer-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,99 @@
+name: 🐛 Bug Report (English)
+description: Report a reproducible bug to help us improve alpha-visualizer.
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to file a bug report! Please fill out the sections below.
+        Before submitting, please [search existing issues](https://github.com/alforge-labs/alpha-visualizer/issues) to avoid duplicates.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: A clear and concise description of the bug.
+      placeholder: When I run `vis serve`, ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps to reproduce the issue.
+      placeholder: |
+        1. Run `vis serve --forge-dir /path/to/data`
+        2. Open browser at http://127.0.0.1:8000/browse
+        3. Click on strategy "X"
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: alpha-visualizer version
+      description: Output of `vis --version` or the value in pyproject.toml.
+      placeholder: "0.1.1"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - macOS
+        - Linux
+        - Windows
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      description: Output of `python --version`.
+      placeholder: "3.12.x"
+    validations:
+      required: true
+
+  - type: input
+    id: browser
+    attributes:
+      label: Browser (if frontend issue)
+      placeholder: "Chrome 132 / Firefox 134 / Safari 18"
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / error output
+      description: Paste any relevant logs, stack traces, or browser console errors.
+      render: shell
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Anything else that might help us understand the problem.
+
+  - type: checkboxes
+    id: confirm
+    attributes:
+      label: Pre-submit checklist
+      options:
+        - label: I have searched existing issues for duplicates
+          required: true
+        - label: I am running a supported version of alpha-visualizer
+          required: true

alpha_visualizer-0.2.0/.github/ISSUE_TEMPLATE/bug_report_ja.yml

@@ -0,0 +1,99 @@
+name: 🐛 バグ報告（日本語）
+description: 再現可能なバグを報告して alpha-visualizer の改善にご協力ください。
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        バグ報告をいただきありがとうございます。以下の項目にご記入ください。
+        提出前に [既存の Issue](https://github.com/alforge-labs/alpha-visualizer/issues) を検索し、重複を避けてください。
+
+  - type: textarea
+    id: description
+    attributes:
+      label: 何が起きましたか？
+      description: バグの内容を簡潔に説明してください。
+      placeholder: vis serve を実行すると...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: 再現手順
+      description: 最小限の再現手順をご記入ください。
+      placeholder: |
+        1. `vis serve --forge-dir /path/to/data` を実行
+        2. ブラウザで http://127.0.0.1:8000/browse を開く
+        3. 戦略 "X" をクリック
+        4. エラーが表示される
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: 期待する動作
+      description: 本来どうなるべきだと考えていますか？
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: alpha-visualizer のバージョン
+      description: "`vis --version` の出力、または pyproject.toml の値。"
+      placeholder: "0.1.1"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: OS
+      options:
+        - macOS
+        - Linux
+        - Windows
+        - その他
+    validations:
+      required: true
+
+  - type: input
+    id: python-version
+    attributes:
+      label: Python バージョン
+      description: "`python --version` の出力。"
+      placeholder: "3.12.x"
+    validations:
+      required: true
+
+  - type: input
+    id: browser
+    attributes:
+      label: ブラウザ（フロントエンドの問題の場合）
+      placeholder: "Chrome 132 / Firefox 134 / Safari 18"
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: ログ・エラー出力
+      description: 関連するログ、スタックトレース、ブラウザコンソールエラーを貼り付けてください。
+      render: shell
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: 追加情報
+      description: 問題の理解に役立つ情報があればご記入ください。
+
+  - type: checkboxes
+    id: confirm
+    attributes:
+      label: 提出前チェックリスト
+      options:
+        - label: 既存 Issue を検索し重複がないことを確認した
+          required: true
+        - label: サポート対象バージョンの alpha-visualizer を使用している
+          required: true

alpha_visualizer-0.2.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 📖 Documentation / 公式ドキュメント
+    url: https://alforgelabs.com/ja/docs/alpha-visualizer/
+    about: Read the docs before opening an issue. / Issue を立てる前に公式ドキュメントを確認してください。
+  - name: 💬 Discussions
+    url: https://github.com/alforge-labs/alpha-visualizer/discussions
+    about: Ask questions or start a discussion. / 質問・議論はこちらから。
+  - name: 🛡️ Security vulnerability / セキュリティ脆弱性
+    url: https://github.com/alforge-labs/alpha-visualizer/security/advisories/new
+    about: Do NOT open a public issue. Use GitHub Security Advisories. / セキュリティ問題は public Issue ではなく Security Advisories で報告してください。

alpha_visualizer-0.2.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,39 @@
+name: 💡 Feature Request (English)
+description: Suggest an idea or enhancement for alpha-visualizer.
+title: "[Feature]: "
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an enhancement! Please describe your idea below.
+        Search [existing issues](https://github.com/alforge-labs/alpha-visualizer/issues?q=is%3Aissue+label%3Aenhancement) first to avoid duplicates.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / motivation
+      description: What problem does this feature solve? What is the use case?
+      placeholder: When I'm comparing 5+ strategies, I can't easily ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: How would you like this to work? UI sketches, API mockups, sample code all welcome.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches you've considered, if any.
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Screenshots, links to similar features in other tools, etc.

alpha_visualizer-0.2.0/.github/ISSUE_TEMPLATE/feature_request_ja.yml

@@ -0,0 +1,39 @@
+name: 💡 機能要望（日本語）
+description: alpha-visualizer の改善案・新機能を提案してください。
+title: "[Feature]: "
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ご提案ありがとうございます。アイデアの詳細をご記入ください。
+        提出前に [既存の Issue](https://github.com/alforge-labs/alpha-visualizer/issues?q=is%3Aissue+label%3Aenhancement) を検索し、重複を避けてください。
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: 解決したい課題・動機
+      description: この機能が解決する問題は何ですか？ユースケースを教えてください。
+      placeholder: 5戦略以上を比較する際に...
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 提案する解決策
+      description: どのように動作してほしいか、UI スケッチ・API モック・サンプルコードなどあれば歓迎です。
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 検討した代替案
+      description: 他に検討したアプローチがあればご記入ください。
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: 追加情報
+      description: スクリーンショット、他ツールでの類似機能へのリンクなど。

alpha_visualizer-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,58 @@
+<!--
+日本語ガイド: https://github.com/alforge-labs/alpha-visualizer/blob/main/CONTRIBUTING.md
+English guide: https://github.com/alforge-labs/alpha-visualizer/blob/main/CONTRIBUTING.en.md
+-->
+
+## 概要 / Summary
+
+<!--
+この PR で何を変更したかを 1〜3 行で説明してください。
+Briefly describe what this PR changes (1-3 lines).
+-->
+
+## 関連 Issue / Related Issue
+
+<!--
+Closes #123 のように記載してください（マージ時に自動で Issue がクローズされます）。
+Use `Closes #123` to auto-close the related issue on merge.
+-->
+
+Closes #
+
+## 変更内容 / Changes
+
+<!--
+- 主な変更点を箇条書きで
+- Key changes as bullet points
+-->
+
+-
+
+## テスト / Testing
+
+<!--
+- [x] 単体テストを追加・更新した / Added or updated unit tests
+- [x] CI が緑 / CI is green
+-->
+
+- [ ] バックエンドテスト: `uv run pytest tests/ -v`
+- [ ] バックエンド Lint: `uv run ruff check src/ tests/`
+- [ ] フロントエンドテスト: `cd frontend && npm run test:ci`
+- [ ] フロントエンド Lint: `cd frontend && npm run lint`
+- [ ] フロントエンドビルド: `cd frontend && npm run build`
+- [ ] E2E（UI 変更時）: `cd frontend && npm run e2e`
+- [ ] スクリーンショット再撮影（UI 変更時）: `cd frontend && npm run screenshots`
+
+## スクリーンショット / Screenshots
+
+<!--
+UI 変更がある場合、Before / After のスクリーンショットを貼ってください。
+For UI changes, paste before/after screenshots.
+-->
+
+## チェックリスト / Checklist
+
+- [ ] [CONTRIBUTING.md](../blob/main/CONTRIBUTING.md) を読んだ / Read CONTRIBUTING
+- [ ] Conventional Commits 形式でコミットしている / Commits follow Conventional Commits
+- [ ] 公開 API / CLI / 設定変更時は alforge-labs ドキュメントも更新 / Public API/CLI/config changes update alforge-labs docs
+- [ ] 破壊的変更がある場合 PR 説明欄に明記 / Breaking changes are clearly noted

alpha_visualizer-0.2.0/.github/codeql/README.md

@@ -0,0 +1,55 @@
+# CodeQL 設定
+
+このディレクトリは GitHub Actions の CodeQL ワークフロー
+（`.github/workflows/codeql.yml`）から参照される設定を管理する。
+
+## ファイル構成
+
+- **`codeql-config.yml`** — メイン設定。クエリスイート・除外パス。
+- **`README.md`** — 本ファイル。
+
+## 採用しているクエリスイート
+
+| Suite | 役割 |
+|---|---|
+| `security-and-quality` | 既定。コード品質 + セキュリティの幅広いチェック |
+| `security-extended` | 高精度のセキュリティ強化クエリ（SQL injection / SSRF / path traversal / XSS 等） |
+
+両方を `uses:` で並べることで、Quality 警告と高精度 Security 警告を併発する。
+
+## 除外パス
+
+`paths-ignore:` セクションで以下を除外:
+
+- `src/alpha_visualizer/static/**` — Vite ビルド成果物（vendor 化された JS）
+- `frontend/src/api/types.gen.ts` — `openapi-typescript` 自動生成
+- `frontend/openapi.json` — FastAPI 自動生成スキーマ
+- `frontend/e2e/fixtures/**` / `tests/fixtures/**` — テストフィクスチャ
+
+## カスタム `.ql` クエリの追加方法（将来）
+
+プロジェクト固有のパターン（例: `text("SELECT ..." + user_input)` 形式の生 SQL
+注入、forge.db のパス注入など）をカスタムクエリで検出したい場合:
+
+1. `.github/codeql/queries/` ディレクトリを作成
+2. `qlpack.yml` を作成（言語と依存パックを宣言）
+3. `MyCheck.ql` 等のクエリファイルを追加（CodeQL の QL 言語）
+4. `codeql-config.yml` の `queries:` に
+   `- uses: ./.github/codeql/queries` を追加
+
+> 参考: <https://docs.github.com/code-security/codeql-cli/getting-started-with-the-codeql-cli/customizing-analysis-with-codeql-packs>
+
+## ローカル動作確認
+
+CodeQL CLI が手元にあれば以下で簡易検証可能:
+
+```sh
+codeql database create build/codeql-db \
+  --language=python --source-root=src
+codeql database analyze build/codeql-db \
+  codeql/python-queries:codeql-suites/security-and-quality.qls \
+  codeql/python-queries:codeql-suites/security-extended.qls \
+  --format=sarif-latest --output=build/codeql.sarif
+```
+
+CI では `github/codeql-action/init@v3` がこれを自動化する。

alpha_visualizer-0.2.0/.github/codeql/codeql-config.yml

@@ -0,0 +1,24 @@
+name: alpha-visualizer CodeQL config
+
+# 既定の `security-and-quality` に加えて `security-extended` も有効化する。
+# `security-extended` は精度の高い高重要度クエリのみだが、デフォルトより
+# 範囲が広い（SQL injection / SSRF / path traversal 等の疑わしい
+# データフローもアラート対象になる）。
+queries:
+  - uses: security-and-quality
+  - uses: security-extended
+
+# 解析対象から除外するパス。
+# - vendor 化された静的ビルド成果物 / フロントエンドの自動生成型
+# - テストフィクスチャ（CodeQL のセキュリティ警告は production code に絞る）
+paths-ignore:
+  - "src/alpha_visualizer/static/**"
+  - "frontend/src/api/types.gen.ts"
+  - "frontend/openapi.json"
+  - "frontend/e2e/fixtures/**"
+  - "tests/fixtures/**"
+  # tests/test_app.py は import 重複 / unused local 等の note アラートが多いが、
+  # テストの可読性優先で許容する（Issue #148 で triage 済み）。
+  - "tests/test_app.py"
+  - "**/__pycache__/**"
+  - "**/node_modules/**"

alpha_visualizer-0.2.0/.github/dependabot.yml

@@ -0,0 +1,68 @@
+version: 2
+updates:
+  # Python パッケージ（uv が pyproject.toml + uv.lock を使うが、Dependabot は pip エコシステムとして扱う）
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+
+  # フロントエンド npm
+  - package-ecosystem: "npm"
+    directory: "/frontend"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "frontend"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    groups:
+      react:
+        patterns:
+          - "react"
+          - "react-dom"
+          - "@types/react"
+          - "@types/react-dom"
+      visx:
+        patterns:
+          - "@visx/*"
+      eslint:
+        patterns:
+          - "eslint*"
+          - "@eslint/*"
+          - "typescript-eslint"
+      testing-library:
+        patterns:
+          - "@testing-library/*"
+      vitest:
+        patterns:
+          - "vitest"
+          - "@vitest/*"
+      storybook:
+        patterns:
+          - "storybook"
+          - "@storybook/*"
+
+  # GitHub Actions ワークフロー
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    labels:
+      - "dependencies"
+      - "ci"
+    commit-message:
+      prefix: "ci"
+      include: "scope"