Sverklo, உள்ளூர் முறையில் இயங்கும் ஒரு குறியீடு தேடல் சேவையகம் (code-search server) ஆகும். இது ஒரு AI முகவர் முடிவின் அடிப்படையில் செயல்படுவதற்கு முன்பே, கோப்பு கண்டறிதல் (file discovery) முதல் குறியீடு வரைபடத் தர்க்கம் (symbol-graph reasoning) வரை ஒரு வினவலின் ஒவ்வொரு படிநிலையையும் ஆய்வாளர்கள் ஆய்வு செய்ய அனுமதிக்கிறது.

தற்போதுள்ள கோடிங் ஏஜெண்டுகள் ஏன் தடுமாறுகின்றன

பெரும்பாலான குறியீடு உருவாக்கும் கருவிகள் ஒரு களஞ்சியத்தை (repository) ஒரு பெரிய உரைத் தொகுப்பாகவே கருதுகின்றன. அவை சிறு துண்டுகளை (snippets) உட்பொதிக்கின்றன (embed), ஒரு ஒற்றுமைத் தேடலை (similarity search) நடத்துகின்றன, மற்றும் அதிக மதிப்பெண் பெற்ற பகுதியைத் திருப்பித் தருகின்றன. அந்தத் துண்டு காலாவதியானதாகவோ, வரம்பிற்கு அப்பாற்பட்டதாகவோ அல்லது வெறும் கோப்புப் பெயராகவோ இருந்தால், ஏஜெண்டால் அதன் மூலத்தைக் கண்டறிய முடியாது. இந்தத் தோல்வி ஒரு வார்த்தை விடுபட்டதனால் ஏற்படுவதல்ல; மாறாக, ஒரு தகவல் எங்கிருந்து வந்தது மற்றும் அது இன்னும் பொருந்துமா என்பதை மனிதர்களுக்குத் தெரிவிக்கும் ஒரு சூழல் அடுக்கு (context layer) விடுபட்டதே இதற்குக் காரணம்.

Sverklo-வின் நான்கு அடுக்கு சரிபார்ப்பு மாதிரி

Sverklo தன்னை ஒரு "பொறியியல் கருதுகோள்" (engineering hypothesis) சேவையகமாக நிலைநிறுத்திக் கொள்கிறது, இது பாரம்பரியத் தேடலுடன் கட்டமைப்பு பகுப்பாய்வையும் (structural analysis) இணைக்கிறது:

  • File Discovery – குறியீடு (index) .gitignore மற்றும் பிற தவிர்க்கப்பட்ட கோப்புகளைப் படிக்கிறது. ஒரு முடிவை நம்புவதற்கு முன், எந்தப் பாதைகள் (paths) உண்மையில் ஸ்கேன் செய்யப்பட்டன என்பதைப் பார்க்க நீங்கள் குறியீட்டை வினவலாம்.
  • Code Structure – குறியீடுகள் (Symbols) வரையறைகள், இறக்குமதிகள் (imports) மற்றும் அழைப்பு உறவுகளைப் (call relationships) பதிவு செய்யும் ஒரு வரைபடத்தில் (graph) உள்ளன. ஒரு தேடல் வெறும் கோப்புப் பாதையை மட்டும் வழங்காமல், குறியீடு பொருளைத் (symbol object) திருப்பித் தரும், இதன் மூலம் சரியான API பயன்படுத்தப்படுவதை நீங்கள் உறுதிப்படுத்தலாம்.
  • Context Delivery – நீங்கள் ஒரு டோக்கன் வரம்பை (token budget) நிர்ணயிக்கும் போது, பதிலளிக்கப் பங்களித்த சிறு துண்டுகளின் வரைபடத்தை Sverklo வழங்குகிறது. இந்த வரைபடத்தில் found_by என்ற புலத்தைக் கொண்டுள்ளது, இது அந்தப் பொருத்தம் BM25 முக்கியச்சொல் பொருத்தம் (keyword matching), ONNX மூலம் உருவாக்கப்பட்ட உட்பொதிவுகள் (embeddings) அல்லது PageRank மூலம் வரிசைப்படுத்தப்பட்ட குறியீடு வரைபடம் ஆகியவற்றில் எதிலிருந்து வந்தது என்பதைத் தெரிவிக்கும்.
  • Memory Ledger – சேவையகம் ஒவ்வொரு முடிவையும் பதிவு செய்கிறது. ஒரு கோப்பு மாறினால், அந்தப் பதிவேடு (ledger) தொடர்புடைய நினைவகப் பதிவை காலாவதியானது எனக் குறித்துக் காட்டும், இதன் மூலம் சேமிக்கப்பட்ட (cached) பதில் இன்னும் செல்லுபடியாகுமா என்பதை அறியலாம்.

மீட்டெடுப்பு அடுக்கு (retrieval stack) எவ்வாறு செயல்படுகிறது

Sverklo வெறும் உட்பொதிவுகளை (embeddings) மட்டுமே நம்பியிருக்கவில்லை. இது துல்லியமான சொல் பொருத்தங்களுக்காக ஒரு பாரம்பரிய BM25 முக்கியச்சொல் இயந்திரத்தை இயக்குகிறது, அந்த முடிவுகளைப் பொருண்மை ஒற்றுமைக்காக (semantic similarity) ONNX அடிப்படையிலான வெக்டர் உட்பொதிவுகளுடன் மேம்படுத்துகிறது, பின்னர் அதிக தாக்கமுள்ள வரையறைகளைக் கண்டறிய குறியீடு வரைபடம் (symbol graph) மூலம் PageRank அல்காரிதத்தைப் பயன்படுத்துகிறது. ஒவ்வொரு முடிவையும் உருவாக்கிய முறையை வெளிப்படுத்துவதன் மூலம், டெவலப்பர்கள் முரண்பாடுகளைக் கண்டறிய முடியும்—உதாரணமாக, ஒரு BM25 முடிவு உட்பொதிவு மாதிரியால் பொருத்தமற்றது எனக் கருதப்பட்டால், எந்தத் தகவலை நம்புவது என்பதை அவர்களால் தேர்ந்தெடுக்க முடியும்.

நடைமுறைப் பயன்பாடுகள்

  • அறிமுகமில்லாத குறியீட்டுத் தளங்களை ஆராய்தல் – ஒரு செயல்பாட்டின் (function) பெயரிலிருந்து, அதை அழைக்கும் அனைத்து இடங்களுக்கும் கைமுறையாகத் தேடாமல் (grepping) நேரடியாகச் செல்லலாம்.
  • சார்பு வரைபடங்களை (dependency graphs) வரைபடமாக்குதல் – பல தொகுப்புகளைக் (packages) கடந்து செல்லும் இறக்குமதிச் சங்கிலிகளைப் பார்க்கலாம்.
  • மறுசீரமைப்புத் தாக்கத்தைக் (refactor impact) கணித்தல் – ஒரு குறிப்பிட்ட கோப்பு மாறினால் எந்தக் குறியீடுகள் பாதிக்கப்படும் என்பதை அறியலாம்.
  • பொருண்மை சார்ந்த கேள்விகளுக்குப் பதிலளித்தல் – "இந்த உதவியாளர் (helper) என்ன செய்கிறார்?" என்று கேட்டால், ஆதாரத்துடன் கூடிய சுருக்கமான விளக்கத்தைப் பெறலாம்.

கவனிக்க வேண்டிய சிக்கல்கள்

  • Freshness – குறியீடு மீண்டும் உருவாக்கப்படும்போது (reindex), குறியீட்டின் நேர முத்திரை (timestamp) பழையதாகவே இருக்கலாம். சமீபத்திய இயக்கம் தற்போதையது என்று assumptions செய்யாமல், எப்போதும் index-status endpoint-ஐ வினவவும்.
  • Project registration – ஒரு திட்டத்தைப் பதிவு நீக்கம் செய்யும் போது, கோப்பு முறைமைப் பாதையை (absolute filesystem path) பயன்படுத்தாமல், Sverklo வழங்கிய உள் திட்டப் பெயரைப் பயன்படுத்தவும், இல்லையெனில் அந்தச் செயல் அமைதியாகத் தோல்வியடையும்.
  • Tool naming quirks – MCP ஹோஸ்ட்கள் சில நேரங்களில் திட்டப் பெயரை இருமுறை முன்னொட்டாகச் சேர்க்கின்றன, இதனால் sverklo_sverklo_impact போன்ற அடையாளங்காட்டிகள் உருவாகலாம். ஒரு கருவியைப் பயன்படுத்துவதற்கு முன் அதன் பெயரைச் சரிபார்க்கவும்.

அடுத்து என்ன முயற்சிக்கலாம்

  1. ஒரு தற்காலிகக் களஞ்சியத்தை (disposable repository) கிளான் செய்து, Sverklo-வை உள்ளூர் முறையில் இயக்கவும்.
  2. ஒரு எளிய குறியீடு தேடலை (symbol lookup) நடத்தி found_by புலத்தைப் பார்க்கவும்.
  3. ஒரு மூலக் கோப்பை (source file) மாற்றிவிட்டு, மீண்டும் தேடலை இயக்கவும்; நினைவகப் பதிவேடு (memory ledger) எவ்வாறு காலாவதியான பதிவைக் குறிக்கிறது என்பதைக் கவனிக்கவும்.
  4. காலாவதியான குறியீடுகளைத் தானாகவே கண்டறிய, உங்கள் பில்ட் ஸ்கிரிப்ட்டில் (build script) index-status சரிபார்ப்பைச் சேர்க்கவும்.

முக்கியக் கருத்து

Sverklo ஒரு குறியீடு தேடல் இயந்திரத்தை தணிக்கை செய்யக்கூடிய ஒரு ஆதாரச் சங்கிலியாக (auditable evidence chain) மாற்றுகிறது. கோப்புத் தொகுப்பு, குறியீட்டுத் துல்லியம், மீட்டெடுப்பு முறை மற்றும் நினைவகத்தின் புத்துணர்ச்சி ஆகியவற்றை டெவலப்பர்கள் சரிபார்க்க வைப்பதன் மூலம், ஒரு AI சார்ந்த பரிந்துரை பயன்பாட்டுக்கு வரும் முன் அது நம்பகமானதா என்பதை அவர்களே தீர்மானிக்க அனுமதிக்கிறது.