pjandro/OmniRoute
1
0
Fork 0
mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-21 22:32:22 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
eb4e3be5dc0207e3f4bc5939cc13dc747229ab3c
OmniRoute/docs/i18n/sr/docs/ops/RELEASE_CHECKLIST.md
Diego Rodrigues de Sa e Souza b637350680 fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940) 
1,104 mirrors rewritten over five passes of run-translation on the 22-source core set: the 14 sources edited since their translation, the 322 mirrors that were still English copies, and the frontmatter the old extractor leaked into the newer locales' bodies. The pipeline now caches per-`## `-section hashes and retranslates only changed sections, never reuses a section that is still English, rebuilds English-copy / leaked mirrors even when the source is unchanged, merges the state on save (parallel runs), and the drift gate (scoped to the core set) is blocking. Final audit: 0 stale, 0 English copies, 0 leaked frontmatter across 1,430 core mirrors.

⚠️ base-red inherited: #12732
2026-09-17 02:55:31 -03:00

31 KiB
Raw Blame History

Release Checklist (Српски)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 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 · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

Последње ажурирање: 2026-08-28 — v3.8.51 Поједностављен ток издавања који користи вештине алатке Claude Code за аутоматизацију.

Одржавајте ред/грану исправним између издања: погледајте RELEASE_GREEN.md (породица /green-prs + npm run check:release-green + /babysit + ноћно покретање). Периодично покретање овога — а нарочито пре ове контролне листе — обезбеђује да PR за издање од почетка буде исправан.

TL;DR

# 1. Повећајте верзију + генеришите CHANGELOG (skill)
/version-bump-cc patch    # или minor/major

# 2. Локално покрените quality gate
npm run check              # lint + testovi
npm run test:coverage      # потпуни coverage gate (60/60/60/60)

# 3. Build & smoke
npm run build
npm run test:e2e           # опционо, али препоручено

# 4. Генеришите release (skill)
/generate-release-cc

# 5. Deploy (skill)
/deploy-vps-both-cc        # или akamai-cc / local-cc

# 6. Snimite dokaze o izdanju (skill)
/capture-release-evidences-cc

npm Trusted Publishing (подразумевано од v3.8.51) — staged на захтев, direct као резервни план

npm-publish.yml подразумевано објављује путем npm Trusted Publishing (OIDC): посао stage-npm (github-hosted) размењује GitHub-ов id-token за краткотрајну npm акредитацију за то извршавање — нема дуготрајног npm token-а у repository secrets, нема 2FA упита, provenance је прикачен. То је начин да се заобиђу npm санкције сада када се токени који заобилазе 2FA повлаче; то враћа потпуно аутоматски ток који је овај пројекат имао до v3.8.48, задржавајући WS1.3 гаранцију (компромитован token сам не може да објави — token не постоји).

Једнократно подешавање (owner): npmjs.com → пакет omniroute → Settings → Trusted Publisher → GitHub: owner diegosouzapw, repo OmniRoute, workflow npm-publish.yml (environment: none). Док то не постоји, аутоматски корак не успева са ENEEDAUTH: поново покрените dispatch са publish_mode=staged (испод) или direct.

Staged објављивање (на захтев — publish_mode=staged)

npm-publish workflow више не објављује директно: он бутује (boot) упакован tarball (check:pack-boot) и затим покреће npm stage publish — тачни бајтови се паркирају на registry-у, нису инсталабилни до одобрења owner-а. Хумана 2FA капија је премештена на ПОСЛЕ доказа, а не пре њега.

Ток за owner-а након што workflow постане зелен:

  1. npm stage list omniroute — пронаћи stage id (такође исписан у сажетку workflow-а).
  2. Верификовати staged бајтове (препоручено): npm stage download <id>, затим инсталирати преузети tarball у temp prefix и bootovati га (npm run check:pack-boot аутоматизује исти pack→install→boot verdikt у CI).
  3. npm stage approve <id> — 2FA упит JESTE публиковање. npm stage reject <id> одбацује.
  4. Post-publish net: post-publish верификатор (WS1.4 из v3.8.49 плана) инсталира објавлену верзију из јавног registry-а у чист container и bootuje је.

