क्लॉड कोड के लिए सुरक्षित निर्भरताएँ

जब क्लॉड जैसे AI कोडिंग सहायक आपके प्रोजेक्ट में पैकेज जोड़ते हैं, तो वे अक्सर जो भी संस्करण सही लगता है उसे चुन लेते हैं — बिना यह जाँचे कि उसमें ज्ञात सुरक्षा कमज़ोरियाँ हैं या नहीं, पैकेज अभी भी सक्रिय रूप से बनाए रखा जा रहा है या नहीं, या नाम किसी दुर्भावनापूर्ण नकली से टाइपो की दूरी पर है या नहीं।

safer-dependencies क्लॉड कोड के लिए एक सुरक्षा परत है: यह क्लॉड और आपकी मैनिफ़ेस्ट फ़ाइलों के बीच बैठता है और अपनी सुरक्षा जाँच स्वचालित रूप से चलाता है: कमज़ोर इंस्टॉल चलने से पहले ही अस्वीकार कर दिए जाते हैं, और मैनिफ़ेस्ट में लिखा गया जोखिम भरा संस्करण लिखने के तुरंत बाद डिस्क पर सुधार दिया जाता है। यह जोखिम भरी निर्भरताओं का पता लगाता है और उन्हें ठीक करता है — CVEs, टाइपोस्क्वैट्स, परित्यक्त पैकेज, और संस्करण-आयु संबंधी समस्याएँ, साथ ही ब्रांड-नए रिलीज़ के लिए एक कूलडाउन अवधि — npm, PyPI, RubyGems, Maven, Go, Rust, और PHP (Composer) में। वास्तव में क्या कवर किया गया है और क्या नहीं, इसके लिए CAPABILITIES.md देखें।

नए हैं? GETTING-STARTED.md आपको लगभग पाँच मिनट में शून्य से कार्यशील इंस्टॉल तक ले जाता है।

सुरक्षा और गोपनीयता: SECURITY.md (कमज़ोरी प्रकटीकरण), PRIVACY.md (डेटा बहिर्गमन, कोई टेलीमेट्री नहीं), और CAPABILITIES.md (उपकरण किससे बचाव करता है और किससे नहीं) देखें।

लाइसेंस (स्रोत-उपलब्ध — OSI "ओपन सोर्स" नहीं): अपने स्वयं के उद्देश्यों के लिए उपयोग और संशोधन करने के लिए निःशुल्क, लाभ-उद्देश्य/कंपनी आंतरिक उपयोग और आपके द्वारा बेचे जाने वाले उत्पाद बनाने सहित। एक अलग सशुल्क लाइसेंस केवल सॉफ़्टवेयर का मुद्रीकरण करने के लिए आवश्यक है — इसे बेचना, इसे किसी बेचे जाने वाले उत्पाद या सेवा के अंदर भेजना, या इसकी कार्यक्षमता को तीसरे पक्षों को शुल्क पर प्रदान करना (होस्टेड/SaaS/API सहित)। पुनर्वितरण और व्युत्पन्न कार्यों को लाइसेंस बनाए रखना चाहिए और इस प्रोजेक्ट को श्रेय देना चाहिए। देखें (वाणिज्यिक प्रतिबंध के लिए धारा 4); वाणिज्यिक-लाइसेंस अनुरोध के माध्यम से।

फ़ाइल

भूमिका

skills/safer-dependencies.md

स्किल (इंस्टॉल होने पर SKILL.md)। ऑडिट प्रक्रियाओं का वर्णन करता है और इंस्टॉलेशन/आँकड़ों के लिए प्रबंधन मोड शामिल करता है।

skills/safer-dependencies-shim.sh

PostToolUse:Write/Edit हुक — मैनिफ़ेस्ट + लॉकफ़ाइल लेखन का ऑडिट करता है और कमज़ोर संस्करणों को स्थान पर स्वतः सुधारता है (इंटरसेप्ट मोड)।

skills/safer-dependencies-pretooluse-bash.sh

PreToolUse:Bash हुक — पैकेज-मैनेजर इंस्टॉल कमांड का प्री-फ़्लाइट OSV ऑडिट; इंस्टॉल चलने से पहले कमज़ोर कंक्रीट पिन को अस्वीकार करता है (प्री-इंस्टॉल मोड)।

