Files
OmniRoute/docs/i18n/sv/CLAUDE.md
Diego Rodrigues de Sa e Souza f59f8daa94 Release v3.8.6 (#2804)
* fix(gemini): preserve structured tool calls for antigravity

* fix(gemini): parse prefixed textual tool calls

* fix(antigravity): preserve textual SSE tool calls

* fix(stream): normalize textual passthrough tool calls

* fix(stream): normalize split textual tool calls

* fix(stream): suppress malformed textual tool calls

* fix(stream): suppress compact malformed tool calls

* fix(stream): emit structured textual tool calls

* fix(stream): suppress unknown textual tool calls

* fix(stream): normalize responses textual tool calls

* chore: ignore .claude/settings.local.json (per-user Claude Code permissions)

* fix(opencode-go): route qwen3.x via claude messages + repair fixMissingToolResponses for Claude-shape upstreams (#2791)

Integrated into release/v3.8.6

* fix: resolve npm install warnings — remove dead deps, relax engine constraint (#2792)

Integrated into release/v3.8.6

* fix: register missing web-cookie validators (claude-web, gemini-web, copilot-web, t3-web) (#2793)

Integrated into release/v3.8.6

* fix: Error: Unable to inspect existing database #2771 (#2795)

Integrated into release/v3.8.6

* fix(oauth): repair Google loopback callback flow (#2796)

Integrated into release/v3.8.6

* feat(logs): add clean history button (#2799)

Integrated into release/v3.8.6

* [codex] home: restore settings-driven home layout and quota auto-refresh (#2800)

Integrated into release/v3.8.6

* fix(gemini): emit signaturelessToolCallMode:text for GEMINI format models (#2801)

Integrated into release/v3.8.6

* feat(modelSpecs): align opencode-go family with upstream provider limits (#2802)

Integrated into release/v3.8.6

* chore: apply unit test fixes, polyfills, and environment precedence fixes

* docs(agents): atualiza fluxos de release e triagem

Expande os workflows de release para incluir auditoria de segurança,
CHANGELOG completo por commits, quality gate obrigatório, homologação em
VPS local, publicação oficial, deploy em Akamai e validação de artefatos.

Reorganiza a triagem de features com arquivos permanentes por bucket,
suporte a itens em andamento, regra de reclaim após 15 dias e novo
tratamento para ideias viáveis catalogadas.

Corrige a orientação de revisão de discussões para usar a ordem
cronológica real dos comentários e respostas ao identificar a última
atividade.

* fix(lockout): classify Gemini Antigravity resource exhaustion as quota_exhausted

* fix(reasoning): gate replay by interleaved field

* docs(rule-16): permit human Co-authored-by, restrict only AI/bot trailers

Rule #16 previously banned all `Co-Authored-By` trailers absolutely.
That blocked the upstream-port workflows (`/port-upstream-features` and
`/port-upstream-issues`), which must credit human upstream PR authors
and issue reporters in OmniRoute commits.

Refine the rule to ban only AI/bot-attributed trailers (Claude, GPT,
Copilot, Bot; anthropic.com / openai.com / bot-owned noreply.github.com
emails) while allowing standard human `Co-authored-by: Name <email>`
attribution.

Sync the rule across the source CLAUDE.md, the E2E shakedown doc note,
and 41 i18n translations.

* fix(gitlawb): add specialty validators for connection test — bypass /models probe

GitLawB OpenGateway API (xiaomi-mimo compatible) does not expose a /models
endpoint, causing validateOpenAILikeProvider to 404 on the initial probe
and report 'Provider validation endpoint not supported'.

Add specialty validators for both gitlawb and gitlawb-gmi that follow the
same pattern as the existing xiaomi-mimo validator: skip GET /models,
validate directly via POST /chat/completions with a minimal test message.
Any 401/403 response means an invalid key; all other responses mean auth
is OK.

Fixes test-connection returning 404 for GitLawB providers.

* test(gitlawb): add 12 unit tests for gitlawb and gitlawb-gmi specialty validators

Covers success, auth failure (401/403), non-auth acceptance (400/422/429),
network errors, and custom baseUrl overrides for both providers.

* feat(gitlawb): serve models from static registry without API-unavailable warning

GitLawB's OpenGateway API does not expose a /models endpoint per
provider-path. Previously the models route fell through to the generic
fallback which returned static catalog models with the misleading
'API unavailable — using local catalog' warning.

Now gitlawb and gitlawb-gmi are handled as static model providers
(same pattern as reka and qwen OAuth) — models are served from the
provider registry without any warning, since all registered models
are functional via POST /chat/completions.

* refactor(gitlawb): extract shared opengateway validator factory, fix docs path in test

- Extract gitlawb/gitlawb-gmi validators into buildOpengatewayValidator factory
- Fix dockerignore-docs-coverage test: update stale docs/AUTO-COMBO.md -> docs/routing/AUTO-COMBO.md

* fix(reasoning): guard interleaved capability lookup

* feat(gitlawb): dynamic model fetch with gmi-cloud fallback

Hybrid approach:
- gitlawb (xiaomi-mimo): dynamic /models endpoint → 356 models
- gitlawb-gmi (gmi-cloud): 404 fallback → local catalog gracefully
Mimics Gitlawb/openclaude's model-routing pattern

* i18n(pt-BR): complete missing translations and sync with en.json

* feat(build): nix multi-OS package manager install (#2806)

Integrated into release/v3.8.6

* fix(i18n): translate 144 new __MISSING__ pt-BR strings (#2816)

Integrated into release/v3.8.6

* chore(docs): set coverage gate to 40/40/40/40 in CLAUDE.md

Aligns the documented coverage gate with the v3.8.6 release decision
(lowered from 75/75/75/70). Matches the threshold already set in
package.json by the large feature PRs (planos 11-22).

* fix(cli): respect PORT env var in serve command (#2845)

Integrated into release/v3.8.6.

* fix(deepseek-web): return 400 when client sends tools[] - chat.deepseek.com has no tool support (#2854)

Integrated into release/v3.8.6.

* fix(qoder): reject invalid/expired PATs returning Cosy 500 error (#2860)

Integrated into release/v3.8.6.

* fix(cli): register openclaw in tool-detector (#2833) (#2850)

Integrated into release/v3.8.6.

* fix(api): include noAuth providers in /v1/models catalog (#2798) (#2814)

Integrated into release/v3.8.6.

* fix(combo): resolve custom provider targets via combo name (#2778) (#2812)

Integrated into release/v3.8.6.

* fix(translator): strip safety_identifier in openai-responses cleanup (#2770) (#2809)

Integrated into release/v3.8.6.

* fix(quota): honor explicit per-connection preflight opt-out (#2831) (#2844)

Integrated into release/v3.8.6.

* fix(usage): un-invert GitHub Copilot Free/limited quota — limited_user_quotas is remaining (#2876) (#2881)

Integrated into release/v3.8.6.

* fix(nous-research): correct baseUrl to include /chat/completions (#2826) (#2835)

Integrated into release/v3.8.6.

* fix(opencode): qwen3.x max/plus models lack vision support (#2822) (#2836)

Integrated into release/v3.8.6.

* fix(translator): pass-through tool_search built-in tool type (#2766) (#2811)

Integrated into release/v3.8.6.

* fix(github): route claude-opus-4.6 via chat completions (#2821)

Integrated into release/v3.8.6.

* docs(oauth): add Windsurf login fix design (Phase 1 hotfix + Phase 2 Firebase OAuth)

Two-phase plan to fix the broken Windsurf OAuth flow:
- Phase 1: drop the dead app.devin.ai/editor/signin PKCE path, promote
  import-token from windsurf.com/show-auth-token as the primary path
- Phase 2: port Firebase OAuth + RegisterUser flow from
  fendoushaonian/WindSurf-gRPC-API for full browser-based automation

Spec only - no code changes yet.

* docs(plan): Phase 1 windsurf login hotfix implementation plan

10 tasks covering:
- TDD assertions for flowType + 410 Gone responses
- Provider switch to import_token
- Route handler retiring authorize/start-callback-server/poll-callback
- OAuthModal UI override
- i18n sync
- Verification + PR steps

* fix(cli): replace cli-table3 with hand-rolled formatter (#2752) (#2813)

Integrated into release/v3.8.6.

* fix(skills): skip interception for unregistered client-native tools (#2815) (#2817)

Integrated into release/v3.8.6.

* feat(sse): add RTK filters for kubectl, docker-build, composer, gh (#2824)

Integrated into release/v3.8.6.

* fix(geminiHelper): support rec.image content shape + warn on dropped remote URLs (refs #2807) (#2855)

Integrated into release/v3.8.6.

* fix(cli): allow nullable/optional apiKey in cliMitmStartSchema (#2857)

Integrated into release/v3.8.6.

* fix(combo): preserve system messages during context handoff summary generation (#2865)

Integrated into release/v3.8.6.

* fix: wire CLIProxyAPI fallback settings into chatCore routing engine (#2866)

Integrated into release/v3.8.6.

* fix(usage): add opencode quota fetcher (#2852) (#2867)

Integrated into release/v3.8.6.

* feat(claude): default xhigh support for newer Opus models (#2874)

Integrated into release/v3.8.6.

* fix(cli): restore omniroute logs command stream (#2756) (#2810)

Integrated into release/v3.8.6.

* fix(combo): normalize upstream Headers for Node 24 undici interop (#2751) (#2823)

Integrated into release/v3.8.6.

* Rename proxy log Public IP to Client IP (#2880)

Integrated into release/v3.8.6.

* fix(claude): preserve max effort for supported models (#2875)

Integrated into release/v3.8.6.

* fix(oauth): switch windsurf provider to import_token flow

The PKCE auth URL targeting app.devin.ai/editor/signin returns 404
post-rebrand. Until Phase 2 ports Firebase OAuth + RegisterUser, the
only supported path is import-token via windsurf.com/show-auth-token.

- windsurf.ts: drop buildAuthUrl, set flowType=import_token
- generateAuthData returns supported:false + helpful error for windsurf/devin-cli
- tests: assert flowType + disabled stub

* fix(oauth): return 410 Gone for retired windsurf/devin-cli PKCE actions

start-callback-server, authorize, and poll-callback (GET + POST) now
return 410 Gone with a pointer to /import-token. The 410 short-circuit
runs before auth so the response is honest about the action being
permanently gone, not gated. Codex PKCE flow unchanged.

Tests: 5 new assertions cover GET + POST 410 paths and a Codex
regression check.

* refactor(oauth): annotate retired PKCE fields in WINDSURF_CONFIG

No behaviour change - comment-only update documenting that authorizeUrl,
codeChallengeMethod, callbackPort, callbackPath, apiServerUrl, and
exchangePath are no longer consumed. Active fields (inferenceUrl,
showAuthTokenUrl, firebaseApiKey, ideName) called out separately.

* fix(cli,docs): use requireCliToolsAuth in logs route + document OPENCODE quota env

Post-merge contract fixes for v3.8.6:
- src/app/api/cli-tools/logs/route.ts (#2810) now uses the shared
  requireCliToolsAuth guard (param renamed req->request) to satisfy the
  cli-tools-auth-hardening contract test.
- Document OMNIROUTE_OPENCODE_QUOTA_URL (#2867) in docs/reference/ENVIRONMENT.md
  to satisfy the env/docs sync contract.

* fix(dashboard): force import-token panel for windsurf/devin-cli

Phase 1 hotfix: hide the 'Browser Login' tab and start in Paste API Key
mode. Removes windsurf/devin-cli from PKCE_CALLBACK_SERVER_PROVIDERS so
no callback server is started for them. Codex still uses the PKCE flow.

The 'Get token' link continues to point at windsurf.com/show-auth-token
via the existing supportsTokenPaste form copy.

* fix(oauth): windsurf import-token mapTokens signature mismatch

The route at `src/app/api/oauth/[provider]/[action]/route.ts` invokes
`providerData.mapTokens({ accessToken: token })` (object), matching the
cursor/kiro signature. The windsurf provider was declared with
`mapTokens(token: string)` instead, so the entire object was stored as
`accessToken`. When the connection record reached the SQLite layer it
crashed with:

  SQLite3 can only bind numbers, strings, bigints, buffers, and null

Fix by aligning windsurf's `mapTokens` signature with the route caller
and the cursor/kiro convention. Also dedupe a copy-pasted second
`if (action === "import-token")` block in the route handler — the
second block was unreachable but identical to the first.

Adds two regression tests asserting that
`provider.mapTokens({ accessToken })` returns a string `accessToken` for
both windsurf and devin-cli, so a future signature drift trips the gate
instead of the SQLite bind error in production.

* feat(compression): expand pt-BR pack with troglodita rules (15 → 49) (#2818)

Integrated into release/v3.8.6

* fix(sse): repair RTK engine defaults so dedup and direct calls work (#2825)

Integrated into release/v3.8.6

* fix(mcp): redirect console.log/warn to stderr in --mcp stdio mode (#2840)

Integrated into release/v3.8.6

* fix(gemini-cli): prefer real project IDs over default-project (#2841)

Integrated into release/v3.8.6

* fix(opencode-go): add provider limits quota fetcher (#2861)

Integrated into release/v3.8.6

* Audit & add web cookie providers: fix 4 missing registry entries + DuckDuckGo (#2862)

Integrated into release/v3.8.6

* fix(antigravity): harden signatureless tool history (#2878)

Integrated into release/v3.8.6

* fix: provider model sync pruning and dynamic antigravity MITM proxy mappings (#2886)

Integrated into release/v3.8.6

* feat(usage): per-API-key token limits scoped to model/provider/global (#2888)

Integrated into release/v3.8.6

* fix(audio): build multipart body manually to preserve Content-Type (#2842)

Integrated into release/v3.8.6

* refactor: remove agent skill documentation files and streamline maintenance workflows

* test(stabilization): resolve unit test failures in blackbox-web, schema-coercion, translator-helper-branches, usage-service-hardening, and audio-transcription

* fix(security): mitigate Socket.dev supply-chain findings + secrets opt-in + minimal build profile (#2863) (#2871)

Two real security gaps closed and four cosmetic Socket.dev fingerprints removed.
See docs/security/SOCKET_DEV_FINDINGS.md for the per-finding maintainer
attestation.

Real bugs fixed:
- cloudSync: HMAC verification of `X-Cloud-Sig` + opt-in
  `OMNIROUTE_CLOUD_SYNC_SECRETS=true` before overwriting `accessToken` /
  `refreshToken` / `providerSpecificData` from a remote response. Closes the
  silent-credential-swap surface (a misconfigured or hostile CLOUD_URL could
  previously replace local tokens unverified).
- Zed import: split into 2-step `/discover` + `/import` flow. `/import` now
  requires `confirmedAccounts: [{ service, account, fingerprint }]` and
  re-reads the keychain server-side to filter by fingerprint, so a tampered
  discover response cannot trick the endpoint into saving an unrelated token.

Cosmetic Socket.dev mitigations:
- runElevatedPowerShell writes the elevated payload to a per-call temp `.ps1`
  file (mode 0o600) and references it via `-File`. Removes the textbook
  `-EncodedCommand <base64utf16le>` pattern flagged as malware by Socket's AI
  classifier.
- Maintainer attestation `SECURITY-AUDITOR-NOTE:` blocks added at every
  flagged call site pointing to `docs/security/SOCKET_DEV_FINDINGS.md`.

Build-time hardening:
- `OMNIROUTE_BUILD_PROFILE=minimal` (`npm run build:secure`) physically
  removes the four sensitive modules from the standalone bundle via webpack
  `NormalModuleReplacementPlugin`. Stubs throw `FeatureDisabledError` at
  runtime. Intended for the `omniroute-secure` artifact.

Tests:
- 24 new unit tests in `tests/unit/security/` covering the wrapper builder,
  HMAC verification (4 cases), credential fingerprint determinism (5 cases),
  confirmedAccounts validation + fingerprint filtering (6 cases), and the
  minimal-build stubs (5 cases).

Docs:
- New `docs/security/SOCKET_DEV_FINDINGS.md` — per-finding attestation.
- New `socket.yml` — Socket.dev v2 config pointing at the attestation.
- Updated `SECURITY.md` — supply-chain scanner section.
- Updated `.env.example` — three new env vars documented.

Backwards compatibility:
- Cloud sync token overwrite is OFF by default. Users who relied on
  it must set `OMNIROUTE_CLOUD_SYNC_SECRETS=true`. Breaking change documented
  in CHANGELOG.
- Zed import 2-step is the new default; legacy 1-step preserved behind
  `OMNIROUTE_ZED_IMPORT_LEGACY_ONE_STEP=true` and will be removed in v3.9.

Closes #2863

* fix(security): redact public Firebase Web key from windsurf spec; doc SHA-256 cache-key rationale (#2894)

Two security-scanning findings on release/v3.8.6:

- Secret-scanning alert 7 (google_api_key): the windsurf login-fix design spec
  embedded the literal public Firebase Web API key on two lines. Firebase Web
  API keys are non-sensitive by design (they identify the project; access is
  gated by Firebase Security Rules + key restrictions), but the literal trips
  secret scanning. Redacted to a placeholder; the embedded default still goes
  through resolvePublicCred per rule #11.

- Code-scanning alert 261 (js/insufficient-password-hash): tokenCacheKey() uses
  SHA-256 to derive an in-memory cache key from the session token, not for
  password-at-rest storage. Added a comment documenting why CWE-916 KDFs do not
  apply (false positive).

* fix(ci): resolve release/v3.8.6 gate failures (docs-sync, any-budget, pack-artifact) (#2895)

* fix(ci): resolve release/v3.8.6 gate failures (docs-sync, any-budget, pack-artifact)

Three CI gates failed on release/v3.8.6 (run 26630300877):

- docs-sync: CHANGELOG had a spurious "## [3.8.6-patch]" section above
  "## [3.8.6]", so the latest release no longer matched package.json (3.8.6)
  and the 41 i18n CHANGELOG mirrors were flagged as missing that section.
  Fold the lone #2752 entry into [3.8.6] and drop the patch heading.
- any-budget:t11: open-sse/handlers/chatCore.ts regressed to 1 explicit `any`
  (budget 0). Type the persist callback arg as Record<string, unknown>, which
  matches runWithOnPersist's RefreshPersistFn contract exactly.
- pack-artifact: open-sse/utils/setupPolyfill.ts ships via package.json "files"
  (bin/omniroute.mjs imports it at startup) but was missing from the pack
  policy allowlist. Allow it and add a regression test.

* fix(security): redact public Firebase Web key from windsurf spec

Redact the literal public Firebase Web API key (secret-scanning #7) to a
placeholder, mirroring the redaction on release/v3.8.6 (PR #2894) and the
windsurf fix branch. Non-sensitive public Web key; trips secret scanning.

* feat(combo): Zero-Latency Combos (Hedging, Proactive Compression, Predictive TTFT) (#2868)

* feat(combo): implement zero-latency combo optimizations (hedging, proactive compression, predictive TTFT)

* fix(combo): fix predictive TTFT skip logic and unhandled promise rejections

---------

Co-authored-by: Automation <automation@omniroute>

* feat: implement automated skill workflows and update system configuration and validation schemas

* test: eliminate dynamic cast warnings in cloud-sync unit test

* test: isolate services-branch-hardening database directory to avoid concurrency issues

* feat(providers): add 7 new web-cookie providers + research catalog + discovery tool

New providers:
- huggingchat: free LLM chat via huggingface.co/chat (no subscription)
- phind: free dev-focused AI chat via phind.com/api/agent
- poe-web: multi-model chat via poe.com GraphQL (p-b cookie)
- venice-web: privacy-focused AI chat via venice.ai (session cookie)
- v0-vercel-web: Vercel v0 code gen via v0.dev (session cookie)
- kimi-web: Moonshot Kimi chat via kimi.moonshot.cn (session cookie)
- doubao-web: ByteDance Doubao chat via doubao.com (session cookie)

Additional:
- Research catalog: docs/research/UNLIMITED_LLM_ACCESS.md
- Discovery tool design + stub: src/lib/discovery/ + migration 073
- Unit tests: 33 tests for all 7 providers
- Shared helpers consolidated in error.ts (slop cleanup)
- All registered in WEB_COOKIE_PROVIDERS + providerRegistry + webSessionCredentials

Closes #2885

* fix(typecheck): resolve typecheck errors in combo spec and compression modules

* feat(api,oauth): add `agy` (Antigravity CLI) standalone provider with CLI token import (#2899)

Add a standalone OAuth provider `agy` (Antigravity CLI) next to gemini-cli/antigravity.
It reuses the antigravity inference backend (identical Google client_id +
daily-cloudcode-pa.googleapis.com endpoint, executor and token-refresh) but ships its own
model catalog — including the Claude models the backend exposes (claude-opus-4-6-thinking,
claude-sonnet-4-6) — its own account pool, and four ways to connect:

- token-file import (paste/upload the agy oauth token JSON)
- auto-detect a local CLI login (~/.gemini/antigravity-cli/antigravity-oauth-token)
- browser OAuth (via the shared OAuthModal Google loopback flow)
- bulk / ZIP import

New routes: POST /api/providers/agy-auth/{import,import-bulk,zip-extract,apply-local}.
Catalog pinned from the live :fetchAvailableModels endpoint. Docs (openapi.yaml,
ENVIRONMENT.md, .env.example, CHANGELOG) updated; new unit tests for registration,
the token parser, and route auth-hardening.

* fix(security): redact public Firebase Web key from windsurf spec (#2896)

Redact the literal public Firebase Web API key (secret-scanning #7) to a
placeholder. Firebase Web API keys are non-sensitive by design but the literal
trips GitHub secret scanning. Mirrors the redaction landed on release/v3.8.6
(PR #2894). Embedded default still flows through resolvePublicCred (rule #11).

* Pr 2871 (#2897)

* fix(security): mitigate Socket.dev supply-chain findings + secrets opt-in + minimal build profile (#2863)

Two real security gaps closed and four cosmetic Socket.dev fingerprints removed.
See docs/security/SOCKET_DEV_FINDINGS.md for the per-finding maintainer
attestation.

Real bugs fixed:
- cloudSync: HMAC verification of `X-Cloud-Sig` + opt-in
  `OMNIROUTE_CLOUD_SYNC_SECRETS=true` before overwriting `accessToken` /
  `refreshToken` / `providerSpecificData` from a remote response. Closes the
  silent-credential-swap surface (a misconfigured or hostile CLOUD_URL could
  previously replace local tokens unverified).
- Zed import: split into 2-step `/discover` + `/import` flow. `/import` now
  requires `confirmedAccounts: [{ service, account, fingerprint }]` and
  re-reads the keychain server-side to filter by fingerprint, so a tampered
  discover response cannot trick the endpoint into saving an unrelated token.

Cosmetic Socket.dev mitigations:
- runElevatedPowerShell writes the elevated payload to a per-call temp `.ps1`
  file (mode 0o600) and references it via `-File`. Removes the textbook
  `-EncodedCommand <base64utf16le>` pattern flagged as malware by Socket's AI
  classifier.
- Maintainer attestation `SECURITY-AUDITOR-NOTE:` blocks added at every
  flagged call site pointing to `docs/security/SOCKET_DEV_FINDINGS.md`.

Build-time hardening:
- `OMNIROUTE_BUILD_PROFILE=minimal` (`npm run build:secure`) physically
  removes the four sensitive modules from the standalone bundle via webpack
  `NormalModuleReplacementPlugin`. Stubs throw `FeatureDisabledError` at
  runtime. Intended for the `omniroute-secure` artifact.

Tests:
- 24 new unit tests in `tests/unit/security/` covering the wrapper builder,
  HMAC verification (4 cases), credential fingerprint determinism (5 cases),
  confirmedAccounts validation + fingerprint filtering (6 cases), and the
  minimal-build stubs (5 cases).

Docs:
- New `docs/security/SOCKET_DEV_FINDINGS.md` — per-finding attestation.
- New `socket.yml` — Socket.dev v2 config pointing at the attestation.
- Updated `SECURITY.md` — supply-chain scanner section.
- Updated `.env.example` — three new env vars documented.

Backwards compatibility:
- Cloud sync token overwrite is OFF by default. Users who relied on
  it must set `OMNIROUTE_CLOUD_SYNC_SECRETS=true`. Breaking change documented
  in CHANGELOG.
- Zed import 2-step is the new default; legacy 1-step preserved behind
  `OMNIROUTE_ZED_IMPORT_LEGACY_ONE_STEP=true` and will be removed in v3.9.

Closes #2863

* feat: implement automated skill workflows and update system configuration and validation schemas

* test: eliminate dynamic cast warnings in cloud-sync unit test

* test: isolate services-branch-hardening database directory to avoid concurrency issues

* chore(docs): refresh generated docs collection index

Update the generated Fumadocs browser collection mapping to keep
documentation imports in sync with the current docs structure.

* docs: update generated browser docs collection manifest

Refresh the generated Fumadocs browser collection mapping so the docs site can resolve the current documentation files correctly.

---------

Co-authored-by: OpenClaw <openclaw@kuzhomesrv.local>
Co-authored-by: Dmitry Kuznetsov <139351986+dmitry@users.noreply.local>
Co-authored-by: KuzyaBot <kuzya@local>
Co-authored-by: JeferssonLemes <jeferssondev@gmail.com>
Co-authored-by: Paijo <14921983+oyi77@users.noreply.github.com>
Co-authored-by: Markus Hartung <mail@hartmark.se>
Co-authored-by: akarray <akarray@users.noreply.github.com>
Co-authored-by: Apostol Apostolov <theapoapostolov@gmail.com>
Co-authored-by: Hernan Javier Ardila Sanchez <hjasgr@gmail.com>
Co-authored-by: Dmitry Kuznetsov <dmitry@kuznetsov.me>
Co-authored-by: Nikolay Alafuzov <alafuzov_nn@rusklimat.ru>
Co-authored-by: oyi77 <oyi77@users.noreply.github.com>
Co-authored-by: Ronaldo Davi <alltomatos@users.noreply.github.com>
Co-authored-by: levonk <277861+levonk@users.noreply.github.com>
Co-authored-by: Lenine Júnior <lenine@engrene.com.br>
Co-authored-by: Annas Alghoffar <aag.annas@gmail.com>
Co-authored-by: Tushar Agarwal <76201310+Tushar49@users.noreply.github.com>
Co-authored-by: GreatLiu <eurasiaxz@qq.com>
Co-authored-by: yuna amelia <230527278+yunaamelia@users.noreply.github.com>
Co-authored-by: Randi <55005611+rdself@users.noreply.github.com>
Co-authored-by: Container <78986709+disonjer@users.noreply.github.com>
Co-authored-by: nickwizard <35692452+nickwizard@users.noreply.github.com>
Co-authored-by: Rajvardhan Patil <rajvardhanpatil7890@gmail.com>
Co-authored-by: Raxxoor <manker_lol@hotmail.com>
Co-authored-by: Muhammad Mugni Hadi <mugnimaestra3@gmail.com>
Co-authored-by: mi <123757457+soyelmismo@users.noreply.github.com>
Co-authored-by: Automation <automation@omniroute>
2026-05-29 12:44:29 -03:00

26 KiB

CLAUDE.md (Svenska)

🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇪🇸 es · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇳 gu · 🇮🇱 he · 🇮🇳 hi · 🇭🇺 hu · 🇮🇩 id · 🇮🇩 in · 🇮🇹 it · 🇯🇵 ja · 🇰🇷 ko · 🇮🇳 mr · 🇲🇾 ms · 🇳🇱 nl · 🇳🇴 no · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇸🇰 sk · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇻🇳 vi · 🇨🇳 zh-CN


Denna fil ger vägledning till Claude Code (claude.ai/code) när man arbetar med kod i detta repository.

Snabbstart

npm install                    # Installera beroenden (auto-genererar .env från .env.example)
npm run dev                    # Utvecklingsserver på http://localhost:20128
npm run build                  # Produktionsbyggnad (Next.js 16 fristående)
npm run lint                   # ESLint (0 fel förväntas; varningar är förhandsbefintliga)
npm run typecheck:core         # TypeScript-kontroll (ska vara ren)
npm run typecheck:noimplicit:core  # Strikt kontroll (inga implicita any)
npm run test:coverage          # Enhetstester + täckningsgräns (75/75/75/70 — satser/rader/funktioner/grenar)
npm run check                  # lint + test kombinerat
npm run check:cycles           # Upptäck cirkulära beroenden

Köra Tester

# Enstaka testfil (Node.js inbyggda testköraren — de flesta tester)
node --import tsx/esm --test tests/unit/your-file.test.ts

# Vitest (MCP-server, autoCombo, cache)
npm run test:vitest

# Alla sviter
npm run test:all

För full testmatris, se CONTRIBUTING.md → "Köra Tester". För djup arkitektur, se AGENTS.md.


Projekt i Korthet

OmniRoute — enad AI-proxy/router. En slutpunkt, 160+ LLM-leverantörer, automatisk återkoppling.

Lager Plats Syfte
API-rutter src/app/api/v1/ Next.js App Router — ingångspunkter
Handlers open-sse/handlers/ Begärningsbehandling (chatt, inbäddningar, etc)
Executors open-sse/executors/ Leverantörsspecifik HTTP-dispatch
Translators open-sse/translator/ Formatkonvertering (OpenAI↔Claude↔Gemini)
Transformer open-sse/transformer/ Svar API ↔ Chattkompletteringar
Tjänster open-sse/services/ Kombinationsrouting, hastighetsgränser, caching, etc
Databas src/lib/db/ SQLite domänmoduler (45+ filer, 55 migrationer)
Domän/Policy src/domain/ Policy-motor, kostnadsregler, återkopplingslogik
MCP-server open-sse/mcp-server/ 37 verktyg (30 bas + 3 minne + 4 färdigheter), 3 transporter, ~13 områden
A2A-server src/lib/a2a/ JSON-RPC 2.0 agentprotokoll
Färdigheter src/lib/skills/ Utbyggbar färdighetsramverk
Minne src/lib/memory/ Persistent konversationsminne

Monorepo: src/ (Next.js 16-app), open-sse/ (streaming engine arbetsyta), electron/ (skrivbordsapp), tests/, bin/ (CLI-ingångspunkt).


Begärningspipeline

Klient → /v1/chat/completions (Next.js-rutt)
  → CORS → Zod-validering → autentisering? → policykontroll → skydd mot promptinjektion
  → handleChatCore() [open-sse/handlers/chatCore.ts]
    → cachekontroll → hastighetsbegränsning → kombinationsrouting?
      → resolveComboTargets() → handleSingleModel() per mål
    → translateRequest() → getExecutor() → executor.execute()
      → fetch() upstream → retry w/ backoff
    → svaröversättning → SSE-ström eller JSON
    → Om Responses API: responsesTransformer.ts TransformStream

API-rutter följer ett konsekvent mönster: Rutt → CORS preflight → Zod kroppvalidering → Valfri autentisering (extractApiKey/isValidApiKey) → Tillämpning av API-nyckelpolicy → Hanterardelning (open-sse). Ingen global Next.js-mellanprogram — avlyssning är rutt-specifik.

Kombinationsrouting (open-sse/services/combo.ts): 14 strategier (prioritet, viktad, fyll-först, rund-robin, P2C, slumpmässig, minst-använd, kostnadsoptimerad, reset-medveten, strikt-slumpmässig, auto, lkgp, kontext-optimerad, kontext-relä). Varje mål anropar handleSingleModel() som omsluter handleChatCore() med felhantering per mål och kretsbrytarkontroller. Se docs/routing/AUTO-COMBO.md för 9-faktors Auto-Combo poängsättning och docs/architecture/RESILIENCE_GUIDE.md för de 3 motståndslager.


Motstånds Runtime-tillstånd

OmniRoute har tre relaterade men distinkta mekanismer för tillfälliga fel. Håll deras omfång separerat när du felsöker routingbeteende. Se 3-lagers motståndsdiagram (källa: docs/diagrams/resilience-3layers.mmd) för en översiktlig karta.

Leverantörs Kretsbrytare

Omfång: hela leverantören, t.ex. glm, openai, anthropic.

Syfte: stoppa trafiken till en leverantör som upprepade gånger misslyckas på upstream/tjänstenivå, så att en ohälsosam leverantör inte saktar ner varje begäran.

Implementering:

  • Kärnklass: src/shared/utils/circuitBreaker.ts
  • Chatport/görande koppling: src/sse/handlers/chatHelpers.ts, src/sse/handlers/chat.ts
  • Runtime-status API: src/app/api/monitoring/health/route.ts
  • Delade omslag: open-sse/services/accountFallback.ts
  • Persistenta tillståndstabell: domain_circuit_breakers

Tillstånd:

  • CLOSED: normal trafik är tillåten.
  • OPEN: leverantören är tillfälligt blockerad; anroparna får ett provider-circuit-open-svar eller kombinationsrouting hoppar till ett annat mål.
  • HALF_OPEN: återställningstidsgränsen har löpt ut; tillåt en provbegäran. Framgång stänger brytaren, misslyckande öppnar den igen.

Standarder (open-sse/config/constants.ts):

  • OAuth-leverantörer: tröskel 3, återställningstidsgräns 60s.
  • API-nyckelleverantörer: tröskel 5, återställningstidsgräns 30s.
  • Lokala leverantörer: tröskel 2, återställningstidsgräns 15s.

Endast leverantörsnivåfelstatusar bör utlösa leverantörsbrytaren:

(408, 500, 502, 503, 504);

Utlösa inte hela leverantörsbrytaren för normala konto/nyckel/modellfel som de flesta 401, 403, eller 429 fallen. Dessa tillhör vanligtvis anslutningskylning eller modell låsningsproblem. En generell API-nyckelleverantör 403 bör vara återställbar om den inte klassificeras som ett terminalt leverantörs-/konto-fel.

Brytaren använder lat återhämtning, inte en bakgrundstimer. När OPEN löper ut, läser sådana som getStatus(), canExecute(), och getRetryAfterMs() uppdaterar tillståndet till HALF_OPEN, så att instrumentpaneler och kombinationskandidatsbyggare inte fortsätter att utesluta en utgången leverantör för alltid.

Anslutningskylning

Omfång: en leverantörsanslutning/konto/nyckel.

Syfte: tillfälligt hoppa över en dålig nyckel/konto medan andra anslutningar för samma leverantör kan fortsätta att betjäna begärningar.

Implementering:

  • Skriv/uppdatera väg: src/sse/services/auth.ts::markAccountUnavailable()
  • Kontoval/filtrering: src/sse/services/auth.ts::getProviderCredentials...
  • Kylberäkning: open-sse/services/accountFallback.ts::checkFallbackError()
  • Inställningar: src/lib/resilience/settings.ts

Viktiga fält på leverantörsanslutningar:

rateLimitedUntil;
testStatus: "unavailable";
lastError;
lastErrorType;
errorCode;
backoffLevel;

Under kontovalet, hoppar en anslutning över medan:

new Date(rateLimitedUntil).getTime() > Date.now();

Kylningar är också lata: när rateLimitedUntil är i det förflutna, blir anslutningen berättigad igen. Vid framgångsrik användning, clearAccountError() rensar testStatus, rateLimitedUntil, felfält och backoffLevel.

Standardbeteende för anslutningskylning:

  • OAuth grundkylning: 5s.
  • API-nyckel grundkylning: 3s.
  • API-nyckel 429 bör föredra upstream retry-hints (Retry-After, återställningshuvuden, eller parsbar återställningstext) när det är tillgängligt.
  • Upprepade återställbara fel använder exponentiell backoff:
baseCooldownMs * 2 ** failureIndex;

Anti-thundering-herd-skyddet förhindrar samtidiga fel på samma anslutning från upprepade gånger förlänga kylningen eller dubbelt öka backoffLevel.

Terminala tillstånd är inte kylningar. banned, expired, och credits_exhausted är avsedda att förbli otillgängliga tills autentiseringsuppgifter/inställningar ändras eller en operatör återställer dem. Överskriv inte terminala tillstånd med tillfälligt kylningstillstånd.

Modellåsningsproblem

Omfång: leverantör + anslutning + modell.

Syfte: undvika att inaktivera en hel anslutning när endast en modell är otillgänglig eller kvotbegränsad för den anslutningen.

Exempel:

  • Per-modell kvotleverantörer som returnerar 429.
  • Lokala leverantörer som returnerar 404 för en saknad modell.
  • Leverantörsspecifika läge/modellbehörighetsfel som valda Grok-lägen.

Modellåsningsproblem finns i open-sse/services/accountFallback.ts och låter samma anslutning fortsätta betjäna andra modeller.

Felsökningsvägledning

  • Om alla nycklar för en leverantör hoppar över, inspektera både leverantörsbrytarens tillstånd och varje anslutnings rateLimitedUntil/testStatus.
  • Om en leverantör verkar permanent utesluten efter återställningsfönstret, kontrollera om koden läser rå state istället för att använda getStatus()/canExecute().
  • Om en leverantörsnyckel misslyckas men andra bör fungera, föredra anslutningskylning över leverantörsbrytaren.
  • Om endast en modell misslyckas, föredra modellåsningsproblem över anslutningskylning.
  • Om ett tillstånd bör självåterhämta sig, bör det ha en framtida tidsstämpel/återställningstidsgräns och en läsväg som uppdaterar utgångna tillstånd. Permanenta statusar kräver manuella autentiserings- eller konfigurationsändringar.

Nyckelkonventioner

Kodstil

  • 2 mellanslag, semikolon, dubbla citattecken, 100 tecken bredd, es5 avslutande komman (tvingas av lint-staged via Prettier)
  • Importeringar: extern → intern (@/, @omniroute/open-sse) → relativ
  • Namngivning: filer=camelCase/kebab, komponenter=PascalCase, konstanter=UPPER_SNAKE
  • ESLint: no-eval, no-implied-eval, no-new-func = fel överallt; no-explicit-any = varna i open-sse/ och tests/
  • TypeScript: strict: false, mål ES2022, modul esnext, upplösning bundlare. Föredra explicita typer.

Databas

  • Gå alltid igenom src/lib/db/ domänmoduler — skriv aldrig rå SQL i rutter eller hanterare
  • Lägg aldrig till logik i src/lib/localDb.ts (endast re-exporteringslager)
  • Lägg aldrig barrel-import från localDb.ts — importera specifika db/ moduler istället
  • DB singleton: getDbInstance() från src/lib/db/core.ts (WAL journaling)
  • Migrationer: src/lib/db/migrations/ — versionerade SQL-filer, idempotenta, körs i transaktioner

Felhantering

  • try/catch med specifika feltyper, logga med pino-kontext
  • Svälj aldrig fel i SSE-strömmar — använd avbryt-signaler för städning
  • Återvänd korrekta HTTP-statuskoder (4xx/5xx)

Säkerhet

  • Använd aldrig eval(), new Function(), eller implicit eval
  • Validera alla indata med Zod-scheman
  • Kryptera autentiseringsuppgifter i vila (AES-256-GCM)
  • Upstream header denylist: src/shared/constants/upstreamHeaders.ts — håll sanera, Zod-scheman och enhetstester i linje vid redigering
  • Offentliga upstream-autentiseringsuppgifter (Gemini/Antigravity/Windsurf-stil OAuth client_id/secret + Firebase Web-nycklar extraherade från offentliga CLI:er): MÅSTE inbäddas via resolvePublicCred() från open-sse/utils/publicCreds.tsaldrig som strängliteral. Se docs/security/PUBLIC_CREDS.md för det obligatoriska mönstret.
  • Felrespons (HTTP / SSE / exekutor / MCP-hanterare): MÅSTE routas genom buildErrorBody() eller sanitizeErrorMessage() från open-sse/utils/error.tsaldrig sätt rå err.stack eller err.message i en responskropp. Se docs/security/ERROR_SANITIZATION.md.
  • Shell-kommandon byggda från variabler: när du anropar exec()/spawn() med ett skript som behöver runtime-värden, skicka dem via env-alternativet (shell-escapade automatiskt) — aldrig sträng-interpolera otillförlitliga/externa sökvägar i skriptkroppen. Referens: src/mitm/cert/install.ts::updateNssDatabases.
  • Säkra som standard-bibliotek (tldrsec/awesome-secure-defaults): föredra Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink framför anpassade implementationer när du lägger till nya säkerhetskänsliga ytor.

Vanliga modifieringsscenarier

Lägga till en ny leverantör

  1. Registrera i src/shared/constants/providers.ts (Zod-validerad vid laddning)
  2. Lägg till exekutor i open-sse/executors/ om anpassad logik behövs (utöka BaseExecutor)
  3. Lägg till översättare i open-sse/translator/ om icke-OpenAI-format
  4. Lägg till OAuth-konfiguration i src/lib/oauth/constants/oauth.ts om OAuth-baserad — om upstream CLI skickar en offentlig client_id/secret, inbädda via resolvePublicCred() (se docs/security/PUBLIC_CREDS.md), aldrig som en literal
  5. Registrera modeller i open-sse/config/providerRegistry.ts
  6. Skriv tester i tests/unit/ (inkludera den publicCreds-formen om du har lagt till en ny inbäddad standard)

Lägga till en ny API-rutt

  1. Skapa katalog under src/app/api/v1/your-route/
  2. Skapa route.ts med GET/POST hanterare
  3. Följ mönster: CORS → Zod kroppvalidering → valfri autentisering → hanterardelning
  4. Hanteraren går i open-sse/handlers/ (importera därifrån, inte inline)
  5. Felrespons använder buildErrorBody() / errorResponse() från open-sse/utils/error.ts (auto-sanitized — sätt aldrig err.stack eller err.message rått i kroppen). Se docs/security/ERROR_SANITIZATION.md.
  6. Lägg till tester — inklusive minst en bekräftelse på att felrespons inte läcker stackspår (!body.error.message.includes("at /"))

Lägga till en ny DB-modul

  1. Skapa src/lib/db/yourModule.ts — importera getDbInstance från ./core.ts
  2. Exportera CRUD-funktioner för din domäntabell(er)
  3. Lägg till migration i src/lib/db/migrations/ om nya tabeller behövs
  4. Re-exportera från src/lib/localDb.ts (lägg till i re-exportlistan endast)
  5. Skriv tester

Lägga till ett nytt MCP-verktyg

  1. Lägg till verktygsdefinition i open-sse/mcp-server/tools/ med Zod indata-schema + asynkron hanterare
  2. Registrera i verktygsuppsättningen (kopplad av createMcpServer())
  3. Tilldela till lämpliga omfattningar
  4. Skriv tester (verktygsanrop loggas till mcp_audit-tabellen)

Lägga till en ny A2A-färdighet

  1. Skapa färdighet i src/lib/a2a/skills/ (5 finns redan: smart-routing, quota-management, provider-discovery, cost-analysis, health-report)
  2. Färdigheten får uppgiftskontext (meddelanden, metadata) → returnerar strukturerat resultat
  3. Registrera i A2A_SKILL_HANDLERS i src/lib/a2a/taskExecution.ts
  4. Exponera i src/app/.well-known/agent.json/route.ts (Agent Card)
  5. Skriv tester i tests/unit/
  6. Dokumentera i docs/frameworks/A2A-SERVER.md färdighets-tabellen

Lägga till en ny molnagent

  1. Skapa agentklass i src/lib/cloudAgent/agents/ som utökar CloudAgentBase (3 finns redan: codex-cloud, devin, jules)
  2. Implementera createTask, getStatus, approvePlan, sendMessage, listSources
  3. Registrera i src/lib/cloudAgent/registry.ts
  4. Lägg till OAuth/autentiseringshantering om det behövs (src/lib/oauth/providers/)
  5. Tester + dokumentera i docs/frameworks/CLOUD_AGENT.md

Lägga till en ny guardrail / eval / färdighet / webhook-händelse

  • Guardrail: src/lib/guardrails/ → docs: docs/security/GUARDRAILS.md
  • Eval suite: src/lib/evals/ → docs: docs/frameworks/EVALS.md
  • Färdighet (sandbox): src/lib/skills/ → docs: docs/frameworks/SKILLS.md
  • Webhook-händelse: src/lib/webhookDispatcher.ts → docs: docs/frameworks/WEBHOOKS.md

Referensdokumentation

För alla icke-triviala ändringar, läs den matchande djupdykningen först:

Område Dokument
Repo-navigering docs/architecture/REPOSITORY_MAP.md
Arkitektur docs/architecture/ARCHITECTURE.md
Ingenjörsreferens docs/architecture/CODEBASE_DOCUMENTATION.md
Auto-Combo (9-faktors poängsättning, 14 strategier) docs/routing/AUTO-COMBO.md
Motståndskraft (3 mekanismer) docs/architecture/RESILIENCE_GUIDE.md
Resonansåterspel docs/routing/REASONING_REPLAY.md
Kompetensramverk docs/frameworks/SKILLS.md
Minnessystem (FTS5 + Qdrant) docs/frameworks/MEMORY.md
Molnagenter docs/frameworks/CLOUD_AGENT.md
Skyddsräcken (PII / injektion / vision) docs/security/GUARDRAILS.md
Offentliga uppströmsreferenser (Gemini/etc.) docs/security/PUBLIC_CREDS.md
Sanitering av felmeddelanden docs/security/ERROR_SANITIZATION.md
Utvärderingar docs/frameworks/EVALS.md
Efterlevnad / revision docs/security/COMPLIANCE.md
Webhooks docs/frameworks/WEBHOOKS.md
Auktoriseringspipeline docs/architecture/AUTHZ_GUIDE.md
Stealth (TLS / fingeravtryck) docs/security/STEALTH_GUIDE.md
Agentprotokoll (A2A / ACP / Moln) docs/frameworks/AGENT_PROTOCOLS_GUIDE.md
MCP-server docs/frameworks/MCP-SERVER.md
A2A-server docs/frameworks/A2A-SERVER.md
API-referens + OpenAPI docs/reference/API_REFERENCE.md + docs/reference/openapi.yaml
Leverantörskatalog (automatiskt genererad) docs/reference/PROVIDER_REFERENCE.md
Utgivningsflöde docs/ops/RELEASE_CHECKLIST.md

Testning

Vad Kommando
Enhetstester npm run test:unit
Enskild fil node --import tsx/esm --test tests/unit/file.test.ts
Vitest (MCP, autoCombo) npm run test:vitest
E2E (Playwright) npm run test:e2e
Protokoll E2E (MCP+A2A) npm run test:protocols:e2e
Ekosystem npm run test:ecosystem
Täckningsgräns npm run test:coverage (75/75/75/70 — uttalanden/rader/funktioner/grenar)
Täckningsrapport npm run coverage:report

PR-regel: Om du ändrar produktionskod i src/, open-sse/, electron/ eller bin/, måste du inkludera eller uppdatera tester i samma PR.

Testlagerpreferens: enhet först → integration (multi-modul eller DB-tillstånd) → e2e (UI/arbetsflöde endast). Koda buggreproduktioner som automatiserade tester före eller tillsammans med fixen.

Copilot täckningspolicy: När en PR ändrar produktionskod och täckningen är under 75% (uttalanden/rader/funktioner) eller 70% (grenar), rapportera inte bara — lägg till eller uppdatera tester, kör täckningsgränsen igen, och be sedan om bekräftelse. Inkludera körda kommandon, ändrade testfiler och slutlig täckningsresultat i PR-rapporten.


Git Arbetsflöde

# Kom aldrig direkt till main
git checkout -b feat/your-feature
git commit -m "feat: beskriv din ändring"
git push -u origin feat/your-feature

Grenprefix: feat/, fix/, refactor/, docs/, test/, chore/

Commitformat (Conventional Commits): feat(db): lägg till kretsbrytare — områden: db, sse, oauth, dashboard, api, cli, docker, ci, mcp, a2a, memory, skills

Husky hooks:

  • pre-commit: lint-staged + check-docs-sync + check:any-budget:t11
  • pre-push: npm run test:unit

Miljö

  • Körning: Node.js ≥20.20.2 <21 || ≥22.22.2 <23 || ≥24 <25, ES-moduler
  • TypeScript: 5.9+, mål ES2022, modul esnext, upplösning bundler
  • Sökvägsalias: @/*src/, @omniroute/open-sseopen-sse/, @omniroute/open-sse/*open-sse/*
  • Standardport: 20128 (API + dashboard på samma port)
  • Data katalog: DATA_DIR miljövariabel, standard till ~/.omniroute/
  • Nyckel miljövariabler: PORT, JWT_SECRET, API_KEY_SECRET, INITIAL_PASSWORD, REQUIRE_API_KEY, APP_LOG_LEVEL
  • Setup: cp .env.example .env och generera JWT_SECRET (openssl rand -base64 48) och API_KEY_SECRET (openssl rand -hex 32)

Hårda Regler

  1. Kom aldrig med hemligheter eller referenser
  2. Lägg aldrig till logik i localDb.ts
  3. Använd aldrig eval() / new Function() / underförstådd eval
  4. Kom aldrig direkt till main
  5. Skriv aldrig rå SQL i rutter — använd src/lib/db/ moduler
  6. Tysta aldrig fel i SSE-strömmar
  7. Validera alltid indata med Zod-scheman
  8. Inkludera alltid tester när du ändrar produktionskod
  9. Täckningen måste förbli ≥75% (uttalanden, rader, funktioner) / ≥70% (grenar). Nuvarande mätt: ~82%.
  10. Omgå aldrig Husky hooks (--no-verify, --no-gpg-sign) utan uttryckligt godkännande från operatören.
  11. Inkludera aldrig offentliga upstream OAuth client_id/secret eller Firebase Web-nycklar som stränglitteraler — gå alltid genom resolvePublicCred() (open-sse/utils/publicCreds.ts). Se docs/security/PUBLIC_CREDS.md.
  12. Återvänd aldrig rå err.stack / err.message i HTTP / SSE / executor-svar — routa alltid genom buildErrorBody() eller sanitizeErrorMessage() (open-sse/utils/error.ts). Se docs/security/ERROR_SANITIZATION.md.
  13. Stränginterpolera aldrig externa sökvägar eller körvärden i shell-skript som skickas till exec()/spawn() — passera istället via env-alternativet. Referens: src/mitm/cert/install.ts::updateNssDatabases.
  14. Avfärda aldrig en CodeQL / Secret-Scanning-varning utan (a) att först kontrollera mönster-dokumentationen ovan för att se om hjälpen gäller, och (b) dokumentera den tekniska motiveringen i avfärdningskommentaren. Precedens: js/stack-trace-exposure som väckts på anropställen som redan routar genom sanitizeErrorMessage() är en känd CodeQL-begränsning (anpassade saniterare erkänns inte) — avfärda som false positive med hänvisning till docs/security/ERROR_SANITIZATION.md.
  15. Exponera aldrig rutter som skapar barnprocesser (/api/mcp/, /api/cli-tools/runtime/) utan isLocalOnlyPath() klassificering i src/server/authz/routeGuard.ts. Loopback-tillämpning sker ovillkorligt före någon autentisering — läckta JWT via tunnel kan inte utlösa processskapande. Se docs/security/ROUTE_GUARD_TIERS.md.
  16. Inkludera aldrig Co-Authored-By-trailers som krediterar en AI-assistent, LLM eller automatiseringskonto (t.ex. namn som innehåller "Claude", "GPT", "Copilot", "Bot"; e-postmeddelanden på anthropic.com / openai.com / bot-ägda noreply.github.com-adresser). Sådana trailers dirigerar commit-attribution till bot-kontot på GitHub, vilket döljer den verkliga författaren (diegosouzapw) i PR-historiken. Mänskliga medarbetare — inklusive upstream PR-författare och issue-rapporterare som portas till OmniRoute — KAN och BÖR krediteras med standard Co-authored-by: Name <email>-trailers; upstream-port arbetsflöden (/port-upstream-features, /port-upstream-issues) beror på detta.