Хитан резервни план (emergency fallback): workflow_dispatch са publish_mode=direct враћа legacy тренутно npm publish (користити само ако staging сам показује проблеме; записати разлог).

Једнократно ојачавање (owner, npmjs.com): конфигурисати Trusted Publisher за omniroute у stage-only режиму тако да компромитован дуготрајан token не може директно да изврши npm publish ниоткуда — CI може само да stage-ује; само owner-ова 2FA ослобађа издавање.

Playbook за оштећен артефакт (непромењен): npm deprecate omniroute@<bad> "<reason> — use <fixed>" као подразумевани рефлекс (минути, реверзибилно); npm unpublish само унутар 72h/no-dependents прозора и никад као први потез. Docker: никада не преписивати version tag — rollback значи поново усмеравање latest на последњи добар digest.

Docker Hub latest (обавезно код сваког стабилног SemVer објављивања): docker-publish workflow мора да таг-ује и X.Y.Z и, када should-promote-latest.sh потврди да је ово највиши стабилни SemVer, :latest са истим digest-ом. Након посла: Hub latest digest се поклапа са новим SemVer digest-ом и last_updated је ажуриран. Не остављати :latest на старијем build-у док release notes говоре о исправкама које постоје само на git-у. Compose quickstarts користе :latest; GitOps треба да настави да pinuje X.Y.Z. Видети Docker release channels и #10317.

Hotfix brza traka (oznaka hotfix)

PR sa oznakom hotfix preskače tešku CI matricu (9-shard E2E, coverage ratchet, quality-gate, quality-extended) i zadržava brze gejtove sa visokim signalom: build, unit shard-ove, integraciju, vitest, lint/typecheck, docs-sync, check:pack-artifact i tarball boot-smoke (check:pack-boot). Cilj: zeleno u ≤15min umesto ~33min.

Politika ulaska — sve četiri obavezne (po uzoru na Chromium/VS Code/Node hitne trake):

  1. Ozbiljnost: produkcija je pokvarena — objavljeni artefakt se ruši na pokretanju / bezbednosna ispravka / svi korisnici izdanja su pogođeni. "Važno" nije "pokvareno".
  2. Autoritet: samo vlasnik repozitorijuma dodaje oznaku hotfix. Oznaka JESTE odobrenje — nikada nemojte sami sebi dodeljivati oznaku na kampanjskom PR-u.
  3. Dokaz: opis PR-a sadrži link na prethodni potpuno zeleni "heavy" pokretanje (skup koji bi preskočeni poslovi ponovo validirali) plus sopstveni test ispravke koji je najpre neuspešan, a potom prolazi.
  4. Obim: samo cherry-pick — minimalna ispravka, bez refaktorisanja, bez propratnih izmena.

Preskočena površina coverage/ratchet ponovo se validira u sledećem potpunom pokretanju na release grani (continuous release-green) — traka preskače ČEKANJE, nikada validaciju. Diff-ovi koji sadrže samo testove (svi fajlovi pod tests/, nijedan pod tests/e2e/) automatski preskaču E2E matricu, bez potrebe za oznakom.

Detaljna kontrolna lista

Pre izdavanja

  • Svi PR-ovi usmereni na ovo izdanje su spojeni u release/vX.Y.0
  • Svi otvoreni Linear/issue stavke za ovu verziju su zatvorene ili prebačene na sledeći milestone
  • CI zeleno na release/vX.Y.0 grani
  • Nema TODO(release) markera u kodu: grep -r "TODO(release)" src/ open-sse/
  • Docker bazna slika je ažurna (trenutno node:24.15.0-trixie-slim)

Verzija i Changelog

  • Pokrenite /version-bump-cc <patch|minor|major> (Claude Code skill)
    • Povećava verziju u package.json, electron/package.json
    • Regeneriše CHANGELOG.md iz git commit-ova od poslednjeg taga
    • Ažurira README.md bedževe
  • Ručno pregledajte CHANGELOG.md i po potrebi uredite commit poruke
  • Osigurajte da najnovija semver sekcija u CHANGELOG.md odgovara verziji u package.json
  • Zadržite ## [Unreleased] kao prvu changelog sekciju za budući rad
  • Ažurirajte docs/openapi.yaml → info.version mora biti jednak verziji u package.json

Kvalitet koda

  • npm run lint — 0 greška (upozorenja su postojeća)
  • npm run typecheck:core — čisto
  • npm run typecheck:noimplicit:core — čisto (strogo)
  • npm run check:cycles — nema kružnih zavisnosti
  • npm run check:any-budget:t11 — u okviru budžeta
  • npm run check:route-validation:t06 — čisto
  • npm run check:node-runtime — podržani runtime prag ispunjen (>=22.22.2 <23, >=24.0.0 <27, prema SUPPORTED_NODE_RANGE u src/shared/utils/nodeRuntimeSupport.ts; usklađeno sa engines u package.json)

Testiranje

  • npm run test:unit — prolazi
  • npm run test:vitest — prolazi (MCP server, autoCombo, cache)
  • npm run test:coverage — gejt 60/60/60/60 zadovoljen (statements/lines/functions/branches)
  • npm run test:integration — prolazi (ako izmene dodiruju DB / handlere)
  • npm run test:combo:matrix — prolazi (matrica combo strategija: dokazuje da svih 19 javnih strategija rutiranja donose determinističke odluke o izboru; pokrenite kada dodirujete combo rutiranje, rešavanje strategija ili fallback logiku)
  • RUN_COMBO_LIVE=1 npm run test:combo:live — opciono/ručno (portovan real-upstream smoke test; preuzima read-only DB snapshot sa VPS root@192.168.0.15; pogađa realne provajdere, troši kredite; nikada se ne pokreće u CI; čisto se preskače bez gejta)
  • npm run test:combo:live:vps — opciono/ručno (Phase-3 VPS live smoke: 7 HTTP scenarija naspram live .15 servera preko čistog Node ESM; zahteva ssh root@192.168.0.15; kreira/briše samo __live_test__* combo-e; pogađa realne provajdere; nikada se ne pokreće u CI)
  • npm run test:e2e — prolazi (UI izmene)
  • npm run test:protocols:e2e — prolazi (MCP/A2A izmene)
  • npm run test:ecosystem — prolazi

Hook-ovi (validirano Husky-jem)

Husky hook-ovi se nalaze u .husky/ i automatski se pokreću tokom git operacija.

  • pre-commit: npx lint-staged + node scripts/check/check-docs-sync.mjs + npm run check:any-budget:t11
  • pre-push: brzi deterministički gejtovi — npm run check:any-budget:t11 && npm run check:tracked-artifacts (aktivirano 2026-06-13). Namerno isključuje test:unit (sporo; obuhvaćeno CI poslom test-unit).
    • Pokrenite npm run test:unit ručno pre push-a release grana.

Ako hook ne uspe: ispravite osnovni problem, ne zaobilazite sa --no-verify.

Conventional Commits

Svi commit-ovi vezani za izdanje moraju pratiti format type(scope): subject.

Validni tipovi: feat, fix, refactor, docs, test, chore, perf, style, ci

Validni opsezi (scope): db, sse, oauth, dashboard, api, cli, docker, ci, mcp, a2a, memory, skills, cloud-agent, guardrails, compression, auto-combo, resilience, providers, executors, translator, domain, authz

