peaks-loop 4.1.1 → 4.1.3

package/dist/services/ide/adapters/claude-code-adapter.js

@@ -1,7 +1,16 @@
-import { closeSync, existsSync, openSync, readFileSync, readSync, readdirSync, statSync } from 'node:fs';
+import { closeSync, openSync, readSync, statSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 import { claudeCodeSubAgentDispatcher } from '../../dispatch/sub-agent-dispatcher.js';
+import { findTranscriptJsonl, readClaudeStatuslinePercent, resolveClaudeTranscriptPath } from './claude-code-local-state.js';
+import { DEFAULT_CONTEXT_WINDOW_TOKENS, ONE_MILLION_CONTEXT_TOKENS, modelContextWindowTokens, resolveClaudeModelFromEnv } from './claude-code-model-window.js';
+// Re-exported so the public surface of this module is unchanged by the split:
+// the readers live in `claude-code-local-state.ts` now, but every existing
+// importer keeps resolving them from here.
+export { resolveClaudeTranscriptPath };
+// Likewise the model-id / window-size pair, which moved into
+// `claude-code-model-window.ts` to make room for `mcpInstall` below.
+export { modelContextWindowTokens, resolveClaudeModelFromEnv };
 /**
  * Claude Code adapter —— peaks-loop 的"起源 IDE"。
  *
@@ -9,7 +18,6 @@ import { claudeCodeSubAgentDispatcher } from '../../dispatch/sub-agent-dispatche
  * 字节级兼容:用户在 Claude Code 环境下跑 `peaks hooks install` 产出的
  * `.claude/settings.json` 与 refactor 前逐字节相同。
  *
- * 字段解释(见 PRD AC-1):
  *   - dirName = '.claude'           : Claude Code 项目根下的 settings 目录
  *   - settingsFileName = 'settings.json'
  *   - envVar = 'CLAUDE_PROJECT_DIR' : Claude Code 注入的 env 变量,用于 ${...} 占位
@@ -18,183 +26,9 @@ import { claudeCodeSubAgentDispatcher } from '../../dispatch/sub-agent-dispatche
  *
  * 不可消除的 per-IDE 字段(见 tech-doc.md §1.3)。
  */
-/**
- * Read Claude Code's statusline state file
- * (`~/.claude/statusline-state.json`) and parse a context-percent key.
- * Moved from the generic reader in slice
- * 2026-09-02-vendor-neutral-context-probe — Claude-specific paths now live
- * only in the Claude Code adapter.
- */
-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 `<outerSessionId>.jsonl` under `projectsDir`. 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 this recursion closes.
- *
- * Moved from the generic reader in slice
- * 2026-09-02-vendor-neutral-context-probe. The lookup key is the OUTER
- * session id (Claude Code names its transcript by the outer session UUID),
- * NOT the peaks session id.
- */
-function findTranscriptJsonl(projectsDir, outerSessionId) {
-    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 === `${outerSessionId}.jsonl`) {
-                    return full;
-                }
-            }
-        }
-    }
-    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;
-}
-/**
- * Resolve the absolute path of a Claude Code transcript jsonl by OUTER
- * session id, searching `~/.claude/projects/**` recursively.
- *
- * Exported (slice 2026-09-10-context-audit-and-discipline, Slice A) so
- * `peaks code context-audit` reuses THIS locator instead of re-implementing
- * the recursive find. Returns `null` when the transcript does not exist —
- * callers MUST treat that as "unavailable", never as an error.
- */
-export function resolveClaudeTranscriptPath(outerSessionId, projectsDir = join(homedir(), '.claude', 'projects')) {
-    if (typeof outerSessionId !== 'string' || outerSessionId.length === 0)
-        return null;
-    return findTranscriptJsonl(projectsDir, outerSessionId);
-}
-/** 1M-context window size in tokens (documented single choice: 1,000,000). */
-const ONE_MILLION_CONTEXT_TOKENS = 1_000_000;
-/** Safe-default (non-1M) context window size in tokens. */
-const DEFAULT_CONTEXT_WINDOW_TOKENS = 200_000;
 /** Reverse-scan chunk size in bytes (keeps memory bounded on multi-MB transcripts). */
 const TRANSCRIPT_SCAN_CHUNK_BYTES = 64 * 1024;
 /**
- * Known 1M-context Claude model id prefixes whose ids do NOT carry a `1m`
- * suffix (e.g. `claude-sonnet-4-5-20250929`). The substring match is
- * intentionally generous — every `claude-sonnet-4*` / `claude-opus-4*`
- * variant is 1M-context.
- */
-const ONE_MILLION_CONTEXT_MODELS = ['claude-opus-4', 'claude-sonnet-4'];
-/**
- * Claude Code runtime env vars that may carry the currently-active model id,
- * in documented precedence order (first non-empty value wins):
- *   1. ANTHROPIC_MODEL                — explicit per-run model override
- *   2. ANTHROPIC_DEFAULT_OPUS_MODEL   — default Opus fallback
- *   3. ANTHROPIC_DEFAULT_SONNET_MODEL — default Sonnet fallback
- *   4. ANTHROPIC_DEFAULT_HAIKU_MODEL  — default Haiku fallback
- *   5. ANTHROPIC_DEFAULT_FABLE_MODEL  — default Fable fallback
- *   6. CLAUDE_CODE_SUBAGENT_MODEL     — sub-agent model (used when the others
- *                                       are absent, e.g. a sub-agent-only env)
- *
- * Why env-first: the transcript's `message.model` often drops Claude Code's
- * `[1M]` / `[200K]` suffix marker (observed: `deepseek-v4-flash`), while the
- * runtime env vars above carry it (`deepseek-v4-flash[1M]`). Reading them
- * first lets the window resolver see the true context window. This family is
- * vendor-specific, so it lives ONLY in the claude-code adapter.
- */
-const CLAUDE_CODE_MODEL_ENV_VARS = [
-    'ANTHROPIC_MODEL',
-    'ANTHROPIC_DEFAULT_OPUS_MODEL',
-    'ANTHROPIC_DEFAULT_SONNET_MODEL',
-    'ANTHROPIC_DEFAULT_HAIKU_MODEL',
-    'ANTHROPIC_DEFAULT_FABLE_MODEL',
-    'CLAUDE_CODE_SUBAGENT_MODEL'
-];
-/**
- * Resolve the currently-active Claude Code model id from a runtime env map.
- * Returns the first non-empty `CLAUDE_CODE_MODEL_ENV_VARS` value (trimmed), or
- * `undefined` when none is present. Pure + exported for tests; the caller falls
- * back to the transcript `message.model` when this returns undefined.
- */
-export function resolveClaudeModelFromEnv(env) {
-    if (!env)
-        return undefined;
-    for (const name of CLAUDE_CODE_MODEL_ENV_VARS) {
-        const value = env[name];
-        if (typeof value === 'string') {
-            const trimmed = value.trim();
-            if (trimmed.length > 0)
-                return trimmed;
-        }
-    }
-    return undefined;
-}
-/**
- * Model-aware context-window size in tokens.
- *
- * Detection rule (documented):
- *   1. Empty / unknown model → DEFAULT_CONTEXT_WINDOW_TOKENS (200_000).
- *   2. Suffix heuristic — a model id containing `1m` (case-insensitive) is
- *      treated as 1M-context.
- *   3. Explicit allowlist — known 1M Claude model ids
- *      (ONE_MILLION_CONTEXT_MODELS).
- *   4. Everything else → 200_000 (the safe default).
- *
- * Callers MAY additionally infer ≥1M from the observed token count: if
- * `contextTokens > DEFAULT_CONTEXT_WINDOW_TOKENS`, the model cannot be a
- * 200K model and must be ≥1M (see `readClaudeTranscriptEstimate`).
- *
- * This is the HEURISTIC layer only. Explicit user overrides sit ABOVE it —
- * see `resolveContextWindow`, which is what the probe actually calls.
- */
-export function modelContextWindowTokens(model) {
-    const m = model.trim().toLowerCase();
-    if (m.length === 0)
-        return DEFAULT_CONTEXT_WINDOW_TOKENS;
-    if (m.includes('1m'))
-        return ONE_MILLION_CONTEXT_TOKENS;
-    for (const known of ONE_MILLION_CONTEXT_MODELS) {
-        if (m.includes(known))
-            return ONE_MILLION_CONTEXT_TOKENS;
-    }
-    return DEFAULT_CONTEXT_WINDOW_TOKENS;
-}
-/**
- * Slice 2026-09-09-context-window-override: vendor-neutral escape hatch for
  * the context-window size in tokens. Third-party / proxied models whose id
  * carries no `[1M]` suffix (and is absent from the hardcoded allowlist) are
  * otherwise stuck at the 200K default, which inflates `ratio` up to 5×.
@@ -203,7 +37,6 @@ export function modelContextWindowTokens(model) {
  */
 export const CONTEXT_WINDOW_TOKENS_ENV_VAR = 'PEAKS_CONTEXT_WINDOW_TOKENS';
 /**
- * E2 (rid 2026-09-13-defects-e) — the notice for a pin larger than
  * peaks-loop's model-window estimate. `null` when there is nothing to say.
  *
  * WHY THIS EXISTS. The harness does not take its auto-compact window on faith:
@@ -273,7 +106,6 @@ export function parseContextWindowOverride(raw) {
  * An invalid explicit override is ignored with a warning and falls through
  * to the next layer — a typo must never crash or silently win the probe.
  *
- * Slice 2026-09-13-auto-compact-trigger-ownership — why layer 3 exists:
  *   The hard constraint is that the window peaks-loop divides by must BE the
  *   window it configured for the harness. Layer 3 is peaks-loop's own output
  *   read back from the harness's settings file, so the two sides reference one
@@ -564,7 +396,6 @@ function readContextPercentFallback(input) {
         const estimate = readClaudeTranscriptEstimate(input.outerSessionId, envModel, {
             env: input.env,
             configWindowTokens: input.configWindowTokens,
-            // Slice 2026-09-13-auto-compact-trigger-ownership: the window
             // peaks-loop configured for the harness outranks config + heuristic
             // (see `resolveContextWindow`). The generic reader resolved it from the
             // adapter's own declarations — this module never names the key.
@@ -610,6 +441,44 @@ export const CLAUDE_CODE_ADAPTER = {
     envVar: 'CLAUDE_PROJECT_DIR',
     hookEvent: 'PreToolUse',
     toolMatcher: 'Bash',
+    // BOTH channels a peaks MCP server can reach this harness through. The hook
+    // entry installed below covers the pair, and the pre-tool branch matches
+    // against the pair; one template would leave the other channel unenforced and
+    // nobody would notice, because a matcher that never fires looks like a clean
+    // call.
+    mcp: {
+        toolNameTemplates: ['mcp__peaks__*', 'mcp__plugin_peaks-loop_peaks__*']
+    },
+    // How this harness REGISTERS a peaks MCP server. The entry
+    // is the harness's OWN verb, not a hand-edit of its config file, which is
+    // full of the user's state (spec §8.3). The shape is recorded in spec §13 —
+    // it is read off that table, not invented here:
+    //   - the `--` before the server argv is LOAD-BEARING: everything after it is
+    //     passed to the server verbatim, otherwise the harness reads the server's
+    //     own flags as its own;
+    //   - the verb is NOT idempotent — same name, same scope fails, with no
+    //     `--force` and no `update` — which is why the engine removes first.
+    // `scopes` is `user` alone: that is the scope a peaks install writes (spec
+    // §8.4), and sweeping a scope peaks never wrote would delete a user's own
+    // entry under the same name.
+    mcpInstall: {
+        serverName: 'peaks',
+        scopes: ['user'],
+        targetScope: 'user',
+        addArgv: [
+            'claude',
+            'mcp',
+            'add',
+            '--scope',
+            '<scope>',
+            '--transport',
+            'stdio',
+            '<name>',
+            '--',
+            '<server-argv>'
+        ],
+        removeArgv: ['claude', 'mcp', 'remove', '<name>', '--scope', '<scope>']
+    },
     // Slice #009: Claude Code uses the `Task` tool for sub-agent dispatch.
     // The CLI calls `claudeCodeSubAgentDispatcher.buildToolCall` to construct
     // the exact args shape the `Task` tool expects.
@@ -623,7 +492,6 @@ export const CLAUDE_CODE_ADAPTER = {
         gateEnforce: true,
         statusline: true
     },
-    // v2.13.0 AC-1 + AC-3 MVP, slice 2026-07-02-auto-compact-zero-pause:
     // Claude Code is the first IDE to fill the `compact` profile.
     // Future adapters (trae / codex / cursor / qoder / tongyi-lingma /
     // hermes / openclaw) follow the same shape — peaks-loop reads the
@@ -648,7 +516,6 @@ export const CLAUDE_CODE_ADAPTER = {
         compactCommand: 'claude --compact',
         compactPathway: 'ide-native',
         postCompactDetectCommand: 'peaks code auto-compact --json',
-        // Slice 2026-09-13-auto-compact-trigger-ownership: the key Claude Code
         // reads its auto-compact WINDOW from, in the machine-local `env` block.
         // Claude Code documents it as taking precedence "over the command, the
         // flag, and the setting", and as accepting the plain token count only
@@ -657,7 +524,6 @@ export const CLAUDE_CODE_ADAPTER = {
         // `harness-window-config.ts`.
         autoCompactWindowEnvVar: 'CLAUDE_CODE_AUTO_COMPACT_WINDOW',
         readContextPercentFallback,
-        // Slice 2026-09-10-context-audit-and-discipline (Slice A): the vendor
         // layout knowledge (`~/.claude/projects/**/<outerSessionId>.jsonl`)
         // stays here; `peaks code context-audit` resolves it through the
         // adapter registry, never by naming this adapter directly.

package/dist/services/ide/adapters/claude-code-local-state.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Read Claude Code's statusline state file
+ * (`~/.claude/statusline-state.json`) and parse a context-percent key.
+ * Moved from the generic reader in slice
+ * only in the Claude Code adapter.
+ */
+export declare function readClaudeStatuslinePercent(): number | null;
+/**
+ * Recursive search for `<outerSessionId>.jsonl` under `projectsDir`. 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 this recursion closes.
+ *
+ * Moved from the generic reader in slice
+ * session id (Claude Code names its transcript by the outer session UUID),
+ * NOT the peaks session id.
+ */
+export declare function findTranscriptJsonl(projectsDir: string, outerSessionId: string): string | null;
+/**
+ * Resolve the absolute path of a Claude Code transcript jsonl by OUTER
+ * session id, searching `~/.claude/projects/**` recursively.
+ *
+ * `peaks code context-audit` reuses THIS locator instead of re-implementing
+ * the recursive find. Returns `null` when the transcript does not exist —
+ * callers MUST treat that as "unavailable", never as an error.
+ */
+export declare function resolveClaudeTranscriptPath(outerSessionId: string, projectsDir?: string): string | null;

