dsh-context-compression-improved 0.4.0 → 0.5.0

package/CHANGELOG.ja.md

@@ -2,6 +2,25 @@
 
 > 完全な履歴（アップストリーム 0.1.0 以前を含む）は [CHANGELOG.md](CHANGELOG.md) を参照。このファイルはフォークの追加エントリーのみを翻訳したものです。 · [English](CHANGELOG.md) · [中文](CHANGELOG.zh.md) · [한국어](CHANGELOG.ko.md)
 
+## 0.5.0 - 2026-09-20
+
+### Added（追加）
+
+- アドバイザリー関連度アドバイザー（統計と提案のみ、デフォルト無効）：各ターン境界で
+  fire-and-forget のパスを実行し、最新の `todo/write` イベントからセッションの末端タスク
+  意味を要約し（todolist が無い場合は直近のユーザーテキストへフォールバック）、履歴
+  tool-result 候選の「内容+コメント意味 ↔ 現在タスク」の関連度を増分スコアリングし、
+  prefix-decay（characterPressure 重み付けの関連度平均の逆数）を算出します。関連度の低い
+  古いセグメントは `recertified` として記録されますが、これは将来の history 積極度判断への
+  提案入力に過ぎず——今回それを消費する経路は存在せず、アドバイザーの出力が着地すべき
+  reduction を抑制・遅延・書き換えすることは決してありません（専用の不変テストで固定）。
+  `presetOptions.advisor*` 設定キーで設定（`advisorMode` `''|'host'|'direct'`、既定 `''`；
+  direct チャネルは estimator のエンドポイントを再利用；`SideChannel` に任意の overrides
+  引数を追加し、設定を共有せずトランスポートを共有）。可観測性：新しい `advisor-outcome`
+  監査レコード（content-free、summary / scoring / decay の各フェーズごとに 1 件）と、読み
+  取り専用 HTTP ルート `GET .../advisor-report?sessionId=`（デプロイ opt-in フラグ
+  `advisorReportRoute`、review ルートと同じ骨格）。クライアント UI は今回意図的に未提供。
+
 ## 0.4.0 - 2026-09-20
 
 ### Fixed（修正）

package/CHANGELOG.ko.md

@@ -2,6 +2,25 @@
 
 > 전체 히스토리(업스트림 0.1.0 이전 포함)는 [CHANGELOG.md](CHANGELOG.md)를 참고하세요. 이 파일은 포크의 추가 항목만 번역한 것입니다. · [English](CHANGELOG.md) · [中文](CHANGELOG.zh.md) · [日本語](CHANGELOG.ja.md)
 
+## 0.5.0 - 2026-09-20
+
+### Added(추가)
+
+- 어드바이저리 관련도 어드바이저(통계와 제안 전용, 기본 꺼짐): 모든 턴 경계에서
+  fire-and-forget 패스를 실행하여, 최신 `todo/write` 이벤트에서 세션의 후미 작업 의미를
+  요약하고(todolist 가 없으면 최근 사용자 텍스트로 폴백), 역사적 tool-result 후보의
+  "내용+주석 의미 ↔ 현재 작업" 관련도를 증분 스코어링하며, prefix-decay 수치(characterPressure
+  가중 관련도 평균의 역)를 계산합니다. 관련도가 낮은 오래된 세그먼트는 `recertified` 로
+  표시되지만 이는 향후 history 공격성 판단을 위한 제안 입력일 뿐——이번 라운드에서 이를
+  소비하는 경로는 없으며, 어드바이저 출력이 착지해야 할 reduction 을 억제·지연·재작성하는
+  일은 결코 없습니다(전용 불변 테스트로 고정). `presetOptions.advisor*` 설정 키로 구성
+  (`advisorMode` `''|'host'|'direct'`, 기본 `''`; direct 채널은 estimator 엔드포인트 재사용;
+  `SideChannel` 에 선택적 overrides 매개변수 추가로 설정 공유 없이 전송 계층 공유).
+  관측성: 새로운 `advisor-outcome` 감사 레코드(content-free, summary / scoring / decay 각
+  페이즈별 1개)와 읽기 전용 HTTP 라우트 `GET .../advisor-report?sessionId=`(배포 opt-in
+  플래그 `advisorReportRoute`, review 라우트와 동일한 뼈대). 클라이언트 UI 는 이번 라운드에서
+  의도적으로 제공하지 않습니다.
+
 ## 0.4.0 - 2026-09-20
 
 ### Fixed(수정)

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes use this file. The project follows semantic versioning after `0.1.0`.
 
