alpha-strike 0.3.0__tar.gz

alpha_strike-0.3.0/.claude/commands/pre-release.md

@@ -0,0 +1,67 @@
+---
+name: pre-release
+description: PyPI リリース前のローカル検証 → リリース実行
+command: true
+---
+
+# pre-release コマンド
+
+alpha-strike を PyPI に公開する前にローカルで lint / test / build を検証し、問題なければリリースする。
+
+## 使い方
+
+```
+/pre-release [patch|minor|major]
+```
+
+引数を省略した場合は `patch` として扱う。
+
+## 実行手順
+
+1. **作業ディレクトリの確認**
+
+   alpha-strike リポジトリのルートにいること、かつ `main` ブランチにいることを確認する。
+
+   ```bash
+   git branch --show-current
+   git status
+   ```
+
+   未コミットの変更があれば中断してユーザーに確認を求める。
+
+2. **ローカル検証**
+
+   ```bash
+   uv sync --all-groups
+   uv run ruff check .
+   uv run pytest -q
+   uv build
+   ```
+
+   wheel / sdist が `dist/alpha_strike-*.whl` / `dist/alpha_strike-*.tar.gz` として生成されることを確認。
+   失敗した場合は中断してエラー内容をユーザーに報告する。
+
+3. **バージョン確認**
+
+   現在のバージョンと、バンプ後のバージョンをユーザーに提示して確認を求める。
+
+   ```bash
+   grep '^version' pyproject.toml
+   ```
+
+4. **リリース実行**
+
+   ユーザーの承認を得てから実行する。
+
+   ```bash
+   bash release.sh ${PART}
+   ```
+
+   `release.sh` がタグを push すると `.github/workflows/release.yml` が走り、
+   PyPI Trusted Publisher 経由で wheel / sdist が PyPI に公開される。
+
+## 注意
+
+- `release.sh` は `git push --tags` まで実行するため、実行前に必ずユーザーの承認を取ること。
+- `git-cliff` と `bump-my-version` が必要（`uv sync --all-groups` で導入済み）。
+- PyPI 公開には事前に PyPI の Trusted Publisher 設定で `alforge-labs/alpha-strike` を登録する必要がある。

alpha_strike-0.3.0/.dockerignore

@@ -0,0 +1,28 @@
+# 機密情報・環境変数（絶対にイメージに含めないこと）
+.env
+
+# Python キャッシュ
+__pycache__/
+*.py[oc]
+.venv/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Git
+.git/
+.gitignore
+
+# IDE
+.vscode/
+.idea/
+
+# macOS
+.DS_Store
+
+# PM2 ログ
+logs/
+
+# ドキュメント（本番イメージ不要）
+docs/
+*.md

alpha_strike-0.3.0/.env.example

@@ -0,0 +1,32 @@
+# Alpha-Strike 環境変数サンプル
+# このファイルをコピーして .env を作成し、実際の値を設定してください。
+# .env はバージョン管理対象外（.gitignore に記載済み）です。
+#
+# [セキュリティ]
+# VPS などのサーバーに配置する場合: chmod 600 .env でアクセス権を制限してください。
+# 開発者向け: 1Password CLI (op) を使用する場合は .env.op を参照してください。
+#   → brew install 1password-cli && make run
+
+# TradingView Webhook認証パスフレーズ（必須）
+# TradingViewのアラート設定で同じ値を使用してください
+WEBHOOK_PASSPHRASE=your-secret-passphrase
+
+# OANDA証券 設定
+# Personal Access Token（OANDAのマイページから取得）
+OANDA_API_KEY=your-oanda-personal-access-token
+# 口座ID（OANDAのマイページで確認）
+OANDA_ACCOUNT_ID=your-account-id
+# テスト時は必ずPRACTICEを使用してください（LIVE=本番）
+OANDA_ENV=PRACTICE
+
+# moomoo証券 (Futu OpenAPI) 設定
+# VPS上で systemd 起動した Futu OpenD へ Docker コンテナから接続するための設定
+# ローカル開発時は 127.0.0.1 に変更してください
+MOOMOO_HOST=host.docker.internal
+MOOMOO_PORT=11111
+# テスト時は必ずSIMULATEを使用してください（REAL=本番）
+MOOMOO_TRD_ENV=SIMULATE
+
+# イベントログ保存先（docker-compose.yml の volumes マウント先と一致させること）
+# ローカル開発時: LIVE_EVENTS_PATH=./data/events
+LIVE_EVENTS_PATH=/app/data/events

