peaks-loop 4.0.0-beta.14 → 4.0.0-beta.15

package/dist/services/crystallization/evidence-brief-builder.d.ts

@@ -1,237 +0,0 @@
-import { z } from "zod";
-import { type EvidenceBrief } from "./crystallization-types.js";
-/**
- * EvidenceBriefBuilder — spec §4.7 / §10 RL-7.
- *
- * The brief is a 4-section natural-language projection that MUST
- * accompany every user-facing recommendation. The shape guard is
- * encoded in `EvidenceBriefSchema` (see crystallization-types.ts);
- * this module is the LLM-side entry point that PRODUCES the brief
- * from a finished trace + evaluator summary and the validator that
- * REFUSES to render a recommendation payload without all 4 sections.
- *
- * Hard rules (mirrored from spec):
- *
- *   1. Every section must be a non-empty NL string (1-2 sentences
- *      for what_happened / why_it_matters / what_learned; 1
- *      sentence for what_action). An empty section is a hard
- *      `MISSING_BRIEF_SECTION` error.
- *
- *   2. The build path is lenient on raw prose and strict on the
- *      final shape — `buildEvidenceBrief` calls
- *      `EvidenceBriefSchema.parse(...)` so a partial brief throws
- *      before reaching the database.
- *
- *   3. `renderRecommendationPayload` refuses to return a
- *      recommendation envelope unless the brief passes the 4-section
- *      guard. This is the CLI's single source of truth for "may I
- *      show this to the user?".
- *
- *   4. The `evaluator_summary` is a separate field on the
- *      crystallization_event row (spec §4.5) and is NOT part of the
- *      brief. It feeds the broader recommendation envelope.
- *
- * Out of scope (deferred to later slices):
- *   - LLM-authored brief generation from live trace evidence (M8 dogfood).
- *   - brief rewrite-on-update semantics.
- */
-/**
- * The minimum viable trace shape that the builder needs to render
- * a brief. The trace is the EVIDENCE; the builder is format-stable
- * so a future slice can swap in a richer trace source without
- * editing every caller.
- */
-export declare const BriefTraceInputSchema: z.ZodObject<{
-    trace_id: z.ZodString;
-    /**
-     * The full NL recap of the run. Required for what_happened.
-     * 1-2 sentences is the spec guidance; the builder does not
-     * truncate, but tests passing multi-paragraph input will be
-     * warned at the Zod boundary (max 4000 chars per section).
-     */
-    what_happened: z.ZodString;
-    /**
-     * The "why this matters" recap. Required for why_it_matters.
-     */
-    why_it_matters: z.ZodString;
-    /**
-     * Failure-mode and preference-extraction recap. Required for
-     * what_learned.
-     */
-    what_learned: z.ZodString;
-    /**
-     * The recommended action. Required for what_action (1
-     * sentence per spec).
-     */
-    what_action: z.ZodString;
-    /**
-     * Optional structured bullets (e.g. "4 phases, 3 gates passed,
-     * 1 evaluator verdict"). Counts are allowed at this layer; the
-     * brief section is the NL primary (RL-7).
-     */
-    bullets: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    /**
-     * Source trace ids backing the brief (the column on
-     * crystallization_event spec §4.5).
-     */
-    source_trace_pointers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    source_trace_pointers: string[];
-    what_happened: string;
-    why_it_matters: string;
-    what_learned: string;
-    what_action: string;
-    trace_id: string;
-    bullets: string[];
-}, {
-    what_happened: string;
-    why_it_matters: string;
-    what_learned: string;
-    what_action: string;
-    trace_id: string;
-    source_trace_pointers?: string[] | undefined;
-    bullets?: string[] | undefined;
-}>;
-export type BriefTraceInput = z.input<typeof BriefTraceInputSchema>;
-/**
- * The summary emitted by the independent evaluators (spec §4.5
- * `evaluator_summary` field). Optional for the brief builder — the
- * brief can be built without it, but a filled evaluator_summary
- * flows into the recommendation envelope.
- */
-export declare const EvaluatorSummarySchema: z.ZodObject<{
-    one_liner: z.ZodDefault<z.ZodString>;
-    risk_tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    one_liner: string;
-    risk_tags: string[];
-}, {
-    one_liner?: string | undefined;
-    risk_tags?: string[] | undefined;
-}>;
-export type EvaluatorSummary = z.input<typeof EvaluatorSummarySchema>;
-export declare const RecommendationPayloadSchema: z.ZodObject<{
-    brief: z.ZodEffects<z.ZodObject<{
-        what_happened: z.ZodString;
-        why_it_matters: z.ZodString;
-        what_learned: z.ZodString;
-        what_action: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        what_happened: string;
-        why_it_matters: string;
-        what_learned: string;
-        what_action: string;
-    }, {
-        what_happened: string;
-        why_it_matters: string;
-        what_learned: string;
-        what_action: string;
-    }>, {
-        what_happened: string;
-        why_it_matters: string;
-        what_learned: string;
-        what_action: string;
-    }, {
-        what_happened: string;
-        why_it_matters: string;
-        what_learned: string;
-        what_action: string;
-    }>;
-    bullets: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    source_trace_pointers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    evaluator_summary: z.ZodDefault<z.ZodObject<{
-        one_liner: z.ZodDefault<z.ZodString>;
-        risk_tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        one_liner: string;
-        risk_tags: string[];
-    }, {
-        one_liner?: string | undefined;
-        risk_tags?: string[] | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    source_trace_pointers: string[];
-    evaluator_summary: {
-        one_liner: string;
-        risk_tags: string[];
-    };
-    bullets: string[];
-    brief: {
-        what_happened: string;
-        why_it_matters: string;
-        what_learned: string;
-        what_action: string;
-    };
-}, {
-    brief: {
-        what_happened: string;
-        why_it_matters: string;
-        what_learned: string;
-        what_action: string;
-    };
-    source_trace_pointers?: string[] | undefined;
-    evaluator_summary?: {
-        one_liner?: string | undefined;
-        risk_tags?: string[] | undefined;
-    } | undefined;
-    bullets?: string[] | undefined;
-}>;
-export type RecommendationPayload = z.infer<typeof RecommendationPayloadSchema>;
-export declare class BriefSectionError extends Error {
-    readonly code: "MISSING_BRIEF_SECTION";
-    readonly findings: ReadonlyArray<{
-        path: string;
-        message: string;
-    }>;
-    constructor(message: string, findings?: ReadonlyArray<{
-        path: string;
-        message: string;
-    }>);
-}
-/**
- * Build a 4-section EvidenceBrief from a finished trace recap.
- *
- * The function is STRICT: it parses the input trace through
- * `BriefTraceInputSchema`, then parses the assembled brief through
- * `EvidenceBriefSchema`. Any missing section throws
- * `BriefSectionError(MISSING_BRIEF_SECTION)` — the same code that
- * `safeParseEvidenceBrief` returns — so a single error code is the
- * user-facing signal for "brief incomplete, do not render".
- *
- * Brief-section related ZodErrors (e.g. `min(1)` on a section) are
- * translated to `BriefSectionError` so callers only handle one
- * shape of failure. Non-section ZodErrors (e.g. invalid `trace_id`)
- * are re-raised unchanged.
- *
- * NOTE: callers who already have raw NL strings can also call
- * `parseEvidenceBrief` directly; this function is the opinionated
- * shape for trace -> brief.
- */
-export declare function buildEvidenceBrief(trace: BriefTraceInput, evaluatorSummary?: EvaluatorSummary): EvidenceBrief;
-/**
- * Render the user-facing recommendation envelope (brief + bullets +
- * trace pointers + evaluator summary). The function refuses to
- * return a payload unless ALL 4 brief sections are present — this
- * is the single CLI-facing gate per spec §10 RL-7.
- *
- * On success, returns the validated `RecommendationPayload`. On a
- * missing-section brief, throws `BriefSectionError`.
- */
-export declare function renderRecommendationPayload(trace: BriefTraceInput, evaluatorSummary?: EvaluatorSummary): RecommendationPayload;
-/**
- * Convenience: validate an arbitrary unknown payload AS IF it were a
- * recommendation envelope. Returns a Result-like shape so the CLI can
- * render a structured MISSING_BRIEF_SECTION error without try/catch
- * noise.
- */
-export declare function safeRenderRecommendationPayload(input: unknown): {
-    ok: true;
-    payload: RecommendationPayload;
-} | {
-    ok: false;
-    code?: "MISSING_BRIEF_SECTION";
-    findings: Array<{
-        path: string;
-        message: string;
-    }>;
-};

package/dist/services/crystallization/evidence-brief-builder.js

@@ -1,240 +0,0 @@
-import { z } from "zod";
-import { EvidenceBriefSchema, } from "./crystallization-types.js";
-/**
- * EvidenceBriefBuilder — spec §4.7 / §10 RL-7.
- *
- * The brief is a 4-section natural-language projection that MUST
- * accompany every user-facing recommendation. The shape guard is
- * encoded in `EvidenceBriefSchema` (see crystallization-types.ts);
- * this module is the LLM-side entry point that PRODUCES the brief
- * from a finished trace + evaluator summary and the validator that
- * REFUSES to render a recommendation payload without all 4 sections.
- *
- * Hard rules (mirrored from spec):
- *
- *   1. Every section must be a non-empty NL string (1-2 sentences
- *      for what_happened / why_it_matters / what_learned; 1
- *      sentence for what_action). An empty section is a hard
- *      `MISSING_BRIEF_SECTION` error.
- *
- *   2. The build path is lenient on raw prose and strict on the
- *      final shape — `buildEvidenceBrief` calls
- *      `EvidenceBriefSchema.parse(...)` so a partial brief throws
- *      before reaching the database.
- *
- *   3. `renderRecommendationPayload` refuses to return a
- *      recommendation envelope unless the brief passes the 4-section
- *      guard. This is the CLI's single source of truth for "may I
- *      show this to the user?".
- *
- *   4. The `evaluator_summary` is a separate field on the
- *      crystallization_event row (spec §4.5) and is NOT part of the
- *      brief. It feeds the broader recommendation envelope.
- *
- * Out of scope (deferred to later slices):
- *   - LLM-authored brief generation from live trace evidence (M8 dogfood).
- *   - brief rewrite-on-update semantics.
- */
-/* ---------------------------------------------------------------------- */
-/* Input shapes — the builder is the only place these normalize.          */
-/* ---------------------------------------------------------------------- */
-/**
- * The minimum viable trace shape that the builder needs to render
- * a brief. The trace is the EVIDENCE; the builder is format-stable
- * so a future slice can swap in a richer trace source without
- * editing every caller.
- */
-export const BriefTraceInputSchema = z.object({
-    trace_id: z.string().trim().min(1).max(256),
-    /**
-     * The full NL recap of the run. Required for what_happened.
-     * 1-2 sentences is the spec guidance; the builder does not
-     * truncate, but tests passing multi-paragraph input will be
-     * warned at the Zod boundary (max 4000 chars per section).
-     */
-    what_happened: z.string().trim().min(1).max(4000),
-    /**
-     * The "why this matters" recap. Required for why_it_matters.
-     */
-    why_it_matters: z.string().trim().min(1).max(4000),
-    /**
-     * Failure-mode and preference-extraction recap. Required for
-     * what_learned.
-     */
-    what_learned: z.string().trim().min(1).max(4000),
-    /**
-     * The recommended action. Required for what_action (1
-     * sentence per spec).
-     */
-    what_action: z.string().trim().min(1).max(4000),
-    /**
-     * Optional structured bullets (e.g. "4 phases, 3 gates passed,
-     * 1 evaluator verdict"). Counts are allowed at this layer; the
-     * brief section is the NL primary (RL-7).
-     */
-    bullets: z.array(z.string().trim().min(1).max(1000)).default([]),
-    /**
-     * Source trace ids backing the brief (the column on
-     * crystallization_event spec §4.5).
-     */
-    source_trace_pointers: z
-        .array(z.string().trim().min(1).max(256))
-        .default([]),
-});
-/**
- * The summary emitted by the independent evaluators (spec §4.5
- * `evaluator_summary` field). Optional for the brief builder — the
- * brief can be built without it, but a filled evaluator_summary
- * flows into the recommendation envelope.
- */
-export const EvaluatorSummarySchema = z.object({
-    one_liner: z.string().trim().max(1000).default(""),
-    risk_tags: z.array(z.string().trim().min(1).max(200)).default([]),
-});
-/* ---------------------------------------------------------------------- */
-/* Recommendation envelope — the CLI renders this.                       */
-/* ---------------------------------------------------------------------- */
-export const RecommendationPayloadSchema = z.object({
-    brief: EvidenceBriefSchema,
-    bullets: z.array(z.string().trim().min(1).max(1000)).default([]),
-    source_trace_pointers: z
-        .array(z.string().trim().min(1).max(256))
-        .default([]),
-    evaluator_summary: EvaluatorSummarySchema.default({
-        one_liner: "",
-        risk_tags: [],
-    }),
-});
-/* ---------------------------------------------------------------------- */
-/* Errors                                                                 */
-/* ---------------------------------------------------------------------- */
-export class BriefSectionError extends Error {
-    code = "MISSING_BRIEF_SECTION";
-    findings;
-    constructor(message, findings = []) {
-        super(message);
-        this.name = "BriefSectionError";
-        this.findings = findings;
-    }
-}
-/* ---------------------------------------------------------------------- */
-/* Builder                                                                */
-/* ---------------------------------------------------------------------- */
-/**
- * Build a 4-section EvidenceBrief from a finished trace recap.
- *
- * The function is STRICT: it parses the input trace through
- * `BriefTraceInputSchema`, then parses the assembled brief through
- * `EvidenceBriefSchema`. Any missing section throws
- * `BriefSectionError(MISSING_BRIEF_SECTION)` — the same code that
- * `safeParseEvidenceBrief` returns — so a single error code is the
- * user-facing signal for "brief incomplete, do not render".
- *
- * Brief-section related ZodErrors (e.g. `min(1)` on a section) are
- * translated to `BriefSectionError` so callers only handle one
- * shape of failure. Non-section ZodErrors (e.g. invalid `trace_id`)
- * are re-raised unchanged.
- *
- * NOTE: callers who already have raw NL strings can also call
- * `parseEvidenceBrief` directly; this function is the opinionated
- * shape for trace -> brief.
- */
-export function buildEvidenceBrief(trace, evaluatorSummary) {
-    let parsedTrace;
-    try {
-        parsedTrace = BriefTraceInputSchema.parse(trace);
-    }
-    catch (err) {
-        throw translateBriefZodError(err);
-    }
-    // Assemble the 4 sections verbatim from the trace recap. The Zod
-    // parser below re-asserts the 4-section guard.
-    const candidate = {
-        what_happened: parsedTrace.what_happened,
-        why_it_matters: parsedTrace.why_it_matters,
-        what_learned: parsedTrace.what_learned,
-        what_action: parsedTrace.what_action,
-    };
-    const result = EvidenceBriefSchema.safeParse(candidate);
-    if (!result.success) {
-        const findings = result.error.issues.map((i) => ({
-            path: i.path.join("."),
-            message: i.message,
-        }));
-        throw new BriefSectionError("evidence_brief must contain all 4 sections (what_happened, why_it_matters, what_learned, what_action) with non-empty content (spec §4.7 / RL-7)", findings);
-    }
-    // Silence the unused-var lint on evaluatorSummary at this layer —
-    // the builder currently does not consume it (the brief is NL
-    // primary), but the surface is preserved for callers via
-    // `renderRecommendationPayload` below.
-    void evaluatorSummary;
-    return result.data;
-}
-/**
- * Translate a ZodError raised on a brief-section path into a
- * `BriefSectionError`. Non-brief errors are re-raised.
- */
-function translateBriefZodError(err) {
-    if (err instanceof z.ZodError) {
-        const issues = err.issues;
-        const allBrief = issues.every((i) => BRIEF_SECTION_KEYS.has(i.path.join(".")));
-        if (allBrief) {
-            const findings = issues.map((i) => ({
-                path: i.path.join("."),
-                message: i.message,
-            }));
-            throw new BriefSectionError("evidence_brief must contain all 4 sections (what_happened, why_it_matters, what_learned, what_action) with non-empty content (spec §4.7 / RL-7)", findings);
-        }
-    }
-    throw err;
-}
-const BRIEF_SECTION_KEYS = new Set([
-    "what_happened",
-    "why_it_matters",
-    "what_learned",
-    "what_action",
-]);
-/**
- * Render the user-facing recommendation envelope (brief + bullets +
- * trace pointers + evaluator summary). The function refuses to
- * return a payload unless ALL 4 brief sections are present — this
- * is the single CLI-facing gate per spec §10 RL-7.
- *
- * On success, returns the validated `RecommendationPayload`. On a
- * missing-section brief, throws `BriefSectionError`.
- */
-export function renderRecommendationPayload(trace, evaluatorSummary = { one_liner: "", risk_tags: [] }) {
-    const brief = buildEvidenceBrief(trace, evaluatorSummary);
-    const payload = RecommendationPayloadSchema.parse({
-        brief,
-        bullets: trace.bullets ?? [],
-        source_trace_pointers: trace.source_trace_pointers ?? [],
-        evaluator_summary: evaluatorSummary,
-    });
-    return payload;
-}
-/**
- * Convenience: validate an arbitrary unknown payload AS IF it were a
- * recommendation envelope. Returns a Result-like shape so the CLI can
- * render a structured MISSING_BRIEF_SECTION error without try/catch
- * noise.
- */
-export function safeRenderRecommendationPayload(input) {
-    const r = RecommendationPayloadSchema.safeParse(input);
-    if (r.success)
-        return { ok: true, payload: r.data };
-    const findings = r.error.issues.map((i) => ({
-        path: i.path.join("."),
-        message: i.message,
-    }));
-    // Map brief failures to MISSING_BRIEF_SECTION. A failure is
-    // recognized as brief iff (a) every issue points at the brief or
-    // its sections, OR (b) the explicit refine message is present.
-    const isBrief = r.error.issues.every((i) => i.message.includes("evidence_brief must contain all 4 sections") ||
-        BRIEF_SECTION_KEYS.has(i.path.join(".")) ||
-        i.path[0] === "brief" ||
-        (i.path.length >= 2 && i.path[0] === "brief"));
-    return isBrief
-        ? { ok: false, code: "MISSING_BRIEF_SECTION", findings }
-        : { ok: false, findings };
-}

package/dist/services/doctor/doctor-service.d.ts

@@ -1,149 +0,0 @@
-import { type SkillPresence } from '../skills/skill-presence-service.js';
-export type DoctorCheck = {
-    id: string;
-    ok: boolean;
-    message: string;
-};
-export type DoctorReport = {
-    checks: DoctorCheck[];
-    summary: {
-        ok: boolean;
-        passed: number;
-        failed: number;
-    };
-};
-export type CodegraphCapabilityProbe = {
-    packagePath: string;
-    version: string;
-    binaryPath: string;
-    binaryExists: boolean;
-};
-export type DistVersionComparison = {
-    dist: string | null;
-    source: string;
-    match: boolean;
-    distReadable: boolean;
-};
-export type DistVersionProbe = () => DistVersionComparison;
-export type WorkspaceLayoutInspection = {
-    topLevelSessionDirs: string[];
-    legacyDotfiles: string[];
-    /**
-     * Slice 007 — per-change-id top-level dirs (e.g. `.peaks/001-2026-06-06-.../`).
-     * The pre-F3 canonical layout put reviewable artifacts under a
-     * per-change-id top-level dir; the post-F3 canonical layout
-     * consolidates them under `.peaks/_runtime/<sid>/<role>/`. Any
-     * leftover per-change-id top-level dir is a regression to flag.
-     * Slice 008's migration will consolidate these; until then, the
-     * check reports them as `ok: false`.
-     *
-     * Optional in the type for back-compat with test probes that
-     * pre-date the slice 007 broadening; the check itself falls back
-     * to an empty array when the field is missing.
-     */
-    perChangeIdDirs?: string[];
-};
-export type WorkspaceLayoutProbe = () => WorkspaceLayoutInspection;
-/**
- * 2026-06-10 — `gateguard-fact-force` (a third-party PreToolUse hook,
- * NOT peaks-loop) fires on Edit / Write and demands a 4-fact questionnaire
- * before allowing the edit. When the LLM is in a peaks-qa flow and tries
- * to update `.peaks/_runtime/<sid>/qa/requests/*.md` via the Edit/Write
- * tool, the hook demands facts that are inapplicable to QA envelope
- * templates (no importers, no public API, no data files, user
- * instruction already in the conversation context). The check detects
- * this hook in the user's global and project `.claude/settings.json` and
- * warns when no `.peaks/**` skip is configured. The probe is injected so
- * tests do not depend on the real `~/.claude/settings.json` state.
- */
-export type GateguardHookLocation = {
-    /** Source file the hook was discovered in (`global` or `project .claude/settings.json`). */
-    source: 'global' | 'project';
-    /** Resolved absolute path to the source file (for the message). */
-    sourcePath: string;
-    /** The PreToolUse entry that contains a gateguard hook command. */
-    entry: {
-        matcher?: string;
-        hooks: ReadonlyArray<{
-            type?: string;
-            command?: string;
-        }>;
-    };
-};
-export type GateguardProbeResult = {
-    /** Absolute path to `~/.claude/settings.json` (or null when the probe could not resolve it). */
-    globalSettingsPath: string | null;
-    /** Parsed global settings payload (or null when missing / unreadable / malformed). */
-    globalSettings: unknown;
-    /** Absolute path to the project `.claude/settings.json` (or null when the project root is not in a peaks project). */
-    projectSettingsPath: string | null;
-    /** Parsed project settings payload (or null when missing / unreadable / malformed). */
-    projectSettings: unknown;
-};
-export type GateguardProbe = () => GateguardProbeResult;
-export type DoctorOptions = {
-    schemasBaseDir?: string;
-    skillsBaseDir?: string;
-    codegraphProbe?: () => CodegraphCapabilityProbe;
-    skillPresenceProbe?: () => SkillPresence | null;
-    skillPresenceFreshnessThresholdMs?: number;
-    statusLineInstalledProbe?: () => boolean;
-    /** Returns true when a Peaks workspace session (.peaks/.session.json) exists. */
-    workspaceInitializedProbe?: () => boolean;
-    /** Platform string (defaults to process.platform); injectable for tests. */
-    platform?: NodeJS.Platform;
-    /** Injected for the build:dist-version-matches-source check (defaults to compareDistVersion on disk). */
-    distVersionProbe?: DistVersionProbe;
-    /** Injected for the build:workspace-layout-canonical check (defaults to inspectWorkspaceLayout on disk). */
-    workspaceLayoutProbe?: WorkspaceLayoutProbe;
-    /** Injected for the integration:gateguard-peaks-conflict check (defaults to defaultGateguardProbe on disk). */
-    gateguardProbe?: GateguardProbe;
-    /**
-     * Slice 2026-06-13-repair-pre-existing-test-failures: injected
-     * root for the L3:l3-memory-health check (defaults to
-     * `findProjectRoot(process.cwd())`). Tests use this to point the
-     * check at a temp dir without monkey-patching `findProjectRoot`.
-     */
-    l3ProjectRoot?: string;
-};
-/**
- * Pure helper extracted from `defaultWorkspaceInitializedProbe` so tests can
- * drive the filesystem check without monkey-patching `process.cwd()` or
- * `findProjectRoot`. Returns `true` when EITHER the canonical
- * `.peaks/_runtime/session.json` OR the legacy `.peaks/.session.json` exists.
- */
-export declare function isWorkspaceInitializedAt(projectRoot: string): boolean;
-/**
- * Pure helper that compares the published dist `CLI_VERSION` against the
- * source-of-truth `package.json#version`. Default readers fail-soft to `null`
- * on missing/unreadable/malformed input. Exported so tests can drive the
- * filesystem reads without monkey-patching `process.cwd()`.
- */
-export declare function compareDistVersion(opts: {
-    projectRoot: string;
-    distVersionReader?: (root: string) => string | null;
-    sourceVersionReader?: (root: string) => string | null;
-}): DistVersionComparison;
-/**
- * Pure helper that inspects the on-disk workspace layout for
- * post-F3-canonical violations. The post-F3 canonical layout puts
- * session dirs under `.peaks/_runtime/<sid>/` and the runtime
- * binding at `.peaks/_runtime/session.json`; the legacy paths
- * (top-level `<YYYY-MM-DD-session-<hex>>/` dirs and the legacy
- * top-level `.peaks/.session.json` / `.peaks/.active-skill.json`
- * dotfiles) must be absent. This helper is exported so tests can
- * drive the filesystem walk without monkey-patching `process.cwd()`
- * or `findProjectRoot`.
- *
- * Both scanners fail-soft (return `[]` on read errors) so a flaky
- * filesystem read on a non-fatal probe path never escalates into a
- * doctor failure.
- */
-export declare function inspectWorkspaceLayout(opts: {
-    projectRoot: string;
-    topLevelScanner?: (root: string) => string[];
-    dotfileScanner?: (root: string) => string[];
-    perChangeIdScanner?: (root: string) => string[];
-}): WorkspaceLayoutInspection;
-export declare function collectGateguardEntries(probe: GateguardProbeResult): GateguardHookLocation[];
-export declare function runDoctor(options?: DoctorOptions): Promise<DoctorReport>;