+## 0.5.0 - 2026-09-20
+
+### Added
+
+- Advisory relevance advisor (statistics and suggestions only, default off): at every turn
+  boundary a fire-and-forget pass summarizes the session's tail-task semantics from the
+  most recent `todo/write` event (falling back to recent user text), incrementally scores
+  historical tool-result candidates for content-and-comment relevance against the current
+  task, and computes a prefix-decay figure (character-pressure-weighted mean relevance).
+  Low-relevance old segments are marked `recertified` as suggestions for later
+  history-aggressiveness decisions — nothing this round consumes them, and advisor output
+  can never suppress, delay, or rewrite any reduction that would land (pinned by a
+  dedicated invariant test). Configure through the `presetOptions.advisor*` settings keys
+  (`advisorMode` `''|'host'|'direct'`, default `''`; the direct channel reuses the
+  estimator endpoint; `SideChannel` gained an optional overrides parameter so the
+  estimator's transport is shared without sharing its configuration). Observability: new
+  `advisor-outcome` audit records (content-free, one per phase: summary / scoring / decay)
+  and a read-only `GET .../advisor-report?sessionId=` HTTP route (opt-in deployment flag
+  `advisorReportRoute`, mirroring the review routes). Client UI is intentionally absent
+  this round.
+
 ## 0.4.0 - 2026-09-20
 
 ### Fixed

package/CHANGELOG.zh.md

@@ -2,6 +2,23 @@
 
 > 完整历史（含上游 0.1.0 及更早版本）见 [CHANGELOG.md](CHANGELOG.md)。本文件只翻译本 fork 的新增条目。 · [English](CHANGELOG.md) · [日本語](CHANGELOG.ja.md) · [한국어](CHANGELOG.ko.md)
 
+## 0.5.0 - 2026-09-20
+
+### Added
+
+- 建议型相关度 advisor（仅统计与建议，默认关闭）：每个 turn 边界以 fire-and-forget 方式
+  运行一次 pass——从最近的 `todo/write` 事件总结尾部任务语义（无 todolist 时回退到最近
+  用户文本）、对历史 tool-result 候选做"内容+注释语义 ↔ 当前任务"的增量相关度打分、并
+  计算前缀腐化度（prefix-decay，按 characterPressure 加权的相关度均值取反）。低相关的
+  旧段标记为 `recertified`，仅作为后续 history 激进化的建议输入——本轮没有任何决策路径
+  消费它，且 advisor 输出绝不抑制、延迟或改写任何本应落地的 reduction（有专项不变量测试
+  钉死）。经 `presetOptions.advisor*` settings 键配置（`advisorMode` `''|'host'|'direct'`，
+  默认 `''`；direct 通道复用 estimator 端点；`SideChannel` 新增可选 overrides 参数，
+  共享传输层而不共享配置）。可观测性：新增 `advisor-outcome` 审计记录（content-free，
+  每阶段一条：summary / scoring / decay）与只读 HTTP 路由
+  `GET .../advisor-report?sessionId=`（部署级 opt-in 开关 `advisorReportRoute`，与 review
+  路由同骨架）。本轮刻意不提供客户端 UI。
+
 ## 0.4.0 - 2026-09-20
 
 ### Fixed

package/docs/installation.md

@@ -59,7 +59,31 @@ Open DeepSeek Harness settings → **Context compression selector**:
 
 Like all selector settings, the value is frozen when a session first observes it — the gate affects newly observed sessions, never a task that is already running.
 
-## 5. Update or remove
+## 5. Optional: the advisory relevance advisor
+
+The plugin can keep statistics about how relevant the session's history still is — advisory only, it never decides or blocks anything. It is off by default; turn it on by editing the `presetOptions` section of the context-compression settings (settings JSON, no UI card this round):
+
+```json
+"presetOptions": {
+  "advisorMode": "host",
+  "advisorRefreshTurns": 8,
+  "advisorScoreThreshold": 0.35,
+  "advisorSampleLimit": 16,
+  "advisorMinTokens": 250,
+  "advisorTimeoutMs": 8000
+}
+```
+
+`advisorMode: "host"` calls the harness `llm` service; `"direct"` reuses the estimator's
+`estimatorBaseUrl` / `estimatorApiKey` / `estimatorModel` endpoint. At every turn boundary
+the advisor (1) summarizes the current task from the most recent `todo/write` event,
+(2) incrementally scores historical tool results for content-and-comment relevance, and
+(3) records a prefix-decay figure. Results surface as `advisor-outcome` audit records and,
+with the deployment flag `advisorReportRoute: true`, a read-only
+`GET .../advisor-report?sessionId=` HTTP route. What the advisor reports can never
+suppress, delay, or rewrite any reduction that would land.
+
+## 6. Update or remove
 
 ```sh
 # update: pull, rebuild, repack, and add the new tarball again

package/docs/installation.zh.md

@@ -57,7 +57,30 @@ dsh --profile web --dump-config
 
 与所有选择器设置一致，取值在会话首次观察时冻结——这道门只影响新观察的会话，不会改变正在运行的任务。
 
-## 5. 更新或卸载
+## 5. 可选：建议型相关度 advisor
+
+插件可以对"会话历史还有多相关"做统计——仅建议性质，不做任何决策、也不阻断任何流程。默认关闭；本轮没有设置卡片，请直接编辑上下文压缩设置中的 `presetOptions` 段（settings JSON）：
+
+```json
+"presetOptions": {
+  "advisorMode": "host",
+  "advisorRefreshTurns": 8,
+  "advisorScoreThreshold": 0.35,
+  "advisorSampleLimit": 16,
+  "advisorMinTokens": 250,
+  "advisorTimeoutMs": 8000
+}
+```
+
+`advisorMode: "host"` 走 harness `llm` 服务；`"direct"` 复用 estimator 的
+`estimatorBaseUrl` / `estimatorApiKey` / `estimatorModel` 端点。每个 turn 边界，advisor
+会：(1) 从最近的 `todo/write` 事件总结当前任务语义；(2) 对历史 tool result 做"内容+注释
+语义 ↔ 当前任务"的增量相关度打分；(3) 记录前缀腐化度（prefix-decay）。结果以
+`advisor-outcome` 审计记录呈现；部署配置打开 `advisorReportRoute: true` 后，还可经只读
+HTTP 路由 `GET .../advisor-report?sessionId=` 读取。advisor 报告的任何内容都不会抑制、
+延迟或改写任何本应落地的 reduction。
+
+## 6. 更新或卸载
 
 ```sh
 # 更新：拉取、重建、重新打包、再次添加新 tarball

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-context-compression-improved",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",

package/packages/selector/lib/{review-registry.js → advisor-state.js}

@@ -394,7 +394,13 @@ function parsePresetOptionsSettings(value) {
 		"reviewMode",
 		"reviewTimeoutTurns",
 		"cacheHitDiscountAlpha",
-		"reviewHighImpactTokens"
+		"reviewHighImpactTokens",
+		"advisorMode",
+		"advisorTimeoutMs",
+		"advisorRefreshTurns",
+		"advisorScoreThreshold",
+		"advisorSampleLimit",
+		"advisorMinTokens"
 	]);
 	const unknown = Object.keys(value).find((key) => !allowed.has(key));
 	if (unknown !== void 0) throw new TypeError(`Context-compression presetOptions: unknown key "${unknown}"`);
