peaks-loop 4.0.0-beta.7 → 4.0.0-beta.8

package/dist/src/services/ide/current-model-detector.js

@@ -1,60 +0,0 @@
-/**
- * Runtime current-model detector (Slice 2026-07-09 add-zcode-adapter, Slice C).
- *
- * Walks the registered IDE adapter chain and asks the IDE adapter
- * (when it opts in via `IdeAdapter.detectCurrentModel?`) to report the
- * currently-active model id. This is the runtime sibling of
- * `getStrongestModelId(config)` in `src/services/config/model-routing.ts`:
- *
- *   - `getStrongestModelId(config)` reads `config.model` (user-set) and
- *     falls back to the env-var / `'claude-opus-4-7'` constant. Sync.
- *   - `detectCurrentIdeModel()` reads the IDE's runtime state (which
- *     provider UI is active, which model the picker shows). Async.
- *
- * The CLI surface `peaks ide model --current` (added in this slice)
- * delegates here. The future async resolver at
- * `getStrongestModelIdAsync` (Slice C §C.4) calls this so config-less
- * runs (e.g. an LLM inside z-code) can derive the strongest model from
- * its actual environment.
- *
- * Vendor-neutrality notes (SC-3 §5 + RD-3 §2.4):
- *   - This file never names a vendor (no "claude", "zcode", etc.).
- *   - It only walks `IdeAdapter.detectCurrentModel?` — any adapter
- *     can opt in.
- *   - It returns `undefined` when detection is unavailable; callers
- *     must fall back to the configured / hardcoded model.
- */
-import { getAdapter } from './ide-registry.js';
-import { listAdapterIds } from './ide-registry.js';
-/**
- * Probe every registered IDE adapter for its currently-active model
- * id. Returns the first non-empty value found in registration order,
- * or `undefined` when no adapter opts in / all opted-in adapters
- * return undefined.
- *
- * Registration order: see `ide-registry.ts` ADAPTERS Map. The IDE
- * adapter for `claude-code` is consulted first; only `zcode` opts in
- * to this slice's detection (other adapters will return undefined).
- *
- * Async because each IDE adapter's detectCurrentModel may read local
- * disk or env on a slow filesystem.
- */
-export async function detectCurrentIdeModel() {
-    for (const id of listAdapterIds()) {
-        const adapter = getAdapter(id);
-        if (typeof adapter.detectCurrentModel !== 'function')
-            continue;
-        try {
-            const modelId = await adapter.detectCurrentModel();
-            if (typeof modelId === 'string' && modelId.trim().length > 0) {
-                return modelId.trim();
-            }
-        }
-        catch {
-            // Per-SC §3.4: detection is best-effort. Swallow errors so a
-            // misconfigured adapter cannot poison the chain; the next
-            // adapter still gets a chance.
-        }
-    }
-    return undefined;
-}

package/dist/src/services/ide/hook-protocol.d.ts

