| name | sqlite-table-definition-trail-core |
| effort | low |
| description | anytime-markdown（trail.db / trail-core）固有の SQLite テーブル定義の補足。スキーマ配置パス・マイグレーションスクリプト規約・本番 DB 運用を定義する。汎用 SQLite 規約（STRICT / CHECK / FK ON DELETE / 12-step migration）は global スキル `sqlite-table-definition` に集約。trail-core のテーブル・制約・インデックス・マイグレーションを追加/変更する時に使用する。 |
SQLite テーブル定義（trail-core 固有補足）
更新日: 2026-06-20
anytime-markdown の SQLite 永続化（主に trail.db）でテーブルを定義・変更する際のプロジェクト固有の補足。
STRICT・CHECK・FK ON DELETE・timestamp GLOB・インデックス命名・12-step テーブル再作成といった汎用ルールは global スキル sqlite-table-definition に集約しているため、本スキルと併用すること。
[!IMPORTANT]
汎用 SQLite 規約は global ~/.claude/skills/sqlite-table-definition/SKILL.md を参照。本スキルは trail-core 固有の配置・運用差分のみを定義する。
適用範囲（trail-core 固有のパス）
| 対象 | 場所 |
|---|
| 新規テーブル定義 | packages/trail-core/src/domain/schema/tables.ts への CREATE TABLE 追加 |
| マイグレーションスクリプト | scripts/migrate-*.mts（tables.ts から DDL を直接 import） |
| 既存 DB へのインデックス追加 | 初期化処理に CREATE INDEX IF NOT EXISTS を追加（次回起動時に冪等適用。VS Code 拡張ではユーザーの Extension Host 再起動が必要） |
trail-core 固有の運用メモ
- マイグレーションは
.mts で書く: tables.ts の DDL を import して drift を防ぐ。.mjs での DDL inline 複製は禁止。実行は node --experimental-strip-types scripts/migrate-<topic>.mts <db-path>。
- 本番
trail.db への適用: 直接実行せず、cp でコピー → 動作確認（integrity_check / foreign_key_check / row counts）→ VACUUM → 原子的 swap（*.before-X-YYYYMMDD でバックアップ）の順。詳細手順は global スキル §9.6 を参照。
- 既存データ保持が前提: trail.db は既存データを保持するため
ALTER TABLE / 12-step migration を使う（Supabase の洗い替え方式とは異なる。code-quality.md §21 参照）。
sql.js（WASM SQLite）のクエリ設計: trail-viewer 等の sql.js 経由クエリは CTE + window 関数 + 非等値 JOIN + GROUP BY の組み合わせで性能崩壊する。シンプル範囲スキャン + JS 側集計に分解する（code-quality.md §16 参照）。
関連
- global
sqlite-table-definition — 汎用 SQLite テーブル定義ルール（本スキルの前提）
code-quality.md §15（日時データの UTC 統一）・§16（sql.js クエリ設計）・§21（Supabase スキーマ運用）
