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

package/dist/src/services/context/auto-compact-types.d.ts

@@ -1,143 +0,0 @@
-/**
- * Auto-compact shared types (v2.13.0 AC-1..AC-4).
- *
- * Two-tier threshold model — peaks-loop is project-aware and the LLM
- * is the decision-maker:
- *
- *   - 50%  soft warn          — log a one-line info row; continue.
- *   - 85%  pre-compact zone   — peaks-loop prepares the convergence
- *                                toolkit (checkpoint + convergence
- *                                plan + auto-decisions log +
- *                                IDE-compact dispatcher). The LLM
- *                                DECIDES when (or whether) to fire
- *                                compact during this zone. The
- *                                toolkit is "ready to use" so the
- *                                LLM doesn't lose context to a
- *                                last-second `/compact` panic.
- *   - 95%  RED LINE           — peaks-loop refuses to dispatch any
- *                                further sub-agent and synchronously
- *                                triggers IDE-side compact. At 95%+
- *                                the context window is too tight to
- *                                continue safely; the LLM cannot
- *                                opt out. This is the compact red
- *                                line that guarantees the LLM-runner
- *                                keeps working with context < 95%.
- *
- * Why 0.85 / 0.95 split: the LLM uses the 0.85–0.95 zone to do
- * intelligent convergence — wait for in-flight sub-agents, finish
- * the current todo row, persist a checkpoint, then compact. peaks-loop
- * provides the toolkit; the LLM picks the moment. At 0.95 the window
- * is gone and peaks-loop takes over synchronously to keep the runner
- * alive.
- */
-export declare const AUTO_COMPACT_SOFT_WARN_RATIO = 0.5;
-export declare const AUTO_COMPACT_PRE_COMPACT_RATIO = 0.85;
-export declare const AUTO_COMPACT_RED_LINE_RATIO = 0.95;
-export declare const AUTO_COMPACT_THRESHOLD_RATIO = 0.85;
-/** Single source of truth for "what should we do at ratio X?" */
-export type CompactTrigger = {
-    kind: 'none';
-} | {
-    kind: 'soft-warn';
-    ratio: number;
-    message: string;
-}
-/** Pre-compact zone (0.85 ≤ ratio < 0.95): toolkit ready; LLM picks the moment. */
- | {
-    kind: 'pre-compact';
-    ratio: number;
-    message: string;
-    toolkitReady: true;
-}
-/** Red line (ratio ≥ 0.95): peaks-loop forces synchronous compact; LLM cannot opt out. */
- | {
-    kind: 'red-line';
-    ratio: number;
-    message: string;
-};
-/** Caller-side info about sub-agent batches in flight (D6.e). */
-export interface InFlightBatchProbe {
-    readonly hasInFlightBatch: boolean;
-    readonly sharedChannelEntries?: number;
-    readonly batchId?: string;
-}
-/** What the post-compact LLM reads to resume exactly where it stopped. */
-export interface ConvergencePlan {
-    readonly schemaVersion: 1;
-    readonly sessionId: string;
-    readonly projectRoot: string;
-    readonly createdAt: string;
-    readonly ratio: number;
-    readonly checkpointPath: string;
-    readonly nextActions: readonly string[];
-    readonly resumeHint: string;
-}
-/** Per-IDE compact pathway chosen by AC-3. */
-export interface CompactDispatchResult {
-    readonly ok: boolean;
-    readonly ide: string;
-    readonly pathway: 'ide-native' | 'llm-self-compress' | 'shell-exec' | 'noop';
-    readonly message: string;
-}
-/** Final envelope returned by `runAutoCompact`. */
-export type AutoCompactResult = {
-    readonly ok: false;
-    readonly code: 'AUTO_COMPACT_NO_SESSION';
-    readonly message: string;
-    readonly nextActions: readonly string[];
-} | {
-    readonly ok: true;
-    readonly code: 'AUTO_COMPACT_SKIP' | 'AUTO_COMPACT_WAIT';
-    readonly message: string;
-    readonly data: {
-        readonly sessionId: string;
-        readonly ratio: number;
-        readonly source: string;
-        readonly decision: 'below-threshold' | 'in-flight-batch';
-    };
-} | {
-    readonly ok: boolean;
-    readonly code: 'AUTO_COMPACT_DISPATCHED' | 'AUTO_COMPACT_DISPATCH_FAILED' | 'AUTO_COMPACT_RED_LINE';
-    readonly message: string;
-    readonly data: {
-        readonly sessionId: string;
-        readonly ratio: number;
-        readonly source: string;
-        readonly checkpointPath?: string;
-        readonly convergencePlan?: ConvergencePlan;
-        readonly dispatch?: CompactDispatchResult;
-        /**
-         * Slice 2026-06-28-solo-mode-bypass-fix (defect #4): which
-         * session the compact targeted. `'main'` (default) means the
-         * main-session Claude Code window will fire `/compact` on its
-         * next turn; `'sub-agent'` means the dispatcher shell-spawned
-         * `/compact` in a child process (legacy behaviour).
-         */
-        readonly target?: 'main' | 'sub-agent';
-        readonly redLineGated?: boolean;
-    };
-};
-/**
- * Probe shape returned by AC-1 (`readContextPercent`). The source
- * field tells callers how the ratio was obtained (env-var, statusline
- * poller, IDE hook, conservative fallback) so the CLI can show
- * "context % (source: statusline-poll)" and the LLM can trust it.
- */
-export interface ContextPercentProbe {
-    readonly ratio: number;
-    /**
-     * Adapter-driven source tag. Fixed values:
-     *   - `${ideId}-env`            (e.g. `claude-code-env`)
-     *   - `statusline-poll`         (Claude Code MVP fallback)
-     *   - `conservative-fallback`   (transcript size estimate OR
-     *                                no signal available — caller
-     *                                MUST NOT treat as hard gate)
-     * Future IDEs may add per-ide sources; the type accepts any
-     * string to keep the schema forward-compatible.
-     */
-    readonly source: string;
-    readonly rawBytes?: number;
-    readonly capacityBytes?: number;
-    readonly ide: string;
-    readonly capturedAt: string;
-}