@@ -1,47 +0,0 @@
-import { PEAKS_HOOK_SCHEMA, type IdeId, type PeaksCanonicalHook, type PeaksDecisionTransport } from './ide-types.js';
-export { PEAKS_HOOK_SCHEMA };
-export type { PeaksCanonicalHook, PeaksDecisionTransport };
-/**
- * Compute the deny decision shape for Claude Code (the only adapter registered
- * in slice #1). The output is a JSON object that, when written to stdout, makes
- * the Claude Code permission system block the tool call BEFORE the user's
- * permission prompt — un-bypassable, even under --dangerously-skip-permissions.
- */
-export declare const CLAUDE_CODE_DENY_SHAPE: Record<string, unknown>;
-export declare const CLAUDE_CODE_DENY_TRANSPORT: PeaksDecisionTransport;
-/**
- * Compute the deny decision shape for Trae (Cursor-style sibling IDE).
- * VERIFIED against Trae 1.x fixture — slice 009-009-2026-06-07-trae-dogfood (2026-06-07).
- * Shape is the standard Cursor/Claude sibling envelope: `hookSpecificOutput`
- * with `hookEventName`, `permissionDecision`, `permissionDecisionReason`.
- * The hookEventName is `'beforeToolCall'` for Trae vs `'PreToolUse'` for
- * Claude Code — the only field that differs between the two siblings.
- * Fixture: tests/fixtures/trae/trae-1x-payload.json. Constant NAME preserved
- * (per slice 009 PRD R-3); only the shape was already correct from slice #3.
- */
-export declare const TRAE_DENY_SHAPE: Record<string, unknown>;
-export declare const TRAE_DENY_TRANSPORT: PeaksDecisionTransport;
-/**
- * Format a decision response for a given IDE. Slice #1 handles Claude Code;
- * slice #3 added Trae (1.x-assumption shape — see TRAE_DENY_SHAPE doc).
- * Future slices will add exit-code / both variants for IDEs that don't read
- * stdout.
- */
-export declare function formatDecisionResponse(ide: IdeId, decision: 'allow' | 'deny', reason?: string): {
-    stdout: string;
-    exitCode: number;
-};
-/**
- * Build a peaks canonical hook from a parsed stdin payload. Caller has already
- * done stdin parsing + IDE auto-detection; this function normalizes to the
- * canonical schema.
- */
-export interface BuildCanonicalHookInput {
-    readonly toolName: string;
-    readonly toolInput: Record<string, unknown>;
-    readonly projectRoot: string;
-    readonly rawIdeFormat: IdeId;
-    readonly rawPayload: unknown;
-    readonly event?: PeaksCanonicalHook['event'];
-}
-export declare function buildCanonicalHook(input: BuildCanonicalHookInput): PeaksCanonicalHook;

package/dist/src/services/ide/hook-protocol.js

@@ -1,74 +0,0 @@
-import { PEAKS_HOOK_SCHEMA } from './ide-types.js';
-export { PEAKS_HOOK_SCHEMA };
-/**
- * Compute the deny decision shape for Claude Code (the only adapter registered
- * in slice #1). The output is a JSON object that, when written to stdout, makes
- * the Claude Code permission system block the tool call BEFORE the user's
- * permission prompt — un-bypassable, even under --dangerously-skip-permissions.
- */
-export const CLAUDE_CODE_DENY_SHAPE = {
-    hookSpecificOutput: {
-        hookEventName: 'PreToolUse',
-        permissionDecision: 'deny',
-        permissionDecisionReason: '__REASON__' // replaced at format time
-    }
-};
-export const CLAUDE_CODE_DENY_TRANSPORT = {
-    kind: 'stdout-json',
-    denyShape: CLAUDE_CODE_DENY_SHAPE
-};
-/**
- * Compute the deny decision shape for Trae (Cursor-style sibling IDE).
- * VERIFIED against Trae 1.x fixture — slice 009-009-2026-06-07-trae-dogfood (2026-06-07).
- * Shape is the standard Cursor/Claude sibling envelope: `hookSpecificOutput`
- * with `hookEventName`, `permissionDecision`, `permissionDecisionReason`.
- * The hookEventName is `'beforeToolCall'` for Trae vs `'PreToolUse'` for
- * Claude Code — the only field that differs between the two siblings.
- * Fixture: tests/fixtures/trae/trae-1x-payload.json. Constant NAME preserved
- * (per slice 009 PRD R-3); only the shape was already correct from slice #3.
- */
-export const TRAE_DENY_SHAPE = {
-    hookSpecificOutput: {
-        hookEventName: 'beforeToolCall',
-        permissionDecision: 'deny',
-        permissionDecisionReason: '__REASON__' // replaced at format time
-    }
-};
-export const TRAE_DENY_TRANSPORT = {
-    kind: 'stdout-json',
-    denyShape: TRAE_DENY_SHAPE
-};
-/**
- * Format a decision response for a given IDE. Slice #1 handles Claude Code;
- * slice #3 added Trae (1.x-assumption shape — see TRAE_DENY_SHAPE doc).
- * Future slices will add exit-code / both variants for IDEs that don't read
- * stdout.
- */
-export function formatDecisionResponse(ide, decision, reason) {
-    if (decision === 'allow') {
-        return { stdout: '', exitCode: 0 };
-    }
-    let shape;
-    if (ide === 'claude-code') {
-        shape = CLAUDE_CODE_DENY_SHAPE;
-    }
-    else if (ide === 'trae') {
-        shape = TRAE_DENY_SHAPE;
-    }
-    else {
-        throw new Error(`formatDecisionResponse: unsupported IDE ${ide} (not registered in adapter registry; future slice will add support)`);
-    }
-    const filled = JSON.stringify(shape).replace('"__REASON__"', JSON.stringify(reason ?? 'denied'));
-    return { stdout: filled, exitCode: 0 };
-}
-export function buildCanonicalHook(input) {
-    return {
-        schema: PEAKS_HOOK_SCHEMA,
-        event: input.event ?? 'pre-tool-use',
-        toolName: input.toolName,
-        toolInput: input.toolInput,
-        projectRoot: input.projectRoot,
-        rawIdeFormat: input.rawIdeFormat,
-        rawPayload: input.rawPayload
-    };
-}

