@hir4ta/memoria 0.11.1 → 0.11.3

package/.claude-plugin/plugin.json

@@ -1,18 +1,12 @@
 {
   "name": "memoria",
   "description": "A plugin that provides long-term memory for Claude Code. It automatically saves context lost during auto-compact, offering features for session restoration, recording technical decisions, and learning developer patterns.",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "author": {
     "name": "hir4ta"
   },
   "homepage": "https://github.com/hir4ta/memoria",
   "repository": "https://github.com/hir4ta/memoria",
   "license": "MIT",
-  "keywords": [
-    "memory",
-    "sessions",
-    "decisions",
-    "patterns",
-    "dashboard"
-  ]
-}
+  "keywords": ["memory", "sessions", "decisions", "patterns", "dashboard"]
+}

package/README.ja.md

@@ -2,13 +2,12 @@
 
 Claude Codeの長期記憶を実現するプラグイン
 
-セッションのリアルタイム保存、技術的な判断の記録、Webダッシュボードでの管理を提供します。
+セッションの自動保存、技術的な判断の記録、Webダッシュボードでの管理を提供します。
 
 ## 機能
 
 ### コア機能
-- **明示的セッション保存**: `/memoria:save` または「セッション保存して」で保存
-- **APIフォールバック**: Auto-Compact前とセッション終了時にOpenAI APIで自動保存
+- **自動保存**: Claudeの返信ごとにセッションを自動保存（設定不要）
 - **セッション再開**: `/memoria:resume` で過去のセッションを再開
 - **技術的な判断の記録**: `/memoria:decision` で判断を記録
 - **ルールベースレビュー**: `dev-rules.json` / `review-guidelines.json` に基づくレビュー
@@ -96,47 +95,23 @@ Claude Codeを再起動
 
 これによりClaude Code起動時に自動でアップデートされます
 
-## 設定（オプション）
-
-APIフォールバックによる自動セッション保存を有効にするには、`/memoria:init` を実行するか、手動で `~/.claude/memoria.json` を作成してください：
-
-```json
-{
-  "openai_api_key": "sk-...",
-  "model": "gpt-5-mini"
-}
-```
-
-| フィールド | 必須 | デフォルト | 説明 |
-|-----------|------|-----------|------|
-| `openai_api_key` | いいえ | - | 設定すると自動保存が有効になる |
-| `model` | いいえ | `gpt-5-mini` | 使用するモデル（gpt-5-mini, gpt-5, gpt-5.2など） |
-
-**`openai_api_key` なし**: `/memoria:save` での手動保存のみ。
-
-**`openai_api_key` あり**: 自動保存が有効になり、以下のタイミングで保存：
-- Auto-Compact前（status: `draft`）
-- セッション終了時（status: `complete`）
-
 ## 使い方
 
-### セッション保存
+### セッション自動保存
 
-| 方法 | タイミング | ステータス |
-|------|----------|-----------|
-| **明示的保存** | `/memoria:save` または「セッション保存して」 | `complete` |
-| **PreCompact** | Auto-Compact前（API） | `draft` |
-| **SessionEnd** | セッション終了時（API） | `complete` |
+セッションは**Claudeの返信ごとに自動保存**されます。設定不要。
 
-**注意**: PreCompact/SessionEnd のAPIフォールバックには `~/.claude/memoria.json` の設定が必要です。
+各返信時に以下が更新されます：
+- `interactions`: チャット形式の会話ログ
+- `summary`: タイトル、目的、結果、説明
+- `metrics`: ファイル数、決定数、エラー数
 
 ### コマンド
 
 | コマンド | 説明 |
 | --------- | ------ |
-| `/memoria:init` | 設定ファイルを初期化（`~/.claude/memoria.json`） |
 | `/memoria:resume [id]` | セッションを再開（ID省略で一覧表示） |
-| `/memoria:save` | セッション保存 + 会話からルール抽出 |
+| `/memoria:save` | ルール抽出 + 手動更新 |
 | `/memoria:decision "タイトル"` | 技術的な判断を記録 |
 | `/memoria:search "クエリ"` | セッション・判断記録を検索 |
 | `/memoria:review [--staged\|--all\|--diff=branch\|--full]` | ルールに基づくレビュー（--fullで二段階） |