package/dist/services/ide/adapters/claude-code-local-state.js

@@ -0,0 +1,112 @@
+// src/services/ide/adapters/claude-code-local-state.ts
+//
+// The readers for Claude Code's OWN on-disk state — its statusline state file and
+// its transcript directory layout. Split out of `claude-code-adapter.ts`,
+// verbatim and with one import apiece, because that file sits far past the
+// 300-line cap and the repo's size ratchet only ever goes down: the adapter
+// needs room for new declared surface, and a self-contained reader leaving is
+// how a file earns that room instead of raising the ceiling.
+//
+// Nothing here is peaks-loop state. Every path below belongs to the harness, and
+// every function tolerates its absence by answering `null` — a machine without a
+// statusline file is not a broken machine.
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Above this, a stored value is a percentage rather than a 0–1 fraction. Both
+ * spellings occur in the wild, and nothing needs to know which one the harness
+ * picked.
+ */
+const PERCENT_VERSUS_FRACTION = 1.5;
+/**
+ * Read Claude Code's statusline state file
+ * (`~/.claude/statusline-state.json`) and parse a context-percent key.
+ * Moved from the generic reader in slice
+ * only in the Claude Code adapter.
+ */
+export 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 > PERCENT_VERSUS_FRACTION ? 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;
+}
+/** One directory's worth of the walk: recurse into directories, return a matching file. */
+function scanForFile(dir, fileName, pending) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            pending.push(full);
+        }
+        else if (entry.isFile() && entry.name === fileName) {
+            return full;
+        }
+    }
+    return null;
+}
+/**
+ * Recursive search for `<outerSessionId>.jsonl` under `projectsDir`. 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 this recursion closes.
+ *
+ * Moved from the generic reader in slice
+ * session id (Claude Code names its transcript by the outer session UUID),
+ * NOT the peaks session id.
+ */
+export function findTranscriptJsonl(projectsDir, outerSessionId) {
+    if (!existsSync(projectsDir))
+        return null;
+    const pending = [projectsDir];
+    try {
+        while (pending.length > 0) {
+            const dir = pending.pop();
+            if (dir === undefined)
+                continue;
+            const found = scanForFile(dir, `${outerSessionId}.jsonl`, pending);
+            if (found !== null)
+                return found;
+        }
+    }
+    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;
+}
+/**
+ * Resolve the absolute path of a Claude Code transcript jsonl by OUTER
+ * session id, searching `~/.claude/projects/**` recursively.
+ *
+ * `peaks code context-audit` reuses THIS locator instead of re-implementing
+ * the recursive find. Returns `null` when the transcript does not exist —
+ * callers MUST treat that as "unavailable", never as an error.
+ */
+export function resolveClaudeTranscriptPath(outerSessionId, projectsDir = join(homedir(), '.claude', 'projects')) {
+    if (typeof outerSessionId !== 'string' || outerSessionId.length === 0)
+        return null;
+    return findTranscriptJsonl(projectsDir, outerSessionId);
+}

