Issue #1: 芦屋研究コアと2連単strategy sandboxを追加

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.9"
+          - "3.14"
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .
+      - name: Run unit tests
+        run: python -m unittest discover -s tests -v
+      - name: Compile Python sources
+        run: python -m compileall -q src scripts tests

.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.egg-info/
+.coverage
+.pytest_cache/
+build/
+dist/
+data/

AGENTS.md

@@ -34,7 +34,7 @@ FunaYomiは、芦屋ボートレースの過去データとオッズを用い、
 ## 現在の固定方針
 
 - 初期対象は芦屋、場コード `21`
-- 賭式は3連単を第一候補とするが、実装開始前に明示的に確定する
+- 初期賭式は3連単
 - 初期データ源はTurnmark API
 - 将来の当日情報候補はBoatrace Open API
 - 有料AI API・LLM APIを予測に使わない
@@ -45,24 +45,28 @@ FunaYomiは、芦屋ボートレースの過去データとオッズを用い、
 - 時系列分割を使い、未来情報の漏洩を防ぐ
 - 条件を満たさないレースは「見送り」とする
 
-## 現在の実装権限
+## 現在の実装状態と権限
 
-**実装はまだ許可されていません。**
+Issue #1 の明示的な許可により、M1〜M3と最小時系列バックテストの非UIコアを
+2026-07-24に実装しました。山田さんの2026-07-27のGate X承認により、
+Turnmark限定・retrospective・non-actionableな2連単schema、
+program Plackett–Luce、市場blend、固定予算portfolio backtestも完了
+しています。実際の状態、悪い結果を含む正式ledger、次の再開地点は
+`docs/HANDOFF.md`、データ境界は `docs/DATA_CONTRACT.md` を正本とします。
 
-現在は企画文書を作成しただけです。山田さんから明示的に実装開始の指示が来るまでは、依存関係の追加、コード生成、API取得処理、UI作成、Issueの大量作成を行わないでください。
+新しいマイルストーン、UI、当日データ源、自動投票へは、現在のIssueや
+山田さんの明示的な指示なしに拡張しないでください。既存コアのバグ修正、
+テストは、その指示範囲内で連続して進められます。Gate U、結果を見た追加の
+閾値・特徴・賭式探索、prospective収集は未承認です。
 
-## 次に実装が許可されたとき
+公式翌日番組LZHは廃案ではなく、将来prospective program snapshotが必要に
+なった場合の候補としてHoldしています。利用条件とfield契約は未確認で、
+収集は開始していません。現在の次工程として扱わないでください。
 
-最初に行うのは予測モデル作成ではなく、M1のデータ監査です。
-
-1. Turnmark APIから少数の日付のJSONを読み取る
-2. 芦屋 `stadium_number = 21` のレースを抽出する
-3. 出走表、直前情報、オッズ、結果の欠損と意味を確認する
-4. オッズがどの時点の値か、リポジトリだけで確認可能か調べる
-5. 3連単120通りの正規化仕様を文書化する
-6. 予測時点で利用可能な特徴だけをデータ契約に固定する
-
-この監査が終わるまで、確率モデルを本実装しないでください。
+M1監査をやり直す必要はありません。ただし Turnmark の原本は後日変更される
+ため、別SHAのデータを採用する場合は差分監査とデータ期間の記録が必要です。
+オッズ時点は未確認のままであり、「最終」「締切」「前夜」と断定しては
+いけません。
 
 ## 開発時の運用
 

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yo4e
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.