Skip to content

perf(hints): optimized profile disables per-result hints by default - #113

Merged
Mibayy merged 1 commit into
mainfrom
feat/optimized-disables-hints
Jul 28, 2026
Merged

perf(hints): optimized profile disables per-result hints by default#113
Mibayy merged 1 commit into
mainfrom
feat/optimized-disables-hints

Conversation

@Mibayy

@Mibayy Mibayy commented Jul 28, 2026

Copy link
Copy Markdown
Owner

First of the measured token-overhead removals. A 3-day usage audit (6,785 real calls) showed the per-result hint/suggestion blocks (~30-50 tokens each) fire on most nav results but convert poorly — the ts_execute nudge fired 228 times while adoption stayed 310 vs 4,502 nav calls. On the optimized profile (the recommended token-minimizing default, which already thins schemas) they were still on.

optimized now disables hints by default, mirroring the thin-schema logic. TS_NO_HINTS=0 opts back in on any profile; =1 still forces off; non-optimized profiles are unchanged, so existing hint tests pass untouched.

Remaining (bigger, not rushed): server-side dedup so get_full_context omits source already served this session (the measured read→get_full_context ×295 waste) — needs careful source-matching between code paths, worth its own pass.

The optimized profile is the token-minimizing default — it already implies
thin schemas. But per-result _hints/_suggestion blocks (~30-50 tokens each)
stayed on, and a usage audit found they convert poorly (the ts_execute nudge
fired hundreds of times without moving adoption). So optimized now disables
them too; the tokens were a measured overhead there. Explicit TS_NO_HINTS=0/1
still wins on any profile. Non-optimized profiles unchanged.
@Mibayy
Mibayy merged commit 8e4d619 into main Jul 28, 2026
3 checks passed
@Mibayy
Mibayy deleted the feat/optimized-disables-hints branch July 28, 2026 18:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant