niceeval 0.13.3 → 0.13.4-canary.39

package/dist/record/host/cli/presentation.d.cts

@@ -0,0 +1,7 @@
+import type { RecordAutomaticMigrationResult, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan } from "../types.cjs";
+export declare function renderRecordMaintenanceFailure(failure: RecordMaintenanceOperationFailure, recordPath: string): string;
+/** Shared CLI wording for ordinary-entry automatic migration failures. */
+export declare function renderAutomaticMigrationFailure(error: unknown): string | undefined;
+/** Shared CLI notice emitted exactly once after an automatic migration. */
+export declare function renderAutomaticMigrationResult(result: RecordAutomaticMigrationResult): string | undefined;
+export declare function renderMigrationPlan(plan: RecordMigrateOperationPlan): string;

package/dist/record/host/cli/presentation.d.mts

@@ -0,0 +1,7 @@
+import type { RecordAutomaticMigrationResult, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan } from "../types.mjs";
+export declare function renderRecordMaintenanceFailure(failure: RecordMaintenanceOperationFailure, recordPath: string): string;
+/** Shared CLI wording for ordinary-entry automatic migration failures. */
+export declare function renderAutomaticMigrationFailure(error: unknown): string | undefined;
+/** Shared CLI notice emitted exactly once after an automatic migration. */
+export declare function renderAutomaticMigrationResult(result: RecordAutomaticMigrationResult): string | undefined;
+export declare function renderMigrationPlan(plan: RecordMigrateOperationPlan): string;

package/dist/record/host/cli/presentation.d.ts

@@ -0,0 +1,7 @@
+import type { RecordAutomaticMigrationResult, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan } from "../types.js";
+export declare function renderRecordMaintenanceFailure(failure: RecordMaintenanceOperationFailure, recordPath: string): string;
+/** Shared CLI wording for ordinary-entry automatic migration failures. */
+export declare function renderAutomaticMigrationFailure(error: unknown): string | undefined;
+/** Shared CLI notice emitted exactly once after an automatic migration. */
+export declare function renderAutomaticMigrationResult(result: RecordAutomaticMigrationResult): string | undefined;
+export declare function renderMigrationPlan(plan: RecordMigrateOperationPlan): string;

package/dist/record/host/cli/presentation.js

@@ -0,0 +1,12 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./presentation.cjs");
+const __niceevalExport0 = __niceevalCanonical["renderAutomaticMigrationFailure"];
+export { __niceevalExport0 as renderAutomaticMigrationFailure };
+const __niceevalExport1 = __niceevalCanonical["renderAutomaticMigrationResult"];
+export { __niceevalExport1 as renderAutomaticMigrationResult };
+const __niceevalExport2 = __niceevalCanonical["renderMigrationPlan"];
+export { __niceevalExport2 as renderMigrationPlan };
+const __niceevalExport3 = __niceevalCanonical["renderRecordMaintenanceFailure"];
+export { __niceevalExport3 as renderRecordMaintenanceFailure };
+//# sourceMappingURL=presentation.js.map

package/dist/record/host/cli/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sources":[],"names":[],"mappings":""}

package/dist/record/host/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,2CAA0C;AAAjC,wGAAA,UAAU,OAAA","sourcesContent":["/**\n * Public, supported high-level Host composition boundary for scoped Record\n * I/O. `niceeval/record` re-exports this same Host; durable definitions,\n * fixed-family registration, and migration factories remain package-private.\n */\nexport { recordHost } from \"./runtime.ts\";\nexport type { RecordHostSDK } from \"./types.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,2CAA0C;AAAjC,wGAAA,UAAU,OAAA","sourcesContent":["/**\n * Public, supported high-level Host composition boundary for scoped Record\n * I/O. `niceeval/record` re-exports this same Host; durable definitions,\n * fixed-family registration, and migration factories remain package-private.\n */\nexport { recordHost } from \"./runtime.ts\";\nexport type { RecordAutomaticMigrationError, RecordAutomaticMigrationResult, RecordCleanOperationPlan, RecordCleanOperationReceipt, RecordHostSDK, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan, RecordMigrateOperationReceipt, RecordMigrateReadyPlan, } from \"./types.ts\";\n"]}

package/dist/record/host/index.d.cts

@@ -4,4 +4,4 @@
  * fixed-family registration, and migration factories remain package-private.
  */
 export { recordHost } from "./runtime.cjs";
-export type { RecordHostSDK } from "./types.cjs";
+export type { RecordAutomaticMigrationError, RecordAutomaticMigrationResult, RecordCleanOperationPlan, RecordCleanOperationReceipt, RecordHostSDK, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan, RecordMigrateOperationReceipt, RecordMigrateReadyPlan, } from "./types.cjs";

package/dist/record/host/index.d.mts

