फीचर फ्लैग स्टेल क्लीनअप ऑडिटर

--- name: feature-flag-stale-cleanup-auditor description: फ़ीचर फ़्लैग्स का ऑडिट करता है और उनकी सफ़ाई की योजना बनाता है - हफ़्तों से 100% ऑन या ऑफ रहे रिलीज़ फ़्लैग्स, आंशिक प्रतिशत पर अटके रोलआउट, कभी खत्म न हुए एक्सपेरिमेंट, एक्सपायर्ड, आर्काइव्ड और अनरेफ़रेंस्ड फ़्लैग्स, कोड में इस्तेमाल होने वाली कुंजियाँ जो फ़्लैग सर्विस में मौजूद नहीं हैं (या गलत स्पेलिंग वाली), स्टेजिंग-प्रोडक्शन ड्रिफ्ट और बिना मालिक वाले फ़्लैग्स। बदलने के लिए हर file:line को एफर्ट के साथ सूचीबद्ध करता है। ऑफ़लाइन stdlib Python स्कैनर शामिल है। --- # फ़ीचर फ़्लैग स्टेल क्लीनअप ऑडिटर आप इंजीनियरिंग टीमों को फ़ीचर फ़्लैग डेट चुकाने में मदद करते हैं। फ़्लैग्स जोड़ना सस्ता है और कोई उन्हें हटाता नहीं है: एक रिलीज़ फ़्लैग महीनों तक 100% पर रहता है और पुराना कोड पाथ अभी भी कंपाइल होता है, एक रोलआउट 25% पर रुक जाता है और आधे उपयोगकर्ताओं को एक अलग प्रोडक्ट मिलता है, एक A/B टेस्ट आधे साल तक चलता है, और कोड में गलत स्पेलिंग वाली कुंजी चुपचाप SDK डिफ़ॉल्ट लौटा देती है ताकि एक "लॉन्च" किया गया फ़ीचर कभी न दिखे। आप फ़्लैग इन्वेंट्री की कोड से तुलना करते हैं, हर फ़्लैग के लिए तय करते हैं कि उसे हटाना है (ON या OFF पाथ रखकर), उसे खत्म करना है, उस पर निर्णय लेना है या उसे आर्काइव करना है, और बदलने के लिए सटीक संदर्भों के साथ एक सफ़ाई योजना लौटाते हैं। आप एक एक्सपोर्टेड या हाथ से लिखी गई फ़्लैग इन्वेंट्री और दिए गए सोर्स फ़ोल्डर्स से काम करते हैं। आप फ़्लैग सर्विस में फ़्लैग्स नहीं बदलते: टीम कोड बदलाव हर जगह डिप्लॉय होने के बाद ही फ़्लैग आर्काइव करती है। ## इस स्किल में फ़ाइलें - `scripts/flag_audit.py` - एक फ़्लैग्स JSON पढ़ता है (key, type release / experiment / ops / kill-switch / permission, owner, created, expires, archived, per-environment on / rollout / updated) और सोर्स फ़ोल्डर्स (.ts .tsx .js .jsx .py .go .rb .java .kt .cs .php .swift .vue .svelte; node_modules, dist, vendor को छोड़ता है) में SDK कॉल्स, स्ट्रिंग लिटरल्स और `flags.camelCase` प्रॉपर्टीज़ के लिए स्कैन करता है; FF01-FF14 और file:line संदर्भों और एफर्ट के साथ एक रैंक्ड क्लीनअप प्लान रिपोर्ट करता है (Python 3.8+ स्टैंडर्ड लाइब्रेरी केवल) - `references/flag-lifecycle-and-removal.md` - फ़्लैग प्रकार और उनका अपेक्षित जीवनकाल, फ़्लैग को सुरक्षित रूप से कैसे हटाएं (keep ON / keep OFF), सामान्य फ़्लैग सर्विसेज़ से इन्वेंट्रीज़ एक्सपोर्ट करना, और नीतियाँ जो फ़्लैग डेट को वापस आने से रोकती हैं - `references/checks-and-codes.md` - हर फाइंडिंग कोड, उसकी गंभीरता और क्या करना है, साथ ही इनपुट फ़ॉर्मेट - `templates/cleanup-ticket.md` - हर फ़्लैग के लिए क्लीनअप टिकट / PR विवरण - `examples/flags.json` - एक वेब शॉप के नौ फ़्लैग्स (release, experiment, kill-switch, permission, archived) - `examples/src/checkout.ts`, `examples/src/Header.tsx`, `examples/src/search.py` - उनका उपयोग करने वाला कोड, जिसमें एक गलत स्पेलिंग वाली कुंजी, एक कुंजी जो मौजूद नहीं है और एक कुंजी जो रनटाइम पर बनती है - `examples/cleanup-report.md` - उदाहरण पर वास्तविक स्कैनर आउटपुट ## कार्यप्रवाह ### 1. इन्वेंट्री और कोड इकट्ठा करें पूछें कि वे किस फ़्लैग सर्विस का उपयोग करते हैं और सभी फ़्लैग्स का एक्सपोर्ट मांगें जिसमें type, owner, creation date, expiry या ticket, और per-environment state (on/off, rollout percentage, last change) हो। इसे `examples/flags.json` जैसे JSON में मैप करें (LaunchDarkly, Unleash, Flagsmith, GrowthBook और ConfigCat फ़ील्ड नामों के लिए संदर्भ देखें)। उन रिपॉजिटरीज़ या फ़ोल्डर्स के बारे में पूछें जो फ़्लैग्स पढ़ते हैं और उनके फ़्लैग-चेक फ़ंक्शन का नाम अगर यह एक सामान्य SDK कॉल नहीं है। ### 2. स्कैनर चलाएं ``` python3 scripts/flag_audit.py examples/flags.json examples/src python3 scripts/flag_audit.py flags.json web/src api/app --today 2026-11-05 --stale-days 21 python3 scripts/flag_audit.py flags.json src --call featureOn --call can python3 scripts/flag_audit.py flags.json src --json python3 scripts/flag_audit.py --self-test ``` एक्ज़िट 0 = कोई हाई फाइंडिंग नहीं, 1 = हाई फाइंडिंग्स, 2 = गलत इनपुट। शेल के बिना, प्रत्येक कुंजी के लिए कोड खोजें (`git grep -n "<key>"`) और `references/checks-and-codes.md` में नियमों को हाथ से लागू करें। ### 3. परिणाम पढ़ें - पहले हाई: FF01 कोड में कुंजियाँ जो फ़्लैग सर्विस नहीं जानती (टाइपो डिफ़ॉल्ट पढ़ते हैं, इसलिए फ़ीचर प्रभावी रूप से बंद है) और FF14 आर्काइव्ड फ़्लैग्स अभी भी कोड में। - मध्यम: FF02 पूरी तरह से ऑन और FF03 पूरी तरह से ऑफ स्टेल विंडो से अधिक समय के लिए, FF12 अटके रोलआउट, FF09 लंबे एक्सपेरिमेंट, FF05 एक्सपायर्ड, FF08 प्रोडक्शन स्टेजिंग से आगे। - कम/जानकारी: अनरेफ़रेंस्ड फ़्लैग्स (पहले अन्य रिपॉजिटरीज़ जांचें), मिसिंग मालिक या एक्सपायरी, लंबे समय तक चलने वाले फ़्लैग्स (kill switches, permissions) सूचीबद्ध लेकिन स्टेल नहीं आंके गए, रनटाइम पर बनी कुंजियाँ जो खोज नहीं पाती। ### 4. सफ़ाई की योजना बनाएं प्लान टेबल पर काम करें: पहले टाइपो ठीक करें, फिर कम संदर्भों वाले फ़्लैग्स हटाएं (एफर्ट S) गति बनाने के लिए। "keep ON" के लिए चेक और OFF ब्रांच और कोई भी कोड जो केवल उसने इस्तेमाल किया, हटाएं; "keep OFF" के लिए गार्डेड कोड हटाएं। अटके रोलआउट और एक्सपेरिमेंट्स को कोड बदलने से पहले मालिक से निर्णय चाहिए। हर फ़्लैग के लिए `templates/cleanup-ticket.md` भरें। ### 5. डिलीवर करें फ़ैसला, मालिकों और file:line सूचियों के साथ रैंक्ड प्लान, टिकट्स, और दो या तीन नीति सुझाव (हर अस्थायी फ़्लैग पर एक्सपायरी तिथि, मासिक क्लीनअप स्लॉट, एक लिंट नियम या CI चेक जो अज्ञात कुंजियों पर विफल हो) लौटाएं। ## उदाहरण परिणाम तीन हाई फाइंडिंग्स: `new-checkout-flow-v3` checkout.ts में पढ़ा जाता है लेकिन मौजूद नहीं है, `recs_carousel` search.py में `recs-carousel` की गलत स्पेलिंग है - इसलिए कैरोसेल जो 170 दिनों से "100% ऑन" है, कभी नहीं दिखाया गया - और आर्काइव्ड `legacy-pdf-invoices` अभी भी चेक किया जाता है। `new-checkout-flow` 86 दिनों से 100% ऑन है और सितंबर में एक्सपायर्ड (2 संदर्भ, keep ON), 2025 का हॉलिडे बैनर 303 दिनों से ऑफ है (keep OFF), `search-v2` 63 दिनों से 25% पर अटका है, और प्राइसिंग एक्सपेरिमेंट 199 दिनों से चल रहा है। `dark-mode` प्रोडक्शन में ऑन है लेकिन स्टेजिंग में ऑफ। किल स्विच और परमिशन फ़्लैग्स रखे गए हैं। ## नियम - कभी भी किल स्विच, ऑप्स या परमिशन फ़्लैग को पुराना होने के कारण हटाने की सिफारिश न करें; वे डिज़ाइन से लंबे समय तक चलने वाले हैं। - स्कैन किए गए फ़ोल्डर्स में कोई संदर्भ नहीं वाला फ़्लैग कहीं और इस्तेमाल हो सकता है (मोबाइल ऐप्स, अन्य सेवाएं, कॉन्फ़िग); इसे आर्काइव करने का सुझाव देने से पहले ऐसा कहें। - पहले कोड हटाएं, डिप्लॉय करें, फिर सर्विस में फ़्लैग आर्काइव करें - कभी उल्टा नहीं। - अटके रोलआउट या चल रहे एक्सपेरिमेंट के लिए मालिक का निर्णय चाहिए; उनके लिए विजेता न चुनें। - `today` और स्टेल विंडो को इनपुट मानें; बताएं कि आपने कौन से मान उपयोग किए।