niceeval 0.13.3 → 0.13.4-canary.39

package/README.md

@@ -1,176 +0,0 @@
-<div align="center">
-
-# NiceEval
-
-**Progressive, agent-native evals tool for AI agents, with excellent DX**
-
-[![typescript](https://img.shields.io/badge/typescript-5.6-blue?style=flat-square)](tsconfig.json)
-[![license](https://img.shields.io/badge/license-MIT-green?style=flat-square)](package.json)
-[![docs](https://img.shields.io/badge/docs-readable-111827?style=flat-square)](docs/README.md)
-[![discord](https://img.shields.io/badge/discord-join%20chat-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/yTMdZjFFJ)
-
-[中文](README.zh.md) | [Deutsch](assets/README.de.md) | [Español](assets/README.es.md) | [français](assets/README.fr.md) | [日本語](assets/README.ja.md) | [한국어](assets/README.ko.md) | [Português](assets/README.pt.md) | [Русский](assets/README.ru.md)
-
-</div>
-
-NiceEval is an agent eval tool that helps teams measure, evaluate, and improve AI in production. With NiceEval, teams can compare models, iterate on agents, catch regressions, and keep improving their AI applications using real user data.
-
-NiceEval is local-first at its core: your evals run in your own environment. When your team needs to share evals or track regressions, you can push a Report to platforms like BrainTrust, or export a custom report.
-
-## Why NiceEval when DeepEval, LangFuse, and BrainTrust already exist
-
-NiceEval is an Agent-Native eval tool. The Dataset / golden pattern of building an Input and an Expected Output doesn't fit real agent evaluation.
-Agents today need to be evaluated at a finer grain — multi-turn conversations, multi-agent collaboration, tool calls, skill loading — and NiceEval does this better.
-
-It also coexists with LangFuse and BrainTrust: use them for tracing, or upload eval results to both.
-
-## Architecture
-
-NiceEval supports two integration modes, depending on whether the agent under test needs an isolated sandbox filesystem.
-
-**Mode 1: Sandbox (Docker, E2B) — run coding agents like Codex and Claude Code that need a sandbox**
-
-```text
-   evals/*.eval.ts
-        │
-        ▼
-   ┌────────────┐
-   │  NiceEval  │
-   └────────────┘
-        │
-        │ Agent adapter (official)
-        ▼
-   ┌────────────────────────────────┐
-   │         Docker Sandbox         │
-   │    ┌────────────────────────┐  │
-   │    │ Codex / Claude Code    │  │
-   │    │ apps needing isolation │  │
-   │    └────────────────────────┘  │
-   └────────────────────────────────┘
-```
-
-**Mode 2: Direct — connect straight to your own AI Agent**
-
-```text
-   evals/*.eval.ts
-        │
-        ▼
-   ┌────────────┐
-   │  NiceEval  │
-   └────────────┘
-        │
-        │ Agent adapter (official, or your own implementation)
-        ▼
-   ┌──────────────────────────┐
-   │    your own AI Agent     │
-   │   (AI SDK·LangGraph·Pi)  │
-   └──────────────────────────┘
-```
-
-- **NiceEval core** owns discovery, scheduling, assertions, reporting, and artifacts.
-- **Agent adapters** are the open boundary: you decide how to call the system under test.
-- Coding agents that need filesystem isolation run inside the **Docker Sandbox**; your own AI agent can connect directly, without Docker.
-
-## Core concepts at a glance
-
-| Concept | In one line |
-|---|---|
-| Eval | A test case: written in `evals/*.eval.ts`, describing what to check. |
-| Experiment | A checked-in run configuration: which Adapter, which model, which flags. |
-| Adapter | The layer that connects to the system under test: implement one `send`, get back a standard event stream. |
-| Sandbox | Only needed for coding agents that require an isolated workspace; a direct web agent doesn't need one. |
-| Tier | Three levels of Adapter integration effort: Tier 1 wires up `send` only, Tier 2 adds OTel for a call waterfall, Tier 3 makes invasive changes for feature A/B testing. |
-
-See the full glossary in the [architecture overview](https://niceeval.com/docs/concepts/overview).
-
-## Example
-
-```ts
-// evals/eval-tool-call.eval.ts
-import { defineEval } from "niceeval";
-import { includes, jsonMatch, pattern, toolMatch } from "niceeval/expect";
-
-export default defineEval({
-  judge: true,
-  description: "Verify the agent calls the weather tool and answers from its result",
-
-  async test(t) {
-    const turn = await t.send("What's the weather in Beijing today?");
-    turn.succeeded();
-
-    await t.group("calls get_weather with the right city", () => {
-      turn.calledTool(toolMatch("get_weather", { input: jsonMatch({ city: "Beijing" }) }));
-      t.check(turn.message, pattern(/°C|sunny|cloudy|rain/));
-    });
-
-    const second = await t.send("What about Shanghai tomorrow?");
-    t.check(second.message, includes("Shanghai"));
-
-    turn.judge.autoevals
-      .closedQA("Does the reply use the tool's weather data instead of making up a temperature?")
-      .gate(0.7);
-  },
-});
-```
-
-```ts
-// experiments/local.ts
-import { defineExperiment } from "niceeval";
-import { webAgent } from "./adapter"; // your agent adapter, pointed at the system under test
-
-export default defineExperiment({
-  agent: webAgent({ baseUrl: "http://127.0.0.1:5188" }),
-  model: "gpt-5.5"
-});
-```
-
-```sh
-pnpm exec niceeval exp local eval-tool-call  // run only eval-tool-call under the local experiment
-pnpm exec niceeval view // view eval results
-```
-
-## Quick Start
-
-```text
-READ https://niceeval.com/INIT.md and set up niceeval for this repo: install it, integrate it with this project, and run the first eval end to end.
-```
-
-Start from the scenario that matches what you need to evaluate:
-
-- [Claude Code / Codex plugin eval](https://niceeval.com/docs/example/claude-code-codex-plugin)
-- [Claude Code / Codex skill eval](https://niceeval.com/docs/example/claude-code-codex-skill)
-- [AI Agent application eval](https://niceeval.com/docs/example/ai-agent-application)
-
-
-## Roadmap
-Official Adapters
-- [ ] Agent Software
-  - [x] Claude Code
-  - [x] Codex
-  - [x] Bub
-  - [x] OpenCode
-  - [x] Hermes Agent
-  - [x] OpenClaw
-  - [ ] Alma
-  - [ ] ...
-
-- [ ] Agent Frameworks
-  - [x] AI SDK
-  - [x] Claude SDK
-  - [x] Codex SDK
-  - [x] Pi Agent SDK
-  - [ ] LangGraph
-  - [ ] vm0
-  - [ ] Cursor Agent SDK
-
-## Documentation
-
-- [Quickstart](https://niceeval.com/docs/quickstart)
-
-# Acknowledgements
-This project was inspired by — or had its code learned by AI from — the projects below:
-- [eve](https://eve.dev): the main DX and API inspiration
-- [agent eval](https://github.com/vercel-labs/agent-eval)
-- [ponytail](https://github.com/DietrichGebert/ponytail)
-
-Thanks to [Linux.do](https://linux.do/) for their support and feedback during the project's early development.

package/README.zh.md

@@ -1,176 +0,0 @@
-<div align="center">
-
-# NiceEval
-
-**渐进式、Agent Native、DX优秀的 AI agent evals 工具**
-
-[![typescript](https://img.shields.io/badge/typescript-5.6-blue?style=flat-square)](tsconfig.json)
-[![license](https://img.shields.io/badge/license-MIT-green?style=flat-square)](package.json)
-[![docs](https://img.shields.io/badge/docs-readable-111827?style=flat-square)](docs/README.md)
-[![discord](https://img.shields.io/badge/discord-join%20chat-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/yTMdZjFFJ)
-
-[English](README.md) | [Deutsch](assets/README.de.md) | [Español](assets/README.es.md) | [français](assets/README.fr.md) | [日本語](assets/README.ja.md) | [한국어](assets/README.ko.md) | [Português](assets/README.pt.md) | [Русский](assets/README.ru.md)
-
-</div>
-
-NiceEval 是一个 Agent 评估工具，帮助团队衡量、评估并改进生产环境中的 AI。借助 NiceEval，团队可以比较模型、迭代 Agent、发现回归问题，并利用真实用户数据持续改进 AI 应用。
- 
-NiceEval 以本地优先为核心：你的评估在你自己的环境中运行。当你的团队需要分享评估、回归跟踪时，可以通过 Report 上报到 BrainTrust 等平台，或者自定义的报告导出。
-
-
-## 为什么有了 DeepEval、LangFuse、BrainTrust 还需要 NiceEval
-NiceEval 是一个 Agent-Native 的评估工具。Dataset / golden 那一套「构建 Input 与 Expected Output」的模式，并不适合真实的 Agent 评估。
-现在 Agent 需要在多轮对话、多 agent 协作、工具调用、Skill 加载等细粒度场景下进行评估，NiceEval 能做得更好。
-
-同时，NiceEval 也能与 LangFuse、BrainTrust 共存：可以用它们做 tracing，或者把评估结果上传到两者。
-
-## 架构
-
-NiceEval 支持两种接入方式，取决于被测 agent 是否需要隔离的沙箱文件系统。
-
-**模式一：Sandbox（Docker、E2B）—— 跑 Codex、Claude Code 等需要 sandbox 的 coding agent**
-
-```text
-   evals/*.eval.ts
-        │
-        ▼
-   ┌─────────────────────┐
-   │     NiceEval        │
-   └─────────────────────┘
-        │
-        │ Agent 适配器(官方)
-        ▼
-   ┌──────────────────────────────┐
-   │        Docker Sandbox        │
-   │   ┌────────────────────────┐ │
-   │   │ Codex / Claude Code    │ │
-   │   │ 需要隔离文件系统的应用     │ │
-   │   └────────────────────────┘ │
-   └──────────────────────────────┘
-```
-
-**模式二：直连 —— 直接连接你自己的 AI Agent**
-
-```text
-   evals/*.eval.ts
-        │
-        ▼
-   ┌─────────────────────┐
-   │     NiceEval        │
-   └─────────────────────┘
-        │
-        │ Agent 适配器(官方，或者自己实现)
-        ▼
-   ┌──────────────────────────────┐
-   │       你自己的 AI Agent        │
-   │   (AI SDK·LangGraph·Pi )     │ 
-   └──────────────────────────────┘
-```
-
-- **NiceEval 核心** 负责发现 eval、调度运行、打分、生成报告与 artifacts。
-- **Agent 适配器** 是开放的边界：你来决定如何调用被测系统。
-- 需要文件系统隔离的 coding agent 走 **Docker Sandbox**；自有的 AI Agent 可以直连，无需 Docker。
-
-## 核心概念一览
-
-| 概念 | 一句话 |
-|---|---|
-| Eval | 一个测试用例：写在 `evals/*.eval.ts` 里，描述测什么。 |
-| Experiment | 可签入的运行配置：决定连哪个 Adapter、什么 model、什么 flags。 |
-| Adapter | 连接被测系统的适配层：实现一个 `send`，把返回翻译成标准事件流。 |
-| Sandbox | 需要隔离工作区的 coding agent 才用得到；直连 Web Agent 不需要。 |
-| Tier | 接入 Adapter 的三档投入：Tier 1 只接 send，Tier 2 加 OTel 换调用瀑布图，Tier 3 侵入改造做 feature A/B。 |
-
-完整术语表见[架构概览](https://niceeval.com/docs/zh/explanation/overview)。
-
-## 示例
-
-```ts
-// evals/eval-tool-call.eval.ts
-import { defineEval } from "niceeval";
-import { includes, jsonMatch, pattern, toolMatch } from "niceeval/expect";
-
-export default defineEval({
-  judge: true,
-  description: "测试 agent 在实时天气问题中正确调用工具并基于结果作答的能力",
-
-  async test(t) {
-    const turn = await t.send("北京今天天气怎么样？");
-    turn.succeeded();
-
-    await t.group("调用 get_weather 且城市正确", () => {
-      turn.calledTool(toolMatch("get_weather", { input: jsonMatch({ city: "北京" }) }));
-      t.check(turn.message, pattern(/°C|气温|天气|晴|多云|雨/));
-    });
-
-    const second = await t.send("上海明天天气怎么样?");
-    t.check(second.message, includes("上海"));
-
-    turn.judge.autoevals
-      .closedQA("助手是否基于工具返回的天气数据作答，而不是凭空编造温度？")
-      .gate(0.7);
-  },
-});
-```
-
-```ts
-// experiments/local.ts
-import { defineExperiment } from "niceeval";
-import { webAgent } from "./adapter"; // 你自己写的 agent adapter，接被测 web agent
-
-export default defineExperiment({
-  agent: webAgent({ baseUrl: "http://127.0.0.1:5188" }),
-  model: "gpt-5.5"
-});
-```
-
-```sh
-pnpm exec niceeval exp local eval-tool-call  // 用 local experiment 只跑 eval-tool-call
-pnpm exec niceeval view // 查看评估结果
-```
-
-## 快速开始
-
-```text
-READ https://niceeval.com/INIT.md and set up niceeval for this repo: install it, integrate it with this project, and run the first eval end to end.
-```
-
-从你的场景开始：
-
-- [浏览可运行示例](https://niceeval.com/docs/zh/examples)
-- [评估 Coding Agent 扩展](https://niceeval.com/docs/zh/examples/coding-agent-extensions)
-- [自写 Adapter 评估 AI Agent 应用](https://niceeval.com/docs/zh/examples/ai-agent-application)
-
-
-## Roadmap
-官方适配器
-- [ ] Agent 软件
-  - [x] Claude Code
-  - [x] Codex
-  - [x] Bub
-  - [x] OpenCode
-  - [x] Hermes Agent
-  - [x] OpenClaw
-  - [ ] Alma
-  - [ ] ...
-
-- [ ] Agent 框架
-  - [x] AI SDK
-  - [x] Claude SDK
-  - [x] Codex SDK
-  - [x] Pi Agent SDK
-  - [ ] LangGraph
-  - [ ] vm0
-  - [ ] Cursor Agent SDK
-
-## 文档
-
-- [快速开始](https://www.niceeval.com/docs/zh/tutorials/quickstart)
-
-# 感谢
-该项目受下面项目所启发或者是由AI从下面项目中学习代码所写
-- [eve](https://eve.dev): 主要的 DX 与 API 受 Eve 所启发
-- [agent eval](https://github.com/vercel-labs/agent-eval)
-- [ponytail](https://github.com/DietrichGebert/ponytail)
-
-感谢 [Linux.do](https://linux.do/) 在项目早期开发期间给予的支持与反馈。

package/dist/cli/record.cjs

@@ -1,246 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeRecordCliLive = void 0;
-exports.ensureAutomaticRecordMigration = ensureAutomaticRecordMigration;
-exports.runRecordCliCommand = runRecordCliCommand;
-const node_path_1 = require("node:path");
-const effect_1 = require("effect");
-const index_ts_1 = require("../record/index.cjs");
-const index_ts_2 = require("../record/host/index.cjs");
-const errors_ts_1 = require("../record/reader/errors.cjs");
-const services_ts_1 = require("../record/platform/services.cjs");
-function output(input) {
-    return Object.freeze({
-        exitCode: input.exitCode,
-        stdout: input.stdout ?? "",
-        stderr: input.stderr ?? "",
-    });
-}
-exports.NodeRecordCliLive = index_ts_1.NodeRecordLive;
-/**
- * Preflight for ordinary CLI entry points. Every Scope is closed before the
- * next lease kind is acquired: read check -> exclusive maintenance -> caller's
- * fresh ordinary open.
- */
-function ensureAutomaticRecordMigration(input) {
-    const root = (0, index_ts_1.makeRecordRoot)((0, node_path_1.resolve)(input.cwd, input.record ?? ".niceeval/record"));
-    if (effect_1.Either.isLeft(root))
-        return effect_1.Effect.fail(root.left);
-    return effect_1.Effect.gen(function* () {
-        const fileSystem = yield* services_ts_1.RecordFileSystem;
-        if ((yield* fileSystem.pathKind((0, services_ts_1.recordPortablePath)(root.right, "record.json"))) === "missing") {
-            return null;
-        }
-        const checked = yield* effect_1.Effect.either(effect_1.Effect.scoped(index_ts_2.recordHost.current.openRead({ root: root.right })));
-        if (effect_1.Either.isRight(checked))
-            return null;
-        if (!(checked.left instanceof errors_ts_1.RecordMigrationRequired))
-            return yield* effect_1.Effect.fail(checked.left);
-        return yield* effect_1.Effect.scoped(effect_1.Effect.gen(function* () {
-            const session = yield* index_ts_2.recordHost.maintenance.open({ root: root.right });
-            const plan = yield* session.planMigrate();
-            if (plan.state !== "migration-required") {
-                return yield* effect_1.Effect.fail(checked.left);
-            }
-            if (plan.backup.state !== "git-restore-point") {
-                return yield* effect_1.Effect.fail(new errors_ts_1.RecordAutoMigrationGitSaveRequired({
-                    code: "record-auto-migration-git-save-required",
-                }));
-            }
-            const receipt = yield* session.applyMigrate(plan).pipe(effect_1.Effect.catchTag("RecordMigrationGitRestoreRequired", () => effect_1.Effect.fail(new errors_ts_1.RecordAutoMigrationGitSaveRequired({
-                code: "record-auto-migration-git-save-required",
-            }))));
-            return Object.freeze({
-                restoreCommit: plan.backup.commit,
-                attachments: receipt.state === "migrated" ? receipt.attachments : Object.freeze([]),
-            });
-        }));
-    });
-}
-function resolveRecordRoot(input) {
-    const root = (0, index_ts_1.makeRecordRoot)((0, node_path_1.resolve)(input.cwd, input.record ?? ".niceeval/record"));
-    return effect_1.Either.isLeft(root)
-        ? effect_1.Either.left(output({
-            exitCode: 1,
-            stderr: `${root.left.code}\n`,
-        }))
-        : effect_1.Either.right(root.right);
-}
-function recordErrorCode(error) {
-    if (typeof error !== "object" || error === null)
-        return "record-command-failed";
-    const candidate = Reflect.get(error, "code");
-    return typeof candidate === "string" ? candidate : "record-command-failed";
-}
-function recordErrorNextStep(code) {
-    switch (code) {
-        case "record-migration-required":
-            return "Run: niceeval migrate";
-        case "record-migration-interrupted":
-            return "Restore the complete Record from the recorded Git commit; do not rerun migrate on mixed bytes.";
-        case "record-migration-recovery-required":
-            return "Restore the complete Record from Git before retrying migration.";
-        case "record-migration-plan-stale":
-            return "Review the new migration plan and rerun migrate.";
-        case "record-migration-git-restore-required":
-            return "Commit, restore, or otherwise obtain a clean Git restore point for this Record before migrating.";
-        case "record-migration-invalid":
-            return "Restore the Record from Git before retrying migration.";
-        case "record-format-unsupported":
-            return "Install a NiceEval version that supports this Record format.";
-        case "record-maintenance-busy":
-        case "record-writer-busy":
-            return "Close the Record command holding the lock, then retry.";
-        default:
-            return undefined;
-    }
-}
-function shellQuote(value) {
-    return `'${value.replaceAll("'", `'"'"'`)}'`;
-}
-function recoveryCommands(restoreCommit, recordPath) {
-    const root = shellQuote(recordPath);
-    const commit = shellQuote(restoreCommit);
-    const sentinel = shellQuote((0, node_path_1.resolve)(recordPath, "migration.in-progress"));
-    return [
-        `Restore command: git -C ${root} restore --source=${commit} --staged --worktree -- .`,
-        `Verify command: git -C ${root} diff --quiet ${commit} -- . && git -C ${root} diff --cached --quiet ${commit} -- .`,
-        `Clear sentinel after verification: rm -f -- ${sentinel}`,
-    ].join("\n") + "\n";
-}
-function interruptedRecovery(error, recordPath) {
-    if (typeof error !== "object" || error === null || recordPath === undefined)
-        return "";
-    const restoreCommit = Reflect.get(error, "restoreCommit");
-    return Reflect.get(error, "restoreSafe") === true &&
-        typeof restoreCommit === "string" && /^[0-9a-f]{40,64}$/.test(restoreCommit)
-        ? recoveryCommands(restoreCommit, recordPath)
-        : "";
-}
-function recordErrorOutput(error, stdout = "", recordPath) {
-    const code = recordErrorCode(error);
-    const automaticRestoreUnsafe = (code === "record-migration-interrupted" || code === "record-migration-recovery-required") &&
-        (typeof error !== "object" || error === null || Reflect.get(error, "restoreSafe") !== true);
-    const next = automaticRestoreUnsafe
-        ? "Inspect and preserve concurrent Record edits before choosing a manual recovery; no automatic Git restore command is safe."
-        : recordErrorNextStep(code);
-    const causeCode = typeof error === "object" && error !== null &&
-        typeof Reflect.get(error, "causeCode") === "string"
-        ? String(Reflect.get(error, "causeCode"))
-        : undefined;
-    return output({
-        exitCode: 1,
-        stdout,
-        stderr: `${code}\n${next === undefined ? "" : `${next}\n`}${causeCode === undefined ? "" : `Cause: ${causeCode}\n`}${code === "record-migration-interrupted" || code === "record-migration-recovery-required"
-            ? interruptedRecovery(error, recordPath)
-            : ""}`,
-    });
-}
-function cleanCommand(input) {
-    return effect_1.Effect.gen(function* () {
-        const incomplete = yield* (0, index_ts_1.inspectIncompleteRuns)({ root: input.root });
-        if (incomplete.length === 0) {
-            return output({
-                exitCode: 0,
-                stdout: "No incomplete Runs found.\n",
-            });
-        }
-        const listed = incomplete.map((entry) => `  ${entry.runId}`).join("\n");
-        if (!input.yes) {
-            return output({
-                exitCode: 1,
-                stdout: `Incomplete Runs:\n${listed}\n`,
-                stderr: "record-clean-confirmation-required\nReview the listed Runs and rerun with --yes.\n",
-            });
-        }
-        const cleaned = yield* effect_1.Effect.either((0, index_ts_1.cleanIncompleteRuns)({
-            root: input.root,
-            runIds: incomplete.map((entry) => entry.runId),
-        }));
-        if (effect_1.Either.isLeft(cleaned)) {
-            return recordErrorOutput(cleaned.left, `Incomplete Runs:\n${listed}\n`);
-        }
-        const lines = ["Cleaned incomplete Runs:"];
-        if (cleaned.right.deleted.length === 0)
-            lines.push("  deleted: none");
-        else
-            lines.push(...cleaned.right.deleted.map((runId) => `  deleted: ${runId}`));
-        if (cleaned.right.skipped.length > 0) {
-            lines.push(...cleaned.right.skipped.map((runId) => `  skipped complete: ${runId}`));
-        }
-        return output({ exitCode: 0, stdout: `${lines.join("\n")}\n` });
-    });
-}
-function migrateCommand(input) {
-    return effect_1.Effect.scoped(effect_1.Effect.gen(function* () {
-        const session = yield* index_ts_2.recordHost.maintenance.open({ root: input.root });
-        const plan = yield* session.planMigrate();
-        const impactText = plan.state !== "migration-required"
-            ? ""
-            : [...new Map(plan.attachments.map((attachment) => {
-                    const key = `${attachment.family}@${attachment.fromSchemaVersion}->${attachment.toSchemaVersion}`;
-                    return [key, attachment];
-                })).values()].map((attachment) => {
-                const retention = attachment.retention;
-                const lines = [
-                    `impact ${attachment.family}@${attachment.fromSchemaVersion}->${attachment.toSchemaVersion}:`,
-                    `  retained facts: ${retention.retainedFacts.length === 0 ? "none" : retention.retainedFacts.join(", ")}`,
-                    `  dropped facts: ${retention.droppedFacts.length === 0 ? "none" : retention.droppedFacts.join(", ")}`,
-                ];
-                if (retention.rerunRecommendation !== null) {
-                    lines.push(`  rerun recommendation: ${retention.rerunRecommendation}`);
-                }
-                return lines.join("\n");
-            }).join("\n");
-        const planText = plan.state === "already-current"
-            ? `Record migration plan: already-current\nformat: ${plan.format}\n`
-            : plan.state === "unsupported-format"
-                ? `Record migration plan: unsupported-format\nformat: ${plan.format}\n`
-                : `Record migration plan: migration-required\nformat: ${plan.format}\nattachments: ${plan.attachments.length}\n${impactText === "" ? "" : `${impactText}\n`}backup: ${plan.backup.state}${plan.backup.state === "git-restore-point" ? `\nrestore commit: ${plan.backup.commit}` : ""}\n`;
-        if (plan.state === "unsupported-format") {
-            return output({
-                exitCode: 1,
-                stdout: planText,
-                stderr: "record-format-unsupported\nInstall a NiceEval version that supports this Record format.\n",
-            });
-        }
-        if (plan.state === "migration-required" && plan.backup.state !== "git-restore-point") {
-            return output({
-                exitCode: 1,
-                stdout: planText,
-                stderr: "record-migration-git-restore-required\nA clean Git restore point is required; --yes cannot bypass this preflight.\n",
-            });
-        }
-        if (plan.state === "migration-required" && !input.yes) {
-            return output({
-                exitCode: 1,
-                stdout: planText,
-                stderr: "record-migration-confirmation-required\nReview the migration plan and rerun with --yes.\n",
-            });
-        }
-        const migrated = yield* effect_1.Effect.either(session.applyMigrate(plan));
-        if (effect_1.Either.isLeft(migrated)) {
-            return recordErrorOutput(migrated.left, planText, input.recordPath);
-        }
-        const receipt = migrated.right;
-        return output({
-            exitCode: 0,
-            stdout: `${planText}Record migration ${receipt.state}.\n`,
-        });
-    }));
-}
-/**
- * Effect-native command handling for the Record maintenance surface. The
- * CLI owns the one Promise adaptation at its actual process boundary.
- */
-function runRecordCliCommand(input) {
-    const root = resolveRecordRoot(input);
-    if (effect_1.Either.isLeft(root))
-        return effect_1.Effect.succeed(root.left);
-    if (input.command === "clean") {
-        return cleanCommand({ root: root.right, yes: input.yes }).pipe(effect_1.Effect.provide(exports.NodeRecordCliLive), effect_1.Effect.catchAll((error) => effect_1.Effect.succeed(recordErrorOutput(error))));
-    }
-    const recordPath = (0, node_path_1.resolve)(input.cwd, input.record ?? ".niceeval/record");
-    return migrateCommand({ root: root.right, recordPath, yes: input.yes }).pipe(effect_1.Effect.provide(exports.NodeRecordCliLive), effect_1.Effect.catchAll((error) => effect_1.Effect.succeed(recordErrorOutput(error, "", recordPath))));
-}
-//# sourceMappingURL=record.cjs.map

package/dist/cli/record.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"record.js","sourceRoot":"","sources":["record.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolve } from \"node:path\";\nimport { Either, Effect, Layer } from \"effect\";\nimport { cleanIncompleteRuns, inspectIncompleteRuns, makeRecordRoot, NodeRecordLive, type RecordRoot, } from \"../record/index.ts\";\nimport { recordHost } from \"../record/host/index.ts\";\nimport type { RecordAttachmentMigrationTarget } from \"../record/host/types.ts\";\nimport { RecordAutoMigrationGitSaveRequired, RecordMigrationRequired, } from \"../record/reader/errors.ts\";\nimport { RecordFileSystem, recordPortablePath } from \"../record/platform/services.ts\";\nexport type RecordCliCommand = \"clean\" | \"migrate\";\nexport interface RunRecordCliCommandInput {\n    readonly command: RecordCliCommand;\n    readonly cwd: string;\n    /** An actual Record root, never a `.niceeval` parent directory. */\n    readonly record?: string;\n    readonly yes: boolean;\n}\n/** The outer CLI owns process streams and exit; this value is its pure receipt. */\nexport interface RecordCliCommandOutput {\n    readonly exitCode: 0 | 1;\n    readonly stdout: string;\n    readonly stderr: string;\n}\nfunction output(input: {\n    readonly exitCode: 0 | 1;\n    readonly stdout?: string;\n    readonly stderr?: string;\n}): RecordCliCommandOutput {\n    return Object.freeze({\n        exitCode: input.exitCode,\n        stdout: input.stdout ?? \"\",\n        stderr: input.stderr ?? \"\",\n    });\n}\nexport const NodeRecordCliLive = NodeRecordLive;\nexport interface AutomaticRecordMigrationReceipt {\n    readonly restoreCommit: string;\n    readonly attachments: readonly RecordAttachmentMigrationTarget[];\n}\n/**\n * Preflight for ordinary CLI entry points. Every Scope is closed before the\n * next lease kind is acquired: read check -> exclusive maintenance -> caller's\n * fresh ordinary open.\n */\nexport function ensureAutomaticRecordMigration(input: {\n    readonly cwd: string;\n    readonly record?: string;\n}) {\n    const root = makeRecordRoot(resolve(input.cwd, input.record ?? \".niceeval/record\"));\n    if (Either.isLeft(root))\n        return Effect.fail(root.left);\n    return Effect.gen(function* () {\n        const fileSystem = yield* RecordFileSystem;\n        if ((yield* fileSystem.pathKind(recordPortablePath(root.right, \"record.json\"))) === \"missing\") {\n            return null;\n        }\n        const checked = yield* Effect.either(Effect.scoped(recordHost.current.openRead({ root: root.right })));\n        if (Either.isRight(checked))\n            return null;\n        if (!(checked.left instanceof RecordMigrationRequired))\n            return yield* Effect.fail(checked.left);\n        return yield* Effect.scoped(Effect.gen(function* () {\n            const session = yield* recordHost.maintenance.open({ root: root.right });\n            const plan = yield* session.planMigrate();\n            if (plan.state !== \"migration-required\") {\n                return yield* Effect.fail(checked.left);\n            }\n            if (plan.backup.state !== \"git-restore-point\") {\n                return yield* Effect.fail(new RecordAutoMigrationGitSaveRequired({\n                    code: \"record-auto-migration-git-save-required\",\n                }));\n            }\n            const receipt = yield* session.applyMigrate(plan).pipe(Effect.catchTag(\"RecordMigrationGitRestoreRequired\", () => Effect.fail(new RecordAutoMigrationGitSaveRequired({\n                code: \"record-auto-migration-git-save-required\",\n            }))));\n            return Object.freeze({\n                restoreCommit: plan.backup.commit,\n                attachments: receipt.state === \"migrated\" ? receipt.attachments : Object.freeze([]),\n            });\n        }));\n    });\n}\nfunction resolveRecordRoot(input: RunRecordCliCommandInput): Either.Either<RecordRoot, RecordCliCommandOutput> {\n    const root = makeRecordRoot(resolve(input.cwd, input.record ?? \".niceeval/record\"));\n    return Either.isLeft(root)\n        ? Either.left(output({\n            exitCode: 1,\n            stderr: `${root.left.code}\\n`,\n        }))\n        : Either.right(root.right);\n}\nfunction recordErrorCode(error: unknown): string {\n    if (typeof error !== \"object\" || error === null)\n        return \"record-command-failed\";\n    const candidate = Reflect.get(error, \"code\");\n    return typeof candidate === \"string\" ? candidate : \"record-command-failed\";\n}\nfunction recordErrorNextStep(code: string): string | undefined {\n    switch (code) {\n        case \"record-migration-required\":\n            return \"Run: niceeval migrate\";\n        case \"record-migration-interrupted\":\n            return \"Restore the complete Record from the recorded Git commit; do not rerun migrate on mixed bytes.\";\n        case \"record-migration-recovery-required\":\n            return \"Restore the complete Record from Git before retrying migration.\";\n        case \"record-migration-plan-stale\":\n            return \"Review the new migration plan and rerun migrate.\";\n        case \"record-migration-git-restore-required\":\n            return \"Commit, restore, or otherwise obtain a clean Git restore point for this Record before migrating.\";\n        case \"record-migration-invalid\":\n            return \"Restore the Record from Git before retrying migration.\";\n        case \"record-format-unsupported\":\n            return \"Install a NiceEval version that supports this Record format.\";\n        case \"record-maintenance-busy\":\n        case \"record-writer-busy\":\n            return \"Close the Record command holding the lock, then retry.\";\n        default:\n            return undefined;\n    }\n}\nfunction shellQuote(value: string): string {\n    return `'${value.replaceAll(\"'\", `'\"'\"'`)}'`;\n}\nfunction recoveryCommands(restoreCommit: string, recordPath: string): string {\n    const root = shellQuote(recordPath);\n    const commit = shellQuote(restoreCommit);\n    const sentinel = shellQuote(resolve(recordPath, \"migration.in-progress\"));\n    return [\n        `Restore command: git -C ${root} restore --source=${commit} --staged --worktree -- .`,\n        `Verify command: git -C ${root} diff --quiet ${commit} -- . && git -C ${root} diff --cached --quiet ${commit} -- .`,\n        `Clear sentinel after verification: rm -f -- ${sentinel}`,\n    ].join(\"\\n\") + \"\\n\";\n}\nfunction interruptedRecovery(error: unknown, recordPath: string | undefined): string {\n    if (typeof error !== \"object\" || error === null || recordPath === undefined)\n        return \"\";\n    const restoreCommit = Reflect.get(error, \"restoreCommit\");\n    return Reflect.get(error, \"restoreSafe\") === true &&\n        typeof restoreCommit === \"string\" && /^[0-9a-f]{40,64}$/.test(restoreCommit)\n        ? recoveryCommands(restoreCommit, recordPath)\n        : \"\";\n}\nfunction recordErrorOutput(error: unknown, stdout = \"\", recordPath?: string): RecordCliCommandOutput {\n    const code = recordErrorCode(error);\n    const automaticRestoreUnsafe = (code === \"record-migration-interrupted\" || code === \"record-migration-recovery-required\") &&\n        (typeof error !== \"object\" || error === null || Reflect.get(error, \"restoreSafe\") !== true);\n    const next = automaticRestoreUnsafe\n        ? \"Inspect and preserve concurrent Record edits before choosing a manual recovery; no automatic Git restore command is safe.\"\n        : recordErrorNextStep(code);\n    const causeCode = typeof error === \"object\" && error !== null &&\n        typeof Reflect.get(error, \"causeCode\") === \"string\"\n        ? String(Reflect.get(error, \"causeCode\"))\n        : undefined;\n    return output({\n        exitCode: 1,\n        stdout,\n        stderr: `${code}\\n${next === undefined ? \"\" : `${next}\\n`}${causeCode === undefined ? \"\" : `Cause: ${causeCode}\\n`}${code === \"record-migration-interrupted\" || code === \"record-migration-recovery-required\"\n            ? interruptedRecovery(error, recordPath)\n            : \"\"}`,\n    });\n}\nfunction cleanCommand(input: {\n    readonly root: RecordRoot;\n    readonly yes: boolean;\n}) {\n    return Effect.gen(function* () {\n        const incomplete = yield* inspectIncompleteRuns({ root: input.root });\n        if (incomplete.length === 0) {\n            return output({\n                exitCode: 0,\n                stdout: \"No incomplete Runs found.\\n\",\n            });\n        }\n        const listed = incomplete.map((entry) => `  ${entry.runId}`).join(\"\\n\");\n        if (!input.yes) {\n            return output({\n                exitCode: 1,\n                stdout: `Incomplete Runs:\\n${listed}\\n`,\n                stderr: \"record-clean-confirmation-required\\nReview the listed Runs and rerun with --yes.\\n\",\n            });\n        }\n        const cleaned = yield* Effect.either(cleanIncompleteRuns({\n            root: input.root,\n            runIds: incomplete.map((entry) => entry.runId),\n        }));\n        if (Either.isLeft(cleaned)) {\n            return recordErrorOutput(cleaned.left, `Incomplete Runs:\\n${listed}\\n`);\n        }\n        const lines = [\"Cleaned incomplete Runs:\"];\n        if (cleaned.right.deleted.length === 0)\n            lines.push(\"  deleted: none\");\n        else\n            lines.push(...cleaned.right.deleted.map((runId) => `  deleted: ${runId}`));\n        if (cleaned.right.skipped.length > 0) {\n            lines.push(...cleaned.right.skipped.map((runId) => `  skipped complete: ${runId}`));\n        }\n        return output({ exitCode: 0, stdout: `${lines.join(\"\\n\")}\\n` });\n    });\n}\nfunction migrateCommand(input: {\n    readonly root: RecordRoot;\n    readonly recordPath: string;\n    readonly yes: boolean;\n}) {\n    return Effect.scoped(Effect.gen(function* () {\n        const session = yield* recordHost.maintenance.open({ root: input.root });\n        const plan = yield* session.planMigrate();\n        const impactText = plan.state !== \"migration-required\"\n            ? \"\"\n            : [...new Map(plan.attachments.map((attachment) => {\n                    const key = `${attachment.family}@${attachment.fromSchemaVersion}->${attachment.toSchemaVersion}`;\n                    return [key, attachment] as const;\n                })).values()].map((attachment) => {\n                const retention = attachment.retention;\n                const lines = [\n                    `impact ${attachment.family}@${attachment.fromSchemaVersion}->${attachment.toSchemaVersion}:`,\n                    `  retained facts: ${retention.retainedFacts.length === 0 ? \"none\" : retention.retainedFacts.join(\", \")}`,\n                    `  dropped facts: ${retention.droppedFacts.length === 0 ? \"none\" : retention.droppedFacts.join(\", \")}`,\n                ];\n                if (retention.rerunRecommendation !== null) {\n                    lines.push(`  rerun recommendation: ${retention.rerunRecommendation}`);\n                }\n                return lines.join(\"\\n\");\n            }).join(\"\\n\");\n        const planText = plan.state === \"already-current\"\n            ? `Record migration plan: already-current\\nformat: ${plan.format}\\n`\n            : plan.state === \"unsupported-format\"\n                ? `Record migration plan: unsupported-format\\nformat: ${plan.format}\\n`\n                : `Record migration plan: migration-required\\nformat: ${plan.format}\\nattachments: ${plan.attachments.length}\\n${impactText === \"\" ? \"\" : `${impactText}\\n`}backup: ${plan.backup.state}${plan.backup.state === \"git-restore-point\" ? `\\nrestore commit: ${plan.backup.commit}` : \"\"}\\n`;\n        if (plan.state === \"unsupported-format\") {\n            return output({\n                exitCode: 1,\n                stdout: planText,\n                stderr: \"record-format-unsupported\\nInstall a NiceEval version that supports this Record format.\\n\",\n            });\n        }\n        if (plan.state === \"migration-required\" && plan.backup.state !== \"git-restore-point\") {\n            return output({\n                exitCode: 1,\n                stdout: planText,\n                stderr: \"record-migration-git-restore-required\\nA clean Git restore point is required; --yes cannot bypass this preflight.\\n\",\n            });\n        }\n        if (plan.state === \"migration-required\" && !input.yes) {\n            return output({\n                exitCode: 1,\n                stdout: planText,\n                stderr: \"record-migration-confirmation-required\\nReview the migration plan and rerun with --yes.\\n\",\n            });\n        }\n        const migrated = yield* Effect.either(session.applyMigrate(plan));\n        if (Either.isLeft(migrated)) {\n            return recordErrorOutput(migrated.left, planText, input.recordPath);\n        }\n        const receipt = migrated.right;\n        return output({\n            exitCode: 0,\n            stdout: `${planText}Record migration ${receipt.state}.\\n`,\n        });\n    }));\n}\n/**\n * Effect-native command handling for the Record maintenance surface. The\n * CLI owns the one Promise adaptation at its actual process boundary.\n */\nexport function runRecordCliCommand(input: RunRecordCliCommandInput): Effect.Effect<RecordCliCommandOutput> {\n    const root = resolveRecordRoot(input);\n    if (Either.isLeft(root))\n        return Effect.succeed(root.left);\n    if (input.command === \"clean\") {\n        return cleanCommand({ root: root.right, yes: input.yes }).pipe(Effect.provide(NodeRecordCliLive), Effect.catchAll((error) => Effect.succeed(recordErrorOutput(error))));\n    }\n    const recordPath = resolve(input.cwd, input.record ?? \".niceeval/record\");\n    return migrateCommand({ root: root.right, recordPath, yes: input.yes }).pipe(Effect.provide(NodeRecordCliLive), Effect.catchAll((error) => Effect.succeed(recordErrorOutput(error, \"\", recordPath))));\n}\n"]}