@mcptoolshop/claude-synergy 1.0.1 → 1.1.1

package/README.hi.md

@@ -65,7 +65,7 @@ claude-synergy/
 │   └── plugins-{official,community,knowledge-work}/  # Plugin marketplaces
 ├── synergies/               # 12 curated cross-product workflows
 ├── src/                     # TypeScript implementation
-├── test/                    # 382 tests (unit, integration, regression, smoke)
+├── test/                    # 508 tests (unit, integration, regression, smoke)
 ├── data/claude-synergy.db   # SQLite database (created by `hk init`)
 ├── schema.sql               # Tier 2a tables (products, releases, changes, entities, FTS5, …)
 ├── schema-vec.sql           # Tier 2b tables (chunks, chunks_vec, chunks_fts)
@@ -73,7 +73,7 @@ claude-synergy/
 └── URGENT_FINDINGS.md       # 23 actionable items surfaced from the corpus
 ```
 
-**वर्तमान आंकड़े (v1.0.0 के अनुसार):** 44 उत्पाद / 1,186 रिलीज़ फ़ाइलें / 6,042 बदलाव / 1,225 इकाइयां / 12 तालमेल / 382 परीक्षण।
+**वर्तमान आंकड़े (v1.1.0 के अनुसार):** 44 उत्पाद / 1,186 रिलीज़ फ़ाइलें / 6,042 परिवर्तन / 1,225 इकाइयां / 12 तालमेल / 508 परीक्षण / 11 एमसीपी उपकरण / 17 सीएलआई कमांड।
 
 ---
 
@@ -84,11 +84,12 @@ claude-synergy/
 | **1 — बूटस्ट्रैप (मार्कडाउन कॉर्पस)** | ✅ जारी किया गया | स्टडी-स्वार्म ने जनवरी से मई 2026 तक 706 रिलीज फ़ाइलें सीड (seed) कीं; इसे चौथे स्तर तक 1,186 तक बढ़ाया गया। |
 | **2a — SQLite + FTS5 + CLI** | ✅ जारी किया गया | `hk` सीएलआई (CLI); 15 सबकमांड; 300 मिलीसेकंड से कम में डेटा इनपुट। |
 | **2b — sqlite-vec + प्रासंगिक पुनर्प्राप्ति (Contextual Retrieval)** | ✅ जारी किया गया | प्रदाता-प्लग करने योग्य (कोई नहीं/संरचित/ओलामा/क्लाउड-हाइक्यू संदर्भ × ओलामा/वॉयज एम्बेड × कोई नहीं/ओलामा-जज/वॉयज/कोहेर रीरैंक)। |
-| **3 — सिंक + एमसीपी सर्वर** | ✅ जारी किया गया | `hk fetch / sync / seed-markers`; `claude-synergy-mcp` 8 टूल को stdio के माध्यम से उजागर करता है। |
+| **3 — सिंक + एमसीपी सर्वर** | ✅ जारी किया गया | `hk fetch / sync / seed-markers`; `claude-synergy-mcp` 11 उपकरण stdio के माध्यम से प्रदान करता है (8 मूल टियर-3 संस्करण में, 3 v1.1 में जोड़े गए)। |
 | **4a — एंथ्रोपिक से आगे बढ़ें** | ✅ जारी किया गया | +15 एमसीपी एसडीके (SDK), कर्सर (RSS), एडर (HISTORY.md), कंटिन्यू.देव, कोडी एंटरप्राइज (RSS फ़िल्टर)। |
 | **4b — एचटीएमएल-स्क्रैप फ़ेचर** | ✅ जारी किया गया | GitHub कोपायलट + वीएस कोड चैट (विंडसर्फ़ के लिए प्लेराइट की आवश्यकता है - v0.7)। |
 | **4c — टर्नडाउन एचटीएमएल→मार्कडाउन इनजेस्ट** | ✅ जारी किया गया | एचटीएमएल बॉडी (कोपायलट/वीएस कोड/कर्सर) अब एफटीएस5 (FTS5) + एंटिटी एक्सट्रैक्शन के लिए प्रति-बुलेट पंक्तियाँ उत्पन्न करते हैं। |
 | **4d — प्लेराइट + एमसीपी रजिस्ट्री + YAML कॉन्फ़िगरेशन** | ✅ जारी किया गया | प्लेराइट के माध्यम से विंडसर्फ़; स्मिथरी + आधिकारिक एमसीपी रजिस्ट्री को चौथे स्तर के कैटलॉग के रूप में उपयोग किया जाता है; उत्पादों को `products.yaml` में समेकित किया गया है। |
+| **5 — v1.1 विंडो ब्राउज़िंग + ओपनएआई एम्बेड** | ✅ जारी किया गया | `hk diff` / `hk breaking`, सभी ब्राउज़िंग कमांड के लिए तारीख सीमा, 3 नए एमसीपी उपकरण (कुल 11), ओपनएआई एम्बेडिंग प्रदाता, कॉन्फ़िगर करने योग्य एम्बेडिंग आयाम, `claude-code` ऑटो-सिंक, सामान्य `keep-a-changelog` पार्सर। |
 
 v0.8+ के लिए रोडमैप: [URGENT_FINDINGS.md](URGENT_FINDINGS.md) और मुद्दों में ट्रैक किया गया है।
 
@@ -126,8 +127,12 @@ hk sync                              # combined fetch → ingest → embed (cron
 hk seed-markers                      # one-time setup after initial corpus
 
 # Search
-hk query "managed agents"            # FTS5 keyword search
-hk hybrid "credential exfiltration"  # FTS5 + vec hybrid via RRF (+ optional --rerank)
+hk query "managed agents"            # FTS5 keyword search (+ --until <date>)
+hk hybrid "credential exfiltration"  # FTS5 + vec hybrid via RRF (+ --rerank, --until)
+
+# Windowed change browsing
+hk diff [product] --since 7d         # what changed in a window, grouped by product+version
+hk breaking --since 30d              # filter-browse of breaking changes (no search term)
 
 # Entity lookups
 hk env-var CLAUDE_CODE_WORKFLOWS     # when introduced + history
@@ -136,7 +141,7 @@ hk model claude-opus-4-7             # model launch + mentions across products
 hk cve CVE-2025-66414                # CVE references in corpus
 
 # Browsing
-hk latest [--product X] [--limit N]  # recent releases
+hk latest [--product X] [--limit N]  # recent releases (+ --since <date>)
 hk products                          # list all 44 with counts
 hk top env_var                       # most-mentioned by entity type
                                      # (env_var, slash_command, cli_option,
@@ -144,6 +149,8 @@ hk top env_var                       # most-mentioned by entity type
                                      #  hook_event, setting_key)
 ```
 
+**v1.1 में नया:** `hk diff` और `hk breaking` बिना किसी खोज शब्द की आवश्यकता के "हाल ही में क्या बदला?" का उत्तर देते हैं। तारीख सीमा समान हैं: प्रत्येक ब्राउज़िंग कमांड `--since` और `--until` को `YYYY-MM-DD` (या पूर्ण आईएसओ 8601), या एक सापेक्ष रूप (`7d`, `2w`, `3m`, `1y`) में लेता है।
+
 ---
 
 ## उदाहरण कार्यप्रवाह
