peaks-loop 4.0.26 → 4.0.28

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 4.0.28 — 2026-09-03 (codegraph 目录回根 + env-first 1M 窗口识别)
+
+**3 atomic commits from session 2026-09-03-session-d49394** (user feedback batch):
+
+- `c0721d3a` fix(codegraph): revert data dir to root `.codegraph/` — drop `.peaks/.codegraph` handling
+- `7011e64c` fix(context): env-first model window resolution — `[1M]`-suffixed model → 1M context
+- `5289a9b3` docs(memory): sediment codegraph root revert + env-first 1M window fix
+
+**Highlights**:
+
+1. **codegraph 数据目录完全回根** — rid-CG-003（4.0.20）引入的 `.peaks/.codegraph/` preferred 位置被移除，数据目录回到根 `.codegraph/`（上游默认语义）。删除 `PREFERRED_CODEGRAPH_DIR` + preferred/legacy/fresh-preferred 三态 union；`resolveCodegraphProjectRoot` 纯路径数学返回 root；doctor messaging / `.gitignore` / 3 测试同步。用户明确"完全回根，去掉 .peaks 路径"。
+
+2. **env-first 模型上下文窗口识别（1M vs 200K）** — 之前只从 transcript `message.model` 读模型 id，而 Claude Code / deepseek 等的 transcript 记录**裸模型名**（`deepseek-v4-flash`，不带 `[1M]`），导致 1M 上下文模型被误判为 200K 并在 ~50% 处 false soft-warn。新增 `resolveClaudeModelFromEnv` 优先读 env 模型标记（`ANTHROPIC_MODEL` → `ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU/FABLE_MODEL` → `CLAUDE_CODE_SUBAGENT_MODEL`，`[1M]`/`[1m]` 后缀即 1M），transcript 兜底。实测修复后 `context-now` 从 `capacityTokens: 200000, ratio 0.88` 变为 `capacityTokens: 1000000, ratio 0.19`。
+
+## 4.0.27 — 2026-09-01 (auto-compact context probe fix)
+
+**1 atomic commit from session 2026-09-01-session-fdd7aa**:
+
+- `7f0f4ca2` perf(auto-compact): vendor-neutral context probe + token-based transcript calibration
+
+**Highlights**:
+
+1. **auto-compact 根因修复（三级链）** — context 比例探针之前永远返回 `conservative-fallback`（ratio 0），auto-compact 从不触发。三处修复：(a) vendor-neutral：Claude transcript/statusline fallback 收进 claude-code-adapter 的 `IdeCompactProfile.readContextPercentFallback`，通用 reader 不再硬编码 `~/.claude`；(b) session-id：transcript 查找改用 `outerSessionId`（Claude Code 真 UUID）而非 peaks `sessionId`；(c) 校准：`ratio = contextTokens / contextWindowTokens`，contextTokens 从最新 `message.usage`（input + cache_read + cache_creation）读取，contextWindowTokens 模型感知（1M vs 200K 默认），替换错误的 `bytes/256KB`（永远 100%）。
+
 ## 4.0.26 — 2026-09-01 (headroom removal + prompt-cache prefix alignment)
 
 **2 atomic commits from session 2026-09-01-session-fdd7aa**:

package/dist/cli/commands/code-runtime-commands.js

@@ -15,6 +15,7 @@ import { evaluateEmitHandoff, JOB_NOT_INITIALIZED, JOB_REMAINING_BLOCKED } from
 import { readJobShapeDecision, JobShapeDecisionError } from '../../services/code/job-shape-decision.js';
 import { getSkillPresence } from '../../services/skills/skill-presence-service.js';
 import { probeInFlightBatch } from '../../services/workflow/workflow-inflight-probe.js';