@@ -410,6 +416,18 @@ function parsePresetOptionsSettings(value) {
 	}
 	const estimatorMode = value.estimatorMode;
 	if (estimatorMode !== void 0 && estimatorMode !== "" && estimatorMode !== "host" && estimatorMode !== "direct") throw new TypeError("Context-compression presetOptions.estimatorMode must be \"\", \"host\", or \"direct\"");
+	const advisorMode = value.advisorMode;
+	if (advisorMode !== void 0 && advisorMode !== "" && advisorMode !== "host" && advisorMode !== "direct") throw new TypeError("Context-compression presetOptions.advisorMode must be \"\", \"host\", or \"direct\"");
+	const advisorTimeoutMs = value.advisorTimeoutMs;
+	if (advisorTimeoutMs !== void 0 && (typeof advisorTimeoutMs !== "number" || !Number.isSafeInteger(advisorTimeoutMs) || advisorTimeoutMs < 100 || advisorTimeoutMs > 6e4)) throw new TypeError("Context-compression presetOptions.advisorTimeoutMs must be an integer between 100 and 60000");
+	const advisorRefreshTurns = value.advisorRefreshTurns;
+	if (advisorRefreshTurns !== void 0 && (typeof advisorRefreshTurns !== "number" || !Number.isSafeInteger(advisorRefreshTurns) || advisorRefreshTurns < 1)) throw new TypeError("Context-compression presetOptions.advisorRefreshTurns must be an integer of at least 1");
+	const advisorScoreThreshold = value.advisorScoreThreshold;
+	if (advisorScoreThreshold !== void 0 && (typeof advisorScoreThreshold !== "number" || !Number.isFinite(advisorScoreThreshold) || advisorScoreThreshold <= 0 || advisorScoreThreshold >= 1)) throw new TypeError("Context-compression presetOptions.advisorScoreThreshold must be a number strictly between 0 and 1");
+	const advisorSampleLimit = value.advisorSampleLimit;
+	if (advisorSampleLimit !== void 0 && (typeof advisorSampleLimit !== "number" || !Number.isSafeInteger(advisorSampleLimit) || advisorSampleLimit < 1 || advisorSampleLimit > 64)) throw new TypeError("Context-compression presetOptions.advisorSampleLimit must be an integer between 1 and 64");
+	const advisorMinTokens = value.advisorMinTokens;
+	if (advisorMinTokens !== void 0 && (typeof advisorMinTokens !== "number" || !Number.isSafeInteger(advisorMinTokens) || advisorMinTokens < 1)) throw new TypeError("Context-compression presetOptions.advisorMinTokens must be a positive integer");
 	const estimatorTimeoutMs = value.estimatorTimeoutMs;
 	if (estimatorTimeoutMs !== void 0 && (typeof estimatorTimeoutMs !== "number" || !Number.isSafeInteger(estimatorTimeoutMs) || estimatorTimeoutMs < 100 || estimatorTimeoutMs > 6e4)) throw new TypeError("Context-compression presetOptions.estimatorTimeoutMs must be an integer between 100 and 60000");
 	const reviewTimeoutTurns = value.reviewTimeoutTurns;