@@ -186,6 +193,30 @@ $ hk hybrid "credential exfiltration" --limit 3
 
 यह क्वेरी कभी भी "env_scrub" शब्द का उल्लेख नहीं करती है - यह वेक्टर सतहों को अर्थ संबंधी समानता के आधार पर खोजता है। शुद्ध FTS5 (फुल-टेक्स्ट सर्च 5) इसे पूरी तरह से छोड़ देता है।
 
+**इस सप्ताह claude-code में क्या बदला:**
+```
+$ hk diff claude-code --since 7d
+claude-code@2.1.147  2026-05-21  (3 changes)
+  [added]     Added the `Workflow` tool for deterministic multi-agent orchestration.
+  [changed]   Slash commands now lazy-load until first invocation.
+  [fixed]     Race condition in MCP server discovery on Windows.
+
+claude-code@2.1.146  2026-05-19  (1 change)
+  [fixed]     Restored `--debug` flag accidentally removed in 2.1.144.
+```
+
+**पूरे डेटासेट में परिवर्तनों को ब्राउज़ करें:**
+```
+$ hk breaking --since 30d --limit 5
+2026-05-15  claude-agent-sdk-python@0.2.82       Headless and SDK sessions now use Task tools by default.
+2026-05-14  claude-agent-sdk-typescript@0.3.142  Headless and SDK sessions now use Task tools by default.
+2026-05-08  anthropic-sdk-go@1.42.0              Removed deprecated `client.Beta()` namespace.
+2026-04-29  cursor@0.49.0                        MCP server config moved from `cursor.json` to `.cursor/mcp.json`.
+2026-04-22  windsurf@1.10.0                      Removed `cascade.run` JSON-RPC method.
+```
+
+किसी खोज शब्द की आवश्यकता नहीं — `hk breaking` "क्या हाल ही में कुछ महत्वपूर्ण बदला?" का उत्तर है।
+
 ---
 
 ## MCP सर्वर: अपने एजेंटों को इस डेटासेट तक पहुंचने की अनुमति दें।
@@ -211,14 +242,19 @@ GitHub Copilot के लिए `.vscode/mcp.json` फ़ाइल में, `m
 
 | उपकरण। | उद्देश्य। |
 |---|---|
-| `search` | हाइब्रिड एफटीएस5 + वेक्टर; वैकल्पिक रूप से पुनः रैंकिंग (रीरैंक)। प्राकृतिक भाषा में पूछे गए प्रश्नों के लिए डिफ़ॉल्ट मोड। |
+| `search` | हाइब्रिड FTS5 + vec; वैकल्पिक रीरैंक। प्राकृतिक भाषा प्रश्नों के लिए डिफ़ॉल्ट मोड। (+ `until` तारीख ऊपरी सीमा) |
 | `lookup_entity` | सटीक इकाई इतिहास: पर्यावरण चर, स्लैश कमांड, मॉडल आईडी, सीवीई (सुरक्षा कमजोरियों), आदि। |
-| `latest_releases` | हाल ही में विभिन्न उत्पादों (या एक उत्पाद) के लिए जारी किए गए नए संस्करण। |
+| `latest_releases` | उत्पादों (या एक) में हाल के रिलीज़। (+ `since` तारीख निचली सीमा) |
 | `get_release` | एक विज्ञप्ति की पूरी सामग्री। |
 | `list_products` | गणना के साथ सूची बनाना + नवीनतम संस्करण। |
 | `top_entities` | प्रकार के अनुसार सबसे अधिक उल्लेखित इकाइयाँ। |
-| `list_synergies` | विभिन्न उत्पादों को मिलाकर तैयार किए गए कार्यप्रवाह। |
+| `list_synergies` | कस्टम क्रॉस-उत्पाद वर्कफ़्लो। (+ वैकल्पिक `उत्पाद` फ़िल्टर) |
 | `read_synergy` | एक सिनर्जी फ़ाइल का पूरा पाठ। |
+| `get_changes_since` | **नया।** एक समय विंडो में परिवर्तन, उत्पाद+संस्करण द्वारा समूहीकृत। इनपुट: `since` (आवश्यक), `until?`, `product?`, `kind?`, `limit?`. |
+| `search_breaking_changes` | **नया।** महत्वपूर्ण परिवर्तनों की एक सपाट सूची — किसी खोज शब्द की आवश्यकता नहीं। इनपुट: `product?`, `since?`, `until?`, `limit?`. |
+| `compare_versions` | **नया।** एक उत्पाद के दो संस्करणों के बीच सभी परिवर्तन। इनपुट: `product`, `from_version`, `to_version`. |
+
+ये तीन नए उपकरण `hk diff` / `hk breaking` और संस्करण-तुलना वर्कफ़्लो को प्रतिबिंबित करते हैं, जिसके लिए पहले स्क्रिप्टिंग की आवश्यकता होती थी। पूर्ण इनपुट स्कीमा के लिए [हैंडबुक → एमसीपी सर्वर](https://mcp-tool-shop-org.github.io/claude-synergy/handbook/mcp-server/) देखें।
 
 ---
 
@@ -226,11 +262,11 @@ GitHub Copilot के लिए `.vscode/mcp.json` फ़ाइल में, `m
 
 [SOURCES.md] फ़ाइल में विस्तृत जानकारी उपलब्ध है।
 
-- **स्तर 1 (GitHub रिलीज़)** — `gh api repos/<मालिक>/<रिपॉजिटरी>/releases`। यह 22 उत्पादों के लिए है, जिनमें एंथ्रोपिक एसडीके (7 भाषाएं), एजेंट एसडीके (2), एंट सीएलआई, क्लाउड-कोड-एक्शन, क्लाउड-कोड-सुरक्षा-समीक्षा, और 15 एमसीपी इकोसिस्टम एसडीके शामिल हैं।
-- **स्तर 2 (रॉ मार्कडाउन)** — `anthropics/claude-code/CHANGELOG.md` + `Aider-AI/aider/HISTORY.md`
-- **स्तर 3 (एचटीएमएल / आरएसएस)** — `platform.claude.com/docs/release-notes`, `support.claude.com/articles/12138966`, `cursor.com/changelog/rss.xml`, `sourcegraph.com/changelog/featured.rss` (फ़िल्टर किया गया), `github.blog/changelog/label/copilot/`, `code.visualstudio.com/updates/v1_NNN`
-- **स्तर 4 (सूची)** — `anthropics/skills`, `claude-plugins-{आधिकारिक,समुदाय}`, `knowledge-work-plugins`
-- **स्तर 5 (सलाह)** — `@ClaudeCodeLog` ट्विटर अकाउंट; marckrenn का चेंजलॉग दर्पण।
+- **टियर 1 (GitHub रिलीज़)** — `gh api repos/<owner>/<repo>/releases` 23 उत्पादों के लिए, जिसमें एंथ्रोपिक एसडीके (7 भाषाएं), एजेंट एसडीके (2), एंट सीएलआई, **claude-code** (अब v1.1 से gh-releases के माध्यम से ऑटो-सिंक — पहले मैन्युअल रूप से सीड किया गया था), claude-code-action, claude-code-security-review, और 15 एमसीपी इकोसिस्टम एसडीके शामिल हैं।
+- **टियर 2 (कच्चा मार्कडाउन)** — `Aider-AI/aider/HISTORY.md`. सामान्य `keep-a-changelog` पार्सर (v1.1+) किसी भी उत्पाद के लिए उपलब्ध है जिसका स्रोत `CHANGELOG.md` एक `Keep-a-Changelog` प्रारूप में है — `products.yaml` में एक प्रविष्टि के माध्यम से कॉन्फ़िगर करें।
+- **टियर 3 (HTML / RSS)** — `platform.claude.com/docs/release-notes`, `support.claude.com/articles/12138966`, `cursor.com/changelog/rss.xml`, `sourcegraph.com/changelog/featured.rss` (फ़िल्टर किया गया), `github.blog/changelog/label/copilot/`, `code.visualstudio.com/updates/v1_NNN`
+- **टियर 4 (कैटलॉग)** — `anthropics/skills`, `claude-plugins-{official,community}`, `knowledge-work-plugins`
+- **टियर 5 (सलाह)** — `@ClaudeCodeLog` एक्स खाता; marckrenn चेंजलॉग मिरर
 
 डेटा प्राप्त करने की विधियाँ: `gh-releases | rss | raw-changelog | html-scrape | catalog | playwright`. नया उत्पाद = `products.yaml` फ़ाइल में एक प्रविष्टि।
 