+import { resolveOuterSessionId } from '../../services/session/binding-status-service.js';
 export function registerCodeRuntimeCommands(code, io) {
     addJsonOption(code
         .command('post-compact-detect')
@@ -175,9 +176,12 @@ export function registerCodeRuntimeCommands(code, io) {
                     // missing/malformed decision file is fine — fall back to advisory.
                 }
             }
+            const sessionId = opts.sessionId ?? readActiveSid(opts.project) ?? 'unknown';
+            const outerSessionId = resolveOuterSessionId(opts.project, sessionId);
             const probe = readContextPercent({
                 projectRoot: opts.project,
-                sessionId: opts.sessionId ?? readActiveSid(opts.project) ?? 'unknown',
+                sessionId,
+                outerSessionId,
                 env: process.env,
                 promptSizeBytes
             });
@@ -218,6 +222,8 @@ export function registerCodeRuntimeCommands(code, io) {
                 ide: probe.ide,
                 capacityBytes: probe.capacityBytes,
                 rawBytes: probe.rawBytes ?? null,
+                rawTokens: probe.rawTokens ?? null,
+                capacityTokens: probe.capacityTokens ?? null,
                 bytesPrompt: promptSizeBytes ?? null,
                 capturedAt: probe.capturedAt
             }, [], [

package/dist/cli/commands/dispatch-commands.js

@@ -27,6 +27,7 @@ import { noteDispatched, BATCH_LIMIT } from '../../services/dispatch/batch-count
 import { writeInitialDispatchRecord } from '../../services/dispatch/dispatch-record-writer.js';
 import { evaluatePromptSize } from '../../services/context/context-guard.js';
 import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
+import { resolveOuterSessionId } from '../../services/session/binding-status-service.js';
 import { buildArtifactMeta, buildContextImpact } from '../../services/context/artifact-meta.js';
 import { assertSafeArtifactPath } from 'peaks-loop-shared-channel';
 import { playwrightProfilePaths } from '../../services/worktree/playwright-profile.js';
@@ -382,9 +383,11 @@ export function registerDispatchCommand(parent, io) {
             let contextProbe = null;
             try {
                 const { readContextPercent } = await import('../../services/context/auto-compact-reader.js');
+                const outerSessionId = resolveOuterSessionId(projectRoot, sid);
                 contextProbe = readContextPercent({
                     projectRoot,
                     sessionId: sid,
+                    outerSessionId,
                     env: process.env
                 });
             }

package/dist/services/code/auto-compact-orchestrator.js

@@ -31,6 +31,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, appendFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { getSessionIdCanonical } from '../session/session-manager.js';
+import { resolveOuterSessionId } from '../session/binding-status-service.js';
 import { AUTO_COMPACT_PRE_COMPACT_RATIO, AUTO_COMPACT_THRESHOLD_RATIO } from '../context/auto-compact-types.js';
 import { describeMode, thresholdFor } from './auto-compact-modes.js';
 import { read24hState } from '../24h-mode/store.js';
@@ -525,9 +526,11 @@ export async function runAutoCompact(input) {
     const mode = input.mode ?? resolveAutoCompactMode(input.projectRoot, sessionId);
     // Lazy import to avoid the AC-1 module depending on the orchestrator.
     const { readContextPercent } = await import('../context/auto-compact-reader.js');
+    const outerSessionId = resolveOuterSessionId(input.projectRoot, sessionId, input.env ?? process.env);
     const probe = readContextPercent({
         projectRoot: input.projectRoot,
         sessionId,
+        outerSessionId,
         env: input.env
     });
     const decision = evaluateAutoCompactDecision({

package/dist/services/codegraph/codegraph-service.d.ts

@@ -41,17 +41,13 @@ export type CodegraphProcessRunner = (invocation: CodegraphInvocation) => Promis
 export declare function createCodegraphInvocation(options: CodegraphInvocationOptions): CodegraphInvocation;
 export declare function executeCodegraphInvocation(invocation: CodegraphInvocation, runner?: CodegraphProcessRunner): Promise<CodegraphExecutionResult>;
 /**
- * Slice rid-CG-006 — root `.codegraph/` (legacy). peaks-loop still
- * reads from this location for back-compat with downstream consumers
- * whose projects pre-date the slice rid-CG-003 preferred-path move.
+ * Single managed codegraph data directory name, relative to the
+ * project root. peaks-loop always reads/writes
+ * `<projectRoot>/.codegraph/` and spawns the upstream binary with
+ * `cwd = <projectRoot>` so its default discovery lands on the same
+ * directory.
  */
 export declare const CODEGRAPH_DIR_NAME = ".codegraph";
-/**
- * Slice rid-CG-003 — preferred managed location. Going forward
- * peaks-loop writes here; legacy root `.codegraph/` is only used
- * when it pre-exists AND `.peaks/.codegraph/` does not.
- */
-export declare const PREFERRED_CODEGRAPH_DIR = ".peaks/.codegraph";
 /**
  * Marker file peaks-loop writes inside the resolved codegraph dir
  * after a successful upstream init. Its presence distinguishes
@@ -61,37 +57,18 @@ export declare const PREFERRED_CODEGRAPH_DIR = ".peaks/.codegraph";
 export declare const CODEGRAPH_MARKER_NAME = ".peaks-loop-marker";
 export declare const CODEGRAPH_INIT_CONFLICT_EXIT_CODE = 73;
 export type ResolvedCodegraphLocation = {
-    readonly source: 'preferred';
-    readonly cwd: string;
-    readonly codegraphDir: string;
-} | {
-    readonly source: 'legacy';
-    readonly cwd: string;
-    readonly codegraphDir: string;
-} | {
-    readonly source: 'fresh-preferred';
+    readonly source: 'root';
+    /** Absolute path the upstream binary should be spawned with. */
     readonly cwd: string;
+    /** Absolute path to the data directory codegraph reads/writes. */
     readonly codegraphDir: string;
 };
 /**
- * Slice rid-CG-003 — pure resolver that returns the cwd the
- * upstream codegraph binary should be spawned with and the
- * absolute path to the data directory it should read/write.
- *
- * Precedence:
- *   1. `<projectRoot>/.peaks/.codegraph/` exists → use it
- *      (cwd = `<projectRoot>/.peaks`, codegraphDir = preferred path)
- *   2. `<projectRoot>/.codegraph/` exists → fall back to legacy
- *      (cwd = `<projectRoot>`, codegraphDir = legacy path)
- *   3. neither exists → default to the preferred path so the next
- *      `peaks codegraph init` lands in `.peaks/.codegraph/`
- *      (cwd = `<projectRoot>/.peaks`, codegraphDir = preferred path,
- *       `source: 'fresh-preferred'`)
- *
- * The cwd is the directory the upstream binary treats as "project
- * root" — the binary's default codegraph discovery reads
- * `<cwd>/.codegraph/`, so we always set cwd to the PARENT of the
- * resolved codegraph dir. Pure fs check; no IO beyond `existsSync`.
+ * Root-only resolver: peaks-loop always manages
+ * `<projectRoot>/.codegraph/`. Returns the cwd the upstream codegraph
+ * binary should be spawned with (= project root, so the binary's
+ * default discovery reads `<projectRoot>/.codegraph/`) and the
+ * absolute data-dir path. Pure path computation; no fs IO.
  */
 export declare function resolveCodegraphProjectRoot(projectRoot: string): ResolvedCodegraphLocation;
 export type CodegraphInitGuardResult = {
@@ -112,12 +89,9 @@ export declare class CodegraphInitConflictError extends Error {
 }
 export type CodegraphInitGuard = (projectRoot: string) => CodegraphInitGuardResult;
 /**
- * Slice rid-CG-003 — preferred-path-first init guard.
- *
- * Looks at `.peaks/.codegraph/` first; falls back to `.codegraph/`
- * when the preferred path is absent. The 'fresh' case returns the
- * preferred path so the next `peaks codegraph init` lands inside
- * `.peaks/` instead of polluting the project root.
+ * Root-only init guard: probes `<projectRoot>/.codegraph/`. 'fresh'
+ * is returned when the directory does not exist yet, so the next
+ * `peaks codegraph init` creates the root `.codegraph/` directory.
  */
 export declare function defaultCodegraphInitGuard(projectRoot: string): CodegraphInitGuardResult;
 /**

package/dist/services/codegraph/codegraph-service.js

@@ -143,10 +143,8 @@ function buildCommandArgs(options, projectRoot) {
 export function createCodegraphInvocation(options) {
     assertSupportedSubcommand(options.subcommand);
     const projectRoot = resolveProjectRoot(options.project);
-    // Slice rid-CG-003 — spawn the upstream binary inside the
-    // resolved codegraph dir's PARENT so its default `.codegraph/`
-    // discovery lands on `.peaks/.codegraph/` (preferred) or
-    // `.codegraph/` (legacy fallback).
+    // Spawn the upstream binary with the project root as cwd so its
+    // default `.codegraph/` discovery reads `<projectRoot>/.codegraph/`.
     const location = resolveCodegraphProjectRoot(projectRoot);
     assertSupportedOptions(options);
     assertRequiredOptions(options);
@@ -165,21 +163,16 @@ export async function executeCodegraphInvocation(invocation, runner = defaultCod
     return runner(invocation);
 }
 /* ──────────────────────────────────────────────────────────────────────
- * Slice rid-CG-003 — preferred `.peaks/.codegraph/` lookup + legacy
- * root `.codegraph/` fallback (spike follow-up #1).
+ * codegraph data-directory resolution — root `.codegraph/` only.
  * ────────────────────────────────────────────────────────────────────── */
 /**
- * Slice rid-CG-006 — root `.codegraph/` (legacy). peaks-loop still
- * reads from this location for back-compat with downstream consumers
- * whose projects pre-date the slice rid-CG-003 preferred-path move.
+ * Single managed codegraph data directory name, relative to the
+ * project root. peaks-loop always reads/writes
+ * `<projectRoot>/.codegraph/` and spawns the upstream binary with
+ * `cwd = <projectRoot>` so its default discovery lands on the same
+ * directory.
  */
 export const CODEGRAPH_DIR_NAME = '.codegraph';
-/**
- * Slice rid-CG-003 — preferred managed location. Going forward
- * peaks-loop writes here; legacy root `.codegraph/` is only used
- * when it pre-exists AND `.peaks/.codegraph/` does not.
- */
-export const PREFERRED_CODEGRAPH_DIR = '.peaks/.codegraph';
 /**
  * Marker file peaks-loop writes inside the resolved codegraph dir
  * after a successful upstream init. Its presence distinguishes
@@ -189,46 +182,17 @@ export const PREFERRED_CODEGRAPH_DIR = '.peaks/.codegraph';
 export const CODEGRAPH_MARKER_NAME = '.peaks-loop-marker';
 export const CODEGRAPH_INIT_CONFLICT_EXIT_CODE = 73;
 /**
- * Slice rid-CG-003 — pure resolver that returns the cwd the
- * upstream codegraph binary should be spawned with and the
- * absolute path to the data directory it should read/write.
- *
- * Precedence:
- *   1. `<projectRoot>/.peaks/.codegraph/` exists → use it
- *      (cwd = `<projectRoot>/.peaks`, codegraphDir = preferred path)
- *   2. `<projectRoot>/.codegraph/` exists → fall back to legacy
- *      (cwd = `<projectRoot>`, codegraphDir = legacy path)
- *   3. neither exists → default to the preferred path so the next
- *      `peaks codegraph init` lands in `.peaks/.codegraph/`
- *      (cwd = `<projectRoot>/.peaks`, codegraphDir = preferred path,
- *       `source: 'fresh-preferred'`)
- *
- * The cwd is the directory the upstream binary treats as "project
- * root" — the binary's default codegraph discovery reads
- * `<cwd>/.codegraph/`, so we always set cwd to the PARENT of the
- * resolved codegraph dir. Pure fs check; no IO beyond `existsSync`.
+ * Root-only resolver: peaks-loop always manages
+ * `<projectRoot>/.codegraph/`. Returns the cwd the upstream codegraph
+ * binary should be spawned with (= project root, so the binary's
+ * default discovery reads `<projectRoot>/.codegraph/`) and the
+ * absolute data-dir path. Pure path computation; no fs IO.
  */
 export function resolveCodegraphProjectRoot(projectRoot) {
-    const preferredDir = join(projectRoot, PREFERRED_CODEGRAPH_DIR);
-    const legacyDir = join(projectRoot, CODEGRAPH_DIR_NAME);
-    if (existsSync(preferredDir)) {
-        return {
-            source: 'preferred',
-            cwd: join(projectRoot, '.peaks'),
-            codegraphDir: preferredDir
-        };
-    }
-    if (existsSync(legacyDir)) {
-        return {
-            source: 'legacy',
-            cwd: projectRoot,
-            codegraphDir: legacyDir
-        };
-    }
     return {
-        source: 'fresh-preferred',
-        cwd: join(projectRoot, '.peaks'),
-        codegraphDir: preferredDir
+        source: 'root',
+        cwd: projectRoot,
+        codegraphDir: join(projectRoot, CODEGRAPH_DIR_NAME)
     };
 }
 export class CodegraphInitConflictError extends Error {
@@ -264,23 +228,16 @@ function inspectCandidateCodegraphDir(codegraphDir) {
     return { status: 'conflict-foreign-schema', codegraphDir };
 }
 /**
- * Slice rid-CG-003 — preferred-path-first init guard.
- *
- * Looks at `.peaks/.codegraph/` first; falls back to `.codegraph/`
- * when the preferred path is absent. The 'fresh' case returns the
- * preferred path so the next `peaks codegraph init` lands inside
- * `.peaks/` instead of polluting the project root.
+ * Root-only init guard: probes `<projectRoot>/.codegraph/`. 'fresh'
+ * is returned when the directory does not exist yet, so the next
+ * `peaks codegraph init` creates the root `.codegraph/` directory.
  */
 export function defaultCodegraphInitGuard(projectRoot) {
-    const preferredDir = join(projectRoot, PREFERRED_CODEGRAPH_DIR);
-    const legacyDir = join(projectRoot, CODEGRAPH_DIR_NAME);
-    if (existsSync(preferredDir)) {
-        return inspectCandidateCodegraphDir(preferredDir);
-    }
-    if (existsSync(legacyDir)) {
-        return inspectCandidateCodegraphDir(legacyDir);
+    const codegraphDir = join(projectRoot, CODEGRAPH_DIR_NAME);
+    if (!existsSync(codegraphDir)) {
+        return { status: 'fresh', codegraphDir };
     }
-    return { status: 'fresh', codegraphDir: preferredDir };
+    return inspectCandidateCodegraphDir(codegraphDir);
 }
 /**
  * Pure-fs helper that stamps the peaks-loop marker AFTER a

package/dist/services/context/auto-compact-reader.d.ts

@@ -1,14 +1,50 @@
+/**
+ * AC-1 — auto context-percent probe.
+ *
+ * Reads the current AI CLI context-fill ratio without requiring the
+ * LLM to pass `--prompt-size <bytes>` manually. Strategy: ask the
+ * registered `IdeAdapter.compact` profile which env-var to read and,
+ * when that misses, ask the adapter for a vendor-specific fallback —
+ * no hard-coded IDE names. Per-adapter:
+ *
+ *   - claude-code: its adapter-declared env-var (MVP) + a
+ *     `readContextPercentFallback` that polls the statusline /
+ *     transcript (see claude-code-adapter.ts).
+ *   - trae / codex / cursor / qoder / tongyi-lingma / hermes /
+ *     openclaw / zcode: each adapter fills its own env-var; until
+ *     L2-dogfood verifies each surface, adapters may omit `compact`
+ *     and the probe returns `source: 'conservative-fallback'`.
+ *
+ * Resolution order (user-overridden → env-var → adapter fallback →
+ * conservative-fallback):
+ *   1. `promptSizeBytes` (P0 `--prompt-size <bytes>` escape hatch) →
+ *      `source: 'user-overridden'`.
+ *   2. `adapter.compact.envVarForContextPercent` env-var →
+ *      `source: '<ideId>-env'`.
+ *   3. `adapter.compact.readContextPercentFallback?.(input)` — the
+ *      adapter owns any vendor-specific statusline / transcript probe.
+ *   4. `ratio: 0` with `source: 'conservative-fallback'` — the
+ *      orchestrator MUST NOT auto-fire compact on this signal.
+ */
 import type { ContextPercentProbe } from './auto-compact-types.js';
 export interface ReadContextPercentInput {
     readonly projectRoot: string;
     readonly sessionId: string;
+    /**
+     * Outer (harness / IDE) session id — the id the IDE uses to name its
+     * transcript / session files. Resolved by the caller (env signal → bound
+     * session meta) and passed through to the adapter's
+     * `readContextPercentFallback`. Optional: when unresolved, the adapter
+     * fallback returns null → conservative-fallback.
+     */
+    readonly outerSessionId?: string | undefined;
     readonly env?: NodeJS.ProcessEnv | undefined;
     /**
      * Slice 2026-07-31-rid-002: explicit byte count from `--prompt-size <bytes>`.
      * When set to a finite non-negative number, short-circuits the entire
      * env / statusline / transcript chain with `source: 'user-overridden'`.
-     * Mac escape hatch — Claude Code Mac does NOT inject
-     * `CLAUDE_CONTEXT_USAGE_PERCENT` into PreToolUse sub-shells, so the
+     * Mac escape hatch — some IDEs (e.g. Claude Code on macOS) do NOT
+     * inject their context-percent env-var into PreToolUse sub-shells, so the
      * user (or a hook wrapper) can inject the bytes they observed themselves.
      * Priority P0 — above everything else.
      */
@@ -21,60 +57,20 @@ export interface ReadContextPercentInput {
  * so the function itself has no hard-coded IDE names.
  */
 declare function readEnvPercent(env: NodeJS.ProcessEnv, varName: string): number | null;
-/**
- * Read the IDE-specific statusline state. MVP path is Claude Code's
- * `~/.claude/statusline-state.json`; other IDEs are intentionally
- * left for future slices (each IDE will expose its own
- * `compact.postCompactDetectCommand` to drive this).
- */
-declare function readClaudeStatuslinePercent(): number | null;
-/**
- * Recursive search for `<sessionId>.jsonl` under `projectsDir`. Used by
- * `readClaudeTranscriptFallback` and exported via `_internal` so unit
- * tests can drive it without monkey-patching `os.homedir` (which is
- * non-configurable in ESM module namespaces).
- *
- * The Mac layout encodes the cwd as a single hash directory; on Mac
- * Claude Code nests the transcript under that hash with an extra level
- * of subdirectory we cannot predict ahead of time. A flat readdir misses
- * that branch and returns null — the silent-failure mode that this fix
- * closes.
- */
-declare function findTranscriptJsonl(projectsDir: string, sessionId: string): {
-    path: string;
-    bytes: number;
-} | null;
-/**
- * Conservative transcript-size fallback. Recursively searches
- * `~/.claude/projects/<hash>/<sid-or-nested>.jsonl` (Mac may nest
- *  the jsonl under an
- * extra directory we cannot predict ahead of time) and estimates
- * `ratio = bytesUsed / 256K`. Returns the bytes seen so the
- * orchestrator can show "estimated from 124KB of 256KB transcript"
- * in the envelope. Tagged `'transcript-estimate'` (v2.14.0) so callers
- * know it is a real signal, NOT a hard gate.
- */
-declare function readClaudeTranscriptFallback(sessionId: string): {
-    ratio: number;
-    bytes: number;
-} | null;
 /**
  * Probe the current AI CLI's context-fill ratio. Adapter-driven:
  * looks up the registered `IdeAdapter.compact` profile via
- * `getIdeAdapter(detectIdeFromEnv(env))` and reads the
- * adapter-declared env-var. Falls back to statusline poll +
- * transcript estimate ONLY for adapters that opt in
- * (`adapter.id === 'claude-code'` for the MVP); other adapters
- * without an env-var hit return `source: 'conservative-fallback'`
- * with `ratio: 0` so the orchestrator never auto-fires on a
- * missing signal.
+ * `getAdapter(detectIdeFromEnv(env))` and reads the
+ * adapter-declared env-var. When that misses, delegates to the
+ * adapter's optional `readContextPercentFallback` (which owns any
+ * vendor-specific statusline / transcript probe). Adapters without a
+ * fallback (or a fallback that returns null) yield
+ * `source: 'conservative-fallback'` with `ratio: 0` so the
+ * orchestrator never auto-fires on a missing signal.
  */
 export declare function readContextPercent(input: ReadContextPercentInput): ContextPercentProbe;
 /** Re-export the env-var probe for unit tests. */
 export declare const _internal: {
     readEnvPercent: typeof readEnvPercent;
-    readClaudeStatuslinePercent: typeof readClaudeStatuslinePercent;
-    readClaudeTranscriptFallback: typeof readClaudeTranscriptFallback;
-    findTranscriptJsonl: typeof findTranscriptJsonl;
 };
 export {};

package/dist/services/context/auto-compact-reader.js

@@ -1,30 +1,3 @@
-/**
- * AC-1 — auto context-percent probe.
- *
- * Reads the current AI CLI context-fill ratio without requiring the
- * LLM to pass `--prompt-size <bytes>` manually. Strategy: ask the
- * registered `IdeAdapter.compact` profile which env-var to read;
- * no hard-coded IDE names. Per-adapter:
- *
- *   - claude-code: `CLAUDE_CONTEXT_USAGE_PERCENT` (MVP)
- *   - trae / codex / cursor / qoder / tongyi-lingma / hermes /
- *     openclaw: each adapter fills its own env-var; until L2-dogfood
- *     verifies each surface, adapters may omit `compact` and the
- *     probe returns `source: 'conservative-fallback'`.
- *
- * Fallback chain (when adapter.compact is undefined OR the env-var
- * is missing):
- *   1. statusline poll (`~/.claude/statusline-state.json` for
- *      Claude Code MVP; other IDEs register their own poll path
- *      by exposing `compact.postCompactDetectCommand`).
- *   2. Conservative transcript-size estimate
- *      (`~/.claude/projects/<hash>/<sid>.jsonl` for Claude Code).
- *   3. `ratio: 0` with `source: 'conservative-fallback'` — the
- *      orchestrator MUST NOT auto-fire compact on this signal.
- */
-import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
 import { detectIdeFromEnv } from './ide-detect.js';
 import { getAdapter } from '../ide/ide-registry.js';
 /**
@@ -44,106 +17,16 @@ function readEnvPercent(env, varName) {
         return null;
     return Math.max(0, Math.min(1, parsed));
 }
-/**
- * Read the IDE-specific statusline state. MVP path is Claude Code's
- * `~/.claude/statusline-state.json`; other IDEs are intentionally
- * left for future slices (each IDE will expose its own
- * `compact.postCompactDetectCommand` to drive this).
- */
-function readClaudeStatuslinePercent() {
-    const path = join(homedir(), '.claude', 'statusline-state.json');
-    if (!existsSync(path))
-        return null;
-    try {
-        const json = JSON.parse(readFileSync(path, 'utf8'));
-        const candidates = ['contextPercent', 'context_usage_percent', 'contextPercentUsed'];
-        for (const key of candidates) {
-            const raw = json[key];
-            if (typeof raw === 'number' && Number.isFinite(raw)) {
-                return raw > 1.5 ? raw / 100 : Math.max(0, Math.min(1, raw));
-            }
-        }
-    }
-    catch (err) { // TODO(g2): legacy silent catch — now narrows to IO errors only (grace: 1 minor release, v2.14.0)
-        if (err instanceof ReferenceError)
-            throw err; // surface module-load bugs
-        if (err instanceof SyntaxError)
-            throw err; // surface parse bugs (e.g. broken statusline JSON)
-        return null; // only swallow IO errors
-    }
-    return null;
-}
-/**
- * Recursive search for `<sessionId>.jsonl` under `projectsDir`. Used by
- * `readClaudeTranscriptFallback` and exported via `_internal` so unit
- * tests can drive it without monkey-patching `os.homedir` (which is
- * non-configurable in ESM module namespaces).
- *
- * The Mac layout encodes the cwd as a single hash directory; on Mac
- * Claude Code nests the transcript under that hash with an extra level
- * of subdirectory we cannot predict ahead of time. A flat readdir misses
- * that branch and returns null — the silent-failure mode that this fix
- * closes.
- */
-function findTranscriptJsonl(projectsDir, sessionId) {
-    if (!existsSync(projectsDir))
-        return null;
-    try {
-        const stack = [projectsDir];
-        while (stack.length > 0) {
-            const dir = stack.pop();
-            if (dir === undefined)
-                break;
-            const entries = readdirSync(dir, { withFileTypes: true });
-            for (const entry of entries) {
-                const full = join(dir, entry.name);
-                if (entry.isDirectory()) {
-                    stack.push(full);
-                }
-                else if (entry.isFile() && entry.name === `${sessionId}.jsonl`) {
-                    const bytes = statSync(full).size;
-                    return { path: full, bytes };
-                }
-            }
-        }
-    }
-    catch (err) { // TODO(g2): legacy silent catch — now narrows to IO errors only (grace: 1 minor release, v2.14.0)
-        if (err instanceof ReferenceError)
-            throw err; // surface module-load bugs
-        if (err instanceof SyntaxError)
-            throw err; // surface parse bugs
-        return null; // only swallow IO errors
-    }
-    return null;
-}
-/**
- * Conservative transcript-size fallback. Recursively searches
- * `~/.claude/projects/<hash>/<sid-or-nested>.jsonl` (Mac may nest
- *  the jsonl under an
- * extra directory we cannot predict ahead of time) and estimates
- * `ratio = bytesUsed / 256K`. Returns the bytes seen so the
- * orchestrator can show "estimated from 124KB of 256KB transcript"
- * in the envelope. Tagged `'transcript-estimate'` (v2.14.0) so callers
- * know it is a real signal, NOT a hard gate.
- */
-function readClaudeTranscriptFallback(sessionId) {
-    const projectsDir = join(homedir(), '.claude', 'projects');
-    const hit = findTranscriptJsonl(projectsDir, sessionId);
-    if (hit === null)
-        return null;
-    const ratio = Math.min(1, hit.bytes / (256 * 1024));
-    return { ratio, bytes: hit.bytes };
-}
 /**
  * Probe the current AI CLI's context-fill ratio. Adapter-driven:
  * looks up the registered `IdeAdapter.compact` profile via
- * `getIdeAdapter(detectIdeFromEnv(env))` and reads the
- * adapter-declared env-var. Falls back to statusline poll +
- * transcript estimate ONLY for adapters that opt in
- * (`adapter.id === 'claude-code'` for the MVP); other adapters
- * without an env-var hit return `source: 'conservative-fallback'`
- * with `ratio: 0` so the orchestrator never auto-fires on a
- * missing signal.
+ * `getAdapter(detectIdeFromEnv(env))` and reads the
+ * adapter-declared env-var. When that misses, delegates to the
+ * adapter's optional `readContextPercentFallback` (which owns any
+ * vendor-specific statusline / transcript probe). Adapters without a
+ * fallback (or a fallback that returns null) yield
+ * `source: 'conservative-fallback'` with `ratio: 0` so the
+ * orchestrator never auto-fires on a missing signal.
  */
 export function readContextPercent(input) {
     const env = input.env ?? process.env;
@@ -158,7 +41,7 @@ export function readContextPercent(input) {
     // through `unknown` to IdeId's wider 8-element set.
     const ideId = (detected === 'unknown' ? 'claude-code' : detected);
     const adapter = getAdapter(ideId);
-    // P0 user-overridden takes priority over env / statusline / transcript.
+    // P0 user-overridden takes priority over env / fallback / transcript.
     // Mac escape hatch: when the CLI/helper passes `--prompt-size <bytes>`,
     // honor that number directly. Do NOT read env, statusline, or transcript
     // — user intent always wins. Negative / non-finite values are ignored
@@ -176,8 +59,8 @@ export function readContextPercent(input) {
             capturedAt
         };
     }
-    // Primary: read the adapter-declared env-var (no hard-coded IDE names).
     if (adapter.compact) {
+        // Primary: read the adapter-declared env-var (no hard-coded IDE names).
         const primary = readEnvPercent(env, adapter.compact.envVarForContextPercent);
         if (primary !== null) {
             return {
@@ -188,27 +71,17 @@ export function readContextPercent(input) {
                 capturedAt
             };
         }
-    }
-    // MVP-only fallback chain: statusline poll + transcript estimate.
-    // Non-MVP adapters that don't fill `compact` skip this and return
-    // a conservative-zero probe (the orchestrator will stay in
-    // 'none' / 'soft-warn' zone and never auto-fire compact).
-    if (ideId === 'claude-code') {
-        const statusline = readClaudeStatuslinePercent();
-        if (statusline !== null) {
-            return { ratio: statusline, source: 'statusline-poll', capacityBytes, ide: ideId, capturedAt };
-        }
-        const fallback = readClaudeTranscriptFallback(input.sessionId);
-        if (fallback !== null) {
-            return {
-                ratio: fallback.ratio,
-                source: 'transcript-estimate',
-                rawBytes: fallback.bytes,
-                capacityBytes,
-                ide: ideId,
-                capturedAt
-            };
-        }
+        // Fallback: the adapter owns any vendor-specific statusline /
+        // transcript probe. When it returns a probe, honor it; otherwise
+        // fall through to conservative-fallback.
+        const fallback = adapter.compact.readContextPercentFallback?.({
+            projectRoot: input.projectRoot,
+            sessionId: input.sessionId,
+            outerSessionId: input.outerSessionId,
+            env
+        });
+        if (fallback)
+            return fallback;
     }
     // No signal available — return `ratio: 0` so the orchestrator
     // stays in `none` zone and the LLM can still pass `--prompt-size`
@@ -216,4 +89,4 @@ export function readContextPercent(input) {
     return { ratio: 0, source: 'conservative-fallback', capacityBytes, ide: ideId, capturedAt };
 }
 /** Re-export the env-var probe for unit tests. */
-export const _internal = { readEnvPercent, readClaudeStatuslinePercent, readClaudeTranscriptFallback, findTranscriptJsonl };
+export const _internal = { readEnvPercent };