@@ -183,46 +158,47 @@ npx @hir4ta/memoria --dashboard --port 8080
 
 ```mermaid
 flowchart TB
-    subgraph realtime [リアルタイム更新]
-        A[意味のある変化] --> B[セッションJSONを更新]
-        B --> C[interactions配列]
+    subgraph autosave [自動保存]
+        A[Claudeの返信] --> B[Stopフック]
+        B --> C[セッションJSON更新]
+        C --> D[interactions + summary + metrics]
     end
 
     subgraph manual [手動操作]
-        D["memoria:save"] --> E[セッションを強制保存]
-        F["memoria:decision"] --> G[判断を明示的に記録]
+        E["memoria:save"] --> F[ルール抽出 + 強制更新]
+        G["memoria:decision"] --> H[判断を明示的に記録]
     end
 
     subgraph resume [セッション再開]
-        H["memoria:resume"] --> I[一覧から選択]
-        I --> J[過去の文脈を復元]
+        I["memoria:resume"] --> J[一覧から選択]
+        J --> K[過去の文脈を復元]
     end
 
     subgraph search [検索]
-        K["memoria:search"] --> L[セッションと判断を検索]
+        L["memoria:search"] --> M[セッションと判断を検索]
     end
 
     subgraph review [レビュー]
-        P["memoria:review"] --> Q[ルールに基づく指摘]
-        Q --> R[レビュー結果を保存]
+        N["memoria:review"] --> O[ルールに基づく指摘]
+        O --> P[レビュー結果を保存]
     end
 
     subgraph report [週次レポート]
-        S["memoria:report"] --> T[レビュー集計レポート]
+        Q["memoria:report"] --> R[レビュー集計レポート]
     end
 
     subgraph dashboard [ダッシュボード]
-        M["npx @hir4ta/memoria -d"] --> N[ブラウザで表示]
-        N --> O[閲覧・編集・削除]
+        S["npx @hir4ta/memoria -d"] --> T[ブラウザで表示]
+        T --> U[閲覧・編集・削除]
     end
 
-    B --> H
-    E --> H
-    G --> K
-    B --> R
-    R --> T
-    B --> M
-    G --> M
+    D --> I
+    F --> I
+    H --> L
+    D --> P
+    P --> R
+    D --> S
+    H --> S
 ```
 
 ## データ保存
@@ -243,8 +219,6 @@ Gitでバージョン管理可能です。`.gitignore` に追加するかはプ
 
 ### セッションJSONスキーマ
 
-セッションは **分析向け** のスキーマを使用します。定量データ（metrics）と定性データ（summary）を分離し、files/decisions/errorsを独立配列として集計可能にしています。
-
 ```json
 {
   "id": "abc12345",
@@ -262,8 +236,15 @@ Gitでバージョン管理可能です。`.gitignore` に追加するかはプ
     "outcome": "success",
     "description": "RS256署名でJWT認証を実装"
   },
+  "interactions": [
+    {
+      "timestamp": "2026-01-27T10:15:00Z",
+      "user": "認証機能を実装して",
+      "assistant": "RS256署名でJWT認証を実装しました",
+      "toolsUsed": ["Read", "Edit", "Write"]
+    }
+  ],
   "metrics": {
-    "durationMinutes": 120,
     "filesCreated": 2,
     "filesModified": 1,
     "decisionsCount": 2,
@@ -299,21 +280,6 @@ Gitでバージョン管理可能です。`.gitignore` に追加するかはプ
 }
 ```
 
-### 更新トリガー
-
-Claude Code は意味のある変化があった時にセッションJSONを更新します：
-
-| トリガー | 更新内容 |
-|---------|---------|
-| セッションの目的が明確になった | `summary.title`, `summary.goal`, `sessionType` |
-| ファイルを変更した | `files` に追加、`metrics` 更新 |
-| 技術的決定を下した | `decisions` に追加 |
-| エラーに遭遇・解決した | `errors` に追加 |
-| URLを参照した | `webLinks` |
-| 新しいキーワードが出現 | `tags`（tags.jsonを参照） |
-
-**注意**: 明示的に `/memoria:save` を実行するか、APIフォールバックが発動するまでセッションは保存されません。
-
 ### セッションタイプ
 
 `sessionType` フィールドはセッションの種類を分類します。

package/README.md

@@ -2,13 +2,12 @@
 
 Long-term memory plugin for Claude Code
 
-Provides explicit session saving with API fallback, technical decision recording, and web dashboard management.
+Provides automatic session saving, technical decision recording, and web dashboard management.
 
 ## Features
 
 ### Core Features
-- **Explicit Session Saving**: Save with `/memoria:save` or "save session" request
-- **API Fallback**: Auto-save via OpenAI API before Auto-Compact and at session end
+- **Auto-save**: Sessions saved automatically on every Claude response (no configuration needed)
 - **Session Resume**: Resume past sessions with `/memoria:resume`
 - **Technical Decision Recording**: Record decisions with `/memoria:decision`
 - **Rule-based Review**: Code review based on `dev-rules.json` / `review-guidelines.json`