@@ -255,7 +291,7 @@ GitHub Copilot के लिए `.vscode/mcp.json` फ़ाइल में, `m
 विटेस्ट (Vitest) में यूनिट, इंटीग्रेशन, रिग्रेशन और स्मोक परीक्षण शामिल हैं। v0.7.0 के अनुसार, "[test-spec-3.md](test-spec-3.md)" वर्तमान में आधिकारिक दस्तावेज है; [test-spec.md](test-spec.md) (v1) और [test-spec-2.md](test-spec-2.md) (v2) डिज़ाइन के ऐतिहासिक रिकॉर्ड के रूप में रिपॉजिटरी में मौजूद हैं।
 
 ```bash
-pnpm test               # unit + integration + regression (~16s, 382 tests)
+pnpm test               # unit + integration + regression (~18s, 508 tests)
 pnpm test:watch         # interactive
 pnpm test:coverage      # generate coverage/index.html (thresholds: 78/75/85/78)
 pnpm test:smoke         # opt-in full-corpus smoke (RUN_SMOKE=1)
@@ -265,9 +301,9 @@ pnpm test:smoke         # opt-in full-corpus smoke (RUN_SMOKE=1)
 
 | मुझे खेद है, लेकिन मैं इस अनुरोध को पूरा करने में असमर्थ हूं क्योंकि यह अपूर्ण है। कृपया पूरा वाक्य या पाठ प्रदान करें जिसका आप अनुवाद करवाना चाहते हैं। | यह क्या शामिल करता है। |
 |-----|----------------|
-| `test/unit/` | प्रत्येक मॉड्यूल के लिए: डेटा निकालना, डेटा का संग्रह करना, डेटा पर प्रश्न करना, डेटाबेस, एम्बेडिंग, हाइब्रिड सिस्टम, डेटा प्राप्त करना, साथ ही प्रत्येक प्रदाता के लिए, आरएसएस/परिवर्तन लॉग/एचटीएमएल डेटा प्राप्त करना, एमसीपी रजिस्ट्री डेटा प्राप्त करना, प्लेराइट डेटा प्राप्त करना, और उत्पादों की कॉन्फ़िगरेशन जानकारी प्राप्त करना। |
-| `test/integration/` | एंड-टू-एंड — पाइपलाइन, सिंक्रोनाइज़ेशन, एमसीपी सर्वर (स्टैंडर्ड इनपुट/आउटपुट JSON-RPC), कमांड-लाइन इंटरफेस। |
-| `test/regression/` | §8.1–§8.18 — प्रत्येक एक वास्तविक बग को ठीक करता है जो विकास के दौरान पाया गया था। |
+| `test/unit/` | प्रति-मॉड्यूल — निकालें, इनजेस्ट करें, क्वेरी करें (शामिल `until` / ब्राउज़ / since / तुलना), डेटाबेस (शामिल dim-config v3 माइग्रेशन), एम्बेड, हाइब्रिड, फेच + प्रत्येक प्रदाता (Ollama / Voyage / **OpenAI**) + फेच-rss/changelog (शामिल **keep-a-changelog** पार्सर)/html + फेच-mcp-registry + फेच-playwright + उत्पादों-कॉन्फ़िग + सि synergy इनजेस्ट/क्वेरी |
+| `test/integration/` | एंड-टू-एंड — पाइपलाइन, सिंक, एमसीपी सर्वर (stdio JSON-RPC, 11 उपकरण), सीएलआई (शामिल `hk diff`, `hk breaking`) |
+| `test/regression/` | §8.1–§8.19 — प्रत्येक एक वास्तविक बग से बचाता है जिसे विकास के दौरान ठीक किया गया था (§8.19: ghReleases शुरुआती-निकास पेजिंग विंडो में आइटम को संरक्षित करता है) |
 | `test/smoke/` | पूर्ण डेटासेट, वास्तविक `products/` (1,143 फ़ाइलें) के लिए। |
 | `test/fixtures/` | 3 नकली उत्पाद + मॉक एचटीटीपी प्रतिक्रियाएं (RSS / GH / Voyage / Cohere / Ollama / Anthropic / Smithery / आधिकारिक MCP रजिस्ट्री)। |
 | `test/helpers/` | `temp-db.ts`, `fetch-mock.ts`, `mcp-client.ts`, `seed-corpus.ts`, `golden-vectors.ts`, `playwright-mock.ts`, `yaml-fixtures.ts` |
@@ -308,8 +344,22 @@ CI: `.github/workflows/test.yml` पुश और PR पर `pnpm test:coverage`
 
 `hk embed` एक बाहरी एम्बेडिंग सेवा को कॉल करता है:
 
