# Test Coverage Plan (Gaeilge) 🌐 **Languages:** 🇺🇸 [English](../../../../ops/COVERAGE_PLAN.md) · 🇪🇹 [am](../../../am/docs/ops/COVERAGE_PLAN.md) · 🇸🇦 [ar](../../../ar/docs/ops/COVERAGE_PLAN.md) · 🇦🇿 [az](../../../az/docs/ops/COVERAGE_PLAN.md) · 🇧🇬 [bg](../../../bg/docs/ops/COVERAGE_PLAN.md) · 🇧🇩 [bn](../../../bn/docs/ops/COVERAGE_PLAN.md) · 🇧🇦 [bs](../../../bs/docs/ops/COVERAGE_PLAN.md) · 🇨🇿 [cs](../../../cs/docs/ops/COVERAGE_PLAN.md) · 🇩🇰 [da](../../../da/docs/ops/COVERAGE_PLAN.md) · 🇩🇪 [de](../../../de/docs/ops/COVERAGE_PLAN.md) · 🇬🇷 [el](../../../el/docs/ops/COVERAGE_PLAN.md) · 🇪🇸 [es](../../../es/docs/ops/COVERAGE_PLAN.md) · 🇪🇪 [et](../../../et/docs/ops/COVERAGE_PLAN.md) · 🇮🇷 [fa](../../../fa/docs/ops/COVERAGE_PLAN.md) · 🇫🇮 [fi](../../../fi/docs/ops/COVERAGE_PLAN.md) · 🇫🇷 [fr](../../../fr/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [gu](../../../gu/docs/ops/COVERAGE_PLAN.md) · 🇳🇬 [ha](../../../ha/docs/ops/COVERAGE_PLAN.md) · 🇮🇱 [he](../../../he/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [hi](../../../hi/docs/ops/COVERAGE_PLAN.md) · 🇭🇷 [hr](../../../hr/docs/ops/COVERAGE_PLAN.md) · 🇭🇺 [hu](../../../hu/docs/ops/COVERAGE_PLAN.md) · 🇦🇲 [hy](../../../hy/docs/ops/COVERAGE_PLAN.md) · 🇮🇩 [id](../../../id/docs/ops/COVERAGE_PLAN.md) · 🇳🇬 [ig](../../../ig/docs/ops/COVERAGE_PLAN.md) · 🇮🇹 [it](../../../it/docs/ops/COVERAGE_PLAN.md) · 🇯🇵 [ja](../../../ja/docs/ops/COVERAGE_PLAN.md) · 🇬🇪 [ka](../../../ka/docs/ops/COVERAGE_PLAN.md) · 🇰🇭 [km](../../../km/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [kn](../../../kn/docs/ops/COVERAGE_PLAN.md) · 🇰🇷 [ko](../../../ko/docs/ops/COVERAGE_PLAN.md) · 🇱🇹 [lt](../../../lt/docs/ops/COVERAGE_PLAN.md) · 🇱🇻 [lv](../../../lv/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [ml](../../../ml/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [mr](../../../mr/docs/ops/COVERAGE_PLAN.md) · 🇲🇾 [ms](../../../ms/docs/ops/COVERAGE_PLAN.md) · 🇲🇹 [mt](../../../mt/docs/ops/COVERAGE_PLAN.md) · 🇲🇲 [my](../../../my/docs/ops/COVERAGE_PLAN.md) · 🇳🇵 [ne](../../../ne/docs/ops/COVERAGE_PLAN.md) · 🇳🇱 [nl](../../../nl/docs/ops/COVERAGE_PLAN.md) · 🇳🇴 [no](../../../no/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [or](../../../or/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [pa](../../../pa/docs/ops/COVERAGE_PLAN.md) · 🇵🇭 [phi](../../../phi/docs/ops/COVERAGE_PLAN.md) · 🇵🇱 [pl](../../../pl/docs/ops/COVERAGE_PLAN.md) · 🇵🇹 [pt](../../../pt/docs/ops/COVERAGE_PLAN.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/ops/COVERAGE_PLAN.md) · 🇷🇴 [ro](../../../ro/docs/ops/COVERAGE_PLAN.md) · 🇷🇺 [ru](../../../ru/docs/ops/COVERAGE_PLAN.md) · 🇱🇰 [si](../../../si/docs/ops/COVERAGE_PLAN.md) · 🇸🇰 [sk](../../../sk/docs/ops/COVERAGE_PLAN.md) · 🇸🇮 [sl](../../../sl/docs/ops/COVERAGE_PLAN.md) · 🇷🇸 [sr](../../../sr/docs/ops/COVERAGE_PLAN.md) · 🇸🇪 [sv](../../../sv/docs/ops/COVERAGE_PLAN.md) · 🇰🇪 [sw](../../../sw/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [ta](../../../ta/docs/ops/COVERAGE_PLAN.md) · 🇮🇳 [te](../../../te/docs/ops/COVERAGE_PLAN.md) · 🇹🇭 [th](../../../th/docs/ops/COVERAGE_PLAN.md) · 🇹🇷 [tr](../../../tr/docs/ops/COVERAGE_PLAN.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/ops/COVERAGE_PLAN.md) · 🇵🇰 [ur](../../../ur/docs/ops/COVERAGE_PLAN.md) · 🇺🇿 [uz](../../../uz/docs/ops/COVERAGE_PLAN.md) · 🇻🇳 [vi](../../../vi/docs/ops/COVERAGE_PLAN.md) · 🇳🇬 [yo](../../../yo/docs/ops/COVERAGE_PLAN.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/ops/COVERAGE_PLAN.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/ops/COVERAGE_PLAN.md) --- Nuashonraithe go deireanach: 2026-06-28 > Stádas tomhaiste ar 2026-05-13: línte 82.58%, ráitis 82.58%, feidhmeanna 84.23%, craobhacha 75.22%. Tá Céimeanna 1-5 curtha i gcrích. Tá an fócas reatha ar Chéim 6 (>=85%) agus ar Chéim 7 (>=90%). ## Bunchairt Tá roinnt uimhreacha clúdaigh ann ag brath ar an gcaoi a gcoinnítear an tuairisc. Le haghaidh pleanála, níl ach ceann amháin inúsáide. | Méadracht | Scóip | Ráitis / Línte | Brainse | Feidhmeanna | Nótaí | | --------------- | --------------------------------------------------------------------------- | -------------: | ------: | ----------: | ---------------------------------------------------------------------------- | | Oidhreacht | Seanchlúdach `npm run test:coverage` | 79.42% | 75.15% | 67.94% | Méadaithe: áirítear comhaid tástála agus dhéantar neamhdearmad ar `open-sse` | | Diagnóiseach | Foinse amháin, ag fáil réidh le tástálacha agus ag fáil réidh le `open-sse` | 68.16% | 63.55% | 64.06% | Ní úsáideach ach chun `src/**` a fhreagairt | | Bunchairt molta | Foinse amháin, ag fáil réidh le tástálacha agus ag áireamh `open-sse` | 82.58% | 75.22% | 84.23% | Is é seo an bunchairt fud na tionsclaíochta le feabhsú | Is é an bunchairt molta an uimhir le bharrfheabhsú. ## Rialacha - Is iad comhaid foinse atá i gceist le spriocanna clúdaigh, ní `tests/**`. - Tá `open-sse/**` mar chuid den táirge agus ní mór é a choinneáil sa raon. - Ní cheart don chód nua an clúdach a laghdú i gceantair a théann sé i bhfeidhm orthu. - Is fearr iompar agus thoradh brainse a thástáil ná sonraí cur i bhfeidhm. - Is fearr bunachair shonraí SQLite sealadacha agus giuirléidí beaga ná mionghámaí leathan do `src/lib/db/**`. ## Tacar ordaithe reatha - `npm run test:coverage` - Príomhghátar clúdaigh foinse don tsraith tástála aonaid - Gineann sé `text-summary`, `html`, `json-summary`, agus `lcov` - `npm run coverage:report` - Tuairisc mhionsonraithe comhad ar chomhad ón rith is déanaí - `npm run test:coverage:legacy` - Cur síos stairiúil amháin ## Céimeanna | Céim | Sprioc | Fócas | Stádas | | ------ | -----------------: | -------------------------------------------------------------------- | ----------------- | | Céim 1 | 60% ráitis / línte | Buanna tapa agus clúdach úsáideochta ríse íseal | ✅ Críochnaithe | | Céim 2 | 65% ráitis / línte | Bunchairt bunachar sonraí agus bealaí | ✅ Críochnaithe | | Céim 3 | 70% ráitis / línte | Fíorú soláthraí agus anailís úsáide | ✅ Críochnaithe | | Céim 4 | 75% ráitis / línte | Teangeoirí agus cabhróirí `open-sse` | ✅ Críochnaithe | | Céim 5 | 80% ráitis / línte | Láimhseálaithe agus brainse forghníomhaigh `open-sse` | ✅ Críochnaithe | | Céim 6 | 85% ráitis / línte | Cásanna fánála níos deacra, fiachas brainse, seoltaí athghníomhachta | Ag dul ar aghaidh | | Céim 7 | 90% ráitis / línte | Scuabadh deireanach, dúntear bearnaí, ratchet dian | Ag fanacht | Ba cheart do bhrainse agus feidhmeanna ratchet a dhéanamh suas le gach céim, ach is é an sprioc crua príomhúil ná ráitis / línte. ## Spotaí tosaíochta Tá na comhaid seo ag an tsruth clúdaigh is ísle inniu (< 60%) agus tairgeann siad an toradh is fearr do chéimeanna 6-7. Gineadh é ó `coverage/coverage-summary.json` ar 2026-05-13: | # | Bith | Línte % | | --- | ------------------------------------------------------------ | ------: | | 1 | `open-sse/services/compression/validation.ts` | 7.87% | | 2 | `src/app/api/v1/batches/route.ts` | 9.67% | | 3 | `src/app/docs/components/FeedbackWidget.tsx` | 9.80% | | 4 | `open-sse/services/compression/toolResultCompressor.ts` | 10.00% | | 5 | `src/app/docs/components/DocCodeBlocks.tsx` | 10.63% | | 6 | `open-sse/services/compression/engines/rtk/lineFilter.ts` | 10.96% | | 7 | `open-sse/services/specificityRules.ts` | 11.28% | | 8 | `src/mitm/systemCommands.ts` | 12.19% | | 9 | `open-sse/services/compression/aggressive.ts` | 12.77% | | 10 | `src/app/api/v1/batches/[id]/cancel/route.ts` | 12.98% | | 11 | `open-sse/services/compression/progressiveAging.ts` | 13.26% | | 12 | `open-sse/services/compression/engines/rtk/smartTruncate.ts` | 13.43% | | 13 | `open-sse/services/compression/engines/rtk/deduplicator.ts` | 13.51% | | 14 | `src/lib/cloudAgent/agents/jules.ts` | 13.52% | | 15 | `open-sse/services/compression/lite.ts` | 14.46% | | 16 | `src/app/api/v1/rerank/route.ts` | 14.94% | | 17 | `open-sse/services/compression/preservation.ts` | 15.07% | | 18 | `src/lib/cloudAgent/agents/codex.ts` | 15.54% | | 19 | `open-sse/services/tierResolver.ts` | 16.66% | | 20 | `src/app/docs/components/DocsLazyWrapper.tsx` | 16.66% | Téamaí do chéimeanna 6-7: - Tá `open-sse/services/compression/**` mar an lárna is dlúithe de chlúdach íseal agus bíonn sé ag rialú an bhearna atá fágtha. - Tá ródanna API na mbaisc agus an athranggalaithe (`src/app/api/v1/batches/**`, `src/app/api/v1/rerank/route.ts`) ag teastáil tástálacha ar leibhéal na láimhseálaithe. - Tá tástálacha cásanna ag teastáil ó chomhtháthóirí na ngníomhaire scamall (`src/lib/cloudAgent/agents/jules.ts`, `codex.ts`) agus `tierResolver.ts`. - Tá comhpháirteanna UI na ndoiciméad agus `src/mitm/systemCommands.ts` ag dul i ndiaidh tosaíochta ach is buanna brainse saor iad. ## Seiceáil curaclaim ### Céim 1: 56.95% -> 60% - [x] Cuir ceartúchán méadrachta clúdaigh i bhfeidhm ionas go léiríonn sé cód foinse seachas comhaid tástála - [x] Coinnigh script clúdaigh oidhreachta le haghaidh comparáide - [x] Taifead an líne tionsclaíoch agus na spotaí tósaíochta sa stór - [ ] Cuir tástálacha dírithe le haghaidh uirlisí riosca-íseal: - `src/shared/utils/upstreamError.ts` - `src/shared/utils/fetchTimeout.ts` - `src/lib/api/errorResponse.ts` - `src/shared/utils/apiAuth.ts` - `src/lib/display/names.ts` - [ ] Cuir tástálacha ród le haghaidh: - `src/app/api/settings/require-login/route.ts` - `src/app/api/providers/[id]/models/route.ts` ### Céim 2: 60% -> 65% - [ ] Cuir tástálacha tacaíochta DB le haghaidh: - `src/lib/db/modelComboMappings.ts` - `src/lib/db/settings.ts` - `src/lib/db/registeredKeys.ts` - [ ] Clúdaigh iompar brainse i: - `src/lib/providers/validation.ts` - `src/app/api/v1/embeddings/route.ts` - `src/app/api/v1/moderations/route.ts` ### Céim 3: 65% -> 70% - [ ] Cuir tástálacha anailísíochta úsáide le haghaidh: - `src/lib/usage/usageHistory.ts` - `src/lib/usage/usageStats.ts` - `src/lib/usage/costCalculator.ts` - [ ] Leathnaigh clúdach na ród le haghaidh bhainistíocht ionadaíochta agus brainsí socruithe ### Céim 4: 70% -> 75% - [ ] Clúdaigh cúntóirí aistriúcháin agus cosáin aistriúcháin lárnacha: - `open-sse/translator/index.ts` - `open-sse/translator/helpers/*` - `open-sse/translator/request/*` - `open-sse/translator/response/*` ### Céim 5: 75% -> 80% - [ ] Cuir tástálacha ar leibhéal na láimhseála le haghaidh: - `open-sse/handlers/chatCore.ts` - `open-sse/handlers/responsesHandler.js` - `open-sse/handlers/imageGeneration.js` - `open-sse/handlers/embeddings.js` - [ ] Cuir clúdach brainse na rithí le haghaidh fíordheimhniú ar son soláthraí, iarrachtaí, agus cealúcháin deireadhphointí ### Céim 6: 80% -> 85% - [ ] Cuir níos mó tásctallacha cásanna imeall le chéile i gcósán clúdach príomhshrutha - [ ] Méadaigh clúdach feidhmeanna do mhodúil DB le clúdach tógálaí/cúnaimh lag - [ ] Dún bearnanna brainse i `settings.ts`, `registeredKeys.ts`, `validation.ts`, agus cúntóirí aistriúcháin ### Céim 7: 85% -> 90% - [ ] Déan na comhaid clúdaigh íseal atá fágtha ina mblocálaithe - [ ] Cuir tástálacha aisghníomhacha le haghaidh gach fabht táirgí neamhchlúdaithe a cuireadh i gceart le linn an bhrú go 90% - [ ] Ardaigh geata clúdach i CI ach tar éis go mbeidh an líne tionsclaíoch logánta cobhsach ar a laghad dhá rith as a chéile ## Polasaí Ratchet Ná nuashonraigh na leibhéalacha `npm run test:coverage` ach tar éis don tionscadal sárú an chéad mhílechléire le bufer fholláin. **Geata reatha:** Éilíonn `npm run test:coverage` **60 ráiteas / 60 líne / 60 feidhm / 60 brainse** (athbhunsaíodh an tomhas i Quality-Gates Fase 6A.1 — bhí an bonnlíne 82.58% níos luaithe bláthaithe mar go raibh sé ag comhaireamh comhaid tástála agus d'fhág sé `open-sse` ar lár). Cosnaíonn an t-ordú `test:coverage:legacy` an seanmheaschruacháin 50/50/50 le haghaidh comparáide stairiúil. Chun seiceáilí ad hoc ar an leibhéal a dhéanamh i gcoinne an tuairisc is déanaí úsáid: ```bash node scripts/check/test-report-summary.mjs --threshold 75 ``` Seqú ratchet molta (ord: `statements-lines / branches / functions`): 1. 55/60/55 2. 60/62/58 3. 65/64/62 4. 70/66/66 5. 75/70/72 <-- geata reatha (75/70/75) 6. 80/75/78 7. 85/80/84 8. 90/85/88 Is é sprioc ratchet atá romhainn `80/75/78` nuair a sheasfaidh clúdach na mbraistí os cionn 78% ar feadh dhá rith as a chéile. ## Bhearna aitheanta Mheasann an t-ordú clúdach reatha an tsraith taispeáint Node príomhúil agus cuireann sé san áireamh an foinse a shroichfidh sé sin, lena n-áirítear `open-sse`. Ní thuilleann sé Vitest clúdach a chomhtháthú ina tuairisc aontaithe amháin fós. Is fiú an tionscnamh comhtháthaithe sin a dhéanamh níos déanaí, ach ní bac é chun tús a chur leis an ardú ó 60% go 80%.