package/dist/src/services/context/context-schema.d.ts

@@ -1,415 +0,0 @@
-/**
- * Runtime validator for context.json. Per spec §4.1 + H8 (audit trail
- * hashable). When this schema changes, version field must bump.
- */
-import { z } from 'zod';
-export declare const ContextJsonSchema: z.ZodObject<{
-    version: z.ZodLiteral<"1.0">;
-    goal: z.ZodString;
-    generatedAt: z.ZodString;
-    sha256: z.ZodString;
-    collector: z.ZodObject<{
-        files: z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            kind: z.ZodEnum<["source", "test", "config", "doc"]>;
-            lines: z.ZodNumber;
-            hash: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            kind: "doc" | "source" | "test" | "config";
-            lines: number;
-            hash: string;
-        }, {
-            path: string;
-            kind: "doc" | "source" | "test" | "config";
-            lines: number;
-            hash: string;
-        }>, "many">;
-        gitStatus: z.ZodObject<{
-            branch: z.ZodString;
-            lastCommit: z.ZodString;
-            dirty: z.ZodBoolean;
-        }, "strip", z.ZodTypeAny, {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        }, {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        }>;
-        memoryEntries: z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            title: z.ZodString;
-            relevanceScore: z.ZodNumber;
-            excerptHash: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }, {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }>, "many">;
-        deps: z.ZodRecord<z.ZodString, z.ZodObject<{
-            version: z.ZodString;
-            source: z.ZodEnum<["package.json", "pnpm-lock.yaml", "yarn.lock"]>;
-            resolved: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        deps: Record<string, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>;
-        gitStatus: {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        };
-        files: {
-            path: string;
-            kind: "doc" | "source" | "test" | "config";
-            lines: number;
-            hash: string;
-        }[];
-        memoryEntries: {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }[];
-    }, {
-        deps: Record<string, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>;
-        gitStatus: {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        };
-        files: {
-            path: string;
-            kind: "doc" | "source" | "test" | "config";
-            lines: number;
-            hash: string;
-        }[];
-        memoryEntries: {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }[];
-    }>;
-    docRetriever: z.ZodObject<{
-        fetchedDocs: z.ZodArray<z.ZodObject<{
-            dep: z.ZodString;
-            version: z.ZodString;
-            source: z.ZodEnum<["local-cache", "remote-fetch"]>;
-            url: z.ZodOptional<z.ZodString>;
-            fetchedAt: z.ZodString;
-            contentHash: z.ZodString;
-            sections: z.ZodArray<z.ZodObject<{
-                title: z.ZodString;
-                tokenEstimate: z.ZodNumber;
-                excerpt: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }, {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }>, "many">;
-            stale: z.ZodBoolean;
-        }, "strip", z.ZodTypeAny, {
-            version: string;
-            source: "local-cache" | "remote-fetch";
-            stale: boolean;
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }, {
-            version: string;
-            source: "local-cache" | "remote-fetch";
-            stale: boolean;
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }>, "many">;
-        skipped: z.ZodArray<z.ZodObject<{
-            dep: z.ZodString;
-            reason: z.ZodEnum<["unconfigured", "network_error", "version_unknown"]>;
-        }, "strip", z.ZodTypeAny, {
-            dep: string;
-            reason: "unconfigured" | "network_error" | "version_unknown";
-        }, {
-            dep: string;
-            reason: "unconfigured" | "network_error" | "version_unknown";
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        skipped: {
-            dep: string;
-            reason: "unconfigured" | "network_error" | "version_unknown";
-        }[];
-        fetchedDocs: {
-            version: string;
-            source: "local-cache" | "remote-fetch";
-            stale: boolean;
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }[];
-    }, {
-        skipped: {
-            dep: string;
-            reason: "unconfigured" | "network_error" | "version_unknown";
-        }[];
-        fetchedDocs: {
-            version: string;
-            source: "local-cache" | "remote-fetch";
-            stale: boolean;
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }[];
-    }>;
-    tokenizer: z.ZodObject<{
-        metadata: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            kind: z.ZodEnum<["doc", "code", "memory", "git"]>;
-            version: z.ZodOptional<z.ZodString>;
-            blastRadius: z.ZodArray<z.ZodString, "many">;
-            conflictScore: z.ZodNumber;
-            timeDecayScore: z.ZodNumber;
-            tags: z.ZodArray<z.ZodString, "many">;
-        }, "strip", z.ZodTypeAny, {
-            kind: "git" | "code" | "doc" | "memory";
-            id: string;
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            tags: string[];
-            version?: string | undefined;
-        }, {
-            kind: "git" | "code" | "doc" | "memory";
-            id: string;
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            tags: string[];
-            version?: string | undefined;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        metadata: {
-            kind: "git" | "code" | "doc" | "memory";
-            id: string;
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            tags: string[];
-            version?: string | undefined;
-        }[];
-    }, {
-        metadata: {
-            kind: "git" | "code" | "doc" | "memory";
-            id: string;
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            tags: string[];
-            version?: string | undefined;
-        }[];
-    }>;
-    renderer: z.ZodObject<{
-        audience: z.ZodEnum<["peaks-rd", "peaks-qa", "peaks-mut", "all"]>;
-        renderedAt: z.ZodString;
-        sizeBytes: z.ZodNumber;
-        truncated: z.ZodBoolean;
-        truncatedReason: z.ZodOptional<z.ZodEnum<["doc_budget_exceeded", "section_count_exceeded"]>>;
-    }, "strip", z.ZodTypeAny, {
-        sizeBytes: number;
-        audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-        renderedAt: string;
-        truncated: boolean;
-        truncatedReason?: "doc_budget_exceeded" | "section_count_exceeded" | undefined;
-    }, {
-        sizeBytes: number;
-        audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-        renderedAt: string;
-        truncated: boolean;
-        truncatedReason?: "doc_budget_exceeded" | "section_count_exceeded" | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    version: "1.0";
-    goal: string;
-    sha256: string;
-    generatedAt: string;
-    collector: {
-        deps: Record<string, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>;
-        gitStatus: {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        };
-        files: {
-            path: string;
-            kind: "doc" | "source" | "test" | "config";
-            lines: number;
-            hash: string;
-        }[];
-        memoryEntries: {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }[];
-    };
-    docRetriever: {
-        skipped: {
-            dep: string;
-            reason: "unconfigured" | "network_error" | "version_unknown";
-        }[];
-        fetchedDocs: {
-            version: string;
-            source: "local-cache" | "remote-fetch";
-            stale: boolean;
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }[];
-    };
-    tokenizer: {
-        metadata: {
-            kind: "git" | "code" | "doc" | "memory";
-            id: string;
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            tags: string[];
-            version?: string | undefined;
-        }[];
-    };
-    renderer: {
-        sizeBytes: number;
-        audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-        renderedAt: string;
-        truncated: boolean;
-        truncatedReason?: "doc_budget_exceeded" | "section_count_exceeded" | undefined;
-    };
-}, {
-    version: "1.0";
-    goal: string;
-    sha256: string;
-    generatedAt: string;
-    collector: {
-        deps: Record<string, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>;
-        gitStatus: {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        };
-        files: {
-            path: string;
-            kind: "doc" | "source" | "test" | "config";
-            lines: number;
-            hash: string;
-        }[];
-        memoryEntries: {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }[];
-    };
-    docRetriever: {
-        skipped: {
-            dep: string;
-            reason: "unconfigured" | "network_error" | "version_unknown";
-        }[];
-        fetchedDocs: {
-            version: string;
-            source: "local-cache" | "remote-fetch";
-            stale: boolean;
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }[];
-    };
-    tokenizer: {
-        metadata: {
-            kind: "git" | "code" | "doc" | "memory";
-            id: string;
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            tags: string[];
-            version?: string | undefined;
-        }[];
-    };
-    renderer: {
-        sizeBytes: number;
-        audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-        renderedAt: string;
-        truncated: boolean;
-        truncatedReason?: "doc_budget_exceeded" | "section_count_exceeded" | undefined;
-    };
-}>;

package/dist/src/services/dispatch/slice-dag.d.ts

@@ -1,81 +0,0 @@
-/**
- * Slice complexity tier (v2.15.0 follow-up, G2 in 12 Gaps).
- * Used by Solo to schedule complex slices during user-attended hours
- * and trivial / simple slices overnight.
- */
-export type SliceComplexity = 'trivial' | 'simple' | 'complex';
-export declare const SLICE_COMPLEXITIES: readonly SliceComplexity[];
-export declare function isSliceComplexity(value: string): value is SliceComplexity;
-export interface SliceNode {
-    readonly id: string;
-    readonly role: string;
-    /** Human-readable label, optional. */
-    readonly label?: string;
-    /** Optional prompt override; dispatch falls back to a default placeholder. */
-    readonly prompt?: string;
-    /**
-     * v2.15.0 follow-up — G12: foundation slice. Foundation slices run before
-     * business slices in the layered DAG. Business slices do NOT wait for
-     * ALL foundation slices — they wait only for the foundation subset
-     * they declare as `dependsOn`. Optional; default false.
-     */
-    readonly foundation?: boolean;
-    /**
-     * v2.15.0 follow-up — G11: upstream sync slice. Marks a slice that
-     * syncs an upstream fork (e.g. hermes) to a new tag. UpstreamSync
-     * slices take priority within their topological level. Optional.
-     */
-    readonly upstreamSync?: boolean;
-    /**
-     * v2.15.0 follow-up — G2: complexity tier. Drives Solo's scheduling
-     * (complex = user-attended, simple/trivial = overnight). Optional.
-     */
-    readonly complexity?: SliceComplexity;
-}
-export interface DependsOn {
-    readonly from: string;
-    readonly to: string;
-}
-export interface SliceDag {
-    readonly nodes: readonly SliceNode[];
-    readonly edges: readonly DependsOn[];
-}
-/** Thrown by `validateDag` when the graph violates one of the constraints. */
-export declare class InvalidSliceDagError extends Error {
-    readonly path?: readonly string[] | undefined;
-    readonly code: "INVALID_SLICE_DAG";
-    constructor(message: string, path?: readonly string[] | undefined);
-}
-/** Thrown by `topologicalLevels` when the graph has a cycle (defensive). */
-export declare class SliceDagCycleError extends Error {
-    readonly cyclePath: readonly string[];
-    readonly code: "SLICE_DAG_CYCLE";
-    constructor(cyclePath: readonly string[]);
-}
-/**
- * Validate a SliceDag. Throws `InvalidSliceDagError` on the first violation.
- * Pure. Cheap. No I/O.
- */
-export declare function validateDag(dag: SliceDag): void;
-/**
- * Compute topological levels. Each level is an array of node IDs that can
- * run in parallel. Throws `SliceDagCycleError` on cycle (defensive;
- * `validateDag` should have caught it).
- *
- * Algorithm: Kahn's algorithm. O(V + E).
- */
-export declare function topologicalLevels(dag: SliceDag): readonly (readonly string[])[];
-/**
- * Return the next set of node IDs that are ready to run given the set of
- * completed node IDs. A node is ready when all of its `from` predecessors
- * are in `completed`.
- */
-export declare function sliceReadyToRun(dag: SliceDag, completed: ReadonlySet<string>): readonly string[];
-/**
- * Serialize the DAG into a deterministic JSON string. Node IDs are sorted;
- * edges are sorted by `(from, to)`. The result is suitable for SHA-256
- * hashing and for byte-stable diffs.
- */
-export declare function serializeDag(dag: SliceDag): string;
-/** SHA-256 hash of the serialized DAG. Stable across runs. */
-export declare function hashDag(dag: SliceDag): string;

package/dist/src/services/dispatch/test-tool-detection.d.ts

@@ -1,36 +0,0 @@
-/**
- * Slice 2026-06-24-test-tool-detection-injection.
- *
- * The Test Tool Detection block is prepended to every sub-agent prompt
- * dispatched by peaks-loop (both the single-dispatch chokepoint in
- * `src/cli/commands/dispatch-commands.ts` and the DAG-dispatch chokepoint
- * in `src/services/solo/dag-orchestrator.ts`). It tells the sub-agent
- * to read `package.json#scripts.test` first and use the project-local
- * runner — never `npx <runner>` — so it cannot bypass the lockfile or
- * spawn a network-bound tool call.
- *
- * Why a static constant (not a per-call detector):
- *  1. Predictable byte budget — the block is part of PROMPT_LIMIT_BYTES
- *     accounting (see dispatch-commands.ts line 113), and the size must
- *     be stable across calls.
- *  2. I/O-free — dispatch is a hot path; reading package.json here would
- *     add a filesystem hit per dispatch and run before the LLM has any
- *     context to act on the result.
- *  3. LLM does runtime lookup — the block itself instructs the sub-agent
- *     to introspect `package.json#scripts.test` (or `peaks test --json`)
- *     at run time, so the LLM gets the resolved framework + argv with
- *     its full context. The dispatch CLI just primes the instruction.
- *
- * Why every sub-agent gets the block (Karpathy #2 Simplicity First):
- *  the rule is machine-injected, not a prompt ritual. The LLM cannot
- *  "remove the redundancy" of a test-tool-detection instruction because
- *  the dispatch CLI always prepends it. This is a guarantee, not a
- *  suggestion.
- */
-export declare const TEST_TOOL_DETECTION_BLOCK = "## Test Tool Detection (mandatory)\n\nBefore running any test, read `package.json#scripts.test` to identify the project's test framework. Use the project-local runner \u2014 do NOT invoke `npx <runner>`:\n\n- **vitest** \u2192 `./node_modules/.bin/vitest run <file>` (or `pnpm test -- <file>`)\n- **jest**   \u2192 `./node_modules/.bin/jest <file>`   (or `pnpm test -- <file>`)\n- **mocha**  \u2192 `./node_modules/.bin/mocha <file>`  (or `pnpm test -- <file>`)\n\nIf unsure which framework the consumer project uses, run `peaks test --json` first to introspect the resolved framework + argv. Only as a last resort, ask the user before assuming a runner. The CLI command `peaks test <file>` already resolves the local binary for you (Windows-aware).";
-/**
- * Pure helper that returns the block. Exists as a function (not just an
- * exported constant) so future variants can take a runtime parameter
- * (e.g. projectRoot for context) without churning every call site.
- */
-export declare function formatTestToolDetection(): string;