@@ -4,4 +4,4 @@
  * fixed-family registration, and migration factories remain package-private.
  */
 export { recordHost } from "./runtime.mjs";
-export type { RecordHostSDK } from "./types.mjs";
+export type { RecordAutomaticMigrationError, RecordAutomaticMigrationResult, RecordCleanOperationPlan, RecordCleanOperationReceipt, RecordHostSDK, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan, RecordMigrateOperationReceipt, RecordMigrateReadyPlan, } from "./types.mjs";

package/dist/record/host/index.d.ts

@@ -4,4 +4,4 @@
  * fixed-family registration, and migration factories remain package-private.
  */
 export { recordHost } from "./runtime.js";
-export type { RecordHostSDK } from "./types.js";
+export type { RecordAutomaticMigrationError, RecordAutomaticMigrationResult, RecordCleanOperationPlan, RecordCleanOperationReceipt, RecordHostSDK, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan, RecordMigrateOperationReceipt, RecordMigrateReadyPlan, } from "./types.js";

package/dist/record/host/runtime.cjs

@@ -24,6 +24,7 @@ const runtime_ts_1 = require("../reader/runtime.cjs");
 const errors_ts_4 = require("../writer/errors.cjs");
 const attachment_payload_ts_1 = require("../writer/attachment-payload.cjs");
 const limits_ts_1 = require("../writer/limits.cjs");
+const runtime_ts_2 = require("../maintenance/runtime.cjs");
 const types_ts_1 = require("./types.cjs");
 const MAXIMUM_RUN_ENTRIES = 100000;
 const MAXIMUM_ATTEMPT_ENTRIES = 100000;
@@ -2404,12 +2405,194 @@ function openMaintenance(input) {
         });
     });
 }
