peaks-loop 4.0.0-beta.2 → 4.0.0-beta.20

package/dist/src/services/filesystem/file-lock.d.ts

@@ -1,11 +0,0 @@
-export declare class LockTimeoutError extends Error {
-    readonly code = "LOCK_TIMEOUT";
-    readonly lockPath: string;
-    constructor(lockPath: string, attempts: number);
-}
-/**
- * Run `fn` while holding an exclusive lock on a sidecar file at
- * `<filePath>.lock`. The lock is released in `finally` (close fd +
- * unlink lock file). Throws LockTimeoutError after MAX_LOCK_RETRIES.
- */
-export declare function withFileLockSync<T>(filePath: string, fn: () => T): T;

package/dist/src/services/filesystem/file-lock.js

@@ -1,129 +0,0 @@
-/**
- * Cross-process file lock — sync, atomic, no third-party deps.
- *
- * Used by writeSharedEntry (shared-channel.ts) and appendHeartbeat /
- * markCompleted (dispatch-record-writer.ts) to guard the
- * read-modify-write sequence against lost updates from concurrent
- * writers (slice 2026-06-23-audit-3rd finding #2 + #3).
- *
- * Mechanism: write a sidecar `.lock` file next to the target via
- * `fs.openSync(path, 'wx')`. The `wx` flag maps to O_CREAT|O_EXCL on
- * POSIX (atomic) and `CreateFileW(... CREATE_NEW)` on Windows (also
- * atomic). The second opener fails with EEXIST. We retry with capped
- * exponential backoff up to MAX_LOCK_RETRIES, falling through to
- * LOCK_TIMEOUT if the lock cannot be acquired.
- *
- * Stale-lock reaping: a crashed previous holder leaves a `.lock` file
- * behind. We reap locks older than LOCK_STALE_MS by unlinking before
- * retrying. This trades a one-time stale-lock window for bounded
- * recovery without leaking orphan locks.
- *
- * Why not fs.flock? Node's `fs.flock` is POSIX-only; on Windows it
- * throws ERR_FEATURE_UNAVAILABLE_ON_PLATFORM. The `.lock` file
- * pattern works uniformly across platforms and survives process
- * crashes (the file remains; the next acquirer reaps it).
- */
-import { closeSync, existsSync, mkdirSync, openSync, statSync, unlinkSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-const MAX_LOCK_RETRIES = 100;
-const LOCK_RETRY_BASE_MS = 5;
-const LOCK_RETRY_MAX_MS = 50;
-const LOCK_STALE_MS = 30_000;
-export class LockTimeoutError extends Error {
-    code = 'LOCK_TIMEOUT';
-    lockPath;
-    constructor(lockPath, attempts) {
-        super(`LOCK_TIMEOUT: failed to acquire ${lockPath} after ${attempts} retries ` +
-            `(a prior holder may be alive or the lock is stale; it will be reaped ` +
-            `after ${LOCK_STALE_MS}ms of inactivity)`);
-        this.lockPath = lockPath;
-    }
-}
-/**
- * Run `fn` while holding an exclusive lock on a sidecar file at
- * `<filePath>.lock`. The lock is released in `finally` (close fd +
- * unlink lock file). Throws LockTimeoutError after MAX_LOCK_RETRIES.
- */
-export function withFileLockSync(filePath, fn) {
-    const target = resolve(filePath);
-    const lockPath = `${target}.lock`;
-    // Ensure the parent dir exists before openSync('wx') — first-write
-    // callers (e.g. writeSharedEntry on a fresh batch) reach the lock
-    // BEFORE writeAtomic's mkdirSync(dir, { recursive: true }) runs.
-    const dir = dirname(target);
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    let attempts = 0;
-    let fd = null;
-    while (attempts < MAX_LOCK_RETRIES) {
-        // Stale-lock reap: if the lock file is older than LOCK_STALE_MS, the
-        // previous holder must have crashed. Unlink and retry without
-        // counting this attempt against MAX_LOCK_RETRIES (only EEXIST from
-        // a non-stale holder consumes a retry).
-        if (isStaleLock(lockPath)) {
-            try {
-                unlinkSync(lockPath);
-            }
-            catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-                // race: another process reaped it; loop and try to acquire.
-            }
-            continue;
-        }
-        try {
-            fd = openSync(lockPath, 'wx');
-            break;
-        }
-        catch (err) {
-            const code = err.code;
-            if (code !== 'EEXIST')
-                throw err;
-            attempts += 1;
-            // Exponential backoff capped at LOCK_RETRY_MAX_MS.
-            const wait = Math.min(LOCK_RETRY_BASE_MS * 2 ** Math.min(attempts, 6), LOCK_RETRY_MAX_MS);
-            spinSleep(wait);
-        }
-    }
-    if (fd === null) {
-        throw new LockTimeoutError(lockPath, attempts);
-    }
-    try {
-        return fn();
-    }
-    finally {
-        try {
-            closeSync(fd);
-        }
-        catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-            // fd may already be closed by the OS on a crash; ignore.
-        }
-        try {
-            unlinkSync(lockPath);
-        }
-        catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-            // Best-effort: stale .lock is harmless; the next acquirer reaps.
-        }
-    }
-}
-function isStaleLock(lockPath) {
-    try {
-        const s = statSync(lockPath);
-        return Date.now() - s.mtimeMs > LOCK_STALE_MS;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Synchronous sleep via busy-wait. Bounded by MAX_LOCK_RETRIES *
- * LOCK_RETRY_MAX_MS = 5s worst case. The alternative — async sleep —
- * would force every lock consumer to become async, which is a much
- * larger refactor for a slice whose lock contention is rare (concurrent
- * `peaks sub-agent share` for the same batch).
- */
-function spinSleep(ms) {
-    const end = Date.now() + ms;
-    while (Date.now() < end) {
-        /* intentional spin */
-    }
-}

package/dist/src/services/final-review/final-review-service.d.ts

@@ -1,12 +0,0 @@
-import type { LlmRunner } from '../audit/audit-goal-service.js';
-import type { FinalReviewOutput } from './final-review-types.js';
-export interface PrepareFinalReviewOptions {
-    readonly projectRoot: string;
-    readonly sessionId: string;
-    readonly llmRunner: LlmRunner;
-}
-export declare class IncompleteFinalReviewError extends Error {
-    readonly code: "INCOMPLETE_FINAL_REVIEW";
-    constructor(message: string);
-}
-export declare function prepareFinalReview(rid: string, opts: PrepareFinalReviewOptions): Promise<FinalReviewOutput>;

package/dist/src/services/final-review/final-review-service.js

@@ -1,52 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-const REQUIRED_DIMENSIONS = [
-    'functional-completeness',
-    'problem-resolution',
-    'no-new-bugs',
-    'existing-functionality-intact'
-];
-const SYSTEM_PROMPT = `You are preparing a 4-dimension business review for human acceptance. Produce a JSON response with EXACTLY these fields:
-- rid (string)
-- generatedAt (ISO timestamp)
-- dimensions (array of EXACTLY 4 objects, one per dimension: functional-completeness, problem-resolution, no-new-bugs, existing-functionality-intact; each with dimension, verdict (pass | fail | inconclusive), summary, evidence (list of {kind, description, [artifact], [link]}), confidence (high | medium | low))
-- overallSummary (one paragraph)
-- allPass (boolean)
-- needsAttention (list of dimension names that need human attention)
-
-Output ONLY valid JSON, no prose.`;
-export class IncompleteFinalReviewError extends Error {
-    code = 'INCOMPLETE_FINAL_REVIEW';
-    constructor(message) {
-        super(message);
-        this.name = 'IncompleteFinalReviewError';
-    }
-}
-export async function prepareFinalReview(rid, opts) {
-    const auditGoalPath = join(opts.projectRoot, '.peaks', '_runtime', opts.sessionId, 'audit-goal', `${rid}.json`);
-    let approvedGoal;
-    try {
-        approvedGoal = JSON.parse(readFileSync(auditGoalPath, 'utf8'));
-    }
-    catch (err) {
-        throw new Error(`Cannot read approved goal from ${auditGoalPath}: ${err.message}`);
-    }
-    const userPrompt = `Approved goal's success criteria: ${JSON.stringify(approvedGoal.successCriteria)}\n\nPrepare the 4-dim review evidence.`;
-    const response = await opts.llmRunner.call(SYSTEM_PROMPT, userPrompt, {
-        maxTokens: 3000
-    });
-    let parsed;
-    try {
-        parsed = JSON.parse(response.output);
-    }
-    catch (err) {
-        throw new IncompleteFinalReviewError(`LLM output is not valid JSON: ${err.message}`);
-    }
-    const output = parsed;
-    const presentDimensions = new Set(output.dimensions.map((d) => d.dimension));
-    const missing = REQUIRED_DIMENSIONS.filter(d => !presentDimensions.has(d));
-    if (missing.length > 0) {
-        throw new IncompleteFinalReviewError(`Missing required dimensions: ${missing.join(', ')}`);
-    }
-    return output;
-}

package/dist/src/services/final-review/final-review-types.d.ts

@@ -1,42 +0,0 @@
-/**
- * `prepareFinalReview()` — the 4-dimension business review primitive that gates
- * end-of-workflow human acceptance in the 10% human / 90% LLM workflow.
- *
- * Contract:
- *   - Reads the approved audit-goal JSON from
- *     `.peaks/_runtime/<sessionId>/audit-goal/<rid>.json`.
- *   - Calls an injected `LlmRunner` exactly once with a 4-dim review prompt.
- *   - Parses the LLM output as JSON and validates that the `dimensions`
- *     array covers ALL four required dimensions
- *     (functional-completeness, problem-resolution, no-new-bugs,
- *     existing-functionality-intact).
- *   - Throws `IncompleteFinalReviewError` if the JSON is malformed or any
- *     required dimension is missing. Callers MUST treat this as a gate
- *     failure (return to human for re-prompting) — autonomous work must
- *     never proceed on a partial review.
- */
-export type DimensionKind = 'functional-completeness' | 'problem-resolution' | 'no-new-bugs' | 'existing-functionality-intact';
-export type DimensionVerdict = 'pass' | 'fail' | 'inconclusive';
-export type EvidenceKind = 'test-result' | 'test-coverage' | 'manual-spot-check' | 'pre-post-diff' | 'regression-suite' | 'ac-mapping';
-export type DimensionConfidence = 'high' | 'medium' | 'low';
-export interface EvidenceItem {
-    readonly kind: EvidenceKind;
-    readonly description: string;
-    readonly artifact?: string;
-    readonly link?: string;
-}
-export interface DimensionEvidence {
-    readonly dimension: DimensionKind;
-    readonly verdict: DimensionVerdict;
-    readonly summary: string;
-    readonly evidence: readonly EvidenceItem[];
-    readonly confidence: DimensionConfidence;
-}
-export interface FinalReviewOutput {
-    readonly rid: string;
-    readonly generatedAt: string;
-    readonly dimensions: readonly DimensionEvidence[];
-    readonly overallSummary: string;
-    readonly allPass: boolean;
-    readonly needsAttention: readonly DimensionKind[];
-}

package/dist/src/services/final-review/final-review-types.js

@@ -1,18 +0,0 @@
-/**
- * `prepareFinalReview()` — the 4-dimension business review primitive that gates
- * end-of-workflow human acceptance in the 10% human / 90% LLM workflow.
- *
- * Contract:
- *   - Reads the approved audit-goal JSON from
- *     `.peaks/_runtime/<sessionId>/audit-goal/<rid>.json`.
- *   - Calls an injected `LlmRunner` exactly once with a 4-dim review prompt.
- *   - Parses the LLM output as JSON and validates that the `dimensions`
- *     array covers ALL four required dimensions
- *     (functional-completeness, problem-resolution, no-new-bugs,
- *     existing-functionality-intact).
- *   - Throws `IncompleteFinalReviewError` if the JSON is malformed or any
- *     required dimension is missing. Callers MUST treat this as a gate
- *     failure (return to human for re-prompting) — autonomous work must
- *     never proceed on a partial review.
- */
-export {};

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

@@ -1,60 +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';
-/**
- * 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],
-]);
-/** 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);
-}

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

@@ -1,230 +0,0 @@
-/**
- * peaks 自有 hook 协议 + slim IDE adapter 接口。
- *
- * peaks-loop 不再适配 IDE 私有的 hook 协议;反之 peaks 定义自己的 canonical
- * schema,每个 IDE 只需要填 4 字符串 + 1 settings 函数,新 IDE 适配变成"填表"。
- *
- * 不可消除的 per-IDE 字段(诚实交代,见 PRD R-1..R-4):
- *   - settings.json 物理位置
- *   - 项目根 env 变量名
- *   - hook 事件名 + matcher 名
- *
- * 其他全部归一化到 peaks 内部模型(见 hook-protocol.ts)。
- */
-import type { SubAgentDispatcher } from '../dispatch/sub-agent-dispatcher.js';
-export type IdeId = 'claude-code' | 'trae' | 'codex' | 'cursor' | 'qoder' | 'tongyi-lingma' | 'hermes' | 'openclaw';
-export interface IdeCapabilities {
-    /** peaks gate enforce 是否适用该 IDE(必备) */
-    readonly gateEnforce: true;
-    /** peaks statusline 状态栏是否适用 */
-    readonly statusline: boolean;
-}
-export interface IdeSettingsLocation {
-    /** 项目根下的 settings 目录名,例如 '.claude' / '.trae' / '.cursor' */
-    readonly dirName: string;
-    /** settings 文件名(部分 IDE 叫 settings.json / mcp.json) */
-    readonly settingsFileName: string;
-    /** 解析出 settings.json 绝对路径 */
-    resolveSettingsFile(scope: 'project' | 'global', projectRoot: string | undefined): string;
-    /** 该 IDE 是否支持此 scope(用于清晰报错) */
-    supportsScope(scope: 'project' | 'global'): boolean;
-}
-/**
- * Slim IDE adapter 描述。每 IDE 一个静态常量(无需 DI)。
- * 字段故意保持少:让 adapter 的添加是"填表"而非"重写"。
- */
-export interface IdeAdapter {
-    readonly id: IdeId;
-    /** 人类可读名,出现在 CLI help / 命令输出 */
-    readonly displayName: string;
-    readonly settings: IdeSettingsLocation;
-    /** IDE 注入的项目根 env 变量名;`peaks gate enforce` 等命令模板会引用此 env */
-    readonly envVar: string;
-    /** settings.json 里 hook 数组的 key,例如 'PreToolUse' / 'beforeToolCall' */
-    readonly hookEvent: string;
-    /** hook 数组元素的 matcher 字段(工具名匹配),例如 'Bash' / 'Task' / 'terminal' */
-    readonly toolMatcher: string;
-    /**
-     * Per-IDE sub-agent dispatcher. The `peaks sub-agent dispatch` CLI reads
-     * this field, calls `supportsRole` + `buildToolCall`, and returns the
-     * resulting tool-call descriptor in the JSON envelope. Encapsulates the per-IDE sub-agent dispatch surface (slice #009). The dispatcher's `buildToolCall` returns the IDE-native tool-call descriptor at runtime.
-     *
-     * Added in slice 2026-06-07-sub-agent-dispatch-decouple. See PRD #002
-     * G1 (AC-1, AC-2) + [[slim-ideadapter-shape-is-the-contract]].
-     */
-    readonly subAgentDispatcher: SubAgentDispatcher;
-    /**
-     * Per-IDE opt-in to the G9 prompt-size gate. When `true`, the
-     * `peaks hooks install` command registers the G9 PreToolUse hook
-     * (`peaks sub-agent-dispatch-guard`) for this IDE. When `false`,
-     * the hook is NOT installed (the IDE either doesn't support the
-     * PreToolUse event in a useful form, or the user has opted out).
-     *
-     * The CLI 兜底 layer in `peaks sub-agent dispatch` still enforces
-     * the threshold regardless of this field — `promptSizeAware` only
-     * controls the hook layer (R-15: G9 hook is LLM-platform-specific).
-     *
-     * Added in slice 2026-06-07-sub-agent-context-governance. See PRD
-     * #003 G9.2 + AC-56. Default `false` to preserve slice #009's
-     * `peaks hooks install` output byte-stability.
-     */
-    readonly promptSizeAware: boolean;
-    /** install / uninstall 后展示给用户的提示文本(各 IDE 不同,例如 Claude 提示重启窗口) */
-    readonly installHints: readonly string[];
-    /** 该 IDE 在 peaks 上可启用的能力(用于在不支持的 IDE 上软警告) */
-    readonly capabilities: IdeCapabilities;
-    /**
-     * Where this IDE reads its project-level agent instructions from.
-     * When undefined, the postinstall + `peaks standards init` codepath falls
-     * back to the legacy Claude Code path (CLAUDE.md + .claude/rules/**)
-     * AND emits a stderr warning. Adapters in slice 1.3.2 declare this
-     * value (Claude Code), are annotated UNVERIFIED for future slices
-     * (Trae, slice #012+), or omit it entirely (not-yet-registered IDEs).
-     *
-     * Added in slice 011-2026-06-07-ide-adapter-resource-profile.
-     */
-    readonly standardsProfile?: IdeStandardsProfile;
-    /**
-     * Where `scripts/install-skills.mjs` symlinks the bundled skills +
-     * output styles. When undefined, the postinstall falls back to
-     * `~/.claude/skills` + `~/.claude/output-styles` (legacy) AND emits
-     * a stderr warning. Adapters that opt into the dispatch layer fill
-     * this; adapters that don't (Trae in slice 1.3.2) leave it undefined
-     * and follow the legacy path with a warning.
-     *
-     * Added in slice 011-2026-06-07-ide-adapter-resource-profile.
-     */
-    readonly skillInstall?: IdeSkillInstall;
-    /**
-     * v2.13.0 auto-compact (AC-1 + AC-3): per-IDE compact-capability
-     * descriptor. When `undefined`, peaks-loop falls back to the
-     * `llm-self-compress` pathway (the LLM summarizes its own context).
-     * Adapters that fill this expose a 4-stage protocol so peaks-loop
-     * can drive compact autonomously:
-     *
-     *   1. `envVarForContextPercent` — env-var the IDE sets per turn
-     *      (e.g. `CLAUDE_CONTEXT_USAGE_PERCENT`). Read by AC-1.
-     *   2. `compactCommand` — slash command or shell-call the IDE
-     *      accepts to trigger compact (e.g. `/compact`). Dispatched
-     *      by AC-3.
-     *   3. `compactPathway` — `'shell-exec' | 'ide-native' |
-     *      'llm-self-compress' | 'noop'`. `shell-exec` means peaks-loop
-     *      spawns `compactCommand` via `child_process.spawn` (zero IDE
-     *      hook required). `ide-native` means the IDE exposes a hook
-     *      surface peaks-loop can write to. `llm-self-compress` is the
-     *      fallback when no compact capability is registered.
-     *   4. `postCompactDetectCommand` (optional) — command the LLM
-     *      runner can invoke after compact to confirm ratio dropped.
-     *
-     * Claude Code is the MVP implementation; trae / codex / cursor /
-     * qoder / tongyi-lingma / hermes / openclaw ship with
-     * `compactPathway: 'llm-self-compress'` until L2-dogfood verifies
-     * each IDE's actual compact surface.
-     *
-     * Added in slice 2026-06-27-auto-compact-protocol. See
-     * `.peaks/memory/2026-06-27-auto-compact-design.md`.
-     */
-    readonly compact?: IdeCompactProfile;
-}
-/**
- * Per-IDE auto-compact capability descriptor. See `IdeAdapter.compact`
- * for the protocol contract. The `MvpCompactPathway` string union
- * keeps the field exhaustive — adding a new pathway requires updating
- * every adapter that opts in.
- */
-export interface IdeCompactProfile {
-    /** Env-var name the IDE writes per turn to expose context-fill %. */
-    readonly envVarForContextPercent: string;
-    /**
-     * Slash command or shell-call to invoke compact. The orchestrator
-     * spawns this via `child_process.spawn` (shell-exec pathway) or
-     * writes it to an IDE hook file (ide-native pathway).
-     */
-    readonly compactCommand: string;
-    /**
-     * `shell-exec` — peaks-loop spawns the command via child_process
-     *                (works for any IDE that accepts a slash command
-     *                via a shell-spawnable entry point).
-     * `ide-native` — peaks-loop writes to an IDE-specific hook file;
-     *                used when the IDE requires a registered hook
-     *                rather than a runtime command.
-     * `llm-self-compress` — peaks-loop prompts the LLM to summarize
-     *                its own context (no IDE integration required;
-     *                least precise but always available).
-     * `noop` — peaks-loop records the intent but performs no action;
-     *          used by IDEs that explicitly opt out (e.g. legacy
-     *          adapters still on the v2.11.x model).
-     */
-    readonly compactPathway: 'shell-exec' | 'ide-native' | 'llm-self-compress' | 'noop';
-    /**
-     * Optional command the runner invokes post-compact to confirm
-     * ratio dropped (e.g. `peaks context now --json`). When omitted,
-     * the orchestrator polls `envVarForContextPercent` directly.
-     */
-    readonly postCompactDetectCommand?: string;
-}
-/**
- * Per-IDE standards-file location + format profile. Used by the
- * `peaks standards init` dispatch layer (slice 011) to write the
- * project-level standards files at the IDE-specific path, not the
- * Claude Code hardcoded one. Adapters that omit this field trigger
- * the legacy Claude Code path with a stderr warning.
- */
-export interface IdeStandardsProfile {
-    /** Filename for the project-root constitution (e.g. 'CLAUDE.md'), or null if the IDE has no equivalent. */
-    readonly rootFile: string | null;
-    /** Directory for module-level rules (e.g. '.claude/rules'), or null if the IDE has no equivalent. */
-    readonly rulesDir: string | null;
-    /** Glob under rulesDir to enumerate rule files. */
-    readonly rulesFileGlob: string;
-    /** True if the IDE auto-loads these files at session start. */
-    readonly autoLoaded: boolean;
-    /** Output format. markdown = plain text; markdown+frontmatter = adds YAML frontmatter to each rule file. */
-    readonly format: 'markdown' | 'markdown+frontmatter';
-    /** Human-readable hint surfaced in the fallback warning. */
-    readonly migrationHint?: string;
-}
-/**
- * Per-IDE postinstall target roots. The `scripts/install-skills.mjs`
- * script consumes this to symlink the bundled skills + output styles
- * to the IDE-specific install location, with back-compat for the
- * legacy `PEAKS_CLAUDE_SKILLS_DIR` / `PEAKS_CLAUDE_OUTPUT_STYLES_DIR`
- * env vars (precedence: explicit option > env var > IDE profile > legacy default).
- */
-export interface IdeSkillInstall {
-    /** Absolute path under which the postinstall script symlinks the bundled `skills/` directory. */
-    readonly skillsDir: string;
-    /** Absolute path under which the postinstall script writes the bundled `output-styles/`. Null if the IDE has no equivalent. */
-    readonly outputStylesDir: string | null;
-    /** Symlink strategy. */
-    readonly installStrategy: 'symlink' | 'copy';
-    /** Back-compat env var name (e.g. PEAKS_CLAUDE_SKILLS_DIR). Null if no env var is supported. */
-    readonly envVarOverride: string | null;
-}
-/** peaks canonical hook schema 版本标识 */
-export declare const PEAKS_HOOK_SCHEMA: "peaks-hook/v1";
-/** peaks canonical hook 形态 —— 单一协议,所有 IDE 经 hook-translator 归一化到此 */
-export interface PeaksCanonicalHook {
-    readonly schema: typeof PEAKS_HOOK_SCHEMA;
-    readonly event: 'pre-tool-use' | 'post-tool-use' | 'sub-agent-start';
-    readonly toolName: string;
-    readonly toolInput: Record<string, unknown>;
-    /** 解析自 env 变量或 --project 的项目根 */
-    readonly projectRoot: string;
-    /** 选输出格式 */
-    readonly rawIdeFormat: IdeId;
-    /** 原始 stdin,留作回退 */
-    readonly rawPayload: unknown;
-}
-/** peaks 决策发回形态枚举(按 IDE 期望的"发回"形式) */
-export type PeaksDecisionTransport = {
-    kind: 'stdout-json';
-    denyShape: Record<string, unknown>;
-} | {
-    kind: 'exit-code';
-    denyCode: number;
-} | {
-    kind: 'both';
-    denyShape: Record<string, unknown>;
-    denyCode: number;
-};

package/dist/src/services/job/job-progress-store.d.ts

@@ -1,60 +0,0 @@
-/**
- * v3.1.2 — On-disk slice progress mirror.
- *
- * After each `peaks job checkpoint --state done`, the orchestrator writes
- * `.peaks/_runtime/<sessionId>/job/<jid>/progress.json` so the next LLM
- * turn (after compact or resume) can read it before any Bash call lands.
- *
- * Shape (schemaVersion 1):
- *   {
- *     jobId, done, total, currentSlice, lastCommitSha, updatedAt
- *   }
- *
- * The `peaks code gate-step-08` hook reads this file in its case-1 path
- * (job-shape.json says isJob=true) and surfaces `Next: slice #N+1 of M
- * (<currentSlice>)` to stdout. The LLM cannot "wake up cold" — the
- * next-slice context is mechanically injected on every Bash call.
- *
- * Karpathy §2 (Simplicity First): ~50 lines, single-purpose writer +
- * reader. Schema is zod-validated on read so a stale on-disk copy
- * from an earlier peaks-loop release fails loud (no silent fallback).
- */
-import { z } from 'zod';
-export declare const JOB_PROGRESS_SCHEMA_VERSION: 1;
-export declare const JobProgressSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    jobId: z.ZodString;
-    done: z.ZodNumber;
-    total: z.ZodNumber;
-    currentSlice: z.ZodString;
-    lastCommitSha: z.ZodNullable<z.ZodString>;
-    updatedAt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    updatedAt: string;
-    done: number;
-    schemaVersion: 1;
-    jobId: string;
-    total: number;
-    currentSlice: string;
-    lastCommitSha: string | null;
-}, {
-    updatedAt: string;
-    done: number;
-    schemaVersion: 1;
-    jobId: string;
-    total: number;
-    currentSlice: string;
-    lastCommitSha: string | null;
-}>;
-export type JobProgress = z.infer<typeof JobProgressSchema>;
-export interface WriteProgressInput {
-    readonly jobId: string;
-    readonly done: number;
-    readonly total: number;
-    readonly currentSlice: string;
-    readonly lastCommitSha: string | null;
-    readonly updatedAt?: string;
-}
-export declare function writeJobProgress(projectRoot: string, sessionId: string, input: WriteProgressInput): JobProgress;
-export declare function readJobProgress(projectRoot: string, sessionId: string, jobId: string): JobProgress;
-export declare function tryReadJobProgress(projectRoot: string, sessionId: string, jobId: string): JobProgress | null;

package/dist/src/services/job/job-resource-snapshot.d.ts

@@ -1,7 +0,0 @@
-import type { ResourceSnapshot } from './job-types.js';
-/**
- * Collects a coarse-grained snapshot of host + project resources.
- * Numeric ranges are clamped to zod's domain — out-of-range values are clamped, not thrown,
- * so callers can decide what to do.
- */
-export declare function collectResourceSnapshot(jobDir: string): ResourceSnapshot;