@@ -96,47 +95,23 @@ Restart Claude Code.
 
 This will auto-update on Claude Code startup.
 
-## Configuration (Optional)
-
-To enable API fallback for automatic session saving, run `/memoria:init` or manually create `~/.claude/memoria.json`:
-
-```json
-{
-  "openai_api_key": "sk-...",
-  "model": "gpt-5-mini"
-}
-```
-
-| Field | Required | Default | Description |
-|-------|----------|---------|-------------|
-| `openai_api_key` | No | - | Enables auto-save at PreCompact/SessionEnd |
-| `model` | No | `gpt-5-mini` | Model to use (gpt-5-mini, gpt-5, gpt-5.2, etc.) |
-
-**Without `openai_api_key`**: Sessions are only saved when you explicitly use `/memoria:save`.
-
-**With `openai_api_key`**: Auto-save is enabled. Sessions are automatically saved:
-- Before Auto-Compact (status: `draft`)
-- At session end (status: `complete`)
-
 ## Usage
 
-### Session Saving
+### Session Auto-Save
 
-| Method | When | Status |
-|--------|------|--------|
-| **Explicit** | `/memoria:save` or "save session" | `complete` |
-| **PreCompact** | Before Auto-Compact (API) | `draft` |
-| **SessionEnd** | Session end (API) | `complete` |
+Sessions are saved **automatically on every Claude response**. No configuration needed.
 
-**Note**: PreCompact/SessionEnd API fallback requires `~/.claude/memoria.json` configuration.
+On each response, Claude updates:
+- `interactions`: Chat-style conversation log
+- `summary`: Title, goal, outcome, description
+- `metrics`: File counts, decision counts, error counts
 
 ### Commands
 
 | Command | Description |
 |---------|-------------|
-| `/memoria:init` | Initialize config file (`~/.claude/memoria.json`) |
 | `/memoria:resume [id]` | Resume session (show list if ID omitted) |
-| `/memoria:save` | Save session + extract rules from conversation |
+| `/memoria:save` | Extract rules from conversation + manual update |
 | `/memoria:decision "title"` | Record a technical decision |
 | `/memoria:search "query"` | Search sessions and decisions |
 | `/memoria:review [--staged\|--all\|--diff=branch\|--full]` | Rule-based code review (--full for two-stage) |
@@ -183,46 +158,47 @@ npx @hir4ta/memoria --dashboard --port 8080
 
 ```mermaid
 flowchart TB
-    subgraph realtime [Real-time Updates]
-        A[Meaningful Change] --> B[Update Session JSON]
-        B --> C[interactions array]
+    subgraph autosave [Auto-Save]
+        A[Claude Response] --> B[Stop Hook]
+        B --> C[Update Session JSON]
+        C --> D[interactions + summary + metrics]
     end
 
     subgraph manual [Manual Actions]
-        D["memoria:save"] --> E[Force flush session]
-        F["memoria:decision"] --> G[Record decision explicitly]
+        E["memoria:save"] --> F[Extract rules + force update]
+        G["memoria:decision"] --> H[Record decision explicitly]
     end
 
     subgraph resume [Session Resume]
-        H["memoria:resume"] --> I[Select from list]
-        I --> J[Restore past context]
+        I["memoria:resume"] --> J[Select from list]
+        J --> K[Restore past context]
     end
 
     subgraph search [Search]
-        K["memoria:search"] --> L[Search sessions and decisions]
+        L["memoria:search"] --> M[Search sessions and decisions]
     end
 
     subgraph review [Review]
-        P["memoria:review"] --> Q[Rule-based findings]
-        Q --> R[Save review results]
+        N["memoria:review"] --> O[Rule-based findings]
+        O --> P[Save review results]
     end
 
     subgraph report [Weekly Report]
-        S["memoria:report"] --> T[Review summary report]
+        Q["memoria:report"] --> R[Review summary report]
     end
 
     subgraph dashboard [Dashboard]
-        M["npx @hir4ta/memoria -d"] --> N[Open in browser]
-        N --> O[View, edit, delete]
+        S["npx @hir4ta/memoria -d"] --> T[Open in browser]
+        T --> U[View, edit, delete]
     end
 
-    B --> H
-    E --> H
-    G --> K
-    B --> R
-    R --> T
-    B --> M
-    G --> M
+    D --> I
+    F --> I
+    H --> L
+    D --> P
+    P --> R
+    D --> S
+    H --> S
 ```
 
 ## Data Storage
@@ -243,8 +219,6 @@ Git-manageable. Add to `.gitignore` based on your project needs.
 
 ### Session JSON Schema
 
