niceeval 0.13.3 → 0.13.4-canary.39

package/dist/record/family/file-changes.d.ts

@@ -244,7 +244,7 @@ export declare const FileChangesAttachmentSchema: Schema.filter<Schema.Struct<{
         readonly state: "partial";
         readonly limitations: readonly [{
             readonly code: "capture-failed" | "capture-interrupted";
-            readonly stage: "normalize" | "export" | "checkpoint" | "finalizer-export";
+            readonly stage: "normalize" | "checkpoint" | "export" | "finalizer-export";
             readonly atWindowId: string | null;
         } | {
             readonly code: "collection-cap-reached";
@@ -257,7 +257,7 @@ export declare const FileChangesAttachmentSchema: Schema.filter<Schema.Struct<{
             readonly omittedAtLeast: number;
         }, ...({
             readonly code: "capture-failed" | "capture-interrupted";
-            readonly stage: "normalize" | "export" | "checkpoint" | "finalizer-export";
+            readonly stage: "normalize" | "checkpoint" | "export" | "finalizer-export";
             readonly atWindowId: string | null;
         } | {
             readonly code: "collection-cap-reached";
@@ -276,7 +276,7 @@ export declare const FileChangesAttachmentSchema: Schema.filter<Schema.Struct<{
         readonly state: "partial";
         readonly limitations: readonly [{
             readonly code: "capture-failed" | "capture-interrupted";
-            readonly stage: "normalize" | "export" | "checkpoint" | "finalizer-export";
+            readonly stage: "normalize" | "checkpoint" | "export" | "finalizer-export";
             readonly atWindowId: string | null;
         } | {
             readonly code: "collection-cap-reached";
@@ -289,7 +289,7 @@ export declare const FileChangesAttachmentSchema: Schema.filter<Schema.Struct<{
             readonly omittedAtLeast: number;
         }, ...({
             readonly code: "capture-failed" | "capture-interrupted";
-            readonly stage: "normalize" | "export" | "checkpoint" | "finalizer-export";
+            readonly stage: "normalize" | "checkpoint" | "export" | "finalizer-export";
             readonly atWindowId: string | null;
         } | {
             readonly code: "collection-cap-reached";
@@ -449,7 +449,7 @@ export declare const fileChangesRecordAttachment: import("../definition/attachme
                 readonly state: "partial";
                 readonly limitations: readonly [{
                     readonly code: "capture-failed" | "capture-interrupted";
-                    readonly stage: "normalize" | "export" | "checkpoint" | "finalizer-export";
+                    readonly stage: "normalize" | "checkpoint" | "export" | "finalizer-export";
                     readonly atWindowId: string | null;
                 } | {
                     readonly code: "collection-cap-reached";
@@ -462,7 +462,7 @@ export declare const fileChangesRecordAttachment: import("../definition/attachme
                     readonly omittedAtLeast: number;
                 }, ...({
                     readonly code: "capture-failed" | "capture-interrupted";
-                    readonly stage: "normalize" | "export" | "checkpoint" | "finalizer-export";
+                    readonly stage: "normalize" | "checkpoint" | "export" | "finalizer-export";
                     readonly atWindowId: string | null;
                 } | {
                     readonly code: "collection-cap-reached";
@@ -481,7 +481,7 @@ export declare const fileChangesRecordAttachment: import("../definition/attachme
                 readonly state: "partial";
                 readonly limitations: readonly [{
                     readonly code: "capture-failed" | "capture-interrupted";
-                    readonly stage: "normalize" | "export" | "checkpoint" | "finalizer-export";
+                    readonly stage: "normalize" | "checkpoint" | "export" | "finalizer-export";
                     readonly atWindowId: string | null;
                 } | {
                     readonly code: "collection-cap-reached";
@@ -494,7 +494,7 @@ export declare const fileChangesRecordAttachment: import("../definition/attachme
                     readonly omittedAtLeast: number;
                 }, ...({
                     readonly code: "capture-failed" | "capture-interrupted";
-                    readonly stage: "normalize" | "export" | "checkpoint" | "finalizer-export";
+                    readonly stage: "normalize" | "checkpoint" | "export" | "finalizer-export";
                     readonly atWindowId: string | null;
                 } | {
                     readonly code: "collection-cap-reached";

package/dist/record/host/cli/contribution.cjs

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateCliCommand = exports.cleanCliCommand = exports.RECORD_MAINTENANCE_CLI_OPTIONS = void 0;
+const effect_1 = require("effect");
+const application_ts_1 = require("../../../cli/application.cjs");
+const contribution_ts_1 = require("../../../cli/contribution.cjs");
+const root_ts_1 = require("../../platform/root.cjs");
+const runtime_ts_1 = require("../runtime.cjs");
+const presentation_ts_1 = require("./presentation.cjs");
+exports.RECORD_MAINTENANCE_CLI_OPTIONS = Object.freeze({
+    record: Object.freeze({
+        type: "string",
+        help: Object.freeze({
+            summary: "Use a specific NiceEval record root.",
+            visibility: "public",
+        }),
+    }),
+    yes: Object.freeze({
+        type: "boolean",
+        help: Object.freeze({
+            summary: "Confirm the planned Record maintenance operation.",
+            visibility: "public",
+        }),
+    }),
+    help: Object.freeze({
+        type: "boolean",
+        short: "h",
+        help: Object.freeze({
+            summary: "Print help for this Record maintenance command.",
+            visibility: "public",
+        }),
+    }),
+});
+const CLEAN_HELP = `niceeval clean — delete incomplete Record Runs
+
+Usage:
+  niceeval clean [--record <root>] [--yes]
+
+Options:
+  --record <root>  use a specific NiceEval Record root
+  --yes            confirm deletion of the listed incomplete Runs
+  -h, --help       print this help
+`;
+const MIGRATE_HELP = `niceeval migrate — migrate a Record through fixed adjacent steps
+
+Usage:
+  niceeval migrate [--record <root>] [--yes]
+
+Options:
+  --record <root>  use a specific NiceEval Record root
+  --yes            confirm application of the displayed migration plan
+  -h, --help       print this help
+`;
+function assertNever(value) {
+    throw new Error(`Unreachable Record CLI contribution value: ${String(value)}`);
+}
+function recordCliFailure(command, operation, cause) {
+    return new contribution_ts_1.CliFeatureError({
+        feature: `record ${command}`,
+        operation,
+        cause,
+        exitCode: 1,
+    });
+}
+function write(command, channel, text) {
+    return effect_1.Effect.flatMap(application_ts_1.CliOutput, (output) => channel === "stdout" ? output.writeStdout(text) : output.writeStderr(text)).pipe(effect_1.Effect.mapError((cause) => recordCliFailure(command, `write ${channel}`, cause)));
+}
+function recordRootErrorCode(error) {
+    switch (error.code) {
+        case "record-root-empty":
+        case "record-root-relative":
+        case "record-root-non-file-url":
+        case "record-root-file-url-invalid":
+            return error.code;
+    }
+}
+function parseRecordCommand(command, argv) {
+    return effect_1.Effect.gen(function* () {
+        const parser = yield* application_ts_1.CliArguments;
+        const parsed = yield* effect_1.Effect.try({
+            try: () => parser.parse(argv, exports.RECORD_MAINTENANCE_CLI_OPTIONS),
+            catch: (cause) => recordCliFailure(command, "parse command", cause),
+        });
+        if (parsed.values.help === true) {
+            yield* write(command, "stdout", command === "clean" ? CLEAN_HELP : MIGRATE_HELP);
+            return 0;
+        }
+        if (parsed.positionals.length > 0) {
+            yield* write(command, "stderr", `niceeval ${command} does not accept positional arguments.\n`);
+            return 1;
+        }
+        const invocation = yield* application_ts_1.CliInvocationFacts;
+        const facts = yield* invocation.facts.pipe(effect_1.Effect.mapError((cause) => recordCliFailure(command, "read invocation facts", cause)));
+        const path = yield* application_ts_1.CliPath;
+        const rootPath = path.resolve(facts.cwd, typeof parsed.values.record === "string" ? parsed.values.record : ".niceeval/record");
+        const root = (0, root_ts_1.makeRecordRoot)(rootPath);
+        if (effect_1.Either.isLeft(root)) {
+            yield* write(command, "stderr", `${recordRootErrorCode(root.left)}\n`);
+            return 1;
+        }
+        return Object.freeze({ rootPath, root: root.right, yes: parsed.values.yes === true });
+    });
+}
+function emitMaintenanceFailure(command, failure, recordPath) {
+    return write(command, "stderr", (0, presentation_ts_1.renderRecordMaintenanceFailure)(failure, recordPath)).pipe(effect_1.Effect.as(1));
+}
+function runClean(input) {
+    return effect_1.Effect.gen(function* () {
+        const planned = yield* effect_1.Effect.either(runtime_ts_1.recordHost.maintenance.planClean({ root: input.root }));
+        if (effect_1.Either.isLeft(planned))
+            return yield* emitMaintenanceFailure("clean", planned.left, input.rootPath);
+        const plan = planned.right;
+        switch (plan._tag) {
+            case "RecordCleanAlreadyClean":
+                yield* write("clean", "stdout", "No incomplete Runs found.\n");
+                return 0;
+            case "RecordCleanConfirmationRequired": {
+                const listed = plan.runIds.map((runId) => `  ${runId}`).join("\n");
+                if (!input.yes) {
+                    yield* write("clean", "stdout", `Incomplete Runs:\n${listed}\n`);
+                    yield* write("clean", "stderr", "record-clean-confirmation-required\nReview the listed Runs and rerun with --yes.\n");
+                    return 1;
+                }
+                const applied = yield* effect_1.Effect.either(runtime_ts_1.recordHost.maintenance.applyClean({
+                    root: input.root,
+                    plan,
+                }));
+                if (effect_1.Either.isLeft(applied))
+                    return yield* emitMaintenanceFailure("clean", applied.left, input.rootPath);
+                const lines = ["Cleaned incomplete Runs:"];
+                if (applied.right.deleted.length === 0)
+                    lines.push("  deleted: none");
+                else
+                    lines.push(...applied.right.deleted.map((runId) => `  deleted: ${runId}`));
+                lines.push(...applied.right.skipped.map((runId) => `  skipped complete: ${runId}`));
+                yield* write("clean", "stdout", `${lines.join("\n")}\n`);
+                return 0;
+            }
+            default:
+                return assertNever(plan);
+        }
+    });
+}
+function runMigrate(input) {
+    return effect_1.Effect.gen(function* () {
+        const planned = yield* effect_1.Effect.either(runtime_ts_1.recordHost.maintenance.planMigrate({ root: input.root }));
+        if (effect_1.Either.isLeft(planned))
+            return yield* emitMaintenanceFailure("migrate", planned.left, input.rootPath);
+        const plan = planned.right;
+        const planText = (0, presentation_ts_1.renderMigrationPlan)(plan);
+        switch (plan._tag) {
+            case "RecordMigrationAlreadyCurrent":
+                yield* write("migrate", "stdout", `${planText}Record migration already-current.\n`);
+                return 0;
+            case "RecordMigrationUnsupported":
+                yield* write("migrate", "stdout", planText);
+                yield* write("migrate", "stderr", "record-format-unsupported\nInstall a NiceEval version that supports this Record format.\n");
+                return 1;
+            case "RecordMigrationRestoreRequired":
+                yield* write("migrate", "stdout", planText);
+                yield* write("migrate", "stderr", "record-migration-git-restore-required\nA clean Git restore point is required; --yes cannot bypass this preflight.\n");
+                return 1;
+            case "RecordMigrationReady": {
+                yield* write("migrate", "stdout", planText);
+                if (!input.yes) {
+                    yield* write("migrate", "stderr", "record-migration-confirmation-required\nReview the migration plan and rerun with --yes.\n");
+                    return 1;
+                }
+                const applied = yield* effect_1.Effect.either(runtime_ts_1.recordHost.maintenance.applyMigrate({
+                    root: input.root,
+                    plan,
+                }));
+                if (effect_1.Either.isLeft(applied))
+                    return yield* emitMaintenanceFailure("migrate", applied.left, input.rootPath);
+                switch (applied.right._tag) {
+                    case "RecordMigrationAlreadyCurrent":
+                        yield* write("migrate", "stdout", "Record migration already-current.\n");
+                        return 0;
+                    case "RecordMigrationApplied":
+                        yield* write("migrate", "stdout", "Record migration migrated.\n");
+                        return 0;
+                    default:
+                        return assertNever(applied.right);
+                }
+            }
+            default:
+                return assertNever(plan);
+        }
+    });
+}
+function makeRecordCliCommand(command, summary, execute) {
+    return Object.freeze({
+        name: command,
+        summary,
+        options: exports.RECORD_MAINTENANCE_CLI_OPTIONS,
+        run: (argv) => effect_1.Effect.gen(function* () {
+            const parsed = yield* parseRecordCommand(command, argv);
+            if (typeof parsed === "number")
+                return parsed;
+            return yield* execute(parsed);
+        }),
+    });
+}
+exports.cleanCliCommand = makeRecordCliCommand("clean", "delete incomplete Record Runs", runClean);
+exports.migrateCliCommand = makeRecordCliCommand("migrate", "migrate a Record through fixed adjacent steps", runMigrate);
+//# sourceMappingURL=contribution.cjs.map

package/dist/record/host/cli/contribution.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.js","sourceRoot":"","sources":["contribution.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AACxC,gEAA8H;AAC9H,kEAA6F;AAE7F,oDAA4G;AAE5G,8CAA2C;AAE3C,uDAAyF;AAC5E,QAAA,8BAA8B,GAAG,MAAM,CAAC,MAAM,CAAC;IACxD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAChB,OAAO,EAAE,sCAAsC;YAC/C,UAAU,EAAE,QAAQ;SACvB,CAAC;KACL,CAAC;IACF,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAChB,OAAO,EAAE,mDAAmD;YAC5D,UAAU,EAAE,QAAQ;SACvB,CAAC;KACL,CAAC;IACF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAChB,OAAO,EAAE,iDAAiD;YAC1D,UAAU,EAAE,QAAQ;SACvB,CAAC;KACL,CAAC;CACmD,CAAC,CAAC;AAC3D,MAAM,UAAU,GAAG;;;;;;;;;CASlB,CAAC;AACF,MAAM,YAAY,GAAG;;;;;;;;;CASpB,CAAC;AAGF,SAAS,WAAW,CAAC,KAAY;IAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AACD,SAAS,gBAAgB,CAAC,OAA4B,EAAE,SAAiB,EAAE,KAAc;IACrF,OAAO,IAAI,iCAAe,CAAC;QACvB,OAAO,EAAE,UAAU,OAAO,EAAE;QAC5B,SAAS;QACT,KAAK;QACL,QAAQ,EAAE,CAAC;KACd,CAAC,CAAC;AACP,CAAC;AACD,SAAS,KAAK,CAAC,OAA4B,EAAE,OAA4B,EAAE,IAAY;IACnF,OAAO,eAAM,CAAC,OAAO,CAAC,0BAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,eAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AACpN,CAAC;AACD,SAAS,mBAAmB,CAAC,KAAkC;IAC3D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,mBAAmB,CAAC;QACzB,KAAK,sBAAsB,CAAC;QAC5B,KAAK,0BAA0B,CAAC;QAChC,KAAK,8BAA8B;YAC/B,OAAO,KAAK,CAAC,IAAI,CAAC;IAC1B,CAAC;AACL,CAAC;AAMD,SAAS,kBAAkB,CAAC,OAA4B,EAAE,IAAuB;IAC7E,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,6BAAY,CAAC;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,GAAG,CAAC;YAC7B,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,sCAA8B,CAAC;YAC7D,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC;SACtE,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9B,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YACjF,OAAO,CAAC,CAAC;QACb,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,OAAO,0CAA0C,CAAC,CAAC;YAC/F,OAAO,CAAC,CAAC;QACb,CAAC;QACD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,mCAAkB,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,eAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAClI,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,wBAAO,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC/H,MAAM,IAAI,GAAG,IAAA,wBAAc,EAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,eAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvE,OAAO,CAAC,CAAC;QACb,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACP,CAAC;AACD,SAAS,sBAAsB,CAAC,OAA4B,EAAE,OAA0C,EAAE,UAAkB;IACxH,OAAO,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAA,gDAA8B,EAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,eAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5G,CAAC;AACD,SAAS,QAAQ,CAAC,KAA0B;IACxC,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,MAAM,CAAC,uBAAU,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7F,IAAI,eAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YACtB,OAAO,KAAK,CAAC,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChF,MAAM,IAAI,GAA6B,OAAO,CAAC,KAAK,CAAC;QACrD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,yBAAyB;gBAC1B,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,6BAA6B,CAAC,CAAC;gBAC/D,OAAO,CAAC,CAAC;YACb,KAAK,iCAAiC,CAAC,CAAC,CAAC;gBACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBACb,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,qBAAqB,MAAM,IAAI,CAAC,CAAC;oBACjE,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,oFAAoF,CAAC,CAAC;oBACtH,OAAO,CAAC,CAAC;gBACb,CAAC;gBACD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,MAAM,CAAC,uBAAU,CAAC,WAAW,CAAC,UAAU,CAAC;oBACnE,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI;iBACP,CAAC,CAAC,CAAC;gBACJ,IAAI,eAAM,CAAC,MAAM,CAAC,OAAO,CAAC;oBACtB,OAAO,KAAK,CAAC,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAChF,MAAM,KAAK,GAAG,CAAC,0BAA0B,CAAC,CAAC;gBAC3C,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;oBAClC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;;oBAE9B,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC/E,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC,CAAC;gBACpF,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzD,OAAO,CAAC,CAAC;YACb,CAAC;YACD;gBACI,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AACD,SAAS,UAAU,CAAC,KAA0B;IAC1C,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,MAAM,CAAC,uBAAU,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/F,IAAI,eAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YACtB,OAAO,KAAK,CAAC,CAAC,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClF,MAAM,IAAI,GAA+B,OAAO,CAAC,KAAK,CAAC;QACvD,MAAM,QAAQ,GAAG,IAAA,qCAAmB,EAAC,IAAI,CAAC,CAAC;QAC3C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,+BAA+B;gBAChC,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,qCAAqC,CAAC,CAAC;gBACpF,OAAO,CAAC,CAAC;YACb,KAAK,4BAA4B;gBAC7B,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC5C,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,2FAA2F,CAAC,CAAC;gBAC/H,OAAO,CAAC,CAAC;YACb,KAAK,gCAAgC;gBACjC,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC5C,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,qHAAqH,CAAC,CAAC;gBACzJ,OAAO,CAAC,CAAC;YACb,KAAK,sBAAsB,CAAC,CAAC,CAAC;gBAC1B,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBACb,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,2FAA2F,CAAC,CAAC;oBAC/H,OAAO,CAAC,CAAC;gBACb,CAAC;gBACD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,MAAM,CAAC,uBAAU,CAAC,WAAW,CAAC,YAAY,CAAC;oBACrE,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI;iBACP,CAAC,CAAC,CAAC;gBACJ,IAAI,eAAM,CAAC,MAAM,CAAC,OAAO,CAAC;oBACtB,OAAO,KAAK,CAAC,CAAC,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAClF,QAAQ,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBACzB,KAAK,+BAA+B;wBAChC,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,qCAAqC,CAAC,CAAC;wBACzE,OAAO,CAAC,CAAC;oBACb,KAAK,wBAAwB;wBACzB,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,8BAA8B,CAAC,CAAC;wBAClE,OAAO,CAAC,CAAC;oBACb;wBACI,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC1C,CAAC;YACL,CAAC;YACD;gBACI,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AACD,SAAS,oBAAoB,CAAI,OAA4B,EAAE,OAAe,EAAE,OAA6F;IACzK,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,OAAO;QACb,OAAO;QACP,OAAO,EAAE,sCAA8B;QACvC,GAAG,EAAE,CAAC,IAAuB,EAAE,EAAE,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACxD,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAC1B,OAAO,MAAM,CAAC;YAClB,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC;KACL,CAAC,CAAC;AACP,CAAC;AACY,QAAA,eAAe,GAAG,oBAAoB,CAAC,OAAO,EAAE,+BAA+B,EAAE,QAAQ,CAAC,CAAC;AAC3F,QAAA,iBAAiB,GAAG,oBAAoB,CAAC,SAAS,EAAE,+CAA+C,EAAE,UAAU,CAAC,CAAC","sourcesContent":["import { Effect, Either } from \"effect\";\nimport { CliArguments, CliInvocationFacts, CliOutput, CliPath, type CliOptionDefinition, } from \"../../../cli/application.ts\";\nimport { CliFeatureError, type CliCommandContribution, } from \"../../../cli/contribution.ts\";\nimport { RecordCoordination } from \"../../../coordination/record-leases.ts\";\nimport { makeRecordRoot, type RecordRoot, type RecordRootConstructionError, } from \"../../platform/root.ts\";\nimport { RecordFileSystem, RecordGit } from \"../../platform/services.ts\";\nimport { recordHost } from \"../runtime.ts\";\nimport type { RecordCleanOperationPlan, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan, } from \"../types.ts\";\nimport { renderMigrationPlan, renderRecordMaintenanceFailure, } from \"./presentation.ts\";\nexport const RECORD_MAINTENANCE_CLI_OPTIONS = Object.freeze({\n    record: Object.freeze({\n        type: \"string\",\n        help: Object.freeze({\n            summary: \"Use a specific NiceEval record root.\",\n            visibility: \"public\",\n        }),\n    }),\n    yes: Object.freeze({\n        type: \"boolean\",\n        help: Object.freeze({\n            summary: \"Confirm the planned Record maintenance operation.\",\n            visibility: \"public\",\n        }),\n    }),\n    help: Object.freeze({\n        type: \"boolean\",\n        short: \"h\",\n        help: Object.freeze({\n            summary: \"Print help for this Record maintenance command.\",\n            visibility: \"public\",\n        }),\n    }),\n} satisfies Readonly<Record<string, CliOptionDefinition>>);\nconst CLEAN_HELP = `niceeval clean — delete incomplete Record Runs\n\nUsage:\n  niceeval clean [--record <root>] [--yes]\n\nOptions:\n  --record <root>  use a specific NiceEval Record root\n  --yes            confirm deletion of the listed incomplete Runs\n  -h, --help       print this help\n`;\nconst MIGRATE_HELP = `niceeval migrate — migrate a Record through fixed adjacent steps\n\nUsage:\n  niceeval migrate [--record <root>] [--yes]\n\nOptions:\n  --record <root>  use a specific NiceEval Record root\n  --yes            confirm application of the displayed migration plan\n  -h, --help       print this help\n`;\ntype RecordCliBaseRequirement = CliArguments | CliInvocationFacts | CliOutput | CliPath;\ntype RecordCliError = CliFeatureError;\nfunction assertNever(value: never): never {\n    throw new Error(`Unreachable Record CLI contribution value: ${String(value)}`);\n}\nfunction recordCliFailure(command: \"clean\" | \"migrate\", operation: string, cause: unknown): RecordCliError {\n    return new CliFeatureError({\n        feature: `record ${command}`,\n        operation,\n        cause,\n        exitCode: 1,\n    });\n}\nfunction write(command: \"clean\" | \"migrate\", channel: \"stdout\" | \"stderr\", text: string): Effect.Effect<void, RecordCliError, CliOutput> {\n    return Effect.flatMap(CliOutput, (output) => channel === \"stdout\" ? output.writeStdout(text) : output.writeStderr(text)).pipe(Effect.mapError((cause) => recordCliFailure(command, `write ${channel}`, cause)));\n}\nfunction recordRootErrorCode(error: RecordRootConstructionError): string {\n    switch (error.code) {\n        case \"record-root-empty\":\n        case \"record-root-relative\":\n        case \"record-root-non-file-url\":\n        case \"record-root-file-url-invalid\":\n            return error.code;\n    }\n}\ninterface ParsedRecordCommand {\n    readonly rootPath: string;\n    readonly root: RecordRoot;\n    readonly yes: boolean;\n}\nfunction parseRecordCommand(command: \"clean\" | \"migrate\", argv: readonly string[]): Effect.Effect<ParsedRecordCommand | number, RecordCliError, CliArguments | CliInvocationFacts | CliOutput | CliPath> {\n    return Effect.gen(function* () {\n        const parser = yield* CliArguments;\n        const parsed = yield* Effect.try({\n            try: () => parser.parse(argv, RECORD_MAINTENANCE_CLI_OPTIONS),\n            catch: (cause) => recordCliFailure(command, \"parse command\", cause),\n        });\n        if (parsed.values.help === true) {\n            yield* write(command, \"stdout\", command === \"clean\" ? CLEAN_HELP : MIGRATE_HELP);\n            return 0;\n        }\n        if (parsed.positionals.length > 0) {\n            yield* write(command, \"stderr\", `niceeval ${command} does not accept positional arguments.\\n`);\n            return 1;\n        }\n        const invocation = yield* CliInvocationFacts;\n        const facts = yield* invocation.facts.pipe(Effect.mapError((cause) => recordCliFailure(command, \"read invocation facts\", cause)));\n        const path = yield* CliPath;\n        const rootPath = path.resolve(facts.cwd, typeof parsed.values.record === \"string\" ? parsed.values.record : \".niceeval/record\");\n        const root = makeRecordRoot(rootPath);\n        if (Either.isLeft(root)) {\n            yield* write(command, \"stderr\", `${recordRootErrorCode(root.left)}\\n`);\n            return 1;\n        }\n        return Object.freeze({ rootPath, root: root.right, yes: parsed.values.yes === true });\n    });\n}\nfunction emitMaintenanceFailure(command: \"clean\" | \"migrate\", failure: RecordMaintenanceOperationFailure, recordPath: string): Effect.Effect<number, RecordCliError, CliOutput> {\n    return write(command, \"stderr\", renderRecordMaintenanceFailure(failure, recordPath)).pipe(Effect.as(1));\n}\nfunction runClean(input: ParsedRecordCommand): Effect.Effect<number, RecordCliError, CliOutput | RecordCoordination | RecordFileSystem> {\n    return Effect.gen(function* () {\n        const planned = yield* Effect.either(recordHost.maintenance.planClean({ root: input.root }));\n        if (Either.isLeft(planned))\n            return yield* emitMaintenanceFailure(\"clean\", planned.left, input.rootPath);\n        const plan: RecordCleanOperationPlan = planned.right;\n        switch (plan._tag) {\n            case \"RecordCleanAlreadyClean\":\n                yield* write(\"clean\", \"stdout\", \"No incomplete Runs found.\\n\");\n                return 0;\n            case \"RecordCleanConfirmationRequired\": {\n                const listed = plan.runIds.map((runId) => `  ${runId}`).join(\"\\n\");\n                if (!input.yes) {\n                    yield* write(\"clean\", \"stdout\", `Incomplete Runs:\\n${listed}\\n`);\n                    yield* write(\"clean\", \"stderr\", \"record-clean-confirmation-required\\nReview the listed Runs and rerun with --yes.\\n\");\n                    return 1;\n                }\n                const applied = yield* Effect.either(recordHost.maintenance.applyClean({\n                    root: input.root,\n                    plan,\n                }));\n                if (Either.isLeft(applied))\n                    return yield* emitMaintenanceFailure(\"clean\", applied.left, input.rootPath);\n                const lines = [\"Cleaned incomplete Runs:\"];\n                if (applied.right.deleted.length === 0)\n                    lines.push(\"  deleted: none\");\n                else\n                    lines.push(...applied.right.deleted.map((runId) => `  deleted: ${runId}`));\n                lines.push(...applied.right.skipped.map((runId) => `  skipped complete: ${runId}`));\n                yield* write(\"clean\", \"stdout\", `${lines.join(\"\\n\")}\\n`);\n                return 0;\n            }\n            default:\n                return assertNever(plan);\n        }\n    });\n}\nfunction runMigrate(input: ParsedRecordCommand): Effect.Effect<number, RecordCliError, CliOutput | RecordCoordination | RecordFileSystem | RecordGit> {\n    return Effect.gen(function* () {\n        const planned = yield* Effect.either(recordHost.maintenance.planMigrate({ root: input.root }));\n        if (Either.isLeft(planned))\n            return yield* emitMaintenanceFailure(\"migrate\", planned.left, input.rootPath);\n        const plan: RecordMigrateOperationPlan = planned.right;\n        const planText = renderMigrationPlan(plan);\n        switch (plan._tag) {\n            case \"RecordMigrationAlreadyCurrent\":\n                yield* write(\"migrate\", \"stdout\", `${planText}Record migration already-current.\\n`);\n                return 0;\n            case \"RecordMigrationUnsupported\":\n                yield* write(\"migrate\", \"stdout\", planText);\n                yield* write(\"migrate\", \"stderr\", \"record-format-unsupported\\nInstall a NiceEval version that supports this Record format.\\n\");\n                return 1;\n            case \"RecordMigrationRestoreRequired\":\n                yield* write(\"migrate\", \"stdout\", planText);\n                yield* write(\"migrate\", \"stderr\", \"record-migration-git-restore-required\\nA clean Git restore point is required; --yes cannot bypass this preflight.\\n\");\n                return 1;\n            case \"RecordMigrationReady\": {\n                yield* write(\"migrate\", \"stdout\", planText);\n                if (!input.yes) {\n                    yield* write(\"migrate\", \"stderr\", \"record-migration-confirmation-required\\nReview the migration plan and rerun with --yes.\\n\");\n                    return 1;\n                }\n                const applied = yield* Effect.either(recordHost.maintenance.applyMigrate({\n                    root: input.root,\n                    plan,\n                }));\n                if (Either.isLeft(applied))\n                    return yield* emitMaintenanceFailure(\"migrate\", applied.left, input.rootPath);\n                switch (applied.right._tag) {\n                    case \"RecordMigrationAlreadyCurrent\":\n                        yield* write(\"migrate\", \"stdout\", \"Record migration already-current.\\n\");\n                        return 0;\n                    case \"RecordMigrationApplied\":\n                        yield* write(\"migrate\", \"stdout\", \"Record migration migrated.\\n\");\n                        return 0;\n                    default:\n                        return assertNever(applied.right);\n                }\n            }\n            default:\n                return assertNever(plan);\n        }\n    });\n}\nfunction makeRecordCliCommand<R>(command: \"clean\" | \"migrate\", summary: string, execute: (input: ParsedRecordCommand) => Effect.Effect<number, RecordCliError, CliOutput | R>): CliCommandContribution<RecordCliBaseRequirement | R, RecordCliError> {\n    return Object.freeze({\n        name: command,\n        summary,\n        options: RECORD_MAINTENANCE_CLI_OPTIONS,\n        run: (argv: readonly string[]) => Effect.gen(function* () {\n            const parsed = yield* parseRecordCommand(command, argv);\n            if (typeof parsed === \"number\")\n                return parsed;\n            return yield* execute(parsed);\n        }),\n    });\n}\nexport const cleanCliCommand = makeRecordCliCommand(\"clean\", \"delete incomplete Record Runs\", runClean);\nexport const migrateCliCommand = makeRecordCliCommand(\"migrate\", \"migrate a Record through fixed adjacent steps\", runMigrate);\n"]}

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

@@ -0,0 +1,32 @@
+import { CliArguments, CliInvocationFacts, CliOutput, CliPath } from "../../../cli/application.cjs";
+import { CliFeatureError, type CliCommandContribution } from "../../../cli/contribution.cjs";
+import { RecordCoordination } from "../../../coordination/record-leases.cjs";
+import { RecordFileSystem, RecordGit } from "../../platform/services.cjs";
+export declare const RECORD_MAINTENANCE_CLI_OPTIONS: Readonly<{
+    record: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Use a specific NiceEval record root.";
+            visibility: "public";
+        }>;
+    }>;
+    yes: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Confirm the planned Record maintenance operation.";
+            visibility: "public";
+        }>;
+    }>;
+    help: Readonly<{
+        type: "boolean";
+        short: "h";
+        help: Readonly<{
+            summary: "Print help for this Record maintenance command.";
+            visibility: "public";
+        }>;
+    }>;
+}>;
+type RecordCliBaseRequirement = CliArguments | CliInvocationFacts | CliOutput | CliPath;
+export declare const cleanCliCommand: CliCommandContribution<RecordCoordination | RecordFileSystem | RecordCliBaseRequirement, CliFeatureError>;
+export declare const migrateCliCommand: CliCommandContribution<RecordCoordination | RecordFileSystem | RecordGit | RecordCliBaseRequirement, CliFeatureError>;
+export {};

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

@@ -0,0 +1,32 @@
+import { CliArguments, CliInvocationFacts, CliOutput, CliPath } from "../../../cli/application.mjs";
+import { CliFeatureError, type CliCommandContribution } from "../../../cli/contribution.mjs";
+import { RecordCoordination } from "../../../coordination/record-leases.mjs";
+import { RecordFileSystem, RecordGit } from "../../platform/services.mjs";
+export declare const RECORD_MAINTENANCE_CLI_OPTIONS: Readonly<{
+    record: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Use a specific NiceEval record root.";
+            visibility: "public";
+        }>;
+    }>;
+    yes: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Confirm the planned Record maintenance operation.";
+            visibility: "public";
+        }>;
+    }>;
+    help: Readonly<{
+        type: "boolean";
+        short: "h";
+        help: Readonly<{
+            summary: "Print help for this Record maintenance command.";
+            visibility: "public";
+        }>;
+    }>;
+}>;
+type RecordCliBaseRequirement = CliArguments | CliInvocationFacts | CliOutput | CliPath;
+export declare const cleanCliCommand: CliCommandContribution<RecordCoordination | RecordFileSystem | RecordCliBaseRequirement, CliFeatureError>;
+export declare const migrateCliCommand: CliCommandContribution<RecordCoordination | RecordFileSystem | RecordGit | RecordCliBaseRequirement, CliFeatureError>;
+export {};

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

@@ -0,0 +1,32 @@
+import { CliArguments, CliInvocationFacts, CliOutput, CliPath } from "../../../cli/application.js";
+import { CliFeatureError, type CliCommandContribution } from "../../../cli/contribution.js";
+import { RecordCoordination } from "../../../coordination/record-leases.js";
+import { RecordFileSystem, RecordGit } from "../../platform/services.js";
+export declare const RECORD_MAINTENANCE_CLI_OPTIONS: Readonly<{
+    record: Readonly<{
+        type: "string";
+        help: Readonly<{
+            summary: "Use a specific NiceEval record root.";
+            visibility: "public";
+        }>;
+    }>;
+    yes: Readonly<{
+        type: "boolean";
+        help: Readonly<{
+            summary: "Confirm the planned Record maintenance operation.";
+            visibility: "public";
+        }>;
+    }>;
+    help: Readonly<{
+        type: "boolean";
+        short: "h";
+        help: Readonly<{
+            summary: "Print help for this Record maintenance command.";
+            visibility: "public";
+        }>;
+    }>;
+}>;
+type RecordCliBaseRequirement = CliArguments | CliInvocationFacts | CliOutput | CliPath;
+export declare const cleanCliCommand: CliCommandContribution<RecordCoordination | RecordFileSystem | RecordCliBaseRequirement, CliFeatureError>;
+export declare const migrateCliCommand: CliCommandContribution<RecordCoordination | RecordFileSystem | RecordGit | RecordCliBaseRequirement, CliFeatureError>;
+export {};

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

@@ -0,0 +1,10 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./contribution.cjs");
+const __niceevalExport0 = __niceevalCanonical["RECORD_MAINTENANCE_CLI_OPTIONS"];
+export { __niceevalExport0 as RECORD_MAINTENANCE_CLI_OPTIONS };
+const __niceevalExport1 = __niceevalCanonical["cleanCliCommand"];
+export { __niceevalExport1 as cleanCliCommand };
+const __niceevalExport2 = __niceevalCanonical["migrateCliCommand"];
+export { __niceevalExport2 as migrateCliCommand };
+//# sourceMappingURL=contribution.js.map

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

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

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECORD_MAINTENANCE_CLI_OPTIONS = exports.migrateCliCommand = exports.cleanCliCommand = void 0;
+var contribution_ts_1 = require("./contribution.cjs");
+Object.defineProperty(exports, "cleanCliCommand", { enumerable: true, get: function () { return contribution_ts_1.cleanCliCommand; } });
+Object.defineProperty(exports, "migrateCliCommand", { enumerable: true, get: function () { return contribution_ts_1.migrateCliCommand; } });
+Object.defineProperty(exports, "RECORD_MAINTENANCE_CLI_OPTIONS", { enumerable: true, get: function () { return contribution_ts_1.RECORD_MAINTENANCE_CLI_OPTIONS; } });
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AAAA,qDAAwG;AAA/F,kHAAA,eAAe,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAAE,iIAAA,8BAA8B,OAAA","sourcesContent":["export { cleanCliCommand, migrateCliCommand, RECORD_MAINTENANCE_CLI_OPTIONS, } from \"./contribution.ts\";\n"]}

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

@@ -0,0 +1 @@
+export { cleanCliCommand, migrateCliCommand, RECORD_MAINTENANCE_CLI_OPTIONS, } from "./contribution.cjs";

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

@@ -0,0 +1 @@
+export { cleanCliCommand, migrateCliCommand, RECORD_MAINTENANCE_CLI_OPTIONS, } from "./contribution.mjs";

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

@@ -0,0 +1 @@
+export { cleanCliCommand, migrateCliCommand, RECORD_MAINTENANCE_CLI_OPTIONS, } from "./contribution.js";

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

@@ -0,0 +1,10 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./index.cjs");
+const __niceevalExport0 = __niceevalCanonical["RECORD_MAINTENANCE_CLI_OPTIONS"];
+export { __niceevalExport0 as RECORD_MAINTENANCE_CLI_OPTIONS };
+const __niceevalExport1 = __niceevalCanonical["cleanCliCommand"];
+export { __niceevalExport1 as cleanCliCommand };
+const __niceevalExport2 = __niceevalCanonical["migrateCliCommand"];
+export { __niceevalExport2 as migrateCliCommand };
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderRecordMaintenanceFailure = renderRecordMaintenanceFailure;
+exports.renderAutomaticMigrationFailure = renderAutomaticMigrationFailure;
+exports.renderAutomaticMigrationResult = renderAutomaticMigrationResult;
+exports.renderMigrationPlan = renderMigrationPlan;
+function assertNever(value) {
+    throw new Error(`Unreachable Record CLI presentation value: ${String(value)}`);
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+function recoveryCommands(restoreCommit, recordPath) {
+    const root = shellQuote(recordPath);
+    const commit = shellQuote(restoreCommit);
+    const sentinel = shellQuote(`${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 renderRecordMaintenanceFailure(failure, recordPath) {
+    switch (failure._tag) {
+        case "RecordMaintenanceBusy":
+            return `${failure.code}\nClose the Record command holding the lock, then retry.\n`;
+        case "RecordMigrationInterrupted":
+            return `${failure.code}\n${failure.restoreSafe === true
+                ? "Restore the complete Record from the recorded Git commit; do not rerun migrate on mixed bytes."
+                : "Inspect and preserve concurrent Record edits before choosing a manual recovery; no automatic Git restore command is safe."}\n${failure.restoreSafe === true && failure.restoreCommit !== undefined
+                ? recoveryCommands(failure.restoreCommit, recordPath)
+                : ""}`;
+        case "RecordMigrationPlanStale":
+            return `${failure.code}\nReview the new migration plan and rerun migrate.\n`;
+        case "RecordMigrationGitRestoreRequired":
+            return `${failure.code}\nCommit, restore, or otherwise obtain a clean Git restore point for this Record before migrating.\n`;
+        case "RecordMigrationInvalid":
+            return `${failure.code}\nRestore the Record from Git before retrying migration.\n`;
+        case "RecordMigrationRecoveryRequired":
+            return `${failure.code}\n${failure.restoreSafe
+                ? "Restore the complete Record from Git before retrying migration."
+                : "Inspect and preserve concurrent Record edits before choosing a manual recovery; no automatic Git restore command is safe."}\nCause: ${failure.causeCode}\n${failure.restoreSafe ? recoveryCommands(failure.restoreCommit, recordPath) : ""}`;
+        case "RecordFormatUnsupported":
+            return `${failure.code}\nInstall a NiceEval version that supports this Record format.\n`;
+        case "RecordMigrationRequired":
+            return `${failure.code}\nRun: niceeval migrate\n`;
+        case "RecordMaintenanceOperationFailed":
+            return `${failure.code}\n`;
+        default:
+            return assertNever(failure);
+    }
+}
+function failureCode(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const code = Reflect.get(value, "code");
+    return typeof code === "string" ? code : undefined;
+}
+/** Shared CLI wording for ordinary-entry automatic migration failures. */
+function renderAutomaticMigrationFailure(error) {
+    const code = failureCode(error);
+    if (code === "record-auto-migration-git-save-required") {
+        return "record-auto-migration-git-save-required\n" +
+            "Save every portable Record byte first (for example: git add .niceeval/record && git commit), then retry the same command.\n";
+    }
+    if (code === "record-maintenance-busy" || code === "record-writer-busy") {
+        return `${code}\nClose the command using this Record, then retry.\n`;
+    }
+    if (code === "record-format-unsupported") {
+        return "record-format-unsupported\nUse the NiceEval version that wrote this future or unknown Record format.\n";
+    }
+    if (code === "record-migration-recovery-required" || code === "record-migration-interrupted") {
+        return `${code}\nRestore and verify the complete Record from Git before retrying.\n`;
+    }
+    return undefined;
+}
+/** Shared CLI notice emitted exactly once after an automatic migration. */
+function renderAutomaticMigrationResult(result) {
+    if (result.state !== "migrated")
+        return undefined;
+    const droppedFacts = [...new Set(result.attachments.flatMap((attachment) => attachment.retention.droppedFacts))];
+    const rerunRecommendations = [...new Set(result.attachments.flatMap((attachment) => attachment.retention.rerunRecommendation === null
+            ? []
+            : [attachment.retention.rerunRecommendation]))];
+    return `Record automatically migrated ${result.attachments.length} attachment${result.attachments.length === 1 ? "" : "s"}; restore commit ${result.restoreCommit}.${droppedFacts.length === 0 ? "" : ` Dropped facts: ${droppedFacts.join(", ")}.`}${rerunRecommendations.length === 0 ? "" : ` ${rerunRecommendations.join(" ")}`}\n`;
+}
+function renderMigrationImpact(attachments) {
+    return [...new Map(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");
+}
+function renderMigrationPlan(plan) {
+    switch (plan._tag) {
+        case "RecordMigrationAlreadyCurrent":
+            return `Record migration plan: already-current\nformat: ${plan.format}\n`;
+        case "RecordMigrationUnsupported":
+            return `Record migration plan: unsupported-format\nformat: ${plan.format}\n`;
+        case "RecordMigrationRestoreRequired": {
+            const impact = renderMigrationImpact(plan.attachments);
+            return `Record migration plan: migration-required\nformat: ${plan.format}\nattachments: ${plan.attachments.length}\n${impact === "" ? "" : `${impact}\n`}backup: ${plan.backup.state}\n`;
+        }
+        case "RecordMigrationReady": {
+            const impact = renderMigrationImpact(plan.attachments);
+            return `Record migration plan: migration-required\nformat: ${plan.format}\nattachments: ${plan.attachments.length}\n${impact === "" ? "" : `${impact}\n`}backup: git-restore-point\nrestore commit: ${plan.restoreCommit}\n`;
+        }
+        default:
+            return assertNever(plan);
+    }
+}
+//# sourceMappingURL=presentation.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RecordAttachmentMigrationTarget, RecordAutomaticMigrationResult, RecordMaintenanceOperationFailure, RecordMigrateOperationPlan, } from \"../types.ts\";\nfunction assertNever(value: never): never {\n    throw new Error(`Unreachable Record CLI presentation value: ${String(value)}`);\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(`${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}\nexport function renderRecordMaintenanceFailure(failure: RecordMaintenanceOperationFailure, recordPath: string): string {\n    switch (failure._tag) {\n        case \"RecordMaintenanceBusy\":\n            return `${failure.code}\\nClose the Record command holding the lock, then retry.\\n`;\n        case \"RecordMigrationInterrupted\":\n            return `${failure.code}\\n${failure.restoreSafe === true\n                ? \"Restore the complete Record from the recorded Git commit; do not rerun migrate on mixed bytes.\"\n                : \"Inspect and preserve concurrent Record edits before choosing a manual recovery; no automatic Git restore command is safe.\"}\\n${failure.restoreSafe === true && failure.restoreCommit !== undefined\n                ? recoveryCommands(failure.restoreCommit, recordPath)\n                : \"\"}`;\n        case \"RecordMigrationPlanStale\":\n            return `${failure.code}\\nReview the new migration plan and rerun migrate.\\n`;\n        case \"RecordMigrationGitRestoreRequired\":\n            return `${failure.code}\\nCommit, restore, or otherwise obtain a clean Git restore point for this Record before migrating.\\n`;\n        case \"RecordMigrationInvalid\":\n            return `${failure.code}\\nRestore the Record from Git before retrying migration.\\n`;\n        case \"RecordMigrationRecoveryRequired\":\n            return `${failure.code}\\n${failure.restoreSafe\n                ? \"Restore the complete Record from Git before retrying migration.\"\n                : \"Inspect and preserve concurrent Record edits before choosing a manual recovery; no automatic Git restore command is safe.\"}\\nCause: ${failure.causeCode}\\n${failure.restoreSafe ? recoveryCommands(failure.restoreCommit, recordPath) : \"\"}`;\n        case \"RecordFormatUnsupported\":\n            return `${failure.code}\\nInstall a NiceEval version that supports this Record format.\\n`;\n        case \"RecordMigrationRequired\":\n            return `${failure.code}\\nRun: niceeval migrate\\n`;\n        case \"RecordMaintenanceOperationFailed\":\n            return `${failure.code}\\n`;\n        default:\n            return assertNever(failure);\n    }\n}\nfunction failureCode(value: unknown): string | undefined {\n    if (typeof value !== \"object\" || value === null)\n        return undefined;\n    const code = Reflect.get(value, \"code\");\n    return typeof code === \"string\" ? code : undefined;\n}\n/** Shared CLI wording for ordinary-entry automatic migration failures. */\nexport function renderAutomaticMigrationFailure(error: unknown): string | undefined {\n    const code = failureCode(error);\n    if (code === \"record-auto-migration-git-save-required\") {\n        return \"record-auto-migration-git-save-required\\n\" +\n            \"Save every portable Record byte first (for example: git add .niceeval/record && git commit), then retry the same command.\\n\";\n    }\n    if (code === \"record-maintenance-busy\" || code === \"record-writer-busy\") {\n        return `${code}\\nClose the command using this Record, then retry.\\n`;\n    }\n    if (code === \"record-format-unsupported\") {\n        return \"record-format-unsupported\\nUse the NiceEval version that wrote this future or unknown Record format.\\n\";\n    }\n    if (code === \"record-migration-recovery-required\" || code === \"record-migration-interrupted\") {\n        return `${code}\\nRestore and verify the complete Record from Git before retrying.\\n`;\n    }\n    return undefined;\n}\n/** Shared CLI notice emitted exactly once after an automatic migration. */\nexport function renderAutomaticMigrationResult(result: RecordAutomaticMigrationResult): string | undefined {\n    if (result.state !== \"migrated\")\n        return undefined;\n    const droppedFacts = [...new Set(result.attachments.flatMap((attachment) => attachment.retention.droppedFacts))];\n    const rerunRecommendations = [...new Set(result.attachments.flatMap((attachment) => attachment.retention.rerunRecommendation === null\n            ? []\n            : [attachment.retention.rerunRecommendation]))];\n    return `Record automatically migrated ${result.attachments.length} attachment${result.attachments.length === 1 ? \"\" : \"s\"}; restore commit ${result.restoreCommit}.${droppedFacts.length === 0 ? \"\" : ` Dropped facts: ${droppedFacts.join(\", \")}.`}${rerunRecommendations.length === 0 ? \"\" : ` ${rerunRecommendations.join(\" \")}`}\\n`;\n}\nfunction renderMigrationImpact(attachments: readonly RecordAttachmentMigrationTarget[]): string {\n    return [...new Map(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}\nexport function renderMigrationPlan(plan: RecordMigrateOperationPlan): string {\n    switch (plan._tag) {\n        case \"RecordMigrationAlreadyCurrent\":\n            return `Record migration plan: already-current\\nformat: ${plan.format}\\n`;\n        case \"RecordMigrationUnsupported\":\n            return `Record migration plan: unsupported-format\\nformat: ${plan.format}\\n`;\n        case \"RecordMigrationRestoreRequired\": {\n            const impact = renderMigrationImpact(plan.attachments);\n            return `Record migration plan: migration-required\\nformat: ${plan.format}\\nattachments: ${plan.attachments.length}\\n${impact === \"\" ? \"\" : `${impact}\\n`}backup: ${plan.backup.state}\\n`;\n        }\n        case \"RecordMigrationReady\": {\n            const impact = renderMigrationImpact(plan.attachments);\n            return `Record migration plan: migration-required\\nformat: ${plan.format}\\nattachments: ${plan.attachments.length}\\n${impact === \"\" ? \"\" : `${impact}\\n`}backup: git-restore-point\\nrestore commit: ${plan.restoreCommit}\\n`;\n        }\n        default:\n            return assertNever(plan);\n    }\n}\n"]}