skills/safer-dependencies-posttooluse-bash.sh

PostToolUse:Bash हुक — बैश कमांड के बाद पोस्ट-फ़्लाइट ऑडिट; नई लिखी गई लॉकफ़ाइलों, sed/jq/स्क्रिप्ट के माध्यम से संपादित मैनिफ़ेस्ट, और सादे pip install के हल किए गए वातावरण में ट्रांज़िटिव CVEs को पकड़ता है (पोस्ट-इंस्टॉल मोड)।

skills/safer-dependencies-pretooluse-agent.sh + skills/safer-dependencies-posttooluse-agent.sh

PreToolUse:Agent + PostToolUse:Agent हुक जोड़ी — सबएजेंट कवरेज अंतर को बंद करती है। मोड 2–4 केवल रूट-सत्र टूल कॉल के लिए सक्रिय होते हैं, इसलिए सबएजेंट द्वारा लिखा गया कोई भी मैनिफ़ेस्ट उन्हें बायपास करता है। पोस्ट-एजेंट प्रत्येक Agent टूल-कॉल के लौटने के बाद सबएजेंट द्वारा लिखी गई किसी भी चीज़ का ऑडिट करता है (पोस्ट-एजेंट मोड)।

skills/scripts/

साझा Python लाइब्रेरी (safedep/) और स्टैंडअलोन रिज़ॉल्वर स्क्रिप्ट जो सभी हुक द्वारा उपयोग की जाती हैं।

skills/scripts/safer_dependencies_manager.py

इंटरैक्टिव इंस्टॉलेशन, उपयोग आँकड़े, और सेटअप सत्यापन के लिए प्रबंधन मॉड्यूल।

