OmniRoute/docs/i18n/gu/docs/compression/COMPRESSION_RULES_FORMAT.md

Compression Rules Format (ગુજરાતી)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

કમ્પ્રેશન નિયમો એવા JSON ફાઇલો છે જે runtime પર લોડ થાય છે. તેમને ઇરાદાપૂર્વક માત્ર ડેટા-આધારિત રાખવામાં આવ્યા છે, જેથી નવા language packs અને RTK command filters ની engine code બદલ્યા વિના સમીક્ષા કરી શકાય.

પ્રમાણભૂત schema (સત્યનો મૂળ સ્રોત): open-sse/services/compression/rules/_schema.json (JSON Schema draft 2020-12). નીચેના ઉદાહરણો માત્ર સમજ માટે છે — શંકા હોય ત્યારે તમારા pack ને _schema.json સામે validate કરો.

Caveman Rule Packs

Caveman rule packs અહીં સ્થિત હોય છે:

open-sse/services/compression/rules/<language>/<pack>.json

દરેક pack માં એવા replacements હોય છે, જે protected regions ને અલગ કર્યા પછી સામાન્ય ગદ્ય પર લાગુ થાય છે.

{
  "language": "en",
  "category": "filler",
  "rules": [
    {
      "name": "question_to_directive",
      "pattern": "\\b(?:Can you explain why|Could you show me how)\\b\\s*",
      "replacement": "Explain why ",
      "replacementMap": {
        "can you explain why": "Explain why ",
        "could you show me how": "Show how "
      },
      "flags": "gi",
      "context": "all",
      "category": "context",
      "minIntensity": "lite",
      "description": "વિસ્તૃત પ્રશ્નોને સીધી વિનંતીઓમાં રૂપાંતરિત કરો."
    }
  ]
}

Caveman Fields

ફીલ્ડ	આવશ્યક	વર્ણન
language	હા	BCP-47-સમાન language key, જેમ કે en, pt-BR, es
category	હા	Pack category filename/category, ઉદાહરણ તરીકે filler અથવા dedup
rules	હા	regex replacement rules ની array
rules[].name	હા	સ્થિર rule name
rules[].pattern	હા	JavaScript regex source
rules[].flags	ના	JavaScript regex flags; default gi
rules[].replacement	ના	replacementMap માં મેળ ન મળે ત્યારે replacement string અથવા fallback
rules[].replacementMap	ના	normalized matched text દ્વારા keyed કરાયેલા match-specific replacements
rules[].context	ના	all, user, assistant, અથવા system; default all
rules[].category	ના	filler, context, structural, dedup, terse, અથવા ultra
rules[].minIntensity	ના	lite, full, અથવા ultra; default lite
rules[].description	ના	માનવ-વાંચનીય rule summary

જ્યારે case-sensitive matching મહત્વનું હોય ત્યારે flags નો ઉપયોગ કરો, ઉદાહરણ તરીકે lowercase ગદ્ય પહેલાં article removal કરતી વખતે the OpenAI API ને દૂર કર્યા વિના. જ્યારે એક regex માં અનેક alternatives હોય અને તેમને અલગ outputs ની જરૂર હોય ત્યારે replacementMap નો ઉપયોગ કરો; આ વધુ સમૃદ્ધ built-in TypeScript replacement functions નું વર્તન જાળવી રાખીને JSON rule packs ને માત્ર ડેટા-આધારિત રાખે છે.

RTK ફિલ્ટર પૅક્સ

RTK ફિલ્ટર્સ અહીં સ્થિત છે:

open-sse/services/compression/engines/rtk/filters/<filter>.json

દરેક ફિલ્ટર કમાન્ડ-આઉટપુટના સમૂહને કેવી રીતે ઓળખવો અને સંકુચિત કરવો તે વર્ણવે છે.

{
  "id": "test-vitest",
  "label": "Vitest આઉટપુટ",
  "category": "test",
  "priority": 92,
  "match": {
    "outputTypes": ["test-vitest"],
    "commands": ["vitest", "npm test", "npm run test"],
    "patterns": ["\\bFAIL\\b", "\\bPASS\\b", "\\bTest Files\\b"]
  },
  "rules": {
    "stripAnsi": true,
    "replace": [{ "pattern": "\\s+\\[[0-9]+ms\\]", "replacement": "" }],
    "matchOutput": [
      {
        "pattern": "All tests passed",
        "message": "vitest: ok",
        "unless": "FAIL|Error:"
      }
    ],
    "includePatterns": ["FAIL", "Error:", "Test Files", "Tests"],
    "dropPatterns": ["^\\s*$", "Duration\\s+\\d+"],
    "collapsePatterns": ["^\\s+at "],
    "deduplicate": true,
    "truncateLineAt": 240,
    "maxLines": 160,
    "headLines": 24,
    "tailLines": 40,
    "onEmpty": "vitest: ok",
    "filterStderr": false
  },
  "preserve": {
    "errorPatterns": ["FAIL", "Error:", "AssertionError"],
    "summaryPatterns": ["Test Files", "Tests", "Snapshots"]
  },
  "tests": [
    {
      "name": "નિષ્ફળ થતી કસોટીઓને જાળવે છે",
      "command": "vitest",
      "input": "FAIL test/a.test.ts\\nError: boom\\nTest Files 1 failed",
      "expected": "FAIL test/a.test.ts\\nError: boom\\nTest Files 1 failed"
    }
  ]
}

RTK ફીલ્ડ્સ

ફીલ્ડ	આવશ્યક	વર્ણન
id	હા	સ્થિર ફિલ્ટર id
label	હા	ડૅશબોર્ડમાં વાંચી શકાય તેવું નામ
category	હા	ફિલ્ટર સમૂહ: git, test, build, shell, docker, package, infra, cloud, generic
priority	ના	અનેક ફિલ્ટર્સ મેળ ખાતાં હોય ત્યારે ઉચ્ચ પ્રાથમિકતાવાળું ફિલ્ટર પસંદ થાય છે
match.outputTypes	ના	આ ફિલ્ટર પસંદ કરતા ડિટેક્ટર આઉટપુટ ids
match.commands	ના	આ ફિલ્ટર પસંદ કરતા કમાન્ડ ટોકન્સ
match.patterns	ના	આઉટપુટ ટેક્સ્ટમાંથી આ ફિલ્ટર પસંદ કરતા regex પેટર્ન્સ
rules.stripAnsi	ના	regex તબક્કાઓ પહેલાં ANSI એસ્કેપ સિક્વન્સ દૂર કરે છે
rules.replace	ના	લાઇન પ્રમાણે લાગુ કરાતા ક્રમબદ્ધ regex અવેજીકરણો
rules.matchOutput	ના	વૈકલ્પિક unless ગાર્ડ સાથેના શૉર્ટ-સર્કિટ આઉટપુટ નિયમો
rules.includePatterns	ના	જાળવી રાખવા માટે પ્રાથમિકતા આપવાની લાઇનો
rules.dropPatterns	ના	અનાવશ્યક સામગ્રી તરીકે દૂર કરવાની લાઇનો
rules.collapsePatterns	ના	વારંવાર આવતી મેળ ખાતી લાઇનો, જેને સંક્ષિપ્ત કરી શકાય
rules.deduplicate	ના	ડુપ્લિકેટ નોર્મલાઇઝ્ડ લાઇનોને સંક્ષિપ્ત કરે છે
rules.truncateLineAt	ના	દરેક લાઇન માટે Unicode-સુરક્ષિત અક્ષર મર્યાદા
rules.maxLines	ના	અંતિમ લાઇનો જાળવતાં પહેલાં રાખવામાં આવતી મહત્તમ લાઇનો
rules.headLines	ના	ટ્રન્કેશન દરમિયાન જાળવવામાં આવતી શરૂઆતની લાઇનો
rules.tailLines	ના	તાજેતરના સંદર્ભ માટે જાળવવામાં આવતી અંતિમ લાઇનો
rules.onEmpty	ના	ફિલ્ટરિંગથી બધી સામગ્રી દૂર થાય ત્યારે વપરાતો ફૉલબૅક સંદેશ
rules.filterStderr	ના	પછીના ફિલ્ટરિંગ તબક્કાઓ પહેલાં સામાન્ય stderr પ્રીફિક્સને નોર્મલાઇઝ કરે છે
preserve.errorPatterns	ના	ટ્રન્કેશન પછી પણ જળવાઈ રહેવી જોઈએ તેવી ભૂલ લાઇનો
preserve.summaryPatterns	ના	ટ્રન્કેશન પછી પણ જળવાઈ રહેવી જોઈએ તેવી સારાંશ લાઇનો
tests[]	ના	RTK ચકાસણી ગેટ દ્વારા ઉપયોગમાં લેવાતા ઇનલાઇન ચકાસણી નમૂનાઓ

RTK આ ક્રમમાં ઘોષણાત્મક તબક્કાઓ લાગુ કરે છે: stripAnsi, filterStderr, replace, matchOutput, dropPatterns/includePatterns, truncateLineAt, headLines/tailLines, maxLines, અને onEmpty.

કસ્ટમ ફિલ્ટર્સ અહીંથી લોડ કરી શકાય છે:

1. પ્રોજેક્ટની .rtk/filters.json ફાઇલો માત્ર ત્યારે, જ્યારે મેળ ખાતો .rtk/trust.json હૅશ હાજર હોય અથવા trustProjectFilters સક્ષમ કરેલું હોય.
2. વૈશ્વિક DATA_DIR/rtk/filters.json.
3. બિલ્ટ-ઇન ફિલ્ટર્સ.

પ્રોજેક્ટ/વૈશ્વિક કસ્ટમ ફાઇલોમાં એક ફિલ્ટર ઑબ્જેક્ટ અથવા ફિલ્ટર ઑબ્જેક્ટ્સની ઍરે હોઈ શકે છે. અમાન્ય કસ્ટમ ફિલ્ટર્સને ડાયગ્નોસ્ટિક્સ સાથે અવગણવામાં આવે છે; અમાન્ય બિલ્ટ-ઇન ફિલ્ટર્સથી માન્યતા નિષ્ફળ જાય છે.

પ્રોજેક્ટ ટ્રસ્ટ ફાઇલ:

{
  "filtersSha256": "0123456789abcdef..."
}

એન્વાયર્નમેન્ટ ઓવરરાઇડ OMNIROUTE_RTK_TRUST_PROJECT_FILTERS=1 હૅશ વિના પ્રોજેક્ટ ફિલ્ટર્સ પર વિશ્વાસ કરે છે અને તેનો ઉપયોગ નિયંત્રિત સ્થાનિક ડેવલપમેન્ટ પૂરતો મર્યાદિત રાખવો જોઈએ.

સુરક્ષા નિયમો

• નિયમોને આઇડેમ્પોટન્ટ રાખો: સમાન ફિલ્ટરને બે વાર ચલાવવાથી આઉટપુટ બગડવું જોઈએ નહીં.
• શક્ય હોય ત્યાં ચોક્કસ એરર ટેક્સ્ટ, ફાઇલ પાથ, લાઇન નંબર અને કમાન્ડ સારાંશ જાળવો.
• કોડ બ્લૉક્સ, JSON પેલોડ્સ, URLs અથવા સિક્રેટ્સને બદલતા નિયમો ટાળો.
• ડિટેક્ટર/ફિલ્ટર ટેસ્ટ્સમાં નવી કમાન્ડ ફૅમિલીઝ માટે યુનિટ કવરેજ ઉમેરો.
• દરેક બિલ્ટ-ઇન ફિલ્ટર અને શેર્ડ કસ્ટમ ફિલ્ટર્સમાં tests[] સૅમ્પલ્સ ઉમેરો.

માન્યતા ચકાસણી

ઉપયોગ પહેલાં રૂલ પૅક્સની માન્યતા ચકાસવામાં આવે છે. બિલ્ટ-ઇન Caveman પૅક્સ અને બિલ્ટ-ઇન RTK ફિલ્ટર્સ માન્યતા ચકાસણી દરમિયાન તરત નિષ્ફળ જાય છે, જેથી ખામીયુક્ત રિલીઝ ઍસેટ્સ શિપમેન્ટ પહેલાં પકડાઈ જાય. પાર્સિંગ અથવા ટ્રસ્ટ માન્યતા ચકાસણી નિષ્ફળ જાય ત્યારે કસ્ટમ RTK ફિલ્ટર્સને ડાયગ્નોસ્ટિક્સ સાથે અવગણવામાં આવે છે.

કેન્દ્રિત માન્યતા ચકાસણી:

node --import tsx/esm --test tests/unit/compression/rule-loader.test.ts tests/unit/compression/language-packs.test.ts
node --import tsx/esm --test tests/unit/compression/rtk-verify.test.ts tests/unit/compression/rtk-dsl-pipeline.test.ts