@@ -442,6 +460,12 @@ function parsePresetOptionsSettings(value) {
 	if (reviewTimeoutTurns !== void 0) result.reviewTimeoutTurns = reviewTimeoutTurns;
 	if (cacheHitDiscountAlpha !== void 0) result.cacheHitDiscountAlpha = cacheHitDiscountAlpha;
 	if (reviewHighImpactTokens !== void 0) result.reviewHighImpactTokens = reviewHighImpactTokens;
+	if (advisorMode !== void 0) result.advisorMode = advisorMode;
+	if (advisorTimeoutMs !== void 0) result.advisorTimeoutMs = advisorTimeoutMs;
+	if (advisorRefreshTurns !== void 0) result.advisorRefreshTurns = advisorRefreshTurns;
+	if (advisorScoreThreshold !== void 0) result.advisorScoreThreshold = advisorScoreThreshold;
+	if (advisorSampleLimit !== void 0) result.advisorSampleLimit = advisorSampleLimit;
+	if (advisorMinTokens !== void 0) result.advisorMinTokens = advisorMinTokens;
 	return result;
 }
 /** Settings schema used by the user-facing profile selector. */
@@ -660,7 +684,15 @@ const PRESET_OPTION_DEFAULTS = deepFreeze({
 	reviewMode: false,
 	reviewTimeoutTurns: 6,
 	cacheHitDiscountAlpha: .1,
-	reviewHighImpactTokens: 4e3
+	reviewHighImpactTokens: 4e3,
+	advisor: {
+		mode: "",
+		timeoutMs: 8e3,
+		refreshTurns: 8,
+		scoreThreshold: .35,
+		sampleLimit: 16,
+		minTokens: 250
+	}
 });
 /**
 * Merge persisted presetOptions overrides over the tokenpilot-inspired
@@ -680,7 +712,15 @@ function mergePresetOptions(overrides) {
 		reviewMode: overrides.reviewMode ?? PRESET_OPTION_DEFAULTS.reviewMode,
 		reviewTimeoutTurns: overrides.reviewTimeoutTurns ?? PRESET_OPTION_DEFAULTS.reviewTimeoutTurns,
 		cacheHitDiscountAlpha: overrides.cacheHitDiscountAlpha ?? PRESET_OPTION_DEFAULTS.cacheHitDiscountAlpha,
-		reviewHighImpactTokens: overrides.reviewHighImpactTokens ?? PRESET_OPTION_DEFAULTS.reviewHighImpactTokens
+		reviewHighImpactTokens: overrides.reviewHighImpactTokens ?? PRESET_OPTION_DEFAULTS.reviewHighImpactTokens,
+		advisor: {
+			mode: overrides.advisorMode ?? PRESET_OPTION_DEFAULTS.advisor.mode,
+			timeoutMs: overrides.advisorTimeoutMs ?? PRESET_OPTION_DEFAULTS.advisor.timeoutMs,
+			refreshTurns: overrides.advisorRefreshTurns ?? PRESET_OPTION_DEFAULTS.advisor.refreshTurns,
+			scoreThreshold: overrides.advisorScoreThreshold ?? PRESET_OPTION_DEFAULTS.advisor.scoreThreshold,
+			sampleLimit: overrides.advisorSampleLimit ?? PRESET_OPTION_DEFAULTS.advisor.sampleLimit,
+			minTokens: overrides.advisorMinTokens ?? PRESET_OPTION_DEFAULTS.advisor.minTokens
+		}
 	});
 }
 /**
@@ -1084,5 +1124,66 @@ function registerReviewPruner(pruner) {
 function resolveReviewPruner() {
 	return live.values().next().value;
 }
+const advisorStates = /* @__PURE__ */ new WeakMap();
+/**
+* The per-session advisor state, created on first touch.
+* @param session - the session to key the state on (by object identity).
+*/
+function getAdvisorState(session) {
+	let state = advisorStates.get(session);
+	if (state === void 0) {
+		state = {
+			todoVersion: void 0,
+			summary: void 0,
+			lastSummaryTurn: -1,
+			watermarkSeq: 0,
+			scores: /* @__PURE__ */ new Map(),
+			recertified: /* @__PURE__ */ new Map(),
+			failures: void 0,
+			inFlight: false,
+			lastDecay: void 0
+		};
+		advisorStates.set(session, state);
+	}
+	return state;
+}
+/**
+* Insert or refresh one score with LRU semantics: a re-touched seq moves to
+* the newest position, and the oldest entry is evicted once the map exceeds
+* {@link ADVISOR_SCORES_LIMIT}.
+*/
+function recordScore(state, seq, entry) {
+	state.scores.delete(seq);
+	state.scores.set(seq, entry);
+	if (state.scores.size > 64) {
+		const oldest = state.scores.keys().next();
+		if (oldest.done !== true) state.scores.delete(oldest.value);
+	}
+}
+/**
+* Mark one seq as LLM-recertified low relevance (a suggestion for later
+* history-aggressiveness decisions, consumed by nothing in this round).
+* Bounded at {@link ADVISOR_RECERTIFIED_LIMIT} with the same LRU eviction.
+*/
+function recordRecertified(state, seq, turn) {
+	state.recertified.delete(seq);
+	state.recertified.set(seq, turn);
+	if (state.recertified.size > 64) {
+		const oldest = state.recertified.keys().next();
+		if (oldest.done !== true) state.recertified.delete(oldest.value);
+	}
+}
+/**
+* Drop every cached artifact that depends on the task semantics: a changed
+* todo version invalidates the summary and makes all eligible candidates
+* rescore-worthy (the watermark alone would otherwise hide them).
+*/
+function invalidateOnTaskChange(state, todoVersion) {
+	if (state.todoVersion === todoVersion) return false;
+	state.todoVersion = todoVersion;
+	state.summary = void 0;
+	state.lastSummaryTurn = -1;
+	return true;
+}
 //#endregion