package/dist/src/services/ide/hook-translator.d.ts

@@ -1,72 +0,0 @@
-import type { IdeId } from './ide-types.js';
-/**
- * hook-translator —— peaks 自有 hook 协议的核心。
- *
- * 单一职责:把 IDE 私有 stdin 形态归一化到 peaks canonical schema;把 peaks 决策
- * 格式化回 IDE 期望的 stdout/exit-code 形态。
- *
- * auto-detection 算法(优先级从高到低):
- *   1. env 变量:CLAUDE_PROJECT_DIR / TRAE_PROJECT_DIR / CODEX_PROJECT_DIR / ...
- *   2. stdin shape:`{ tool_name, tool_input }` 是 Claude / Trae;
- *                `{ toolName, toolInput }` 是 Cursor;
- *                `{ eventName, parameters }` 是 Trae 另形态
- *   3. cwd 启发式:存在 .claude / .trae / .codex / .cursor 目录
- *   4. fallback:`claude-code`(backward compat,见 PRD preserved behavior #10)
- */
-export interface DetectFromStdinInput {
-    readonly env: NodeJS.ProcessEnv;
-    readonly cwd: string;
-    /** 已解析的 stdin 形态;null = 空 stdin 或非 JSON */
-    readonly parsedStdin: unknown;
-}
-/**
- * Detect the originating IDE from env / stdin shape / cwd heuristics.
- * Falls back to 'claude-code' (PRD preserved behavior: backward compat).
- */
-export declare function detectIdeFromContext(input: DetectFromStdinInput): IdeId;
-/**
- * Pluck a string value at a nested path. Returns undefined if any segment is
- * missing or non-object. Used by adapter-driven stdin parsers.
- */
-export declare function pluckString(obj: unknown, path: readonly string[]): string | undefined;
-export declare function pluckObject(obj: unknown, path: readonly string[]): Record<string, unknown> | undefined;
-/**
- * Default stdin parser for adapters that follow the Claude Code shape
- * (most LLM-style IDEs do: tool_name at top, tool_input.{command} inside).
- */
-export declare function parseClaudeShapeStdin(parsed: unknown): {
-    toolName?: string;
-    command?: string;
-};
-/**
- * Trae stdin parser. UNVERIFIED — Trae 1.x's actual stdin envelope shape is
- * assumed to be Cursor-style (eventName at top, parameters nested), based on
- * slice #2's read of Trae as a "Cursor sibling". When a real Trae 1.x hook
- * payload is dogfooded, this parser is the seam to update.
- *
- * Shape (assumed):
- *   { eventName: 'beforeToolCall', parameters: { command: 'rm -rf /' } }
- *
- * Returns the same `{ toolName, command }` shape as parseClaudeShapeStdin so
- * downstream code (buildCanonicalHook, enforceBashCommand) does not need to
- * branch on IDE. The `toolName` here is the IDE-specific name (e.g.
- * 'terminal'); callers may normalize it to the canonical 'Bash' if needed.
- */
-export declare function parseTraeShapeStdin(parsed: unknown): {
-    toolName?: string;
-    command?: string;
-};
-/**
- * Per-adapter stdin parser dispatch. Returns the `{ toolName, command }` pair
- * for the given IDE, regardless of which stdin shape the IDE actually emits.
- *
- * The dispatch table is keyed on `IdeId` (not stdin shape) so an adapter can
- * change its wire format without breaking the hook-handle flow. Unknown IDEs
- * fall back to the Claude parser — that preserves the slice #1 "fail-open to
- * Claude" behavior so a future adapter that has not yet been added does not
- * crash the hook runtime.
- */
-export declare function parseAdapterStdin(ide: IdeId, parsed: unknown): {
-    toolName?: string;
-    command?: string;
-};

package/dist/src/services/ide/hook-translator.js

@@ -1,128 +0,0 @@
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { getAdapter, listAdapterIds } from './ide-registry.js';
-/**
- * Detect the originating IDE from env / stdin shape / cwd heuristics.
- * Falls back to 'claude-code' (PRD preserved behavior: backward compat).
- */
-export function detectIdeFromContext(input) {
-    // 1. env 变量优先级最高。Iterate ONLY over currently-registered adapters
-    // so the function does not throw on unregistered IDEs while future slices
-    // progressively add trae / codex / cursor / qoder / tongyi-lingma.
-    for (const adapter of listAdapterIds()) {
-        const a = getAdapter(adapter);
-        if (input.env[a.envVar] !== undefined) {
-            return adapter;
-        }
-    }
-    // 2. stdin shape
-    if (isObject(input.parsedStdin)) {
-        if ('tool_name' in input.parsedStdin || 'tool_input' in input.parsedStdin) {
-            return 'claude-code';
-        }
-        if ('toolName' in input.parsedStdin || 'toolInput' in input.parsedStdin) {
-            return 'cursor';
-        }
-        if ('eventName' in input.parsedStdin || 'parameters' in input.parsedStdin) {
-            return 'trae';
-        }
-    }
-    // 3. cwd 启发式。Same registration-aware iteration as step 1.
-    for (const adapter of listAdapterIds()) {
-        const a = getAdapter(adapter);
-        if (existsSync(join(input.cwd, a.settings.dirName))) {
-            return adapter;
-        }
-    }
-    // 4. fallback
-    return 'claude-code';
-}
-/**
- * Pluck a string value at a nested path. Returns undefined if any segment is
- * missing or non-object. Used by adapter-driven stdin parsers.
- */
-export function pluckString(obj, path) {
-    let cur = obj;
-    for (const seg of path) {
-        if (!isObject(cur) || !(seg in cur))
-            return undefined;
-        cur = cur[seg];
-    }
-    return typeof cur === 'string' ? cur : undefined;
-}
-export function pluckObject(obj, path) {
-    let cur = obj;
-    for (const seg of path) {
-        if (!isObject(cur) || !(seg in cur))
-            return undefined;
-        cur = cur[seg];
-    }
-    return isObject(cur) ? cur : undefined;
-}
-function isObject(v) {
-    return v !== null && typeof v === 'object' && !Array.isArray(v);
-}
-/**
- * Default stdin parser for adapters that follow the Claude Code shape
- * (most LLM-style IDEs do: tool_name at top, tool_input.{command} inside).
- */
-export function parseClaudeShapeStdin(parsed) {
-    if (!isObject(parsed))
-        return {};
-    const toolName = pluckString(parsed, ['tool_name']);
-    const command = pluckString(parsed, ['tool_input', 'command']);
-    const result = {};
-    if (toolName !== undefined)
-        result.toolName = toolName;
-    if (command !== undefined)
-        result.command = command;
-    return result;
-}
-/**
- * Trae stdin parser. UNVERIFIED — Trae 1.x's actual stdin envelope shape is
- * assumed to be Cursor-style (eventName at top, parameters nested), based on
- * slice #2's read of Trae as a "Cursor sibling". When a real Trae 1.x hook
- * payload is dogfooded, this parser is the seam to update.
- *
- * Shape (assumed):
- *   { eventName: 'beforeToolCall', parameters: { command: 'rm -rf /' } }
- *
- * Returns the same `{ toolName, command }` shape as parseClaudeShapeStdin so
- * downstream code (buildCanonicalHook, enforceBashCommand) does not need to
- * branch on IDE. The `toolName` here is the IDE-specific name (e.g.
- * 'terminal'); callers may normalize it to the canonical 'Bash' if needed.
- */
-export function parseTraeShapeStdin(parsed) {
-    if (!isObject(parsed))
-        return {};
-    const eventName = pluckString(parsed, ['eventName']);
-    const command = pluckString(parsed, ['parameters', 'command']);
-    const result = {};
-    // Trae sends the event name in the payload (`eventName: 'beforeToolCall'`)
-    // and the tool name on the parameters (e.g. `parameters.tool: 'terminal'`).
-    // We expose the event name as the "toolName" for now since Trae has not
-    // been observed to carry a top-level tool field. Future slice can split
-    // event vs tool if the real shape requires it.
-    if (eventName !== undefined)
-        result.toolName = eventName;
-    if (command !== undefined)
-        result.command = command;
-    return result;
-}
-/**
- * Per-adapter stdin parser dispatch. Returns the `{ toolName, command }` pair
- * for the given IDE, regardless of which stdin shape the IDE actually emits.
- *
- * The dispatch table is keyed on `IdeId` (not stdin shape) so an adapter can
- * change its wire format without breaking the hook-handle flow. Unknown IDEs
- * fall back to the Claude parser — that preserves the slice #1 "fail-open to
- * Claude" behavior so a future adapter that has not yet been added does not
- * crash the hook runtime.
- */
-export function parseAdapterStdin(ide, parsed) {
-    if (ide === 'trae')
-        return parseTraeShapeStdin(parsed);
-    // Future adapters (codex, cursor, qoder, tongyi-lingma) — branch here when
-    // their adapters are registered. Until then, fall back to Claude shape.
-    return parseClaudeShapeStdin(parsed);
-}

package/dist/src/services/ide/ide-detector.d.ts

@@ -1,10 +0,0 @@
-import type { IdeId } from './ide-types.js';
-/**
- * Detect which IDE a given project root is using, by looking for the IDE's
- * settings directory (`.claude`, `.trae`, etc.). Returns the first match in
- * adapter insertion order, or `null` if no adapter's directory is present.
- *
- * 启发式:基于 cwd 目录存在性。CLI 后续 slice 会扩展为 env 变量检测、settings
- * 文件内容检测、显式 `--ide` flag 覆盖等。
- */
-export declare function detectInstalledIde(projectRoot: string): IdeId | null;

package/dist/src/services/ide/ide-detector.js

@@ -1,19 +0,0 @@
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { listAdapters } from './ide-registry.js';
-/**
- * Detect which IDE a given project root is using, by looking for the IDE's
- * settings directory (`.claude`, `.trae`, etc.). Returns the first match in
- * adapter insertion order, or `null` if no adapter's directory is present.
- *
- * 启发式:基于 cwd 目录存在性。CLI 后续 slice 会扩展为 env 变量检测、settings
- * 文件内容检测、显式 `--ide` flag 覆盖等。
- */
-export function detectInstalledIde(projectRoot) {
-    for (const adapter of listAdapters()) {
-        if (existsSync(join(projectRoot, adapter.settings.dirName))) {
-            return adapter.id;
-        }
-    }
-    return null;
-}

package/dist/src/services/ide/ide-registry.d.ts

@@ -1,14 +0,0 @@
-import type { IdeAdapter, IdeId } from './ide-types.js';
-/** Get the adapter for a given IDE id. Throws on unsupported IDE. */
-export declare function getAdapter(ide: IdeId): IdeAdapter;
-/** All registered adapter ids (insertion order). */
-export declare function listAdapterIds(): readonly IdeId[];
-/** All registered adapters (insertion order). */
-export declare function listAdapters(): readonly IdeAdapter[];
-/**
- * Test seam: register or replace an adapter. Used by future slices when adding
- * a new IDE. Caller is responsible for ensuring the adapter is well-formed.
- */
-export declare function _setAdapterForTesting(ide: IdeId, adapter: IdeAdapter): void;
-/** Test seam: reset to built-in defaults. */
-export declare function _resetAdaptersForTesting(): void;

package/dist/src/services/ide/ide-registry.js

@@ -1,63 +0,0 @@
-import { CLAUDE_CODE_ADAPTER } from './adapters/claude-code-adapter.js';
-import { TRAE_ADAPTER } from './adapters/trae-adapter.js';
-import { CURSOR_ADAPTER } from './adapters/cursor-adapter.js';
-import { CODEX_ADAPTER } from './adapters/codex-adapter.js';
-import { HERMES_ADAPTER } from './adapters/hermes-adapter.js';
-import { OPENCLAW_ADAPTER } from './adapters/openclaw-adapter.js';
-import { ZCODE_ADAPTER } from './adapters/zcode-adapter.js';
-/**
- * Built-in IDE adapter registry。Map<IdeId, IdeAdapter> 是单一来源。
- *
- * Slice #1 注册 claude-code。
- * Slice #2 注册 trae —— 这是 slice #1 抽出的 IdeAdapter 形状的
- * 第一个真实客户,验证"填表"承诺。
- * 后续 slice 注入 codex / cursor / qoder / tongyi-lingma 时,只需在此
- * Map 加条目 —— 所有 adapter 使用方(hook-translator、hooks install、statusline
- * install、mcp apply)通过 `getAdapter(ide)` 拿取,无需修改。
- * Slice #0.7 注入 hermes + openclaw。
- * Slice #12 (2.4.0) 注册 cursor。
- * Slice #13 (2.4.0) 注册 codex。
- */
-const ADAPTERS = new Map([
-    ['claude-code', CLAUDE_CODE_ADAPTER],
-    ['trae', TRAE_ADAPTER],
-    ['cursor', CURSOR_ADAPTER],
-    ['codex', CODEX_ADAPTER],
-    ['hermes', HERMES_ADAPTER],
-    ['openclaw', OPENCLAW_ADAPTER],
-    ['zcode', ZCODE_ADAPTER],
-]);
-/** Get the adapter for a given IDE id. Throws on unsupported IDE. */
-export function getAdapter(ide) {
-    const adapter = ADAPTERS.get(ide);
-    if (!adapter) {
-        throw new Error(`Unsupported IDE: ${ide}. Registered: ${listAdapterIds().join(', ') || '(none)'}`);
-    }
-    return adapter;
-}
-/** All registered adapter ids (insertion order). */
-export function listAdapterIds() {
-    return Array.from(ADAPTERS.keys());
-}
-/** All registered adapters (insertion order). */
-export function listAdapters() {
-    return Array.from(ADAPTERS.values());
-}
-/**
- * Test seam: register or replace an adapter. Used by future slices when adding
- * a new IDE. Caller is responsible for ensuring the adapter is well-formed.
- */
-export function _setAdapterForTesting(ide, adapter) {
-    ADAPTERS.set(ide, adapter);
-}
-/** Test seam: reset to built-in defaults. */
-export function _resetAdaptersForTesting() {
-    ADAPTERS.clear();
-    ADAPTERS.set('claude-code', CLAUDE_CODE_ADAPTER);
-    ADAPTERS.set('trae', TRAE_ADAPTER);
-    ADAPTERS.set('cursor', CURSOR_ADAPTER);
-    ADAPTERS.set('codex', CODEX_ADAPTER);
-    ADAPTERS.set('hermes', HERMES_ADAPTER);
-    ADAPTERS.set('openclaw', OPENCLAW_ADAPTER);
-    ADAPTERS.set('zcode', ZCODE_ADAPTER);
-}