Prelomne izmene (breaking changes): dodajte BREAKING CHANGE: footer ili ! nakon scope-a (npr. feat(api)!: drop /v0).

Dokumentacija

  • npm run check:docs-sync prolazi (automatski pokreće pre-commit)
  • npm run check:docs-all prolazi (nadgejt: docs-sync + docs-counts + env-doc-sync + deprecated-versions + doc-links)
  • npm run check:env-doc-sync izlazi sa 0 — ugovor o env promenljivama kod ↔ .env.example ↔ docs/reference/ENVIRONMENT.md je netaknut
  • npm run check:doc-links izlazi sa 0 — nema polomljenih internih markdown referenci nakon restrukturiranja
  • docs/architecture/ARCHITECTURE.md pregledan zbog odstupanja u storage/runtime
  • docs/guides/TROUBLESHOOTING.md pregledan zbog odstupanja u env promenljivama i operativnim aspektima
  • Ako je .env.example izmenjen: docs/reference/ENVIRONMENT.md je ažuriran
  • Ako nova funkcionalnost ima UI: docs/guides/USER_GUIDE.md je pominje
  • Ako nova funkcionalnost ima API: docs/reference/API_REFERENCE.md + docs/openapi.yaml su ažurirani
  • Ako je nova funkcionalnost modul: postoji posvećen docs/<MODULE>.md
  • Ako je prelomna izmena: docs/guides/TROUBLESHOOTING.md sadrži napomenu o migraciji

i18n

  • npm run i18n:check izlazi sa 0 — stanje prevoda (.i18n-state.json) je u sinhronizaciji sa izvornom dokumentacijom (nema odstupljenih izvora u strogom modu; savetodavno upozorenje je prihvatljivo za izmene dokumentacije u zadnji čas, ali treba da bude 0 pre tagovanja)
  • npm run i18n:check-ui-coverage izlazi sa 0 — svaki UI lokal je na ili iznad praga pokrivenosti od 80%
  • npm run i18n:sync-ui:dry izveštava o 0 nedostajućih ključeva u svih 42 lokala
  • Ako su izvorni engleski dokumenti izmenjeni, pokrenite npm run i18n:run (zahteva OMNIROUTE_TRANSLATION_API_KEY u .env) pre tagovanja
  • Prevodilački doprinosi mogu biti odloženi za sledeće izdanje ako su manji (pratite u CHANGELOG-u)

Migracije baze podataka

  • Ako src/lib/db/migrations/ sadrži nove fajlove:
    • Svaka migracija je idempotentna (CREATE TABLE IF NOT EXISTS, itd.)
    • Migracije su umotane u transakcije
    • Numeracija je ispravna (nema praznina u sekvenci)
  • Testirajte na svežoj instalaciji: obrišite ~/.omniroute/omniroute.db i pokrenite npm run dev
  • Testirajte na postojećoj instalaciji: napravite backup baze, pokrenite migraciju, provjerite šemu
  • WAL fajlovi (-wal, -shm) su ispravno obrađeni ako migracija ponovo piše tabele

Katalog provajdera (Zod-validiran)

  • Zod šema u src/shared/constants/providers.ts je validna pri učitavanju
    • Svi provajderi imaju obavezna polja (id, label, kind, itd.)
    • freeNote je obezbeđen za nove besplatne provajdere
    • OAuth provajderi imaju oauthConfig registrovan u src/lib/oauth/constants/oauth.ts
  • Ako je dodat novi provajder: odgovarajući executor u open-sse/executors/
  • Ako format nije OpenAI: translator u open-sse/translator/
  • Modeli registrovani u open-sse/config/providerRegistry.ts
  • Unit testovi u tests/unit/ pokrivaju klasifikaciju provajdera i rutiranje

Desktop (Electron)

