@mcptoolshop/claude-synergy 1.0.0 → 1.1.0

package/README.hi.md

@@ -4,14 +4,15 @@
 
 <p align="center"><img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-synergy/readme.png" alt="Claude Synergy" width="400"></p>
 
-यह एंथ्रोपिक (Anthropic) और उससे संबंधित सभी एआई विकास उपकरणों के परिवर्तनों का एक स्थानीय, खोज योग्य दर्पण है - साथ ही एक क्यूरेटेड "**सिनर्जी**" (Synergy) परत जो विभिन्न उत्पादों के बीच कार्यप्रवाह का वर्णन करती है - ताकि 'हॉर्नेस्स' (harness) के अंदर मौजूद एलएलएम (LLM) एजेंट को पता चल सके कि 'हॉर्नेस्स' क्या कर सकता है।
-
 <p align="center">
-
-[![tests](https://github.com/mcp-tool-shop-org/claude-synergy/actions/workflows/test.yml/badge.svg)](https://github.com/mcp-tool-shop-org/claude-synergy/actions/workflows/test.yml) [![npm](https://img.shields.io/npm/v/@mcptoolshop/claude-synergy)](https://www.npmjs.com/package/@mcptoolshop/claude-synergy) [![license](https://img.shields.io/badge/license-MIT-blue)](#license) [![landing page](https://img.shields.io/badge/landing%20page-live-brightgreen)](https://mcp-tool-shop-org.github.io/claude-synergy/)
-
+  <a href="https://github.com/mcp-tool-shop-org/claude-synergy/actions/workflows/test.yml"><img src="https://github.com/mcp-tool-shop-org/claude-synergy/actions/workflows/test.yml/badge.svg" alt="tests"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/claude-synergy"><img src="https://img.shields.io/npm/v/@mcptoolshop/claude-synergy" alt="npm"></a>
+  <a href="#license"><img src="https://img.shields.io/badge/license-MIT-blue" alt="license"></a>
+  <a href="https://mcp-tool-shop-org.github.io/claude-synergy/"><img src="https://img.shields.io/badge/landing%20page-live-brightgreen" alt="landing page"></a>
 </p>
 
+यह एंथ्रोपिक (Anthropic) और उससे संबंधित सभी एआई विकास उपकरणों के परिवर्तनों का एक स्थानीय, खोज योग्य दर्पण है - साथ ही एक क्यूरेटेड "**सिनर्जी**" (Synergy) परत जो विभिन्न उत्पादों के बीच कार्यप्रवाह का वर्णन करती है - ताकि 'हॉर्नेस्स' (harness) के अंदर मौजूद एलएलएम (LLM) एजेंट को पता चल सके कि 'हॉर्नेस्स' क्या कर सकता है।
+
 ```bash
 $ hk query redact
 2026-05-11  anthropic-cli@1.7.1            [changed]  redact api-key headers in debug logs
@@ -22,6 +23,7 @@ $ hk query redact
 4 results
 ```
 
+
 एकल एफटीएस (FTS) क्वेरी एक समन्वित क्रॉस-एसडीके (SDK) सुरक्षा सुधार को उजागर करती है जिसे किसी भी व्यक्तिगत परिवर्तन लॉग में सीवीई (CVE) के रूप में चिह्नित नहीं किया गया था। यही मुख्य प्रदर्शन है: जब प्रत्येक परिवर्तन लॉग एक साथ होता है, तो पैटर्न उभरते हैं।
 
 रिपॉजिटरी: [github.com/mcp-tool-shop-org/claude-synergy](https://github.com/mcp-tool-shop-org/claude-synergy)
@@ -63,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)
@@ -71,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 सीएलआई कमांड।
 
 ---
 
@@ -82,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) और मुद्दों में ट्रैक किया गया है।
 
@@ -94,7 +97,7 @@ v0.8+ के लिए रोडमैप: [URGENT_FINDINGS.md](URGENT_FINDINGS.
 
 ## सुरक्षा और डेटा मॉडल
 
-यह टूल स्थानीय रूप से चलता है। **डेटा जो प्रभावित होता है:** एक व्युत्पन्न SQLite डेटाबेस और मार्कडाउन रिलीज़ फ़ाइलें - ये सभी फिर से बनाए जा सकते हैं। **नेटवर्क:** केवल आउटबाउंड HTTPS कनेक्शन, जब आप `hk fetch`/`hk sync` (GitHub API, RSS फ़ीड, परिवर्तन लॉग पेज, MCP रजिस्ट्री) या `hk embed` को किसी दूरस्थ प्रदाता (Voyage, Cohere) के साथ चलाते हैं। **गुप्त जानकारी:** यह `GITHUB_TOKEN`, `VOYAGE_API_KEY`, `COHERE_API_KEY`, `ANTHROPIC_API_KEY` को पर्यावरण चर से पढ़ता है - कभी भी लॉग नहीं किया जाता, कभी भी डिस्क पर संग्रहीत नहीं किया जाता। **कोई टेलीमेट्री नहीं।** रिपोर्टिंग नीति के लिए [SECURITY.md](SECURITY.md) देखें।
+यह टूल स्थानीय रूप से चलता है। **डेटा जो उपयोग में है:** एक व्युत्पन्न SQLite डेटाबेस और मार्कडाउन रिलीज़ फ़ाइलें - ये सभी दोबारा बनाए जा सकते हैं। **नेटवर्क:** केवल आउटबाउंड HTTPS कनेक्शन का उपयोग तब किया जाता है जब आप `hk fetch`/`hk sync` (GitHub API, RSS फ़ीड, बदलाव लॉग पेज, MCP रजिस्ट्री) या `hk embed` को किसी दूरस्थ प्रदाता (Voyage, Cohere) के साथ चलाते हैं। **सुरक्षा क्रेडेंशियल:** यह `GITHUB_TOKEN`, `VOYAGE_API_KEY`, `COHERE_API_KEY`, `ANTHROPIC_API_KEY` जैसे पर्यावरण चर से जानकारी पढ़ता है - यह कभी भी लॉग नहीं किया जाता है और कभी भी डिस्क पर संग्रहीत नहीं किया जाता है। **कोई भी डेटा संग्रह (टेलीमेट्री) नहीं है।** रिपोर्टिंग नीति के बारे में जानकारी के लिए [SECURITY.md](SECURITY.md) देखें।
 
 ---
 
@@ -124,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
@@ -134,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,
@@ -142,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`) में लेता है।
+
 ---
 
 ## उदाहरण कार्यप्रवाह
@@ -184,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 सर्वर: अपने एजेंटों को इस डेटासेट तक पहुंचने की अनुमति दें।
@@ -209,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/) देखें।
 
 ---
 
@@ -224,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` फ़ाइल में एक प्रविष्टि।
 
@@ -253,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)
@@ -263,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` |
@@ -306,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

@@ -4,14 +4,15 @@
 
 <p align="center"><img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/claude-synergy/readme.png" alt="Claude Synergy" width="400"></p>
 
-Un mirror locale e interrogabile di tutte le modifiche apportate a Anthropic e agli strumenti di sviluppo AI correlati, oltre a un livello curato di **"Synergy"** che descrive i flussi di lavoro tra i diversi prodotti, in modo che l'agente LLM all'interno del sistema sappia cosa può fare il sistema stesso.
-
 <p align="center">
-
-[![tests](https://github.com/mcp-tool-shop-org/claude-synergy/actions/workflows/test.yml/badge.svg)](https://github.com/mcp-tool-shop-org/claude-synergy/actions/workflows/test.yml) [![npm](https://img.shields.io/npm/v/@mcptoolshop/claude-synergy)](https://www.npmjs.com/package/@mcptoolshop/claude-synergy) [![license](https://img.shields.io/badge/license-MIT-blue)](#license) [![landing page](https://img.shields.io/badge/landing%20page-live-brightgreen)](https://mcp-tool-shop-org.github.io/claude-synergy/)
-
+  <a href="https://github.com/mcp-tool-shop-org/claude-synergy/actions/workflows/test.yml"><img src="https://github.com/mcp-tool-shop-org/claude-synergy/actions/workflows/test.yml/badge.svg" alt="tests"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/claude-synergy"><img src="https://img.shields.io/npm/v/@mcptoolshop/claude-synergy" alt="npm"></a>
+  <a href="#license"><img src="https://img.shields.io/badge/license-MIT-blue" alt="license"></a>
+  <a href="https://mcp-tool-shop-org.github.io/claude-synergy/"><img src="https://img.shields.io/badge/landing%20page-live-brightgreen" alt="landing page"></a>
 </p>
 
+Un mirror locale e interrogabile di tutte le modifiche apportate a Anthropic e agli strumenti di sviluppo AI correlati, oltre a un livello curato di **"Synergy"** che descrive i flussi di lavoro tra i diversi prodotti, in modo che l'agente LLM all'interno del sistema sappia cosa può fare il sistema stesso.
+
 ```bash
 $ hk query redact
 2026-05-11  anthropic-cli@1.7.1            [changed]  redact api-key headers in debug logs
@@ -22,6 +23,7 @@ $ hk query redact
 4 results
 ```
 
+
 **Una singola query FTS (Full-Text Search) rivela una correzione di sicurezza coordinata tra diversi SDK che non era stata segnalata come CVE (Common Vulnerabilities and Exposures) in nessuna delle singole liste di modifiche.** Questo è l'esempio più efficace: emergono dei modelli quando tutte le liste di modifiche sono confrontate fianco a fianco.
 
 Repository: [github.com/mcp-tool-shop-org/claude-synergy](https://github.com/mcp-tool-shop-org/claude-synergy)
@@ -63,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)
@@ -71,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.
 
 ---
 
@@ -82,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.
 
@@ -124,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
@@ -134,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,
@@ -142,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
@@ -184,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
@@ -209,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.
 
 ---
 
@@ -224,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`.
 
@@ -253,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)
@@ -263,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` |
@@ -306,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**