-export { COMPRESSION_PROFILES as C, deepFreeze as S, resolvePolicy as _, AUTO_COMPACT_THRESHOLD_LIMITS as a, resolveCustomPolicy as b, DEFAULTS as c, charsToTokens as d, codePointLength as f, resolveConfig as g, parseContextCompressionSettings as h, ReviewQueue as i, PRUNE_MARKER as l, isValidAutoCompactThresholdPercent as m, resolveReviewPruner as n, CONTEXT_COMPRESSION_SETTINGS_NAMESPACE as o, isCompressionProfile as p, sharedReviewStore as r, ContextCompressionSettingsSchema as s, registerReviewPruner as t, charsForTokens as u, CustomCompressionPolicySchema as v, assertNever as x, DEFAULT_CUSTOM_COMPRESSION_POLICY as y };
+export { DEFAULT_CUSTOM_COMPRESSION_POLICY as C, COMPRESSION_PROFILES as D, deepFreeze as E, CustomCompressionPolicySchema as S, assertNever as T, isCompressionProfile as _, registerReviewPruner as a, resolveConfig as b, ReviewQueue as c, ContextCompressionSettingsSchema as d, DEFAULTS as f, codePointLength as g, charsToTokens as h, recordScore as i, AUTO_COMPACT_THRESHOLD_LIMITS as l, charsForTokens as m, invalidateOnTaskChange as n, resolveReviewPruner as o, PRUNE_MARKER as p, recordRecertified as r, sharedReviewStore as s, getAdvisorState as t, CONTEXT_COMPRESSION_SETTINGS_NAMESPACE as u, isValidAutoCompactThresholdPercent as v, resolveCustomPolicy as w, resolvePolicy as x, parseContextCompressionSettings as y };