Ako je electron/ izmenjen:

  • npm run electron:smoke:packaged prolazi
  • Build-ovi testirani za bar jedan od :win, :mac, :linux
  • Sertifikati za potpisivanje koda nisu istekli (ako se potpisuje)
  • Verzija u electron/package.json se poklapa sa root package.json
  • Auto-update kanal pokazivač je ažuriran ako se izdaje na stable

Build raspored

Repozitorijum koristi tri odvojena izlazna direktorijuma — nikada ih ne pomešajte:

Direktorijum Namena Praćen?
src/ Izvorni kod aplikacije (TypeScript / TSX) Da
.build/ Build intermediates — izlaz next build-a (distDir) Ne (gitignored)
dist/ Spremni za slanje npm bundle — sastavljen od assembleStandalone Ne (gitignored)

Napomena operatera: direktorijum slike na udaljenom VPS-u ostaje /usr/lib/node_modules/omniroute/app/. Samo se u-repozitorijumski build izlaz premestio (app/ → dist/). Deploy skill-ovi rsync-uju sadržaj dist/ u udaljeni app/ direktorijum — nisu potrebne izmene VPS putanja.

Tok jednog build-a:

npm run build:release
  └─ rm -rf .build dist          (čišćenje)
  └─ next build → .build/next/   (intermediates)
  └─ assembleStandalone          (kopira standalone + static + public + natives → dist/)
  └─ upisuje dist/BUILD_SHA       (HEAD sentinel)

NE pokrećite npm run build nakon čega slijedi odvojen npm run build:cli za deploy — koristite npm run build:release koji radi čist rebuild + sentinel u jednoj komandi.

Validacija artefakta

  • npm run build:release uspešno se izvršava i dist/BUILD_SHA == git rev-parse --short HEAD
  • npm run check:pack-artifact čisto — nema app.__qa_backup, scripts/scratch, package-lock.json, ili drugih lokalnih ostataka
  • dist/server.js postoji nakon build-a

Tagovanje i izdavanje

  • Pokrenite /generate-release-cc (Claude Code skill):
    • Kreira tag vX.Y.Z
    • Push-uje tag i granu
    • Otvara GitHub Release sa changelog telom
    • Prilaže Electron instalatore (ako su izgrađeni)
  • Ili ručno: 
    git tag -a vX.Y.Z -m "Release vX.Y.Z"
git push origin vX.Y.Z
gh release create vX.Y.Z --notes-from-tag

Deploy

Deploy skill-ovi koriste laki rsync tok — bez npm pack, bez npm i -g:

  • Koristite deploy skill koji odgovara cilju:
    • /deploy-vps-local-cc — lokalni VPS (192.168.0.15)
    • /deploy-vps-akamai-cc — Akamai VPS (69.164.221.35)
    • /deploy-vps-both-cc — oba
  • Pre deploy-a, potvrdite da dist/BUILD_SHA == git rev-parse --short HEAD
  • Build mora da se izvrši gde je node_modules stvaran (glavni checkout ili npm ci-ovan worktree — NE simlinkovan worktree)
  • Smoke test deployovane instance:
    • Otvorite /dashboard/health → provjerite da string verzije odgovara izdanju
    • Pokrenite /v1/chat/completions zahtev naspram poznatog provajdera
    • Provjerite da /api/monitoring/health vraća CLOSED circuit breaker-e
    • Potvrdite da MCP transporti odgovaraju (/mcp HTTP, /mcp-sse SSE)

Post-izdavanje

  • Pokrenite /capture-release-evidences-cc (Claude Code skill)
    • Snima WebP screenshot-ove/snimke novih funkcionalnosti
    • Prilaže uz release notes / blog post
  • Ažurirajte GitHub Discussions / Discord sa najavom izdanja
  • Otvorite milestone za sledeću verziju
  • Ako je kritično: prikačite (pin) diskusiju ili objavite u news.json za in-app baner

Radar gejt javnog lansiranja

Radar najava je namerno commit-ovana sa active: false. Aktivacija je posebna izmena nakon što je svaka stavka ispod dokazana:

  • Svi naslagani Radar PR-ovi su spojeni i CI na vrhu release grane je zelen
  • Deploy-ujte i smoke testirajte OSS Radar rute sa RADAR_ENABLED još isključenim po podrazumevanju
  • Smoke testirajte GET /planos, /termos, /privacidade, i /reembolso na imenovanom Radar host-u
  • Zabeležite identitet/kontakt/adresu operatera i pravni pregled odobren od vlasnika u privatnom servisu
  • Isprobajte Stripe Checkout i potpisan webhook samo u test modu
  • Isprobajte jednu isporuku enkriptovane transakcione e-poruke sa odobrenim pošiljaocem/domenom
  • Dokažite backup restore i jedno nadgledano, budžetom ograničeno istraživačko pokretanje
  • Odobrite politiku pregleda BRL/PIX pre prihvatanja dokaza o donaciji
  • Omogućite javni Checkout samo nakon prethodnih gejtova, zatim aktivirajte novi news.json ID
  • Provjerite da Home baner koristi lokalizovan tekst i da se novi ID ponovo pojavljuje nakon što je stariji ID odbačen

Провера рада уграђених сервиса (v3.8.4+)

Пре објављивања сваке верзије која садржи измене уграђених сервиса, проверите:

Покретање са свежом базом (открива сукобе миграција — додато после хотфикса v3.8.4)

  • DATA_DIR=$(mktemp -d) npm start & — сачекајте 10 s за покретање
  • curl -s http://127.0.0.1:20128/api/services/9router/status | jq '.tool' враћа "9router" (НЕ 404, НЕ 500). Потврђује да је миграција 071_services.sql примењена + да је ред попуњен.
  • sqlite3 $DATA_DIR/storage.sqlite "PRAGMA table_info(version_manager);" | grep -E "provider_expose|logs_buffer_path|last_sync_at" враћа 3 реда.
  • sqlite3 $DATA_DIR/storage.sqlite "PRAGMA table_info(webhooks);" | grep -E "kind|metadata_encrypted" враћа 2 реда (потврђује да је 070_webhooks_kind_metadata.sql примењена).
  • node --import tsx/esm --test tests/unit/db/no-migration-collisions.test.ts пролази — штити од будућих сукоба.

9Router

  • POST /api/services/9router/install враћа 200 са installedVersion за мање од 2 минута
  • POST /api/services/9router/start враћа 200 и state: "running" за мање од 30 s
  • GET /api/services/9router/status пријављује health: "healthy"
  • POST /v1/chat/completions са "model": "9router/auto/..." враћа 200 (end-to-end рутирање кроз 9Router)
  • GET /dashboard/providers/services/9router/embed/dashboard рендерује изворни 9Router кориснички интерфејс унутар proxy-ja (без директног 127.0.0.1:port iframe-а)
  • POST /api/services/9router/rotate-key враћа { keyRotated: true } и сервис се уредно поново покреће
  • POST /api/services/9router/stop враћа 200 и state: "stopped"
  • GET /api/services/9router/logs?tail=50 враћа SSE стрим са snapshot догађајем који садржи недавне линије
  • Инсталација у окружењу без npm у PATH-у враћа 500 са пријатељском (не stack-trace) поруком о грешци

CLIProxyAPI

  • POST /api/services/cliproxy/install враћа 200 за мање од 2 минута
  • POST /api/services/cliproxy/start враћа 200 и state: "running" за мање од 30 s
  • GET /api/services/cliproxy/status пријављује health: "healthy"
  • POST /api/services/cliproxy/stop враћа 200 и state: "stopped"
  • GET /api/services/cliproxy/logs?tail=50 враћа SSE стрим

