niceeval 0.13.1 → 0.13.2

package/dist/cli/record.cjs

@@ -1,11 +1,15 @@
 "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 identifiers_ts_1 = require("../record/model/identifiers.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,
@@ -14,6 +18,46 @@ function output(input) {
     });
 }
 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",
+                }));
+            }
+            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,
+                targetSchemaVersion: identifiers_ts_1.RECORD_SCHEMA_VERSION,
+            });
+        }));
+    });
+}
 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)
@@ -34,7 +78,15 @@ function recordErrorNextStep(code) {
         case "record-migration-required":
             return "Run: niceeval migrate";
         case "record-migration-interrupted":
-            return "Restore the Record from Git; do not rerun migrate on mixed bytes.";
+            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":
@@ -44,13 +96,45 @@ function recordErrorNextStep(code) {
             return undefined;
     }
 }
-function recordErrorOutput(error, stdout = "") {
+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 next = recordErrorNextStep(code);
+    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`}`,
+        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) {
@@ -94,15 +178,35 @@ function migrateCommand(input) {
         const plan = yield* session.planMigrate();
         const planText = plan.state === "already-current"
             ? `Record migration plan: already-current\nformat: ${plan.format}\n`
-            : `Record migration plan: unsupported-format\nformat: ${plan.format}\n`;
-        if (plan.state !== "already-current") {
+            : plan.state === "unsupported-format"
+                ? `Record migration plan: unsupported-format\nformat: ${plan.format}\n`
+                : `Record migration plan: migration-required\nformat: ${plan.format}\nroot: ${plan.root === null ? "current" : `${plan.root.fromSchemaVersion} -> ${plan.root.toSchemaVersion}`}\nattachments: ${plan.attachments.length}\nbackup: ${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",
             });
         }
-        const receipt = yield* session.applyMigrate(plan);
+        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`,
@@ -120,6 +224,7 @@ function runRecordCliCommand(input) {
     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))));
     }
-    return migrateCommand({ 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 +1 @@
-{"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\";\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;\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 Record from Git; do not rerun migrate on mixed bytes.\";\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 recordErrorOutput(error: unknown, stdout = \"\"): RecordCliCommandOutput {\n    const code = recordErrorCode(error);\n    const next = recordErrorNextStep(code);\n    return output({\n        exitCode: 1,\n        stdout,\n        stderr: `${code}\\n${next === undefined ? \"\" : `${next}\\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 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 planText = plan.state === \"already-current\"\n            ? `Record migration plan: already-current\\nformat: ${plan.format}\\n`\n            : `Record migration plan: unsupported-format\\nformat: ${plan.format}\\n`;\n        if (plan.state !== \"already-current\") {\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        const receipt = yield* session.applyMigrate(plan);\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    return migrateCommand({ root: root.right, yes: input.yes }).pipe(Effect.provide(NodeRecordCliLive), Effect.catchAll((error) => Effect.succeed(recordErrorOutput(error))));\n}\n"]}
+{"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 { RECORD_SCHEMA_VERSION } from \"../record/model/identifiers.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 targetSchemaVersion: typeof RECORD_SCHEMA_VERSION;\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            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                targetSchemaVersion: RECORD_SCHEMA_VERSION,\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 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}\\nroot: ${plan.root === null ? \"current\" : `${plan.root.fromSchemaVersion} -> ${plan.root.toSchemaVersion}`}\\nattachments: ${plan.attachments.length}\\nbackup: ${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"]}

package/dist/cli/record.d.cts

@@ -1,4 +1,7 @@
 import { Effect, Layer } from "effect";