-- **Ollama (डिफ़ॉल्ट)** — सुनिश्चित करें कि Ollama चल रहा है (`ollama serve`) और एम्बेडिंग मॉडल डाउनलोड किया गया है (`ollama pull nomic-embed-text`)।
-- **Voyage** — अपने वातावरण में `VOYAGE_API_KEY` सेट करें। अपने API कुंजी की जांच [dash.voyageai.com](https://dash.voyageai.com) पर करें।
+- **ओलामा (डिफ़ॉल्ट, 768-डायमेंशन)** — सुनिश्चित करें कि ओलामा चल रहा है (`ollama serve`) और एम्बेडिंग मॉडल डाउनलोड किया गया है (`ollama pull nomic-embed-text`)।
+- **वॉयज (1024-डायमेंशन)** — अपने वातावरण में `VOYAGE_API_KEY` सेट करें। अपना एपीआई कुंजी [dash.voyageai.com](https://dash.voyageai.com) पर जांचें।
+- **ओपनएआई (डिफ़ॉल्ट 1536-डायमेंशन, कॉन्फ़िगर करने योग्य)** — `OPENAI_API_KEY` सेट करें। डिफ़ॉल्ट मॉडल `text-embedding-3-small` है; `OPENAI_EMBED_MODEL` के साथ इसे बदलें (उदाहरण के लिए, 3072-डायमेंशन के लिए `text-embedding-3-large`)। `hk hybrid --embed openai` या `hk embed --embed openai` के माध्यम से उपयोग करें।
+
+**प्रदाता बदलने पर एम्बेडिंग डायमेंशन में अंतर**
+
+प्रत्येक प्रदाता एक निश्चित डायमेंशन के वेक्टर उत्पन्न करता है (ओलामा 768, वॉयज 1024, ओपनएआई डिफ़ॉल्ट रूप से 1536 — ओपनएआई मॉडल के मूल आकार के भीतर कॉन्फ़िगर करने योग्य डायमेंशन का समर्थन करता है)। डेटाबेस `schema_meta.embedding_dim` में सक्रिय डायमेंशन को संग्रहीत करता है। अलग-अलग डायमेंशन वाले प्रदाताओं के बीच स्विच करने से वेक्टर टेबल चुपचाप दूषित होने के बजाय `EMBEDDING_DIM_MISMATCH` (`AppError`) त्रुटि उत्पन्न होती है, खासकर जब डेटा मौजूद हो। स्विच करने के लिए:
+
+```bash
+rm data/claude-synergy.db data/claude-synergy.db-wal data/claude-synergy.db-shm
+hk init
+hk ingest
+hk embed --embed openai     # new provider, new dim, fresh chunks_vec
+```
+
+ओपनएआई मैट्रियोश्का ट्रंकेशन (मॉडल के मूल डायमेंशन से छोटा डायमेंशन) के लिए, `OPENAI_EMBED_MODEL` सेट करें और `hk embed` के प्रदाता निर्माण के माध्यम से वांछित डायमेंशन पास करें — विवरण के लिए [हैंडबुक एम्बेडिंग अनुभाग](https://mcp-tool-shop-org.github.io/claude-synergy/handbook/cli-reference/#embedding-providers-and-dimensions) देखें।
 
 **स्कीमा संस्करण बेमेल / दूषित डेटाबेस**
 

package/README.it.md

@@ -65,7 +65,7 @@ claude-synergy/
 │   └── plugins-{official,community,knowledge-work}/  # Plugin marketplaces
 ├── synergies/               # 12 curated cross-product workflows
 ├── src/                     # TypeScript implementation
-├── test/                    # 382 tests (unit, integration, regression, smoke)
+├── test/                    # 508 tests (unit, integration, regression, smoke)
 ├── data/claude-synergy.db   # SQLite database (created by `hk init`)
 ├── schema.sql               # Tier 2a tables (products, releases, changes, entities, FTS5, …)
 ├── schema-vec.sql           # Tier 2b tables (chunks, chunks_vec, chunks_fts)
@@ -73,7 +73,7 @@ claude-synergy/
 └── URGENT_FINDINGS.md       # 23 actionable items surfaced from the corpus
 ```
 
-**Dati aggiornati (alla versione v1.0.0):** 44 prodotti / 1.186 file di rilascio / 6.042 modifiche / 1.225 entità / 12 sinergie / 382 test.
+**Dati aggiornati (alla versione v1.1.0):** 44 prodotti / 1.186 file di rilascio / 6.042 modifiche / 1.225 entità / 12 sinergie / 508 test / 11 strumenti MCP / 17 comandi CLI.
 
 ---
 
@@ -84,11 +84,12 @@ claude-synergy/
 | **1 — corpus in formato Markdown (bootstrap)** | ✅ implementato | Study-swarm ha inserito 706 file di rilascio da gennaio a maggio 2026; ampliato a 1.186 con il livello 4. |
 | **2a — SQLite + FTS5 + CLI** | ✅ implementato | CLI `hk`; 15 sottocomandi; ingestione inferiore a 300ms. |
 | **2b — sqlite-vec + Recupero contestuale** | ✅ implementato | Provider pluggable (nessuno/strutturato/ollama/claude-haiku contesto × ollama/voyage embed × nessuno/ollama-judge/voyage/cohere rerank). |
-| **3 — sincronizzazione + server MCP** | ✅ implementato | `hk fetch / sync / seed-markers`; `claude-synergy-mcp` espone 8 strumenti tramite stdio. |
+| **3 — sincronizzazione + server MCP** | ✅ implementato | `hk fetch / sync / seed-markers`; `claude-synergy-mcp` espone 11 strumenti tramite stdio (8 nella versione originale Tier-3, 3 aggiunti nella v1.1). |
 | **4a — estensione oltre Anthropic** | ✅ implementato | +15 SDK MCP, Cursor (RSS), Aider (HISTORY.md), Continue.dev, Cody Enterprise (RSS filtrato). |
 | **4b — fetcher per l'estrazione da HTML** | ✅ implementato | GitHub Copilot + VS Code Chat (Windsurf richiede Playwright — v0.7). |
 | **4c — ingestione da HTML a Markdown con turndown** | ✅ implementato | I corpi HTML (Copilot/VS Code/Cursor) ora generano righe separate per ogni elemento per FTS5 + estrazione di entità. |
 | **4d — Playwright + registro MCP + configurazione YAML** | ✅ implementato | Windsurf tramite Playwright; Smithery + registro ufficiale MCP come cataloghi del livello 4; prodotti consolidati in `products.yaml`. |
+| **5 — v1.1: navigazione con finestra + integrazione OpenAI** | ✅ implementato | `hk diff` / `hk breaking`, limiti di data per tutti i comandi di navigazione, 3 nuovi strumenti MCP (totale 11), provider di embedding OpenAI, dimensione di embedding configurabile, sincronizzazione automatica di `claude-code`, parser generico `keep-a-changelog`. |
 
 Roadmap per la versione 0.8+: disponibile in [URGENT_FINDINGS.md](URGENT_FINDINGS.md) e nella sezione issues.
 
@@ -126,8 +127,12 @@ hk sync                              # combined fetch → ingest → embed (cron
 hk seed-markers                      # one-time setup after initial corpus
 
 # Search
-hk query "managed agents"            # FTS5 keyword search
-hk hybrid "credential exfiltration"  # FTS5 + vec hybrid via RRF (+ optional --rerank)
+hk query "managed agents"            # FTS5 keyword search (+ --until <date>)
+hk hybrid "credential exfiltration"  # FTS5 + vec hybrid via RRF (+ --rerank, --until)
+
+# Windowed change browsing
+hk diff [product] --since 7d         # what changed in a window, grouped by product+version
+hk breaking --since 30d              # filter-browse of breaking changes (no search term)
 
 # Entity lookups
 hk env-var CLAUDE_CODE_WORKFLOWS     # when introduced + history
@@ -136,7 +141,7 @@ hk model claude-opus-4-7             # model launch + mentions across products
 hk cve CVE-2025-66414                # CVE references in corpus
 
 # Browsing
-hk latest [--product X] [--limit N]  # recent releases
+hk latest [--product X] [--limit N]  # recent releases (+ --since <date>)
 hk products                          # list all 44 with counts
 hk top env_var                       # most-mentioned by entity type
                                      # (env_var, slash_command, cli_option,
@@ -144,6 +149,8 @@ hk top env_var                       # most-mentioned by entity type
                                      #  hook_event, setting_key)
 ```
 
+**Novità nella v1.1:** `hk diff` e `hk breaking` rispondono alla domanda "cosa è cambiato di recente?" senza richiedere un termine di ricerca. I limiti di data sono uniformi: ogni comando di navigazione accetta `--since` e `--until` in formato `YYYY-MM-DD` (o ISO 8601 completo), oppure in formato relativo (`7d`, `2w`, `3m`, `1y`).
+
 ---
 
 ## Esempi di flussi di lavoro
@@ -186,6 +193,30 @@ $ hk hybrid "credential exfiltration" --limit 3
 
 La query non utilizza mai "env_scrub"; l'interfaccia utente lo presenta tramite somiglianza semantica. La ricerca FTS5 pura non lo trova affatto.
 
+**Cosa è cambiato in claude-code questa settimana:**
+```
+$ hk diff claude-code --since 7d
+claude-code@2.1.147  2026-05-21  (3 changes)
+  [added]     Added the `Workflow` tool for deterministic multi-agent orchestration.
+  [changed]   Slash commands now lazy-load until first invocation.
+  [fixed]     Race condition in MCP server discovery on Windows.
+
+claude-code@2.1.146  2026-05-19  (1 change)
+  [fixed]     Restored `--debug` flag accidentally removed in 2.1.144.
+```
+
+**Esplora le modifiche rilevanti in tutto il corpus:**
+```
+$ hk breaking --since 30d --limit 5
+2026-05-15  claude-agent-sdk-python@0.2.82       Headless and SDK sessions now use Task tools by default.
+2026-05-14  claude-agent-sdk-typescript@0.3.142  Headless and SDK sessions now use Task tools by default.
+2026-05-08  anthropic-sdk-go@1.42.0              Removed deprecated `client.Beta()` namespace.
+2026-04-29  cursor@0.49.0                        MCP server config moved from `cursor.json` to `.cursor/mcp.json`.
+2026-04-22  windsurf@1.10.0                      Removed `cascade.run` JSON-RPC method.
+```
+
+Non è necessario un termine di ricerca — `hk breaking` è la risposta alla domanda "è cambiata qualcosa di importante di recente?".
+
 ---
 
 ## Server MCP: fornisce ai tuoi agenti l'accesso a questo corpus
@@ -211,14 +242,19 @@ Strumenti esposti:
 
 | Strumento | Scopo |
 |---|---|
-| `search` | FTS5 + ricerca vettoriale ibrida; opzionale riordinamento. Modalità predefinita per le query in linguaggio naturale. |
+| `search` | FTS5 + vettoriale; opzionale reranking. Modalità predefinita per query in linguaggio naturale. (+ limite superiore di data `until`) |
 | `lookup_entity` | Cronologia esatta delle entità: variabili d'ambiente, comandi, ID dei modelli, CVE, ecc. |
-| `latest_releases` | Rilasci recenti in tutti i prodotti (o in uno). |
+| `latest_releases` | Rilasci recenti in tutti i prodotti (o in uno). (+ limite inferiore di data `since`) |
 | `get_release` | Contenuto completo di un rilascio. |
 | `list_products` | Elenco con conteggi + ultima versione. |
 | `top_entities` | Entità più menzionate per tipo. |
-| `list_synergies` | Flussi di lavoro curati tra prodotti. |
+| `list_synergies` | Flussi di lavoro trasversali tra prodotti. (+ filtro opzionale `product`) |
 | `read_synergy` | Testo completo di un file di sinergia. |
+| `get_changes_since` | **Nuovo.** Modifiche in un intervallo di tempo, raggruppate per prodotto+versione. Input: `since` (obbligatorio), `until?`, `product?`, `kind?`, `limit?`. |
+| `search_breaking_changes` | **Nuovo.** Elenco piatto delle modifiche rilevanti — non è necessario un termine di ricerca. Input: `product?`, `since?`, `until?`, `limit?`. |
+| `compare_versions` | **Nuovo.** Tutte le modifiche tra due versioni di un prodotto. Input: `product`, `from_version`, `to_version`. |
+
+I tre nuovi strumenti replicano `hk diff` / `hk breaking` e il flusso di lavoro di confronto delle versioni che in precedenza richiedeva script. Consultare [manuale → server MCP](https://mcp-tool-shop-org.github.io/claude-synergy/handbook/mcp-server/) per gli schemi di input completi.
 
 ---
 
@@ -226,11 +262,11 @@ Strumenti esposti:
 
 Panoramica completa in [SOURCES.md](SOURCES.md).
 
-- **Livello 1 (Rilasci di GitHub)** — `gh api repos/<owner>/<repo>/releases` per 22 prodotti, inclusi gli SDK di Anthropic (7 lingue), gli SDK per agenti (2), l'interfaccia a riga di comando ant, claude-code-action, claude-code-security-review e 15 SDK dell'ecosistema MCP.
-- **Livello 2 (Markdown grezzo)** — `anthropics/claude-code/CHANGELOG.md` + `Aider-AI/aider/HISTORY.md`.
+- **Livello 1 (GitHub Releases)** — `gh api repos/<owner>/<repo>/releases` per 23 prodotti, inclusi gli SDK di Anthropic (7 linguaggi), gli SDK per agenti (2), l'interfaccia a riga di comando ant, **claude-code** (ora sincronizzato automaticamente tramite gh-releases dalla versione v1.1 — precedentemente configurato manualmente), claude-code-action, claude-code-security-review e 15 SDK dell'ecosistema MCP.
+- **Livello 2 (markdown grezzo)** — `Aider-AI/aider/HISTORY.md`. Il parser generico `keep-a-changelog` (v1.1+) è disponibile anche per qualsiasi prodotto il cui sorgente è un file CHANGELOG.md in formato Keep-a-Changelog — configurabile tramite una voce in `products.yaml`.
 - **Livello 3 (HTML / RSS)** — `platform.claude.com/docs/release-notes`, `support.claude.com/articles/12138966`, `cursor.com/changelog/rss.xml`, `sourcegraph.com/changelog/featured.rss` (filtrato), `github.blog/changelog/label/copilot/`, `code.visualstudio.com/updates/v1_NNN`.
 - **Livello 4 (catalogo)** — `anthropics/skills`, `claude-plugins-{official,community}`, `knowledge-work-plugins`.
-- **Livello 5 (avvisi)** — Account X `@ClaudeCodeLog`; mirror del changelog di marckrenn.
+- **Livello 5 (consigli)** — Account X `@ClaudeCodeLog`; mirror del changelog di marckrenn.
 
 Strategie di acquisizione: `gh-releases | rss | raw-changelog | html-scrape | catalog | playwright`. Nuovo prodotto = una voce in `products.yaml`.
 
@@ -255,7 +291,7 @@ Indice completo in [synergies/INDEX.md](synergies/INDEX.md).
 La suite di test Vitest copre i livelli di unità, integrazione, regressione e test preliminari. **[test-spec-3.md](test-spec-3.md) è la documentazione di riferimento corrente** a partire dalla versione 0.7.0; [test-spec.md](test-spec.md) (versione 1) e [test-spec-2.md](test-spec-2.md) (versione 2) rimangono nel repository come documentazione storica della progettazione.
 
 ```bash
-pnpm test               # unit + integration + regression (~16s, 382 tests)
+pnpm test               # unit + integration + regression (~18s, 508 tests)
 pnpm test:watch         # interactive
 pnpm test:coverage      # generate coverage/index.html (thresholds: 78/75/85/78)
 pnpm test:smoke         # opt-in full-corpus smoke (RUN_SMOKE=1)
@@ -265,9 +301,9 @@ Layout:
 
 | Directory | Cosa copre |
 |-----|----------------|
-| `test/unit/` | per-modulo — estrazione, acquisizione, query, database, incorporamento, ibrido, recupero + ogni provider + recupero-rss/changelog/html + recupero-mcp-registry + recupero-playwright + configurazione-prodotti |
-| `test/integration/` | end-to-end — pipeline, sincronizzazione, server MCP (JSON-RPC tramite standard input/output), CLI |
-| `test/regression/` | §8.1–§8.18 — ciascuno protegge da un bug reale corretto durante lo sviluppo. |
+| `test/unit/` | per-modulo — estrazione, ingestione, query (incl. `until` / navigazione / since / confronto), database (incl. migrazione della configurazione della dimensione v3), embedding, ibrido, fetch + tutti i provider (Ollama / Voyage / **OpenAI**) + fetch-rss/changelog (incl. parser **keep-a-changelog**)/html + fetch-mcp-registry + fetch-playwright + configurazione dei prodotti + ingestione/query delle sinergie. |
+| `test/integration/` | end-to-end — pipeline, sincronizzazione, server MCP (JSON-RPC stdio, 11 strumenti), CLI (incl. `hk diff`, `hk breaking`). |
+| `test/regression/` | §8.1–§8.19 — ciascuno protegge da un bug reale corretto durante lo sviluppo (§8.19: la paginazione early-exit di ghReleases preserva gli elementi all'interno dell'intervallo). |
 | `test/smoke/` | Test completo con l'intero corpus rispetto alla directory `products/` (1.143 file). |
 | `test/fixtures/` | 3 prodotti fittizi + risposte HTTP simulate (RSS / GH / Voyage / Cohere / Ollama / Anthropic / Smithery / Registro MCP ufficiale). |
 | `test/helpers/` | `temp-db.ts`, `fetch-mock.ts`, `mcp-client.ts`, `seed-corpus.ts`, `golden-vectors.ts`, `playwright-mock.ts`, `yaml-fixtures.ts` |
@@ -308,8 +344,22 @@ La sincronizzazione è idempotente: è sicuro rieseguirla anche in caso di un er
 
 Il comando `hk embed` chiama un servizio esterno di embedding:
 
-- **Ollama (predefinito):** assicurati che Ollama sia in esecuzione (`ollama serve`) e che il modello di embedding sia stato scaricato (`ollama pull nomic-embed-text`).
-- **Voyage:** imposta la variabile d'ambiente `VOYAGE_API_KEY`. Controlla la tua chiave API su [dash.voyageai.com](https://dash.voyageai.com).
+- **Ollama (predefinito, 768 dimensioni)**: assicurarsi che Ollama sia in esecuzione (`ollama serve`) e che il modello di embedding sia stato scaricato (`ollama pull nomic-embed-text`).
+- **Voyage (1024 dimensioni)**: impostare la variabile d'ambiente `VOYAGE_API_KEY`. Verificare la propria chiave API su [dash.voyageai.com](https://dash.voyageai.com).
+- **OpenAI (1536 dimensioni predefinite, configurabili)**: impostare la variabile `OPENAI_API_KEY`. Il modello predefinito è `text-embedding-3-small`; è possibile sovrascriverlo utilizzando `OPENAI_EMBED_MODEL` (ad esempio, `text-embedding-3-large` per 3072 dimensioni). Utilizzare tramite `hk hybrid --embed openai` oppure `hk embed --embed openai`.
+
+**Incompatibilità delle dimensioni degli embedding durante il cambio di provider.**
+
+Ogni provider produce vettori di una dimensione fissa (Ollama 768, Voyage 1024, OpenAI 1536 per impostazione predefinita; OpenAI supporta dimensioni configurabili all'interno delle dimensioni native del modello). Il database memorizza la dimensione attiva in `schema_meta.embedding_dim`. Il cambio di provider tra dimensioni diverse, quando esistono già frammenti di dati, genera un errore `EMBEDDING_DIM_MISMATCH` (`AppError`) anziché corrompere silenziosamente la tabella dei vettori. Per cambiare provider:
+
+```bash
+rm data/claude-synergy.db data/claude-synergy.db-wal data/claude-synergy.db-shm
+hk init
+hk ingest
+hk embed --embed openai     # new provider, new dim, fresh chunks_vec
+```
+
+Per la troncatura di Matryoshka di OpenAI (dimensioni inferiori a quelle native), impostare `OPENAI_EMBED_MODEL` e specificare la dimensione desiderata durante la configurazione del provider in `hk embed` – consultare la [sezione relativa agli embedding nel manuale](https://mcp-tool-shop-org.github.io/claude-synergy/handbook/cli-reference/#embedding-providers-and-dimensions) per maggiori dettagli.
 
 **Incompatibilità di versione dello schema / database corrotto**
 

package/README.ja.md

@@ -65,7 +65,7 @@ claude-synergy/
 │   └── plugins-{official,community,knowledge-work}/  # Plugin marketplaces
 ├── synergies/               # 12 curated cross-product workflows
 ├── src/                     # TypeScript implementation
-├── test/                    # 382 tests (unit, integration, regression, smoke)
+├── test/                    # 508 tests (unit, integration, regression, smoke)
 ├── data/claude-synergy.db   # SQLite database (created by `hk init`)
 ├── schema.sql               # Tier 2a tables (products, releases, changes, entities, FTS5, …)
 ├── schema-vec.sql           # Tier 2b tables (chunks, chunks_vec, chunks_fts)
@@ -73,7 +73,7 @@ claude-synergy/
 └── URGENT_FINDINGS.md       # 23 actionable items surfaced from the corpus
 ```
 
-**現在の状況（v1.0.0時点）：** 44製品 / 1,186件のリリースファイル / 6,042件の変更 / 1,225件のエンティティ / 12件の連携 / 382件のテスト。
+**現在の数値 (v1.1.0 時点):** 44製品 / 1,186リリースファイル / 6,042変更点 / 1,225エンティティ / 12の連携 / 508テスト / 11のMCPツール / 17のCLIコマンド。
 
 ---
 
@@ -84,11 +84,12 @@ claude-synergy/
 | **1 — ブートストラップ（Markdownコーパス）** | ✅ リリース済み | Study-swarmが706のリリースファイルを2026年1月から5月までに収集し、Tier 4で1,186に拡張。 |
 | **2a — SQLite + FTS5 + CLI** | ✅ リリース済み | `hk` CLI; 15のサブコマンド; 300ms未満のインジェスト速度 |
 | **2b — sqlite-vec + コンテキスト検索** | ✅ リリース済み | プロバイダープラグ可能（なし/構造化/Ollama/Claude-Haiku コンテキスト × Ollama/Voyage埋め込み × なし/Ollama-Judge/Voyage/Cohere リランク） |
-| **3 — 同期 + MCPサーバー** | ✅ リリース済み | `hk fetch / sync / seed-markers`; `claude-synergy-mcp`が8つのツールをstdio経由で公開 |
+| **3 — 同期 + MCPサーバー** | ✅ リリース済み | `hk fetch / sync / seed-markers`; `claude-synergy-mcp`は、標準入出力経由で11のツールを提供します（v1.1で追加された3つを含む、元々のTier-3で提供されていた8つに加え）。 |
 | **4a — Anthropic社以外の拡張** | ✅ リリース済み | +15のMCP SDK、Cursor（RSS）、Aider（HISTORY.md）、Continue.dev、Cody Enterprise（RSSフィルタリング） |
 | **4b — HTMLスクレイピングフェッチャー** | ✅ リリース済み | GitHub Copilot + VS Code Chat（WindsurfはPlaywrightが必要 — v0.7） |
 | **4c — turndown HTML→Markdownインジェスト** | ✅ リリース済み | HTMLの本文（Copilot/VS Code/Cursor）が、FTS5とエンティティ抽出のための、行ごとのリストを生成 |
 | **4d — Playwright + MCPレジストリ + YAML設定** | ✅ リリース済み | WindsurfはPlaywright経由; Smitheryと公式MCPレジストリをTier-4カタログとして使用; 製品は`products.yaml`に統合 |
+| **5 — v1.1：ウィンドウ表示機能 + OpenAIの埋め込み機能** | ✅ リリース済み | `hk diff` / `hk breaking`：すべての閲覧コマンドで日付範囲を指定可能。3つの新しいMCPツール（合計11個）、OpenAIの埋め込み機能、設定可能な埋め込み次元、`claude-code`の自動同期、汎用的な`keep-a-changelog`パーサー。 |
 
 v0.8以降のロードマップ：[URGENT_FINDINGS.md](URGENT_FINDINGS.md)およびissueで追跡中。
 
@@ -126,8 +127,12 @@ hk sync                              # combined fetch → ingest → embed (cron
 hk seed-markers                      # one-time setup after initial corpus
 
 # Search
-hk query "managed agents"            # FTS5 keyword search
-hk hybrid "credential exfiltration"  # FTS5 + vec hybrid via RRF (+ optional --rerank)
+hk query "managed agents"            # FTS5 keyword search (+ --until <date>)
+hk hybrid "credential exfiltration"  # FTS5 + vec hybrid via RRF (+ --rerank, --until)
+
+# Windowed change browsing
+hk diff [product] --since 7d         # what changed in a window, grouped by product+version
+hk breaking --since 30d              # filter-browse of breaking changes (no search term)
 
 # Entity lookups
 hk env-var CLAUDE_CODE_WORKFLOWS     # when introduced + history
@@ -136,7 +141,7 @@ hk model claude-opus-4-7             # model launch + mentions across products
 hk cve CVE-2025-66414                # CVE references in corpus
 
 # Browsing
-hk latest [--product X] [--limit N]  # recent releases
+hk latest [--product X] [--limit N]  # recent releases (+ --since <date>)
 hk products                          # list all 44 with counts
 hk top env_var                       # most-mentioned by entity type
                                      # (env_var, slash_command, cli_option,
@@ -144,6 +149,8 @@ hk top env_var                       # most-mentioned by entity type
                                      #  hook_event, setting_key)
 ```
 
+**v1.1の新機能:** `hk diff`と`hk breaking`は、検索語句なしで「最近何が変わったか」を教えてくれます。日付範囲はすべて統一されており、すべての閲覧コマンドで`--since`と`--until`を`YYYY-MM-DD`形式（または完全なISO 8601形式）、または相対形式（`7d`、`2w`、`3m`、`1y`）で指定できます。
+
 ---
 
 ## 例：ワークフロー
@@ -186,6 +193,30 @@ $ hk hybrid "credential exfiltration" --limit 3
 
 この検索クエリは「env_scrub」という文字列を含みません。代わりに、意味的な類似性に基づいて表示されます。従来の完全一致検索では、該当する情報を見つけることができません。
 
+**今週のclaude-codeの変更点:**
+```
+$ hk diff claude-code --since 7d
+claude-code@2.1.147  2026-05-21  (3 changes)
+  [added]     Added the `Workflow` tool for deterministic multi-agent orchestration.
+  [changed]   Slash commands now lazy-load until first invocation.
+  [fixed]     Race condition in MCP server discovery on Windows.
+
+claude-code@2.1.146  2026-05-19  (1 change)
+  [fixed]     Restored `--debug` flag accidentally removed in 2.1.144.
+```
+
+**コーパス全体における変更点を閲覧:**
+```
+$ hk breaking --since 30d --limit 5
+2026-05-15  claude-agent-sdk-python@0.2.82       Headless and SDK sessions now use Task tools by default.
+2026-05-14  claude-agent-sdk-typescript@0.3.142  Headless and SDK sessions now use Task tools by default.
+2026-05-08  anthropic-sdk-go@1.42.0              Removed deprecated `client.Beta()` namespace.
+2026-04-29  cursor@0.49.0                        MCP server config moved from `cursor.json` to `.cursor/mcp.json`.
+2026-04-22  windsurf@1.10.0                      Removed `cascade.run` JSON-RPC method.
+```
+
+検索語句は不要 — `hk breaking`は「最近、重要な変更はありましたか？」という質問への答えです。
+
 ---
 
 ## MCPサーバー：エージェントがこのドキュメント群にアクセスできるようにします
@@ -211,14 +242,19 @@ GitHub Copilotの`.vscode/mcp.json`ファイルでは、`mcpServers`ではなく
 
 | ツール | 目的 |
 |---|---|
-| `search` | ハイブリッドFTS5 + ベクトル検索；オプションで再ランキング。自然言語クエリのデフォルトモード。 |
+| `search` | ハイブリッドFTS5 + ベクトル; オプションで再ランキング。自然言語クエリのデフォルトモード。（`until`の日付上限付き） |
 | `lookup_entity` | 環境変数、コマンド、モデルID、CVEなどのエンティティの履歴。 |
-| `latest_releases` | 製品（または特定の製品）の最新リリース情報。 |
+| `latest_releases` | 製品（または単一の製品）における最近のリリース。（`since`の日付下限付き） |
 | `get_release` | 特定のリリースに関する完全な内容。 |
 | `list_products` | カウント付きの列挙と最新バージョン。 |
 | `top_entities` | 種類ごとの最も言及されているエンティティ。 |
-| `list_synergies` | 製品を横断したワークフローのコレクション。 |
+| `list_synergies` | 複数の製品を横断したワークフロー。 （オプションで`product`フィルターを使用可能） |
 | `read_synergy` | 特定のシナジーファイルの内容全体。 |
+| `get_changes_since` | **新規。** 製品とバージョンごとにグループ化された、時間範囲内の変更点。入力：`since`（必須）、`until?`、`product?`、`kind?`、`limit?`。 |
+| `search_breaking_changes` | **新規。** 検索語句不要の、変更点のフラットリスト。入力：`product?`、`since?`、`until?`、`limit?`。 |
+| `compare_versions` | **新規。** 単一の製品の2つのバージョン間のすべての変更点。入力：`product`、`from_version`、`to_version`。 |
+
+これらの3つの新しいツールは、`hk diff` / `hk breaking`と、以前はスクリプトが必要だったバージョン比較のワークフローを反映しています。入力スキーマの詳細については、[マニュアル → MCPサーバー](https://mcp-tool-shop-org.github.io/claude-synergy/handbook/mcp-server/)を参照してください。
 
 ---
 
@@ -226,11 +262,11 @@ GitHub Copilotの`.vscode/mcp.json`ファイルでは、`mcpServers`ではなく
 
 データソースの詳細については、[SOURCES.md](SOURCES.md)を参照してください。
 
-- **レベル1 (GitHub Releases)**：`gh api repos/<owner>/<repo>/releases`。Anthropic SDK（7言語）、Agent SDK（2）、ant CLI、claude-code-action、claude-code-security-review、および15のMCPエコシステムSDKを含む、22の製品。
-- **レベル2 (raw markdown)**：`anthropics/claude-code/CHANGELOG.md` + `Aider-AI/aider/HISTORY.md`
-- **レベル3 (HTML / RSS)**：`platform.claude.com/docs/release-notes`、`support.claude.com/articles/12138966`、`cursor.com/changelog/rss.xml`、`sourcegraph.com/changelog/featured.rss`（フィルタリング済み）、`github.blog/changelog/label/copilot/`、`code.visualstudio.com/updates/v1_NNN`
-- **レベル4 (catalog)**：`anthropics/skills`、`claude-plugins-{official,community}`、`knowledge-work-plugins`
-- **レベル5 (advisory)**：`@ClaudeCodeLog`のXアカウント、marckrennの変更履歴ミラー
+- **Tier 1 (GitHub Releases):** `gh api repos/<owner>/<repo>/releases`。Anthropic SDK（7言語）、Agent SDK（2）、ant CLI、**claude-code**（v1.1以降はgh-releasesで自動同期 — 以前は手動で初期化）、claude-code-action、claude-code-security-review、および15のMCPエコシステムSDKを含む、23製品。
+- **Tier 2 (raw markdown):** `Aider-AI/aider/HISTORY.md`。汎用的な`keep-a-changelog`パーサー（v1.1以降）は、ソースコードがKeep-a-Changelog形式のCHANGELOG.mdファイルである製品にも利用可能です。`products.yaml`で設定します。
+- **Tier 3 (HTML / RSS):** `platform.claude.com/docs/release-notes`、`support.claude.com/articles/12138966`、`cursor.com/changelog/rss.xml`、`sourcegraph.com/changelog/featured.rss`（フィルタリング済み）、`github.blog/changelog/label/copilot/`、`code.visualstudio.com/updates/v1_NNN`
+- **Tier 4 (catalog):** `anthropics/skills`、`claude-plugins-{official,community}`、`knowledge-work-plugins`
+- **Tier 5 (advisory):** `@ClaudeCodeLog`のXアカウント; marckrennの変更ログミラー
 
 取得戦略：`gh-releases`、`rss`、`raw-changelog`、`html-scrape`、`catalog`、`playwright`。新しい製品ごとに、`products.yaml`に1つのエントリを追加します。
 
@@ -255,7 +291,7 @@ GitHub Copilotの`.vscode/mcp.json`ファイルでは、`mcpServers`ではなく
 Vitestスイートは、ユニットテスト、統合テスト、回帰テスト、および初期動作確認（smoke）の各レベルをカバーします。**[test-spec-3.md](test-spec-3.md)が現在の仕様**です（v0.7.0時点）。[test-spec.md](test-spec.md)（v1）および[test-spec-2.md](test-spec-2.md)（v2）は、設計の経緯を示すための履歴として、リポジトリに残っています。
 
 ```bash
-pnpm test               # unit + integration + regression (~16s, 382 tests)
+pnpm test               # unit + integration + regression (~18s, 508 tests)
 pnpm test:watch         # interactive
 pnpm test:coverage      # generate coverage/index.html (thresholds: 78/75/85/78)
 pnpm test:smoke         # opt-in full-corpus smoke (RUN_SMOKE=1)
@@ -265,9 +301,9 @@ pnpm test:smoke         # opt-in full-corpus smoke (RUN_SMOKE=1)
 
 | ディレクトリ | 内容 |
 |-----|----------------|
-| `test/unit/` | モジュールごと：抽出、取り込み、検索、データベース、埋め込み、ハイブリッド検索、取得（すべてのプロバイダー、fetch-rss/changelog/html、fetch-mcp-registry、fetch-playwright、製品構成） |
-| `test/integration/` | エンドツーエンド：パイプライン、同期、MCPサーバー（stdio JSON-RPC）、CLI |
-| `test/regression/` | §8.1–§8.18：それぞれが、開発中に修正された実際のバグに対する保護を提供します。 |
+| `test/unit/` | モジュールごと — 抽出、取り込み、クエリ（`until` / 閲覧 / `since` / 比較を含む）、データベース（次元設定v3移行を含む）、埋め込み、ハイブリッド、取り込み + すべてのプロバイダー（Ollama / Voyage / **OpenAI**）+ RSS/変更ログの取り込み（**keep-a-changelog**パーサーを含む）/HTML + MCPレジストリの取り込み + Playwrightの取り込み + 製品設定 + 連携の取り込み/クエリ |
+| `test/integration/` | エンドツーエンド — パイプライン、同期、MCPサーバー（標準入出力JSON-RPC、11のツール）、CLI（`hk diff`、`hk breaking`を含む） |
+| `test/regression/` | §8.1–§8.19 — それぞれが、開発中に修正された実際のバグに対する対策。（§8.19：ghReleasesの早期終了ページネーションは、指定範囲内のアイテムを保持します） |
 | `test/smoke/` | 実際の`products/`ディレクトリ（1,143個のファイル）に対するフルコーパスのテスト。 |
 | `test/fixtures/` | 3つのダミー製品と、モックHTTPレスポンス（RSS / GH / Voyage / Cohere / Ollama / Anthropic / Smithery / 公式MCPレジストリ）。 |
 | `test/helpers/` | `temp-db.ts`, `fetch-mock.ts`, `mcp-client.ts`, `seed-corpus.ts`, `golden-vectors.ts`, `playwright-mock.ts`, `yaml-fixtures.ts` |
@@ -308,8 +344,22 @@ CI：`.github/workflows/test.yml`は、`pnpm test:coverage`をpushおよびプ
 
 `hk embed`は、外部の埋め込みサービスを呼び出します。
 
-- **Ollama (デフォルト)**：Ollamaが実行中であることを確認してください（`ollama serve`）。また、埋め込みモデルがダウンロードされていることを確認してください（`ollama pull nomic-embed-text`）。
-- **Voyage**：環境変数に`VOYAGE_API_KEY`を設定してください。APIキーは[dash.voyageai.com](https://dash.voyageai.com)で確認できます。
+- **Ollama (デフォルト、768次元)**：Ollamaが実行されていることを確認します (`ollama serve`)。また、埋め込みモデルをダウンロードします (`ollama pull nomic-embed-text`)。
+- **Voyage (1024次元)**：環境変数 `VOYAGE_API_KEY` を設定します。APIキーは [dash.voyageai.com](https://dash.voyageai.com) で確認できます。
+- **OpenAI (デフォルト1536次元、設定可能)**：`OPENAI_API_KEY` を設定します。デフォルトのモデルは `text-embedding-3-small` です。`OPENAI_EMBED_MODEL` で別のモデルを指定できます（例：3072次元の `text-embedding-3-large`）。`hk hybrid --embed openai` または `hk embed --embed openai` コマンドで利用できます。
+
+**プロバイダーの切り替え時の埋め込み次元の不一致**
+
+各プロバイダーは、固定の次元を持つベクトルを生成します（Ollama: 768、Voyage: 1024、OpenAI: デフォルト1536。OpenAIは、モデルのネイティブサイズ内で設定可能な次元をサポートしています）。データベースは、アクティブな次元を `schema_meta.embedding_dim` に保存します。チャンクが存在する状態で、次元が異なるプロバイダーに切り替えると、ベクトルテーブルが静かに破損するのではなく、`EMBEDDING_DIM_MISMATCH` (`AppError`) エラーが発生します。切り替えるには、以下の手順に従ってください。
+
+```bash
+rm data/claude-synergy.db data/claude-synergy.db-wal data/claude-synergy.db-shm
+hk init
+hk ingest
+hk embed --embed openai     # new provider, new dim, fresh chunks_vec
+```
+
+OpenAIのMatryoshka切り詰め（ネイティブサイズよりも小さい次元を使用する場合）では、`OPENAI_EMBED_MODEL` を設定し、`hk embed` コマンドのプロバイダー設定を通じて、希望する次元を指定します。詳細は、[マニュアルの埋め込みに関するセクション](https://mcp-tool-shop-org.github.io/claude-synergy/handbook/cli-reference/#embedding-providers-and-dimensions) を参照してください。
 
 **スキーマのバージョン不一致/データベースの破損**