watashi-db 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 watashi-db contributors
+
+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.

package/README.md

@@ -0,0 +1,239 @@
+# watashi-db (わたしDB)
+
+> User-owned personal context database as an MCP server.
+> Each AI tool connects with permission — reversing vendor lock-in.
+
+> [!NOTE]
+> **v0.x は開発初期段階です。** APIやデータ構造に破壊的変更が入る可能性があります。
+> データはすべてローカル（`~/.watashi-db/watashi.db`）に保存され、外部送信は一切ありません。
+
+---
+
+## 概要
+
+**わたしDB** は、ユーザーが自分の情報（好み・スキル・価値観・意思決定）を所有し、各社のAIツールがMCP（Model Context Protocol）を通じて接続・利用する「パーソナルコンテキストデータベース」です。
+
+従来、AIツールごとにユーザー情報がサイロ化していた問題を解決し、**ベンダーロックインの逆転** を実現します。
+
+### 特徴
+
+- **SPO三つ組モデル**: Subject-Predicate-Object 形式でユーザー知識を構造的に記録
+- **MCP準拠**: Model Context Protocol サーバーとして動作、あらゆるMCPクライアントから接続可能
+- **SQLite + FTS5**: ローカルファイルDB、全文検索対応、ゼロ依存のインフラ
+- **変更履歴保持**: Claimの更新は全て履歴に記録、削除ではなく撤回（retract）モデル
+- **監査ログ**: 全操作に「誰が・何を・なぜ」を自動記録
+- **Provenance自動付与**: 接続元AIの情報をサーバー側で自動記録（自己申告に依存しない）
+- **L2推論基盤**: Claim間の関係（推論グラフ）、構造化根拠参照、検証ログ
+
+---
+
+## セットアップ
+
+### 前提条件
+
+- Node.js >= 18
+- MCP対応のAIクライアント（Claude Code, Claude Desktop 等）
+
+### インストール
+
+```bash
+npm install -g watashi-db
+```
+
+### Claude Code での設定
+
+```bash
+claude mcp add watashi-db -- npx watashi-db
+```
+
+または `~/.claude.json` に直接記述：
+
+```json
+{
+  "mcpServers": {
+    "watashi-db": {
+      "command": "npx",
+      "args": ["watashi-db"]
+    }
+  }
+}
+```
+
+### Claude Desktop での設定
+
+`claude_desktop_config.json` に追加：
+
+```json
+{
+  "mcpServers": {
+    "watashi-db": {
+      "command": "npx",
+      "args": ["watashi-db"]
+    }
+  }
+}
+```
+
+### Claude Code Cowork プラグイン
+
+[Releases](https://github.com/bareforge/watashi-db/releases) から `watashi-db-cowork-plugin.zip` をダウンロードし、Cowork UI の「プラグインをアップロード」からインストールできます。
+
+プラグインには以下のスキルが含まれます：
+
+| スキル | 説明 |
+|--------|------|
+| `/session-start` | セッション開始時にプロファイルとコンテキストを自動読み込み |
+| `/remember <内容>` | ユーザーの好み・スキル・知識をわたしDBに記録 |
+| `/reflect [トピック]` | エピソード・意思決定の振り返りとパターン分析 |
+
+---
+
+## 使い方
+
+### ユーザー情報の登録
+
+AIとの会話中に自然に情報が登録されます。
+
+```
+# Claimとして登録（SPO三つ組）
+watashi_store_claim:
+  subject: "user"
+  predicate: "prefers"
+  object: "日本語コメント"
+  category: "preference"
+
+# 好みの簡易登録
+watashi_store_preference:
+  preference: "ダークモードのエディタ"
+```
+
+### 情報の取得
+
+```
+# プロファイル全体像（セッション開始時に推奨）
+watashi_get_profile_summary
+
+# トピック関連のコンテキスト検索
+watashi_query_context:
+  topic: "TypeScript"
+
+# 条件検索
+watashi_search_claims:
+  category: "skill"
+  status: "active"
+```
+
+### 意思決定の記録
+
+```
+watashi_log_decision:
+  title: "MIT LICENSEを採用"
+  description: "オープンソースライセンスの選定"
+  reasoning: "最も自由度が高く、個人プロジェクトに適切"
+  alternatives: ["Apache 2.0", "GPL v3"]
+```
+
+---
+
+## アーキテクチャ
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Claude Code   │    │ Claude Desktop  │    │  Other AI Tool  │
+│  (MCP Client)   │    │  (MCP Client)   │    │  (MCP Client)   │
+└────────┬────────┘    └────────┬────────┘    └────────┬────────┘
+         │ MCP                  │ MCP                  │ MCP
+         └──────────────────────┼──────────────────────┘
+                                │
+                    ┌───────────▼───────────┐
+                    │     watashi-db        │
+                    │   (MCP Server)        │
+                    │                       │
+                    │  ┌─────────────────┐  │
+                    │  │   Tools (17)    │  │
+                    │  │  Resources (2)  │  │
+                    │  │  Prompts (1)    │  │
+                    │  └────────┬────────┘  │
+                    │           │           │
+                    │  ┌────────▼────────┐  │
+                    │  │   SQLite + FTS5 │  │
+                    │  │  (~/.watashi-db │  │
+                    │  │   /watashi.db)  │  │
+                    │  └─────────────────┘  │
+                    └───────────────────────┘
+```
+
+### データモデル
+
+| テーブル | 説明 |
+|---------|------|
+| `claims` | SPO三つ組の知識断片（主語・述語・目的語） |
+| `claims_fts` | FTS5全文検索インデックス |
+| `claim_history` | Claimの変更履歴 |
+| `claim_relations` | Claim間の推論関係（7種: supports, contradicts, derives, ...） |
+| `claim_evidence` | 構造化根拠参照（7種: url, file, claim, ...） |
+| `claim_checks` | 検証ログ（7種 x 4結果） |
+| `decisions` | 意思決定ログ |
+| `episodes` | 思考パターン・意思決定エピソード（文脈→問題→欲求→決定→結果→原則） |
+| `episodes_fts` | Episodes用FTS5全文検索インデックス |
+| `audit_log` | 全操作の監査ログ |
+
+### MCPツール一覧
+
+| ツール | 説明 |
+|--------|------|
+| `watashi_store_claim` | SPO三つ組でユーザー知識を記録 |
+| `watashi_update_claim` | 既存Claimを更新（履歴付き） |
+| `watashi_retract_claim` | Claimを撤回（削除ではない） |
+| `watashi_supersede_claim` | Claimを新しいClaimで置き換え |
+| `watashi_get_claim` | Claim詳細 + 変更履歴を取得 |
+| `watashi_search_claims` | 条件検索（カテゴリ・スコープ・テキスト） |
+| `watashi_query_context` | FTS5全文検索でコンテキスト取得 |
+| `watashi_log_decision` | 意思決定を構造的に記録 |
+| `watashi_list_decisions` | 意思決定ログの検索・一覧 |
+| `watashi_update_decision_status` | 意思決定のステータス遷移 |
+| `watashi_get_profile_summary` | プロファイル全体像をMarkdownで取得 |
+| `watashi_store_preference` | 好みの簡易登録ショートカット |
+| `watashi_log_episode` | 思考パターン・意思決定エピソードを構造的に記録 |
+| `watashi_list_episodes` | エピソードの検索・一覧（FTS5・タグ対応） |
+| `watashi_get_episode` | エピソード詳細を取得 |
+| `watashi_backup_db` | SQLiteファイルのバックアップ |
+| `watashi_export_json` | 全データのJSONエクスポート |
+
+---
+
+## 背景思想
+
+わたしDBは **L1/L2言語構想** から派生したプロジェクトです。
+
+- **L2（AI内部思考言語）**: AIが内部で使う構造化された中間表現
+- **L1（人間向け監査言語）**: 人間が読める形でAIの思考を説明する言語
+
+わたしDBはまず「パーソナルコンテキストストア」としての完成を目指し、将来的にL2推論基盤としての発展を構想しています。
+
+---
+
+## 開発
+
+```bash
+# ビルド
+npm run build
+
+# テスト
+npm test
+
+# 開発モード（ファイル監視）
+npm run dev
+```
+
+### DBファイルの場所
+
+```
+~/.watashi-db/watashi.db
+```
+
+---
+
+## ライセンス
+
+[MIT](LICENSE)

package/cowork-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "watashi-db",
+  "version": "0.0.5",
+  "description": "わたしDB - パーソナルコンテキストデータベース。ユーザーの好み・スキル・価値観・意思決定をセッション横断で記憶・活用します。",
+  "author": { "name": "watashi-db" },
+  "repository": "https://github.com/bareforge/watashi-db",
+  "license": "MIT",
+  "keywords": ["memory", "personalization", "context", "mcp"],
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/",
+  "agents": "./agents/"
+}

package/cowork-plugin/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "watashi-db": {
+      "command": "npx",
+      "args": ["watashi-db"]
+    }
+  }
+}

package/cowork-plugin/agents/memory-keeper.md

@@ -0,0 +1,48 @@
+---
+name: memory-keeper
+description: ユーザー情報の整合性をチェックし、古い情報や矛盾の検出・報告を行うサブエージェント。データ品質の維持が必要な時にClaudeが自動実行する。
+---
+
+バックグラウンドでユーザー情報の整合性を管理し、コンテキストの品質を維持するサブエージェントです。
+
+## 役割
+- ユーザーの記録（Claims, Episodes, Decisions）の整合性チェック
+- 古い情報や矛盾する情報の検出・報告
+- コンテキスト情報の最適化提案
+
+## 利用可能なツール
+- `watashi_search_claims`: Claim検索
+- `watashi_get_claim`: Claim詳細取得
+- `watashi_query_context`: コンテキスト検索
+- `watashi_list_episodes`: エピソード一覧
+- `watashi_list_decisions`: 意思決定一覧
+- `watashi_get_profile_summary`: プロファイル全体像
+
+## タスク
+
+### 1. 矛盾検出
+同じsubjectに対する矛盾するClaimを検出する:
+- 例: "user prefers tabs" と "user prefers spaces" が両方active
+- 検出した場合、ユーザーにどちらが最新か確認を促す
+
+### 2. 古いClaim確認
+長期間更新されていないClaimを特定する:
+- 作成から90日以上経過したClaimをリストアップ
+- ユーザーに現在も有効か確認を促す
+
+### 3. スコープ整理
+スコープの不整合を検出する:
+- globalスコープだがプロジェクト固有の内容
+- 存在しないプロジェクトスコープのClaim
+
+### 4. 重複検出
+内容が重複するClaimを特定する:
+- 同じobjectを持つ複数のClaim
+- 類似した内容で異なる表現のClaim
+- 重複がある場合、統合（supersede）を提案する
+
+## 実行方針
+- ユーザーのデータを勝手に変更しない（提案のみ）
+- 検出結果は簡潔にまとめて報告する
+- 重要度が高い問題（矛盾）を優先的に報告する
+- 軽微な問題（古いClaim）は一括でまとめて報告する

package/cowork-plugin/skills/reflect/SKILL.md

@@ -0,0 +1,58 @@
+---
+description: 記録されたエピソードや意思決定を振り返り、パターンや教訓を抽出する。ユーザーが /reflect で過去の経験を振り返りたい時に使用する。
+---
+
+記録されたエピソードや意思決定を振り返り、パターンや教訓を抽出します。
+
+## 引数
+- `$ARGUMENTS`: （オプション）振り返りたいトピックやキーワード
+
+## 手順
+
+1. **データ収集**: 以下のツールを並行して呼び出し、記録済みデータを取得する:
+   - `watashi_list_episodes`: エピソード一覧（引数があればキーワードで絞り込み）
+   - `watashi_list_decisions`: 意思決定一覧（引数があればキーワードで絞り込み）
+   - `watashi_search_claims`: 関連するClaim（category: value, workflow を優先）
+
+2. **パターン分析**: 取得したデータから以下のパターンを抽出する:
+   - **繰り返し現れるテーマ**: 複数のエピソードに共通するトピック
+   - **意思決定の傾向**: 一貫した判断基準やバイアス
+   - **成長の軌跡**: スキルや知識の変遷
+   - **原則の蓄積**: エピソードから導かれた原則（principles）
+
+3. **教訓の整理**: 特に以下に注目して教訓を整理する:
+   - 成功パターン: うまくいった判断とその理由
+   - 失敗からの学び: 問題が起きた状況と得られた教訓
+   - 未解決の課題: まだ結論が出ていない検討事項
+
+4. **サマリー提供**: 分析結果を構造化して提示する。
+
+## 出力形式
+
+```
+## 振り返りサマリー
+
+### 主要テーマ
+- [テーマ1]: [関連エピソード数]件のエピソードで言及
+- [テーマ2]: ...
+
+### 意思決定の傾向
+- [傾向の説明]
+- 例: [具体的な意思決定の例]
+
+### 蓄積された原則
+1. [原則1]（出典: [エピソードタイトル]）
+2. [原則2]（出典: ...）
+
+### 教訓
+- **成功パターン**: [説明]
+- **注意点**: [説明]
+
+### 今後の検討事項
+- [未解決の課題や発展的なテーマ]
+```
+
+## 注意事項
+- データが少ない場合（5件未満）は、その旨を伝えて記録の蓄積を促す
+- 振り返りの結果から新たな原則やClaimが導かれた場合は、記録を提案する
+- ユーザーのプライバシーに配慮し、機密性の高い内容は要約に留める

package/cowork-plugin/skills/remember/SKILL.md

@@ -0,0 +1,54 @@
+---
+description: ユーザーの好み・スキル・知識・価値観などをわたしDBに記録する。ユーザーが /remember で情報を記憶させたい時に使用する。
+---
+
+ユーザーの好み・スキル・知識・価値観などをわたしDBに記録します。
+
+## 引数
+- `$ARGUMENTS`: 記録したい内容（自然言語テキスト）
+
+## 手順
+
+1. **引数の解析**: `$ARGUMENTS` の内容を分析し、記録の種類を判別する:
+   - **好み（preference）**: 「〜が好き」「〜を使いたい」→ `watashi_store_preference` を使用
+   - **スキル（skill）**: 「〜ができる」「〜を学んだ」→ `watashi_store_claim` を使用（category: skill）
+   - **知識（knowledge）**: 「〜について知っている」→ `watashi_store_claim` を使用（category: knowledge）
+   - **価値観（value）**: 「〜を大切にしている」→ `watashi_store_claim` を使用（category: value）
+   - **ワークフロー（workflow）**: 「〜の手順で作業する」→ `watashi_store_claim` を使用（category: workflow）
+   - **アイデンティティ（identity）**: 「〜として活動している」→ `watashi_store_claim` を使用（category: identity）
+
+2. **重複チェック**: `watashi_search_claims` で類似する既存Claimがないか確認する。
+   - 類似Claimが見つかった場合、更新（`watashi_update_claim`）または置き換え（`watashi_supersede_claim`）を提案する。
+
+3. **記録実行**: 適切なツールで記録を行う。
+   - `subject`: 通常は "user"
+   - `predicate`: 内容に応じて選択（prefers, uses, knows, believes, practices など）
+   - `object`: 記録内容の要約
+   - `evidence`: ユーザーの元の発言をそのまま記録
+   - `scope`: 文脈に応じて設定（global, project:<name> など）
+
+4. **確認メッセージ**: 記録した内容をユーザーに確認する。
+
+## 出力形式
+
+```
+記録しました:
+- **種類**: [カテゴリ]
+- **内容**: [subject] [predicate] [object]
+- **スコープ**: [scope]
+```
+
+## 例
+
+```
+/remember TypeScriptではstrictモードを常に使う
+→ user prefers "TypeScript strict mode always enabled" (category: preference, scope: global)
+
+/remember このプロジェクトではvitest使う
+→ user uses "vitest for testing" (category: workflow, scope: project:current)
+```
+
+## 注意事項
+- 引数が空の場合は、何を記録したいか尋ねる
+- 曖昧な内容の場合は、具体化を促す質問をする
+- 機密情報（パスワード、トークンなど）は記録しないよう警告する

package/cowork-plugin/skills/session-start/SKILL.md

@@ -0,0 +1,38 @@
+---
+description: セッション開始時にユーザーのプロファイルとコンテキストを読み込む。新しい会話の開始時やユーザーが /session-start を呼び出した時に実行する。
+---
+
+セッション開始時にユーザーのプロファイルとコンテキストを読み込み、パーソナライズされた応答を提供します。
+
+## 手順
+
+1. **プロファイル読み込み**: `watashi_get_profile_summary` を呼び出して、ユーザーの好み・スキル・価値観の全体像を取得する。
+
+2. **関連コンテキスト取得**: `watashi_query_context` を呼び出して、現在のプロジェクトや作業に関連する直近のコンテキストを取得する。
+   - scopeパラメータがあれば、プロジェクトスコープで絞り込む（例: `project:watashi-db`）
+   - なければ `global` スコープで取得
+
+3. **直近のエピソード確認**: `watashi_list_episodes` を呼び出して、最近記録されたエピソード（思考パターン・意思決定）を2〜3件取得する。
+
+4. **コンテキスト要約の提供**: 取得した情報をもとに、以下を含む簡潔な挨拶を行う:
+   - ユーザーの主要な好み・作業スタイルの認識
+   - 直近の作業コンテキスト（進行中のプロジェクトなど）
+   - 関連するエピソードからの教訓や原則
+
+## 出力形式
+
+```
+[ユーザー名/呼称]さん、こんにちは。
+
+**現在のコンテキスト:**
+- [プロジェクト/作業の状況]
+- [関連する好み・設定]
+
+**直近の活動:**
+- [最近のエピソードや意思決定の要約]
+```
+
+## 注意事項
+- プロファイルが空の場合は、基本的な挨拶のみ行い、情報の記録を促す
+- 情報量が多い場合は、最も関連性の高いものに絞って提示する
+- ユーザーの好みに合わせた言語（日本語/英語）で応答する

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const DB_DIR: string;
+export declare const DB_PATH: string;
+export declare const SERVER_NAME = "watashi-db";
+export declare const SERVER_VERSION = "0.0.5";
+export declare const CLAIM_CATEGORIES: readonly ["preference", "identity", "skill", "value", "workflow", "knowledge", "custom"];
+export declare const CLAIM_SCOPES: readonly ["global", "project", "tool", "temporal"];
+export declare const CLAIM_STATUSES: readonly ["active", "retracted", "superseded"];
+export declare const DECISION_STATUSES: readonly ["active", "reversed", "obsolete"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -0,0 +1,43 @@
+import path from "node:path";
+import os from "node:os";
+// DBファイル配置: ~/.watashi-db/watashi.db（ユーザーホーム配下、プロジェクト非依存）
+export const DB_DIR = path.join(os.homedir(), ".watashi-db");
+export const DB_PATH = path.join(DB_DIR, "watashi.db");
+// MCPサーバー情報
+export const SERVER_NAME = "watashi-db";
+// 2026-02-11 修正: 実態に合わせてv0.0.1に変更（Codexレビュー指摘）
+// 元の実装: 0.1.0 としていたが、初期実装段階のため0.0.1が適切
+// 2026-02-13 修正: v0.0.5（Episodeモデル追加）
+// 元の実装: v0.0.4（Phase 3: テスト・README・LICENSE・エクスポート・npm化）
+// v0.1.0はGitHub公開時に付与予定
+export const SERVER_VERSION = "0.0.5";
+// Claimのカテゴリ一覧
+export const CLAIM_CATEGORIES = [
+    "preference", // 好み・設定
+    "identity", // アイデンティティ・自己認識
+    "skill", // スキル・能力
+    "value", // 価値観・信条
+    "workflow", // ワークフロー・作業手順
+    "knowledge", // 知識・事実
+    "custom", // カスタム
+];
+// Claimのスコープ種別
+export const CLAIM_SCOPES = [
+    "global", // 全体に適用
+    "project", // 特定プロジェクトに適用（project:<name>）
+    "tool", // 特定ツールに適用（tool:<name>）
+    "temporal", // 一時的に適用
+];
+// Claimのステータス（削除せず履歴保持）
+export const CLAIM_STATUSES = [
+    "active", // 有効
+    "retracted", // 撤回済み
+    "superseded", // 後続に置き換え済み
+];
+// 意思決定のステータス
+export const DECISION_STATUSES = [
+    "active", // 有効
+    "reversed", // 撤回済み
+    "obsolete", // 廃止
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,0DAA0D;AAC1D,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEvD,YAAY;AACZ,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AACxC,+CAA+C;AAC/C,uCAAuC;AACvC,sCAAsC;AACtC,wDAAwD;AACxD,wBAAwB;AACxB,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,eAAe;AACf,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,YAAY,EAAG,QAAQ;IACvB,UAAU,EAAK,gBAAgB;IAC/B,OAAO,EAAQ,SAAS;IACxB,OAAO,EAAQ,SAAS;IACxB,UAAU,EAAK,cAAc;IAC7B,WAAW,EAAI,QAAQ;IACvB,QAAQ,EAAO,OAAO;CACd,CAAC;AAEX,eAAe;AACf,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAO,QAAQ;IACvB,SAAS,EAAM,8BAA8B;IAC7C,MAAM,EAAS,wBAAwB;IACvC,UAAU,EAAK,SAAS;CAChB,CAAC;AAEX,wBAAwB;AACxB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ,EAAO,KAAK;IACpB,WAAW,EAAI,OAAO;IACtB,YAAY,EAAG,YAAY;CACnB,CAAC;AAEX,aAAa;AACb,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAO,KAAK;IACpB,UAAU,EAAK,OAAO;IACtB,UAAU,EAAK,KAAK;CACZ,CAAC"}

package/dist/database/connection.d.ts

@@ -0,0 +1,16 @@
+import Database from "better-sqlite3";
+/**
+ * SQLiteデータベース接続を取得（シングルトン）
+ * WALモード有効、FTS5使用
+ */
+export declare function getDatabase(): Database.Database;
+/**
+ * データベース接続を閉じる（プロセス終了時に呼び出し）
+ */
+export declare function closeDatabase(): void;
+/**
+ * テスト用: データベースインスタンスを外部から差し替える
+ * 本番コードでは使用しないこと
+ */
+export declare function _setDatabaseForTesting(testDb: Database.Database): void;
+//# sourceMappingURL=connection.d.ts.map

package/dist/database/connection.js

@@ -0,0 +1,42 @@
+import Database from "better-sqlite3";
+import fs from "node:fs";
+import { DB_DIR, DB_PATH } from "../constants.js";
+import { initializeSchema } from "./schema.js";
+let db = null;
+/**
+ * SQLiteデータベース接続を取得（シングルトン）
+ * WALモード有効、FTS5使用
+ */
+export function getDatabase() {
+    if (db)
+        return db;
+    // DBディレクトリが無ければ作成
+    if (!fs.existsSync(DB_DIR)) {
+        fs.mkdirSync(DB_DIR, { recursive: true });
+    }
+    db = new Database(DB_PATH);
+    // WALモード: 読み書き並行性の向上
+    db.pragma("journal_mode = WAL");
+    // 外部キー制約を有効化
+    db.pragma("foreign_keys = ON");
+    // スキーマ初期化
+    initializeSchema(db);
+    return db;
+}
+/**
+ * データベース接続を閉じる（プロセス終了時に呼び出し）
+ */
+export function closeDatabase() {
+    if (db) {
+        db.close();
+        db = null;
+    }
+}
+/**
+ * テスト用: データベースインスタンスを外部から差し替える
+ * 本番コードでは使用しないこと
+ */
+export function _setDatabaseForTesting(testDb) {
+    db = testDb;
+}
+//# sourceMappingURL=connection.js.map

package/dist/database/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/database/connection.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,IAAI,EAAE,GAA6B,IAAI,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,kBAAkB;IAClB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,EAAE,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE3B,qBAAqB;IACrB,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,aAAa;IACb,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,UAAU;IACV,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAErB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAyB;IAC9D,EAAE,GAAG,MAAM,CAAC;AACd,CAAC"}