package/packages/selector/lib/client.d.ts

@@ -89,6 +89,13 @@ interface PresetOptionsSettings {
   readonly reviewTimeoutTurns?: number;
   readonly cacheHitDiscountAlpha?: number;
   readonly reviewHighImpactTokens?: number;
+  /** Advisory advisor channel; `''` (the default) keeps the advisor off. */
+  readonly advisorMode?: '' | 'host' | 'direct';
+  readonly advisorTimeoutMs?: number;
+  readonly advisorRefreshTurns?: number;
+  readonly advisorScoreThreshold?: number;
+  readonly advisorSampleLimit?: number;
+  readonly advisorMinTokens?: number;
 }
 /** Durable settings section owned by this package. */
 interface ContextCompressionSettings {

package/packages/selector/lib/client.js

@@ -82,7 +82,13 @@ window.__ModuleLoader__.load({
 				"reviewMode",
 				"reviewTimeoutTurns",
 				"cacheHitDiscountAlpha",
-				"reviewHighImpactTokens"
+				"reviewHighImpactTokens",
+				"advisorMode",
+				"advisorTimeoutMs",
+				"advisorRefreshTurns",
+				"advisorScoreThreshold",
+				"advisorSampleLimit",
+				"advisorMinTokens"
 			]);
 			if (Object.keys(value).some((key) => !allowed.has(key))) return void 0;
 			for (const key of [
@@ -97,6 +103,8 @@ window.__ModuleLoader__.load({
 			}
 			const estimatorMode = value.estimatorMode;
 			if (estimatorMode !== void 0 && estimatorMode !== "" && estimatorMode !== "host" && estimatorMode !== "direct") return;
+			const advisorMode = value.advisorMode;
+			if (advisorMode !== void 0 && advisorMode !== "" && advisorMode !== "host" && advisorMode !== "direct") return;
 			for (const key of [
 				"estimatorProvider",
 				"estimatorModel",
@@ -114,6 +122,16 @@ window.__ModuleLoader__.load({
 			if (cacheHitDiscountAlpha !== void 0 && (typeof cacheHitDiscountAlpha !== "number" || !Number.isFinite(cacheHitDiscountAlpha) || cacheHitDiscountAlpha <= 0 || cacheHitDiscountAlpha >= 1)) return;
 			const reviewHighImpactTokens = value.reviewHighImpactTokens;
 			if (reviewHighImpactTokens !== void 0 && (typeof reviewHighImpactTokens !== "number" || !Number.isSafeInteger(reviewHighImpactTokens) || reviewHighImpactTokens < 0)) return;
+			const advisorTimeoutMs = value.advisorTimeoutMs;
+			if (advisorTimeoutMs !== void 0 && (typeof advisorTimeoutMs !== "number" || !Number.isSafeInteger(advisorTimeoutMs) || advisorTimeoutMs < 100 || advisorTimeoutMs > 6e4)) return;
+			const advisorRefreshTurns = value.advisorRefreshTurns;
+			if (advisorRefreshTurns !== void 0 && (typeof advisorRefreshTurns !== "number" || !Number.isSafeInteger(advisorRefreshTurns) || advisorRefreshTurns < 1)) return;
+			const advisorScoreThreshold = value.advisorScoreThreshold;
+			if (advisorScoreThreshold !== void 0 && (typeof advisorScoreThreshold !== "number" || !Number.isFinite(advisorScoreThreshold) || advisorScoreThreshold <= 0 || advisorScoreThreshold >= 1)) return;
+			const advisorSampleLimit = value.advisorSampleLimit;
+			if (advisorSampleLimit !== void 0 && (typeof advisorSampleLimit !== "number" || !Number.isSafeInteger(advisorSampleLimit) || advisorSampleLimit < 1 || advisorSampleLimit > 64)) return;
+			const advisorMinTokens = value.advisorMinTokens;
+			if (advisorMinTokens !== void 0 && (typeof advisorMinTokens !== "number" || !Number.isSafeInteger(advisorMinTokens) || advisorMinTokens < 1)) return;
 			const decoded = {};
 			if (value.dedupeToolResults !== void 0) decoded.dedupeToolResults = value.dedupeToolResults;
 			if (value.summaryLocator !== void 0) decoded.summaryLocator = value.summaryLocator;
@@ -129,6 +147,12 @@ window.__ModuleLoader__.load({
 			if (reviewTimeoutTurns !== void 0) decoded.reviewTimeoutTurns = reviewTimeoutTurns;
 			if (cacheHitDiscountAlpha !== void 0) decoded.cacheHitDiscountAlpha = cacheHitDiscountAlpha;
 			if (reviewHighImpactTokens !== void 0) decoded.reviewHighImpactTokens = reviewHighImpactTokens;
+			if (advisorMode !== void 0) decoded.advisorMode = advisorMode;
+			if (advisorTimeoutMs !== void 0) decoded.advisorTimeoutMs = advisorTimeoutMs;
+			if (advisorRefreshTurns !== void 0) decoded.advisorRefreshTurns = advisorRefreshTurns;
+			if (advisorScoreThreshold !== void 0) decoded.advisorScoreThreshold = advisorScoreThreshold;
+			if (advisorSampleLimit !== void 0) decoded.advisorSampleLimit = advisorSampleLimit;
+			if (advisorMinTokens !== void 0) decoded.advisorMinTokens = advisorMinTokens;
 			return decoded;
 		}
 		/**
@@ -1544,7 +1568,13 @@ window.__ModuleLoader__.load({
 			"reviewMode",
 			"reviewTimeoutTurns",
 			"cacheHitDiscountAlpha",
-			"reviewHighImpactTokens"
+			"reviewHighImpactTokens",
+			"advisorMode",
+			"advisorTimeoutMs",
+			"advisorRefreshTurns",
+			"advisorScoreThreshold",
+			"advisorSampleLimit",
+			"advisorMinTokens"
 		];
 		/**
 		* Plan the path ops one patch needs against the section currently stored.

package/packages/selector/lib/index.d.ts

@@ -24,6 +24,13 @@ interface Config {
    * transport and simply never appears.
    */
   reviewQueueRoute?: boolean;
+  /**
+   * Register the advisory advisor's read-only HTTP report route (decay
+   * figure, task summary, score distribution). Same Bundle opt-in semantics
+   * as `reviewQueueRoute`; the advisor itself stays off until the user turns
+   * it on through the `presetOptions.advisor*` settings keys.
+   */
+  advisorReportRoute?: boolean;
 }
 /** Loader validation for the standalone Bundle opt-in. */
 declare const Config: z<Config>;

package/packages/selector/lib/index.js

@@ -1,4 +1,4 @@
-import { n as resolveReviewPruner, o as CONTEXT_COMPRESSION_SETTINGS_NAMESPACE, s as ContextCompressionSettingsSchema } from "./review-registry.js";
+import { d as ContextCompressionSettingsSchema, o as resolveReviewPruner, t as getAdvisorState, u as CONTEXT_COMPRESSION_SETTINGS_NAMESPACE } from "./advisor-state.js";
 import z from "@deepseek-ai/schemastery";
 import "@deepseek-ai/dsh-settings";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -459,6 +459,7 @@ const CONTEXT_COMPRESSION_NAMESPACE = CONTEXT_COMPRESSION_SETTINGS_NAMESPACE;
 const ESTIMATOR_CATALOG_ROUTES = ["/endpoint/dsh-context-compression-improved/estimator-catalog", "/api/dsh-context-compression-improved/estimator-catalog"];
 const REVIEW_QUEUE_ROUTES = ["/endpoint/dsh-context-compression-improved/review-queue", "/api/dsh-context-compression-improved/review-queue"];
 const REVIEW_DECIDE_ROUTES = ["/endpoint/dsh-context-compression-improved/review-decide", "/api/dsh-context-compression-improved/review-decide"];
+const ADVISOR_REPORT_ROUTES = ["/endpoint/dsh-context-compression-improved/advisor-report", "/api/dsh-context-compression-improved/advisor-report"];
 /**
 * Resolve the review pipeline for the top-level routes.
 *
@@ -694,6 +695,102 @@ function registerReviewQueueRoutes(ctx) {
 	log("warn", "context-compression webServer not active yet — review routes pending: %s", REVIEW_QUEUE_ROUTES.join(", "));
 }
 /**
+* Serve the advisory advisor's read-only report route (same registration
+* skeleton as the review routes):
+*
+* `GET .../advisor-report?sessionId=…` → the session's prefix-decay figure,
+* the todolist-bound task summary, and the score distribution. Content-free
+* by construction: task semantics are LLM-derived summaries, never message
+* text, and no score reason or candidate preview is ever returned.
+* Unknown session → 404; no agents service → 503. A session whose advisor
+* never ran reports nulls and empty arrays, not an error.
+*/
+function registerAdvisorReportRoute(ctx) {
+	const readService = (name) => {
+		try {
+			return ctx.get(name);
+		} catch {
+			return;
+		}
+	};
+	const log = (level, message, ...args) => {
+		console[level](message, ...args);
+	};
+	const getHandler = (req, res) => {
+		if (typeof readService("agents")?.get !== "function") {
+			reviewJson(res, 503, {
+				ok: false,
+				error: "advisor report unavailable"
+			});
+			return;
+		}
+		let sessionId = "";
+		try {
+			sessionId = new URL(String(req.url ?? ""), "http://localhost").searchParams.get("sessionId") ?? "";
+		} catch {}
+		if (sessionId === "") {
+			reviewJson(res, 400, {
+				ok: false,
+				error: "sessionId is required"
+			});
+			return;
+		}
+		const session = sessionFor(readService, sessionId);
+		if (session === void 0) {
+			reviewJson(res, 404, {
+				ok: false,
+				error: "unknown session"
+			});
+			return;
+		}
+		const state = getAdvisorState(session);
+		reviewJson(res, 200, {
+			ok: true,
+			sessionId,
+			advisor: {
+				summary: state.summary ?? null,
+				decay: state.lastDecay?.decay ?? null,
+				weightedChars: state.lastDecay?.weightedChars ?? null,
+				decayTurn: state.lastDecay?.turn ?? null,
+				scores: [...state.scores].map(([seq, entry]) => ({
+					seq,
+					score: entry.score,
+					turn: entry.turn
+				})),
+				lowRelevanceSeqs: [...state.recertified.keys()]
+			}
+		});
+	};
+	const register = (webServer) => {
+		const disposers = [...ADVISOR_REPORT_ROUTES].map((path) => ({
+			path,
+			handler: getHandler
+		})).map((entry) => webServer.register({
+			kind: "exact",
+			path: entry.path,
+			handler: entry.handler
+		})).filter((off) => typeof off === "function");
+		ctx.effect(() => () => {
+			for (const off of disposers) off();
+		}, "contextCompressionSelector.advisor report route");
+		log("info", "context-compression advisor report route registered: %s", ADVISOR_REPORT_ROUTES.join(", "));
+	};
+	const active = asWebServer(readService("webServer"));
+	if (active !== void 0) {
+		register(active);
+		return;
+	}
+	ctx.inject(["webServer"], (injected) => {
+		const webServer = asWebServer(injected.webServer);
+		if (webServer === void 0) {
+			log("warn", "context-compression webServer exposes no register() — advisor report route not registered");
+			return;
+		}
+		register(webServer);
+	});
+	log("warn", "context-compression webServer not active yet — advisor report route pending: %s", ADVISOR_REPORT_ROUTES.join(", "));
+}
+/**
 * The one service the catalog route actually needs. `llm` and
 * `agentDefaultModel` are payload enrichment the handler resolves per request,
 * never reasons to withhold the route.
@@ -797,7 +894,8 @@ const SHARED_SETTINGS = Symbol.for("dsh-context-compression-improved/settings-re
 const Config = z.object({
 	presetOverlay: z.boolean().default(false),
 	estimatorCatalogRoute: z.boolean().default(false),
-	reviewQueueRoute: z.boolean().default(false)
+	reviewQueueRoute: z.boolean().default(false),
+	advisorReportRoute: z.boolean().default(false)
 });
 /** Register the persisted default read by the currently mounted root pruner. */
 function apply(ctx, config = {}) {
@@ -807,6 +905,7 @@ function apply(ctx, config = {}) {
 		});
 		if (config.estimatorCatalogRoute === true) registerEstimatorCatalogRoute(ctx);
 		if (config.reviewQueueRoute === true) registerReviewQueueRoutes(ctx);
+		if (config.advisorReportRoute === true) registerAdvisorReportRoute(ctx);
 		if (config.presetOverlay !== true) return;
 		ctx.inject(["agentPresets"], (presetsCtx) => {
 			const installation = decorateAgentPresets(presetsCtx.agentPresets, {