alpha_strike-0.3.0/.env.op

@@ -0,0 +1,7 @@
+WEBHOOK_PASSPHRASE=op://AlphaTrade/alpha-strike/WEBHOOK_PASSPHRASE
+OANDA_API_KEY=op://AlphaTrade/alpha-strike/OANDA_API_KEY
+OANDA_ACCOUNT_ID=op://AlphaTrade/alpha-strike/OANDA_ACCOUNT_ID
+OANDA_ENV=op://AlphaTrade/alpha-strike/OANDA_ENV
+MOOMOO_HOST=op://AlphaTrade/alpha-strike/MOOMOO_HOST
+MOOMOO_PORT=op://AlphaTrade/alpha-strike/MOOMOO_PORT
+MOOMOO_TRD_ENV=op://AlphaTrade/alpha-strike/MOOMOO_TRD_ENV

alpha_strike-0.3.0/.envrc

@@ -0,0 +1 @@
+dotenv

alpha_strike-0.3.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-strike.
+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-strike/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-strike 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-strike
+          required: true

alpha_strike-0.3.0/.github/ISSUE_TEMPLATE/bug_report_ja.yml

@@ -0,0 +1,99 @@
+name: 🐛 バグ報告（日本語）
+description: 再現可能なバグを報告して alpha-strike の改善にご協力ください。
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        バグ報告をいただきありがとうございます。以下の項目にご記入ください。
+        提出前に [既存の Issue](https://github.com/alforge-labs/alpha-strike/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-strike のバージョン
+      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-strike を使用している
+          required: true

alpha_strike-0.3.0/.github/ISSUE_TEMPLATE/config.yml

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

alpha_strike-0.3.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,39 @@
+name: 💡 Feature Request (English)
+description: Suggest an idea or enhancement for alpha-strike.
+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-strike/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_strike-0.3.0/.github/ISSUE_TEMPLATE/feature_request_ja.yml

@@ -0,0 +1,39 @@
+name: 💡 機能要望（日本語）
+description: alpha-strike の改善案・新機能を提案してください。
+title: "[Feature]: "
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ご提案ありがとうございます。アイデアの詳細をご記入ください。
+        提出前に [既存の Issue](https://github.com/alforge-labs/alpha-strike/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_strike-0.3.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,58 @@
+<!--
+日本語ガイド: https://github.com/alforge-labs/alpha-strike/blob/main/CONTRIBUTING.md
+English guide: https://github.com/alforge-labs/alpha-strike/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 && pnpm run test:ci`
+- [ ] フロントエンド Lint: `cd frontend && pnpm run lint`
+- [ ] フロントエンドビルド: `cd frontend && pnpm run build`
+- [ ] E2E（UI 変更時）: `cd frontend && pnpm run e2e`
+- [ ] スクリーンショット再撮影（UI 変更時）: `cd frontend && pnpm 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_strike-0.3.0/.github/codeql/codeql-config.yml

@@ -0,0 +1,17 @@
+name: alpha-strike CodeQL config
+
+# 既定の `security-and-quality` に加えて `security-extended` も有効化する。
+# `security-extended` は精度の高い高重要度クエリのみだが、デフォルトより
+# 範囲が広い（SQL injection / SSRF / path traversal 等の疑わしい
+# データフローもアラート対象になる）。
+queries:
+  - uses: security-and-quality
+  - uses: security-extended
+
+# 解析対象から除外するパス。
+# - テストフィクスチャ / __pycache__ / dist
+paths-ignore:
+  - "tests/fixtures/**"
+  - "**/__pycache__/**"
+  - "dist/**"
+  - "build/**"

alpha_strike-0.3.0/.github/copilot-instructions.md

@@ -0,0 +1,93 @@
+# Alpha-Strike — Copilot Instructions
+
+FastAPI webhook server that receives TradingView alerts and routes orders to OANDA or moomoo brokers.
+
+## Commands
+
+```bash
+uv sync                                              # install / update dependencies
+uv run uvicorn webhook_server:app --host 0.0.0.0 --port 8080 --reload  # dev server
+uv run pytest                                        # full test suite
+uv run pytest tests/test_oanda_handler.py -v        # single test file
+uv run pytest tests/test_webhook_server.py::test_name -v  # single test
+uv run ruff check .                                  # lint
+```
+
+Requires Python 3.14. Add packages with `uv add <package>`, not `pip install`.
+
+## Architecture
+
+```
+POST /webhook  →  webhook_server.py  →  handlers/oanda_handler.py   →  OANDA REST API v20
+                                     →  handlers/moomoo_handler.py  →  moomoo OpenD (local)
+POST /events/trade-closed  →  event_logger.py  →  JSONL files
+```
+
+**Entry point**: `webhook_server.py` (FastAPI + slowapi rate limiting)
+
+**Handlers** (`handlers/`):
+- `oanda_handler.py` — OANDA REST API v20 (`api-fxpractice.oanda.com` / `api-fxtrade.oanda.com`)
+- `moomoo_handler.py` — moomoo/Futu OpenAPI via OpenD local gateway
+
+**Event logger**: `event_logger.py` — writes `SignalEvent`, `OrderEvent`, `FillEvent`, `TradeClosedEvent` as JSONL to `$LIVE_EVENTS_PATH` (format: `YYYY-MM-DD.<broker>.jsonl`)
+
+**Models**: `models.py` — all Pydantic models (`WebhookPayload`, `OrderResult`, event types)
+
+## Key Implementation Details
+
+### OANDA instrument conversion (`oanda_handler.py`)
+- `FX` / `COMMODITY`: `USDJPY` → `USD_JPY` (split 6-char ticker at position 3)
+- `US` / `INDEX`: `AAPL` → `AAPL_USD` (append `_USD`)
+- Other: pass through as-is
+
+### OANDA SELL orders
+`units` must be negative for SELL (e.g., `-1000`).
+
+### moomoo asset classes
+- `HK` → `OpenHKTradeContext`; all others → `OpenUSTradeContext`
+- Ticker format: `US.AAPL`, `HK.00700`
+
+### OpenD pre-flight check
+`moomoo_handler.py` does a TCP connection check to `MOOMOO_HOST:MOOMOO_PORT` (3s timeout) before placing any order. Raises `RuntimeError` if unreachable. Start OpenD before the server.
+
+### Opposite-fill detection
+Both handlers detect when an incoming fill closes an existing open position (opposite-side fill for same strategy/ticker). Generates `TradeClosedEvent` automatically. For reversal fills (quantity exceeds open position), the excess becomes a new `FillEvent` with a fresh `trade_id`.
+
+### Passphrase authentication
+All endpoints (`/webhook`, `/events/trade-closed`) validate `passphrase` against `WEBHOOK_PASSPHRASE` env var. Use `hmac.compare_digest` to prevent timing attacks.
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `WEBHOOK_PASSPHRASE` | Yes | — | TradingView auth passphrase |
+| `LIVE_EVENTS_PATH` | No | — | JSONL event output directory |
+| `OANDA_API_KEY` | OANDA | — | Personal Access Token |
+| `OANDA_ACCOUNT_ID` | OANDA | — | Account ID |
+| `OANDA_ENV` | OANDA | `PRACTICE` | `PRACTICE` or `LIVE` |
+| `MOOMOO_HOST` | moomoo | `127.0.0.1` | OpenD host |
+| `MOOMOO_PORT` | moomoo | `11111` | OpenD port |
+| `MOOMOO_TRD_ENV` | moomoo | `SIMULATE` | `SIMULATE` or `REAL` |
+
+## Webhook Payload
+
+```json
+{
+  "passphrase": "secret",
+  "broker": "oanda",
+  "asset_class": "FX",
+  "action": "buy",
+  "ticker": "USDJPY",
+  "quantity": 1000
+}
+```
+
+`broker` is `"oanda"` or `"moomoo"`. `action` is `"buy"` or `"sell"`.
+
+## Docker
+
+```bash
+docker compose up -d   # production (port 8080, nginx reverse proxy)
+```
+
+`ecosystem.config.js` is a PM2 config for non-Docker deployments.

alpha_strike-0.3.0/.github/dependabot.yml

@@ -0,0 +1,47 @@
+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"
+    groups:
+      fastapi:
+        patterns:
+          - "fastapi"
+          - "starlette"
+          - "uvicorn*"
+      pydantic:
+        patterns:
+          - "pydantic*"
+      moomoo-sdk:
+        patterns:
+          - "futu-api"
+          - "moomoo-api"
+      test:
+        patterns:
+          - "pytest*"
+      lint:
+        patterns:
+          - "ruff"
+
+  # GitHub Actions ワークフロー
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    labels:
+      - "dependencies"
+      - "ci"
+    commit-message:
+      prefix: "ci"
+      include: "scope"

alpha_strike-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Lint (ruff)
+        run: uv run ruff check .
+
+      - name: Test (pytest)
+        run: uv run pytest tests/ -q