Skip to content
Merged
Show file tree
Hide file tree
Changes from 26 commits
Commits
Show all changes
162 commits
Select commit Hold shift + click to select a range
39349da
fix(install): add pnpm-workspace.yaml allowBuilds + pnpm.json for pnp…
chirag127 Jul 2, 2026
be420af
chore(release): open v3.8.44 development cycle
diegosouzapw Jul 2, 2026
dfbc89f
test(security): parse Kimi Web URL host instead of substring match (C…
diegosouzapw Jul 2, 2026
2e75ed2
refactor(translator): extract thinking-budget fitting from openai-to-…
diegosouzapw Jul 2, 2026
a8d1e7b
chore(release): pipeline hardening — test-masking pre-flight gate + c…
diegosouzapw Jul 2, 2026
0d6add1
refactor(translator): split openai-responses request translator into …
diegosouzapw Jul 2, 2026
16ccd5f
chore(ci): pr-evidence FAIL output tells you to push (body edit does …
diegosouzapw Jul 2, 2026
9ba79c7
fix(providers): Perplexity Web emits real tool_calls in streaming mod…
diegosouzapw Jul 2, 2026
cd81b2a
fix(discovery): resolve duplicate /v1 paths and redirect aborts (#5904)
hamsa0x7 Jul 2, 2026
f199e40
docs(changelog): record #5926 + #5944 (release-pipeline hardening) un…
diegosouzapw Jul 2, 2026
283a501
docs(claude): add Hard Rule #22 — cross-session safety (git stash + i…
diegosouzapw Jul 2, 2026
b6249dd
refactor(translator): extract pure helpers from response/openai-respo…
diegosouzapw Jul 2, 2026
26dc500
docs(compression): document upstream sync policy for RTK/Caveman engi…
diegosouzapw Jul 2, 2026
058cfd4
fix(sse): strip ANSI/VT100 codes from gemini-cli stream frames (#5934)
diegosouzapw Jul 2, 2026
18cf641
fix(translator): strict Anthropic content-block compliance in antigra…
diegosouzapw Jul 2, 2026
70a70e6
fix(mcp): auto-recover stale streamable HTTP sessions on initialize (…
Chewji9875 Jul 2, 2026
11a22bb
fix(providers): validate v0 Platform API keys via chats endpoint (#5954)
Jul 2, 2026
b2f77f3
fix(api): relax provider-scoped chat completion validation (#5907)
nickwizard Jul 2, 2026
ad9a859
fix(providers): strip /v1 unconditionally to avoid /v1/v1/models fetc…
anki1kr Jul 2, 2026
476968e
fix(resilience): per-window is_exhausted + honor quota-exhaustion pre…
diegosouzapw Jul 2, 2026
8d2df91
fix(resilience): honor active codex session affinity over per-request…
diegosouzapw Jul 2, 2026
2b0da37
fix(thinking): only inject redacted_thinking replay block when tool_u…
diegosouzapw Jul 2, 2026
26fd7b6
feat(providers): add ClinePass API-key provider (#5942)
diegosouzapw Jul 2, 2026
01d2e1a
feat(api): add /v1/ocr endpoint (Mistral OCR) + Mistral moderation (#…
diegosouzapw Jul 2, 2026
61bba3e
fix(codex): convert chat json schema to responses text format (#5933)
yusufrahadika Jul 2, 2026
4f157e9
feat(providers): add Claude Sonnet 5 support across the model pipelin…
ggiak Jul 2, 2026
b56a94c
feat(relay): gate bifrost auto routing by provider manifest (#5870)
KooshaPari Jul 2, 2026
717069a
refactor(translator): extract pure message helpers from openai-to-kir…
diegosouzapw Jul 2, 2026
4eaa2f4
refactor(executors): extract pure prompt + composer helpers from curs…
diegosouzapw Jul 2, 2026
81d640d
refactor(executors): extract pure SSE-collect parsing from antigravit…
diegosouzapw Jul 2, 2026
273e749
refactor(executors): extract pure model maps + resolvers from chatgpt…
diegosouzapw Jul 2, 2026
cc570cb
refactor(executors): decompose grok-web into pure tool/markup leaves …
diegosouzapw Jul 2, 2026
edb01b9
refactor(executors): extract pure quota parsing from codex (#5999)
diegosouzapw Jul 2, 2026
17d8cb9
refactor(executors): extract pure stream formatters from deepseek-web…
diegosouzapw Jul 2, 2026
4e69185
refactor(api): add validatedJsonBody helper (salvage #5075) (#5931)
diegosouzapw Jul 2, 2026
a3e6868
feat(qoder): drive PAT auth via qodercli, add dashboard quota, fix co…
AgentKiller45 Jul 2, 2026
501d4b2
fix(providers): minimax-m3 supportsVision (LEDGER-4) + stryker tap.te…
diegosouzapw Jul 2, 2026
de3fbd5
fix(registry): flag cline-pass/minimax-m3 as multimodal (supportsVisi…
diegosouzapw Jul 2, 2026
1a73dd2
refactor(executors): extract pure payload construction from claude-we…
diegosouzapw Jul 2, 2026
3a3d618
refactor(executors): extract pure upstream-header helpers from base (…
diegosouzapw Jul 2, 2026
7bcd750
refactor(executors): extract pure wire protocol from perplexity-web (…
diegosouzapw Jul 3, 2026
fa51354
refactor(executors): extract pure URL normalizers from default (#6015)
diegosouzapw Jul 3, 2026
babfa7b
feat(webfetch): support self-hosted FireCrawl instances (#5793)
diegosouzapw Jul 3, 2026
9e5d2d1
feat(xai): register XaiExecutor with reasoning-effort suffix parsing …
diegosouzapw Jul 3, 2026
0965c54
feat(discovery): Phase 2 — reporter, /api/discovery/* routes (strict …
diegosouzapw Jul 3, 2026
a49d34b
feat(providers): custom icon URL for compatible provider nodes (#5815)
diegosouzapw Jul 3, 2026
cbd08ef
feat(api): add /v1/audio/translations endpoint (#5809)
diegosouzapw Jul 3, 2026
f7dea02
feat(dashboard): wildcard-CORS runtime warning + CORS security doc (#…
diegosouzapw Jul 3, 2026
20a67d4
refactor(executors): extract pure JSONL stream translation from huggi…
diegosouzapw Jul 3, 2026
0c3498e
refactor(executors): extract pure Meta AI response parser from muse-s…
diegosouzapw Jul 3, 2026
2ce64e8
refactor(executors): extract pure EventStream framing from kiro (#6018)
diegosouzapw Jul 3, 2026
6756fa8
refactor(executors): extract challenge solver from duckduckgo-web (#6…
diegosouzapw Jul 3, 2026
cfa3686
test(cli): deflake setup-claude.test.ts — silence console to stop std…
diegosouzapw Jul 3, 2026
08b5e08
fix(cli): stabilize setup-claude.test.ts flake — inject dry-run log s…
diegosouzapw Jul 3, 2026
25783d1
refactor(executors): extract reasoning-effort (base) + tool-normaliza…
diegosouzapw Jul 3, 2026
3b512f4
test(ci): move orphaned executor tests to top-level so a runner colle…
diegosouzapw Jul 3, 2026
31e80a9
test(cli): deflake cli-setup-opencode.test.ts — silence console (#595…
diegosouzapw Jul 3, 2026
4b8056b
feat(agy): support Google Cloud project ID settings (#5905)
nickwizard Jul 3, 2026
bff75cb
feat(proxy): add Webshare proxy pool import and sync (#5993)
diegosouzapw Jul 3, 2026
b6a11f0
feat(api-keys): add per-key device/connection tracking (#5998)
diegosouzapw Jul 3, 2026
5d3f85f
fix(providers): only apply openai-family model inference fallback whe…
diegosouzapw Jul 3, 2026
1640b8c
fix(cc-compatible): send SSE accept for streamed requests (#5958)
rdself Jul 3, 2026
1264d1f
fix: deepseek-web reliability — auto-refresh on 401/403, refresh v2.0…
backryun Jul 3, 2026
b253d8a
feat(providers): support Vercel AI Gateway embeddings and images (#5968)
diegosouzapw Jul 3, 2026
c9ac305
feat(cli-tools): add Crush CLI tool to the dashboard (#5970)
diegosouzapw Jul 3, 2026
9838acc
feat(dashboard): suggest HuggingFace Hub media models (#5990)
diegosouzapw Jul 3, 2026
aac5ebc
feat(dashboard): collapse and sort provider quota rows by remaining (…
diegosouzapw Jul 3, 2026
a4872ce
feat(providers): refresh The Old LLM (Free) model catalog (#5181)
diegosouzapw Jul 3, 2026
cbe2ec1
feat(dashboard): add tool-source diagnostics settings toggle (#5978)
diegosouzapw Jul 3, 2026
cd10a6f
feat(oauth): import Codex connection from a raw ChatGPT access token …
diegosouzapw Jul 3, 2026
85a7be9
fix(resilience): parse Retry-After from 429 JSON body for cooldown (#…
diegosouzapw Jul 3, 2026
e6e6d36
fix(embeddings): forward connection-level proxy to embedding requests…
diegosouzapw Jul 3, 2026
08acf86
fix(api): guard shared API client against non-JSON error responses (#…
diegosouzapw Jul 3, 2026
ff64c9e
feat(dashboard): surface Codex banked reset credits per account (#5199)
diegosouzapw Jul 3, 2026
ef7b4fe
feat(providers): add NVIDIA NIM image generation (#5971)
diegosouzapw Jul 3, 2026
196375b
feat(providers): add Augment (Auggie CLI) local provider (#5972)
diegosouzapw Jul 3, 2026
7aaf109
feat(providers): add ModelScope OpenAI-compatible provider (#5965)
diegosouzapw Jul 3, 2026
a518ce8
feat(providers): add Qiniu OpenAI-compatible provider (#5966)
diegosouzapw Jul 3, 2026
70dd5df
feat(providers): add b.ai OpenAI-compatible provider (#5969)
diegosouzapw Jul 3, 2026
50f7705
feat(providers): add Nube.sh OpenAI-compatible provider (#5936)
diegosouzapw Jul 3, 2026
7658a7d
feat(providers): add Charm Hyper OpenAI-compatible provider (#5961)
diegosouzapw Jul 3, 2026
f984bef
feat(providers): add SumoPod and X5Lab OpenAI-compatible providers (#…
diegosouzapw Jul 3, 2026
4e16a49
feat(server): support reverse-proxy basePath deployment (#5992)
diegosouzapw Jul 3, 2026
373dd17
refactor(combo): extract buildTargetTimeoutRunner from handleComboCha…
diegosouzapw Jul 3, 2026
1bd4b02
feat(cli-tools): add CodeWhale CLI tool (#5996)
diegosouzapw Jul 3, 2026
c9032e4
feat(i18n): auto-detect browser language on first visit (#5979)
diegosouzapw Jul 3, 2026
e34d1a4
fix(dashboard): render Update-now API errors as text, not the raw env…
diegosouzapw Jul 3, 2026
6bce788
feat(api): expose provider plugin manifest (#6001)
KooshaPari Jul 3, 2026
96c04f7
feat(providers): add CN sign-up geo-restriction notices for SenseNova…
diegosouzapw Jul 3, 2026
0c2b057
feat(sidecar): advertise provider manifest url (#6007)
KooshaPari Jul 3, 2026
72ee806
feat(autoCombo): latency/speed-optimized routing mode + omniroute_pic…
KooshaPari Jul 3, 2026
9521864
Merge PR #6037: refresh The Old LLM (Free) model catalog (#5181)
diegosouzapw Jul 3, 2026
4f1803a
Merge PR #6038: surface Codex banked reset credits per account (#5199)
diegosouzapw Jul 3, 2026
29fc4a7
Merge PR #6045: CN sign-up geo-restriction notices for SenseNova & St…
diegosouzapw Jul 3, 2026
83f67c8
docs(changelog): restore #5181/#5199/#5462 feature bullets eaten by m…
diegosouzapw Jul 3, 2026
0e98534
feat(usage): on-demand period-scoped usage-data reset (re-cut onto re…
diegosouzapw Jul 3, 2026
204bd7f
chore(quality): rebaseline eslintWarnings 4199->4256 + cognitiveCompl…
diegosouzapw Jul 3, 2026
6a04114
feat(claude-code): opt-in auto-permission classifier compat mode (re-…
diegosouzapw Jul 3, 2026
e12bbd3
feat(providers): client-identity header profiles for compatible nodes…
diegosouzapw Jul 3, 2026
8fb0206
docs(openapi): document 9 newly-added routes to restore coverage ratc…
diegosouzapw Jul 3, 2026
d6dc869
refactor(sse): decompose handleComboChat auto-strategy region (Block …
diegosouzapw Jul 3, 2026
65602b5
fix(ci): release-green base-reds — #5695 test regex + file-size rebas…
diegosouzapw Jul 3, 2026
90aca8b
fix(translator): wrap Kiro system prompt in <system-reminder> (port f…
diegosouzapw Jul 3, 2026
f496738
fix(translator): strip multipleOf from antigravity/gemini tool schema…
diegosouzapw Jul 3, 2026
8d0ed4f
fix(kimi-web, qwen-web): align model catalog with live /models + map …
janeza2 Jul 3, 2026
5d902e5
feat(minimax): extract M3 <think> to reasoning_content on OpenAI-form…
KooshaPari Jul 3, 2026
772fea3
fix: unwrap Cline response envelope (#6046)
KooshaPari Jul 3, 2026
4573684
refactor(sse): extract applyStrategyOrdering leaf from handleComboCha…
diegosouzapw Jul 3, 2026
5fe2258
fix(combo): fallback to sibling model on 500 for per-model-quota prov…
hartmark Jul 3, 2026
b7160e9
feat(xai): surface Grok usage on quota dashboard via local usageHisto…
diegosouzapw Jul 3, 2026
dc7892c
feat(services): add Mux managed embedded service (#6034)
diegosouzapw Jul 3, 2026
556f191
feat(services): promote Bifrost to embedded/supervised service (#5670…
diegosouzapw Jul 3, 2026
d0be015
Merge pull request #5912 from chirag127/fix/pnpm11-allowbuilds-workspace
diegosouzapw Jul 3, 2026
8d7e3e2
fix(ci): document BIFROST_PORT to clear env-doc-sync base-red
diegosouzapw Jul 3, 2026
513e3b0
Merge pull request #6110 from diegosouzapw/fix/release-envdoc-bifrost…
diegosouzapw Jul 3, 2026
2a20e5c
fix(providers): emulate OpenAI tool_calls in GitLab Duo executor (#60…
diegosouzapw Jul 3, 2026
29e04b7
fix(providers): strip orphan tool_result on Antigravity MITM path (#6…
diegosouzapw Jul 3, 2026
9c6a364
fix(registry): update grok-cli model context lengths (#5913)
Chewji9875 Jul 3, 2026
ad58bc1
feat(proxy): batch delete, auto-test, health scheduler + transitive a…
oyi77 Jul 3, 2026
1f6ec5b
feat(minimax): extract M3 reasoning_content on OpenAI-format tiers (#…
KooshaPari Jul 3, 2026
439f28d
fix(ci): harden provider translate-path golden across CI runners (#6076)
KooshaPari Jul 3, 2026
dbc0cdb
test(embeddings): pin seeded connection to direct egress in route-edg…
diegosouzapw Jul 3, 2026
1f1fda7
fix(config): externalize ws for copilot-m365-web executor (#6130, clo…
diegosouzapw Jul 3, 2026
caeee89
fix(providers): update Perplexity Web models (#6106)
backryun Jul 3, 2026
91cda11
fix(providers): update Gemini Web cookies and models (#6095)
backryun Jul 3, 2026
9c2fbf5
fix(models): normalize GLM-5.2 provider context (#6091)
Thinkscape Jul 3, 2026
f884c40
fix(combo): prefer known context capacity over unknown (#6088)
Thinkscape Jul 3, 2026
c02f8d5
fix: keep Claude tool results adjacent (#6035)
KooshaPari Jul 3, 2026
f9b2fb4
fix(security): persist IP filter config + enforce it in the authz pip…
diegosouzapw Jul 3, 2026
00d97ca
fix(codex): use access_token.exp instead of id_token.exp for import e…
anki1kr Jul 3, 2026
631c6c4
fix(compression): send patch-only to PUT /api/settings/compression in…
anki1kr Jul 3, 2026
32e4c90
fix: reqId ReferenceError in safety-net redirect, dead code, filename…
fix2015 Jul 3, 2026
421a1ec
fix(combo): expand fingerprint-based providers into per-fingerprint c…
pizzav-xyz Jul 3, 2026
8c3bcf0
fix(auth): persist quota preflight account lockouts (#6090)
Thinkscape Jul 3, 2026
d072db2
fix(combos): expand OpenCode/MiMo fingerprint accounts in combo build…
anki1kr Jul 3, 2026
e267246
chore(quality): rebaseline v3.8.44 release-green drift (eslint/cognit…
diegosouzapw Jul 3, 2026
e9d83e7
fix(accountFallback): persist per-account 429 cascade + classify 'Mon…
KooshaPari Jul 3, 2026
8cded07
feat(build): backend-only fast build (skip the dashboard frontend) (#…
artickc Jul 3, 2026
7160412
fix(provider-limits): clear transient rate-limit state when quota rec…
janeza2 Jul 3, 2026
cfd1f72
docs: Normalize mixed-language documentation content (#6105)
Iammilansoni Jul 4, 2026
926b08a
chore docs
diegosouzapw Jul 3, 2026
e42e554
i18n(zh-CN): translate CHANGELOG entries and section headings (#6043)
studyzy Jul 4, 2026
4a7602f
chore(quality): rebaseline residual eslint + file-size drift (v3.8.44)
diegosouzapw Jul 4, 2026
d3edbb5
fix(repo): remove Windows case-conflicting DESIGN duplicate (#6140)
backryun Jul 4, 2026
c51693b
fix(provider-limits): close TOCTOU race in quota recovery clear (I2) …
janeza2 Jul 4, 2026
65bec99
fix(glm): suppress </think> close marker leak in GLM Anthropic transp…
dhaern Jul 4, 2026
81f5bce
fix(cli): give setup-claude a fallback profile generator like setup-c…
derhornspieler Jul 4, 2026
d8e4eee
fix(onboarding): route provider-details link by node id, not provider…
chirag127 Jul 4, 2026
d927f2d
fix(translator): strip Responses-only truncation field before Chat Co…
diegosouzapw Jul 4, 2026
0cc3256
fix(mitm): guard against concurrent MITM server starts (#6107)
diegosouzapw Jul 4, 2026
402d9de
feat(models): add claude-sonnet-5 to Antigravity catalog (#6103)
diegosouzapw Jul 4, 2026
c900bbb
fix(providers): strip thinking param for minimax-m2.7 on NVIDIA NIM (…
diegosouzapw Jul 4, 2026
016fec3
feat(providers): add Kenari OpenAI-compatible gateway (#6104)
diegosouzapw Jul 4, 2026
2fa47b7
feat(sse): per-request Auto-Combo controls (X-OmniRoute-Mode / X-Omni…
diegosouzapw Jul 4, 2026
dc2efa5
feat(resilience): throttle concurrent upstream quota fetches — closes…
diegosouzapw Jul 4, 2026
415d159
fix(oauth): graceful 400 for keychain-import-only providers (zed) (#6…
diegosouzapw Jul 4, 2026
5ca28f2
fix(dashboard): resolve broken Card import breaking next build (base-…
diegosouzapw Jul 4, 2026
979a7c6
fix(release): v3.8.44 Phase-0 pre-flight — base-red sweep + ratchet a…
diegosouzapw Jul 4, 2026
babb759
chore(release): v3.8.44 — 2026-07-04
diegosouzapw Jul 4, 2026
00c55af
fix(release): v3.8.44 one-pass release-PR CI sweep
diegosouzapw Jul 4, 2026
103236d
fix(release): round-2 CI findings — LocaleAutoDetect refresh gating +…
diegosouzapw Jul 4, 2026
6c6ab8a
test(release): collect the #6082 fingerprint-expansion ghost test
diegosouzapw Jul 4, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,22 @@

---

## [3.8.44] — TBD

### ✨ New Features

- **feat(api):** add `/v1/ocr` endpoint (Mistral OCR), an OCR provider category, and Mistral moderation support. (thanks @waguriagentic)

### 🔧 Bug Fixes

_TBD_

### 📝 Maintenance

_TBD_

---

## [3.8.43] — 2026-07-02

### ✨ New Features
Expand Down
3 changes: 3 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -541,6 +541,9 @@ the stale-enforcement added in Fase 6A.3.
19. Never develop on the shared main checkout. Every development task runs in its own git worktree on its own dedicated branch, and you MUST confirm the base branch with the operator (e.g. via `AskUserQuestion`) before creating the worktree/branch — never assume `main` or the currently checked-out branch. A `git checkout` in the shared checkout silently destroys other sessions' uncommitted work. Tear down only the worktrees/branches you created (by name, never `fix/*`/`feat/*` wildcards), leave other sessions' worktrees untouched, and end on the branch you started on (the active `release/vX.Y.Z`, never `main`). See Git Workflow → "Worktree isolation".
20. PII redaction/sanitization is **opt-in — never on by default**. OmniRoute proxies for self-hosted/local LLMs where the operator owns the data, so mutating request/response payloads by default would silently corrupt legitimate traffic. The two data-mutating PII feature flags **MUST** keep `defaultValue: "false"` in `src/shared/constants/featureFlagDefinitions.ts`: `PII_REDACTION_ENABLED` (request-side) and `PII_RESPONSE_SANITIZATION` (response + streaming). All three application points — `src/lib/guardrails/piiMasker.ts` (request guardrail), `src/lib/piiSanitizer.ts` (response), `src/lib/streamingPiiTransform.ts` (SSE) — are gated on these flags; with both off the `pii-masker` guardrail still runs but never mutates payloads (data passes through untouched). Flipping either default to `"true"` requires explicit operator approval. The regression guard is `tests/unit/pii-opt-in-default.test.ts` (asserts both definition defaults + behavioral pass-through). Opt-in is per-operator via env or the settings/DB override (`src/lib/db/featureFlags.ts`), never a silent default. See `docs/security/GUARDRAILS.md`.
21. **Release-freeze — the release branch is frozen to campaign merges while a `/generate-release` is running.** `/generate-release` opens a marker issue labeled `release-freeze` at the start of reconciliation (Phase 0a) and closes it once the release PR squash-merges to `main`. Before merging **any** PR into the active `release/vX.Y.Z` branch, every campaign workflow (`/review-issues`, `/review-prs`, `/implement-features`, `/green-prs`, `/port-upstream-*`) **MUST** check `gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open` — if a freeze is active, **HOLD the merge** (leave the PR ready and open; do NOT merge to the release branch), tell the operator, and resume once the freeze lifts. This is a **coordination signal, not a permission lock**: the release captain and the campaign sessions share the `diegosouzapw` identity, so a GitHub branch-protection lock cannot distinguish them — only this honored marker prevents the mid-release commit races that forced full CHANGELOG re-reconciliation in v3.8.40/v3.8.41 (a parallel campaign advanced `release/vX.Y.Z` by 34 commits mid-run). The release captain's own reconciliation/cycle-open pushes are exempt — they _are_ the release. Fixes that must land during a freeze (a homologation finding) follow the post-merge read-only rule: land on `main` first via `fix/release-vX.Y.Z-*`. **⛔ ONLY `/generate-release` may raise a release-freeze, and ONLY at its Phase 0a (start of generating a new version) — lifted at Phase 12c after the squash-merge to `main`.** No campaign, session, or agent may open a `release-freeze` marker at any other time — a freeze is **never** a mid-development coordination tool. If a session ever believes a freeze is genuinely, unavoidably necessary outside the `/generate-release` flow, it **MUST first ask the operator (`diegosouzapw`) in chat, explicitly alert "estou criando um freeze" and get an explicit yes** — never open, extend, or re-open a `release-freeze` autonomously. Conversely, do **not** close/lift an active `/generate-release` freeze to unblock campaign merges: it protects the captain's single clean CI run and auto-lifts at Phase 12c — closing it early re-triggers the exact commit race it prevents. Verify a freeze is legitimate before acting on it: an open `release-freeze` whose title/body references an **OPEN** release PR (`gh pr view <N> --json state`) is the authorized captain freeze — hold, don't touch.
22. **Cross-session safety — this repo is worked by MANY parallel sessions/agents at once; never step on another's in-flight work.** Two absolute bans, both recurring incidents (this rule exists because they keep happening):
- **(a) Never `git stash` / `git stash pop` — ANYWHERE in this repo, including inside an isolated worktree, and including inside any subagent you dispatch.** `git stash` operates on the **shared repository object store**, not the per-worktree working tree — so a stash pushed or popped in one session can silently clobber or resurrect another parallel session's uncommitted changes. This is not hypothetical: 2026-07-02 a `#5923` quotaCache change leaked into the unrelated `#2296` worktree via a global `stash pop`, and the same class reincided through a **subagent**. To compare working changes against a base ref **without** stashing, use `git show <ref>:<path>` or `git diff <ref> -- <path>`; to confirm a typecheck/lint error is pre-existing on the base, inspect the base ref directly (`git show origin/release/vX.Y.Z:<path>`) — never stash your tree away to "get it clean". **Put this ban verbatim in the prompt of every subagent that touches git** (agents don't inherit this file's context — the recurrence was a subagent).
- **(b) Never merge, push, rebase, or force-push a PR / branch / worktree that another session is actively working.** An open PR whose head is a live fix worktree in `.claude/worktrees/` you did **not** create (e.g. `fix-5852`/`fix-5923` carrying fresh commits, even when they share your `diegosouzapw` identity), or any branch another session owns, is **off-limits — HOLD**, and let the owning session merge it. **Before** merging or pushing to any PR you did not create *this* session, run `git worktree list` to check for a matching in-flight worktree and re-check `gh pr view <N> --json state,headRefOid`. Only the owning session merges its own in-flight PR; mid-flight merges race the owner and re-trigger the exact commit/CHANGELOG races Rule #19 and Rule #21 guard against. (Reinforces Rule #19.)

---

Expand Down
6 changes: 4 additions & 2 deletions config/quality/file-size-baseline.json
Original file line number Diff line number Diff line change
Expand Up @@ -294,7 +294,7 @@
"_rebaseline_2026_06_27_5193_antigravity_test": "#5193 own test growth: oauth-providers-config.test.ts 870->873 (+3: antigravity projectId assertion + 50ms tick for the now fire-and-forget onboarding, matching the no-PKCE/no-openid flow).",
"tests/unit/oauth-providers-config.test.ts": 873,
"tests/unit/perplexity-web.test.ts": 959,
"tests/unit/provider-models-route.test.ts": 1628,
"tests/unit/provider-models-route.test.ts": 1752,
"tests/unit/provider-validation-specialty.test.ts": 2874,
"_rebaseline_pr4613_compatible_provider_groups": "Reconcile #4613 already-merged growth: providers-page-utils.test.ts 1004->1052 (+48, buildCompatibleProviderGroups partition unit test). Fast-gate PR->release does not run check:file-size, so this surfaced post-merge.",
"tests/unit/providers-page-utils.test.ts": 1052,
Expand All @@ -313,7 +313,8 @@
"tests/unit/usage-service-hardening.test.ts": 1633,
"tests/unit/vscode-token-routes.test.ts": 1212,
"tests/unit/combo-config.test.ts": 881,
"tests/unit/web-cookie-providers-new.test.ts": 845,
"_rebaseline_2026_07_02_5928_base_red": "web-cookie-providers-new.test.ts 845->850: #5928 (test(security) Kimi Web URL host parse, CodeQL #689) grew the file +5 lines and merged into release/v3.8.44 WITHOUT rebaselining, leaving a fast-gates base-red that blocked every subsequent PR->release. Test growth is legitimate (a security regression test); maintainer absorbs the drift here. Frozen at 850.",
"tests/unit/web-cookie-providers-new.test.ts": 850,
"tests/unit/response-sanitizer.test.ts": 906
},
"_rebaseline_2026_06_09": "Re-baseline consciente pre-release v3.8.19: 9 arquivos cresceram durante o ciclo (features mergeadas: RequestLoggerV2 +281 request-logger rework, stream +101, combo +73, chatCore +45, catalog +32 fable-5/catalog-flag, callLogs +4, accountFallback +2, usageHistory novo 840) + core.ts +7 (fix resetAllDbModuleState, PR 3536). A catraca segue valendo destes valores — proximo crescimento falha. Decisao: encolher (esp. RequestLoggerV2/chatCore) e a issue #3501 ficam para o ciclo seguinte.",
Expand Down Expand Up @@ -355,6 +356,7 @@
"_rebaseline_2026_06_17_4107_pending_reaper": "PR #4107 own growth: usageHistory.ts 854->934 (+80 = orphaned-pending-request reaper — sweepStalePendingRequests() evicts pending details older than 15min + a hard 5000 cap, plus an unref'd 5min sweep timer wired lazily into trackPendingRequest). Fixes an unbounded memory leak where abnormally-terminated requests left payload previews in pendingById forever. Cohesive with the existing pending-request bookkeeping (mirrors the normal removal path: decrement counters + cleanup buckets); not extractable.",
"_rebaseline_2026_06_17_4116_combo_hedge_listener": "combo.ts: +9 lines from #4116 (detach per-target listener from shared hedge abort signal to fix a listener leak). Behavior-preserving cleanup; 5289 -> 5298.",
"_rebaseline_2026_06_20_4355_gpt5x_pro_pricing": "PR #4355 own growth: pricing.ts 1581->1592 (+11 = pure-data pricing rows for openai gpt-5.5-pro + gpt-5.4-pro, closing the $0 gap that tripped the catalog pricing gate after the #4324 sweep added them to the registry; -pro mirrors its base family tier). provider-models-route.test.ts 1616->1618 (+2 = test-only alignment to the intentional opencode-go discovery behavior: owned_by stamp + T39 two-endpoint fail-path fetchCalls). Both are data/test-only; not extractable.",
"_rebaseline_2026_07_02_5899_airforce_v1_discovery": "PR #5904 own growth: provider-models-route.test.ts 1628->1752 (+124 = test-only Rule #18 regression guards for the Api Airforce /v1/v1/models discovery bug (#5899): (a) a baseUrl ending in /v1/chat/completions must probe .../v1/models not the doubled .../v1/v1/models, and the host-guard case http://v1; (b) a REDIRECT_BLOCKED on one candidate must continue to the next endpoint instead of aborting the probe loop. Both guards fail on the pre-fix code. Test-only additions cohesive with the existing provider-models discovery suite (shared seedConnection/callRoute harness); not separately extractable without duplicating the harness.",
"_rebaseline_2026_06_19_4293_codex_spark_scope": "PR #4293 (isolate Codex Spark quota scope) own growth, MEASURED on the actual merged tree (release/v3.8.30 + #4293). Production: auth.ts 2219->2279 (+60) threads requestedModel into Codex quota-policy/headroom/preflight/P2C scoring so normal Codex and GPT-5.3-Codex-Spark windows are evaluated independently; chatCore.ts 5116->5125 (+9) passes the failing model scope into Codex 429 failover (markCodexScopeRateLimited) instead of a connection-wide rateLimitedUntil write; accountFallback.ts 1727->1731 (+4) scopes Codex model-lock keys to codex vs spark. Heavy parsing/display logic lives in new leaf helpers under the cap (codexQuotaScopes.ts, codexUsageQuotas.ts, codexFailover.ts). Tests: account-fallback-service 1544->1569, executor-codex 1336->1339, sse-auth 1527->1553, usage-service-hardening 1612->1633 (added Spark-scope regression coverage). Cohesive wiring at existing selection/failover lockout boundaries; not extractable.",
"_rebaseline_2026_06_20_4447_openai_gpt41mini_o_mini_pricing": "PR #4447 own growth: pricing.ts 1592->1620 (+28 = pure-data pricing rows closing the null/$0 gap for registry-exposed OpenAI ids gpt-4.1-mini, gpt-4.1-nano, o3-mini, o4-mini that tripped the catalog pricing gate; getPricingForModel does an exact lookup, so a missing key resolves to null. Official OpenAI per-1M prices + the table's derived-field convention (reasoning=output*1.5, cache_creation=input, cached=official). Restore-green for a pre-existing release/v3.8.32 red surfaced by #4432's __RUN_ALL__ run. Cohesive data; not extractable.",
"_rebaseline_2026_06_20_web_cookie_validator_shadow_fix": "validation.ts 4518->4522 (+4 = move the generic web-cookie validateWebCookieProvider dispatch from the TOP of validateProviderApiKey to a FALLBACK after SPECIALTY_VALIDATORS, plus a comment, so #4023's generic AUTH_007 ping no longer shadows the rich per-provider validators (grok-web #3474 IP-reputation/Cloudflare, chatgpt-web cf-mitigated, claude/gemini/copilot/qwen/t3-web). Restores provider-validation-specialty.test.ts (112/112) while keeping web-cookie-auth007 (5/5). Behavior fix at an existing dispatch boundary; not extractable.",
Expand Down
1 change: 1 addition & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,7 @@ Lookup material — API surface, environment variables, CLI flags, provider cata

- [API_REFERENCE.md](reference/API_REFERENCE.md) — REST API endpoints and shapes.
- [PROVIDER_REFERENCE.md](reference/PROVIDER_REFERENCE.md) — auto-generated provider catalog (do not edit by hand).
- [PROVIDER_PLUGIN_MANIFEST.md](reference/PROVIDER_PLUGIN_MANIFEST.md) — sidecar-safe provider plugin contract for Bifrost and CLIProxyAPI migration.
- [openapi.yaml](openapi.yaml) — OpenAPI spec for the public API.
- [ENVIRONMENT.md](reference/ENVIRONMENT.md) — environment variables reference.
- [FEATURE_FLAGS.md](reference/FEATURE_FLAGS.md) — feature flags and their defaults.
Expand Down
60 changes: 58 additions & 2 deletions docs/compression/EXTENDING_COMPRESSION.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Extending the Compression Pipeline"
version: 3.8.40
lastUpdated: 2026-06-28
version: 3.8.44
lastUpdated: 2026-07-02
---

# Extending the Compression Pipeline
Expand Down Expand Up @@ -512,6 +512,62 @@ To drive it from config, set `mode: "stacked"` and provide the step array under

---

## Upstream Sync Policy

OmniRoute's compression engines credit several upstream projects in the README
("inspired by RTK, Caveman, LLMLingua-2, Troglodita"). A common contributor
question is: **when upstream RTK adds a new tool filter or Caveman adds a rule
pack, how does that reach OmniRoute?** This section is the authoritative answer.

### Vendored copies vs. independent implementations

| Engine | Relationship to upstream | Location |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **RTK** | **Independent reimplementation** (inspired-by, not a copy) | `open-sse/services/compression/engines/rtk/` |
| **Caveman** | **Independent reimplementation** (inspired-by) | `open-sse/services/compression/engines/cavemanAdapter.ts` |
| **Headroom** | Mostly internal; only the `gcf/` codec is **genuinely vendored** from `gcf-typescript` (MIT, SPDX-marked, generic profile only) | `open-sse/services/compression/engines/headroom/gcf/` |
| **LLMLingua-2 / Troglodita** | Inspired-by (drive the `llmlingua` + `session-dedup` engines) | `open-sse/services/compression/engines/llmlingua/`, `session-dedup` |

Key point: **RTK and Caveman are clean-room TypeScript implementations of the
_ideas_ (filter rules, rule packs), not vendored source trees.** There is no
upstream copy to `git pull` from — which is exactly why the README says
"inspired by" rather than "bundled".

### How upstream improvements are merged

There is **no automated upstream-release tracking and no `compression-sync`
label** — by design. Because the engines are reimplementations, an upstream RTK
filter or Caveman rule pack is not merged as code; it is **re-expressed as a new
rule/filter in OmniRoute's own format** (see
[COMPRESSION_RULES_FORMAT.md](./COMPRESSION_RULES_FORMAT.md)) and lands ad-hoc via
a normal PR. The extension points above (custom engine, language pack, RTK filter)
are the sanctioned way to contribute one.

Recent examples of exactly this flow:

- RTK filters for Gradle & `dotnet` build output (v3.8.42)
- RTK filters for kubectl / docker-build / composer / gh (#2824)
- Caveman Indonesian language pack (#3975), plus German / French / Japanese / Chinese packs

### Headroom (input-compression proxy)

Headroom is **fully internal** — a pinned vendored `gcf` codec snapshot plus
OmniRoute's own `smartcrusher` / `toon` / `tabular` layers. There is no live
upstream to track beyond the vendored copy; updates to `gcf` are refreshed
manually when the codec changes and re-validated against the compression budget
gate (`check:compression-budget`).

### Proposing an upstream-inspired improvement

1. **Don't vendor** — re-express the upstream rule/filter in OmniRoute's format.
2. Add it via the matching extension point below (language pack, RTK filter, or
custom engine).
3. Reference the upstream project in the PR description (attribution), not by
copying its license-bearing source.
4. Include tests and confirm the `check:compression-budget` gate still passes.

---

## Best Practices

### Engine Development
Expand Down
18 changes: 18 additions & 0 deletions docs/i18n/ar/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,24 @@

## [3.8.31] — 2026-06-20

## [3.8.44] — TBD

### ✨ New Features

_TBD_

### 🔧 Bug Fixes

_TBD_

### 📝 Maintenance

- **chore(release):** release-pipeline hardening — `check:test-masking` (vs `origin/main`) is now a HARD gate in the release-green pre-flight (`validate-release-green.mjs`), so a non-allowlisted net-assert reduction surfaces locally instead of in a ~40-min CI layer on the release PR; plus two reconciliation helpers — `npm run release:contributors` (reproducible `### 🙌 Contributors` table via a parenthetical-group parser) and `npm run release:uncovered` (lists commits with no CHANGELOG bullet). ([#5926](https://github.com/diegosouzapw/OmniRoute/pull/5926) — thanks @diegosouzapw)

- **chore(ci):** the `check:pr-evidence` FAIL report now tells you that editing the PR body does not re-run the gate (`ci.yml` ignores the `edited` event) — push a commit to re-validate. ([#5944](https://github.com/diegosouzapw/OmniRoute/pull/5944) — thanks @diegosouzapw)

---

## [3.8.43] — 2026-07-02

### ✨ New Features
Expand Down
18 changes: 18 additions & 0 deletions docs/i18n/az/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,24 @@

## [3.8.31] — 2026-06-20

## [3.8.44] — TBD

### ✨ New Features

_TBD_

### 🔧 Bug Fixes

_TBD_

### 📝 Maintenance

- **chore(release):** release-pipeline hardening — `check:test-masking` (vs `origin/main`) is now a HARD gate in the release-green pre-flight (`validate-release-green.mjs`), so a non-allowlisted net-assert reduction surfaces locally instead of in a ~40-min CI layer on the release PR; plus two reconciliation helpers — `npm run release:contributors` (reproducible `### 🙌 Contributors` table via a parenthetical-group parser) and `npm run release:uncovered` (lists commits with no CHANGELOG bullet). ([#5926](https://github.com/diegosouzapw/OmniRoute/pull/5926) — thanks @diegosouzapw)

- **chore(ci):** the `check:pr-evidence` FAIL report now tells you that editing the PR body does not re-run the gate (`ci.yml` ignores the `edited` event) — push a commit to re-validate. ([#5944](https://github.com/diegosouzapw/OmniRoute/pull/5944) — thanks @diegosouzapw)

---

## [3.8.43] — 2026-07-02

### ✨ New Features
Expand Down
Loading
Loading