package/dist/services/ide/adapters/claude-code-model-window.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 1M-context window size in tokens (documented single choice: 1,000,000).
+ * EXPORTED because the adapter's late 1M rescue (`resolveContextWindowTokens`)
+ * names it too — one number, one declaration, rather than a copy that can drift.
+ */
+export declare const ONE_MILLION_CONTEXT_TOKENS = 1000000;
+/**
+ * Safe-default (non-1M) context window size in tokens. Exported for the same
+ * reason: `resolveContextWindow` compares the heuristic against it.
+ */
+export declare const DEFAULT_CONTEXT_WINDOW_TOKENS = 200000;
+/**
+ * Resolve the currently-active Claude Code model id from a runtime env map.
+ * Returns the first non-empty `CLAUDE_CODE_MODEL_ENV_VARS` value (trimmed), or
+ * `undefined` when none is present. Pure + exported for tests; the caller falls
+ * back to the transcript `message.model` when this returns undefined.
+ */
+export declare function resolveClaudeModelFromEnv(env: NodeJS.ProcessEnv | undefined): string | undefined;
+/**
+ * Model-aware context-window size in tokens.
+ *
+ * Detection rule (documented):
+ *   1. Empty / unknown model → DEFAULT_CONTEXT_WINDOW_TOKENS (200_000).
+ *   2. Suffix heuristic — a model id containing `1m` (case-insensitive) is
+ *      treated as 1M-context.
+ *   3. Explicit allowlist — known 1M Claude model ids
+ *      (ONE_MILLION_CONTEXT_MODELS).
+ *   4. Everything else → 200_000 (the safe default).
+ *
+ * Callers MAY additionally infer ≥1M from the observed token count: if
+ * `contextTokens > DEFAULT_CONTEXT_WINDOW_TOKENS`, the model cannot be a
+ * 200K model and must be ≥1M (see `readClaudeTranscriptEstimate`).
+ *
+ * This is the HEURISTIC layer only. Explicit user overrides sit ABOVE it —
+ * see `resolveContextWindow`, which is what the probe actually calls.
+ */
+export declare function modelContextWindowTokens(model: string): number;