इंस्टॉलर स्कोप (ग्लोबल बनाम प्रोजेक्ट) और कौन से हुक सक्षम करने हैं, इसके बारे में पूछता है, फिर आपके लिए `settings.json` लिखता है — दोनों हुक एंट्री **और** अनुमतियाँ अनुमति-सूची, जो स्किल के चेक कमांड को हर ऑडिट पर अनुमोदन प्रॉम्प्ट के बिना चलाने देती है। इंस्टॉल से जुड़ी बाकी सब कुछ **[INSTALLATION.md](https://github.com/robert-auger/safer-dependencies/blob/main/INSTALLATION.md)** में रहती है, जो इंस्टॉल तंत्र का एकमात्र संदर्भ है: मैन्युअल फ़ाइल-दर-फ़ाइल इंस्टॉल (ग्लोबल और प्रोजेक्ट-स्तर), Windows विशेषताएँ, Post-Agent हुक, [अनुमतियाँ अनुमति-सूची](https://github.com/robert-auger/safer-dependencies/blob/main/INSTALLATION.md#permissions-allowlist), सेटअप सत्यापन, अपडेट, रिलीज़ टैग पर पिन करना, और अनइंस्टॉल करना। इंस्टॉल के बाद, दिन-प्रतिदिन का प्रबंधन Claude को प्राकृतिक भाषा में किया जाता है — `install safer-dependencies` (फिर से चलाएँ / हुक बदलें), `show safer-dependencies stats`, `check safer-dependencies setup` — या `/safer-dependencies` मेनू के माध्यम से। अपडेट भी सत्र के भीतर होता है: `/safer-dependencies update` नवीनतम रिलीज़ लागू करता है (`update --check` ड्राई-रन के लिए, `update --rollback` पूर्ववत करने के लिए); विश्वास मॉडल के लिए [INSTALLATION.md](https://github.com/robert-auger/safer-dependencies/blob/main/INSTALLATION.md#in-session-self-updater-safer-dependencies-update) देखें। > **प्लेटफ़ॉर्म नोट:** macOS, Linux, और Windows समर्थित हैं। Windows को Git for Windows (जो bash प्रदान करता है) और `PATH` पर Python 3 की आवश्यकता होती है — WSL की कोई आवश्यकता नहीं। अब तक के व्यावहारिक परीक्षण **macOS और Windows** पर केंद्रित रहे हैं; Linux समर्थन स्वचालित CI मैट्रिक्स द्वारा परखा जाता है। ### कॉन्फ़िगरेशन इंस्टॉल के बाद दो चीज़ें कॉन्फ़िगर करने योग्य हैं: - **अनुमतियाँ अनुमति-सूची** — स्किल के केवल-पढ़ने वाले चेक कमांड (सटीक-रूप `npm audit` / `bundle audit` नियम और स्किल के अपने रिज़ॉल्वर स्क्रिप्ट) को पहले से अनुमोदित करती है, ताकि ऑडिट हर बार अनुमोदन प्रॉम्प्ट के बिना चलें; `curl` कभी पहले से अनुमोदित नहीं होता, और `npm view` / `pip-audit` Convenience प्रोफ़ाइल के माध्यम से ऑप्ट-इन होते हैं। इंटरैक्टिव इंस्टॉलर आपके लिए मुख्य एंट्री लिखता है; मैन्युअल इंस्टॉल पूरा ब्लॉक हाथ से जोड़ते हैं। पूरा ब्लॉक और तर्क: [INSTALLATION.md → अनुमतियाँ अनुमति-सूची](https://github.com/robert-auger/safer-dependencies/blob/main/INSTALLATION.md#permissions-allowlist)। - **सुरक्षा नीति** — रिलीज़-आयु कूलडाउन विंडो/मोड और हर चेक प्रकार के लिए एक प्रति-चेक `off`/`warn`/`block` स्तर, जिसे `/safer-dependencies config` से संपादित किया जाता है और `~/.config/safer-dependencies/config.toml` में संग्रहीत किया जाता है। स्कीमा और स्तर शब्दार्थ: [`skills/references/configuration.md`](https://github.com/robert-auger/safer-dependencies/blob/main/skills/references/configuration.md)। ### कूलडाउन अवधि बदलना कूलडाउन (जिसे कॉन्फ़िग में **cooloff** कहा जाता है) वह न्यूनतम आयु है जो एक रिलीज़ को स्किल द्वारा चुने जाने से पहले प्राप्त करनी चाहिए — डिफ़ॉल्ट **7 दिन**। इसे बदलने के लिए, Claude से पूछें या कॉन्फ़िग कमांड सीधे चलाएँ:``` /safer-dependencies config set cooloff.days 14 # require releases to be 14+ days old /safer-dependencies config set cooloff.mode block # gate strength: off | warn | block (default: warn) /safer-dependencies config unset cooloff.days # revert to the 7-day default /safer-dependencies config # show effective values and where each comes from

यह सेटिंग `~/.config/safer-dependencies/config.toml` (अनुभाग `[cooloff]`) में बनी रहती है; `SAFE_DEP_COOLOFF_DAYS` और `SAFE_DEP_COOLOFF_MODE` पर्यावरण चर प्रति-सत्र फ़ाइल को ओवरराइड करते हैं। तीन व्यवहार जानने योग्य हैं: `mode = "off"` संस्करण चयन से आयु फ़िल्टर को पूरी तरह हटा देता है; CVE-संचालित पुनर्लेखन गेट को बायपास करता है, इसलिए सुरक्षा सुधार को कभी भी बहुत नया होने के कारण रोका नहीं जाता; और गेट npm, PyPI, RubyGems, और crates.io को कवर करता है — Maven और Go को जानबूझकर गेट नहीं किया गया है। पूर्ण शब्दार्थ: [`skills/references/configuration.md`](https://github.com/robert-auger/safer-dependencies/blob/main/skills/references/configuration.md)। ## चेतावनी स्तर | स्तर | अर्थ | उदाहरण | |-------|---------|---------| | CRITICAL | रोकें और उपयोगकर्ता से पूछें | टाइपोस्क्वाट का पता चला, छेड़छाड़ किया गया हस्ताक्षर | | HIGH | चेतावनी दें और आगे बढ़ें | ज्ञात CVE, पैकेज 30 दिन से कम पुराना | | MEDIUM | चेतावनी दें और आगे बढ़ें | संस्करण 7 दिन से कम पुराना, हस्ताक्षर गायब | | LOW | चेतावनी दें और आगे बढ़ें | अहस्ताक्षरित Ruby gem (अपेक्षित) | ## यह कैसे काम करता है यह स्किल पाँच मोड में संचालित होती है (नीचे सारांशित; सबसे गहरा डिज़ाइन तर्क `skills/safer-dependencies.md` में है): ### सामान्य मोड (मैनुअल) जब Claude एक `import` लिखने, मैनिफ़ेस्ट में पैकेज जोड़ने, या लॉक फ़ाइल अपडेट करने वाला होता है, तो स्किल आपके सत्र में इनलाइन चलती है: 1. स्थिर संस्करणों के लिए पैकेज रजिस्ट्री से पूछताछ करती है 2. 7+ दिन पहले प्रकाशित नवीनतम संस्करण को स्वतः चुनती है (निर्धारक — कोई LLM निर्णय नहीं) 3. इकोसिस्टम टूल्स और OSV API के माध्यम से ज्ञात कमजोरियों की जाँच करती है 4. जहाँ उपलब्ध हो, पैकेज हस्ताक्षर सत्यापित करती है 5. समस्याएँ मिलने पर चेतावनियाँ जारी करती है, सटीक संस्करण पिन करती है 6. परिणाम को ऑडिट ट्रेल में लॉग करती है संस्करण चयन स्किल के साथ बंडल किए गए स्टैंडअलोन Python स्क्रिप्ट द्वारा संभाला जाता है, न कि नियमों की व्याख्या करने वाले LLM द्वारा। कमांड `SELECTED: <version>` आउटपुट करता है और Claude उस संस्करण का सटीक उपयोग करता है। ### इंटरसेप्ट मोड (स्वचालित) स्वचालित, पारदर्शी पैकेज सत्यापन सक्षम करने के लिए `.claude/settings.json` को `PostToolUse` हुक के साथ कॉन्फ़िगर करें: 1. Claude मूल रूप से अनुरोधित संस्करण के साथ एक मैनिफ़ेस्ट फ़ाइल (जैसे `package.json`) लिखता है — फ़ाइल डिस्क पर आ जाती है 2. `PostToolUse` हुक लेखन पूर्ण होते ही तुरंत सक्रिय होता है और `safer-dependencies-shim.sh` को आमंत्रित करता है 3. शिम फ़ाइल पढ़ता है, घोषित पैकेजों को पार्स करता है, और सभी सुरक्षा जाँचें (टाइपोस्क्वाट, परित्यक्त, CVE, स्टेलनेस, हैश-पिन) चलाता है 4. यदि सुधार आवश्यक हैं, तो शिम सुरक्षित संस्करणों के साथ **मैनिफ़ेस्ट को स्थान पर पुनर्लेखित करता है** (या उन प्रविष्टियों को हटा देता है जिनका कोई सुरक्षित संस्करण नहीं है) 5. शिम stdout पर `hookSpecificOutput.additionalContext` के माध्यम से सिग्नल (`UPDATED:`, `BLOCKED:`, `WARNING:`, `STALE:`, `MAJOR-UPDATE-CONFIRM:`, `REFACTOR-REQUIRED:`, `REGRESSION:`, `TYPOSQUAT-CONFIRM:`, `VERIFY:`, `CLEAN:`) उत्सर्जित करता है। `REGRESSION:` एक `MAJOR-UPDATE-CONFIRM:` से पहले आता है जब ऑडिट लॉग दिखाता है कि समान (फ़ाइल, पैकेज) को पहले उसी सुरक्षित लक्ष्य पर सुधारा गया था — अर्थात, एक सबएजेंट या पुरानी योजना ने ज्ञात-कमजोर संस्करण को पुनः प्रस्तुत किया है, और ऑर्केस्ट्रेटर को प्रमुख बंप को फिर से तय करने के बजाय पहले-अनुमोदित संस्करण को पुनर्स्थापित करना चाहिए। 6. Claude उन सिग्नलों को सिस्टम-रिमाइंडर के रूप में प्राप्त करता है और अनुवर्ती कार्य करता है (प्रभावित imports खोजें, परीक्षण चलाएँ, ब्रेकिंग परिवर्तनों के लिए रीफैक्टर करें) **डिज़ाइन नोट — Shape C (पोस्ट-राइट सुधारात्मक):** हुक लेखन को ब्लॉक नहीं करता। प्रत्येक कमजोर संस्करण पहले डिस्क पर आता है और फिर उसी टूल-उपयोग चक्र के भीतर स्वतः सुधारा जाता है। यह `PreToolUse` ब्लॉकिंग डिज़ाइन पर एक जानबूझकर चयन है — ट्रेडऑफ़ के लिए [FAQ.md](https://github.com/robert-auger/safer-dependencies/blob/main/FAQ.md#why-posttooluse-post-write-corrective-instead-of-pretooluse-pre-write-blocking-for-the-manifest-path) देखें। **उदाहरण सिग्नल:**``` UPDATED: aiohttp 3.8.5 → 3.9.0 (HIGH: 33 CVEs fixed)

### पोस्ट-इंस्टॉल मोड (बैश हुक) Bash कमांड के बाद पोस्ट-फ्लाइट ऑडिटिंग सक्षम करने के लिए `.claude/settings.json` में `PostToolUse:Bash` हुक कॉन्फ़िगर करें। यह कमांड के `cwd` के विरुद्ध **तीन स्वतंत्र स्कैन** चलाता है, जिनमें से प्रत्येक उस अंतर को भरता है जिसे अन्य हुक संबोधित नहीं कर सकते: - **स्कैन A — लॉकफ़ाइलें।** एक सफल इंस्टॉल वर्ब (`npm install`, `bundle install`, `poetry install`, `uv sync`, `go mod tidy`, आदि) के बाद, हाल ही में संशोधित लॉकफ़ाइलों (`package-lock.json`, `Gemfile.lock`, `poetry.lock`, `uv.lock`, `go.sum`, `yarn.lock`, `pnpm-lock.yaml`, `Pipfile.lock`) का ऑडिट करता है। यह **ट्रांज़िटिव-CVE अंतर** को बंद करता है जिसे प्री-इंस्टॉल नहीं देख सकता: उपयोगकर्ता ने `pkg@version` टाइप किया, लेकिन रिज़ॉल्वर ने दर्जनों ट्रांज़िटिव पैकेज खींच लिए होंगे जिनका नाम किसी ने नहीं लिया। - **स्कैन B — मैनिफ़ेस्ट।** किसी भी Bash कमांड के बाद जो रीड-ओनली डेनीलिस्ट (`ls`, `cat`, `git status`, …) पर *नहीं* है, हाल ही में संशोधित मैनिफ़ेस्ट का ऑडिट करता है। यह `sed -i`, `jq`, या स्क्रिप्ट के माध्यम से किए गए मैनिफ़ेस्ट संपादनों के लिए **एकमात्र** फ़ॉलबैक है — वे `Write`/`Edit` टूल को बायपास करते हैं जिस पर इंटरसेप्ट मोड हुक करता है। - **स्कैन C — हल किया गया वातावरण।** सादा `pip install` / `pip install -r requirements.txt` कोई लॉकफ़ाइल नहीं लिखता, इसलिए स्कैन A हल किए गए ट्री को कभी नहीं देखता। pip-आकार के इंस्टॉल के बाद, स्कैन C उसी pip को रीड-ओनली `list --format=json` के साथ फिर से लागू करता है और पूरे हल किए गए वातावरण (डायरेक्ट + ट्रांज़िटिव) की OSV-जाँच करता है। स्कैन कैसे चलता है: 1. Claude एक Bash टूल कॉल चलाता है 2. `PostToolUse` हुक कमांड पूरा होने के *बाद* फायर होता है और `safer-dependencies-posttooluse-bash.sh` को लागू करता है 3. एक शुद्ध-बैश प्रारंभिक फ़िल्टर उन कमांडों को शॉर्ट-सर्किट करता है जो ~115 ms में किसी स्कैन गेट से मेल नहीं खाते (प्री-इंस्टॉल के समान फास्ट-पाथ कन्वेंशन), इसलिए `ls` / `git` / `cat` नगण्य लागत वहन करते हैं 4. प्रत्येक स्कैन `find -maxdepth 5` के साथ `cwd` को ट्रैवर्स करता है (मोनोरेपो लेआउट को कवर करता है; `node_modules`, `.git`, `.venv`, `venv` को बाहर करता है) पिछले 60 s के भीतर संशोधित फ़ाइलों के लिए — `SAFE_DEP_POSTINSTALL_MTIME_WINDOW` के माध्यम से ओवरराइड करें 5. प्रत्येक हाल ही में संशोधित फ़ाइल (स्कैन A/B) के लिए, हुक एक सिंथेटिक `PostToolUse:Write` पेलोड बनाता है और इसे मौजूदा शिम में पाइप करता है — शिम के लॉकफ़ाइल और मैनिफ़ेस्ट ऑडिटर अपरिवर्तित चलते हैं, कोई डुप्लिकेट लॉजिक नहीं 6. प्रति-फ़ाइल सिग्नल संयोजित होते हैं और पैरेंट एजेंट को एक `hookSpecificOutput` JSON के रूप में उत्सर्जित होते हैं **यह क्या पकड़ता है जो प्री-इंस्टॉल नहीं:** ट्रांज़िटिव कमजोरियाँ। एक साफ-सुथरा दिखने वाला `bundle install` `sinatra` के ट्रांज़िटिव के रूप में `[email protected]` (CVE-2025-27610) खींच सकता है — उपयोगकर्ता ने कभी `rack` नहीं टाइप किया, इसलिए प्री-इंस्टॉल इसे नहीं देख सकता, लेकिन पोस्ट-इंस्टॉल हल किए गए `Gemfile.lock` को पढ़ता है और CVE की रिपोर्ट करता है। **दायरा:** स्कैन A हल किए गए संस्करणों को फिर से नहीं लिखता — ऑटो-करेक्ट अनुबंध केवल उन मैनिफ़ेस्ट पर लागू होता है जिन्हें Claude ने सीधे लिखा था। ट्रांज़िटिव CVE के लिए, फिक्स आमतौर पर "उस डायरेक्ट डिप को अपडेट करें जो ट्रांज़िटिव का मालिक है" होता है, जिसके लिए मानवीय निर्णय की आवश्यकता होती है। स्कैन B *वास्तव में* ऑटो-करेक्ट करता है, क्योंकि यह इंटरसेप्ट मोड के समान शिम पथ के माध्यम से मैनिफ़ेस्ट का ऑडिट करता है। स्कैन A तब छोड़ दिया जाता है जब `transitive` चेक टियर `off` पर सेट होता है (`config set checks.transitive off`)। **विफलता मोड:** फेल-ओपन, अन्य हुक के समान। कोई भी त्रुटि (शिम गायब, विकृत पेलोड, Python अनुपलब्ध) चुपचाप 0 के साथ बाहर निकलती है। **उदाहरण WARNING:**``` WARNING: [email protected] in lock file has GHSA-29mw-wpgm-hmr9, GHSA-35jh-r3h4-6jhm

एक fail-open प्रविष्टि कहती है: "यह हुक फायर हुआ लेकिन बिना ऑडिट किए जल्दी बाहर निकल गया क्योंकि कोई पूर्वापेक्षा गायब थी।" अपने लॉग में हर मूक सुरक्षा-हानि घटना को सतह पर लाने के लिए उपरोक्त jq फ़िल्टर (`select(.source.mode == "fail_open")`) का उपयोग करें। जब शिम ड्राई-रन मोड में चलता है (`SAFE_DEP_DRY_RUN=1`), प्रविष्टियों में `"mode": "dry_run"` भी शामिल होता है ताकि पोस्ट-हॉक विश्लेषण केवल-ऑडिट इनवोकेशन को फ़िल्टर कर सके। ## आवश्यकताएँ - Python 3.9+ (हुक इसकी जाँच करते हैं और पुराने इंटरप्रेटरों पर fail-open होते हैं) - `curl` (रजिस्ट्री API कॉल और OSV भेद्यता जाँच के लिए) - इकोसिस्टम उपकरण (वैकल्पिक, गायब होने पर स्किल OSV API पर वापस आ जाती है): - npm पैकेजों के लिए `npm` - Python पैकेजों के लिए `pip-audit` - Ruby पैकेजों के लिए `bundle` - Java पैकेजों के लिए `dependency-check` ## FAQ डिज़ाइन-निर्णय तर्क (PreToolUse के बजाय PostToolUse क्यों, हस्ताक्षर सत्यापित क्यों नहीं किए जाते, स्क्रिप्ट और शिम डुप्लिकेट क्यों हैं, स्किल-लोडिंग गॉचा, आदि) [`FAQ.md`](https://github.com/robert-auger/safer-dependencies/blob/main/FAQ.md) में प्रलेखित है।

इकोसिस्टम	मैनिफ़ेस्ट	लॉक फ़ाइल
npm	`package.json`	`package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`
PyPI	`requirements.txt`, `pyproject.toml`, `Pipfile`, `setup.py`, `setup.cfg`	`Pipfile.lock`, `poetry.lock`, `uv.lock`
RubyGems	`Gemfile`, `*.gemspec`	`Gemfile.lock`
Maven	`pom.xml`, `build.gradle`, `libs.versions.toml`	--
Go	`go.mod`	`go.sum`
Rust	`Cargo.toml`	`Cargo.lock`
PHP (Composer)	`composer.json`	`composer.lock`

PM	Verbs	कंक्रीट-पिन सिंटैक्स
`npm`, `pnpm`, `yarn`, `bun`	`install`, `i`, `add` (साथ ही `yarn`/`pnpm dlx`, `bun x`, `yarn create`)	`[email protected]`, `@scope/[email protected]`
`npx`	(वर्बलेस — पैकेज पहला पोज़िशनल है)	`[email protected]`
`deno`	`add`, `install`	`npm:[email protected]` (npm-उपसर्गित स्पेक्स)
`pip`, `pip3`, `pipx`, `pipenv`, `uv`, `uvx`, `poetry`	`install` (pip/pip3/pipx/pipenv) / `add` (uv/poetry) / वर्बलेस (uvx)	`pkg==1.2.3` (एक्स्ट्रा `pkg[extra]==X` भी संभाले जाते हैं)
`gem`, `bundle`	`install` (gem) / `add`	`-v 1.2.3`, `--version 1.2.3`, `--version=1.2.3` (अलग फ़्लैग)
`go`	`get`, `install`	`[email protected]` (Go मॉड्यूल के अनुसार `v` उपसर्ग शामिल होना चाहिए)
`cargo`	`add`, `install`	`[email protected]`

`source.component`	किसके द्वारा लिखा गया	ट्रिगर
`shim.posttooluse`	`shim.sh`	मैनिफेस्ट या लॉकफ़ाइल लेखन (इंटरसेप्ट मोड, पोस्ट-इंस्टॉल डिस्पैच)
`shim.install_error`	`shim.sh`	शिम प्रीफ़्लाइट इंस्टॉल विफलता
`bash.pretooluse`	`pretooluse-bash.sh`	Bash इंस्टॉल कमांड (प्री-इंस्टॉल मोड)
`bash.posttooluse`	`posttooluse-bash.sh`	पोस्ट-इंस्टॉल Bash हुक स्वयं, जब यह शिम तक पहुँचने से पहले फेल-ओपन होता है
`agent.pretooluse`	`pretooluse-agent.sh`	प्री-एजेंट फेल-ओपन घटनाओं के लिए आरक्षित (हुक स्वयं सफलता पर वर्तमान में मौन है)
`agent.posttooluse`	`posttooluse-agent.sh`	पोस्ट-एजेंट हुक फेल-ओपन घटनाएँ (जैसे शिम लापता, python_missing)
`manual.skill`	सामान्य मोड में चल रहा Claude	इनलाइन मैन्युअल ऑडिट

आकृति	कब लिखी जाती है	विशिष्ट फ़ील्ड
ऑडिट प्रविष्टि	मैनिफ़ेस्ट / लॉकफ़ाइल / bash-इंस्टॉल ऑडिट	`file`, `ecosystem`, `checked`, `findings`, `abandoned`, `stale`, `typosquat`, `unknown`, `signatures`, `notes`, `clean`
इंस्टॉल-त्रुटि प्रविष्टि	शिम प्रीफ़्लाइट इंस्टॉल-त्रुटि (घटक `shim.install_error`)	`install_error`, `shim_dir`, `scripts_dir`
फेल-ओपन प्रविष्टि	कोई भी हुक एंट्री-पॉइंट `helper_missing` / `shim_missing` / `python_missing` के कारण जल्दी बाहर निकलता है। `source.mode` `"fail_open"` है	`fail_open: { reason, detail? }`

safer-dependencies

सबसे लोकप्रिय

सामग्री

आरंभ करना

यह क्या करता है

इसे क्या ट्रिगर करता है

इस रेपो में क्या है

समर्थित इकोसिस्टम

इंस्टॉल

प्री-इंस्टॉल मोड (Bash हुक)

पोस्ट-एजेंट मोड (एजेंट हुक जोड़ी)

ऑडिट लॉग

Surface every silent fail-open across all hooks: