peaks-loop 4.0.0-beta → 4.0.0-beta.10

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 solo 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-progress-store.js

@@ -1,70 +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 solo 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 { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { z } from 'zod';
-export const JOB_PROGRESS_SCHEMA_VERSION = 1;
-export const JobProgressSchema = z.object({
-    schemaVersion: z.literal(JOB_PROGRESS_SCHEMA_VERSION),
-    jobId: z.string(),
-    done: z.number().int().nonnegative(),
-    total: z.number().int().positive(),
-    currentSlice: z.string(),
-    lastCommitSha: z.string().nullable(),
-    updatedAt: z.string().datetime()
-});
-export function writeJobProgress(projectRoot, sessionId, input) {
-    const dir = join(projectRoot, '.peaks', '_runtime', sessionId, 'job', input.jobId);
-    mkdirSync(dir, { recursive: true });
-    const record = {
-        schemaVersion: JOB_PROGRESS_SCHEMA_VERSION,
-        jobId: input.jobId,
-        done: input.done,
-        total: input.total,
-        currentSlice: input.currentSlice,
-        lastCommitSha: input.lastCommitSha,
-        updatedAt: input.updatedAt ?? new Date().toISOString()
-    };
-    const path = join(dir, 'progress.json');
-    writeFileSync(path, JSON.stringify(record, null, 2) + '\n', 'utf8');
-    return record;
-}
-export function readJobProgress(projectRoot, sessionId, jobId) {
-    const path = join(projectRoot, '.peaks', '_runtime', sessionId, 'job', jobId, 'progress.json');
-    if (!existsSync(path)) {
-        throw new Error(`JobProgressStore: no progress for ${jobId} at ${path}`);
-    }
-    const raw = readFileSync(path, 'utf8');
-    return JobProgressSchema.parse(JSON.parse(raw));
-}
-export function tryReadJobProgress(projectRoot, sessionId, jobId) {
-    const path = join(projectRoot, '.peaks', '_runtime', sessionId, 'job', jobId, 'progress.json');
-    if (!existsSync(path))
-        return null;
-    try {
-        const raw = readFileSync(path, 'utf8');
-        return JobProgressSchema.parse(JSON.parse(raw));
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        return null;
-    }
-}

package/dist/src/services/memory/project-context-service.d.ts

@@ -1,11 +0,0 @@
-export type ProjectContextSection = {
-    heading: string;
-    body: string;
-};
-export declare function generateProjectContext(projectRoot: string): {
-    path: string;
-    content: string;
-    sessionCount: number;
-};
-export declare function readProjectContext(projectRoot: string): string | null;
-export declare function getProjectContextPath(projectRoot: string): string;

package/dist/src/services/memory/project-context-service.js

@@ -1,148 +0,0 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { listSessionMetas } from '../session/session-manager.js';
-import { getSessionDir } from '../session/getSessionDir.js';
-const PROJECT_CONTEXT_FILE = '.peaks/PROJECT.md';
-const CONTEXT_HEADER = `# Peaks Project Context
-
-> Auto-generated project memory. Peaks reads this at the start of each session to understand
-> the project's history, tech stack, conventions, and past decisions.
-> Last updated: `;
-const MANAGED_BLOCK_START = '<!-- peaks-managed:session-history-start -->';
-const MANAGED_BLOCK_END = '<!-- peaks-managed:session-history-end -->';
-function projectName(projectRoot) {
-    const pkgPath = join(projectRoot, 'package.json');
-    if (!existsSync(pkgPath))
-        return projectRoot.split(/[\\/]/).pop() ?? 'unknown';
-    try {
-        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-        return pkg.name ?? projectRoot.split(/[\\/]/).pop() ?? 'unknown';
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        return projectRoot.split(/[\\/]/).pop() ?? 'unknown';
-    }
-}
-function listMdFiles(dir, maxDepth = 3) {
-    const results = [];
-    if (!existsSync(dir) || maxDepth <= 0)
-        return results;
-    let entries;
-    try {
-        entries = readdirSync(dir, { withFileTypes: true });
-    }
-    catch {
-        return results;
-    }
-    for (const entry of entries) {
-        if (entry.name.startsWith('.'))
-            continue;
-        const full = join(dir, entry.name);
-        if (entry.isDirectory()) {
-            results.push(...listMdFiles(full, maxDepth - 1));
-        }
-        else if (entry.isFile() && entry.name.endsWith('.md')) {
-            results.push(full);
-        }
-    }
-    return results;
-}
-function extractOneLineSummary(sessionRoot) {
-    const artifacts = listMdFiles(sessionRoot, 4);
-    for (const artifact of artifacts.slice(0, 5)) {
-        try {
-            const content = readFileSync(artifact, 'utf8');
-            // Grab the first non-heading, non-empty line after the front section
-            const lines = content.split(/\r?\n/);
-            for (const line of lines) {
-                const trimmed = line.trim();
-                if (!trimmed || trimmed.startsWith('#') || trimmed.startsWith('-') || trimmed.startsWith('`'))
-                    continue;
-                if (trimmed.length > 10 && trimmed.length < 200)
-                    return trimmed;
-                break;
-            }
-        }
-        catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-            // skip unreadable
-        }
-    }
-    return null;
-}
-function buildSessionHistory(projectRoot) {
-    const metas = listSessionMetas(projectRoot);
-    if (metas.length === 0) {
-        return `${MANAGED_BLOCK_START}\n\n_No sessions recorded yet._\n\n${MANAGED_BLOCK_END}`;
-    }
-    const maxSessions = 15;
-    // Sort by createdAt descending (most recent first)
-    const sorted = [...metas].sort((a, b) => (b.createdAt || '').localeCompare(a.createdAt || ''));
-    const recent = sorted.slice(0, maxSessions);
-    let body = `${MANAGED_BLOCK_START}\n\n## Timeline (${metas.length} sessions`;
-    if (metas.length > maxSessions)
-        body += `, showing last ${maxSessions}`;
-    body += ')\n\n';
-    // Human-readable timeline: date | name | brief
-    body += `| Date | Directory | Title | What |\n`;
-    body += `|------|-----------|-------|------|\n`;
-    for (const meta of recent) {
-        const date = meta.createdAt ? meta.createdAt.slice(0, 10) : '?';
-        const dir = meta.sessionId;
-        const title = (meta.title ?? 'Untitled').slice(0, 40);
-        const skill = meta.skill ?? '-';
-        // Extract one-line summary from artifacts for the "What" column
-        const sessionRoot = getSessionDir(projectRoot, meta.sessionId);
-        const summary = extractOneLineSummary(sessionRoot);
-        const brief = summary ? summary.slice(0, 70) : skill;
-        body += `| ${date} | \`${dir}\` | ${title} | ${brief} |\n`;
-    }
-    body += `\n${MANAGED_BLOCK_END}`;
-    return body;
-}
-export function generateProjectContext(projectRoot) {
-    const peaksDir = join(projectRoot, '.peaks');
-    if (!existsSync(peaksDir)) {
-        mkdirSync(peaksDir, { recursive: true });
-    }
-    const contextPath = join(projectRoot, PROJECT_CONTEXT_FILE);
-    const name = projectName(projectRoot);
-    const now = new Date().toISOString();
-    const sessionHistory = buildSessionHistory(projectRoot);
-    const header = `${CONTEXT_HEADER}${now}\n\n## Project: ${name}\n`;
-    let content;
-    if (existsSync(contextPath)) {
-        const existing = readFileSync(contextPath, 'utf8');
-        const startIdx = existing.indexOf(MANAGED_BLOCK_START);
-        const endIdx = existing.indexOf(MANAGED_BLOCK_END);
-        // Update the Last-updated timestamp in the header
-        const updatedExisting = existing.replace(/Last updated: .*/, `Last updated: ${now}`);
-        if (startIdx >= 0 && endIdx > startIdx) {
-            // Replace managed block, preserve user content outside it
-            const before = updatedExisting.slice(0, startIdx);
-            const after = updatedExisting.slice(endIdx + MANAGED_BLOCK_END.length);
-            content = before + sessionHistory + after;
-        }
-        else {
-            // No managed block found — append
-            content = updatedExisting.trimEnd() + '\n\n' + sessionHistory + '\n';
-        }
-    }
-    else {
-        content = header + '\n' + sessionHistory + '\n';
-    }
-    writeFileSync(contextPath, content, 'utf8');
-    return { path: contextPath, content, sessionCount: listSessionMetas(projectRoot).length };
-}
-export function readProjectContext(projectRoot) {
-    const contextPath = join(projectRoot, PROJECT_CONTEXT_FILE);
-    if (!existsSync(contextPath))
-        return null;
-    try {
-        return readFileSync(contextPath, 'utf8');
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        return null;
-    }
-}
-export function getProjectContextPath(projectRoot) {
-    return join(projectRoot, PROJECT_CONTEXT_FILE);
-}

package/dist/src/services/preferences/preferences-service.d.ts

@@ -1,38 +0,0 @@
-import { DEFAULT_PREFERENCES, PREFERENCES_SCHEMA_VERSION, type ProjectPreferences } from './preferences-types.js';
-export { DEFAULT_PREFERENCES, PREFERENCES_SCHEMA_VERSION };
-export type { ProjectPreferences } from './preferences-types.js';
-export declare function preferencesPath(projectRoot: string): string;
-export declare function loadPreferences(projectRoot: string): ProjectPreferences;
-export declare function savePreferences(projectRoot: string, overrides: Partial<ProjectPreferences>): ProjectPreferences;
-/**
- * Atomic write helper for preferences.json. Writes to `<path>.tmp-<pid>-<ts>`
- * and renames over the target. On Windows, `rename` is atomic for files
- * on the same volume; on POSIX, `rename(2)` is atomic by spec.
- */
-export declare function writeAtomic(filePath: string, prefs: ProjectPreferences): void;
-/**
- * Slice 2026-06-23-audit-4th #C1: migrate a legacy preferences.json
- * (any `schema_version` older than PREFERENCES_SCHEMA_VERSION) to the
- * current shape. Returns the migrated object + a list of changes
- * applied (for surfacing in the CLI envelope and the migration log).
- *
- * The v1 → v2 mapping fills in the `headroom.perTouchpoint` sub-keys
- * that v1 didn't track: each touchpoint gets the v1 `headroom.defaultMode`
- * (or 'balanced' if absent), and `compressMinBytes` is preserved
- * verbatim. v1's `agentShieldPrompt` and `loopAutonomousEnabled` were
- * already present, so they carry through unchanged. The `fanout` field
- * is new in v2 — it defaults to `{ defaultMode: 'fan-out' }` so the
- * pre-v2 behavior (peak-solo SKILL instructed fan-out when ≥ 2 leaves)
- * is preserved.
- */
-export type MigrateResult = {
-    readonly fromVersion: string;
-    readonly toVersion: typeof PREFERENCES_SCHEMA_VERSION;
-    readonly migrated: ProjectPreferences;
-    readonly changes: readonly string[];
-    readonly written: boolean;
-};
-export declare function migratePreferences(projectRoot: string, opts?: {
-    write?: boolean;
-    now?: () => Date;
-}): MigrateResult | null;