peaks-loop 4.0.0-beta.3 → 4.0.0-beta.31

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/migrate-skill-name/schema.d.ts

@@ -1,42 +0,0 @@
-import { z } from 'zod';
-/**
- * Result shape for `peaks session migrate-skill-name`.
- *
- * Counters:
- *   - `scannedFiles` — every .json / .md under `.peaks/_runtime/**` (excluding
- *     skip dirs below).
- *   - `modifiedFiles` — files whose contents would change (dry-run reports
- *     the predicted count; --apply reports the actually-written count).
- *   - `keyValueReplacements` — `"skill": "<old>"` → `"skill": "<new>"`.
- *   - `stringReplacements` — `/<old>` → `/<new>` slash-trigger mentions.
- *
- * Errors are surfaced per-file with `errors: [ "<absPath>: <message>", … ]`;
- * the tool never silently skips a broken JSON file (Karpathy §4 honesty:
- * silence on bad data is the worst kind of fake-green).
- */
-export declare const MigrateResultSchema: z.ZodObject<{
-    ok: z.ZodBoolean;
-    scannedFiles: z.ZodNumber;
-    modifiedFiles: z.ZodNumber;
-    keyValueReplacements: z.ZodNumber;
-    stringReplacements: z.ZodNumber;
-    skipped: z.ZodArray<z.ZodString, "many">;
-    errors: z.ZodArray<z.ZodString, "many">;
-}, "strip", z.ZodTypeAny, {
-    ok: boolean;
-    skipped: string[];
-    scannedFiles: number;
-    modifiedFiles: number;
-    keyValueReplacements: number;
-    stringReplacements: number;
-    errors: string[];
-}, {
-    ok: boolean;
-    skipped: string[];
-    scannedFiles: number;
-    modifiedFiles: number;
-    keyValueReplacements: number;
-    stringReplacements: number;
-    errors: string[];
-}>;
-export type MigrateResult = z.infer<typeof MigrateResultSchema>;

package/dist/src/services/mut/assert-scanner.d.ts

@@ -1,6 +0,0 @@
-import type { AssertionsReport } from './types.js';
-export interface ScanInput {
-    readonly project: string;
-    readonly testFiles: ReadonlyArray<string>;
-}
-export declare function scanAssertions(input: ScanInput): Promise<AssertionsReport>;

package/dist/src/services/mut/assert-scanner.js