+import { RECORD_SCHEMA_VERSION } from "../record/model/identifiers.cjs";
+import { RecordAutoMigrationGitSaveRequired, RecordMigrationRequired } from "../record/reader/errors.cjs";
+import { RecordFileSystem } from "../record/platform/services.cjs";
 export type RecordCliCommand = "clean" | "migrate";
 export interface RunRecordCliCommandInput {
     readonly command: RecordCliCommand;
@@ -13,7 +16,23 @@ export interface RecordCliCommandOutput {
     readonly stdout: string;
     readonly stderr: string;
 }
-export declare const NodeRecordCliLive: Layer.Layer<import("../coordination/record-leases.cjs").RecordCoordination | import("../record/platform/services.cjs").RecordFileSystem | import("../record/platform/services.cjs").RecordEntropy | import("../record/platform/services.cjs").RecordGit, never, never>;
+export declare const NodeRecordCliLive: Layer.Layer<import("../coordination/record-leases.cjs").RecordCoordination | RecordFileSystem | import("../record/platform/services.cjs").RecordEntropy | import("../record/platform/services.cjs").RecordGit, never, never>;
+export interface AutomaticRecordMigrationReceipt {
+    readonly restoreCommit: string;
+    readonly targetSchemaVersion: typeof RECORD_SCHEMA_VERSION;
+}
+/**
+ * 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.
+ */
+export declare function ensureAutomaticRecordMigration(input: {
+    readonly cwd: string;
+    readonly record?: string;
+}): Effect.Effect<never, import("../record/index.cjs").RecordRootConstructionError, never> | Effect.Effect<Readonly<{
+    restoreCommit: string;
+    targetSchemaVersion: 2;
+}> | null, import("../record/platform/errors.cjs").RecordMaintenanceBusy | import("../record/platform/errors.cjs").RecordGitCommandError | import("../record/platform/errors.cjs").RecordFileSystemError | import("../coordination/record-leases.cjs").RecordCoordinationIdentityMismatch | import("../record/reader/errors.cjs").RecordBootstrapInvalid | RecordMigrationRequired | import("../record/reader/errors.cjs").RecordFormatUnsupported | import("../record/reader/errors.cjs").RecordMigrationInterruptedState | import("../record/reader/errors.cjs").RecordMigrationPlanStale | import("../record/reader/errors.cjs").RecordMigrationGitRestoreRequired | RecordAutoMigrationGitSaveRequired | import("../record/reader/errors.cjs").RecordMigrationInvalid | import("../record/reader/errors.cjs").RecordMigrationRecoveryRequired, import("../coordination/record-leases.cjs").RecordCoordination | RecordFileSystem | import("../record/platform/services.cjs").RecordGit>;
 /**
  * Effect-native command handling for the Record maintenance surface. The
  * CLI owns the one Promise adaptation at its actual process boundary.

package/dist/cli/record.d.mts

@@ -1,4 +1,7 @@
 import { Effect, Layer } from "effect";
+import { RECORD_SCHEMA_VERSION } from "../record/model/identifiers.mjs";
+import { RecordAutoMigrationGitSaveRequired, RecordMigrationRequired } from "../record/reader/errors.mjs";
+import { RecordFileSystem } from "../record/platform/services.mjs";
 export type RecordCliCommand = "clean" | "migrate";
 export interface RunRecordCliCommandInput {
     readonly command: RecordCliCommand;
@@ -13,7 +16,23 @@ export interface RecordCliCommandOutput {
     readonly stdout: string;
     readonly stderr: string;
 }
-export declare const NodeRecordCliLive: Layer.Layer<import("../coordination/record-leases.mjs").RecordCoordination | import("../record/platform/services.mjs").RecordFileSystem | import("../record/platform/services.mjs").RecordEntropy | import("../record/platform/services.mjs").RecordGit, never, never>;
+export declare const NodeRecordCliLive: Layer.Layer<import("../coordination/record-leases.mjs").RecordCoordination | RecordFileSystem | import("../record/platform/services.mjs").RecordEntropy | import("../record/platform/services.mjs").RecordGit, never, never>;
+export interface AutomaticRecordMigrationReceipt {
+    readonly restoreCommit: string;
+    readonly targetSchemaVersion: typeof RECORD_SCHEMA_VERSION;
+}
+/**
+ * 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.
+ */
+export declare function ensureAutomaticRecordMigration(input: {
+    readonly cwd: string;
+    readonly record?: string;
+}): Effect.Effect<never, import("../record/index.mjs").RecordRootConstructionError, never> | Effect.Effect<Readonly<{
+    restoreCommit: string;
+    targetSchemaVersion: 2;
+}> | null, import("../record/platform/errors.mjs").RecordMaintenanceBusy | import("../record/platform/errors.mjs").RecordGitCommandError | import("../record/platform/errors.mjs").RecordFileSystemError | import("../coordination/record-leases.mjs").RecordCoordinationIdentityMismatch | import("../record/reader/errors.mjs").RecordBootstrapInvalid | RecordMigrationRequired | import("../record/reader/errors.mjs").RecordFormatUnsupported | import("../record/reader/errors.mjs").RecordMigrationInterruptedState | import("../record/reader/errors.mjs").RecordMigrationPlanStale | import("../record/reader/errors.mjs").RecordMigrationGitRestoreRequired | RecordAutoMigrationGitSaveRequired | import("../record/reader/errors.mjs").RecordMigrationInvalid | import("../record/reader/errors.mjs").RecordMigrationRecoveryRequired, import("../coordination/record-leases.mjs").RecordCoordination | RecordFileSystem | import("../record/platform/services.mjs").RecordGit>;
 /**
  * Effect-native command handling for the Record maintenance surface. The
  * CLI owns the one Promise adaptation at its actual process boundary.

package/dist/cli/record.d.ts

@@ -1,4 +1,7 @@
 import { Effect, Layer } from "effect";
+import { RECORD_SCHEMA_VERSION } from "../record/model/identifiers.js";
+import { RecordAutoMigrationGitSaveRequired, RecordMigrationRequired } from "../record/reader/errors.js";
+import { RecordFileSystem } from "../record/platform/services.js";
 export type RecordCliCommand = "clean" | "migrate";
 export interface RunRecordCliCommandInput {
     readonly command: RecordCliCommand;
@@ -13,7 +16,23 @@ export interface RecordCliCommandOutput {
     readonly stdout: string;
     readonly stderr: string;
 }
-export declare const NodeRecordCliLive: Layer.Layer<import("../coordination/record-leases.js").RecordCoordination | import("../record/platform/services.js").RecordFileSystem | import("../record/platform/services.js").RecordEntropy | import("../record/platform/services.js").RecordGit, never, never>;
+export declare const NodeRecordCliLive: Layer.Layer<import("../coordination/record-leases.js").RecordCoordination | RecordFileSystem | import("../record/platform/services.js").RecordEntropy | import("../record/platform/services.js").RecordGit, never, never>;
+export interface AutomaticRecordMigrationReceipt {
+    readonly restoreCommit: string;
+    readonly targetSchemaVersion: typeof RECORD_SCHEMA_VERSION;
+}
+/**
+ * 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.
+ */
+export declare function ensureAutomaticRecordMigration(input: {
+    readonly cwd: string;
+    readonly record?: string;
+}): Effect.Effect<never, import("../record/index.js").RecordRootConstructionError, never> | Effect.Effect<Readonly<{
+    restoreCommit: string;
+    targetSchemaVersion: 2;
+}> | null, import("../record/platform/errors.js").RecordMaintenanceBusy | import("../record/platform/errors.js").RecordGitCommandError | import("../record/platform/errors.js").RecordFileSystemError | import("../coordination/record-leases.js").RecordCoordinationIdentityMismatch | import("../record/reader/errors.js").RecordBootstrapInvalid | RecordMigrationRequired | import("../record/reader/errors.js").RecordFormatUnsupported | import("../record/reader/errors.js").RecordMigrationInterruptedState | import("../record/reader/errors.js").RecordMigrationPlanStale | import("../record/reader/errors.js").RecordMigrationGitRestoreRequired | RecordAutoMigrationGitSaveRequired | import("../record/reader/errors.js").RecordMigrationInvalid | import("../record/reader/errors.js").RecordMigrationRecoveryRequired, import("../coordination/record-leases.js").RecordCoordination | RecordFileSystem | import("../record/platform/services.js").RecordGit>;
 /**
  * Effect-native command handling for the Record maintenance surface. The
  * CLI owns the one Promise adaptation at its actual process boundary.

package/dist/cli/record.js

@@ -3,6 +3,8 @@ const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
 const __niceevalCanonical = __niceevalRequire("./record.cjs");
 const __niceevalExport0 = __niceevalCanonical["NodeRecordCliLive"];
 export { __niceevalExport0 as NodeRecordCliLive };
-const __niceevalExport1 = __niceevalCanonical["runRecordCliCommand"];
-export { __niceevalExport1 as runRecordCliCommand };
+const __niceevalExport1 = __niceevalCanonical["ensureAutomaticRecordMigration"];
+export { __niceevalExport1 as ensureAutomaticRecordMigration };
+const __niceevalExport2 = __niceevalCanonical["runRecordCliCommand"];
+export { __niceevalExport2 as runRecordCliCommand };
 //# sourceMappingURL=record.js.map