package/dist/services/ide/adapters/claude-code-model-window.js

@@ -0,0 +1,113 @@
+// src/services/ide/adapters/claude-code-model-window.ts
+//
+// Which Claude Code model is active, and how many tokens its context window
+// holds. Those are the two questions `resolveClaudeModelFromEnv` and
+// `modelContextWindowTokens` answer, and they are the pair that left
+// `claude-code-adapter.ts`: that file is far past the
+// 300-line cap, the repo's size ratchet only ever goes down, and the adapter
+// needed room for its `mcpInstall` declaration. Same technique, and the same
+// reason, as the `claude-code-local-state.ts` split before it — a self-contained
+// responsibility leaves, instead of the ceiling going up.
+//
+// WHY THIS BLOCK AND NOT ANOTHER. Both functions are PURE: the env map is an
+// argument, and nothing here reads a file, an env var or a process global. So
+// the move needs no rewiring in either direction — the adapter imports both
+// back and nothing here reaches for the adapter — which is what keeps the move
+// a move. It is also the one block in that file whose eslint findings are zero,
+// which a receiving file with no baseline row must be.
+//
+// The vendor spellings below (`ANTHROPIC_*`, `claude-opus-4`) are Claude Code's
+// own. An adapter is the only place they belong (spec §13), which is why this is
+// a second adapter module and not a shared one.
+/**
+ * 1M-context window size in tokens (documented single choice: 1,000,000).
+ * EXPORTED because the adapter's late 1M rescue (`resolveContextWindowTokens`)
+ * names it too — one number, one declaration, rather than a copy that can drift.
+ */
+export const ONE_MILLION_CONTEXT_TOKENS = 1_000_000;
+/**
+ * Safe-default (non-1M) context window size in tokens. Exported for the same
+ * reason: `resolveContextWindow` compares the heuristic against it.
+ */
+export const DEFAULT_CONTEXT_WINDOW_TOKENS = 200_000;
+/**
+ * Known 1M-context Claude model id prefixes whose ids do NOT carry a `1m`
+ * suffix (e.g. `claude-sonnet-4-5-20250929`). The substring match is
+ * intentionally generous — every `claude-sonnet-4*` / `claude-opus-4*`
+ * variant is 1M-context.
+ */
+const ONE_MILLION_CONTEXT_MODELS = ['claude-opus-4', 'claude-sonnet-4'];
+/**
+ * Claude Code runtime env vars that may carry the currently-active model id,
+ * in documented precedence order (first non-empty value wins):
+ *   1. ANTHROPIC_MODEL                — explicit per-run model override
+ *   2. ANTHROPIC_DEFAULT_OPUS_MODEL   — default Opus fallback
+ *   3. ANTHROPIC_DEFAULT_SONNET_MODEL — default Sonnet fallback
+ *   4. ANTHROPIC_DEFAULT_HAIKU_MODEL  — default Haiku fallback
+ *   5. ANTHROPIC_DEFAULT_FABLE_MODEL  — default Fable fallback
+ *   6. CLAUDE_CODE_SUBAGENT_MODEL     — sub-agent model (used when the others
+ *                                       are absent, e.g. a sub-agent-only env)
+ *
+ * Why env-first: the transcript's `message.model` often drops Claude Code's
+ * `[1M]` / `[200K]` suffix marker (observed: `deepseek-v4-flash`), while the
+ * runtime env vars above carry it (`deepseek-v4-flash[1M]`). Reading them
+ * first lets the window resolver see the true context window. This family is
+ * vendor-specific, so it lives ONLY in the claude-code adapter.
+ */
+const CLAUDE_CODE_MODEL_ENV_VARS = [
+    'ANTHROPIC_MODEL',
+    'ANTHROPIC_DEFAULT_OPUS_MODEL',
+    'ANTHROPIC_DEFAULT_SONNET_MODEL',
+    'ANTHROPIC_DEFAULT_HAIKU_MODEL',
+    'ANTHROPIC_DEFAULT_FABLE_MODEL',
+    'CLAUDE_CODE_SUBAGENT_MODEL'
+];
+/**
+ * Resolve the currently-active Claude Code model id from a runtime env map.
+ * Returns the first non-empty `CLAUDE_CODE_MODEL_ENV_VARS` value (trimmed), or
+ * `undefined` when none is present. Pure + exported for tests; the caller falls
+ * back to the transcript `message.model` when this returns undefined.
+ */
+export function resolveClaudeModelFromEnv(env) {
+    if (!env)
+        return undefined;
+    for (const name of CLAUDE_CODE_MODEL_ENV_VARS) {
+        const value = env[name];
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            if (trimmed.length > 0)
+                return trimmed;
+        }
+    }
+    return undefined;
+}
+/**
+ * Model-aware context-window size in tokens.
+ *
+ * Detection rule (documented):
+ *   1. Empty / unknown model → DEFAULT_CONTEXT_WINDOW_TOKENS (200_000).
+ *   2. Suffix heuristic — a model id containing `1m` (case-insensitive) is
+ *      treated as 1M-context.
+ *   3. Explicit allowlist — known 1M Claude model ids
+ *      (ONE_MILLION_CONTEXT_MODELS).
+ *   4. Everything else → 200_000 (the safe default).
+ *
+ * Callers MAY additionally infer ≥1M from the observed token count: if
+ * `contextTokens > DEFAULT_CONTEXT_WINDOW_TOKENS`, the model cannot be a
+ * 200K model and must be ≥1M (see `readClaudeTranscriptEstimate`).
+ *
+ * This is the HEURISTIC layer only. Explicit user overrides sit ABOVE it —
+ * see `resolveContextWindow`, which is what the probe actually calls.
+ */
+export function modelContextWindowTokens(model) {
+    const m = model.trim().toLowerCase();
+    if (m.length === 0)
+        return DEFAULT_CONTEXT_WINDOW_TOKENS;
+    if (m.includes('1m'))
+        return ONE_MILLION_CONTEXT_TOKENS;
+    for (const known of ONE_MILLION_CONTEXT_MODELS) {
+        if (m.includes(known))
+            return ONE_MILLION_CONTEXT_TOKENS;
+    }
+    return DEFAULT_CONTEXT_WINDOW_TOKENS;
+}