@@ -1,116 +0,0 @@
-/**
- * Per spec §4.2 验收审计 + §7 阶段二 — 5-pattern weak-assertion AST scan.
- *
- * Hard constraints:
- *   H6 (CLI裁决): every detection is regex/AST-based, not LLM-judged.
- *   KISS: regex matchers on common expect() patterns. Production slice
- *   would migrate to TypeScript Compiler API; v1 ships regex for speed.
- *
- * Weak patterns (5):
- *   - toBeDefined()
- *   - toBeTruthy()
- *   - toEqual(x) where arg === receiver (toEqual-self)
- *   - expect.anything()
- *   - toBe(x) where arg === receiver (toBe-self)
- */
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-const WEAK_PATTERNS = [
-    { pattern: 'toBeDefined', regex: /\.toBeDefined\s*\(\s*\)/g },
-    { pattern: 'toBeTruthy', regex: /\.toBeTruthy\s*\(\s*\)/g },
-    { pattern: 'expect-anything', regex: /expect\.anything\s*\(\s*\)/g },
-    // Self-equality patterns require matched-pair parsing; handled below.
-];
-const TO_EQUAL_SELF = /\.toEqual\s*\(\s*([a-zA-Z_$][\w$]*)\s*\)/g;
-const TO_BE_SELF = /\.toBe\s*\(\s*([a-zA-Z_$][\w$]*)\s*\)/g;
-async function countAssertions(content) {
-    // Approximate: count expect(...).method( occurrences.
-    // Handle nested parens by finding expect( and matching to a balanced close.
-    let count = 0;
-    const re = /expect\s*\(/g;
-    for (const m of content.matchAll(re)) {
-        let depth = 1;
-        let i = (m.index ?? 0) + m[0].length;
-        while (i < content.length && depth > 0) {
-            const ch = content[i];
-            if (ch === '(')
-                depth++;
-            else if (ch === ')')
-                depth--;
-            i++;
-        }
-        // After balanced expect(...), check for .method( pattern.
-        const tail = content.slice(i);
-        if (/^\s*\.\w+\s*\(/.test(tail)) {
-            count++;
-        }
-    }
-    return count;
-}
-function lineOf(content, offset) {
-    return content.slice(0, offset).split('\n').length;
-}
-export async function scanAssertions(input) {
-    let total = 0;
-    let weak = 0;
-    const byPattern = new Map();
-    for (const file of input.testFiles) {
-        const fullPath = join(input.project, file);
-        const content = await readFile(fullPath, 'utf8');
-        total += await countAssertions(content);
-        for (const { pattern, regex } of WEAK_PATTERNS) {
-            const matches = [...content.matchAll(regex)];
-            if (matches.length > 0) {
-                weak += matches.length;
-                const list = byPattern.get(pattern) ?? [];
-                for (const m of matches) {
-                    const idx = m.index ?? 0;
-                    list.push({ file, line: lineOf(content, idx), code: m[0] });
-                }
-                byPattern.set(pattern, list);
-            }
-        }
-        // toEqual-self: needs receiver extraction.
-        const eqSelf = [...content.matchAll(TO_EQUAL_SELF)];
-        for (const m of eqSelf) {
-            const receiverMatch = content.slice(0, m.index ?? 0).match(/expect\s*\(\s*([a-zA-Z_$][\w$]*)\s*\)/g);
-            if (receiverMatch && receiverMatch.length > 0) {
-                const lastReceiver = receiverMatch[receiverMatch.length - 1];
-                const receiverName = lastReceiver?.match(/expect\s*\(\s*([a-zA-Z_$][\w$]*)\s*\)/)?.[1];
-                if (receiverName && receiverName === m[1]) {
-                    weak += 1;
-                    const idx = m.index ?? 0;
-                    const list = byPattern.get('toEqual-self') ?? [];
-                    list.push({ file, line: lineOf(content, idx), code: m[0] });
-                    byPattern.set('toEqual-self', list);
-                }
-            }
-        }
-        // toBe-self: same pattern.
-        const beSelf = [...content.matchAll(TO_BE_SELF)];
-        for (const m of beSelf) {
-            const receiverMatch = content.slice(0, m.index ?? 0).match(/expect\s*\(\s*([a-zA-Z_$][\w$]*)\s*\)/g);
-            if (receiverMatch && receiverMatch.length > 0) {
-                const lastReceiver = receiverMatch[receiverMatch.length - 1];
-                const receiverName = lastReceiver?.match(/expect\s*\(\s*([a-zA-Z_$][\w$]*)\s*\)/)?.[1];
-                if (receiverName && receiverName === m[1]) {
-                    weak += 1;
-                    const idx = m.index ?? 0;
-                    const list = byPattern.get('toBe-self') ?? [];
-                    list.push({ file, line: lineOf(content, idx), code: m[0] });
-                    byPattern.set('toBe-self', list);
-                }
-            }
-        }
-    }
-    const weakPatterns = [];
-    for (const [pattern, examples] of byPattern.entries()) {
-        weakPatterns.push({ pattern, count: examples.length, examples });
-    }
-    return {
-        totalAssertions: total,
-        weakAssertions: weak,
-        weakRate: total === 0 ? 0 : weak / total,
-        weakPatterns,
-    };
-}

package/dist/src/services/mut/index.d.ts

@@ -1,8 +0,0 @@
-export { MutReportSchema } from './types.js';
-export { scanAssertions, type ScanInput } from './assert-scanner.js';
-export { runMutation, type RunMutationInput, type RunMutationOutput, type StrykerInvoker, type StrykerRawResult, } from './mut-runner.js';
-export { createProductionStrykerInvoker } from './production-stryker.js';
-export { buildMutReport, type BuildMutInput } from './report-builder.js';
-export { loadMutReport, mutReportPath, MUT_REPORT_RELATIVE_PATH } from './report-loader.js';
-export { DEFAULT_THRESHOLDS, evaluateThresholds, type Thresholds, type ThresholdEvaluation, type ThresholdViolation, type ThresholdViolationKind, } from './thresholds.js';
-export type { MutReportJson, MutationReport, AssertionsReport, WeakPattern, WeakPatternCount, Followup, } from './types.js';

package/dist/src/services/mut/index.js

@@ -1,7 +0,0 @@
-export { MutReportSchema } from './types.js';
-export { scanAssertions } from './assert-scanner.js';
-export { runMutation, } from './mut-runner.js';
-export { createProductionStrykerInvoker } from './production-stryker.js';
-export { buildMutReport } from './report-builder.js';
-export { loadMutReport, mutReportPath, MUT_REPORT_RELATIVE_PATH } from './report-loader.js';
-export { DEFAULT_THRESHOLDS, evaluateThresholds, } from './thresholds.js';

package/dist/src/services/mut/mut-runner.d.ts

@@ -1,39 +0,0 @@
-/**
- * Per spec §4.2 验收审计 — Stryker wrapper for TS mutation testing.
- *
- * Hard constraints:
- *   H6 (CLI裁决): invokeStryker is injected; production wires it to
- *       @stryker-mutator/core programmatic API.
- *   DRY: production implementation lives in this file; tests mock the
- *       invokeStryker injection point.
- *   KISS: keep the public surface narrow — input, invoker, output.
- */
-import type { MutationReport } from './types.js';
-export interface StrykerRawResult {
-    readonly mutantsTotal: number;
-    readonly mutantsKilled: number;
-    readonly mutantsSurvived: number;
-    readonly mutantsTimeout: number;
-    readonly perFile: ReadonlyArray<{
-        readonly file: string;
-        readonly killRate: number;
-        readonly survived: ReadonlyArray<{
-            line: number;
-            mutation: string;
-            survivedBecause: string;
-        }>;
-    }>;
-}
-export type StrykerInvoker = (opts: {
-    project: string;
-    testFiles: ReadonlyArray<string>;
-}) => Promise<StrykerRawResult>;
-export interface RunMutationInput {
-    readonly project: string;
-    readonly testFiles: ReadonlyArray<string>;
-    readonly invokeStryker: StrykerInvoker;
-}
-export interface RunMutationOutput {
-    readonly mutation: MutationReport;
-}
-export declare function runMutation(input: RunMutationInput): Promise<RunMutationOutput>;

package/dist/src/services/mut/mut-runner.js

@@ -1,29 +0,0 @@
-export async function runMutation(input) {
-    let raw;
-    try {
-        raw = await input.invokeStryker({
-            project: input.project,
-            testFiles: input.testFiles,
-        });
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new Error(`Stryker invocation failed: ${message}`);
-    }
-    const killRate = raw.mutantsTotal === 0 ? 0 : raw.mutantsKilled / raw.mutantsTotal;
-    return {
-        mutation: {
-            tool: 'stryker',
-            mutantsTotal: raw.mutantsTotal,
-            mutantsKilled: raw.mutantsKilled,
-            mutantsSurvived: raw.mutantsSurvived,
-            mutantsTimeout: raw.mutantsTimeout,
-            killRate,
-            byFile: raw.perFile.map((f) => ({
-                file: f.file,
-                killRate: f.killRate,
-                survived: f.survived,
-            })),
-        },
-    };
-}

package/dist/src/services/mut/production-stryker.d.ts

@@ -1,2 +0,0 @@
-import type { StrykerInvoker } from './mut-runner.js';
-export declare function createProductionStrykerInvoker(): StrykerInvoker;

package/dist/src/services/mut/production-stryker.js

@@ -1,75 +0,0 @@
-/**
- * Production Stryker invoker. Uses @stryker-mutator/core programmatic API.
- * Note: this is a thin wrapper — actual Stryker invocation requires the
- * Stryker config in `stryker.conf.js` to live at the project root.
- */
-import { relative, isAbsolute } from 'node:path';
-export function createProductionStrykerInvoker() {
-    return async ({ project, testFiles: _testFiles }) => {
-        // Lazy-load Stryker so unit tests don't need it installed.
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const Stryker = (await import('@stryker-mutator/core')).Stryker;
-        // Mutation surface is owned by stryker.conf.js. testFiles is a runtime
-        // hint (consumed by the configured testRunner, not by Stryker's `mutate`
-        // field — `mutate` is source files to mutate, never test paths).
-        const stryker = new Stryker({});
-        const mutants = (await stryker.runMutationTest());
-        return normalize(mutants, project);
-    };
-}
-function normalize(mutants, project) {
-    let mutantsKilled = 0;
-    let mutantsSurvived = 0;
-    let mutantsTimeout = 0;
-    for (const m of mutants) {
-        if (m.status === 'Killed')
-            mutantsKilled++;
-        else if (m.status === 'Survived')
-            mutantsSurvived++;
-        else if (m.status === 'Timeout')
-            mutantsTimeout++;
-    }
-    // Bucket mutants by fileName to populate perFile. deriveFollowups iterates
-    // m.byFile to emit per-file followups (e.g. low_kill_rate) — leaving this
-    // empty (as v0 did) silently swallowed those followups in production.
-    const byFile = new Map();
-    for (const m of mutants) {
-        // Stryker 8 returns absolute paths in MutantResult.fileName. Strip the
-        // project root so byFile[].file is repo-relative (e.g. "src/services/loop/...").
-        // path.relative falls back to the absolute path when input is outside
-        // project, which is the safest failure mode.
-        const file = isAbsolute(m.fileName) && m.fileName.startsWith(project)
-            ? relative(project, m.fileName)
-            : m.fileName;
-        let bucket = byFile.get(file);
-        if (!bucket) {
-            bucket = { killed: 0, survived: 0, survivedEntries: [] };
-            byFile.set(file, bucket);
-        }
-        if (m.status === 'Killed')
-            bucket.killed++;
-        else if (m.status === 'Survived') {
-            bucket.survived++;
-            bucket.survivedEntries.push({
-                line: m.location.start.line + 1, // Stryker is 0-based; reports are 1-based.
-                mutation: m.replacement,
-                survivedBecause: m.statusReason ?? '',
-            });
-        }
-    }
-    const perFile = [...byFile.entries()]
-        .map(([file, b]) => {
-        const total = b.killed + b.survived;
-        const killRate = total === 0 ? 0 : b.killed / total;
-        return { file, killRate, survived: b.survivedEntries };
-    })
-        // Stable order for MUT.sig / reports.
-        .sort((a, b) => a.file.localeCompare(b.file));
-    return {
-        mutantsTotal: mutants.length,
-        mutantsKilled,
-        mutantsSurvived,
-        mutantsTimeout,
-        perFile,
-    };
-}

package/dist/src/services/mut/report-builder.d.ts

@@ -1,11 +0,0 @@
-import { type AssertionsReport, type MutationReport, type MutReportJson } from './types.js';
-import { type Thresholds } from './thresholds.js';
-export interface BuildMutInput {
-    readonly mutation: MutationReport;
-    readonly assertions: AssertionsReport;
-    readonly inputSig: string;
-    readonly out: string;
-    readonly thresholds?: Thresholds;
-    readonly now?: () => Date;
-}
-export declare function buildMutReport(input: BuildMutInput): Promise<MutReportJson>;

package/dist/src/services/mut/report-builder.js

@@ -1,110 +0,0 @@
-/**
- * Combines MutationReport + AssertionsReport into MutReportJson, computes
- * thresholds, derives followups, computes MUT.sig, writes file atomically.
- *
- * Hard constraints:
- *   H8 (audit trail hashable): MUT.sig is sha256 of normalized content;
- *       generatedAt + sha256 are excluded from the digest to make the
- *       signature deterministic across runs.
- *   H6 (CLI裁决): passed boolean + followups computed by CLI, not LLM.
- *   KISS: keep composition narrow — input, thresholds, output file path.
- */
-import { createHash } from 'node:crypto';
-import { mkdir, rename, unlink, writeFile } from 'node:fs/promises';
-import { dirname } from 'node:path';
-import { MutReportSchema, } from './types.js';
-import { DEFAULT_THRESHOLDS, evaluateThresholds, } from './thresholds.js';
-function deriveFollowups(m, a, t) {
-    const out = [];
-    if (m.killRate < t.mutationKillRateMin) {
-        for (const f of m.byFile) {
-            if (f.killRate < t.mutationKillRateMin) {
-                out.push({
-                    file: f.file,
-                    issue: 'low_kill_rate',
-                    severity: 'soft',
-                    suggestion: `Add tests for ${f.survived.length} survived mutants in ${f.file}`,
-                });
-            }
-        }
-    }
-    if (a.weakRate > t.weakAssertionRateMax) {
-        for (const p of a.weakPatterns) {
-            if (p.count > 0) {
-                const exampleFile = p.examples[0]?.file ?? '<unknown>';
-                out.push({
-                    file: exampleFile,
-                    issue: 'high_weak_assertions',
-                    severity: 'hard',
-                    suggestion: `Replace ${p.count} weak assertions of type "${p.pattern}" with concrete value checks`,
-                });
-            }
-        }
-    }
-    return out;
-}
-/**
- * Recursively sort object keys to produce a canonical JSON string.
- * Arrays preserve order; only object keys are sorted.
- */
-function canonicalize(value) {
-    if (value === null || typeof value !== 'object') {
-        return value;
-    }
-    if (Array.isArray(value)) {
-        return value.map((v) => canonicalize(v));
-    }
-    const obj = value;
-    const sorted = {};
-    for (const key of Object.keys(obj).sort()) {
-        sorted[key] = canonicalize(obj[key]);
-    }
-    return sorted;
-}
-function sha256OfCanonical(value) {
-    const canonical = JSON.stringify(canonicalize(value));
-    return createHash('sha256').update(canonical).digest('hex');
-}
-/**
- * Compute MUT.sig: sha256 of the report content excluding generatedAt and
- * sha256 itself. Both fields are removed before canonicalization so the
- * digest is stable across runs that differ only in timestamp.
- */
-function computeMutSig(report) {
-    const { generatedAt: _g, ...rest } = report;
-    void _g;
-    return sha256OfCanonical(rest);
-}
-export async function buildMutReport(input) {
-    const thresholds = input.thresholds ?? DEFAULT_THRESHOLDS;
-    const now = input.now ?? (() => new Date());
-    const evalResult = evaluateThresholds(thresholds, input.mutation.killRate, input.assertions.weakRate);
-    const followups = deriveFollowups(input.mutation, input.assertions, thresholds);
-    const partial = {
-        version: '1.0',
-        generatedAt: now().toISOString(),
-        inputSig: input.inputSig,
-        mutation: input.mutation,
-        assertions: input.assertions,
-        thresholds: {
-            mutationKillRateMin: thresholds.mutationKillRateMin,
-            weakAssertionRateMax: thresholds.weakAssertionRateMax,
-            passed: evalResult.passed,
-        },
-        followups,
-    };
-    const sha256 = computeMutSig(partial);
-    const final = { ...partial, sha256 };
-    MutReportSchema.parse(final);
-    await mkdir(dirname(input.out), { recursive: true });
-    const tmp = `${input.out}.tmp`;
-    try {
-        await writeFile(tmp, JSON.stringify(final, null, 2), 'utf8');
-        await rename(tmp, input.out);
-    }
-    catch (err) {
-        await unlink(tmp).catch(() => undefined);
-        throw err;
-    }
-    return final;
-}

package/dist/src/services/mut/report-loader.d.ts

@@ -1,31 +0,0 @@
-import { type MutReportJson } from './types.js';
-export declare const MUT_REPORT_RELATIVE_PATH = "mut/mut-report.json";
-/**
- * Build the canonical absolute path of a session's mut-report.json.
- * Exported so the CLI surface in qa-commands can reuse the same
- * constant for diagnostic messages.
- *
- * Uses POSIX separators intentionally: the one-axis envelope is
- * documented as `.peaks/_runtime/<sid>/mut/mut-report.json` (forward
- * slashes) and that path is what the hotfix 81f00ce audit-trail
- * contract guarantees. `node:path` would produce backslashes on
- * Windows, breaking the cross-platform invariant. POSIX join is
- * correct here because the result is a logical path stored in JSON
- * artifacts and CLI diagnostics — it never gets passed to OS
- * syscalls directly (readFile / writeFile accept both forms).
- */
-export declare function mutReportPath(sessionId: string): string;
-/**
- * Read and validate a session's mut-report.json.
- *
- * Returns `null` for any of these cases:
- *   - file does not exist (ENOENT)
- *   - file exists but JSON is malformed
- *   - file exists and parses but does not satisfy `MutReportSchema`
- *
- * Never throws. Never logs to stdout (per "no console.log in src/").
- * Schema-parse failures are reported via `process.stderr` so the
- * qa-runner operator can see why their report is being treated as
- * absent.
- */
-export declare function loadMutReport(sessionId: string): Promise<MutReportJson | null>;