+/**
+ * The ordinary-entry migration transaction deliberately closes the read
+ * Scope before asking Coordination for maintenance. Returning from here also
+ * closes maintenance, so the caller's next open is necessarily fresh.
+ */
+function ensureAutomaticMigration(input) {
+    return effect_1.Effect.gen(function* () {
+        const fileSystem = yield* services_ts_1.RecordFileSystem;
+        if ((yield* fileSystem.pathKind((0, services_ts_1.recordPortablePath)(input.root, "record.json"))) === "missing") {
+            return Object.freeze({ state: "record-missing" });
+        }
+        const checked = yield* effect_1.Effect.either(effect_1.Effect.scoped(openCurrentRead(input)));
+        if (effect_1.Either.isRight(checked)) {
+            return Object.freeze({ state: "already-current" });
+        }
+        if (!(checked.left instanceof errors_ts_3.RecordMigrationRequired)) {
+            return yield* effect_1.Effect.fail(checked.left);
+        }
+        return yield* effect_1.Effect.scoped(effect_1.Effect.gen(function* () {
+            const session = yield* openMaintenance(input);
+            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_3.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_3.RecordAutoMigrationGitSaveRequired({
+                code: "record-auto-migration-git-save-required",
+            }))));
+            return Object.freeze({
+                state: "migrated",
+                restoreCommit: plan.backup.commit,
+                attachments: Object.freeze(receipt.state === "migrated" ? [...receipt.attachments] : []),
+            });
+        }));
+    });
+}
+function closeMaintenanceFailure(error) {
+    if (error instanceof errors_ts_2.RecordMaintenanceBusy) {
+        return Object.freeze({
+            _tag: "RecordMaintenanceBusy",
+            code: "record-maintenance-busy",
+        });
+    }
+    if (error instanceof errors_ts_3.RecordMigrationInterruptedState) {
+        return Object.freeze({
+            _tag: "RecordMigrationInterrupted",
+            code: "record-migration-interrupted",
+            ...(error.restoreCommit === undefined ? {} : { restoreCommit: error.restoreCommit }),
+            ...(error.restoreSafe === undefined ? {} : { restoreSafe: error.restoreSafe }),
+        });
+    }
+    if (error instanceof errors_ts_3.RecordMigrationPlanStale) {
+        return Object.freeze({
+            _tag: "RecordMigrationPlanStale",
+            code: "record-migration-plan-stale",
+        });
+    }
+    if (error instanceof errors_ts_3.RecordMigrationGitRestoreRequired) {
+        return Object.freeze({
+            _tag: "RecordMigrationGitRestoreRequired",
+            code: "record-migration-git-restore-required",
+        });
+    }
+    if (error instanceof errors_ts_3.RecordMigrationInvalid) {
+        return Object.freeze({
+            _tag: "RecordMigrationInvalid",
+            code: "record-migration-invalid",
+        });
+    }
+    if (error instanceof errors_ts_3.RecordMigrationRecoveryRequired) {
+        return Object.freeze({
+            _tag: "RecordMigrationRecoveryRequired",
+            code: "record-migration-recovery-required",
+            causeCode: error.causeCode,
+            restoreCommit: error.restoreCommit,
+            restoreSafe: error.restoreSafe,
+        });
+    }
+    if (error instanceof errors_ts_3.RecordFormatUnsupported) {
+        return Object.freeze({
+            _tag: "RecordFormatUnsupported",
+            code: "record-format-unsupported",
+        });
+    }
+    if (error instanceof errors_ts_3.RecordMigrationRequired) {
+        return Object.freeze({
+            _tag: "RecordMigrationRequired",
+            code: "record-migration-required",
+        });
+    }
+    return Object.freeze({
+        _tag: "RecordMaintenanceOperationFailed",
+        code: error.code,
+    });
+}
+const migrateOperationPlans = new WeakMap();
+function planCleanOperation(input) {
+    return (0, runtime_ts_2.inspectIncompleteRuns)(input).pipe(effect_1.Effect.map((incomplete) => incomplete.length === 0
+        ? Object.freeze({ _tag: "RecordCleanAlreadyClean" })
+        : Object.freeze({
+            _tag: "RecordCleanConfirmationRequired",
+            runIds: Object.freeze(incomplete.map(({ runId }) => runId)),
+        })), effect_1.Effect.mapError(closeMaintenanceFailure));
+}
+function applyCleanOperation(input) {
+    return (0, runtime_ts_2.cleanIncompleteRuns)({ root: input.root, runIds: input.plan.runIds }).pipe(effect_1.Effect.map((receipt) => Object.freeze({
+        _tag: "RecordCleanApplied",
+        deleted: Object.freeze([...receipt.deleted]),
+        skipped: Object.freeze([...receipt.skipped]),
+    })), effect_1.Effect.mapError(closeMaintenanceFailure));
+}
+function planMigrateOperation(input) {
+    return effect_1.Effect.scoped(effect_1.Effect.gen(function* () {
+        const session = yield* openMaintenance(input);
+        const plan = yield* session.planMigrate();
+        if (plan.state === "already-current") {
+            return Object.freeze({
+                _tag: "RecordMigrationAlreadyCurrent",
+                format: plan.format,
+            });
+        }
+        if (plan.state === "unsupported-format") {
+            return Object.freeze({
+                _tag: "RecordMigrationUnsupported",
+                format: plan.format,
+            });
+        }
+        if (plan.backup.state !== "git-restore-point") {
+            return Object.freeze({
+                _tag: "RecordMigrationRestoreRequired",
+                format: plan.format,
+                backup: plan.backup,
+                attachments: plan.attachments,
+            });
+        }
+        const closed = Object.freeze({
+            _tag: "RecordMigrationReady",
+            format: plan.format,
+            restoreCommit: plan.backup.commit,
+            attachments: plan.attachments,
+        });
+        migrateOperationPlans.set(closed, plan);
+        return closed;
+    })).pipe(effect_1.Effect.catchTag("RecordFormatUnsupported", (error) => effect_1.Effect.succeed(Object.freeze({
+        _tag: "RecordMigrationUnsupported",
+        format: error.format,
+    }))), effect_1.Effect.mapError(closeMaintenanceFailure));
+}
+function applyMigrateOperation(input) {
+    const sourcePlan = migrateOperationPlans.get(input.plan);
+    if (sourcePlan === undefined) {
+        return effect_1.Effect.fail(Object.freeze({
+            _tag: "RecordMigrationPlanStale",
+            code: "record-migration-plan-stale",
+        }));
+    }
+    return effect_1.Effect.scoped(effect_1.Effect.gen(function* () {
+        const session = yield* openMaintenance({ root: input.root });
+        const receipt = yield* session.applyMigrate(sourcePlan);
+        return receipt.state === "already-current"
+            ? Object.freeze({
+                _tag: "RecordMigrationAlreadyCurrent",
+                format: receipt.format,
+            })
+            : Object.freeze({
+                _tag: "RecordMigrationApplied",
+                format: receipt.format,
+                attachments: receipt.attachments,
+            });
+    })).pipe(effect_1.Effect.mapError(closeMaintenanceFailure));
+}
 exports.recordHost = Object.freeze({
+    ensureAutomaticMigration,
     current: Object.freeze({
         openRead: openCurrentRead,
         createRun: openNewRun,
         createReferenceRun: openNewReferenceRun,
     }),
-    maintenance: Object.freeze({ open: openMaintenance }),
+    maintenance: Object.freeze({
+        planClean: planCleanOperation,
+        applyClean: applyCleanOperation,
+        planMigrate: planMigrateOperation,
+        applyMigrate: applyMigrateOperation,
+        open: openMaintenance,
+    }),
 });
 //# sourceMappingURL=runtime.cjs.map