-Sessions use an **analysis-friendly** schema. Quantitative data (metrics) and qualitative data (summary) are separated, with files/decisions/errors as independent arrays for easy aggregation.
-
 ```json
 {
   "id": "abc12345",
@@ -262,8 +236,15 @@ Sessions use an **analysis-friendly** schema. Quantitative data (metrics) and qu
     "outcome": "success",
     "description": "Implemented JWT auth with RS256 signing"
   },
+  "interactions": [
+    {
+      "timestamp": "2026-01-27T10:15:00Z",
+      "user": "Implement authentication",
+      "assistant": "Implemented JWT auth with RS256 signing",
+      "toolsUsed": ["Read", "Edit", "Write"]
+    }
+  ],
   "metrics": {
-    "durationMinutes": 120,
     "filesCreated": 2,
     "filesModified": 1,
     "decisionsCount": 2,
@@ -299,19 +280,6 @@ Sessions use an **analysis-friendly** schema. Quantitative data (metrics) and qu
 }
 ```
 
-### Update Triggers
-
-Claude Code updates session JSON when meaningful changes occur:
-
-| Trigger | Update |
-|---------|--------|
-| Session purpose becomes clear | `summary.title`, `summary.goal`, `sessionType` |
-| File modified | Add to `files`, update `metrics` |
-| Technical decision made | Add to `decisions` |
-| Error encountered/resolved | Add to `errors` |
-| URL referenced | `webLinks` |
-| New keyword appears | `tags` (reference tags.json) |
-
 ### Session Types
 
 The `sessionType` field classifies the session type.

package/dist/lib/fuzzy-search.js

@@ -195,7 +195,7 @@ if (isMain && process.argv.length > 2) {
   const args = process.argv.slice(2);
   const queryIndex = args.indexOf("--query");
   const query = queryIndex !== -1 ? args[queryIndex + 1] : "";
-  const memoriaDir = process.cwd() + "/.memoria";
+  const memoriaDir = `${process.cwd()}/.memoria`;
   if (!query) {
     console.error(JSON.stringify({ success: false, error: "Missing --query" }));
     process.exit(0);

package/dist/lib/pattern-learner.js

@@ -88,11 +88,7 @@ function aggregateReviewFindings(reviews, minOccurrences = 3) {
 }
 async function learnPatterns(memoriaDir, options = {}) {
   const patterns = [];
-  const {
-    analyzeCommits = true,
-    analyzeReviews = true,
-    analyzeCoChanges = true
-  } = options;
+  const { analyzeReviews = true } = options;
   if (analyzeReviews) {
     const reviewsDir = path2.join(memoriaDir, "reviews");
     const reviewFiles = findJsonFiles(reviewsDir);
@@ -120,7 +116,7 @@ async function learnPatterns(memoriaDir, options = {}) {
 var isMain = process.argv[1]?.endsWith("pattern-learner.js") || process.argv[1]?.endsWith("pattern-learner.ts");
 if (isMain && process.argv.length > 2) {
   const args = process.argv.slice(2);
-  const memoriaDir = process.cwd() + "/.memoria";
+  const memoriaDir = `${process.cwd()}/.memoria`;
   learnPatterns(memoriaDir, {
     analyzeCommits: args.includes("--analyze-commits"),
     analyzeReviews: args.includes("--analyze-reviews"),

package/dist/lib/session-continuity.js

@@ -87,7 +87,7 @@ async function buildContinueContext(memoriaDir, tasksPath) {
 }
 var isMain = process.argv[1]?.endsWith("session-continuity.js") || process.argv[1]?.endsWith("session-continuity.ts");
 if (isMain && process.argv.length > 2) {
-  const memoriaDir = process.cwd() + "/.memoria";
+  const memoriaDir = `${process.cwd()}/.memoria`;
   buildContinueContext(memoriaDir).then((context) => {
     console.log(JSON.stringify({ success: true, context }));
   }).catch((error) => {

package/dist/lib/utils.js

@@ -9,6 +9,20 @@ function safeReadJson(filePath, fallback) {
     return fallback;
   }
 }
+function safeReadJsonWithSchema(filePath, schema, fallback) {
+  try {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const data = JSON.parse(content);
+    const result = schema.safeParse(data);
+    if (result.success) {
+      return result.data;
+    }
+    console.warn(`Validation failed for ${filePath}: ${result.error.message}`);
+    return fallback;
+  } catch {
+    return fallback;
+  }
+}
 function safeWriteJson(filePath, data) {
   const dir = path.dirname(filePath);
   if (!fs.existsSync(dir)) {
@@ -43,5 +57,6 @@ export {
   findJsonFiles,
   nowISO,
   safeReadJson,
+  safeReadJsonWithSchema,
   safeWriteJson
 };