Безбедносна регресија

  • curl -H "X-Forwarded-For: 1.2.3.4" http://localhost:20128/api/services/9router/start враћа 403 LOCAL_ONLY
  • curl -H "X-Forwarded-For: 1.2.3.4" http://localhost:20128/api/services/cliproxy/start враћа 403 LOCAL_ONLY
  • Одговори са грешкама из /api/services/* не садрже err.stack ни апсолутне путеве до фајлова

Провере за v3.8.0+

Пре објављивања сваке v3.8.x верзије, проверите ове додатне ставке:

  • omniroute --tray се покреће на macOS-у (systray2 инсталиран у ~/.omniroute/runtime/)
  • omniroute --tray се покреће на Linux-у (захтева DISPLAY; учтива грешка ако није подешен)
  • omniroute --tray се покреће на Windows-у (PowerShell NotifyIcon, без додатних бинарних фајлова)
  • omniroute config tray enable креира autostart унос; disable га уклања
  • npm install -g omniroute@<this-version> покреће postinstall без фаталног прекида
  • Путања ажурирања чува опционе зависности: omniroute update --apply и аутоматски updater покрећу npm install -g … --include=optional тако да optionalDependencies (better-sqlite3, keytar, tls-client, и llmlingua SLM стек: @atjsh/llmlingua-2@2.0.5, js-tiktoken) преживе ажурирање. Ultra modelPath SLM ниво такође захтева tinybert модел, који се аутоматски преузима у ${DATA_DIR}/models/llmlingua при првом коришћењу. Postinstall (scripts/build/colocateOptionals.mjs) затим смешта затвориште SLM опционих зависности у dist/node_modules тако да worker разреши ЈЕДНУ инстанцу @huggingface/transformers ^4.2.0 — самосталан trace bundle укључује само transformers, а не динамички увезене опционе зависности, тако да без овога worker би учитао llmlingua-2 наспрам transformers-а из корена и SLM ниво би тихо fail-open-овао.
  • omniroute status радi без .env фајла (путања CLI токена, само loopback)
  • curl http://localhost:20128/api/shutdown враћа 401 (увек заштићена рута)
  • curl -H "host: evil.com" http://localhost:20128/api/mcp/sse враћа 401 (loopback заштита)
  • SQLite runtime се разрешава на bundled при првом покретању (bundled бинарни фајл важи за платформу)
  • SQLite runtime се пребацује на runtime када се обрише node_modules/better-sqlite3
  • Smart MCP филтер компримује стварни излаз playwright-mcp browser_snapshot (≥50% смањења)
  • Свих 10 skills/omniroute*/SKILL.md фајлова су јавно доступни путем raw GitHub URL-а
  • Чаробњак за онбординг приказује корак обиласка нивоа "How It Works" при свежем подешавању
  • Виджет покривености нивоа на почетној контролној табли приказује конфигурисане/активне бројеве

Враћање на претходну верзију (Rollback)

Ако издање има критичан проблем:

  1. gh release edit vX.Y.Z --prerelease (означава као не-најновије)
  2. git tag -d vX.Y.Z && git push --delete origin vX.Y.Z (само ако корисници још нису усвојили)
  3. Или: hotfix на release/vX.Y.0 → patch издање vX.Y.(Z+1)
  4. Одмах обавестити заједницу на GitHub Discussions и Discord-у

Стриктна правила

  • Никада немојте директно комитовати на main
  • Никада немојте користити git push --force на main или release/* гранама
  • Никада немојте прескакати Husky hooks (--no-verify)
  • Никада немојте комитовати тајне, креденцијале или .env фајлове
  • Покривеност мора остати ≥60/60/60/60 (statements/lines/functions/branches)
  • Увек укључите или ажурирајте тестове када мењате продукциони код у src/, open-sse/, electron/ или bin/

Аутоматизована провера синхронизације

Покрените локалну проверу синхронизације документације пре отварања PR-а:

npm run check:docs-sync

CI такође покреће ову проверу у .github/workflows/ci.yml (lint job).

Reference in New Issue View Git Blame Copy Permalink