package/dist/services/ide/adapters/qoder-adapter.d.ts

@@ -1,5 +1,4 @@
 /**
- * Qoder IDE adapter (slice 2026-07-25-qoder-adapter-ship) — peaks-loop
  * 第八个内置 IDE 适配器(填表)。
  *
  * 不可消除的 per-IDE 字段(本 slice 填表;字段值暂为占位):
@@ -9,14 +8,12 @@
  *   - hookEvent = 'PreToolUse'             : 现代 IDE 通用约定(UNVERIFIED — 待真实 Qoder 安装验证)
  *   - toolMatcher = 'Bash'                 : 同上(UNVERIFIED)
  *
- * Slice 2026-07-25-qoder-adapter-ship 状态:
  *   - Slim adapter shape 跟 hermes-adapter.ts / claude-code-adapter.ts 同型,
  *     验证 slice #1 抽出的形状在第 8 个 IDE 上仍然可以"填表"接入。
  *   - 5 fields (dirName / settingsFileName / envVar / hookEvent / toolMatcher)
  *     均为占位值并标记 UNVERIFIED;待真实 Qoder 安装可用后再走 VERIFIED 路径
  *     (见 PRD §3 step 5 + 多 IDE 治理政策
  *     .peaks/memory/2026-07-24-multi-ide-adapter-policy.md)。
- *   - 见 [[2026-07-24-multi-ide-adapter-policy]] 了解 UNVERIFIED → VERIFIED
  *     的迁移路径与 7-step checklist。
  *   - 本 slice 不修改 src/services/ide/ide-types.ts(IdeId union 已经在
  *     line 21 包含 'qoder'),不修改既有 adapter 文件,不修改既有测试。

package/dist/services/ide/adapters/qoder-adapter.js

@@ -1,5 +1,4 @@
 /**
- * Qoder IDE adapter (slice 2026-07-25-qoder-adapter-ship) — peaks-loop
  * 第八个内置 IDE 适配器(填表)。
  *
  * 不可消除的 per-IDE 字段(本 slice 填表;字段值暂为占位):
@@ -9,14 +8,12 @@
  *   - hookEvent = 'PreToolUse'             : 现代 IDE 通用约定(UNVERIFIED — 待真实 Qoder 安装验证)
  *   - toolMatcher = 'Bash'                 : 同上(UNVERIFIED)
  *
- * Slice 2026-07-25-qoder-adapter-ship 状态:
  *   - Slim adapter shape 跟 hermes-adapter.ts / claude-code-adapter.ts 同型,
  *     验证 slice #1 抽出的形状在第 8 个 IDE 上仍然可以"填表"接入。
  *   - 5 fields (dirName / settingsFileName / envVar / hookEvent / toolMatcher)
  *     均为占位值并标记 UNVERIFIED;待真实 Qoder 安装可用后再走 VERIFIED 路径
  *     (见 PRD §3 step 5 + 多 IDE 治理政策
  *     .peaks/memory/2026-07-24-multi-ide-adapter-policy.md)。
- *   - 见 [[2026-07-24-multi-ide-adapter-policy]] 了解 UNVERIFIED → VERIFIED
  *     的迁移路径与 7-step checklist。
  *   - 本 slice 不修改 src/services/ide/ide-types.ts(IdeId union 已经在
  *     line 21 包含 'qoder'),不修改既有 adapter 文件,不修改既有测试。
@@ -38,12 +35,10 @@ export const QODER_ADAPTER = {
     envVar: 'QODER_PROJECT_DIR', // UNVERIFIED
     hookEvent: 'PreToolUse', // UNVERIFIED
     toolMatcher: 'Bash', // UNVERIFIED
-    // Slice 2026-07-25-qoder-adapter-ship: Qoder sub-agent dispatcher UNVERIFIED —
     // pending real Qoder dogfood. Reusing the Trae dispatcher as a uniform
     // placeholder (same rationale as hermes-adapter.ts: byte-stable shape
     // across placeholder adapters).
     subAgentDispatcher: traeSubAgentDispatcher,
-    // Slice 2026-07-25-qoder-adapter-ship: Qoder PreToolUse is the assumed hook
     // path. UNVERIFIED — will be re-evaluated against a real Qoder install.
     promptSizeAware: true,
     installHints: ['Restart Qoder (or reload the workspace) so the PreToolUse hooks take effect.'],

package/dist/services/ide/adapters/tongyi-lingma-adapter.d.ts

@@ -1,5 +1,4 @@
 /**
- * Tongyi Lingma IDE adapter (slice 2026-07-25-tongyi-lingma-adapter-ship) —
  * peaks-loop 第九个内置 IDE 适配器(填表)。
  *
  * 不可消除的 per-IDE 字段(本 slice 填表;字段值暂为占位):
@@ -10,7 +9,6 @@
  *   - toolMatcher = 'Bash'                         (UNVERIFIED)
  *
  * 这些字段在真实 Tongyi Lingma 安装 dogfood 完成前不得标记 VERIFIED。
- * 见 [[2026-07-24-multi-ide-adapter-policy]] §3 step 5。
  */
 import type { IdeAdapter } from '../ide-types.js';
 export declare const TONGYI_LINGMA_ADAPTER: IdeAdapter;